@scalebun/web 1.0.0

package/dist/features/performance/PerformanceFeature.js

@@ -0,0 +1,265 @@
+import { safeObserve, getReplayCoord } from '../../core';
+import { publishJank } from './jankTap';
+import { toPerfItem } from './normalize';
+import { RateCap } from './throttle';
+import { TraceRegistry } from './traces';
+import { longTaskReading, loafReading } from './longTasks';
+import { resourceTiming, setSelfEndpoint } from './resources';
+import { installSpaRoutes } from './spa';
+import { keepTransaction } from './sampler';
+import { NOOP_TXN } from './trace/types';
+/** SPA route transaction settles this long after the last route change (initial render/data-load). */
+const ROUTE_SETTLE_MS = 1000;
+const DEFAULT_SLOW_TXN_MS = 3000;
+const clockNow = () => typeof performance !== 'undefined' && performance.now ? performance.now() : Date.now();
+function loafSupported() {
+    try {
+        const types = typeof PerformanceObserver !== 'undefined' &&
+            PerformanceObserver.supportedEntryTypes;
+        return Array.isArray(types) && types.includes('long-animation-frame');
+    }
+    catch {
+        return false;
+    }
+}
+export class PerformanceFeature {
+    constructor() {
+        this.name = 'performance';
+        this.ctx = null;
+        this.active = false;
+        this.disconnects = [];
+        this.cap = new RateCap();
+        // Resources burst on page-load (buffered observer delivers all past entries at once) → a roomier cap.
+        this.resCap = new RateCap({ capCount: 100, windowMs: 10000 });
+        this.traces = new TraceRegistry();
+        this.pageloadEmitted = false;
+        // P4 — transaction sampling.
+        this.tracesSampleRate = 1;
+        this.slowTxnMs = DEFAULT_SLOW_TXN_MS;
+        // P5 — self-observability counters.
+        this.droppedTxns = 0;
+        this.txnCount = 0;
+        this.resourceCount = 0;
+        this.jankCount = 0;
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        if (this.active)
+            return; // idempotent — a second setup without teardown would double-observe
+        this.ctx = ctx;
+        // Tell the resource reader which origin is OURS, so the SDK never reports its own telemetry
+        // traffic as one of the page's resources. See setSelfEndpoint().
+        setSelfEndpoint(ctx.apiBaseUrl);
+        const opts = ctx.performanceOptions;
+        if (opts) {
+            if (typeof opts.tracesSampleRate === 'number')
+                this.tracesSampleRate = opts.tracesSampleRate;
+            if (typeof opts.slowTransactionMs === 'number')
+                this.slowTxnMs = opts.slowTransactionMs;
+        }
+        // Load the trace engine as a separate chunk now (at init), ready before the host opens a transaction.
+        void import('./trace')
+            .then((m) => {
+            this.engine = m;
+            this.tryEmitPageload(); // engine may resolve after the nav entry is grabbed
+        })
+            .catch(() => {
+            /* engine unavailable → transactions degrade to no-ops */
+        });
+        // P2 — auto page-load transaction: grab Navigation Timing once the page has loaded.
+        const grabNav = () => {
+            const nav = performance.getEntriesByType?.('navigation')?.[0];
+            if (nav) {
+                this.navEntry = nav;
+                this.tryEmitPageload();
+            }
+        };
+        if (typeof document !== 'undefined' && document.readyState === 'complete')
+            grabNav();
+        else if (typeof window !== 'undefined')
+            window.addEventListener('load', () => setTimeout(grabNav, 0), { once: true });
+        // P2 — SPA soft navigations → route-change transactions.
+        this.disconnects.push(installSpaRoutes((route) => this.onRouteChange(route)));
+        if (typeof window !== 'undefined') {
+            const onHide = () => this.finishRouteTxn();
+            window.addEventListener('pagehide', onHide);
+            this.disconnects.push(() => window.removeEventListener('pagehide', onHide));
+        }
+        // P5 — count errors during the active transaction (drives correlation + the sampler's error bias).
+        if (ctx.onSignal) {
+            this.disconnects.push(ctx.onSignal((reason) => {
+                if (reason === 'error')
+                    this.activeTxn?.noteError();
+            }));
+        }
+        if (typeof PerformanceObserver === 'undefined') {
+            this.active = true; // transactions still work without PerformanceObserver
+            return;
+        }
+        if (loafSupported()) {
+            // Prefer LoAF — it attributes the jank to a script (the wedge over plain long tasks).
+            this.disconnects.push(safeObserve('long-animation-frame', (entries) => {
+                for (const e of entries)
+                    this.emitCapped('loaf', e, loafReading(e));
+            }));
+        }
+        else {
+            this.disconnects.push(safeObserve('longtask', (entries) => {
+                for (const e of entries)
+                    this.emitCapped('longtask', e, longTaskReading(e));
+            }));
+        }
+        // RUM P0 — resource-timing waterfall (static assets; fetch/XHR are the Network vertical's).
+        // `buffered:true` (safeObserve default) replays resources loaded before setup.
+        this.disconnects.push(safeObserve('resource', (entries) => {
+            for (const e of entries) {
+                const r = resourceTiming(e);
+                if (r)
+                    this.emitResource(r);
+            }
+        }));
+        this.active = true;
+    }
+    emitResource(reading) {
+        if (!this.resCap.accept())
+            return;
+        const dropped = this.resCap.takeDropped();
+        const metadata = dropped > 0 ? { ...reading.metadata, droppedSince: dropped } : reading.metadata;
+        this.resourceCount++;
+        this.ctx?.emit(toPerfItem('resource', reading.value, { unit: 'ms', duration: reading.value, metadata }));
+    }
+    /** Self-observability — the perf pipeline's own health. */
+    perfStats() {
+        return {
+            transactions: this.txnCount,
+            droppedTransactions: this.droppedTxns,
+            resources: this.resourceCount,
+            jank: this.jankCount,
+            activeTransaction: !!this.activeTxn,
+            sampleRate: this.tracesSampleRate,
+        };
+    }
+    emitCapped(metric, entry, reading) {
+        if (!this.cap.accept())
+            return;
+        const dropped = this.cap.takeDropped();
+        const metadata = dropped > 0 ? { ...reading.metadata, droppedSince: dropped } : reading.metadata;
+        this.jankCount++;
+        this.ctx?.emit(toPerfItem(metric, reading.value, { unit: 'ms', metadata }));
+        // W5.2 — publish to the jank tap so the Resource Watchdog reuses this observer (no second one).
+        const script = metadata.script;
+        publishJank({
+            metric,
+            blockingMs: reading.value,
+            frameDurationMs: metric === 'loaf' ? Number(metadata.frameDuration ?? entry.duration) : entry.duration,
+            script: script ? { url: script.url, invoker: script.invoker } : undefined,
+        });
+        // P3 — attribute the jank to the active transaction (route/user txn) as a span, placed at the
+        // entry's actual time (long-task/LoAF startTime + duration are in the performance.now() domain,
+        // same as the transaction clock). Bounded by the transaction's own span cap.
+        this.activeTxn?.addSpan(metric, entry.startTime, entry.startTime + entry.duration, reading.metadata);
+    }
+    /**
+     * Open a RUM transaction (a timed root with a bounded span tree). Returns a safe no-op handle if the
+     * trace engine hasn't loaded yet (engine loads at init, before host code runs). On finish it emits a
+     * `performance` item (`metric:'transaction'`) with the span tree + trace context in metadata.
+     */
+    startTransaction(name) {
+        if (!this.engine)
+            return NOOP_TXN;
+        const txn = new this.engine.Transaction(name, {
+            clock: clockNow,
+            onFinish: (t) => this.emitTransaction(t),
+        });
+        this.activeTxn = txn;
+        return txn;
+    }
+    /** The active transaction's trace context — read by the Network vertical (P5/N5 seam) so an outbound
+     *  request injects the SAME traceparent (FE txn ↔ FE request ↔ BE span share one trace). */
+    getActiveTraceContext() {
+        return this.activeTxn?.context();
+    }
+    emitTransaction(txn) {
+        if (this.activeTxn === txn)
+            this.activeTxn = undefined;
+        this.emitTransactionData(txn.data());
+    }
+    emitTransactionData(d) {
+        // E1 (engage) — a transaction over the "slow" threshold nudges the capture-signal bus so a
+        // `slow_screen`-triggered campaign can fire (independent of sampling; fire-and-forget).
+        if (d.durationMs >= this.slowTxnMs)
+            this.ctx?.signal?.('slow_screen');
+        // P4 — tail-based sampling: keep slow/errored always, deterministically thin the rest.
+        if (!keepTransaction({
+            traceId: d.traceId,
+            durationMs: d.durationMs,
+            slowMs: this.slowTxnMs,
+            sampleRate: this.tracesSampleRate,
+            hasError: (d.errorCount ?? 0) > 0, // P5 — errored transactions are always kept
+        })) {
+            this.droppedTxns++;
+            return;
+        }
+        this.txnCount++;
+        const replay = getReplayCoord(); // P5 — deep-link the transaction to the replay frame
+        this.ctx?.emit(toPerfItem('transaction', d.durationMs, {
+            unit: 'ms',
+            duration: d.durationMs,
+            metadata: {
+                kind: 'transaction',
+                name: d.name,
+                trace: { traceId: d.traceId, spanId: d.spanId, sampled: d.sampled },
+                spans: d.spans,
+                ...(d.droppedSpans ? { droppedSpans: d.droppedSpans } : {}),
+                ...(d.errorCount ? { errorCount: d.errorCount } : {}),
+                ...(replay ? { replay } : {}),
+            },
+        }));
+    }
+    /** Emit the page-load transaction once the engine + a completed nav entry are both available. */
+    tryEmitPageload() {
+        if (this.pageloadEmitted || !this.engine || !this.navEntry || !this.navEntry.loadEventEnd)
+            return;
+        this.pageloadEmitted = true;
+        const route = typeof location !== 'undefined' ? location.pathname : '/';
+        this.emitTransactionData(this.engine.buildPageload(this.navEntry, route));
+    }
+    /** A SPA route change → finish the previous route transaction, open a new one, (re)arm the settle. */
+    onRouteChange(route) {
+        this.finishRouteTxn();
+        this.routeTxn = this.startTransaction(`navigation ${route}`);
+        if (typeof setTimeout !== 'undefined') {
+            this.routeTimer = setTimeout(() => this.finishRouteTxn(), ROUTE_SETTLE_MS);
+        }
+    }
+    finishRouteTxn() {
+        if (this.routeTimer !== undefined) {
+            clearTimeout(this.routeTimer);
+            this.routeTimer = undefined;
+        }
+        this.routeTxn?.finish();
+        this.routeTxn = undefined;
+    }
+    /** Begin a custom trace span (facade: ScaleBun.performance.startTrace). */
+    startTrace(name) {
+        this.traces.start(name);
+    }
+    /** End a custom trace span → emits a `performance` item with the elapsed time. */
+    stopTrace(name) {
+        const result = this.traces.stop(name);
+        if (!result)
+            return;
+        this.ctx?.emit(toPerfItem(result.name, result.durationMs, { unit: 'ms', duration: result.durationMs, metadata: { kind: 'trace' } }));
+    }
+    teardown() {
+        this.finishRouteTxn(); // flush an in-flight route transaction
+        for (const d of this.disconnects)
+            d();
+        this.disconnects = [];
+        this.traces.clear();
+        this.active = false;
+    }
+}
+//# sourceMappingURL=PerformanceFeature.js.map

package/dist/features/performance/PerformanceFeature.js.map

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

package/dist/features/performance/jankTap.d.ts

@@ -0,0 +1,23 @@
+/**
+ * W5.2 — a tiny pub/sub so the (optional, off-by-default) Resource Watchdog can consume the
+ * LoAF/longtask readings PerformanceFeature ALREADY observes, instead of opening a SECOND
+ * PerformanceObserver. The design invariant is one observer per entry type; this tap upholds it.
+ * Publish is a no-op with zero subscribers, so it costs nothing when the watchdog is off.
+ */
+export interface JankTapReading {
+    metric: 'loaf' | 'longtask';
+    /** Blocking time (LoAF blockingDuration, else the task/frame duration). */
+    blockingMs: number;
+    /** Whole-frame / task duration — drives the frozen_frame incident. */
+    frameDurationMs: number;
+    script?: {
+        url?: string;
+        invoker?: string;
+        fn?: string;
+    };
+}
+type Sub = (r: JankTapReading) => void;
+export declare function publishJank(r: JankTapReading): void;
+export declare function onJank(cb: Sub): () => void;
+export {};
+//# sourceMappingURL=jankTap.d.ts.map

package/dist/features/performance/jankTap.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jankTap.d.ts","sourceRoot":"","sources":["../../../src/features/performance/jankTap.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,cAAc;IAC7B,MAAM,EAAE,MAAM,GAAG,UAAU,CAAC;IAC5B,2EAA2E;IAC3E,UAAU,EAAE,MAAM,CAAC;IACnB,sEAAsE;IACtE,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,CAAC,EAAE;QAAE,GAAG,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,EAAE,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;CAC1D;AAED,KAAK,GAAG,GAAG,CAAC,CAAC,EAAE,cAAc,KAAK,IAAI,CAAC;AAGvC,wBAAgB,WAAW,CAAC,CAAC,EAAE,cAAc,GAAG,IAAI,CASnD;AAED,wBAAgB,MAAM,CAAC,EAAE,EAAE,GAAG,GAAG,MAAM,IAAI,CAK1C"}

package/dist/features/performance/jankTap.js

@@ -0,0 +1,20 @@
+const subs = new Set();
+export function publishJank(r) {
+    if (!subs.size)
+        return;
+    for (const s of subs) {
+        try {
+            s(r);
+        }
+        catch {
+            /* isolate a subscriber throw from the perf hot path */
+        }
+    }
+}
+export function onJank(cb) {
+    subs.add(cb);
+    return () => {
+        subs.delete(cb);
+    };
+}
+//# sourceMappingURL=jankTap.js.map

package/dist/features/performance/jankTap.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jankTap.js","sourceRoot":"","sources":["../../../src/features/performance/jankTap.ts"],"names":[],"mappings":"AAgBA,MAAM,IAAI,GAAG,IAAI,GAAG,EAAO,CAAC;AAE5B,MAAM,UAAU,WAAW,CAAC,CAAiB;IAC3C,IAAI,CAAC,IAAI,CAAC,IAAI;QAAE,OAAO;IACvB,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,CAAC,CAAC,CAAC,CAAC,CAAC;QACP,CAAC;QAAC,MAAM,CAAC;YACP,uDAAuD;QACzD,CAAC;IACH,CAAC;AACH,CAAC;AAED,MAAM,UAAU,MAAM,CAAC,EAAO;IAC5B,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACb,OAAO,GAAG,EAAE;QACV,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;IAClB,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/performance/longTasks.d.ts

@@ -0,0 +1,14 @@
+type Entry = PerformanceEntry | Record<string, unknown>;
+export interface PerfReading {
+    value: number;
+    metadata: Record<string, unknown>;
+}
+/** Long Task → its duration (ms) + start time. */
+export declare function longTaskReading(entry: Entry): PerfReading;
+/**
+ * LoAF → blocking duration (ms) + the single most expensive attributed script (so the dashboard can
+ * say *which* script caused the jank — the attribution wedge over a plain long task).
+ */
+export declare function loafReading(entry: Entry): PerfReading;
+export {};
+//# sourceMappingURL=longTasks.d.ts.map

package/dist/features/performance/longTasks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"longTasks.d.ts","sourceRoot":"","sources":["../../../src/features/performance/longTasks.ts"],"names":[],"mappings":"AAQA,KAAK,KAAK,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AAED,kDAAkD;AAClD,wBAAgB,eAAe,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CAMzD;AAgCD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,WAAW,CA6BrD"}

package/dist/features/performance/longTasks.js

@@ -0,0 +1,55 @@
+/**
+ * Pure readers for Long Tasks + LoAF (Long Animation Frames) — kept separate from the observer
+ * wiring so they're unit-testable without a browser. Entries are heterogeneous (each carries extra
+ * fields not on the base PerformanceEntry), so we take a loose shape and cast per field (as vitals.ts
+ * does). `scrubText` is applied to any URL/name strings by the caller (normalize) before emit.
+ */
+import { scrubText } from '../../core';
+/** Long Task → its duration (ms) + start time. */
+export function longTaskReading(entry) {
+    const e = entry;
+    return {
+        value: e.duration ?? 0,
+        metadata: { startTime: Math.round(e.startTime ?? 0) },
+    };
+}
+/**
+ * LoAF → blocking duration (ms) + the single most expensive attributed script (so the dashboard can
+ * say *which* script caused the jank — the attribution wedge over a plain long task).
+ */
+export function loafReading(entry) {
+    const e = entry;
+    const scripts = Array.isArray(e.scripts) ? e.scripts : [];
+    let top;
+    for (const s of scripts) {
+        if (!top || (s.duration ?? 0) > (top.duration ?? 0))
+            top = s;
+    }
+    const metadata = {
+        frameDuration: Math.round(e.duration ?? 0),
+        startTime: Math.round(e.startTime ?? 0),
+    };
+    if (top) {
+        const script = {
+            url: scrubText(String(top.sourceURL ?? top.name ?? '')),
+            invoker: scrubText(String(top.invoker ?? '')),
+            duration: Math.round(top.duration ?? 0),
+        };
+        // P4 source-frame fields, each written only when the browser actually reported it — an absent
+        // field and a zero are different facts, and the backend's confidence model reads them as such.
+        // `sourceFunctionName` is NOT scrubbed: it is an identifier from the page's own code, not user
+        // data, and scrubbing would corrupt the very string a source map has to match.
+        if (top.sourceFunctionName)
+            script.fn = String(top.sourceFunctionName);
+        if (top.sourceCharPosition != null && top.sourceCharPosition >= 0)
+            script.pos = top.sourceCharPosition;
+        if (top.forcedStyleAndLayoutDuration)
+            script.forcedLayout = Math.round(top.forcedStyleAndLayoutDuration);
+        if (top.invokerType)
+            script.invokerType = String(top.invokerType);
+        metadata.script = script;
+    }
+    // Prefer blockingDuration (the jank that matters); fall back to total frame duration.
+    return { value: e.blockingDuration ?? e.duration ?? 0, metadata };
+}
+//# sourceMappingURL=longTasks.js.map

package/dist/features/performance/longTasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"longTasks.js","sourceRoot":"","sources":["../../../src/features/performance/longTasks.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AASvC,kDAAkD;AAClD,MAAM,UAAU,eAAe,CAAC,KAAY;IAC1C,MAAM,CAAC,GAAG,KAAkD,CAAC;IAC7D,OAAO;QACL,KAAK,EAAE,CAAC,CAAC,QAAQ,IAAI,CAAC;QACtB,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,EAAE;KACtD,CAAC;AACJ,CAAC;AAgCD;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAY;IACtC,MAAM,CAAC,GAAG,KAAkB,CAAC;IAC7B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,IAAI,GAA2B,CAAC;IAChC,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;QACxB,IAAI,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;YAAE,GAAG,GAAG,CAAC,CAAC;IAC/D,CAAC;IACD,MAAM,QAAQ,GAA4B;QACxC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC1C,SAAS,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC;KACxC,CAAC;IACF,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,MAAM,GAA4B;YACtC,GAAG,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,SAAS,IAAI,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC;YACvD,OAAO,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,CAAC,OAAO,IAAI,EAAE,CAAC,CAAC;YAC7C,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,QAAQ,IAAI,CAAC,CAAC;SACxC,CAAC;QACF,8FAA8F;QAC9F,+FAA+F;QAC/F,+FAA+F;QAC/F,+EAA+E;QAC/E,IAAI,GAAG,CAAC,kBAAkB;YAAE,MAAM,CAAC,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;QACvE,IAAI,GAAG,CAAC,kBAAkB,IAAI,IAAI,IAAI,GAAG,CAAC,kBAAkB,IAAI,CAAC;YAAE,MAAM,CAAC,GAAG,GAAG,GAAG,CAAC,kBAAkB,CAAC;QACvG,IAAI,GAAG,CAAC,4BAA4B;YAAE,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,4BAA4B,CAAC,CAAC;QACzG,IAAI,GAAG,CAAC,WAAW;YAAE,MAAM,CAAC,WAAW,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;QAClE,QAAQ,CAAC,MAAM,GAAG,MAAM,CAAC;IAC3B,CAAC;IACD,sFAAsF;IACtF,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC,gBAAgB,IAAI,CAAC,CAAC,QAAQ,IAAI,CAAC,EAAE,QAAQ,EAAE,CAAC;AACpE,CAAC"}

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

@@ -0,0 +1,15 @@
+/** Builds a contract `performance` Item from a trace / long-task / LoAF reading. Pure + shared. */
+import type { PerformanceItem } from '@scalebun/protocol';
+export interface PerfFields {
+    unit?: string;
+    /** Duration in ms (set alongside value for span-like metrics so avgByType.duration works). */
+    duration?: number;
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Normalize a performance reading into a contract `performance` item. `metric` is scrubbed (custom
+ * span names are developer-supplied and may carry ids); metadata strings are scrubbed too. Extra
+ * fields (clientId/duration/metadata) ride on the `.passthrough()` schema — no contract change.
+ */
+export declare function toPerfItem(metric: string, value: number, fields?: PerfFields): PerformanceItem;
+//# sourceMappingURL=normalize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.d.ts","sourceRoot":"","sources":["../../../src/features/performance/normalize.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAEnG,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAG1D,MAAM,WAAW,UAAU;IACzB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAUD;;;;GAIG;AACH,wBAAgB,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAE,UAAe,GAAG,eAAe,CAalG"}

package/dist/features/performance/normalize.js

@@ -0,0 +1,30 @@
+/** Builds a contract `performance` Item from a trace / long-task / LoAF reading. Pure + shared. */
+import { uuid, now, scrubText } from '../../core';
+const currentScreen = () => {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+/**
+ * Normalize a performance reading into a contract `performance` item. `metric` is scrubbed (custom
+ * span names are developer-supplied and may carry ids); metadata strings are scrubbed too. Extra
+ * fields (clientId/duration/metadata) ride on the `.passthrough()` schema — no contract change.
+ */
+export function toPerfItem(metric, value, fields = {}) {
+    return {
+        kind: 'performance',
+        metric: scrubText(metric),
+        value: Math.round(value * 1000) / 1000,
+        unit: fields.unit ?? 'ms',
+        screenName: currentScreen(),
+        // Dedup belt-and-suspenders (emit-once is the primary guard) → PerformanceMetric.clientId.
+        clientId: `perf_${uuid()}`,
+        ...(fields.duration != null ? { duration: Math.round(fields.duration) } : {}),
+        ...(fields.metadata ? { metadata: fields.metadata } : {}),
+        timestamp: now(),
+    };
+}
+//# sourceMappingURL=normalize.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"normalize.js","sourceRoot":"","sources":["../../../src/features/performance/normalize.ts"],"names":[],"mappings":"AAAA,mGAAmG;AAGnG,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AASlD,MAAM,aAAa,GAAG,GAAuB,EAAE;IAC7C,IAAI,CAAC;QACH,OAAO,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACzE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,UAAU,UAAU,CAAC,MAAc,EAAE,KAAa,EAAE,SAAqB,EAAE;IAC/E,OAAO;QACL,IAAI,EAAE,aAAa;QACnB,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC;QACzB,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,KAAK,GAAG,IAAI,CAAC,GAAG,IAAI;QACtC,IAAI,EAAE,MAAM,CAAC,IAAI,IAAI,IAAI;QACzB,UAAU,EAAE,aAAa,EAAE;QAC3B,2FAA2F;QAC3F,QAAQ,EAAE,QAAQ,IAAI,EAAE,EAAE;QAC1B,GAAG,CAAC,MAAM,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzD,SAAS,EAAE,GAAG,EAAE;KACE,CAAC;AACvB,CAAC"}

package/dist/features/performance/resources.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Resource-timing extraction (RUM P0) — turns a `PerformanceResourceTiming` entry into a perf reading
+ * for the resource waterfall (DNS / TCP / TLS / TTFB / download + sizes). Pure + dependency-free
+ * (takes a plain entry so it's unit-testable without a browser).
+ *
+ * fetch / XMLHttpRequest / beacon are EXCLUDED — those requests are the Network vertical's domain
+ * (deduped by `initiatorType`), so a request is never counted by both. This owns STATIC assets
+ * (script / link / css / img / font / …).
+ */
+export interface ResourceReading {
+    /** total duration in ms */
+    value: number;
+    metadata: Record<string, unknown>;
+}
+export declare function setSelfEndpoint(apiBaseUrl: string | undefined | null): void;
+/** True for anything addressed to our own ingest — never a fact about the customer's page. */
+export declare function isSelfRequest(url: string): boolean;
+export declare function resourceTiming(e: PerformanceResourceTiming): ResourceReading | null;
+//# sourceMappingURL=resources.d.ts.map

package/dist/features/performance/resources.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"resources.d.ts","sourceRoot":"","sources":["../../../src/features/performance/resources.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAKH,MAAM,WAAW,eAAe;IAC9B,2BAA2B;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACnC;AA0BD,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI,GAAG,IAAI,CAE3E;AAED,8FAA8F;AAC9F,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD;AAED,wBAAgB,cAAc,CAAC,CAAC,EAAE,yBAAyB,GAAG,eAAe,GAAG,IAAI,CAiCnF"}

package/dist/features/performance/resources.js

@@ -0,0 +1,78 @@
+/**
+ * Resource-timing extraction (RUM P0) — turns a `PerformanceResourceTiming` entry into a perf reading
+ * for the resource waterfall (DNS / TCP / TLS / TTFB / download + sizes). Pure + dependency-free
+ * (takes a plain entry so it's unit-testable without a browser).
+ *
+ * fetch / XMLHttpRequest / beacon are EXCLUDED — those requests are the Network vertical's domain
+ * (deduped by `initiatorType`), so a request is never counted by both. This owns STATIC assets
+ * (script / link / css / img / font / …).
+ */
+/** Owned by the Network vertical — skip here to avoid double-counting. */
+const NETWORK_OWNED = new Set(['fetch', 'xmlhttprequest', 'beacon']);
+function stripQuery(url) {
+    return url.replace(/[?#].*$/, '');
+}
+/** A timing segment in ms, or undefined when the marks are absent/zero (cross-origin without a
+ *  Timing-Allow-Origin header zeroes the sub-timings — we keep only duration + url in that case). */
+function seg(a, b) {
+    return a > 0 && b >= a ? Math.round(b - a) : undefined;
+}
+/**
+ * Our OWN telemetry endpoint, set once at setup so this pure reader can exclude it.
+ *
+ * Without this the SDK reports itself. `ConfigFeature` holds an `EventSource` open to
+ * `${apiBaseUrl}/config/stream`, and Resource Timing records that connection as `initiatorType:
+ * 'other'` — which `NETWORK_OWNED` does not cover — so a long-lived SSE stream that reconnects lands
+ * in the customer's resource list as the same URL fetched dozens of times. It reached production
+ * analysis: the top performance finding on a real app was "http://localhost:3001/api/v1/config/stream
+ * is fetched 77× in a single session", i.e. we diagnosed our own agent as their bug.
+ *
+ * Matching is by ORIGIN + path prefix rather than a hardcoded host, so it holds for localhost during
+ * development and for whatever ingest domain a customer is configured against.
+ */
+let selfBase = '';
+export function setSelfEndpoint(apiBaseUrl) {
+    selfBase = (apiBaseUrl ?? '').replace(/\/$/, '');
+}
+/** True for anything addressed to our own ingest — never a fact about the customer's page. */
+export function isSelfRequest(url) {
+    return !!selfBase && url.startsWith(selfBase);
+}
+export function resourceTiming(e) {
+    if (NETWORK_OWNED.has(e.initiatorType))
+        return null; // Network vertical owns these
+    if (isSelfRequest(e.name))
+        return null; // never report our own telemetry as their resource
+    const duration = Math.round(e.duration);
+    if (duration <= 0)
+        return null; // opaque / instant memory-cache → no useful timing
+    const metadata = {
+        kind: 'resource',
+        initiator: e.initiatorType,
+        url: stripQuery(e.name),
+    };
+    const put = (k, v) => {
+        if (v !== undefined && v > 0)
+            metadata[k] = v;
+    };
+    put('dns', seg(e.domainLookupStart, e.domainLookupEnd));
+    put('tcp', seg(e.connectStart, e.connectEnd));
+    put('tls', e.secureConnectionStart > 0 ? seg(e.secureConnectionStart, e.connectEnd) : undefined);
+    put('ttfb', seg(e.requestStart, e.responseStart));
+    put('download', seg(e.responseStart, e.responseEnd));
+    put('transferSize', e.transferSize || undefined);
+    put('encodedSize', e.encodedBodySize || undefined);
+    // P4. `decodedBodySize` is what makes a compression finding EXACT rather than a guess: encoded ÷
+    // decoded is the real compression ratio, so "this text asset is served uncompressed" becomes a
+    // measurement instead of an inference from a suspiciously round transfer size.
+    put('decodedSize', e.decodedBodySize || undefined);
+    // …and `renderBlockingStatus` is Chromium telling us directly, so a render-blocking finding no
+    // longer has to infer it from resource type and position. Stored as reported — including
+    // `non-blocking`, because "the browser said it is not blocking" and "the browser did not say" are
+    // different states and only the first can support a confirmed finding.
+    const rbs = e.renderBlockingStatus;
+    if (rbs)
+        metadata.renderBlocking = rbs;
+    return { value: duration, metadata };
+}
+//# sourceMappingURL=resources.js.map

package/dist/features/performance/resources.js.map

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

package/dist/features/performance/sampler.d.ts

@@ -0,0 +1,10 @@
+export interface SampleInput {
+    traceId: string;
+    durationMs: number;
+    slowMs: number;
+    sampleRate: number;
+    /** Set in P5 once a transaction's in-window errors are known. */
+    hasError?: boolean;
+}
+export declare function keepTransaction(i: SampleInput): boolean;
+//# sourceMappingURL=sampler.d.ts.map

package/dist/features/performance/sampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../../src/features/performance/sampler.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,iEAAiE;IACjE,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,wBAAgB,eAAe,CAAC,CAAC,EAAE,WAAW,GAAG,OAAO,CAMvD"}

package/dist/features/performance/sampler.js

@@ -0,0 +1,23 @@
+/**
+ * Transaction sampling (RUM P4) — tail-based, "interesting-transaction" bias. ALWAYS keep a slow or
+ * errored transaction regardless of the base dice; deterministically thin only the fast, clean ones.
+ * Net: high signal at low volume. fnv1a32 on the traceId (same hash family as flags/grouping) so the
+ * backend can re-derive the decision — no client trust.
+ */
+import { fnv1a32 } from '../config/bucketing';
+// NOTE: keeps the legacy `wzb-` prefix on purpose. This salt is a bucketing input, not
+// branding — nobody ever sees it, and changing the string reshuffles which sessions are
+// sampled. It was left untouched by the ScaleBun rebrand for that reason.
+const SALT = 'wzb-traces-v1'; // frozen — changing it reshuffles every app's transaction sampling
+export function keepTransaction(i) {
+    if (i.durationMs >= i.slowMs)
+        return true; // slow → always keep (adaptive bias)
+    if (i.hasError)
+        return true; // errored → always keep
+    if (i.sampleRate >= 1)
+        return true; // default: keep everything
+    if (i.sampleRate <= 0)
+        return false;
+    return fnv1a32(`${i.traceId}:${SALT}`) % 100 < i.sampleRate * 100;
+}
+//# sourceMappingURL=sampler.js.map

package/dist/features/performance/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../../../src/features/performance/sampler.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAE9C,uFAAuF;AACvF,wFAAwF;AACxF,0EAA0E;AAC1E,MAAM,IAAI,GAAG,eAAe,CAAC,CAAC,mEAAmE;AAWjG,MAAM,UAAU,eAAe,CAAC,CAAc;IAC5C,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC,CAAC,qCAAqC;IAChF,IAAI,CAAC,CAAC,QAAQ;QAAE,OAAO,IAAI,CAAC,CAAC,wBAAwB;IACrD,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,2BAA2B;IAC/D,IAAI,CAAC,CAAC,UAAU,IAAI,CAAC;QAAE,OAAO,KAAK,CAAC;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,CAAC,UAAU,GAAG,GAAG,CAAC;AACpE,CAAC"}

package/dist/features/performance/spa.d.ts

@@ -0,0 +1,2 @@
+export declare function installSpaRoutes(onRouteChange: (route: string) => void): () => void;
+//# sourceMappingURL=spa.d.ts.map

package/dist/features/performance/spa.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"spa.d.ts","sourceRoot":"","sources":["../../../src/features/performance/spa.ts"],"names":[],"mappings":"AAQA,wBAAgB,gBAAgB,CAAC,aAAa,EAAE,CAAC,KAAK,EAAE,MAAM,KAAK,IAAI,GAAG,MAAM,IAAI,CAwCnF"}