@coinbase/cdp-hooks 0.0.50 → 0.0.52

package/README.md

@@ -364,6 +364,227 @@ function SignInScreen() {
 }
 ```
 
+### Link Additional Authentication Methods
+
+Once a user is authenticated, you can link additional authentication methods to their account. This allows users to sign in using multiple methods (email, SMS, OAuth providers) with the same embedded wallet.
+
+#### Link an Email Address
+
+Use the `useLinkEmail` hook to link an email address to the currently authenticated user:
+
+```tsx lines
+import { useLinkEmail, useVerifyEmailOTP, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function LinkEmail() {
+  const { linkEmail } = useLinkEmail();
+  const { verifyEmailOTP } = useVerifyEmailOTP();
+  const { currentUser } = useCurrentUser();
+  const [flowId, setFlowId] = useState("");
+
+  const handleLinkEmail = async (email: string) => {
+    if (!currentUser) {
+      console.error("User must be signed in first");
+      return;
+    }
+
+    try {
+      // Initiate email linking
+      const result = await linkEmail(email);
+      setFlowId(result.flowId);
+
+      // In a real application, you would prompt the user for the OTP
+      const otp = "123456";
+
+      // Verify the OTP to complete linking
+      await verifyEmailOTP({
+        flowId: result.flowId,
+        otp
+      });
+
+      console.log("Email linked successfully!");
+    } catch (error) {
+      console.error("Failed to link email:", error);
+    }
+  };
+
+  return (
+    <button
+      onClick={() => handleLinkEmail("additional-email@example.com")}
+      disabled={!currentUser}
+    >
+      Link Email
+    </button>
+  );
+}
+```
+
+#### Link a Phone Number
+
+Use the `useLinkSms` hook to link a phone number to the currently authenticated user:
+
+```tsx lines
+import { useLinkSms, useVerifySmsOTP, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function LinkPhoneNumber() {
+  const { linkSms } = useLinkSms();
+  const { verifySmsOTP } = useVerifySmsOTP();
+  const { currentUser } = useCurrentUser();
+  const [flowId, setFlowId] = useState("");
+
+  const handleLinkSms = async (phoneNumber: string) => {
+    if (!currentUser) {
+      console.error("User must be signed in first");
+      return;
+    }
+
+    try {
+      // Initiate SMS linking
+      const result = await linkSms(phoneNumber);
+      setFlowId(result.flowId);
+
+      // In a real application, you would prompt the user for the OTP
+      const otp = "123456";
+
+      // Verify the OTP to complete linking
+      await verifySmsOTP({
+        flowId: result.flowId,
+        otp
+      });
+
+      console.log("Phone number linked successfully!");
+    } catch (error) {
+      console.error("Failed to link phone number:", error);
+    }
+  };
+
+  return (
+    <button
+      onClick={() => handleLinkSms("+14155552671")}
+      disabled={!currentUser}
+    >
+      Link Phone Number
+    </button>
+  );
+}
+```
+
+#### Link a Google Account
+
+Use the `useLinkGoogle` hook to link a Google account to the currently authenticated user:
+
+```tsx lines
+import { useLinkGoogle, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function LinkGoogleAccount() {
+  const { linkGoogle } = useLinkGoogle();
+  const { currentUser } = useCurrentUser();
+
+  const handleLinkGoogle = async () => {
+    if (!currentUser) {
+      console.error("User must be signed in first");
+      return;
+    }
+
+    try {
+      // This initiates the OAuth flow to link a Google account
+      await linkGoogle();
+      // The user will be redirected to Google for authentication
+      // After successful authentication, the Google account will be linked
+    } catch (error) {
+      console.error("Failed to link Google account:", error);
+    }
+  };
+
+  return (
+    <button onClick={handleLinkGoogle} disabled={!currentUser}>
+      Link Google Account
+    </button>
+  );
+}
+```
+
+#### Link an Apple Account
+
+Use the `useLinkApple` hook to link an Apple account to the currently authenticated user:
+
+```tsx lines
+import { useLinkApple, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function LinkAppleAccount() {
+  const { linkApple } = useLinkApple();
+  const { currentUser } = useCurrentUser();
+
+  const handleLinkApple = async () => {
+    if (!currentUser) {
+      console.error("User must be signed in first");
+      return;
+    }
+
+    try {
+      // Link an Apple account
+      await linkApple();
+    } catch (error) {
+      console.error("Failed to link Apple account:", error);
+    }
+  };
+
+  return (
+    <button onClick={handleLinkApple} disabled={!currentUser}>  
+      Link Apple Account
+    </button>
+  );
+}
+```
+
+#### Link Any OAuth Provider
+
+Use the `useLinkOAuth` hook to link any supported OAuth provider (Google, Apple) to the currently authenticated user:
+
+```tsx lines
+import { useLinkOAuth, useCurrentUser } from "@coinbase/cdp-hooks";
+
+function LinkOAuthProvider() {
+  const { linkOAuth } = useLinkOAuth();
+  const { currentUser } = useCurrentUser();
+
+  const handleLinkGoogle = async () => {
+    if (!currentUser) {
+      console.error("User must be signed in first");
+      return;
+    }
+
+    try {
+      // Link a Google account
+      await linkOAuth("google");
+    } catch (error) {
+      console.error("Failed to link Google account:", error);
+    }
+  };
+
+  const handleLinkApple = async () => {
+    if (!currentUser) return;
+
+    try {
+      // Link an Apple account
+      await linkOAuth("apple");
+    } catch (error) {
+      console.error("Failed to link Apple account:", error);
+    }
+  };
+
+  return (
+    <div>
+      <button onClick={handleLinkGoogle} disabled={!currentUser}>
+        Link Google
+      </button>
+      <button onClick={handleLinkApple} disabled={!currentUser}>
+        Link Apple
+      </button>
+    </div>
+  );
+}
+```
+
 ### View User Information
 
 Once the end user has signed in, you can display their information in your application:

package/dist/esm/index.js

@@ -1,43 +1,53 @@
-import { APIError as n, OAuth2ProviderType as r } from "@coinbase/cdp-core";
+import { APIError as n, OAuth2ProviderType as o } from "@coinbase/cdp-core";
 import { CDPContext as i, CDPHooksProvider as t } from "./index2.js";
-import { useConfig as a, useCurrentUser as S, useEnforceAuthenticated as m, useEnforceUnauthenticated as d, useEvmAddress as p, useExportEvmAccount as c, useExportSolanaAccount as g, useGetAccessToken as E, useIsInitialized as f, useIsSignedIn as v, useOAuthState as A, useSendEvmTransaction as P, useSendSolanaTransaction as h, useSendUserOperation as x, useSignEvmHash as T, useSignEvmMessage as l, useSignEvmTransaction as I, useSignEvmTypedData as O, useSignInWithEmail as C, useSignInWithOAuth as y, useSignInWithSms as U, useSignOut as W, useSignSolanaMessage as k, useSignSolanaTransaction as D, useSolanaAddress as H, useVerifyEmailOTP as M, useVerifySmsOTP as V, useWaitForUserOperation as z } from "./index3.js";
-import { useCreateSpendPermission as G } from "./index4.js";
+import { useConfig as a, useCurrentUser as m, useEnforceAuthenticated as S, useEnforceUnauthenticated as p, useEvmAddress as d, useExportEvmAccount as f, useExportSolanaAccount as g, useGetAccessToken as E, useIsInitialized as c, useIsSignedIn as x, useOAuthState as A, useSendEvmTransaction as l, useSendSolanaTransaction as h, useSendUserOperation as v, useSignEvmHash as P, useSignEvmMessage as O, useSignEvmTransaction as T, useSignEvmTypedData as k, useSignInWithEmail as I, useSignInWithOAuth as C, useSignInWithSms as L, useSignOut as y, useSignSolanaMessage as U, useSignSolanaTransaction as W, useSolanaAddress as D, useVerifyEmailOTP as G, useVerifySmsOTP as H, useWaitForUserOperation as M } from "./index3.js";
+import { useCreateSpendPermission as z } from "./index4.js";
 import { useListSpendPermissions as R } from "./index5.js";
 import { useRevokeSpendPermission as j } from "./index6.js";
+import { useLinkGoogle as w } from "./index7.js";
+import { useLinkApple as J } from "./index8.js";
+import { useLinkSms as N } from "./index9.js";
+import { useLinkEmail as X } from "./index10.js";
+import { useLinkOAuth as Z } from "./index11.js";
 export {
   n as APIError,
   i as CDPContext,
   t as CDPHooksProvider,
-  r as OAuth2ProviderType,
+  o as OAuth2ProviderType,
   a as useConfig,
-  G as useCreateSpendPermission,
-  S as useCurrentUser,
-  m as useEnforceAuthenticated,
-  d as useEnforceUnauthenticated,
-  p as useEvmAddress,
-  c as useExportEvmAccount,
+  z as useCreateSpendPermission,
+  m as useCurrentUser,
+  S as useEnforceAuthenticated,
+  p as useEnforceUnauthenticated,
+  d as useEvmAddress,
+  f as useExportEvmAccount,
   g as useExportSolanaAccount,
   E as useGetAccessToken,
-  f as useIsInitialized,
-  v as useIsSignedIn,
+  c as useIsInitialized,
+  x as useIsSignedIn,
+  J as useLinkApple,
+  X as useLinkEmail,
+  w as useLinkGoogle,
+  Z as useLinkOAuth,
+  N as useLinkSms,
   R as useListSpendPermissions,
   A as useOAuthState,
   j as useRevokeSpendPermission,
-  P as useSendEvmTransaction,
+  l as useSendEvmTransaction,
   h as useSendSolanaTransaction,
-  x as useSendUserOperation,
-  T as useSignEvmHash,
-  l as useSignEvmMessage,
-  I as useSignEvmTransaction,
-  O as useSignEvmTypedData,
-  C as useSignInWithEmail,
-  y as useSignInWithOAuth,
-  U as useSignInWithSms,
-  W as useSignOut,
-  k as useSignSolanaMessage,
-  D as useSignSolanaTransaction,
-  H as useSolanaAddress,
-  M as useVerifyEmailOTP,
-  V as useVerifySmsOTP,
-  z as useWaitForUserOperation
+  v as useSendUserOperation,
+  P as useSignEvmHash,
+  O as useSignEvmMessage,
+  T as useSignEvmTransaction,
+  k as useSignEvmTypedData,
+  I as useSignInWithEmail,
+  C as useSignInWithOAuth,
+  L as useSignInWithSms,
+  y as useSignOut,
+  U as useSignSolanaMessage,
+  W as useSignSolanaTransaction,
+  D as useSolanaAddress,
+  G as useVerifyEmailOTP,
+  H as useVerifySmsOTP,
+  M as useWaitForUserOperation
 };

package/dist/esm/index10.js

@@ -1,14 +1,7 @@
-import { createClient as n } from "./index14.js";
-import { publicActions as c } from "./index22.js";
-function u(t) {
-  const { key: e = "public", name: i = "Public Client" } = t;
-  return n({
-    ...t,
-    key: e,
-    name: i,
-    type: "publicClient"
-  }).extend(c);
+import { linkEmail as i } from "@coinbase/cdp-core";
+function r() {
+  return { linkEmail: i };
 }
 export {
-  u as createPublicClient
+  r as useLinkEmail
 };