@b3dotfun/sdk 0.1.69 → 0.1.70-alpha.1

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

@@ -0,0 +1,446 @@
+import { Button, Input, Loading, useAuthStore } from "@b3dotfun/sdk/global-account/react";
+import { debugB3React } from "@b3dotfun/sdk/shared/utils/debug";
+import { useState } from "react";
+import {
+  EmailVerificationRequiredError,
+  type BetterAuthSocialProvider,
+  useBetterAuth,
+} from "../../hooks/useBetterAuth";
+import { PasswordInput } from "./components/PasswordInput";
+import { strategyIcons, strategyLabels } from "./utils/signInUtils";
+
+const debug = debugB3React("BetterAuthSignIn");
+const EMAIL_REGEX = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+
+type SocialProviderConfig = { id: BetterAuthSocialProvider; label: string };
+
+const DEFAULT_SOCIAL_PROVIDERS: SocialProviderConfig[] = [
+  { id: "google", label: "Google" },
+  { id: "github", label: "GitHub" },
+  { id: "discord", label: "Discord" },
+  { id: "microsoft", label: "Microsoft" },
+  { id: "slack", label: "Slack" },
+];
+
+export interface BetterAuthSignInProps {
+  /** Title displayed above the form. Default: "Welcome back" for sign-in, "Create an account" for sign-up */
+  title?: string;
+  /** Subtitle displayed below the title */
+  subtitle?: string;
+  /** Which social providers to show. Defaults to all. Pass empty array to hide. */
+  socialProviders?: BetterAuthSocialProvider[];
+  /** Show email/password form. Default: true */
+  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 */
+  onError?: (error: Error) => void;
+  /** Optional class name for the root container */
+  className?: string;
+}
+
+/**
+ * Standalone inline sign-in component for Better Auth.
+ *
+ * Renders directly — no modal, no button wrapper. Designed for full-page
+ * sign-in layouts (e.g., B3OS web with branding on the left, form on the right).
+ *
+ * Usage:
+ * ```tsx
+ * <BetterAuthSignIn
+ *   socialProviders={["google", "github"]}
+ *   onSuccess={() => router.push("/dashboard")}
+ * />
+ * ```
+ */
+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,
+}: BetterAuthSignInProps) {
+  const { signInWithEmail, signUpWithEmail, signInWithSocial, requestPasswordReset } = useBetterAuth();
+  const isAuthenticated = useAuthStore(state => state.isAuthenticated);
+  const isAuthenticating = useAuthStore(state => state.isAuthenticating);
+  const hasStartedConnecting = useAuthStore(state => state.hasStartedConnecting);
+
+  const [mode, setMode] = useState<"sign-in" | "sign-up" | "forgot-password">("sign-in");
+  const [email, setEmail] = useState("");
+  const [password, setPassword] = useState("");
+  const [name, setName] = useState("");
+  const [isLoading, setIsLoading] = useState(false);
+  const [loadingProvider, setLoadingProvider] = useState<string | null>(null);
+  const [error, setError] = useState<string | null>(null);
+  const [resetEmailSent, setResetEmailSent] = useState(false);
+  const [verificationSent, setVerificationSent] = useState(false);
+
+  const resolvedTitle =
+    title ||
+    (mode === "forgot-password" ? "Reset password" : mode === "sign-in" ? "Welcome back" : "Create an account");
+
+  const resolvedSubtitle =
+    mode === "forgot-password"
+      ? resetEmailSent
+        ? "We've sent a password reset link to your email"
+        : "Enter your email and we'll send you a reset link"
+      : subtitle || "Enter your credentials to access your account";
+
+  const handleForgotPassword = async () => {
+    const normalizedEmail = email.trim().toLowerCase();
+
+    if (!EMAIL_REGEX.test(normalizedEmail)) {
+      setError("Please enter a valid email address");
+      return;
+    }
+
+    try {
+      setIsLoading(true);
+      setError(null);
+      await requestPasswordReset(normalizedEmail, passwordResetRedirectTo);
+      setResetEmailSent(true);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : "Failed to send reset email";
+      setError(message);
+    } finally {
+      setIsLoading(false);
+    }
+  };
+
+  const providers: SocialProviderConfig[] = socialProviders
+    .map(id => DEFAULT_SOCIAL_PROVIDERS.find(p => p.id === id))
+    .filter((p): p is SocialProviderConfig => !!p);
+
+  // Show loading during session restore (before any user interaction) to prevent
+  // the login form from flashing briefly after OAuth redirect.
+  if (isAuthenticating && !hasStartedConnecting) {
+    return (
+      <div className={`flex w-full max-w-[400px] items-center justify-center px-6 py-20 ${className || ""}`}>
+        <Loading variant="primary" size="lg" />
+      </div>
+    );
+  }
+
+  if (isAuthenticated) {
+    return null;
+  }
+
+  const handleEmailSubmit = async () => {
+    const normalizedEmail = email.trim().toLowerCase();
+
+    if (!EMAIL_REGEX.test(normalizedEmail)) {
+      setError("Please enter a valid email address");
+      return;
+    }
+
+    if (!password) {
+      setError("Please enter a password");
+      return;
+    }
+
+    if (mode === "sign-up" && !name.trim()) {
+      setError("Please enter your name");
+      return;
+    }
+
+    try {
+      setIsLoading(true);
+      setError(null);
+
+      if (mode === "sign-up") {
+        await signUpWithEmail(normalizedEmail, password, name.trim(), verifyEmailRedirectTo);
+      } else {
+        await signInWithEmail(normalizedEmail, password);
+      }
+
+      debug("Auth successful");
+      onSuccess?.();
+    } catch (err) {
+      if (err instanceof EmailVerificationRequiredError) {
+        setVerificationSent(true);
+        setError(null);
+      } else {
+        const message = err instanceof Error ? err.message : "Authentication failed";
+        setError(message);
+        onError?.(err as Error);
+      }
+      debug("Auth failed", err);
+    } finally {
+      setPassword("");
+      setIsLoading(false);
+    }
+  };
+
+  const handleSocialSignIn = async (provider: BetterAuthSocialProvider) => {
+    try {
+      setIsLoading(true);
+      setLoadingProvider(provider);
+      setError(null);
+      await signInWithSocial(provider);
+    } catch (err) {
+      const message = err instanceof Error ? err.message : `Sign in failed`;
+      setError(message);
+      onError?.(err as Error);
+      setIsLoading(false);
+      setLoadingProvider(null);
+    }
+  };
+
+  if (verificationSent) {
+    return (
+      <div className={`w-full max-w-[400px] px-6 ${className || ""}`}>
+        <div className="flex flex-col items-center gap-6 text-center">
+          <div className="flex h-14 w-14 shrink-0 items-center justify-center rounded-full bg-green-100">
+            <svg
+              className="h-7 w-7 shrink-0 text-green-600"
+              fill="none"
+              viewBox="0 0 24 24"
+              stroke="currentColor"
+              width={28}
+              height={28}
+            >
+              <path
+                strokeLinecap="round"
+                strokeLinejoin="round"
+                strokeWidth={2}
+                d="M3 8l7.89 5.26a2 2 0 002.22 0L21 8M5 19h14a2 2 0 002-2V7a2 2 0 00-2-2H5a2 2 0 00-2 2v10a2 2 0 002 2z"
+              />
+            </svg>
+          </div>
+          <h2 className="text-[22px] font-semibold text-gray-900 dark:text-gray-100">Check your email</h2>
+          <p className="text-[15px] text-gray-500 dark:text-gray-400">
+            We sent a verification link to <span className="font-medium text-gray-700 dark:text-gray-200">{email}</span>
+            . Click the link to verify your account, then come back and sign in.
+          </p>
+          <button
+            onClick={() => {
+              setVerificationSent(false);
+              setMode("sign-in");
+              setPassword("");
+            }}
+            className="text-[14px] font-medium text-blue-600 hover:text-blue-500 dark:text-blue-400"
+          >
+            Back to sign in
+          </button>
+        </div>
+      </div>
+    );
+  }
+
+  return (
+    <div className={`w-full max-w-[400px] px-6 ${className || ""}`}>
+      {/* Header */}
+      <div className="mb-10 text-center">
+        <h1 className="text-[28px] font-semibold tracking-tight text-gray-900 dark:text-gray-100">{resolvedTitle}</h1>
+        <p className="mt-3 text-[15px] text-gray-500 dark:text-gray-400">{resolvedSubtitle}</p>
+      </div>
+
+      {/* Forgot password view */}
+      {mode === "forgot-password" && (
+        <div className="space-y-5">
+          {resetEmailSent ? (
+            <div className="space-y-4 text-center">
+              <div className="mx-auto flex h-12 w-12 items-center justify-center rounded-full bg-green-100">
+                <svg className="h-6 w-6 text-green-600" fill="none" viewBox="0 0 24 24" stroke="currentColor">
+                  <path strokeLinecap="round" strokeLinejoin="round" strokeWidth={2} d="M5 13l4 4L19 7" />
+                </svg>
+              </div>
+              <p className="text-[15px] text-gray-600 dark:text-gray-300">Check your email for a reset link.</p>
+            </div>
+          ) : (
+            <>
+              <div>
+                <label className="mb-2 block text-xs font-medium uppercase tracking-wide text-gray-700 dark:text-gray-300">
+                  Email
+                </label>
+                <Input
+                  type="email"
+                  placeholder="name@company.com"
+                  value={email}
+                  onChange={e => setEmail(e.target.value)}
+                  disabled={isLoading}
+                  onKeyDown={e => {
+                    if (e.key === "Enter") handleForgotPassword();
+                  }}
+                  className="h-11 px-4 text-[15px]"
+                />
+              </div>
+
+              {error && <p className="text-sm text-red-500">{error}</p>}
+
+              <Button
+                onClick={handleForgotPassword}
+                disabled={isLoading}
+                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"
+              >
+                {isLoading ? "Sending..." : "Send reset link"}
+              </Button>
+            </>
+          )}
+
+          <p className="mt-8 text-center text-[14px] text-gray-500 dark:text-gray-400">
+            <button
+              onClick={() => {
+                setMode("sign-in");
+                setError(null);
+                setResetEmailSent(false);
+              }}
+              className="font-medium text-blue-600 hover:text-blue-500 dark:text-blue-400"
+            >
+              Back to sign in
+            </button>
+          </p>
+        </div>
+      )}
+
+      {/* Email/Password form */}
+      {showEmail && mode !== "forgot-password" && (
+        <div className="space-y-5">
+          {mode === "sign-up" && (
+            <div>
+              <label className="mb-2 block text-xs font-medium uppercase tracking-wide text-gray-700 dark:text-gray-300">
+                Name
+              </label>
+              <Input
+                type="text"
+                placeholder="Your name"
+                value={name}
+                onChange={e => setName(e.target.value)}
+                disabled={isLoading}
+                className="h-11 px-4 text-[15px]"
+              />
+            </div>
+          )}
+
+          <div>
+            <label className="mb-2 block text-xs font-medium uppercase tracking-wide text-gray-700 dark:text-gray-300">
+              Email
+            </label>
+            <Input
+              type="email"
+              placeholder="name@company.com"
+              value={email}
+              onChange={e => setEmail(e.target.value)}
+              disabled={isLoading}
+              className="h-11 px-4 text-[15px]"
+            />
+          </div>
+
+          <div>
+            <div className="mb-2 flex items-center justify-between">
+              <label className="block text-xs font-medium uppercase tracking-wide text-gray-700 dark:text-gray-300">
+                Password
+              </label>
+              {mode === "sign-in" && (
+                <button
+                  type="button"
+                  onClick={() => {
+                    setMode("forgot-password");
+                    setError(null);
+                  }}
+                  className="text-xs font-medium text-blue-600 hover:text-blue-500 dark:text-blue-400"
+                >
+                  Forgot password?
+                </button>
+              )}
+            </div>
+            <PasswordInput
+              key={mode}
+              value={password}
+              onChange={e => setPassword(e.target.value)}
+              disabled={isLoading}
+              onKeyDown={e => {
+                if (e.key === "Enter") handleEmailSubmit();
+              }}
+              className="h-11 px-4 pr-11 text-[15px]"
+            />
+          </div>
+
+          {error && <p className="text-sm text-red-500">{error}</p>}
+
+          <Button
+            onClick={handleEmailSubmit}
+            disabled={isLoading}
+            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"
+          >
+            {isLoading ? "Loading..." : mode === "sign-in" ? "Sign in" : "Sign up"}
+          </Button>
+        </div>
+      )}
+
+      {/* Social providers */}
+      {providers.length > 0 && mode !== "forgot-password" && (
+        <>
+          {showEmail && (
+            <div className="my-8 flex items-center gap-4">
+              <div className="h-px flex-1 bg-gray-200 dark:bg-gray-700" />
+              <span className="text-xs text-gray-400">Or continue with</span>
+              <div className="h-px flex-1 bg-gray-200 dark:bg-gray-700" />
+            </div>
+          )}
+
+          <div className="space-y-4">
+            {providers.map(provider => {
+              const icon = strategyIcons[provider.id];
+              const label = strategyLabels[provider.id] || provider.label;
+
+              const isProviderLoading = loadingProvider === provider.id;
+
+              return (
+                <button
+                  key={provider.id}
+                  onClick={() => handleSocialSignIn(provider.id)}
+                  disabled={isLoading}
+                  style={{ paddingTop: "12px", paddingBottom: "12px" }}
+                  className="flex w-full items-center justify-center gap-3 rounded-lg border border-gray-200 bg-white px-4 text-[14px] font-medium text-gray-700 transition-colors hover:bg-gray-50 disabled:opacity-50 dark:border-gray-700 dark:bg-gray-800 dark:text-gray-200 dark:hover:bg-gray-700"
+                >
+                  {isProviderLoading ? (
+                    <svg className="h-5 w-5 animate-spin text-gray-400" viewBox="0 0 24 24" fill="none">
+                      <circle className="opacity-25" cx="12" cy="12" r="10" stroke="currentColor" strokeWidth="4" />
+                      <path
+                        className="opacity-75"
+                        fill="currentColor"
+                        d="M4 12a8 8 0 018-8V0C5.373 0 0 5.373 0 12h4z"
+                      />
+                    </svg>
+                  ) : (
+                    icon && <img src={icon} alt="" className="h-5 w-5" />
+                  )}
+                  <span>{isProviderLoading ? "Redirecting..." : label}</span>
+                </button>
+              );
+            })}
+          </div>
+        </>
+      )}
+
+      {/* Toggle sign-in / sign-up */}
+      {showEmail && mode !== "forgot-password" && (
+        <p className="mt-8 text-center text-[14px] text-gray-500 dark:text-gray-400">
+          {mode === "sign-in" ? "Don't have an account? " : "Already have an account? "}
+          <button
+            onClick={() => {
+              setMode(mode === "sign-in" ? "sign-up" : "sign-in");
+              setError(null);
+            }}
+            disabled={isLoading}
+            className="font-medium text-blue-600 hover:text-blue-500 dark:text-blue-400"
+          >
+            {mode === "sign-in" ? "Sign up" : "Sign in"}
+          </button>
+        </p>
+      )}
+    </div>
+  );
+}

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>
+  );
+}