@oxvo/browser 7.1.0 → 7.3.0

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

@@ -5,6 +5,8 @@ interface Options {
     isDebug?: boolean;
     fixedScaling?: boolean;
     useAnimationFrame?: boolean;
+    framesSupport?: boolean;
+    /** @deprecated webp is the default format for pipeline optimization */
     fileExt?: 'webp' | 'png' | 'jpeg' | 'avif';
 }
 declare class CanvasRecorder {
@@ -22,6 +24,12 @@ declare class CanvasRecorder {
     private isProcessingQueue;
     constructor(app: App, options: Options);
     startTracking(): void;
+    /**
+     * Reacts to a runtime sanitization change on a canvas: stop capturing if it
+     * just became masked, start if it just became visible. Already-sent frames
+     * cannot be retracted, so escalation only stops future capture.
+     */
+    resanitizeCanvas: (node: Node, id: number) => void;
     restartTracking: () => void;
     captureCanvas: (node: Node) => void;
     recordCanvas: (node: Node, id: number) => void;

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

@@ -1,13 +1,14 @@
 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';
 import type { Options as ObserverOptions } from './observer/top_observer.js';
 import Observer from './observer/top_observer.js';
 import type { Options as SanitizerOptions } from './sanitizer.js';
-import Sanitizer from './sanitizer.js';
+import Sanitizer, { SanitizeLevel } from './sanitizer.js';
 import type { Options as SessOptions } from './session.js';
 import Session from './session.js';
 import Ticker from './ticker.js';
@@ -64,6 +65,7 @@ type AppOptions = {
     __is_snippet: boolean;
     __debug_report_edp: string | null;
     __debug__?: ILogLevel;
+    __local_debug?: boolean;
     localStorage: Storage | null;
     sessionStorage: Storage | null;
     forceSingleTab?: boolean;
@@ -129,6 +131,7 @@ export default class App {
     readonly ticker: Ticker;
     readonly projectKey: string;
     readonly sanitizer: Sanitizer;
+    private readonly resanitizeCallbacks;
     readonly debug: Logger;
     readonly notify: Logger;
     readonly session: Session;
@@ -159,6 +162,7 @@ export default class App {
     private canvasRecorder;
     private conditionsManager;
     private readonly markerWatcher;
+    get tagMatcher(): TagMatcher;
     private canStart;
     private rootId;
     private pageFrames;
@@ -170,11 +174,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] }
@@ -290,8 +293,13 @@ export default class App {
      * */
     uploadOfflineRecording(): Promise<void>;
     prevOpts: StartOptions;
+    private userStartCallback?;
     private _start;
     restartCanvasTracking: () => void;
+    attachResanitizeCallback: (cb: (node: Node, id: number) => void) => void;
+    callResanitizeCallbacks: (node: Node, id: number) => void;
+    resanitize: (el?: Element) => void;
+    checkSanitization: (el: Node) => SanitizeLevel | undefined;
     flushBuffer: (buffer: Message[]) => Promise<unknown>;
     waitStart(): Promise<unknown>;
     waitStarted(): 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;
     /**
@@ -47,6 +53,16 @@ export default abstract class Observer {
     private commitNode;
     private commitNodes;
     protected observeRoot(node: Node, beforeCommit: (id?: number) => unknown, nodeToBind?: Node): void;
+    /**
+     * Re-evaluates sanitization for every tracked node in `root`'s subtree against
+     * the current DOM and re-emits whatever changed. Pass the highest node you
+     * changed (or the document root) so inherited levels propagate correctly.
+     */
+    resanitizeSubtree(root: Node): void;
+    private resanitizeNode;
+    private recreateSubtree;
+    private clearSubtreeRegistration;
+    private reemitNode;
     disconnect(): void;
 }
 export {};

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

@@ -35,8 +35,7 @@ export interface Options {
 }
 export declare const stringWiper: (input: string) => string;
 export default class Sanitizer {
-    private readonly obscured;
-    private readonly hidden;
+    private readonly levels;
     private readonly options;
     readonly maskAllByDefault: boolean;
     private readonly app;
@@ -44,7 +43,10 @@ export default class Sanitizer {
         app: App;
         options?: Partial<Options>;
     });
-    handleNode(id: number, parentID: number, node: Node): Set<number> | undefined;
+    computeLevel(node: Node, parentLevel: SanitizeLevel): SanitizeLevel;
+    getLevel(id: number): SanitizeLevel;
+    setLevel(id: number, level: SanitizeLevel): SanitizeLevel;
+    handleNode(id: number, parentID: number, node: Node): void;
     sanitize(id: number, data: string): string;
     isObscured(id: number): boolean;
     isHidden(id: number): boolean;

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

@@ -27,6 +27,7 @@ export type Options = Partial<AppOptions & ConsoleOptions & ExceptionOptions & I
     resetTabOnWindowOpen?: boolean;
     networkCapture?: Partial<NetworkOptions>;
     mouse?: Partial<MouseHandlerOptions>;
+    customAttributes?: string[];
     devAllowInsecure?: boolean;
     css: CssRulesOptions;
     webAnimations?: WapOptions;
@@ -46,6 +47,21 @@ export default class API {
     checkDoNotTrack: () => boolean | undefined;
     signalStartIssue: (reason: string, missingApi: string[]) => void;
     restartCanvasTracking: () => void;
+    /**
+     * Re-evaluates sanitization against the current DOM and re-emits whatever
+     * changed, updating already-recorded nodes mid-session. Call after toggling
+     * `data-oxvosessions-*` attributes or after changing whatever your `domSanitizer`
+     * keys on (class/id/etc).
+     *
+     * @param el - the highest node you changed; omit to re-scan the whole document;
+     * scanning the entire doc is O(dom size)
+     * */
+    resanitize: (el?: Element) => void;
+    /**
+     * Returns the sanitization level the tracker currently has for a node
+     * (0 = Plain, 1 = Obscured, 2 = Hidden), or undefined if it isn't tracked.
+     * */
+    checkSanitization: (el: Node) => import("./app/sanitizer.js").SanitizeLevel | undefined;
     use<T>(fn: (app: App | null, options?: Partial<Options>) => T): T;
     isActive(): boolean;
     /**

package/dist/lib/main/modules/analytics/batcher.d.ts

@@ -15,13 +15,15 @@ declare class Batcher {
     private readonly backendUrl;
     private readonly getToken;
     private readonly init;
+    private readonly standalone;
     private readonly autosendInterval;
     private readonly retryTimeout;
     private readonly retryLimit;
     private readonly apiEdp;
     private batch;
     private intervalId;
-    constructor(backendUrl: string, getToken: () => string | null, init: () => Promise<void>);
+    private stopped;
+    constructor(backendUrl: string, getToken: () => string | null, init: () => Promise<void>, standalone: boolean);
     getBatches(): {
         data: {
             user_actions: PeopleEvent[];
@@ -38,8 +40,11 @@ declare class Batcher {
     dedupePeopleEvents(): PeopleEvent[];
     private squashPeopleEvents;
     private sendBatch;
+    private paused;
+    private onVisibilityChange;
     startAutosend(): void;
     flush(): void;
     stop(): void;
+    restart(): void;
 }
 export default Batcher;

package/dist/lib/main/modules/analytics/index.d.ts

@@ -51,6 +51,11 @@ export default class Analytics {
     _getToken: () => string | null;
     _getTimestamp: () => number;
     init: () => Promise<void>;
+    /**
+     * Used by tracker when running in blundled mode
+     */
+    onStart: () => void;
+    onStop: () => void;
     reset: () => void;
     /**
      * COMPATIBILITY LAYER

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

@@ -1,6 +1,6 @@
 import type App from '../app/index.js';
 type TextFieldElement = HTMLInputElement | HTMLTextAreaElement;
-export declare function getInputLabel(node: TextFieldElement): string;
+export declare function getInputLabel(node: TextFieldElement, customAttributes?: string[]): string;
 export declare const InputMode: {
     readonly Plain: 0;
     readonly Obscured: 1;
@@ -29,6 +29,7 @@ export interface Options {
      * will override other settings.
      * */
     inputPrivacyMode: InputModeT;
+    customAttributes?: string[];
 }
 export default function (app: App, opts: Partial<Options>): void;
 export {};

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

@@ -1,10 +1,9 @@
+import TagMatcher, { type Tag } from './tagMatcher.js';
 export declare const WATCHED_MARKERS_KEY = "__or__watched_markers__";
 declare class MarkerWatcher {
     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 MarkerWatcher {
         onMarkerHit: (markerId: number) => void;
     });
     fetchTags(ingest: string, token: string): Promise<void>;
-    setTags(tags: {
-        id: number;
-        selector: string;
-    }[]): void;
+    setTags(tags: Tag[]): void;
     onMarkerRendered(markerId: number): void;
     clear(): void;
 }

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

@@ -8,6 +8,7 @@ export interface MouseHandlerOptions {
      * default 7 = 210ms
      * */
     trackingOffset?: number;
+    customAttributes?: string[];
 }
 export default function (app: App, options?: MouseHandlerOptions): void;
 export declare function getCSSPath(el: any): string | false;

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/singleton.d.ts

@@ -97,6 +97,30 @@ declare class BrowserSingleton {
     forceFlushBatch(): void;
     getSessionMeta(): import("./app/session.js").SessionInfo | null;
     getTabId(): string | null;
+    /**
+     * Re-evaluates sanitization against the current DOM and re-emits whatever
+     * changed, updating already-recorded nodes mid-session. Call after toggling
+     * `data-oxvosessions-*` attributes or after changing whatever your `domSanitizer`
+     * keys on (class/id/etc).
+     *
+     * @param el - the highest node you changed; omit to re-scan the whole document.
+     * */
+    resanitize(el?: Element): void;
+    /**
+     * Returns the sanitization level the tracker currently has for a node
+     * (0 = Plain, 1 = Obscured, 2 = Hidden), or undefined if it isn't tracked.
+     * */
+    checkSanitization(el: Node): import("./index.js").SanitizeLevel | undefined;
+    incident(options: {
+        label?: string;
+        startTime: number;
+        endTime?: number;
+    }): void;
+    /**
+     * Use custom token for analytics events without session recording.
+     * */
+    setAnalyticsToken(token: string): void;
+    getAnalyticsToken(): string | undefined;
 }
 declare const browser: BrowserSingleton;
 export default browser;

package/dist/lib/main/utils.d.ts

@@ -11,6 +11,8 @@ export declare const DOCS_HOST = "https://docs.oxvo.com";
 export declare function isLoopbackHost(hostname: string): boolean;
 export declare function canUseTrackerOrigin(protocol: string, hostname: string, devAllowInsecure?: boolean): boolean;
 export declare function deprecationWarn(nameOfFeature: string, useInstead: string, docsPath?: string): void;
+export declare function getCustomAttributeLabel(e: Element, customAttributes?: string[]): string;
+export declare function getClassSelector(e: Element): string;
 export declare function getLabelAttribute(e: Element): string | null;
 export declare function hasOxvoSessionsAttribute(e: Element, attr: string): boolean;
 /**

package/dist/types/common/interaction.d.ts

@@ -1,4 +1,5 @@
 import Message from './messages.gen.js';
+export type DataType = 'player' | 'assets' | 'devtools' | 'analytics';
 export interface Options {
     connAttemptCount?: number;
     connAttemptGap?: number;
@@ -10,18 +11,22 @@ type Start = {
     timestamp: number;
     url: string;
     tabId: string;
+    localDebug?: boolean;
 } & Options;
 type Auth = {
     type: 'auth';
     token: string;
     beaconSizeLimit?: number;
+    protocolVersion?: number;
 };
 export type ToWorkerData = null | 'stop' | Start | Auth | Array<Message> | {
     type: 'compressed';
     batch: Uint8Array;
+    dataType: DataType;
 } | {
     type: 'uncompressed';
     batch: Uint8Array;
+    dataType: DataType;
 } | 'forceFlushBatch' | 'closing' | 'check_queue';
 type Failure = {
     type: 'failure';
@@ -30,8 +35,14 @@ type Failure = {
 type QEmpty = {
     type: 'queue_empty';
 };
+type LocalSave = {
+    type: 'local_save';
+    name: string;
+    batch: Uint8Array;
+};
 export type FromWorkerData = 'a_stop' | 'a_start' | Failure | 'not_init' | {
     type: 'compress';
     batch: Uint8Array;
-} | QEmpty;
+    dataType: DataType;
+} | QEmpty | LocalSave;
 export {};

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,8 @@ 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;
+export declare const ASSET_MESSAGES: ReadonlySet<number>;
+export declare const DEVTOOLS_MESSAGES: ReadonlySet<number>;
+export declare const ANALYTICS_MESSAGES: ReadonlySet<number>;
+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/canvas.d.ts

@@ -5,6 +5,8 @@ interface Options {
     isDebug?: boolean;
     fixedScaling?: boolean;
     useAnimationFrame?: boolean;
+    framesSupport?: boolean;
+    /** @deprecated webp is the default format for pipeline optimization */
     fileExt?: 'webp' | 'png' | 'jpeg' | 'avif';
 }
 declare class CanvasRecorder {
@@ -22,6 +24,12 @@ declare class CanvasRecorder {
     private isProcessingQueue;
     constructor(app: App, options: Options);
     startTracking(): void;
+    /**
+     * Reacts to a runtime sanitization change on a canvas: stop capturing if it
+     * just became masked, start if it just became visible. Already-sent frames
+     * cannot be retracted, so escalation only stops future capture.
+     */
+    resanitizeCanvas: (node: Node, id: number) => void;
     restartTracking: () => void;
     captureCanvas: (node: Node) => void;
     recordCanvas: (node: Node, id: number) => void;

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

@@ -1,13 +1,14 @@
 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';
 import type { Options as ObserverOptions } from './observer/top_observer.js';
 import Observer from './observer/top_observer.js';
 import type { Options as SanitizerOptions } from './sanitizer.js';
-import Sanitizer from './sanitizer.js';
+import Sanitizer, { SanitizeLevel } from './sanitizer.js';
 import type { Options as SessOptions } from './session.js';
 import Session from './session.js';
 import Ticker from './ticker.js';
@@ -64,6 +65,7 @@ type AppOptions = {
     __is_snippet: boolean;
     __debug_report_edp: string | null;
     __debug__?: ILogLevel;
+    __local_debug?: boolean;
     localStorage: Storage | null;
     sessionStorage: Storage | null;
     forceSingleTab?: boolean;
@@ -129,6 +131,7 @@ export default class App {
     readonly ticker: Ticker;
     readonly projectKey: string;
     readonly sanitizer: Sanitizer;
+    private readonly resanitizeCallbacks;
     readonly debug: Logger;
     readonly notify: Logger;
     readonly session: Session;
@@ -159,6 +162,7 @@ export default class App {
     private canvasRecorder;
     private conditionsManager;
     private readonly markerWatcher;
+    get tagMatcher(): TagMatcher;
     private canStart;
     private rootId;
     private pageFrames;
@@ -170,11 +174,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] }
@@ -290,8 +293,13 @@ export default class App {
      * */
     uploadOfflineRecording(): Promise<void>;
     prevOpts: StartOptions;
+    private userStartCallback?;
     private _start;
     restartCanvasTracking: () => void;
+    attachResanitizeCallback: (cb: (node: Node, id: number) => void) => void;
+    callResanitizeCallbacks: (node: Node, id: number) => void;
+    resanitize: (el?: Element) => void;
+    checkSanitization: (el: Node) => SanitizeLevel | undefined;
     flushBuffer: (buffer: Message[]) => Promise<unknown>;
     waitStart(): Promise<unknown>;
     waitStarted(): 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;
     /**
@@ -47,6 +53,16 @@ export default abstract class Observer {
     private commitNode;
     private commitNodes;
     protected observeRoot(node: Node, beforeCommit: (id?: number) => unknown, nodeToBind?: Node): void;
+    /**
+     * Re-evaluates sanitization for every tracked node in `root`'s subtree against
+     * the current DOM and re-emits whatever changed. Pass the highest node you
+     * changed (or the document root) so inherited levels propagate correctly.
+     */
+    resanitizeSubtree(root: Node): void;
+    private resanitizeNode;
+    private recreateSubtree;
+    private clearSubtreeRegistration;
+    private reemitNode;
     disconnect(): void;
 }
 export {};

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

@@ -35,8 +35,7 @@ export interface Options {
 }
 export declare const stringWiper: (input: string) => string;
 export default class Sanitizer {
-    private readonly obscured;
-    private readonly hidden;
+    private readonly levels;
     private readonly options;
     readonly maskAllByDefault: boolean;
     private readonly app;
@@ -44,7 +43,10 @@ export default class Sanitizer {
         app: App;
         options?: Partial<Options>;
     });
-    handleNode(id: number, parentID: number, node: Node): Set<number> | undefined;
+    computeLevel(node: Node, parentLevel: SanitizeLevel): SanitizeLevel;
+    getLevel(id: number): SanitizeLevel;
+    setLevel(id: number, level: SanitizeLevel): SanitizeLevel;
+    handleNode(id: number, parentID: number, node: Node): void;
     sanitize(id: number, data: string): string;
     isObscured(id: number): boolean;
     isHidden(id: number): boolean;

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

@@ -27,6 +27,7 @@ export type Options = Partial<AppOptions & ConsoleOptions & ExceptionOptions & I
     resetTabOnWindowOpen?: boolean;
     networkCapture?: Partial<NetworkOptions>;
     mouse?: Partial<MouseHandlerOptions>;
+    customAttributes?: string[];
     devAllowInsecure?: boolean;
     css: CssRulesOptions;
     webAnimations?: WapOptions;
@@ -46,6 +47,21 @@ export default class API {
     checkDoNotTrack: () => boolean | undefined;
     signalStartIssue: (reason: string, missingApi: string[]) => void;
     restartCanvasTracking: () => void;
+    /**
+     * Re-evaluates sanitization against the current DOM and re-emits whatever
+     * changed, updating already-recorded nodes mid-session. Call after toggling
+     * `data-oxvosessions-*` attributes or after changing whatever your `domSanitizer`
+     * keys on (class/id/etc).
+     *
+     * @param el - the highest node you changed; omit to re-scan the whole document;
+     * scanning the entire doc is O(dom size)
+     * */
+    resanitize: (el?: Element) => void;
+    /**
+     * Returns the sanitization level the tracker currently has for a node
+     * (0 = Plain, 1 = Obscured, 2 = Hidden), or undefined if it isn't tracked.
+     * */
+    checkSanitization: (el: Node) => import("./app/sanitizer.js").SanitizeLevel | undefined;
     use<T>(fn: (app: App | null, options?: Partial<Options>) => T): T;
     isActive(): boolean;
     /**

package/dist/types/main/modules/analytics/batcher.d.ts

@@ -15,13 +15,15 @@ declare class Batcher {
     private readonly backendUrl;
     private readonly getToken;
     private readonly init;
+    private readonly standalone;
     private readonly autosendInterval;
     private readonly retryTimeout;
     private readonly retryLimit;
     private readonly apiEdp;
     private batch;
     private intervalId;
-    constructor(backendUrl: string, getToken: () => string | null, init: () => Promise<void>);
+    private stopped;
+    constructor(backendUrl: string, getToken: () => string | null, init: () => Promise<void>, standalone: boolean);
     getBatches(): {
         data: {
             user_actions: PeopleEvent[];
@@ -38,8 +40,11 @@ declare class Batcher {
     dedupePeopleEvents(): PeopleEvent[];
     private squashPeopleEvents;
     private sendBatch;
+    private paused;
+    private onVisibilityChange;
     startAutosend(): void;
     flush(): void;
     stop(): void;
+    restart(): void;
 }
 export default Batcher;

package/dist/types/main/modules/analytics/index.d.ts

@@ -51,6 +51,11 @@ export default class Analytics {
     _getToken: () => string | null;
     _getTimestamp: () => number;
     init: () => Promise<void>;
+    /**
+     * Used by tracker when running in blundled mode
+     */
+    onStart: () => void;
+    onStop: () => void;
     reset: () => void;
     /**
      * COMPATIBILITY LAYER