@scalebun/web 1.0.0

package/dist/features/errors/ErrorsFeature.js

@@ -0,0 +1,209 @@
+/**
+ * F-ERR — captures JS errors and emits contract `error` items onto the unified pipeline.
+ * Auto path (window.onerror + unhandledrejection) is throttled (anti-flood); the manual path
+ * (captureError) is NOT — it's dev-intentional, not a loop.
+ */
+import { toErrorItem } from './normalize';
+import { ErrorThrottle } from './dedup';
+import { resolveScope } from './scope';
+import { shouldSampleErrors } from './sampling';
+import { breadcrumbs } from '../../core';
+const noParse = () => [];
+function firstFrame(stack) {
+    if (!stack)
+        return '';
+    const line = stack.split('\n').find((l) => /\bat\b|@/.test(l));
+    return (line ?? '').trim().slice(0, 200);
+}
+/** Benign noise nearly every app throws but that isn't actionable. Dropped by default; the host's
+ *  own `ignoreErrors` is appended, never replaces these. */
+const DEFAULT_IGNORE = [
+    'ResizeObserver loop limit exceeded',
+    'ResizeObserver loop completed with undelivered notifications',
+];
+function matchPattern(pat, value) {
+    return typeof pat === 'string' ? value.includes(pat) : pat.test(value);
+}
+export class ErrorsFeature {
+    constructor() {
+        this.name = 'errors';
+        this.ctx = null;
+        this.active = false;
+        this.throttle = new ErrorThrottle();
+        this.ignore = DEFAULT_IGNORE;
+        this.denyUrls = [];
+        this.captureResourceErrors = false;
+        /** Whether auto-capture (onerror/unhandledrejection) is sampled in for this session. */
+        this.sampled = true;
+        this.counters = { captured: 0, droppedThrottle: 0, droppedIgnore: 0, droppedBeforeSend: 0, byType: {}, lastFingerprint: undefined };
+    }
+    /** Self-observability — the SDK's own error-pipeline health. */
+    stats() {
+        return {
+            captured: this.counters.captured,
+            droppedThrottle: this.counters.droppedThrottle,
+            droppedIgnore: this.counters.droppedIgnore,
+            droppedBeforeSend: this.counters.droppedBeforeSend,
+            byType: { ...this.counters.byType },
+            lastFingerprint: this.counters.lastFingerprint,
+            breadcrumbs: breadcrumbs.snapshot().length,
+            sampled: this.sampled,
+        };
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        const opts = ctx.errorsOptions;
+        if (opts) {
+            this.ignore = [...DEFAULT_IGNORE, ...(opts.ignoreErrors ?? [])];
+            this.denyUrls = opts.denyUrls ?? [];
+            this.captureResourceErrors = opts.captureResourceErrors ?? false;
+            this.beforeSend = opts.beforeSend;
+        }
+        // Per-session sampling gates only the AUTO firehose; manual captureError always works.
+        this.sampled = shouldSampleErrors(opts?.sampleRate, ctx.sessionId);
+        // Load the enrichment chunk now (at init), so it's ready well before the first error.
+        void import('./lazy')
+            .then((m) => {
+            this.parseStack = m.parseStack;
+            this.computeFingerprint = m.computeFingerprint;
+            this.extractCauses = m.extractCauses;
+        })
+            .catch(() => {
+            /* enrichment unavailable → frames/fingerprint omitted, raw stack still ships */
+        });
+        if (typeof window === 'undefined')
+            return;
+        this.onError = (e) => {
+            // A failed resource load (img/script/link/css) ALSO surfaces here in the capture phase, but as
+            // a plain Event whose target is the failing element, with no `.error`/`.message`. Don't file it
+            // as a JS crash — it's a different signal (and noise in the Issues list). Dropped unless opted in.
+            const target = e.target;
+            const isResource = !!target &&
+                target !== window &&
+                typeof target.tagName === 'string' &&
+                !e.error &&
+                !e.message;
+            if (isResource) {
+                if (!this.captureResourceErrors)
+                    return;
+                const url = target.src || target.href || '';
+                this.handleAuto({
+                    type: 'fatal',
+                    message: `Failed to load ${target.tagName.toLowerCase()}${url ? ` ${url}` : ''}`,
+                    source: url,
+                    mechanism: 'resource',
+                });
+                return;
+            }
+            this.handleAuto({
+                type: 'fatal',
+                message: e.message || e.error?.message || 'Uncaught error',
+                stack: e.error?.stack,
+                source: e.filename,
+                lineno: e.lineno,
+                colno: e.colno,
+                mechanism: 'onerror',
+            }, e.error);
+        };
+        this.onRejection = (e) => {
+            const r = e.reason;
+            this.handleAuto({
+                type: 'unhandledrejection',
+                message: r?.message ?? String(e.reason),
+                stack: r?.stack,
+                mechanism: 'onunhandledrejection',
+            }, e.reason);
+        };
+        // capture-phase `error` also catches resource errors; we keep it for uncaught JS.
+        // Sampled-out sessions install NOTHING (zero auto-capture overhead); manual captureError still works.
+        if (this.sampled) {
+            window.addEventListener('error', this.onError, true);
+            window.addEventListener('unhandledrejection', this.onRejection);
+        }
+        this.active = true;
+    }
+    /** True if this error is benign noise or originates from a denied source — dropped silently. */
+    shouldIgnore(raw) {
+        for (const pat of this.ignore)
+            if (matchPattern(pat, raw.message))
+                return true;
+        if (raw.source)
+            for (const pat of this.denyUrls)
+                if (matchPattern(pat, raw.source))
+                    return true;
+        return false;
+    }
+    /** Auto path — throttled to survive render loops. */
+    handleAuto(raw, original) {
+        if (this.shouldIgnore(raw)) {
+            this.counters.droppedIgnore++;
+            return;
+        }
+        const signature = `${raw.type}|${raw.message}|${firstFrame(raw.stack)}`;
+        if (!this.throttle.accept(signature)) {
+            this.counters.droppedThrottle++;
+            return;
+        }
+        this.buildAndEmit(raw, { droppedSince: this.throttle.takeDropped(), original });
+    }
+    /** Manual path used by ScaleBun.captureError — not throttled (intentional). */
+    captureHandled(error, extra, over) {
+        const e = error;
+        this.buildAndEmit({ type: 'handled', message: e?.message ?? String(error), stack: e?.stack, mechanism: 'captureError' }, { extra, scopeOver: over, original: error });
+    }
+    /** Shared build: enrich (frames + fingerprint + causes + scope) → beforeSend → emit + signal. */
+    buildAndEmit(raw, o) {
+        const frames = this.parseStack?.(raw.stack);
+        const fingerprint = o.scopeOver?.fingerprint ?? this.computeFingerprint?.(raw.type, frames, raw.message);
+        const causes = o.original != null && this.extractCauses ? this.extractCauses(o.original, this.parseStack ?? noParse) : undefined;
+        let item = toErrorItem(raw, {
+            droppedSince: o.droppedSince,
+            extra: o.extra,
+            frames,
+            fingerprint,
+            causes,
+            scope: resolveScope(o.scopeOver),
+        });
+        if (this.beforeSend) {
+            try {
+                const r = this.beforeSend(item);
+                if (!r) {
+                    this.counters.droppedBeforeSend++;
+                    return; // host returned null → drop the error entirely
+                }
+                item = r;
+            }
+            catch {
+                /* a throwing hook must never lose the error — ship the original */
+            }
+        }
+        this.ctx?.emit(item);
+        this.counters.captured++;
+        this.counters.byType[raw.type] = (this.counters.byType[raw.type] ?? 0) + 1;
+        if (fingerprint)
+            this.counters.lastFingerprint = fingerprint;
+        // Arm capture-on-signal (replay) AND carry just enough for AnalyticsFeature to promote this to a
+        // `$exception` product event. Errors previously lived ONLY in the errors lane, so no funnel or
+        // cohort could ask "did this user hit an error" — the data existed and never crossed over.
+        // Message is truncated and fingerprint/type are already-derived, non-PII fields.
+        this.ctx?.signal('error', {
+            fingerprint,
+            type: raw.type,
+            message: (raw.message ?? '').slice(0, 200),
+            handled: raw.type === 'handled',
+        });
+    }
+    teardown() {
+        if (typeof window === 'undefined')
+            return;
+        if (this.onError)
+            window.removeEventListener('error', this.onError, true);
+        if (this.onRejection)
+            window.removeEventListener('unhandledrejection', this.onRejection);
+        this.active = false;
+    }
+}
+//# sourceMappingURL=ErrorsFeature.js.map

package/dist/features/errors/ErrorsFeature.js.map

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

package/dist/features/errors/causes.d.ts

@@ -0,0 +1,15 @@
+/**
+ * Cause-chain extraction (M4) — walks `error.cause` (ES2022) and `AggregateError.errors` into a flat
+ * chain so a wrapped error ("DB write failed" → caused by "ECONNREFUSED") shows its root cause. Each
+ * cause's stack is parsed into frames via the passed parser. Cycle-safe + depth-capped. Lives in the
+ * lazy enrichment chunk (uses the stack parser; ~0 core cost).
+ */
+import type { StackFrame } from '@scalebun/protocol';
+export interface Cause {
+    type?: string;
+    message: string;
+    frames?: StackFrame[];
+}
+/** Flatten the cause chain BELOW the head error (the head is represented by the error item itself). */
+export declare function extractCauses(err: unknown, parse: (s?: string) => StackFrame[]): Cause[];
+//# sourceMappingURL=causes.d.ts.map

package/dist/features/errors/causes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"causes.d.ts","sourceRoot":"","sources":["../../../src/features/errors/causes.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAErD,MAAM,WAAW,KAAK;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;CACvB;AAID,uGAAuG;AACvG,wBAAgB,aAAa,CAAC,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,MAAM,KAAK,UAAU,EAAE,GAAG,KAAK,EAAE,CAwBxF"}

package/dist/features/errors/causes.js

@@ -0,0 +1,29 @@
+const MAX_DEPTH = 5; // cap pathological / cyclic chains
+/** Flatten the cause chain BELOW the head error (the head is represented by the error item itself). */
+export function extractCauses(err, parse) {
+    const out = [];
+    const seen = new Set();
+    const push = (e) => {
+        if (!e || typeof e !== 'object' || seen.has(e) || out.length >= MAX_DEPTH)
+            return;
+        seen.add(e);
+        const ex = e;
+        const frames = parse(ex.stack);
+        out.push({ type: ex.name, message: String(ex.message ?? e), ...(frames.length ? { frames } : {}) });
+    };
+    // AggregateError: every aggregated error is a cause.
+    const agg = err?.errors;
+    if (Array.isArray(agg))
+        for (const sub of agg)
+            push(sub);
+    // `cause` chain (and a cause may itself aggregate / chain).
+    let cur = err?.cause;
+    while (cur && out.length < MAX_DEPTH) {
+        if (seen.has(cur))
+            break;
+        push(cur);
+        cur = cur?.cause;
+    }
+    return out;
+}
+//# sourceMappingURL=causes.js.map

package/dist/features/errors/causes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"causes.js","sourceRoot":"","sources":["../../../src/features/errors/causes.ts"],"names":[],"mappings":"AAcA,MAAM,SAAS,GAAG,CAAC,CAAC,CAAC,mCAAmC;AAExD,uGAAuG;AACvG,MAAM,UAAU,aAAa,CAAC,GAAY,EAAE,KAAmC;IAC7E,MAAM,GAAG,GAAY,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG,IAAI,GAAG,EAAW,CAAC;IAEhC,MAAM,IAAI,GAAG,CAAC,CAAU,EAAQ,EAAE;QAChC,IAAI,CAAC,CAAC,IAAI,OAAO,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,IAAI,SAAS;YAAE,OAAO;QAClF,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACZ,MAAM,EAAE,GAAG,CAAwD,CAAC;QACpE,MAAM,MAAM,GAAG,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,CAAC;QAC/B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,MAAM,CAAC,EAAE,CAAC,OAAO,IAAI,CAAC,CAAC,EAAE,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACtG,CAAC,CAAC;IAEF,qDAAqD;IACrD,MAAM,GAAG,GAAI,GAA4B,EAAE,MAAM,CAAC;IAClD,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC;QAAE,KAAK,MAAM,GAAG,IAAI,GAAG;YAAE,IAAI,CAAC,GAAG,CAAC,CAAC;IAEzD,4DAA4D;IAC5D,IAAI,GAAG,GAAI,GAA2B,EAAE,KAAK,CAAC;IAC9C,OAAO,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,SAAS,EAAE,CAAC;QACrC,IAAI,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,MAAM;QACzB,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,GAAG,GAAI,GAA2B,EAAE,KAAK,CAAC;IAC5C,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/dist/features/errors/dedup.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Anti-flood throttle. A render loop can throw thousands of identical errors/sec — this collapses
+ * repeats within a window and enforces a hard rate cap, counting what's dropped (no silent caps).
+ *
+ * NOTE: the `signature` here is for FLOOD control only. It is NOT the issue-grouping fingerprint —
+ * that's computed server-side. Keep the two separate.
+ */
+export interface ThrottleOptions {
+    /** Same signature within this window is collapsed to one. */
+    dedupWindowMs?: number;
+    /** Hard cap: at most `capCount` accepted per `capWindowMs`. */
+    capCount?: number;
+    capWindowMs?: number;
+}
+export declare class ErrorThrottle {
+    private readonly dedupWindowMs;
+    private readonly capCount;
+    private readonly capWindowMs;
+    private readonly lastSeen;
+    private recent;
+    private dropped;
+    constructor(opts?: ThrottleOptions);
+    /** True if this occurrence should be emitted; false if deduped / over the cap (counts a drop). */
+    accept(signature: string): boolean;
+    /** Read + reset the dropped counter (rides along on the next emitted item). */
+    takeDropped(): number;
+}
+//# sourceMappingURL=dedup.d.ts.map

package/dist/features/errors/dedup.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.d.ts","sourceRoot":"","sources":["../../../src/features/errors/dedup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,MAAM,WAAW,eAAe;IAC9B,6DAA6D;IAC7D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,+DAA+D;IAC/D,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6B;IACtD,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,CAAC,EAAE,eAAe;IAMlC,kGAAkG;IAClG,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO;IA4BlC,+EAA+E;IAC/E,WAAW,IAAI,MAAM;CAKtB"}

package/dist/features/errors/dedup.js

@@ -0,0 +1,42 @@
+export class ErrorThrottle {
+    constructor(opts) {
+        this.lastSeen = new Map();
+        this.recent = [];
+        this.dropped = 0;
+        this.dedupWindowMs = opts?.dedupWindowMs ?? 5000;
+        this.capCount = opts?.capCount ?? 20;
+        this.capWindowMs = opts?.capWindowMs ?? 10000;
+    }
+    /** True if this occurrence should be emitted; false if deduped / over the cap (counts a drop). */
+    accept(signature) {
+        const t = Date.now();
+        // Bound `lastSeen` on long-running sessions: once it grows past a cap, drop signatures older
+        // than the dedup window (they can no longer collapse anything). Keeps memory flat over hours.
+        if (this.lastSeen.size > 512) {
+            for (const [sig, ts] of this.lastSeen) {
+                if (t - ts >= this.dedupWindowMs)
+                    this.lastSeen.delete(sig);
+            }
+        }
+        const last = this.lastSeen.get(signature);
+        if (last != null && t - last < this.dedupWindowMs) {
+            this.dropped++;
+            return false;
+        }
+        this.recent = this.recent.filter((ts) => t - ts < this.capWindowMs);
+        if (this.recent.length >= this.capCount) {
+            this.dropped++;
+            return false;
+        }
+        this.lastSeen.set(signature, t);
+        this.recent.push(t);
+        return true;
+    }
+    /** Read + reset the dropped counter (rides along on the next emitted item). */
+    takeDropped() {
+        const d = this.dropped;
+        this.dropped = 0;
+        return d;
+    }
+}
+//# sourceMappingURL=dedup.js.map

package/dist/features/errors/dedup.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dedup.js","sourceRoot":"","sources":["../../../src/features/errors/dedup.ts"],"names":[],"mappings":"AAeA,MAAM,OAAO,aAAa;IAQxB,YAAY,IAAsB;QAJjB,aAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;QAC9C,WAAM,GAAa,EAAE,CAAC;QACtB,YAAO,GAAG,CAAC,CAAC;QAGlB,IAAI,CAAC,aAAa,GAAG,IAAI,EAAE,aAAa,IAAI,IAAI,CAAC;QACjD,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,KAAK,CAAC;IAChD,CAAC;IAED,kGAAkG;IAClG,MAAM,CAAC,SAAiB;QACtB,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAErB,6FAA6F;QAC7F,8FAA8F;QAC9F,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,GAAG,GAAG,EAAE,CAAC;YAC7B,KAAK,MAAM,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACtC,IAAI,CAAC,GAAG,EAAE,IAAI,IAAI,CAAC,aAAa;oBAAE,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC9D,CAAC;QACH,CAAC;QAED,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAC1C,IAAI,IAAI,IAAI,IAAI,IAAI,CAAC,GAAG,IAAI,GAAG,IAAI,CAAC,aAAa,EAAE,CAAC;YAClD,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QAED,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC;QAChC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/dist/features/errors/group/fingerprint.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Client-side grouping fingerprint (M2). A stable key for "the same logical error", derived from the
+ * top in-app stack frames (function@path — NO line/col/host, so it survives reformatting and deploys
+ * to other hosts) or, with no usable stack, from the normalized message shape. Uses fnv1a32 — the
+ * same hash family the sampler/flags use, so the backend can re-derive/verify it (no client trust).
+ *
+ * NOTE: minified frames make this RELEASE-SCOPED (the hashed chunk name shifts per build). It's the
+ * best stable key from what the client can see; the backend re-fingerprints after source-map
+ * symbolication and treats this as a hint / fallback. Lives in the lazy enrichment chunk.
+ */
+import type { StackFrame } from '@scalebun/protocol';
+export declare function computeFingerprint(type: string, frames: StackFrame[] | undefined, message: string): string;
+//# sourceMappingURL=fingerprint.d.ts.map

package/dist/features/errors/group/fingerprint.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.d.ts","sourceRoot":"","sources":["../../../../src/features/errors/group/fingerprint.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AA0CrD,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,UAAU,EAAE,GAAG,SAAS,EAChC,OAAO,EAAE,MAAM,GACd,MAAM,CAIR"}

package/dist/features/errors/group/fingerprint.js

@@ -0,0 +1,45 @@
+import { fnv1a32 } from '../../config/bucketing';
+const MAX_FP_FRAMES = 5; // top N frames define the group
+/** Drop the scheme://host from a URL file (keep the path) so the same error on staging vs prod —
+ *  or behind a CDN — fingerprints identically. Non-URL files (native, <anonymous>, relative) pass through. */
+function normFile(file) {
+    if (!file)
+        return '';
+    const m = /^[a-z]+:\/\/[^/]+(\/.*)$/i.exec(file);
+    return m && m[1] ? m[1] : file;
+}
+/** The frame contribution: top in-app frames (function@path), immediate recursion collapsed. */
+function frameSignature(frames) {
+    if (!frames || !frames.length)
+        return '';
+    const inApp = frames.filter((f) => f.inApp);
+    const base = inApp.length ? inApp : frames;
+    const parts = [];
+    let prev = '';
+    for (const f of base) {
+        const key = `${f.function ?? '<anonymous>'}@${normFile(f.file)}`;
+        if (key !== prev) {
+            parts.push(key); // collapse a()->a()->a() recursion into one
+            prev = key;
+            if (parts.length >= MAX_FP_FRAMES)
+                break;
+        }
+    }
+    return parts.join('>');
+}
+/** Collapse the volatile bits of a message so the same error groups regardless of ids/counts. */
+function messageShape(msg) {
+    return msg
+        .replace(/0x[0-9a-f]+/gi, '0x?')
+        .replace(/\b[0-9a-f]{8,}\b/gi, 'H') // hex ids / hashes / uuids segments
+        .replace(/\d+/g, 'N')
+        .replace(/(['"]).*?\1/g, 'S') // quoted literals
+        .trim()
+        .slice(0, 200);
+}
+export function computeFingerprint(type, frames, message) {
+    const sig = frameSignature(frames);
+    const basis = sig ? `${type}|${sig}` : `${type}|${messageShape(message)}`;
+    return fnv1a32(basis).toString(36);
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/features/errors/group/fingerprint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fingerprint.js","sourceRoot":"","sources":["../../../../src/features/errors/group/fingerprint.ts"],"names":[],"mappings":"AAWA,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAEjD,MAAM,aAAa,GAAG,CAAC,CAAC,CAAC,gCAAgC;AAEzD;8GAC8G;AAC9G,SAAS,QAAQ,CAAC,IAAa;IAC7B,IAAI,CAAC,IAAI;QAAE,OAAO,EAAE,CAAC;IACrB,MAAM,CAAC,GAAG,2BAA2B,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACjD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,gGAAgG;AAChG,SAAS,cAAc,CAAC,MAAqB;IAC3C,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACzC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC5C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC;IAC3C,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,IAAI,IAAI,GAAG,EAAE,CAAC;IACd,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,MAAM,GAAG,GAAG,GAAG,CAAC,CAAC,QAAQ,IAAI,aAAa,IAAI,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC;QACjE,IAAI,GAAG,KAAK,IAAI,EAAE,CAAC;YACjB,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,4CAA4C;YAC7D,IAAI,GAAG,GAAG,CAAC;YACX,IAAI,KAAK,CAAC,MAAM,IAAI,aAAa;gBAAE,MAAM;QAC3C,CAAC;IACH,CAAC;IACD,OAAO,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC;AAED,iGAAiG;AACjG,SAAS,YAAY,CAAC,GAAW;IAC/B,OAAO,GAAG;SACP,OAAO,CAAC,eAAe,EAAE,KAAK,CAAC;SAC/B,OAAO,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,oCAAoC;SACvE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC;SACpB,OAAO,CAAC,cAAc,EAAE,GAAG,CAAC,CAAC,kBAAkB;SAC/C,IAAI,EAAE;SACN,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;AACnB,CAAC;AAED,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,MAAgC,EAChC,OAAe;IAEf,MAAM,GAAG,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;IACnC,MAAM,KAAK,GAAG,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,GAAG,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,IAAI,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;IAC1E,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;AACrC,CAAC"}

package/dist/features/errors/lazy.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The error-enrichment helpers, bundled into ONE lazy chunk (loaded once in ErrorsFeature.setup) so
+ * the parser + fingerprint (+ fnv1a) stay out of the core bundle. Add new heavy enrichers here.
+ */
+export { parseStack } from './parse/stacktrace';
+export { computeFingerprint } from './group/fingerprint';
+export { extractCauses } from './causes';
+//# sourceMappingURL=lazy.d.ts.map

package/dist/features/errors/lazy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.d.ts","sourceRoot":"","sources":["../../../src/features/errors/lazy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/features/errors/lazy.js

@@ -0,0 +1,8 @@
+/**
+ * The error-enrichment helpers, bundled into ONE lazy chunk (loaded once in ErrorsFeature.setup) so
+ * the parser + fingerprint (+ fnv1a) stay out of the core bundle. Add new heavy enrichers here.
+ */
+export { parseStack } from './parse/stacktrace';
+export { computeFingerprint } from './group/fingerprint';
+export { extractCauses } from './causes';
+//# sourceMappingURL=lazy.js.map

package/dist/features/errors/lazy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lazy.js","sourceRoot":"","sources":["../../../src/features/errors/lazy.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC"}

package/dist/features/errors/normalize.d.ts

@@ -0,0 +1,26 @@
+/** Builds a contract `error` Item from a raw browser error. Shared by the auto + manual paths. */
+import type { ErrorItem, StackFrame } from '@scalebun/protocol';
+import type { ResolvedScope } from './scope';
+import type { Cause } from './causes';
+/** How an error reached the SDK — provenance for the dashboard (handled vs unhandled vs resource). */
+export type ErrorMechanism = 'onerror' | 'onunhandledrejection' | 'captureError' | 'resource';
+export interface RawError {
+    type: 'fatal' | 'handled' | 'unhandledrejection';
+    message: string;
+    stack?: string;
+    source?: string;
+    lineno?: number;
+    colno?: number;
+    mechanism?: ErrorMechanism;
+}
+/** Everything the capture path computes around a RawError before it becomes a wire item. */
+export interface ErrorEnrichment {
+    droppedSince?: number;
+    extra?: Record<string, unknown>;
+    frames?: StackFrame[];
+    fingerprint?: string;
+    causes?: Cause[];
+    scope?: ResolvedScope;
+}
+export declare function toErrorItem(raw: RawError, enrich?: ErrorEnrichment): ErrorItem;
+//# sourceMappingURL=normalize.d.ts.map

package/dist/features/errors/normalize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/features/errors/normalize.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAElG,OAAO,KAAK,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAGhE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAC7C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,UAAU,CAAC;AAEtC,sGAAsG;AACtG,MAAM,MAAM,cAAc,GAAG,SAAS,GAAG,sBAAsB,GAAG,cAAc,GAAG,UAAU,CAAC;AAE9F,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,OAAO,GAAG,SAAS,GAAG,oBAAoB,CAAC;IACjD,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,cAAc,CAAC;CAC5B;AAED,4FAA4F;AAC5F,MAAM,WAAW,eAAe;IAC9B,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,MAAM,CAAC,EAAE,UAAU,EAAE,CAAC;IACtB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC;IACjB,KAAK,CAAC,EAAE,aAAa,CAAC;CACvB;AAID,wBAAgB,WAAW,CAAC,GAAG,EAAE,QAAQ,EAAE,MAAM,GAAE,eAAoB,GAAG,SAAS,CAkClF"}

package/dist/features/errors/normalize.js

@@ -0,0 +1,58 @@
+/** Builds a contract `error` Item from a raw browser error. Shared by the auto + manual paths. */
+import { uuid, now, scrubText, breadcrumbs, getReplayCoord } from '../../core';
+import { scrubStack, scrubExtra } from './redact';
+const MAX_STACK = 16 * 1024; // protect payloads from pathological stacks
+export function toErrorItem(raw, enrich = {}) {
+    const { droppedSince = 0, extra, frames, fingerprint, causes, scope } = enrich;
+    let stack = raw.stack;
+    // Synthesize a minimal frame when onerror gave no Error object (older browsers / cross-origin).
+    if (!stack && raw.source) {
+        stack = `${raw.message} at ${raw.source}:${raw.lineno ?? 0}:${raw.colno ?? 0}`;
+    }
+    if (stack && stack.length > MAX_STACK)
+        stack = stack.slice(0, MAX_STACK);
+    stack = scrubStack(stack); // M0: scrub the stack too (emails + URL query strings), not just the message
+    const item = {
+        kind: 'error',
+        type: raw.type,
+        message: scrubText(raw.message ?? ''),
+        stack,
+        source: 'js',
+        ...(raw.mechanism ? { mechanism: raw.mechanism } : {}),
+        ...(frames && frames.length ? { frames } : {}),
+        ...(fingerprint ? { fingerprint } : {}),
+        ...(causes && causes.length ? { causes } : {}),
+        ...(scope?.level ? { level: scope.level } : {}),
+        ...(scope?.tags ? { tags: scope.tags } : {}),
+        ...(scope?.context ? { context: scope.context } : {}),
+        ...attachBreadcrumbs(),
+        ...attachReplay(),
+        screenName: currentScreen(),
+        // Dedup key for the backend (SessionError.clientId is @unique + skipDuplicates).
+        clientId: `err_${uuid()}`,
+        timestamp: now(),
+        ...(droppedSince > 0 ? { droppedSince } : {}),
+        ...(scrubExtra(extra) ?? {}),
+    };
+    return item;
+}
+/** Snapshot the breadcrumb trail (the events leading up to this error). Captured BEFORE this error
+ *  is itself emitted, so it never contains the error it's attached to. */
+function attachBreadcrumbs() {
+    const trail = breadcrumbs.snapshot();
+    return trail.length ? { breadcrumbs: trail } : {};
+}
+/** Stamp WHERE the session replay was — lets the dashboard deep-link to the exact frame (M5). */
+function attachReplay() {
+    const coord = getReplayCoord();
+    return coord ? { replay: coord } : {};
+}
+function currentScreen() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=normalize.js.map

package/dist/features/errors/normalize.js.map

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

package/dist/features/errors/parse/stacktrace.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Multi-dialect stack-trace parser (M1). Turns a raw `error.stack` string into structured
+ * `StackFrame[]` so the backend can symbolicate against `file:line:col` without re-parsing
+ * browser-specific stack formats. Handles V8/Chrome/Node/Edge ("  at fn (file:line:col)") and
+ * Gecko/WebKit/Safari ("fn@file:line:col"). Pure + dependency-free.
+ *
+ * Loaded LAZILY (dynamic import in ErrorsFeature.setup) so it lives in its own chunk and adds ~0 to
+ * the core bundle. Never throws — a frame it can't parse is skipped, not fatal.
+ */
+import type { StackFrame } from '@scalebun/protocol';
+/** Parse a raw stack string into structured frames (top frame first). Returns [] when unparseable. */
+export declare function parseStack(stack?: string): StackFrame[];
+//# sourceMappingURL=stacktrace.d.ts.map

package/dist/features/errors/parse/stacktrace.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stacktrace.d.ts","sourceRoot":"","sources":["../../../../src/features/errors/parse/stacktrace.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAyErD,sGAAsG;AACtG,wBAAgB,UAAU,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,UAAU,EAAE,CASvD"}