@v-tilt/browser 1.10.0 → 1.10.2

package/dist/module.d.ts

@@ -71,6 +71,8 @@ interface VTiltConfig {
     capture_pageview?: boolean | "auto";
     /** Enable page leave tracking */
     capture_pageleave?: boolean | "if_capture_pageview";
+    /** Enable rage click detection (rapid clicks in same area) */
+    rageclick?: boolean;
     /** Disable compression */
     disable_compression?: boolean;
     /** Whether to stringify payload before sending */
@@ -275,6 +277,34 @@ interface AutocaptureOptions {
      * Capture text content from copy/cut events (default: false)
      */
     capture_copied_text?: boolean;
+    /**
+     * Mask all text content in captured elements (use placeholder).
+     * Overrides VTiltConfig.mask_all_text for autocapture specifically.
+     */
+    mask_all_text?: boolean;
+    /**
+     * Mask all element attributes (only safe attributes or none).
+     * Overrides VTiltConfig.mask_all_element_attributes for autocapture specifically.
+     */
+    mask_all_element_attributes?: boolean;
+    /**
+     * Capture form field values on change events (default: false)
+     *
+     * When enabled, captures $el_value and $selected_text properties:
+     * - $el_value: The programmatic value (input.value, option.value, checkbox checked state)
+     * - $selected_text: Human-readable selection (option text, checkbox label)
+     *
+     * Protected by multiple privacy layers:
+     * - Password and hidden inputs are never captured
+     * - Fields with sensitive names (cc, pass, ssn, etc.) are skipped
+     * - Credit card and SSN patterns in values are filtered out
+     * - Elements with vt-sensitive or vt-no-capture classes are excluded
+     *
+     * Use case: Tracking search keywords, filter selections, etc.
+     *
+     * @default false
+     */
+    capture_element_values?: boolean;
 }
 /** Mask options for input elements in session recording */
 interface SessionRecordingMaskInputOptions {
@@ -404,6 +434,10 @@ interface RemoteConfig {
         ipAnonymization?: boolean;
     };
     featureFlags?: FeatureFlagsConfig;
+    /** Whether to send elements as chain string (PostHog compatibility) */
+    elementsChainAsString?: boolean;
+    /** Server-side autocapture opt-out */
+    autocapture_opt_out?: boolean;
 }
 
 /**
@@ -864,64 +898,11 @@ declare class HistoryAutocapture implements Feature {
     private _capturePageview;
 }
 
-/**
- * Autocapture Types
- *
- * Type definitions for the DOM autocapture feature.
- * Following PostHog's patterns for element capture and privacy.
- */
-/**
- * Autocapture configuration options
- * Controls what events and elements are captured
- */
-interface AutocaptureConfig {
-    /**
-     * Enable autocapture (default: true when autocapture config is present)
-     */
-    enabled?: boolean;
-    /**
-     * URL patterns to allow autocapture on (default: all URLs)
-     * Supports strings (exact match) and RegExp patterns
-     */
-    url_allowlist?: (string | RegExp)[];
-    /**
-     * URL patterns to exclude from autocapture
-     * Supports strings (exact match) and RegExp patterns
-     */
-    url_ignorelist?: (string | RegExp)[];
-    /**
-     * DOM events to capture (default: ['click', 'change', 'submit'])
-     */
-    dom_event_allowlist?: AutocaptureEventType[];
-    /**
-     * Element tags to capture (default: ['a', 'button', 'form', 'input', 'select', 'textarea', 'label'])
-     */
-    element_allowlist?: string[];
-    /**
-     * CSS selectors to allow for capture (elements matching these are always captured)
-     * Example: ['[data-track]', '.track-click']
-     */
-    css_selector_allowlist?: string[];
-    /**
-     * Element attributes to exclude from capture
-     * Example: ['data-secret', 'aria-label']
-     */
-    element_attribute_ignorelist?: string[];
-    /**
-     * Capture text content from copy/cut events (default: false)
-     */
-    capture_copied_text?: boolean;
-}
-/**
- * Supported DOM event types for autocapture
- */
-type AutocaptureEventType = "click" | "change" | "submit";
-
 /**
  * Autocapture
  *
  * Automatic DOM event capture for clicks, form submissions, and input changes.
- * Following PostHog's privacy-first approach with element chain tracking.
+ * Privacy-first approach with element chain tracking and sensitive data filtering.
  */
 
 /**
@@ -931,72 +912,30 @@ type AutocaptureEventType = "click" | "change" | "submit";
 declare class Autocapture implements Feature {
     readonly name = "Autocapture";
     private _instance;
-    private _config;
-    private _isStarted;
-    private _eventHandlers;
-    constructor(instance: VTilt, config?: AutocaptureConfig);
-    /**
-     * Extract autocapture config from VTiltConfig.
-     * This allows the feature to be self-contained - vtilt.ts doesn't need
-     * to know about autocapture-specific config transformations.
-     */
-    static extractConfig(config: VTiltConfig): AutocaptureConfig;
-    /**
-     * Check if autocapture is enabled
-     */
+    private _initialized;
+    private _isDisabledServerSide;
+    private _elementSelectors;
+    private _rageclicks;
+    private _elementsChainAsString;
+    constructor(instance: VTilt);
+    private get _config();
     get isEnabled(): boolean;
-    /**
-     * Check if autocapture is currently active
-     */
     get isStarted(): boolean;
-    /**
-     * Start autocapture if enabled (Feature interface)
-     */
     startIfEnabled(): void;
-    /**
-     * Stop autocapture (Feature interface)
-     */
     stop(): void;
+    onConfigUpdate(_config: VTiltConfig): void;
+    onRemoteConfig(response: RemoteConfig): void;
     /**
-     * Handle config updates (Feature interface)
-     */
-    onConfigUpdate(config: VTiltConfig): void;
-    /**
-     * Update autocapture configuration
-     */
-    updateConfig(config: Partial<AutocaptureConfig>): void;
-    /**
-     * Start autocapture
-     */
-    private _start;
-    /**
-     * Add DOM event handlers
-     */
-    private _addEventHandlers;
-    /**
-     * Remove DOM event handlers
-     */
-    private _removeEventHandlers;
-    /**
-     * Create event handler for a specific event type
-     */
-    private _createEventHandler;
-    /**
-     * Capture a DOM event
+     * Update autocapture configuration (for programmatic control)
      */
+    updateConfig(config: Partial<{
+        enabled: boolean;
+    }>): void;
+    setElementSelectors(selectors: Set<string>): void;
+    getElementSelectors(element: Element | null): string[] | null;
+    private _addDomEventHandlers;
     private _captureEvent;
-    /**
-     * Build properties for an autocapture event
-     */
-    private _buildEventProperties;
-    /**
-     * Add element-specific properties
-     */
-    private _addElementSpecificProps;
-    /**
-     * Add event-specific properties
-     */
-    private _addEventSpecificProps;
+    private _isBrowserSupported;
 }
 
 /**
@@ -1662,7 +1601,7 @@ declare class SimpleEventEmitter {
  */
 
 declare class VTilt {
-    readonly version = "1.10.0";
+    readonly version: string;
     __loaded: boolean;
     __request_queue: QueuedRequest[];
     historyAutocapture?: HistoryAutocapture;