@formo/analytics 1.19.6 → 1.19.8

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

@@ -3,4 +3,5 @@ export declare const SESSION_WALLET_DETECTED_KEY = "wallet-detected";
 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 DEFAULT_PROVIDER_ICON = "data:image/svg+xml;base64,";
 //# sourceMappingURL=base.d.ts.map

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

@@ -1,9 +1,11 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.LOCAL_ANONYMOUS_ID_KEY = exports.SESSION_USER_ID_KEY = exports.SESSION_CURRENT_URL_KEY = exports.SESSION_WALLET_DETECTED_KEY = exports.SESSION_TRAFFIC_SOURCE_KEY = void 0;
+exports.DEFAULT_PROVIDER_ICON = exports.LOCAL_ANONYMOUS_ID_KEY = exports.SESSION_USER_ID_KEY = exports.SESSION_CURRENT_URL_KEY = exports.SESSION_WALLET_DETECTED_KEY = exports.SESSION_TRAFFIC_SOURCE_KEY = void 0;
 exports.SESSION_TRAFFIC_SOURCE_KEY = "traffic-source";
 exports.SESSION_WALLET_DETECTED_KEY = "wallet-detected";
 exports.SESSION_CURRENT_URL_KEY = "analytics-current-url";
 exports.SESSION_USER_ID_KEY = "user-id";
 exports.LOCAL_ANONYMOUS_ID_KEY = "anonymous-id";
+// Default provider icon (empty data URL)
+exports.DEFAULT_PROVIDER_ICON = 'data:image/svg+xml;base64,';
 //# sourceMappingURL=base.js.map

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

@@ -20,7 +20,7 @@ declare class EventFactory implements IEventFactory {
     generateDetectWalletEvent(providerName: string, rdns: string, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;
     generateIdentifyEvent(providerName: string, rdns: string, address: Nullable<Address>, userId?: Nullable<string>, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;
     generateConnectEvent(chainId: ChainID, address: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;
-    generateDisconnectEvent(chainId: ChainID, address: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;
+    generateDisconnectEvent(chainId?: ChainID, address?: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;
     generateChainChangedEvent(chainId: ChainID, address: Address, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;
     generateSignatureEvent(status: SignatureStatus, chainId: ChainID, address: Address, message: string, signatureHash?: string, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;
     generateTransactionEvent(status: TransactionStatus, chainId: ChainID, address: Address, data: string, to: string, value: string, transactionHash?: string, properties?: IFormoEventProperties, context?: IFormoEventContext): IFormoEvent;

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

@@ -66,7 +66,7 @@ var EventFactory = /** @class */ (function () {
             var storedTrafficSources = (0, storage_1.session)().get(constants_1.SESSION_TRAFFIC_SOURCE_KEY) || {};
             var finalTrafficSources = {
                 ref: contextTrafficSources.ref || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.ref) || "",
-                referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer),
+                referrer: contextTrafficSources.referrer || (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.referrer) || "",
                 utm_campaign: contextTrafficSources.utm_campaign ||
                     (storedTrafficSources === null || storedTrafficSources === void 0 ? void 0 : storedTrafficSources.utm_campaign) ||
                     "",

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

@@ -1,2 +1,2 @@
-export declare const version = "1.19.5";
+export declare const version = "1.19.7";
 //# 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.19.5';
+exports.version = '1.19.7';
 //# sourceMappingURL=version.js.map

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

@@ -79,8 +79,8 @@ export interface ConnectAPIEvent {
 }
 export interface DisconnectAPIEvent {
     type: "disconnect";
-    chainId: ChainID;
-    address: Address;
+    chainId?: ChainID;
+    address?: Address;
 }
 export interface TrackAPIEvent {
     type: "track";

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

@@ -15,4 +15,12 @@ export interface RPCError extends Error {
 export interface ConnectInfo {
     chainId: string;
 }
+export declare const WRAPPED_REQUEST_SYMBOL: unique symbol;
+export type WrappedRequestFunction = (<T>(args: RequestArguments) => Promise<T | null | undefined>) & {
+    [WRAPPED_REQUEST_SYMBOL]?: boolean;
+};
+export declare const WRAPPED_REQUEST_REF_SYMBOL: unique symbol;
+export interface WrappedEIP1193Provider extends EIP1193Provider {
+    [WRAPPED_REQUEST_REF_SYMBOL]?: WrappedRequestFunction;
+}
 //# sourceMappingURL=provider.d.ts.map

package/dist/cjs/src/types/provider.js

@@ -1,3 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.WRAPPED_REQUEST_REF_SYMBOL = exports.WRAPPED_REQUEST_SYMBOL = void 0;
+exports.WRAPPED_REQUEST_SYMBOL = Symbol("formoWrappedRequest");
+exports.WRAPPED_REQUEST_REF_SYMBOL = Symbol("formoWrappedRequestRef");
 //# sourceMappingURL=provider.js.map

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

@@ -2,7 +2,16 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.getActionDescriptor = void 0;
 var getActionDescriptor = function (type, properties) {
-    return "".concat(type).concat((properties === null || properties === void 0 ? void 0 : properties.status) ? " ".concat(properties === null || properties === void 0 ? void 0 : properties.status) : "");
+    var descriptor = type;
+    // Add status for events that have it (e.g., signature, transaction)
+    if (properties === null || properties === void 0 ? void 0 : properties.status) {
+        descriptor += " ".concat(properties.status);
+    }
+    // Add RDNS for connect/disconnect events to identify the wallet provider
+    if ((type === 'connect' || type === 'disconnect') && (properties === null || properties === void 0 ? void 0 : properties.rdns)) {
+        descriptor += " (".concat(properties.rdns, ")");
+    }
+    return descriptor;
 };
 exports.getActionDescriptor = getActionDescriptor;
 //# sourceMappingURL=base.js.map

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

@@ -4,14 +4,42 @@ export declare class FormoAnalytics implements IFormoAnalytics {
     readonly writeKey: string;
     options: Options;
     private _provider?;
-    private _providerListeners;
+    private _providerListenersMap;
     private session;
     private eventManager;
+    /**
+     * EIP-6963 provider details discovered through the browser
+     * This array contains all available providers with their metadata
+     */
     private _providers;
+    /**
+     * Set of providers that have been tracked with event listeners
+     * This is separate from _providers because:
+     * - _providers contains all discovered providers (EIP-6963)
+     * - _trackedProviders contains only providers that have been set up with listeners
+     * - A provider can be discovered but not yet tracked (e.g., during initialization)
+     * - A provider can be tracked but later removed from discovery
+     */
+    private _trackedProviders;
+    private _injectedProviderDetail?;
+    private _processingAccountsChanged;
+    private _seenProviders;
     config: Config;
     currentChainId?: ChainID;
     currentAddress?: Address;
     currentUserId?: string;
+    /**
+     * Helper method to check if a provider is different from the currently active one
+     * @param provider The provider to check
+     * @returns true if there's a provider mismatch, false otherwise
+     */
+    private isProviderMismatch;
+    /**
+     * Check if a provider is in a valid state for switching
+     * @param provider The provider to validate
+     * @returns true if the provider is in a valid state
+     */
+    private isProviderInValidState;
     private constructor();
     static init(writeKey: string, options?: Options): Promise<FormoAnalytics>;
     /**
@@ -36,7 +64,6 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * @param {IFormoEventProperties} properties
      * @param {IFormoEventContext} context
      * @param {(...args: unknown[]) => void} callback
-     * @throws {Error} If chainId or address is empty
      * @returns {Promise<void>}
      */
     connect({ chainId, address, }: {
@@ -63,8 +90,6 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * @param {IFormoEventProperties} properties
      * @param {IFormoEventContext} context
      * @param {(...args: unknown[]) => void} callback
-     * @throws {Error} If chainId is empty, zero, or not a valid number
-     * @throws {Error} If no address is provided and no previous address is recorded
      * @returns {Promise<void>}
      */
     chain({ chainId, address, }: {
@@ -153,11 +178,25 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      */
     track(event: string, properties?: IFormoEventProperties, context?: IFormoEventContext, callback?: (...args: unknown[]) => void): Promise<void>;
     private trackProvider;
+    private trackProviders;
+    private addProviderListener;
     private registerAccountsChangedListener;
     private onAccountsChanged;
+    /**
+     * Handles changes to the accounts of a given EIP-1193 provider.
+     *
+     * @param provider - The EIP-1193 provider whose accounts have changed.
+     * @param accounts - The new array of account addresses. An empty array indicates a disconnect.
+     * @returns A promise that resolves when the account change has been processed.
+     *
+     * If the accounts array is empty and the provider is the active provider, this method triggers
+     * a disconnect flow. Otherwise, it updates the state to reflect the new accounts as needed.
+     */
+    private _handleAccountsChanged;
     private registerChainChangedListener;
     private onChainChanged;
     private registerConnectListener;
+    private registerDisconnectListener;
     private onConnected;
     private registerRequestListeners;
     private onLocationChange;
@@ -169,6 +208,18 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * @returns {boolean} True if tracking should be enabled
      */
     private shouldTrack;
+    /**
+     * Get provider information for a given provider
+     * @param provider The provider to get info for
+     * @returns Provider information
+     */
+    private getProviderInfo;
+    /**
+     * Attempts to detect information about an injected provider
+     * @param provider The injected provider to analyze
+     * @returns Provider information with fallback values
+     */
+    private detectInjectedProviderInfo;
     private getProviders;
     get providers(): readonly EIP6963ProviderDetail[];
     private detectWallets;
@@ -182,5 +233,47 @@ export declare class FormoAnalytics implements IFormoAnalytics {
      * Polls for transaction receipt and emits tx.status = CONFIRMED or REVERTED.
      */
     private pollTransactionReceipt;
+    private removeProviderListeners;
+    private untrackProvider;
+    getTrackedProvidersCount(): number;
+    /**
+     * Get current provider state for debugging
+     * @returns Object containing current provider state information
+     */
+    getProviderState(): {
+        totalProviders: number;
+        trackedProviders: number;
+        seenProviders: number;
+        activeProvider: boolean;
+    };
+    /**
+     * Clean up providers that are no longer available
+     * This helps maintain consistent state and prevents memory leaks
+     */
+    private cleanupUnavailableProviders;
+    /**
+     * Helper method to check if a provider is already wrapped
+     * @param provider The provider to check
+     * @param currentRequest The current request function
+     * @returns true if the provider is already wrapped
+     */
+    private isProviderAlreadyWrapped;
+    /**
+     * Handle provider mismatch by switching to the new provider and invalidating old tokens
+     * @param provider The new provider to switch to
+     */
+    private handleProviderMismatch;
+    /**
+     * Helper method to validate and checksum an address
+     * @param address The address to validate and checksum
+     * @returns The checksummed address or undefined if invalid
+     */
+    private validateAndChecksumAddress;
+    /**
+     * Helper method to safely add a provider detail to _providers array, ensuring no duplicates
+     * @param detail The provider detail to add
+     * @returns true if the provider was added, false if it was already present
+     */
+    private safeAddProviderDetail;
 }
 //# sourceMappingURL=FormoAnalytics.d.ts.map