@scalebun-release/web 2.2.2

package/dist/features/console/serialize.js

@@ -0,0 +1,99 @@
+/**
+ * Safe serialization of console arguments → one human-readable string.
+ *
+ * console.* takes `...args: unknown[]` (strings, objects, Errors, DOM nodes, circular graphs).
+ * We must never throw and never serialize an unbounded graph, so every arg is rendered with a
+ * `seen` guard (circular → "[Circular]"), a depth cap, a breadth cap, and a total length cap.
+ * This is the heart of the console feature — kept pure + dependency-free so it's unit-testable.
+ */
+const DEFAULTS = {
+    maxDepth: 4,
+    maxBreadth: 50,
+    maxLength: 8 * 1024,
+};
+/** Render a single value to a compact string, circular- and depth-safe. */
+function renderValue(value, depth, seen, opts) {
+    if (value === null)
+        return 'null';
+    if (value === undefined)
+        return 'undefined';
+    const t = typeof value;
+    if (t === 'string')
+        return value;
+    if (t === 'number' || t === 'boolean' || t === 'bigint')
+        return String(value);
+    if (t === 'symbol')
+        return value.toString();
+    if (t === 'function') {
+        const name = value.name;
+        return `[Function${name ? `: ${name}` : ''}]`;
+    }
+    // From here on `value` is an object.
+    const obj = value;
+    if (seen.has(obj))
+        return '[Circular]';
+    // Errors — show name + message (stack rides separately via metadata when relevant).
+    if (value instanceof Error) {
+        return `${value.name}: ${value.message}`;
+    }
+    if (depth >= opts.maxDepth) {
+        return Array.isArray(value) ? '[Array]' : '[Object]';
+    }
+    seen.add(obj);
+    try {
+        if (Array.isArray(value)) {
+            const shown = value.slice(0, opts.maxBreadth).map((v) => renderValue(v, depth + 1, seen, opts));
+            const extra = value.length > opts.maxBreadth ? `, …(+${value.length - opts.maxBreadth} more)` : '';
+            return `[${shown.join(', ')}${extra}]`;
+        }
+        // Map / Set get a friendly summary rather than "{}".
+        if (value instanceof Map)
+            return `Map(${value.size})`;
+        if (value instanceof Set)
+            return `Set(${value.size})`;
+        // DOM-ish nodes (jsdom + browser) — avoid walking the whole tree.
+        const nodeName = value.nodeName;
+        if (typeof nodeName === 'string') {
+            const id = value.id;
+            return `<${nodeName.toLowerCase()}${id ? ` #${String(id)}` : ''}>`;
+        }
+        const keys = Object.keys(value);
+        const shownKeys = keys.slice(0, opts.maxBreadth);
+        const parts = shownKeys.map((k) => {
+            const rendered = renderValue(value[k], depth + 1, seen, opts);
+            return `${k}: ${rendered}`;
+        });
+        const extra = keys.length > opts.maxBreadth ? `, …(+${keys.length - opts.maxBreadth} more)` : '';
+        return `{${parts.join(', ')}${extra}}`;
+    }
+    finally {
+        // Allow the same object to appear again in a sibling branch (only blocks true cycles).
+        seen.delete(obj);
+    }
+}
+/**
+ * Serialize console args into a single message string. Strings join with spaces (console-like);
+ * the result is length-capped. Never throws — any unexpected failure degrades to a placeholder.
+ */
+export function safeSerialize(args, options) {
+    const opts = { ...DEFAULTS, ...options };
+    let out;
+    try {
+        out = args.map((a) => renderValue(a, 0, new WeakSet(), opts)).join(' ');
+    }
+    catch {
+        out = '[unserializable console arguments]';
+    }
+    if (out.length > opts.maxLength)
+        out = out.slice(0, opts.maxLength) + '…(truncated)';
+    return out;
+}
+/** Extract a short stack from an Error arg, if any (for metadata on warn/error logs). */
+export function firstErrorStack(args) {
+    for (const a of args) {
+        if (a instanceof Error && a.stack)
+            return a.stack.slice(0, 4 * 1024);
+    }
+    return undefined;
+}
+//# sourceMappingURL=serialize.js.map

package/dist/features/console/serialize.js.map

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

package/dist/features/console/throttle.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Noise control for console capture. A `console.log` in a render loop floods exactly like an error
+ * loop, so we mirror F-ERR's anti-flood approach (errors/dedup.ts): a hard per-window rate cap that
+ * counts what it drops (no silent caps). The one difference: it's LEVEL-AWARE — `warn`/`error` are
+ * the debugging-valuable lines and are ALWAYS kept; only chatty `info`/`debug` get sampled + capped.
+ */
+import type { LogLevel } from './normalize.js';
+export interface LogThrottleOptions {
+    /** Hard cap on sampled (info/debug) logs accepted per `capWindowMs`. */
+    capCount?: number;
+    capWindowMs?: number;
+}
+export declare class LogThrottle {
+    private readonly capCount;
+    private readonly capWindowMs;
+    private recent;
+    private dropped;
+    constructor(opts?: LogThrottleOptions);
+    /**
+     * True if this log should be emitted. `warn`/`error` always pass; `info`/`debug` are subject to
+     * the rolling rate cap. Drops are counted (ride along on the next emitted item).
+     */
+    accept(level: LogLevel): boolean;
+    /** Read + reset the dropped counter (rides along on the next emitted item). */
+    takeDropped(): number;
+}
+//# sourceMappingURL=throttle.d.ts.map

package/dist/features/console/throttle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.d.ts","sourceRoot":"","sources":["../../../src/features/console/throttle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAE5C,MAAM,WAAW,kBAAkB;IACjC,wEAAwE;IACxE,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,WAAW;IACtB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAS;IACrC,OAAO,CAAC,MAAM,CAAgB;IAC9B,OAAO,CAAC,OAAO,CAAK;gBAER,IAAI,CAAC,EAAE,kBAAkB;IAKrC;;;OAGG;IACH,MAAM,CAAC,KAAK,EAAE,QAAQ,GAAG,OAAO;IAahC,+EAA+E;IAC/E,WAAW,IAAI,MAAM;CAKtB"}

package/dist/features/console/throttle.js

@@ -0,0 +1,37 @@
+/**
+ * Noise control for console capture. A `console.log` in a render loop floods exactly like an error
+ * loop, so we mirror F-ERR's anti-flood approach (errors/dedup.ts): a hard per-window rate cap that
+ * counts what it drops (no silent caps). The one difference: it's LEVEL-AWARE — `warn`/`error` are
+ * the debugging-valuable lines and are ALWAYS kept; only chatty `info`/`debug` get sampled + capped.
+ */
+export class LogThrottle {
+    constructor(opts) {
+        this.recent = [];
+        this.dropped = 0;
+        this.capCount = opts?.capCount ?? 100;
+        this.capWindowMs = opts?.capWindowMs ?? 10000;
+    }
+    /**
+     * True if this log should be emitted. `warn`/`error` always pass; `info`/`debug` are subject to
+     * the rolling rate cap. Drops are counted (ride along on the next emitted item).
+     */
+    accept(level) {
+        if (level === 'warn' || level === 'error')
+            return true;
+        const t = Date.now();
+        this.recent = this.recent.filter((ts) => t - ts < this.capWindowMs);
+        if (this.recent.length >= this.capCount) {
+            this.dropped++;
+            return false;
+        }
+        this.recent.push(t);
+        return true;
+    }
+    /** Read + reset the dropped counter (rides along on the next emitted item). */
+    takeDropped() {
+        const d = this.dropped;
+        this.dropped = 0;
+        return d;
+    }
+}
+//# sourceMappingURL=throttle.js.map

package/dist/features/console/throttle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"throttle.js","sourceRoot":"","sources":["../../../src/features/console/throttle.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAUH,MAAM,OAAO,WAAW;IAMtB,YAAY,IAAyB;QAH7B,WAAM,GAAa,EAAE,CAAC;QACtB,YAAO,GAAG,CAAC,CAAC;QAGlB,IAAI,CAAC,QAAQ,GAAG,IAAI,EAAE,QAAQ,IAAI,GAAG,CAAC;QACtC,IAAI,CAAC,WAAW,GAAG,IAAI,EAAE,WAAW,IAAI,KAAK,CAAC;IAChD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,KAAe;QACpB,IAAI,KAAK,KAAK,MAAM,IAAI,KAAK,KAAK,OAAO;YAAE,OAAO,IAAI,CAAC;QAEvD,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACrB,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,CAAC;QACpE,IAAI,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACf,OAAO,KAAK,CAAC;QACf,CAAC;QACD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,+EAA+E;IAC/E,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;CACF"}

package/dist/features/crash/CrashFeature.d.ts

@@ -0,0 +1,46 @@
+/**
+ * F-CRASH — native-style crash detection for the web. Two complementary signals:
+ *
+ *  1. ReportingObserver — browser-generated `crash` (OOM/unresponsive) + `intervention` reports that
+ *     never surface via window.onerror. Emitted as contract `error` items (crash → type:'crash').
+ *  2. Session-liveness recovery — a per-tab marker (see liveness.ts) that, on the next load, detects a
+ *     prior session that died without a graceful `pagehide` (tab crash / OOM kill / forced close) and
+ *     emits a `type:'crash'` error referencing the dead session. This is the web analog of a native
+ *     crash, which is otherwise invisible (the page can't report its own hard death).
+ *
+ * Cheap + always-on. Deprecation reports are intentionally skipped (high-volume, low-signal).
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export declare class CrashFeature implements IFeature {
+    readonly name = "crash";
+    private ctx;
+    private active;
+    private tabId;
+    private observer?;
+    private heartbeat?;
+    private onHide?;
+    private onShow?;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    private installReportingObserver;
+    private handleReport;
+    private installLiveness;
+    /**
+     * Report the death of the PRIOR session — on that session, not on this one.
+     *
+     * The crash is discovered by the next load, so the only pipeline in existence belongs to a
+     * session that is perfectly healthy. Emitting normally filed the crash there: verified against
+     * real rows, 4 of 4 recovered crashes landed on a brand-new session at t≈0 (three of them a
+     * fraction of a second BEFORE that session's own recorded start), while the session that actually
+     * died stayed clean. Every first open after a hard kill therefore came up already crashed.
+     *
+     * `emitFor` files it against `prior.sessionId` instead. Without it (older bootstrap, mock ctx) the
+     * item still has to go somewhere, so it falls back to the live session as `handled` — recorded and
+     * searchable, but not a crash the current session did not have.
+     */
+    private emitRecoveredCrash;
+    private buildError;
+    private emitError;
+    teardown(): void;
+}
+//# sourceMappingURL=CrashFeature.d.ts.map

package/dist/features/crash/CrashFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CrashFeature.d.ts","sourceRoot":"","sources":["../../../src/features/crash/CrashFeature.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAkCxE,qBAAa,YAAa,YAAW,QAAQ;IAC3C,QAAQ,CAAC,IAAI,WAAW;IACxB,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,KAAK,CAAM;IACnB,OAAO,CAAC,QAAQ,CAAC,CAA0C;IAC3D,OAAO,CAAC,SAAS,CAAC,CAAiC;IACnD,OAAO,CAAC,MAAM,CAAC,CAAa;IAC5B,OAAO,CAAC,MAAM,CAAC,CAAa;IAE5B,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAUhC,OAAO,CAAC,wBAAwB;IAgBhC,OAAO,CAAC,YAAY;IAqBpB,OAAO,CAAC,eAAe;IA8BvB;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,kBAAkB;IA0B1B,OAAO,CAAC,UAAU;IAuBlB,OAAO,CAAC,SAAS;IAIjB,QAAQ,IAAI,IAAI;CAmBjB"}

package/dist/features/crash/CrashFeature.js

@@ -0,0 +1,173 @@
+import { uuid, now, scrubText } from '../../core/index.js';
+import { getTabId, readRecord, writeRecord, markEnded, touch, cleanupStale, } from './liveness.js';
+const HEARTBEAT_MS = 15000;
+export class CrashFeature {
+    constructor() {
+        this.name = 'crash';
+        this.ctx = null;
+        this.active = false;
+        this.tabId = '';
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        if (typeof window === 'undefined')
+            return;
+        this.installReportingObserver();
+        this.installLiveness(ctx.sessionId ?? `sess_${uuid()}`);
+        this.active = true;
+    }
+    // ── ReportingObserver ───────────────────────────────────────────────────────
+    installReportingObserver() {
+        const Ctor = globalThis.ReportingObserver;
+        if (!Ctor)
+            return;
+        try {
+            this.observer = new Ctor((reports) => {
+                for (const r of reports)
+                    this.handleReport(r);
+            }, { buffered: true });
+            this.observer.observe();
+        }
+        catch {
+            /* ReportingObserver unsupported / blocked — liveness recovery still works */
+        }
+    }
+    handleReport(r) {
+        if (r.type === 'deprecation')
+            return; // noisy + low-signal
+        const body = r.body ?? {};
+        const isCrash = r.type === 'crash';
+        const message = isCrash
+            ? `Browser crash report: ${body.reason ?? 'unknown'}`
+            : (body.message ?? `${r.type} report`);
+        const stack = body.sourceFile
+            ? `${body.sourceFile}:${body.lineNumber ?? 0}:${body.columnNumber ?? 0}`
+            : undefined;
+        this.emitError({
+            type: isCrash ? 'crash' : 'handled',
+            message,
+            stack,
+            fingerprint: `report:${r.type}:${body.reason ?? body.id ?? message}`.slice(0, 180),
+            metadata: { reportType: r.type, reason: body.reason, anticipated: body.anticipated, url: r.url },
+        });
+        if (isCrash)
+            this.ctx?.signal('error');
+    }
+    // ── Session-liveness recovery ─────────────────────────────────────────────────
+    installLiveness(sessionId) {
+        this.tabId = getTabId();
+        // Recover: a prior record for THIS tab that never ended = abnormal termination.
+        const prior = readRecord(this.tabId);
+        if (prior && !prior.ended && prior.sessionId !== sessionId) {
+            this.emitRecoveredCrash(prior);
+        }
+        // Stamp this session as live.
+        const t = now();
+        writeRecord(this.tabId, {
+            v: 1,
+            sessionId,
+            startedAt: t,
+            lastActive: t,
+            screen: currentScreen() ?? '',
+            ended: false,
+        });
+        cleanupStale(this.tabId, t);
+        // pagehide = the only reliable "graceful shutdown" hook → mark ended. A hard kill skips it,
+        // which is exactly the crash we detect next load. pageshow (bfcache restore) re-arms.
+        this.onHide = () => markEnded(this.tabId, true);
+        this.onShow = () => markEnded(this.tabId, false);
+        window.addEventListener('pagehide', this.onHide);
+        window.addEventListener('pageshow', this.onShow);
+        this.heartbeat = setInterval(() => touch(this.tabId), HEARTBEAT_MS);
+    }
+    /**
+     * Report the death of the PRIOR session — on that session, not on this one.
+     *
+     * The crash is discovered by the next load, so the only pipeline in existence belongs to a
+     * session that is perfectly healthy. Emitting normally filed the crash there: verified against
+     * real rows, 4 of 4 recovered crashes landed on a brand-new session at t≈0 (three of them a
+     * fraction of a second BEFORE that session's own recorded start), while the session that actually
+     * died stayed clean. Every first open after a hard kill therefore came up already crashed.
+     *
+     * `emitFor` files it against `prior.sessionId` instead. Without it (older bootstrap, mock ctx) the
+     * item still has to go somewhere, so it falls back to the live session as `handled` — recorded and
+     * searchable, but not a crash the current session did not have.
+     */
+    emitRecoveredCrash(prior) {
+        const durationMs = Math.max(0, prior.lastActive - prior.startedAt);
+        const item = this.buildError({
+            type: 'crash',
+            message: 'Session ended abnormally (tab crash, OOM, or forced close — no graceful shutdown)',
+            fingerprint: 'session-abnormal-termination',
+            screenName: prior.screen || undefined,
+            metadata: {
+                reason: 'unfinalized-session',
+                priorSessionId: prior.sessionId,
+                durationMs,
+                lastScreen: prior.screen,
+            },
+            // The death happened while the prior session was alive, not now. Stamping "now" is what put
+            // these errors a few hundred ms before the host session's own start.
+            timestamp: prior.lastActive,
+        });
+        if (this.ctx?.emitFor) {
+            this.ctx.emitFor(prior.sessionId, item);
+            return;
+        }
+        this.ctx?.emit({ ...item, type: 'handled' });
+        this.ctx?.signal('error');
+    }
+    buildError(p) {
+        return {
+            kind: 'error',
+            type: p.type,
+            message: scrubText(p.message),
+            stack: p.stack,
+            source: 'js',
+            fingerprint: p.fingerprint,
+            screenName: p.screenName ?? currentScreen(),
+            clientId: `crash_${uuid()}`,
+            timestamp: p.timestamp ?? now(),
+            ...(p.metadata ? { metadata: p.metadata } : {}),
+        };
+    }
+    emitError(p) {
+        this.ctx?.emit(this.buildError(p));
+    }
+    teardown() {
+        if (this.observer) {
+            try {
+                this.observer.disconnect();
+            }
+            catch {
+                /* ignore */
+            }
+            this.observer = undefined;
+        }
+        if (this.heartbeat)
+            clearInterval(this.heartbeat);
+        this.heartbeat = undefined;
+        if (typeof window !== 'undefined') {
+            if (this.onHide)
+                window.removeEventListener('pagehide', this.onHide);
+            if (this.onShow)
+                window.removeEventListener('pageshow', this.onShow);
+        }
+        // Teardown is a graceful stop (consent revoke / SDK stop) → not a crash.
+        if (this.tabId)
+            markEnded(this.tabId, true);
+        this.active = false;
+    }
+}
+function currentScreen() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=CrashFeature.js.map

package/dist/features/crash/CrashFeature.js.map

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

package/dist/features/crash/liveness.d.ts

@@ -0,0 +1,30 @@
+/**
+ * Per-tab session-liveness marker for native-style crash detection on the web.
+ *
+ * Idea: a page that dies abnormally (renderer crash, OOM kill, forced close, power loss) never runs
+ * its `pagehide` shutdown, so it never marks the session `ended`. On the NEXT load in that tab we read
+ * the prior marker — if it's still `ended:false`, the previous session terminated abnormally → a
+ * crash-class signal (the web analog of a native crash).
+ *
+ * Multi-tab safety: the marker is keyed by a per-TAB id held in sessionStorage (survives reloads +
+ * crash-restore within the tab, distinct per tab), so two open tabs never see each other's live marker
+ * as a crash. localStorage holds the record so it survives the renderer dying.
+ */
+export interface LivenessRecord {
+    v: 1;
+    sessionId: string;
+    startedAt: number;
+    lastActive: number;
+    screen: string;
+    ended: boolean;
+}
+/** Stable id for THIS tab (sessionStorage → survives reload + crash-restore, unique per tab). */
+export declare function getTabId(): string;
+export declare function readRecord(tabId: string): LivenessRecord | null;
+export declare function writeRecord(tabId: string, rec: LivenessRecord): void;
+/** Mark the current tab's record ended (graceful shutdown) without a full rewrite when possible. */
+export declare function markEnded(tabId: string, ended: boolean): void;
+export declare function touch(tabId: string): void;
+/** Remove other tabs' clearly-abandoned records (old + ended) so localStorage doesn't accrete. */
+export declare function cleanupStale(exceptTabId: string, now: number): void;
+//# sourceMappingURL=liveness.d.ts.map

package/dist/features/crash/liveness.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"liveness.d.ts","sourceRoot":"","sources":["../../../src/features/crash/liveness.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,WAAW,cAAc;IAC7B,CAAC,EAAE,CAAC,CAAC;IACL,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,OAAO,CAAC;CAChB;AAgCD,iGAAiG;AACjG,wBAAgB,QAAQ,IAAI,MAAM,CAYjC;AAID,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAW/D;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAQpE;AAED,oGAAoG;AACpG,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAM7D;AAED,wBAAgB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI,CAKzC;AAED,kGAAkG;AAClG,wBAAgB,YAAY,CAAC,WAAW,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,IAAI,CAmBnE"}

package/dist/features/crash/liveness.js

@@ -0,0 +1,131 @@
+/**
+ * Per-tab session-liveness marker for native-style crash detection on the web.
+ *
+ * Idea: a page that dies abnormally (renderer crash, OOM kill, forced close, power loss) never runs
+ * its `pagehide` shutdown, so it never marks the session `ended`. On the NEXT load in that tab we read
+ * the prior marker — if it's still `ended:false`, the previous session terminated abnormally → a
+ * crash-class signal (the web analog of a native crash).
+ *
+ * Multi-tab safety: the marker is keyed by a per-TAB id held in sessionStorage (survives reloads +
+ * crash-restore within the tab, distinct per tab), so two open tabs never see each other's live marker
+ * as a crash. localStorage holds the record so it survives the renderer dying.
+ */
+const TAB_KEY = 'scalebun:tab';
+const REC_PREFIX = 'scalebun:live:';
+/** Other-tab records older than this are abandoned junk → cleaned up (not reported, to avoid FPs). */
+const STALE_MS = 24 * 60 * 60 * 1000;
+function ls() {
+    try {
+        return typeof localStorage !== 'undefined' ? localStorage : null;
+    }
+    catch {
+        return null;
+    }
+}
+function ss() {
+    try {
+        return typeof sessionStorage !== 'undefined' ? sessionStorage : null;
+    }
+    catch {
+        return null;
+    }
+}
+function rand() {
+    try {
+        const c = globalThis.crypto;
+        if (c && typeof c.randomUUID === 'function')
+            return c.randomUUID();
+    }
+    catch {
+        /* fall through */
+    }
+    return `${Date.now().toString(36)}-${Math.floor(Math.random() * 1e9).toString(36)}`;
+}
+/** Stable id for THIS tab (sessionStorage → survives reload + crash-restore, unique per tab). */
+export function getTabId() {
+    const store = ss();
+    if (!store)
+        return `mem-${rand()}`; // no sessionStorage → degrade to a per-load id (no recovery)
+    try {
+        const existing = store.getItem(TAB_KEY);
+        if (existing)
+            return existing;
+        const id = rand();
+        store.setItem(TAB_KEY, id);
+        return id;
+    }
+    catch {
+        return `mem-${rand()}`;
+    }
+}
+const keyFor = (tabId) => `${REC_PREFIX}${tabId}`;
+export function readRecord(tabId) {
+    const store = ls();
+    if (!store)
+        return null;
+    try {
+        const raw = store.getItem(keyFor(tabId));
+        if (!raw)
+            return null;
+        const r = JSON.parse(raw);
+        return r && r.v === 1 && typeof r.sessionId === 'string' ? r : null;
+    }
+    catch {
+        return null;
+    }
+}
+export function writeRecord(tabId, rec) {
+    const store = ls();
+    if (!store)
+        return;
+    try {
+        store.setItem(keyFor(tabId), JSON.stringify(rec));
+    }
+    catch {
+        /* quota / disabled — liveness is best-effort */
+    }
+}
+/** Mark the current tab's record ended (graceful shutdown) without a full rewrite when possible. */
+export function markEnded(tabId, ended) {
+    const rec = readRecord(tabId);
+    if (!rec)
+        return;
+    rec.ended = ended;
+    rec.lastActive = Date.now();
+    writeRecord(tabId, rec);
+}
+export function touch(tabId) {
+    const rec = readRecord(tabId);
+    if (!rec)
+        return;
+    rec.lastActive = Date.now();
+    writeRecord(tabId, rec);
+}
+/** Remove other tabs' clearly-abandoned records (old + ended) so localStorage doesn't accrete. */
+export function cleanupStale(exceptTabId, now) {
+    const store = ls();
+    if (!store)
+        return;
+    try {
+        const doomed = [];
+        for (let i = 0; i < store.length; i++) {
+            const k = store.key(i);
+            if (!k || !k.startsWith(REC_PREFIX) || k === keyFor(exceptTabId))
+                continue;
+            try {
+                const r = JSON.parse(store.getItem(k) || '{}');
+                if (r && (r.ended || now - (r.lastActive || 0) > STALE_MS))
+                    doomed.push(k);
+            }
+            catch {
+                doomed.push(k); // unparseable → remove
+            }
+        }
+        for (const k of doomed)
+            store.removeItem(k);
+    }
+    catch {
+        /* best-effort */
+    }
+}
+//# sourceMappingURL=liveness.js.map

package/dist/features/crash/liveness.js.map

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

package/dist/features/engage/EngageFeature.d.ts

@@ -0,0 +1,67 @@
+/**
+ * F-ENG — Engage (surveys / NPS / in-app). Core shell: fetch the active campaign config from
+ * /sdk/engage/config and, only if a campaign exists, LAZY-load the runtime (trigger engine + throttle +
+ * DOM widget) so the heavy bits stay out of core. Triggers are fed from existing producers — capture
+ * signals (rage/dead/error/network_error/slow_screen), navigation, track()/purchase custom events, and
+ * session lifecycle — no parallel pipeline.
+ *
+ * E1 — cold-start buffer: triggers that arrive while the first config fetch is still in flight (and
+ * before the runtime lazy-loads) are buffered in a bounded TTL ring and replayed once the runtime arms,
+ * honouring each campaign's REMAINING delay — so a "show on session #1 / app_open" campaign isn't lost.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+import type { LifecycleKind } from './triggerEngine.js';
+export declare class EngageFeature implements IFeature {
+    readonly name = "engage";
+    private ctx;
+    private active;
+    private transport?;
+    private runtime?;
+    private unsub?;
+    private onPop?;
+    private screen;
+    private buffer;
+    private bufferOpen;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): Promise<void>;
+    /** Fetch engage config; lazy-load + (re)arm the runtime when campaigns are present, then drain the
+     *  cold-start buffer. The heavy normalizer + matcher stay in the lazy chunk — core does only a shallow
+     *  presence check (an empty config is the common case and must cost ~nothing). */
+    refresh(): Promise<void>;
+    /** Lazy-load + construct the runtime on first need (config load, or a programmatic
+     *  emitRatingEvent/submit). Returns undefined only before setup / without a transport. */
+    private ensureRuntime;
+    /** Programmatic submit for a host's own survey UI → 'success'|'error' (transport-retried). */
+    submit(surveyId: string, result: import('./types.js').SurveyResult): Promise<'success' | 'error'>;
+    /** Emit one rating-funnel event (works even without a served campaign). */
+    emitRatingEvent(type: import('./types.js').RatingEventType, input?: import('./types.js').RatingEventInput): void;
+    /** Dev/QA — clear on-device engage state (throttle/session/test-seen) so campaigns show again. */
+    resetInAppState(): Promise<void>;
+    onScreenView(screen: string): void;
+    /**
+     * Identity changed (the host called identify()) — re-fetch config.
+     *
+     * The boot fetch is normally anonymous and the backend serves NO segment-targeted campaign to an
+     * anonymous request (it fails closed), so without this a visitor who logs in mid-session would see
+     * none of their targeted surveys or messages until a full page load.
+     */
+    onIdentify(): void;
+    onCustomEvent(name: string): void;
+    onSignal(reason: string): void;
+    onLifecycle(kind: LifecycleKind, count?: number): void;
+    private feed;
+    private dispatch;
+    /** Replay the cold-start buffer into the armed runtime, honouring each entry's remaining delay. */
+    private drain;
+    private closeBuffer;
+    /**
+     * Running session number, persisted across launches; bumped exactly once per new session.
+     *
+     * Also reports WHETHER this load opened a new session, which is what gates the lifecycle triggers
+     * above — a reload of an existing session is not a session start. An empty session id means the
+     * caller can't tell us (test mocks), so it reports new rather than suppressing.
+     */
+    private bumpSessionCount;
+    teardown(): void;
+}
+//# sourceMappingURL=EngageFeature.d.ts.map