@squasher-ai/browser 0.1.0

package/dist/telemetry.js

@@ -0,0 +1,145 @@
+import { getSessionId } from "./session";
+export function mergeIdentifiedUser(currentUser, contextUser, distinctId) {
+    return {
+        ...currentUser,
+        ...contextUser,
+        id: distinctId,
+    };
+}
+export function buildTrackEvent(eventName, properties, context) {
+    return {
+        ...context,
+        message: context.message ?? eventName,
+        level: context.level ?? "info",
+        kind: context.kind ?? "analytics",
+        event_name: context.event_name ?? eventName,
+        analytics: {
+            ...context.analytics,
+            event: context.analytics?.event ?? eventName,
+            properties: properties ?? context.analytics?.properties,
+        },
+    };
+}
+export function buildIdentifyEvent(distinctId, traits, context) {
+    return {
+        ...context,
+        message: context.message ?? `identify:${distinctId}`,
+        level: context.level ?? "info",
+        kind: "identify",
+        event_name: context.event_name ?? "identify",
+        distinct_id: context.distinct_id ?? distinctId,
+        analytics: {
+            ...context.analytics,
+            event: context.analytics?.event ?? "identify",
+            properties: traits ?? context.analytics?.properties,
+        },
+        user: {
+            ...context.user,
+            id: distinctId,
+        },
+    };
+}
+export function buildPageEvent(name, properties, context) {
+    return {
+        ...context,
+        message: context.message ?? `page:${name}`,
+        level: context.level ?? "info",
+        kind: "page",
+        event_name: context.event_name ?? name,
+        analytics: {
+            ...context.analytics,
+            event: context.analytics?.event ?? name,
+            properties: properties ?? context.analytics?.properties,
+        },
+        page: {
+            ...context.page,
+            name: context.page?.name ?? name,
+            path: context.page?.path ?? (typeof location !== "undefined" ? location.pathname : undefined),
+            title: context.page?.title ?? (typeof document !== "undefined" ? document.title : undefined),
+            referrer: context.page?.referrer ?? (typeof document !== "undefined" ? document.referrer : undefined),
+            search: context.page?.search ?? (typeof location !== "undefined" ? location.search : undefined),
+        },
+    };
+}
+export function buildScreenEvent(name, properties, context) {
+    return {
+        ...context,
+        message: context.message ?? `screen:${name}`,
+        level: context.level ?? "info",
+        kind: "screen",
+        event_name: context.event_name ?? name,
+        analytics: {
+            ...context.analytics,
+            event: context.analytics?.event ?? name,
+            properties: properties ?? context.analytics?.properties,
+        },
+        page: {
+            ...context.page,
+            name: context.page?.name ?? name,
+            screen_class: context.page?.screen_class ?? name,
+        },
+    };
+}
+export function buildSpanEvent(name, context) {
+    return {
+        ...context,
+        message: context.message ?? `span:${name}`,
+        level: context.level ?? "info",
+        kind: context.kind ?? "agent_span",
+        event_name: context.event_name ?? name,
+        trace: {
+            ...context.trace,
+            span_name: context.trace?.span_name ?? name,
+        },
+    };
+}
+export function buildToolCallEvent(name, context) {
+    return {
+        ...context,
+        message: context.message ?? `tool:${name}`,
+        level: context.level ?? "info",
+        kind: "tool_call",
+        event_name: context.event_name ?? name,
+        tool_call: {
+            ...context.tool_call,
+            name: context.tool_call?.name ?? name,
+        },
+    };
+}
+export function buildGenerationEvent(message, context) {
+    return {
+        ...context,
+        message,
+        level: context.level ?? "info",
+        kind: "llm_generation",
+        event_name: context.event_name ?? context.llm?.model ?? "llm_generation",
+    };
+}
+export function prepareBrowserEvent(event, input) {
+    const filtered = input.beforeSend ? input.beforeSend(event) : event;
+    if (!filtered) {
+        return null;
+    }
+    const prepared = {
+        ...filtered,
+        session_id: getSessionId(),
+        environment: filtered.environment ?? input.environment,
+        release: filtered.release ?? input.release,
+        kind: filtered.kind ?? (filtered.level === "error" || filtered.level === "fatal" ? "error" : "log"),
+        ...(input.user ? { user: { ...input.user } } : {}),
+        ...(Object.keys(input.tags).length > 0 ? { tags: { ...input.tags, ...filtered.tags } } : {}),
+        ...(input.breadcrumbs.length > 0 ? { breadcrumbs: [...input.breadcrumbs] } : {}),
+    };
+    if (!prepared.visitor &&
+        prepared.kind &&
+        ["analytics", "identify", "page", "screen", "visitor"].includes(prepared.kind)) {
+        prepared.visitor = { anonymous_id: prepared.session_id };
+    }
+    if (typeof location !== "undefined") {
+        prepared.request = {
+            ...prepared.request,
+            url: prepared.request?.url ?? location.href,
+        };
+    }
+    return prepared;
+}

package/dist/transport.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Transport layer for the browser SDK.
+ *
+ * Two send paths:
+ *   1. Errors → POST /v1/ingest/{project_id} (immediate, same wire format as sdk-node)
+ *   2. Vitals → POST /v1/vitals/{project_id} (batched array)
+ *
+ * Primary transport: navigator.sendBeacon() — fire-and-forget, survives page unload.
+ * Fallback: fetch() with keepalive: true.
+ *
+ * Vitals are buffered and flushed on:
+ *   - Buffer reaching vitalsBufferSize (default: 10)
+ *   - Timer tick (default: 10s)
+ *   - Page visibility change to "hidden" (user leaving)
+ */
+import type { BrowserErrorEvent, VitalEvent } from "./types";
+export interface TransportConfig {
+    endpoint: string;
+    projectId: string;
+    apiKey: string;
+    debug: boolean;
+    vitalsBufferSize: number;
+    vitalsFlushIntervalMs: number;
+}
+export declare class Transport {
+    private config;
+    private vitalsBuffer;
+    private flushTimer;
+    private disposed;
+    constructor(config: TransportConfig);
+    /** Send a single telemetry event immediately. Fire-and-forget. */
+    sendEvent(event: BrowserErrorEvent): void;
+    /** Backward-compatible alias for error events. */
+    sendError(event: BrowserErrorEvent): void;
+    /** Buffer a vital event. Auto-flushes when buffer is full. */
+    enqueueVital(event: VitalEvent): void;
+    /** Flush all buffered vitals immediately. */
+    flushVitals(): void;
+    /** Stop all timers and flush remaining data. */
+    dispose(): void;
+    private buildIngestUrl;
+    /** Try sending via navigator.sendBeacon. Returns true if successful. */
+    private trySendBeacon;
+    /** Send via fetch with keepalive and the API key header. */
+    private sendFetch;
+}
+//# 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;;;;;;;;;;;;;;GAcG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAiB,MAAM,SAAS,CAAC;AAE5E,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;IACf,gBAAgB,EAAE,MAAM,CAAC;IACzB,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AAED,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,YAAY,CAAoB;IACxC,OAAO,CAAC,UAAU,CAA+C;IACjE,OAAO,CAAC,QAAQ,CAAS;gBAEb,MAAM,EAAE,eAAe;IA2BnC,kEAAkE;IAClE,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAoBzC,kDAAkD;IAClD,SAAS,CAAC,KAAK,EAAE,iBAAiB,GAAG,IAAI;IAMzC,8DAA8D;IAC9D,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAUrC,6CAA6C;IAC7C,WAAW,IAAI,IAAI;IAoBnB,gDAAgD;IAChD,OAAO,IAAI,IAAI;IAWf,OAAO,CAAC,cAAc;IAQtB,wEAAwE;IACxE,OAAO,CAAC,aAAa;IAarB,4DAA4D;YAC9C,SAAS;CAoBxB"}

package/dist/transport.js

@@ -0,0 +1,145 @@
+/**
+ * Transport layer for the browser SDK.
+ *
+ * Two send paths:
+ *   1. Errors → POST /v1/ingest/{project_id} (immediate, same wire format as sdk-node)
+ *   2. Vitals → POST /v1/vitals/{project_id} (batched array)
+ *
+ * Primary transport: navigator.sendBeacon() — fire-and-forget, survives page unload.
+ * Fallback: fetch() with keepalive: true.
+ *
+ * Vitals are buffered and flushed on:
+ *   - Buffer reaching vitalsBufferSize (default: 10)
+ *   - Timer tick (default: 10s)
+ *   - Page visibility change to "hidden" (user leaving)
+ */
+export class Transport {
+    config;
+    vitalsBuffer = [];
+    flushTimer = null;
+    disposed = false;
+    constructor(config) {
+        this.config = config;
+        // Start the vitals flush timer
+        this.flushTimer = setInterval(() => {
+            this.flushVitals();
+        }, config.vitalsFlushIntervalMs);
+        // Flush vitals when the page is being hidden (user leaving/switching tabs)
+        if (typeof document !== "undefined") {
+            document.addEventListener("visibilitychange", () => {
+                if (document.visibilityState === "hidden") {
+                    this.flushVitals();
+                }
+            });
+        }
+        // Also flush on pagehide (more reliable than unload)
+        if (typeof window !== "undefined") {
+            window.addEventListener("pagehide", () => {
+                this.flushVitals();
+            });
+        }
+    }
+    // ─── Error sending (immediate) ──────────────────────────────────────
+    /** Send a single telemetry event immediately. Fire-and-forget. */
+    sendEvent(event) {
+        if (this.disposed)
+            return;
+        const url = this.buildIngestUrl();
+        const body = JSON.stringify(event);
+        // Try sendBeacon first (survives page unload)
+        if (this.trySendBeacon(this.buildIngestUrl({ beacon: true }), body)) {
+            if (this.config.debug) {
+                console.log("[squasher] Error sent via sendBeacon");
+            }
+            return;
+        }
+        // Fallback to fetch with keepalive
+        this.sendFetch(url, body).catch(() => {
+            // Fire-and-forget — errors are best-effort in the browser
+        });
+    }
+    /** Backward-compatible alias for error events. */
+    sendError(event) {
+        this.sendEvent(event);
+    }
+    // ─── Vitals buffering ───────────────────────────────────────────────
+    /** Buffer a vital event. Auto-flushes when buffer is full. */
+    enqueueVital(event) {
+        if (this.disposed)
+            return;
+        this.vitalsBuffer.push(event);
+        if (this.vitalsBuffer.length >= this.config.vitalsBufferSize) {
+            this.flushVitals();
+        }
+    }
+    /** Flush all buffered vitals immediately. */
+    flushVitals() {
+        if (this.vitalsBuffer.length === 0)
+            return;
+        const events = this.vitalsBuffer.splice(0);
+        const url = `${this.config.endpoint}/v1/vitals/${this.config.projectId}`;
+        const payload = { events };
+        const body = JSON.stringify(payload);
+        if (this.trySendBeacon(url, body)) {
+            if (this.config.debug) {
+                console.log(`[squasher] Flushed ${events.length} vitals via sendBeacon`);
+            }
+            return;
+        }
+        this.sendFetch(url, body).catch(() => {
+            // Best-effort
+        });
+    }
+    /** Stop all timers and flush remaining data. */
+    dispose() {
+        this.disposed = true;
+        if (this.flushTimer) {
+            clearInterval(this.flushTimer);
+            this.flushTimer = null;
+        }
+        this.flushVitals();
+    }
+    // ─── Private helpers ────────────────────────────────────────────────
+    buildIngestUrl(options) {
+        const baseUrl = `${this.config.endpoint}/v1/ingest/${this.config.projectId}`;
+        if (!options?.beacon) {
+            return baseUrl;
+        }
+        return `${baseUrl}?key=${encodeURIComponent(this.config.apiKey)}`;
+    }
+    /** Try sending via navigator.sendBeacon. Returns true if successful. */
+    trySendBeacon(url, body) {
+        if (typeof navigator === "undefined" || !navigator.sendBeacon) {
+            return false;
+        }
+        try {
+            const blob = new Blob([body], { type: "application/json" });
+            return navigator.sendBeacon(url, blob);
+        }
+        catch {
+            return false;
+        }
+    }
+    /** Send via fetch with keepalive and the API key header. */
+    async sendFetch(url, body) {
+        try {
+            await fetch(url, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    "x-squasher-key": this.config.apiKey,
+                },
+                body,
+                keepalive: true,
+            });
+            if (this.config.debug) {
+                console.log("[squasher] Event sent via fetch");
+            }
+        }
+        catch (err) {
+            if (this.config.debug) {
+                console.warn("[squasher] Failed to send event:", err);
+            }
+        }
+    }
+}

package/dist/types.d.ts

@@ -0,0 +1,234 @@
+/**
+ * @squasher-ai/browser — Type definitions for the browser SDK.
+ *
+ * Defines its own types to avoid runtime dependency on @squasher-ai/node or
+ * @squasher-ai/api-spec. Shapes match the canonical wire protocol in
+ * packages/sdk-spec/protocol.schema.json.
+ */
+export interface BrowserConfig {
+    /** API key (sq_pk_...). Required. */
+    apiKey: string;
+    /** Project ID (UUID). Required. */
+    projectId: string;
+    /** Ingestion endpoint. Default: "https://ingest.squasher.ai" */
+    endpoint?: string;
+    /** Environment tag (production, staging, development). */
+    environment?: string;
+    /** Release/version tag. */
+    release?: string;
+    /** Enable debug logging to console. Default: false. */
+    debug?: boolean;
+    /** Error sampling rate 0-1. Default: 1 (capture everything). */
+    sampleRate?: number;
+    /** Web Vitals sampling rate 0-1. Default: 1. */
+    vitalsSampleRate?: number;
+    /** Enable Core Web Vitals collection. Default: true. */
+    enableVitals?: boolean;
+    /** Enable global error capture (onerror, unhandledrejection). Default: true. */
+    enableErrorCapture?: boolean;
+    /** Enable auto-capture breadcrumbs (navigation, clicks, fetch). Default: true. */
+    enableAutoBreadcrumbs?: boolean;
+    /**
+     * Hook invoked before every error event is sent.
+     * Return the event (possibly modified) to send, or null to drop.
+     */
+    beforeSend?: (event: BrowserErrorEvent) => BrowserErrorEvent | null;
+    /** Max breadcrumbs to retain. Default: 30. */
+    maxBreadcrumbs?: number;
+    /** Max vitals to buffer before flush. Default: 10. */
+    vitalsBufferSize?: number;
+    /** Vitals flush interval in ms. Default: 10000. */
+    vitalsFlushIntervalMs?: number;
+    /** Optional session replay recording powered by rrweb. */
+    replay?: ReplayConfig;
+}
+export interface ReplayConfig {
+    /** Enable rrweb session replay recording for this browser session. */
+    enabled: boolean;
+    /** Session-level replay sampling rate from 0-1. Default: 1. */
+    sampleRate?: number;
+    /** Optional privacy controls applied to rrweb session replay recording. */
+    privacy?: ReplayPrivacyConfig;
+}
+export interface ReplayPrivacyConfig {
+    /** Replace recorded DOM text and typed input values with masked characters. */
+    maskAllText?: boolean;
+    /** CSS selector for elements that should render as blocked placeholders. */
+    blockSelector?: string;
+}
+export type VitalMetricName = "LCP" | "CLS" | "INP" | "FCP" | "TTFB";
+export type VitalRating = "good" | "needs-improvement" | "poor";
+export type DeviceType = "mobile" | "tablet" | "desktop";
+/** Single vital measurement sent to POST /v1/vitals/{project_id}. */
+export interface VitalEvent {
+    type: "vital";
+    /** Metric name (LCP, CLS, INP, FCP, TTFB). */
+    name: VitalMetricName;
+    /** Metric value (ms for timing metrics, unitless for CLS). */
+    value: number;
+    /** Rating based on Google thresholds. */
+    rating: VitalRating;
+    /** Change since last report (useful for CLS which accumulates). */
+    delta: number;
+    /** How the user navigated here (navigate, reload, back_forward, prerender). */
+    navigationType: string;
+    /** Full URL where this measurement was taken. */
+    url: string;
+    /** Optional route pattern (e.g. /products/:id). User-configurable. */
+    route?: string;
+    /** Session ID linking vitals to errors from the same browser session. */
+    session_id: string;
+    /** Epoch ms timestamp. */
+    timestamp: number;
+    /** Environment tag from config. */
+    environment?: string;
+    /** Release tag from config. */
+    release?: string;
+    /** Network connection type (4g, 3g, slow-2g). Via navigator.connection. */
+    connection?: string;
+    /** Device classification based on screen width. */
+    device_type?: DeviceType;
+    /** Document referrer. */
+    referrer?: string;
+}
+/** Batched payload sent to the vitals endpoint. */
+export interface VitalsPayload {
+    events: VitalEvent[];
+}
+export type Level = "fatal" | "error" | "warning" | "info" | "debug";
+export type TelemetryKind = "error" | "log" | "analytics" | "identify" | "page" | "screen" | "visitor" | "agent_session" | "agent_span" | "tool_call" | "llm_generation";
+export type JsonPrimitive = string | number | boolean | null;
+export type JsonValue = JsonPrimitive | JsonObject | JsonValue[];
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export interface VisitorContext {
+    visitor_id?: string;
+    anonymous_id?: string;
+    account_id?: string;
+}
+export interface AnalyticsContext {
+    event?: string;
+    category?: string;
+    funnel?: string;
+    step?: string;
+    properties?: JsonObject;
+}
+export interface PageContext {
+    name?: string;
+    path?: string;
+    title?: string;
+    referrer?: string;
+    search?: string;
+    screen_class?: string;
+}
+export interface SessionContext {
+    session_type?: string;
+    agent_id?: string;
+    run_id?: string;
+    workflow_id?: string;
+    step_id?: string;
+    status?: string;
+    duration_ms?: number;
+}
+export interface TraceContext {
+    trace_id?: string;
+    span_id?: string;
+    parent_span_id?: string;
+    span_name?: string;
+    span_kind?: string;
+    status?: string;
+    duration_ms?: number;
+}
+export interface ToolCallContext {
+    name?: string;
+    input?: JsonObject;
+    output?: JsonObject;
+    status?: string;
+    duration_ms?: number;
+}
+export interface LlmContext {
+    provider?: string;
+    model?: string;
+    prompt_tokens?: number;
+    completion_tokens?: number;
+    total_tokens?: number;
+    cost_usd?: number;
+    latency_ms?: number;
+    status?: string;
+    input?: JsonObject;
+    output?: JsonObject;
+}
+export interface TelemetryMeasurement {
+    name: string;
+    value: number;
+    unit?: string;
+}
+export interface BrowserErrorEvent {
+    message: string;
+    type?: string;
+    stack?: string;
+    frames?: StackFrame[];
+    level?: Level;
+    tags?: Record<string, string>;
+    user?: UserContext;
+    request?: {
+        url: string;
+        method?: string;
+    };
+    sdk?: {
+        name: string;
+        version: string;
+    };
+    timestamp?: string;
+    release?: string;
+    environment?: string;
+    breadcrumbs?: Breadcrumb[];
+    extra?: Record<string, unknown>;
+    /** Session ID for correlation with Web Vitals. */
+    session_id?: string;
+    kind?: TelemetryKind;
+    event_name?: string;
+    distinct_id?: string;
+    visitor?: VisitorContext;
+    analytics?: AnalyticsContext;
+    page?: PageContext;
+    session?: SessionContext;
+    trace?: TraceContext;
+    tool_call?: ToolCallContext;
+    llm?: LlmContext;
+    attributes?: JsonObject;
+    measurements?: TelemetryMeasurement[];
+}
+export interface IngestBatchPayload {
+    events: BrowserErrorEvent[];
+}
+export interface StackFrame {
+    filename?: string;
+    function?: string;
+    lineno?: number;
+    colno?: number;
+    in_app?: boolean;
+    context_line?: string;
+    pre_context?: string[];
+    post_context?: string[];
+}
+export interface UserContext {
+    id?: string;
+    email?: string;
+    username?: string;
+    ip_address?: string;
+}
+export interface Breadcrumb {
+    timestamp?: string;
+    category?: string;
+    message?: string;
+    level?: string;
+    data?: Record<string, unknown>;
+}
+export interface IngestResponse {
+    id: string;
+    status: string;
+    accepted?: 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":"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"}

package/dist/types.js

@@ -0,0 +1,8 @@
+/**
+ * @squasher-ai/browser — Type definitions for the browser SDK.
+ *
+ * Defines its own types to avoid runtime dependency on @squasher-ai/node or
+ * @squasher-ai/api-spec. Shapes match the canonical wire protocol in
+ * packages/sdk-spec/protocol.schema.json.
+ */
+export {};

package/dist/vitals.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Core Web Vitals collector.
+ *
+ * Uses Google's `web-vitals` library to measure:
+ *   - LCP (Largest Contentful Paint)
+ *   - CLS (Cumulative Layout Shift)
+ *   - INP (Interaction to Next Paint)
+ *   - FCP (First Contentful Paint)
+ *   - TTFB (Time to First Byte)
+ *
+ * Each metric fires once (LCP, FCP, TTFB) or accumulates (CLS, INP).
+ * Measurements are mapped to VitalEvent and queued via the transport.
+ */
+import type { Transport } from "./transport";
+export interface VitalsCollectorConfig {
+    /** Sampling rate 0-1 for vitals. */
+    sampleRate: number;
+    /** Environment tag from SDK config. */
+    environment?: string;
+    /** Release tag from SDK config. */
+    release?: string;
+    /** Enable debug logging. */
+    debug: boolean;
+}
+/**
+ * Start collecting all 5 Core Web Vitals and feed them to the transport.
+ * Call once during SDK initialization.
+ */
+export declare function startVitalsCollection(transport: Transport, config: VitalsCollectorConfig): void;
+//# sourceMappingURL=vitals.d.ts.map

package/dist/vitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../src/vitals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAKH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAG7C,MAAM,WAAW,qBAAqB;IACpC,oCAAoC;IACpC,UAAU,EAAE,MAAM,CAAC;IACnB,uCAAuC;IACvC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,mCAAmC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,4BAA4B;IAC5B,KAAK,EAAE,OAAO,CAAC;CAChB;AAsDD;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,SAAS,EAAE,SAAS,EAAE,MAAM,EAAE,qBAAqB,GAAG,IAAI,CAuB/F"}