@v-tilt/browser 1.0.8 → 1.0.10

package/lib/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/web-vitals.js

@@ -4,8 +4,8 @@ exports.WebVitalsManager = void 0;
 const geolocation_1 = require("./geolocation");
 const globals_1 = require("./utils/globals");
 class WebVitalsManager {
-    constructor(config, trackingManager) {
-        this.trackingManager = trackingManager;
+    constructor(config, instance) {
+        this.instance = instance;
         // Load web-vitals if enabled and in browser environment (not SSR)
         if (config.webVitals && globals_1.window) {
             try {
@@ -33,7 +33,7 @@ class WebVitalsManager {
                     return;
                 }
                 const { country, locale } = (0, geolocation_1.getCountryAndLocale)();
-                this.trackingManager.sendEvent("web_vital", {
+                this.instance.capture("web_vital", {
                     name: metric.name,
                     value: metric.value,
                     delta: metric.delta,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@v-tilt/browser",
-  "version": "1.0.8",
+  "version": "1.0.10",
   "description": "vTilt browser tracking library",
   "main": "dist/main.js",
   "module": "dist/module.js",

package/dist/tracking.d.ts

@@ -1,120 +0,0 @@
-import { VTiltConfig, EventPayload } from "./types";
-interface QueuedRequest {
-    url: string;
-    event: any;
-}
-export declare class TrackingManager {
-    private config;
-    private sessionManager;
-    private userManager;
-    __request_queue: QueuedRequest[];
-    private _hasWarnedAboutConfig;
-    constructor(config: VTiltConfig);
-    /**
-     * 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;
-    /**
-     * Send event to endpoint
-     * PostHog-style: 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
-     */
-    sendEvent(name: string, payload: EventPayload): Promise<void>;
-    /**
-     * Build the tracking URL with token in query parameters (PostHog style)
-     */
-    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;
-    /**
-     * Get current session ID
-     */
-    getSessionId(): string | null;
-    /**
-     * Identify a user with PostHog-style property operations
-     * Copied from PostHog's identify method signature
-     */
-    identify(distinctId?: string, userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
-    /**
-     * Set user properties (PostHog-style)
-     */
-    setUserProperties(userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
-    /**
-     * Reset user identity (logout)
-     * PostHog behavior: Clears all user data, generates new anonymous ID, resets session
-     *
-     * @param reset_device_id - If true, also resets device_id. Default: false
-     */
-    resetUser(reset_device_id?: boolean): void;
-    /**
-     * Get current user identity
-     */
-    getUserIdentity(): import("./types").UserIdentity;
-    /**
-     * Get current device ID
-     */
-    getDeviceId(): string;
-    /**
-     * Get current user state
-     */
-    getUserState(): "anonymous" | "identified";
-    /**
-     * Create an alias to link two distinct IDs
-     * PostHog behavior: 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)
-     *
-     * @example
-     * // Link anonymous user to account on signup
-     * vtilt.createAlias('user_12345')
-     *
-     * @example
-     * // Explicit alias with original ID
-     * vtilt.createAlias('user_12345', 'anonymous_abc123')
-     */
-    createAlias(alias: string, original?: string): void;
-    /**
-     * Setup listener for identify, set, and alias events
-     */
-    private setupIdentifyListener;
-    /**
-     * Get session and window IDs (PostHog-style)
-     * Both methods ensure IDs always exist (generate if needed)
-     */
-    private _getSessionAndWindowIds;
-    /**
-     * Create base tracking event structure
-     */
-    private _createTrackingEvent;
-    /**
-     * Send identify event for session merging
-     */
-    private sendIdentifyEvent;
-    /**
-     * Send $set event for property updates (PostHog behavior)
-     * This notifies Tinybird when user properties are updated
-     */
-    private sendSetEvent;
-    /**
-     * Send alias event for identity linking
-     * PostHog format: { alias: alias, distinct_id: original }
-     */
-    private sendAliasEvent;
-}
-export {};

package/dist/utils/is-function.d.ts

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

package/lib/tracking.d.ts

@@ -1,120 +0,0 @@
-import { VTiltConfig, EventPayload } from "./types";
-interface QueuedRequest {
-    url: string;
-    event: any;
-}
-export declare class TrackingManager {
-    private config;
-    private sessionManager;
-    private userManager;
-    __request_queue: QueuedRequest[];
-    private _hasWarnedAboutConfig;
-    constructor(config: VTiltConfig);
-    /**
-     * 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;
-    /**
-     * Send event to endpoint
-     * PostHog-style: 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
-     */
-    sendEvent(name: string, payload: EventPayload): Promise<void>;
-    /**
-     * Build the tracking URL with token in query parameters (PostHog style)
-     */
-    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;
-    /**
-     * Get current session ID
-     */
-    getSessionId(): string | null;
-    /**
-     * Identify a user with PostHog-style property operations
-     * Copied from PostHog's identify method signature
-     */
-    identify(distinctId?: string, userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
-    /**
-     * Set user properties (PostHog-style)
-     */
-    setUserProperties(userPropertiesToSet?: Record<string, any>, userPropertiesToSetOnce?: Record<string, any>): void;
-    /**
-     * Reset user identity (logout)
-     * PostHog behavior: Clears all user data, generates new anonymous ID, resets session
-     *
-     * @param reset_device_id - If true, also resets device_id. Default: false
-     */
-    resetUser(reset_device_id?: boolean): void;
-    /**
-     * Get current user identity
-     */
-    getUserIdentity(): import("./types").UserIdentity;
-    /**
-     * Get current device ID
-     */
-    getDeviceId(): string;
-    /**
-     * Get current user state
-     */
-    getUserState(): "anonymous" | "identified";
-    /**
-     * Create an alias to link two distinct IDs
-     * PostHog behavior: 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)
-     *
-     * @example
-     * // Link anonymous user to account on signup
-     * vtilt.createAlias('user_12345')
-     *
-     * @example
-     * // Explicit alias with original ID
-     * vtilt.createAlias('user_12345', 'anonymous_abc123')
-     */
-    createAlias(alias: string, original?: string): void;
-    /**
-     * Setup listener for identify, set, and alias events
-     */
-    private setupIdentifyListener;
-    /**
-     * Get session and window IDs (PostHog-style)
-     * Both methods ensure IDs always exist (generate if needed)
-     */
-    private _getSessionAndWindowIds;
-    /**
-     * Create base tracking event structure
-     */
-    private _createTrackingEvent;
-    /**
-     * Send identify event for session merging
-     */
-    private sendIdentifyEvent;
-    /**
-     * Send $set event for property updates (PostHog behavior)
-     * This notifies Tinybird when user properties are updated
-     */
-    private sendSetEvent;
-    /**
-     * Send alias event for identity linking
-     * PostHog format: { alias: alias, distinct_id: original }
-     */
-    private sendAliasEvent;
-}
-export {};

package/lib/tracking.js

@@ -1,338 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.TrackingManager = void 0;
-const session_1 = require("./session");
-const user_manager_1 = require("./user-manager");
-const utils_1 = require("./utils");
-const event_utils_1 = require("./utils/event-utils");
-const globals_1 = require("./utils/globals");
-class TrackingManager {
-    constructor(config) {
-        this.__request_queue = [];
-        this._hasWarnedAboutConfig = false; // Track if we've already warned about missing config
-        this.config = config;
-        // Auto-detect domain from location if not provided
-        if (!this.config.domain && globals_1.location) {
-            this.config.domain = this.getCurrentDomain();
-        }
-        this.sessionManager = new session_1.SessionManager(config.storage || "cookie", this.config.domain);
-        this.userManager = new user_manager_1.UserManager(config.persistence || "localStorage", this.config.domain);
-        // Listen for identify events
-        this.setupIdentifyListener();
-    }
-    /**
-     * Get current domain from location
-     * Returns full URL format for consistency with dashboard
-     */
-    getCurrentDomain() {
-        if (!globals_1.location) {
-            return "";
-        }
-        const protocol = globals_1.location.protocol;
-        const hostname = globals_1.location.hostname;
-        const port = globals_1.location.port;
-        const portSuffix = port ? `:${port}` : "";
-        return `${protocol}//${hostname}${portSuffix}`;
-    }
-    /**
-     * 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
-     */
-    _isConfigured() {
-        if (this.config.projectId && this.config.token) {
-            return true;
-        }
-        // Only warn once to avoid console spam
-        if (!this._hasWarnedAboutConfig) {
-            console.warn("VTilt: projectId and token are required for tracking. " +
-                "Events will be skipped until init() or updateConfig() is called with these fields.");
-            this._hasWarnedAboutConfig = true;
-        }
-        return false;
-    }
-    /**
-     * Send event to endpoint
-     * PostHog-style: 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
-     */
-    async sendEvent(name, payload) {
-        this.sessionManager.setSessionId();
-        // Only send events in browser environment (not SSR)
-        if (!globals_1.navigator || !globals_1.navigator.userAgent) {
-            return;
-        }
-        if (!(0, utils_1.isValidUserAgent)(globals_1.navigator.userAgent)) {
-            return;
-        }
-        const url = this.buildUrl();
-        // Add properties to all events (PostHog-style)
-        // This includes: $current_url, $host, $pathname, $referrer, $referring_domain, $browser_language, etc.
-        const eventProperties = (0, event_utils_1.getEventProperties)();
-        // Get session and window IDs (PostHog-style)
-        // Both methods ensure IDs always exist (generate if needed)
-        const session_id = this.sessionManager.getSessionId();
-        const window_id = this.sessionManager.getWindowId();
-        const enrichedPayload = {
-            ...eventProperties, // Base properties for all events
-            $session_id: session_id, // PostHog-style: session ID in properties
-            $window_id: window_id, // PostHog-style: window ID in properties
-            ...payload, // User-provided payload (can override base properties)
-        };
-        // Add title only to $pageview events (PostHog-style)
-        if (name === "$pageview" && globals_1.document) {
-            enrichedPayload.title = globals_1.document.title;
-        }
-        let processedPayload;
-        if (this.config.stringifyPayload !== false) {
-            processedPayload = (0, utils_1.maskSuspiciousAttributes)(enrichedPayload);
-            processedPayload = Object.assign({}, JSON.parse(processedPayload), this.config.globalAttributes);
-            processedPayload = JSON.stringify(processedPayload);
-            if (!(0, utils_1.isValidPayload)(processedPayload)) {
-                return;
-            }
-        }
-        else {
-            processedPayload = Object.assign({}, enrichedPayload, this.config.globalAttributes);
-            const maskedStr = (0, utils_1.maskSuspiciousAttributes)(processedPayload);
-            if (!(0, utils_1.isValidPayload)(maskedStr)) {
-                return;
-            }
-            processedPayload = JSON.parse(maskedStr);
-        }
-        // session_id is already in payload as $session_id (PostHog-style)
-        const distinct_id = this.userManager.getDistinctId();
-        const anonymous_id = this.userManager.getAnonymousId();
-        const trackingEvent = {
-            timestamp: new Date().toISOString(),
-            event: name,
-            tenant_id: this.config.projectId || "",
-            domain: this.config.domain || this.getCurrentDomain(), // Use config domain or current domain
-            payload: processedPayload,
-            distinct_id: distinct_id || anonymous_id,
-        };
-        this.sendRequest(url, trackingEvent, true);
-    }
-    /**
-     * Build the tracking URL with token in query parameters (PostHog style)
-     */
-    buildUrl() {
-        const { proxyUrl, proxy, host, token } = this.config;
-        // Use proxy endpoint to handle Tinybird authentication
-        if (proxyUrl) {
-            // Use the full proxy URL as provided
-            return proxyUrl;
-        }
-        else if (proxy) {
-            // Construct the proxy URL from the proxy domain with token
-            return `${proxy}/api/tracking?token=${token}`;
-        }
-        else if (host) {
-            const cleanHost = host.replace(/\/+$/gm, "");
-            return `${cleanHost}/api/tracking?token=${token}`;
-        }
-        else {
-            // Use relative path to our tracking proxy endpoint
-            return `/api/tracking?token=${token}`;
-        }
-    }
-    /**
-     * Send HTTP request
-     * This is the central entry point for all tracking requests
-     */
-    sendRequest(url, event, shouldEnqueue) {
-        // Validate configuration (only warns once per instance)
-        // This is the single place where validation happens for all sending methods
-        if (!this._isConfigured()) {
-            return;
-        }
-        // Check if we should queue requests (for older browsers before DOM is loaded)
-        if (shouldEnqueue && typeof globals_1.window !== "undefined") {
-            // ENQUEUE_REQUESTS is defined in vtilt.ts as a module-level variable
-            const ENQUEUE_REQUESTS = globals_1.window.__VTILT_ENQUEUE_REQUESTS;
-            if (ENQUEUE_REQUESTS) {
-                this.__request_queue.push({ url, event });
-                return;
-            }
-        }
-        const request = new XMLHttpRequest();
-        request.open("POST", url, true);
-        request.setRequestHeader("Content-Type", "application/json");
-        request.send(JSON.stringify(event));
-    }
-    /**
-     * Send a queued request (called after DOM is loaded)
-     */
-    _send_retriable_request(item) {
-        this.sendRequest(item.url, item.event, false);
-    }
-    /**
-     * Get current session ID
-     */
-    getSessionId() {
-        return this.sessionManager.getSessionId();
-    }
-    /**
-     * Identify a user with PostHog-style property operations
-     * Copied from PostHog's identify method signature
-     */
-    identify(distinctId, userPropertiesToSet, userPropertiesToSetOnce) {
-        this.userManager.identify(distinctId, userPropertiesToSet, userPropertiesToSetOnce);
-    }
-    /**
-     * Set user properties (PostHog-style)
-     */
-    setUserProperties(userPropertiesToSet, userPropertiesToSetOnce) {
-        this.userManager.setUserProperties(userPropertiesToSet, userPropertiesToSetOnce);
-    }
-    /**
-     * Reset user identity (logout)
-     * PostHog behavior: Clears all user data, generates new anonymous ID, resets session
-     *
-     * @param reset_device_id - If true, also resets device_id. Default: false
-     */
-    resetUser(reset_device_id) {
-        // PostHog behavior: Reset session ID
-        this.sessionManager.resetSessionId();
-        this.userManager.reset(reset_device_id);
-    }
-    /**
-     * Get current user identity
-     */
-    getUserIdentity() {
-        return this.userManager.getUserIdentity();
-    }
-    /**
-     * Get current device ID
-     */
-    getDeviceId() {
-        return this.userManager.getDeviceId();
-    }
-    /**
-     * Get current user state
-     */
-    getUserState() {
-        return this.userManager.getUserState();
-    }
-    /**
-     * Create an alias to link two distinct IDs
-     * PostHog behavior: 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)
-     *
-     * @example
-     * // Link anonymous user to account on signup
-     * vtilt.createAlias('user_12345')
-     *
-     * @example
-     * // Explicit alias with original ID
-     * vtilt.createAlias('user_12345', 'anonymous_abc123')
-     */
-    createAlias(alias, original) {
-        this.userManager.createAlias(alias, original);
-    }
-    /**
-     * Setup listener for identify, set, and alias events
-     */
-    setupIdentifyListener() {
-        // Only setup listeners in browser environment (not SSR)
-        if (!globals_1.window) {
-            return;
-        }
-        // Listen for identify events
-        globals_1.window.addEventListener("vtilt:identify", (event) => {
-            const customEvent = event;
-            const { distinct_id, anonymous_id, device_id, properties } = customEvent.detail;
-            this.sendIdentifyEvent(distinct_id, anonymous_id, device_id, properties);
-        });
-        // Listen for set events (property updates)
-        globals_1.window.addEventListener("vtilt:set", (event) => {
-            const customEvent = event;
-            const { $set, $set_once } = customEvent.detail;
-            this.sendSetEvent($set || {}, $set_once || {});
-        });
-        // Listen for alias events
-        globals_1.window.addEventListener("vtilt:alias", (event) => {
-            const customEvent = event;
-            const aliasEvent = customEvent.detail;
-            this.sendAliasEvent(aliasEvent);
-        });
-    }
-    /**
-     * Get session and window IDs (PostHog-style)
-     * Both methods ensure IDs always exist (generate if needed)
-     */
-    _getSessionAndWindowIds() {
-        return {
-            session_id: this.sessionManager.getSessionId(),
-            window_id: this.sessionManager.getWindowId(),
-        };
-    }
-    /**
-     * Create base tracking event structure
-     */
-    _createTrackingEvent(event, payload, distinct_id) {
-        return {
-            timestamp: new Date().toISOString(),
-            event,
-            tenant_id: this.config.projectId || "",
-            domain: this.config.domain || this.getCurrentDomain(),
-            payload,
-            distinct_id,
-        };
-    }
-    /**
-     * Send identify event for session merging
-     */
-    sendIdentifyEvent(distinctId, anonymousId, deviceId, properties) {
-        const { session_id, window_id } = this._getSessionAndWindowIds();
-        // Payload contains only properties, not event or distinct_id (those are in trackingEvent)
-        // Add $session_id and $window_id to payload (PostHog-style)
-        const identifyPayload = {
-            $session_id: session_id,
-            $window_id: window_id,
-            $anon_distinct_id: anonymousId,
-            $device_id: deviceId,
-            ...properties,
-        };
-        const trackingEvent = this._createTrackingEvent("$identify", identifyPayload, distinctId);
-        this.sendRequest(this.buildUrl(), trackingEvent, true);
-    }
-    /**
-     * Send $set event for property updates (PostHog behavior)
-     * This notifies Tinybird when user properties are updated
-     */
-    sendSetEvent(userPropertiesToSet, userPropertiesToSetOnce) {
-        const { session_id, window_id } = this._getSessionAndWindowIds();
-        const distinct_id = this.userManager.getDistinctId();
-        const anonymous_id = this.userManager.getAnonymousId();
-        // Add $session_id and $window_id to payload (PostHog-style)
-        const setEventPayload = {
-            $session_id: session_id,
-            $window_id: window_id,
-            $set: userPropertiesToSet || {},
-            $set_once: userPropertiesToSetOnce || {},
-        };
-        const trackingEvent = this._createTrackingEvent("$set", setEventPayload, distinct_id || anonymous_id);
-        this.sendRequest(this.buildUrl(), trackingEvent, true);
-    }
-    /**
-     * Send alias event for identity linking
-     * PostHog format: { alias: alias, distinct_id: original }
-     */
-    sendAliasEvent(aliasEvent) {
-        const { session_id, window_id } = this._getSessionAndWindowIds();
-        // Add $session_id and $window_id to payload (PostHog-style)
-        const aliasPayload = {
-            $session_id: session_id,
-            $window_id: window_id,
-            $original_id: aliasEvent.original,
-            $alias_id: aliasEvent.distinct_id,
-        };
-        const trackingEvent = this._createTrackingEvent("$alias", aliasPayload, aliasEvent.distinct_id);
-        this.sendRequest(this.buildUrl(), trackingEvent, true);
-    }
-}
-exports.TrackingManager = TrackingManager;

package/lib/utils/is-function.d.ts

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

package/lib/utils/is-function.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isFunction = isFunction;
-/**
- * Type guard to check if a value is a function
- */
-function isFunction(value) {
-    return typeof value === "function";
-}