@scalebun/web 1.2.3 → 1.3.0

package/dist/features/journey/InteractionTracker.js

@@ -10,6 +10,7 @@
  * unmasked, so this never was the SDK's privacy boundary anyway.
  */
 import { RageDetector, DeadClickWatcher } from './friction.js';
+import { getPositionContext } from './positionContext.js';
 export class InteractionTracker {
     constructor(emit, opts = {}, 
     /** Raise a capture signal ('rage'|'dead') onto the bus — arms friction-triggered features
@@ -89,11 +90,155 @@ function pointer(me) {
 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 };
+    /**
+     * VIEWPORT ANCHORING — `fx` is now 1 for fixed and 2 for STICKY.
+     *
+     * Additive by widening the value rather than by adding a field. Every deployed reader tests `fx`
+     * for truthiness, and 2 is as truthy as 1, so an old backend treats a sticky click as
+     * element-owned — exactly the intended behaviour — while a new one can tell them apart. Nothing
+     * changes meaning and no deploy ordering is required.
+     *
+     * A separate `pc: 'sticky'` string was written first and reverted: it cost 60 bytes against 14
+     * bytes of core headroom. See positionContext.ts.
+     *
+     * STICKY IS WHY THIS CHANGED AT ALL. The old check looked for `position: fixed` and nothing else,
+     * so a sticky header read as ordinary content and its clicks went to the document-space lane —
+     * which must choose one page coordinate for a control clicked at every scroll depth.
+     */
+    const pc = getPositionContext(el);
+    // Emitted only when there is something to say, so the common case still adds no bytes.
+    if (pc)
+        out.fx = pc;
+    out.path = structuralPath(el);
+    const ui = openOverlays();
+    if (ui)
+        out.ui = ui;
     const comp = el.closest('[data-scalebun-component]')?.getAttribute('data-scalebun-component');
     if (comp)
         out.component = comp;
     return out;
 }
+/**
+ * S1 — WHICH OVERLAYS WERE OPEN when this click happened.
+ *
+ * A click on a menu item only means something if the menu was open. Nothing stored today says so, and
+ * it is not derivable afterwards from anything else on the event — the same lesson as `fx` and
+ * `path`: capture has to lead use, and history cannot be backfilled. Without this the dashboard can
+ * SHOW a state (the viewer can open and close the reconstruction) but cannot COUNT one, because every
+ * click on the route is aggregated into a single picture regardless of what was on screen.
+ *
+ * PLATFORM-DEFINED STATE ONLY: `aria-expanded="true"` and `<dialog open>`. Deliberately no guessing at
+ * `.menu-open` or `.is-active` — a class heuristic is right on some sites and silently wrong on
+ * others, and a wrong state key partitions clicks into buckets that do not correspond to anything.
+ *
+ * SORTED, so the same set of open overlays produces the same key whatever order the DOM happens to
+ * return them in — otherwise one state would fragment into several and the counts would be
+ * meaningless.
+ *
+ * Emitted ONLY when something is open, exactly as `fx` is. The overwhelming majority of clicks happen
+ * with nothing open and pay nothing at all; the length cap bounds the rest.
+ */
+function openOverlays() {
+    const out = [];
+    document.querySelectorAll('[aria-expanded="true"],dialog[open]').forEach((e) => {
+        const k = e.getAttribute('aria-controls') || e.getAttribute('aria-label') || e.id;
+        if (k)
+            out.push(k);
+    });
+    return out.length ? out.sort().join('|').slice(0, 64) : undefined;
+}
+/**
+ * True when this click landed on a VIEWPORT-anchored element — one that does not move as the page
+ * scrolls, because it or an ancestor computes to `position: fixed`.
+ *
+ * WHY THE DASHBOARD NEEDS THIS. A click's page position is derived as `y + sy`: viewport coordinate
+ * plus scroll offset. For a fixed element that arithmetic is meaningless — it never moved, so adding
+ * how far the visitor happened to have scrolled scatters one physical button down the whole document.
+ * Measured on real data before this field existed: a single fixed host produced clicks at 22 distinct
+ * page depths between 0.5% and 50.8%, which is 10% of all placeable clicks laid down as a false
+ * vertical streak. A structured artefact like that reads as a finding; noise does not.
+ *
+ * It was worked around by excluding one selector we own by name. That only ever covered OUR widget —
+ * the customer's sticky header, cookie banner and third-party chat have the identical defect and
+ * cannot be recognised from a selector. This field is the general fix, and it is the ELEMENT that
+ * knows: only capture can answer it, which is why it belongs here and not in the query.
+ *
+ * ONLY `fixed`, DELIBERATELY NOT `sticky`. A sticky element behaves like a fixed one *while stuck*
+ * and like normal content otherwise, and which of the two it is at click time cannot be decided from
+ * the element alone without reconstructing its natural flow position. Reporting a guess would put
+ * clicks in a confidently wrong place, which is the failure this field exists to remove. Sticky
+ * therefore keeps today's behaviour until it can be answered rather than estimated.
+ *
+ * Emitted only when TRUE (`fx: 1`), so the common case adds no bytes to the payload.
+ *
+ * Cost: `getComputedStyle` per ancestor, on click only. Layout is already flushed by the
+ * `getBoundingClientRect` above, so these reads hit a clean style tree rather than forcing a
+ * recalculation. Uncapped depth on purpose — a cap would silently misreport exactly the deeply
+ * nested content inside a fixed modal that most needs this to be right.
+ */
+/**
+ * A STRUCTURAL path to the clicked element — `main>div:nth-of-type(2)>button`.
+ *
+ * WHY, given `selector` already exists. `selector` is the element's own tag and classes, which turns
+ * out to identify almost nothing: measured across 849 real clicks, the single commonest value is a
+ * bare `div` (159 of them), followed by Tailwind utility soups like `div.flex.flex-col`. None of
+ * those distinguish one element from thousands of others, so anything built on them — anchoring a
+ * click to the control it hit, following a control across a redesign — is no more reliable than raw
+ * coordinates while LOOKING far more precise. That combination is the worst of the two.
+ *
+ * A path is stable where classes are not: utility classes change whenever the design does, but a
+ * button's position in the document structure usually survives a restyle.
+ *
+ * ADDED ALONGSIDE `selector`, NOT REPLACING IT. The component heatmap aggregates on `selector`
+ * today; changing its meaning underneath would silently re-bucket every existing aggregate against
+ * history captured under the old rule.
+ *
+ * Captured now although nothing consumes it yet, which is a deliberate exception to not shipping
+ * unused fields: a path cannot be reconstructed after the fact from a stored click, so the data has
+ * to start accumulating before the feature that needs it can be built at all. The alternative is
+ * building it later and having no history to run it against.
+ *
+ * An `id` ENDS the walk — an id is unique in the document, so everything above it is noise, and
+ * stopping keeps the common case short. Depth is capped for the same reason: bytes on every click
+ * are real, and the segments nearest the element carry nearly all of the identifying power.
+ *
+ * `nth-of-type` is emitted only when a parent holds more than one child of that tag, so a page whose
+ * structure is already unambiguous pays nothing for it.
+ */
+function structuralPath(el) {
+    const parts = [];
+    let n = el;
+    for (let depth = 0; n && depth < 6; depth++) {
+        const tag = n.tagName.toLowerCase();
+        if (tag === 'html' || tag === 'body')
+            break;
+        if (n.id) {
+            parts.unshift(`${tag}#${n.id}`);
+            break;
+        }
+        const up = n.parentElement;
+        if (up) {
+            let index = 0;
+            let total = 0;
+            const kids = up.children;
+            const self = n;
+            for (let i = 0; i < kids.length; i++) {
+                const kid = kids[i];
+                if (!kid || kid.tagName !== self.tagName)
+                    continue;
+                total++;
+                if (kid === self)
+                    index = total;
+            }
+            parts.unshift(total > 1 ? `${tag}:nth-of-type(${index})` : tag);
+        }
+        else {
+            parts.unshift(tag);
+        }
+        n = up;
+    }
+    return parts.join('>');
+}
 const mask = (s) => s.replace(/\S/g, '*');
 /**
  * A human-ish label: tag + short text, e.g. `button: Buy now`.

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * How an element is positioned relative to the page — the one fact that decides whether a click on
+ * it can be placed in document space at all.
+ *
+ * WHY CHECKING `fixed` WAS NOT ENOUGH. The previous rule walked ancestors for `position: fixed` and
+ * nothing else, so a `position: sticky` header read as ordinary content. Its clicks then went into
+ * the document-space lane, which must choose ONE page coordinate for them — and a sticky header is
+ * clicked at every scroll depth, so no single coordinate is right for more than a fraction of them.
+ * The heat sat where the header had been while the header was somewhere else.
+ *
+ * STICKY COUNTS EVEN WHEN NOT CURRENTLY STUCK. An element that will pin at some offset cannot be
+ * described by one document coordinate either, and the consumer positions it from its current rect,
+ * which is correct in both phases. Requiring it to be stuck at click time would make the answer
+ * depend on when the visitor happened to click.
+ *
+ * ANCESTORS, NOT JUST THE TARGET. The thing clicked is usually a link or an icon inside the
+ * positioned container, so the target's own `position` is almost always `static`.
+ *
+ * Nothing here names a tag, a class or a framework — it asks the browser what it computed.
+ *
+ * NUMERIC, AND IT SHIPS ON `fx`. The core bundle gate had 14 bytes of headroom; a `pc: 'sticky'`
+ * string field costs 60. Widening the value of the field that already exists is additive in the way
+ * that matters — every deployed reader tests `fx` for truthiness, and 2 is as truthy as 1, so an old
+ * backend treats a sticky click as element-owned, which is exactly the intended behaviour. A new
+ * reader can tell the two apart. No field changes meaning, and nothing has to be deployed in order.
+ */
+/** 0 = normal document flow · 1 = fixed ancestor · 2 = sticky ancestor. */
+export type PositionContext = 0 | 1 | 2;
+/**
+ * `fixed` wins over `sticky` when both appear: the nearest fixed ancestor is what actually detaches
+ * the subtree from the document, and a sticky element inside a fixed one travels with the fixed one.
+ */
+export declare function getPositionContext(el: Element): PositionContext;
+//# sourceMappingURL=positionContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"positionContext.d.ts","sourceRoot":"","sources":["../../../src/features/journey/positionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,2EAA2E;AAC3E,MAAM,MAAM,eAAe,GAAG,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAExC;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,EAAE,EAAE,OAAO,GAAG,eAAe,CAS/D"}

package/dist/features/journey/positionContext.js

@@ -0,0 +1,43 @@
+/**
+ * How an element is positioned relative to the page — the one fact that decides whether a click on
+ * it can be placed in document space at all.
+ *
+ * WHY CHECKING `fixed` WAS NOT ENOUGH. The previous rule walked ancestors for `position: fixed` and
+ * nothing else, so a `position: sticky` header read as ordinary content. Its clicks then went into
+ * the document-space lane, which must choose ONE page coordinate for them — and a sticky header is
+ * clicked at every scroll depth, so no single coordinate is right for more than a fraction of them.
+ * The heat sat where the header had been while the header was somewhere else.
+ *
+ * STICKY COUNTS EVEN WHEN NOT CURRENTLY STUCK. An element that will pin at some offset cannot be
+ * described by one document coordinate either, and the consumer positions it from its current rect,
+ * which is correct in both phases. Requiring it to be stuck at click time would make the answer
+ * depend on when the visitor happened to click.
+ *
+ * ANCESTORS, NOT JUST THE TARGET. The thing clicked is usually a link or an icon inside the
+ * positioned container, so the target's own `position` is almost always `static`.
+ *
+ * Nothing here names a tag, a class or a framework — it asks the browser what it computed.
+ *
+ * NUMERIC, AND IT SHIPS ON `fx`. The core bundle gate had 14 bytes of headroom; a `pc: 'sticky'`
+ * string field costs 60. Widening the value of the field that already exists is additive in the way
+ * that matters — every deployed reader tests `fx` for truthiness, and 2 is as truthy as 1, so an old
+ * backend treats a sticky click as element-owned, which is exactly the intended behaviour. A new
+ * reader can tell the two apart. No field changes meaning, and nothing has to be deployed in order.
+ */
+/**
+ * `fixed` wins over `sticky` when both appear: the nearest fixed ancestor is what actually detaches
+ * the subtree from the document, and a sticky element inside a fixed one travels with the fixed one.
+ */
+export function getPositionContext(el) {
+    // No `typeof window` guard: this runs only inside DOM event handlers, which never fire server-side.
+    let sticky = 0;
+    for (let n = el; n; n = n.parentElement) {
+        const p = getComputedStyle(n).position;
+        if (p === 'fixed')
+            return 1;
+        if (p === 'sticky')
+            sticky = 2;
+    }
+    return sticky;
+}
+//# sourceMappingURL=positionContext.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"positionContext.js","sourceRoot":"","sources":["../../../src/features/journey/positionContext.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAKH;;;GAGG;AACH,MAAM,UAAU,kBAAkB,CAAC,EAAW;IAC5C,oGAAoG;IACpG,IAAI,MAAM,GAAoB,CAAC,CAAC;IAChC,KAAK,IAAI,CAAC,GAAmB,EAAE,EAAE,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,CAAC;QACxD,MAAM,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;QACvC,IAAI,CAAC,KAAK,OAAO;YAAE,OAAO,CAAC,CAAC;QAC5B,IAAI,CAAC,KAAK,QAAQ;YAAE,MAAM,GAAG,CAAC,CAAC;IACjC,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/features/manifest.d.ts

@@ -6,6 +6,27 @@ import type { Capabilities } from '../core/capabilities.js';
  * only registers a feature when config.features[name] !== false (replay is off by default).
  */
 export declare const FEATURES: IFeature[];
+/**
+ * P5a — features that are OFF BY DEFAULT, loaded only when a host turns one on.
+ *
+ * WHY THESE FIVE AND NOT OTHERS: `resolveConfig` defaults `replay`, `inbox`, `profiler`, `watchdog`
+ * and `inapp2` to `false`. Every other feature defaults to `true`, so lazy-loading it would trade
+ * eager bytes for a round trip on the path virtually every site takes — a bad exchange. These five are
+ * the only ones the typical site never uses, and they were nonetheless constructed and bundled into
+ * the eager core on every page load.
+ *
+ * MEASURED: removing their shells takes the eager core from 33,602 B to 32,219 B gzipped — **1,383 B**,
+ * which is 7× the headroom that existed before this change (190 B). That budget is what a minimal
+ * eager keyframe needs, and it did not exist until now.
+ *
+ * A dynamic `import()` here is what actually moves the bytes; a `() => new X()` factory would not,
+ * because the static import would still pull the module into the eager chunk.
+ *
+ * The cost is one round trip when a host opts in, paid during `activate()` before `setupAll` — so an
+ * enabled feature still sets up before the pipeline starts, exactly as an eager one does. The ordering
+ * F-VIT depends on is unchanged.
+ */
+export declare const OPTIONAL_FEATURES: Record<string, () => Promise<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

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

@@ -1 +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"}
+{"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;AAezD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,QAAQ,EAc9B,CAAC;AAEF;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,iBAAiB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,OAAO,CAAC,QAAQ,CAAC,CAMrE,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

@@ -9,13 +9,8 @@ import { ConsoleFeature } from './console/ConsoleFeature.js';
 import { BugReportFeature } from './bugreport/BugReportFeature.js';
 import { CrashFeature } from './crash/CrashFeature.js';
 import { EngageFeature } from './engage/EngageFeature.js';
-import { InboxFeature } from './inbox/InboxFeature.js';
 import { WebPerfFeature } from './webperf/WebPerfFeature.js';
-import { ProfilerFeature } from './profiler/ProfilerFeature.js';
-import { WatchdogFeature } from './watchdog/WatchdogFeature.js';
 import { ExitIntentFeature } from './exit-intent/ExitIntentFeature.js';
-import { InApp2Feature } from './inapp/InApp2Feature.js';
-import { ReplayFeature } from './replay/ReplayFeature.js';
 /**
  * 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
@@ -34,13 +29,35 @@ export const FEATURES = [
     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)
 ];
+/**
+ * P5a — features that are OFF BY DEFAULT, loaded only when a host turns one on.
+ *
+ * WHY THESE FIVE AND NOT OTHERS: `resolveConfig` defaults `replay`, `inbox`, `profiler`, `watchdog`
+ * and `inapp2` to `false`. Every other feature defaults to `true`, so lazy-loading it would trade
+ * eager bytes for a round trip on the path virtually every site takes — a bad exchange. These five are
+ * the only ones the typical site never uses, and they were nonetheless constructed and bundled into
+ * the eager core on every page load.
+ *
+ * MEASURED: removing their shells takes the eager core from 33,602 B to 32,219 B gzipped — **1,383 B**,
+ * which is 7× the headroom that existed before this change (190 B). That budget is what a minimal
+ * eager keyframe needs, and it did not exist until now.
+ *
+ * A dynamic `import()` here is what actually moves the bytes; a `() => new X()` factory would not,
+ * because the static import would still pull the module into the eager chunk.
+ *
+ * The cost is one round trip when a host opts in, paid during `activate()` before `setupAll` — so an
+ * enabled feature still sets up before the pipeline starts, exactly as an eager one does. The ordering
+ * F-VIT depends on is unchanged.
+ */
+export const OPTIONAL_FEATURES = {
+    replay: async () => new (await import('./replay/ReplayFeature.js')).ReplayFeature(),
+    inbox: async () => new (await import('./inbox/InboxFeature.js')).InboxFeature(),
+    profiler: async () => new (await import('./profiler/ProfilerFeature.js')).ProfilerFeature(),
+    watchdog: async () => new (await import('./watchdog/WatchdogFeature.js')).WatchdogFeature(),
+    inapp2: async () => new (await import('./inapp/InApp2Feature.js')).InApp2Feature(),
+};
 /**
  * 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

package/dist/features/manifest.js.map

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

package/dist/features/replay/ReplayFeature.d.ts

@@ -11,8 +11,28 @@ export declare class ReplayFeature implements IFeature {
     readonly name = "replay";
     private controller?;
     private uninstallWebGL?;
+    private watchdog?;
     get isActive(): boolean;
     setup(ctx: FeatureContext): Promise<void>;
+    /**
+     * Resolves when arming has finished — succeeded OR reported its failure. Never rejects (`arm` owns
+     * its own error handling), so awaiting it is always safe.
+     *
+     * Deliberately not on `IFeature`: nothing in the SDK awaits it, and adding it to the interface would
+     * imply every feature has an async tail. It exists because `setup()` returning early made "the
+     * recorder is now live" unobservable, which the replay suites legitimately need to assert — the
+     * alternative was weakening eleven behavioural tests into timing guesses, which would trade a real
+     * contract for a green tick.
+     */
+    armed?: Promise<void>;
+    /**
+     * Load the recorder and start capturing. Runs detached from `setup()` — see the note above.
+     *
+     * Every failure here is terminal for replay and silent everywhere else, so this method owns its own
+     * reporting: nothing upstream is awaiting it to notice a rejection.
+     */
+    private arm;
+    private load;
     /** Capture-on-signal flush (promote pre-roll → live). No-op until a recorder is active. */
     flush(): void;
     /** Live diagnostics (null when not recording — off, or a non-sampled session). */

package/dist/features/replay/ReplayFeature.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ReplayFeature.d.ts","sourceRoot":"","sources":["../../../src/features/replay/ReplayFeature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAsB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAS5E,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAa;IAEpC,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IA2F/C,2FAA2F;IAC3F,KAAK,IAAI,IAAI;IAIb,kFAAkF;IAClF,KAAK,IAAI,WAAW,GAAG,IAAI;IAI3B,6FAA6F;IAC7F,UAAU,CAAC,MAAM,SAAW,GAAG,IAAI;IAInC,8FAA8F;IAC9F,KAAK,IAAI,IAAI;IAIb,+EAA+E;IAC/E,MAAM,IAAI,IAAI;IAId,uFAAuF;IACvF,UAAU,CAAC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAInD,QAAQ,IAAI,IAAI;CAMjB"}
+{"version":3,"file":"ReplayFeature.d.ts","sourceRoot":"","sources":["../../../src/features/replay/ReplayFeature.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AACH,OAAO,KAAK,EAAE,QAAQ,EAAE,cAAc,EAAE,MAAM,yBAAyB,CAAC;AACxE,OAAO,KAAK,EAAsB,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAsD5E,qBAAa,aAAc,YAAW,QAAQ;IAC5C,QAAQ,CAAC,IAAI,YAAY;IACzB,OAAO,CAAC,UAAU,CAAC,CAAqB;IACxC,OAAO,CAAC,cAAc,CAAC,CAAa;IACpC,OAAO,CAAC,QAAQ,CAAC,CAAgC;IAEjD,IAAI,QAAQ,IAAI,OAAO,CAEtB;IAEK,KAAK,CAAC,GAAG,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAgF/C;;;;;;;;;OASG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;IAEtB;;;;;OAKG;YACW,GAAG;YAgBH,IAAI;IA+FlB,2FAA2F;IAC3F,KAAK,IAAI,IAAI;IAIb,kFAAkF;IAClF,KAAK,IAAI,WAAW,GAAG,IAAI;IAI3B,6FAA6F;IAC7F,UAAU,CAAC,MAAM,SAAW,GAAG,IAAI;IAInC,8FAA8F;IAC9F,KAAK,IAAI,IAAI;IAIb,+EAA+E;IAC/E,MAAM,IAAI,IAAI;IAId,uFAAuF;IACvF,UAAU,CAAC,MAAM,EAAE;QAAE,WAAW,CAAC,EAAE,OAAO,CAAA;KAAE,GAAG,IAAI;IAInD,QAAQ,IAAI,IAAI;CAUjB"}

package/dist/features/replay/ReplayFeature.js

@@ -1,6 +1,49 @@
+/**
+ * P5 — `decideSampling` is imported STATICALLY, not fetched.
+ *
+ * It used to be `await import('./lifecycle/sampling.js')`, which put a whole round trip in front of the
+ * recorder import: init → fetch sampling → decide → fetch recorder → create. Measured, that waterfall
+ * is what sets the capture floor, and the floor is set by LATENCY rather than by session duration —
+ * with instant chunks a 100 ms visit captures, at 300 ms per chunk the floor rises to 500 ms and at
+ * 600 ms it rises to 2 s. Time-to-first-keyframe scales at roughly 8× per-chunk latency because the
+ * graph is deep, so removing a hop from it is worth more than shaving bytes anywhere else.
+ *
+ * This costs the EAGER core nothing. Since P5a moved `ReplayFeature` itself into a lazy chunk, its
+ * static imports are bundled into that chunk — which is already being fetched by the time this runs.
+ * The module is ~40 lines and its only runtime dependency, `bucketOf`, is in eager core already for
+ * flags and experiments.
+ *
+ * The guarantee the dynamic import was protecting is preserved and in fact strengthened: a
+ * non-sampled session still installs nothing beyond the decision, and now fetches nothing extra to
+ * make it.
+ */
+import { decideSampling } from './lifecycle/sampling.js';
+// Already in the eager core (FeatureRegistry), so reusing it here costs the identifier and nothing
+// more — and keeps ONE definition of "was this a chunk that never arrived" across both reporters.
+import { isModuleLoadFailure } from '../../bootstrap/FeatureRegistry.js';
 /** Gap before the single recorder-import retry (A3). Long enough to outlast a blip, short enough that a
  *  bouncing visitor is not what decides the outcome. */
 const RECORDER_RETRY_MS = 400;
+/**
+ * P1b — the capture-failure report. SAME NAME as the React Native SDK, with platform-specific
+ * `reason` values, so one dashboard breakdown reads both without a concept-map alias.
+ *
+ * Hoisted to a const because it appears three times: repeating the literal costs more gzipped bytes
+ * than the identifier, and the eager budget it comes out of is 468 B.
+ */
+const FAIL = 'sdk_replay_capture_failed';
+/**
+ * How long a session may be ARMED with zero frames before that is a defect rather than latency.
+ *
+ * Measured, not chosen. Of sessions that produced a keyframe, the capture offset is p50 0 ms, p95
+ * 2,453 ms, p99 6,821 ms. 5 s sits above p95 and below p99: late enough that a merely slow session is
+ * not accused, early enough to still fire inside the 5–10 s bucket — which is where readiness collapses
+ * to 31.4% against 77% at 10–30 s, i.e. the one bucket this watchdog exists to explain.
+ *
+ * A page that unloads before this fires reports nothing, and that is correct: the session ended, it did
+ * not fail. Those are `bounced`, and they are counted from duration, not from here.
+ */
+const FIRST_FRAME_WATCHDOG_MS = 5000;
 /** Extracted so the retry awaits the SAME specifier — two spellings would defeat the module cache. */
 const loadRecorder = () => import('./lifecycle/recorder.js');
 export class ReplayFeature {
@@ -11,11 +54,31 @@ export class ReplayFeature {
         return this.controller?.isActive ?? false;
     }
     async setup(ctx) {
-        if (typeof document === 'undefined' || typeof MutationObserver === 'undefined')
+        /**
+         * P1b — the three exits below used to be SILENT, and that silence is the whole diagnostic gap.
+         *
+         * Measured on 275 live web sessions: 64 lasted a second or more and stored zero frames, and 57 of
+         * those 64 uploaded events, web vitals and `first_open` in the same session — so the SDK
+         * demonstrably ran, authenticated and delivered. Yet `sdk_feature_setup_failed` appears zero times
+         * across 2,736 analytics events and 2,317 replay events. The reason is now known: that event only
+         * fires when `setup()` THROWS, and these paths `return`. A failure that returns normally is
+         * indistinguishable from a healthy session that simply had nothing to say.
+         *
+         * Sampling is deliberately NOT reported. It is a legitimate decision rather than a failure, and it
+         * is already recoverable server-side — the bucket is `fnv1a32(sessionId + ':wzb-replay-v1') % 100`,
+         * byte-identical in the backend, so "should this session have recorded" is re-derivable without
+         * spending a single eager byte or trusting the client. Verified against this dataset: `missing`
+         * sessions are spread evenly across all 100 buckets (33 below 50, 31 above), which is what ruled
+         * sampling out as the cause. Calling a sampled-out session a capture failure would also poison the
+         * one metric this event exists to feed.
+         */
+        if (typeof document === 'undefined' || typeof MutationObserver === 'undefined') {
+            ctx.trackEvent(FAIL, { stage: 'init', reason: 'ENV_UNSUPPORTED' });
             return;
+        }
         // Deterministic sampling gate (server-reconcilable fnv1a) — decide BEFORE loading the recorder,
-        // so a non-sampled session installs nothing beyond this tiny decision.
-        const { decideSampling } = await import('./lifecycle/sampling.js');
+        // so a non-sampled session installs nothing beyond this tiny decision. Statically imported: see
+        // the note on the import.
         const decision = decideSampling(ctx.replaySampling, ctx.sessionId ?? '');
         ctx.log('[replay] sampling:', decision.reason, '(bucket', decision.bucket + ')');
         if (!decision.record)
@@ -26,6 +89,9 @@ export class ReplayFeature {
             const { userOptedOutOfTracking } = await import('./lifecycle/deviceSignals.js');
             if (userOptedOutOfTracking()) {
                 ctx.log('[replay] dnt: skip');
+                // Not a defect — a respected opt-out. Reported anyway so it lands in the ATTRIBUTED column
+                // instead of the residual; an unexplained gap is what this phase exists to remove.
+                ctx.trackEvent(FAIL, { stage: 'init', reason: 'DNT_OPTED_OUT' });
                 return;
             }
         }
@@ -38,6 +104,54 @@ export class ReplayFeature {
             const { installWebGLPreserve } = await import('./engine/webglPatch.js');
             this.uninstallWebGL = installWebGLPreserve();
         }
+        /**
+         * P3 — ARM WITHOUT BLOCKING THE BOOTSTRAP. Everything below this line is deliberately NOT awaited.
+         *
+         * `SDKBootstrapper.activate()` runs `await registry.setupAll(ctx)` and only then
+         * `await pipeline.start()` — and `setupAll` is a sequential for-loop. So every millisecond replay
+         * spends fetching its recorder chunk is a millisecond before the SESSION IS OPENED. A slow chunk
+         * therefore does not merely lose replay: it loses the whole visit, including analytics, errors and
+         * performance, because nothing has a session to attach to yet.
+         *
+         * MEASURED, Phase 2 browser matrix: with the recorder chunk stalled 6 s, visits of 3 s and 5 s
+         * produced NO SESSION ROW AT ALL — not a session missing replay, no session. At 8 s and 15 s (long
+         * enough to outlast the stall) the same scenario reached PLAYBACK_READY, which is what identifies
+         * the stall as the cause rather than anything about capture itself.
+         *
+         * The `setupAll` ordering it relies on cannot simply be reversed: F-VIT documents a dependency on
+         * setup running before `pipeline.start`. Making replay's own tail non-blocking fixes the defect
+         * without touching that contract or any other feature.
+         *
+         * The cost of not awaiting is that a rejection no longer reaches `FeatureRegistry.setupAll`, which
+         * is what produced `sdk_feature_setup_failed` for replay. `arm()` therefore reports its own failure
+         * with a MORE specific reason than the registry could, so attribution improves rather than
+         * regresses.
+         */
+        this.armed = this.arm(ctx, decision);
+    }
+    /**
+     * Load the recorder and start capturing. Runs detached from `setup()` — see the note above.
+     *
+     * Every failure here is terminal for replay and silent everywhere else, so this method owns its own
+     * reporting: nothing upstream is awaiting it to notice a rejection.
+     */
+    async arm(ctx, decision) {
+        try {
+            await this.load(ctx, decision);
+        }
+        catch (err) {
+            const message = String(err?.message ?? err).slice(0, 300);
+            ctx.trackEvent(FAIL, {
+                stage: 'init',
+                // Separates "the chunk never arrived" (CSP, 404 after a deploy, chunk-hash skew, dropped
+                // request) from "the recorder itself threw" — completely different fixes, and the message is
+                // the only signal the three engines agree on.
+                reason: isModuleLoadFailure(message) ? 'ENGINE_CHUNK_LOAD_FAILED' : 'RECORDER_INIT_FAILED',
+                message,
+            });
+        }
+    }
+    async load(ctx, decision) {
         /**
          * R3 — WARM the engine chunks concurrently instead of letting them waterfall.
          *
@@ -81,8 +195,8 @@ export class ReplayFeature {
          *
          * When the retry SUCCEEDS it says so. Without that event a retry is an unfalsifiable fix: coverage
          * might improve and nobody could tell whether this was why. `sdk_replay_recovered` makes it
-         * measurable, and pairs with `sdk_feature_setup_failed` (which the throw below still produces via
-         * FeatureRegistry) so both outcomes are visible instead of neither.
+         * measurable, and pairs with the `sdk_replay_capture_failed` its caller emits when the second
+         * attempt fails too, so both outcomes are visible instead of neither.
          */
         let createRecorder;
         try {
@@ -97,6 +211,38 @@ export class ReplayFeature {
             });
         }
         this.controller = await createRecorder(ctx, decision);
+        /**
+         * P1b — the ARMED-BUT-SILENT watchdog. This is the case nothing else can see.
+         *
+         * Every gate above reports by returning or throwing. Once `createRecorder` resolves the feature is
+         * live and, as far as any existing signal is concerned, healthy — so a recorder that attaches and
+         * then never produces a frame (root never resolved, snapshot threw inside an observer callback,
+         * serialization died on a hostile DOM) is invisible on the client AND on the server, because
+         * nothing is ever sent. That is the exact residue this phase has to attribute.
+         *
+         * Tests `captured`, NOT `frames`. `frames` is the segment-buffer occupancy: while streaming, frames
+         * leave the buffer as they ship, so a healthy session reports 0 and an earlier revision of this
+         * watchdog accused every one of them — measured in the Phase 2 browser matrix, `normal` at 5 s, 8 s
+         * and 15 s all reached PLAYBACK_READY while reporting NO_FRAME_AFTER_ARM. A false positive here is
+         * worse than no watchdog: it would fill the attribution table this phase exists to build with
+         * sessions that captured perfectly.
+         *
+         * `recording` is still required: a paused or torn-down recorder has a legitimate reason to hold no
+         * keyframe and must not be accused either.
+         */
+        this.watchdog = setTimeout(() => {
+            const s = this.controller?.stats();
+            if (s?.recording && !s.captured) {
+                ctx.trackEvent(FAIL, {
+                    stage: 'first-frame',
+                    reason: 'NO_FRAME_AFTER_ARM',
+                    // Carried so the server can separate "armed and streaming" from "armed and buffering the
+                    // pre-roll", which is a legitimate zero-frame state under onError mode.
+                    streaming: s.streaming,
+                    bucket: s.sampleBucket,
+                });
+            }
+        }, FIRST_FRAME_WATCHDOG_MS);
     }
     /** Capture-on-signal flush (promote pre-roll → live). No-op until a recorder is active. */
     flush() {
@@ -123,6 +269,10 @@ export class ReplayFeature {
         this.controller?.setPrivacy(policy);
     }
     teardown() {
+        // Before the controller goes: a fired-after-teardown watchdog would read `stats()` as undefined and
+        // report nothing, but the timer would still hold this instance alive until it elapsed.
+        clearTimeout(this.watchdog);
+        this.watchdog = undefined;
         this.controller?.teardown();
         this.controller = undefined;
         this.uninstallWebGL?.();