@lumiapassport/ui-kit 1.11.0 → 1.12.0

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import React__default from 'react';
-import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
+import React__default, { PropsWithChildren, FC, HTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
 import * as viem from 'viem';
 import { Chain, Hash as Hash$1, TransactionReceipt, Address as Address$1, Hex } from 'viem';
 export { JwtTokens, LoginResponse, VerifyResponse, getValidTokens, jwtTokenManager, logout } from '@lumiapassport/core/auth';
@@ -69,11 +69,14 @@ interface LumiaPassportConfig {
         subtitle?: string;
         theme: 'light' | 'dark' | 'auto';
         authOrder?: Array<'passkey' | 'email' | 'social'>;
+        /** DEPRECATED use useLumiaPassportOpen().open('auth') in your app for auto-open auth dialog */
         authOpen?: boolean;
+        /** DEPRECATED use system fonts */
         fonts?: {
             base?: string;
             heading?: string;
         };
+        /** DEPRECATED colors provided by cssv */
         colors?: {
             light?: {
                 background?: string;
@@ -193,6 +196,8 @@ interface LumiaPassportContextType {
     config: LumiaPassportConfig;
     updateConfig: (updates: Partial<LumiaPassportConfig>) => void;
     callbacks?: LumiaPassportCallbacks;
+    providersVersion: number;
+    notifyProvidersUpdate: () => void;
 }
 interface LumiaPassportProviderProps {
     children: React__default.ReactNode;
@@ -330,18 +335,15 @@ interface SessionState {
     status: string;
     error: string | null;
     recoveryUserId: string | null;
-    isRecoveryModalOpen: boolean;
+    isIframeReady: boolean;
+    setIsIframeReady: (ready: boolean) => void;
     setSession: (s: AccountSession | null) => void;
     setAddress: (a: `0x${string}` | null) => void;
     setStatus: (s: string) => void;
     setError: (e: string | null) => void;
     setRecoveryUserId: (userId: string | null) => void;
-    setIsRecoveryModalOpen: (open: boolean) => void;
-}
-interface LumiaPassportSessionProviderProps {
-    children: React__default.ReactNode;
 }
-declare const LumiaPassportSessionProvider: React__default.FC<LumiaPassportSessionProviderProps>;
+declare function LumiaPassportSessionProvider({ children }: PropsWithChildren): react_jsx_runtime.JSX.Element;
 declare function useLumiaPassportSession(): SessionState;
 /**
  * @deprecated Use `useLumiaPassportSession` instead. This alias will be removed in v2.0.0
@@ -350,7 +352,7 @@ declare function useLumiaSession(): SessionState;
 /**
  * @deprecated Use `LumiaPassportSessionProviderProps` instead. This alias will be removed in v2.0.0
  */
-type LumiaSessionProviderProps = LumiaPassportSessionProviderProps;
+type LumiaSessionProviderProps = PropsWithChildren;
 /**
  * @deprecated Use `LumiaPassportSessionProvider` instead. This alias will be removed in v2.0.0
  */
@@ -367,7 +369,11 @@ interface LumiaRainbowKitProviderProps {
 declare const LumiaRainbowKitProvider: React__default.FC<LumiaRainbowKitProviderProps>;
 
 interface ConnectWalletButtonProps {
+    /** Button Component to render as unsigned button instance */
+    ConnectButton?: FC<HTMLAttributes<HTMLButtonElement>>;
+    /** Button container class name */
     className?: string;
+    /** Button label */
     label?: string;
     usePaymaster?: boolean;
     authOpen?: boolean;
@@ -393,9 +399,7 @@ interface LumiaLogoProps {
 declare const LumiaLogo: React__default.FC<LumiaLogoProps>;
 
 type Theme = 'light' | 'dark' | 'auto';
-/**
- * Hook for managing theme detection and CSS classes
- */
+/** @deprecated will not be provided by v2 */
 declare function useTheme(configTheme: Theme): {
     theme: "light" | "dark";
     isDark: boolean;
@@ -418,6 +422,32 @@ declare function useTheme(configTheme: Theme): {
     };
 };
 
+type PageKey = 'auth' | 'terms-of-service' | 'main-menu' | 'send' | 'receive' | 'buy' | 'kyc' | 'transactions' | 'assets' | 'manage-wallet' | 'add-provider' | 'unlink-provider' | 'security' | 'keysare-backup';
+
+/**
+ * Hook to programmatically open the LumiaPassport dialogs
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { isOpen, open, close } = useLumiaPassportOpen();
+ *
+ *   return (
+ *     <button onClick={() => open('manage-wallet')}>
+ *       Manage Wallet
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useLumiaPassportOpen(): {
+    /** Opens the Manage Wallet modal */
+    readonly open: (passportPage: PageKey) => void;
+    /** Closes the Manage Wallet modal */
+    readonly close: () => void;
+    /** Whether the Manage Wallet modal is currently open */
+    readonly isOpen: boolean;
+};
+
 type ChainLike$2 = {
     id: number;
     blockExplorers?: {
@@ -486,12 +516,7 @@ interface TransactionsListProps {
 }
 declare const TransactionsList: React__default.FC<TransactionsListProps>;
 
-interface KeyshareBackupProps {
-    userId: string;
-    onBackupSuccess?: () => void;
-    onBack?: () => void;
-}
-declare function KeyshareBackup({ userId, onBackupSuccess, onBack }: KeyshareBackupProps): react_jsx_runtime.JSX.Element;
+declare function KeyshareBackupMenu(): react_jsx_runtime.JSX.Element;
 
 interface SendTransactionParams$1 {
     to: `0x${string}`;
@@ -609,6 +634,10 @@ interface UserProfile {
     createdAt: string;
     updatedAt: string;
     hasKeyshare: boolean;
+    kycDetails: {
+        provider: 'sumsub' | 'uaepass' | 'custom';
+        kycStatus: string;
+    } | null;
 }
 interface UpdateProfileRequest {
     displayName?: string;
@@ -995,7 +1024,9 @@ declare function useSmartAccountTransactions(): {
 
 interface LinkedProfileDisplay extends AuthProvider {
     displayName: string;
-    icon?: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
     color?: string;
 }
 declare function useLumiaPassportLinkedProfiles(): {
@@ -1116,9 +1147,9 @@ declare class IframeManager {
     private restoreAllDialogs;
     /**
      * Stop Radix dismissable layers from swallowing the first click on the iframe.
-    * Radix attaches pointer event guards at the document level; we intercept at window
-    * capture phase so user clicks flow straight into the consent iframe.
-    */
+     * Radix attaches pointer event guards at the document level; we intercept at window
+     * capture phase so user clicks flow straight into the consent iframe.
+     */
     private enablePointerEventGuards;
     /**
      * Remove pointer interception once iframe is hidden again.
@@ -1207,6 +1238,11 @@ declare class IframeManager {
      * Remove app from trusted list
      */
     removeTrustedApp(userId: string, projectId: string, origin: string): Promise<boolean>;
+    /**
+     * Clear all authorizations for current project (for testing consent flow)
+     * This will force the consent modal to appear on next authentication
+     */
+    clearAuthorizations(): Promise<boolean>;
     /**
      * Create backup of keyshare
      */
@@ -1286,4 +1322,4 @@ declare function getIframeManager(config?: IframeManagerConfig): IframeManager;
  */
 declare function destroyIframeManager(): void;
 
-export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, type LumiaPassportSessionProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction$1 as Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, destroyIframeManager, getIframeManager, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };
+export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackupMenu as KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction$1 as Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, destroyIframeManager, getIframeManager, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportOpen, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import * as React from 'react';
-import React__default from 'react';
-import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
+import React__default, { PropsWithChildren, FC, HTMLAttributes } from 'react';
 import * as react_jsx_runtime from 'react/jsx-runtime';
+import { UserOperationV07, UserOperationV06 } from '@lumiapassport/core/bundler';
 import * as viem from 'viem';
 import { Chain, Hash as Hash$1, TransactionReceipt, Address as Address$1, Hex } from 'viem';
 export { JwtTokens, LoginResponse, VerifyResponse, getValidTokens, jwtTokenManager, logout } from '@lumiapassport/core/auth';
@@ -69,11 +69,14 @@ interface LumiaPassportConfig {
         subtitle?: string;
         theme: 'light' | 'dark' | 'auto';
         authOrder?: Array<'passkey' | 'email' | 'social'>;
+        /** DEPRECATED use useLumiaPassportOpen().open('auth') in your app for auto-open auth dialog */
         authOpen?: boolean;
+        /** DEPRECATED use system fonts */
         fonts?: {
             base?: string;
             heading?: string;
         };
+        /** DEPRECATED colors provided by cssv */
         colors?: {
             light?: {
                 background?: string;
@@ -193,6 +196,8 @@ interface LumiaPassportContextType {
     config: LumiaPassportConfig;
     updateConfig: (updates: Partial<LumiaPassportConfig>) => void;
     callbacks?: LumiaPassportCallbacks;
+    providersVersion: number;
+    notifyProvidersUpdate: () => void;
 }
 interface LumiaPassportProviderProps {
     children: React__default.ReactNode;
@@ -330,18 +335,15 @@ interface SessionState {
     status: string;
     error: string | null;
     recoveryUserId: string | null;
-    isRecoveryModalOpen: boolean;
+    isIframeReady: boolean;
+    setIsIframeReady: (ready: boolean) => void;
     setSession: (s: AccountSession | null) => void;
     setAddress: (a: `0x${string}` | null) => void;
     setStatus: (s: string) => void;
     setError: (e: string | null) => void;
     setRecoveryUserId: (userId: string | null) => void;
-    setIsRecoveryModalOpen: (open: boolean) => void;
-}
-interface LumiaPassportSessionProviderProps {
-    children: React__default.ReactNode;
 }
-declare const LumiaPassportSessionProvider: React__default.FC<LumiaPassportSessionProviderProps>;
+declare function LumiaPassportSessionProvider({ children }: PropsWithChildren): react_jsx_runtime.JSX.Element;
 declare function useLumiaPassportSession(): SessionState;
 /**
  * @deprecated Use `useLumiaPassportSession` instead. This alias will be removed in v2.0.0
@@ -350,7 +352,7 @@ declare function useLumiaSession(): SessionState;
 /**
  * @deprecated Use `LumiaPassportSessionProviderProps` instead. This alias will be removed in v2.0.0
  */
-type LumiaSessionProviderProps = LumiaPassportSessionProviderProps;
+type LumiaSessionProviderProps = PropsWithChildren;
 /**
  * @deprecated Use `LumiaPassportSessionProvider` instead. This alias will be removed in v2.0.0
  */
@@ -367,7 +369,11 @@ interface LumiaRainbowKitProviderProps {
 declare const LumiaRainbowKitProvider: React__default.FC<LumiaRainbowKitProviderProps>;
 
 interface ConnectWalletButtonProps {
+    /** Button Component to render as unsigned button instance */
+    ConnectButton?: FC<HTMLAttributes<HTMLButtonElement>>;
+    /** Button container class name */
     className?: string;
+    /** Button label */
     label?: string;
     usePaymaster?: boolean;
     authOpen?: boolean;
@@ -393,9 +399,7 @@ interface LumiaLogoProps {
 declare const LumiaLogo: React__default.FC<LumiaLogoProps>;
 
 type Theme = 'light' | 'dark' | 'auto';
-/**
- * Hook for managing theme detection and CSS classes
- */
+/** @deprecated will not be provided by v2 */
 declare function useTheme(configTheme: Theme): {
     theme: "light" | "dark";
     isDark: boolean;
@@ -418,6 +422,32 @@ declare function useTheme(configTheme: Theme): {
     };
 };
 
+type PageKey = 'auth' | 'terms-of-service' | 'main-menu' | 'send' | 'receive' | 'buy' | 'kyc' | 'transactions' | 'assets' | 'manage-wallet' | 'add-provider' | 'unlink-provider' | 'security' | 'keysare-backup';
+
+/**
+ * Hook to programmatically open the LumiaPassport dialogs
+ * @example
+ * ```tsx
+ * function MyComponent() {
+ *   const { isOpen, open, close } = useLumiaPassportOpen();
+ *
+ *   return (
+ *     <button onClick={() => open('manage-wallet')}>
+ *       Manage Wallet
+ *     </button>
+ *   );
+ * }
+ * ```
+ */
+declare function useLumiaPassportOpen(): {
+    /** Opens the Manage Wallet modal */
+    readonly open: (passportPage: PageKey) => void;
+    /** Closes the Manage Wallet modal */
+    readonly close: () => void;
+    /** Whether the Manage Wallet modal is currently open */
+    readonly isOpen: boolean;
+};
+
 type ChainLike$2 = {
     id: number;
     blockExplorers?: {
@@ -486,12 +516,7 @@ interface TransactionsListProps {
 }
 declare const TransactionsList: React__default.FC<TransactionsListProps>;
 
-interface KeyshareBackupProps {
-    userId: string;
-    onBackupSuccess?: () => void;
-    onBack?: () => void;
-}
-declare function KeyshareBackup({ userId, onBackupSuccess, onBack }: KeyshareBackupProps): react_jsx_runtime.JSX.Element;
+declare function KeyshareBackupMenu(): react_jsx_runtime.JSX.Element;
 
 interface SendTransactionParams$1 {
     to: `0x${string}`;
@@ -609,6 +634,10 @@ interface UserProfile {
     createdAt: string;
     updatedAt: string;
     hasKeyshare: boolean;
+    kycDetails: {
+        provider: 'sumsub' | 'uaepass' | 'custom';
+        kycStatus: string;
+    } | null;
 }
 interface UpdateProfileRequest {
     displayName?: string;
@@ -995,7 +1024,9 @@ declare function useSmartAccountTransactions(): {
 
 interface LinkedProfileDisplay extends AuthProvider {
     displayName: string;
-    icon?: string;
+    icon?: React.ComponentType<{
+        className?: string;
+    }>;
     color?: string;
 }
 declare function useLumiaPassportLinkedProfiles(): {
@@ -1116,9 +1147,9 @@ declare class IframeManager {
     private restoreAllDialogs;
     /**
      * Stop Radix dismissable layers from swallowing the first click on the iframe.
-    * Radix attaches pointer event guards at the document level; we intercept at window
-    * capture phase so user clicks flow straight into the consent iframe.
-    */
+     * Radix attaches pointer event guards at the document level; we intercept at window
+     * capture phase so user clicks flow straight into the consent iframe.
+     */
     private enablePointerEventGuards;
     /**
      * Remove pointer interception once iframe is hidden again.
@@ -1207,6 +1238,11 @@ declare class IframeManager {
      * Remove app from trusted list
      */
     removeTrustedApp(userId: string, projectId: string, origin: string): Promise<boolean>;
+    /**
+     * Clear all authorizations for current project (for testing consent flow)
+     * This will force the consent modal to appear on next authentication
+     */
+    clearAuthorizations(): Promise<boolean>;
     /**
      * Create backup of keyshare
      */
@@ -1286,4 +1322,4 @@ declare function getIframeManager(config?: IframeManagerConfig): IframeManager;
  */
 declare function destroyIframeManager(): void;
 
-export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, type LumiaPassportSessionProviderProps, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction$1 as Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, destroyIframeManager, getIframeManager, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };
+export { type AccountSession$1 as AccountSession, Address, type AddressProps, type Asset, ConnectWalletButton, type ConnectWalletButtonProps, Hash, type HashProps, KeyshareBackupMenu as KeyshareBackup, LUMIA_EXPLORER_URL, LumiaLogo, type LumiaPassportCallbacks, type LumiaPassportConfig, LumiaPassportProvider, type LumiaPassportProviderProps, LumiaPassportSessionProvider, LumiaRainbowKitProvider, type LumiaRainbowKitProviderProps, LumiaSessionProvider, type LumiaSessionProviderProps, LumiaWagmiProvider, type ProviderDetail, type SendTransactionParams, type SendTransactionResult, type SignTypedDataParams, type Theme, ThemeToggle, type TokenBalance, type Transaction$1 as Transaction, TransactionsList, type TypedDataDomain, type TypedDataField, type UpdateProfileRequest, type UseLogoutReturn, type UseSendTransactionReturn, type UseUserOpStatusOptions, type UseUserOpStatusReturn, type UserOpMempool, type UserOpReceipt, type SendTransactionParams$1 as UserOpSendTransactionParams, type UserOpState, UserOpStatus, type UserOpStatusProps, type UserOperation, type UserProfile, type WalletReadyStatus, deployAccount, destroyIframeManager, getIframeManager, getUserProfile, lumiaBeam, prepareUserOperation, queryClient, sendUserOperation, signTypedData, updateUserProfile, useAssets, useLogout, useLumiaPassportConfig, useLumiaPassportLinkedProfiles, useLumiaPassportOpen, useLumiaPassportSession, useLumiaSession, useSendTransaction, useSmartAccountTransactions, useTheme, useTokenBalance, useTokenInfo, useTransactions, useUserOpStatus, wagmiConfig };