@v-tilt/browser 1.0.7 → 1.0.9

package/lib/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 {};