@scalebun/web 1.0.0

package/dist/features/index.d.ts

@@ -0,0 +1,21 @@
+/**
+ * features/ — pluggable capture features (each implements IFeature from @scalebun/sdk-contracts
+ * and registers with the FeatureRegistry). Mirrors RN react-native/src/features.
+ *
+ * 🚧 NOT IMPLEMENTED YET (intentionally — scaffold only). Planned folders, mapped to mobile:
+ *
+ *   errors/      JS errors: window.onerror + unhandledrejection + manual capture   (RN: crash/)
+ *   network/     fetch + XHR + sendBeacon interceptors, denylist-by-default        (RN: network/)
+ *   webVitals/   LCP / INP / CLS / FCP / TTFB — in the core, no web-vitals dep      (RN: performance/)
+ *   performance/ custom traces, resource timing, LoAF attribution                  (RN: performance/)
+ *   replay/      DOM snapshot + mutations (renderer:'dom'), capture-on-signal       (RN: replay/)
+ *   session/     SessionManager + boundary (timeout / pagehide)                     (RN: session/)
+ *   journey/     route/page tracking, click / rage-click / dead-click              (RN: journey/)
+ *   navigation/  Navigation API + history fallback (SPA route names)               (RN: navigation/)
+ *   bugreport/   embeddable widget + auto-context report                           (RN: bugreport/)
+ *   ratings/     in-app rating / survey response                                   (RN: rating)
+ *
+ * See ../../../../WEB-SDK-PLAN.md §5 (parity) and §7 (sequenced work).
+ */
+export {};
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/features/index.js

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

package/dist/features/index.js.map

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

package/dist/features/journey/InteractionTracker.d.ts

@@ -0,0 +1,34 @@
+export interface InteractionTrackerOptions {
+    deadMs?: number;
+    rageWindowMs?: number;
+    rageRadius?: number;
+    rageMin?: number;
+    /** Mask the label text (`privacy.maskEventText`). Default false — the real label is sent. */
+    maskText?: boolean;
+}
+type EmitAction = (name: string, data: Record<string, unknown>, label?: string) => void;
+export declare class InteractionTracker {
+    private readonly emit;
+    /** Raise a capture signal ('rage'|'dead') onto the bus — arms friction-triggered features
+     *  (replay capture-on-signal, struggle-triggered surveys/in-app). Optional (tests omit it). */
+    private readonly signal?;
+    private readonly rage;
+    private readonly dead;
+    private readonly maskText;
+    private onClickFn?;
+    constructor(emit: EmitAction, opts?: InteractionTrackerOptions, 
+    /** Raise a capture signal ('rage'|'dead') onto the bus — arms friction-triggered features
+     *  (replay capture-on-signal, struggle-triggered surveys/in-app). Optional (tests omit it). */
+    signal?: ((reason: string) => void) | undefined);
+    start(): void;
+    stop(): void;
+}
+/**
+ * A human-ish label: tag + short text, e.g. `button: Buy now`.
+ *
+ * `maskText` (from `privacy.maskEventText`) replaces every non-whitespace character with `*`, keeping
+ * the word shape. Exported so the unit tests can drive both branches directly.
+ */
+export declare function describe(el: Element, maskText?: boolean): string;
+export {};
+//# sourceMappingURL=InteractionTracker.d.ts.map

package/dist/features/journey/InteractionTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InteractionTracker.d.ts","sourceRoot":"","sources":["../../../src/features/journey/InteractionTracker.ts"],"names":[],"mappings":"AAaA,MAAM,WAAW,yBAAyB;IACxC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,6FAA6F;IAC7F,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,KAAK,UAAU,GAAG,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,KAAK,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;AAExF,qBAAa,kBAAkB;IAO3B,OAAO,CAAC,QAAQ,CAAC,IAAI;IAErB;mGAC+F;IAC/F,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC;IAV1B,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAe;IACpC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAmB;IACxC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAU;IACnC,OAAO,CAAC,SAAS,CAAC,CAAqB;gBAGpB,IAAI,EAAE,UAAU,EACjC,IAAI,GAAE,yBAA8B;IACpC;mGAC+F;IAC9E,MAAM,CAAC,GAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,aAAA;IAOpD,KAAK,IAAI,IAAI;IAgCb,IAAI,IAAI,IAAI;CAMb;AAsCD;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,OAAO,EAAE,QAAQ,UAAQ,GAAG,MAAM,CAK9D"}

package/dist/features/journey/InteractionTracker.js

@@ -0,0 +1,125 @@
+/**
+ * Clicks → USER_ACTION analytics events, with rage + dead-click flags (the friction signals) and a
+ * target label/selector. Always-on + cheap; does NOT depend on replay.
+ *
+ * LABEL TEXT IS NO LONGER MASKED BY DEFAULT (`privacy.maskEventText`, default false). It used to be
+ * unconditional — every non-whitespace character replaced with `*` — which is why the Events explorer
+ * rendered `button: *** ***`. Because rows there group by label, masking preserved the SHAPE of the
+ * text and destroyed its identity: two different buttons whose text happened to be the same length
+ * merged into a single row, so per-element click analytics could not exist. The selector was always
+ * unmasked, so this never was the SDK's privacy boundary anyway.
+ */
+import { RageDetector, DeadClickWatcher } from './friction';
+export class InteractionTracker {
+    constructor(emit, opts = {}, 
+    /** Raise a capture signal ('rage'|'dead') onto the bus — arms friction-triggered features
+     *  (replay capture-on-signal, struggle-triggered surveys/in-app). Optional (tests omit it). */
+    signal) {
+        this.emit = emit;
+        this.signal = signal;
+        this.rage = new RageDetector(opts.rageWindowMs ?? 800, opts.rageRadius ?? 30, opts.rageMin ?? 3);
+        this.dead = new DeadClickWatcher(opts.deadMs ?? 700);
+        this.maskText = opts.maskText ?? false;
+    }
+    start() {
+        if (typeof document === 'undefined')
+            return;
+        this.dead.observe(document);
+        this.onClickFn = (e) => {
+            const me = e;
+            const t = Date.now();
+            const target = e.target;
+            if (!target || !target.tagName)
+                return;
+            const label = describe(target, this.maskText);
+            const selector = selectorOf(target);
+            // Viewport + scroll at click time → the dashboard normalizes click positions across screen
+            // sizes (heatmaps). Compact keys keep the event small.
+            const p = pointer(me);
+            // H7 — element anchoring + component identity. The target's bounding rect lets the dashboard re-project
+            // a hotspot onto the element at any viewport (responsive), and `component` (opt-in data-scalebun-component,
+            // walked up ancestors) groups clicks BY reusable component across every route it appears on.
+            const el = anchor(target);
+            const rage = this.rage.push(me.clientX, me.clientY, t);
+            const data = { action: 'click', ...p, selector, ...el };
+            if (rage)
+                data.rage = true;
+            this.emit('USER_ACTION', data, label);
+            if (rage)
+                this.signal?.('rage'); // RageDetector coalesces → one signal per cluster
+            this.dead.onClick(t, () => {
+                this.emit('USER_ACTION', { action: 'click', ...p, selector, ...el, dead: true }, label);
+                this.signal?.('dead'); // resolved async (no follow-up DOM change within deadMs)
+            });
+        };
+        document.addEventListener('click', this.onClickFn, true);
+    }
+    stop() {
+        this.dead.disconnect();
+        if (this.onClickFn && typeof document !== 'undefined') {
+            document.removeEventListener('click', this.onClickFn, true);
+        }
+    }
+}
+/** Click position + viewport + scroll + document height, so the dashboard can place clicks in
+ *  viewport-% or DOCUMENT space across different screen sizes. `x`/`y` are viewport-relative (clientX/Y).
+ *
+ *  `dh` is the whole document's height. Without it a click's page position is unrecoverable — `y + sy`
+ *  is a pixel offset with no denominator — so heatmaps of a scrollable page had to fold the entire
+ *  document onto one screenful, stacking below-fold clicks on top of the hero. Read unguarded because
+ *  `pointer` only runs from the click handler, which `start()` never installs without a document; one
+ *  layout read per click, next to the target rect the handler already measures. Width is deliberately
+ *  NOT sent: horizontal scrolling is vanishingly rare, and the viewport width the dashboard already
+ *  has is the right horizontal denominator for a responsive layout. */
+function pointer(me) {
+    const w = typeof window !== 'undefined' ? window : undefined;
+    return {
+        x: me.clientX,
+        y: me.clientY,
+        vw: w?.innerWidth ?? 0,
+        vh: w?.innerHeight ?? 0,
+        sx: w ? Math.round(w.scrollX) : 0,
+        sy: w ? Math.round(w.scrollY) : 0,
+        dh: document.documentElement.scrollHeight,
+        // H5 — devicePixelRatio: sharper backdrops + a device-density bucketing dimension for heatmaps.
+        dpr: w?.devicePixelRatio ?? 1,
+    };
+}
+/** H7 — element bounding rect (for responsive re-anchoring) + opt-in component name (for component heatmaps). */
+function anchor(el) {
+    const r = el.getBoundingClientRect();
+    const out = { ex: r.x | 0, ey: r.y | 0, ew: r.width | 0, eh: r.height | 0 };
+    const comp = el.closest('[data-scalebun-component]')?.getAttribute('data-scalebun-component');
+    if (comp)
+        out.component = comp;
+    return out;
+}
+const mask = (s) => s.replace(/\S/g, '*');
+/**
+ * A human-ish label: tag + short text, e.g. `button: Buy now`.
+ *
+ * `maskText` (from `privacy.maskEventText`) replaces every non-whitespace character with `*`, keeping
+ * the word shape. Exported so the unit tests can drive both branches directly.
+ */
+export function describe(el, maskText = false) {
+    const tag = el.tagName.toLowerCase();
+    const text = (el.textContent || '').trim().slice(0, 40);
+    if (!text)
+        return tag;
+    return `${tag}: ${maskText ? mask(text) : text}`;
+}
+/** A compact CSS-ish selector (tag#id.class) — structure only, no text/PII. */
+function selectorOf(el) {
+    let s = el.tagName.toLowerCase();
+    if (el.id)
+        s += `#${el.id}`;
+    const cls = (el.getAttribute('class') || '')
+        .trim()
+        .split(/\s+/)
+        .filter(Boolean)
+        .slice(0, 2);
+    if (cls.length)
+        s += '.' + cls.join('.');
+    return s;
+}
+//# sourceMappingURL=InteractionTracker.js.map

package/dist/features/journey/InteractionTracker.js.map

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

package/dist/features/journey/JourneyFeature.d.ts

@@ -0,0 +1,18 @@
+/**
+ * F-JRN — journey + navigation. Emits SCREEN_VIEW (route changes) and USER_ACTION (clicks + rage/dead
+ * friction) as `kind:'event'` items → the existing funnels / flows / friction analytics. Always-on,
+ * decoupled from replay.
+ */
+import type { IFeature, FeatureContext } from '@scalebun/sdk-contracts';
+export declare class JourneyFeature implements IFeature {
+    readonly name = "journey";
+    private ctx;
+    private active;
+    private nav?;
+    private interactions?;
+    get isActive(): boolean;
+    setup(ctx: FeatureContext): void;
+    private emit;
+    teardown(): void;
+}
+//# sourceMappingURL=JourneyFeature.d.ts.map

package/dist/features/journey/JourneyFeature.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"JourneyFeature.d.ts","sourceRoot":"","sources":["../../../src/features/journey/JourneyFeature.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAMxE,qBAAa,cAAe,YAAW,QAAQ;IAC7C,QAAQ,CAAC,IAAI,aAAa;IAC1B,OAAO,CAAC,GAAG,CAA+B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,GAAG,CAAC,CAAoB;IAChC,OAAO,CAAC,YAAY,CAAC,CAAqB;IAE1C,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAED,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,IAAI;IAmBhC,OAAO,CAAC,IAAI;IAkBZ,QAAQ,IAAI,IAAI;CAKjB"}

package/dist/features/journey/JourneyFeature.js

@@ -0,0 +1,57 @@
+import { uuid, now, getReplayCoord } from '../../core';
+import { NavigationTracker } from './NavigationTracker';
+import { InteractionTracker } from './InteractionTracker';
+export class JourneyFeature {
+    constructor() {
+        this.name = 'journey';
+        this.ctx = null;
+        this.active = false;
+    }
+    get isActive() {
+        return this.active;
+    }
+    setup(ctx) {
+        this.ctx = ctx;
+        if (typeof window === 'undefined' || typeof document === 'undefined')
+            return;
+        this.nav = new NavigationTracker((from, to) => this.emit('SCREEN_VIEW', { from, to }, undefined, to));
+        this.interactions = new InteractionTracker((name, data, label) => this.emit(name, data, label, currentPath()), 
+        // Label masking is opt-IN (`privacy.maskEventText`). Off by default so USER_ACTION rows carry the
+        // real element text and group per element instead of collapsing by text shape.
+        { maskText: ctx.maskEventText === true }, (reason) => this.ctx?.signal(reason));
+        this.nav.start();
+        this.interactions.start();
+        this.active = true;
+    }
+    emit(name, props, label, screenName) {
+        // Heatmaps 2.0 (H5) — stamp WHERE the replay was when this happened, so a heatmap hotspot (or friction
+        // click) deep-links to the EXACT replay frame, not just the session. Cheap (a getter + spread); only
+        // present when replay is producing frames (undefined otherwise). Closes the journey↔replay gap that
+        // left the richest heatmap signal (clicks + rage/dead) without a frame coordinate.
+        const replay = getReplayCoord();
+        const item = {
+            kind: 'event',
+            name,
+            props: replay ? { ...props, replayCoord: replay } : props,
+            label,
+            screenName: screenName ?? currentPath(),
+            eventId: `evt_${uuid()}`,
+            timestamp: now(),
+        };
+        this.ctx?.emit(item);
+    }
+    teardown() {
+        this.nav?.stop();
+        this.interactions?.stop();
+        this.active = false;
+    }
+}
+function currentPath() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+//# sourceMappingURL=JourneyFeature.js.map

package/dist/features/journey/JourneyFeature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"JourneyFeature.js","sourceRoot":"","sources":["../../../src/features/journey/JourneyFeature.ts"],"names":[],"mappings":"AAOA,OAAO,EAAE,IAAI,EAAE,GAAG,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,OAAO,cAAc;IAA3B;QACW,SAAI,GAAG,SAAS,CAAC;QAClB,QAAG,GAA0B,IAAI,CAAC;QAClC,WAAM,GAAG,KAAK,CAAC;IAkDzB,CAAC;IA9CC,IAAI,QAAQ;QACV,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;IAED,KAAK,CAAC,GAAmB;QACvB,IAAI,CAAC,GAAG,GAAG,GAAG,CAAC;QACf,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,OAAO,QAAQ,KAAK,WAAW;YAAE,OAAO;QAE7E,IAAI,CAAC,GAAG,GAAG,IAAI,iBAAiB,CAAC,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAC5C,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,CAAC,CACtD,CAAC;QACF,IAAI,CAAC,YAAY,GAAG,IAAI,kBAAkB,CACxC,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAC;QAClE,kGAAkG;QAClG,+EAA+E;QAC/E,EAAE,QAAQ,EAAE,GAAG,CAAC,aAAa,KAAK,IAAI,EAAE,EACxC,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CACrC,CAAC;QACF,IAAI,CAAC,GAAG,CAAC,KAAK,EAAE,CAAC;QACjB,IAAI,CAAC,YAAY,CAAC,KAAK,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;IACrB,CAAC;IAEO,IAAI,CAAC,IAAY,EAAE,KAA8B,EAAE,KAAc,EAAE,UAAmB;QAC5F,uGAAuG;QACvG,qGAAqG;QACrG,oGAAoG;QACpG,mFAAmF;QACnF,MAAM,MAAM,GAAG,cAAc,EAAE,CAAC;QAChC,MAAM,IAAI,GAAG;YACX,IAAI,EAAE,OAAO;YACb,IAAI;YACJ,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,KAAK;YACzD,KAAK;YACL,UAAU,EAAE,UAAU,IAAI,WAAW,EAAE;YACvC,OAAO,EAAE,OAAO,IAAI,EAAE,EAAE;YACxB,SAAS,EAAE,GAAG,EAAE;SACJ,CAAC;QACf,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IACvB,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;QACjB,IAAI,CAAC,YAAY,EAAE,IAAI,EAAE,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;IACtB,CAAC;CACF;AAED,SAAS,WAAW;IAClB,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"}

package/dist/features/journey/NavigationTracker.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Tracks route changes → one SCREEN_VIEW per navigation. Navigation API (Baseline 2026) + a
+ * history.pushState/replaceState patch fallback (Safari/older) + initial page-view + bfcache pageshow.
+ * Guards prerendering (don't log a page the user never sees) and dedups identical consecutive routes.
+ */
+export declare class NavigationTracker {
+    private readonly onScreen;
+    private last;
+    private cleanup;
+    constructor(onScreen: (from: string, to: string) => void);
+    start(): void;
+    private begin;
+    private check;
+    stop(): void;
+}
+//# sourceMappingURL=NavigationTracker.d.ts.map

package/dist/features/journey/NavigationTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"NavigationTracker.d.ts","sourceRoot":"","sources":["../../../src/features/journey/NavigationTracker.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,qBAAa,iBAAiB;IAIhB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAHrC,OAAO,CAAC,IAAI,CAAM;IAClB,OAAO,CAAC,OAAO,CAAyB;gBAEX,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,KAAK,IAAI;IAEzE,KAAK,IAAI,IAAI;IAYb,OAAO,CAAC,KAAK;IA2Cb,OAAO,CAAC,KAAK;IAQb,IAAI,IAAI,IAAI;CAIb"}

package/dist/features/journey/NavigationTracker.js

@@ -0,0 +1,92 @@
+/**
+ * Tracks route changes → one SCREEN_VIEW per navigation. Navigation API (Baseline 2026) + a
+ * history.pushState/replaceState patch fallback (Safari/older) + initial page-view + bfcache pageshow.
+ * Guards prerendering (don't log a page the user never sees) and dedups identical consecutive routes.
+ */
+export class NavigationTracker {
+    constructor(onScreen) {
+        this.onScreen = onScreen;
+        this.last = '';
+        this.cleanup = [];
+    }
+    start() {
+        if (typeof window === 'undefined')
+            return;
+        // Speculation-Rules / prerender trap: wait until the page is actually shown.
+        if (typeof document !== 'undefined' && document.prerendering) {
+            const onShow = () => this.begin();
+            document.addEventListener('prerenderingchange', onShow, { once: true });
+            this.cleanup.push(() => document.removeEventListener('prerenderingchange', onShow));
+            return;
+        }
+        this.begin();
+    }
+    begin() {
+        this.last = path();
+        this.onScreen('', this.last); // initial page view
+        const nav = window.navigation;
+        if (nav && typeof nav.addEventListener === 'function') {
+            const onNav = (e) => {
+                const dest = e.destination?.url;
+                this.check(dest ? safePath(dest) : path());
+            };
+            nav.addEventListener('navigate', onNav);
+            this.cleanup.push(() => nav.removeEventListener('navigate', onNav));
+        }
+        // history patch fallback (SPA routers that don't trigger the Navigation API).
+        const h = history;
+        const origPush = h.pushState;
+        const origReplace = h.replaceState;
+        const check = () => this.check();
+        h.pushState = function (...args) {
+            const r = origPush.apply(this, args);
+            check();
+            return r;
+        };
+        h.replaceState = function (...args) {
+            const r = origReplace.apply(this, args);
+            check();
+            return r;
+        };
+        this.cleanup.push(() => {
+            h.pushState = origPush;
+            h.replaceState = origReplace;
+        });
+        const onPop = () => this.check();
+        window.addEventListener('popstate', onPop);
+        window.addEventListener('pageshow', onPop);
+        this.cleanup.push(() => {
+            window.removeEventListener('popstate', onPop);
+            window.removeEventListener('pageshow', onPop);
+        });
+    }
+    check(to = path()) {
+        if (to && to !== this.last) {
+            const from = this.last;
+            this.last = to;
+            this.onScreen(from, to);
+        }
+    }
+    stop() {
+        for (const c of this.cleanup)
+            c();
+        this.cleanup = [];
+    }
+}
+function path() {
+    try {
+        return typeof location !== 'undefined' ? location.pathname : '';
+    }
+    catch {
+        return '';
+    }
+}
+function safePath(url) {
+    try {
+        return new URL(url).pathname;
+    }
+    catch {
+        return path();
+    }
+}
+//# sourceMappingURL=NavigationTracker.js.map

package/dist/features/journey/NavigationTracker.js.map

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

package/dist/features/journey/friction.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Shared friction primitives — rage-click clustering + dead-click detection. Used by F-JRN (and
+ * adoptable by the replay interaction recorder later). Kept dependency-free so it's trivially
+ * testable. Dead-click uses a LIGHTWEIGHT mutation-flag observer (a boolean "did anything change?",
+ * no serialization) so friction works with replay OFF.
+ */
+/** Rage = ≥`min` clicks clustered within `windowMs` and `radius` px. `push` returns the rage verdict. */
+export declare class RageDetector {
+    private readonly windowMs;
+    private readonly radius;
+    private readonly min;
+    private history;
+    constructor(windowMs?: number, radius?: number, min?: number);
+    push(x: number, y: number, t: number): boolean;
+}
+/** Fires a callback when a click had NO DOM change and NO navigation within `deadMs`. */
+export declare class DeadClickWatcher {
+    private readonly deadMs;
+    private lastChangeT;
+    private observer;
+    private timers;
+    private startHref;
+    constructor(deadMs?: number);
+    observe(target: Node): void;
+    /** Call on each click. `onDead` runs later iff the click produced no DOM change + no navigation. */
+    onClick(at: number, onDead: () => void): void;
+    disconnect(): void;
+}
+//# sourceMappingURL=friction.d.ts.map

package/dist/features/journey/friction.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"friction.d.ts","sourceRoot":"","sources":["../../../src/features/journey/friction.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,yGAAyG;AACzG,qBAAa,YAAY;IAGrB,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;IACvB,OAAO,CAAC,QAAQ,CAAC,GAAG;IAJtB,OAAO,CAAC,OAAO,CAAkD;gBAE9C,QAAQ,SAAM,EACd,MAAM,SAAK,EACX,GAAG,SAAI;IAG1B,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;CAM/C;AAED,yFAAyF;AACzF,qBAAa,gBAAgB;IAMf,OAAO,CAAC,QAAQ,CAAC,MAAM;IALnC,OAAO,CAAC,WAAW,CAAK;IACxB,OAAO,CAAC,QAAQ,CAAiC;IACjD,OAAO,CAAC,MAAM,CAA4C;IAC1D,OAAO,CAAC,SAAS,CAAM;gBAEM,MAAM,SAAM;IAEzC,OAAO,CAAC,MAAM,EAAE,IAAI,GAAG,IAAI;IAS3B,oGAAoG;IACpG,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,IAAI,GAAG,IAAI;IAQ7C,UAAU,IAAI,IAAI;CAMnB"}

package/dist/features/journey/friction.js

@@ -0,0 +1,65 @@
+/**
+ * Shared friction primitives — rage-click clustering + dead-click detection. Used by F-JRN (and
+ * adoptable by the replay interaction recorder later). Kept dependency-free so it's trivially
+ * testable. Dead-click uses a LIGHTWEIGHT mutation-flag observer (a boolean "did anything change?",
+ * no serialization) so friction works with replay OFF.
+ */
+/** Rage = ≥`min` clicks clustered within `windowMs` and `radius` px. `push` returns the rage verdict. */
+export class RageDetector {
+    constructor(windowMs = 800, radius = 30, min = 3) {
+        this.windowMs = windowMs;
+        this.radius = radius;
+        this.min = min;
+        this.history = [];
+    }
+    push(x, y, t) {
+        this.history = this.history.filter((c) => t - c.t < this.windowMs);
+        const near = this.history.filter((c) => Math.hypot(c.x - x, c.y - y) <= this.radius);
+        this.history.push({ x, y, t });
+        return near.length + 1 >= this.min;
+    }
+}
+/** Fires a callback when a click had NO DOM change and NO navigation within `deadMs`. */
+export class DeadClickWatcher {
+    constructor(deadMs = 700) {
+        this.deadMs = deadMs;
+        this.lastChangeT = 0;
+        this.observer = null;
+        this.timers = new Set();
+        this.startHref = '';
+    }
+    observe(target) {
+        if (typeof MutationObserver === 'undefined')
+            return;
+        this.startHref = href();
+        this.observer = new MutationObserver(() => {
+            this.lastChangeT = Date.now();
+        });
+        this.observer.observe(target, { subtree: true, childList: true, attributes: true, characterData: true });
+    }
+    /** Call on each click. `onDead` runs later iff the click produced no DOM change + no navigation. */
+    onClick(at, onDead) {
+        const timer = setTimeout(() => {
+            this.timers.delete(timer);
+            if (this.lastChangeT < at && href() === this.startHref)
+                onDead();
+        }, this.deadMs);
+        this.timers.add(timer);
+    }
+    disconnect() {
+        this.observer?.disconnect();
+        this.observer = null;
+        for (const t of this.timers)
+            clearTimeout(t);
+        this.timers.clear();
+    }
+}
+function href() {
+    try {
+        return typeof location !== 'undefined' ? location.href : '';
+    }
+    catch {
+        return '';
+    }
+}
+//# sourceMappingURL=friction.js.map

package/dist/features/journey/friction.js.map

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

package/dist/features/manifest.d.ts

@@ -0,0 +1,20 @@
+import type { IFeature } from '@scalebun/sdk-contracts';
+import type { Capabilities } from '../core/capabilities';
+/**
+ * The feature registry source. Each capture feature vertical (errors, network, webVitals, replay,
+ * …) appends its instance here — this is the append-only seam from WEB-SDK-PLAN.md §1. Bootstrap
+ * only registers a feature when config.features[name] !== false (replay is off by default).
+ */
+export declare const FEATURES: IFeature[];
+/**
+ * The MINIMAL capability each feature fundamentally needs — bootstrap skips a feature whose required
+ * capabilities are absent in the current runtime (e.g. DOM features on the edge). CONSERVATIVE by
+ * design: gate on the core capability only, so a browser missing an optional API (say
+ * IntersectionObserver) still registers DOM features (they degrade internally) — browser behavior never
+ * changes. Only edge/worker runtimes (no DOM) filter the DOM features out. `network`-only features
+ * (analytics, config) are the edge-eligible surface. See core/capabilities.ts.
+ */
+export declare const FEATURE_CAPS: Record<string, Array<keyof Capabilities>>;
+/** A feature's required capabilities. Unmapped (future) features default to DOM — browser-only, conservative. */
+export declare function featureRequirements(name: string): Array<keyof Capabilities>;
+//# sourceMappingURL=manifest.d.ts.map

package/dist/features/manifest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/features/manifest.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AAoBzD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,EAmB9B,CAAC;AAEF;;;;;;;GAOG;AACH,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,KAAK,CAAC,MAAM,YAAY,CAAC,CAmBlE,CAAC;AAEF,iHAAiH;AACjH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,KAAK,CAAC,MAAM,YAAY,CAAC,CAE3E"}

package/dist/features/manifest.js

@@ -0,0 +1,76 @@
+import { AnalyticsFeature } from './analytics/AnalyticsFeature';
+import { ConfigFeature } from './config/ConfigFeature';
+import { ErrorsFeature } from './errors/ErrorsFeature';
+import { NetworkFeature } from './network/NetworkFeature';
+import { WebVitalsFeature } from './webVitals/WebVitalsFeature';
+import { PerformanceFeature } from './performance/PerformanceFeature';
+import { JourneyFeature } from './journey/JourneyFeature';
+import { ConsoleFeature } from './console/ConsoleFeature';
+import { BugReportFeature } from './bugreport/BugReportFeature';
+import { CrashFeature } from './crash/CrashFeature';
+import { EngageFeature } from './engage/EngageFeature';
+import { InboxFeature } from './inbox/InboxFeature';
+import { WebPerfFeature } from './webperf/WebPerfFeature';
+import { ProfilerFeature } from './profiler/ProfilerFeature';
+import { WatchdogFeature } from './watchdog/WatchdogFeature';
+import { ExitIntentFeature } from './exit-intent/ExitIntentFeature';
+import { InApp2Feature } from './inapp/InApp2Feature';
+import { ReplayFeature } from './replay/ReplayFeature';
+/**
+ * The feature registry source. Each capture feature vertical (errors, network, webVitals, replay,
+ * …) appends its instance here — this is the append-only seam from WEB-SDK-PLAN.md §1. Bootstrap
+ * only registers a feature when config.features[name] !== false (replay is off by default).
+ */
+export const FEATURES = [
+    new ConfigFeature(), // F-CFG flags/config/rollouts/experiments (early: cache loads sync in setup)
+    new AnalyticsFeature(), // F-ANL product-analytics + revenue lane → POST /batch (Event)
+    new ErrorsFeature(), // F-ERR
+    new NetworkFeature(), // F-NET
+    new WebVitalsFeature(), // F-VIT
+    new WebPerfFeature(), // web RUM: page-load + FPS + LoAF (F-PERFWEB)
+    new PerformanceFeature(), // performance traces (F-PERF)
+    new JourneyFeature(), // F-JRN
+    new ConsoleFeature(), // console breadcrumbs (F-CON)
+    new BugReportFeature(), // bug-report widget (F-BUG)
+    new CrashFeature(), // crash detection: ReportingObserver + session-liveness recovery (F-CRASH)
+    new EngageFeature(), // surveys/NPS — shell in core, runtime lazy-loaded when a campaign is active (F-ENG)
+    new InboxFeature(), // persistent message inbox — eager shell, runtime lazy-loaded on first inbox() use (F-INBOX, opt-in)
+    new ProfilerFeature(), // JS Self-Profiling flame graphs (F-PROF, opt-in/off by default)
+    new WatchdogFeature(), // resource watchdog: continuous sampling → replay-linked incidents (F-WDOG, opt-in)
+    new ExitIntentFeature(), // exit-intent CRO detector → $exit_intent + signal (F-EXIT, opt-in)
+    new InApp2Feature(), // IAM 2.0 engine — schema-driven in-app surfaces (F-IAM2, opt-in/off by default)
+    new ReplayFeature(), // F-RPL (lazy, opt-in)
+];
+/**
+ * The MINIMAL capability each feature fundamentally needs — bootstrap skips a feature whose required
+ * capabilities are absent in the current runtime (e.g. DOM features on the edge). CONSERVATIVE by
+ * design: gate on the core capability only, so a browser missing an optional API (say
+ * IntersectionObserver) still registers DOM features (they degrade internally) — browser behavior never
+ * changes. Only edge/worker runtimes (no DOM) filter the DOM features out. `network`-only features
+ * (analytics, config) are the edge-eligible surface. See core/capabilities.ts.
+ */
+export const FEATURE_CAPS = {
+    config: ['network'],
+    analytics: ['network'],
+    errors: ['dom'],
+    network: ['dom'],
+    webVitals: ['performanceObserver'],
+    webPerf: ['performanceObserver'],
+    performance: ['performance'],
+    journey: ['dom'],
+    console: ['dom'],
+    bugReport: ['dom'],
+    crash: ['dom'],
+    engage: ['dom'],
+    inbox: ['dom'],
+    profiler: ['dom'],
+    watchdog: ['performanceObserver'],
+    exitIntent: ['dom'],
+    inapp2: ['dom'],
+    replay: ['dom'],
+};
+/** A feature's required capabilities. Unmapped (future) features default to DOM — browser-only, conservative. */
+export function featureRequirements(name) {
+    return FEATURE_CAPS[name] ?? ['dom'];
+}
+//# sourceMappingURL=manifest.js.map

package/dist/features/manifest.js.map

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