Prerequisites
- A Node.js project (front-end framework, plain HTML with a bundler, or a meta-framework like Next.js or Nuxt)
- An API key from heretic.quest/dashboard/keys
Installation
Install@heretic-hq/collector with your preferred package manager.
Initialize the Collector
ImportCollector, pass your API key, and call collect(). The call is asynchronous — it resolves once the collector has gathered enough evidence to issue a session ID.
Configuration Options
string
required
Your Heretic API key. Retrieve it from heretic.quest/dashboard/keys. Keep this key out of public source control — consider injecting it via an environment variable at build time.
boolean
default:"true"
When
true (the default), the collector includes device fingerprinting via render clustering, which compares how the browser rasterises a reference scene against known GPU/driver profiles. Set to false to disable this signal family and reduce the volume of data the collector gathers.
