@fixback/sdk-core 0.2.0 → 0.3.0

package/dist/trace/console-args.js

@@ -0,0 +1,189 @@
+"use strict";
+/**
+ * Structured **console arguments** (spec #122 §C, decision D7) — the shared,
+ * runtime-agnostic assembly that turns a `console.*` call's arguments into
+ * type-tagged, JSON-safe, size-capped {@link ConsoleArg} values, plus the one-line
+ * preview the crumb's `message` carries.
+ *
+ * Preserving arguments type-tagged rather than flattening them to a string is what
+ * lets the Console tab render an object or an Error expandably instead of
+ * `[object Object]`. Every cap is applied **at assembly**, so a single console
+ * crumb can never bloat a report and an exotic or circular value can never reach
+ * the wire unserialized.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_CONSOLE_ARGS_BYTES = exports.MAX_ARG_STRING_LENGTH = exports.MAX_ARG_ITEMS = exports.MAX_ARG_DEPTH = exports.MAX_MESSAGE_LENGTH = void 0;
+exports.capLength = capLength;
+exports.stringifyArg = stringifyArg;
+exports.joinArgs = joinArgs;
+exports.describeErrorValue = describeErrorValue;
+exports.safeCloneValue = safeCloneValue;
+exports.toConsoleArg = toConsoleArg;
+exports.capConsoleArgs = capConsoleArgs;
+const env_1 = require("../env");
+/** Longest crumb message kept; a huge log line is truncated, never dropped. */
+exports.MAX_MESSAGE_LENGTH = 300;
+/**
+ * Structured console argument caps (spec #122 §C/§F), all applied **at assembly** so a
+ * single console crumb can never bloat a report:
+ * - {@link MAX_ARG_DEPTH} bounds how deep a `json` argument is cloned (deeper nodes
+ *   collapse to an `[Object]`/`[Array]` marker);
+ * - {@link MAX_ARG_ITEMS} bounds how many keys/elements are kept at each level;
+ * - {@link MAX_ARG_STRING_LENGTH} truncates a single over-long string value;
+ * - {@link MAX_CONSOLE_ARGS_BYTES} bounds the serialized size of the whole args array
+ *   (trailing args are dropped to fit), kept well under ingest's per-entry byte cap.
+ */
+exports.MAX_ARG_DEPTH = 4;
+exports.MAX_ARG_ITEMS = 100;
+exports.MAX_ARG_STRING_LENGTH = 1024;
+exports.MAX_CONSOLE_ARGS_BYTES = 4096;
+/** Longest Error `stack` kept on a structured `error` arg, truncated never dropped. */
+const MAX_ERROR_STACK_LENGTH = 2048;
+/** Truncate a string to `max` with an ellipsis marker; keeps the value, never drops it. */
+function capLength(value, max) {
+    return value.length > max ? `${value.slice(0, max)}…` : value;
+}
+/** Render one console argument to the flat text of the crumb's preview line. */
+function stringifyArg(arg) {
+    if (typeof arg === "string")
+        return arg;
+    if (arg instanceof Error)
+        return `${arg.name}: ${arg.message}`;
+    if (arg === null || arg === undefined)
+        return String(arg);
+    if (typeof arg === "number" || typeof arg === "boolean")
+        return String(arg);
+    try {
+        return JSON.stringify(arg) ?? String(arg);
+    }
+    catch {
+        return "[object]";
+    }
+}
+/** The one-line preview a console crumb's `message` carries, length-capped. */
+function joinArgs(args) {
+    const text = args.map(stringifyArg).join(" ");
+    return text.length > exports.MAX_MESSAGE_LENGTH
+        ? `${text.slice(0, exports.MAX_MESSAGE_LENGTH)}…`
+        : text;
+}
+/** An Error rendered to a structured, size-capped `{ name, message, stack? }`. */
+function describeErrorValue(error) {
+    const out = {
+        name: error.name || "Error",
+        message: capLength(String(error.message ?? ""), exports.MAX_ARG_STRING_LENGTH),
+    };
+    if (typeof error.stack === "string" && error.stack.length > 0) {
+        out.stack = capLength(error.stack, MAX_ERROR_STACK_LENGTH);
+    }
+    return out;
+}
+/**
+ * Build a JSON-safe, depth-/breadth-/string-capped clone of a value for a `json`
+ * console argument. Beyond {@link MAX_ARG_DEPTH} the node collapses to a marker;
+ * at each level at most {@link MAX_ARG_ITEMS} keys/elements are kept; strings are
+ * truncated to {@link MAX_ARG_STRING_LENGTH}; circular references become
+ * `"[Circular]"`; and exotic values (bigint / symbol / function / undefined) are
+ * rendered to safe text — so the result is always serializable and bounded.
+ */
+function safeCloneValue(value, depth, seen) {
+    if (value === null)
+        return null;
+    const type = typeof value;
+    if (type === "string")
+        return capLength(value, exports.MAX_ARG_STRING_LENGTH);
+    if (type === "number")
+        return Number.isFinite(value) ? value : String(value);
+    if (type === "boolean")
+        return value;
+    if (type === "bigint")
+        return `${value.toString()}n`;
+    if (type === "symbol")
+        return value.toString();
+    if (type === "function")
+        return "[Function]";
+    if (type === "undefined")
+        return null;
+    const obj = value;
+    if (value instanceof Error) {
+        const { name, message } = describeErrorValue(value);
+        return { name, message };
+    }
+    if (seen.has(obj))
+        return "[Circular]";
+    if (depth <= 0)
+        return Array.isArray(value) ? "[Array]" : "[Object]";
+    seen.add(obj);
+    try {
+        if (Array.isArray(value)) {
+            const items = value
+                .slice(0, exports.MAX_ARG_ITEMS)
+                .map((item) => safeCloneValue(item, depth - 1, seen));
+            if (value.length > exports.MAX_ARG_ITEMS) {
+                items.push(`… ${value.length - exports.MAX_ARG_ITEMS} more`);
+            }
+            return items;
+        }
+        const source = value;
+        const keys = Object.keys(source);
+        const out = {};
+        for (const key of keys.slice(0, exports.MAX_ARG_ITEMS)) {
+            const child = source[key];
+            // Undefined / function values JSON drops anyway — omit them for a clean clone.
+            if (typeof child === "undefined" || typeof child === "function")
+                continue;
+            out[key] = safeCloneValue(child, depth - 1, seen);
+        }
+        if (keys.length > exports.MAX_ARG_ITEMS)
+            out["…"] = `${keys.length - exports.MAX_ARG_ITEMS} more`;
+        return out;
+    }
+    finally {
+        seen.delete(obj);
+    }
+}
+/** Classify one console argument into a type-tagged {@link ConsoleArg} (spec #122 §C). */
+function toConsoleArg(value) {
+    if (value === null || value === undefined)
+        return { t: "null", v: null };
+    const type = typeof value;
+    if (type === "string") {
+        return { t: "string", v: capLength(value, exports.MAX_ARG_STRING_LENGTH) };
+    }
+    if (type === "number") {
+        return Number.isFinite(value)
+            ? { t: "number", v: value }
+            : { t: "string", v: String(value) };
+    }
+    if (type === "boolean")
+        return { t: "bool", v: value };
+    if (type === "bigint")
+        return { t: "string", v: `${value.toString()}n` };
+    if (type === "symbol")
+        return { t: "string", v: value.toString() };
+    if (type === "function")
+        return { t: "string", v: "[Function]" };
+    if (value instanceof Error)
+        return { t: "error", v: describeErrorValue(value) };
+    return { t: "json", v: safeCloneValue(value, exports.MAX_ARG_DEPTH, new Set()) };
+}
+/**
+ * Cap an entry's structured args to {@link MAX_CONSOLE_ARGS_BYTES} (spec #122 §F):
+ * drop trailing args until the array fits, keeping the earliest (usually the format
+ * string / main message); if even a single arg is over budget, keep one honest
+ * placeholder rather than an unbounded value. Per-arg depth/breadth/string caps bound
+ * most cases already — this is the whole-entry backstop.
+ */
+function capConsoleArgs(args) {
+    if ((0, env_1.serializedBytes)(args) <= exports.MAX_CONSOLE_ARGS_BYTES)
+        return args;
+    let out = args.slice();
+    while (out.length > 1 && (0, env_1.serializedBytes)(out) > exports.MAX_CONSOLE_ARGS_BYTES) {
+        out = out.slice(0, -1);
+    }
+    if (out.length === 1 && (0, env_1.serializedBytes)(out) > exports.MAX_CONSOLE_ARGS_BYTES) {
+        return [{ t: "string", v: "[trace: console argument omitted (too large)]" }];
+    }
+    return out;
+}
+//# sourceMappingURL=console-args.js.map

package/dist/trace/console-args.js.map

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

package/dist/trace/console.d.ts

@@ -0,0 +1,42 @@
+/**
+ * The **console instrumentation** (spec #122 §C) — the one wrapper both the browser
+ * and React Native SDKs install (ADR-0028).
+ *
+ * It patches the injected `console` object's level methods so each call becomes a
+ * crumb before the original runs. The console surface is a parameter, never read
+ * off a global here, so the core stays runtime-agnostic and tests pass a plain
+ * object. Capture must never throw into the host app: a failure recording a crumb
+ * is swallowed and the original `console` method always runs.
+ */
+import type { BreadcrumbLevel } from "../breadcrumb";
+import { type BreadcrumbBuffer } from "./buffer";
+/** Detaches an installed instrumentation, restoring the original behaviour. */
+export type Teardown = () => void;
+/**
+ * The `console` surface the wrapper patches — injected, never read off a global
+ * here.
+ *
+ * Declared as optional **methods** rather than a `Partial<Record<Level, Fn>>` of
+ * function-typed properties, deliberately: method signatures are bivariant in
+ * their parameters, so a real DOM `Console` — whose `assert` is overloaded with a
+ * leading `condition?: boolean` — satisfies this directly. That is what lets the
+ * browser SDK pass `console` with no cast at all.
+ */
+export interface ConsoleLike {
+    log?(...args: unknown[]): unknown;
+    info?(...args: unknown[]): unknown;
+    warn?(...args: unknown[]): unknown;
+    error?(...args: unknown[]): unknown;
+    assert?(...args: unknown[]): unknown;
+    debug?(...args: unknown[]): unknown;
+}
+/**
+ * Wrap `console` methods so calls at the captured levels become crumbs, returning a
+ * teardown that restores every method it replaced.
+ *
+ * Whether a level pays the source-capture cost is decided **once per level**, not per
+ * call: only `warn`/`error`/`assert` construct a `new Error()` to read the call site,
+ * so a tight `log` loop stays cheap (ticket #159; see `SOURCE_CAPTURE_LEVELS`).
+ * `console.assert` records only when the asserted condition is falsy.
+ */
+export declare function instrumentConsole(buffer: BreadcrumbBuffer, consoleObj: ConsoleLike, levels: readonly BreadcrumbLevel[], now: () => number): Teardown;

package/dist/trace/console.js

@@ -0,0 +1,71 @@
+"use strict";
+/**
+ * The **console instrumentation** (spec #122 §C) — the one wrapper both the browser
+ * and React Native SDKs install (ADR-0028).
+ *
+ * It patches the injected `console` object's level methods so each call becomes a
+ * crumb before the original runs. The console surface is a parameter, never read
+ * off a global here, so the core stays runtime-agnostic and tests pass a plain
+ * object. Capture must never throw into the host app: a failure recording a crumb
+ * is swallowed and the original `console` method always runs.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.instrumentConsole = instrumentConsole;
+const buffer_1 = require("./buffer");
+const crumbs_1 = require("./crumbs");
+const source_1 = require("./source");
+/**
+ * Wrap `console` methods so calls at the captured levels become crumbs, returning a
+ * teardown that restores every method it replaced.
+ *
+ * Whether a level pays the source-capture cost is decided **once per level**, not per
+ * call: only `warn`/`error`/`assert` construct a `new Error()` to read the call site,
+ * so a tight `log` loop stays cheap (ticket #159; see `SOURCE_CAPTURE_LEVELS`).
+ * `console.assert` records only when the asserted condition is falsy.
+ */
+function instrumentConsole(buffer, consoleObj, levels, now) {
+    const restores = [];
+    for (const level of levels) {
+        const original = consoleObj[level];
+        if (typeof original !== "function")
+            continue;
+        const withSource = (0, buffer_1.capturesSource)(level);
+        const wrapper = (...args) => {
+            // Capture the call site before anything else so the wrapper is the top frame —
+            // but only for the levels that keep a source (the hot-page budget, ticket #159).
+            let source;
+            if (withSource) {
+                try {
+                    source = (0, source_1.sourceFromStack)(new Error().stack, source_1.CONSOLE_SOURCE_SKIP_FRAMES);
+                }
+                catch {
+                    source = undefined;
+                }
+            }
+            try {
+                if (level === "assert") {
+                    // console.assert records only when the asserted condition is falsy.
+                    if (!args[0]) {
+                        buffer.add((0, crumbs_1.consoleCrumb)("assert", args.slice(1), now(), source));
+                    }
+                }
+                else {
+                    buffer.add((0, crumbs_1.consoleCrumb)(level, args, now(), source));
+                }
+            }
+            catch {
+                // Capture must never throw into the host app.
+            }
+            return original.apply(consoleObj, args);
+        };
+        consoleObj[level] = wrapper;
+        restores.push(() => {
+            consoleObj[level] = original;
+        });
+    }
+    return () => {
+        for (const restore of restores)
+            restore();
+    };
+}
+//# sourceMappingURL=console.js.map

package/dist/trace/console.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"console.js","sourceRoot":"","sources":["../../src/trace/console.ts"],"names":[],"mappings":";AAAA;;;;;;;;;GASG;;AAuCH,8CA4CC;AA/ED,qCAAiE;AACjE,qCAAwC;AACxC,qCAAuE;AAwBvE;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC/B,MAAwB,EACxB,UAAuB,EACvB,MAAkC,EAClC,GAAiB;IAEjB,MAAM,QAAQ,GAAe,EAAE,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,MAAM,QAAQ,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;QACnC,IAAI,OAAO,QAAQ,KAAK,UAAU;YAAE,SAAS;QAC7C,MAAM,UAAU,GAAG,IAAA,uBAAc,EAAC,KAAK,CAAC,CAAC;QACzC,MAAM,OAAO,GAAG,CAAC,GAAG,IAAe,EAAW,EAAE;YAC9C,+EAA+E;YAC/E,iFAAiF;YACjF,IAAI,MAAkC,CAAC;YACvC,IAAI,UAAU,EAAE,CAAC;gBACf,IAAI,CAAC;oBACH,MAAM,GAAG,IAAA,wBAAe,EAAC,IAAI,KAAK,EAAE,CAAC,KAAK,EAAE,mCAA0B,CAAC,CAAC;gBAC1E,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,GAAG,SAAS,CAAC;gBACrB,CAAC;YACH,CAAC;YACD,IAAI,CAAC;gBACH,IAAI,KAAK,KAAK,QAAQ,EAAE,CAAC;oBACvB,oEAAoE;oBACpE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC;wBACb,MAAM,CAAC,GAAG,CAAC,IAAA,qBAAY,EAAC,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;oBACnE,CAAC;gBACH,CAAC;qBAAM,CAAC;oBACN,MAAM,CAAC,GAAG,CAAC,IAAA,qBAAY,EAAC,KAAK,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC,CAAC;gBACvD,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,8CAA8C;YAChD,CAAC;YACD,OAAO,QAAQ,CAAC,KAAK,CAAC,UAAU,EAAE,IAAI,CAAC,CAAC;QAC1C,CAAC,CAAC;QACF,UAAU,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC;QAC5B,QAAQ,CAAC,IAAI,CAAC,GAAG,EAAE;YACjB,UAAU,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC;QAC/B,CAAC,CAAC,CAAC;IACL,CAAC;IACD,OAAO,GAAG,EAAE;QACV,KAAK,MAAM,OAAO,IAAI,QAAQ;YAAE,OAAO,EAAE,CAAC;IAC5C,CAAC,CAAC;AACJ,CAAC"}

package/dist/trace/crumbs.d.ts

@@ -0,0 +1,88 @@
+/**
+ * The pure **crumb builders** (spec #122 §C/§D/§F) — the shared, runtime-agnostic
+ * constructors every capture SDK assembles trace entries with (ADR-0028), so the
+ * server and dashboard cannot tell a mobile trace from a web one.
+ *
+ * Everything private is kept out **at the source**: a network crumb has no field
+ * for a request/response body or an arbitrary header, and every URL is scrubbed
+ * (query dropped, path PII redacted) and length-capped as the crumb is built. The
+ * `beforeSend` choke point (`../scrub`) is the final gate over the whole report.
+ *
+ * The two DOM-shaped builders — `ui.click` and `ui.input`, which need an `Element`
+ * to derive a masked selector from — stay in the browser SDK; every crumb kind a
+ * non-browser runtime can also produce lives here.
+ */
+import type { Breadcrumb, BreadcrumbLevel, NetworkApi, NetworkOutcome, SourceLocation } from "../breadcrumb";
+/**
+ * Longest scrubbed URL kept on a crumb (spec #122 §F): capped at assembly so an
+ * over-long URL is truncated, never dropped and never allowed to bloat a report.
+ */
+export declare const MAX_URL_LENGTH = 2048;
+/**
+ * A `console` crumb from a captured call's level and arguments (spec #122 §C). The
+ * `message` is the one-line preview (flattened, truncated); `args` preserves each
+ * argument as a structured, type-tagged, size-capped value so the Console tab can
+ * render objects/errors expandably; `source` is the best-effort `file:line`, attached
+ * only when the stack yielded one. Args are omitted entirely for a no-argument call.
+ */
+export declare function consoleCrumb(level: BreadcrumbLevel, args: readonly unknown[], timestamp: number, source?: SourceLocation): Breadcrumb;
+/**
+ * A `navigation` crumb; both URLs are scrubbed and length-capped as the crumb is
+ * built. In a browser these come from `history`/`hashchange`; on mobile from the
+ * host app's `trackScreen` calls (spec 0004 §D), where the values are screen URLs
+ * derived from the configured origin.
+ */
+export declare function navigationCrumb(from: string, to: string, timestamp: number): Breadcrumb;
+/**
+ * Classify an HTTP status into a {@link NetworkOutcome} (spec #122 §D). A missing or
+ * `0` status is a `network-error` (a request that never got a response); otherwise
+ * the 4xx/5xx classes flag failures and everything else is `ok`. Used both as the
+ * fallback outcome and by the thin {@link fetchCrumb} / {@link xhrCrumb} builders.
+ */
+export declare function outcomeFromStatus(status: number | undefined): NetworkOutcome;
+/** Parse a `content-length` header into a non-negative byte count, or `undefined`. */
+export declare function parseContentLength(value: string | null | undefined): number | undefined;
+/** The media type from a `content-type` header (the part before any `;` parameters). */
+export declare function contentTypeOf(value: string | null | undefined): string | undefined;
+/** The rich metadata a network crumb records (spec #122 §D) — never a body or header. */
+export interface NetworkCrumbInput {
+    readonly api: NetworkApi;
+    readonly method: string;
+    /** The raw request URL — scrubbed (query dropped, path PII redacted) as the crumb is built. */
+    readonly url: string;
+    readonly status?: number;
+    readonly statusText?: string;
+    readonly durationMs?: number;
+    readonly reqSize?: number;
+    readonly respSize?: number;
+    readonly contentType?: string;
+    readonly outcome: NetworkOutcome;
+}
+/**
+ * A network crumb (`fetch` / `xhr` / `beacon`) with the rich, metadata-only fields
+ * the Network tab renders (spec #122 §D, ticket #139): api, method, scrubbed URL,
+ * status + statusText, duration, request/response sizes, content type, and a failure
+ * outcome. The URL is scrubbed and length-capped at assembly. The shape has **no field
+ * for a request/response body or an arbitrary header**, so neither can ever be
+ * recorded; only a positive status, and fields that were actually supplied, ride along.
+ */
+export declare function networkCrumb(input: NetworkCrumbInput, timestamp: number): Breadcrumb;
+/**
+ * A thin `fetch` crumb from method + URL + status (outcome derived from the status).
+ * The instrumentation uses {@link networkCrumb} directly to carry the full metadata;
+ * this convenience builder seeds a network crumb from a status alone.
+ */
+export declare function fetchCrumb(method: string, url: string, status: number | undefined, timestamp: number): Breadcrumb;
+/** A thin `xhr` crumb from method + URL + status (outcome derived from the status). */
+export declare function xhrCrumb(method: string, url: string, status: number | undefined, timestamp: number): Breadcrumb;
+/** Distil any thrown value into the `{ name, message }` an error crumb reads. */
+export declare function describeError(error: unknown): {
+    name: string;
+    message: string;
+};
+/**
+ * An `error` crumb for the failing exception or rejection that ends the trace. When
+ * `causedBy` is given (an auto-captured error), it rides on the crumb as the causal
+ * pointer to the ids of the entries immediately preceding the throw (spec #122 §F).
+ */
+export declare function errorCrumb(error: unknown, timestamp: number, causedBy?: readonly string[]): Breadcrumb;

package/dist/trace/crumbs.js

@@ -0,0 +1,164 @@
+"use strict";
+/**
+ * The pure **crumb builders** (spec #122 §C/§D/§F) — the shared, runtime-agnostic
+ * constructors every capture SDK assembles trace entries with (ADR-0028), so the
+ * server and dashboard cannot tell a mobile trace from a web one.
+ *
+ * Everything private is kept out **at the source**: a network crumb has no field
+ * for a request/response body or an arbitrary header, and every URL is scrubbed
+ * (query dropped, path PII redacted) and length-capped as the crumb is built. The
+ * `beforeSend` choke point (`../scrub`) is the final gate over the whole report.
+ *
+ * The two DOM-shaped builders — `ui.click` and `ui.input`, which need an `Element`
+ * to derive a masked selector from — stay in the browser SDK; every crumb kind a
+ * non-browser runtime can also produce lives here.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MAX_URL_LENGTH = void 0;
+exports.consoleCrumb = consoleCrumb;
+exports.navigationCrumb = navigationCrumb;
+exports.outcomeFromStatus = outcomeFromStatus;
+exports.parseContentLength = parseContentLength;
+exports.contentTypeOf = contentTypeOf;
+exports.networkCrumb = networkCrumb;
+exports.fetchCrumb = fetchCrumb;
+exports.xhrCrumb = xhrCrumb;
+exports.describeError = describeError;
+exports.errorCrumb = errorCrumb;
+const scrub_1 = require("../scrub");
+const console_args_1 = require("./console-args");
+/**
+ * Longest scrubbed URL kept on a crumb (spec #122 §F): capped at assembly so an
+ * over-long URL is truncated, never dropped and never allowed to bloat a report.
+ */
+exports.MAX_URL_LENGTH = 2048;
+/**
+ * A `console` crumb from a captured call's level and arguments (spec #122 §C). The
+ * `message` is the one-line preview (flattened, truncated); `args` preserves each
+ * argument as a structured, type-tagged, size-capped value so the Console tab can
+ * render objects/errors expandably; `source` is the best-effort `file:line`, attached
+ * only when the stack yielded one. Args are omitted entirely for a no-argument call.
+ */
+function consoleCrumb(level, args, timestamp, source) {
+    const structured = (0, console_args_1.capConsoleArgs)(args.map(console_args_1.toConsoleArg));
+    return {
+        category: "console",
+        level,
+        message: (0, console_args_1.joinArgs)(args),
+        timestamp,
+        ...(structured.length > 0 ? { args: structured } : {}),
+        ...(source ? { source } : {}),
+    };
+}
+/**
+ * A `navigation` crumb; both URLs are scrubbed and length-capped as the crumb is
+ * built. In a browser these come from `history`/`hashchange`; on mobile from the
+ * host app's `trackScreen` calls (spec 0004 §D), where the values are screen URLs
+ * derived from the configured origin.
+ */
+function navigationCrumb(from, to, timestamp) {
+    const fromUrl = (0, console_args_1.capLength)((0, scrub_1.scrubUrl)(from), exports.MAX_URL_LENGTH);
+    const toUrl = (0, console_args_1.capLength)((0, scrub_1.scrubUrl)(to), exports.MAX_URL_LENGTH);
+    return {
+        category: "navigation",
+        message: `${fromUrl} → ${toUrl}`,
+        timestamp,
+        data: { from: fromUrl, to: toUrl },
+    };
+}
+/**
+ * Classify an HTTP status into a {@link NetworkOutcome} (spec #122 §D). A missing or
+ * `0` status is a `network-error` (a request that never got a response); otherwise
+ * the 4xx/5xx classes flag failures and everything else is `ok`. Used both as the
+ * fallback outcome and by the thin {@link fetchCrumb} / {@link xhrCrumb} builders.
+ */
+function outcomeFromStatus(status) {
+    if (typeof status !== "number" || status <= 0)
+        return "network-error";
+    if (status >= 500)
+        return "http-5xx";
+    if (status >= 400)
+        return "http-4xx";
+    return "ok";
+}
+/** Parse a `content-length` header into a non-negative byte count, or `undefined`. */
+function parseContentLength(value) {
+    if (typeof value !== "string")
+        return undefined;
+    const bytes = Number.parseInt(value, 10);
+    return Number.isFinite(bytes) && bytes >= 0 ? bytes : undefined;
+}
+/** The media type from a `content-type` header (the part before any `;` parameters). */
+function contentTypeOf(value) {
+    if (typeof value !== "string" || value.length === 0)
+        return undefined;
+    const media = value.split(";")[0]?.trim();
+    return media && media.length > 0 ? media : undefined;
+}
+/**
+ * A network crumb (`fetch` / `xhr` / `beacon`) with the rich, metadata-only fields
+ * the Network tab renders (spec #122 §D, ticket #139): api, method, scrubbed URL,
+ * status + statusText, duration, request/response sizes, content type, and a failure
+ * outcome. The URL is scrubbed and length-capped at assembly. The shape has **no field
+ * for a request/response body or an arbitrary header**, so neither can ever be
+ * recorded; only a positive status, and fields that were actually supplied, ride along.
+ */
+function networkCrumb(input, timestamp) {
+    const url = (0, console_args_1.capLength)((0, scrub_1.scrubUrl)(input.url), exports.MAX_URL_LENGTH);
+    const hasStatus = typeof input.status === "number" && input.status > 0;
+    const statusPart = hasStatus ? ` → ${input.status}` : "";
+    const outcomePart = input.outcome !== "ok" ? ` (${input.outcome})` : "";
+    return {
+        category: input.api,
+        api: input.api,
+        method: input.method,
+        url,
+        message: `${input.method} ${url}${statusPart}${outcomePart}`,
+        timestamp,
+        ...(hasStatus ? { status: input.status } : {}),
+        ...(input.statusText ? { statusText: input.statusText } : {}),
+        ...(typeof input.durationMs === "number" ? { durationMs: input.durationMs } : {}),
+        ...(typeof input.reqSize === "number" ? { reqSize: input.reqSize } : {}),
+        ...(typeof input.respSize === "number" ? { respSize: input.respSize } : {}),
+        ...(input.contentType ? { contentType: input.contentType } : {}),
+        outcome: input.outcome,
+    };
+}
+/**
+ * A thin `fetch` crumb from method + URL + status (outcome derived from the status).
+ * The instrumentation uses {@link networkCrumb} directly to carry the full metadata;
+ * this convenience builder seeds a network crumb from a status alone.
+ */
+function fetchCrumb(method, url, status, timestamp) {
+    return networkCrumb({ api: "fetch", method, url, status, outcome: outcomeFromStatus(status) }, timestamp);
+}
+/** A thin `xhr` crumb from method + URL + status (outcome derived from the status). */
+function xhrCrumb(method, url, status, timestamp) {
+    return networkCrumb({ api: "xhr", method, url, status, outcome: outcomeFromStatus(status) }, timestamp);
+}
+/** Distil any thrown value into the `{ name, message }` an error crumb reads. */
+function describeError(error) {
+    if (error instanceof Error) {
+        return { name: error.name || "Error", message: error.message };
+    }
+    if (typeof error === "string")
+        return { name: "Error", message: error };
+    return { name: "Error", message: (0, console_args_1.stringifyArg)(error) };
+}
+/**
+ * An `error` crumb for the failing exception or rejection that ends the trace. When
+ * `causedBy` is given (an auto-captured error), it rides on the crumb as the causal
+ * pointer to the ids of the entries immediately preceding the throw (spec #122 §F).
+ */
+function errorCrumb(error, timestamp, causedBy) {
+    const { name, message } = describeError(error);
+    const crumb = {
+        category: "error",
+        level: "error",
+        message: message ? `${name}: ${message}` : name,
+        timestamp,
+        data: { errorType: name },
+    };
+    return causedBy && causedBy.length > 0 ? { ...crumb, causedBy } : crumb;
+}
+//# sourceMappingURL=crumbs.js.map

package/dist/trace/crumbs.js.map

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

package/dist/trace/source.d.ts

@@ -0,0 +1,30 @@
+/**
+ * The console crumb's **call site** (spec #122 §C) — the best-effort `file:line` a
+ * `console.*` call was made from, shared runtime-agnostically (ADR-0028).
+ *
+ * Frames are tokenized by the core's single stack parser (`stack.ts`), so a stack
+ * that yields a fingerprint frame yields a source location too — the browser's V8
+ * and Firefox/Safari dialects and React Native's Hermes/JSC ones alike. A query
+ * string on the asset URL is dropped, both for parse safety and privacy (it may be
+ * a cache-buster, or defensively a token).
+ */
+import type { SourceLocation } from "../breadcrumb";
+/**
+ * Parse a single **trimmed** stack line into a `{ file, line }` location, or
+ * `undefined` when the line names no locatable file:line.
+ */
+export declare function parseStackFrame(line: string): SourceLocation | undefined;
+/**
+ * The best-effort `file:line` a console call was made from (spec #122 §C). Parses the
+ * frames of a stack, skipping `skipFrames` leading (SDK-internal) frames so the source
+ * points at the host code that called `console.*`. Returns `undefined` when no frame
+ * yields a usable location — the crumb then simply omits `source`.
+ */
+export declare function sourceFromStack(stack: string | undefined, skipFrames?: number): SourceLocation | undefined;
+/**
+ * Frames between `new Error()` (created inside the console wrapper) and the host
+ * caller: just the wrapper frame itself. Skipping it points {@link sourceFromStack}
+ * at the app code. The wrapper is called through the console object's property, so
+ * it is not a direct-call inlining candidate — keeping this skip count stable.
+ */
+export declare const CONSOLE_SOURCE_SKIP_FRAMES = 1;