@orbithunt/tracker 1.0.0-beta.2

package/LICENSE

@@ -0,0 +1,9 @@
+Copyright (c) 2024 OrbitHunt. All rights reserved.
+
+This software is proprietary and confidential. You may use the published
+npm packages (@orbithunt/tracker, @orbithunt/react) in your own projects,
+but you may not copy, modify, distribute, reverse-engineer, or create
+derivative works of the source code without prior written permission
+from OrbitHunt.
+
+For licensing inquiries, contact: support@orbithunt.com

package/README.md

@@ -0,0 +1,91 @@
+# @orbithunt/tracker
+
+Lightweight CDN loader for [OrbitHunt](https://orbithunt.com) session recording. Injects the tracker script tag — same behavior as the manual `<script>` tag, but installable via npm.
+
+## Installation
+
+```bash
+npm install @orbithunt/tracker
+```
+
+## Quick Start
+
+```javascript
+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:
+
+```bash
+npm install @orbithunt/tracker @orbithunt/react
+```
+
+See [@orbithunt/react](https://www.npmjs.com/package/@orbithunt/react) for details.
+
+## Vue / Svelte / Angular
+
+```javascript
+// 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:
+
+```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()` |
+| `ingestUrl` | `string` | No | Built-in default | Override the ingest endpoint URL |
+| `rrwebCdn` | `string` | No | Built-in default | Override the rrweb CDN URL |
+
+```javascript
+load('your-tracker-id', {
+  ingestUrl: 'https://your-custom-endpoint.com/v1/ingest',
+});
+```
+
+## 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](./LICENSE) for details.

package/dist/index.cjs.js

@@ -0,0 +1,55 @@
+'use strict';
+
+var CDN_URL = "https://script.orbithunt.com/js/tracker.js";
+
+/**
+ * Load the OrbitHunt tracker by injecting the CDN script tag.
+ * Safe to call in SSR — does nothing on the server.
+ *
+ * @param {string} trackerId - Your OrbitHunt tracker ID
+ * @param {Object} [options]
+ * @param {string} [options.ingestUrl] - Custom ingest endpoint
+ * @param {string} [options.rrwebCdn] - Custom rrweb CDN URL
+ */
+function load(trackerId, options) {
+  if (typeof window === "undefined") return;
+
+  if (!trackerId) {
+    console.error("[OrbitHunt] trackerId is required");
+    return;
+  }
+
+  // Prevent double-loading
+  if (document.querySelector("script[data-orbithunt-loader]")) {
+    console.warn("[OrbitHunt] Tracker already loaded");
+    return;
+  }
+
+  var opts = options || {};
+  var script = document.createElement("script");
+  script.src = CDN_URL;
+  script.async = true;
+  script.setAttribute("data-tracker-id", trackerId);
+  script.setAttribute("data-orbithunt-loader", "true");
+
+  if (opts.ingestUrl) script.setAttribute("data-ingest-url", opts.ingestUrl);
+  if (opts.rrwebCdn) script.setAttribute("data-rrweb-cdn", opts.rrwebCdn);
+
+  document.head.appendChild(script);
+}
+
+/**
+ * Remove the OrbitHunt tracker script tag.
+ * Safe to call in SSR — does nothing on the server.
+ */
+function unload() {
+  if (typeof window === "undefined") return;
+
+  var script = document.querySelector("script[data-orbithunt-loader]");
+  if (script) {
+    script.remove();
+  }
+}
+
+exports.load = load;
+exports.unload = unload;

package/dist/index.esm.js

@@ -0,0 +1,52 @@
+var CDN_URL = "https://script.orbithunt.com/js/tracker.js";
+
+/**
+ * Load the OrbitHunt tracker by injecting the CDN script tag.
+ * Safe to call in SSR — does nothing on the server.
+ *
+ * @param {string} trackerId - Your OrbitHunt tracker ID
+ * @param {Object} [options]
+ * @param {string} [options.ingestUrl] - Custom ingest endpoint
+ * @param {string} [options.rrwebCdn] - Custom rrweb CDN URL
+ */
+function load(trackerId, options) {
+  if (typeof window === "undefined") return;
+
+  if (!trackerId) {
+    console.error("[OrbitHunt] trackerId is required");
+    return;
+  }
+
+  // Prevent double-loading
+  if (document.querySelector("script[data-orbithunt-loader]")) {
+    console.warn("[OrbitHunt] Tracker already loaded");
+    return;
+  }
+
+  var opts = options || {};
+  var script = document.createElement("script");
+  script.src = CDN_URL;
+  script.async = true;
+  script.setAttribute("data-tracker-id", trackerId);
+  script.setAttribute("data-orbithunt-loader", "true");
+
+  if (opts.ingestUrl) script.setAttribute("data-ingest-url", opts.ingestUrl);
+  if (opts.rrwebCdn) script.setAttribute("data-rrweb-cdn", opts.rrwebCdn);
+
+  document.head.appendChild(script);
+}
+
+/**
+ * Remove the OrbitHunt tracker script tag.
+ * Safe to call in SSR — does nothing on the server.
+ */
+function unload() {
+  if (typeof window === "undefined") return;
+
+  var script = document.querySelector("script[data-orbithunt-loader]");
+  if (script) {
+    script.remove();
+  }
+}
+
+export { load, unload };

package/package.json

@@ -0,0 +1,36 @@
+{
+  "name": "@orbithunt/tracker",
+  "version": "1.0.0-beta.2",
+  "description": "OrbitHunt session recording tracker — lightweight CDN loader for any framework",
+  "license": "SEE LICENSE IN LICENSE",
+  "main": "./dist/index.cjs.js",
+  "module": "./dist/index.esm.js",
+  "types": "./src/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./src/index.d.ts",
+      "import": "./dist/index.esm.js",
+      "require": "./dist/index.cjs.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src/index.d.ts",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "rollup -c ../../rollup.config.mjs --environment PACKAGE:tracker"
+  },
+  "keywords": [
+    "analytics",
+    "session-recording",
+    "session-replay",
+    "rrweb",
+    "web-analytics",
+    "orbithunt",
+    "heatmap",
+    "user-tracking"
+  ],
+  "homepage": "https://orbithunt.com"
+}

package/src/index.d.ts

@@ -0,0 +1,18 @@
+export interface LoadOptions {
+  /** Custom ingest endpoint URL */
+  ingestUrl?: string;
+  /** Custom rrweb CDN URL */
+  rrwebCdn?: string;
+}
+
+/**
+ * Load the OrbitHunt tracker by injecting the CDN script tag.
+ * Safe to call in SSR — does nothing on the server.
+ */
+export function load(trackerId: string, options?: LoadOptions): void;
+
+/**
+ * Remove the OrbitHunt tracker script tag.
+ * Safe to call in SSR — does nothing on the server.
+ */
+export function unload(): void;