@b3dotfun/sdk 0.1.69-alpha.23 → 0.1.69-alpha.24

package/dist/types/global-account/react/components/index.d.ts

@@ -8,6 +8,7 @@ export { useB3Config } from "./B3Provider/useB3Config";
 export { StyleRoot } from "./StyleRoot";
 export { BetterAuthResetPassword, type BetterAuthResetPasswordProps } from "./SignInWithB3/BetterAuthResetPassword";
 export { BetterAuthSignIn, type BetterAuthSignInProps } from "./SignInWithB3/BetterAuthSignIn";
+export { BetterAuthVerifyEmail, type BetterAuthVerifyEmailProps, type BetterAuthVerifyEmailState, } from "./SignInWithB3/BetterAuthVerifyEmail";
 export { AuthButton } from "./SignInWithB3/components/AuthButton";
 export { PermissionItem } from "./SignInWithB3/components/PermissionItem";
 export { WalletRow } from "./SignInWithB3/components/WalletRow";

package/dist/types/global-account/react/hooks/useBetterAuth.d.ts

@@ -13,7 +13,7 @@ export declare class EmailVerificationRequiredError extends Error {
  */
 export declare function useBetterAuth(): {
     signInWithEmail: (email: string, password: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
-    signUpWithEmail: (email: string, password: string, name: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
+    signUpWithEmail: (email: string, password: string, name: string, verifyCallbackURL?: string) => Promise<import("@feathersjs/authentication").AuthenticationResult>;
     signInWithSocial: (provider: BetterAuthSocialProvider) => Promise<void>;
     requestPasswordReset: (email: string, redirectTo?: string) => Promise<{
         data: {

package/dist/types/global-account/react/stores/useModalStore.d.ts

@@ -41,6 +41,8 @@ export interface SignInWithB3ModalProps extends BaseModalProps {
     source?: "signInWithB3Button" | "requestPermissions";
     /** Whether to show the signers enabled modal */
     signersEnabled?: boolean;
+    /** URL Better Auth redirects to after server-side email verification. */
+    verifyEmailRedirectTo?: string;
 }
 /**
  * Props for the Request Permissions modal

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@b3dotfun/sdk",
-  "version": "0.1.69-alpha.23",
+  "version": "0.1.69-alpha.24",
   "source": "src/index.ts",
   "main": "./dist/cjs/index.js",
   "react-native": "./dist/cjs/index.native.js",

package/src/global-account/react/components/SignInWithB3/BetterAuthSignIn.tsx

@@ -33,6 +33,11 @@ export interface BetterAuthSignInProps {
   showEmail?: boolean;
   /** URL to redirect to after password reset link is clicked. Token is appended as ?token=... */
   passwordResetRedirectTo?: string;
+  /**
+   * URL Better Auth redirects to after server-side email verification. Render
+   * `BetterAuthVerifyEmail` at this route so the user gets a confirmation page.
+   */
+  verifyEmailRedirectTo?: string;
   /** Called after successful authentication */
   onSuccess?: () => void;
   /** Called on authentication error */
@@ -61,6 +66,7 @@ export function BetterAuthSignIn({
   socialProviders = DEFAULT_SOCIAL_PROVIDERS.map(p => p.id),
   showEmail = true,
   passwordResetRedirectTo,
+  verifyEmailRedirectTo,
   onSuccess,
   onError,
   className,
@@ -153,7 +159,7 @@ export function BetterAuthSignIn({
       setError(null);
 
       if (mode === "sign-up") {
-        await signUpWithEmail(normalizedEmail, password, name.trim());
+        await signUpWithEmail(normalizedEmail, password, name.trim(), verifyEmailRedirectTo);
       } else {
         await signInWithEmail(normalizedEmail, password);
       }

package/src/global-account/react/components/SignInWithB3/BetterAuthVerifyEmail.tsx

@@ -0,0 +1,155 @@
+import { Button } from "@b3dotfun/sdk/global-account/react";
+import { debugB3React } from "@b3dotfun/sdk/shared/utils/debug";
+
+const debug = debugB3React("BetterAuthVerifyEmail");
+
+export type BetterAuthVerifyEmailState = "success" | "expired" | "invalid" | "already-verified" | "error";
+
+export interface BetterAuthVerifyEmailProps {
+  /**
+   * Error code from the callback URL's `?error=` query param. Pass `null` /
+   * `undefined` when the user landed here cleanly (successful verification).
+   * Better Auth appends this param when server-side verification fails.
+   */
+  errorCode?: string | null;
+  /** Called when the user clicks the "Go to sign in" button. */
+  onGoToSignIn?: () => void;
+  /** Fallback href used when `onGoToSignIn` is not provided. Defaults to "/login". */
+  signInHref?: string;
+  /** Optional override for the success headline. */
+  successTitle?: string;
+  /** Optional override for the success body text. */
+  successMessage?: string;
+  /** Optional class name for the root container. */
+  className?: string;
+}
+
+function classifyError(code: string | null | undefined): BetterAuthVerifyEmailState {
+  if (!code) return "success";
+  const normalized = code.toLowerCase();
+
+  // Exact matches for Better Auth's documented verification error codes.
+  if (normalized === "expired_token") return "expired";
+  if (normalized === "invalid_token") return "invalid";
+  if (normalized === "already_verified" || normalized === "email_already_verified") return "already-verified";
+
+  // Loose fallbacks for close variants. Order matters — check "already" before
+  // "verified" so `email_already_verified` maps to already-verified, not invalid.
+  if (normalized.includes("expired")) return "expired";
+  if (normalized.includes("already")) return "already-verified";
+  if (normalized.includes("invalid")) return "invalid";
+  return "error";
+}
+
+const COPY: Record<BetterAuthVerifyEmailState, { title: string; message: string }> = {
+  success: {
+    title: "Email verified",
+    message: "Your email is confirmed. You can now sign in to your account.",
+  },
+  expired: {
+    title: "Link expired",
+    message: "This verification link has expired. Request a new one from the sign-in page.",
+  },
+  invalid: {
+    title: "Invalid link",
+    message: "This verification link is invalid or has already been used. Try signing in or request a new link.",
+  },
+  "already-verified": {
+    title: "Already verified",
+    message: "Your email was already confirmed. You can sign in now.",
+  },
+  error: {
+    title: "Verification failed",
+    message: "We couldn't verify your email. Request a new link from the sign-in page.",
+  },
+};
+
+/**
+ * Standalone email-verification confirmation page. Render on the route you
+ * set as `callbackURL` when calling `betterAuthClient.sendVerificationEmail`
+ * (or the `verifyCallbackURL` arg on `useBetterAuth().signUpWithEmail`).
+ *
+ * Better Auth verifies the token server-side before redirecting here. This
+ * component only displays the outcome based on the `?error=` query param.
+ *
+ * Usage:
+ * ```tsx
+ * const error = new URLSearchParams(window.location.search).get("error");
+ * <BetterAuthVerifyEmail
+ *   errorCode={error}
+ *   onGoToSignIn={() => router.push("/login")}
+ * />
+ * ```
+ */
+export function BetterAuthVerifyEmail({
+  errorCode,
+  onGoToSignIn,
+  signInHref = "/login",
+  successTitle,
+  successMessage,
+  className,
+}: BetterAuthVerifyEmailProps) {
+  const state = classifyError(errorCode);
+  const isSuccess = state === "success" || state === "already-verified";
+  const copy = COPY[state];
+  const title = isSuccess && successTitle ? successTitle : copy.title;
+  const message = isSuccess && successMessage ? successMessage : copy.message;
+
+  debug("Rendering verify-email state", { state, errorCode });
+
+  const handleClick = () => {
+    if (onGoToSignIn) {
+      onGoToSignIn();
+      return;
+    }
+    if (typeof window !== "undefined") {
+      window.location.href = signInHref;
+    }
+  };
+
+  return (
+    <div className={`w-full max-w-[400px] px-6 ${className || ""}`}>
+      <div className="space-y-6 text-center">
+        <div
+          className={`mx-auto flex h-12 w-12 items-center justify-center rounded-full ${
+            isSuccess ? "bg-green-100" : "bg-red-100"
+          }`}
+        >
+          {isSuccess ? (
+            <svg
+              className="h-6 w-6 text-green-600"
+              fill="none"
+              viewBox="0 0 24 24"
+              stroke="currentColor"
+              aria-hidden="true"
+            >
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
+            </svg>
+          ) : (
+            <svg
+              className="h-6 w-6 text-red-600"
+              fill="none"
+              viewBox="0 0 24 24"
+              stroke="currentColor"
+              aria-hidden="true"
+            >
+              <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M6 18L18 6M6 6l12 12" />
+            </svg>
+          )}
+        </div>
+
+        <div>
+          <h1 className="text-[28px] font-semibold tracking-tight text-gray-900 dark:text-gray-100">{title}</h1>
+          <p className="mt-3 text-[15px] text-gray-500 dark:text-gray-400">{message}</p>
+        </div>
+
+        <Button
+          onClick={handleClick}
+          className="h-11 w-full bg-gray-900 text-[15px] font-medium text-white hover:bg-gray-800 dark:bg-white dark:text-gray-900 dark:hover:bg-gray-100"
+        >
+          {isSuccess ? "Go to sign in" : "Back to sign in"}
+        </Button>
+      </div>
+    </div>
+  );
+}

package/src/global-account/react/components/SignInWithB3/SignInWithB3Flow.tsx

@@ -34,6 +34,7 @@ export function SignInWithB3Flow({
   closeAfterLogin = false,
   source = "signInWithB3Button",
   signersEnabled = false,
+  verifyEmailRedirectTo,
 }: SignInWithB3ModalProps) {
   const { automaticallySetFirstEoa, authStrategy } = useB3Config();
   // skipAutoConnect: this component intentionally logs out on mount to show a fresh login screen.
@@ -292,7 +293,13 @@ export function SignInWithB3Flow({
       // Better Auth manages its own loading/verification states internally.
       // Don't gate on isAuthenticating — it would unmount the component
       // and lose verification state when setIsAuthenticating(false) fires.
-      content = <LoginStepBetterAuth onSuccess={() => handleLoginSuccess({} as Account)} onError={onError} />;
+      content = (
+        <LoginStepBetterAuth
+          onSuccess={() => handleLoginSuccess({} as Account)}
+          onError={onError}
+          verifyEmailRedirectTo={verifyEmailRedirectTo}
+        />
+      );
     } else if (!readyToShowLogin || isAuthenticating || isFetchingSigners) {
       content = (
         <LoginStepContainer partnerId={partnerId}>

package/src/global-account/react/components/SignInWithB3/steps/LoginStepBetterAuth.tsx

@@ -23,9 +23,11 @@ const SOCIAL_PROVIDERS: { id: BetterAuthSocialProvider; label: string }[] = [
 interface LoginStepBetterAuthProps {
   onSuccess?: () => void;
   onError?: (error: Error) => Promise<void>;
+  /** URL Better Auth redirects to after server-side email verification. */
+  verifyEmailRedirectTo?: string;
 }
 
-export function LoginStepBetterAuth({ onSuccess, onError }: LoginStepBetterAuthProps) {
+export function LoginStepBetterAuth({ onSuccess, onError, verifyEmailRedirectTo }: LoginStepBetterAuthProps) {
   const { partnerId } = useB3Config();
   const { signInWithEmail, signUpWithEmail, signInWithSocial, requestPasswordReset } = useBetterAuth();
 
@@ -63,7 +65,7 @@ export function LoginStepBetterAuth({ onSuccess, onError }: LoginStepBetterAuthP
 
       if (mode === "sign-up") {
         debug("Signing up", { email: normalizedEmail, name: name.trim() });
-        await signUpWithEmail(normalizedEmail, password, name.trim());
+        await signUpWithEmail(normalizedEmail, password, name.trim(), verifyEmailRedirectTo);
       } else {
         debug("Signing in", { email: normalizedEmail });
         await signInWithEmail(normalizedEmail, password);

package/src/global-account/react/components/index.ts

@@ -12,6 +12,11 @@ export { StyleRoot } from "./StyleRoot";
 // SignInWithB3 Components
 export { BetterAuthResetPassword, type BetterAuthResetPasswordProps } from "./SignInWithB3/BetterAuthResetPassword";
 export { BetterAuthSignIn, type BetterAuthSignInProps } from "./SignInWithB3/BetterAuthSignIn";
+export {
+  BetterAuthVerifyEmail,
+  type BetterAuthVerifyEmailProps,
+  type BetterAuthVerifyEmailState,
+} from "./SignInWithB3/BetterAuthVerifyEmail";
 export { AuthButton } from "./SignInWithB3/components/AuthButton";
 export { PermissionItem } from "./SignInWithB3/components/PermissionItem";
 export { WalletRow } from "./SignInWithB3/components/WalletRow";

package/src/global-account/react/hooks/useBetterAuth.ts

@@ -87,7 +87,7 @@ export function useBetterAuth() {
   );
 
   const signUpWithEmail = useCallback(
-    async (email: string, password: string, name: string) => {
+    async (email: string, password: string, name: string, verifyCallbackURL?: string) => {
       debug("Signing up with email", { email, name });
       setHasStartedConnecting(true);
       setIsAuthenticating(true);
@@ -101,11 +101,12 @@ export function useBetterAuth() {
 
         const token = result.data?.token;
         if (!token) {
-          // requireEmailVerification is enabled — send verification email
-          // with the client's origin as callbackURL so the user returns here
+          // requireEmailVerification is enabled — send verification email with
+          // a callbackURL Better Auth redirects to after server-side verify.
+          // Pass verifyCallbackURL to land on a dedicated confirmation page.
           await betterAuthClient.sendVerificationEmail({
             email,
-            callbackURL: `${window.location.origin}?authStrategy=better-auth`,
+            callbackURL: verifyCallbackURL || `${window.location.origin}?authStrategy=better-auth`,
           });
           throw new EmailVerificationRequiredError();
         }

package/src/global-account/react/stores/useModalStore.ts

@@ -44,6 +44,8 @@ export interface SignInWithB3ModalProps extends BaseModalProps {
   source?: "signInWithB3Button" | "requestPermissions";
   /** Whether to show the signers enabled modal */
   signersEnabled?: boolean;
+  /** URL Better Auth redirects to after server-side email verification. */
+  verifyEmailRedirectTo?: string;
 }
 
 /**