@formo/analytics 1.19.10 → 1.21.0

package/dist/esm/src/FormoAnalytics.js

@@ -55,8 +55,8 @@ var __spreadArray = (this && this.__spreadArray) || function (to, from, pack) {
     return to.concat(ar || Array.prototype.slice.call(from));
 };
 import { createStore } from "mipd";
-import { EVENTS_API_URL, EventType, LOCAL_ANONYMOUS_ID_KEY, SESSION_CURRENT_URL_KEY, SESSION_USER_ID_KEY, SESSION_WALLET_DETECTED_KEY, SESSION_WALLET_IDENTIFIED_KEY, DEFAULT_PROVIDER_ICON, } from "./constants";
-import { cookie, EventManager, EventQueue, initStorageManager, logger, Logger, } from "./lib";
+import { EVENTS_API_URL, EventType, LOCAL_ANONYMOUS_ID_KEY, SESSION_CURRENT_URL_KEY, SESSION_USER_ID_KEY, SESSION_WALLET_DETECTED_KEY, SESSION_WALLET_IDENTIFIED_KEY, DEFAULT_PROVIDER_ICON, CONSENT_OPT_OUT_KEY, } from "./constants";
+import { cookie, EventManager, EventQueue, initStorageManager, logger, Logger, setConsentFlag, getConsentFlag, removeConsentFlag, } from "./lib";
 import { SignatureStatus, TransactionStatus, WRAPPED_REQUEST_SYMBOL, WRAPPED_REQUEST_REF_SYMBOL, } from "./types";
 import { toChecksumAddress } from "./utils";
 import { getValidAddress } from "./utils/address";
@@ -68,7 +68,7 @@ import { parseChainId } from "./utils/chain";
 var PROVIDER_SWITCH_REASONS = {
     ADDRESS_MISMATCH: "Address mismatch indicates wallet switch",
     NO_ACCOUNTS: "Current provider has no accounts",
-    CHECK_FAILED: "Could not check current provider accounts"
+    CHECK_FAILED: "Could not check current provider accounts",
 };
 var FormoAnalytics = /** @class */ (function () {
     function FormoAnalytics(writeKey, options) {
@@ -123,13 +123,17 @@ var FormoAnalytics = /** @class */ (function () {
             maxQueueSize: options.maxQueueSize,
             flushInterval: options.flushInterval,
         }));
+        // Check consent status on initialization
+        if (this.hasOptedOutTracking()) {
+            logger.info("User has previously opted out of tracking");
+        }
         // Handle initial provider (injected) as fallback; listeners for EIP-6963 are added later
         var provider = undefined;
         var optProvider = options.provider;
         if (optProvider) {
             provider = optProvider;
         }
-        else if (typeof window !== 'undefined' && window.ethereum) {
+        else if (typeof window !== "undefined" && window.ethereum) {
             provider = window.ethereum;
         }
         if (provider) {
@@ -156,9 +160,9 @@ var FormoAnalytics = /** @class */ (function () {
     FormoAnalytics.prototype.isProviderInValidState = function (provider) {
         // Basic validation: ensure provider exists and has required methods
         return (provider &&
-            typeof provider.request === 'function' &&
-            typeof provider.on === 'function' &&
-            typeof provider.removeListener === 'function');
+            typeof provider.request === "function" &&
+            typeof provider.on === "function" &&
+            typeof provider.removeListener === "function");
     };
     FormoAnalytics.init = function (writeKey, options) {
         return __awaiter(this, void 0, void 0, function () {
@@ -277,16 +281,18 @@ var FormoAnalytics = /** @class */ (function () {
                     case 0:
                         chainId = (params === null || params === void 0 ? void 0 : params.chainId) || this.currentChainId;
                         address = (params === null || params === void 0 ? void 0 : params.address) || this.currentAddress;
-                        providerInfo = this._provider ? this.getProviderInfo(this._provider) : null;
+                        providerInfo = this._provider
+                            ? this.getProviderInfo(this._provider)
+                            : null;
                         logger.info("Disconnect: Emitting disconnect event with:", {
                             chainId: chainId,
                             address: address,
                             providerName: providerInfo === null || providerInfo === void 0 ? void 0 : providerInfo.name,
-                            rdns: providerInfo === null || providerInfo === void 0 ? void 0 : providerInfo.rdns
+                            rdns: providerInfo === null || providerInfo === void 0 ? void 0 : providerInfo.rdns,
                         });
                         disconnectProperties = __assign(__assign({}, (providerInfo && {
                             providerName: providerInfo.name,
-                            rdns: providerInfo.rdns
+                            rdns: providerInfo.rdns,
                         })), properties);
                         return [4 /*yield*/, this.trackEvent(EventType.DISCONNECT, __assign(__assign({}, (chainId && { chainId: chainId })), (address && { address: address })), disconnectProperties, context, callback)];
                     case 1:
@@ -433,9 +439,12 @@ var FormoAnalytics = /** @class */ (function () {
                             validAddress: validAddress_1,
                             rdns: providerDetail.info.rdns,
                             providerName: providerDetail.info.name,
-                            isAlreadyIdentified: validAddress_1 ? this.session.isWalletIdentified(validAddress_1, providerDetail.info.rdns) : false
+                            isAlreadyIdentified: validAddress_1
+                                ? this.session.isWalletIdentified(validAddress_1, providerDetail.info.rdns)
+                                : false,
                         });
-                        if (!(validAddress_1 && !this.session.isWalletIdentified(validAddress_1, providerDetail.info.rdns))) return [3 /*break*/, 5];
+                        if (!(validAddress_1 &&
+                            !this.session.isWalletIdentified(validAddress_1, providerDetail.info.rdns))) return [3 /*break*/, 5];
                         logger.info("Auto-identifying", validAddress_1, providerDetail.info.name, providerDetail.info.rdns);
                         // NOTE: do not set this.currentAddress without explicit connect or identify
                         return [4 /*yield*/, this.identify({
@@ -479,23 +488,25 @@ var FormoAnalytics = /** @class */ (function () {
                             this.currentUserId = userId;
                             cookie().set(SESSION_USER_ID_KEY, userId);
                         }
-                        isAlreadyIdentified = validAddress ? this.session.isWalletIdentified(validAddress, rdns || '') : false;
+                        isAlreadyIdentified = validAddress
+                            ? this.session.isWalletIdentified(validAddress, rdns || "")
+                            : false;
                         logger.debug("Identify: Checking deduplication", {
                             validAddress: validAddress,
                             rdns: rdns,
                             providerName: providerName,
                             hasValidAddress: !!validAddress,
                             hasRdns: !!rdns,
-                            isAlreadyIdentified: isAlreadyIdentified
+                            isAlreadyIdentified: isAlreadyIdentified,
                         });
                         if (isAlreadyIdentified) {
-                            logger.info("Identify: Wallet ".concat(providerName || 'Unknown', " with address ").concat(validAddress, " already identified in this session (rdns: ").concat(rdns || 'empty', ")"));
+                            logger.info("Identify: Wallet ".concat(providerName || "Unknown", " with address ").concat(validAddress, " already identified in this session (rdns: ").concat(rdns || "empty", ")"));
                             return [2 /*return*/];
                         }
                         // Mark as identified before emitting the event
                         // Mark even if rdns is empty to prevent duplicate empty identifies
                         if (validAddress) {
-                            this.session.markWalletIdentified(validAddress, rdns || '');
+                            this.session.markWalletIdentified(validAddress, rdns || "");
                         }
                         return [4 /*yield*/, this.trackEvent(EventType.IDENTIFY, {
                                 address: validAddress,
@@ -564,6 +575,39 @@ var FormoAnalytics = /** @class */ (function () {
             });
         });
     };
+    /*
+      Consent management functions
+    */
+    /**
+     * Opt out of tracking.
+     * @returns {void}
+     */
+    FormoAnalytics.prototype.optOutTracking = function () {
+        logger.info("Opting out of tracking");
+        // Set opt-out flag in persistent storage using direct cookie access
+        // This must be done before switching storage to ensure persistence
+        setConsentFlag(this.writeKey, CONSENT_OPT_OUT_KEY, "true");
+        this.reset();
+        logger.info("Successfully opted out of tracking");
+    };
+    /**
+     * Opt back into tracking after previously opting out. This will re-enable analytics tracking
+     * and switch back to persistent storage.
+     * @returns {void}
+     */
+    FormoAnalytics.prototype.optInTracking = function () {
+        logger.info("Opting back into tracking");
+        // Remove opt-out flag
+        removeConsentFlag(this.writeKey, CONSENT_OPT_OUT_KEY);
+        logger.info("Successfully opted back into tracking");
+    };
+    /**
+     * Check if the user has opted out of tracking.
+     * @returns {boolean} True if the user has opted out
+     */
+    FormoAnalytics.prototype.hasOptedOutTracking = function () {
+        return getConsentFlag(this.writeKey, CONSENT_OPT_OUT_KEY) === "true";
+    };
     /*
       SDK tracking and event listener functions
     */
@@ -630,7 +674,7 @@ var FormoAnalytics = /** @class */ (function () {
                         // Prevent concurrent processing of accountsChanged events to avoid race conditions
                         if (this._processingAccountsChanged) {
                             logger.debug("OnAccountsChanged: Already processing accountsChanged, skipping", {
-                                provider: this.getProviderInfo(provider).name
+                                provider: this.getProviderInfo(provider).name,
                             });
                             return [2 /*return*/];
                         }
@@ -671,7 +715,7 @@ var FormoAnalytics = /** @class */ (function () {
                         logger.info("OnAccountsChanged: Detecting disconnect, current state:", {
                             currentAddress: this.currentAddress,
                             currentChainId: this.currentChainId,
-                            providerMatch: this._provider === provider
+                            providerMatch: this._provider === provider,
                         });
                         _a.label = 1;
                     case 1:
@@ -679,7 +723,7 @@ var FormoAnalytics = /** @class */ (function () {
                         // Pass current state explicitly to ensure we have the data for the disconnect event
                         return [4 /*yield*/, this.disconnect({
                                 chainId: this.currentChainId,
-                                address: this.currentAddress
+                                address: this.currentAddress,
                             })];
                     case 2:
                         // Pass current state explicitly to ensure we have the data for the disconnect event
@@ -707,7 +751,7 @@ var FormoAnalytics = /** @class */ (function () {
                             activeProvider: this.getProviderInfo(this._provider).name,
                             eventProvider: this.getProviderInfo(provider).name,
                             currentStoredAddress: currentStoredAddress,
-                            newProviderAddress: newProviderAddress
+                            newProviderAddress: newProviderAddress,
                         });
                         _a.label = 8;
                     case 8:
@@ -717,22 +761,26 @@ var FormoAnalytics = /** @class */ (function () {
                         activeProviderAccounts = _a.sent();
                         logger.info("OnAccountsChanged: Checking current provider accounts", {
                             activeProvider: this.getProviderInfo(this._provider).name,
-                            accountsLength: activeProviderAccounts ? activeProviderAccounts.length : 0,
-                            accounts: activeProviderAccounts
+                            accountsLength: activeProviderAccounts
+                                ? activeProviderAccounts.length
+                                : 0,
+                            accounts: activeProviderAccounts,
                         });
                         if (!(activeProviderAccounts && activeProviderAccounts.length > 0)) return [3 /*break*/, 13];
-                        if (!(newProviderAddress && currentStoredAddress && newProviderAddress !== currentStoredAddress)) return [3 /*break*/, 11];
+                        if (!(newProviderAddress &&
+                            currentStoredAddress &&
+                            newProviderAddress !== currentStoredAddress)) return [3 /*break*/, 11];
                         logger.info("OnAccountsChanged: Different address detected, switching providers despite current provider having accounts", {
                             activeProvider: this.getProviderInfo(this._provider).name,
                             eventProvider: this.getProviderInfo(provider).name,
                             currentAddress: currentStoredAddress,
                             newAddress: newProviderAddress,
-                            reason: PROVIDER_SWITCH_REASONS.ADDRESS_MISMATCH
+                            reason: PROVIDER_SWITCH_REASONS.ADDRESS_MISMATCH,
                         });
                         // Emit disconnect for the old provider
                         return [4 /*yield*/, this.disconnect({
                                 chainId: this.currentChainId,
-                                address: this.currentAddress
+                                address: this.currentAddress,
                             })];
                     case 10:
                         // Emit disconnect for the old provider
@@ -746,7 +794,7 @@ var FormoAnalytics = /** @class */ (function () {
                             eventProvider: this.getProviderInfo(provider).name,
                             activeProviderAccountsCount: activeProviderAccounts.length,
                             currentAddress: currentStoredAddress,
-                            newAddress: newProviderAddress
+                            newAddress: newProviderAddress,
                         });
                         return [2 /*return*/];
                     case 12: return [3 /*break*/, 15];
@@ -754,12 +802,12 @@ var FormoAnalytics = /** @class */ (function () {
                         logger.info("OnAccountsChanged: Current provider has no accounts, switching to new provider", {
                             oldProvider: this.getProviderInfo(this._provider).name,
                             newProvider: this.getProviderInfo(provider).name,
-                            reason: PROVIDER_SWITCH_REASONS.NO_ACCOUNTS
+                            reason: PROVIDER_SWITCH_REASONS.NO_ACCOUNTS,
                         });
                         // Emit disconnect for the old provider that didn't signal properly
                         return [4 /*yield*/, this.disconnect({
                                 chainId: this.currentChainId,
-                                address: this.currentAddress
+                                address: this.currentAddress,
                             })];
                     case 14:
                         // Emit disconnect for the old provider that didn't signal properly
@@ -773,14 +821,16 @@ var FormoAnalytics = /** @class */ (function () {
                         logger.warn("OnAccountsChanged: Could not check current provider accounts, switching to new provider", {
                             error: error_2 instanceof Error ? error_2.message : String(error_2),
                             errorType: error_2 instanceof Error ? error_2.constructor.name : typeof error_2,
-                            oldProvider: this._provider ? this.getProviderInfo(this._provider).name : 'unknown',
+                            oldProvider: this._provider
+                                ? this.getProviderInfo(this._provider).name
+                                : "unknown",
                             newProvider: this.getProviderInfo(provider).name,
-                            reason: PROVIDER_SWITCH_REASONS.CHECK_FAILED
+                            reason: PROVIDER_SWITCH_REASONS.CHECK_FAILED,
                         });
                         // If we can't check the current provider, assume it's disconnected
                         return [4 /*yield*/, this.disconnect({
                                 chainId: this.currentChainId,
-                                address: this.currentAddress
+                                address: this.currentAddress,
                             })];
                     case 17:
                         // If we can't check the current provider, assume it's disconnected
@@ -809,7 +859,7 @@ var FormoAnalytics = /** @class */ (function () {
                             wasDisconnected: wasDisconnected,
                             providerName: providerInfo.name,
                             rdns: providerInfo.rdns,
-                            hasChainId: !!nextChainId
+                            hasChainId: !!nextChainId,
                         });
                         effectiveChainId = nextChainId || 0;
                         if (effectiveChainId === 0) {
@@ -817,10 +867,10 @@ var FormoAnalytics = /** @class */ (function () {
                         }
                         this.connect({
                             chainId: effectiveChainId,
-                            address: address
+                            address: address,
                         }, {
                             providerName: providerInfo.name,
-                            rdns: providerInfo.rdns
+                            rdns: providerInfo.rdns,
                         }).catch(function (error) {
                             logger.error("Failed to track connect event during account change:", error);
                         });
@@ -902,7 +952,7 @@ var FormoAnalytics = /** @class */ (function () {
                             return [2 /*return*/];
                         logger.info("OnDisconnect: Wallet disconnect event received, current state:", {
                             currentAddress: this.currentAddress,
-                            currentChainId: this.currentChainId
+                            currentChainId: this.currentChainId,
                         });
                         _a.label = 1;
                     case 1:
@@ -910,7 +960,7 @@ var FormoAnalytics = /** @class */ (function () {
                         // Pass current state explicitly to ensure we have the data for the disconnect event
                         return [4 /*yield*/, this.disconnect({
                                 chainId: this.currentChainId,
-                                address: this.currentAddress
+                                address: this.currentAddress,
                             })];
                     case 2:
                         // Pass current state explicitly to ensure we have the data for the disconnect event
@@ -937,7 +987,7 @@ var FormoAnalytics = /** @class */ (function () {
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 3, , 4]);
-                        if (!(connection === null || connection === void 0 ? void 0 : connection.chainId) || typeof connection.chainId !== 'string')
+                        if (!(connection === null || connection === void 0 ? void 0 : connection.chainId) || typeof connection.chainId !== "string")
                             return [2 /*return*/];
                         chainId = parseChainId(connection.chainId);
                         return [4 /*yield*/, this.getAddress(provider)];
@@ -953,7 +1003,8 @@ var FormoAnalytics = /** @class */ (function () {
                             // Only update global state (chainId/address) from the active provider
                             if (isActiveProvider) {
                                 this.currentChainId = chainId;
-                                this.currentAddress = this.validateAndChecksumAddress(address) || undefined;
+                                this.currentAddress =
+                                    this.validateAndChecksumAddress(address) || undefined;
                             }
                             if (isActiveProvider && this.currentAddress) {
                                 providerInfo = this.getProviderInfo(provider);
@@ -963,7 +1014,7 @@ var FormoAnalytics = /** @class */ (function () {
                                     providerName: providerInfo.name,
                                     rdns: providerInfo.rdns,
                                     hasChainId: !!chainId,
-                                    isActiveProvider: isActiveProvider
+                                    isActiveProvider: isActiveProvider,
                                 });
                                 effectiveChainId = chainId || 0;
                                 if (effectiveChainId === 0) {
@@ -971,10 +1022,10 @@ var FormoAnalytics = /** @class */ (function () {
                                 }
                                 this.connect({
                                     chainId: effectiveChainId,
-                                    address: address
+                                    address: address,
                                 }, {
                                     providerName: providerInfo.name,
-                                    rdns: providerInfo.rdns
+                                    rdns: providerInfo.rdns,
                                 }).catch(function (error) {
                                     logger.error("Failed to track connect event during provider connection:", error);
                                 });
@@ -986,7 +1037,9 @@ var FormoAnalytics = /** @class */ (function () {
                                     providerName: providerInfo.name,
                                     rdns: providerInfo.rdns,
                                     isActiveProvider: isActiveProvider,
-                                    activeProviderInfo: this._provider ? this.getProviderInfo(this._provider) : null
+                                    activeProviderInfo: this._provider
+                                        ? this.getProviderInfo(this._provider)
+                                        : null,
                                 });
                             }
                         }
@@ -1168,7 +1221,8 @@ var FormoAnalytics = /** @class */ (function () {
         }); };
         // Mark the wrapper so we can detect if request is replaced externally and keep a reference on provider
         wrappedRequest[WRAPPED_REQUEST_SYMBOL] = true;
-        provider[WRAPPED_REQUEST_REF_SYMBOL] = wrappedRequest;
+        provider[WRAPPED_REQUEST_REF_SYMBOL] =
+            wrappedRequest;
         try {
             // Attempt to assign the wrapped request function (rely on try-catch for mutability errors)
             provider.request = wrappedRequest;
@@ -1258,44 +1312,55 @@ var FormoAnalytics = /** @class */ (function () {
     };
     FormoAnalytics.prototype.trackEvent = function (type, payload, properties, context, callback) {
         return __awaiter(this, void 0, void 0, function () {
+            var error_5;
             return __generator(this, function (_a) {
-                try {
-                    if (!this.shouldTrack()) {
-                        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) {
-                    logger.error("Error tracking event:", error);
+                switch (_a.label) {
+                    case 0:
+                        _a.trys.push([0, 2, , 3]);
+                        if (!this.shouldTrack()) {
+                            logger.info("Skipping ".concat(type, " event due to tracking configuration"));
+                            return [2 /*return*/];
+                        }
+                        return [4 /*yield*/, this.eventManager.addEvent(__assign(__assign({ type: type }, payload), { properties: properties, context: context, callback: callback }), this.currentAddress, this.currentUserId)];
+                    case 1:
+                        _a.sent();
+                        return [3 /*break*/, 3];
+                    case 2:
+                        error_5 = _a.sent();
+                        logger.error("Error tracking event:", error_5);
+                        return [3 /*break*/, 3];
+                    case 3: return [2 /*return*/];
                 }
-                return [2 /*return*/];
             });
         });
     };
     /**
-     * Determines if tracking should be enabled based on configuration
+     * Determines if tracking should be enabled based on configuration and consent
      * @returns {boolean} True if tracking should be enabled
      */
     FormoAnalytics.prototype.shouldTrack = function () {
+        // First check if user has opted out of tracking
+        if (this.hasOptedOutTracking()) {
+            return false;
+        }
         // Check if tracking is explicitly provided as a boolean
-        if (typeof this.options.tracking === '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' &&
+            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') {
+            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') {
+            if (excludePaths.length > 0 && typeof window !== "undefined") {
                 var pathname = window.location.pathname;
                 if (excludePaths.includes(pathname)) {
                     return false;
@@ -1327,14 +1392,14 @@ var FormoAnalytics = /** @class */ (function () {
         if (eip6963Provider) {
             return {
                 name: eip6963Provider.info.name,
-                rdns: eip6963Provider.info.rdns
+                rdns: eip6963Provider.info.rdns,
             };
         }
         // Fallback to injected provider detection
         var injectedInfo = this.detectInjectedProviderInfo(provider);
         return {
             name: injectedInfo.name,
-            rdns: injectedInfo.rdns
+            rdns: injectedInfo.rdns,
         };
     };
     /**
@@ -1344,45 +1409,45 @@ var FormoAnalytics = /** @class */ (function () {
      */
     FormoAnalytics.prototype.detectInjectedProviderInfo = function (provider) {
         // Try to detect provider type from common properties
-        var name = 'Injected Provider';
-        var rdns = 'io.injected.provider';
+        var name = "Injected Provider";
+        var rdns = "io.injected.provider";
         // Use WalletProviderFlags interface for type safety
         var flags = provider;
         // Check if it's MetaMask
         if (flags.isMetaMask) {
-            name = 'MetaMask';
-            rdns = 'io.metamask';
+            name = "MetaMask";
+            rdns = "io.metamask";
         }
         // Check if it's Coinbase Wallet
         else if (flags.isCoinbaseWallet) {
-            name = 'Coinbase Wallet';
-            rdns = 'com.coinbase.wallet';
+            name = "Coinbase Wallet";
+            rdns = "com.coinbase.wallet";
         }
         // Check if it's WalletConnect
         else if (flags.isWalletConnect) {
-            name = 'WalletConnect';
-            rdns = 'com.walletconnect';
+            name = "WalletConnect";
+            rdns = "com.walletconnect";
         }
         // Check if it's Trust Wallet
         else if (flags.isTrust) {
-            name = 'Trust Wallet';
-            rdns = 'com.trustwallet';
+            name = "Trust Wallet";
+            rdns = "com.trustwallet";
         }
         // Check if it's Brave Wallet
         else if (flags.isBraveWallet) {
-            name = 'Brave Wallet';
-            rdns = 'com.brave.wallet';
+            name = "Brave Wallet";
+            rdns = "com.brave.wallet";
         }
         // Check if it's Phantom
         else if (flags.isPhantom) {
-            name = 'Phantom';
-            rdns = 'app.phantom';
+            name = "Phantom";
+            rdns = "app.phantom";
         }
         return {
             name: name,
             rdns: rdns,
-            uuid: "injected-".concat(rdns.replace(/[^a-zA-Z0-9]/g, '-')),
-            icon: DEFAULT_PROVIDER_ICON
+            uuid: "injected-".concat(rdns.replace(/[^a-zA-Z0-9]/g, "-")),
+            icon: DEFAULT_PROVIDER_ICON,
         };
     };
     FormoAnalytics.prototype.getProviders = function () {
@@ -1436,7 +1501,7 @@ var FormoAnalytics = /** @class */ (function () {
                 });
                 // Fallback to injected provider if no providers are found
                 if (providers.length === 0) {
-                    injected_1 = typeof window !== 'undefined' ? window.ethereum : undefined;
+                    injected_1 = typeof window !== "undefined" ? window.ethereum : undefined;
                     if (injected_1) {
                         // If we have already detected and cached the injected provider, and it's the same instance, return the cached result
                         if (this._injectedProviderDetail &&
@@ -1447,7 +1512,9 @@ var FormoAnalytics = /** @class */ (function () {
                             }
                             // Merge with existing providers instead of overwriting
                             if (!this._providers.some(function (existing) { return existing.provider === injected_1; })) {
-                                this._providers = __spreadArray(__spreadArray([], this._providers, true), [this._injectedProviderDetail], false);
+                                this._providers = __spreadArray(__spreadArray([], this._providers, true), [
+                                    this._injectedProviderDetail,
+                                ], false);
                             }
                             return [2 /*return*/, this._providers];
                         }
@@ -1458,7 +1525,7 @@ var FormoAnalytics = /** @class */ (function () {
                         injectedProviderInfo = this.detectInjectedProviderInfo(injected_1);
                         injectedDetail = {
                             provider: injected_1,
-                            info: injectedProviderInfo
+                            info: injectedProviderInfo,
                         };
                         // Cache the detected injected provider detail
                         this._injectedProviderDetail = injectedDetail;
@@ -1797,9 +1864,10 @@ var FormoAnalytics = /** @class */ (function () {
      */
     FormoAnalytics.prototype.isProviderAlreadyWrapped = function (provider, currentRequest) {
         return !!(currentRequest &&
-            typeof currentRequest === 'function' &&
+            typeof currentRequest === "function" &&
             currentRequest[WRAPPED_REQUEST_SYMBOL] &&
-            provider[WRAPPED_REQUEST_REF_SYMBOL] === currentRequest);
+            provider[WRAPPED_REQUEST_REF_SYMBOL] ===
+                currentRequest);
     };
     /**
      * Handle provider mismatch by switching to the new provider and invalidating old tokens
@@ -1888,7 +1956,7 @@ var FormoAnalyticsSession = /** @class */ (function () {
         logger.debug("Session: Checking wallet identification", {
             identifiedKey: identifiedKey,
             isIdentified: isIdentified,
-            hasRdns: !!rdns
+            hasRdns: !!rdns,
         });
         return isIdentified;
     };
@@ -1906,14 +1974,14 @@ var FormoAnalyticsSession = /** @class */ (function () {
             });
             logger.debug("Session: Marked wallet as identified", {
                 identifiedKey: identifiedKey,
-                hasRdns: !!rdns
+                hasRdns: !!rdns,
             });
         }
         else {
             logger.info("Session: Wallet already marked as identified", {
                 identifiedKey: identifiedKey,
                 existingWallets: identifiedWallets,
-                hasRdns: !!rdns
+                hasRdns: !!rdns,
             });
         }
     };

package/dist/esm/src/FormoAnalyticsProvider.js

@@ -52,7 +52,7 @@ import { initStorageManager, logger } from "./lib";
 var defaultContext = {
     chain: function () { return Promise.resolve(); },
     page: function () { return Promise.resolve(); },
-    reset: function () { return Promise.resolve(); },
+    reset: function () { },
     detect: function () { return Promise.resolve(); },
     connect: function () { return Promise.resolve(); },
     disconnect: function () { return Promise.resolve(); },
@@ -60,6 +60,10 @@ var defaultContext = {
     transaction: function () { return Promise.resolve(); },
     identify: function () { return Promise.resolve(); },
     track: function () { return Promise.resolve(); },
+    // Consent management methods
+    optOutTracking: function () { },
+    optInTracking: function () { },
+    hasOptedOutTracking: function () { return false; },
 };
 export var FormoAnalyticsContext = createContext(defaultContext);
 export var FormoAnalyticsProvider = function (props) {

package/dist/esm/src/constants/base.d.ts

@@ -4,5 +4,9 @@ export declare const SESSION_WALLET_IDENTIFIED_KEY = "wallet-identified";
 export declare const SESSION_CURRENT_URL_KEY = "analytics-current-url";
 export declare const SESSION_USER_ID_KEY = "user-id";
 export declare const LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";
+export declare const CONSENT_OPT_OUT_KEY = "opt-out-tracking";
 export declare const DEFAULT_PROVIDER_ICON = "data:image/svg+xml;base64,";
+export declare const ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export declare const DEAD_ADDRESS = "0x000000000000000000000000000000000000dEaD";
+export declare const BLOCKED_ADDRESSES: readonly ["0x0000000000000000000000000000000000000000", "0x000000000000000000000000000000000000dEaD"];
 //# sourceMappingURL=base.d.ts.map

package/dist/esm/src/constants/base.js

@@ -4,6 +4,13 @@ export var SESSION_WALLET_IDENTIFIED_KEY = "wallet-identified";
 export var SESSION_CURRENT_URL_KEY = "analytics-current-url";
 export var SESSION_USER_ID_KEY = "user-id";
 export var LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";
+// Consent management keys
+export var CONSENT_OPT_OUT_KEY = "opt-out-tracking";
 // Default provider icon (empty data URL)
 export var DEFAULT_PROVIDER_ICON = 'data:image/svg+xml;base64,';
+// Blocked addresses that should not emit events
+export var ZERO_ADDRESS = "0x0000000000000000000000000000000000000000";
+export var DEAD_ADDRESS = "0x000000000000000000000000000000000000dEaD";
+// Array of all blocked addresses for easy checking
+export var BLOCKED_ADDRESSES = [ZERO_ADDRESS, DEAD_ADDRESS];
 //# sourceMappingURL=base.js.map

package/dist/esm/src/lib/browser/browsers.d.ts

@@ -0,0 +1,3 @@
+export type BrowserName = "brave" | "chrome" | "edge" | "firefox" | "safari" | "opera" | "unknown";
+export declare function detectBrowser(): Promise<BrowserName>;
+//# sourceMappingURL=browsers.d.ts.map