@pooflabs/web 0.0.73-rc-1 → 0.0.74

package/dist/auth/index.d.ts

@@ -1,12 +1,11 @@
-export { PhantomWalletProvider, PhantomWalletConfig, PhantomProviderType, } from "./providers/phantom-wallet-provider";
-export { PrivyWalletProvider } from "./providers/privy-wallet-provider";
-export { MockAuthProvider, DEFAULT_TEST_ADDRESS, } from "./providers/mock-auth-provider";
-export { OffchainAuthProvider, OffchainAuthProviderConfig, } from "./providers/offchain-auth-provider";
-export { SolanaMobileWalletProvider, SolanaMobileWalletConfig, isMobileWalletAvailable, registerMobileWalletAdapter, } from "./providers/solana-mobile-wallet-provider";
 import { AuthProvider, User, ClientConfig } from "@pooflabs/core";
 /**
  * Clears the session if it was created before auth method tracking (legacy session).
  * Returns true if the session was cleared, false if the session is compatible.
+ *
+ * Dispatches to the correct session manager based on the current auth method
+ * so both web (WebSessionManager) and RN (ReactNativeSessionManager) sessions
+ * are properly cleared.
  */
 export declare function clearIncompatibleSession(): boolean;
 export declare const SOLANA_DEVNET_RPC_URL = "https://idelle-8nxsep-fast-devnet.helius-rpc.com";

package/dist/auth/providers/mock-auth-provider.d.ts

@@ -4,13 +4,13 @@ import { Transaction, VersionedTransaction } from '@solana/web3.js';
 export declare const DEFAULT_TEST_ADDRESS = "HKbZbRR7jWWR5VRN8KFjvTCHEzJQgameYxKQxh2gPoof";
 /**
  * MockAuthProvider bypasses real wallet authentication for testing purposes.
- * Uses sessionStorage to simulate logged-in user, with fallback to default test address.
+ * Uses session storage to simulate logged-in user, with fallback to default test address.
  *
  * This is enabled by passing mockAuth: true to init()
  */
 export declare class MockAuthProvider implements AuthProvider {
     /**
-     * Mock login - reads user from sessionStorage or uses default test address
+     * Mock login - reads user from session storage or uses default test address
      */
     login(): Promise<User | null>;
     /**
@@ -39,7 +39,7 @@ export declare class MockAuthProvider implements AuthProvider {
      */
     restoreSession(): Promise<User | null>;
     /**
-     * Mock logout - clears test user from sessionStorage
+     * Mock logout - clears test user from session storage
      */
     logout(): Promise<void>;
     /**

package/dist/auth/providers/privy-expo-provider.d.ts

@@ -0,0 +1,105 @@
+/**
+ * Privy Expo Auth Provider — React Native implementation of AuthProvider.
+ *
+ * Uses @privy-io/expo instead of @privy-io/react-auth.
+ * Uses ReactNativeSessionManager instead of WebSessionManager.
+ *
+ * IMPORTANT — Expo/RN consumers must:
+ *   1. Install polyfills: fast-text-encoding, react-native-get-random-values
+ *   2. Install @privy-io/expo, @privy-io/expo-native-extensions
+ *   3. Call ReactNativeSessionManager.configure({ storage, atob }) at startup
+ *   4. Call setPlatform({ ... }) from @pooflabs/web at startup
+ *   5. Wrap their app tree with PrivyProvider from @privy-io/expo
+ *   6. Create this provider and pass the Privy hooks/methods via setPrivyMethods()
+ *
+ * Unlike the web PrivyWalletProvider which renders a hidden React DOM tree
+ * to host Privy's React context, this provider expects the RN app itself
+ * to render <PrivyProvider> and then bridge the hooks via setPrivyMethods().
+ */
+import type { EVMTransaction, SolTransaction, TransactionResult, AuthProvider, User, SetOptions } from '@pooflabs/core';
+import { PublicKey, Connection, Transaction, VersionedTransaction } from '@solana/web3.js';
+export interface PrivyExpoMethods {
+    /** Whether Privy SDK is fully initialized. */
+    isReady: boolean;
+    /** Whether the user is authenticated. */
+    isAuthenticated: boolean;
+    /** The user object from usePrivy(). */
+    user: any;
+    /** Trigger Privy login UI. Returns the user on success. */
+    login: () => Promise<any>;
+    /** Log out from Privy. */
+    logout: () => Promise<void>;
+    /** Get an access token from Privy. */
+    getAccessToken: () => Promise<string | null>;
+    /** Get the Privy identity token. */
+    getIdentityToken: () => Promise<string | null>;
+    /**
+     * Get the embedded Solana wallet provider.
+     * Comes from useEmbeddedSolanaWallet().
+     */
+    getWalletProvider: () => Promise<{
+        address: string;
+        signMessage: (message: Uint8Array) => Promise<{
+            signature: Uint8Array;
+        }>;
+        signTransaction: (transaction: Transaction | VersionedTransaction) => Promise<{
+            signedTransaction: Uint8Array;
+        }>;
+        signAndSendTransaction: (transaction: Transaction | VersionedTransaction, connection: Connection) => Promise<{
+            signature: string;
+        }>;
+    } | null>;
+}
+export declare class PrivyExpoProvider implements AuthProvider {
+    private networkUrl;
+    private privyMethods;
+    private appId;
+    constructor(appId: string, networkUrl?: string | null);
+    /**
+     * Bridge Privy hooks from the app's React tree into this provider.
+     *
+     * Call this from a component rendered inside <PrivyProvider>:
+     * ```tsx
+     * const privy = usePrivy();
+     * const wallet = useEmbeddedSolanaWallet();
+     * const { getAccessToken } = usePrivy();
+     * const { getIdentityToken } = useIdentityToken();
+     *
+     * useEffect(() => {
+     *   provider.setPrivyMethods({
+     *     isReady: privy.isReady,
+     *     isAuthenticated: !!privy.user,
+     *     user: privy.user,
+     *     login: privy.login,
+     *     logout: privy.logout,
+     *     getAccessToken,
+     *     getIdentityToken,
+     *     getWalletProvider: async () => {
+     *       if (!wallet.wallets[0]) return null;
+     *       const provider = await wallet.wallets[0].getProvider();
+     *       return {
+     *         address: wallet.wallets[0].address,
+     *         signMessage: provider.signMessage,
+     *         signTransaction: provider.signTransaction,
+     *         signAndSendTransaction: provider.signAndSendTransaction,
+     *       };
+     *     },
+     *   });
+     * }, [privy.isReady, privy.user, wallet.wallets]);
+     * ```
+     */
+    setPrivyMethods(methods: PrivyExpoMethods): void;
+    login(): Promise<User | null>;
+    runTransaction(_evmTransactionData?: EVMTransaction, solTransactionData?: SolTransaction, options?: SetOptions): Promise<TransactionResult>;
+    signMessage(message: string): Promise<string>;
+    signTransaction(transaction: Transaction | VersionedTransaction): Promise<Transaction | VersionedTransaction>;
+    signAndSubmitTransaction(transaction: Transaction | VersionedTransaction, feePayer?: PublicKey): Promise<string>;
+    restoreSession(): Promise<User | null>;
+    logout(): Promise<void>;
+    getNativeMethods(): Promise<any>;
+    private createSession;
+    private getWalletOrThrow;
+    private signAndSubmitInternal;
+    private getRpcUrl;
+    private ensureReady;
+}