@formo/analytics 1.39.0 → 1.40.0

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

@@ -54,6 +54,7 @@ export declare class FormoAnalytics implements IFormoAnalytics {
     private _onPopStateListener?;
     private _onLocationChangeListener?;
     private _pageHooksDisposed;
+    private _pageGeneration;
     config: Config;
     /**
      * The wallet later events are attributed to, derived from whichever
@@ -87,7 +88,8 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      */
     page(category?: string, name?: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
     /**
-     * Reset the current user session.
+     * Reset user and wallet state while preserving the browser's anonymous id.
+     * Use `optOutTracking()` to clear the anonymous id and the attribution.
      * @returns {void}
      */
     reset(): void;
@@ -142,6 +144,7 @@ export declare class FormoAnalytics implements IFormoAnalytics {
         chainId?: ChainID;
         address?: Address;
     }): void;
+    private retryWalletDetection;
     /** @see WalletStateStore.clearProvider */
     private clearActiveProvider;
     /** @see WalletStateStore.backfill */

package/dist/cjs/src/FormoAnalytics.js

@@ -52,6 +52,7 @@ var constants_1 = require("./constants");
 var storage_1 = require("./storage");
 var cookiePolicy_1 = require("./storage/cookiePolicy");
 var event_1 = require("./event");
+var utils_1 = require("./event/utils");
 var queue_1 = require("./queue");
 var logger_1 = require("./logger");
 var consent_1 = require("./consent");
@@ -68,7 +69,7 @@ var wagmi_1 = require("./wagmi");
 var solana_1 = require("./solana");
 var SolanaManager_1 = require("./solana/SolanaManager");
 // Internal: the Privy identify is reached through identify(user), not exported.
-var utils_1 = require("./privy/utils");
+var utils_2 = require("./privy/utils");
 /**
  * Constants for provider switching reasons
  */
@@ -93,6 +94,7 @@ var FormoAnalytics = /** @class */ (function () {
         /** In-memory URL used to deduplicate SPA pageview events. */
         this._currentUrl = "";
         this._pageHooksDisposed = false;
+        this._pageGeneration = 0;
         this.currentUserId = "";
         /**
          * Clean up resources and event listeners
@@ -190,6 +192,7 @@ var FormoAnalytics = /** @class */ (function () {
             isAutocaptureEnabled: function (t) { return _this.isAutocaptureEnabled(t); },
             isTrackingSuppressed: function () { return _this.isTrackingSuppressed(); },
             willTrackEvent: function (chainId) { return _this.willTrackEvent(chainId); },
+            retryDetection: function () { return _this.retryWalletDetection(); },
             isWagmiMode: function () { return _this.isWagmiMode; },
             connect: function (params, properties) { return _this.connect(params, properties); },
             disconnect: function (params) { return _this.disconnect(params); },
@@ -218,7 +221,7 @@ var FormoAnalytics = /** @class */ (function () {
             // ever sent once the user has opted out, even via a timer or
             // pagehide flush scheduled before opt-out.
             canSend: function () { return !_this.hasOptedOutTracking(); },
-        }), options);
+        }), options, function () { return !_this.hasOptedOutTracking(); });
         // Check consent status on initialization
         if (this.hasOptedOutTracking()) {
             logger_1.logger.info("User has previously opted out of tracking");
@@ -320,7 +323,7 @@ var FormoAnalytics = /** @class */ (function () {
     });
     FormoAnalytics.init = function (writeKey, options) {
         return __awaiter(this, void 0, void 0, function () {
-            var analytics, discovered;
+            var analytics, discovered, error_1;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -330,18 +333,21 @@ var FormoAnalytics = /** @class */ (function () {
                         logger_1.logger.info("FormoAnalytics: Skipping provider detection (EVM disabled)");
                         return [3 /*break*/, 5];
                     case 1:
-                        if (!!analytics.isWagmiMode) return [3 /*break*/, 4];
+                        _a.trys.push([1, 4, , 5]);
                         return [4 /*yield*/, analytics.evmEvents.getProviders()];
                     case 2:
                         discovered = _a.sent();
                         return [4 /*yield*/, analytics.evmEvents.detectWallets(discovered)];
                     case 3:
                         _a.sent();
-                        analytics.evmEvents.trackProviders(discovered);
+                        if (!analytics.isWagmiMode) {
+                            analytics.evmEvents.trackProviders(discovered);
+                        }
                         return [3 /*break*/, 5];
                     case 4:
-                        logger_1.logger.info("FormoAnalytics: Skipping provider detection (Wagmi mode)");
-                        _a.label = 5;
+                        error_1 = _a.sent();
+                        logger_1.logger.warn("FormoAnalytics: Provider discovery failed", error_1);
+                        return [3 /*break*/, 5];
                     case 5: return [2 /*return*/, analytics];
                 }
             });
@@ -372,7 +378,8 @@ var FormoAnalytics = /** @class */ (function () {
         });
     };
     /**
-     * Reset the current user session.
+     * Reset user and wallet state while preserving the browser's anonymous id.
+     * Use `optOutTracking()` to clear the anonymous id and the attribution.
      * @returns {void}
      */
     FormoAnalytics.prototype.reset = function () {
@@ -383,15 +390,11 @@ var FormoAnalytics = /** @class */ (function () {
         // page lifetime, because they fall back to currentAddress. Keep the
         // EVM provider reference so tracking can resume on the next connect.
         this.wallet.reset();
-        (0, storage_1.cookie)().remove(constants_1.LOCAL_ANONYMOUS_ID_KEY);
         (0, storage_1.cookie)().remove(constants_1.SESSION_USER_ID_KEY);
         (0, storage_1.cookie)().remove(session_1.SESSION_WALLET_DETECTED_KEY);
         (0, storage_1.cookie)().remove(session_1.SESSION_WALLET_IDENTIFIED_KEY);
         (0, storage_1.cookie)().remove(constants_1.ACTIVE_WALLET_KEY);
-        // Stored traffic-source attribution (referrer/UTM) is tracking data;
-        // clear it too so reset()/optOutTracking() don't leave it to be
-        // re-attached to the next session's events.
-        (0, storage_1.session)().remove(constants_1.SESSION_TRAFFIC_SOURCE_KEY);
+        // Attribution belongs to the visit, so reset preserves it.
     };
     FormoAnalytics.prototype.cleanup = function () {
         this.isCleanedUp = true;
@@ -575,6 +578,12 @@ var FormoAnalytics = /** @class */ (function () {
      */
     FormoAnalytics.prototype.syncWalletState = function (params) {
         this.wallet.syncWalletState(params);
+        this.retryWalletDetection();
+    };
+    FormoAnalytics.prototype.retryWalletDetection = function () {
+        if (this.isCleanedUp)
+            return;
+        void this.evmEvents.detectWallets(this.evmEvents.detectableProviders());
     };
     /** @see WalletStateStore.clearProvider */
     FormoAnalytics.prototype.clearActiveProvider = function () {
@@ -742,7 +751,7 @@ var FormoAnalytics = /** @class */ (function () {
                         // namespace before emitting. It reads this.currentAddress itself to
                         // preserve an already-connected wallet, so this dispatch is a thin
                         // pass-through and both entry points behave identically.
-                        return [4 /*yield*/, (0, utils_1.identifyPrivyUser)(this, maybeUser, {
+                        return [4 /*yield*/, (0, utils_2.identifyPrivyUser)(this, maybeUser, {
                                 activeAddress: opts.activeAddress,
                                 properties: opts.properties,
                             })];
@@ -774,6 +783,11 @@ var FormoAnalytics = /** @class */ (function () {
                             return [2 /*return*/];
                         }
                         if (!!params) return [3 /*break*/, 12];
+                        // Wagmi owns wallet identification.
+                        if (this.isWagmiMode) {
+                            logger_1.logger.info("identify() without params is a no-op in Wagmi mode");
+                            return [2 /*return*/];
+                        }
                         // If no params provided, auto-identify
                         logger_1.logger.info("Auto-identifying with providers:", this.evm.all.map(function (p) { return p.info.name; }));
                         _i = 0, _a = this.evm.all;
@@ -953,10 +967,8 @@ var FormoAnalytics = /** @class */ (function () {
             return __generator(this, function (_c) {
                 switch (_c.label) {
                     case 0:
-                        // detect() marks wallet detection (a cookie write) before
-                        // trackEvent's consent check - gate it for a suppressed visitor or
-                        // excluded environment (opt-out / timezone / host / path).
-                        if (this.isTrackingSuppressed()) {
+                        // Apply all policy checks before persisting the detection marker.
+                        if (!this.shouldTrack()) {
                             logger_1.logger.info("detect() skipped: tracking is suppressed for this visitor or environment");
                             return [2 /*return*/];
                         }
@@ -1018,6 +1030,7 @@ var FormoAnalytics = /** @class */ (function () {
         // Set opt-out flag in persistent storage using direct cookie access
         // This must be done before switching storage to ensure persistence
         (0, consent_1.setConsentFlag)(this.writeKey, constants_1.CONSENT_OPT_OUT_KEY, "true");
+        this._pageGeneration++;
         // Drop anything already buffered so a pending timer/pagehide flush
         // cannot ship events after consent withdrawal.
         this.eventManager.clear();
@@ -1025,6 +1038,9 @@ var FormoAnalytics = /** @class */ (function () {
         // on opt-in, and nothing else would retry an already-adopted one.
         this.evmEvents.markRegisteredAdoptionsPending();
         this.reset();
+        // Consent withdrawal also clears the browser id and the attribution.
+        (0, utils_1.clearAnonymousId)(constants_1.LOCAL_ANONYMOUS_ID_KEY);
+        (0, storage_1.session)().remove(constants_1.SESSION_TRAFFIC_SOURCE_KEY);
         logger_1.logger.info("Successfully opted out of tracking");
     };
     /**
@@ -1051,11 +1067,9 @@ var FormoAnalytics = /** @class */ (function () {
         logger_1.logger.info("Opting back into tracking");
         // Remove opt-out flag
         (0, consent_1.removeConsentFlag)(this.writeKey, constants_1.CONSENT_OPT_OUT_KEY);
-        // A wallet connected while opted out was declined by syncWalletState, and
-        // an unchanged wagmi connection produces no status or chain update to
-        // retry on. Without this, opting back in leaves that wallet invisible for
-        // the rest of the page load.
+        // Retry wallet adoption skipped while opted out.
         (_a = this.wagmiHandler) === null || _a === void 0 ? void 0 : _a.retryAdoption();
+        this.retryWalletDetection();
         logger_1.logger.info("Successfully opted back into tracking");
     };
     /**
@@ -1136,29 +1150,30 @@ var FormoAnalytics = /** @class */ (function () {
     };
     FormoAnalytics.prototype.trackPageHit = function (category, name, properties, context, callback) {
         return __awaiter(this, void 0, void 0, function () {
+            var canTrack, generation;
             var _this = this;
             return __generator(this, function (_a) {
-                // A route change can end path-based suppression; a provider registered
-                // while suppressed gets its refused session adoption retried here.
-                // Idempotent and cheap when nothing is pending.
-                if (!this.isCleanedUp) {
+                canTrack = this.shouldTrack();
+                if (!this.isCleanedUp && canTrack) {
                     try {
                         this.evmEvents.retryExternalAdoptions();
+                        this.retryWalletDetection();
                     }
                     catch (_b) {
-                        /* never let the retry break a page hit */
+                        // Detection retries must not break page tracking.
                     }
                 }
-                if (!this.shouldTrack()) {
+                if (!canTrack) {
                     logger_1.logger.info("Track page hit: Skipping event due to tracking configuration");
                     return [2 /*return*/];
                 }
+                generation = this._pageGeneration;
                 setTimeout(function () {
                     // Drop in-flight page hits from an SDK instance that was torn down
                     // between scheduling and firing (e.g. provider remount in React Strict
                     // Mode / HMR). Otherwise the orphan instance would queue a page event
                     // here with its stale, never-populated `currentAddress`.
-                    if (_this._pageHooksDisposed)
+                    if (_this._pageHooksDisposed || generation !== _this._pageGeneration)
                         return;
                     (function () { return __awaiter(_this, void 0, void 0, function () {
                         var e_2;
@@ -1188,7 +1203,7 @@ var FormoAnalytics = /** @class */ (function () {
     };
     FormoAnalytics.prototype.trackEvent = function (type, payload, properties, context, callback) {
         return __awaiter(this, void 0, void 0, function () {
-            var error_1;
+            var error_2;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
@@ -1207,8 +1222,8 @@ var FormoAnalytics = /** @class */ (function () {
                         _a.sent();
                         return [3 /*break*/, 3];
                     case 2:
-                        error_1 = _a.sent();
-                        logger_1.logger.error("Error tracking event:", error_1);
+                        error_2 = _a.sent();
+                        logger_1.logger.error("Error tracking event:", error_2);
                         return [3 /*break*/, 3];
                     case 3: return [2 /*return*/];
                 }

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

@@ -1,10 +1,16 @@
 import { Address, APIEvent, ChainID, IFormoEvent, IFormoEventContext, IFormoEventProperties, Nullable, Options, SignatureStatus, TransactionStatus } from "../types";
 import { IEventFactory } from "./type";
 declare class EventFactory implements IEventFactory {
+    /** Consulted once per event, after the only await in creation. */
+    private readonly canCreate;
     private options?;
     private compiledPathPattern?;
     private excludedQueryParams;
-    constructor(options?: Options);
+    /** Bumped by invalidate(); an event created across a bump is dropped. */
+    private generation;
+    constructor(options?: Options, 
+    /** Consulted once per event, after the only await in creation. */
+    canCreate?: () => boolean);
     /**
      * Validate an address for both EVM and Solana chains.
      * Uses chainId for strict validation when available.
@@ -56,6 +62,8 @@ declare class EventFactory implements IEventFactory {
     private redactStoredTrafficSources;
     private getTrafficSources;
     private getScreen;
+    /** Drop every event still being created. Called on clear() and close(). */
+    invalidate(): void;
     private generateContext;
     /**
      * Add any missing default page properties using values from options and defaults

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

@@ -73,11 +73,18 @@ var constants_2 = require("./constants");
 var sanitize_1 = require("./sanitize");
 var utils_2 = require("./utils");
 var browsers_1 = require("../browser/browsers");
+var cancellation_1 = require("./cancellation");
 var ISO_3166_ALPHA_2_REGEX = /^[A-Z]{2}$/;
 var EventFactory = /** @class */ (function () {
-    function EventFactory(options) {
+    function EventFactory(options, 
+    /** Consulted once per event, after the only await in creation. */
+    canCreate) {
+        if (canCreate === void 0) { canCreate = function () { return true; }; }
         var _this = this;
         var _a, _b;
+        this.canCreate = canCreate;
+        /** Bumped by invalidate(); an event created across a bump is dropped. */
+        this.generation = 0;
         this.extractUTMParameters = function (url) {
             var result = {
                 utm_campaign: "",
@@ -410,6 +417,10 @@ var EventFactory = /** @class */ (function () {
             return safeDefaults;
         }
     };
+    /** Drop every event still being created. Called on clear() and close(). */
+    EventFactory.prototype.invalidate = function () {
+        this.generation++;
+    };
     // Contextual fields that are automatically collected and populated by the Formo SDK
     EventFactory.prototype.generateContext = function (context) {
         return __awaiter(this, void 0, void 0, function () {
@@ -433,24 +444,28 @@ var EventFactory = /** @class */ (function () {
     };
     EventFactory.prototype.getEnrichedEvent = function (formoEvent, context) {
         return __awaiter(this, void 0, void 0, function () {
-            var commonEventData, eventChainId, validAddress, processedEvent;
-            var _a;
-            var _b, _c;
-            return __generator(this, function (_d) {
-                switch (_d.label) {
+            var generation, enrichedContext, commonEventData, eventChainId, validAddress, processedEvent;
+            var _a, _b;
+            return __generator(this, function (_c) {
+                switch (_c.label) {
                     case 0:
-                        _a = {};
+                        generation = this.generation;
                         return [4 /*yield*/, this.generateContext(context)];
                     case 1:
-                        commonEventData = (_a.context = _d.sent(),
-                            _a.original_timestamp = (0, timestamp_1.getCurrentTimeFormatted)(),
-                            _a.user_id = formoEvent.user_id,
-                            _a.type = formoEvent.type,
-                            _a.channel = constants_2.CHANNEL,
-                            _a.version = constants_2.VERSION,
-                            _a);
-                        commonEventData.anonymous_id = (0, utils_2.generateAnonymousId)(constants_1.LOCAL_ANONYMOUS_ID_KEY, (_b = this.options) === null || _b === void 0 ? void 0 : _b.crossSubdomainCookies);
-                        eventChainId = (_c = formoEvent.properties) === null || _c === void 0 ? void 0 : _c.chainId;
+                        enrichedContext = _c.sent();
+                        if (generation !== this.generation || !this.canCreate()) {
+                            throw cancellation_1.EVENT_CREATION_CANCELLED;
+                        }
+                        commonEventData = {
+                            context: enrichedContext,
+                            original_timestamp: (0, timestamp_1.getCurrentTimeFormatted)(),
+                            user_id: formoEvent.user_id,
+                            type: formoEvent.type,
+                            channel: constants_2.CHANNEL,
+                            version: constants_2.VERSION,
+                        };
+                        commonEventData.anonymous_id = (0, utils_2.generateAnonymousId)(constants_1.LOCAL_ANONYMOUS_ID_KEY, (_a = this.options) === null || _a === void 0 ? void 0 : _a.crossSubdomainCookies);
+                        eventChainId = (_b = formoEvent.properties) === null || _b === void 0 ? void 0 : _b.chainId;
                         validAddress = this.validateEventAddress(formoEvent.address, eventChainId);
                         commonEventData.address = validAddress;
                         processedEvent = (0, mergeDeepRight_1.default)(formoEvent, commonEventData);

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

@@ -5,14 +5,16 @@ import { IEventFactory, IEventManager } from "./type";
  * A service to generate valid event payloads and queue them for processing
  */
 declare class EventManager implements IEventManager {
+    private readonly canAcceptEvent;
     eventQueue: IEventQueue;
     eventFactory: IEventFactory;
+    private generation;
     /**
      *
      * @param eventQueue Event queue instance
      * @param options Optional configuration (referral parsing, etc.)
      */
-    constructor(eventQueue: IEventQueue, options?: Options);
+    constructor(eventQueue: IEventQueue, options?: Options, canAcceptEvent?: () => boolean);
     /**
      * Consumes a new incoming event
      * @param event Incoming event data

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

@@ -50,6 +50,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.EventManager = void 0;
 var logger_1 = require("../logger");
 var EventFactory_1 = require("./EventFactory");
+var cancellation_1 = require("./cancellation");
 var address_1 = require("../utils/address");
 /**
  * A service to generate valid event payloads and queue them for processing
@@ -60,9 +61,13 @@ var EventManager = /** @class */ (function () {
      * @param eventQueue Event queue instance
      * @param options Optional configuration (referral parsing, etc.)
      */
-    function EventManager(eventQueue, options) {
+    function EventManager(eventQueue, options, canAcceptEvent) {
+        if (canAcceptEvent === void 0) { canAcceptEvent = function () { return true; }; }
+        var _this = this;
+        this.canAcceptEvent = canAcceptEvent;
+        this.generation = 0;
         this.eventQueue = eventQueue;
-        this.eventFactory = new EventFactory_1.EventFactory(options);
+        this.eventFactory = new EventFactory_1.EventFactory(options, function () { return _this.canAcceptEvent(); });
     }
     /**
      * Consumes a new incoming event
@@ -70,14 +75,34 @@ var EventManager = /** @class */ (function () {
      */
     EventManager.prototype.addEvent = function (event, address, userId) {
         return __awaiter(this, void 0, void 0, function () {
-            var callback, _event, formoEvent;
+            var callback, _event, generation, shouldContinue, formoEvent, error_1;
+            var _this = this;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         callback = event.callback, _event = __rest(event, ["callback"]);
-                        return [4 /*yield*/, this.eventFactory.create(_event, address, userId)];
+                        generation = this.generation;
+                        shouldContinue = function () {
+                            return generation === _this.generation && _this.canAcceptEvent();
+                        };
+                        if (!shouldContinue())
+                            return [2 /*return*/];
+                        _a.label = 1;
                     case 1:
+                        _a.trys.push([1, 3, , 4]);
+                        return [4 /*yield*/, this.eventFactory.create(_event, address, userId)];
+                    case 2:
                         formoEvent = _a.sent();
+                        return [3 /*break*/, 4];
+                    case 3:
+                        error_1 = _a.sent();
+                        if (error_1 === cancellation_1.EVENT_CREATION_CANCELLED)
+                            return [2 /*return*/];
+                        throw error_1;
+                    case 4:
+                        // Reject work invalidated while enrichment was pending.
+                        if (!shouldContinue())
+                            return [2 /*return*/];
                         // Check if the final event has a blocked address - don't queue it
                         if (formoEvent.address && (0, address_1.isBlockedAddress)(formoEvent.address)) {
                             logger_1.logger.warn("Event blocked: Address ".concat(formoEvent.address, " is in the blocked list and cannot emit events"));
@@ -98,10 +123,14 @@ var EventManager = /** @class */ (function () {
     };
     /** Drop any buffered events (consent withdrawal). Recoverable. */
     EventManager.prototype.clear = function () {
+        this.generation++;
+        this.eventFactory.invalidate();
         this.eventQueue.clear();
     };
     /** Terminal shutdown on teardown: nothing can be sent after this. */
     EventManager.prototype.close = function () {
+        this.generation++;
+        this.eventFactory.invalidate();
         this.eventQueue.close();
     };
     return EventManager;

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

@@ -0,0 +1,4 @@
+/** Internal control flow: an event invalidated by consent withdrawal. */
+declare const EVENT_CREATION_CANCELLED: unique symbol;
+export { EVENT_CREATION_CANCELLED };
+//# sourceMappingURL=cancellation.d.ts.map

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

@@ -0,0 +1,7 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EVENT_CREATION_CANCELLED = void 0;
+/** Internal control flow: an event invalidated by consent withdrawal. */
+var EVENT_CREATION_CANCELLED = Symbol();
+exports.EVENT_CREATION_CANCELLED = EVENT_CREATION_CANCELLED;
+//# sourceMappingURL=cancellation.js.map

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

@@ -5,6 +5,7 @@ export interface IEventManager {
     close(): void;
 }
 export interface IEventFactory {
+    invalidate(): void;
     create(event: APIEvent, address?: Address, userId?: string): Promise<IFormoEvent>;
 }
 //# sourceMappingURL=type.d.ts.map

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

@@ -1,4 +1,8 @@
 import { AnonymousID } from "../types";
 declare const generateAnonymousId: (key: string, crossSubdomainCookies?: boolean) => AnonymousID;
-export { generateAnonymousId };
+/** Clear the anonymous id from every storage layer. */
+declare const clearAnonymousId: (key: string) => void;
+/** Test hook: forget the page-lifetime memory, as a new page load would. */
+declare const __resetAnonymousIdMemory: () => void;
+export { generateAnonymousId, clearAnonymousId, __resetAnonymousIdMemory };
 //# sourceMappingURL=utils.d.ts.map

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

@@ -11,15 +11,28 @@ var __assign = (this && this.__assign) || function () {
     return __assign.apply(this, arguments);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.generateAnonymousId = void 0;
+exports.__resetAnonymousIdMemory = exports.clearAnonymousId = exports.generateAnonymousId = void 0;
 var utils_1 = require("../utils");
 var storage_1 = require("../storage");
 var cookiePolicy_1 = require("../storage/cookiePolicy");
+/** Page-lifetime fallback when persistent storage is unavailable. */
+var volatileAnonymousId;
+/** Persistent fallback when cookies are unavailable. */
+var readLocal = function (key) {
+    try {
+        var value = (0, storage_1.local)().get(key);
+        return typeof value === "string" && value ? value : undefined;
+    }
+    catch (_a) {
+        return undefined;
+    }
+};
 var generateAnonymousId = function (key, crossSubdomainCookies) {
+    var _a, _b;
     var storedAnonymousId = (0, storage_1.cookie)().get(key);
     var anonymousId = (storedAnonymousId && typeof storedAnonymousId === "string"
         ? storedAnonymousId
-        : (0, utils_1.generateNativeUUID)());
+        : (_b = (_a = readLocal(key)) !== null && _a !== void 0 ? _a : volatileAnonymousId) !== null && _b !== void 0 ? _b : (0, utils_1.generateNativeUUID)());
     var domain = (0, cookiePolicy_1.getIdentityCookieDomain)(crossSubdomainCookies);
     // Re-set the cookie with the configured scope. When crossSubdomainCookies
     // is true, this migrates legacy host-only cookies on the current host to the apex
@@ -27,7 +40,49 @@ var generateAnonymousId = function (key, crossSubdomainCookies) {
     // example.com is not visible from app.example.com) cannot be migrated
     // until the user revisits that host.
     (0, storage_1.cookie)().set(key, anonymousId, __assign(__assign({ expires: new Date(Date.now() + 1000 * 60 * 60 * 24 * 365).toUTCString(), path: "/" }, (0, cookiePolicy_1.getIdentityCookieSecurity)()), (domain ? { domain: domain } : {})));
+    // Retry host-only when a domain-scoped write is rejected.
+    if (domain && (0, storage_1.cookie)().get(key) !== anonymousId) {
+        (0, storage_1.cookie)().set(key, anonymousId, __assign({ expires: new Date(Date.now() + 1000 * 60 * 60 * 24 * 365).toUTCString(), path: "/" }, (0, cookiePolicy_1.getIdentityCookieSecurity)()));
+    }
+    if ((0, storage_1.cookie)().get(key) === anonymousId) {
+        // Prefer the cookie and discard the fallback copy.
+        volatileAnonymousId = undefined;
+        if ((0, storage_1.usesCookieStorage)() && readLocal(key)) {
+            try {
+                (0, storage_1.local)().remove(key);
+            }
+            catch (_c) {
+                // Storage is unavailable.
+            }
+        }
+        return anonymousId;
+    }
+    // Persist across embedded page loads when cookies are blocked.
+    try {
+        (0, storage_1.local)().set(key, anonymousId);
+    }
+    catch (_d) {
+        // Memory remains the last fallback.
+    }
+    volatileAnonymousId = anonymousId;
     return anonymousId;
 };
 exports.generateAnonymousId = generateAnonymousId;
+/** Clear the anonymous id from every storage layer. */
+var clearAnonymousId = function (key) {
+    (0, storage_1.cookie)().remove(key);
+    try {
+        (0, storage_1.local)().remove(key);
+    }
+    catch (_a) {
+        // Storage is unavailable.
+    }
+    volatileAnonymousId = undefined;
+};
+exports.clearAnonymousId = clearAnonymousId;
+/** Test hook: forget the page-lifetime memory, as a new page load would. */
+var __resetAnonymousIdMemory = function () {
+    volatileAnonymousId = undefined;
+};
+exports.__resetAnonymousIdMemory = __resetAnonymousIdMemory;
 //# sourceMappingURL=utils.js.map

package/dist/cjs/src/evm/EvmEventTracker.d.ts

@@ -11,6 +11,8 @@ export interface EvmEventTrackerDeps {
     isTrackingSuppressed(): boolean;
     /** Whether an event on this chain would actually be sent. */
     willTrackEvent(chainId?: ChainID): boolean;
+    /** Retry detect events after the active chain changes. */
+    retryDetection(): void;
     /** In wagmi mode the SDK does not wrap providers itself. */
     isWagmiMode(): boolean;
     /** Emission. The tracker decides WHEN; the SDK owns the event API. */
@@ -152,6 +154,8 @@ export declare class EvmEventTracker {
      * had already replaced.
      */
     private unsubscribeDiscovery?;
+    /** Discovery store retained for complete listener cleanup. */
+    private discoveryStore?;
     constructor(wallet: WalletStateStore, registry: EvmProviderRegistry, deps: EvmEventTrackerDeps);
     /** Stop listening for wallet announcements. Called from SDK teardown. */
     cleanup(): void;
@@ -259,8 +263,11 @@ export declare class EvmEventTracker {
     private registerConnectListener;
     private registerDisconnectListener;
     private onConnected;
+    /** Whether Formo owns provider lifecycle tracking. */
+    private tracksDiscovered;
     getProviders(): Promise<readonly EIP6963ProviderDetail[]>;
     detectWallets(providers: readonly EIP6963ProviderDetail[]): Promise<void>;
+    detectableProviders(): readonly EIP6963ProviderDetail[];
     /**
      * Seed a provider's chain from whatever it already exposes synchronously.
      *