@interfere/types 10.2.2 → 10.4.0

package/dist/sdk/envelope.d.cts

@@ -188,7 +188,7 @@ export declare const errorEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -315,7 +315,7 @@ export declare const pageviewEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -422,7 +422,7 @@ export declare const pageleaveEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -529,7 +529,7 @@ export declare const uiEventEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -635,7 +635,7 @@ export declare const replayChunkEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -745,7 +745,7 @@ export declare const rageClickEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -857,7 +857,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -983,7 +983,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1089,7 +1089,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1195,7 +1195,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1300,7 +1300,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1409,7 +1409,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";

package/dist/sdk/envelope.d.mts

@@ -188,7 +188,7 @@ export declare const errorEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -315,7 +315,7 @@ export declare const pageviewEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -422,7 +422,7 @@ export declare const pageleaveEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -529,7 +529,7 @@ export declare const uiEventEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -635,7 +635,7 @@ export declare const replayChunkEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -745,7 +745,7 @@ export declare const rageClickEnvelopeSchema: z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -857,7 +857,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -983,7 +983,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1089,7 +1089,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1195,7 +1195,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1300,7 +1300,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";
@@ -1409,7 +1409,7 @@ export declare const envelopeSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
     node: "node";
   }>>;
   sdkStack: z.ZodOptional<z.ZodArray<z.ZodString>>;
-  sessionId: z.ZodNullable<z.core.$ZodBranded<z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>, "SessionId", "out">>;
+  sessionId: z.ZodNullable<z.ZodIntersection<z.core.$ZodBranded<z.ZodString, "SessionId", "out">, z.ZodUnion<readonly [z.ZodUUID, z.ZodTemplateLiteral<`server_${string}`>]>>>;
   sessionSource: z.ZodOptional<z.ZodEnum<{
     async_context: "async_context";
     client: "client";

package/dist/sdk/errors.d.cts

@@ -92,19 +92,7 @@ export declare function parseReactComponentStack(componentStack: string): {
   line?: number | undefined;
   source?: string | undefined;
 }[];
-/**
- * Coerces any thrown value into an `Error` instance, preferring a nested
- * `Error` inside a plain-object rejection over a stringified fallback.
- *
- * Motivated by the common `Promise.reject({ error: realErr })` pattern
- * (tRPC, GraphQL clients, some fetch wrappers). Without this, the captured
- * exception would be `new Error("[object Object]")` and the nested Error's
- * stack/message would be lost entirely.
- *
- * When multiple candidate Error values exist on the object, the first one
- * found (in declaration order) wins. `cause` is preferred if present, since
- * it's the documented ES2022 convention.
- */
+/** Returns an Error, preferring an existing or nested Error over a stringified fallback. */
 export declare function toError(error: unknown): Error;
 /**
  * Capture-side variant for thrown values that aren't Errors and don't
@@ -139,29 +127,10 @@ export interface NonErrorException {
    */
   readonly value: string;
 }
-/**
- * Depth-bounded, circular-safe clone. Primitives + null/undefined pass
- * through as-is. Objects and arrays recurse up to `MAX_NON_ERROR_DEPTH`
- * before collapsing to `DEPTH_LIMIT_SENTINEL`; back-edges become
- * `CIRCULAR_SENTINEL`. Functions, symbols, and other non-serialisable
- * values are coerced via `String(...)` so the dashboard can render
- * something rather than dropping the field.
- */
 type SerializedException = null | undefined | string | number | boolean | SerializedException[] | {
   [key: string]: SerializedException;
 };
-/**
- * Coerces any thrown value into either an `Error` (when one is
- * recoverable — direct Error, or nested Error inside an object via
- * `cause` / first-Error-valued property — or a string, which maps
- * cleanly to `new Error(str)`) or a structured `NonErrorException`
- * carrying the original payload.
- *
- * Replaces `toError` for capture sites that handle both branches
- * (today: `unhandledrejection`). `toError` is kept for callers that
- * specifically need an `Error` (`<ErrorBoundary>` interop, browser
- * APIs that take Error-typed args).
- */
+/** Preserves recoverable Errors and serializes other thrown values as structured exceptions. */
 export declare function toException(value: unknown): Error | {
   kind: "non-error";
   serialized: SerializedException;
@@ -175,7 +144,7 @@ export declare function isNonErrorException(value: unknown): value is NonErrorEx
  * plus the raw `stack` string — the SDK ships **no parsed frames**.
  * Server-side ingest parses `stack` into structured `IngestedFrame[]`
  * via the collector's stack parser (see
- * `src/packages/private/otlp-ingest/src/stack-parser.ts`).
+ * `src/packages/private/otlp-ingest/src/mapping/traces/stack-parser.ts`).
  *
  * Non-Error rejections short-circuit to a single `kind: "non-error"`
  * entry with the structured payload on `serialized`.

package/dist/sdk/errors.d.mts

@@ -92,19 +92,7 @@ export declare function parseReactComponentStack(componentStack: string): {
   line?: number | undefined;
   source?: string | undefined;
 }[];
-/**
- * Coerces any thrown value into an `Error` instance, preferring a nested
- * `Error` inside a plain-object rejection over a stringified fallback.
- *
- * Motivated by the common `Promise.reject({ error: realErr })` pattern
- * (tRPC, GraphQL clients, some fetch wrappers). Without this, the captured
- * exception would be `new Error("[object Object]")` and the nested Error's
- * stack/message would be lost entirely.
- *
- * When multiple candidate Error values exist on the object, the first one
- * found (in declaration order) wins. `cause` is preferred if present, since
- * it's the documented ES2022 convention.
- */
+/** Returns an Error, preferring an existing or nested Error over a stringified fallback. */
 export declare function toError(error: unknown): Error;
 /**
  * Capture-side variant for thrown values that aren't Errors and don't
@@ -139,29 +127,10 @@ export interface NonErrorException {
    */
   readonly value: string;
 }
-/**
- * Depth-bounded, circular-safe clone. Primitives + null/undefined pass
- * through as-is. Objects and arrays recurse up to `MAX_NON_ERROR_DEPTH`
- * before collapsing to `DEPTH_LIMIT_SENTINEL`; back-edges become
- * `CIRCULAR_SENTINEL`. Functions, symbols, and other non-serialisable
- * values are coerced via `String(...)` so the dashboard can render
- * something rather than dropping the field.
- */
 type SerializedException = null | undefined | string | number | boolean | SerializedException[] | {
   [key: string]: SerializedException;
 };
-/**
- * Coerces any thrown value into either an `Error` (when one is
- * recoverable — direct Error, or nested Error inside an object via
- * `cause` / first-Error-valued property — or a string, which maps
- * cleanly to `new Error(str)`) or a structured `NonErrorException`
- * carrying the original payload.
- *
- * Replaces `toError` for capture sites that handle both branches
- * (today: `unhandledrejection`). `toError` is kept for callers that
- * specifically need an `Error` (`<ErrorBoundary>` interop, browser
- * APIs that take Error-typed args).
- */
+/** Preserves recoverable Errors and serializes other thrown values as structured exceptions. */
 export declare function toException(value: unknown): Error | {
   kind: "non-error";
   serialized: SerializedException;
@@ -175,7 +144,7 @@ export declare function isNonErrorException(value: unknown): value is NonErrorEx
  * plus the raw `stack` string — the SDK ships **no parsed frames**.
  * Server-side ingest parses `stack` into structured `IngestedFrame[]`
  * via the collector's stack parser (see
- * `src/packages/private/otlp-ingest/src/stack-parser.ts`).
+ * `src/packages/private/otlp-ingest/src/mapping/traces/stack-parser.ts`).
  *
  * Non-Error rejections short-circuit to a single `kind: "non-error"`
  * entry with the structured payload on `serialized`.

package/dist/sdk/injected-globals.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),exports.API_URL_GLOBAL=`__INTERFERE_API_URL__`,exports.BUILD_MARKER_GLOBAL=`__INTERFERE_BUILD__`,exports.ENVIRONMENT_GLOBAL=`__INTERFERE_ENVIRONMENT__`,exports.FORCE_ENABLE_GLOBAL=`__INTERFERE_FORCE_ENABLE__`,exports.INGEST_URL_GLOBAL=`__INTERFERE_INGEST_URL__`,exports.PUBLIC_KEY_GLOBAL=`__INTERFERE_PUBLIC_KEY__`,exports.RELEASE_SLUG_GLOBAL=`__INTERFERE_RELEASE_SLUG__`,exports.SDK_STACK_GLOBAL=`__INTERFERE_SDK_STACK__`;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),exports.API_URL_GLOBAL=`__INTERFERE_API_URL__`,exports.BUILD_MARKER_GLOBAL=`__INTERFERE_BUILD__`,exports.DISABLED_GLOBAL=`__INTERFERE_DISABLED__`,exports.ENVIRONMENT_GLOBAL=`__INTERFERE_ENVIRONMENT__`,exports.FORCE_ENABLE_GLOBAL=`__INTERFERE_FORCE_ENABLE__`,exports.INGEST_URL_GLOBAL=`__INTERFERE_INGEST_URL__`,exports.PUBLIC_KEY_GLOBAL=`__INTERFERE_PUBLIC_KEY__`,exports.RELEASE_SLUG_GLOBAL=`__INTERFERE_RELEASE_SLUG__`,exports.SDK_STACK_GLOBAL=`__INTERFERE_SDK_STACK__`;

package/dist/sdk/injected-globals.d.cts

@@ -1,6 +1,7 @@
 //#region src/sdk/injected-globals.d.ts
 export declare const API_URL_GLOBAL = "__INTERFERE_API_URL__";
 export declare const BUILD_MARKER_GLOBAL = "__INTERFERE_BUILD__";
+export declare const DISABLED_GLOBAL = "__INTERFERE_DISABLED__";
 export declare const ENVIRONMENT_GLOBAL = "__INTERFERE_ENVIRONMENT__";
 export declare const FORCE_ENABLE_GLOBAL = "__INTERFERE_FORCE_ENABLE__";
 export declare const INGEST_URL_GLOBAL = "__INTERFERE_INGEST_URL__";

package/dist/sdk/injected-globals.d.mts

@@ -1,6 +1,7 @@
 //#region src/sdk/injected-globals.d.ts
 export declare const API_URL_GLOBAL = "__INTERFERE_API_URL__";
 export declare const BUILD_MARKER_GLOBAL = "__INTERFERE_BUILD__";
+export declare const DISABLED_GLOBAL = "__INTERFERE_DISABLED__";
 export declare const ENVIRONMENT_GLOBAL = "__INTERFERE_ENVIRONMENT__";
 export declare const FORCE_ENABLE_GLOBAL = "__INTERFERE_FORCE_ENABLE__";
 export declare const INGEST_URL_GLOBAL = "__INTERFERE_INGEST_URL__";

package/dist/sdk/injected-globals.mjs

@@ -1 +1 @@
-const API_URL_GLOBAL=`__INTERFERE_API_URL__`,BUILD_MARKER_GLOBAL=`__INTERFERE_BUILD__`,ENVIRONMENT_GLOBAL=`__INTERFERE_ENVIRONMENT__`,FORCE_ENABLE_GLOBAL=`__INTERFERE_FORCE_ENABLE__`,INGEST_URL_GLOBAL=`__INTERFERE_INGEST_URL__`,PUBLIC_KEY_GLOBAL=`__INTERFERE_PUBLIC_KEY__`,RELEASE_SLUG_GLOBAL=`__INTERFERE_RELEASE_SLUG__`,SDK_STACK_GLOBAL=`__INTERFERE_SDK_STACK__`;export{API_URL_GLOBAL,BUILD_MARKER_GLOBAL,ENVIRONMENT_GLOBAL,FORCE_ENABLE_GLOBAL,INGEST_URL_GLOBAL,PUBLIC_KEY_GLOBAL,RELEASE_SLUG_GLOBAL,SDK_STACK_GLOBAL};
+const API_URL_GLOBAL=`__INTERFERE_API_URL__`,BUILD_MARKER_GLOBAL=`__INTERFERE_BUILD__`,DISABLED_GLOBAL=`__INTERFERE_DISABLED__`,ENVIRONMENT_GLOBAL=`__INTERFERE_ENVIRONMENT__`,FORCE_ENABLE_GLOBAL=`__INTERFERE_FORCE_ENABLE__`,INGEST_URL_GLOBAL=`__INTERFERE_INGEST_URL__`,PUBLIC_KEY_GLOBAL=`__INTERFERE_PUBLIC_KEY__`,RELEASE_SLUG_GLOBAL=`__INTERFERE_RELEASE_SLUG__`,SDK_STACK_GLOBAL=`__INTERFERE_SDK_STACK__`;export{API_URL_GLOBAL,BUILD_MARKER_GLOBAL,DISABLED_GLOBAL,ENVIRONMENT_GLOBAL,FORCE_ENABLE_GLOBAL,INGEST_URL_GLOBAL,PUBLIC_KEY_GLOBAL,RELEASE_SLUG_GLOBAL,SDK_STACK_GLOBAL};

package/dist/sdk/runtime.cjs

@@ -1 +1 @@
-Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let zod=require("zod");const envSchema=zod.z.string().min(1).nullable().meta({description:"Deployment environment the SDK is running in. Free-form label (e.g. `production`, `preview`, `staging`, `development`).",id:`Environment`,title:`Environment`}),DEFAULT_ENVIRONMENT=`development`,ENVIRONMENT_ENV_VARS=[`INTERFERE_ENVIRONMENT`,`VERCEL_ENV`,`NODE_ENV`];function resolveEnvironment(opts){let env=opts?.env??{},explicit=normalizeEnv(opts?.explicit);if(explicit)return explicit;for(let key of ENVIRONMENT_ENV_VARS){let value=normalizeEnv(env[key]);if(value)return value}return DEFAULT_ENVIRONMENT}const runtimeSchema=zod.z.enum([`browser`,`node`,`edge`]).nullable().meta({description:`JavaScript runtime the SDK is running in.`,id:`Runtime`,title:`Runtime`}),globalScope=globalThis;function readProcessEnv(){return globalScope.process?.env}function inferRuntime(options){return globalScope.window!==void 0&&globalScope.document!==void 0&&globalScope.navigator!==void 0?`browser`:typeof globalScope.EdgeRuntime==`string`||options?.nextRuntime===`edge`?`edge`:typeof globalScope.process?.versions?.node==`string`?`node`:null}function normalizeEnv(value){if(typeof value!=`string`)return null;let env=value.trim().toLowerCase();return env.length>0?env:null}exports.DEFAULT_ENVIRONMENT=DEFAULT_ENVIRONMENT,exports.envSchema=envSchema,exports.inferRuntime=inferRuntime,exports.normalizeEnv=normalizeEnv,exports.readProcessEnv=readProcessEnv,exports.resolveEnvironment=resolveEnvironment,exports.runtimeSchema=runtimeSchema;
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});const require_internal_runtime_inference=require("../internal/runtime-inference.cjs");let zod=require("zod");const envSchema=zod.z.string().min(1).nullable().meta({description:"Deployment environment the SDK is running in. Free-form label (e.g. `production`, `preview`, `staging`, `development`).",id:`Environment`,title:`Environment`}),DEFAULT_ENVIRONMENT=`development`,ENVIRONMENT_ENV_VARS=[`INTERFERE_ENVIRONMENT`,`VERCEL_ENV`,`NODE_ENV`];function resolveEnvironment(opts){let env=opts?.env??{},explicit=normalizeEnv(opts?.explicit);if(explicit)return explicit;for(let key of ENVIRONMENT_ENV_VARS){let value=normalizeEnv(env[key]);if(value)return value}return DEFAULT_ENVIRONMENT}const runtimeSchema=zod.z.enum([`browser`,`node`,`edge`]).nullable().meta({description:`JavaScript runtime the SDK is running in.`,id:`Runtime`,title:`Runtime`}),globalScope=globalThis;function readProcessEnv(){return globalScope.process?.env}function inferRuntime(options){return require_internal_runtime_inference.inferRuntimeFromEvidence({hasWindow:globalScope.window!==void 0,hasDocument:globalScope.document!==void 0,hasNavigator:globalScope.navigator!==void 0,edgeRuntime:globalScope.EdgeRuntime,nodeVersion:globalScope.process?.versions?.node,nextRuntime:options?.nextRuntime})}function normalizeEnv(value){if(typeof value!=`string`)return null;let env=value.trim().toLowerCase();return env.length>0?env:null}exports.DEFAULT_ENVIRONMENT=DEFAULT_ENVIRONMENT,exports.envSchema=envSchema,exports.inferRuntime=inferRuntime,exports.normalizeEnv=normalizeEnv,exports.readProcessEnv=readProcessEnv,exports.resolveEnvironment=resolveEnvironment,exports.runtimeSchema=runtimeSchema;

package/dist/sdk/runtime.mjs

@@ -1 +1 @@
-import{z}from"zod";const envSchema=z.string().min(1).nullable().meta({description:"Deployment environment the SDK is running in. Free-form label (e.g. `production`, `preview`, `staging`, `development`).",id:`Environment`,title:`Environment`}),DEFAULT_ENVIRONMENT=`development`,ENVIRONMENT_ENV_VARS=[`INTERFERE_ENVIRONMENT`,`VERCEL_ENV`,`NODE_ENV`];function resolveEnvironment(opts){let env=opts?.env??{},explicit=normalizeEnv(opts?.explicit);if(explicit)return explicit;for(let key of ENVIRONMENT_ENV_VARS){let value=normalizeEnv(env[key]);if(value)return value}return DEFAULT_ENVIRONMENT}const runtimeSchema=z.enum([`browser`,`node`,`edge`]).nullable().meta({description:`JavaScript runtime the SDK is running in.`,id:`Runtime`,title:`Runtime`}),globalScope=globalThis;function readProcessEnv(){return globalScope.process?.env}function inferRuntime(options){return globalScope.window!==void 0&&globalScope.document!==void 0&&globalScope.navigator!==void 0?`browser`:typeof globalScope.EdgeRuntime==`string`||options?.nextRuntime===`edge`?`edge`:typeof globalScope.process?.versions?.node==`string`?`node`:null}function normalizeEnv(value){if(typeof value!=`string`)return null;let env=value.trim().toLowerCase();return env.length>0?env:null}export{DEFAULT_ENVIRONMENT,envSchema,inferRuntime,normalizeEnv,readProcessEnv,resolveEnvironment,runtimeSchema};
+import{inferRuntimeFromEvidence}from"../internal/runtime-inference.mjs";import{z}from"zod";const envSchema=z.string().min(1).nullable().meta({description:"Deployment environment the SDK is running in. Free-form label (e.g. `production`, `preview`, `staging`, `development`).",id:`Environment`,title:`Environment`}),DEFAULT_ENVIRONMENT=`development`,ENVIRONMENT_ENV_VARS=[`INTERFERE_ENVIRONMENT`,`VERCEL_ENV`,`NODE_ENV`];function resolveEnvironment(opts){let env=opts?.env??{},explicit=normalizeEnv(opts?.explicit);if(explicit)return explicit;for(let key of ENVIRONMENT_ENV_VARS){let value=normalizeEnv(env[key]);if(value)return value}return DEFAULT_ENVIRONMENT}const runtimeSchema=z.enum([`browser`,`node`,`edge`]).nullable().meta({description:`JavaScript runtime the SDK is running in.`,id:`Runtime`,title:`Runtime`}),globalScope=globalThis;function readProcessEnv(){return globalScope.process?.env}function inferRuntime(options){return inferRuntimeFromEvidence({hasWindow:globalScope.window!==void 0,hasDocument:globalScope.document!==void 0,hasNavigator:globalScope.navigator!==void 0,edgeRuntime:globalScope.EdgeRuntime,nodeVersion:globalScope.process?.versions?.node,nextRuntime:options?.nextRuntime})}function normalizeEnv(value){if(typeof value!=`string`)return null;let env=value.trim().toLowerCase();return env.length>0?env:null}export{DEFAULT_ENVIRONMENT,envSchema,inferRuntime,normalizeEnv,readProcessEnv,resolveEnvironment,runtimeSchema};

package/dist/sdk/service-name.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`}),exports.SERVICE_NAME_GLOBAL=`__INTERFERE_SERVICE_NAME__`;

package/dist/sdk/service-name.d.cts

@@ -0,0 +1,8 @@
+//#region src/sdk/service-name.d.ts
+/**
+ * Global a build stamps into the page with the default OTel `service.name`
+ * (the Vite plugin derives it from the package name). The kernel reads it
+ * when `init()` is called without `serviceName`; an explicit value wins.
+ */
+export declare const SERVICE_NAME_GLOBAL = "__INTERFERE_SERVICE_NAME__";
+//#endregion

package/dist/sdk/service-name.d.mts

@@ -0,0 +1,8 @@
+//#region src/sdk/service-name.d.ts
+/**
+ * Global a build stamps into the page with the default OTel `service.name`
+ * (the Vite plugin derives it from the package name). The kernel reads it
+ * when `init()` is called without `serviceName`; an explicit value wins.
+ */
+export declare const SERVICE_NAME_GLOBAL = "__INTERFERE_SERVICE_NAME__";
+//#endregion

package/dist/sdk/service-name.mjs

@@ -0,0 +1 @@
+const SERVICE_NAME_GLOBAL=`__INTERFERE_SERVICE_NAME__`;export{SERVICE_NAME_GLOBAL};

package/dist/sdk/throw-site.cjs

@@ -0,0 +1,2 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let _sdk_errors=require("#sdk/errors");const V8_FRAME_RE=/^\s*at\s+(?:(?<fn>.+?)\s+\()?(?<location>.+?):(?<line>\d+)(?::\d+)?\)?\s*$/u,GECKO_FRAME_RE=/^(?<fn>[^@]*)@(?<location>.+?):(?<line>\d+)(?::\d+)?\s*$/u,FOREIGN_LOCATION_RE=/(?:^|\/)node_modules\/|^(?:native|<anonymous>|\[native code\])$|\beval at\s|^(?:chrome|moz|safari-web|safari|ms-browser|webkit-masked)-(?:extension|url):/u,ANONYMOUS_FN_RE=/^(?:<anonymous>|Object\.<anonymous>|global code)?$/u;function basename(location){let trimmed=location.replace(/[?#].*$/u,``),last=trimmed.lastIndexOf(`/`);return(last===-1?trimmed:trimmed.slice(last+1))||trimmed}function throwSiteLabel(stack){for(let rawLine of stack.split(`
+`,30)){let line=rawLine.slice(0,1024),groups=(V8_FRAME_RE.exec(line)??GECKO_FRAME_RE.exec(line))?.groups;if(!groups?.location||!groups.line)continue;let location=groups.location.trim();if(FOREIGN_LOCATION_RE.test(location))continue;let fn=(groups.fn??``).replace(/^(?:async|new)\s+/u,``).trim(),site=`${basename(location)}:${groups.line}`;return ANONYMOUS_FN_RE.test(fn)?site:`${fn} (${site})`}return null}function exceptionSpanName(value){if((0,_sdk_errors.isNonErrorException)(value))return value.type;let stack=value.stack;return(typeof stack==`string`?throwSiteLabel(stack):null)??(value.name||`Error`)}exports.exceptionSpanName=exceptionSpanName;

package/dist/sdk/throw-site.d.cts

@@ -0,0 +1,14 @@
+import { NonErrorException } from "#sdk/errors";
+//#region src/sdk/throw-site.d.ts
+/**
+ * Name for the span the SDK opens to carry a captured exception when no
+ * span is active: the top in-app frame of the raw stack as `fn (file:line)`
+ * (`file:line` for anonymous frames; `node_modules`, native and
+ * browser-extension frames are skipped), or the error's type when the
+ * stack has no usable frame or host code replaced it with a non-string.
+ * Non-Error rejections carry no stack and use their structural type. The
+ * label mirrors the raw text the SDK ships; symbolication of minified
+ * names stays server-side.
+ */
+export declare function exceptionSpanName(value: Error | NonErrorException): string;
+//#endregion

package/dist/sdk/throw-site.d.mts

@@ -0,0 +1,14 @@
+import { NonErrorException } from "#sdk/errors";
+//#region src/sdk/throw-site.d.ts
+/**
+ * Name for the span the SDK opens to carry a captured exception when no
+ * span is active: the top in-app frame of the raw stack as `fn (file:line)`
+ * (`file:line` for anonymous frames; `node_modules`, native and
+ * browser-extension frames are skipped), or the error's type when the
+ * stack has no usable frame or host code replaced it with a non-string.
+ * Non-Error rejections carry no stack and use their structural type. The
+ * label mirrors the raw text the SDK ships; symbolication of minified
+ * names stays server-side.
+ */
+export declare function exceptionSpanName(value: Error | NonErrorException): string;
+//#endregion

package/dist/sdk/throw-site.mjs

@@ -0,0 +1,2 @@
+import{isNonErrorException}from"#sdk/errors";const V8_FRAME_RE=/^\s*at\s+(?:(?<fn>.+?)\s+\()?(?<location>.+?):(?<line>\d+)(?::\d+)?\)?\s*$/u,GECKO_FRAME_RE=/^(?<fn>[^@]*)@(?<location>.+?):(?<line>\d+)(?::\d+)?\s*$/u,FOREIGN_LOCATION_RE=/(?:^|\/)node_modules\/|^(?:native|<anonymous>|\[native code\])$|\beval at\s|^(?:chrome|moz|safari-web|safari|ms-browser|webkit-masked)-(?:extension|url):/u,ANONYMOUS_FN_RE=/^(?:<anonymous>|Object\.<anonymous>|global code)?$/u;function basename(location){let trimmed=location.replace(/[?#].*$/u,``),last=trimmed.lastIndexOf(`/`);return(last===-1?trimmed:trimmed.slice(last+1))||trimmed}function throwSiteLabel(stack){for(let rawLine of stack.split(`
+`,30)){let line=rawLine.slice(0,1024),groups=(V8_FRAME_RE.exec(line)??GECKO_FRAME_RE.exec(line))?.groups;if(!groups?.location||!groups.line)continue;let location=groups.location.trim();if(FOREIGN_LOCATION_RE.test(location))continue;let fn=(groups.fn??``).replace(/^(?:async|new)\s+/u,``).trim(),site=`${basename(location)}:${groups.line}`;return ANONYMOUS_FN_RE.test(fn)?site:`${fn} (${site})`}return null}function exceptionSpanName(value){if(isNonErrorException(value))return value.type;let stack=value.stack;return(typeof stack==`string`?throwSiteLabel(stack):null)??(value.name||`Error`)}export{exceptionSpanName};

package/dist/sdk/url-redaction.cjs

@@ -0,0 +1 @@
+Object.defineProperty(exports,Symbol.toStringTag,{value:`Module`});let zod=require("zod");const URL_ATTRIBUTE_KEYS=[`http.referrer`,`http.request.header.referer`,`http.target`,`http.url`,`url.full`,`url.original`,`url.path`],URL_PARTS_RE=/^(?<base>[^?#]*)(?:\?(?<query>[^#]*))?(?<fragment>#.*)?$/su,ABSOLUTE_URL_RE=/https?:\/\/[^\s"'<>]+/giu,REDACTED=`REDACTED`,SENSITIVE_NAMES=new Set([`awsaccesskeyid`,`code`,`key`,`sig`]),SENSITIVE_TERMS=[`api_key`,`apikey`,`auth`,`credential`,`passwd`,`password`,`secret`,`session`,`signature`,`token`];function isSensitiveName(name){return SENSITIVE_NAMES.has(name)||SENSITIVE_TERMS.some(term=>name.includes(term))}function resolveUrlRedaction(option={}){if(option===!0||option===!1)return{fragment:option,redactsValue:()=>option};let allow=option.allow&&new Set(option.allow.map(name=>name.toLowerCase())),deny=new Set(option.deny?.map(name=>name.toLowerCase()));return{fragment:option.fragment??!1,redactsValue:name=>deny.has(name)||(allow?!allow.has(name):isSensitiveName(name))}}function decodeName(name){try{return decodeURIComponent(name).toLowerCase()}catch{return name.toLowerCase()}}function redactQuery(query,policy){return query.split(`&`).map(parameter=>{let separator=parameter.indexOf(`=`),name=separator===-1?parameter:parameter.slice(0,separator);return parameter&&policy.redactsValue(decodeName(name))?separator===-1?REDACTED:`${name}=${REDACTED}`:parameter}).join(`&`)}function redactCredentials(base){return base.replace(/^(?<scheme>[a-z][\d+.a-z-]*:\/\/)[^/@:]*:[^/@]*@/iu,`$<scheme>${REDACTED}:${REDACTED}@`).replace(/^(?<scheme>[a-z][\d+.a-z-]*:\/\/)[^/@:]*@/iu,`$<scheme>${REDACTED}@`)}function redactUrl(url,policy){let{base=``,fragment=``,query}=URL_PARTS_RE.exec(url)?.groups??{};return[redactCredentials(base),query===void 0?``:`?${redactQuery(query,policy)}`,policy.fragment?``:fragment].join(``)}function redactMessage(message,policy){return message.replaceAll(ABSOLUTE_URL_RE,url=>redactUrl(url,policy))}function redactSpanName(name,policy){return name.split(` `).map(token=>token.startsWith(`/`)||token.includes(`://`)?redactUrl(token,policy):token).join(` `)}const exceptionChainSchema=zod.z.array(zod.z.looseObject({stack:zod.z.string().optional(),value:zod.z.string().optional()}));function redactExceptionChain(chain,policy){try{let entries=exceptionChainSchema.parse(JSON.parse(chain));for(let entry of entries)if(entry.value!==void 0){let value=redactMessage(entry.value,policy);entry.stack=entry.stack?.replace(entry.value,value),entry.value=value}return JSON.stringify(entries)}catch{return chain}}function rewrite(attributes,key,redact){let value=attributes[key];typeof value==`string`?attributes[key]=redact(value):typeof value==`object`&&(attributes[key]=value.map(item=>typeof item==`string`?redact(item):item))}function redactAttributes(attributes,policy){for(let key of URL_ATTRIBUTE_KEYS)rewrite(attributes,key,url=>redactUrl(url,policy));rewrite(attributes,`url.query`,query=>redactQuery(query,policy)),policy.fragment&&delete attributes[`url.fragment`],rewrite(attributes,`exception.message`,message=>{let redacted=redactMessage(message,policy);return rewrite(attributes,`exception.stacktrace`,stack=>stack.replace(message,redacted)),redacted}),rewrite(attributes,`interfere.exception.chain`,chain=>redactExceptionChain(chain,policy)),rewrite(attributes,`interfere.exception.serialized`,serialized=>redactMessage(serialized,policy))}function redactSpan(span,policy){redactAttributes(span.attributes,policy);for(let event of span.events)event.attributes&&redactAttributes(event.attributes,policy)}function createUrlRedactionSpanProcessor(policy){return{async forceFlush(){await Promise.resolve()},onEnd(span){redactSpan(span,policy)},onEnding(span){span.updateName(redactSpanName(span.name,policy)),span.status.message!==void 0&&span.setStatus({...span.status,message:redactMessage(span.status.message,policy)}),redactSpan(span,policy)},onStart:()=>void 0,async shutdown(){await Promise.resolve()}}}exports.createUrlRedactionSpanProcessor=createUrlRedactionSpanProcessor,exports.redactUrl=redactUrl,exports.resolveUrlRedaction=resolveUrlRedaction;

package/dist/sdk/url-redaction.d.cts

@@ -0,0 +1,58 @@
+//#region src/sdk/url-redaction.d.ts
+/** Query parameters and fragments to redact in SDK telemetry. Parameter names match case-insensitively. */
+export interface UrlRedactionOptions {
+  /**
+   * Parameters whose values are kept. Every other value becomes `REDACTED`,
+   * including the built-in sensitive names unless they are listed here.
+   */
+  allow?: string[];
+  /** Parameters whose values become `REDACTED` in addition to the built-in sensitive names. */
+  deny?: string[];
+  /** Remove fragments, including hash-router paths. Defaults to `false`. */
+  fragment?: boolean;
+}
+/**
+ * Omit to redact the values of built-in sensitive query parameters such as
+ * `token`, `password` and `sig`. `true` redacts every value and removes
+ * fragments. `false` keeps query values. URL credentials are always redacted.
+ */
+export type UrlRedactionOption = boolean | UrlRedactionOptions;
+export interface UrlRedactionPolicy {
+  readonly fragment: boolean;
+  readonly redactsValue: (name: string) => boolean;
+}
+type AttributeScalar = boolean | number | string;
+type SpanAttributes = Record<string, AttributeScalar | readonly (AttributeScalar | null | undefined)[] | undefined>;
+interface RedactableSpan {
+  attributes: SpanAttributes;
+  events: readonly {
+    attributes?: SpanAttributes | undefined;
+    name: string;
+  }[];
+}
+interface EndingSpan extends RedactableSpan {
+  name: string;
+  setStatus: (status: {
+    code: number;
+    message: string;
+  }) => void;
+  status: {
+    code: number;
+    message?: string;
+  };
+  updateName: (name: string) => void;
+}
+export declare function resolveUrlRedaction(option?: UrlRedactionOption): {
+  fragment: boolean;
+  redactsValue: (name: string) => boolean;
+};
+export declare function redactUrl(url: string, policy: UrlRedactionPolicy): string;
+/** Redacts URL attributes, URL-bearing span names and absolute URLs in exception messages in `onEnding`, before any processor exports the span. */
+export declare function createUrlRedactionSpanProcessor(policy: UrlRedactionPolicy): {
+  forceFlush(): Promise<void>;
+  onEnd(span: RedactableSpan): void;
+  onEnding(span: EndingSpan): void;
+  onStart: () => undefined;
+  shutdown(): Promise<void>;
+};
+//#endregion

package/dist/sdk/url-redaction.d.mts

@@ -0,0 +1,58 @@
+//#region src/sdk/url-redaction.d.ts
+/** Query parameters and fragments to redact in SDK telemetry. Parameter names match case-insensitively. */
+export interface UrlRedactionOptions {
+  /**
+   * Parameters whose values are kept. Every other value becomes `REDACTED`,
+   * including the built-in sensitive names unless they are listed here.
+   */
+  allow?: string[];
+  /** Parameters whose values become `REDACTED` in addition to the built-in sensitive names. */
+  deny?: string[];
+  /** Remove fragments, including hash-router paths. Defaults to `false`. */
+  fragment?: boolean;
+}
+/**
+ * Omit to redact the values of built-in sensitive query parameters such as
+ * `token`, `password` and `sig`. `true` redacts every value and removes
+ * fragments. `false` keeps query values. URL credentials are always redacted.
+ */
+export type UrlRedactionOption = boolean | UrlRedactionOptions;
+export interface UrlRedactionPolicy {
+  readonly fragment: boolean;
+  readonly redactsValue: (name: string) => boolean;
+}
+type AttributeScalar = boolean | number | string;
+type SpanAttributes = Record<string, AttributeScalar | readonly (AttributeScalar | null | undefined)[] | undefined>;
+interface RedactableSpan {
+  attributes: SpanAttributes;
+  events: readonly {
+    attributes?: SpanAttributes | undefined;
+    name: string;
+  }[];
+}
+interface EndingSpan extends RedactableSpan {
+  name: string;
+  setStatus: (status: {
+    code: number;
+    message: string;
+  }) => void;
+  status: {
+    code: number;
+    message?: string;
+  };
+  updateName: (name: string) => void;
+}
+export declare function resolveUrlRedaction(option?: UrlRedactionOption): {
+  fragment: boolean;
+  redactsValue: (name: string) => boolean;
+};
+export declare function redactUrl(url: string, policy: UrlRedactionPolicy): string;
+/** Redacts URL attributes, URL-bearing span names and absolute URLs in exception messages in `onEnding`, before any processor exports the span. */
+export declare function createUrlRedactionSpanProcessor(policy: UrlRedactionPolicy): {
+  forceFlush(): Promise<void>;
+  onEnd(span: RedactableSpan): void;
+  onEnding(span: EndingSpan): void;
+  onStart: () => undefined;
+  shutdown(): Promise<void>;
+};
+//#endregion

package/dist/sdk/url-redaction.mjs

@@ -0,0 +1 @@
+import{z}from"zod";const URL_ATTRIBUTE_KEYS=[`http.referrer`,`http.request.header.referer`,`http.target`,`http.url`,`url.full`,`url.original`,`url.path`],URL_PARTS_RE=/^(?<base>[^?#]*)(?:\?(?<query>[^#]*))?(?<fragment>#.*)?$/su,ABSOLUTE_URL_RE=/https?:\/\/[^\s"'<>]+/giu,REDACTED=`REDACTED`,SENSITIVE_NAMES=new Set([`awsaccesskeyid`,`code`,`key`,`sig`]),SENSITIVE_TERMS=[`api_key`,`apikey`,`auth`,`credential`,`passwd`,`password`,`secret`,`session`,`signature`,`token`];function isSensitiveName(name){return SENSITIVE_NAMES.has(name)||SENSITIVE_TERMS.some(term=>name.includes(term))}function resolveUrlRedaction(option={}){if(option===!0||option===!1)return{fragment:option,redactsValue:()=>option};let allow=option.allow&&new Set(option.allow.map(name=>name.toLowerCase())),deny=new Set(option.deny?.map(name=>name.toLowerCase()));return{fragment:option.fragment??!1,redactsValue:name=>deny.has(name)||(allow?!allow.has(name):isSensitiveName(name))}}function decodeName(name){try{return decodeURIComponent(name).toLowerCase()}catch{return name.toLowerCase()}}function redactQuery(query,policy){return query.split(`&`).map(parameter=>{let separator=parameter.indexOf(`=`),name=separator===-1?parameter:parameter.slice(0,separator);return parameter&&policy.redactsValue(decodeName(name))?separator===-1?REDACTED:`${name}=${REDACTED}`:parameter}).join(`&`)}function redactCredentials(base){return base.replace(/^(?<scheme>[a-z][\d+.a-z-]*:\/\/)[^/@:]*:[^/@]*@/iu,`$<scheme>${REDACTED}:${REDACTED}@`).replace(/^(?<scheme>[a-z][\d+.a-z-]*:\/\/)[^/@:]*@/iu,`$<scheme>${REDACTED}@`)}function redactUrl(url,policy){let{base=``,fragment=``,query}=URL_PARTS_RE.exec(url)?.groups??{};return[redactCredentials(base),query===void 0?``:`?${redactQuery(query,policy)}`,policy.fragment?``:fragment].join(``)}function redactMessage(message,policy){return message.replaceAll(ABSOLUTE_URL_RE,url=>redactUrl(url,policy))}function redactSpanName(name,policy){return name.split(` `).map(token=>token.startsWith(`/`)||token.includes(`://`)?redactUrl(token,policy):token).join(` `)}const exceptionChainSchema=z.array(z.looseObject({stack:z.string().optional(),value:z.string().optional()}));function redactExceptionChain(chain,policy){try{let entries=exceptionChainSchema.parse(JSON.parse(chain));for(let entry of entries)if(entry.value!==void 0){let value=redactMessage(entry.value,policy);entry.stack=entry.stack?.replace(entry.value,value),entry.value=value}return JSON.stringify(entries)}catch{return chain}}function rewrite(attributes,key,redact){let value=attributes[key];typeof value==`string`?attributes[key]=redact(value):typeof value==`object`&&(attributes[key]=value.map(item=>typeof item==`string`?redact(item):item))}function redactAttributes(attributes,policy){for(let key of URL_ATTRIBUTE_KEYS)rewrite(attributes,key,url=>redactUrl(url,policy));rewrite(attributes,`url.query`,query=>redactQuery(query,policy)),policy.fragment&&delete attributes[`url.fragment`],rewrite(attributes,`exception.message`,message=>{let redacted=redactMessage(message,policy);return rewrite(attributes,`exception.stacktrace`,stack=>stack.replace(message,redacted)),redacted}),rewrite(attributes,`interfere.exception.chain`,chain=>redactExceptionChain(chain,policy)),rewrite(attributes,`interfere.exception.serialized`,serialized=>redactMessage(serialized,policy))}function redactSpan(span,policy){redactAttributes(span.attributes,policy);for(let event of span.events)event.attributes&&redactAttributes(event.attributes,policy)}function createUrlRedactionSpanProcessor(policy){return{async forceFlush(){await Promise.resolve()},onEnd(span){redactSpan(span,policy)},onEnding(span){span.updateName(redactSpanName(span.name,policy)),span.status.message!==void 0&&span.setStatus({...span.status,message:redactMessage(span.status.message,policy)}),redactSpan(span,policy)},onStart:()=>void 0,async shutdown(){await Promise.resolve()}}}export{createUrlRedactionSpanProcessor,redactUrl,resolveUrlRedaction};