@squasher-ai/browser 0.1.1 → 0.3.0

package/dist/client.js

@@ -1,43 +1,10 @@
-/**
- * BrowserClient — the core SDK client for browser environments.
- *
- * Manages:
- *   - Configuration with sensible defaults
- *   - User context, tags, and breadcrumbs
- *   - Web Vitals collection (via vitals.ts)
- *   - Global error capture (via errors.ts)
- *   - Auto-capture breadcrumbs (via autocapture.ts)
- *   - Transport (via transport.ts)
- */
-import { installAutocapture } from "./autocapture";
-import { buildErrorEvent, buildMessageEvent, installGlobalErrorHandlers } from "./errors";
-import { ReplayRecorder } from "./replay";
-import { buildGenerationEvent, buildIdentifyEvent, buildPageEvent, buildScreenEvent, buildSpanEvent, buildToolCallEvent, buildTrackEvent, mergeIdentifiedUser, prepareBrowserEvent, } from "./telemetry";
-import { Transport } from "./transport";
-import { startVitalsCollection } from "./vitals";
-const DEFAULT_ENDPOINT = "https://ingest.squasher.ai";
-function resolveConfig(config) {
-    return {
-        apiKey: config.apiKey,
-        projectId: config.projectId,
-        endpoint: config.endpoint ?? DEFAULT_ENDPOINT,
-        environment: config.environment,
-        release: config.release,
-        debug: config.debug ?? false,
-        sampleRate: config.sampleRate ?? 1,
-        vitalsSampleRate: config.vitalsSampleRate ?? 1,
-        enableVitals: config.enableVitals ?? true,
-        enableErrorCapture: config.enableErrorCapture ?? true,
-        enableAutoBreadcrumbs: config.enableAutoBreadcrumbs ?? true,
-        beforeSend: config.beforeSend,
-        maxBreadcrumbs: config.maxBreadcrumbs ?? 30,
-        vitalsBufferSize: config.vitalsBufferSize ?? 10,
-        vitalsFlushIntervalMs: config.vitalsFlushIntervalMs ?? 10_000,
-        replayEnabled: config.replay?.enabled ?? false,
-        replaySampleRate: config.replay?.sampleRate ?? 1,
-        replayPrivacy: config.replay?.privacy,
-    };
-}
+import { shouldSampleTelemetry } from "./_vendor/sdk-runtime/runtime/public-sdk-runtime.js";
+import { resolveConfig } from "./config.js";
+import { buildErrorEvent, buildMessageEvent } from "./errors.js";
+import { defaultBrowserClientRuntime, } from "./runtime/client.js";
+import { getSessionId } from "./session.js";
+import { buildGenerationEvent, buildIdentifyEvent, buildPageEvent, buildScreenEvent, buildSpanEvent, buildToolCallEvent, buildTrackEvent, mergeIdentifiedUser, prepareBrowserEvent, } from "./telemetry.js";
+import { mapExternalVital } from "./vitals.js";
 export class BrowserClient {
     config;
     transport;
@@ -47,7 +14,8 @@ export class BrowserClient {
     disabled;
     cleanups = [];
     replayRecorder = null;
-    constructor(config) {
+    vitalsHandle = null;
+    constructor(config, runtime = defaultBrowserClientRuntime) {
         if (!config.apiKey)
             throw new Error("Squasher: apiKey is required");
         if (!config.projectId)
@@ -58,8 +26,7 @@ export class BrowserClient {
             if (this.config.debug) {
                 console.warn("[squasher] SDK initialized in disabled mode");
             }
-            // Create a no-op transport
-            this.transport = new Transport({
+            this.transport = runtime.createTransport({
                 endpoint: this.config.endpoint,
                 projectId: this.config.projectId,
                 apiKey: this.config.apiKey,
@@ -69,8 +36,7 @@ export class BrowserClient {
             });
             return;
         }
-        // Initialize transport
-        this.transport = new Transport({
+        this.transport = runtime.createTransport({
             endpoint: this.config.endpoint,
             projectId: this.config.projectId,
             apiKey: this.config.apiKey,
@@ -78,36 +44,45 @@ export class BrowserClient {
             vitalsBufferSize: this.config.vitalsBufferSize,
             vitalsFlushIntervalMs: this.config.vitalsFlushIntervalMs,
         });
-        // Start Web Vitals collection
         if (this.config.enableVitals) {
-            startVitalsCollection(this.transport, {
+            this.vitalsHandle = runtime.startVitalsCollection(this.transport, {
                 sampleRate: this.config.vitalsSampleRate,
                 environment: this.config.environment,
                 release: this.config.release,
                 debug: this.config.debug,
             });
         }
-        // Install global error handlers
         if (this.config.enableErrorCapture) {
-            const cleanup = installGlobalErrorHandlers((event) => {
+            const cleanup = runtime.installGlobalErrorHandlers((event) => {
                 this.sendErrorEvent(event);
             });
             this.cleanups.push(cleanup);
         }
-        // Install auto-capture breadcrumbs
-        if (this.config.enableAutoBreadcrumbs) {
-            const cleanup = installAutocapture((crumb) => {
+        if (this.config.enableAutoBreadcrumbs || this.config.captureConsoleErrors) {
+            const cleanup = runtime.installAutocapture((crumb) => {
                 this.addBreadcrumb(crumb);
+            }, {
+                captureBreadcrumbs: this.config.enableAutoBreadcrumbs,
+                onConsoleError: this.config.captureConsoleErrors
+                    ? (event) => {
+                        this.sendErrorEvent(event);
+                    }
+                    : undefined,
             });
             this.cleanups.push(cleanup);
         }
         if (this.config.replayEnabled) {
-            this.replayRecorder = new ReplayRecorder({
+            this.replayRecorder = runtime.createReplayRecorder({
                 endpoint: this.config.endpoint,
                 projectId: this.config.projectId,
                 apiKey: this.config.apiKey,
                 debug: this.config.debug,
                 sampleRate: this.config.replaySampleRate,
+                environment: this.config.environment,
+                release: this.config.release,
+                getDistinctId: () => this.user?.id,
+                getUserId: () => this.user?.id,
+                getVisitorId: () => getSessionId(),
                 privacy: this.config.replayPrivacy,
             });
         }
@@ -117,11 +92,11 @@ export class BrowserClient {
                 vitals: this.config.enableVitals,
                 errorCapture: this.config.enableErrorCapture,
                 autoBreadcrumbs: this.config.enableAutoBreadcrumbs,
+                consoleErrors: this.config.captureConsoleErrors,
                 replay: this.config.replayEnabled,
             });
         }
     }
-    // ─── Context ──────────────────────────────────────────────────────────
     setUser(user) {
         this.user = user;
     }
@@ -140,7 +115,6 @@ export class BrowserClient {
             this.breadcrumbs = this.breadcrumbs.slice(-this.config.maxBreadcrumbs);
         }
     }
-    // ─── Capture ──────────────────────────────────────────────────────────
     captureError(error, extra) {
         this.captureTelemetry(buildErrorEvent(error, extra));
     }
@@ -150,8 +124,6 @@ export class BrowserClient {
     captureTelemetry(event) {
         if (this.disabled)
             return;
-        if (!this.shouldSample())
-            return;
         this.sendErrorEvent(event);
     }
     track(eventName, properties, context = {}) {
@@ -176,11 +148,22 @@ export class BrowserClient {
     captureGeneration(message, context = {}) {
         this.captureTelemetry(buildGenerationEvent(message, context));
     }
-    // ─── Lifecycle ────────────────────────────────────────────────────────
-    /**
-     * Flush remaining vitals and stop all timers.
-     * Call this before unmounting a SPA or during cleanup.
-     */
+    /** Record a web vital from an external collector (e.g. Next.js `useReportWebVitals`). */
+    recordWebVital(metric, route) {
+        if (this.disabled)
+            return;
+        const event = mapExternalVital(metric, this.vitalsConfig(), route);
+        this.transport.enqueueVital(event);
+    }
+    /** Stop the SDK's native `web-vitals` collector to avoid double-counting. */
+    suppressNativeVitalsCollection() {
+        this.vitalsHandle?.suppress();
+    }
+    vitalsConfig() {
+        const { vitalsSampleRate: sampleRate, environment, release, debug } = this.config;
+        return { sampleRate, environment, release, debug };
+    }
+    /** Flush vitals and stop timers. Call before unmounting a SPA. */
     close() {
         this.replayRecorder?.dispose();
         this.replayRecorder = null;
@@ -190,14 +173,6 @@ export class BrowserClient {
         this.cleanups = [];
         this.transport.dispose();
     }
-    // ─── Private ──────────────────────────────────────────────────────────
-    shouldSample() {
-        if (this.config.sampleRate >= 1)
-            return true;
-        if (this.config.sampleRate <= 0)
-            return false;
-        return Math.random() < this.config.sampleRate;
-    }
     /** Enrich an error event with current context and send it. */
     sendErrorEvent(event) {
         const prepared = prepareBrowserEvent(event, {
@@ -208,8 +183,17 @@ export class BrowserClient {
             tags: this.tags,
             user: this.user,
         });
-        if (prepared) {
-            this.transport.sendEvent(prepared);
+        if (!prepared)
+            return;
+        if (!this.config.debug && !shouldSampleTelemetry(prepared, this.config.sampling)) {
+            if (!prepared.measurements?.length)
+                return;
+            this.transport.sendEvent({
+                ...prepared,
+                attributes: { ...prepared.attributes, "squasher.sampled": false },
+            });
+            return;
         }
+        this.transport.sendEvent(prepared);
     }
 }

package/dist/config.d.ts

@@ -0,0 +1,24 @@
+import { type ResolvedTelemetrySampling } from "./_vendor/sdk-runtime/runtime/public-sdk-runtime.js";
+import type { BrowserConfig, BrowserErrorEvent, ReplayPrivacyConfig } from "./types.js";
+export interface ResolvedConfig {
+    apiKey: string;
+    projectId: string;
+    endpoint: string;
+    environment?: string;
+    release?: string;
+    debug: boolean;
+    sampling: ResolvedTelemetrySampling;
+    vitalsSampleRate: number;
+    enableVitals: boolean;
+    enableErrorCapture: boolean;
+    enableAutoBreadcrumbs: boolean;
+    captureConsoleErrors: boolean;
+    beforeSend?: (event: BrowserErrorEvent) => BrowserErrorEvent | null;
+    maxBreadcrumbs: number;
+    vitalsBufferSize: number;
+    vitalsFlushIntervalMs: number;
+    replayEnabled: boolean;
+    replaySampleRate: number;
+    replayPrivacy?: ReplayPrivacyConfig;
+}
+export declare function resolveConfig(config: BrowserConfig): ResolvedConfig;

package/dist/config.js

@@ -0,0 +1,26 @@
+import { DEFAULT_INGEST_ENDPOINT, detectRelease, resolveDebugFlag, resolveTelemetrySampling, } from "./_vendor/sdk-runtime/runtime/public-sdk-runtime.js";
+export function resolveConfig(config) {
+    return {
+        apiKey: config.apiKey,
+        projectId: config.projectId,
+        endpoint: config.endpoint ?? DEFAULT_INGEST_ENDPOINT,
+        environment: config.environment,
+        // In the browser, detectRelease only picks up build-time-injected vars
+        // (Next.js inlines `process.env.NEXT_PUBLIC_*` etc).
+        release: config.release ?? detectRelease() ?? undefined,
+        debug: resolveDebugFlag(config.debug),
+        sampling: resolveTelemetrySampling(config.sampling),
+        vitalsSampleRate: config.vitalsSampleRate ?? 1,
+        enableVitals: config.enableVitals ?? true,
+        enableErrorCapture: config.enableErrorCapture ?? true,
+        enableAutoBreadcrumbs: config.enableAutoBreadcrumbs ?? true,
+        captureConsoleErrors: config.captureConsoleErrors ?? false,
+        beforeSend: config.beforeSend,
+        maxBreadcrumbs: config.maxBreadcrumbs ?? 30,
+        vitalsBufferSize: config.vitalsBufferSize ?? 10,
+        vitalsFlushIntervalMs: config.vitalsFlushIntervalMs ?? 10_000,
+        replayEnabled: config.replay?.enabled ?? true,
+        replaySampleRate: config.replay?.sampleRate ?? 1,
+        replayPrivacy: config.replay?.privacy,
+    };
+}

package/dist/console-capture.d.ts

@@ -0,0 +1,7 @@
+import type { Breadcrumb, BrowserErrorEvent } from "./types.js";
+export type BreadcrumbCallback = (crumb: Omit<Breadcrumb, "timestamp">) => void;
+export interface ConsoleCaptureOptions {
+    captureBreadcrumbs: boolean;
+    onConsoleError?: (event: BrowserErrorEvent) => void;
+}
+export declare function captureConsole(onBreadcrumb: BreadcrumbCallback, options: ConsoleCaptureOptions): () => void;

package/dist/console-capture.js

@@ -0,0 +1,79 @@
+import { buildErrorEvent, buildMessageEvent } from "./errors.js";
+export function captureConsole(onBreadcrumb, options) {
+    const origError = console.error.bind(console);
+    const origWarn = console.warn.bind(console);
+    console.error = (...args) => {
+        if (!isInternalSquasherConsole(args)) {
+            const message = formatConsoleArgs(args);
+            if (options.captureBreadcrumbs) {
+                onBreadcrumb({
+                    category: "console",
+                    message: message.slice(0, 200),
+                    level: "error",
+                });
+            }
+            options.onConsoleError?.(buildConsoleErrorEvent(args, message));
+        }
+        origError(...args);
+    };
+    console.warn = (...args) => {
+        if (options.captureBreadcrumbs && !isInternalSquasherConsole(args)) {
+            onBreadcrumb({
+                category: "console",
+                message: formatConsoleArgs(args).slice(0, 200),
+                level: "warning",
+            });
+        }
+        origWarn(...args);
+    };
+    return () => {
+        console.error = origError;
+        console.warn = origWarn;
+    };
+}
+function buildConsoleErrorEvent(args, message) {
+    const error = args.find((arg) => arg instanceof Error);
+    if (error instanceof Error) {
+        const event = buildErrorEvent(error, {
+            argument_count: args.length,
+            source: "console",
+        });
+        event.message = message || event.message;
+        event.type = event.type === "Error" ? "ConsoleError" : `ConsoleError(${event.type})`;
+        return event;
+    }
+    const event = buildMessageEvent(message || "console.error", "error");
+    event.type = "ConsoleError";
+    event.extra = {
+        argument_count: args.length,
+        source: "console",
+    };
+    return event;
+}
+function isInternalSquasherConsole(args) {
+    const first = args[0];
+    return (Object.prototype.toString.call(first) === "[object String]" &&
+        String(first).startsWith("[squasher]"));
+}
+function formatConsoleArgs(args) {
+    return args.map(formatConsoleArg).join(" ").slice(0, 1_000);
+}
+function formatConsoleArg(arg) {
+    if (arg instanceof Error) {
+        return `${arg.name}: ${arg.message}`;
+    }
+    if (arg === null) {
+        return "null";
+    }
+    if (arg === undefined) {
+        return "undefined";
+    }
+    const tag = Object.prototype.toString.call(arg);
+    if (tag === "[object String]" ||
+        tag === "[object Number]" ||
+        tag === "[object Boolean]" ||
+        tag === "[object BigInt]") {
+        return String(arg);
+    }
+    return Object.prototype.toString.call(arg);
+}

package/dist/errors.d.ts

@@ -8,7 +8,7 @@
  * Parses Error.stack into StackFrame[] using the same regex pattern as
  * @squasher-ai/node. In-app heuristic: node_modules = not in_app.
  */
-import type { BrowserErrorEvent, StackFrame } from "./types";
+import type { BrowserErrorEvent, JsonObject, StackFrame } from "./types.js";
 /**
  * Parse an Error.stack string into structured StackFrame[].
  */
@@ -16,7 +16,7 @@ export declare function parseStack(stack?: string): StackFrame[] | undefined;
 /**
  * Build a BrowserErrorEvent from an Error object.
  */
-export declare function buildErrorEvent(error: Error, extra?: Record<string, unknown>): BrowserErrorEvent;
+export declare function buildErrorEvent(error: Error, extra?: JsonObject): BrowserErrorEvent;
 /**
  * Build a BrowserErrorEvent from a string message.
  */
@@ -26,4 +26,3 @@ export declare function buildMessageEvent(message: string, level?: BrowserErrorE
  * Returns a cleanup function to remove the handlers.
  */
 export declare function installGlobalErrorHandlers(onError: (event: BrowserErrorEvent) => void): () => void;
-//# sourceMappingURL=errors.d.ts.map

package/dist/errors.js

@@ -9,7 +9,7 @@
  * @squasher-ai/node. In-app heuristic: node_modules = not in_app.
  */
 const SDK_NAME = "@squasher-ai/browser";
-const SDK_VERSION = "0.1.0";
+const SDK_VERSION = "0.3.0";
 /** Stack trace line regex — works for V8 (Chrome, Node) and SpiderMonkey (Firefox). */
 const STACK_LINE_RE = /^\s*at\s+(?:(.+?)\s+\()?(.+?):(\d+):(\d+)\)?/;
 /** Firefox stack format: "functionName@filename:line:col" */
@@ -33,10 +33,7 @@ export function parseStack(stack) {
         if (!match)
             continue;
         const [, fn, filename, lineno, colno] = match;
-        const isExternal = filename?.includes("node_modules") ||
-            filename?.includes("extensions/") ||
-            filename?.startsWith("chrome-extension://") ||
-            false;
+        const isExternal = isExternalFilename(filename);
         frames.push({
             function: fn || "<anonymous>",
             filename,
@@ -47,6 +44,12 @@ export function parseStack(stack) {
     }
     return frames.length > 0 ? frames : undefined;
 }
+function isExternalFilename(filename) {
+    return (filename?.includes("node_modules") ||
+        filename?.includes("extensions/") ||
+        filename?.startsWith("chrome-extension://") ||
+        false);
+}
 /**
  * Build a BrowserErrorEvent from an Error object.
  */

package/dist/index.d.ts

@@ -5,6 +5,7 @@
  *   - Core Web Vitals (LCP, CLS, INP, FCP, TTFB)
  *   - JavaScript errors (window.onerror, unhandledrejection)
  *   - Navigation breadcrumbs, click breadcrumbs, fetch error breadcrumbs
+ *   - Optional console.error events
  *   - Session context for error ↔ vitals correlation
  *
  * Usage:
@@ -21,42 +22,7 @@
  *   // Manual capture:
  *   captureError(new Error('Something went wrong'));
  */
-export { BrowserClient } from "./client";
-export type { AnalyticsContext, Breadcrumb, BrowserConfig, BrowserErrorEvent, DeviceType, IngestBatchPayload, IngestResponse, JsonObject, LlmContext, Level, PageContext, ReplayConfig, ReplayPrivacyConfig, SessionContext, StackFrame, TelemetryKind, TelemetryMeasurement, ToolCallContext, UserContext, VitalEvent, VitalMetricName, VitalRating, TraceContext, VisitorContext, VitalsPayload, } from "./types";
-import { BrowserClient } from "./client";
-import type { Breadcrumb, BrowserConfig, BrowserErrorEvent, JsonObject, Level, UserContext } from "./types";
-/** Initialize the global Squasher browser client. Throws if called twice. */
-export declare function init(config: BrowserConfig): BrowserClient;
-/** Get the global client (throws if not initialized). */
-export declare function getClient(): BrowserClient;
-/** Capture an error using the global client. */
-export declare function captureError(error: Error, extra?: Record<string, unknown>): void;
-/** Capture a message using the global client. */
-export declare function captureMessage(message: string, level?: Level): void;
-/** Capture a generalized telemetry event using the global client. */
-export declare function captureTelemetry(event: BrowserErrorEvent): void;
-/** Track a product analytics event using the global client. */
-export declare function track(eventName: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Identify a distinct user or visitor using the global client. */
-export declare function identify(distinctId: string, traits?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Capture a page navigation event using the global client. */
-export declare function page(name: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Capture a screen event using the global client. */
-export declare function screen(name: string, properties?: JsonObject, context?: Partial<BrowserErrorEvent>): void;
-/** Capture an agent span using the global client. */
-export declare function captureSpan(name: string, context?: Partial<BrowserErrorEvent>): void;
-/** Capture a tool call using the global client. */
-export declare function captureToolCall(name: string, context?: Partial<BrowserErrorEvent>): void;
-/** Capture an LLM generation event using the global client. */
-export declare function captureGeneration(message: string, context?: Partial<BrowserErrorEvent>): void;
-/** Set user context on the global client. */
-export declare function setUser(user: UserContext | undefined): void;
-/** Set a single tag on the global client. */
-export declare function setTag(key: string, value: string): void;
-/** Set multiple tags on the global client. */
-export declare function setTags(tags: Record<string, string>): void;
-/** Add a breadcrumb on the global client. */
-export declare function addBreadcrumb(crumb: Omit<Breadcrumb, "timestamp">): void;
-/** Close the global client (stop timers, flush vitals, remove handlers). */
-export declare function close(): void;
-//# sourceMappingURL=index.d.ts.map
+export { BrowserClient } from "./client.js";
+export { addBreadcrumb, captureError, captureGeneration, captureMessage, captureSpan, captureTelemetry, captureToolCall, close, getClient, identify, init, page, screen, setTag, setTags, setUser, track, } from "./runtime/client-singleton.js";
+export { createSpanId, createTraceContext, createTraceId } from "./trace-context.js";
+export type { AnalyticsContext, Breadcrumb, BrowserConfig, BrowserErrorEvent, DeviceType, IngestBatchPayload, IngestResponse, JsonObject, Level, LlmContext, PageContext, ReplayConfig, ReplayPrivacyConfig, SessionContext, StackFrame, TelemetryKind, TelemetryMeasurement, ToolCallContext, TraceContext, UserContext, VisitorContext, VitalEvent, VitalMetricName, VitalRating, VitalsPayload, } from "./types.js";

package/dist/index.js

@@ -5,6 +5,7 @@
  *   - Core Web Vitals (LCP, CLS, INP, FCP, TTFB)
  *   - JavaScript errors (window.onerror, unhandledrejection)
  *   - Navigation breadcrumbs, click breadcrumbs, fetch error breadcrumbs
+ *   - Optional console.error events
  *   - Session context for error ↔ vitals correlation
  *
  * Usage:
@@ -21,85 +22,6 @@
  *   // Manual capture:
  *   captureError(new Error('Something went wrong'));
  */
-export { BrowserClient } from "./client";
-// ─── Global singleton ───────────────────────────────────────────────────────
-import { BrowserClient } from "./client";
-let _client = null;
-/** Initialize the global Squasher browser client. Throws if called twice. */
-export function init(config) {
-    if (_client) {
-        throw new Error("squasher.init() called more than once. Call close() first if re-initializing.");
-    }
-    _client = new BrowserClient(config);
-    return _client;
-}
-/** Get the global client (throws if not initialized). */
-export function getClient() {
-    if (!_client) {
-        throw new Error("Squasher not initialized. Call init() first.");
-    }
-    return _client;
-}
-/** Capture an error using the global client. */
-export function captureError(error, extra) {
-    getClient().captureError(error, extra);
-}
-/** Capture a message using the global client. */
-export function captureMessage(message, level) {
-    getClient().captureMessage(message, level);
-}
-/** Capture a generalized telemetry event using the global client. */
-export function captureTelemetry(event) {
-    getClient().captureTelemetry(event);
-}
-/** Track a product analytics event using the global client. */
-export function track(eventName, properties, context) {
-    getClient().track(eventName, properties, context);
-}
-/** Identify a distinct user or visitor using the global client. */
-export function identify(distinctId, traits, context) {
-    getClient().identify(distinctId, traits, context);
-}
-/** Capture a page navigation event using the global client. */
-export function page(name, properties, context) {
-    getClient().page(name, properties, context);
-}
-/** Capture a screen event using the global client. */
-export function screen(name, properties, context) {
-    getClient().screen(name, properties, context);
-}
-/** Capture an agent span using the global client. */
-export function captureSpan(name, context) {
-    getClient().captureSpan(name, context);
-}
-/** Capture a tool call using the global client. */
-export function captureToolCall(name, context) {
-    getClient().captureToolCall(name, context);
-}
-/** Capture an LLM generation event using the global client. */
-export function captureGeneration(message, context) {
-    getClient().captureGeneration(message, context);
-}
-/** Set user context on the global client. */
-export function setUser(user) {
-    getClient().setUser(user);
-}
-/** Set a single tag on the global client. */
-export function setTag(key, value) {
-    getClient().setTag(key, value);
-}
-/** Set multiple tags on the global client. */
-export function setTags(tags) {
-    getClient().setTags(tags);
-}
-/** Add a breadcrumb on the global client. */
-export function addBreadcrumb(crumb) {
-    getClient().addBreadcrumb(crumb);
-}
-/** Close the global client (stop timers, flush vitals, remove handlers). */
-export function close() {
-    if (_client) {
-        _client.close();
-        _client = null;
-    }
-}
+export { BrowserClient } from "./client.js";
+export { addBreadcrumb, captureError, captureGeneration, captureMessage, captureSpan, captureTelemetry, captureToolCall, close, getClient, identify, init, page, screen, setTag, setTags, setUser, track, } from "./runtime/client-singleton.js";
+export { createSpanId, createTraceContext, createTraceId } from "./trace-context.js";

package/dist/next.d.ts

@@ -0,0 +1,39 @@
+/**
+ * Next.js Web Vitals bridge for @squasher-ai/browser.
+ *
+ * Drop `<SquasherNextWebVitals />` into your root layout to capture both
+ * Core Web Vitals (LCP, CLS, INP, FCP, TTFB) and Next.js framework metrics
+ * (`Next.js-hydration`, `Next.js-route-change-to-render`, `Next.js-render`).
+ *
+ * The component hard-imports `next/web-vitals` and `next/navigation` so it
+ * is **only** valid in a Next.js app. Non-Next consumers should rely on the
+ * auto-collector that runs from `init()` and not import this module.
+ *
+ * Internally it bridges Next's `useReportWebVitals` hook into the existing
+ * browser client transport, suppressing the SDK's native `web-vitals`
+ * collector on mount so Core metrics aren't reported twice.
+ *
+ * Usage:
+ *   import { SquasherNextWebVitals } from '@squasher-ai/browser/next';
+ *
+ *   export default function RootLayout({ children }) {
+ *     return (
+ *       <html>
+ *         <body>
+ *           <SquasherNextWebVitals />
+ *           {children}
+ *         </body>
+ *       </html>
+ *     );
+ *   }
+ */
+interface SquasherNextWebVitalsProps {
+    /**
+     * Override the route tag attached to every metric. Defaults to the
+     * current `usePathname()` value, with the pathname re-evaluated lazily
+     * so a single hook subscription doesn't re-fire on every navigation.
+     */
+    path?: string;
+}
+export declare function SquasherNextWebVitals({ path }?: SquasherNextWebVitalsProps): null;
+export {};