@scalebun/web 1.0.0

package/dist/features/webVitals/vitals.d.ts

@@ -0,0 +1,99 @@
+/**
+ * Pure CWV reducers — kept separate from the observer wiring so they're unit-testable without a
+ * browser. v1 uses simple, cheap definitions (documented approximations vs the web-vitals lib).
+ */
+type Entry = PerformanceEntry | Record<string, unknown>;
+/** LCP = the last largest-contentful-paint entry's render/load time. */
+export declare function lcpFrom(entries: ReadonlyArray<Entry>): number;
+/** CLS = running sum of layout-shift values, excluding shifts after recent input.
+ *  @deprecated naïve sum — overstates CLS on long/SPA sessions. Use the session-window reducer below
+ *  ({@link newClsState} + {@link addClsWindowed}) for the real CWV value. Kept for back-compat + tests. */
+export declare function addCls(current: number, entries: ReadonlyArray<Entry>): number;
+/** Session-window CLS state (the real Core Web Vital): the max sum over any window of consecutive
+ *  shifts each within 1 s of the previous and ≤ 5 s total. `max` is the reportable CLS. */
+export interface ClsState {
+    max: number;
+    cur: number;
+    first: number;
+    last: number;
+}
+/** Fresh session-window accumulator (reset per route). */
+export declare function newClsState(): ClsState;
+/**
+ * Fold layout-shift entries into the session-window CLS — the web-vitals algorithm: a shift extends
+ * the current window if it's < 1 s after the last shift and < 5 s after the window's first; otherwise
+ * it opens a new window. CLS = the largest window sum. Excludes shifts after recent input.
+ */
+export declare function addClsWindowed(state: ClsState, entries: ReadonlyArray<Entry>): ClsState;
+/** INP ≈ the worst interaction duration seen (cheap upper bound). */
+export declare function maxInp(current: number, entries: ReadonlyArray<Entry>): number;
+/** Drop query + hash from a URL (may carry tokens/PII). Keep origin + path. */
+export declare function stripUrlQuery(url: string | undefined): string | undefined;
+export interface LcpPhases {
+    ttfb: number;
+    resourceLoadDelay: number;
+    resourceLoadTime: number;
+    elementRenderDelay: number;
+}
+export interface TtfbPhases {
+    /** Time in HTTP redirects before the final document was even requested. */
+    redirect: number;
+    /** Service-worker startup, when one intercepted the navigation. */
+    worker: number;
+    dns: number;
+    tcp: number;
+    /** TLS handshake — part of `tcp` in the timeline, reported separately because it is fixable. */
+    tls: number;
+    /** requestStart → responseStart: the server actually thinking. Usually the whole story. */
+    request: number;
+}
+/**
+ * TTFB phase breakdown — the whole point of P4 for this metric.
+ *
+ * Until now TTFB was emitted as a bare number, so 0% of it carried attribution and the only advice a
+ * rule could give was "look at server response time". That is not a diagnosis. Every phase here comes
+ * from the SAME Navigation Timing entry TTFB itself is read from, so it costs one extra read and no
+ * new observer: a redirect chain, a cold service worker, a slow DNS lookup and a slow server are four
+ * completely different problems that were previously indistinguishable.
+ *
+ * Returns undefined when navigation timing is unavailable. Phases are clamped ≥ 0 and rounded, and
+ * sum to `responseStart` by construction (the marks are consecutive points on one timeline).
+ */
+export declare function ttfbPhases(): TtfbPhases | undefined;
+/**
+ * LCP timing breakdown (A5; web-vitals/attribution model): TTFB → resourceLoadDelay → resourceLoadTime
+ * → elementRenderDelay. Reads navigation + (for image LCP) resource timing. Returns undefined when
+ * timing is unavailable. All phases clamped ≥ 0 and rounded.
+ */
+export declare function lcpPhases(attr: {
+    url?: string;
+    loadTime?: number;
+    renderTime?: number;
+}): LcpPhases | undefined;
+/**
+ * The longest script among Long-Animation-Frame frames overlapping [start, end] — the script most
+ * likely responsible for an interaction's processing delay (A6, INP × LoAF). Undefined if none overlap.
+ */
+/** The script fields carried through the INP × LoAF join. `fn`/`invokerType` are P4 (see below). */
+export interface LoafScriptRef {
+    url: string;
+    dur: number;
+    fn?: string;
+    invokerType?: string;
+}
+export declare function loafScriptFor(loaf: ReadonlyArray<{
+    start: number;
+    end: number;
+    scripts: ReadonlyArray<LoafScriptRef>;
+}>, window: {
+    start: number;
+    end: number;
+}): {
+    url: string;
+    duration: number;
+    fn?: string;
+    invokerType?: string;
+} | undefined;
+export declare function rateVital(metric: string, value: number): 'good' | 'needs-improvement' | 'poor' | 'unknown';
+export {};
+//# sourceMappingURL=vitals.d.ts.map

package/dist/features/webVitals/vitals.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"vitals.d.ts","sourceRoot":"","sources":["../../../src/features/webVitals/vitals.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH,KAAK,KAAK,GAAG,gBAAgB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAExD,wEAAwE;AACxE,wBAAgB,OAAO,CAAC,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAM7D;AAED;;2GAE2G;AAC3G,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAM7E;AAED;2FAC2F;AAC3F,MAAM,WAAW,QAAQ;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,IAAI,QAAQ,CAEtC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,QAAQ,CAevF;AAED,qEAAqE;AACrE,wBAAgB,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,CAAC,KAAK,CAAC,GAAG,MAAM,CAM7E;AAED,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,GAAG,SAAS,CAGzE;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,iBAAiB,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,kBAAkB,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,UAAU;IACzB,2EAA2E;IAC3E,QAAQ,EAAE,MAAM,CAAC;IACjB,mEAAmE;IACnE,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,gGAAgG;IAChG,GAAG,EAAE,MAAM,CAAC;IACZ,2FAA2F;IAC3F,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,IAAI,UAAU,GAAG,SAAS,CAgBnD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE;IAAE,GAAG,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAAC,UAAU,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,GAAG,SAAS,CAyB/G;AAED;;;GAGG;AACH,oGAAoG;AACpG,MAAM,WAAW,aAAa;IAC5B,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,wBAAgB,aAAa,CAC3B,IAAI,EAAE,aAAa,CAAC;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;CAAE,CAAC,EAC1F,MAAM,EAAE;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACrC;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC;IAAC,EAAE,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAclF;AAiBD,wBAAgB,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,mBAAmB,GAAG,MAAM,GAAG,SAAS,CAM1G"}

package/dist/features/webVitals/vitals.js

@@ -0,0 +1,166 @@
+/**
+ * Pure CWV reducers — kept separate from the observer wiring so they're unit-testable without a
+ * browser. v1 uses simple, cheap definitions (documented approximations vs the web-vitals lib).
+ */
+/** LCP = the last largest-contentful-paint entry's render/load time. */
+export function lcpFrom(entries) {
+    const last = entries[entries.length - 1];
+    if (!last)
+        return 0;
+    return last.renderTime || last.loadTime || last.startTime || 0;
+}
+/** CLS = running sum of layout-shift values, excluding shifts after recent input.
+ *  @deprecated naïve sum — overstates CLS on long/SPA sessions. Use the session-window reducer below
+ *  ({@link newClsState} + {@link addClsWindowed}) for the real CWV value. Kept for back-compat + tests. */
+export function addCls(current, entries) {
+    let v = current;
+    for (const e of entries) {
+        if (!e.hadRecentInput && typeof e.value === 'number')
+            v += e.value;
+    }
+    return v;
+}
+/** Fresh session-window accumulator (reset per route). */
+export function newClsState() {
+    return { max: 0, cur: 0, first: 0, last: 0 };
+}
+/**
+ * Fold layout-shift entries into the session-window CLS — the web-vitals algorithm: a shift extends
+ * the current window if it's < 1 s after the last shift and < 5 s after the window's first; otherwise
+ * it opens a new window. CLS = the largest window sum. Excludes shifts after recent input.
+ */
+export function addClsWindowed(state, entries) {
+    for (const e of entries) {
+        if (e.hadRecentInput || typeof e.value !== 'number')
+            continue;
+        const t = typeof e.startTime === 'number' ? e.startTime : state.last;
+        if (state.cur > 0 && t - state.last < 1000 && t - state.first < 5000) {
+            state.cur += e.value;
+            state.last = t;
+        }
+        else {
+            state.cur = e.value;
+            state.first = t;
+            state.last = t;
+        }
+        if (state.cur > state.max)
+            state.max = state.cur;
+    }
+    return state;
+}
+/** INP ≈ the worst interaction duration seen (cheap upper bound). */
+export function maxInp(current, entries) {
+    let m = current;
+    for (const e of entries) {
+        if (typeof e.duration === 'number' && e.duration > m)
+            m = e.duration;
+    }
+    return m;
+}
+/** Drop query + hash from a URL (may carry tokens/PII). Keep origin + path. */
+export function stripUrlQuery(url) {
+    if (!url)
+        return undefined;
+    return url.replace(/[?#].*$/, '');
+}
+/**
+ * TTFB phase breakdown — the whole point of P4 for this metric.
+ *
+ * Until now TTFB was emitted as a bare number, so 0% of it carried attribution and the only advice a
+ * rule could give was "look at server response time". That is not a diagnosis. Every phase here comes
+ * from the SAME Navigation Timing entry TTFB itself is read from, so it costs one extra read and no
+ * new observer: a redirect chain, a cold service worker, a slow DNS lookup and a slow server are four
+ * completely different problems that were previously indistinguishable.
+ *
+ * Returns undefined when navigation timing is unavailable. Phases are clamped ≥ 0 and rounded, and
+ * sum to `responseStart` by construction (the marks are consecutive points on one timeline).
+ */
+export function ttfbPhases() {
+    if (typeof performance === 'undefined' || typeof performance.getEntriesByType !== 'function')
+        return undefined;
+    const nav = performance.getEntriesByType('navigation')[0];
+    if (!nav || !(nav.responseStart > 0))
+        return undefined;
+    // `seg` semantics, inlined: a zero mark means "did not happen" (no redirect, no worker) or
+    // "not exposed", and both must read as 0 rather than as a negative span.
+    const r = (a, b) => (a > 0 && b >= a ? Math.round(b - a) : 0);
+    return {
+        redirect: r(nav.redirectStart, nav.redirectEnd),
+        // workerStart has no paired end mark; the span to fetchStart is the startup cost.
+        worker: r(nav.workerStart, nav.fetchStart),
+        dns: r(nav.domainLookupStart, nav.domainLookupEnd),
+        tcp: r(nav.connectStart, nav.connectEnd),
+        tls: r(nav.secureConnectionStart, nav.connectEnd),
+        request: r(nav.requestStart, nav.responseStart),
+    };
+}
+/**
+ * LCP timing breakdown (A5; web-vitals/attribution model): TTFB → resourceLoadDelay → resourceLoadTime
+ * → elementRenderDelay. Reads navigation + (for image LCP) resource timing. Returns undefined when
+ * timing is unavailable. All phases clamped ≥ 0 and rounded.
+ */
+export function lcpPhases(attr) {
+    if (typeof performance === 'undefined' || typeof performance.getEntriesByType !== 'function')
+        return undefined;
+    const nav = performance.getEntriesByType('navigation')[0];
+    const ttfb = Math.max(0, nav?.responseStart ?? 0);
+    const renderTime = attr.renderTime ?? attr.loadTime ?? 0;
+    if (renderTime <= 0)
+        return undefined;
+    let lcpRequestStart = ttfb;
+    let lcpResponseEnd = attr.loadTime ?? renderTime;
+    if (attr.url) {
+        const res = performance.getEntriesByName(attr.url)[0];
+        if (res) {
+            lcpRequestStart = Math.max(ttfb, res.requestStart || res.startTime || ttfb);
+            lcpResponseEnd = attr.loadTime || res.responseEnd || lcpResponseEnd;
+        }
+    }
+    const r = (n) => Math.round(Math.max(0, n));
+    return {
+        ttfb: r(ttfb),
+        resourceLoadDelay: r(lcpRequestStart - ttfb),
+        resourceLoadTime: attr.url ? r(lcpResponseEnd - lcpRequestStart) : 0,
+        elementRenderDelay: r(renderTime - (attr.url ? lcpResponseEnd : ttfb)),
+    };
+}
+export function loafScriptFor(loaf, window) {
+    let best;
+    for (const f of loaf) {
+        if (f.end < window.start || f.start > window.end)
+            continue; // no overlap with the interaction
+        for (const sc of f.scripts) {
+            // P4: carry the function name and invoker type through the join. `inp-long-handler` previously
+            // could only name a minified bundle ("a handler in app.js runs for 420 ms"); with these it can
+            // name the function, and distinguish an event listener from a promise continuation — which need
+            // different fixes.
+            if (sc.url && (!best || sc.dur > best.duration))
+                best = { url: sc.url, duration: Math.round(sc.dur), fn: sc.fn, invokerType: sc.invokerType };
+        }
+    }
+    return best;
+}
+/**
+ * Core Web Vitals "good / needs-improvement / poor" thresholds, from web.dev.
+ *
+ * Lives here (not at the call site) so the SDK has ONE definition of what a good LCP is — the same
+ * rating then travels on the `$web_vital` event, and a funnel filtering `rating = 'poor'` means the
+ * same thing as the dashboard's own colouring.
+ */
+const VITAL_THRESHOLDS = {
+    lcp: [2500, 4000],
+    inp: [200, 500],
+    cls: [0.1, 0.25],
+    fcp: [1800, 3000],
+    ttfb: [800, 1800],
+};
+export function rateVital(metric, value) {
+    const t = VITAL_THRESHOLDS[metric];
+    // An unknown metric has no thresholds, and guessing one would be a fabricated verdict.
+    if (!t)
+        return 'unknown';
+    if (value <= t[0])
+        return 'good';
+    return value <= t[1] ? 'needs-improvement' : 'poor';
+}
+//# sourceMappingURL=vitals.js.map

package/dist/features/webVitals/vitals.js.map

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

package/dist/features/webperf/WebPerfFeature.d.ts

@@ -0,0 +1,19 @@
+/**
+ * F-PERFWEB — Web RUM: page-load (Navigation Timing) + FPS (rAF) + LoAF. Maps onto the EXISTING
+ * PerformanceMetric types (screen_load / frame_metrics / js_stall) so the dashboards already read it.
+ * The collector wiring is LAZY-loaded (its work is deferred anyway — load event, 30 s FPS cadence,
+ * buffered LoAF) so it stays out of the core bundle. Raw web APIs only (zero third-party deps).
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export { fpsFromFrames, loafSeverity, navMetric } from './math';
+export declare class WebPerfFeature implements IFeature {
+    readonly name = "webPerf";
+    private ctx;
+    private active;
+    private stop?;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): Promise<void>;
+    private emit;
+    teardown(): void;
+}
+//# sourceMappingURL=WebPerfFeature.d.ts.map

package/dist/features/webperf/WebPerfFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebPerfFeature.d.ts","sourceRoot":"","sources":["../../../src/features/webperf/WebPerfFeature.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAIxE,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAUhE,qBAAa,cAAe,YAAW,QAAQ;IAC7C,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,IAAI,CAAC,CAAa;IAE1B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAQ/C,OAAO,CAAC,IAAI;IAaZ,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/features/webperf/WebPerfFeature.js

@@ -0,0 +1,48 @@
+import { uuid, now } from '../../core';
+// Re-export the pure math (also covered by the unit tests).
+export { fpsFromFrames, loafSeverity, navMetric } from './math';
+function currentScreen() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+export class WebPerfFeature {
+    constructor() {
+        this.name = 'webPerf';
+        this.ctx = null;
+        this.active = false;
+    }
+    get isActive() {
+        return this.active;
+    }
+    async setup(ctx) {
+        this.ctx = ctx;
+        if (typeof window === 'undefined' || typeof performance === 'undefined')
+            return;
+        this.active = true;
+        const { startCollectors } = await import('./collectors');
+        if (this.active)
+            this.stop = startCollectors((metric, value, metadata, duration) => this.emit(metric, value, metadata, duration), () => this.active);
+    }
+    emit(metric, value, metadata, duration) {
+        this.ctx?.emit({
+            kind: 'performance',
+            metric,
+            value,
+            screenName: currentScreen(),
+            ...(duration != null ? { duration } : {}),
+            metadata,
+            clientId: `pw_${uuid()}`,
+            timestamp: now(),
+        });
+    }
+    teardown() {
+        this.active = false;
+        this.stop?.();
+        this.stop = undefined;
+    }
+}
+//# sourceMappingURL=WebPerfFeature.js.map

package/dist/features/webperf/WebPerfFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebPerfFeature.js","sourceRoot":"","sources":["../../../src/features/webperf/WebPerfFeature.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAEvC,4DAA4D;AAC5D,OAAO,EAAE,aAAa,EAAE,YAAY,EAAE,SAAS,EAAE,MAAM,QAAQ,CAAC;AAEhE,SAAS,aAAa;IACpB,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;AAED,MAAM,OAAO,cAAc;IAA3B;QACW,SAAI,GAAG,SAAS,CAAC;QAClB,QAAG,GAA0B,IAAI,CAAC;QAClC,WAAM,GAAG,KAAK,CAAC;IAiCzB,CAAC;IA9BC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,KAAK,CAAC,GAAmB;QAC7B,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,WAAW,KAAK,WAAW;YAAE,OAAO;QAChF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,cAAc,CAAC,CAAC;QACzD,IAAI,IAAI,CAAC,MAAM;YAAE,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACvJ,CAAC;IAEO,IAAI,CAAC,MAAc,EAAE,KAAa,EAAE,QAAiC,EAAE,QAAiB;QAC9F,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC;YACb,IAAI,EAAE,aAAa;YACnB,MAAM;YACN,KAAK;YACL,UAAU,EAAE,aAAa,EAAE;YAC3B,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACzC,QAAQ;YACR,QAAQ,EAAE,MAAM,IAAI,EAAE,EAAE;YACxB,SAAS,EAAE,GAAG,EAAE;SACwB,CAAC,CAAC;IAC9C,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;QACd,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;CACF"}

package/dist/features/webperf/collectors.d.ts

@@ -0,0 +1,3 @@
+export type EmitPerf = (metric: string, value: number, metadata: Record<string, unknown>, duration?: number) => void;
+export declare function startCollectors(emit: EmitPerf, isActive: () => boolean): () => void;
+//# sourceMappingURL=collectors.d.ts.map

package/dist/features/webperf/collectors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"collectors.d.ts","sourceRoot":"","sources":["../../../src/features/webperf/collectors.ts"],"names":[],"mappings":"AAeA,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAUrH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,OAAO,GAAG,MAAM,IAAI,CAkGnF"}

package/dist/features/webperf/collectors.js

@@ -0,0 +1,118 @@
+// Web-perf collectors (page-load / FPS / LoAF) — the LAZY chunk. Loaded by WebPerfFeature.setup so the
+// observer/rAF wiring stays out of the core bundle. Returns a stop() that tears everything down.
+import { fpsFromFrames, loafSeverity, navMetric } from './math';
+const FPS_WINDOW_MS = 5000;
+const FPS_GAP_MS = 25000;
+const LOAF_MIN_MS = 50;
+const MEM_GAP_MS = 30000; // JS-heap sample cadence (Chromium `performance.memory`)
+export function startCollectors(emit, isActive) {
+    let observer;
+    let raf;
+    let fpsTimer;
+    let memTimer;
+    let onLoad;
+    // Sample used JS-heap on a slow cadence → the 'memory' PerformanceMetric the High-Memory KPI counts.
+    // `performance.memory` is Chromium-only + non-standard; degrades to a no-op elsewhere (never throws).
+    const sampleMemory = () => {
+        if (!isActive())
+            return;
+        try {
+            const mem = performance.memory;
+            const used = mem?.usedJSHeapSize;
+            if (typeof used === 'number' && used > 0) {
+                emit('memory', used, { kind: 'js_heap', totalHeap: mem?.totalJSHeapSize, heapLimit: mem?.jsHeapSizeLimit });
+            }
+        }
+        catch {
+            /* performance.memory unavailable */
+        }
+        memTimer = setTimeout(sampleMemory, MEM_GAP_MS);
+    };
+    const capturePageLoad = () => {
+        try {
+            const navs = performance.getEntriesByType?.('navigation');
+            const nav = navs?.[0];
+            if (!nav || nav.loadEventEnd <= 0)
+                return;
+            const m = navMetric(nav);
+            emit('screen_load', m.value, m.metadata, m.value);
+        }
+        catch {
+            /* Navigation Timing unavailable */
+        }
+    };
+    const startLoaf = () => {
+        const PO = window.PerformanceObserver;
+        if (!PO)
+            return;
+        const types = PO.supportedEntryTypes ?? [];
+        const useLoaf = types.includes('long-animation-frame');
+        const useLongtask = !useLoaf && types.includes('longtask');
+        if (!useLoaf && !useLongtask)
+            return;
+        try {
+            const obs = new PO((list) => {
+                for (const e of list.getEntries()) {
+                    const blocking = useLoaf ? (e.blockingDuration ?? 0) : e.duration;
+                    if (blocking < LOAF_MIN_MS)
+                        continue;
+                    emit('js_stall', Math.round(blocking), { kind: useLoaf ? 'loaf' : 'longtask', severity: loafSeverity(blocking) }, Math.round(e.duration));
+                }
+            });
+            obs.observe({ type: useLoaf ? 'long-animation-frame' : 'longtask', buffered: true });
+            observer = obs;
+        }
+        catch {
+            /* observer type unsupported */
+        }
+    };
+    const sampleFps = () => {
+        if (!isActive())
+            return;
+        if ((typeof document !== 'undefined' && document.visibilityState !== 'visible') || typeof requestAnimationFrame === 'undefined') {
+            fpsTimer = setTimeout(sampleFps, FPS_GAP_MS);
+            return;
+        }
+        let frames = 0;
+        const start = performance.now();
+        const tick = () => {
+            if (!isActive())
+                return;
+            frames++;
+            const elapsed = performance.now() - start;
+            if (elapsed < FPS_WINDOW_MS) {
+                raf = requestAnimationFrame(tick);
+            }
+            else {
+                const { fps, dropped } = fpsFromFrames(frames, elapsed);
+                emit('frame_metrics', fps, { totalFrames: frames, dropped, windowMs: Math.round(elapsed) });
+                fpsTimer = setTimeout(sampleFps, FPS_GAP_MS);
+            }
+        };
+        raf = requestAnimationFrame(tick);
+    };
+    if (document.readyState === 'complete') {
+        setTimeout(capturePageLoad, 0);
+    }
+    else {
+        onLoad = () => setTimeout(capturePageLoad, 0);
+        window.addEventListener('load', onLoad, { once: true });
+    }
+    startLoaf();
+    fpsTimer = setTimeout(sampleFps, FPS_GAP_MS);
+    // Only arm the memory sampler when the API exists, so unsupported browsers don't spin an idle timer.
+    if (performance.memory)
+        memTimer = setTimeout(sampleMemory, MEM_GAP_MS);
+    return () => {
+        observer?.disconnect();
+        if (raf != null && typeof cancelAnimationFrame !== 'undefined')
+            cancelAnimationFrame(raf);
+        if (fpsTimer)
+            clearTimeout(fpsTimer);
+        if (memTimer)
+            clearTimeout(memTimer);
+        if (onLoad && typeof window !== 'undefined')
+            window.removeEventListener('load', onLoad);
+    };
+}
+//# sourceMappingURL=collectors.js.map

package/dist/features/webperf/collectors.js.map

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

package/dist/features/webperf/math.d.ts

@@ -0,0 +1,12 @@
+export declare function loafSeverity(blockingMs: number): 'info' | 'warning' | 'critical';
+/** Frames counted over a window → estimated fps (cap 60) + dropped count. */
+export declare function fpsFromFrames(frames: number, windowMs: number): {
+    fps: number;
+    dropped: number;
+};
+/** Page-load metric from a Navigation Timing entry. */
+export declare function navMetric(nav: PerformanceNavigationTiming): {
+    value: number;
+    metadata: Record<string, unknown>;
+};
+//# sourceMappingURL=math.d.ts.map

package/dist/features/webperf/math.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.d.ts","sourceRoot":"","sources":["../../../src/features/webperf/math.ts"],"names":[],"mappings":"AAEA,wBAAgB,YAAY,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,GAAG,UAAU,CAEhF;AAED,6EAA6E;AAC7E,wBAAgB,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAKhG;AAED,uDAAuD;AACvD,wBAAgB,SAAS,CAAC,GAAG,EAAE,2BAA2B,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,CAWhH"}

package/dist/features/webperf/math.js

@@ -0,0 +1,26 @@
+// Pure web-perf math — shared by the (lazy) collectors and the unit tests.
+export function loafSeverity(blockingMs) {
+    return blockingMs >= 200 ? 'critical' : blockingMs >= 100 ? 'warning' : 'info';
+}
+/** Frames counted over a window → estimated fps (cap 60) + dropped count. */
+export function fpsFromFrames(frames, windowMs) {
+    if (windowMs <= 0)
+        return { fps: 0, dropped: 0 };
+    const fps = Math.min(60, Math.round((frames / windowMs) * 1000));
+    const expected = Math.round((windowMs / 1000) * 60);
+    return { fps, dropped: Math.max(0, expected - frames) };
+}
+/** Page-load metric from a Navigation Timing entry. */
+export function navMetric(nav) {
+    const load = Math.round(nav.loadEventEnd || nav.duration);
+    return {
+        value: load,
+        metadata: {
+            kind: 'page_load',
+            ttfb: Math.round(nav.responseStart),
+            dcl: Math.round(nav.domContentLoadedEventEnd),
+            navType: nav.type,
+        },
+    };
+}
+//# sourceMappingURL=math.js.map

package/dist/features/webperf/math.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"math.js","sourceRoot":"","sources":["../../../src/features/webperf/math.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,MAAM,UAAU,YAAY,CAAC,UAAkB;IAC7C,OAAO,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,IAAI,GAAG,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC;AACjF,CAAC;AAED,6EAA6E;AAC7E,MAAM,UAAU,aAAa,CAAC,MAAc,EAAE,QAAgB;IAC5D,IAAI,QAAQ,IAAI,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,EAAE,CAAC;IACjD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,MAAM,GAAG,QAAQ,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IACjE,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,QAAQ,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;IACpD,OAAO,EAAE,GAAG,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAC;AAC1D,CAAC;AAED,uDAAuD;AACvD,MAAM,UAAU,SAAS,CAAC,GAAgC;IACxD,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,YAAY,IAAI,GAAG,CAAC,QAAQ,CAAC,CAAC;IAC1D,OAAO;QACL,KAAK,EAAE,IAAI;QACX,QAAQ,EAAE;YACR,IAAI,EAAE,WAAW;YACjB,IAAI,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,aAAa,CAAC;YACnC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,wBAAwB,CAAC;YAC7C,OAAO,EAAE,GAAG,CAAC,IAAI;SAClB;KACF,CAAC;AACJ,CAAC"}

package/dist/inapp.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Subpath entry for `@scalebun/web/inapp` — the In-App Messaging 2.0 public API. Kept separate from
+ * the size-gated `index.ts` so none of the IAM engine loads into the eager core bundle.
+ */
+export * from './features/inapp';
+//# sourceMappingURL=inapp.d.ts.map

package/dist/inapp.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inapp.d.ts","sourceRoot":"","sources":["../src/inapp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC"}

package/dist/inapp.js

@@ -0,0 +1,6 @@
+/**
+ * Subpath entry for `@scalebun/web/inapp` — the In-App Messaging 2.0 public API. Kept separate from
+ * the size-gated `index.ts` so none of the IAM engine loads into the eager core bundle.
+ */
+export * from './features/inapp';
+//# sourceMappingURL=inapp.js.map

package/dist/inapp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"inapp.js","sourceRoot":"","sources":["../src/inapp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,cAAc,kBAAkB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,31 @@
+/**
+ * @scalebun/web — Public entry point.
+ *
+ * The ONLY module consumers import from. Mirrors the RN SDK's single public surface.
+ *
+ *   import ScaleBun from '@scalebun/web';
+ *   await ScaleBun.init({ clientKey: 'pk_xxx', apiBaseUrl: 'https://api.scalebun.com/api/v1' });
+ *
+ * 🚧 Scaffold: the facade is stubbed; capture features are not implemented yet.
+ */
+export { ScaleBun as default, ScaleBun } from './public/ScaleBunFacade';
+export type { ScaleBunInitConfig, ScaleBunFeatures, ScaleBunUser, PrivacyConfig, } from '@scalebun/sdk-contracts';
+/**
+ * The gamified in-app contract, so a host can type its `onInAppGameRequest` handler — and share one
+ * implementation with the React Native SDK, where these types are identical.
+ *
+ * TYPES ONLY: `export type` erases at build time, so this adds nothing to the bundle.
+ */
+export type { InAppGameRequest, InAppGameResult, InAppGameOutcome, InAppGameAction, InAppGameVariantKey, InAppGameRequestHandler, } from './features/engage/gameTypes';
+/**
+ * Inbox contracts, so a host can render the message list in its OWN design system.
+ *
+ * ⚠️ These were unreachable from the package root, which quietly forced every headless integration
+ * to be untyped — the one path the inbox is explicitly built for ("UI is opt-in; hosts that render
+ * their own never pay for the widget"). A headless-first feature whose types are private is
+ * headless-first in name only.
+ *
+ * TYPES ONLY — `export type` erases at build time, so this costs zero bytes.
+ */
+export type { InboxMessage, InboxController, InboxState, InboxCta, InboxQueryOptions, InboxPage, InboxMessageState, InboxSyncStatus, InboxMountOptions, InboxLabels, InboxLayout, } from './features/inbox/types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAGxE,YAAY,EACV,kBAAkB,EAClB,gBAAgB,EAChB,YAAY,EACZ,aAAa,GACd,MAAM,yBAAyB,CAAC;AAEjC;;;;;GAKG;AACH,YAAY,EACV,gBAAgB,EAChB,eAAe,EACf,gBAAgB,EAChB,eAAe,EACf,mBAAmB,EACnB,uBAAuB,GACxB,MAAM,6BAA6B,CAAC;AAErC;;;;;;;;;GASG;AACH,YAAY,EACV,YAAY,EACZ,eAAe,EACf,UAAU,EACV,QAAQ,EACR,iBAAiB,EACjB,SAAS,EACT,iBAAiB,EACjB,eAAe,EACf,iBAAiB,EACjB,WAAW,EACX,WAAW,GACZ,MAAM,wBAAwB,CAAC"}

package/dist/index.js

@@ -0,0 +1,12 @@
+/**
+ * @scalebun/web — Public entry point.
+ *
+ * The ONLY module consumers import from. Mirrors the RN SDK's single public surface.
+ *
+ *   import ScaleBun from '@scalebun/web';
+ *   await ScaleBun.init({ clientKey: 'pk_xxx', apiBaseUrl: 'https://api.scalebun.com/api/v1' });
+ *
+ * 🚧 Scaffold: the facade is stubbed; capture features are not implemented yet.
+ */
+export { ScaleBun as default, ScaleBun } from './public/ScaleBunFacade';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,QAAQ,IAAI,OAAO,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC"}

package/dist/integrations/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * integrations/ — framework router hooks + glue consumed by the adapter packages
+ * (@scalebun/web-react, /vue, /next, …). Auto route/page-name detection lives here.
+ * 🚧 SCAFFOLD: not implemented yet.
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/integrations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/integrations/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,CAAC"}

package/dist/integrations/index.js

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