@pooflabs/web 0.0.46 → 0.0.47-rc.10

package/dist/auth/index.d.ts

@@ -1,11 +1,17 @@
 export { PhantomWalletProvider, PhantomWalletConfig, PhantomProviderType, } from "./providers/phantom-wallet-provider";
-export { PrivyWalletProvider, RedirectUrlContext, RedirectUrlResolver, } from "./providers/privy-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";
 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.
+ */
+export declare function clearIncompatibleSession(): boolean;
 export declare const SOLANA_DEVNET_RPC_URL = "https://idelle-8nxsep-fast-devnet.helius-rpc.com";
 export declare const SOLANA_MAINNET_RPC_URL = "https://celestia-cegncv-fast-mainnet.helius-rpc.com";
 export declare const SURFNET_RPC_URL = "https://surfpool.fly.dev";
 export declare function getAuthProvider(config?: Partial<ClientConfig>): Promise<AuthProvider>;
 export declare function login(): Promise<User | null>;
+export declare function getCurrentAuthMethod(): string | null;
 export declare function logout(): Promise<void>;

package/dist/auth/providers/phantom-wallet-provider.d.ts

@@ -1,11 +1,10 @@
 import type { EVMTransaction, SolTransaction, TransactionResult, User, AuthProvider, SetOptions } from '@pooflabs/core';
 import { PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
-export type PhantomProviderType = 'injected' | 'google' | 'apple' | 'phantom';
+export type PhantomProviderType = 'injected' | 'google' | 'apple' | 'deeplink';
 export interface PhantomWalletConfig {
     appId?: string;
     /** Providers to use for authentication. Accepts string[] for convenience (e.g., ["injected"]) */
     providers?: PhantomProviderType[] | string[];
-    redirectUrl?: string;
     autoConnect?: boolean;
     /** Theme for the connect modal: 'light' or 'dark' */
     theme?: 'light' | 'dark';
@@ -13,6 +12,8 @@ export interface PhantomWalletConfig {
     appName?: string;
     /** App icon URL displayed in the connect modal */
     appIcon?: string;
+    /** Enable a "Log in with email" fallback button (via Privy) in the Phantom modal */
+    enablePrivyFallback?: boolean;
 }
 export declare class PhantomWalletProvider implements AuthProvider {
     private static instance;
@@ -26,6 +27,8 @@ export declare class PhantomWalletProvider implements AuthProvider {
     private loginInProgress;
     private autoLoginInProgress;
     private initPromise;
+    /** Callback to swap to a Privy provider when the user clicks "Log in with email" */
+    onSwitchToPrivy: (() => Promise<AuthProvider>) | null;
     constructor(networkUrl?: string | null, config?: PhantomWalletConfig);
     private initializeAsync;
     /**
@@ -43,8 +46,8 @@ export declare class PhantomWalletProvider implements AuthProvider {
     getAvailableProviders(): PhantomProviderType[];
     /**
      * Login using the Phantom connect modal.
-     * Opens the native Phantom connect UI where users can choose their preferred login method
-     * (Google, Apple, Phantom, or browser extension).
+     * When enablePrivyFallback is true, the modal is enhanced via React effect to
+     * auto-skip to the wallet list and show a "Log in with email" button.
      */
     login(): Promise<User | null>;
     restoreSession(): Promise<User | null>;

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

@@ -1,36 +1,5 @@
 import type { EVMTransaction, SolTransaction, TransactionResult, AuthProvider, User, SetOptions } from '@pooflabs/core';
 import { PublicKey, Transaction, VersionedTransaction } from '@solana/web3.js';
-/**
- * Context passed to the redirect URL resolver function.
- * Allows dynamic redirect URL selection based on the current environment.
- */
-export interface RedirectUrlContext {
-    /** The current platform (best effort detection) */
-    platform: 'android' | 'ios' | 'web' | 'unknown';
-    /** The user agent string */
-    userAgent: string;
-    /** Whether this appears to be a WebView */
-    isWebView: boolean;
-    /** The current URL origin */
-    origin: string;
-}
-/**
- * Redirect URL can be a static string or a function that returns a string.
- * Using a function allows dynamic selection based on platform/environment.
- *
- * @example
- * // Static string
- * redirectUrl: 'seekerwheel://callback'
- *
- * @example
- * // Dynamic function
- * redirectUrl: (context) => {
- *   if (context.platform === 'android') return 'seekerwheel://callback';
- *   if (context.platform === 'ios') return 'seekerwheel://callback';
- *   return context.origin; // web fallback
- * }
- */
-export type RedirectUrlResolver = string | ((context: RedirectUrlContext) => string);
 export declare class PrivyWalletProvider implements AuthProvider {
     private static instance;
     private containerElement;
@@ -40,71 +9,15 @@ export declare class PrivyWalletProvider implements AuthProvider {
     private privyMethods;
     private privyConfig;
     private pendingLogin;
-    /**
-     * Custom redirect URL for OAuth flows.
-     * Can be a static string or a function that dynamically determines the URL.
-     * Required for Android/iOS apps with custom URI schemes (e.g., 'seekerwheel://callback').
-     */
-    private redirectUrl;
     private pendingTransaction;
     private pendingSignTransaction;
     private pendingSignMessage;
     private pendingSignAndSubmitTransaction;
-    /**
-     * Create a new PrivyWalletProvider instance.
-     *
-     * @param appName - App name displayed in the Privy modal
-     * @param appLogoUrl - App logo URL displayed in the Privy modal
-     * @param privyConfig - Custom Privy configuration (optional, uses default if not provided)
-     * @param networkUrl - Custom RPC URL (optional)
-     * @param redirectUrl - Custom redirect URL for OAuth flows. Can be a string or a function
-     *                      that returns a string based on the current context (platform, WebView, etc.)
-     *
-     * @example
-     * // Static string
-     * new PrivyWalletProvider('MyApp', null, null, null, 'seekerwheel://callback')
-     *
-     * @example
-     * // Dynamic function
-     * new PrivyWalletProvider('MyApp', null, null, null, (context) => {
-     *   if (context.platform === 'android' || context.platform === 'ios') {
-     *     return 'seekerwheel://callback';
-     *   }
-     *   return context.origin; // web fallback
-     * })
-     */
     constructor(appName: string | null, appLogoUrl: string | null, privyConfig?: {
         appId: string;
         config: any;
-    }, networkUrl?: string | null, redirectUrl?: RedirectUrlResolver | null);
-    static getInstance(appName: string | null, appLogoUrl: string | null, privyConfig: any, networkUrl?: string | null, redirectUrl?: RedirectUrlResolver | null): PrivyWalletProvider;
-    /**
-     * Get the resolved redirect URL for OAuth flows.
-     * If a function was provided, it will be called with the current context.
-     *
-     * IMPORTANT: This URL must be added to your Privy Dashboard under
-     * "Allowed OAuth Redirect URLs" for social OAuth (Google, Apple, etc.) to work.
-     *
-     * For Android apps:
-     * 1. Add an intent filter in AndroidManifest.xml for your custom scheme
-     * 2. Add the scheme (e.g., 'seekerwheel://callback') to Privy Dashboard
-     * 3. Pass the same URL as `redirectUrl` when initializing the SDK
-     *
-     * For iOS apps:
-     * 1. Add the URL scheme to Info.plist under CFBundleURLTypes
-     * 2. Add the scheme to Privy Dashboard
-     * 3. Pass the same URL as `redirectUrl` when initializing the SDK
-     *
-     * @returns The resolved redirect URL or null if not set
-     */
-    getRedirectUrl(): string | null;
-    /**
-     * Get the current redirect URL context.
-     * Useful for debugging or determining what platform was detected.
-     *
-     * @returns The context object with platform, userAgent, isWebView, and origin
-     */
-    getRedirectUrlContext(): RedirectUrlContext;
+    }, networkUrl?: string | null);
+    static getInstance(appName: string | null, appLogoUrl: string | null, privyConfig: any): PrivyWalletProvider;
     private initialize;
     login(): Promise<User | null>;
     getNativeMethods(): Promise<any>;

package/dist/global.d.ts

@@ -1,4 +1,4 @@
-import { User, ClientConfig } from '@pooflabs/core';
+import { AuthProvider, User, ClientConfig } from '@pooflabs/core';
 export declare function init(newConfig: Partial<ClientConfig>): Promise<void>;
 export declare function onAuthStateChanged(callback: (user: User | null) => void): void;
 export declare function onAuthLoadingChanged(callback: (loading: boolean) => void): void;
@@ -8,3 +8,4 @@ export declare function login(): Promise<User | null>;
 export declare function logout(): Promise<void>;
 export declare function setCurrentUser(user: User | null): void;
 export declare function getCurrentUser(): User | null;
+export declare function setAuthProviderInstance(provider: AuthProvider): void;