@cedros/login-react 0.0.37 → 0.0.39

package/dist/index.d.ts

@@ -673,6 +673,7 @@ export declare interface AuthUser {
     id: string;
     email?: string;
     name?: string;
+    username?: string;
     picture?: string;
     walletAddress?: string;
     authMethods: AuthMethod[];
@@ -913,6 +914,29 @@ export declare interface ChangePasswordResponse {
  */
 declare type ChatMessageRole = 'user' | 'assistant' | 'system';
 
+declare interface CheckUsernameResponse {
+    available: boolean;
+    suggestion?: string;
+    error?: string;
+}
+
+/**
+ * Prompts the user to choose a unique handle-style username.
+ *
+ * Shown when the server returns `postLogin.action === 'choose_username'`,
+ * indicating the admin has enabled username selection and the user hasn't
+ * chosen one yet.
+ */
+export declare function ChooseUsernamePrompt({ onComplete, onSkip, className, }: ChooseUsernamePromptProps): JSX.Element;
+
+export declare interface ChooseUsernamePromptProps {
+    /** Called after the user saves their username */
+    onComplete?: () => void;
+    /** Called when the user chooses to skip */
+    onSkip?: () => void;
+    className?: string;
+}
+
 /**
  * Prompts the user to fill in their display name.
  *
@@ -2560,8 +2584,8 @@ export declare interface PluginRegistry {
  * Post-login action returned by the server after authentication
  */
 export declare interface PostLoginAction {
-    /** Action type: "welcome", "complete_profile", "redirect", or "setup_mfa" */
-    action: 'welcome' | 'complete_profile' | 'redirect' | 'setup_mfa';
+    /** Action type: "setup_mfa", "enroll_wallet", "acknowledge_recovery", "choose_username", "welcome", "complete_profile", or "redirect" */
+    action: 'setup_mfa' | 'enroll_wallet' | 'acknowledge_recovery' | 'choose_username' | 'welcome' | 'complete_profile' | 'redirect';
     /** URL/route for redirect or welcome page */
     redirectUrl?: string;
 }
@@ -3718,6 +3742,8 @@ export declare interface UpdateOrgRequest {
 export declare interface UpdateProfileRequest {
     /** User's display name */
     name?: string;
+    /** Unique handle-style username (3-30 chars, lowercase alphanumeric + underscores) */
+    username?: string;
     /** User's profile picture URL */
     picture?: string;
 }
@@ -3729,6 +3755,7 @@ export declare interface UpdateProfileResponse {
     id: string;
     email?: string;
     name?: string;
+    username?: string;
     picture?: string;
     emailVerified: boolean;
     createdAt: string;
@@ -4194,8 +4221,8 @@ export declare interface UseGoogleAuthReturn {
     isInitialized: boolean;
     error: AuthError | null;
     clearError: () => void;
-    /** ID token saved when ACCOUNT_LINK_REQUIRED is returned. Pass to POST /auth/link-oauth with the user's password. */
-    pendingLinkIdToken: string | null;
+    /** Access token saved when ACCOUNT_LINK_REQUIRED is returned. Pass to POST /auth/link-oauth with the user's password. */
+    pendingLinkToken: string | null;
     /** Clear the pending link state */
     clearPendingLink: () => void;
 }
@@ -4516,6 +4543,18 @@ export declare interface UsePendingRecoveryReturn {
  *     return <MfaSetupPrompt onComplete={clearPostLogin} />;
  *   }
  *
+ *   if (postLoginAction?.action === 'enroll_wallet') {
+ *     return <WalletEnrollment onComplete={clearPostLogin} />;
+ *   }
+ *
+ *   if (postLoginAction?.action === 'acknowledge_recovery') {
+ *     return <RecoveryInfoScreen onComplete={clearPostLogin} />;
+ *   }
+ *
+ *   if (postLoginAction?.action === 'choose_username') {
+ *     return <ChooseUsernamePrompt onComplete={clearPostLogin} onSkip={clearPostLogin} />;
+ *   }
+ *
  *   if (postLoginAction?.action === 'welcome') {
  *     return <WelcomePage onComplete={async () => {
  *       await markWelcomeCompleted();
@@ -4741,6 +4780,15 @@ export declare interface UseSessionsReturn {
     otherSessionCount: number;
 }
 
+export declare function useSetPassword(): UseSetPasswordReturn;
+
+export declare interface UseSetPasswordReturn {
+    /** Set initial password for the current user */
+    setPassword: (password: string) => Promise<void>;
+    isLoading: boolean;
+    error: AuthError | null;
+}
+
 /**
  * Hook for first-run setup operations.
  *
@@ -5008,6 +5056,41 @@ export declare interface UseTransactionSigningReturn {
  */
 export declare function useTranslations(): Translations;
 
+/**
+ * Hook for username availability checking and setting.
+ *
+ * @example
+ * ```tsx
+ * const { checkAvailability, getSuggestion, setUsername } = useUsername();
+ *
+ * // Get a random suggestion
+ * const suggestion = await getSuggestion();
+ *
+ * // Check if a username is available
+ * const result = await checkAvailability('swift_falcon_42');
+ * if (result.available) {
+ *   await setUsername('swift_falcon_42');
+ * }
+ * ```
+ */
+export declare function useUsername(): UseUsernameReturn;
+
+/**
+ * Return type for the useUsername hook
+ */
+export declare interface UseUsernameReturn {
+    /** Check if a username is available. Returns availability + optional suggestion. */
+    checkAvailability: (username: string) => Promise<CheckUsernameResponse>;
+    /** Get a random username suggestion from the server. */
+    getSuggestion: () => Promise<string | null>;
+    /** Set the current user's username via PATCH /auth/me. */
+    setUsername: (username: string) => Promise<void>;
+    /** Whether a request is in progress */
+    isLoading: boolean;
+    /** Error from the last operation */
+    error: Error | null;
+}
+
 /**
  * Main wallet hook
  *
@@ -5329,8 +5412,18 @@ export declare interface WalletContextValue {
 /**
  * Wallet enrollment wizard
  */
-export declare function WalletEnrollment({ onComplete, onCancel, className, forceAuthMethod, }: WalletEnrollmentProps): JSX.Element;
+export declare function WalletEnrollment({ onComplete, onCancel, className, }: WalletEnrollmentProps): JSX.Element;
 
+/**
+ * Wallet enrollment wizard component (server-side signing)
+ *
+ * Auto-detects the user's auth method and shows the appropriate flow:
+ * - Email users → enter existing account password
+ * - Passkey users → authenticate with existing passkey
+ * - OAuth-only users → set a new account password first
+ *
+ * Share B is stored as plaintext on the server (SSS math protects it).
+ */
 export declare interface WalletEnrollmentProps {
     /** Callback when enrollment completes */
     onComplete?: (solanaPubkey: string) => void;
@@ -5338,8 +5431,6 @@ export declare interface WalletEnrollmentProps {
     onCancel?: () => void;
     /** Optional class name */
     className?: string;
-    /** Force a specific auth method (otherwise auto-detected) */
-    forceAuthMethod?: ShareAAuthMethod;
 }
 
 /** Request to enroll wallet  */