@squasher-ai/browser 0.1.1 → 0.2.0

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.
  */

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AAW7D;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,SAAS,CAkCnE;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,iBAAiB,CAWhG;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAAiB,CAAC,OAAO,CAAU,GACzC,iBAAiB,CAOnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC1C,MAAM,IAAI,CAuCZ"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAW5E;;GAEG;AACH,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,GAAG,SAAS,CA8BnE;AAWD;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,EAAE,UAAU,GAAG,iBAAiB,CAWnF;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EACf,KAAK,GAAE,iBAAiB,CAAC,OAAO,CAAU,GACzC,iBAAiB,CAOnB;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,GAC1C,MAAM,IAAI,CAuCZ"}

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.2.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,8 @@
  *   // 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;
+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";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EACL,aAAa,EACb,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,KAAK,EACL,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,IAAI,EACJ,MAAM,EACN,MAAM,EACN,OAAO,EACP,OAAO,EACP,KAAK,GACN,MAAM,+BAA+B,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,kBAAkB,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACrF,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,aAAa,EACb,iBAAiB,EACjB,UAAU,EACV,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,KAAK,EACL,UAAU,EACV,WAAW,EACX,YAAY,EACZ,mBAAmB,EACnB,cAAc,EACd,UAAU,EACV,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,WAAW,EACX,cAAc,EACd,UAAU,EACV,eAAe,EACf,WAAW,EACX,aAAa,GACd,MAAM,YAAY,CAAC"}

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,40 @@
+/**
+ * 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 {};
+//# sourceMappingURL=next.d.ts.map

package/dist/next.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"next.d.ts","sourceRoot":"","sources":["../src/next.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAeH,UAAU,0BAA0B;IAClC;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,wBAAgB,qBAAqB,CAAC,EAAE,IAAI,EAAE,GAAE,0BAA+B,QA+B9E"}

package/dist/next.js

@@ -0,0 +1,67 @@
+/**
+ * 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>
+ *     );
+ *   }
+ */
+"use client";
+import { usePathname } from "next/navigation";
+import { useReportWebVitals } from "next/web-vitals";
+import { useCallback, useEffect, useRef } from "react";
+import { getClient } from "./runtime/client-singleton.js";
+const SUPPORTED_WEB_VITALS = new Set(["CLS", "FCP", "INP", "LCP", "TTFB"]);
+function isSupportedWebVital(name) {
+    return SUPPORTED_WEB_VITALS.has(name);
+}
+export function SquasherNextWebVitals({ path } = {}) {
+    const pathname = usePathname();
+    const currentPath = path ?? pathname ?? "/";
+    const stabilizedPath = useRef(currentPath);
+    useEffect(() => {
+        stabilizedPath.current = currentPath;
+    }, [currentPath]);
+    useEffect(() => {
+        try {
+            getClient().suppressNativeVitalsCollection();
+        }
+        catch {
+            // Squasher SDK not initialized — nothing to suppress. Bridge still
+            // runs so the host can call init() asynchronously.
+        }
+    }, []);
+    const report = useCallback((metric) => {
+        if (!isSupportedWebVital(metric.name))
+            return;
+        try {
+            getClient().recordWebVital(metric, stabilizedPath.current);
+        }
+        catch {
+            // SDK not yet initialized; drop this metric rather than throw.
+        }
+    }, []);
+    useReportWebVitals(report);
+    return null;
+}

package/dist/react.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlE,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACxD;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;gBACpD,KAAK,EAAE,KAAK;IAKxB,MAAM,CAAC,wBAAwB,IAAI,KAAK;IAI/B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAa3D,MAAM,IAAI,SAAS;CAM7B"}
+{"version":3,"file":"react.d.ts","sourceRoot":"","sources":["../src/react.tsx"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAKlE,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,qDAAqD;IACrD,QAAQ,CAAC,EAAE,SAAS,CAAC;IACrB,iDAAiD;IACjD,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,KAAK,IAAI,CAAC;CACxD;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,qBAAsB,SAAQ,SAAS,CAAC,KAAK,EAAE,KAAK,CAAC;gBACpD,KAAK,EAAE,KAAK;IAKxB,MAAM,CAAC,wBAAwB,IAAI,KAAK;IAI/B,iBAAiB,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,GAAG,IAAI;IAc3D,MAAM,IAAI,SAAS;CAM7B"}

package/dist/react.js

@@ -12,7 +12,8 @@
  *   </SquasherErrorBoundary>
  */
 import { Component } from "react";
-import { getClient } from "./index";
+import { attempt } from "@squasher-ai/result-utils";
+import { getClient } from "./runtime/client-singleton.js";
 export class SquasherErrorBoundary extends Component {
     constructor(props) {
         super(props);
@@ -22,15 +23,16 @@ export class SquasherErrorBoundary extends Component {
         return { hasError: true };
     }
     componentDidCatch(error, errorInfo) {
-        try {
-            const client = getClient();
-            client.captureError(error, {
-                componentStack: errorInfo.componentStack ?? undefined,
-            });
-        }
-        catch {
-            // SDK not initialized — silently ignore
-        }
+        attempt({
+            try: () => {
+                const client = getClient();
+                const extra = {};
+                if (errorInfo.componentStack)
+                    extra.componentStack = errorInfo.componentStack;
+                client.captureError(error, extra);
+            },
+            catch: () => undefined,
+        });
         this.props.onError?.(error, errorInfo);
     }
     render() {

package/dist/replay-network.d.ts

@@ -0,0 +1,21 @@
+export interface ReplayNetworkEventPayload {
+    durationMs: number;
+    initiatorType: string;
+    method?: string;
+    pageUrl: string;
+    protocol?: string | null;
+    requestUrl: string;
+    source: "fetch" | "resource";
+    startOffsetMs: number;
+    statusCode?: number | null;
+    statusText?: string | null;
+    transferSize?: number | null;
+}
+export interface ReplayNetworkCaptureOptions {
+    debug: boolean;
+    emitCustomEvent?: (tag: string, payload: ReplayNetworkEventPayload) => void;
+    ignoredUrlPrefixes?: string[];
+    replayStartedAtMs: number;
+}
+export declare function installReplayNetworkCapture({ debug, emitCustomEvent, ignoredUrlPrefixes, replayStartedAtMs, }: ReplayNetworkCaptureOptions): () => void;
+//# sourceMappingURL=replay-network.d.ts.map

package/dist/replay-network.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay-network.d.ts","sourceRoot":"","sources":["../src/replay-network.ts"],"names":[],"mappings":"AAMA,MAAM,WAAW,yBAAyB;IACxC,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,MAAM,CAAC;IACtB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,OAAO,GAAG,UAAU,CAAC;IAC7B,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,KAAK,EAAE,OAAO,CAAC;IACf,eAAe,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,yBAAyB,KAAK,IAAI,CAAC;IAC5E,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC9B,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAsED,wBAAgB,2BAA2B,CAAC,EAC1C,KAAK,EACL,eAAe,EACf,kBAAuB,EACvB,iBAAiB,GAClB,EAAE,2BAA2B,GAAG,MAAM,IAAI,CA6J1C"}