@orbithunt/tracker

Lightweight CDN loader for OrbitHunt session recording. Injects the tracker script tag — same behavior as the manual <script> tag, but installable via npm.

Installation

npm install @orbithunt/tracker

Quick Start

import { load } from '@orbithunt/tracker';

load('your-tracker-id');

That's it. The CDN script handles everything: visitor IDs, session management, recording, batching, retry logic, and flushing on page unload.

React / Next.js

Use the companion package for a React component:

npm install @orbithunt/tracker @orbithunt/react

See @orbithunt/react for details.

Vue / Svelte / Angular

// main.js or equivalent entry point
import { load } from '@orbithunt/tracker';

load('your-tracker-id');

Manual Script Tag

If you prefer not to use npm, add this to your HTML:

<script
  src="https://script.orbithunt.com/js/tracker.js"
  data-tracker-id="your-tracker-id"
  async
></script>

The npm package does exactly this under the hood.

Configuration

| Option | Type | Required | Default | Description | |--------|------|----------|---------|-------------| | trackerId | string | Yes | — | First argument to load() | | rrwebCdn | string | No | Built-in default | Override the rrweb CDN URL |

load('your-tracker-id');

API Reference

load(trackerId, options?): void

Inject the OrbitHunt tracker script tag. Safe to call on the server (no-op). Prevents double-loading automatically.

unload(): void

Remove the tracker script tag from the DOM. Safe to call on the server (no-op).

SSR

Safe to import and call on the server. load() and unload() are no-ops when window is undefined.

Privacy

• All input fields are masked at the browser level — sensitive data never leaves the page
• No cookies or cross-site tracking
• IP addresses are anonymized server-side
• Built-in consent banner (configurable per tracker)

License

Proprietary. See LICENSE for details.