@sessionsight/insights 1.0.0 → 1.0.1

package/dist/recorder.d.ts

@@ -0,0 +1,115 @@
+import { WorkerBridge } from './worker-bridge.js';
+import type { RecordOptions, PrivacyConfig } from './types.js';
+export declare class Recorder {
+    private bridge;
+    private visitorId;
+    private preBuffer;
+    private isRecording;
+    private stopRrweb;
+    private userId;
+    private userProperties;
+    private userPropertiesDirty;
+    private lastHref;
+    private lastEmittedFlagToken;
+    private flagCheckTimer;
+    private origPushState;
+    private origReplaceState;
+    private formStarted;
+    private formStartTimestamps;
+    private focusTimestamps;
+    private lastMouseMoveEmit;
+    private scrollHistory;
+    private lastScrollDirection;
+    private lastScrollY;
+    private fieldFocusCounts;
+    private lastInteractionTime;
+    private idleTimer;
+    private idleEmitted;
+    private static readonly IDLE_THRESHOLD_MS;
+    private lastErrorMessage;
+    private lastErrorTime;
+    private static readonly SCROLL_DEPTH_THRESHOLDS;
+    private scrollDepthHits;
+    private scrollSentinels;
+    private scrollDepthObserver;
+    private settledSnapshotTimer;
+    private static readonly SETTLED_SNAPSHOT_DELAY_MS;
+    private hiddenAt;
+    private static readonly VISIBILITY_GRACE_MS;
+    endedByVisibility: boolean;
+    private isHidden;
+    private propertyId;
+    private privacyMode;
+    private excludePagePatterns;
+    private isPaused;
+    constructor(bridge: WorkerBridge, propertyId: string, visitorId: string, options?: {
+        privacyMode?: 'default' | 'relaxed';
+        excludePages?: string[];
+    });
+    start(autoRecord: boolean): void;
+    /** Start persisting events to the server. Call after init({ autoRecord: false }). */
+    beginRecording(options?: RecordOptions): void;
+    stop(): void;
+    getVisitorId(): string;
+    getBridge(): WorkerBridge;
+    getPropertyId(): string;
+    identify(userId: string, properties?: Record<string, string | number | boolean>): void;
+    /**
+     * Apply server-delivered privacy configuration. If settings differ from the
+     * current defaults, update the recorder and trigger a fresh FullSnapshot so
+     * replay uses the correct masking from this point forward.
+     */
+    applyPrivacyConfig(config: PrivacyConfig): void;
+    /**
+     * Stamp fixed dimensions onto data-ss-exclude elements so that when rrweb
+     * replaces them with empty placeholders (via blockSelector), the placeholders
+     * preserve the original layout space.
+     */
+    private stampExcludedDimensions;
+    private startRrweb;
+    /**
+     * Schedule a delayed FullSnapshot to capture the page after async content
+     * has loaded (lazy images, client-rendered components, etc.). This gives
+     * the heatmap a much better baseline than the immediate rrweb snapshot.
+     */
+    private scheduleSettledSnapshot;
+    /** Route an event to the bridge or pre-buffer */
+    private pushEvent;
+    /** Trim pre-buffer to keep only the last 5 seconds of events */
+    private trimPreBuffer;
+    private emitCustomEvent;
+    private static readonly INPUT_SELECTOR;
+    /** Find the nearest grouping container: <form>, [data-ss-form], or null (page-level). */
+    private getFormContainer;
+    private getFormInfo;
+    private getFieldInfo;
+    private handleFieldFocus;
+    private handleFieldBlur;
+    private handleClick;
+    private getElementLabel;
+    private handleFormSubmit;
+    private static readonly INTERACTIVE_SELECTOR;
+    private static readonly DEAD_CLICK_DEFER_MS;
+    private handleHeatmapClick;
+    private deferDeadClickCheck;
+    private handleHeatmapMouseMove;
+    private handleHeatmapScroll;
+    private setupScrollDepthObserver;
+    private placeSentinels;
+    private teardownScrollDepthObserver;
+    private sanitizePii;
+    private stripQueryString;
+    private emitErrorEvent;
+    private handleWindowError;
+    private handleUnhandledRejection;
+    private resetIdleTimer;
+    private checkIdle;
+    private handleKeydown;
+    private patchHistoryMethods;
+    private unpatchHistoryMethods;
+    private handleNavigation;
+    private checkFlagToken;
+    private collectMetadata;
+    private handleVisibilityChange;
+    private handleBeforeUnload;
+}