@squasher-ai/browser 0.1.0 → 0.2.0

package/dist/types.d.ts

@@ -5,12 +5,13 @@
  * @squasher-ai/api-spec. Shapes match the canonical wire protocol in
  * packages/sdk-spec/protocol.schema.json.
  */
+import type { AnalyticsContext, Breadcrumb as ApiBreadcrumb, IngestEvent, IngestResponse, JsonObject, Level, LlmContext, PageContext, SessionContext, StackFrame, TelemetryKind, TelemetryMeasurement, TelemetrySamplingConfig, ToolCallContext, TraceContext, UserContext, VisitorContext } from "@squasher-ai/api-spec";
 export interface BrowserConfig {
     /** API key (sq_pk_...). Required. */
     apiKey: string;
     /** Project ID (UUID). Required. */
     projectId: string;
-    /** Ingestion endpoint. Default: "https://ingest.squasher.ai" */
+    /** Public edge ingestion endpoint. Default: "https://ingest.squasher.ai" */
     endpoint?: string;
     /** Environment tag (production, staging, development). */
     environment?: string;
@@ -18,8 +19,8 @@ export interface BrowserConfig {
     release?: string;
     /** Enable debug logging to console. Default: false. */
     debug?: boolean;
-    /** Error sampling rate 0-1. Default: 1 (capture everything). */
-    sampleRate?: number;
+    /** Outcome-aware, deterministic event sampling. */
+    sampling?: TelemetrySamplingConfig;
     /** Web Vitals sampling rate 0-1. Default: 1. */
     vitalsSampleRate?: number;
     /** Enable Core Web Vitals collection. Default: true. */
@@ -28,6 +29,8 @@ export interface BrowserConfig {
     enableErrorCapture?: boolean;
     /** Enable auto-capture breadcrumbs (navigation, clicks, fetch). Default: true. */
     enableAutoBreadcrumbs?: boolean;
+    /** Capture `console.error(...)` calls as error events. Default: false. */
+    captureConsoleErrors?: boolean;
     /**
      * Hook invoked before every error event is sent.
      * Return the event (possibly modified) to send, or null to drop.
@@ -39,11 +42,11 @@ export interface BrowserConfig {
     vitalsBufferSize?: number;
     /** Vitals flush interval in ms. Default: 10000. */
     vitalsFlushIntervalMs?: number;
-    /** Optional session replay recording powered by rrweb. */
+    /** Optional session replay recording powered by rrweb. Enabled by default. */
     replay?: ReplayConfig;
 }
 export interface ReplayConfig {
-    /** Enable rrweb session replay recording for this browser session. */
+    /** Enable rrweb session replay recording for this browser session. Default: true. */
     enabled: boolean;
     /** Session-level replay sampling rate from 0-1. Default: 1. */
     sampleRate?: number;
@@ -56,7 +59,13 @@ export interface ReplayPrivacyConfig {
     /** CSS selector for elements that should render as blocked placeholders. */
     blockSelector?: string;
 }
-export type VitalMetricName = "LCP" | "CLS" | "INP" | "FCP" | "TTFB";
+/**
+ * Well-known web vital names. Includes the 5 Core Web Vitals plus the
+ * Next.js framework metrics emitted by `useReportWebVitals` from
+ * `next/web-vitals`. The wire format accepts arbitrary strings, so custom
+ * names from other frameworks pass through unchanged.
+ */
+export type VitalMetricName = "LCP" | "CLS" | "INP" | "FCP" | "TTFB" | "Next.js-hydration" | "Next.js-route-change-to-render" | "Next.js-render" | (string & {});
 export type VitalRating = "good" | "needs-improvement" | "poor";
 export type DeviceType = "mobile" | "tablet" | "desktop";
 /** Single vital measurement sent to POST /v1/vitals/{project_id}. */
@@ -90,145 +99,38 @@ export interface VitalEvent {
     device_type?: DeviceType;
     /** Document referrer. */
     referrer?: string;
+    /** Browser language, for example en-US. */
+    language?: string;
+    /** Browser time zone, for example America/Los_Angeles. */
+    timezone?: string;
+    /** URL pathname at measurement time. */
+    page_path?: string;
+    /** URL query string without the leading question mark. */
+    query_string?: string;
+    /** UTM source query parameter. */
+    utm_source?: string;
+    /** UTM medium query parameter. */
+    utm_medium?: string;
+    /** UTM campaign query parameter. */
+    utm_campaign?: 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;
+export type { AnalyticsContext, IngestResponse, JsonObject, Level, LlmContext, PageContext, SessionContext, StackFrame, TelemetryKind, TelemetryMeasurement, ToolCallContext, TraceContext, UserContext, VisitorContext, };
+export type Breadcrumb = Omit<ApiBreadcrumb, "data"> & {
+    data?: JsonObject;
+};
+export type BrowserErrorEvent = Omit<IngestEvent, "breadcrumbs" | "extra" | "request"> & {
+    breadcrumbs?: Breadcrumb[];
+    extra?: JsonObject;
     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

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

package/dist/types.js

@@ -1,8 +1 @@
-/**
- * @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

@@ -11,7 +11,15 @@
  * 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";
+import { type Metric } from "web-vitals";
+import type { VitalEvent } from "./types.js";
+declare global {
+    interface Navigator {
+        connection?: {
+            effectiveType?: string;
+        };
+    }
+}
 export interface VitalsCollectorConfig {
     /** Sampling rate 0-1 for vitals. */
     sampleRate: number;
@@ -22,9 +30,54 @@ export interface VitalsCollectorConfig {
     /** Enable debug logging. */
     debug: boolean;
 }
+/**
+ * Shape accepted by external collectors that bridge into our transport
+ * (e.g. Next.js `useReportWebVitals`). Mirrors the relevant subset of the
+ * `web-vitals` Metric and Next's `NextWebVitalsMetric` so callers can pass
+ * the framework metric object through unchanged.
+ */
+export interface ExternalVitalInput {
+    name: string;
+    value: number;
+    rating?: string;
+    delta?: number;
+    navigationType?: string;
+    /** Unique identifier the underlying lib assigns to a measurement. */
+    id?: string;
+}
+/**
+ * Map an externally-sourced web vital (Next.js custom metric or otherwise)
+ * to our VitalEvent wire shape so it can be enqueued through the transport.
+ */
+export declare function mapExternalVital(metric: ExternalVitalInput, config: VitalsCollectorConfig, route?: string): VitalEvent;
+export interface VitalsCollectorHandle {
+    /**
+     * Stop forwarding metrics from the native `web-vitals` library to the
+     * transport. The library's observers cannot be unregistered, so callbacks
+     * still fire — they just no-op. Use this when an external collector (e.g.
+     * Next.js `useReportWebVitals`) takes over so we don't double-count.
+     */
+    suppress: () => void;
+}
+export interface VitalsTransport {
+    enqueueVital(event: VitalEvent): void;
+}
+export interface VitalsRuntime {
+    getSessionId(): string;
+    observeCLS(callback: (metric: Metric) => void, options: {
+        reportAllChanges: boolean;
+    }): void;
+    observeFCP(callback: (metric: Metric) => void): void;
+    observeINP(callback: (metric: Metric) => void, options: {
+        reportAllChanges: boolean;
+    }): void;
+    observeLCP(callback: (metric: Metric) => void): void;
+    observeTTFB(callback: (metric: Metric) => void): void;
+}
+export declare const defaultVitalsRuntime: VitalsRuntime;
 /**
  * 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;
+export declare function startVitalsCollection(transport: VitalsTransport, config: VitalsCollectorConfig, runtime?: VitalsRuntime): VitalsCollectorHandle;
 //# sourceMappingURL=vitals.d.ts.map

package/dist/vitals.d.ts.map

@@ -1 +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"}
+{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../src/vitals.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAAsC,KAAK,MAAM,EAAE,MAAM,YAAY,CAAC;AAG7E,OAAO,KAAK,EAAc,UAAU,EAAE,MAAM,YAAY,CAAC;AAEzD,OAAO,CAAC,MAAM,CAAC;IACb,UAAU,SAAS;QACjB,UAAU,CAAC,EAAE;YAAE,aAAa,CAAC,EAAE,MAAM,CAAA;SAAE,CAAC;KACzC;CACF;AAED,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;AA4GD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qEAAqE;IACrE,EAAE,CAAC,EAAE,MAAM,CAAC;CACb;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,kBAAkB,EAC1B,MAAM,EAAE,qBAAqB,EAC7B,KAAK,CAAC,EAAE,MAAM,GACb,UAAU,CA0BZ;AAcD,MAAM,WAAW,qBAAqB;IACpC;;;;;OAKG;IACH,QAAQ,EAAE,MAAM,IAAI,CAAC;CACtB;AAED,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CACvC;AAED,MAAM,WAAW,aAAa;IAC5B,YAAY,IAAI,MAAM,CAAC;IACvB,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,EAAE;QAAE,gBAAgB,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7F,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAAE,OAAO,EAAE;QAAE,gBAAgB,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI,CAAC;IAC7F,UAAU,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;IACrD,WAAW,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,GAAG,IAAI,CAAC;CACvD;AAED,eAAO,MAAM,oBAAoB,EAAE,aAOlC,CAAC;AAEF;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,SAAS,EAAE,eAAe,EAC1B,MAAM,EAAE,qBAAqB,EAC7B,OAAO,GAAE,aAAoC,GAC5C,qBAAqB,CA+BvB"}

package/dist/vitals.js

@@ -12,15 +12,15 @@
  * Measurements are mapped to VitalEvent and queued via the transport.
  */
 import { onLCP, onCLS, onINP, onFCP, onTTFB } from "web-vitals";
-import { getSessionId } from "./session";
+import { getSessionId } from "./session.js";
 /**
  * Infer device type from screen width.
  * Mobile < 768px, Tablet < 1024px, Desktop >= 1024px.
  */
 function inferDeviceType() {
-    if (typeof screen === "undefined")
+    if (!globalThis.screen)
         return undefined;
-    const width = screen.width;
+    const width = globalThis.screen.width;
     if (width < 768)
         return "mobile";
     if (width < 1024)
@@ -32,13 +32,54 @@ function inferDeviceType() {
  * Returns undefined if not supported (Firefox, Safari).
  */
 function getConnectionType() {
-    const nav = navigator;
-    return nav.connection?.effectiveType;
+    return globalThis.navigator?.connection?.effectiveType;
+}
+function getBrowserTimezone() {
+    try {
+        return Intl.DateTimeFormat().resolvedOptions().timeZone;
+    }
+    catch {
+        return undefined;
+    }
+}
+function getUrlDimensions() {
+    if (!globalThis.location) {
+        return {
+            page_path: "",
+            query_string: "",
+            url: "",
+            utm_campaign: undefined,
+            utm_medium: undefined,
+            utm_source: undefined,
+        };
+    }
+    const href = globalThis.location.href;
+    const parsed = href ? safeUrl(href) : undefined;
+    const rawSearch = globalThis.location.search || parsed?.search || "";
+    const search = rawSearch.startsWith("?") ? rawSearch.slice(1) : rawSearch;
+    const params = new URLSearchParams(search);
+    return {
+        page_path: globalThis.location.pathname || parsed?.pathname || "",
+        query_string: search,
+        url: href,
+        utm_campaign: params.get("utm_campaign") || undefined,
+        utm_medium: params.get("utm_medium") || undefined,
+        utm_source: params.get("utm_source") || undefined,
+    };
+}
+function safeUrl(value) {
+    try {
+        return new URL(value);
+    }
+    catch {
+        return undefined;
+    }
 }
 /**
  * Map a web-vitals Metric to our VitalEvent shape.
  */
-function mapMetric(metric, config) {
+function mapMetric(metric, config, getCurrentSessionId) {
+    const url = getUrlDimensions();
     return {
         type: "vital",
         name: metric.name,
@@ -46,16 +87,59 @@ function mapMetric(metric, config) {
         rating: metric.rating,
         delta: metric.delta,
         navigationType: metric.navigationType,
-        url: location.href,
+        url: url.url,
+        session_id: getCurrentSessionId(),
+        timestamp: Date.now(),
+        environment: config.environment,
+        release: config.release,
+        connection: getConnectionType(),
+        device_type: inferDeviceType(),
+        language: globalThis.navigator?.language || undefined,
+        page_path: url.page_path,
+        query_string: url.query_string,
+        referrer: globalThis.document?.referrer || undefined,
+        timezone: getBrowserTimezone(),
+        utm_campaign: url.utm_campaign,
+        utm_medium: url.utm_medium,
+        utm_source: url.utm_source,
+    };
+}
+/**
+ * Map an externally-sourced web vital (Next.js custom metric or otherwise)
+ * to our VitalEvent wire shape so it can be enqueued through the transport.
+ */
+export function mapExternalVital(metric, config, route) {
+    const url = getUrlDimensions();
+    return {
+        type: "vital",
+        name: metric.name,
+        value: metric.value,
+        rating: normalizeRating(metric.rating),
+        delta: metric.delta ?? metric.value,
+        navigationType: metric.navigationType ?? "navigate",
+        url: url.url,
+        route,
         session_id: getSessionId(),
         timestamp: Date.now(),
         environment: config.environment,
         release: config.release,
         connection: getConnectionType(),
         device_type: inferDeviceType(),
-        referrer: document.referrer || undefined,
+        language: globalThis.navigator?.language || undefined,
+        page_path: url.page_path,
+        query_string: url.query_string,
+        referrer: globalThis.document?.referrer || undefined,
+        timezone: getBrowserTimezone(),
+        utm_campaign: url.utm_campaign,
+        utm_medium: url.utm_medium,
+        utm_source: url.utm_source,
     };
 }
+function normalizeRating(rating) {
+    if (rating === "poor" || rating === "needs-improvement")
+        return rating;
+    return "good";
+}
 /** Decide whether to sample this vital based on the configured rate. */
 function shouldSample(sampleRate) {
     if (sampleRate >= 1)
@@ -64,19 +148,33 @@ function shouldSample(sampleRate) {
         return false;
     return Math.random() < sampleRate;
 }
+export const defaultVitalsRuntime = {
+    getSessionId,
+    observeCLS: (callback, options) => onCLS(callback, options),
+    observeFCP: (callback) => onFCP(callback),
+    observeINP: (callback, options) => onINP(callback, options),
+    observeLCP: (callback) => onLCP(callback),
+    observeTTFB: (callback) => onTTFB(callback),
+};
 /**
  * Start collecting all 5 Core Web Vitals and feed them to the transport.
  * Call once during SDK initialization.
  */
-export function startVitalsCollection(transport, config) {
+export function startVitalsCollection(transport, config, runtime = defaultVitalsRuntime) {
+    let suppressed = false;
+    const suppress = () => {
+        suppressed = true;
+    };
     if (!shouldSample(config.sampleRate)) {
         if (config.debug) {
             console.log("[squasher] Vitals collection skipped (sampled out)");
         }
-        return;
+        return { suppress };
     }
     const handle = (metric) => {
-        const event = mapMetric(metric, config);
+        if (suppressed)
+            return;
+        const event = mapMetric(metric, config, runtime.getSessionId);
         if (config.debug) {
             console.log(`[squasher] ${metric.name}: ${metric.value.toFixed(2)} (${metric.rating})`);
         }
@@ -84,9 +182,10 @@ export function startVitalsCollection(transport, config) {
     };
     // Register all 5 metric observers.
     // reportAllChanges: true for CLS/INP so we get cumulative values.
-    onLCP(handle);
-    onCLS(handle, { reportAllChanges: true });
-    onINP(handle, { reportAllChanges: true });
-    onFCP(handle);
-    onTTFB(handle);
+    runtime.observeLCP(handle);
+    runtime.observeCLS(handle, { reportAllChanges: true });
+    runtime.observeINP(handle, { reportAllChanges: true });
+    runtime.observeFCP(handle);
+    runtime.observeTTFB(handle);
+    return { suppress };
 }

package/package.json

@@ -1,13 +1,13 @@
 {
   "name": "@squasher-ai/browser",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Official @squasher-ai/browser package for Squasher.",
   "homepage": "https://squasher.ai",
   "license": "MIT",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/squasher-ai/squasher.git",
-    "directory": "packages/sdk-browser"
+    "directory": "packages/public/sdk-browser"
   },
   "bugs": {
     "url": "https://github.com/squasher-ai/squasher/issues"
@@ -20,23 +20,37 @@
   "types": "./dist/index.d.ts",
   "exports": {
     ".": {
+      "source": "./src/index.ts",
       "import": "./dist/index.js",
       "types": "./dist/index.d.ts"
     },
     "./react": {
+      "source": "./src/react.tsx",
       "import": "./dist/react.js",
       "types": "./dist/react.d.ts"
+    },
+    "./next": {
+      "source": "./src/next.tsx",
+      "import": "./dist/next.js",
+      "types": "./dist/next.d.ts"
     }
   },
   "sideEffects": false,
   "dependencies": {
-    "rrweb": "^2.0.0-alpha.4",
+    "@squasher-ai/api-spec": "0.2.0",
+    "@squasher-ai/result-utils": "0.2.0",
+    "@squasher-ai/sdk-core": "0.2.0",
+    "rrweb": "^2.0.0-alpha.20",
     "web-vitals": "^4.2.4"
   },
   "peerDependencies": {
+    "next": ">=14",
     "react": ">=18"
   },
   "peerDependenciesMeta": {
+    "next": {
+      "optional": true
+    },
     "react": {
       "optional": true
     }

package/dist/__tests__/client.test.d.ts

@@ -1,2 +0,0 @@
-export {};
-//# sourceMappingURL=client.test.d.ts.map

package/dist/__tests__/client.test.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.test.d.ts","sourceRoot":"","sources":["../../src/__tests__/client.test.ts"],"names":[],"mappings":""}