@formo/analytics 1.27.0 → 1.28.0

package/dist/cjs/src/solana/SolanaAdapter.d.ts

@@ -0,0 +1,211 @@
+/**
+ * SolanaAdapter
+ *
+ * Handles wallet event tracking by hooking into Solana Wallet Adapter events.
+ * This provides integration with the @solana/wallet-adapter ecosystem.
+ *
+ * @see https://github.com/anza-xyz/wallet-adapter
+ */
+import { FormoAnalytics } from "../FormoAnalytics";
+import { ISolanaAdapter, SolanaWalletContext, SolanaConnection, SolanaCluster } from "./types";
+export declare class SolanaAdapter {
+    private formo;
+    private wallet;
+    private connection;
+    private cluster;
+    private chainId;
+    private unsubscribers;
+    private connectionState;
+    /**
+     * Track processed signatures to prevent duplicate event emissions
+     */
+    private processedSignatures;
+    /**
+     * Store pending transaction details for confirmation tracking
+     * Key: transaction signature, Value: transaction details
+     */
+    private pendingTransactions;
+    /**
+     * Original adapter methods that we wrap for tracking
+     */
+    private originalAdapterSendTransaction?;
+    private originalAdapterSignMessage?;
+    private originalAdapterSignTransaction?;
+    /**
+     * Bound wrapper references — used to detect when external code (e.g. StandardWalletAdapter._reset())
+     * overwrites our wraps so we can re-apply them.
+     */
+    private boundWrappedSendTransaction?;
+    private boundWrappedSignMessage?;
+    private boundWrappedSignTransaction?;
+    /**
+     * Reference to the wrapped adapter (to restore methods on cleanup)
+     */
+    private wrappedAdapter?;
+    /**
+     * Reference to the adapter we bound event listeners to (for context wallets).
+     * Used to detect when context.wallet changes and rebind listeners.
+     */
+    private currentBoundAdapter?;
+    /**
+     * Track active polling timeout IDs for cleanup
+     */
+    private pollingTimeouts;
+    /**
+     * Flag to prevent new polls after cleanup is initiated
+     */
+    private isCleanedUp;
+    constructor(formoAnalytics: FormoAnalytics, options: {
+        wallet?: ISolanaAdapter | SolanaWalletContext;
+        connection?: SolanaConnection;
+        cluster?: SolanaCluster;
+    });
+    /**
+     * Restore original methods on the wrapped adapter
+     */
+    private restoreOriginalMethods;
+    /**
+     * Update the wallet instance (useful for React context updates)
+     */
+    setWallet(wallet: ISolanaAdapter | SolanaWalletContext | null): void;
+    /**
+     * Check if the wallet adapter has changed (for context-based wallets) and rebind if needed.
+     * Call this in React effects when you know the wallet context may have changed but the
+     * context object reference stayed the same (e.g., user switched wallets in the wallet selector).
+     *
+     * This ensures connect/disconnect events from the new wallet are properly tracked without
+     * waiting for the next transaction or signature call.
+     *
+     * @example
+     * ```tsx
+     * const wallet = useWallet();
+     * useEffect(() => {
+     *   formo.solana.syncWalletState();
+     * }, [wallet.wallet]); // Trigger when inner wallet changes
+     * ```
+     */
+    syncWalletState(): void;
+    /**
+     * Update the connection instance
+     */
+    setConnection(connection: SolanaConnection | null): void;
+    /**
+     * Update the cluster/network
+     */
+    setCluster(cluster: SolanaCluster): void;
+    /**
+     * Get the current chain ID
+     */
+    getChainId(): number;
+    /**
+     * Set up listeners for wallet events
+     */
+    private setupWalletListeners;
+    /**
+     * Set up listeners for a wallet context (useWallet)
+     */
+    private setupContextListeners;
+    /**
+     * Check if the adapter inside a wallet context has changed (e.g., user switched wallets).
+     * If so, rebind event listeners and rewrap methods on the new adapter.
+     * This handles the case where context.wallet changes but the context object reference stays the same.
+     */
+    private checkAndRebindContextAdapter;
+    /**
+     * Clean up only adapter event listeners (not the full cleanup)
+     */
+    private cleanupAdapterListenersOnly;
+    /**
+     * Register a listener on an adapter and track its unsubscriber
+     */
+    private registerAdapterListener;
+    /**
+     * Set up event listeners on an adapter (connect/disconnect events)
+     */
+    private setupAdapterEventListenersOnly;
+    /**
+     * Set up listeners for a direct wallet adapter
+     */
+    private setupAdapterListeners;
+    /**
+     * Wrap wallet adapter methods for transaction/signature tracking
+     */
+    private wrapAdapterMethods;
+    /**
+     * Re-wrap methods that were overwritten by external code.
+     *
+     * StandardWalletAdapter._reset() overwrites signMessage and signTransaction
+     * as own properties on every connect/disconnect/
+     * feature-change event. This method detects which wraps were overwritten
+     * and re-applies them, capturing the new original methods.
+     */
+    private rewrapOverwrittenMethods;
+    /**
+     * Wrapped sendTransaction method for direct adapter
+     */
+    private wrappedSendTransaction;
+    /**
+     * Wrapped signMessage method for direct adapter
+     */
+    private wrappedSignMessage;
+    /**
+     * Wrapped signTransaction method for direct adapter
+     */
+    private wrappedSignTransaction;
+    /**
+     * Check initial connection state
+     */
+    private checkInitialConnection;
+    /**
+     * Handle wallet connect event
+     */
+    private handleConnect;
+    /**
+     * Handle wallet disconnect event
+     */
+    private handleDisconnect;
+    /**
+     * Poll for transaction confirmation
+     */
+    private pollTransactionConfirmation;
+    /**
+     * Get current wallet public key
+     */
+    private getPublicKey;
+    /**
+     * Get current address
+     */
+    private getCurrentAddress;
+    /**
+     * Emit a transaction event if address is valid and autocapture is enabled
+     */
+    private emitTransactionEvent;
+    /**
+     * Emit a signature event if address is valid and autocapture is enabled
+     */
+    private emitSignatureEvent;
+    /**
+     * Extract the actual adapter (with .on/.off) from a wallet context.
+     * In @solana/wallet-adapter-react, context.wallet is { adapter, readyState },
+     * not a direct adapter.
+     */
+    private getAdapterFromContext;
+    /**
+     * Get wallet name
+     */
+    private getWalletName;
+    /**
+     * Get wallet RDNS (reverse domain name)
+     * For Solana wallets, we construct an RDNS-like identifier
+     */
+    private getWalletRdns;
+    /**
+     * Clean up wallet listeners
+     */
+    private cleanupWalletListeners;
+    /**
+     * Clean up all resources
+     */
+    cleanup(): void;
+}
+//# sourceMappingURL=SolanaAdapter.d.ts.map