@neowhale/telemetry 1.0.0

package/dist/breadcrumbs.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Breadcrumb collector — records click, navigation, console, and network events.
+ * Maintains a ring buffer of the most recent 25 breadcrumbs.
+ */
+import type { Breadcrumb } from "./types.js";
+export declare function addBreadcrumb(category: string, message: string, level?: Breadcrumb["level"], data?: Record<string, unknown>): void;
+export declare function getBreadcrumbs(): Breadcrumb[];
+export declare function clearBreadcrumbs(): void;
+export declare function installBreadcrumbs(): void;
+//# sourceMappingURL=breadcrumbs.d.ts.map

package/dist/breadcrumbs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.d.ts","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAM7C,wBAAgB,aAAa,CAC3B,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,UAAU,CAAC,OAAO,CAAU,EACnC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI,CAWN;AAED,wBAAgB,cAAc,IAAI,UAAU,EAAE,CAE7C;AAED,wBAAgB,gBAAgB,IAAI,IAAI,CAEvC;AAED,wBAAgB,kBAAkB,IAAI,IAAI,CAsEzC"}

package/dist/breadcrumbs.js

@@ -0,0 +1,89 @@
+/**
+ * Breadcrumb collector — records click, navigation, console, and network events.
+ * Maintains a ring buffer of the most recent 25 breadcrumbs.
+ */
+const MAX_BREADCRUMBS = 25;
+const breadcrumbs = [];
+let installed = false;
+export function addBreadcrumb(category, message, level = "info", data) {
+    breadcrumbs.push({
+        timestamp: new Date().toISOString(),
+        category,
+        message,
+        level,
+        data,
+    });
+    if (breadcrumbs.length > MAX_BREADCRUMBS) {
+        breadcrumbs.shift();
+    }
+}
+export function getBreadcrumbs() {
+    return [...breadcrumbs];
+}
+export function clearBreadcrumbs() {
+    breadcrumbs.length = 0;
+}
+export function installBreadcrumbs() {
+    if (installed || typeof window === "undefined")
+        return;
+    installed = true;
+    // Click breadcrumbs
+    document.addEventListener("click", (e) => {
+        const target = e.target;
+        if (!target)
+            return;
+        const tag = target.tagName?.toLowerCase();
+        const text = target.textContent?.slice(0, 50) || "";
+        const id = target.id ? `#${target.id}` : "";
+        const cls = target.className
+            ? `.${String(target.className).split(" ")[0]}`
+            : "";
+        addBreadcrumb("ui.click", `${tag}${id}${cls} "${text.trim()}"`, "info");
+    }, { capture: true, passive: true });
+    // Navigation breadcrumbs (SPA route changes)
+    const origPushState = history.pushState;
+    history.pushState = function (...args) {
+        origPushState.apply(this, args);
+        addBreadcrumb("navigation", `${window.location.pathname}`, "info");
+    };
+    const origReplaceState = history.replaceState;
+    history.replaceState = function (...args) {
+        origReplaceState.apply(this, args);
+        addBreadcrumb("navigation", `${window.location.pathname}`, "info");
+    };
+    window.addEventListener("popstate", () => {
+        addBreadcrumb("navigation", `${window.location.pathname}`, "info");
+    });
+    // Console breadcrumbs (intercept console.warn/error)
+    const origWarn = console.warn;
+    console.warn = function (...args) {
+        addBreadcrumb("console", String(args[0]).slice(0, 200), "warning");
+        origWarn.apply(console, args);
+    };
+    const origError = console.error;
+    console.error = function (...args) {
+        addBreadcrumb("console", String(args[0]).slice(0, 200), "error");
+        origError.apply(console, args);
+    };
+    // Fetch breadcrumbs
+    const origFetch = window.fetch;
+    window.fetch = async function (input, init) {
+        const url = typeof input === "string" ? input : input instanceof URL ? input.href : input.url;
+        const method = init?.method || "GET";
+        const start = Date.now();
+        try {
+            const response = await origFetch.call(window, input, init);
+            addBreadcrumb("http", `${method} ${url} [${response.status}]`, response.ok ? "info" : "warning", {
+                duration_ms: Date.now() - start,
+            });
+            return response;
+        }
+        catch (err) {
+            addBreadcrumb("http", `${method} ${url} [FAILED]`, "error", {
+                duration_ms: Date.now() - start,
+            });
+            throw err;
+        }
+    };
+}
+//# sourceMappingURL=breadcrumbs.js.map

package/dist/breadcrumbs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"breadcrumbs.js","sourceRoot":"","sources":["../src/breadcrumbs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,MAAM,eAAe,GAAG,EAAE,CAAC;AAC3B,MAAM,WAAW,GAAiB,EAAE,CAAC;AACrC,IAAI,SAAS,GAAG,KAAK,CAAC;AAEtB,MAAM,UAAU,aAAa,CAC3B,QAAgB,EAChB,OAAe,EACf,QAA6B,MAAM,EACnC,IAA8B;IAE9B,WAAW,CAAC,IAAI,CAAC;QACf,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;QACnC,QAAQ;QACR,OAAO;QACP,KAAK;QACL,IAAI;KACL,CAAC,CAAC;IACH,IAAI,WAAW,CAAC,MAAM,GAAG,eAAe,EAAE,CAAC;QACzC,WAAW,CAAC,KAAK,EAAE,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,CAAC,GAAG,WAAW,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,gBAAgB;IAC9B,WAAW,CAAC,MAAM,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,MAAM,UAAU,kBAAkB;IAChC,IAAI,SAAS,IAAI,OAAO,MAAM,KAAK,WAAW;QAAE,OAAO;IACvD,SAAS,GAAG,IAAI,CAAC;IAEjB,oBAAoB;IACpB,QAAQ,CAAC,gBAAgB,CACvB,OAAO,EACP,CAAC,CAAC,EAAE,EAAE;QACJ,MAAM,MAAM,GAAG,CAAC,CAAC,MAAqB,CAAC;QACvC,IAAI,CAAC,MAAM;YAAE,OAAO;QACpB,MAAM,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,WAAW,EAAE,CAAC;QAC1C,MAAM,IAAI,GAAG,MAAM,CAAC,WAAW,EAAE,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;QACpD,MAAM,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5C,MAAM,GAAG,GAAG,MAAM,CAAC,SAAS;YAC1B,CAAC,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE;YAC9C,CAAC,CAAC,EAAE,CAAC;QACP,aAAa,CAAC,UAAU,EAAE,GAAG,GAAG,GAAG,EAAE,GAAG,GAAG,KAAK,IAAI,CAAC,IAAI,EAAE,GAAG,EAAE,MAAM,CAAC,CAAC;IAC1E,CAAC,EACD,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,CACjC,CAAC;IAEF,6CAA6C;IAC7C,MAAM,aAAa,GAAG,OAAO,CAAC,SAAS,CAAC;IACxC,OAAO,CAAC,SAAS,GAAG,UAAU,GAAG,IAAI;QACnC,aAAa,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,aAAa,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,MAAM,gBAAgB,GAAG,OAAO,CAAC,YAAY,CAAC;IAC9C,OAAO,CAAC,YAAY,GAAG,UAAU,GAAG,IAAI;QACtC,gBAAgB,CAAC,KAAK,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACnC,aAAa,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE;QACvC,aAAa,CAAC,YAAY,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,EAAE,MAAM,CAAC,CAAC;IACrE,CAAC,CAAC,CAAC;IAEH,qDAAqD;IACrD,MAAM,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAC9B,OAAO,CAAC,IAAI,GAAG,UAAU,GAAG,IAAe;QACzC,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;QACnE,QAAQ,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IAChC,CAAC,CAAC;IAEF,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC;IAChC,OAAO,CAAC,KAAK,GAAG,UAAU,GAAG,IAAe;QAC1C,aAAa,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACjE,SAAS,CAAC,KAAK,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;IACjC,CAAC,CAAC;IAEF,oBAAoB;IACpB,MAAM,SAAS,GAAG,MAAM,CAAC,KAAK,CAAC;IAC/B,MAAM,CAAC,KAAK,GAAG,KAAK,WAAW,KAAK,EAAE,IAAI;QACxC,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,YAAY,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAE,KAAiB,CAAC,GAAG,CAAC;QAC3G,MAAM,MAAM,GAAG,IAAI,EAAE,MAAM,IAAI,KAAK,CAAC;QACrC,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACzB,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,CAAC,CAAC;YAC3D,aAAa,CAAC,MAAM,EAAE,GAAG,MAAM,IAAI,GAAG,KAAK,QAAQ,CAAC,MAAM,GAAG,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE;gBAC/F,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAChC,CAAC,CAAC;YACH,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,aAAa,CAAC,MAAM,EAAE,GAAG,MAAM,IAAI,GAAG,WAAW,EAAE,OAAO,EAAE;gBAC1D,WAAW,EAAE,IAAI,CAAC,GAAG,EAAE,GAAG,KAAK;aAChC,CAAC,CAAC;YACH,MAAM,GAAG,CAAC;QACZ,CAAC;IACH,CAAC,CAAC;AACJ,CAAC"}

package/dist/client.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Core WhaleTools telemetry client.
+ * Orchestrates error capture, analytics, Web Vitals, breadcrumbs, and transport.
+ */
+import type { WhaleToolsConfig, ErrorPayload } from "./types.js";
+export declare class WhaleToolsClient {
+    private config;
+    private transport;
+    private user;
+    private initialized;
+    private beforeSend?;
+    constructor();
+    init(config: WhaleToolsConfig): void;
+    /** Manually capture an error. */
+    captureError(error: Error | string, extra?: Record<string, unknown>): Promise<void>;
+    /** Capture a message as an error event. */
+    captureMessage(message: string, severity?: ErrorPayload["severity"], extra?: Record<string, unknown>): Promise<void>;
+    /** Track a custom analytics event. */
+    track(eventName: string, properties?: Record<string, unknown>): void;
+    /** Track a page view. */
+    page(properties?: Record<string, unknown>): void;
+    /** Identify the current user. */
+    identify(userId: string, traits?: Record<string, unknown>): void;
+    /** Add a manual breadcrumb. */
+    addBreadcrumb(category: string, message: string, data?: Record<string, unknown>): void;
+    /** Force flush all queued telemetry. */
+    flush(): void;
+    /** Shut down the client. */
+    destroy(): void;
+    private installErrorHandlers;
+    private installPageTracking;
+    private installWebVitals;
+    private observeVital;
+    private reportVital;
+    private rateVital;
+    private buildErrorPayload;
+    private getSessionContext;
+    private shouldSample;
+}
+//# 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":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,gBAAgB,EAChB,YAAY,EAKb,MAAM,YAAY,CAAC;AAkBpB,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,MAAM,CAaiB;IAC/B,OAAO,CAAC,SAAS,CAAY;IAC7B,OAAO,CAAC,IAAI,CAA0B;IACtC,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAC,CAAiC;;IA4BpD,IAAI,CAAC,MAAM,EAAE,gBAAgB,GAAG,IAAI;IAoDpC,iCAAiC;IAC3B,YAAY,CAChB,KAAK,EAAE,KAAK,GAAG,MAAM,EACrB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC;IAOhB,2CAA2C;IACrC,cAAc,CAClB,OAAO,EAAE,MAAM,EACf,QAAQ,GAAE,YAAY,CAAC,UAAU,CAAU,EAC3C,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC;IAOhB,sCAAsC;IACtC,KAAK,CAAC,SAAS,EAAE,MAAM,EAAE,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAiBpE,yBAAyB;IACzB,IAAI,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWhD,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAWhE,+BAA+B;IAC/B,aAAa,CACX,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,MAAM,EACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC7B,IAAI;IAIP,wCAAwC;IACxC,KAAK,IAAI,IAAI;IAIb,4BAA4B;IAC5B,OAAO,IAAI,IAAI;IASf,OAAO,CAAC,oBAAoB;IAyC5B,OAAO,CAAC,mBAAmB;IAsB3B,OAAO,CAAC,gBAAgB;IAuCxB,OAAO,CAAC,YAAY;IAgBpB,OAAO,CAAC,WAAW;IAkBnB,OAAO,CAAC,SAAS;YAuBH,iBAAiB;IA+C/B,OAAO,CAAC,iBAAiB;IAyBzB,OAAO,CAAC,YAAY;CAGrB"}

package/dist/client.js

@@ -0,0 +1,348 @@
+/**
+ * Core WhaleTools telemetry client.
+ * Orchestrates error capture, analytics, Web Vitals, breadcrumbs, and transport.
+ */
+import { computeFingerprint, parseStack } from "./fingerprint.js";
+import { getVisitorId, getSessionId, getSessionStartedAt, detectDevice, getUtmParams, } from "./session.js";
+import { addBreadcrumb, getBreadcrumbs, installBreadcrumbs, } from "./breadcrumbs.js";
+import { Transport } from "./transport.js";
+const DEFAULT_ENDPOINT = "https://whale-gateway.fly.dev";
+export class WhaleToolsClient {
+    config;
+    transport;
+    user;
+    initialized = false;
+    beforeSend;
+    constructor() {
+        // Defaults — overridden by init()
+        this.config = {
+            apiKey: "",
+            storeId: "",
+            endpoint: DEFAULT_ENDPOINT,
+            environment: "production",
+            serviceName: "store_client",
+            serviceVersion: "",
+            flushInterval: 5000,
+            flushThreshold: 10,
+            debug: false,
+            sampleRate: 1,
+        };
+        this.transport = new Transport({
+            apiKey: "",
+            storeId: "",
+            endpoint: DEFAULT_ENDPOINT,
+            flushInterval: 5000,
+            flushThreshold: 10,
+            debug: false,
+            getSession: () => this.getSessionContext(),
+            getUser: () => this.user,
+        });
+    }
+    init(config) {
+        if (this.initialized)
+            return;
+        this.initialized = true;
+        this.config = {
+            apiKey: config.apiKey,
+            storeId: config.storeId,
+            endpoint: config.endpoint || DEFAULT_ENDPOINT,
+            environment: config.environment || "production",
+            serviceName: config.serviceName || "store_client",
+            serviceVersion: config.serviceVersion || "",
+            flushInterval: config.flushInterval || 5000,
+            flushThreshold: config.flushThreshold || 10,
+            debug: config.debug || false,
+            sampleRate: config.sampleRate ?? 1,
+        };
+        this.beforeSend = config.beforeSend;
+        this.transport = new Transport({
+            apiKey: this.config.apiKey,
+            storeId: this.config.storeId,
+            endpoint: this.config.endpoint,
+            flushInterval: this.config.flushInterval,
+            flushThreshold: this.config.flushThreshold,
+            debug: this.config.debug,
+            getSession: () => this.getSessionContext(),
+            getUser: () => this.user,
+        });
+        // Install auto-capture
+        if (typeof window !== "undefined") {
+            if (config.breadcrumbs !== false)
+                installBreadcrumbs();
+            if (config.errors !== false)
+                this.installErrorHandlers();
+            if (config.analytics !== false)
+                this.installPageTracking();
+            if (config.vitals !== false)
+                this.installWebVitals();
+        }
+        this.transport.start();
+        if (this.config.debug) {
+            console.log("[whaletools] initialized", {
+                storeId: this.config.storeId,
+                endpoint: this.config.endpoint,
+            });
+        }
+    }
+    // ===========================================================================
+    // Public API
+    // ===========================================================================
+    /** Manually capture an error. */
+    async captureError(error, extra) {
+        const err = typeof error === "string" ? new Error(error) : error;
+        const payload = await this.buildErrorPayload(err, "error", extra);
+        if (!payload)
+            return;
+        this.transport.queueError(payload);
+    }
+    /** Capture a message as an error event. */
+    async captureMessage(message, severity = "info", extra) {
+        const err = new Error(message);
+        const payload = await this.buildErrorPayload(err, severity, extra);
+        if (!payload)
+            return;
+        this.transport.queueError(payload);
+    }
+    /** Track a custom analytics event. */
+    track(eventName, properties) {
+        if (!this.shouldSample())
+            return;
+        const event = {
+            event_name: eventName,
+            properties: {
+                ...properties,
+                page_url: typeof window !== "undefined" ? window.location.href : "",
+                page_title: typeof document !== "undefined" ? document.title : "",
+            },
+            timestamp: new Date().toISOString(),
+        };
+        this.transport.queueEvent(event);
+        addBreadcrumb("track", `${eventName}`, "info", properties);
+    }
+    /** Track a page view. */
+    page(properties) {
+        this.track("page_view", {
+            page_url: typeof window !== "undefined" ? window.location.href : "",
+            page_path: typeof window !== "undefined" ? window.location.pathname : "",
+            page_title: typeof document !== "undefined" ? document.title : "",
+            ...properties,
+        });
+    }
+    /** Identify the current user. */
+    identify(userId, traits) {
+        this.user = {
+            user_id: userId,
+            email: traits?.email,
+            name: traits?.name,
+            traits,
+        };
+        this.track("identify", { user_id: userId, ...traits });
+    }
+    /** Add a manual breadcrumb. */
+    addBreadcrumb(category, message, data) {
+        addBreadcrumb(category, message, "info", data);
+    }
+    /** Force flush all queued telemetry. */
+    flush() {
+        this.transport.flush();
+    }
+    /** Shut down the client. */
+    destroy() {
+        this.transport.stop();
+        this.initialized = false;
+    }
+    // ===========================================================================
+    // Internal: Error Handlers
+    // ===========================================================================
+    installErrorHandlers() {
+        // Global unhandled errors
+        window.addEventListener("error", (event) => {
+            if (event.error) {
+                this.buildErrorPayload(event.error, "error").then((p) => {
+                    if (p)
+                        this.transport.queueError(p);
+                });
+            }
+            else {
+                // Script errors without error object
+                this.buildErrorPayload(new Error(event.message || "Script error"), "error", {
+                    filename: event.filename,
+                    lineno: event.lineno,
+                    colno: event.colno,
+                }).then((p) => {
+                    if (p)
+                        this.transport.queueError(p);
+                });
+            }
+        });
+        // Unhandled promise rejections
+        window.addEventListener("unhandledrejection", (event) => {
+            const error = event.reason instanceof Error
+                ? event.reason
+                : new Error(String(event.reason));
+            this.buildErrorPayload(error, "error", {
+                type: "unhandledrejection",
+            }).then((p) => {
+                if (p)
+                    this.transport.queueError(p);
+            });
+        });
+    }
+    // ===========================================================================
+    // Internal: Page Tracking
+    // ===========================================================================
+    installPageTracking() {
+        // Track initial page load
+        this.page();
+        // Track SPA navigation via history
+        const origPush = history.pushState;
+        const self = this;
+        history.pushState = function (...args) {
+            origPush.apply(this, args);
+            // Defer to let React update document.title
+            setTimeout(() => self.page(), 50);
+        };
+        window.addEventListener("popstate", () => {
+            setTimeout(() => this.page(), 50);
+        });
+    }
+    // ===========================================================================
+    // Internal: Web Vitals
+    // ===========================================================================
+    installWebVitals() {
+        if (typeof PerformanceObserver === "undefined")
+            return;
+        // Largest Contentful Paint
+        this.observeVital("largest-contentful-paint", (entry) => {
+            this.reportVital("LCP", entry.startTime);
+        });
+        // First Input Delay / Interaction to Next Paint
+        this.observeVital("first-input", (entry) => {
+            const fid = entry.processingStart - entry.startTime;
+            this.reportVital("FID", fid);
+        });
+        // Cumulative Layout Shift
+        let clsValue = 0;
+        this.observeVital("layout-shift", (entry) => {
+            if (!entry.hadRecentInput) {
+                clsValue += entry.value;
+            }
+        });
+        // Report CLS on visibility change (when user leaves page)
+        if (typeof document !== "undefined") {
+            document.addEventListener("visibilitychange", () => {
+                if (document.visibilityState === "hidden" && clsValue > 0) {
+                    this.reportVital("CLS", clsValue);
+                }
+            });
+        }
+        // First Contentful Paint
+        this.observeVital("paint", (entry) => {
+            if (entry.name === "first-contentful-paint") {
+                this.reportVital("FCP", entry.startTime);
+            }
+        });
+    }
+    observeVital(type, callback) {
+        try {
+            const observer = new PerformanceObserver((list) => {
+                for (const entry of list.getEntries()) {
+                    callback(entry);
+                }
+            });
+            observer.observe({ type, buffered: true });
+        }
+        catch {
+            // Observer not supported for this type
+        }
+    }
+    reportVital(name, value) {
+        const rating = this.rateVital(name, value);
+        const vital = {
+            name,
+            value: Math.round(value * 1000) / 1000,
+            rating,
+            timestamp: new Date().toISOString(),
+        };
+        this.transport.queueVital(vital);
+        if (this.config.debug) {
+            console.log(`[whaletools] vital ${name}=${vital.value} (${rating})`);
+        }
+    }
+    rateVital(name, value) {
+        // Thresholds from web.dev
+        const thresholds = {
+            CLS: [0.1, 0.25],
+            FID: [100, 300],
+            LCP: [2500, 4000],
+            INP: [200, 500],
+            TTFB: [800, 1800],
+            FCP: [1800, 3000],
+        };
+        const [good, poor] = thresholds[name] || [1000, 3000];
+        if (value <= good)
+            return "good";
+        if (value <= poor)
+            return "needs-improvement";
+        return "poor";
+    }
+    // ===========================================================================
+    // Internal: Helpers
+    // ===========================================================================
+    async buildErrorPayload(error, severity, extra) {
+        const stack = error.stack || "";
+        const parsed = parseStack(stack);
+        const fingerprint = await computeFingerprint(error.name || "Error", error.message || "Unknown error", `${parsed.file}:${parsed.line}:${parsed.func}`);
+        let payload = {
+            error_type: error.name || "Error",
+            error_message: (error.message || "Unknown error").slice(0, 1000),
+            stack_trace: stack.slice(0, 8000),
+            fingerprint,
+            severity,
+            source_file: parsed.file,
+            source_line: parsed.line,
+            source_function: parsed.func,
+            tags: {
+                environment: this.config.environment,
+                service: this.config.serviceName,
+            },
+            extra: extra || {},
+            breadcrumbs: getBreadcrumbs(),
+            occurred_at: new Date().toISOString(),
+            platform: typeof window !== "undefined" ? "browser" : "node",
+        };
+        if (this.config.serviceVersion) {
+            payload.tags.version = this.config.serviceVersion;
+        }
+        // beforeSend hook
+        if (this.beforeSend) {
+            const result = this.beforeSend(payload);
+            if (result === false)
+                return null;
+            payload = result;
+        }
+        return payload;
+    }
+    getSessionContext() {
+        const utm = getUtmParams();
+        return {
+            session_id: getSessionId(),
+            visitor_id: getVisitorId(),
+            started_at: getSessionStartedAt(),
+            page_url: typeof window !== "undefined" ? window.location.href : "",
+            referrer: typeof document !== "undefined" ? document.referrer : "",
+            user_agent: typeof navigator !== "undefined" ? navigator.userAgent : "",
+            screen_width: typeof screen !== "undefined" ? screen.width : 0,
+            screen_height: typeof screen !== "undefined" ? screen.height : 0,
+            device: detectDevice(),
+            language: typeof navigator !== "undefined"
+                ? navigator.language
+                : "en",
+            ...utm,
+        };
+    }
+    shouldSample() {
+        return Math.random() < this.config.sampleRate;
+    }
+}
+//# 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/fingerprint.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Error fingerprinting — SHA-256 hash of normalized (errorType | message | source).
+ * Same algorithm as supabase/functions/_shared/error-logger.ts
+ */
+/** Normalize a message to group similar errors. */
+export declare function normalizeMessage(msg: string): string;
+/** Compute SHA-256 fingerprint for an error. */
+export declare function computeFingerprint(errorType: string, errorMessage: string, sourceLocation: string): Promise<string>;
+/** Parse a stack trace string into source location info. */
+export declare function parseStack(stack: string): {
+    file: string;
+    line: number;
+    func: string;
+};
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../src/fingerprint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,mDAAmD;AACnD,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAepD;AAED,gDAAgD;AAChD,wBAAsB,kBAAkB,CACtC,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,MAAM,EACpB,cAAc,EAAE,MAAM,GACrB,OAAO,CAAC,MAAM,CAAC,CAkBjB;AAED,4DAA4D;AAC5D,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG;IACzC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAkBA"}

package/dist/fingerprint.js

@@ -0,0 +1,58 @@
+/**
+ * Error fingerprinting — SHA-256 hash of normalized (errorType | message | source).
+ * Same algorithm as supabase/functions/_shared/error-logger.ts
+ */
+/** Normalize a message to group similar errors. */
+export function normalizeMessage(msg) {
+    return msg
+        // UUIDs
+        .replace(/[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}/gi, "<UUID>")
+        // URLs
+        .replace(/https?:\/\/[^\s)]+/g, "<URL>")
+        // Emails
+        .replace(/[\w.-]+@[\w.-]+\.\w+/g, "<EMAIL>")
+        // IPs
+        .replace(/\b\d{1,3}\.\d{1,3}\.\d{1,3}\.\d{1,3}\b/g, "<IP>")
+        // Numbers (standalone)
+        .replace(/\b\d{3,}\b/g, "<N>")
+        // Quoted strings
+        .replace(/"[^"]{4,}"/g, '"<STR>"')
+        .replace(/'[^']{4,}'/g, "'<STR>'");
+}
+/** Compute SHA-256 fingerprint for an error. */
+export async function computeFingerprint(errorType, errorMessage, sourceLocation) {
+    const normalized = normalizeMessage(errorMessage);
+    const input = `${errorType}|${normalized}|${sourceLocation}`;
+    // Use SubtleCrypto in browser, fall back to basic hash
+    if (typeof globalThis.crypto?.subtle?.digest === "function") {
+        const encoded = new TextEncoder().encode(input);
+        const hashBuffer = await crypto.subtle.digest("SHA-256", encoded);
+        const hashArray = Array.from(new Uint8Array(hashBuffer));
+        return hashArray.map((b) => b.toString(16).padStart(2, "0")).join("");
+    }
+    // Fallback: simple djb2 hash (for environments without SubtleCrypto)
+    let hash = 5381;
+    for (let i = 0; i < input.length; i++) {
+        hash = ((hash << 5) + hash + input.charCodeAt(i)) >>> 0;
+    }
+    return hash.toString(16).padStart(16, "0");
+}
+/** Parse a stack trace string into source location info. */
+export function parseStack(stack) {
+    if (!stack)
+        return { file: "", line: 0, func: "" };
+    const lines = stack.split("\n");
+    // Find first meaningful stack frame (skip Error: message line)
+    for (const line of lines) {
+        const match = line.match(/at\s+(?:(.+?)\s+\()?(?:(.+?):(\d+):\d+)\)?/);
+        if (match) {
+            return {
+                func: match[1] || "<anonymous>",
+                file: match[2] || "",
+                line: parseInt(match[3] || "0", 10),
+            };
+        }
+    }
+    return { file: "", line: 0, func: "" };
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/fingerprint.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+/**
+ * @whaletools/telemetry — Error tracking, analytics & Web Vitals for WhaleTools stores.
+ *
+ * Usage:
+ *   import { whaletools } from '@whaletools/telemetry'
+ *
+ *   whaletools.init({ apiKey: 'wk_live_...', storeId: '...' })
+ *   whaletools.track('purchase', { amount: 49.99 })
+ *   whaletools.captureError(new Error('Something broke'))
+ */
+import { WhaleToolsClient } from "./client.js";
+export declare const whaletools: WhaleToolsClient;
+export { WhaleToolsClient } from "./client.js";
+export { addBreadcrumb } from "./breadcrumbs.js";
+export type { WhaleToolsConfig, ErrorPayload, AnalyticsEvent, WebVital, Breadcrumb, TelemetryBatch, SessionContext, UserContext, } 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;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAG/C,eAAO,MAAM,UAAU,kBAAyB,CAAC;AAGjD,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,YAAY,EACV,gBAAgB,EAChB,YAAY,EACZ,cAAc,EACd,QAAQ,EACR,UAAU,EACV,cAAc,EACd,cAAc,EACd,WAAW,GACZ,MAAM,YAAY,CAAC"}

package/dist/index.js

@@ -0,0 +1,17 @@
+/**
+ * @whaletools/telemetry — Error tracking, analytics & Web Vitals for WhaleTools stores.
+ *
+ * Usage:
+ *   import { whaletools } from '@whaletools/telemetry'
+ *
+ *   whaletools.init({ apiKey: 'wk_live_...', storeId: '...' })
+ *   whaletools.track('purchase', { amount: 49.99 })
+ *   whaletools.captureError(new Error('Something broke'))
+ */
+import { WhaleToolsClient } from "./client.js";
+// Singleton instance
+export const whaletools = new WhaleToolsClient();
+// Named exports for tree-shaking
+export { WhaleToolsClient } from "./client.js";
+export { addBreadcrumb } from "./breadcrumbs.js";
+//# 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;;;;;;;;;GASG;AAEH,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAE/C,qBAAqB;AACrB,MAAM,CAAC,MAAM,UAAU,GAAG,IAAI,gBAAgB,EAAE,CAAC;AAEjD,iCAAiC;AACjC,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC"}