@openreplay/tracker 17.2.6 → 17.2.9

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

@@ -1,6 +1,7 @@
 import type { Options as WebworkerOptions } from '../../common/interaction.js';
 import AttributeSender from '../modules/attributeSender.js';
 import type { Options as NetworkOptions } from '../modules/network.js';
+import type TagMatcher from '../modules/tagMatcher.js';
 import Logger, { ILogLevel } from './logger.js';
 import Message from './messages.gen.js';
 import Nodes from './nodes/index.js';
@@ -158,6 +159,7 @@ export default class App {
     private canvasRecorder;
     private conditionsManager;
     private readonly tagWatcher;
+    get tagMatcher(): TagMatcher;
     private canStart;
     private rootId;
     private pageFrames;
@@ -169,11 +171,10 @@ export default class App {
     parentActive: boolean;
     checkStatus: () => boolean;
     parentCrossDomainFrameListener: (event: MessageEvent) => void;
-    /**
-     * context ids for iframes,
-     * order is not so important as long as its consistent
-     * */
     trackedFrames: string[];
+    private frameLastSeen;
+    private readonly FRAME_STALE_MS;
+    private pruneStaleFrames;
     crossDomainIframeListener: (event: MessageEvent) => void;
     /**
      * { command : [remaining iframes] }
@@ -288,6 +289,7 @@ export default class App {
      * */
     uploadOfflineRecording(): Promise<void>;
     prevOpts: StartOptions;
+    private userStartCallback?;
     private _start;
     restartCanvasTracking: () => void;
     flushBuffer: (buffer: Message[]) => Promise<unknown>;

package/dist/lib/main/app/messages.gen.d.ts

@@ -62,7 +62,6 @@ export declare function AdoptedSSRemoveOwner(sheetID: number, id: number): Messa
 export declare function JSException(name: string, message: string, payload: string, metadata: string): Messages.JSException;
 export declare function Zustand(mutation: string, state: string): Messages.Zustand;
 export declare function BatchMetadata(version: number, pageNo: number, firstIndex: number, timestamp: number, location: string): Messages.BatchMetadata;
-export declare function PartitionedMessage(partNo: number, partTotal: number): Messages.PartitionedMessage;
 export declare function NetworkRequest(type: string, method: string, url: string, request: string, response: string, status: number, timestamp: number, duration: number, transferredBodySize: number): Messages.NetworkRequest;
 export declare function WSChannel(chType: string, channelName: string, data: string, timestamp: number, dir: string, messageType: string): Messages.WSChannel;
 export declare function ResourceTiming(timestamp: number, duration: number, ttfb: number, headerSize: number, encodedBodySize: number, decodedBodySize: number, url: string, initiator: string, transferredSize: number, cached: boolean, queueing: number, dnsLookup: number, initialConnection: number, ssl: number, contentDownload: number, total: number, stalled: number): Messages.ResourceTiming;

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

@@ -28,6 +28,12 @@ export default abstract class Observer {
     private readonly inlineRemoteCss;
     private readonly inlinerOptions;
     private readonly domParser;
+    /**
+     * Bumped on every disconnect(). Stale async CSS-inlining callbacks from a
+     * previous session (e.g. agent reload → tracker restart) compare against
+     * this and bail instead of sending messages that reference vanished node ids.
+     */
+    private generation;
     constructor(app: App, isTopContext?: boolean, options?: Options);
     private clear;
     /**

package/dist/lib/main/modules/tagMatcher.d.ts

@@ -0,0 +1,28 @@
+export type Tag = {
+    id: number;
+    selector: string;
+    location?: string;
+};
+/**
+ * Two-tier tag matching:
+ * 1. Fast fingerprint lookup by id, data-attr,
+ *    or class from the selector's last segment
+ * 2. Fallback iteration using native element.matches()
+ */
+declare class TagMatcher {
+    private tags;
+    private byId;
+    private byDataAttr;
+    private byClass;
+    private fallback;
+    setTags(tags: Tag[]): void;
+    getTags(): Tag[];
+    /** Match element, its parent, or direct children against known tag selectors */
+    match(el: Element): Tag | null;
+    private matchExact;
+    clear(): void;
+}
+export declare function matchesLocation(tag: {
+    location?: string;
+}): boolean;
+export default TagMatcher;

package/dist/lib/main/modules/tagWatcher.d.ts

@@ -1,10 +1,9 @@
+import TagMatcher, { type Tag } from './tagMatcher.js';
 export declare const WATCHED_TAGS_KEY = "__or__watched_tags__";
 declare class TagWatcher {
     interval: ReturnType<typeof setInterval> | null;
-    tags: {
-        id: number;
-        selector: string;
-    }[];
+    tags: Tag[];
+    readonly matcher: TagMatcher;
     observer: IntersectionObserver;
     private readonly sessionStorage;
     private readonly errLog;
@@ -15,10 +14,7 @@ declare class TagWatcher {
         onTag: (tag: number) => void;
     });
     fetchTags(ingest: string, token: string): Promise<void>;
-    setTags(tags: {
-        id: number;
-        selector: string;
-    }[]): void;
+    setTags(tags: Tag[]): void;
     onTagRendered(tagId: number): void;
     clear(): void;
 }

package/dist/types/common/messages.gen.d.ts

@@ -61,7 +61,6 @@ export declare const enum Type {
     JSException = 78,
     Zustand = 79,
     BatchMetadata = 81,
-    PartitionedMessage = 82,
     NetworkRequest = 83,
     WSChannel = 84,
     ResourceTiming = 85,
@@ -442,11 +441,6 @@ export type BatchMetadata = [
     number,
     string
 ];
-export type PartitionedMessage = [
-    Type.PartitionedMessage,
-    number,
-    number
-];
 export type NetworkRequest = [
     Type.NetworkRequest,
     string,
@@ -583,5 +577,5 @@ export type WebVitals = [
     string,
     string
 ];
-type Message = Timestamp | SetPageLocationDeprecated | SetViewportSize | SetViewportScroll | CreateDocument | CreateElementNode | CreateTextNode | MoveNode | RemoveNode | SetNodeAttribute | RemoveNodeAttribute | SetNodeData | SetNodeScroll | SetInputTarget | SetInputValue | SetInputChecked | MouseMove | NetworkRequestDeprecated | ConsoleLog | PageLoadTiming | PageRenderTiming | CustomEvent | UserID | UserAnonymousID | Metadata | StringDictGlobal | SetNodeAttributeDictGlobal | NodeAnimationResult | Profiler | OTable | StateAction | ReduxDeprecated | Vuex | MobX | NgRx | GraphQLDeprecated | PerformanceTrack | StringDictDeprecated | SetNodeAttributeDictDeprecated | StringDict | SetNodeAttributeDict | ResourceTimingDeprecatedDeprecated | ConnectionInformation | SetPageVisibility | LoadFontFace | SetNodeFocus | SetNodeAttributeURLBased | SetCSSDataURLBased | TechnicalInfo | CustomIssue | SetNodeSlot | MouseClick | MouseClickDeprecated | CreateIFrameDocument | AdoptedSSReplaceURLBased | AdoptedSSInsertRuleURLBased | AdoptedSSDeleteRule | AdoptedSSAddOwner | AdoptedSSRemoveOwner | JSException | Zustand | BatchMetadata | PartitionedMessage | NetworkRequest | WSChannel | ResourceTiming | Incident | LongAnimationTask | InputChange | SelectionChange | MouseThrashing | UnbindNodes | ResourceTimingDeprecated | TabChange | TabData | CanvasNode | TagTrigger | Redux | SetPageLocation | GraphQL | WebVitals;
+type Message = Timestamp | SetPageLocationDeprecated | SetViewportSize | SetViewportScroll | CreateDocument | CreateElementNode | CreateTextNode | MoveNode | RemoveNode | SetNodeAttribute | RemoveNodeAttribute | SetNodeData | SetNodeScroll | SetInputTarget | SetInputValue | SetInputChecked | MouseMove | NetworkRequestDeprecated | ConsoleLog | PageLoadTiming | PageRenderTiming | CustomEvent | UserID | UserAnonymousID | Metadata | StringDictGlobal | SetNodeAttributeDictGlobal | NodeAnimationResult | Profiler | OTable | StateAction | ReduxDeprecated | Vuex | MobX | NgRx | GraphQLDeprecated | PerformanceTrack | StringDictDeprecated | SetNodeAttributeDictDeprecated | StringDict | SetNodeAttributeDict | ResourceTimingDeprecatedDeprecated | ConnectionInformation | SetPageVisibility | LoadFontFace | SetNodeFocus | SetNodeAttributeURLBased | SetCSSDataURLBased | TechnicalInfo | CustomIssue | SetNodeSlot | MouseClick | MouseClickDeprecated | CreateIFrameDocument | AdoptedSSReplaceURLBased | AdoptedSSInsertRuleURLBased | AdoptedSSDeleteRule | AdoptedSSAddOwner | AdoptedSSRemoveOwner | JSException | Zustand | BatchMetadata | NetworkRequest | WSChannel | ResourceTiming | Incident | LongAnimationTask | InputChange | SelectionChange | MouseThrashing | UnbindNodes | ResourceTimingDeprecated | TabChange | TabData | CanvasNode | TagTrigger | Redux | SetPageLocation | GraphQL | WebVitals;
 export default Message;

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

@@ -1,6 +1,7 @@
 import type { Options as WebworkerOptions } from '../../common/interaction.js';
 import AttributeSender from '../modules/attributeSender.js';
 import type { Options as NetworkOptions } from '../modules/network.js';
+import type TagMatcher from '../modules/tagMatcher.js';
 import Logger, { ILogLevel } from './logger.js';
 import Message from './messages.gen.js';
 import Nodes from './nodes/index.js';
@@ -158,6 +159,7 @@ export default class App {
     private canvasRecorder;
     private conditionsManager;
     private readonly tagWatcher;
+    get tagMatcher(): TagMatcher;
     private canStart;
     private rootId;
     private pageFrames;
@@ -169,11 +171,10 @@ export default class App {
     parentActive: boolean;
     checkStatus: () => boolean;
     parentCrossDomainFrameListener: (event: MessageEvent) => void;
-    /**
-     * context ids for iframes,
-     * order is not so important as long as its consistent
-     * */
     trackedFrames: string[];
+    private frameLastSeen;
+    private readonly FRAME_STALE_MS;
+    private pruneStaleFrames;
     crossDomainIframeListener: (event: MessageEvent) => void;
     /**
      * { command : [remaining iframes] }
@@ -288,6 +289,7 @@ export default class App {
      * */
     uploadOfflineRecording(): Promise<void>;
     prevOpts: StartOptions;
+    private userStartCallback?;
     private _start;
     restartCanvasTracking: () => void;
     flushBuffer: (buffer: Message[]) => Promise<unknown>;

package/dist/types/main/app/messages.gen.d.ts

@@ -62,7 +62,6 @@ export declare function AdoptedSSRemoveOwner(sheetID: number, id: number): Messa
 export declare function JSException(name: string, message: string, payload: string, metadata: string): Messages.JSException;
 export declare function Zustand(mutation: string, state: string): Messages.Zustand;
 export declare function BatchMetadata(version: number, pageNo: number, firstIndex: number, timestamp: number, location: string): Messages.BatchMetadata;
-export declare function PartitionedMessage(partNo: number, partTotal: number): Messages.PartitionedMessage;
 export declare function NetworkRequest(type: string, method: string, url: string, request: string, response: string, status: number, timestamp: number, duration: number, transferredBodySize: number): Messages.NetworkRequest;
 export declare function WSChannel(chType: string, channelName: string, data: string, timestamp: number, dir: string, messageType: string): Messages.WSChannel;
 export declare function ResourceTiming(timestamp: number, duration: number, ttfb: number, headerSize: number, encodedBodySize: number, decodedBodySize: number, url: string, initiator: string, transferredSize: number, cached: boolean, queueing: number, dnsLookup: number, initialConnection: number, ssl: number, contentDownload: number, total: number, stalled: number): Messages.ResourceTiming;

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

@@ -28,6 +28,12 @@ export default abstract class Observer {
     private readonly inlineRemoteCss;
     private readonly inlinerOptions;
     private readonly domParser;
+    /**
+     * Bumped on every disconnect(). Stale async CSS-inlining callbacks from a
+     * previous session (e.g. agent reload → tracker restart) compare against
+     * this and bail instead of sending messages that reference vanished node ids.
+     */
+    private generation;
     constructor(app: App, isTopContext?: boolean, options?: Options);
     private clear;
     /**

package/dist/types/main/modules/tagMatcher.d.ts

@@ -0,0 +1,28 @@
+export type Tag = {
+    id: number;
+    selector: string;
+    location?: string;
+};
+/**
+ * Two-tier tag matching:
+ * 1. Fast fingerprint lookup by id, data-attr,
+ *    or class from the selector's last segment
+ * 2. Fallback iteration using native element.matches()
+ */
+declare class TagMatcher {
+    private tags;
+    private byId;
+    private byDataAttr;
+    private byClass;
+    private fallback;
+    setTags(tags: Tag[]): void;
+    getTags(): Tag[];
+    /** Match element, its parent, or direct children against known tag selectors */
+    match(el: Element): Tag | null;
+    private matchExact;
+    clear(): void;
+}
+export declare function matchesLocation(tag: {
+    location?: string;
+}): boolean;
+export default TagMatcher;

package/dist/types/main/modules/tagWatcher.d.ts

@@ -1,10 +1,9 @@
+import TagMatcher, { type Tag } from './tagMatcher.js';
 export declare const WATCHED_TAGS_KEY = "__or__watched_tags__";
 declare class TagWatcher {
     interval: ReturnType<typeof setInterval> | null;
-    tags: {
-        id: number;
-        selector: string;
-    }[];
+    tags: Tag[];
+    readonly matcher: TagMatcher;
     observer: IntersectionObserver;
     private readonly sessionStorage;
     private readonly errLog;
@@ -15,10 +14,7 @@ declare class TagWatcher {
         onTag: (tag: number) => void;
     });
     fetchTags(ingest: string, token: string): Promise<void>;
-    setTags(tags: {
-        id: number;
-        selector: string;
-    }[]): void;
+    setTags(tags: Tag[]): void;
     onTagRendered(tagId: number): void;
     clear(): void;
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@openreplay/tracker",
   "description": "The OpenReplay tracker main package",
-  "version": "17.2.6",
+  "version": "17.2.9",
   "keywords": [
     "logging",
     "replay"