@formo/analytics 1.28.6 → 1.29.1

package/dist/cjs/src/constants/config.js

@@ -192,7 +192,7 @@ exports.COUNTRY_LIST = {
     "America/Panama": "PA",
     "America/Pangnirtung": "CA",
     "America/Paramaribo": "SR",
-    "America/Phoenix": "US,CA",
+    "America/Phoenix": "US",
     "America/Port-au-Prince": "HT",
     "America/Port_of_Spain": "TT",
     "America/Porto_Acre": "BR",
@@ -298,6 +298,7 @@ exports.COUNTRY_LIST = {
     "Asia/Katmandu": "NP",
     "Asia/Khandyga": "RU",
     "Asia/Kolkata": "IN",
+    "Asia/Kostanay": "KZ",
     "Asia/Krasnoyarsk": "RU",
     "Asia/Kuala_Lumpur": "MY",
     "Asia/Kuching": "MY",
@@ -399,59 +400,15 @@ exports.COUNTRY_LIST = {
     "Canada/Pacific": "CA",
     "Canada/Saskatchewan": "CA",
     "Canada/Yukon": "CA",
-    // CET
-    CET: "CET",
     // Chile
     "Chile/Continental": "CL",
     "Chile/EasterIsland": "CL",
-    // CST6CDT
-    CST6CDT: "CST6CDT",
     // Cuba
     Cuba: "CU",
-    // EET
-    EET: "EET",
     // Egypt
     Egypt: "EG",
     // Eire
     Eire: "IE",
-    // EST
-    EST: "EST",
-    EST5EDT: "EST5EDT",
-    "Etc/GMT": "Etc/GMT",
-    "Etc/GMT+0": "Etc/GMT+0",
-    "Etc/GMT+1": "Etc/GMT+1",
-    "Etc/GMT+10": "Etc/GMT+10",
-    "Etc/GMT+11": "Etc/GMT+11",
-    "Etc/GMT+12": "Etc/GMT+12",
-    "Etc/GMT+2": "Etc/GMT+2",
-    "Etc/GMT+3": "Etc/GMT+3",
-    "Etc/GMT+4": "Etc/GMT+4",
-    "Etc/GMT+5": "Etc/GMT+5",
-    "Etc/GMT+6": "Etc/GMT+6",
-    "Etc/GMT+7": "Etc/GMT+7",
-    "Etc/GMT+8": "Etc/GMT+8",
-    "Etc/GMT+9": "Etc/GMT+9",
-    "Etc/GMT-0": "Etc/GMT-0",
-    "Etc/GMT-1": "Etc/GMT-1",
-    "Etc/GMT-10": "Etc/GMT-10",
-    "Etc/GMT-11": "Etc/GMT-11",
-    "Etc/GMT-12": "Etc/GMT-12",
-    "Etc/GMT-13": "Etc/GMT-13",
-    "Etc/GMT-14": "Etc/GMT-14",
-    "Etc/GMT-2": "Etc/GMT-2",
-    "Etc/GMT-3": "Etc/GMT-3",
-    "Etc/GMT-4": "Etc/GMT-4",
-    "Etc/GMT-5": "Etc/GMT-5",
-    "Etc/GMT-6": "Etc/GMT-6",
-    "Etc/GMT-7": "Etc/GMT-7",
-    "Etc/GMT-8": "Etc/GMT-8",
-    "Etc/GMT-9": "Etc/GMT-9",
-    "Etc/GMT0": "Etc/GMT0",
-    "Etc/Greenwich": "Etc/Greenwich",
-    "Etc/UCT": "Etc/UCT",
-    "Etc/UTC": "Etc/UTC",
-    "Etc/Universal": "Etc/Universal",
-    "Etc/Zulu": "Etc/Zulu",
     // Europe
     "Europe/Amsterdam": "NL",
     "Europe/Andorra": "AD",
@@ -517,21 +474,11 @@ exports.COUNTRY_LIST = {
     "Europe/Zagreb": "HR",
     "Europe/Zaporozhye": "UA",
     "Europe/Zurich": "CH",
-    // Factory
-    Factory: "Factory",
     // GB
     GB: "GB",
     "GB-Eire": "GB",
-    // GMT
-    GMT: "GMT",
-    "GMT+0": "GMT+0",
-    "GMT-0": "GMT-0",
-    GMT0: "GMT0",
-    Greenwich: "Greenwich",
     // HK
     Hongkong: "HK",
-    // HST
-    HST: "HST",
     // Iceland
     Iceland: "IS",
     // Indian
@@ -558,15 +505,10 @@ exports.COUNTRY_LIST = {
     Kwajalein: "MH",
     // Libya
     Libya: "LY",
-    // MET
-    MET: "MET",
     // Mexico
     "Mexico/BajaNorte": "MX",
     "Mexico/BajaSur": "MX",
     "Mexico/General": "MX",
-    // MST
-    MST: "MST",
-    MST7MDT: "MST7MDT",
     // Navajo
     Navajo: "US",
     // NZ
@@ -587,7 +529,7 @@ exports.COUNTRY_LIST = {
     "Pacific/Galapagos": "EC",
     "Pacific/Gambier": "PF",
     "Pacific/Guadalcanal": "SB",
-    "Pacific/Guam": "GU,MP",
+    "Pacific/Guam": "GU",
     "Pacific/Honolulu": "US",
     "Pacific/Johnston": "UM",
     "Pacific/Kanton": "KI",
@@ -623,8 +565,6 @@ exports.COUNTRY_LIST = {
     Portugal: "PT",
     // PRC
     PRC: "CN",
-    // PST8PDT
-    PST8PDT: "PST8PDT",
     // ROC
     ROC: "TW",
     // ROK
@@ -633,10 +573,6 @@ exports.COUNTRY_LIST = {
     Singapore: "SG",
     // Turkey
     Turkey: "TR",
-    // UCT
-    UCT: "UCT",
-    // Universal
-    Universal: "Universal",
     // US
     "US/Alaska": "US",
     "US/Aleutian": "US",
@@ -650,13 +586,7 @@ exports.COUNTRY_LIST = {
     "US/Mountain": "US",
     "US/Pacific": "US",
     "US/Samoa": "AS",
-    // UTC
-    UTC: "UTC",
     // W-SU
     "W-SU": "RU",
-    // WET
-    WET: "WET",
-    // Zulu
-    Zulu: "Zulu",
 };
 //# sourceMappingURL=config.js.map

package/dist/cjs/src/event/EventFactory.d.ts

@@ -17,6 +17,7 @@ declare class EventFactory implements IEventFactory {
     private getLanguage;
     private getLibraryVersion;
     private extractUTMParameters;
+    private extractClickIdParameters;
     private extractReferralParameter;
     private getTrafficSources;
     private getScreen;

package/dist/cjs/src/event/EventFactory.js

@@ -63,6 +63,7 @@ var version_1 = require("../version");
 var constants_2 = require("./constants");
 var utils_2 = require("./utils");
 var browsers_1 = require("../browser/browsers");
+var ISO_3166_ALPHA_2_REGEX = /^[A-Z]{2}$/;
 var EventFactory = /** @class */ (function () {
     function EventFactory(options) {
         var _this = this;
@@ -87,6 +88,15 @@ var EventFactory = /** @class */ (function () {
             catch (_a) { }
             return result;
         };
+        this.extractClickIdParameters = function (urlObj) {
+            var result = {};
+            for (var _i = 0, CLICK_ID_PARAMS_1 = constants_2.CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_1.length; _i++) {
+                var param = CLICK_ID_PARAMS_1[_i];
+                var value = urlObj.searchParams.get(param);
+                result[param] = value ? value.trim() : "";
+            }
+            return result;
+        };
         this.extractReferralParameter = function (urlObj) {
             var _a, _b, _c;
             // Strategy: Check query params first, then check path pattern if configured
@@ -119,25 +129,23 @@ var EventFactory = /** @class */ (function () {
         };
         this.getTrafficSources = function (url) {
             var urlObj = new URL(url);
-            var contextTrafficSources = __assign(__assign({}, _this.extractUTMParameters(url)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
+            var contextTrafficSources = __assign(__assign(__assign({}, _this.extractUTMParameters(url)), _this.extractClickIdParameters(urlObj)), { ref: _this.extractReferralParameter(urlObj), referrer: document.referrer });
             var storedTrafficSources = (0, storage_1.session)().get(constants_1.SESSION_TRAFFIC_SOURCE_KEY) || {};
-            var finalTrafficSources = {
-                ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "",
-                referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "",
-                utm_campaign: contextTrafficSources.utm_campaign ||
+            var mergedClickIds = {};
+            for (var _i = 0, CLICK_ID_PARAMS_2 = constants_2.CLICK_ID_PARAMS; _i < CLICK_ID_PARAMS_2.length; _i++) {
+                var p = CLICK_ID_PARAMS_2[_i];
+                mergedClickIds[p] =
+                    contextTrafficSources[p] || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources[p]) || "";
+            }
+            var finalTrafficSources = __assign({ ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "", referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "", utm_campaign: contextTrafficSources.utm_campaign ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_campaign) ||
-                    "",
-                utm_content: contextTrafficSources.utm_content ||
+                    "", utm_content: contextTrafficSources.utm_content ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_content) ||
-                    "",
-                utm_medium: contextTrafficSources.utm_medium ||
+                    "", utm_medium: contextTrafficSources.utm_medium ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_medium) ||
-                    "",
-                utm_source: contextTrafficSources.utm_source ||
+                    "", utm_source: contextTrafficSources.utm_source ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_source) ||
-                    "",
-                utm_term: contextTrafficSources.utm_term || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_term) || "",
-            };
+                    "", utm_term: contextTrafficSources.utm_term || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_term) || "" }, mergedClickIds);
             // Store to session
             var sessionStoredTrafficSources = Object.keys(finalTrafficSources).reduce(function (res, key) {
                 var value = finalTrafficSources[key];
@@ -223,9 +231,14 @@ var EventFactory = /** @class */ (function () {
     EventFactory.prototype.getLocation = function () {
         try {
             var timezone = this.getTimezone();
-            if (timezone in constants_1.COUNTRY_LIST)
-                return constants_1.COUNTRY_LIST[timezone];
-            return timezone;
+            if (!timezone)
+                return "";
+            var mapped = constants_1.COUNTRY_LIST[timezone];
+            // Only emit ISO-3166 alpha-2. Anything else (including the raw
+            // timezone string) is treated as unknown.
+            return typeof mapped === "string" && ISO_3166_ALPHA_2_REGEX.test(mapped)
+                ? mapped
+                : "";
         }
         catch (error) {
             logger_1.logger.error("Error resolving location:", error);

package/dist/cjs/src/event/constants.d.ts

@@ -1,11 +1,17 @@
 declare const CHANNEL = "web";
 declare const VERSION = "0";
+/**
+ * Paid-attribution click IDs captured from the landing-page URL and persisted
+ * across the session alongside UTM parameters. Keep the ClickIdParameters type
+ * in src/types/events.ts derived from this array.
+ */
+declare const CLICK_ID_PARAMS: readonly ["gclid", "gad_source", "fbclid", "msclkid", "twclid", "li_fat_id", "rdt_cid", "ttclid"];
 /**
  * Fields that should be excluded from page event properties parsing
  * These are either:
- * - Already captured in event context (UTM params, referral params)
+ * - Already captured in event context (UTM params, referral params, click IDs)
  * - Semantic event properties that should not be overridden by URL params
  */
 declare const PAGE_PROPERTIES_EXCLUDED_FIELDS: Set<string>;
-export { CHANNEL, VERSION, PAGE_PROPERTIES_EXCLUDED_FIELDS };
+export { CHANNEL, VERSION, CLICK_ID_PARAMS, PAGE_PROPERTIES_EXCLUDED_FIELDS };
 //# sourceMappingURL=constants.d.ts.map

package/dist/cjs/src/event/constants.js

@@ -1,17 +1,42 @@
 "use strict";
+var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
+    if (pack || arguments.length === 2) for (var i = 0, l = from.length, ar; i < l; i++) {
+        if (ar || !(i in from)) {
+            if (!ar) ar = Array.prototype.slice.call(from, 0, i);
+            ar[i] = from[i];
+        }
+    }
+    return to.concat(ar || Array.prototype.slice.call(from));
+};
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.PAGE_PROPERTIES_EXCLUDED_FIELDS = exports.VERSION = exports.CHANNEL = void 0;
+exports.PAGE_PROPERTIES_EXCLUDED_FIELDS = exports.CLICK_ID_PARAMS = exports.VERSION = exports.CHANNEL = void 0;
 var CHANNEL = "web";
 exports.CHANNEL = CHANNEL;
 var VERSION = "0";
 exports.VERSION = VERSION;
+/**
+ * Paid-attribution click IDs captured from the landing-page URL and persisted
+ * across the session alongside UTM parameters. Keep the ClickIdParameters type
+ * in src/types/events.ts derived from this array.
+ */
+var CLICK_ID_PARAMS = [
+    "gclid", // Google Ads
+    "gad_source", // Google Ads (newer)
+    "fbclid", // Meta (Facebook/Instagram)
+    "msclkid", // Microsoft Ads (Bing)
+    "twclid", // Twitter/X Ads
+    "li_fat_id", // LinkedIn Ads
+    "rdt_cid", // Reddit Ads
+    "ttclid", // TikTok Ads
+];
+exports.CLICK_ID_PARAMS = CLICK_ID_PARAMS;
 /**
  * Fields that should be excluded from page event properties parsing
  * These are either:
- * - Already captured in event context (UTM params, referral params)
+ * - Already captured in event context (UTM params, referral params, click IDs)
  * - Semantic event properties that should not be overridden by URL params
  */
-var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
+var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set(__spreadArray(__spreadArray([
     // Context fields (already captured in event context)
     'utm_source',
     'utm_medium',
@@ -21,7 +46,8 @@ var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
     'ref',
     'referral',
     'refcode',
-    'referrer',
+    'referrer'
+], CLICK_ID_PARAMS, true), [
     // Semantic event properties (should not be overridden by URL params)
     'category',
     'name',
@@ -29,6 +55,6 @@ var PAGE_PROPERTIES_EXCLUDED_FIELDS = new Set([
     'path',
     'hash',
     'query',
-]);
+], false));
 exports.PAGE_PROPERTIES_EXCLUDED_FIELDS = PAGE_PROPERTIES_EXCLUDED_FIELDS;
 //# sourceMappingURL=constants.js.map

package/dist/cjs/src/types/events.d.ts

@@ -1,6 +1,7 @@
 import { UUID } from "crypto";
 import { Address, ChainID, Nullable } from "./base";
 import { TEventChannel, TEventType } from "../constants";
+import { CLICK_ID_PARAMS } from "../event/constants";
 export type AnonymousID = UUID;
 export interface ICommonProperties {
     anonymous_id: AnonymousID;
@@ -21,7 +22,10 @@ export type UTMParameters = {
     utm_term: string;
     utm_content: string;
 };
-export type ITrafficSource = UTMParameters & {
+export type ClickIdParameters = {
+    [K in (typeof CLICK_ID_PARAMS)[number]]: string;
+};
+export type ITrafficSource = UTMParameters & ClickIdParameters & {
     ref: string;
     referrer: string;
 };

package/dist/cjs/src/version.d.ts

@@ -1,2 +1,2 @@
-export declare const version = "1.28.6";
+export declare const version = "1.29.1";
 //# sourceMappingURL=version.d.ts.map

package/dist/cjs/src/version.js

@@ -3,5 +3,5 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // This file is auto-generated by scripts/update-version.js during npm version
 // Do not edit manually - it will be overwritten
-exports.version = '1.28.6';
+exports.version = '1.29.1';
 //# sourceMappingURL=version.js.map

package/dist/esm/src/FormoAnalytics.d.ts

@@ -52,6 +52,12 @@ export declare class FormoAnalytics implements IFormoAnalytics {
     private isEvmDisabled;
     /** Instance-level flag so multiple SDK instances don't interfere. */
     private crossSubdomainCookies;
+    /** In-memory URL used to deduplicate SPA pageview events. */
+    private _currentUrl;
+    /** Page-hit hooks installed in trackPageHits() so cleanup() can undo them. */
+    private _onPopStateListener?;
+    private _onLocationChangeListener?;
+    private _pageHooksDisposed;
     config: Config;
     currentChainId?: ChainID;
     currentAddress?: Address;
@@ -270,6 +276,12 @@ export declare class FormoAnalytics implements IFormoAnalytics {
     private registerRequestListeners;
     private onLocationChange;
     private trackPageHits;
+    /**
+     * Wrap history.pushState / replaceState exactly once per `history` object,
+     * regardless of how many SDK instances are constructed. Uses a Symbol
+     * marker so we recognize our own wrapper across module reloads in HMR.
+     */
+    private static installHistoryHooksOnce;
     private trackPageHit;
     private trackEvent;
     /**
@@ -310,6 +322,15 @@ export declare class FormoAnalytics implements IFormoAnalytics {
     private getCurrentChainId;
     private buildSignatureEventPayload;
     private buildTransactionEventPayload;
+    /**
+     * Persist an EVM address discovered through autocapture (signature / transaction)
+     * as the current EVM address when none is currently set. This lets subsequent
+     * track()/page() calls carry the address even when the underlying wallet never
+     * fires an EIP-1193 `accountsChanged` event (embedded wallets, smart accounts,
+     * social-login wrappers). If `accountsChanged` later fires it overwrites this
+     * value in the normal way; existing connections are never clobbered.
+     */
+    private backfillActiveWallet;
     /**
      * Polls for transaction receipt and emits tx.status = CONFIRMED or REVERTED.
      */
@@ -365,6 +386,19 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * Last-connected-chain-wins: _activeNamespace takes precedence.
      */
     private syncDerivedState;
+    /**
+     * Persist (or clear) the current wallet snapshot in a cookie so that the
+     * SDK can repopulate `currentAddress`/`currentChainId` at init on the next
+     * page load — closing the gap between page-show and wagmi/EIP-1193
+     * reconnection during which track()/page() events would otherwise ship
+     * with an empty address.
+     */
+    private persistActiveWallet;
+    /**
+     * Seed `currentAddress`/`currentChainId` from the persisted snapshot, if
+     * any. Called once during construction before the first page hit fires.
+     */
+    private loadActiveWallet;
     /**
      * Helper method to clear the active provider state
      * Centralizes provider clearing logic for consistency