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

package/dist/cjs/global-account/react/components/SignInWithB3/BetterAuthSignIn.d.ts

@@ -10,6 +10,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 */
@@ -31,4 +36,4 @@ export interface BetterAuthSignInProps {
  * />
  * ```
  */
-export declare function BetterAuthSignIn({ title, subtitle, socialProviders, showEmail, passwordResetRedirectTo, onSuccess, onError, className, }: BetterAuthSignInProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function BetterAuthSignIn({ title, subtitle, socialProviders, showEmail, passwordResetRedirectTo, verifyEmailRedirectTo, onSuccess, onError, className, }: BetterAuthSignInProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/cjs/global-account/react/components/SignInWithB3/BetterAuthSignIn.js

@@ -31,7 +31,7 @@ const DEFAULT_SOCIAL_PROVIDERS = [
  * />
  * ```
  */
-function BetterAuthSignIn({ title, subtitle = "Enter your credentials to access your account", socialProviders = DEFAULT_SOCIAL_PROVIDERS.map(p => p.id), showEmail = true, passwordResetRedirectTo, onSuccess, onError, className, }) {
+function BetterAuthSignIn({ title, subtitle = "Enter your credentials to access your account", socialProviders = DEFAULT_SOCIAL_PROVIDERS.map(p => p.id), showEmail = true, passwordResetRedirectTo, verifyEmailRedirectTo, onSuccess, onError, className, }) {
     const { signInWithEmail, signUpWithEmail, signInWithSocial, requestPasswordReset } = (0, useBetterAuth_1.useBetterAuth)();
     const isAuthenticated = (0, react_1.useAuthStore)(state => state.isAuthenticated);
     const isAuthenticating = (0, react_1.useAuthStore)(state => state.isAuthenticating);
@@ -101,7 +101,7 @@ function BetterAuthSignIn({ title, subtitle = "Enter your credentials to access
             setIsLoading(true);
             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/dist/cjs/global-account/react/components/SignInWithB3/BetterAuthVerifyEmail.d.ts

@@ -0,0 +1,37 @@
+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;
+}
+/**
+ * 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 declare function BetterAuthVerifyEmail({ errorCode, onGoToSignIn, signInHref, successTitle, successMessage, className, }: BetterAuthVerifyEmailProps): import("react/jsx-runtime").JSX.Element;

package/dist/cjs/global-account/react/components/SignInWithB3/BetterAuthVerifyEmail.js

@@ -0,0 +1,85 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BetterAuthVerifyEmail = BetterAuthVerifyEmail;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const react_1 = require("../../../../global-account/react");
+const debug_1 = require("../../../../shared/utils/debug");
+const debug = (0, debug_1.debugB3React)("BetterAuthVerifyEmail");
+function classifyError(code) {
+    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 = {
+    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")}
+ * />
+ * ```
+ */
+function BetterAuthVerifyEmail({ errorCode, onGoToSignIn, signInHref = "/login", successTitle, successMessage, className, }) {
+    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 ((0, jsx_runtime_1.jsx)("div", { className: `w-full max-w-[400px] px-6 ${className || ""}`, children: (0, jsx_runtime_1.jsxs)("div", { className: "space-y-6 text-center", children: [(0, jsx_runtime_1.jsx)("div", { className: `mx-auto flex h-12 w-12 items-center justify-center rounded-full ${isSuccess ? "bg-green-100" : "bg-red-100"}`, children: isSuccess ? ((0, jsx_runtime_1.jsx)("svg", { className: "h-6 w-6 text-green-600", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", "aria-hidden": "true", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M5 13l4 4L19 7" }) })) : ((0, jsx_runtime_1.jsx)("svg", { className: "h-6 w-6 text-red-600", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", "aria-hidden": "true", children: (0, jsx_runtime_1.jsx)("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) })) }), (0, jsx_runtime_1.jsxs)("div", { children: [(0, jsx_runtime_1.jsx)("h1", { className: "text-[28px] font-semibold tracking-tight text-gray-900 dark:text-gray-100", children: title }), (0, jsx_runtime_1.jsx)("p", { className: "mt-3 text-[15px] text-gray-500 dark:text-gray-400", children: message })] }), (0, jsx_runtime_1.jsx)(react_1.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", children: isSuccess ? "Go to sign in" : "Back to sign in" })] }) }));
+}

package/dist/cjs/global-account/react/components/SignInWithB3/SignInWithB3Flow.d.ts

@@ -3,4 +3,4 @@ import { SignInWithB3ModalProps } from "../../../../global-account/react";
  * Component that manages the authentication flow for Sign In With B3
  * Handles different login providers, authentication steps, and session key management
  */
-export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, source, signersEnabled, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, source, signersEnabled, verifyEmailRedirectTo, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/cjs/global-account/react/components/SignInWithB3/SignInWithB3Flow.js

@@ -16,7 +16,7 @@ const MAX_REFETCH_ATTEMPTS = 20;
  * Component that manages the authentication flow for Sign In With B3
  * Handles different login providers, authentication steps, and session key management
  */
-function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin = false, source = "signInWithB3Button", signersEnabled = false, }) {
+function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin = false, source = "signInWithB3Button", signersEnabled = false, verifyEmailRedirectTo, }) {
     const { automaticallySetFirstEoa, authStrategy } = (0, react_1.useB3Config)();
     // skipAutoConnect: this component intentionally logs out on mount to show a fresh login screen.
     // AuthenticationProvider is the sole owner of useAutoConnect to avoid competing auth cycles.
@@ -247,7 +247,7 @@ function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onE
             // 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 = (0, jsx_runtime_1.jsx)(LoginStepBetterAuth_1.LoginStepBetterAuth, { onSuccess: () => handleLoginSuccess({}), onError: onError });
+            content = ((0, jsx_runtime_1.jsx)(LoginStepBetterAuth_1.LoginStepBetterAuth, { onSuccess: () => handleLoginSuccess({}), onError: onError, verifyEmailRedirectTo: verifyEmailRedirectTo }));
         }
         else if (!readyToShowLogin || isAuthenticating || isFetchingSigners) {
             content = ((0, jsx_runtime_1.jsx)(LoginStep_1.LoginStepContainer, { partnerId: partnerId, children: (0, jsx_runtime_1.jsx)("div", { className: "my-8 flex min-h-[350px] items-center justify-center", children: (0, jsx_runtime_1.jsx)(react_1.Loading, { variant: "white", size: "lg" }) }) }));

package/dist/cjs/global-account/react/components/SignInWithB3/steps/LoginStepBetterAuth.d.ts

@@ -1,6 +1,8 @@
 interface LoginStepBetterAuthProps {
     onSuccess?: () => void;
     onError?: (error: Error) => Promise<void>;
+    /** URL Better Auth redirects to after server-side email verification. */
+    verifyEmailRedirectTo?: string;
 }
-export declare function LoginStepBetterAuth({ onSuccess, onError }: LoginStepBetterAuthProps): import("react/jsx-runtime").JSX.Element;
+export declare function LoginStepBetterAuth({ onSuccess, onError, verifyEmailRedirectTo }: LoginStepBetterAuthProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/cjs/global-account/react/components/SignInWithB3/steps/LoginStepBetterAuth.js

@@ -17,7 +17,7 @@ const SOCIAL_PROVIDERS = [
     { id: "microsoft", label: "Microsoft" },
     { id: "slack", label: "Slack" },
 ];
-function LoginStepBetterAuth({ onSuccess, onError }) {
+function LoginStepBetterAuth({ onSuccess, onError, verifyEmailRedirectTo }) {
     const { partnerId } = (0, react_1.useB3Config)();
     const { signInWithEmail, signUpWithEmail, signInWithSocial, requestPasswordReset } = (0, useBetterAuth_1.useBetterAuth)();
     const [mode, setMode] = (0, react_2.useState)("sign-in");
@@ -48,7 +48,7 @@ function LoginStepBetterAuth({ onSuccess, onError }) {
             setError(null);
             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 });

package/dist/cjs/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/cjs/global-account/react/components/index.js

@@ -3,9 +3,9 @@ var __importDefault = (this && this.__importDefault) || function (mod) {
     return (mod && mod.__esModule) ? mod : { "default": mod };
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.DialogClose = exports.Dialog = exports.CommandShortcut = exports.CommandSeparator = exports.CommandList = exports.CommandItem = exports.CommandInput = exports.CommandGroup = exports.CommandEmpty = exports.CommandDialog = exports.Command = exports.buttonVariants = exports.Button = exports.badgeVariants = exports.Badge = exports.WalletConnectorIcon = exports.StaggeredFadeLoader = exports.CopyToClipboard = exports.ClientOnly = exports.customButtonVariants = exports.CustomButton = exports.SingleUserSearchSelector = exports.SendERC20Button = exports.SendETHButton = exports.MintButton = exports.AccountAssets = exports.RequestPermissionsButton = exports.RequestPermissions = exports.IPFSMediaRenderer = exports.Send = exports.Deposit = exports.ManageAccount = exports.isWalletType = exports.getConnectOptionsFromStrategy = exports.LoginStepContainer = exports.SignInWithB3Privy = exports.SignInWithB3Flow = exports.SignInWithB3 = exports.WalletRow = exports.PermissionItem = exports.AuthButton = exports.BetterAuthSignIn = exports.BetterAuthResetPassword = exports.StyleRoot = exports.useB3Config = exports.useB3Account = exports.useB3 = exports.RelayKitProviderWrapper = exports.B3Provider = exports.B3DynamicModal = void 0;
-exports.TransitionPanel = exports.TooltipTrigger = exports.TooltipProvider = exports.TooltipContent = exports.Tooltip = exports.TextShimmer = exports.TextLoop = exports.TabTrigger = exports.TabsTransitionWrapper = exports.TabsList = exports.TabsContent = exports.Tabs = exports.TabTriggerPrimitive = exports.TabsPrimitive = exports.TabsListPrimitive = exports.TabsContentPrimitive = exports.Skeleton = exports.ShinyButton = exports.ScrollBar = exports.ScrollArea = exports.PopoverTrigger = exports.PopoverContent = exports.Popover = exports.Loading = exports.Input = exports.GlareCardRounded = exports.GlareCard = exports.DropdownMenuTrigger = exports.DropdownMenuSeparator = exports.DropdownMenuItem = exports.DropdownMenuContent = exports.DropdownMenu = exports.DrawerTrigger = exports.DrawerTitle = exports.DrawerPortal = exports.DrawerOverlay = exports.DrawerHeader = exports.DrawerFooter = exports.DrawerDescription = exports.DrawerContent = exports.DrawerClose = exports.Drawer = exports.DialogTrigger = exports.DialogTitle = exports.DialogPortal = exports.DialogOverlay = exports.DialogHeader = exports.DialogFooter = exports.DialogDescription = exports.DialogContent = void 0;
-exports.WalletImage = exports.useToastContext = exports.ToastProvider = exports.ToastContainer = exports.Toast = exports.toast = exports.AnimatedLottie = void 0;
+exports.Dialog = exports.CommandShortcut = exports.CommandSeparator = exports.CommandList = exports.CommandItem = exports.CommandInput = exports.CommandGroup = exports.CommandEmpty = exports.CommandDialog = exports.Command = exports.buttonVariants = exports.Button = exports.badgeVariants = exports.Badge = exports.WalletConnectorIcon = exports.StaggeredFadeLoader = exports.CopyToClipboard = exports.ClientOnly = exports.customButtonVariants = exports.CustomButton = exports.SingleUserSearchSelector = exports.SendERC20Button = exports.SendETHButton = exports.MintButton = exports.AccountAssets = exports.RequestPermissionsButton = exports.RequestPermissions = exports.IPFSMediaRenderer = exports.Send = exports.Deposit = exports.ManageAccount = exports.isWalletType = exports.getConnectOptionsFromStrategy = exports.LoginStepContainer = exports.SignInWithB3Privy = exports.SignInWithB3Flow = exports.SignInWithB3 = exports.WalletRow = exports.PermissionItem = exports.AuthButton = exports.BetterAuthVerifyEmail = exports.BetterAuthSignIn = exports.BetterAuthResetPassword = exports.StyleRoot = exports.useB3Config = exports.useB3Account = exports.useB3 = exports.RelayKitProviderWrapper = exports.B3Provider = exports.B3DynamicModal = void 0;
+exports.TooltipTrigger = exports.TooltipProvider = exports.TooltipContent = exports.Tooltip = exports.TextShimmer = exports.TextLoop = exports.TabTrigger = exports.TabsTransitionWrapper = exports.TabsList = exports.TabsContent = exports.Tabs = exports.TabTriggerPrimitive = exports.TabsPrimitive = exports.TabsListPrimitive = exports.TabsContentPrimitive = exports.Skeleton = exports.ShinyButton = exports.ScrollBar = exports.ScrollArea = exports.PopoverTrigger = exports.PopoverContent = exports.Popover = exports.Loading = exports.Input = exports.GlareCardRounded = exports.GlareCard = exports.DropdownMenuTrigger = exports.DropdownMenuSeparator = exports.DropdownMenuItem = exports.DropdownMenuContent = exports.DropdownMenu = exports.DrawerTrigger = exports.DrawerTitle = exports.DrawerPortal = exports.DrawerOverlay = exports.DrawerHeader = exports.DrawerFooter = exports.DrawerDescription = exports.DrawerContent = exports.DrawerClose = exports.Drawer = exports.DialogTrigger = exports.DialogTitle = exports.DialogPortal = exports.DialogOverlay = exports.DialogHeader = exports.DialogFooter = exports.DialogDescription = exports.DialogContent = exports.DialogClose = void 0;
+exports.WalletImage = exports.useToastContext = exports.ToastProvider = exports.ToastContainer = exports.Toast = exports.toast = exports.AnimatedLottie = exports.TransitionPanel = void 0;
 // TODO woj: Barrel file for all components, this might be reason of bundle size issues
 // Core Components
 var B3DynamicModal_1 = require("./B3DynamicModal");
@@ -27,6 +27,8 @@ var BetterAuthResetPassword_1 = require("./SignInWithB3/BetterAuthResetPassword"
 Object.defineProperty(exports, "BetterAuthResetPassword", { enumerable: true, get: function () { return BetterAuthResetPassword_1.BetterAuthResetPassword; } });
 var BetterAuthSignIn_1 = require("./SignInWithB3/BetterAuthSignIn");
 Object.defineProperty(exports, "BetterAuthSignIn", { enumerable: true, get: function () { return BetterAuthSignIn_1.BetterAuthSignIn; } });
+var BetterAuthVerifyEmail_1 = require("./SignInWithB3/BetterAuthVerifyEmail");
+Object.defineProperty(exports, "BetterAuthVerifyEmail", { enumerable: true, get: function () { return BetterAuthVerifyEmail_1.BetterAuthVerifyEmail; } });
 var AuthButton_1 = require("./SignInWithB3/components/AuthButton");
 Object.defineProperty(exports, "AuthButton", { enumerable: true, get: function () { return AuthButton_1.AuthButton; } });
 var PermissionItem_1 = require("./SignInWithB3/components/PermissionItem");

package/dist/cjs/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/cjs/global-account/react/hooks/useBetterAuth.js

@@ -73,7 +73,7 @@ function useBetterAuth() {
             throw error;
         }
     }, [exchangeForFeathersJWT, setIsAuthenticating, setHasStartedConnecting]);
-    const signUpWithEmail = (0, react_2.useCallback)(async (email, password, name) => {
+    const signUpWithEmail = (0, react_2.useCallback)(async (email, password, name, verifyCallbackURL) => {
         debug("Signing up with email", { email, name });
         setHasStartedConnecting(true);
         setIsAuthenticating(true);
@@ -84,11 +84,12 @@ 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 better_auth_client_1.betterAuthClient.sendVerificationEmail({
                     email,
-                    callbackURL: `${window.location.origin}?authStrategy=better-auth`,
+                    callbackURL: verifyCallbackURL || `${window.location.origin}?authStrategy=better-auth`,
                 });
                 throw new EmailVerificationRequiredError();
             }

package/dist/cjs/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/dist/esm/global-account/react/components/SignInWithB3/BetterAuthSignIn.d.ts

@@ -10,6 +10,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 */
@@ -31,4 +36,4 @@ export interface BetterAuthSignInProps {
  * />
  * ```
  */
-export declare function BetterAuthSignIn({ title, subtitle, socialProviders, showEmail, passwordResetRedirectTo, onSuccess, onError, className, }: BetterAuthSignInProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function BetterAuthSignIn({ title, subtitle, socialProviders, showEmail, passwordResetRedirectTo, verifyEmailRedirectTo, onSuccess, onError, className, }: BetterAuthSignInProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/esm/global-account/react/components/SignInWithB3/BetterAuthSignIn.js

@@ -28,7 +28,7 @@ const DEFAULT_SOCIAL_PROVIDERS = [
  * />
  * ```
  */
-export function BetterAuthSignIn({ title, subtitle = "Enter your credentials to access your account", socialProviders = DEFAULT_SOCIAL_PROVIDERS.map(p => p.id), showEmail = true, passwordResetRedirectTo, onSuccess, onError, className, }) {
+export function BetterAuthSignIn({ title, subtitle = "Enter your credentials to access your account", socialProviders = DEFAULT_SOCIAL_PROVIDERS.map(p => p.id), showEmail = true, passwordResetRedirectTo, verifyEmailRedirectTo, onSuccess, onError, className, }) {
     const { signInWithEmail, signUpWithEmail, signInWithSocial, requestPasswordReset } = useBetterAuth();
     const isAuthenticated = useAuthStore(state => state.isAuthenticated);
     const isAuthenticating = useAuthStore(state => state.isAuthenticating);
@@ -98,7 +98,7 @@ export function BetterAuthSignIn({ title, subtitle = "Enter your credentials to
             setIsLoading(true);
             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/dist/esm/global-account/react/components/SignInWithB3/BetterAuthVerifyEmail.d.ts

@@ -0,0 +1,37 @@
+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;
+}
+/**
+ * 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 declare function BetterAuthVerifyEmail({ errorCode, onGoToSignIn, signInHref, successTitle, successMessage, className, }: BetterAuthVerifyEmailProps): import("react/jsx-runtime").JSX.Element;

package/dist/esm/global-account/react/components/SignInWithB3/BetterAuthVerifyEmail.js

@@ -0,0 +1,82 @@
+import { jsx as _jsx, jsxs as _jsxs } from "react/jsx-runtime";
+import { Button } from "../../../../global-account/react/index.js";
+import { debugB3React } from "../../../../shared/utils/debug.js";
+const debug = debugB3React("BetterAuthVerifyEmail");
+function classifyError(code) {
+    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 = {
+    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, }) {
+    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 (_jsx("div", { className: `w-full max-w-[400px] px-6 ${className || ""}`, children: _jsxs("div", { className: "space-y-6 text-center", children: [_jsx("div", { className: `mx-auto flex h-12 w-12 items-center justify-center rounded-full ${isSuccess ? "bg-green-100" : "bg-red-100"}`, children: isSuccess ? (_jsx("svg", { className: "h-6 w-6 text-green-600", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M5 13l4 4L19 7" }) })) : (_jsx("svg", { className: "h-6 w-6 text-red-600", fill: "none", viewBox: "0 0 24 24", stroke: "currentColor", "aria-hidden": "true", children: _jsx("path", { strokeLinecap: "round", strokeLinejoin: "round", strokeWidth: 2, d: "M6 18L18 6M6 6l12 12" }) })) }), _jsxs("div", { children: [_jsx("h1", { className: "text-[28px] font-semibold tracking-tight text-gray-900 dark:text-gray-100", children: title }), _jsx("p", { className: "mt-3 text-[15px] text-gray-500 dark:text-gray-400", children: message })] }), _jsx(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", children: isSuccess ? "Go to sign in" : "Back to sign in" })] }) }));
+}

package/dist/esm/global-account/react/components/SignInWithB3/SignInWithB3Flow.d.ts

@@ -3,4 +3,4 @@ import { SignInWithB3ModalProps } from "../../../../global-account/react";
  * Component that manages the authentication flow for Sign In With B3
  * Handles different login providers, authentication steps, and session key management
  */
-export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, source, signersEnabled, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;
+export declare function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin, source, signersEnabled, verifyEmailRedirectTo, }: SignInWithB3ModalProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/esm/global-account/react/components/SignInWithB3/SignInWithB3Flow.js

@@ -13,7 +13,7 @@ const MAX_REFETCH_ATTEMPTS = 20;
  * Component that manages the authentication flow for Sign In With B3
  * Handles different login providers, authentication steps, and session key management
  */
-export function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin = false, source = "signInWithB3Button", signersEnabled = false, }) {
+export function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySuccess, onError, chain, sessionKeyAddress, partnerId, closeAfterLogin = false, source = "signInWithB3Button", signersEnabled = false, verifyEmailRedirectTo, }) {
     const { automaticallySetFirstEoa, authStrategy } = useB3Config();
     // skipAutoConnect: this component intentionally logs out on mount to show a fresh login screen.
     // AuthenticationProvider is the sole owner of useAutoConnect to avoid competing auth cycles.
@@ -244,7 +244,7 @@ export function SignInWithB3Flow({ strategies, onLoginSuccess, onSessionKeySucce
             // 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 = _jsx(LoginStepBetterAuth, { onSuccess: () => handleLoginSuccess({}), onError: onError });
+            content = (_jsx(LoginStepBetterAuth, { onSuccess: () => handleLoginSuccess({}), onError: onError, verifyEmailRedirectTo: verifyEmailRedirectTo }));
         }
         else if (!readyToShowLogin || isAuthenticating || isFetchingSigners) {
             content = (_jsx(LoginStepContainer, { partnerId: partnerId, children: _jsx("div", { className: "my-8 flex min-h-[350px] items-center justify-center", children: _jsx(Loading, { variant: "white", size: "lg" }) }) }));

package/dist/esm/global-account/react/components/SignInWithB3/steps/LoginStepBetterAuth.d.ts

@@ -1,6 +1,8 @@
 interface LoginStepBetterAuthProps {
     onSuccess?: () => void;
     onError?: (error: Error) => Promise<void>;
+    /** URL Better Auth redirects to after server-side email verification. */
+    verifyEmailRedirectTo?: string;
 }
-export declare function LoginStepBetterAuth({ onSuccess, onError }: LoginStepBetterAuthProps): import("react/jsx-runtime").JSX.Element;
+export declare function LoginStepBetterAuth({ onSuccess, onError, verifyEmailRedirectTo }: LoginStepBetterAuthProps): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/esm/global-account/react/components/SignInWithB3/steps/LoginStepBetterAuth.js

@@ -14,7 +14,7 @@ const SOCIAL_PROVIDERS = [
     { id: "microsoft", label: "Microsoft" },
     { id: "slack", label: "Slack" },
 ];
-export function LoginStepBetterAuth({ onSuccess, onError }) {
+export function LoginStepBetterAuth({ onSuccess, onError, verifyEmailRedirectTo }) {
     const { partnerId } = useB3Config();
     const { signInWithEmail, signUpWithEmail, signInWithSocial, requestPasswordReset } = useBetterAuth();
     const [mode, setMode] = useState("sign-in");
@@ -45,7 +45,7 @@ export function LoginStepBetterAuth({ onSuccess, onError }) {
             setError(null);
             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 });

package/dist/esm/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/esm/global-account/react/components/index.js

@@ -10,6 +10,7 @@ export { StyleRoot } from "./StyleRoot.js";
 // SignInWithB3 Components
 export { BetterAuthResetPassword } from "./SignInWithB3/BetterAuthResetPassword.js";
 export { BetterAuthSignIn } from "./SignInWithB3/BetterAuthSignIn.js";
+export { BetterAuthVerifyEmail, } from "./SignInWithB3/BetterAuthVerifyEmail.js";
 export { AuthButton } from "./SignInWithB3/components/AuthButton.js";
 export { PermissionItem } from "./SignInWithB3/components/PermissionItem.js";
 export { WalletRow } from "./SignInWithB3/components/WalletRow.js";

package/dist/esm/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/esm/global-account/react/hooks/useBetterAuth.js

@@ -65,7 +65,7 @@ export function useBetterAuth() {
             throw error;
         }
     }, [exchangeForFeathersJWT, setIsAuthenticating, setHasStartedConnecting]);
-    const signUpWithEmail = useCallback(async (email, password, name) => {
+    const signUpWithEmail = useCallback(async (email, password, name, verifyCallbackURL) => {
         debug("Signing up with email", { email, name });
         setHasStartedConnecting(true);
         setIsAuthenticating(true);
@@ -76,11 +76,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/dist/esm/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