@qurvo/sdk-browser 0.0.1

package/dist/index.d.ts

@@ -0,0 +1,24 @@
+export interface BrowserSdkConfig {
+    apiKey: string;
+    endpoint?: string;
+    autocapture?: boolean;
+    flushInterval?: number;
+    flushSize?: number;
+}
+declare class QurvoBrowser {
+    private queue;
+    private userId;
+    private initialized;
+    init(config: BrowserSdkConfig): void;
+    track(event: string, properties?: Record<string, unknown>): void;
+    identify(userId: string, userProperties?: Record<string, unknown>): void;
+    page(properties?: Record<string, unknown>): void;
+    set(properties: Record<string, unknown>): void;
+    setOnce(properties: Record<string, unknown>): void;
+    reset(): void;
+    private setupAutocapture;
+    private setupBeaconFlush;
+}
+export declare const qurvo: QurvoBrowser;
+export {};
+//# 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":"AA8CA,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,cAAM,YAAY;IAChB,OAAO,CAAC,KAAK,CAA2B;IACxC,OAAO,CAAC,MAAM,CAAuB;IACrC,OAAO,CAAC,WAAW,CAAS;IAE5B,IAAI,CAAC,MAAM,EAAE,gBAAgB;IAwB7B,KAAK,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAczD,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAejE,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIzC,GAAG,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAcvC,OAAO,CAAC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAc3C,KAAK;IAML,OAAO,CAAC,gBAAgB;IAYxB,OAAO,CAAC,gBAAgB;CAczB;AAED,eAAO,MAAM,KAAK,cAAqB,CAAC"}

package/dist/index.js

@@ -0,0 +1,147 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qurvo = void 0;
+const sdk_core_1 = require("@qurvo/sdk-core");
+const SDK_NAME = '@qurvo/sdk-browser';
+const SDK_VERSION = '0.0.1';
+const ANON_ID_KEY = 'qurvo_anonymous_id';
+const SESSION_ID_KEY = 'qurvo_session_id';
+function generateId() {
+    return crypto.randomUUID?.() || Math.random().toString(36).substring(2) + Date.now().toString(36);
+}
+function getAnonymousId() {
+    let id = localStorage.getItem(ANON_ID_KEY);
+    if (!id) {
+        id = generateId();
+        localStorage.setItem(ANON_ID_KEY, id);
+    }
+    return id;
+}
+function getSessionId() {
+    let id = sessionStorage.getItem(SESSION_ID_KEY);
+    if (!id) {
+        id = generateId();
+        sessionStorage.setItem(SESSION_ID_KEY, id);
+    }
+    return id;
+}
+function getContext() {
+    return {
+        session_id: getSessionId(),
+        url: window.location.href,
+        referrer: document.referrer,
+        page_title: document.title,
+        page_path: window.location.pathname,
+        screen_width: window.screen.width,
+        screen_height: window.screen.height,
+        language: navigator.language,
+        timezone: Intl.DateTimeFormat().resolvedOptions().timeZone,
+        sdk_name: SDK_NAME,
+        sdk_version: SDK_VERSION,
+    };
+}
+class QurvoBrowser {
+    queue = null;
+    userId = null;
+    initialized = false;
+    init(config) {
+        if (this.initialized)
+            return;
+        const endpoint = config.endpoint || 'http://localhost:3001';
+        const transport = new sdk_core_1.FetchTransport();
+        this.queue = new sdk_core_1.EventQueue(transport, `${endpoint}/v1/batch`, config.apiKey, config.flushInterval || 10000, config.flushSize || 10, 1000);
+        this.queue.start();
+        this.initialized = true;
+        if (config.autocapture !== false) {
+            this.setupAutocapture();
+        }
+        this.setupBeaconFlush();
+        this.page();
+    }
+    track(event, properties) {
+        if (!this.queue)
+            return;
+        const payload = {
+            event,
+            distinct_id: this.userId || getAnonymousId(),
+            anonymous_id: getAnonymousId(),
+            properties,
+            context: getContext(),
+            timestamp: new Date().toISOString(),
+        };
+        this.queue.enqueue(payload);
+    }
+    identify(userId, userProperties) {
+        if (!this.queue)
+            return;
+        this.userId = userId;
+        const payload = {
+            event: '$identify',
+            distinct_id: userId,
+            anonymous_id: getAnonymousId(),
+            user_properties: userProperties,
+            context: getContext(),
+            timestamp: new Date().toISOString(),
+        };
+        this.queue.enqueue(payload);
+    }
+    page(properties) {
+        this.track('$pageview', properties);
+    }
+    set(properties) {
+        if (!this.queue)
+            return;
+        const payload = {
+            event: '$set',
+            distinct_id: this.userId || getAnonymousId(),
+            anonymous_id: getAnonymousId(),
+            user_properties: { $set: properties },
+            context: getContext(),
+            timestamp: new Date().toISOString(),
+        };
+        this.queue.enqueue(payload);
+    }
+    setOnce(properties) {
+        if (!this.queue)
+            return;
+        const payload = {
+            event: '$set_once',
+            distinct_id: this.userId || getAnonymousId(),
+            anonymous_id: getAnonymousId(),
+            user_properties: { $set_once: properties },
+            context: getContext(),
+            timestamp: new Date().toISOString(),
+        };
+        this.queue.enqueue(payload);
+    }
+    reset() {
+        this.userId = null;
+        localStorage.removeItem(ANON_ID_KEY);
+        sessionStorage.removeItem(SESSION_ID_KEY);
+    }
+    setupAutocapture() {
+        const originalPushState = history.pushState;
+        history.pushState = (...args) => {
+            originalPushState.apply(history, args);
+            this.page();
+        };
+        window.addEventListener('popstate', () => {
+            this.page();
+        });
+    }
+    setupBeaconFlush() {
+        const flushForUnload = () => {
+            this.track('$pageleave');
+            if (this.queue && this.queue.size > 0) {
+                this.queue.flushForUnload();
+            }
+        };
+        document.addEventListener('visibilitychange', () => {
+            if (document.visibilityState === 'hidden')
+                flushForUnload();
+        });
+        window.addEventListener('beforeunload', flushForUnload);
+    }
+}
+exports.qurvo = new QurvoBrowser();
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "@qurvo/sdk-browser",
+  "version": "0.0.1",
+  "description": "Browser SDK for Qurvo analytics — event tracking, user identification, auto-capture",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "dependencies": {
+    "@qurvo/sdk-core": "0.0.1"
+  },
+  "devDependencies": {
+    "typescript": "^5.7.0",
+    "@qurvo/tsconfig": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "clean": "rm -rf dist .turbo"
+  }
+}