@squasher-ai/nextjs 0.1.1 → 0.3.0

package/LICENSE

@@ -1,21 +1,21 @@
-MIT License
-
-Copyright (c) 2026 Squasher
-
-Permission is hereby granted, free of charge, to any person obtaining a copy
-of this software and associated documentation files (the "Software"), to deal
-in the Software without restriction, including without limitation the rights
-to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
-copies of the Software, and to permit persons to whom the Software is
-furnished to do so, subject to the following conditions:
-
-The above copyright notice and this permission notice shall be included in all
-copies or substantial portions of the Software.
-
-THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
-IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
-FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
-AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
-LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
-OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
-SOFTWARE.
+MIT License
+
+Copyright (c) 2026 Squasher
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -8,5 +8,5 @@ Official @squasher-ai/nextjs package for Squasher.
 npm install @squasher-ai/nextjs
 ```
 
-Docs: https://docs.squasher.ai
+Docs: https://docs.squasher.ai/sdks/nextjs
 Homepage: https://squasher.ai

package/dist/_vendor/result-runtime/attempt.d.ts

@@ -0,0 +1,17 @@
+export interface AttemptFailure<TCause = Error> {
+    cause: TCause;
+    error: Error;
+}
+export interface AttemptOptions<TTry, TCatch = TTry, TCause = Error> {
+    try: () => TTry;
+    catch: (failure: AttemptFailure<TCause>) => TCatch;
+    finally?: () => void;
+}
+export interface AttemptAsyncOptions<TTry, TCatch = TTry, TCause = Error> {
+    try: () => Promise<TTry>;
+    catch: (failure: AttemptFailure<TCause>) => Promise<TCatch> | TCatch;
+    finally?: () => Promise<void> | void;
+}
+export declare function toError<T>(cause: T, fallbackMessage?: string): Error;
+export declare function attempt<TTry, TCatch = TTry, TCause = Error>(options: AttemptOptions<TTry, TCatch, TCause>): TTry | TCatch;
+export declare function attemptAsync<TTry, TCatch = TTry, TCause = Error>(options: AttemptAsyncOptions<TTry, TCatch, TCause>): Promise<TTry | TCatch>;

package/dist/_vendor/result-runtime/attempt.js

@@ -0,0 +1,62 @@
+export function toError(cause, fallbackMessage = "Unexpected error") {
+    if (cause instanceof Error)
+        return cause;
+    const nestedError = readProperty(cause, "error");
+    if (nestedError instanceof Error)
+        return nestedError;
+    const messageValue = readProperty(cause, "message");
+    if (Object.prototype.toString.call(messageValue) === "[object String]") {
+        const message = String(messageValue);
+        if (message.length > 0)
+            return new Error(message);
+    }
+    if (Object.prototype.toString.call(cause) === "[object String]") {
+        const message = String(cause);
+        if (message.length > 0)
+            return new Error(message);
+    }
+    return new Error(fallbackMessage, { cause });
+}
+function readProperty(owner, key) {
+    try {
+        const target = Object(owner);
+        let cursor = target;
+        while (cursor) {
+            const descriptor = Object.getOwnPropertyDescriptor(cursor, key);
+            if (descriptor) {
+                return "value" in descriptor ? descriptor.value : descriptor.get?.call(target);
+            }
+            cursor = Object.getPrototypeOf(cursor);
+        }
+        return undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export function attempt(options) {
+    try {
+        return options.try();
+    }
+    catch (cause) {
+        // SAFETY: `TCause` is the caller-selected type for the catch channel.
+        const preservedCause = cause;
+        return options.catch({ cause: preservedCause, error: toError(preservedCause) });
+    }
+    finally {
+        options.finally?.();
+    }
+}
+export async function attemptAsync(options) {
+    try {
+        return await options.try();
+    }
+    catch (cause) {
+        // SAFETY: `TCause` is the caller-selected type for the catch channel.
+        const preservedCause = cause;
+        return await options.catch({ cause: preservedCause, error: toError(preservedCause) });
+    }
+    finally {
+        await options.finally?.();
+    }
+}

package/dist/_vendor/telemetry-contract/sdk/public-contract.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Customer-facing telemetry contract shared by the published JavaScript SDKs.
+ * This module intentionally contains only the documented ingestion shapes.
+ */
+export type JsonPrimitive = boolean | null | number | string;
+export interface JsonObject {
+    [key: string]: JsonValue;
+}
+export type JsonValue = JsonPrimitive | JsonValue[] | JsonObject;
+export type Level = "fatal" | "error" | "warning" | "info" | "debug";
+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 RequestContext {
+    url?: string;
+    method?: string;
+    headers?: Record<string, string>;
+}
+export interface Breadcrumb {
+    timestamp?: string;
+    category?: string;
+    message?: string;
+    level?: string;
+    data?: JsonObject;
+}
+/** Event payload accepted by the documented ingestion endpoint. */
+export interface IngestEvent {
+    message: string;
+    type?: string;
+    stack?: string;
+    frames?: StackFrame[];
+    level?: Level;
+    tags?: Record<string, string>;
+    user?: UserContext;
+    request?: RequestContext;
+    sdk?: {
+        name: string;
+        version: string;
+    };
+    timestamp?: string;
+    release?: string;
+    environment?: string;
+    breadcrumbs?: Breadcrumb[];
+    extra?: Record<string, JsonValue>;
+    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[];
+    resource_attributes?: Record<string, string>;
+}
+export interface IngestBatchPayload {
+    events: IngestEvent[];
+}
+export type IngestEventBatch = [IngestEvent, ...IngestEvent[]];
+export interface IngestBatchEnvelope {
+    events: IngestEventBatch;
+}
+export type IngestJsonBatchPayload = IngestEventBatch | IngestBatchEnvelope;
+export type IngestJsonPayload = IngestEvent | IngestJsonBatchPayload;
+/** An encoded newline-delimited JSON request body. */
+export type IngestNdjsonPayload = string;
+export type IngestRequestPayload = IngestJsonPayload | IngestNdjsonPayload;
+export type TelemetryKind = "error" | "log" | "analytics" | "identify" | "page" | "screen" | "visitor" | "agent_session" | "agent_span" | "tool_call" | "llm_generation" | "agent_score";
+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;
+    cached_input_tokens?: number;
+    cost_usd?: number;
+    latency_ms?: number;
+    status?: string;
+    input?: JsonObject;
+    output?: JsonObject;
+}
+export interface TelemetryMeasurement {
+    name: string;
+    value: number;
+    unit?: string;
+}
+/** Outcome-aware SDK sampling. Errors and slow operations are kept by default. */
+export interface TelemetrySamplingConfig {
+    successRate?: number;
+    errorRate?: number;
+    slowRate?: number;
+    slowThresholdMs?: number;
+    alwaysSampleUserIds?: string[];
+    alwaysSampleReleases?: string[];
+}
+export interface IngestResponse {
+    id: string;
+    status: string;
+    accepted?: number;
+}
+export interface SdkConfig {
+    apiKey: string;
+    projectId: string;
+    endpoint?: string;
+    environment?: string;
+    release?: string;
+    debug?: boolean;
+    sampling?: TelemetrySamplingConfig;
+    beforeSend?: (event: IngestEvent) => IngestEvent | null;
+    maxBreadcrumbs?: number;
+    resourceAttributes?: Record<string, string>;
+    autoFlushIntervalMs?: number;
+}

package/dist/_vendor/telemetry-contract/sdk/public-contract.js

@@ -0,0 +1,5 @@
+/**
+ * Customer-facing telemetry contract shared by the published JavaScript SDKs.
+ * This module intentionally contains only the documented ingestion shapes.
+ */
+export {};

package/dist/api-handler.d.ts

@@ -1,4 +1,6 @@
+import { getClient } from "@squasher-ai/node";
 type NextApiHandler = (request: Request) => Response | Promise<Response>;
+export type SquasherClientResolver = () => Pick<ReturnType<typeof getClient>, "addBreadcrumb" | "captureError">;
 /**
  * Wrap a Next.js App Router API route handler to capture errors.
  *
@@ -10,6 +12,5 @@ type NextApiHandler = (request: Request) => Response | Promise<Response>;
  * });
  * ```
  */
-export declare function squasherApiHandler(handler: NextApiHandler): NextApiHandler;
+export declare function squasherApiHandler(handler: NextApiHandler, resolveClient?: SquasherClientResolver): NextApiHandler;
 export {};
-//# sourceMappingURL=api-handler.d.ts.map

package/dist/api-handler.js

@@ -1,4 +1,5 @@
 import { getClient } from "@squasher-ai/node";
+import { attemptAsync } from "./_vendor/result-runtime/attempt.js";
 /**
  * Wrap a Next.js App Router API route handler to capture errors.
  *
@@ -10,30 +11,30 @@ import { getClient } from "@squasher-ai/node";
  * });
  * ```
  */
-export function squasherApiHandler(handler) {
+export function squasherApiHandler(handler, resolveClient = getClient) {
     return async (request) => {
         try {
             return await handler(request);
         }
-        catch (error) {
-            if (error instanceof Error) {
-                try {
-                    const client = getClient();
-                    const url = new URL(request.url);
-                    client.addBreadcrumb({
-                        category: "api",
-                        message: `${request.method} ${url.pathname}`,
-                    });
-                    await client.captureError(error, {
-                        url: request.url,
-                        method: request.method,
-                    });
-                }
-                catch {
-                    // SDK not initialized — silently ignore
-                }
+        catch (cause) {
+            if (cause instanceof Error) {
+                await attemptAsync({
+                    try: async () => {
+                        const client = resolveClient();
+                        const url = new URL(request.url);
+                        client.addBreadcrumb({
+                            category: "api",
+                            message: `${request.method} ${url.pathname}`,
+                        });
+                        await client.captureError(cause, {
+                            url: request.url,
+                            method: request.method,
+                        });
+                    },
+                    catch: () => undefined,
+                });
             }
-            throw error;
+            throw cause;
         }
     };
 }

package/dist/client.d.ts

@@ -1,7 +1,9 @@
 import { Component, type ErrorInfo, type ReactNode } from "react";
+import { getClient, type JsonObject } from "@squasher-ai/node";
 interface Props {
     children: ReactNode;
     fallback?: ReactNode;
+    captureError?: (error: Error, context: JsonObject) => ReturnType<ReturnType<typeof getClient>["captureError"]>;
 }
 interface State {
     hasError: boolean;
@@ -25,4 +27,3 @@ export declare class SquasherErrorBoundary extends Component<Props, State> {
     render(): ReactNode;
 }
 export {};
-//# sourceMappingURL=client.d.ts.map

package/dist/client.js

@@ -1,6 +1,7 @@
 "use client";
 import { Component } from "react";
 import { getClient } from "@squasher-ai/node";
+import { attempt } from "./_vendor/result-runtime/attempt.js";
 /**
  * Error boundary that captures errors to Squasher.
  *
@@ -22,15 +23,20 @@ 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 context = {};
+                if (errorInfo.componentStack)
+                    context.componentStack = errorInfo.componentStack;
+                if (this.props.captureError) {
+                    this.props.captureError(error, context);
+                }
+                else {
+                    getClient().captureError(error, context);
+                }
+            },
+            catch: () => undefined,
+        });
     }
     render() {
         if (this.state.hasError) {

package/dist/index.d.ts

@@ -1,5 +1,4 @@
 export { SquasherClient, captureGeneration, init, getClient, identify, page, captureError, captureMessage, captureSpan, captureTelemetry, captureToolCall, screen, track, } from "@squasher-ai/node";
 export type { AnalyticsContext, JsonObject, SquasherConfig, ErrorEvent, UserContext, Breadcrumb, LlmContext, PageContext, SessionContext, TelemetryKind, TelemetryMeasurement, ToolCallContext, TraceContext, VisitorContext, } from "@squasher-ai/node";
-export { withSquasher } from "./middleware";
-export { squasherApiHandler } from "./api-handler";
-//# sourceMappingURL=index.d.ts.map
+export { withSquasher } from "./middleware.js";
+export { squasherApiHandler } from "./api-handler.js";

package/dist/index.js

@@ -1,3 +1,3 @@
 export { SquasherClient, captureGeneration, init, getClient, identify, page, captureError, captureMessage, captureSpan, captureTelemetry, captureToolCall, screen, track, } from "@squasher-ai/node";
-export { withSquasher } from "./middleware";
-export { squasherApiHandler } from "./api-handler";
+export { withSquasher } from "./middleware.js";
+export { squasherApiHandler } from "./api-handler.js";

package/dist/middleware.d.ts

@@ -1,4 +1,5 @@
 import type { NextRequest, NextResponse } from "next/server";
+import type { SquasherClientResolver } from "./api-handler";
 type MiddlewareHandler = (request: NextRequest) => NextResponse | Response | Promise<NextResponse | Response>;
 /**
  * Wrap a Next.js middleware to capture errors automatically.
@@ -11,6 +12,5 @@ type MiddlewareHandler = (request: NextRequest) => NextResponse | Response | Pro
  * });
  * ```
  */
-export declare function withSquasher(handler: MiddlewareHandler): MiddlewareHandler;
+export declare function withSquasher(handler: MiddlewareHandler, resolveClient?: SquasherClientResolver): MiddlewareHandler;
 export {};
-//# sourceMappingURL=middleware.d.ts.map

package/dist/middleware.js

@@ -1,4 +1,5 @@
 import { getClient } from "@squasher-ai/node";
+import { attemptAsync } from "./_vendor/result-runtime/attempt.js";
 /**
  * Wrap a Next.js middleware to capture errors automatically.
  *
@@ -10,29 +11,29 @@ import { getClient } from "@squasher-ai/node";
  * });
  * ```
  */
-export function withSquasher(handler) {
+export function withSquasher(handler, resolveClient = getClient) {
     return async (request) => {
         try {
             return await handler(request);
         }
-        catch (error) {
-            if (error instanceof Error) {
-                try {
-                    const client = getClient();
-                    client.addBreadcrumb({
-                        category: "middleware",
-                        message: `${request.method} ${request.nextUrl.pathname}`,
-                    });
-                    await client.captureError(error, {
-                        url: request.nextUrl.toString(),
-                        method: request.method,
-                    });
-                }
-                catch {
-                    // SDK not initialized — silently ignore
-                }
+        catch (cause) {
+            if (cause instanceof Error) {
+                await attemptAsync({
+                    try: async () => {
+                        const client = resolveClient();
+                        client.addBreadcrumb({
+                            category: "middleware",
+                            message: `${request.method} ${request.nextUrl.pathname}`,
+                        });
+                        await client.captureError(cause, {
+                            url: request.nextUrl.toString(),
+                            method: request.method,
+                        });
+                    },
+                    catch: () => undefined,
+                });
             }
-            throw error;
+            throw cause;
         }
     };
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "@squasher-ai/nextjs",
-  "version": "0.1.1",
+  "version": "0.3.0",
   "description": "Official @squasher-ai/nextjs package for Squasher.",
-  "homepage": "https://docs.squasher.ai",
+  "homepage": "https://squasher.ai",
   "license": "MIT",
   "publishConfig": {
     "access": "public"
@@ -21,7 +21,7 @@
     }
   },
   "dependencies": {
-    "@squasher-ai/node": "0.1.1"
+    "@squasher-ai/node": "0.4.0"
   },
   "peerDependencies": {
     "next": ">=14.0.0"

package/dist/api-handler.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"api-handler.d.ts","sourceRoot":"","sources":["../src/api-handler.ts"],"names":[],"mappings":"AAEA,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,OAAO,KAAK,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEzE;;;;;;;;;;GAUG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,cAAc,GAAG,cAAc,CAwB1E"}

package/dist/client.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.tsx"],"names":[],"mappings":"AAEA,OAAO,EAAE,SAAS,EAAE,KAAK,SAAS,EAAE,KAAK,SAAS,EAAE,MAAM,OAAO,CAAC;AAGlE,UAAU,KAAK;IACb,QAAQ,EAAE,SAAS,CAAC;IACpB,QAAQ,CAAC,EAAE,SAAS,CAAC;CACtB;AAED,UAAU,KAAK;IACb,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED;;;;;;;;;;;GAWG;AACH,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;IAW3D,MAAM,IAAI,SAAS;CAM7B"}

package/dist/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,cAAc,EACd,iBAAiB,EACjB,IAAI,EACJ,SAAS,EACT,QAAQ,EACR,IAAI,EACJ,YAAY,EACZ,cAAc,EACd,WAAW,EACX,gBAAgB,EAChB,eAAe,EACf,MAAM,EACN,KAAK,GACN,MAAM,gBAAgB,CAAC;AACxB,YAAY,EACV,gBAAgB,EAChB,UAAU,EACV,cAAc,EACd,UAAU,EACV,WAAW,EACX,UAAU,EACV,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,oBAAoB,EACpB,eAAe,EACf,YAAY,EACZ,cAAc,GACf,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC"}

package/dist/middleware.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"middleware.d.ts","sourceRoot":"","sources":["../src/middleware.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAG7D,KAAK,iBAAiB,GAAG,CACvB,OAAO,EAAE,WAAW,KACjB,YAAY,GAAG,QAAQ,GAAG,OAAO,CAAC,YAAY,GAAG,QAAQ,CAAC,CAAC;AAEhE;;;;;;;;;;GAUG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,iBAAiB,GAAG,iBAAiB,CAuB1E"}