@formo/analytics 1.19.5 → 1.19.7

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/initialization.js

@@ -7,6 +7,19 @@ function formofy(writeKey, options) {
         FormoAnalytics_1.FormoAnalytics.init(writeKey, options)
             .then(function (f) {
             window.formo = f;
+            // Call ready callback if provided with proper error handling
+            if (options === null || options === void 0 ? void 0 : options.ready) {
+                // Wrap the callback execution in a try-catch to handle synchronous errors
+                try {
+                    options.ready(f);
+                }
+                catch (callbackError) {
+                    console.error("Error in FormoAnalytics ready callback:", callbackError);
+                }
+                // Note: If the callback returns a Promise (even though typed as void),
+                // it's the responsibility of the callback implementation to handle its own errors.
+                // This prevents the callback from throwing unhandled rejections.
+            }
         })
             .catch(function (e) { return console.error("Error initializing FormoAnalytics:", e); });
     }

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/types/base.d.ts

@@ -71,6 +71,7 @@ export interface Options {
         enabled?: boolean;
         levels?: LogLevel[];
     };
+    ready?: (formo: IFormoAnalytics) => void;
 }
 export interface FormoAnalyticsProviderProps {
     writeKey: string;

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/esm/src/FormoAnalytics.d.ts

@@ -4,14 +4,41 @@ 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 _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 +63,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 +89,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 +177,14 @@ 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;
     private registerChainChangedListener;
     private onChainChanged;
     private registerConnectListener;
+    private registerDisconnectListener;
     private onConnected;
     private registerRequestListeners;
     private onLocationChange;
@@ -169,6 +196,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 +221,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