decane-connect-kit 2.7.6 → 2.8.0

package/dist/index.d.cts

@@ -92,7 +92,7 @@ interface DecaneConnectConfig {
     appId: string;
     apiKey: string;
     chains: Chain[];
-    authMethods: Array<'google' | 'email' | 'kingschat'>;
+    authMethods: Array<'google' | 'email' | 'phone' | 'kingschat'>;
     /**
      * Scopes requested from KingsChat at sign-in. Defaults to
      * `['send_chat_message']`, which is what KingsChat's own SDK asks for and is
@@ -315,6 +315,23 @@ interface DecaneConnect {
         providerId?: string;
     }): Promise<ConnectResult>;
     verifyEmailCode(email: string, code: string): Promise<ConnectResult>;
+    /**
+     * Send a 6-digit sign-in code by SMS (delivered via Termii).
+     *
+     * `phone` must be **E.164** — `+2348012345678`. Local formats like
+     * `08012345678` are rejected rather than guessed at: the wallet is derived
+     * from the number, so guessing a country would either merge two people onto
+     * one wallet or split one person across two. Collect the country in your UI.
+     *
+     * Always resolves, whether or not the number has an account — the backend
+     * answers identically either way so this cannot be used to discover who is
+     * registered. Follow with {@link verifyPhoneCode}.
+     */
+    connectWithPhone(phone: string): Promise<{
+        codeRequired: true;
+    }>;
+    /** Verify the SMS code and open the wallet. Pass the same E.164 number. */
+    verifyPhoneCode(phone: string, code: string): Promise<ConnectResult>;
     unlock(): Promise<void>;
     isUnlocked(): boolean;
     /**
@@ -503,6 +520,8 @@ declare class ApiClient {
     authKingsChat(accessToken: string): Promise<AuthResult>;
     authEmailStart(email: string): Promise<void>;
     authEmailVerify(email: string, code: string): Promise<AuthResult>;
+    authPhoneStart(phone: string): Promise<void>;
+    authPhoneVerify(phone: string, code: string): Promise<AuthResult>;
     getAddresses(jwt: string): Promise<{
         evm: string | null;
         solana: string | null;
@@ -668,7 +687,7 @@ interface DecaneProvider {
 type ConnectMode = "all" | "social" | "wallets" | "evm" | "solana" | "tron" | "evm+social" | "solana+social" | "tron+social" | "evm+tron" | "evm+tron+social";
 interface SocialConfig {
     apiKey: string;
-    authMethods?: ("google" | "email" | "kingschat")[];
+    authMethods?: ("google" | "email" | "phone" | "kingschat")[];
     /**
      * Scopes requested from KingsChat. Defaults to `['send_chat_message']`, which
      * is what KingsChat's own SDK asks for and is enough to establish identity.
@@ -1052,13 +1071,17 @@ interface WalletSelectorProps {
     theme?: "light" | "dark" | "auto";
     networks?: "evm" | "solana" | "tron" | "bitcoin" | "all";
     mode?: ConnectMode;
-    socialAuthMethods?: ("google" | "email" | "kingschat")[];
+    socialAuthMethods?: ("google" | "email" | "phone" | "kingschat")[];
     onGoogleSignIn?: () => Promise<void>;
     onKingsChatSignIn?: () => Promise<void>;
     onEmailStart?: (email: string) => Promise<{
         codeRequired: true;
     }>;
     onEmailVerify?: (email: string, code: string) => Promise<void>;
+    onPhoneStart?: (phone: string) => Promise<{
+        codeRequired: true;
+    }>;
+    onPhoneVerify?: (phone: string, code: string) => Promise<void>;
     /** Button text for the developer's own auth system, e.g. "Continue with Acme Inc". Omitted entirely when not configured. */
     customAuthLabel?: string;
     onCustomAuthSignIn?: () => Promise<void>;
@@ -1068,7 +1091,7 @@ interface WalletSelectorProps {
     passkeyAddress?: string | null;
     onPasskeySignIn?: () => Promise<unknown>;
 }
-declare function WalletSelector({ provider, open, onClose, onConnect, theme, networks, mode, socialAuthMethods, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, }: WalletSelectorProps): React.ReactPortal | null;
+declare function WalletSelector({ provider, open, onClose, onConnect, theme, networks, mode, socialAuthMethods, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, onPhoneStart, onPhoneVerify, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, }: WalletSelectorProps): React.ReactPortal | null;
 
 type Theme = "light" | "dark" | "auto";
 interface SocialAuthState {
@@ -1131,7 +1154,11 @@ interface SocialWalletModalProps {
         codeRequired: true;
     }>;
     onEmailVerify: (email: string, code: string) => Promise<void>;
-    authMethods?: Array<"google" | "email" | "kingschat">;
+    onPhoneStart?: (phone: string) => Promise<{
+        codeRequired: true;
+    }>;
+    onPhoneVerify?: (phone: string, code: string) => Promise<void>;
+    authMethods?: Array<"google" | "email" | "phone" | "kingschat">;
     customAuthLabel?: string;
     onCustomAuthSignIn?: () => Promise<void>;
     canUsePasskey?: boolean;
@@ -1148,7 +1175,7 @@ interface SocialWalletModalProps {
     rpcUrls?: Record<string, string>;
     chains?: string[];
 }
-declare function SocialWalletModal({ open, onClose, theme, socialAuth, onUnlock, onDisconnect, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, authMethods, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, onRotateShares, onExportPortableBackup, rpcUrls, chains, }: SocialWalletModalProps): React.ReactPortal | null;
+declare function SocialWalletModal({ open, onClose, theme, socialAuth, onUnlock, onDisconnect, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, onPhoneStart, onPhoneVerify, authMethods, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, onRotateShares, onExportPortableBackup, rpcUrls, chains, }: SocialWalletModalProps): React.ReactPortal | null;
 
 declare function DecaneMark({ size, muted }: {
     size?: number;
@@ -1179,6 +1206,7 @@ declare function useSocialAuth(): {
     needsReconnect: boolean;
     googleLoading: boolean;
     emailLoading: boolean;
+    phoneLoading: boolean;
     tokenLoading: boolean;
     customLoading: boolean;
     customAuthLabel: string | undefined;
@@ -1189,6 +1217,10 @@ declare function useSocialAuth(): {
         codeRequired: true;
     }>;
     confirmEmailCode: (email: string, code: string) => Promise<void>;
+    sendPhoneCode: (phone: string) => Promise<{
+        codeRequired: true;
+    }>;
+    confirmPhoneCode: (phone: string, code: string) => Promise<void>;
     signInWithToken: (token: string, opts?: {
         providerId?: string;
     }) => Promise<void>;

package/dist/index.d.ts

@@ -92,7 +92,7 @@ interface DecaneConnectConfig {
     appId: string;
     apiKey: string;
     chains: Chain[];
-    authMethods: Array<'google' | 'email' | 'kingschat'>;
+    authMethods: Array<'google' | 'email' | 'phone' | 'kingschat'>;
     /**
      * Scopes requested from KingsChat at sign-in. Defaults to
      * `['send_chat_message']`, which is what KingsChat's own SDK asks for and is
@@ -315,6 +315,23 @@ interface DecaneConnect {
         providerId?: string;
     }): Promise<ConnectResult>;
     verifyEmailCode(email: string, code: string): Promise<ConnectResult>;
+    /**
+     * Send a 6-digit sign-in code by SMS (delivered via Termii).
+     *
+     * `phone` must be **E.164** — `+2348012345678`. Local formats like
+     * `08012345678` are rejected rather than guessed at: the wallet is derived
+     * from the number, so guessing a country would either merge two people onto
+     * one wallet or split one person across two. Collect the country in your UI.
+     *
+     * Always resolves, whether or not the number has an account — the backend
+     * answers identically either way so this cannot be used to discover who is
+     * registered. Follow with {@link verifyPhoneCode}.
+     */
+    connectWithPhone(phone: string): Promise<{
+        codeRequired: true;
+    }>;
+    /** Verify the SMS code and open the wallet. Pass the same E.164 number. */
+    verifyPhoneCode(phone: string, code: string): Promise<ConnectResult>;
     unlock(): Promise<void>;
     isUnlocked(): boolean;
     /**
@@ -503,6 +520,8 @@ declare class ApiClient {
     authKingsChat(accessToken: string): Promise<AuthResult>;
     authEmailStart(email: string): Promise<void>;
     authEmailVerify(email: string, code: string): Promise<AuthResult>;
+    authPhoneStart(phone: string): Promise<void>;
+    authPhoneVerify(phone: string, code: string): Promise<AuthResult>;
     getAddresses(jwt: string): Promise<{
         evm: string | null;
         solana: string | null;
@@ -668,7 +687,7 @@ interface DecaneProvider {
 type ConnectMode = "all" | "social" | "wallets" | "evm" | "solana" | "tron" | "evm+social" | "solana+social" | "tron+social" | "evm+tron" | "evm+tron+social";
 interface SocialConfig {
     apiKey: string;
-    authMethods?: ("google" | "email" | "kingschat")[];
+    authMethods?: ("google" | "email" | "phone" | "kingschat")[];
     /**
      * Scopes requested from KingsChat. Defaults to `['send_chat_message']`, which
      * is what KingsChat's own SDK asks for and is enough to establish identity.
@@ -1052,13 +1071,17 @@ interface WalletSelectorProps {
     theme?: "light" | "dark" | "auto";
     networks?: "evm" | "solana" | "tron" | "bitcoin" | "all";
     mode?: ConnectMode;
-    socialAuthMethods?: ("google" | "email" | "kingschat")[];
+    socialAuthMethods?: ("google" | "email" | "phone" | "kingschat")[];
     onGoogleSignIn?: () => Promise<void>;
     onKingsChatSignIn?: () => Promise<void>;
     onEmailStart?: (email: string) => Promise<{
         codeRequired: true;
     }>;
     onEmailVerify?: (email: string, code: string) => Promise<void>;
+    onPhoneStart?: (phone: string) => Promise<{
+        codeRequired: true;
+    }>;
+    onPhoneVerify?: (phone: string, code: string) => Promise<void>;
     /** Button text for the developer's own auth system, e.g. "Continue with Acme Inc". Omitted entirely when not configured. */
     customAuthLabel?: string;
     onCustomAuthSignIn?: () => Promise<void>;
@@ -1068,7 +1091,7 @@ interface WalletSelectorProps {
     passkeyAddress?: string | null;
     onPasskeySignIn?: () => Promise<unknown>;
 }
-declare function WalletSelector({ provider, open, onClose, onConnect, theme, networks, mode, socialAuthMethods, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, }: WalletSelectorProps): React.ReactPortal | null;
+declare function WalletSelector({ provider, open, onClose, onConnect, theme, networks, mode, socialAuthMethods, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, onPhoneStart, onPhoneVerify, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, }: WalletSelectorProps): React.ReactPortal | null;
 
 type Theme = "light" | "dark" | "auto";
 interface SocialAuthState {
@@ -1131,7 +1154,11 @@ interface SocialWalletModalProps {
         codeRequired: true;
     }>;
     onEmailVerify: (email: string, code: string) => Promise<void>;
-    authMethods?: Array<"google" | "email" | "kingschat">;
+    onPhoneStart?: (phone: string) => Promise<{
+        codeRequired: true;
+    }>;
+    onPhoneVerify?: (phone: string, code: string) => Promise<void>;
+    authMethods?: Array<"google" | "email" | "phone" | "kingschat">;
     customAuthLabel?: string;
     onCustomAuthSignIn?: () => Promise<void>;
     canUsePasskey?: boolean;
@@ -1148,7 +1175,7 @@ interface SocialWalletModalProps {
     rpcUrls?: Record<string, string>;
     chains?: string[];
 }
-declare function SocialWalletModal({ open, onClose, theme, socialAuth, onUnlock, onDisconnect, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, authMethods, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, onRotateShares, onExportPortableBackup, rpcUrls, chains, }: SocialWalletModalProps): React.ReactPortal | null;
+declare function SocialWalletModal({ open, onClose, theme, socialAuth, onUnlock, onDisconnect, onGoogleSignIn, onKingsChatSignIn, onEmailStart, onEmailVerify, onPhoneStart, onPhoneVerify, authMethods, customAuthLabel, onCustomAuthSignIn, canUsePasskey, passkeyAddress, onPasskeySignIn, onRotateShares, onExportPortableBackup, rpcUrls, chains, }: SocialWalletModalProps): React.ReactPortal | null;
 
 declare function DecaneMark({ size, muted }: {
     size?: number;
@@ -1179,6 +1206,7 @@ declare function useSocialAuth(): {
     needsReconnect: boolean;
     googleLoading: boolean;
     emailLoading: boolean;
+    phoneLoading: boolean;
     tokenLoading: boolean;
     customLoading: boolean;
     customAuthLabel: string | undefined;
@@ -1189,6 +1217,10 @@ declare function useSocialAuth(): {
         codeRequired: true;
     }>;
     confirmEmailCode: (email: string, code: string) => Promise<void>;
+    sendPhoneCode: (phone: string) => Promise<{
+        codeRequired: true;
+    }>;
+    confirmPhoneCode: (phone: string, code: string) => Promise<void>;
     signInWithToken: (token: string, opts?: {
         providerId?: string;
     }) => Promise<void>;