@v-tilt/browser 1.0.9 → 1.0.11

package/lib/vtilt.js

@@ -10,7 +10,6 @@ const web_vitals_1 = require("./web-vitals");
 const history_autocapture_1 = require("./extensions/history-autocapture");
 const utils_1 = require("./utils");
 const event_utils_1 = require("./utils/event-utils");
-const utils_2 = require("./utils");
 const globals_1 = require("./utils/globals");
 // Helper to check if value is an array
 const isArray = Array.isArray;
@@ -94,6 +93,9 @@ class VTilt {
             name: name,
         });
         this.__loaded = true;
+        // Set initial person info: stores referrer and URL on first visit
+        const fullConfig = this.configManager.getConfig();
+        this.userManager.set_initial_person_info(fullConfig.mask_personal_data_properties, fullConfig.custom_personal_data_properties);
         // Initialize history autocapture
         this.historyAutocapture = new history_autocapture_1.HistoryAutocapture(this);
         this.historyAutocapture.startIfEnabled();
@@ -205,7 +207,8 @@ class VTilt {
     /**
      * Capture an event
      * Automatically adds common properties to all events
-     * ($current_url, $host, $pathname, $referrer, $referring_domain, $browser_language, etc.)
+     * ($current_url, $host, $pathname, $referrer, $referring_domain, $browser, $os, $device, $timezone, etc.)
+     * Only properties in EVENT_TO_PERSON_PROPERTIES are copied to person properties
      * Also adds title property for $pageview events only
      *
      * @param name - Event name
@@ -222,11 +225,14 @@ class VTilt {
         }
         const url = this.buildUrl();
         // Add properties to all events
-        // This includes: $current_url, $host, $pathname, $referrer, $referring_domain, $browser_language, etc.
+        // This includes: $current_url, $host, $pathname, $referrer, $referring_domain, $browser, $os, $device, $timezone, etc.
+        // (Only properties in EVENT_TO_PERSON_PROPERTIES are copied to person properties)
         const eventProperties = (0, event_utils_1.getEventProperties)();
         // Get person properties (includes $device_id and other user properties)
         // These are automatically included in all events
         const personProperties = this.userManager.getUserProperties();
+        // Get initial props: $initial_* properties from stored initial person info
+        const initialProps = this.userManager.get_initial_props();
         // Get session and window IDs
         // Both methods ensure IDs always exist (generate if needed)
         const session_id = this.sessionManager.getSessionId();
@@ -235,6 +241,17 @@ class VTilt {
         // This allows linking events with different distinct_ids that share the same anonymous_id
         // This is especially important for handling race conditions when $identify events arrive
         const anonymousId = this.userManager.getAnonymousId();
+        // Build $set and $set_once from initial props
+        // Initial props are added to $set_once (only first time, preserves first values)
+        // Regular event properties that match EVENT_TO_PERSON_PROPERTIES will be added to $set by server
+        const setOnce = {};
+        if (Object.keys(initialProps).length > 0) {
+            Object.assign(setOnce, initialProps);
+        }
+        // Merge with user-provided $set_once if present
+        if (payload.$set_once) {
+            Object.assign(setOnce, payload.$set_once);
+        }
         const enrichedPayload = {
             ...eventProperties, // Base properties for all events
             ...personProperties, // Person properties (includes $device_id)
@@ -243,6 +260,10 @@ class VTilt {
             // Always include $anon_distinct_id for identity linking (even for identified users)
             // This allows the server to merge identities proactively when events arrive out of order
             ...(anonymousId ? { $anon_distinct_id: anonymousId } : {}),
+            // Add $set_once with initial props
+            ...(Object.keys(setOnce).length > 0 ? { $set_once: setOnce } : {}),
+            // Merge user-provided $set if present
+            ...(payload.$set ? { $set: payload.$set } : {}),
             ...payload, // User-provided payload (can override base and person properties)
         };
         // Add title only to $pageview events
@@ -282,7 +303,7 @@ class VTilt {
         const trackingEvent = {
             timestamp: new Date().toISOString(),
             event: name,
-            tenant_id: config.projectId || "",
+            project_id: config.projectId || "",
             domain: config.domain || this.getCurrentDomain(), // Use config domain or current domain
             payload: processedPayload,
             distinct_id: distinct_id,
@@ -508,7 +529,7 @@ class VTilt {
                 this._visibilityStateListener = () => {
                     this._captureInitialPageview();
                 };
-                (0, utils_2.addEventListener)(globals_1.document, "visibilitychange", this._visibilityStateListener);
+                (0, utils_1.addEventListener)(globals_1.document, "visibilitychange", this._visibilityStateListener);
             }
             return;
         }
@@ -636,7 +657,7 @@ const add_dom_loaded_handler = function () {
             globals_1.window.__VTILT_ENQUEUE_REQUESTS = false;
         }
         // Process queued requests for all instances
-        (0, utils_2.each)(instances, function (inst) {
+        (0, utils_1.each)(instances, function (inst) {
             inst._dom_loaded();
         });
     }
@@ -649,7 +670,7 @@ const add_dom_loaded_handler = function () {
             dom_loaded_handler();
         }
         else {
-            (0, utils_2.addEventListener)(globals_1.document, "DOMContentLoaded", dom_loaded_handler, {
+            (0, utils_1.addEventListener)(globals_1.document, "DOMContentLoaded", dom_loaded_handler, {
                 capture: false,
             });
         }
@@ -734,7 +755,7 @@ function init_from_snippet() {
          *
          */
         // Call all pre-loaded init calls properly
-        (0, utils_2.each)(snippetVT["_i"], function (item) {
+        (0, utils_1.each)(snippetVT["_i"], function (item) {
             if (item && isArray(item)) {
                 const instance = vTiltMain.init(item[0], item[1], item[2]);
                 const instanceSnippet = snippetVT[item[2] || "vt"] || snippetVT;

package/package.json

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