@squasher-ai/nextjs 0.3.0 → 0.4.0

package/dist/_vendor/sdk-runtime/runtime/release.js

@@ -0,0 +1,120 @@
+import { readProcessEnvironment } from "./environment.js";
+const MAX_LEN = 200;
+const JUNK_VALUES = new Set([
+    "",
+    "undefined",
+    "null",
+    "nan",
+    "latest",
+    "unknown",
+    "(none)",
+    "n/a",
+    "none",
+]);
+const SEMVER_RE = /^\d+\.\d+\.\d+(?:-[0-9a-zA-Z.-]+)?$/;
+const VERSION_CHAR_RE = /^[A-Za-z0-9._-]+$/;
+const BUILD_CHAR_RE = /^[A-Za-z0-9._-]+$/;
+const SERVICE_CHAR_RE = /^[A-Za-z0-9._/@-]+$/;
+/**
+ * Parse + validate a release string. Returns `null` for empty input, junk
+ * sentinels, values over 200 chars, or strings with whitespace / control chars.
+ * Accepts: `1.2.3`, `v1.2.3`, `svc@1.2.3`, `svc@1.2.3+sha`, `1.2.3+sha`, and
+ * bare git shas (non-semver but valid).
+ */
+export function parseRelease(input) {
+    if (Object.prototype.toString.call(input) !== "[object String]")
+        return null;
+    const raw = String(input).trim();
+    if (raw.length === 0 || raw.length > MAX_LEN)
+        return null;
+    if (JUNK_VALUES.has(raw.toLowerCase()))
+        return null;
+    // Reject whitespace + ASCII control chars (NUL..US, DEL).
+    // oxlint-disable-next-line no-control-regex
+    if (/[\s\x00-\x1f\x7f]/.test(raw))
+        return null;
+    // Only the LAST `@` separates service from version, so npm-style scopes
+    // like `@org/pkg@1.2.3` parse with `@org/pkg` as the service.
+    const atIndex = raw.lastIndexOf("@");
+    let service = null;
+    let rest = raw;
+    if (atIndex >= 0) {
+        const left = raw.slice(0, atIndex);
+        const right = raw.slice(atIndex + 1);
+        if (right.length === 0)
+            return null;
+        service = left.length > 0 ? left : null;
+        rest = right;
+    }
+    if (service !== null && !SERVICE_CHAR_RE.test(service))
+        return null;
+    const plusIndex = rest.indexOf("+");
+    let version;
+    let build;
+    if (plusIndex >= 0) {
+        version = rest.slice(0, plusIndex);
+        build = rest.slice(plusIndex + 1);
+        if (version.length === 0 || build.length === 0)
+            return null;
+        if (!BUILD_CHAR_RE.test(build))
+            return null;
+    }
+    else {
+        version = rest;
+        build = null;
+    }
+    if (!VERSION_CHAR_RE.test(version))
+        return null;
+    // Strip a `v` prefix only when followed by a digit — don't eat the first
+    // character of names like `viper`.
+    const normalizedVersion = version.length > 1 &&
+        (version[0] === "v" || version[0] === "V") &&
+        /[0-9]/.test(version[1] ?? "")
+        ? version.slice(1)
+        : version;
+    const isSemver = SEMVER_RE.test(normalizedVersion);
+    const canonical = [
+        service !== null ? `${service}@` : "",
+        normalizedVersion,
+        build !== null ? `+${build}` : "",
+    ].join("");
+    return { canonical, service, version: normalizedVersion, build, isSemver };
+}
+/**
+ * True when `parseRelease(input)` would accept the value. Pure boolean — use
+ * this at validation boundaries that don't need the parsed pieces (e.g. zod
+ * `.refine()`, ingest pre-filters).
+ */
+export function isValidRelease(input) {
+    return parseRelease(input) !== null;
+}
+/**
+ * Auto-detect a release from common CI/host env vars so customers on
+ * Vercel / Railway / Render / Fly / GitHub Actions get a useful release tag
+ * without configuring anything. Explicit `SQUASHER_RELEASE` always wins;
+ * values that fail `parseRelease` are skipped and detection continues.
+ */
+export function detectRelease(env = readProcessEnvironment()) {
+    const candidates = [
+        env.SQUASHER_RELEASE,
+        env.VERCEL_GIT_COMMIT_SHA,
+        env.RAILWAY_GIT_COMMIT_SHA,
+        env.RENDER_GIT_COMMIT,
+        env.FLY_MACHINE_VERSION,
+        env.GITHUB_SHA,
+        npmPackageCandidate(env),
+    ];
+    for (const value of candidates) {
+        const parsed = parseRelease(value);
+        if (parsed !== null)
+            return parsed.canonical;
+    }
+    return null;
+}
+function npmPackageCandidate(env) {
+    const version = env.npm_package_version;
+    if (!version)
+        return null;
+    const name = env.npm_package_name;
+    return name ? `${name}@${version}` : version;
+}

package/dist/_vendor/sdk-runtime/sampling/index.d.ts

@@ -0,0 +1,43 @@
+interface TelemetrySamplingConfig {
+    successRate?: number;
+    errorRate?: number;
+    slowRate?: number;
+    slowThresholdMs?: number;
+    alwaysSampleUserIds?: string[];
+    alwaysSampleReleases?: string[];
+}
+type SamplingAttributePrimitive = boolean | null | number | string;
+type SamplingAttributeValue = SamplingAttributePrimitive | SamplingAttributeValue[] | SamplingAttributes;
+interface SamplingAttributes {
+    [key: string]: SamplingAttributeValue;
+}
+interface SamplingEvent {
+    attributes?: SamplingAttributes;
+    distinct_id?: string;
+    event_name?: string;
+    kind?: string;
+    level?: string;
+    message: string;
+    release?: string;
+    session_id?: string;
+    timestamp?: number | string;
+    trace?: {
+        duration_ms?: number;
+        status?: string;
+        trace_id?: string;
+    };
+    user?: {
+        id?: string;
+    };
+}
+export interface ResolvedTelemetrySampling {
+    successRate: number;
+    errorRate: number;
+    slowRate: number;
+    slowThresholdMs: number;
+    alwaysSampleUserIds: ReadonlySet<string>;
+    alwaysSampleReleases: ReadonlySet<string>;
+}
+export declare function resolveTelemetrySampling(config: TelemetrySamplingConfig | undefined): ResolvedTelemetrySampling;
+export declare function shouldSampleTelemetry(event: SamplingEvent, config: ResolvedTelemetrySampling): boolean;
+export {};

package/dist/_vendor/sdk-runtime/sampling/index.js

@@ -0,0 +1,70 @@
+export function resolveTelemetrySampling(config) {
+    return {
+        successRate: rate(config?.successRate, 1),
+        errorRate: rate(config?.errorRate, 1),
+        slowRate: rate(config?.slowRate, 1),
+        slowThresholdMs: Math.max(0, config?.slowThresholdMs ?? 1_000),
+        alwaysSampleUserIds: new Set(config?.alwaysSampleUserIds ?? []),
+        alwaysSampleReleases: new Set(config?.alwaysSampleReleases ?? []),
+    };
+}
+export function shouldSampleTelemetry(event, config) {
+    if ((event.distinct_id && config.alwaysSampleUserIds.has(event.distinct_id)) ||
+        (event.user?.id && config.alwaysSampleUserIds.has(event.user.id)))
+        return true;
+    if (event.release && config.alwaysSampleReleases.has(event.release))
+        return true;
+    // AI generation events are metered usage: dropping them would under-report
+    // tokens, cost, and cache reads on the AI dashboards, so they are never sampled.
+    if (event.kind === "llm_generation")
+        return true;
+    // Events in one trace share a hash input, but each outcome class applies its
+    // configured threshold. This correlates their decisions without pretending
+    // that event sampling is whole-trace tail sampling.
+    const durationMs = event.trace?.duration_ms;
+    const selectedRate = isFailure(event)
+        ? config.errorRate
+        : durationMs !== undefined && durationMs >= config.slowThresholdMs
+            ? config.slowRate
+            : config.successRate;
+    if (selectedRate >= 1)
+        return true;
+    if (selectedRate <= 0)
+        return false;
+    return stableFraction(sampleKey(event)) < selectedRate;
+}
+function isFailure(event) {
+    if (event.level === "fatal" || event.level === "error" || event.level === "warning")
+        return true;
+    if (event.kind === "error" || event.trace?.status === "error")
+        return true;
+    const outcome = event.attributes?.["squasher.outcome"] ?? event.attributes?.outcome;
+    return outcome === "failure" || outcome === "error";
+}
+function sampleKey(event) {
+    if (event.trace?.trace_id)
+        return `trace:${event.trace.trace_id}`;
+    return [
+        event.session_id,
+        event.distinct_id,
+        event.user?.id,
+        event.event_name,
+        event.message,
+        event.timestamp === undefined ? undefined : String(event.timestamp),
+    ]
+        .filter((value) => Boolean(value))
+        .join("|");
+}
+function stableFraction(value) {
+    let hash = 2166136261;
+    for (let index = 0; index < value.length; index++) {
+        hash ^= value.charCodeAt(index);
+        hash = Math.imul(hash, 16777619);
+    }
+    return (hash >>> 0) / 0x1_0000_0000;
+}
+function rate(value, fallback) {
+    if (value === undefined || !Number.isFinite(value))
+        return fallback;
+    return Math.min(1, Math.max(0, value));
+}

package/dist/api-handler.d.ts

@@ -1,4 +1,4 @@
-import { getClient } from "@squasher-ai/node";
+import { getClient } from "./_vendor/node-sdk/index.js";
 type NextApiHandler = (request: Request) => Response | Promise<Response>;
 export type SquasherClientResolver = () => Pick<ReturnType<typeof getClient>, "addBreadcrumb" | "captureError">;
 /**

package/dist/api-handler.js

@@ -1,4 +1,4 @@
-import { getClient } from "@squasher-ai/node";
+import { getClient } from "./_vendor/node-sdk/index.js";
 import { attemptAsync } from "./_vendor/result-runtime/attempt.js";
 /**
  * Wrap a Next.js App Router API route handler to capture errors.

package/dist/client.d.ts

@@ -1,5 +1,5 @@
 import { Component, type ErrorInfo, type ReactNode } from "react";
-import { getClient, type JsonObject } from "@squasher-ai/node";
+import { getClient, type JsonObject } from "./_vendor/node-sdk/index.js";
 interface Props {
     children: ReactNode;
     fallback?: ReactNode;

package/dist/client.js

@@ -1,6 +1,6 @@
 "use client";
 import { Component } from "react";
-import { getClient } from "@squasher-ai/node";
+import { getClient } from "./_vendor/node-sdk/index.js";
 import { attempt } from "./_vendor/result-runtime/attempt.js";
 /**
  * Error boundary that captures errors to Squasher.

package/dist/index.d.ts

@@ -1,4 +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 { SquasherClient, captureGeneration, init, getClient, identify, page, captureError, captureMessage, captureSpan, captureTelemetry, captureToolCall, screen, track, } from "./_vendor/node-sdk/index.js";
+export type { AnalyticsContext, JsonObject, SquasherConfig, ErrorEvent, UserContext, Breadcrumb, LlmContext, PageContext, SessionContext, TelemetryKind, TelemetryMeasurement, ToolCallContext, TraceContext, VisitorContext, } from "./_vendor/node-sdk/index.js";
 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 { SquasherClient, captureGeneration, init, getClient, identify, page, captureError, captureMessage, captureSpan, captureTelemetry, captureToolCall, screen, track, } from "./_vendor/node-sdk/index.js";
 export { withSquasher } from "./middleware.js";
 export { squasherApiHandler } from "./api-handler.js";

package/dist/middleware.js

@@ -1,4 +1,4 @@
-import { getClient } from "@squasher-ai/node";
+import { getClient } from "./_vendor/node-sdk/index.js";
 import { attemptAsync } from "./_vendor/result-runtime/attempt.js";
 /**
  * Wrap a Next.js middleware to capture errors automatically.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@squasher-ai/nextjs",
-  "version": "0.3.0",
+  "version": "0.4.0",
   "description": "Official @squasher-ai/nextjs package for Squasher.",
   "homepage": "https://squasher.ai",
   "license": "MIT",
@@ -20,9 +20,6 @@
       "types": "./dist/client.d.ts"
     }
   },
-  "dependencies": {
-    "@squasher-ai/node": "0.4.0"
-  },
   "peerDependencies": {
     "next": ">=14.0.0"
   }