@formo/analytics 1.19.6 → 1.19.8

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