@formo/analytics 1.39.0 → 1.40.0

package/dist/cjs/src/evm/EvmEventTracker.js

@@ -270,7 +270,7 @@ var EvmEventTracker = /** @class */ (function () {
     };
     /** Stop listening for wallet announcements. Called from SDK teardown. */
     EvmEventTracker.prototype.cleanup = function () {
-        var _a;
+        var _a, _b;
         // A replay in flight (awaiting the active wallet's accounts) must not
         // resume into a torn-down instance and commit a session there.
         this.disposed = true;
@@ -280,11 +280,13 @@ var EvmEventTracker = /** @class */ (function () {
         this.retryRequested = false;
         try {
             (_a = this.unsubscribeDiscovery) === null || _a === void 0 ? void 0 : _a.call(this);
+            (_b = this.discoveryStore) === null || _b === void 0 ? void 0 : _b.destroy();
         }
         catch (e) {
             logger_1.logger.warn("Failed to unsubscribe from provider discovery", e);
         }
         this.unsubscribeDiscovery = undefined;
+        this.discoveryStore = undefined;
     };
     EvmEventTracker.prototype.sessionGeneration = function (provider) {
         var _a;
@@ -1018,6 +1020,7 @@ var EvmEventTracker = /** @class */ (function () {
                             this.wallet.provider = provider;
                         }
                         this.wallet.set('evm', { chainId: nextChainId });
+                        this.deps.retryDetection();
                         _a.label = 1;
                     case 1:
                         _a.trys.push([1, 5, , 6]);
@@ -1335,12 +1338,17 @@ var EvmEventTracker = /** @class */ (function () {
             });
         });
     };
+    /** Whether Formo owns provider lifecycle tracking. */
+    EvmEventTracker.prototype.tracksDiscovered = function () {
+        return !this.deps.isWagmiMode();
+    };
     EvmEventTracker.prototype.getProviders = function () {
         return __awaiter(this, void 0, void 0, function () {
             var store, providers, injected, injectedProviderInfo, injectedDetail, uniqueProviders, _i, uniqueProviders_1, detail;
             var _this = this;
             return __generator(this, function (_a) {
                 store = (0, mipd_1.createStore)();
+                this.discoveryStore = store;
                 providers = store.getProviders();
                 this.unsubscribeDiscovery = store.subscribe(function (providerDetails) {
                     providers = providerDetails;
@@ -1359,8 +1367,12 @@ var EvmEventTracker = /** @class */ (function () {
                         var p = detail === null || detail === void 0 ? void 0 : detail.provider;
                         return !!p && !_this.registry.isTracked(p);
                     });
-                    if (newDetails.length > 0) {
+                    // Wagmi detects only providers added by this announcement.
+                    var toDetect = _this.tracksDiscovered() ? newDetails : newlyAddedDetails;
+                    if (_this.tracksDiscovered() && newDetails.length > 0) {
                         _this.trackProviders(newDetails);
+                    }
+                    if (toDetect.length > 0) {
                         // Detect newly discovered wallets (session de-dupes) with error handling
                         (function () { return __awaiter(_this, void 0, void 0, function () {
                             var e_3;
@@ -1368,7 +1380,7 @@ var EvmEventTracker = /** @class */ (function () {
                                 switch (_a.label) {
                                     case 0:
                                         _a.trys.push([0, 2, , 3]);
-                                        return [4 /*yield*/, this.detectWallets(newDetails)];
+                                        return [4 /*yield*/, this.detectWallets(toDetect)];
                                     case 1:
                                         _a.sent();
                                         return [3 /*break*/, 3];
@@ -1394,7 +1406,7 @@ var EvmEventTracker = /** @class */ (function () {
                         if (this.registry.injected &&
                             this.registry.injected.provider === injected) {
                             // Ensure it's tracked
-                            if (!this.registry.isTracked(injected)) {
+                            if (this.tracksDiscovered() && !this.registry.isTracked(injected)) {
                                 this.trackEIP1193Provider(injected);
                             }
                             // Merge with existing providers instead of overwriting
@@ -1402,7 +1414,7 @@ var EvmEventTracker = /** @class */ (function () {
                             return [2 /*return*/, this.registry.all];
                         }
                         // Re-check if the injected provider is already tracked just before tracking
-                        if (!this.registry.isTracked(injected)) {
+                        if (this.tracksDiscovered() && !this.registry.isTracked(injected)) {
                             this.trackEIP1193Provider(injected);
                         }
                         injectedProviderInfo = (0, provider_1.detectInjectedProviderInfo)(injected);
@@ -1462,6 +1474,20 @@ var EvmEventTracker = /** @class */ (function () {
             });
         });
     };
+    EvmEventTracker.prototype.detectableProviders = function () {
+        var _a;
+        var available = new Set();
+        (_a = this.discoveryStore) === null || _a === void 0 ? void 0 : _a.getProviders().forEach(function (detail) {
+            return available.add(detail.provider);
+        });
+        var injected = typeof window !== "undefined" ? window.ethereum : undefined;
+        if (injected)
+            available.add(injected);
+        this.externallyRegistered.forEach(function (provider) { return available.add(provider); });
+        return this.registry.all.filter(function (detail) {
+            return available.has(detail.provider);
+        });
+    };
     /**
      * Seed a provider's chain from whatever it already exposes synchronously.
      *

package/dist/cjs/src/queue/EventQueue.d.ts

@@ -28,6 +28,7 @@ export declare class EventQueue implements IEventQueue {
     private pendingFlush;
     private payloadHashes;
     private canSend?;
+    private generation;
     private closed;
     private disposePageLeave;
     constructor(writeKey: string, options: Options);

package/dist/cjs/src/queue/EventQueue.js

@@ -89,6 +89,7 @@ var EventQueue = /** @class */ (function () {
         this.queue = [];
         this.queueByteSize = 0; // running total of queued items' byteSize
         this.payloadHashes = new Set();
+        this.generation = 0;
         // Terminal shutdown flag. Once set, enqueue() and flush() are no-ops for
         // the rest of this instance's life. See close().
         this.closed = false;
@@ -222,6 +223,7 @@ var EventQueue = /** @class */ (function () {
      * withdrawal / SDK teardown so nothing buffered can be sent later.
      */
     EventQueue.prototype.clear = function () {
+        this.generation++;
         if (this.timer) {
             clearTimeout(this.timer);
             this.timer = null;
@@ -229,6 +231,8 @@ var EventQueue = /** @class */ (function () {
         this.queue = [];
         this.queueByteSize = 0;
         this.payloadHashes.clear();
+        this.flushed = false;
+        this.pendingFlush = null;
     };
     /**
      * Terminal shutdown. Unlike clear(), which only empties the buffer and can
@@ -265,11 +269,12 @@ var EventQueue = /** @class */ (function () {
     });
     EventQueue.prototype.enqueue = function (event, callback) {
         return __awaiter(this, void 0, void 0, function () {
-            var message_id, queueItem, hasReachedFlushAt, hasReachedQueueSize;
+            var generation, message_id, queueItem, hasReachedFlushAt, hasReachedQueueSize;
             return __generator(this, function (_a) {
                 switch (_a.label) {
                     case 0:
                         callback = callback || noop;
+                        generation = this.generation;
                         // A torn-down instance must never buffer, however late the caller
                         // arrives. See close().
                         if (this.closed)
@@ -282,12 +287,12 @@ var EventQueue = /** @class */ (function () {
                         return [4 /*yield*/, this.generateMessageId(event)];
                     case 1:
                         message_id = _a.sent();
-                        // Re-check after the await. A caller that entered before close() is
-                        // suspended here, and on a queue that has not flushed yet its event
-                        // would push and flush immediately - the exact shape of the bug close()
-                        // exists to stop.
-                        if (this.closed)
+                        if (this.closed || generation !== this.generation)
                             return [2 /*return*/];
+                        if (this.canSend && !this.canSend()) {
+                            this.clear();
+                            return [2 /*return*/];
+                        }
                         // check if the message already exists
                         if (this.isDuplicate(message_id)) {
                             logger_1.logger.warn("Event already enqueued, try again after ".concat((0, utils_1.millisecondsToSecond)(this.flushIntervalMs), " seconds."));

package/dist/cjs/src/storage/StorageManager.d.ts

@@ -2,8 +2,10 @@ import { IStorage, StorageType } from "./type";
 export declare class StorageManager {
     private readonly writeKey;
     private storages;
+    private resolvedTypes;
     constructor(writeKey: string);
     getStorage(type: StorageType): IStorage;
+    getResolvedType(type: StorageType): StorageType;
     private createStorage;
     private getWebStorage;
 }

package/dist/cjs/src/storage/StorageManager.js

@@ -19,6 +19,7 @@ var StorageManager = /** @class */ (function () {
     function StorageManager(writeKey) {
         this.writeKey = writeKey;
         this.storages = new Map();
+        this.resolvedTypes = new Map();
     }
     StorageManager.prototype.getStorage = function (type) {
         if (!this.storages.has(type)) {
@@ -39,9 +40,14 @@ var StorageManager = /** @class */ (function () {
             }
             // Add to cache
             this.storages.set(type, storage);
+            this.resolvedTypes.set(type, currentType);
         }
         return this.storages.get(type);
     };
+    StorageManager.prototype.getResolvedType = function (type) {
+        this.getStorage(type);
+        return this.resolvedTypes.get(type);
+    };
     StorageManager.prototype.createStorage = function (type) {
         switch (type) {
             case "cookieStorage":

package/dist/cjs/src/storage/index.d.ts

@@ -5,4 +5,5 @@ export declare const cookie: () => IStorage;
 export declare const local: () => IStorage;
 export declare const session: () => IStorage;
 export declare const memory: () => IStorage;
+export declare const usesCookieStorage: () => boolean;
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/src/storage/index.js

@@ -14,7 +14,7 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.memory = exports.session = exports.local = exports.cookie = void 0;
+exports.usesCookieStorage = exports.memory = exports.session = exports.local = exports.cookie = void 0;
 exports.initStorageManager = initStorageManager;
 var StorageManager_1 = require("./StorageManager");
 __exportStar(require("./type"), exports);
@@ -38,4 +38,10 @@ var session = function () { return getStorageInstance("sessionStorage"); };
 exports.session = session;
 var memory = function () { return getStorageInstance("memoryStorage"); };
 exports.memory = memory;
+var usesCookieStorage = function () {
+    if (!globalManager)
+        return false;
+    return globalManager.getResolvedType("cookieStorage") === "cookieStorage";
+};
+exports.usesCookieStorage = usesCookieStorage;
 //# sourceMappingURL=index.js.map

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

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

package/dist/cjs/src/version.js

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

package/dist/esm/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/esm/src/FormoAnalytics.js

@@ -49,6 +49,7 @@ import { EVENTS_API_HOST, EventType, LOCAL_ANONYMOUS_ID_KEY, SESSION_USER_ID_KEY
 import { cookie, session, initStorageManager } from "./storage";
 import { getIdentityCookieDomain, getIdentityCookieSecurity, } from "./storage/cookiePolicy";
 import { EventManager } from "./event";
+import { clearAnonymousId } from "./event/utils";
 import { EventQueue } from "./queue";
 import { logger, Logger } from "./logger";
 import { setConsentFlag, getConsentFlag, removeConsentFlag, } from "./consent";
@@ -90,6 +91,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
@@ -187,6 +189,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); },
@@ -215,7 +218,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.info("User has previously opted out of tracking");
@@ -317,7 +320,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:
@@ -327,18 +330,21 @@ var FormoAnalytics = /** @class */ (function () {
                         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.info("FormoAnalytics: Skipping provider detection (Wagmi mode)");
-                        _a.label = 5;
+                        error_1 = _a.sent();
+                        logger.warn("FormoAnalytics: Provider discovery failed", error_1);
+                        return [3 /*break*/, 5];
                     case 5: return [2 /*return*/, analytics];
                 }
             });
@@ -369,7 +375,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 () {
@@ -380,15 +387,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();
-        cookie().remove(LOCAL_ANONYMOUS_ID_KEY);
         cookie().remove(SESSION_USER_ID_KEY);
         cookie().remove(SESSION_WALLET_DETECTED_KEY);
         cookie().remove(SESSION_WALLET_IDENTIFIED_KEY);
         cookie().remove(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.
-        session().remove(SESSION_TRAFFIC_SOURCE_KEY);
+        // Attribution belongs to the visit, so reset preserves it.
     };
     FormoAnalytics.prototype.cleanup = function () {
         this.isCleanedUp = true;
@@ -572,6 +575,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 () {
@@ -771,6 +780,11 @@ var FormoAnalytics = /** @class */ (function () {
                             return [2 /*return*/];
                         }
                         if (!!params) return [3 /*break*/, 12];
+                        // Wagmi owns wallet identification.
+                        if (this.isWagmiMode) {
+                            logger.info("identify() without params is a no-op in Wagmi mode");
+                            return [2 /*return*/];
+                        }
                         // If no params provided, auto-identify
                         logger.info("Auto-identifying with providers:", this.evm.all.map(function (p) { return p.info.name; }));
                         _i = 0, _a = this.evm.all;
@@ -950,10 +964,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.info("detect() skipped: tracking is suppressed for this visitor or environment");
                             return [2 /*return*/];
                         }
@@ -1015,6 +1027,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
         setConsentFlag(this.writeKey, 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();
@@ -1022,6 +1035,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.
+        clearAnonymousId(LOCAL_ANONYMOUS_ID_KEY);
+        session().remove(SESSION_TRAFFIC_SOURCE_KEY);
         logger.info("Successfully opted out of tracking");
     };
     /**
@@ -1048,11 +1064,9 @@ var FormoAnalytics = /** @class */ (function () {
         logger.info("Opting back into tracking");
         // Remove opt-out flag
         removeConsentFlag(this.writeKey, 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.info("Successfully opted back into tracking");
     };
     /**
@@ -1133,29 +1147,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.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;
@@ -1185,7 +1200,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:
@@ -1204,8 +1219,8 @@ var FormoAnalytics = /** @class */ (function () {
                         _a.sent();
                         return [3 /*break*/, 3];
                     case 2:
-                        error_1 = _a.sent();
-                        logger.error("Error tracking event:", error_1);
+                        error_2 = _a.sent();
+                        logger.error("Error tracking event:", error_2);
                         return [3 /*break*/, 3];
                     case 3: return [2 /*return*/];
                 }

package/dist/esm/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/esm/src/event/EventFactory.js

@@ -67,11 +67,18 @@ import { CHANNEL, CLICK_ID_PARAMS, DEFAULT_EXCLUDED_QUERY_PARAMS, DEFAULT_REFERR
 import { sanitizeTrafficSources } from "./sanitize";
 import { generateAnonymousId } from "./utils";
 import { detectBrowser } from "../browser/browsers";
+import { EVENT_CREATION_CANCELLED } from "./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: "",
@@ -404,6 +411,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 () {
@@ -427,24 +438,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 = getCurrentTimeFormatted(),
-                            _a.user_id = formoEvent.user_id,
-                            _a.type = formoEvent.type,
-                            _a.channel = CHANNEL,
-                            _a.version = VERSION,
-                            _a);
-                        commonEventData.anonymous_id = generateAnonymousId(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 EVENT_CREATION_CANCELLED;
+                        }
+                        commonEventData = {
+                            context: enrichedContext,
+                            original_timestamp: getCurrentTimeFormatted(),
+                            user_id: formoEvent.user_id,
+                            type: formoEvent.type,
+                            channel: CHANNEL,
+                            version: VERSION,
+                        };
+                        commonEventData.anonymous_id = generateAnonymousId(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 = mergeDeepRight(formoEvent, commonEventData);

package/dist/esm/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