@formo/analytics 1.20.0 → 1.22.0

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

@@ -1,4 +1,40 @@
 "use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __generator = (this && this.__generator) || function (thisArg, body) {
+    var _ = { label: 0, sent: function() { if (t[0] & 1) throw t[1]; return t[1]; }, trys: [], ops: [] }, f, y, t, g = Object.create((typeof Iterator === "function" ? Iterator : Object).prototype);
+    return g.next = verb(0), g["throw"] = verb(1), g["return"] = verb(2), typeof Symbol === "function" && (g[Symbol.iterator] = function() { return this; }), g;
+    function verb(n) { return function (v) { return step([n, v]); }; }
+    function step(op) {
+        if (f) throw new TypeError("Generator is already executing.");
+        while (g && (g = 0, op[0] && (_ = 0)), _) try {
+            if (f = 1, y && (t = op[0] & 2 ? y["return"] : op[0] ? y["throw"] || ((t = y["return"]) && t.call(y), 0) : y.next) && !(t = t.call(y, op[1])).done) return t;
+            if (y = 0, t) op = [op[0] & 2, t.value];
+            switch (op[0]) {
+                case 0: case 1: t = op; break;
+                case 4: _.label++; return { value: op[1], done: false };
+                case 5: _.label++; y = op[1]; op = [0]; continue;
+                case 7: op = _.ops.pop(); _.trys.pop(); continue;
+                default:
+                    if (!(t = _.trys, t = t.length > 0 && t[t.length - 1]) && (op[0] === 6 || op[0] === 2)) { _ = 0; continue; }
+                    if (op[0] === 3 && (!t || (op[1] > t[0] && op[1] < t[3]))) { _.label = op[1]; break; }
+                    if (op[0] === 6 && _.label < t[1]) { _.label = t[1]; t = op; break; }
+                    if (t && _.label < t[2]) { _.label = t[2]; _.ops.push(op); break; }
+                    if (t[2]) _.ops.pop();
+                    _.trys.pop(); continue;
+            }
+            op = body.call(thisArg, _);
+        } catch (e) { op = [6, e]; y = 0; } finally { f = t = 0; }
+        if (op[0] & 5) throw op[1]; return { value: op[0] ? op[1] : void 0, done: true };
+    }
+};
 var __rest = (this && this.__rest) || function (s, e) {
     var t = {};
     for (var p in s) if (Object.prototype.hasOwnProperty.call(s, p) && e.indexOf(p) < 0)
@@ -32,20 +68,31 @@ var EventManager = /** @class */ (function () {
      * @param event Incoming event data
      */
     EventManager.prototype.addEvent = function (event, address, userId) {
-        var callback = event.callback, _event = __rest(event, ["callback"]);
-        var formoEvent = this.eventFactory.create(_event, address, userId);
-        // 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"));
-            return;
-        }
-        this.eventQueue.enqueue(formoEvent, function (err, _, data) {
-            if (err) {
-                logger_1.logger.error("Error sending events:", err);
-            }
-            else
-                logger_1.logger.info("Events sent successfully: ".concat(data.length, " events"));
-            callback === null || callback === void 0 ? void 0 : callback(err, _, data);
+        return __awaiter(this, void 0, void 0, function () {
+            var callback, _event, formoEvent;
+            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)];
+                    case 1:
+                        formoEvent = _a.sent();
+                        // 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"));
+                            return [2 /*return*/];
+                        }
+                        this.eventQueue.enqueue(formoEvent, function (err, _, data) {
+                            if (err) {
+                                logger_1.logger.error("Error sending events:", err);
+                            }
+                            else
+                                logger_1.logger.info("Events sent successfully: ".concat(data.length, " events"));
+                            callback === null || callback === void 0 ? void 0 : callback(err, _, data);
+                        });
+                        return [2 /*return*/];
+                }
+            });
         });
     };
     return EventManager;

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

@@ -1,8 +1,8 @@
 import { Address, APIEvent, IFormoEvent } from "../../types";
 export interface IEventManager {
-    addEvent(event: APIEvent, address?: Address, userId?: string): void;
+    addEvent(event: APIEvent, address?: Address, userId?: string): Promise<void>;
 }
 export interface IEventFactory {
-    create(event: APIEvent, address?: Address, userId?: string): IFormoEvent;
+    create(event: APIEvent, address?: Address, userId?: string): Promise<IFormoEvent>;
 }
 //# sourceMappingURL=type.d.ts.map

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

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

package/dist/cjs/src/lib/version.js

@@ -2,5 +2,5 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.version = void 0;
 // Generated by genversion.
-exports.version = '1.20.0';
+exports.version = '1.22.0';
 //# sourceMappingURL=version.js.map

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

@@ -63,9 +63,48 @@ export interface TrackingOptions {
     excludePaths?: string[];
     excludeChains?: ChainID[];
 }
+/**
+ * Configuration options for controlling wallet event autocapture
+ * All events are enabled by default unless explicitly set to false
+ */
+export interface AutocaptureOptions {
+    /**
+     * Track wallet connect events
+     * @default true
+     */
+    connect?: boolean;
+    /**
+     * Track wallet disconnect events
+     * @default true
+     */
+    disconnect?: boolean;
+    /**
+     * Track wallet signature events (personal_sign, eth_signTypedData_v4)
+     * @default true
+     */
+    signature?: boolean;
+    /**
+     * Track wallet transaction events (eth_sendTransaction)
+     * @default true
+     */
+    transaction?: boolean;
+    /**
+     * Track wallet chain change events
+     * @default true
+     */
+    chain?: boolean;
+}
 export interface Options {
     provider?: EIP1193Provider;
     tracking?: boolean | TrackingOptions;
+    /**
+     * Control wallet event autocapture
+     * - `false`: Disable all wallet autocapture
+     * - `true`: Enable all wallet events (default)
+     * - `AutocaptureOptions`: Granular control over specific events
+     * @default true
+     */
+    autocapture?: boolean | AutocaptureOptions;
     flushAt?: number;
     flushInterval?: number;
     retryCount?: number;

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

@@ -224,6 +224,12 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * @returns {boolean} True if tracking should be enabled
      */
     private shouldTrack;
+    /**
+     * Check if a specific wallet event type is enabled for autocapture
+     * @param eventType The wallet event type to check
+     * @returns {boolean} True if the event type should be autocaptured
+     */
+    private isAutocaptureEnabled;
     /**
      * Get provider information for a given provider
      * @param provider The provider to get info for