@v-tilt/browser 1.0.7 → 1.0.9

package/dist/utils/event-utils.d.ts

@@ -1,35 +1,34 @@
 /**
- * Get browser language (PostHog-style)
+ * Get browser language
  * Returns the browser's language setting (e.g., "en-US")
  */
 export declare function getBrowserLanguage(): string | undefined;
 /**
- * Get browser language prefix (PostHog-style)
+ * Get browser language prefix
  * Returns the language code without region (e.g., "en" from "en-US")
  */
 export declare function getBrowserLanguagePrefix(): string | undefined;
 /**
- * Get referrer (PostHog-style)
+ * Get referrer
  * Returns document.referrer or '$direct' if no referrer
  */
 export declare function getReferrer(): string;
 /**
- * Get referring domain (PostHog-style)
+ * Get referring domain
  * Returns the hostname of the referrer URL or '$direct' if no referrer
  */
 export declare function getReferringDomain(): string;
 /**
- * Get timezone (PostHog-style)
+ * Get timezone
  * Returns the timezone (e.g., "America/New_York")
  */
 export declare function getTimezone(): string | undefined;
 /**
- * Get timezone offset (PostHog-style)
+ * Get timezone offset
  * Returns the timezone offset in minutes
  */
 export declare function getTimezoneOffset(): number | undefined;
 /**
- * Get event properties that should be added to all events (PostHog-style)
- * Matches PostHog's getEventProperties() implementation
+ * Get event properties that should be added to all events
  */
 export declare function getEventProperties(): Record<string, any>;

package/dist/utils/index.d.ts

@@ -1,4 +1,3 @@
-import { EventPayload } from "../types";
 /**
  * Generate uuid to identify the session. Random, not data-derived
  */
@@ -11,10 +10,6 @@ export declare function isValidUserAgent(userAgent: string): boolean;
  * Validate payload string
  */
 export declare function isValidPayload(payloadStr: string): boolean;
-/**
- * Try to mask PPI and potential sensible attributes
- */
-export declare function maskSuspiciousAttributes(payload: EventPayload): string;
 /**
  * Check if current environment is a test environment
  */

package/dist/utils/patch.d.ts

@@ -1,8 +1,6 @@
 /**
  * Patch utility for wrapping native methods
- * Based on PostHog's patch implementation from rrweb
  */
-export declare const isFunction: (f: any) => f is (...args: any[]) => any;
 export declare function patch(source: {
     [key: string]: any;
 }, name: string, replacement: (...args: unknown[]) => unknown): () => void;

package/dist/utils/type-utils.d.ts

@@ -0,0 +1,4 @@
+/**
+ * Type guard to check if a value is a function
+ */
+export declare function isFunction(value: any): value is (...args: any[]) => any;

package/dist/vtilt.d.ts

@@ -1,14 +1,20 @@
 import { VTiltConfig, EventPayload } from "./types";
-import { TrackingManager } from "./tracking";
 import { HistoryAutocapture } from "./extensions/history-autocapture";
+interface QueuedRequest {
+    url: string;
+    event: any;
+}
 export declare class VTilt {
     private configManager;
-    trackingManager: TrackingManager;
+    private sessionManager;
+    private userManager;
     private webVitalsManager;
     historyAutocapture?: HistoryAutocapture;
     __loaded: boolean;
     private _initialPageviewCaptured;
     private _visibilityStateListener;
+    __request_queue: QueuedRequest[];
+    private _hasWarnedAboutConfig;
     constructor(config?: Partial<VTiltConfig>);
     /**
      * Initializes a new instance of the VTilt tracking object.
@@ -44,23 +50,57 @@ export declare class VTilt {
     /**
      * Handles the actual initialization logic for a VTilt instance.
      * This internal method should only be called by `init()`.
-     * Follows the PostHog convention of using a private `_init()` method for instance setup.
      */
     private _init;
     /**
-     * Returns a string representation of the instance name (PostHog-style)
+     * Returns a string representation of the instance name
      * Used for debugging and logging
      *
      * @internal
      */
     toString(): string;
     /**
-     * Track a custom event
+     * Get current domain from location
+     * Returns full URL format for consistency with dashboard
+     */
+    private getCurrentDomain;
+    /**
+     * Check if tracking is properly configured
+     * Returns true if projectId and token are present, false otherwise
+     * Logs a warning only once per instance if not configured
+     */
+    private _isConfigured;
+    /**
+     * Build the tracking URL with token in query parameters
+     */
+    private buildUrl;
+    /**
+     * Send HTTP request
+     * This is the central entry point for all tracking requests
+     */
+    private sendRequest;
+    /**
+     * Send a queued request (called after DOM is loaded)
+     */
+    _send_retriable_request(item: QueuedRequest): void;
+    /**
+     * Capture an event
+     * Automatically adds common properties to all events
+     * ($current_url, $host, $pathname, $referrer, $referring_domain, $browser_language, etc.)
+     * Also adds title property for $pageview events only
+     *
+     * @param name - Event name
+     * @param payload - Event payload
+     */
+    capture(name: string, payload: EventPayload): void;
+    /**
+     * Track a custom event (alias for capture)
      */
     trackEvent(name: string, payload?: EventPayload): void;
     /**
-     * Identify a user with PostHog-style property operations
-     * Copied from PostHog's identify method signature
+     * Identify a user with property operations
+     * Sends $identify event when transitioning from anonymous to identified
+     * Event's distinct_id is the previous/anonymous ID, new distinct_id is in payload
      *
      * @example
      * ```js
@@ -77,9 +117,9 @@ export declare class VTilt {
      * vTilt.identify('user_123', { name: 'John Doe', email: 'john@example.com' })
      * ```
      */
-    identify(distinctId?: string, userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
+    identify(newDistinctId?: string, userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
     /**
-     * Set user properties with PostHog-style operations
+     * Set user properties
      * Sets properties on the person profile associated with the current distinct_id
      *
      * @example
@@ -103,7 +143,7 @@ export declare class VTilt {
     setUserProperties(userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
     /**
      * Reset user identity (logout)
-     * PostHog behavior: Clears all user data, generates new anonymous ID
+     * Clears all user data, generates new anonymous ID, resets session
      *
      * @param reset_device_id - If true, also resets device_id. Default: false
      *
@@ -130,7 +170,7 @@ export declare class VTilt {
     getUserState(): "anonymous" | "identified";
     /**
      * Create an alias to link two distinct IDs
-     * PostHog behavior: Links anonymous session to account on signup
+     * Links anonymous session to account on signup
      *
      * @param alias - A unique identifier that you want to use for this user in the future
      * @param original - The current identifier being used for this user (optional, defaults to current distinct_id)
@@ -146,7 +186,6 @@ export declare class VTilt {
     createAlias(alias: string, original?: string): void;
     /**
      * Capture initial pageview with visibility check
-     * Based on PostHog's _captureInitialPageview implementation
      */
     private _captureInitialPageview;
     /**
@@ -179,12 +218,12 @@ export declare class VTilt {
     _dom_loaded(): void;
 }
 /**
- * Initialize vTilt as a module (similar to PostHog's init_as_module)
+ * Initialize vTilt as a module
  * Returns an uninitialized vTilt instance that the user must call init() on
  */
 export declare function init_as_module(): VTilt;
 /**
- * Initialize vTilt from snippet (similar to PostHog's init_from_snippet)
+ * Initialize vTilt from snippet
  * Processes queued calls from the snippet stub and replaces it with real instance
  *
  * The snippet uses some clever tricks to allow deferred loading of array.js (this code)
@@ -214,3 +253,4 @@ export declare function init_as_module(): VTilt;
  * ]
  */
 export declare function init_from_snippet(): void;
+export {};

package/dist/web-vitals.d.ts

@@ -1,9 +1,9 @@
 import { VTiltConfig } from "./types";
-import { TrackingManager } from "./tracking";
+import { VTilt } from "./vtilt";
 export declare class WebVitalsManager {
-    private trackingManager;
+    private instance;
     private webVitals;
-    constructor(config: VTiltConfig, trackingManager: TrackingManager);
+    constructor(config: VTiltConfig, instance: VTilt);
     /**
      * Initialize web vitals tracking
      */

package/lib/constants.d.ts

@@ -9,4 +9,3 @@ export declare const USER_PROPERTIES_KEY = "vt_user_properties";
 export declare const USER_STATE_KEY = "vt_user_state";
 export declare const STORAGE_METHODS: StorageMethods;
 export declare const TIMEZONES: Record<string, string>;
-export declare const ATTRIBUTES_TO_MASK: string[];

package/lib/constants.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ATTRIBUTES_TO_MASK = exports.TIMEZONES = exports.STORAGE_METHODS = exports.USER_STATE_KEY = exports.USER_PROPERTIES_KEY = exports.DEVICE_ID_KEY = exports.DISTINCT_ID_KEY = exports.ANONYMOUS_ID_KEY = exports.PRIMARY_WINDOW_EXISTS_KEY = exports.WINDOW_ID_KEY = exports.STORAGE_KEY = void 0;
+exports.TIMEZONES = exports.STORAGE_METHODS = exports.USER_STATE_KEY = exports.USER_PROPERTIES_KEY = exports.DEVICE_ID_KEY = exports.DISTINCT_ID_KEY = exports.ANONYMOUS_ID_KEY = exports.PRIMARY_WINDOW_EXISTS_KEY = exports.WINDOW_ID_KEY = exports.STORAGE_KEY = void 0;
 exports.STORAGE_KEY = "vt_session_id";
 exports.WINDOW_ID_KEY = "vt_window_id";
 exports.PRIMARY_WINDOW_EXISTS_KEY = "vt_primary_window_exists";
@@ -441,25 +441,3 @@ exports.TIMEZONES = {
     "Asia/Urumqi": "CN",
     "Asia/Calcutta": "IN",
 };
-exports.ATTRIBUTES_TO_MASK = [
-    "username",
-    "user",
-    "user_id",
-    "userid",
-    "password",
-    "pass",
-    "pin",
-    "passcode",
-    "token",
-    "api_token",
-    "email",
-    "address",
-    "phone",
-    "sex",
-    "gender",
-    "order",
-    "order_id",
-    "orderid",
-    "payment",
-    "credit_card",
-];

package/lib/extensions/history-autocapture.d.ts

@@ -2,8 +2,6 @@ import { VTilt } from "../vtilt";
 /**
  * This class is used to capture pageview events when the user navigates using the history API (pushState, replaceState)
  * and when the user navigates using the browser's back/forward buttons.
- *
- * Based on PostHog's HistoryAutocapture implementation
  */
 export declare class HistoryAutocapture {
     private _instance;

package/lib/extensions/history-autocapture.js

@@ -7,8 +7,6 @@ const patch_1 = require("../utils/patch");
 /**
  * This class is used to capture pageview events when the user navigates using the history API (pushState, replaceState)
  * and when the user navigates using the browser's back/forward buttons.
- *
- * Based on PostHog's HistoryAutocapture implementation
  */
 class HistoryAutocapture {
     constructor(instance) {
@@ -40,7 +38,7 @@ class HistoryAutocapture {
         }
         // Initialize last pathname
         this._lastPathname = globals_1.location.pathname || "";
-        // Track history API changes using patch (PostHog-style)
+        // Track history API changes using patch
         if (globals_1.window.history) {
             // Old fashioned, we could also use arrow functions but I think the closure for a patch is more reliable
             // eslint-disable-next-line @typescript-eslint/no-this-alias
@@ -77,11 +75,11 @@ class HistoryAutocapture {
             // Only capture pageview if the pathname has changed and the feature is enabled
             if (currentPathname !== this._lastPathname && this.isEnabled) {
                 // Note: $current_url, $host, $pathname, $referrer, $referring_domain, title
-                // are automatically added by sendEvent() for all events (title only for $pageview)
+                // are automatically added by capture() for all events (title only for $pageview)
                 const payload = {
                     navigation_type: navigationType,
                 };
-                this._instance.trackingManager.sendEvent("$pageview", payload);
+                this._instance.capture("$pageview", payload);
             }
             this._lastPathname = currentPathname;
         }

package/lib/session.d.ts

@@ -38,7 +38,7 @@ export declare class SessionManager {
      */
     private _getSessionIdRaw;
     /**
-     * Get session ID (PostHog-style: always returns a value, generates if needed)
+     * Get session ID (always returns a value, generates if needed)
      */
     getSessionId(): string;
     /**
@@ -51,17 +51,17 @@ export declare class SessionManager {
      */
     private _clearSessionId;
     /**
-     * Reset session ID (PostHog behavior: generates new session on reset)
+     * Reset session ID (generates new session on reset)
      */
     resetSessionId(): void;
     /**
-     * Get window ID (PostHog-style)
+     * Get window ID
      * Window ID is unique per browser tab/window and persists across page reloads
      * Always returns a window_id (generates one if not set)
      */
     getWindowId(): string;
     /**
-     * Set window ID (PostHog-style)
+     * Set window ID
      * Stores in sessionStorage which is unique per tab
      */
     private _setWindowId;
@@ -71,7 +71,7 @@ export declare class SessionManager {
      */
     private _canUseSessionStorage;
     /**
-     * Initialize window ID (PostHog-style)
+     * Initialize window ID
      * Detects tab duplication and handles window_id persistence
      */
     private _initializeWindowId;

package/lib/session.js

@@ -9,7 +9,7 @@ class SessionManager {
         this.storageMethod = storageMethod;
         this.domain = domain;
         this._windowId = undefined;
-        // Initialize window_id (PostHog-style)
+        // Initialize window_id
         this._initializeWindowId();
     }
     /**
@@ -114,11 +114,11 @@ class SessionManager {
         return this.getSessionIdFromCookie();
     }
     /**
-     * Get session ID (PostHog-style: always returns a value, generates if needed)
+     * Get session ID (always returns a value, generates if needed)
      */
     getSessionId() {
         let sessionId = this._getSessionIdRaw();
-        // Generate and store session_id if not found (PostHog-style: always ensure session_id exists)
+        // Generate and store session_id if not found (always ensure session_id exists)
         if (!sessionId) {
             sessionId = (0, utils_1.uuidv4)();
             this._storeSessionId(sessionId);
@@ -157,7 +157,7 @@ class SessionManager {
         }
     }
     /**
-     * Reset session ID (PostHog behavior: generates new session on reset)
+     * Reset session ID (generates new session on reset)
      */
     resetSessionId() {
         this._clearSessionId();
@@ -166,7 +166,7 @@ class SessionManager {
         this._setWindowId((0, utils_1.uuidv4)());
     }
     /**
-     * Get window ID (PostHog-style)
+     * Get window ID
      * Window ID is unique per browser tab/window and persists across page reloads
      * Always returns a window_id (generates one if not set)
      */
@@ -182,13 +182,13 @@ class SessionManager {
                 return windowId;
             }
         }
-        // Generate and store window_id if not found (PostHog-style: always ensure window_id exists)
+        // Generate and store window_id if not found (always ensure window_id exists)
         const newWindowId = (0, utils_1.uuidv4)();
         this._setWindowId(newWindowId);
         return newWindowId;
     }
     /**
-     * Set window ID (PostHog-style)
+     * Set window ID
      * Stores in sessionStorage which is unique per tab
      */
     _setWindowId(windowId) {
@@ -218,7 +218,7 @@ class SessionManager {
         }
     }
     /**
-     * Initialize window ID (PostHog-style)
+     * Initialize window ID
      * Detects tab duplication and handles window_id persistence
      */
     _initializeWindowId() {

package/lib/types.d.ts

@@ -40,6 +40,7 @@ export interface TrackingEvent {
     domain: string;
     payload: EventPayload;
     distinct_id?: string;
+    anonymous_id?: string;
 }
 export type StorageMethod = "cookie" | "localStorage" | "sessionStorage";
 export interface StorageMethods {

package/lib/user-manager.d.ts

@@ -1,4 +1,4 @@
-import { UserIdentity, StorageMethod } from "./types";
+import { UserIdentity, AliasEvent, StorageMethod } from "./types";
 export declare class UserManager {
     private storageMethod;
     private domain?;
@@ -23,11 +23,10 @@ export declare class UserManager {
     getUserProperties(): Record<string, any>;
     /**
      * Identify a user with distinct ID and properties
-     * Copied from PostHog's identify method implementation
      */
     identify(newDistinctId?: string, userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
     /**
-     * Set user properties without changing distinct ID (PostHog-style)
+     * Set user properties without changing distinct ID
      * Sets properties on the person profile associated with the current distinct_id
      *
      * @example
@@ -48,20 +47,15 @@ export declare class UserManager {
      * @param userPropertiesToSet Optional: Properties to set (can be updated)
      * @param userPropertiesToSetOnce Optional: Properties to set once (preserves first value)
      */
-    setUserProperties(userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
+    setUserProperties(userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): boolean;
     /**
-     * Get hash for person properties (PostHog behavior)
+     * Get hash for person properties
      * Used for deduplication of identical setUserProperties calls
      */
     private getPersonPropertiesHash;
-    /**
-     * Send $set event for property updates (PostHog behavior)
-     * This notifies the server when user properties are updated
-     */
-    private sendSetEvent;
     /**
      * Reset user identity (logout)
-     * PostHog behavior: Generates new anonymous ID, clears user data, optionally resets device ID
+     * Generates new anonymous ID, clears user data, optionally resets device ID
      *
      * @param reset_device_id - If true, also resets device_id. Default: false (preserves device_id)
      */
@@ -78,23 +72,43 @@ export declare class UserManager {
      * Get current user state
      */
     getUserState(): "anonymous" | "identified";
+    /**
+     * Update distinct ID (internal use - for VTilt)
+     */
+    setDistinctId(distinctId: string): void;
+    /**
+     * Update user state (internal use - for VTilt)
+     */
+    setUserState(state: "anonymous" | "identified"): void;
+    /**
+     * Update user properties (internal use - for VTilt)
+     */
+    updateUserProperties(userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
+    /**
+     * Set device ID if not already set (internal use - for VTilt)
+     */
+    ensureDeviceId(deviceId: string): void;
+    /**
+     * Check if distinct ID is string-like (hardcoded string) - public for validation
+     * This is a wrapper to expose the private method
+     */
+    isDistinctIdStringLikePublic(distinctId: string): boolean;
     /**
      * Create an alias to link two distinct IDs
-     * PostHog behavior: If original is not provided, uses current distinct_id
-     * If alias matches original, just calls identify instead
+     * If original is not provided, uses current distinct_id
+     * If alias matches original, returns null (caller should use identify instead)
      *
      * @param alias - A unique identifier that you want to use for this user in the future
      * @param original - The current identifier being used for this user (optional, defaults to current distinct_id)
+     * @returns AliasEvent if alias was created, null if alias matches original or invalid
      */
-    createAlias(alias: string, original?: string): void;
+    createAlias(alias: string, original?: string): AliasEvent | null;
     /**
      * Validate distinct ID to prevent hardcoded strings
-     * Copied from PostHog's validation logic
      */
     private isValidDistinctId;
     /**
      * Check if distinct ID is string-like (hardcoded string)
-     * Copied from PostHog's isDistinctIdStringLike function
      */
     private isDistinctIdStringLike;
     /**
@@ -113,10 +127,6 @@ export declare class UserManager {
      * Generate a new device ID
      */
     private generateDeviceId;
-    /**
-     * Send identify event for session merging
-     */
-    private sendIdentifyEvent;
     /**
      * Get stored value from storage
      */