@scoperat/tracker 0.1.0

package/README.md

@@ -0,0 +1,75 @@
+# @scoperat/tracker
+
+Browser analytics SDK.
+
+## Install
+
+```bash
+npm install @scoperat/tracker
+```
+
+## Quick Start
+
+```typescript
+import scoperat from "@scoperat/tracker";
+
+// Initialize once at app startup (endpoint defaults to window.location.origin)
+scoperat.init("tk_live_your_write_key");
+
+// Identify the current user after login
+scoperat.identify("user_123", { email: "user@example.com", orgId: "org_456" });
+
+// Track events
+scoperat.track("button_clicked", { buttonId: "signup-cta", page: "/pricing" });
+
+// Reset on logout
+scoperat.reset();
+```
+
+## API
+
+### `scoperat.init(writeKey, options?)`
+
+Initialize the tracker. Must be called before any other method.
+
+| Option          | Type                      | Default                  | Description                  |
+| --------------- | ------------------------- | ------------------------ | ---------------------------- |
+| `endpoint`      | `string`                  | `window.location.origin` | API base URL                 |
+| `flushAt`       | `number`                  | `10`                     | Flush after this many events |
+| `flushInterval` | `number`                  | `3000`                   | Auto-flush interval in ms    |
+| `timeout`       | `number`                  | `10000`                  | Request timeout in ms        |
+| `onError`       | `(error, events) => void` | —                        | Error callback               |
+
+### `scoperat.identify(userId, traits?)`
+
+Associate events with a user. Traits are merged into every event's context.
+
+### `scoperat.track(event, properties?)`
+
+Enqueue a tracking event. Events are batched and flushed automatically.
+
+### `scoperat.reset()`
+
+Clear user identity and generate a new anonymous ID. Call on logout.
+
+### `scoperat.flush()`
+
+Manually flush the event buffer. Returns a `Promise<FlushResult>`.
+
+### `scoperat.shutdown()`
+
+Flush remaining events and stop the auto-flush timer. Call before app teardown.
+
+## Features
+
+- **Auto-batching** — events are buffered and sent in batches for efficiency
+- **Anonymous IDs** — persistent anonymous ID via `localStorage`, auto-generated on first visit
+- **sendBeacon fallback** — uses `navigator.sendBeacon` on page hide for reliable delivery
+- **Retry on failure** — failed batches are re-queued for the next flush
+- **Zero dependencies** — no runtime dependencies
+- **Tree-shakeable** — marked as side-effect-free for optimal bundling
+- **ESM-only** — ships as pure ES modules
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,27 @@
+import type { FlushResult, IdentifyTraits, InitOptions, TrackEvent } from "./types.js";
+declare class TrackerImpl {
+    private writeKey;
+    private endpoint;
+    private flushAt;
+    private flushInterval;
+    private timeout;
+    private onError?;
+    private buffer;
+    private timer;
+    private visibilityHandler;
+    private userId;
+    private orgId;
+    private traits;
+    private anonymousId;
+    init(writeKey: string, options?: InitOptions): void;
+    identify(userId: string, traits?: IdentifyTraits): void;
+    reset(): void;
+    track(event: string, properties?: Record<string, unknown>): void;
+    track(event: TrackEvent): void;
+    flush(): Promise<FlushResult>;
+    private flushSync;
+    shutdown(): Promise<void>;
+}
+declare const scoperat: TrackerImpl;
+export default scoperat;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EACV,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,EACX,MAAM,YAAY,CAAC;AAoCpB,cAAM,WAAW;IACf,OAAO,CAAC,QAAQ,CAAuB;IACvC,OAAO,CAAC,QAAQ,CAAc;IAC9B,OAAO,CAAC,OAAO,CAA4B;IAC3C,OAAO,CAAC,aAAa,CAAkC;IACvD,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,OAAO,CAAC,CAA+C;IAE/D,OAAO,CAAC,MAAM,CAAoB;IAClC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,iBAAiB,CAA6B;IACtD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,KAAK,CAAqB;IAClC,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,WAAW,CAAqB;IAExC,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,GAAE,WAAgB,GAAG,IAAI;IAkCvD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,cAAc,GAAG,IAAI;IAQvD,KAAK,IAAI,IAAI;IAOb,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAChE,KAAK,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAoCxB,KAAK,IAAI,OAAO,CAAC,WAAW,CAAC;IAiCnC,OAAO,CAAC,SAAS;IAiBX,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;CAehC;AAED,QAAA,MAAM,QAAQ,aAAoB,CAAC;AACnC,eAAe,QAAQ,CAAC"}

package/dist/client.js

@@ -0,0 +1,178 @@
+import { getBrowserContext } from "./context.js";
+const DEFAULT_FLUSH_AT = 10;
+const DEFAULT_FLUSH_INTERVAL = 3_000;
+const DEFAULT_TIMEOUT = 10_000;
+const MAX_BATCH_SIZE = 100;
+const ANON_ID_KEY = "__scoperat_anon_id";
+function generateAnonId() {
+    if (typeof crypto !== "undefined" && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        const v = c === "x" ? r : (r & 0x3) | 0x8;
+        return v.toString(16);
+    });
+}
+function getOrCreateAnonId() {
+    if (typeof window === "undefined" || typeof localStorage === "undefined") {
+        return undefined;
+    }
+    try {
+        let id = localStorage.getItem(ANON_ID_KEY);
+        if (!id) {
+            id = generateAnonId();
+            localStorage.setItem(ANON_ID_KEY, id);
+        }
+        return id;
+    }
+    catch {
+        return generateAnonId();
+    }
+}
+class TrackerImpl {
+    writeKey = null;
+    endpoint = "";
+    flushAt = DEFAULT_FLUSH_AT;
+    flushInterval = DEFAULT_FLUSH_INTERVAL;
+    timeout = DEFAULT_TIMEOUT;
+    onError;
+    buffer = [];
+    timer = null;
+    visibilityHandler = null;
+    userId;
+    orgId;
+    traits = {};
+    anonymousId;
+    init(writeKey, options = {}) {
+        this.writeKey = writeKey;
+        this.endpoint = (options.endpoint ??
+            globalThis.location?.origin ??
+            "").replace(/\/+$/, "");
+        this.flushAt = options.flushAt ?? DEFAULT_FLUSH_AT;
+        this.flushInterval = options.flushInterval ?? DEFAULT_FLUSH_INTERVAL;
+        this.timeout = options.timeout ?? DEFAULT_TIMEOUT;
+        this.onError = options.onError;
+        this.anonymousId = getOrCreateAnonId();
+        if (this.timer)
+            clearInterval(this.timer);
+        this.timer = setInterval(() => {
+            if (this.buffer.length > 0) {
+                this.flush().catch(() => { });
+            }
+        }, this.flushInterval);
+        if (typeof window !== "undefined") {
+            if (this.visibilityHandler) {
+                window.removeEventListener("visibilitychange", this.visibilityHandler);
+            }
+            this.visibilityHandler = () => {
+                if (document.visibilityState === "hidden" && this.buffer.length > 0) {
+                    this.flushSync();
+                }
+            };
+            window.addEventListener("visibilitychange", this.visibilityHandler);
+        }
+    }
+    identify(userId, traits) {
+        this.userId = userId;
+        if (traits) {
+            this.traits = { ...traits };
+            if (traits.orgId)
+                this.orgId = traits.orgId;
+        }
+    }
+    reset() {
+        this.userId = undefined;
+        this.orgId = undefined;
+        this.traits = {};
+        this.anonymousId = getOrCreateAnonId();
+    }
+    track(eventOrName, properties) {
+        if (!this.writeKey)
+            return;
+        const evt = typeof eventOrName === "string"
+            ? { event: eventOrName, properties }
+            : eventOrName;
+        const traitsContext = Object.keys(this.traits).length > 0 ? { traits: this.traits } : {};
+        const enriched = {
+            ...evt,
+            occurred_at: evt.occurred_at ?? new Date().toISOString(),
+            source: evt.source ?? "browser",
+            org_id: evt.org_id ?? this.orgId,
+            user_id: evt.user_id ?? this.userId,
+            anonymous_id: evt.anonymous_id ?? this.anonymousId,
+            context: {
+                ...getBrowserContext(),
+                ...traitsContext,
+                ...evt.context,
+            },
+        };
+        this.buffer.push(enriched);
+        if (this.buffer.length >= this.flushAt) {
+            this.flush().catch(() => { });
+        }
+    }
+    async flush() {
+        if (!this.writeKey || this.buffer.length === 0) {
+            return { success: true, ingested: 0 };
+        }
+        const batch = this.buffer.splice(0, MAX_BATCH_SIZE);
+        try {
+            const res = await fetch(`${this.endpoint}/api/ingest/track`, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${this.writeKey}`,
+                },
+                body: JSON.stringify({ events: batch }),
+                signal: AbortSignal.timeout(this.timeout),
+            });
+            if (!res.ok) {
+                const body = await res.text().catch(() => "");
+                throw new Error(`API returned ${res.status}: ${body}`);
+            }
+            const json = (await res.json());
+            return { success: true, ingested: json.ingested };
+        }
+        catch (error) {
+            this.buffer.unshift(...batch);
+            const err = error instanceof Error ? error : new Error(String(error));
+            this.onError?.(err, batch);
+            return { success: false, ingested: 0 };
+        }
+    }
+    flushSync() {
+        if (!this.writeKey)
+            return;
+        if (typeof navigator === "undefined" || !navigator.sendBeacon)
+            return;
+        if (this.buffer.length === 0)
+            return;
+        const batch = this.buffer.splice(0, MAX_BATCH_SIZE);
+        const payload = JSON.stringify({ events: batch });
+        const url = `${this.endpoint}/api/ingest/track?key=${encodeURIComponent(this.writeKey)}`;
+        try {
+            const blob = new Blob([payload], { type: "application/json" });
+            navigator.sendBeacon(url, blob);
+        }
+        catch {
+            // Best effort on unload
+        }
+    }
+    async shutdown() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        if (typeof window !== "undefined" && this.visibilityHandler) {
+            window.removeEventListener("visibilitychange", this.visibilityHandler);
+            this.visibilityHandler = null;
+        }
+        while (this.buffer.length > 0) {
+            await this.flush();
+        }
+    }
+}
+const scoperat = new TrackerImpl();
+export default scoperat;
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"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"}

package/dist/context.d.ts

@@ -0,0 +1,5 @@
+/**
+ * Auto-capture browser context: page, referrer, screen, locale, user agent.
+ */
+export declare function getBrowserContext(): Record<string, unknown>;
+//# sourceMappingURL=context.d.ts.map

package/dist/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAoB3D"}

package/dist/context.js

@@ -0,0 +1,24 @@
+/**
+ * Auto-capture browser context: page, referrer, screen, locale, user agent.
+ */
+export function getBrowserContext() {
+    if (typeof window === "undefined") {
+        return {};
+    }
+    return {
+        page: {
+            url: window.location.href,
+            path: window.location.pathname,
+            title: document.title,
+            referrer: document.referrer || undefined,
+        },
+        screen: {
+            width: window.screen.width,
+            height: window.screen.height,
+        },
+        locale: navigator.language,
+        userAgent: navigator.userAgent,
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+    };
+}
+//# sourceMappingURL=context.js.map

package/dist/context.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.js","sourceRoot":"","sources":["../src/context.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,UAAU,iBAAiB;IAC/B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO,EAAE,CAAC;IACZ,CAAC;IAED,OAAO;QACL,IAAI,EAAE;YACJ,GAAG,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI;YACzB,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;YAC9B,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,QAAQ,EAAE,QAAQ,CAAC,QAAQ,IAAI,SAAS;SACzC;QACD,MAAM,EAAE;YACN,KAAK,EAAE,MAAM,CAAC,MAAM,CAAC,KAAK;YAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,CAAC,MAAM;SAC7B;QACD,MAAM,EAAE,SAAS,CAAC,QAAQ;QAC1B,SAAS,EAAE,SAAS,CAAC,SAAS;QAC9B,QAAQ,EAAE,IAAI,CAAC,cAAc,EAAE,CAAC,eAAe,EAAE,CAAC,QAAQ;KAC3D,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+import scoperat from "./client.js";
+export default scoperat;
+export type { EventSource, FlushResult, IdentifyTraits, InitOptions, TrackEvent, } from "./types.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,aAAa,CAAC;AAEnC,eAAe,QAAQ,CAAC;AACxB,YAAY,EACV,WAAW,EACX,WAAW,EACX,cAAc,EACd,WAAW,EACX,UAAU,GACX,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,3 @@
+import scoperat from "./client.js";
+export default scoperat;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,QAAQ,MAAM,aAAa,CAAC;AAEnC,eAAe,QAAQ,CAAC"}

package/dist/types.d.ts

@@ -0,0 +1,30 @@
+export type EventSource = "browser" | "server" | "worker";
+export interface TrackEvent {
+    event: string;
+    properties?: Record<string, unknown>;
+    context?: Record<string, unknown>;
+    source?: EventSource;
+    occurred_at?: Date | string;
+    org_id?: string;
+    user_id?: string;
+    anonymous_id?: string;
+}
+export interface IdentifyTraits {
+    orgId?: string;
+    orgName?: string;
+    email?: string;
+    name?: string;
+    [key: string]: unknown;
+}
+export interface InitOptions {
+    endpoint?: string;
+    flushAt?: number;
+    flushInterval?: number;
+    timeout?: number;
+    onError?: (error: Error, events: TrackEvent[]) => void;
+}
+export interface FlushResult {
+    success: boolean;
+    ingested: number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAE1D,MAAM,WAAW,UAAU;IACzB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,WAAW,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACxB;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,KAAK,IAAI,CAAC;CACxD;AAED,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB"}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":""}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@scoperat/tracker",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Browser analytics SDK",
+  "license": "MIT",
+  "sideEffects": false,
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "analytics",
+    "tracking",
+    "events",
+    "telemetry",
+    "browser",
+    "scoperat"
+  ],
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "devDependencies": {
+    "typescript": "^5"
+  },
+  "scripts": {
+    "build": "tsc",
+    "clean": "rm -rf dist",
+    "type-check": "tsc --noEmit"
+  }
+}