@scalebun-release/web 2.2.2

package/dist/features/performance/trace/transaction.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Transaction + Span tree (RUM P1). A transaction is a timed root with a bounded tree of child spans
+ * (resource loads, long-tasks, user spans). Pure + dependency-free (injected clock → unit-testable
+ * without a browser). Bounds cardinality: caps spans per transaction, drop-counts overflow (no silent
+ * caps), and is idempotent on finish. Lazy chunk.
+ */
+import { type TraceContext } from './context.js';
+import { type SpanHandle, type TransactionHandle } from './types.js';
+export interface SpanData {
+    spanId: string;
+    parentSpanId?: string;
+    op: string;
+    description?: string;
+    startMs: number;
+    endMs?: number;
+    data?: Record<string, unknown>;
+}
+export interface TransactionData {
+    name: string;
+    traceId: string;
+    spanId: string;
+    sampled: boolean;
+    startMs: number;
+    durationMs: number;
+    spans: SpanData[];
+    droppedSpans?: number;
+    errorCount?: number;
+}
+export interface TransactionOptions {
+    clock: () => number;
+    maxSpans?: number;
+    sampled?: boolean;
+    onFinish: (t: Transaction) => void;
+}
+export declare class Transaction implements TransactionHandle {
+    readonly name: string;
+    readonly traceId: string;
+    readonly rootSpanId: string;
+    readonly startMs: number;
+    readonly sampled: boolean;
+    private endMs?;
+    private readonly spans;
+    private dropped;
+    private errors;
+    private readonly clock;
+    private readonly maxSpans;
+    private readonly onFinish;
+    constructor(name: string, opts: TransactionOptions);
+    private open;
+    startSpan(op: string, description?: string): SpanHandle;
+    /** Add an already-measured span with EXPLICIT times (for retroactive entries that happened before
+     *  we could open a live span — long-tasks, LoAF, resources). Bounded + drop-counted like live spans. */
+    addSpan(op: string, startMs: number, endMs: number, data?: Record<string, unknown>): void;
+    finish(endMs?: number): void;
+    /** Note that an error occurred during this transaction's window (drives correlation + sampling). */
+    noteError(): void;
+    /** The active trace context — read by the Network vertical (P5/N5 seam) to share the trace. */
+    context(): TraceContext;
+    data(): TransactionData;
+}
+//# sourceMappingURL=transaction.d.ts.map

package/dist/features/performance/trace/transaction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction.d.ts","sourceRoot":"","sources":["../../../../src/features/performance/trace/transaction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAyB,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACrE,OAAO,EAAa,KAAK,UAAU,EAAE,KAAK,iBAAiB,EAAE,MAAM,SAAS,CAAC;AAE7E,MAAM,WAAW,QAAQ;IACvB,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CAChC;AAED,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,QAAQ,EAAE,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,CAAC,CAAC,EAAE,WAAW,KAAK,IAAI,CAAC;CACpC;AAED,qBAAa,WAAY,YAAW,iBAAiB;IAcjD,QAAQ,CAAC,IAAI,EAAE,MAAM;IAbvB,QAAQ,CAAC,OAAO,SAAgB;IAChC,QAAQ,CAAC,UAAU,SAAe;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,OAAO,CAAC,KAAK,CAAC,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAkB;IACxC,OAAO,CAAC,OAAO,CAAK;IACpB,OAAO,CAAC,MAAM,CAAK;IACnB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA2B;gBAGzC,IAAI,EAAE,MAAM,EACrB,IAAI,EAAE,kBAAkB;IAS1B,OAAO,CAAC,IAAI;IAmBZ,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU;IAIvD;4GACwG;IACxG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI;IAezF,MAAM,CAAC,KAAK,SAAe,GAAG,IAAI;IAMlC,oGAAoG;IACpG,SAAS,IAAI,IAAI;IAIjB,+FAA+F;IAC/F,OAAO,IAAI,YAAY;IAIvB,IAAI,IAAI,eAAe;CAaxB"}

package/dist/features/performance/trace/transaction.js

@@ -0,0 +1,90 @@
+/**
+ * Transaction + Span tree (RUM P1). A transaction is a timed root with a bounded tree of child spans
+ * (resource loads, long-tasks, user spans). Pure + dependency-free (injected clock → unit-testable
+ * without a browser). Bounds cardinality: caps spans per transaction, drop-counts overflow (no silent
+ * caps), and is idempotent on finish. Lazy chunk.
+ */
+import { newTraceId, newSpanId } from './context.js';
+import { NOOP_SPAN } from './types.js';
+export class Transaction {
+    constructor(name, opts) {
+        this.name = name;
+        this.traceId = newTraceId();
+        this.rootSpanId = newSpanId();
+        this.spans = [];
+        this.dropped = 0;
+        this.errors = 0;
+        this.clock = opts.clock;
+        this.maxSpans = opts.maxSpans ?? 1000;
+        this.sampled = opts.sampled ?? true;
+        this.onFinish = opts.onFinish;
+        this.startMs = this.clock();
+    }
+    open(op, parentSpanId, description) {
+        if (this.endMs != null || this.spans.length >= this.maxSpans) {
+            this.dropped++;
+            return NOOP_SPAN; // transaction already finished, or span budget exhausted
+        }
+        const span = { spanId: newSpanId(), parentSpanId, op, description, startMs: this.clock() };
+        this.spans.push(span);
+        const clock = this.clock;
+        return {
+            startChild: (childOp, childDesc) => this.open(childOp, span.spanId, childDesc),
+            finish: (endMs = clock()) => {
+                if (span.endMs == null)
+                    span.endMs = endMs;
+            },
+            setData: (key, value) => {
+                (span.data ?? (span.data = {}))[key] = value;
+            },
+        };
+    }
+    startSpan(op, description) {
+        return this.open(op, this.rootSpanId, description);
+    }
+    /** Add an already-measured span with EXPLICIT times (for retroactive entries that happened before
+     *  we could open a live span — long-tasks, LoAF, resources). Bounded + drop-counted like live spans. */
+    addSpan(op, startMs, endMs, data) {
+        if (this.endMs != null || this.spans.length >= this.maxSpans) {
+            this.dropped++;
+            return;
+        }
+        this.spans.push({
+            spanId: newSpanId(),
+            parentSpanId: this.rootSpanId,
+            op,
+            startMs: Math.round(startMs),
+            endMs: Math.round(endMs),
+            ...(data ? { data } : {}),
+        });
+    }
+    finish(endMs = this.clock()) {
+        if (this.endMs != null)
+            return; // idempotent
+        this.endMs = endMs;
+        this.onFinish(this);
+    }
+    /** Note that an error occurred during this transaction's window (drives correlation + sampling). */
+    noteError() {
+        if (this.endMs == null)
+            this.errors++;
+    }
+    /** The active trace context — read by the Network vertical (P5/N5 seam) to share the trace. */
+    context() {
+        return { traceId: this.traceId, spanId: this.rootSpanId, sampled: this.sampled };
+    }
+    data() {
+        return {
+            name: this.name,
+            traceId: this.traceId,
+            spanId: this.rootSpanId,
+            sampled: this.sampled,
+            startMs: this.startMs,
+            durationMs: Math.max(0, (this.endMs ?? this.startMs) - this.startMs),
+            spans: this.spans.slice(),
+            ...(this.dropped > 0 ? { droppedSpans: this.dropped } : {}),
+            ...(this.errors > 0 ? { errorCount: this.errors } : {}),
+        };
+    }
+}
+//# sourceMappingURL=transaction.js.map

package/dist/features/performance/trace/transaction.js.map

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

package/dist/features/performance/trace/types.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Transaction/Span handle types + no-op singletons (RUM P1). Kept EAGER + tiny so the public API
+ * (`ScaleBun.startTransaction`) can always return a safe handle — even before the lazy trace engine
+ * has loaded — without pulling the engine into core. The engine (`transaction.ts`/`context.ts`) is a
+ * separate lazy chunk.
+ */
+export interface SpanHandle {
+    /** Open a child span under this one. */
+    startChild(op: string, description?: string): SpanHandle;
+    /** Close the span (defaults to now). Idempotent. */
+    finish(endMs?: number): void;
+    /** Attach arbitrary data to the span. */
+    setData(key: string, value: unknown): void;
+}
+export interface TransactionHandle {
+    /** Open a span under the transaction root. */
+    startSpan(op: string, description?: string): SpanHandle;
+    /** Close the transaction → emits a `performance` item with its span tree. Idempotent. */
+    finish(endMs?: number): void;
+}
+export declare const NOOP_SPAN: SpanHandle;
+export declare const NOOP_TXN: TransactionHandle;
+//# sourceMappingURL=types.d.ts.map

package/dist/features/performance/trace/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/features/performance/trace/types.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,WAAW,UAAU;IACzB,wCAAwC;IACxC,UAAU,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACzD,oDAAoD;IACpD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yCAAyC;IACzC,OAAO,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAAC;CAC5C;AAED,MAAM,WAAW,iBAAiB;IAChC,8CAA8C;IAC9C,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,UAAU,CAAC;IACxD,yFAAyF;IACzF,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CAC9B;AAED,eAAO,MAAM,SAAS,EAAE,UAIvB,CAAC;AAEF,eAAO,MAAM,QAAQ,EAAE,iBAGtB,CAAC"}

package/dist/features/performance/trace/types.js

@@ -0,0 +1,10 @@
+export const NOOP_SPAN = {
+    startChild: () => NOOP_SPAN,
+    finish() { },
+    setData() { },
+};
+export const NOOP_TXN = {
+    startSpan: () => NOOP_SPAN,
+    finish() { },
+};
+//# sourceMappingURL=types.js.map

package/dist/features/performance/trace/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/features/performance/trace/types.ts"],"names":[],"mappings":"AAsBA,MAAM,CAAC,MAAM,SAAS,GAAe;IACnC,UAAU,EAAE,GAAG,EAAE,CAAC,SAAS;IAC3B,MAAM,KAAI,CAAC;IACX,OAAO,KAAI,CAAC;CACb,CAAC;AAEF,MAAM,CAAC,MAAM,QAAQ,GAAsB;IACzC,SAAS,EAAE,GAAG,EAAE,CAAC,SAAS;IAC1B,MAAM,KAAI,CAAC;CACZ,CAAC"}

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

@@ -0,0 +1,36 @@
+/**
+ * Custom-trace registry — name-keyed spans for startTrace()/stopTrace(). Pure + dependency-free
+ * (takes a clock so it's unit-testable without a browser). Bounds cardinality: caps live spans,
+ * expires never-stopped spans via a TTL, and counts drops (no silent caps).
+ */
+export interface TraceOptions {
+    /** Max simultaneously-open spans before new starts are dropped. */
+    maxOpen?: number;
+    /** A span open longer than this (ms) is considered abandoned and discarded on the next op. */
+    ttlMs?: number;
+    /** Clock injection for tests (defaults to Date.now). */
+    clock?: () => number;
+}
+export interface TraceResult {
+    name: string;
+    /** Elapsed time in ms. */
+    durationMs: number;
+}
+export declare class TraceRegistry {
+    private readonly maxOpen;
+    private readonly ttlMs;
+    private readonly clock;
+    private readonly open;
+    private dropped;
+    constructor(opts?: TraceOptions);
+    /** Begin a span. Last-write-wins on a duplicate name; over-cap starts are dropped + counted. */
+    start(name: string): void;
+    /** End a span → its elapsed ms, or null if it was never started (or already expired). */
+    stop(name: string): TraceResult | null;
+    /** Drop spans that have been open past the TTL (a forgotten stopTrace must not leak). */
+    private expire;
+    /** Read + reset the dropped counter. */
+    takeDropped(): number;
+    clear(): void;
+}
+//# sourceMappingURL=traces.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traces.d.ts","sourceRoot":"","sources":["../../../src/features/performance/traces.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,mEAAmE;IACnE,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8FAA8F;IAC9F,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,KAAK,CAAC,EAAE,MAAM,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,aAAa;IACxB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;IAC/B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAe;IACrC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA6B;IAClD,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,CAAC,EAAE,YAAY;IAM/B,gGAAgG;IAChG,KAAK,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAUzB,yFAAyF;IACzF,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,GAAG,IAAI;IAQtC,yFAAyF;IACzF,OAAO,CAAC,MAAM;IAUd,wCAAwC;IACxC,WAAW,IAAI,MAAM;IAMrB,KAAK,IAAI,IAAI;CAId"}

package/dist/features/performance/traces.js

@@ -0,0 +1,50 @@
+export class TraceRegistry {
+    constructor(opts) {
+        this.open = new Map(); // name → startTime
+        this.dropped = 0;
+        this.maxOpen = opts?.maxOpen ?? 100;
+        this.ttlMs = opts?.ttlMs ?? 60000;
+        this.clock = opts?.clock ?? Date.now;
+    }
+    /** Begin a span. Last-write-wins on a duplicate name; over-cap starts are dropped + counted. */
+    start(name) {
+        if (!name)
+            return;
+        this.expire();
+        if (!this.open.has(name) && this.open.size >= this.maxOpen) {
+            this.dropped++;
+            return;
+        }
+        this.open.set(name, this.clock());
+    }
+    /** End a span → its elapsed ms, or null if it was never started (or already expired). */
+    stop(name) {
+        this.expire();
+        const startedAt = this.open.get(name);
+        if (startedAt == null)
+            return null;
+        this.open.delete(name);
+        return { name, durationMs: this.clock() - startedAt };
+    }
+    /** Drop spans that have been open past the TTL (a forgotten stopTrace must not leak). */
+    expire() {
+        const t = this.clock();
+        for (const [name, startedAt] of this.open) {
+            if (t - startedAt > this.ttlMs) {
+                this.open.delete(name);
+                this.dropped++;
+            }
+        }
+    }
+    /** Read + reset the dropped counter. */
+    takeDropped() {
+        const d = this.dropped;
+        this.dropped = 0;
+        return d;
+    }
+    clear() {
+        this.open.clear();
+        this.dropped = 0;
+    }
+}
+//# sourceMappingURL=traces.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"traces.js","sourceRoot":"","sources":["../../../src/features/performance/traces.ts"],"names":[],"mappings":"AAoBA,MAAM,OAAO,aAAa;IAOxB,YAAY,IAAmB;QAHd,SAAI,GAAG,IAAI,GAAG,EAAkB,CAAC,CAAC,mBAAmB;QAC9D,YAAO,GAAG,CAAC,CAAC;QAGlB,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,GAAG,CAAC;QACpC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,KAAK,CAAC;QAClC,IAAI,CAAC,KAAK,GAAG,IAAI,EAAE,KAAK,IAAI,IAAI,CAAC,GAAG,CAAC;IACvC,CAAC;IAED,gGAAgG;IAChG,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,IAAI;YAAE,OAAO;QAClB,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YAC3D,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO;QACT,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;IACpC,CAAC;IAED,yFAAyF;IACzF,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QACtC,IAAI,SAAS,IAAI,IAAI;YAAE,OAAO,IAAI,CAAC;QACnC,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QACvB,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,CAAC,KAAK,EAAE,GAAG,SAAS,EAAE,CAAC;IACxD,CAAC;IAED,yFAAyF;IACjF,MAAM;QACZ,MAAM,CAAC,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;QACvB,KAAK,MAAM,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YAC1C,IAAI,CAAC,GAAG,SAAS,GAAG,IAAI,CAAC,KAAK,EAAE,CAAC;gBAC/B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBACvB,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,CAAC;QACH,CAAC;IACH,CAAC;IAED,wCAAwC;IACxC,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC;QAClB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;IACnB,CAAC;CACF"}

package/dist/features/profiler/ProfilerFeature.d.ts

@@ -0,0 +1,28 @@
+/**
+ * F-PROF — JS Self-Profiling (flame graphs). Captures a sampled call-stack trace via the W3C JS
+ * Self-Profiling API (`window.Profiler`) and ships it as a perf item (metric:'js_profile', the trace in
+ * metadata) — reusing the existing PerformanceMetric lane, so NO backend migration.
+ *
+ * OPT-IN (default off): profiling has a CPU cost, and `window.Profiler` only exists when the host page
+ * is served with `Document-Policy: js-profiling` — so this is an advanced, explicitly-enabled feature
+ * that degrades to a graceful no-op everywhere else. Short windows on demand (manual start/stop or
+ * around a known-slow operation). Zero third-party deps.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export declare class ProfilerFeature implements IFeature {
+    readonly name = "profiler";
+    private ctx;
+    private active;
+    private profiler?;
+    private startedAt;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    /** Whether the JS Self-Profiling API is usable (host must send Document-Policy: js-profiling). */
+    available(): boolean;
+    /** Begin a profiling window. Returns false if unavailable or one is already running. */
+    start(sampleIntervalMs?: number): boolean;
+    /** Stop the window and ship the trace as a js_profile perf item. Returns false if none running. */
+    stop(): Promise<boolean>;
+    teardown(): void;
+}
+//# sourceMappingURL=ProfilerFeature.d.ts.map

package/dist/features/profiler/ProfilerFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProfilerFeature.d.ts","sourceRoot":"","sources":["../../../src/features/profiler/ProfilerFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAkBxE,qBAAa,eAAgB,YAAW,QAAQ;IAC9C,QAAQ,CAAC,IAAI,cAAc;IAC3B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,QAAQ,CAAC,CAAa;IAC9B,OAAO,CAAC,SAAS,CAAK;IAEtB,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAKhC,kGAAkG;IAClG,SAAS,IAAI,OAAO;IAIpB,wFAAwF;IACxF,KAAK,CAAC,gBAAgB,SAAK,GAAG,OAAO;IAarC,mGAAmG;IAC7F,IAAI,IAAI,OAAO,CAAC,OAAO,CAAC;IAuB9B,QAAQ,IAAI,IAAI;CAYjB"}

package/dist/features/profiler/ProfilerFeature.js

@@ -0,0 +1,82 @@
+import { uuid, now } from '../../core/index.js';
+function currentScreen() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class ProfilerFeature {
+    constructor() {
+        this.name = 'profiler';
+        this.ctx = null;
+        this.active = false;
+        this.startedAt = 0;
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        this.active = true;
+    }
+    /** Whether the JS Self-Profiling API is usable (host must send Document-Policy: js-profiling). */
+    available() {
+        return typeof window !== 'undefined' && typeof window.Profiler === 'function';
+    }
+    /** Begin a profiling window. Returns false if unavailable or one is already running. */
+    start(sampleIntervalMs = 10) {
+        if (!this.active || this.profiler || !this.available())
+            return false;
+        try {
+            const Ctor = window.Profiler;
+            this.profiler = new Ctor({ sampleInterval: sampleIntervalMs, maxBufferSize: 10000 });
+            this.startedAt = now();
+            return true;
+        }
+        catch {
+            this.profiler = undefined;
+            return false;
+        }
+    }
+    /** Stop the window and ship the trace as a js_profile perf item. Returns false if none running. */
+    async stop() {
+        if (!this.profiler)
+            return false;
+        const p = this.profiler;
+        this.profiler = undefined;
+        try {
+            const trace = (await p.stop());
+            const durationMs = Math.round(now() - this.startedAt);
+            this.ctx?.emit({
+                kind: 'performance',
+                metric: 'js_profile',
+                value: Array.isArray(trace.samples) ? trace.samples.length : 0,
+                duration: durationMs,
+                screenName: currentScreen(),
+                metadata: { profile: trace, format: 'w3c-js-self-profiling' },
+                clientId: `prof_${uuid()}`,
+                timestamp: now(),
+            });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+    teardown() {
+        // Best-effort stop without shipping (consent revoke / SDK stop).
+        if (this.profiler) {
+            try {
+                void this.profiler.stop();
+            }
+            catch {
+                /* ignore */
+            }
+            this.profiler = undefined;
+        }
+        this.active = false;
+    }
+}
+//# sourceMappingURL=ProfilerFeature.js.map

package/dist/features/profiler/ProfilerFeature.js.map

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

package/dist/features/profiler/capture.d.ts

@@ -0,0 +1,8 @@
+export declare function flameAvailable(): boolean;
+/** Capture one JS Self-Profiling window of ~durationMs. Returns the raw W3C trace + sample count, or
+ *  null when unavailable/failed. Short windows only, so `samplebufferfull` rotation isn't needed. */
+export declare function captureFlameWindow(durationMs: number, sampleIntervalMs?: number): Promise<{
+    profile: unknown;
+    samples: number;
+} | null>;
+//# sourceMappingURL=capture.d.ts.map

package/dist/features/profiler/capture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.d.ts","sourceRoot":"","sources":["../../../src/features/profiler/capture.ts"],"names":[],"mappings":"AAaA,wBAAgB,cAAc,IAAI,OAAO,CAExC;AAED;qGACqG;AACrG,wBAAsB,kBAAkB,CACtC,UAAU,EAAE,MAAM,EAClB,gBAAgB,SAAK,GACpB,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAAC,CAYvD"}

package/dist/features/profiler/capture.js

@@ -0,0 +1,21 @@
+export function flameAvailable() {
+    return typeof window !== 'undefined' && typeof window.Profiler === 'function';
+}
+/** Capture one JS Self-Profiling window of ~durationMs. Returns the raw W3C trace + sample count, or
+ *  null when unavailable/failed. Short windows only, so `samplebufferfull` rotation isn't needed. */
+export async function captureFlameWindow(durationMs, sampleIntervalMs = 10) {
+    if (!flameAvailable())
+        return null;
+    try {
+        const Ctor = window.Profiler;
+        const profiler = new Ctor({ sampleInterval: sampleIntervalMs, maxBufferSize: 10000 });
+        await new Promise((resolve) => setTimeout(resolve, durationMs));
+        const trace = await profiler.stop();
+        const samples = Array.isArray(trace?.samples) ? trace.samples.length : 0;
+        return { profile: trace, samples };
+    }
+    catch {
+        return null;
+    }
+}
+//# sourceMappingURL=capture.js.map

package/dist/features/profiler/capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"capture.js","sourceRoot":"","sources":["../../../src/features/profiler/capture.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,MAAM,KAAK,WAAW,IAAI,OAAQ,MAA4C,CAAC,QAAQ,KAAK,UAAU,CAAC;AACvH,CAAC;AAED;qGACqG;AACrG,MAAM,CAAC,KAAK,UAAU,kBAAkB,CACtC,UAAkB,EAClB,gBAAgB,GAAG,EAAE;IAErB,IAAI,CAAC,cAAc,EAAE;QAAE,OAAO,IAAI,CAAC;IACnC,IAAI,CAAC;QACH,MAAM,IAAI,GAAI,MAAkD,CAAC,QAAQ,CAAC;QAC1E,MAAM,QAAQ,GAAG,IAAI,IAAI,CAAC,EAAE,cAAc,EAAE,gBAAgB,EAAE,aAAa,EAAE,KAAM,EAAE,CAAC,CAAC;QACvF,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE,CAAC,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,CAAC;QACtE,MAAM,KAAK,GAAG,MAAM,QAAQ,CAAC,IAAI,EAAE,CAAC;QACpC,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAE,KAAiC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAE,KAAgC,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;QAClI,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IACrC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,IAAI,CAAC;IACd,CAAC;AACH,CAAC"}

package/dist/features/push/PushFeature.d.ts

@@ -0,0 +1,120 @@
+/**
+ * F-PUSH — Web Push (VAPID) subscribe + device-token registration. LAZY: the facade dynamic-imports
+ * this module only when the host calls `ScaleBun.enablePush()` from a user gesture, so it stays out of
+ * the core bundle entirely (it is NOT in the FEATURES manifest).
+ *
+ * Flow: feature-detect → request Notification permission (host gesture) → register the host-served
+ * service worker (`/scalebun-push-sw.js`) → fetch the tenant VAPID public key (`/sdk/engage/push-config`)
+ * → `pushManager.subscribe({ userVisibleOnly, applicationServerKey })` → POST the browser
+ * PushSubscription JSON to `/sdk/engage/device-token` (platform:'web', pushProvider:'webpush').
+ *
+ * The differentiator vs OneSignal/Braze: the subscription is registered on the SAME device/session the
+ * recorder is capturing, so a push open is replay-correlated (E6 stamps the coord). Zero third-party:
+ * only ServiceWorker / PushManager / Notification / atob — degrades to a no-op (never throws) when the
+ * browser lacks support or the user denied permission.
+ */
+import type { PushDiagnostics } from './diagnostics.js';
+/** SW contract version this SDK build expects. Bump in lockstep with WZB_SW_VERSION in
+ *  public/scalebun-push-sw.js — push.check() compares them to catch a stale hand-copied worker. */
+export declare const EXPECTED_SW_VERSION = 5;
+/** Default path the host serves the worker at. Shared by enable() and check() so a diagnostic can
+ *  never disagree with what was actually registered. */
+export declare const DEFAULT_SW_URL = "/scalebun-push-sw.js";
+export type { PushPermission, PushState } from './pushState.js';
+export { PUSH_STATE_COPY, resolvePushState } from './pushState.js';
+import { type PushPermission, type PushState } from './pushState.js';
+export interface PushEnableOptions {
+    /** URL the host serves the SDK service worker at (same origin). Default `/scalebun-push-sw.js`. */
+    serviceWorkerUrl?: string;
+    /** Optional SW registration scope (defaults to the SW's directory). */
+    serviceWorkerScope?: string;
+}
+export type PushEnableStatus = 'subscribed' | 'unsupported' | 'denied' | 'not-configured' | 'error';
+export interface PushStatus {
+    supported: boolean;
+    /** The raw browser value. Kept for compatibility; branch on `state` instead. */
+    permission: PushPermission;
+    subscribed: boolean;
+    endpoint: string | null;
+    /** The actionable state — separates blocked/revoked and never-granted/expired. */
+    state: PushState;
+}
+export interface PushDeps {
+    apiBaseUrl: string;
+    clientKey: string;
+    deviceId: string;
+    sdkVersion?: string;
+    log?: (...args: unknown[]) => void;
+}
+type NotificationOpenedCallback = (payload: {
+    data: Record<string, unknown>;
+    action: string | null;
+}) => void;
+export declare class PushFeature {
+    private readonly deps;
+    private reg;
+    private lastEndpoint;
+    /** Remembers where enable() actually registered the worker, so check() diagnoses THAT path. */
+    private swUrl;
+    private readonly openedCbs;
+    private swMessageBound;
+    constructor(deps: PushDeps);
+    private log;
+    /** Current permission without prompting. */
+    permission(): PushPermission;
+    /**
+     * Subscribe this browser to Web Push and register the subscription with the backend. MUST be called
+     * from a user gesture (browsers gate `Notification.requestPermission()`). Idempotent: a repeat call
+     * reuses the existing subscription and re-registers it (cheap upsert). Never throws.
+     */
+    enable(opts?: PushEnableOptions): Promise<PushEnableStatus>;
+    /**
+     * P2 — opt out of Web Push. Unsubscribes this browser AND tells the backend to revoke the token, so
+     * the device stops being addressable immediately instead of lingering until a send eats a 410.
+     *
+     * Order matters: unsubscribe LOCALLY first (the part that must not fail), then revoke server-side.
+     * The revoke is best-effort — if it fails we simply fall back to the old 410-cleanup behaviour, so
+     * this is belt-and-braces rather than a correctness dependency. The return value reflects the local
+     * unsubscribe; a network failure must not tell the host their opt-out didn't work, because locally
+     * it did.
+     */
+    disable(opts?: {
+        revokeServerSide?: boolean;
+    }): Promise<boolean>;
+    /** Tell the backend this device opted out. Best-effort; never throws. */
+    private revokeDeviceToken;
+    /** Subscribe to notification-open events (the SW postMessages the page on click). Returns an unsub. */
+    onNotificationOpened(cb: NotificationOpenedCallback): () => void;
+    /** The current subscription (or null). */
+    getSubscription(): Promise<PushSubscriptionJSON | null>;
+    /**
+     * P1 — full self-diagnosis: HTTPS, API support, worker reachable/registered/current, VAPID set up,
+     * permission, subscription validity (incl. VAPID-rotation detection), and what the SERVER thinks of
+     * this device. Returns a structured, self-describing report — never prompts, never throws.
+     *
+     * The diagnostics module is a SEPARATE dynamic chunk, so hosts that use push but never call check()
+     * do not download it.
+     */
+    check(opts?: {
+        serviceWorkerUrl?: string;
+    }): Promise<PushDiagnostics>;
+    /**
+     * Has this browser EVER held a subscription?
+     *
+     * The one extra fact that makes `revoked` separable from `blocked`, and `expired` from
+     * `never-granted` — `Notification.permission` cannot tell those pairs apart on its own. Stored
+     * under the SDK's own key; a cleared storage degrades to "never", which is the safe direction (an
+     * opt-out reads as a first refusal rather than the reverse).
+     */
+    private static readonly EVER_KEY;
+    private everSubscribed;
+    private markEverSubscribed;
+    /** A synchronous-ish snapshot for a Dev Panel / debugging. */
+    status(): Promise<PushStatus>;
+    private bindSwMessages;
+    private headers;
+    private fetchPushConfig;
+    private registerDeviceToken;
+    private registerDeviceTokenJson;
+}
+//# sourceMappingURL=PushFeature.d.ts.map

package/dist/features/push/PushFeature.d.ts.map

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