@brainfish-ai/web-tracker 0.0.27 → 0.0.29

package/dist/common/recordingSampler.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Session Recording Sampler
+ *
+ * Provides hash-based deterministic sampling for session recording to reduce recording volume.
+ * Same sessionId always produces the same decision (consistent across tabs and page reloads).
+ */
+/**
+ * Determines whether session recording should be enabled for the current session.
+ * Uses deterministic hash-based sampling for consistency across tabs.
+ *
+ * @param sampleRate - Percentage of sessions to record (0-100).
+ *                     Undefined or invalid values default to 5%.
+ * @param sessionId - Backend session ID for deterministic sampling (required)
+ * @returns true if recording should be enabled, false otherwise
+ */
+export declare function shouldSampleRecording(sampleRate: number | undefined, sessionId: string): boolean;

package/dist/index.d.ts

@@ -1,12 +1,20 @@
 import { TrackerSdkOptions, TrackProperties, TrackerSdk } from '@brainfish-ai/tracker-sdk';
 export type * from '@brainfish-ai/tracker-sdk';
+export type RecordingOptions = {
+    blocklist?: string[];
+    sampleRate?: number;
+    _allowLocalhostRecording?: boolean;
+};
 export type TrackerOptions = TrackerSdkOptions & {
     trackOutgoingLinks?: boolean;
     trackScreenViews?: boolean;
     trackAttributes?: boolean;
     trackHashChanges?: boolean;
     enableRecording?: boolean;
+    recordingOptions?: RecordingOptions;
+    /** @deprecated Use recordingOptions.blocklist instead */
     recordingBlocklist?: string[];
+    /** @deprecated Use recordingOptions._allowLocalhostRecording instead */
     _allowLocalhostRecording?: boolean;
 };
 export declare const VERSION: string;
@@ -18,13 +26,14 @@ export declare class Tracker extends TrackerSdk {
     private readonly sessionManager;
     private readonly recordingBlocklist;
     private isRecordingActive;
+    private onFirstScreenViewTracked;
     constructor(options: TrackerOptions);
     private debounce;
     private isServer;
     trackOutgoingLinks(): void;
     trackScreenViews(): void;
     trackAttributes(): void;
-    startRecording(): void;
+    private startRecording;
     screenView(properties?: TrackProperties): Promise<void>;
     screenView(path: string, properties?: TrackProperties): Promise<void>;
     /**
@@ -33,6 +42,7 @@ export declare class Tracker extends TrackerSdk {
      * @returns Promise that resolves when events are recorded and session is managed
      */
     private recordEventsToServer;
+    private initializeRecordingWithSessionId;
     private sendScreenViewEvent;
     /**
      * Disables privacy-sensitive tracking features and stops active recording.