@openreplay/tracker 18.0.10 → 18.0.12-beta.1

package/dist/lib/main/app/index.d.ts

@@ -171,11 +171,72 @@ export default class App {
     /** used by child iframes for crossdomain only */
     parentActive: boolean;
     checkStatus: () => boolean;
+    /** child-side crossdomain debug state (only meaningful when insideIframe) */
+    private lastTokenReceived;
+    private lastParentMsgAt;
+    private lastSentToParentAt;
+    private iframeDebugInterval;
+    /** stamp every outbound post to the parent window, for the child debug snapshot */
+    private markSentToParent;
+    /**
+     * Child-side counterpart of emitCrossdomainDebug: once per minute an iframe posts an
+     * encoded snapshot of its own tracking state up to the parent, which records it as a
+     * console log. Posted directly (not via this.send) so it is reported even when the
+     * child is NOT active — an inactive/orphaned child is exactly what we want to catch.
+     */
+    private emitIframeDebug;
     parentCrossDomainFrameListener: (event: MessageEvent) => void;
     trackedFrames: string[];
+    /** every context that has been enrolled at least once, to tell an orphan (re-adopt) apart
+     *  from a brand-new child still mid-enrollment (leave alone). */
+    private everTrackedFrames;
     private frameLastSeen;
+    /** crossdomain debug diagnostics, reported once per minute as an encoded console log */
+    private frameOrigin;
+    private frameAnyLastSeen;
+    private frameBatchLastSeen;
+    private frameLastSent;
+    private xdomainDebugInterval;
+    /** last time we re-adopted a given orphaned context, to avoid restart spam */
+    private reAdoptCooldown;
+    private readonly RE_ADOPT_COOLDOWN_MS;
+    /**
+     * Stable, collision-free frame-order allocation. Node ids are partitioned by
+     * (frameLevel, frameOrder) via pack() — every (level, order) owns its own id block, so
+     * two simultaneously-live frames sharing an order at the same level corrupt each other's
+     * node trees and one stops rendering. The previous `trackedFrames.findIndex+1` derived
+     * order from a mutable array index, and pruneStaleFrames()'s .filter() shifts those
+     * indices, so a newly enrolled frame could be handed an order still in use by a live
+     * (but pruned) frame. We instead assign each context a persistent order, unique among all
+     * non-recycled contexts at its level, freed only when the context is GC'd (truly gone).
+     */
+    private frameAlloc;
+    private usedOrdersByLevel;
+    private allocateFrameOrder;
+    private freeFrameOrder;
     private readonly FRAME_STALE_MS;
     private pruneStaleFrames;
+    /** records the last command/signal we posted to a given child iframe context (debug) */
+    private recordSentToFrame;
+    /**
+     * Self-heal for the "kill-then-prune orphan" race: a live child can fall out of
+     * `trackedFrames` (its 250ms poll was delayed past FRAME_STALE_MS during the parent's
+     * stop/start NotActive gap, so pruneStaleFrames evicted it). It keeps polling but the
+     * only re-enrollment path is an `iframeSignal`, which a stopped/active-but-orphaned
+     * child never re-emits — so it would record nothing forever. When we (the parent) are
+     * active and see a poll from an un-tracked context, push a `startIframe` so the child
+     * restarts, re-runs the full handshake and re-observes with a fresh rootId. Cooldowned
+     * so we don't spam restarts during the child's start window.
+     */
+    private reAdoptOrphanFrame;
+    /**
+     * Once per minute: emit an encoded console log from the parent tracker describing every
+     * tracked child iframe and the freshness of our two-way communication with it. Lets us
+     * see in replay which crossdomain iframe went silent and on which leg of the handshake.
+     */
+    /** drop debug entries for contexts we have neither heard from nor messaged in this long */
+    private readonly XDOMAIN_DEBUG_RETENTION_MS;
+    private emitCrossdomainDebug;
     crossDomainIframeListener: (event: MessageEvent) => void;
     /**
      * { command : [remaining iframes] }

package/dist/types/main/app/index.d.ts

@@ -171,11 +171,72 @@ export default class App {
     /** used by child iframes for crossdomain only */
     parentActive: boolean;
     checkStatus: () => boolean;
+    /** child-side crossdomain debug state (only meaningful when insideIframe) */
+    private lastTokenReceived;
+    private lastParentMsgAt;
+    private lastSentToParentAt;
+    private iframeDebugInterval;
+    /** stamp every outbound post to the parent window, for the child debug snapshot */
+    private markSentToParent;
+    /**
+     * Child-side counterpart of emitCrossdomainDebug: once per minute an iframe posts an
+     * encoded snapshot of its own tracking state up to the parent, which records it as a
+     * console log. Posted directly (not via this.send) so it is reported even when the
+     * child is NOT active — an inactive/orphaned child is exactly what we want to catch.
+     */
+    private emitIframeDebug;
     parentCrossDomainFrameListener: (event: MessageEvent) => void;
     trackedFrames: string[];
+    /** every context that has been enrolled at least once, to tell an orphan (re-adopt) apart
+     *  from a brand-new child still mid-enrollment (leave alone). */
+    private everTrackedFrames;
     private frameLastSeen;
+    /** crossdomain debug diagnostics, reported once per minute as an encoded console log */
+    private frameOrigin;
+    private frameAnyLastSeen;
+    private frameBatchLastSeen;
+    private frameLastSent;
+    private xdomainDebugInterval;
+    /** last time we re-adopted a given orphaned context, to avoid restart spam */
+    private reAdoptCooldown;
+    private readonly RE_ADOPT_COOLDOWN_MS;
+    /**
+     * Stable, collision-free frame-order allocation. Node ids are partitioned by
+     * (frameLevel, frameOrder) via pack() — every (level, order) owns its own id block, so
+     * two simultaneously-live frames sharing an order at the same level corrupt each other's
+     * node trees and one stops rendering. The previous `trackedFrames.findIndex+1` derived
+     * order from a mutable array index, and pruneStaleFrames()'s .filter() shifts those
+     * indices, so a newly enrolled frame could be handed an order still in use by a live
+     * (but pruned) frame. We instead assign each context a persistent order, unique among all
+     * non-recycled contexts at its level, freed only when the context is GC'd (truly gone).
+     */
+    private frameAlloc;
+    private usedOrdersByLevel;
+    private allocateFrameOrder;
+    private freeFrameOrder;
     private readonly FRAME_STALE_MS;
     private pruneStaleFrames;
+    /** records the last command/signal we posted to a given child iframe context (debug) */
+    private recordSentToFrame;
+    /**
+     * Self-heal for the "kill-then-prune orphan" race: a live child can fall out of
+     * `trackedFrames` (its 250ms poll was delayed past FRAME_STALE_MS during the parent's
+     * stop/start NotActive gap, so pruneStaleFrames evicted it). It keeps polling but the
+     * only re-enrollment path is an `iframeSignal`, which a stopped/active-but-orphaned
+     * child never re-emits — so it would record nothing forever. When we (the parent) are
+     * active and see a poll from an un-tracked context, push a `startIframe` so the child
+     * restarts, re-runs the full handshake and re-observes with a fresh rootId. Cooldowned
+     * so we don't spam restarts during the child's start window.
+     */
+    private reAdoptOrphanFrame;
+    /**
+     * Once per minute: emit an encoded console log from the parent tracker describing every
+     * tracked child iframe and the freshness of our two-way communication with it. Lets us
+     * see in replay which crossdomain iframe went silent and on which leg of the handshake.
+     */
+    /** drop debug entries for contexts we have neither heard from nor messaged in this long */
+    private readonly XDOMAIN_DEBUG_RETENTION_MS;
+    private emitCrossdomainDebug;
     crossDomainIframeListener: (event: MessageEvent) => void;
     /**
      * { command : [remaining iframes] }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openreplay/tracker",
   "description": "The OpenReplay tracker main package",
-  "version": "18.0.10",
+  "version": "18.0.12-beta.1",
   "keywords": [
     "logging",
     "replay"