@sessionvision/core 0.2.0 → 0.3.0

package/dist/types/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()
@@ -44,12 +50,19 @@ export interface ResolvedConfig {
     maskAllInputs: boolean;
     autocapture: {
         pageview: boolean;
-        clicks: boolean;
+        click: boolean;
         formSubmit: boolean;
+        rageClick: boolean;
+        deadClick: boolean;
+        formAbandonment: 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 +72,6 @@ export interface RemoteConfig {
     session?: {
         timeoutMinutes: number;
     };
-    version?: string;
 }
 /**
  * User traits for identify()
@@ -123,6 +135,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 +202,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 +262,8 @@ 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>;
     /** SDK version */
     version: string;
     /** Internal: queued method calls before SDK loads */

package/dist/vue/capture/autocapture.d.ts

@@ -1,6 +1,7 @@
 /**
  * Autocapture module
- * Handles automatic capture of clicks and form submissions
+ * Handles automatic capture of clicks, form submissions,
+ * rage clicks, and dead clicks
  */
 import { ResolvedConfig } from '../types';
 /**

package/dist/vue/capture/deadclick.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Dead Click Detection
+ *
+ * Detects clicks that produce no visible DOM changes.
+ * Emits $dead_click events when no response is detected.
+ */
+import { ResolvedConfig } from '../types';
+export declare function shouldExcludeFromDeadClick(element: Element): boolean;
+export declare class DeadClickDetector {
+    private static readonly DEFAULT_TIMEOUT_MS;
+    private pendingClick;
+    private timeoutMs;
+    constructor(_config: ResolvedConfig);
+    monitorClick(event: MouseEvent, element: Element, properties: Record<string, unknown>): void;
+    private cancelPending;
+    private isMeaningfulMutation;
+    private emitDeadClick;
+    destroy(): void;
+}

package/dist/vue/capture/formfields.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Form Field Tracking
+ *
+ * Tracks form field interactions for abandonment analysis.
+ * Emits $form_start when user begins filling a form,
+ * $form_field_change when fields are modified.
+ */
+import { ResolvedConfig } from '../types';
+/**
+ * State for a form that has been started
+ */
+interface FormState {
+    startTime: number;
+    fieldCount: number;
+    interactedFields: Set<string>;
+    filledFields: Set<string>;
+}
+/**
+ * Get the current state for a form
+ */
+export declare function getFormState(formSelector: string): FormState | undefined;
+/**
+ * Reset tracking for a specific form (called after submit)
+ */
+export declare function resetForm(formSelector: string): void;
+/**
+ * Get form tracking data for enhanced submit event
+ */
+export declare function getFormTrackingData(form: HTMLFormElement): {
+    formSelector: string;
+    formFieldCount: number;
+    formFieldsFilled: string[];
+    formFieldsInteracted: string[];
+    formCompletionRate: number;
+    formTimeToSubmitMs: number | null;
+};
+/**
+ * Initialize form field tracking
+ */
+export declare function initFormFieldTracking(_cfg: ResolvedConfig): void;
+/**
+ * Stop form field tracking
+ */
+export declare function stopFormFieldTracking(): void;
+/**
+ * Check if form field tracking is active
+ */
+export declare function isFormFieldTrackingEnabled(): boolean;
+/**
+ * Reset for testing
+ */
+export declare function _reset(): void;
+export {};

package/dist/vue/capture/rageclick.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Rage Click Detection
+ *
+ * Detects rapid repeated clicks indicating user frustration.
+ * Emits a single $rage_click event after the click sequence ends.
+ */
+import { ResolvedConfig } from '../types';
+export declare function shouldExcludeFromRageClick(element: Element): boolean;
+export declare class RageClickDetector {
+    private clicks;
+    private emitTimeout;
+    private threshold;
+    private windowMs;
+    private radiusPx;
+    private static readonly DEFAULT_THRESHOLD;
+    private static readonly DEFAULT_WINDOW_MS;
+    private static readonly DEFAULT_RADIUS_PX;
+    constructor(_config: ResolvedConfig);
+    recordClick(event: MouseEvent, element: Element, properties: Record<string, unknown>): void;
+    private scheduleEmit;
+    private maybeEmitRageClick;
+    private isClickCluster;
+    private emitRageClick;
+    destroy(): void;
+}

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()
@@ -44,12 +50,19 @@ export interface ResolvedConfig {
     maskAllInputs: boolean;
     autocapture: {
         pageview: boolean;
-        clicks: boolean;
+        click: boolean;
         formSubmit: boolean;
+        rageClick: boolean;
+        deadClick: boolean;
+        formAbandonment: 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 +72,6 @@ export interface RemoteConfig {
     session?: {
         timeoutMinutes: number;
     };
-    version?: string;
 }
 /**
  * User traits for identify()
@@ -123,6 +135,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 +202,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 +262,8 @@ 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>;
     /** SDK version */
     version: string;
     /** Internal: queued method calls before SDK loads */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sessionvision/core",
-  "version": "0.2.0",
+  "version": "0.3.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",