@sessionvision/core 0.2.0 → 0.4.0

package/dist/vue/recorder/mask.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Privacy & masking bridge for session recordings
+ * Bridges rrweb's masking callbacks with the SDK's existing PII detection
+ */
+/**
+ * Mask text content for rrweb's maskTextFn callback
+ */
+export declare function maskTextForRecording(text: string): string;
+/**
+ * Mask input values for rrweb's maskInputFn callback
+ * Respects data-sessionvision-unmask attribute
+ */
+export declare function maskInputForRecording(text: string, element: HTMLElement): string;

package/dist/vue/recorder/rrweb.d.ts

@@ -0,0 +1,19 @@
+/**
+ * rrweb integration module
+ * Wraps rrweb with configured capture options and handles events
+ */
+import { RecordingEvent, ResolvedConfig } from '../types';
+type EventCallback = (event: RecordingEvent) => void;
+/**
+ * Start rrweb recording
+ */
+export declare function startRrwebRecording(config: ResolvedConfig, onEvent: EventCallback): void;
+/**
+ * Stop rrweb recording
+ */
+export declare function stopRrwebRecording(): void;
+/**
+ * Check if rrweb is currently recording
+ */
+export declare function isRrwebRecording(): boolean;
+export {};

package/dist/vue/recorder/upload.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Upload manager for recording chunks
+ * Sends recording chunks to the ingest API as $recording events
+ */
+import { RecordingEvent, ResolvedConfig } from '../types';
+interface ChunkPayload {
+    chunkNumber: number;
+    startTime: number;
+    endTime: number;
+    events: RecordingEvent[];
+    fullSnapshotIncluded: boolean;
+    tags?: Record<string, string>;
+    isFirstChunk: boolean;
+}
+/**
+ * Send a recording chunk to the ingest API
+ * Uses the same endpoint as regular events with the $recording event name
+ */
+export declare function sendRecordingChunk(config: ResolvedConfig, chunk: ChunkPayload): Promise<boolean>;
+export {};

package/dist/vue/types.d.ts

@@ -8,9 +8,15 @@ export interface AutocaptureConfig {
     /** Capture $pageview events (default: true) */
     pageview?: boolean;
     /** Capture $click events (default: true) */
-    clicks?: boolean;
+    click?: boolean;
     /** Capture $form_submit events (default: true) */
     formSubmit?: boolean;
+    /** Detect rage clicks - rapid repeated clicks indicating frustration (default: true) */
+    rageClick?: boolean;
+    /** Detect dead clicks - clicks with no DOM response (default: true) */
+    deadClick?: boolean;
+    /** Track form field interactions for abandonment analysis (default: true) */
+    formAbandonment?: boolean;
 }
 /**
  * SDK configuration options passed to init()
@@ -30,6 +36,10 @@ export interface SessionVisionConfig {
     maskAllInputs?: boolean;
     /** Enable/disable auto-capture (default: true) */
     autocapture?: boolean | AutocaptureConfig;
+    /** Override recording behavior. Set false to force-disable regardless of remote config. */
+    recording?: false | {
+        maskAllInputs?: boolean;
+    };
 }
 /**
  * Internal resolved configuration
@@ -44,12 +54,22 @@ export interface ResolvedConfig {
     maskAllInputs: boolean;
     autocapture: {
         pageview: boolean;
-        clicks: boolean;
+        click: boolean;
         formSubmit: boolean;
+        rageClick: boolean;
+        deadClick: boolean;
+        formAbandonment: boolean;
+    };
+    recording?: false | {
+        maskAllInputs?: boolean;
     };
 }
 /**
  * Remote configuration fetched from server
+ *
+ * Only recording and session settings are remotely configurable.
+ * Autocapture settings (including rage/dead click detection) are
+ * configured locally via init() options.
  */
 export interface RemoteConfig {
     recording?: {
@@ -59,7 +79,6 @@ export interface RemoteConfig {
     session?: {
         timeoutMinutes: number;
     };
-    version?: string;
 }
 /**
  * User traits for identify()
@@ -123,6 +142,65 @@ export interface ClickEventProperties extends EventProperties {
     $element_selector: string;
     $element_href: string | null;
 }
+/**
+ * Rage click event properties
+ */
+export interface RageClickEventProperties extends EventProperties {
+    $element_tag: string;
+    $element_text: string;
+    $element_classes: string;
+    $element_id: string | null;
+    $element_selector: string;
+    $element_href: string | null;
+    $click_count: number;
+    $rage_click_duration_ms: number;
+    $click_x: number;
+    $click_y: number;
+    $element_x: number;
+    $element_y: number;
+    $click_positions: Array<{
+        x: number;
+        y: number;
+        timestamp: number;
+    }>;
+}
+/**
+ * Dead click event properties
+ */
+export interface DeadClickEventProperties extends EventProperties {
+    $element_tag: string;
+    $element_text: string;
+    $element_classes: string;
+    $element_id: string | null;
+    $element_selector: string;
+    $element_href: string | null;
+    $click_x: number;
+    $click_y: number;
+    $element_x: number;
+    $element_y: number;
+    $wait_duration_ms: number;
+    $element_is_interactive: boolean;
+}
+/**
+ * Form start event properties
+ */
+export interface FormStartEventProperties extends EventProperties {
+    $form_id: string | null;
+    $form_name: string | null;
+    $form_selector: string;
+    $form_field_count: number;
+}
+/**
+ * Form field change event properties
+ */
+export interface FormFieldChangeEventProperties extends EventProperties {
+    $form_selector: string;
+    $field_selector: string;
+    $field_name: string | null;
+    $field_type: string;
+    $field_index: number;
+    $has_value: boolean;
+}
 /**
  * Form submit event properties
  */
@@ -131,6 +209,12 @@ export interface FormSubmitEventProperties extends EventProperties {
     $form_action: string;
     $form_method: string;
     $form_name: string | null;
+    $form_selector: string;
+    $form_field_count: number;
+    $form_fields_filled: string[];
+    $form_fields_interacted: string[];
+    $form_completion_rate: number;
+    $form_time_to_submit_ms: number | null;
 }
 /**
  * Pageview event properties
@@ -185,6 +269,20 @@ export interface SessionVisionAPI {
     register(properties: EventProperties): void;
     /** Register properties only if they don't already exist */
     registerOnce(properties: EventProperties): void;
+    /** Manually flush the event buffer */
+    flushEvents(): Promise<void>;
+    /** Subscribe to SDK events (e.g., 'recording:error', 'recording:quota_exceeded') */
+    on(event: string, callback: (data?: unknown) => void): void;
+    /** Unsubscribe from SDK events */
+    off(event: string, callback: (data?: unknown) => void): void;
+    /** Manually start recording. Respects remote config — no-op if recording.enabled is false. Bypasses sampling when recording is enabled. */
+    startRecording(): void;
+    /** Stop recording for this session */
+    stopRecording(): void;
+    /** Check if recording is active */
+    isRecording(): boolean;
+    /** Tag the current recording with custom metadata */
+    tagRecording(tags: Record<string, string>): void;
     /** SDK version */
     version: string;
     /** Internal: queued method calls before SDK loads */
@@ -194,6 +292,23 @@ export interface SessionVisionAPI {
     /** Internal: SDK version marker */
     __SV?: number;
 }
+/**
+ * Recording event type (rrweb event)
+ */
+export interface RecordingEvent {
+    type: number;
+    data: unknown;
+    timestamp: number;
+}
+/**
+ * Recording chunk configuration
+ */
+export declare const RECORDING_CONFIG: {
+    readonly FLUSH_INTERVAL_MS: 5000;
+    readonly MAX_BUFFER_SIZE_BYTES: number;
+    readonly FULL_SNAPSHOT_INTERVAL_MS: number;
+    readonly RETRY_DELAY_MS: 2000;
+};
 /**
  * Storage key constants
  */
@@ -223,6 +338,6 @@ export declare const BUFFER_CONFIG: {
     readonly RETRY_DELAYS_MS: readonly [1000, 2000, 4000];
 };
 /**
- * Config cache TTL in milliseconds (1 hour)
+ * Config cache TTL in milliseconds (4 hours)
  */
 export declare const CONFIG_CACHE_TTL_MS: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sessionvision/core",
-  "version": "0.2.0",
+  "version": "0.4.0",
   "description": "Session Vision client-side tracking library",
   "type": "module",
   "main": "dist/sessionvision.cjs.js",
@@ -57,16 +57,16 @@
   "author": "Session Vision",
   "license": "MIT",
   "devDependencies": {
-    "@testing-library/jest-dom": "^6.5.0",
-    "@testing-library/react": "^16.0.1",
-    "@testing-library/user-event": "^14.5.2",
     "@eslint/js": "^9.18.0",
-    "@playwright/test": "^1.41.0",
+    "@playwright/test": "^1.56.0",
     "@rollup/plugin-commonjs": "^25.0.7",
     "@rollup/plugin-node-resolve": "^15.2.3",
     "@rollup/plugin-replace": "^5.0.5",
     "@rollup/plugin-terser": "^0.4.4",
     "@rollup/plugin-typescript": "^11.1.6",
+    "@testing-library/jest-dom": "^6.5.0",
+    "@testing-library/react": "^16.0.1",
+    "@testing-library/user-event": "^14.5.2",
     "@types/jest": "^29.5.12",
     "@types/react": "^18.3.12",
     "@types/react-dom": "^18.3.0",
@@ -76,9 +76,9 @@
     "jest": "^29.7.0",
     "jest-environment-jsdom": "^29.7.0",
     "prettier": "^3.4.2",
-    "rollup": "^4.9.6",
     "react": "^18.3.1",
     "react-dom": "^18.3.1",
+    "rollup": "^4.9.6",
     "ts-jest": "^29.1.2",
     "tslib": "^2.6.2",
     "typescript": "^5.3.3",
@@ -105,5 +105,8 @@
     "last 2 Firefox versions",
     "last 2 Safari versions",
     "last 2 Edge versions"
-  ]
+  ],
+  "dependencies": {
+    "rrweb": "^2.0.0-alpha.18"
+  }
 }