@neowhale/telemetry 1.0.0

package/dist/react.d.ts

@@ -0,0 +1,39 @@
+/**
+ * React integration for @whaletools/telemetry.
+ *
+ * Usage:
+ *   import { WhaleTelemetry, WhaleErrorBoundary } from '@whaletools/telemetry/react'
+ *
+ *   <WhaleTelemetry apiKey="wk_live_..." storeId="...">
+ *     <WhaleErrorBoundary fallback={<p>Something went wrong</p>}>
+ *       <App />
+ *     </WhaleErrorBoundary>
+ *   </WhaleTelemetry>
+ */
+import { Component, type ReactNode } from "react";
+import { type WhaleToolsConfig } from "./index.js";
+interface WhaleTelemetryProps extends WhaleToolsConfig {
+    children: ReactNode;
+}
+export declare function WhaleTelemetry({ children, ...config }: WhaleTelemetryProps): ReactNode;
+interface ErrorBoundaryProps {
+    children: ReactNode;
+    fallback?: ReactNode | ((error: Error) => ReactNode);
+    onError?: (error: Error, errorInfo: {
+        componentStack: string;
+    }) => void;
+}
+interface ErrorBoundaryState {
+    error: Error | null;
+}
+export declare class WhaleErrorBoundary extends Component<ErrorBoundaryProps, ErrorBoundaryState> {
+    constructor(props: ErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): ErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: {
+        componentStack?: string;
+    }): void;
+    render(): ReactNode;
+}
+export { whaletools } from "./index.js";
+export type { WhaleToolsConfig } from "./types.js";
+//# sourceMappingURL=react.d.ts.map

package/dist/react.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAa,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAc,KAAK,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAM/D,UAAU,mBAAoB,SAAQ,gBAAgB;IACpD,QAAQ,EAAE,SAAS,CAAC;CACrB;AAED,wBAAgB,cAAc,CAAC,EAC7B,QAAQ,EACR,GAAG,MAAM,EACV,EAAE,mBAAmB,GAAG,SAAS,CAOjC;AAMD,UAAU,kBAAkB;IAC1B,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,GAAG,CAAC,CAAC,KAAK,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC;IACrD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;QAAE,cAAc,EAAE,MAAM,CAAA;KAAE,KAAK,IAAI,CAAC;CACzE;AAED,UAAU,kBAAkB;IAC1B,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;CACrB;AAED,qBAAa,kBAAmB,SAAQ,SAAS,CAC/C,kBAAkB,EAClB,kBAAkB,CACnB;gBACa,KAAK,EAAE,kBAAkB;IAKrC,MAAM,CAAC,wBAAwB,CAAC,KAAK,EAAE,KAAK,GAAG,kBAAkB;IAIjE,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE;QAAE,cAAc,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAY7E,MAAM,IAAI,SAAS;CAUpB;AAGD,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AACxC,YAAY,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC"}

package/dist/react.js

@@ -0,0 +1,53 @@
+/**
+ * React integration for @whaletools/telemetry.
+ *
+ * Usage:
+ *   import { WhaleTelemetry, WhaleErrorBoundary } from '@whaletools/telemetry/react'
+ *
+ *   <WhaleTelemetry apiKey="wk_live_..." storeId="...">
+ *     <WhaleErrorBoundary fallback={<p>Something went wrong</p>}>
+ *       <App />
+ *     </WhaleErrorBoundary>
+ *   </WhaleTelemetry>
+ */
+import { Component, useEffect } from "react";
+import { whaletools } from "./index.js";
+export function WhaleTelemetry({ children, ...config }) {
+    useEffect(() => {
+        whaletools.init(config);
+        return () => whaletools.destroy();
+    }, [config.apiKey, config.storeId]);
+    return children;
+}
+export class WhaleErrorBoundary extends Component {
+    constructor(props) {
+        super(props);
+        this.state = { error: null };
+    }
+    static getDerivedStateFromError(error) {
+        return { error };
+    }
+    componentDidCatch(error, errorInfo) {
+        // Report to WhaleTools
+        whaletools.captureError(error, {
+            componentStack: errorInfo.componentStack,
+            type: "react_error_boundary",
+        });
+        this.props.onError?.(error, {
+            componentStack: errorInfo.componentStack || "",
+        });
+    }
+    render() {
+        if (this.state.error) {
+            const { fallback } = this.props;
+            if (typeof fallback === "function") {
+                return fallback(this.state.error);
+            }
+            return fallback ?? null;
+        }
+        return this.props.children;
+    }
+}
+// Re-export core for convenience
+export { whaletools } from "./index.js";
+//# sourceMappingURL=react.js.map

package/dist/react.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"react.js","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,SAAS,EAAE,SAAS,EAAkB,MAAM,OAAO,CAAC;AAC7D,OAAO,EAAE,UAAU,EAAyB,MAAM,YAAY,CAAC;AAU/D,MAAM,UAAU,cAAc,CAAC,EAC7B,QAAQ,EACR,GAAG,MAAM,EACW;IACpB,SAAS,CAAC,GAAG,EAAE;QACb,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;QACxB,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,CAAC;IACpC,CAAC,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IAEpC,OAAO,QAAQ,CAAC;AAClB,CAAC;AAgBD,MAAM,OAAO,kBAAmB,SAAQ,SAGvC;IACC,YAAY,KAAyB;QACnC,KAAK,CAAC,KAAK,CAAC,CAAC;QACb,IAAI,CAAC,KAAK,GAAG,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC;IAC/B,CAAC;IAED,MAAM,CAAC,wBAAwB,CAAC,KAAY;QAC1C,OAAO,EAAE,KAAK,EAAE,CAAC;IACnB,CAAC;IAED,iBAAiB,CAAC,KAAY,EAAE,SAAsC;QACpE,uBAAuB;QACvB,UAAU,CAAC,YAAY,CAAC,KAAK,EAAE;YAC7B,cAAc,EAAE,SAAS,CAAC,cAAc;YACxC,IAAI,EAAE,sBAAsB;SAC7B,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE;YAC1B,cAAc,EAAE,SAAS,CAAC,cAAc,IAAI,EAAE;SAC/C,CAAC,CAAC;IACL,CAAC;IAED,MAAM;QACJ,IAAI,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;YACrB,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC;YAChC,IAAI,OAAO,QAAQ,KAAK,UAAU,EAAE,CAAC;gBACnC,OAAO,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACpC,CAAC;YACD,OAAO,QAAQ,IAAI,IAAI,CAAC;QAC1B,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC;IAC7B,CAAC;CACF;AAED,iCAAiC;AACjC,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Server-side helpers for @whaletools/telemetry.
+ * Works with Next.js API routes, Express, etc.
+ *
+ * Usage (Next.js App Router):
+ *   import { withTelemetry } from '@whaletools/telemetry/server'
+ *
+ *   export const GET = withTelemetry(async (req) => {
+ *     return Response.json({ ok: true })
+ *   }, { apiKey: 'wk_live_...', storeId: '...' })
+ */
+interface ServerConfig {
+    apiKey: string;
+    storeId: string;
+    endpoint?: string;
+    serviceName?: string;
+    environment?: string;
+}
+/**
+ * Wrap a Next.js App Router handler with error telemetry.
+ * Catches unhandled errors, reports them, and re-throws.
+ */
+export declare function withTelemetry<T extends (...args: unknown[]) => Promise<Response>>(handler: T, config: ServerConfig): T;
+/**
+ * Send a server-side error to WhaleTools telemetry.
+ * Use in catch blocks where withTelemetry isn't applicable.
+ */
+export declare function reportServerError(error: Error, config: ServerConfig, extra?: Record<string, unknown>): Promise<void>;
+export {};
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,UAAU,YAAY;IACpB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AA0DD;;;GAGG;AACH,wBAAgB,aAAa,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,OAAO,CAAC,QAAQ,CAAC,EAC/E,OAAO,EAAE,CAAC,EACV,MAAM,EAAE,YAAY,GACnB,CAAC,CAkEH;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,YAAY,EACpB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,OAAO,CAAC,IAAI,CAAC,CAsDf"}

package/dist/server.js

@@ -0,0 +1,162 @@
+/**
+ * Server-side helpers for @whaletools/telemetry.
+ * Works with Next.js API routes, Express, etc.
+ *
+ * Usage (Next.js App Router):
+ *   import { withTelemetry } from '@whaletools/telemetry/server'
+ *
+ *   export const GET = withTelemetry(async (req) => {
+ *     return Response.json({ ok: true })
+ *   }, { apiKey: 'wk_live_...', storeId: '...' })
+ */
+const DEFAULT_ENDPOINT = "https://whale-gateway.fly.dev";
+// Simple server-side fingerprint (no SubtleCrypto needed in Node 18+)
+async function serverFingerprint(type, message, source) {
+    const input = `${type}|${message}|${source}`;
+    if (typeof globalThis.crypto?.subtle?.digest === "function") {
+        const encoded = new TextEncoder().encode(input);
+        const hash = await crypto.subtle.digest("SHA-256", encoded);
+        return Array.from(new Uint8Array(hash))
+            .map((b) => b.toString(16).padStart(2, "0"))
+            .join("");
+    }
+    // Fallback
+    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");
+}
+function parseServerStack(stack) {
+    if (!stack)
+        return { file: "", line: 0, func: "" };
+    const lines = stack.split("\n");
+    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: "" };
+}
+/**
+ * Wrap a Next.js App Router handler with error telemetry.
+ * Catches unhandled errors, reports them, and re-throws.
+ */
+export function withTelemetry(handler, config) {
+    const wrapped = async (...args) => {
+        const start = Date.now();
+        try {
+            return await handler(...args);
+        }
+        catch (error) {
+            const err = error instanceof Error ? error : new Error(String(error));
+            const parsed = parseServerStack(err.stack || "");
+            const fp = await serverFingerprint(err.name, err.message, `${parsed.file}:${parsed.line}:${parsed.func}`);
+            const report = {
+                error_type: err.name || "Error",
+                error_message: err.message.slice(0, 1000),
+                stack_trace: (err.stack || "").slice(0, 8000),
+                fingerprint: fp,
+                severity: "error",
+                source_file: parsed.file,
+                source_line: parsed.line,
+                source_function: parsed.func,
+                tags: {
+                    environment: config.environment || "production",
+                    service: config.serviceName || "store_server",
+                },
+                extra: { handler: "api_route", duration_ms: Date.now() - start },
+                breadcrumbs: [],
+                occurred_at: new Date().toISOString(),
+                platform: "node",
+            };
+            // Fire-and-forget to gateway
+            const endpoint = config.endpoint || DEFAULT_ENDPOINT;
+            const url = `${endpoint}/v1/stores/${config.storeId}/telemetry/ingest`;
+            fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-api-key": config.apiKey,
+                },
+                body: JSON.stringify({
+                    session: {
+                        session_id: "",
+                        visitor_id: "server",
+                        started_at: new Date(start).toISOString(),
+                        page_url: "",
+                        referrer: "",
+                        user_agent: "",
+                        screen_width: 0,
+                        screen_height: 0,
+                        device: "server",
+                        language: "en",
+                    },
+                    errors: [report],
+                    events: [],
+                    vitals: [],
+                }),
+            }).catch(() => { });
+            throw error; // Re-throw so Next.js can handle the error
+        }
+    };
+    return wrapped;
+}
+/**
+ * Send a server-side error to WhaleTools telemetry.
+ * Use in catch blocks where withTelemetry isn't applicable.
+ */
+export async function reportServerError(error, config, extra) {
+    const parsed = parseServerStack(error.stack || "");
+    const fp = await serverFingerprint(error.name, error.message, `${parsed.file}:${parsed.line}:${parsed.func}`);
+    const report = {
+        error_type: error.name || "Error",
+        error_message: error.message.slice(0, 1000),
+        stack_trace: (error.stack || "").slice(0, 8000),
+        fingerprint: fp,
+        severity: "error",
+        source_file: parsed.file,
+        source_line: parsed.line,
+        source_function: parsed.func,
+        tags: {
+            environment: config.environment || "production",
+            service: config.serviceName || "store_server",
+        },
+        extra: extra || {},
+        breadcrumbs: [],
+        occurred_at: new Date().toISOString(),
+        platform: "node",
+    };
+    const endpoint = config.endpoint || DEFAULT_ENDPOINT;
+    const url = `${endpoint}/v1/stores/${config.storeId}/telemetry/ingest`;
+    await fetch(url, {
+        method: "POST",
+        headers: {
+            "Content-Type": "application/json",
+            "x-api-key": config.apiKey,
+        },
+        body: JSON.stringify({
+            session: {
+                session_id: "",
+                visitor_id: "server",
+                started_at: new Date().toISOString(),
+                page_url: "",
+                referrer: "",
+                user_agent: "",
+                screen_width: 0,
+                screen_height: 0,
+                device: "server",
+                language: "en",
+            },
+            errors: [report],
+            events: [],
+            vitals: [],
+        }),
+    }).catch(() => { });
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/dist/session.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Session and visitor ID management.
+ * Visitor ID persists across sessions (localStorage).
+ * Session ID resets after 30 min inactivity.
+ */
+export declare function getVisitorId(): string;
+export declare function getSessionId(): string;
+export declare function getSessionStartedAt(): string;
+/** Detect device type from user agent. */
+export declare function detectDevice(): string;
+/** Extract UTM params from URL. */
+export declare function getUtmParams(): Record<string, string>;
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0BH,wBAAgB,YAAY,IAAI,MAAM,CAWrC;AAED,wBAAgB,YAAY,IAAI,MAAM,CAgBrC;AAED,wBAAgB,mBAAmB,IAAI,MAAM,CAO5C;AAED,0CAA0C;AAC1C,wBAAgB,YAAY,IAAI,MAAM,CAMrC;AAED,mCAAmC;AACnC,wBAAgB,YAAY,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAarD"}

package/dist/session.js

@@ -0,0 +1,93 @@
+/**
+ * Session and visitor ID management.
+ * Visitor ID persists across sessions (localStorage).
+ * Session ID resets after 30 min inactivity.
+ */
+const VISITOR_KEY = "wt_vid";
+const SESSION_KEY = "wt_sid";
+const SESSION_TS_KEY = "wt_sts";
+const SESSION_TIMEOUT = 30 * 60 * 1000; // 30 minutes
+function generateId() {
+    if (typeof crypto !== "undefined" && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    // Fallback
+    return "xxxxxxxx-xxxx-4xxx-yxxx-xxxxxxxxxxxx".replace(/[xy]/g, (c) => {
+        const r = (Math.random() * 16) | 0;
+        return (c === "x" ? r : (r & 0x3) | 0x8).toString(16);
+    });
+}
+function getStorage() {
+    try {
+        return typeof localStorage !== "undefined" ? localStorage : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function getVisitorId() {
+    const storage = getStorage();
+    if (storage) {
+        let vid = storage.getItem(VISITOR_KEY);
+        if (!vid) {
+            vid = generateId();
+            storage.setItem(VISITOR_KEY, vid);
+        }
+        return vid;
+    }
+    return generateId();
+}
+export function getSessionId() {
+    const storage = getStorage();
+    if (!storage)
+        return generateId();
+    const now = Date.now();
+    const lastActivity = parseInt(storage.getItem(SESSION_TS_KEY) || "0", 10);
+    let sid = storage.getItem(SESSION_KEY);
+    // New session if expired or missing
+    if (!sid || now - lastActivity > SESSION_TIMEOUT) {
+        sid = generateId();
+        storage.setItem(SESSION_KEY, sid);
+    }
+    storage.setItem(SESSION_TS_KEY, String(now));
+    return sid;
+}
+export function getSessionStartedAt() {
+    const storage = getStorage();
+    if (storage) {
+        const ts = storage.getItem(SESSION_TS_KEY);
+        if (ts)
+            return new Date(parseInt(ts, 10)).toISOString();
+    }
+    return new Date().toISOString();
+}
+/** Detect device type from user agent. */
+export function detectDevice() {
+    if (typeof navigator === "undefined")
+        return "server";
+    const ua = navigator.userAgent;
+    if (/Mobi|Android|iPhone|iPad/i.test(ua))
+        return "mobile";
+    if (/Tablet|iPad/i.test(ua))
+        return "tablet";
+    return "desktop";
+}
+/** Extract UTM params from URL. */
+export function getUtmParams() {
+    if (typeof window === "undefined")
+        return {};
+    try {
+        const params = new URLSearchParams(window.location.search);
+        const utm = {};
+        for (const key of ["utm_source", "utm_medium", "utm_campaign", "utm_content", "utm_term"]) {
+            const val = params.get(key);
+            if (val)
+                utm[key] = val;
+        }
+        return utm;
+    }
+    catch {
+        return {};
+    }
+}
+//# sourceMappingURL=session.js.map

package/dist/session.js.map

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

package/dist/transport.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Batched HTTP transport to whale-gateway telemetry ingestion endpoint.
+ * Batches errors, events, and vitals — flushes on interval, threshold, or page unload.
+ */
+import type { ErrorPayload, AnalyticsEvent, WebVital, SessionContext, UserContext } from "./types.js";
+export interface TransportConfig {
+    apiKey: string;
+    storeId: string;
+    endpoint: string;
+    flushInterval: number;
+    flushThreshold: number;
+    debug: boolean;
+    getSession: () => SessionContext;
+    getUser: () => UserContext | undefined;
+}
+export declare class Transport {
+    private errors;
+    private events;
+    private vitals;
+    private timer;
+    private config;
+    constructor(config: TransportConfig);
+    start(): void;
+    stop(): void;
+    queueError(error: ErrorPayload): void;
+    queueEvent(event: AnalyticsEvent): void;
+    queueVital(vital: WebVital): void;
+    private checkThreshold;
+    flush(useBeacon?: boolean): void;
+}
+//# sourceMappingURL=transport.d.ts.map

package/dist/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../src/transport.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,cAAc,EACd,QAAQ,EAER,cAAc,EACd,WAAW,EACZ,MAAM,YAAY,CAAC;AAEpB,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,cAAc,EAAE,MAAM,CAAC;IACvB,KAAK,EAAE,OAAO,CAAC;IACf,UAAU,EAAE,MAAM,cAAc,CAAC;IACjC,OAAO,EAAE,MAAM,WAAW,GAAG,SAAS,CAAC;CACxC;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,MAAM,CAAwB;IACtC,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,MAAM,CAAkB;gBAEpB,MAAM,EAAE,eAAe;IAInC,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI;IAQZ,UAAU,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAKrC,UAAU,CAAC,KAAK,EAAE,cAAc,GAAG,IAAI;IAKvC,UAAU,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAKjC,OAAO,CAAC,cAAc;IAOtB,KAAK,CAAC,SAAS,UAAQ,GAAG,IAAI;CAgD/B"}

package/dist/transport.js

@@ -0,0 +1,91 @@
+/**
+ * Batched HTTP transport to whale-gateway telemetry ingestion endpoint.
+ * Batches errors, events, and vitals — flushes on interval, threshold, or page unload.
+ */
+export class Transport {
+    errors = [];
+    events = [];
+    vitals = [];
+    timer = null;
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    start() {
+        this.timer = setInterval(() => this.flush(), this.config.flushInterval);
+        // Flush on page unload
+        if (typeof window !== "undefined") {
+            const onUnload = () => this.flush(true);
+            window.addEventListener("visibilitychange", () => {
+                if (document.visibilityState === "hidden")
+                    onUnload();
+            });
+            window.addEventListener("pagehide", onUnload);
+        }
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+        this.flush(true);
+    }
+    queueError(error) {
+        this.errors.push(error);
+        this.checkThreshold();
+    }
+    queueEvent(event) {
+        this.events.push(event);
+        this.checkThreshold();
+    }
+    queueVital(vital) {
+        this.vitals.push(vital);
+        // Don't auto-flush for vitals (they come in small numbers)
+    }
+    checkThreshold() {
+        const total = this.errors.length + this.events.length;
+        if (total >= this.config.flushThreshold) {
+            this.flush();
+        }
+    }
+    flush(useBeacon = false) {
+        if (this.errors.length === 0 &&
+            this.events.length === 0 &&
+            this.vitals.length === 0) {
+            return;
+        }
+        const batch = {
+            session: this.config.getSession(),
+            user: this.config.getUser(),
+            errors: this.errors.splice(0),
+            events: this.events.splice(0),
+            vitals: this.vitals.splice(0),
+        };
+        const url = `${this.config.endpoint}/v1/stores/${this.config.storeId}/telemetry/ingest`;
+        const body = JSON.stringify(batch);
+        const headers = {
+            "Content-Type": "application/json",
+            "x-api-key": this.config.apiKey,
+        };
+        if (this.config.debug) {
+            console.log("[whaletools] flush", {
+                errors: batch.errors.length,
+                events: batch.events.length,
+                vitals: batch.vitals.length,
+            });
+        }
+        // Use sendBeacon on page unload (more reliable)
+        if (useBeacon && typeof navigator?.sendBeacon === "function") {
+            const blob = new Blob([body], { type: "application/json" });
+            navigator.sendBeacon(url + `?api_key=${this.config.apiKey}`, blob);
+            return;
+        }
+        // Normal fetch (fire-and-forget)
+        fetch(url, { method: "POST", headers, body, keepalive: true }).catch((err) => {
+            if (this.config.debug) {
+                console.error("[whaletools] flush failed:", err);
+            }
+        });
+    }
+}
+//# sourceMappingURL=transport.js.map

package/dist/transport.js.map

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

package/dist/types.d.ts

@@ -0,0 +1,96 @@
+export interface WhaleToolsConfig {
+    /** API key (wk_live_... or wk_test_...) */
+    apiKey: string;
+    /** Store UUID */
+    storeId: string;
+    /** Gateway endpoint (defaults to https://whale-gateway.fly.dev) */
+    endpoint?: string;
+    /** Enable error tracking (default: true) */
+    errors?: boolean;
+    /** Enable analytics / page views (default: true) */
+    analytics?: boolean;
+    /** Enable Web Vitals collection (default: true) */
+    vitals?: boolean;
+    /** Enable breadcrumb collection (default: true) */
+    breadcrumbs?: boolean;
+    /** Environment tag (default: "production") */
+    environment?: string;
+    /** Service name tag (default: "store_client") */
+    serviceName?: string;
+    /** Service version tag */
+    serviceVersion?: string;
+    /** Flush interval in ms (default: 5000) */
+    flushInterval?: number;
+    /** Max items before auto-flush (default: 10) */
+    flushThreshold?: number;
+    /** Debug mode — logs to console (default: false) */
+    debug?: boolean;
+    /** Sample rate 0-1 for analytics events (default: 1) */
+    sampleRate?: number;
+    /** Callback before sending errors — return false to drop */
+    beforeSend?: (error: ErrorPayload) => ErrorPayload | false;
+}
+export interface ErrorPayload {
+    error_type: string;
+    error_message: string;
+    stack_trace: string;
+    fingerprint: string;
+    severity: "debug" | "info" | "warning" | "error" | "fatal";
+    source_file: string;
+    source_line: number;
+    source_function: string;
+    tags: Record<string, string>;
+    extra: Record<string, unknown>;
+    breadcrumbs: Breadcrumb[];
+    occurred_at: string;
+    platform: string;
+}
+export interface Breadcrumb {
+    timestamp: string;
+    category: string;
+    message: string;
+    level: "debug" | "info" | "warning" | "error";
+    data?: Record<string, unknown>;
+}
+export interface AnalyticsEvent {
+    event_name: string;
+    properties: Record<string, unknown>;
+    timestamp: string;
+}
+export interface WebVital {
+    name: "CLS" | "FID" | "LCP" | "INP" | "TTFB" | "FCP";
+    value: number;
+    rating: "good" | "needs-improvement" | "poor";
+    timestamp: string;
+}
+export interface TelemetryBatch {
+    session: SessionContext;
+    user?: UserContext;
+    errors: ErrorPayload[];
+    events: AnalyticsEvent[];
+    vitals: WebVital[];
+}
+export interface SessionContext {
+    session_id: string;
+    visitor_id: string;
+    started_at: string;
+    page_url: string;
+    referrer: string;
+    user_agent: string;
+    screen_width: number;
+    screen_height: number;
+    device: string;
+    language: string;
+    utm_source?: string;
+    utm_medium?: string;
+    utm_campaign?: string;
+    utm_content?: string;
+    utm_term?: string;
+}
+export interface UserContext {
+    user_id: string;
+    email?: string;
+    name?: string;
+    traits?: Record<string, unknown>;
+}
+//# sourceMappingURL=types.d.ts.map