@formo/analytics 1.17.9 → 1.18.0

package/README.md

@@ -5,4 +5,3 @@ The Formo Analytics SDK is a Javascript library that allows you to track and ana
 ## Installation
 
 Please visit Formo's [Developer Docs](https://docs.formo.so) for detailed guides and installation instructions.
-

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

@@ -20,9 +20,10 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * @param {string} name - The name of the page
      * @param {Record<string, any>} properties - Additional properties to include
      * @param {Record<string, any>} context - Additional context to include
+     * @param {(...args: unknown[]) => void} callback - Optional callback function
      * @returns {Promise<void>}
      */
-    page(category?: string, name?: string, properties?: IFormoEventProperties, context?: IFormoEventContext): Promise<void>;
+    page(category?: string, name?: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
     /**
      * Reset the current user session.
      * @returns {void}
@@ -43,9 +44,9 @@ export declare class FormoAnalytics implements IFormoAnalytics {
         address: Address;
     }, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
     /**
-     * Emits a wallet disconnect event.
-     * @param {ChainID} params.chainId
-     * @param {Address} params.address
+     * Emits a disconnect wallet event.
+     * @param {ChainID} [params.chainId]
+     * @param {Address} [params.address]
      * @param {IFormoEventProperties} properties
      * @param {IFormoEventContext} context
      * @param {(...args: unknown[]) => void} callback
@@ -152,19 +153,22 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      */
     track(event: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
     private trackProvider;
-    private registerAddressChangedListener;
+    private registerAccountsChangedListener;
+    private onAccountsChanged;
     private registerChainChangedListener;
-    private registerRequestListeners;
-    private onAddressChanged;
-    private onAddressConnected;
-    private handleDisconnect;
-    private onAddressDisconnected;
     private onChainChanged;
-    private trackFirstPageHit;
-    private trackPageHits;
+    private registerConnectListener;
+    private onConnected;
+    private registerRequestListeners;
     private onLocationChange;
+    private trackPageHits;
     private trackPageHit;
     private trackEvent;
+    /**
+     * Determines if tracking should be enabled based on configuration
+     * @returns {boolean} True if tracking should be enabled
+     */
+    private shouldTrack;
     private getProviders;
     get providers(): readonly EIP6963ProviderDetail[];
     private detectWallets;

package/dist/cjs/src/FormoAnalytics.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"FormoAnalytics.d.ts","sourceRoot":"","sources":["../../../src/FormoAnalytics.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"FormoAnalytics.d.ts","sourceRoot":"","sources":["../../../src/FormoAnalytics.ts"],"names":[],"mappings":"AAAA,OAAO,EAAe,qBAAqB,EAAE,MAAM,MAAM,CAAC;AAmB1D,OAAO,EACL,OAAO,EACP,OAAO,EACP,MAAM,EACN,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,OAAO,EAGP,eAAe,EAEf,iBAAiB,EAElB,MAAM,SAAS,CAAC;AAIjB,qBAAa,cAAe,YAAW,eAAe;aAalC,QAAQ,EAAE,MAAM;IACzB,OAAO,EAAE,OAAO;IAbzB,OAAO,CAAC,SAAS,CAAC,CAAkB;IACpC,OAAO,CAAC,kBAAkB,CAAoD;IAC9E,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,UAAU,CAAwC;IAE1D,MAAM,EAAE,MAAM,CAAC;IACf,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,cAAc,CAAC,EAAE,OAAO,CAAM;IAC9B,aAAa,CAAC,EAAE,MAAM,CAAM;IAE5B,OAAO;WAgDM,IAAI,CACf,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,cAAc,CAAC;IAe1B;;;;;;;;OAQG;IACU,IAAI,CACf,QAAQ,CAAC,EAAE,MAAM,EACjB,IAAI,CAAC,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAIhB;;;OAGG;IACI,KAAK,IAAI,IAAI;IAMpB;;;;;;;;;OASG;IACG,OAAO,CACX,EACE,OAAO,EACP,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;KAClB,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAuBhB;;;;;;;;OAQG;IACG,UAAU,CACd,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAoBhB;;;;;;;;;;OAUG;IACG,KAAK,CACT,EACE,OAAO,EACP,OAAO,GACR,EAAE;QACD,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,CAAC,EAAE,OAAO,CAAC;KACnB,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IA6BhB;;;;;;;;;;;OAWG;IACG,SAAS,CACb,EACE,MAAM,EACN,OAAO,EACP,OAAO,EACP,OAAO,EACP,aAAa,GACd,EAAE;QACD,MAAM,EAAE,eAAe,CAAC;QACxB,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,MAAM,CAAC;QAChB,aAAa,CAAC,EAAE,MAAM,CAAC;KACxB,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAgBhB;;;;;;;;;;;;;OAaG;IACG,WAAW,CACf,EACE,MAAM,EACN,OAAO,EACP,OAAO,EACP,IAAI,EACJ,EAAE,EACF,KAAK,EACL,eAAe,GAChB,EAAE;QACD,MAAM,EAAE,iBAAiB,CAAC;QAC1B,OAAO,EAAE,OAAO,CAAC;QACjB,OAAO,EAAE,OAAO,CAAC;QACjB,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAkBhB;;;;;;;;;;OAUG;IACG,QAAQ,CACZ,MAAM,CAAC,EAAE;QACP,OAAO,CAAC,EAAE,OAAO,CAAC;QAClB,YAAY,CAAC,EAAE,MAAM,CAAC;QACtB,MAAM,CAAC,EAAE,MAAM,CAAC;QAChB,IAAI,CAAC,EAAE,MAAM,CAAC;KACf,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAqEhB;;;;;;;;OAQG;IACG,MAAM,CACV,EACE,YAAY,EACZ,IAAI,GACL,EAAE;QACD,YAAY,EAAE,MAAM,CAAC;QACrB,IAAI,EAAE,MAAM,CAAC;KACd,EACD,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAmBhB;;;;;;;OAOG;IACG,KAAK,CACT,KAAK,EAAE,MAAM,EACb,UAAU,CAAC,EAAE,qBAAqB,EAClC,OAAO,CAAC,EAAE,kBAAkB,EAC5B,QAAQ,CAAC,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GACtC,OAAO,CAAC,IAAI,CAAC;IAchB,OAAO,CAAC,aAAa;IAkCrB,OAAO,CAAC,+BAA+B;YASzB,iBAAiB;IAkB/B,OAAO,CAAC,4BAA4B;YAQtB,cAAc;IAkC5B,OAAO,CAAC,uBAAuB;YAUjB,WAAW;IAczB,OAAO,CAAC,wBAAwB;YAyIlB,gBAAgB;YAShB,aAAa;YAmBb,YAAY;YA4BZ,UAAU;IA6BxB;;;OAGG;IACH,OAAO,CAAC,WAAW;YAmDL,YAAY;IAiB1B,IAAI,SAAS,IAAI,SAAS,qBAAqB,EAAE,CAEhD;YAEa,aAAa;IAe3B,IAAI,QAAQ,IAAI,eAAe,GAAG,SAAS,CAE1C;YAEa,UAAU;YAwBV,WAAW;YAqBX,iBAAiB;IAqB/B,OAAO,CAAC,0BAA0B;YAgCpB,4BAA4B;IAgB1C;;OAEG;YACW,sBAAsB;CA4CrC"}

package/dist/cjs/src/FormoAnalytics.js

@@ -53,6 +53,7 @@ var constants_1 = require("./constants");
 var lib_1 = require("./lib");
 var types_1 = require("./types");
 var validators_1 = require("./validators");
+var chain_1 = require("./utils/chain");
 var FormoAnalytics = /** @class */ (function () {
     function FormoAnalytics(writeKey, options) {
         if (options === void 0) { options = {}; }
@@ -65,8 +66,8 @@ var FormoAnalytics = /** @class */ (function () {
         this.currentUserId = "";
         this.config = {
             writeKey: writeKey,
-            trackLocalhost: options.trackLocalhost || false,
         };
+        this.options = options;
         this.session = new FormoAnalyticsSession();
         this.currentUserId =
             (0, lib_1.cookie)().get(constants_1.SESSION_USER_ID_KEY) || undefined;
@@ -95,7 +96,7 @@ var FormoAnalytics = /** @class */ (function () {
         if (provider) {
             this.trackProvider(provider);
         }
-        this.trackFirstPageHit();
+        this.trackPageHit();
         this.trackPageHits();
     }
     FormoAnalytics.init = function (writeKey, options) {
@@ -129,13 +130,14 @@ var FormoAnalytics = /** @class */ (function () {
      * @param {string} name - The name of the page
      * @param {Record<string, any>} properties - Additional properties to include
      * @param {Record<string, any>} context - Additional context to include
+     * @param {(...args: unknown[]) => void} callback - Optional callback function
      * @returns {Promise<void>}
      */
-    FormoAnalytics.prototype.page = function (category, name, properties, context) {
+    FormoAnalytics.prototype.page = function (category, name, properties, context, callback) {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.trackPageHit(category, name, properties, context)];
+                    case 0: return [4 /*yield*/, this.trackPageHit(category, name, properties, context, callback)];
                     case 1:
                         _a.sent();
                         return [2 /*return*/];
@@ -188,9 +190,9 @@ var FormoAnalytics = /** @class */ (function () {
         });
     };
     /**
-     * Emits a wallet disconnect event.
-     * @param {ChainID} params.chainId
-     * @param {Address} params.address
+     * Emits a disconnect wallet event.
+     * @param {ChainID} [params.chainId]
+     * @param {Address} [params.address]
      * @param {IFormoEventProperties} properties
      * @param {IFormoEventContext} context
      * @param {(...args: unknown[]) => void} callback
@@ -198,15 +200,21 @@ var FormoAnalytics = /** @class */ (function () {
      */
     FormoAnalytics.prototype.disconnect = function (params, properties, context, callback) {
         return __awaiter(this, void 0, void 0, function () {
-            var address, chainId;
+            var chainId, address;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
-                        address = (params === null || params === void 0 ? void 0 : params.address) || this.currentAddress;
                         chainId = (params === null || params === void 0 ? void 0 : params.chainId) || this.currentChainId;
-                        return [4 /*yield*/, this.handleDisconnect(chainId, address, properties, context, callback)];
+                        address = (params === null || params === void 0 ? void 0 : params.address) || this.currentAddress;
+                        return [4 /*yield*/, this.trackEvent(constants_1.EventType.DISCONNECT, {
+                                chainId: chainId,
+                                address: address,
+                            }, properties, context, callback)];
                     case 1:
                         _a.sent();
+                        this.currentAddress = undefined;
+                        this.currentChainId = undefined;
+                        lib_1.logger.info("Wallet disconnected: Cleared currentAddress and currentChainId");
                         return [2 /*return*/];
                 }
             });
@@ -360,7 +368,7 @@ var FormoAnalytics = /** @class */ (function () {
                     case 8: return [2 /*return*/];
                     case 9:
                         userId = params.userId, address = params.address, providerName = params.providerName, rdns = params.rdns;
-                        lib_1.logger.debug("Identify", address, userId, providerName, rdns);
+                        lib_1.logger.info("Identify", address, userId, providerName, rdns);
                         if (address)
                             this.currentAddress = address;
                         if (userId) {
@@ -438,6 +446,7 @@ var FormoAnalytics = /** @class */ (function () {
       SDK tracking and event listener functions
     */
     FormoAnalytics.prototype.trackProvider = function (provider) {
+        lib_1.logger.info("trackProvider", provider);
         try {
             if (provider === this._provider) {
                 lib_1.logger.warn("TrackProvider: Provider already tracked.");
@@ -455,33 +464,65 @@ var FormoAnalytics = /** @class */ (function () {
             }
             this._provider = provider;
             // Register listeners for web3 provider events
-            this.registerAddressChangedListener();
+            this.registerAccountsChangedListener();
             this.registerChainChangedListener();
+            this.registerConnectListener();
             this.registerRequestListeners();
         }
         catch (error) {
             lib_1.logger.error("Error tracking provider:", error);
         }
     };
-    FormoAnalytics.prototype.registerAddressChangedListener = function () {
+    FormoAnalytics.prototype.registerAccountsChangedListener = function () {
         var _this = this;
-        var _a, _b;
+        var _a;
+        lib_1.logger.info("registerAccountsChangedListener");
         var listener = function () {
             var args = [];
             for (var _i = 0; _i < arguments.length; _i++) {
                 args[_i] = arguments[_i];
             }
-            return _this.onAddressChanged(args[0]);
+            return _this.onAccountsChanged(args[0]);
         };
         (_a = this._provider) === null || _a === void 0 ? void 0 : _a.on("accountsChanged", listener);
         this._providerListeners["accountsChanged"] = listener;
-        var onAddressDisconnected = this.onAddressDisconnected.bind(this);
-        (_b = this._provider) === null || _b === void 0 ? void 0 : _b.on("disconnect", onAddressDisconnected);
-        this._providerListeners["disconnect"] = onAddressDisconnected;
+    };
+    FormoAnalytics.prototype.onAccountsChanged = function (accounts) {
+        return __awaiter(this, void 0, void 0, function () {
+            var address, _a;
+            return __generator(this, function (_b) {
+                switch (_b.label) {
+                    case 0:
+                        lib_1.logger.info("onAccountsChanged", accounts);
+                        if (!(accounts.length === 0)) return [3 /*break*/, 2];
+                        // Handle wallet disconnect
+                        return [4 /*yield*/, this.disconnect()];
+                    case 1:
+                        // Handle wallet disconnect
+                        _b.sent();
+                        return [2 /*return*/];
+                    case 2:
+                        address = accounts[0];
+                        if (address === this.currentAddress) {
+                            // We have already reported this address
+                            return [2 /*return*/];
+                        }
+                        // Handle wallet connect
+                        this.currentAddress = address;
+                        _a = this;
+                        return [4 /*yield*/, this.getCurrentChainId()];
+                    case 3:
+                        _a.currentChainId = _b.sent();
+                        this.connect({ chainId: this.currentChainId, address: address });
+                        return [2 /*return*/];
+                }
+            });
+        });
     };
     FormoAnalytics.prototype.registerChainChangedListener = function () {
         var _this = this;
         var _a;
+        lib_1.logger.info("registerChainChangedListener");
         var listener = function () {
             var args = [];
             for (var _i = 0; _i < arguments.length; _i++) {
@@ -492,10 +533,92 @@ var FormoAnalytics = /** @class */ (function () {
         (_a = this.provider) === null || _a === void 0 ? void 0 : _a.on("chainChanged", listener);
         this._providerListeners["chainChanged"] = listener;
     };
+    FormoAnalytics.prototype.onChainChanged = function (chainIdHex) {
+        return __awaiter(this, void 0, void 0, function () {
+            var address;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        lib_1.logger.info("onChainChanged", chainIdHex);
+                        this.currentChainId = (0, chain_1.parseChainId)(chainIdHex);
+                        if (!!this.currentAddress) return [3 /*break*/, 2];
+                        if (!this.provider) {
+                            lib_1.logger.info("OnChainChanged: Provider not found. CHAIN_CHANGED not reported");
+                            return [2 /*return*/, Promise.resolve()];
+                        }
+                        return [4 /*yield*/, this.getAddress()];
+                    case 1:
+                        address = _a.sent();
+                        if (!address) {
+                            lib_1.logger.info("OnChainChanged: Unable to fetch or store connected address");
+                            return [2 /*return*/, Promise.resolve()];
+                        }
+                        this.currentAddress = address;
+                        _a.label = 2;
+                    case 2:
+                        // Proceed only if the address exists
+                        if (this.currentAddress) {
+                            return [2 /*return*/, this.chain({
+                                    chainId: this.currentChainId,
+                                    address: this.currentAddress,
+                                })];
+                        }
+                        else {
+                            lib_1.logger.info("OnChainChanged: Current connected address is null despite fetch attempt");
+                        }
+                        return [2 /*return*/];
+                }
+            });
+        });
+    };
+    FormoAnalytics.prototype.registerConnectListener = function () {
+        var _this = this;
+        var _a;
+        lib_1.logger.info("registerConnectListener");
+        var listener = function () {
+            var args = [];
+            for (var _i = 0; _i < arguments.length; _i++) {
+                args[_i] = arguments[_i];
+            }
+            var connection = args[0];
+            _this.onConnected(connection);
+        };
+        (_a = this._provider) === null || _a === void 0 ? void 0 : _a.on("connect", listener);
+        this._providerListeners["connect"] = listener;
+    };
+    FormoAnalytics.prototype.onConnected = function (connection) {
+        return __awaiter(this, void 0, void 0, function () {
+            var chainId, address, e_2;
+            return __generator(this, function (_a) {
+                switch (_a.label) {
+                    case 0:
+                        lib_1.logger.info("onConnected", connection);
+                        _a.label = 1;
+                    case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        if (!connection || typeof connection.chainId !== 'string')
+                            return [2 /*return*/];
+                        chainId = (0, chain_1.parseChainId)(connection.chainId);
+                        return [4 /*yield*/, this.getAddress()];
+                    case 2:
+                        address = _a.sent();
+                        if (chainId !== null && chainId !== undefined && address) {
+                            this.connect({ chainId: chainId, address: address });
+                        }
+                        return [3 /*break*/, 4];
+                    case 3:
+                        e_2 = _a.sent();
+                        lib_1.logger.error("Error handling connect event", e_2);
+                        return [3 /*break*/, 4];
+                    case 4: return [2 /*return*/];
+                }
+            });
+        });
+    };
     FormoAnalytics.prototype.registerRequestListeners = function () {
         var _this = this;
         var _a;
-        lib_1.logger.debug("registerRequestListeners");
+        lib_1.logger.info("registerRequestListeners");
         if (!this.provider) {
             lib_1.logger.error("Provider not found for request (signature, transaction) tracking");
             return;
@@ -570,7 +693,7 @@ var FormoAnalytics = /** @class */ (function () {
                             method === "eth_sendTransaction" &&
                             params[0])) return [3 /*break*/, 8];
                         (function () { return __awaiter(_this, void 0, void 0, function () {
-                            var payload, e_2;
+                            var payload, e_3;
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
                                     case 0:
@@ -581,8 +704,8 @@ var FormoAnalytics = /** @class */ (function () {
                                         this.transaction(__assign({ status: types_1.TransactionStatus.STARTED }, payload));
                                         return [3 /*break*/, 3];
                                     case 2:
-                                        e_2 = _a.sent();
-                                        lib_1.logger.error("Formo: Failed to track transaction start", e_2);
+                                        e_3 = _a.sent();
+                                        lib_1.logger.error("Formo: Failed to track transaction start", e_3);
                                         return [3 /*break*/, 3];
                                     case 3: return [2 /*return*/];
                                 }
@@ -598,7 +721,7 @@ var FormoAnalytics = /** @class */ (function () {
                     case 6:
                         transactionHash_1 = (_c.sent());
                         (function () { return __awaiter(_this, void 0, void 0, function () {
-                            var payload, e_3;
+                            var payload, e_4;
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
                                     case 0:
@@ -611,8 +734,8 @@ var FormoAnalytics = /** @class */ (function () {
                                         this.pollTransactionReceipt(transactionHash_1, payload);
                                         return [3 /*break*/, 3];
                                     case 2:
-                                        e_3 = _a.sent();
-                                        lib_1.logger.error("Formo: Failed to track transaction broadcast", e_3);
+                                        e_4 = _a.sent();
+                                        lib_1.logger.error("Formo: Failed to track transaction broadcast", e_4);
                                         return [3 /*break*/, 3];
                                     case 3: return [2 /*return*/];
                                 }
@@ -622,7 +745,7 @@ var FormoAnalytics = /** @class */ (function () {
                     case 7:
                         error_2 = _c.sent();
                         (function () { return __awaiter(_this, void 0, void 0, function () {
-                            var rpcError, payload, e_4;
+                            var rpcError, payload, e_5;
                             return __generator(this, function (_a) {
                                 switch (_a.label) {
                                     case 0:
@@ -636,8 +759,8 @@ var FormoAnalytics = /** @class */ (function () {
                                         _a.label = 2;
                                     case 2: return [3 /*break*/, 4];
                                     case 3:
-                                        e_4 = _a.sent();
-                                        lib_1.logger.error("Formo: Failed to track transaction rejection", e_4);
+                                        e_5 = _a.sent();
+                                        lib_1.logger.error("Formo: Failed to track transaction rejection", e_5);
                                         return [3 /*break*/, 4];
                                     case 4: return [2 /*return*/];
                                 }
@@ -649,116 +772,16 @@ var FormoAnalytics = /** @class */ (function () {
             });
         }); };
     };
-    FormoAnalytics.prototype.onAddressChanged = function (addresses) {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                if (addresses.length > 0) {
-                    this.onAddressConnected(addresses[0]);
-                }
-                else {
-                    this.onAddressDisconnected();
-                }
-                return [2 /*return*/];
-            });
-        });
-    };
-    FormoAnalytics.prototype.onAddressConnected = function (address) {
-        return __awaiter(this, void 0, void 0, function () {
-            var _a;
-            return __generator(this, function (_b) {
-                switch (_b.label) {
-                    case 0:
-                        if (address === this.currentAddress)
-                            // We have already reported this address
-                            return [2 /*return*/];
-                        this.currentAddress = address;
-                        _a = this;
-                        return [4 /*yield*/, this.getCurrentChainId()];
-                    case 1:
-                        _a.currentChainId = _b.sent();
-                        this.connect({ chainId: this.currentChainId, address: address });
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    FormoAnalytics.prototype.handleDisconnect = function (chainId, address, properties, context, callback) {
-        return __awaiter(this, void 0, void 0, function () {
-            var payload;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        payload = {
-                            chainId: chainId || this.currentChainId,
-                            address: address || this.currentAddress,
-                        };
-                        this.currentChainId = undefined;
-                        this.currentAddress = undefined;
-                        (0, lib_1.cookie)().remove(constants_1.SESSION_USER_ID_KEY);
-                        return [4 /*yield*/, this.trackEvent(constants_1.EventType.DISCONNECT, payload, properties, context, callback)];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    FormoAnalytics.prototype.onAddressDisconnected = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0: return [4 /*yield*/, this.handleDisconnect(this.currentChainId, this.currentAddress)];
-                    case 1:
-                        _a.sent();
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    FormoAnalytics.prototype.onChainChanged = function (chainIdHex) {
-        return __awaiter(this, void 0, void 0, function () {
-            var address;
-            return __generator(this, function (_a) {
-                switch (_a.label) {
-                    case 0:
-                        this.currentChainId = parseInt(chainIdHex);
-                        if (!!this.currentAddress) return [3 /*break*/, 2];
-                        if (!this.provider) {
-                            lib_1.logger.info("OnChainChanged: Provider not found. CHAIN_CHANGED not reported");
-                            return [2 /*return*/, Promise.resolve()];
-                        }
-                        return [4 /*yield*/, this.getAddress()];
-                    case 1:
-                        address = _a.sent();
-                        if (!address) {
-                            lib_1.logger.info("OnChainChanged: Unable to fetch or store connected address");
-                            return [2 /*return*/, Promise.resolve()];
-                        }
-                        this.currentAddress = address;
-                        _a.label = 2;
-                    case 2:
-                        // Proceed only if the address exists
-                        if (this.currentAddress) {
-                            return [2 /*return*/, this.chain({
-                                    chainId: this.currentChainId,
-                                    address: this.currentAddress,
-                                })];
-                        }
-                        else {
-                            lib_1.logger.info("OnChainChanged: Current connected address is null despite fetch attempt");
-                        }
-                        return [2 /*return*/];
-                }
-            });
-        });
-    };
-    FormoAnalytics.prototype.trackFirstPageHit = function () {
+    FormoAnalytics.prototype.onLocationChange = function () {
         return __awaiter(this, void 0, void 0, function () {
+            var currentUrl;
             return __generator(this, function (_a) {
-                if ((0, lib_1.cookie)().get(constants_1.SESSION_CURRENT_URL_KEY) === null) {
+                currentUrl = (0, lib_1.cookie)().get(constants_1.SESSION_CURRENT_URL_KEY);
+                if (currentUrl !== window.location.href) {
                     (0, lib_1.cookie)().set(constants_1.SESSION_CURRENT_URL_KEY, window.location.href);
+                    this.trackPageHit();
                 }
-                return [2 /*return*/, this.trackPageHit()];
+                return [2 /*return*/];
             });
         });
     };
@@ -793,25 +816,13 @@ var FormoAnalytics = /** @class */ (function () {
             });
         });
     };
-    FormoAnalytics.prototype.onLocationChange = function () {
-        return __awaiter(this, void 0, void 0, function () {
-            var currentUrl;
-            return __generator(this, function (_a) {
-                currentUrl = (0, lib_1.cookie)().get(constants_1.SESSION_CURRENT_URL_KEY);
-                if (currentUrl !== window.location.href) {
-                    (0, lib_1.cookie)().set(constants_1.SESSION_CURRENT_URL_KEY, window.location.href);
-                    this.trackPageHit();
-                }
-                return [2 /*return*/];
-            });
-        });
-    };
     FormoAnalytics.prototype.trackPageHit = function (category, name, properties, context, callback) {
         return __awaiter(this, void 0, void 0, function () {
             var _this = this;
             return __generator(this, function (_a) {
-                if (!this.config.trackLocalhost && (0, validators_1.isLocalhost)()) {
-                    return [2 /*return*/, lib_1.logger.warn("Track page hit: Ignoring event because website is running locally")];
+                if (!this.shouldTrack()) {
+                    lib_1.logger.info("Track page hit: Skipping event due to tracking configuration");
+                    return [2 /*return*/];
                 }
                 setTimeout(function () { return __awaiter(_this, void 0, void 0, function () {
                     return __generator(this, function (_a) {
@@ -830,6 +841,10 @@ var FormoAnalytics = /** @class */ (function () {
         return __awaiter(this, void 0, void 0, function () {
             return __generator(this, function (_a) {
                 try {
+                    if (!this.shouldTrack()) {
+                        lib_1.logger.info("Skipping ".concat(type, " event due to tracking configuration"));
+                        return [2 /*return*/];
+                    }
                     this.eventManager.addEvent(__assign(__assign({ type: type }, payload), { properties: properties, context: context, callback: callback }), this.currentAddress, this.currentUserId);
                 }
                 catch (error) {
@@ -839,6 +854,46 @@ var FormoAnalytics = /** @class */ (function () {
             });
         });
     };
+    /**
+     * Determines if tracking should be enabled based on configuration
+     * @returns {boolean} True if tracking should be enabled
+     */
+    FormoAnalytics.prototype.shouldTrack = function () {
+        // Check if tracking is explicitly provided as a boolean
+        if (typeof this.options.tracking === 'boolean') {
+            return this.options.tracking;
+        }
+        // Handle object configuration with exclusion rules
+        if (this.options.tracking !== null &&
+            typeof this.options.tracking === 'object' &&
+            !Array.isArray(this.options.tracking)) {
+            var _a = this.options.tracking, _b = _a.excludeHosts, excludeHosts = _b === void 0 ? [] : _b, _c = _a.excludePaths, excludePaths = _c === void 0 ? [] : _c, _d = _a.excludeChains, excludeChains = _d === void 0 ? [] : _d;
+            // Check hostname exclusions - use exact matching
+            if (excludeHosts.length > 0 && typeof window !== 'undefined') {
+                var hostname = window.location.hostname;
+                if (excludeHosts.includes(hostname)) {
+                    return false;
+                }
+            }
+            // Check path exclusions - use exact matching
+            if (excludePaths.length > 0 && typeof window !== 'undefined') {
+                var pathname = window.location.pathname;
+                if (excludePaths.includes(pathname)) {
+                    return false;
+                }
+            }
+            // Check chainId exclusions
+            if (excludeChains.length > 0 &&
+                this.currentChainId &&
+                excludeChains.includes(this.currentChainId)) {
+                return false;
+            }
+            // If nothing is excluded, tracking is enabled
+            return true;
+        }
+        // Default behavior: track everywhere except localhost
+        return !(0, validators_1.isLocalhost)();
+    };
     /*
       Utility functions
     */
@@ -994,7 +1049,7 @@ var FormoAnalytics = /** @class */ (function () {
                             lib_1.logger.info("Chain id not found");
                             return [2 /*return*/, 0];
                         }
-                        return [2 /*return*/, parseInt(chainIdHex, 16)];
+                        return [2 /*return*/, (0, chain_1.parseChainId)(chainIdHex)];
                     case 3:
                         err_5 = _b.sent();
                         lib_1.logger.error("eth_chainId threw an error:", err_5);
@@ -1057,7 +1112,7 @@ var FormoAnalytics = /** @class */ (function () {
                 if (!provider)
                     return [2 /*return*/];
                 poll = function () { return __awaiter(_this, void 0, void 0, function () {
-                    var receipt, e_5;
+                    var receipt, e_6;
                     return __generator(this, function (_a) {
                         switch (_a.label) {
                             case 0:
@@ -1081,8 +1136,8 @@ var FormoAnalytics = /** @class */ (function () {
                                 }
                                 return [3 /*break*/, 3];
                             case 2:
-                                e_5 = _a.sent();
-                                lib_1.logger.error("Error polling transaction receipt", e_5);
+                                e_6 = _a.sent();
+                                lib_1.logger.error("Error polling transaction receipt", e_6);
                                 return [3 /*break*/, 3];
                             case 3:
                                 attempts++;