@scalebun-release/web 2.2.2

package/dist/features/network/tracing.d.ts

@@ -0,0 +1,18 @@
+/**
+ * P4.3 (light FE-side tracing) — W3C Trace Context. We generate a `traceparent` per outbound request
+ * and inject it ONLY into allowlisted origins (same-origin by default; cross-origin is opt-in since the
+ * server must CORS-allow the header). This is the FE→BE correlation HANDOFF: the customer's own backend
+ * APM (Datadog/Sentry/OTel) reads the traceparent — we don't store BE spans. We capture the trace id on
+ * the network item so the dashboard can surface it. Zero third-party deps.
+ */
+export interface TraceContext {
+    traceId: string;
+    spanId: string;
+    header: string;
+}
+export declare function makeTrace(): TraceContext;
+/** The origin of a (possibly relative) URL, resolved against the page. Null if unparseable. */
+export declare function originOf(url: string): string | null;
+/** Build the per-request injector for the allowlist; null when tracing is off (empty allowlist). */
+export declare function makeTraceInjector(origins: string[]): ((url: string) => TraceContext | null) | null;
+//# sourceMappingURL=tracing.d.ts.map

package/dist/features/network/tracing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.d.ts","sourceRoot":"","sources":["../../../src/features/network/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAYH,MAAM,WAAW,YAAY;IAC3B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;CAChB;AAED,wBAAgB,SAAS,IAAI,YAAY,CAIxC;AAED,+FAA+F;AAC/F,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAOnD;AAED,oGAAoG;AACpG,wBAAgB,iBAAiB,CAC/B,OAAO,EAAE,MAAM,EAAE,GAChB,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,YAAY,GAAG,IAAI,CAAC,GAAG,IAAI,CAO/C"}

package/dist/features/network/tracing.js

@@ -0,0 +1,46 @@
+/**
+ * P4.3 (light FE-side tracing) — W3C Trace Context. We generate a `traceparent` per outbound request
+ * and inject it ONLY into allowlisted origins (same-origin by default; cross-origin is opt-in since the
+ * server must CORS-allow the header). This is the FE→BE correlation HANDOFF: the customer's own backend
+ * APM (Datadog/Sentry/OTel) reads the traceparent — we don't store BE spans. We capture the trace id on
+ * the network item so the dashboard can surface it. Zero third-party deps.
+ */
+function hex(bytes) {
+    const arr = new Uint8Array(bytes);
+    const c = globalThis.crypto;
+    if (c && typeof c.getRandomValues === 'function')
+        c.getRandomValues(arr);
+    else
+        for (let i = 0; i < bytes; i++)
+            arr[i] = Math.floor(Math.random() * 256);
+    let s = '';
+    for (const b of arr)
+        s += b.toString(16).padStart(2, '0');
+    return s;
+}
+export function makeTrace() {
+    const traceId = hex(16);
+    const spanId = hex(8);
+    return { traceId, spanId, header: `00-${traceId}-${spanId}-01` };
+}
+/** The origin of a (possibly relative) URL, resolved against the page. Null if unparseable. */
+export function originOf(url) {
+    try {
+        const base = typeof location !== 'undefined' ? location.href : undefined;
+        return new URL(url, base).origin;
+    }
+    catch {
+        return null;
+    }
+}
+/** Build the per-request injector for the allowlist; null when tracing is off (empty allowlist). */
+export function makeTraceInjector(origins) {
+    if (!origins.length)
+        return null;
+    const set = new Set(origins);
+    return (url) => {
+        const o = originOf(url);
+        return o && set.has(o) ? makeTrace() : null;
+    };
+}
+//# sourceMappingURL=tracing.js.map

package/dist/features/network/tracing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tracing.js","sourceRoot":"","sources":["../../../src/features/network/tracing.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,SAAS,GAAG,CAAC,KAAa;IACxB,MAAM,GAAG,GAAG,IAAI,UAAU,CAAC,KAAK,CAAC,CAAC;IAClC,MAAM,CAAC,GAAG,UAAU,CAAC,MAA4B,CAAC;IAClD,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,eAAe,KAAK,UAAU;QAAE,CAAC,CAAC,eAAe,CAAC,GAAG,CAAC,CAAC;;QACpE,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,EAAE,CAAC,EAAE;YAAE,GAAG,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,GAAG,CAAC,CAAC;IAC9E,IAAI,CAAC,GAAG,EAAE,CAAC;IACX,KAAK,MAAM,CAAC,IAAI,GAAG;QAAE,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;IAC1D,OAAO,CAAC,CAAC;AACX,CAAC;AAQD,MAAM,UAAU,SAAS;IACvB,MAAM,OAAO,GAAG,GAAG,CAAC,EAAE,CAAC,CAAC;IACxB,MAAM,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,CAAC;IACtB,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,OAAO,IAAI,MAAM,KAAK,EAAE,CAAC;AACnE,CAAC;AAED,+FAA+F;AAC/F,MAAM,UAAU,QAAQ,CAAC,GAAW;IAClC,IAAI,CAAC;QACH,MAAM,IAAI,GAAG,OAAO,QAAQ,KAAK,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC;QACzE,OAAO,IAAI,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC,MAAM,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC;AAED,oGAAoG;AACpG,MAAM,UAAU,iBAAiB,CAC/B,OAAiB;IAEjB,IAAI,CAAC,OAAO,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACjC,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,CAAC;IAC7B,OAAO,CAAC,GAAW,EAAE,EAAE;QACrB,MAAM,CAAC,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC;QACxB,OAAO,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9C,CAAC,CAAC;AACJ,CAAC"}

package/dist/features/network/types.d.ts

@@ -0,0 +1,75 @@
+/** Transport a capture rode over. 'http' is the default for fetch/XHR. */
+export type NetProtocol = 'http' | 'ws' | 'sse' | 'beacon';
+/** Classified failure taxonomy (N0). Absent ⇒ the request succeeded. Mirrors the wire enum. */
+export type NetFailure = 'http_4xx' | 'http_5xx' | 'network_error' | 'timeout' | 'cors' | 'abort';
+/** GraphQL operation metadata parsed from a request body (N2). */
+export interface NetGraphql {
+    operationName?: string;
+    operationType?: 'query' | 'mutation' | 'subscription';
+    hasErrors?: boolean;
+    batched?: boolean;
+}
+/** PerformanceResourceTiming phase breakdown merged onto a capture (N1, ms). */
+export interface NetTiming {
+    dns?: number;
+    tcp?: number;
+    tls?: number;
+    ttfb?: number;
+    download?: number;
+}
+/** WebSocket / SSE lifecycle counters (N3). */
+export interface NetWs {
+    messagesSent?: number;
+    messagesReceived?: number;
+    bytesSent?: number;
+    bytesReceived?: number;
+    closeCode?: number;
+    closeReason?: string;
+}
+/** Captured body/header pair (N4, opt-in). Already redacted + capped at the capture site. */
+export interface NetBody {
+    headers?: Record<string, string>;
+    body?: string;
+}
+/** What an interceptor reports for a single request. Normalized to a contract item by normalize.ts. */
+export interface NetCapture {
+    /** Transport. Undefined ⇒ 'http' (backward-compatible default). */
+    protocol?: NetProtocol;
+    method: string;
+    url: string;
+    status?: number;
+    startedAt: number;
+    duration: number;
+    requestSize?: number;
+    responseSize?: number;
+    /** Actual bytes over the wire from ResourceTiming (N1). */
+    transferSize?: number;
+    error?: string;
+    /** The request was aborted (AbortController / xhr.abort) — N0 classification hint. */
+    aborted?: boolean;
+    /** The request timed out — N0 classification hint. */
+    timedOut?: boolean;
+    graphql?: NetGraphql;
+    timing?: NetTiming;
+    ws?: NetWs;
+    request?: NetBody;
+    response?: NetBody;
+    traceId?: string;
+    /** The request body as a string when available (used by N2 GraphQL + N4 body capture). */
+    reqBody?: string;
+    /** A function that resolves the (cloned, stream-safe) response text — for N2/N4. Resolves null on
+     *  failure or when no clone is available. The feature calls it at most once. */
+    readResponseText?: () => Promise<string | null>;
+    /** Request content-type header (for N4 content-type allowlist). */
+    reqContentType?: string;
+    /** Response content-type header (for N2/N4). */
+    resContentType?: string;
+}
+export type OnRecord = (capture: NetCapture) => void;
+export type IsOwnUrl = (url: string) => boolean;
+/** Returns a trace context to inject for this URL, or null to skip (off-allowlist / disabled). */
+export type InjectTrace = (url: string) => {
+    traceId: string;
+    header: string;
+} | null;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/network/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/features/network/types.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,IAAI,GAAG,KAAK,GAAG,QAAQ,CAAC;AAE3D,+FAA+F;AAC/F,MAAM,MAAM,UAAU,GAAG,UAAU,GAAG,UAAU,GAAG,eAAe,GAAG,SAAS,GAAG,MAAM,GAAG,OAAO,CAAC;AAElG,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,GAAG,UAAU,GAAG,cAAc,CAAC;IACtD,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,gFAAgF;AAChF,MAAM,WAAW,SAAS;IACxB,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,+CAA+C;AAC/C,MAAM,WAAW,KAAK;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,6FAA6F;AAC7F,MAAM,WAAW,OAAO;IACtB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACjC,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,uGAAuG;AACvG,MAAM,WAAW,UAAU;IACzB,mEAAmE;IACnE,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,sFAAsF;IACtF,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,sDAAsD;IACtD,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,UAAU,CAAC;IACrB,MAAM,CAAC,EAAE,SAAS,CAAC;IACnB,EAAE,CAAC,EAAE,KAAK,CAAC;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IAGjB,0FAA0F;IAC1F,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB;oFACgF;IAChF,gBAAgB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAChD,mEAAmE;IACnE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,gDAAgD;IAChD,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,OAAO,EAAE,UAAU,KAAK,IAAI,CAAC;AACrD,MAAM,MAAM,QAAQ,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK,OAAO,CAAC;AAChD,kGAAkG;AAClG,MAAM,MAAM,WAAW,GAAG,CAAC,GAAG,EAAE,MAAM,KAAK;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC"}

package/dist/features/network/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/features/network/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/features/network/types.ts"],"names":[],"mappings":""}

package/dist/features/network/xhrInterceptor.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Patches XMLHttpRequest (axios + many libs still use it) to record method/url/status/duration.
+ * Bodies/headers are not read in v1. Self-excludes the SDK's own traffic. `target` is injectable
+ * for testability.
+ */
+import type { OnRecord, IsOwnUrl, InjectTrace } from './types.js';
+type XhrHolder = {
+    XMLHttpRequest: typeof XMLHttpRequest;
+};
+export declare function installXhr(target: XhrHolder, onRecord: OnRecord, isOwnUrl: IsOwnUrl, injectTrace?: InjectTrace): () => void;
+export {};
+//# sourceMappingURL=xhrInterceptor.d.ts.map

package/dist/features/network/xhrInterceptor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"xhrInterceptor.d.ts","sourceRoot":"","sources":["../../../src/features/network/xhrInterceptor.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,WAAW,EAAE,MAAM,SAAS,CAAC;AAG/D,KAAK,SAAS,GAAG;IAAE,cAAc,EAAE,OAAO,cAAc,CAAA;CAAE,CAAC;AAK3D,wBAAgB,UAAU,CACxB,MAAM,EAAE,SAAS,EACjB,QAAQ,EAAE,QAAQ,EAClB,QAAQ,EAAE,QAAQ,EAClB,WAAW,CAAC,EAAE,WAAW,GACxB,MAAM,IAAI,CAmFZ"}

package/dist/features/network/xhrInterceptor.js

@@ -0,0 +1,108 @@
+/**
+ * Patches XMLHttpRequest (axios + many libs still use it) to record method/url/status/duration.
+ * Bodies/headers are not read in v1. Self-excludes the SDK's own traffic. `target` is injectable
+ * for testability.
+ */
+import { requestBodyBytes, contentLengthBytes, utf8ByteLength, perfNow } from './size.js';
+export function installXhr(target, onRecord, isOwnUrl, injectTrace) {
+    const XHR = target.XMLHttpRequest;
+    if (typeof XHR !== 'function')
+        return () => { };
+    const origOpen = XHR.prototype.open;
+    const origSend = XHR.prototype.send;
+    const origSetHeader = XHR.prototype.setRequestHeader;
+    XHR.prototype.open = function (method, url, ...rest) {
+        this.__scalebun = { method: String(method).toUpperCase(), url: String(url) };
+        return origOpen.call(this, method, url, ...rest);
+    };
+    // Capture the request content-type the app sets (XHR request headers aren't readable post-send) so
+    // the N4 body-capture content-type allowlist works for XHR too — not just fetch.
+    XHR.prototype.setRequestHeader = function (name, value) {
+        if (this.__scalebun && typeof name === 'string' && name.toLowerCase() === 'content-type') {
+            this.__scalebun.reqContentType = String(value);
+        }
+        return origSetHeader.call(this, name, value);
+    };
+    XHR.prototype.send = function (body) {
+        const meta = this.__scalebun;
+        if (meta && !isOwnUrl(meta.url)) {
+            // P4.3 — inject traceparent for allowlisted origins (must be set after open, before send).
+            const trace = injectTrace?.(meta.url);
+            if (trace) {
+                meta.traceId = trace.traceId;
+                try {
+                    this.setRequestHeader('traceparent', trace.header);
+                }
+                catch {
+                    /* header forbidden / already sent — skip */
+                }
+            }
+            const startedAt = Date.now(); // epoch — wire timestamp + ResourceTiming match
+            const t0 = perfNow(); // monotonic — for duration
+            const reqBody = typeof body === 'string' ? body : undefined;
+            const requestSize = requestBodyBytes(body); // byte-accurate (string/URLSearchParams/Blob/ArrayBuffer)
+            let aborted = false;
+            let timedOut = false;
+            this.addEventListener('abort', () => {
+                aborted = true;
+            });
+            this.addEventListener('timeout', () => {
+                timedOut = true;
+            });
+            this.addEventListener('loadend', () => {
+                const failedTransport = this.status === 0;
+                onRecord({
+                    method: meta.method,
+                    url: meta.url,
+                    status: this.status || 0,
+                    startedAt,
+                    duration: Math.round(perfNow() - t0),
+                    requestSize,
+                    responseSize: xhrResponseSize(this),
+                    error: failedTransport ? (aborted ? 'aborted' : timedOut ? 'timeout' : 'network error') : undefined,
+                    aborted,
+                    timedOut,
+                    reqBody,
+                    reqContentType: meta.reqContentType, // captured from setRequestHeader (enables N4 body capture)
+                    resContentType: safeResponseHeader(this, 'content-type'),
+                    // XHR exposes responseText synchronously — no clone needed; guarded for non-text types.
+                    readResponseText: async () => {
+                        try {
+                            return typeof this.responseText === 'string' ? this.responseText : null;
+                        }
+                        catch {
+                            return null;
+                        }
+                    },
+                    traceId: meta.traceId,
+                });
+            });
+        }
+        return origSend.call(this, body);
+    };
+    return () => {
+        XHR.prototype.open = origOpen;
+        XHR.prototype.send = origSend;
+        XHR.prototype.setRequestHeader = origSetHeader;
+    };
+}
+function safeResponseHeader(xhr, name) {
+    try {
+        return xhr.getResponseHeader?.(name) ?? undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+function xhrResponseSize(xhr) {
+    const cl = contentLengthBytes(xhr.getResponseHeader?.('content-length'));
+    if (cl != null)
+        return cl;
+    try {
+        return typeof xhr.responseText === 'string' ? utf8ByteLength(xhr.responseText) : undefined;
+    }
+    catch {
+        return undefined; // responseText throws for non-text responseTypes
+    }
+}
+//# sourceMappingURL=xhrInterceptor.js.map

package/dist/features/network/xhrInterceptor.js.map

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

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

@@ -0,0 +1,76 @@
+/**
+ * F-PERF — performance traces: Long Tasks + LoAF (the web "profiler" analog) + custom spans
+ * (startTrace/stopTrace). Emits `kind:'performance'` items onto the unified pipeline. Deliberately
+ * does NOT emit Core Web Vitals — those are F-VIT's (webVitals/). To avoid double-counting jank, we
+ * prefer LoAF (richer, attributed) when the browser supports it and fall back to plain Long Tasks
+ * otherwise — never both.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+/** Self-observability snapshot (RUM P5) — the perf pipeline's own health. */
+export interface PerfStats {
+    /** transactions emitted (kept by sampling) */
+    transactions: number;
+    /** transactions dropped by sampling */
+    droppedTransactions: number;
+    /** resource-timing items emitted */
+    resources: number;
+    /** long-task / LoAF items emitted */
+    jank: number;
+    /** whether a transaction is currently open */
+    activeTransaction: boolean;
+    /** effective transaction sample rate */
+    sampleRate: number;
+}
+import { type TransactionHandle } from './trace/types.js';
+import type { TraceContext } from './trace/index.js';
+export declare class PerformanceFeature implements IFeature {
+    readonly name = "performance";
+    private ctx;
+    private active;
+    private disconnects;
+    private readonly cap;
+    private readonly resCap;
+    private readonly traces;
+    /** Lazily-loaded trace engine (Transaction/Span tree). Undefined until the dynamic import resolves;
+     *  until then startTransaction returns a safe no-op handle (engine loads at init, before host calls). */
+    private engine?;
+    private activeTxn?;
+    private navEntry?;
+    private pageloadEmitted;
+    private routeTxn?;
+    private routeTimer?;
+    private tracesSampleRate;
+    private slowTxnMs;
+    private droppedTxns;
+    private txnCount;
+    private resourceCount;
+    private jankCount;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    private emitResource;
+    /** Self-observability — the perf pipeline's own health. */
+    perfStats(): PerfStats;
+    private emitCapped;
+    /**
+     * 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: string): TransactionHandle;
+    /** 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(): TraceContext | undefined;
+    private emitTransaction;
+    private emitTransactionData;
+    /** Emit the page-load transaction once the engine + a completed nav entry are both available. */
+    private tryEmitPageload;
+    /** A SPA route change → finish the previous route transaction, open a new one, (re)arm the settle. */
+    private onRouteChange;
+    private finishRouteTxn;
+    /** Begin a custom trace span (facade: ScaleBun.performance.startTrace). */
+    startTrace(name: string): void;
+    /** End a custom trace span → emits a `performance` item with the elapsed time. */
+    stopTrace(name: string): void;
+    teardown(): void;
+}
+//# sourceMappingURL=PerformanceFeature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"PerformanceFeature.d.ts","sourceRoot":"","sources":["../../../src/features/performance/PerformanceFeature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIxE,6EAA6E;AAC7E,MAAM,WAAW,SAAS;IACxB,8CAA8C;IAC9C,YAAY,EAAE,MAAM,CAAC;IACrB,uCAAuC;IACvC,mBAAmB,EAAE,MAAM,CAAC;IAC5B,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,qCAAqC;IACrC,IAAI,EAAE,MAAM,CAAC;IACb,8CAA8C;IAC9C,iBAAiB,EAAE,OAAO,CAAC;IAC3B,wCAAwC;IACxC,UAAU,EAAE,MAAM,CAAC;CACpB;AAQD,OAAO,EAAY,KAAK,iBAAiB,EAAE,MAAM,eAAe,CAAC;AACjE,OAAO,KAAK,EAAe,YAAY,EAAmB,MAAM,SAAS,CAAC;AAoB1E,qBAAa,kBAAmB,YAAW,QAAQ;IACjD,QAAQ,CAAC,IAAI,iBAAiB;IAC9B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,WAAW,CAAyB;IAC5C,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAiB;IAErC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAmD;IAC1E,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C;6GACyG;IACzG,OAAO,CAAC,MAAM,CAAC,CAA2B;IAC1C,OAAO,CAAC,SAAS,CAAC,CAAc;IAEhC,OAAO,CAAC,QAAQ,CAAC,CAA8B;IAC/C,OAAO,CAAC,eAAe,CAAS;IAEhC,OAAO,CAAC,QAAQ,CAAC,CAAoB;IACrC,OAAO,CAAC,UAAU,CAAC,CAAgC;IAEnD,OAAO,CAAC,gBAAgB,CAAK;IAC7B,OAAO,CAAC,SAAS,CAAuB;IAExC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,SAAS,CAAK;IAEtB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAmFhC,OAAO,CAAC,YAAY;IAQpB,2DAA2D;IAC3D,SAAS,IAAI,SAAS;IAWtB,OAAO,CAAC,UAAU;IAwBlB;;;;OAIG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,iBAAiB;IAUjD;gGAC4F;IAC5F,qBAAqB,IAAI,YAAY,GAAG,SAAS;IAIjD,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,mBAAmB;IAoC3B,iGAAiG;IACjG,OAAO,CAAC,eAAe;IAOvB,sGAAsG;IACtG,OAAO,CAAC,aAAa;IAQrB,OAAO,CAAC,cAAc;IAStB,2EAA2E;IAC3E,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAI9B,kFAAkF;IAClF,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAQ7B,QAAQ,IAAI,IAAI;CAOjB"}

package/dist/features/performance/PerformanceFeature.js

@@ -0,0 +1,265 @@
+import { safeObserve, getReplayCoord } from '../../core/index.js';
+import { publishJank } from './jankTap.js';
+import { toPerfItem } from './normalize.js';
+import { RateCap } from './throttle.js';
+import { TraceRegistry } from './traces.js';
+import { longTaskReading, loafReading } from './longTasks.js';
+import { resourceTiming, setSelfEndpoint } from './resources.js';
+import { installSpaRoutes } from './spa.js';
+import { keepTransaction } from './sampler.js';
+import { NOOP_TXN } from './trace/types.js';
+/** 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/index.js')
+            .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