better-auth-ui 3.2.5

package/src/localization/base-error-codes.ts

@@ -0,0 +1,27 @@
+export const BASE_ERROR_CODES = {
+    USER_NOT_FOUND: "User not found",
+    FAILED_TO_CREATE_USER: "Failed to create user",
+    FAILED_TO_CREATE_SESSION: "Failed to create session",
+    FAILED_TO_UPDATE_USER: "Failed to update user",
+    FAILED_TO_GET_SESSION: "Failed to get session",
+    INVALID_PASSWORD: "Invalid password",
+    INVALID_EMAIL: "Invalid email",
+    INVALID_EMAIL_OR_PASSWORD: "Invalid email or password",
+    SOCIAL_ACCOUNT_ALREADY_LINKED: "Social account already linked",
+    PROVIDER_NOT_FOUND: "Provider not found",
+    INVALID_TOKEN: "Invalid token",
+    ID_TOKEN_NOT_SUPPORTED: "id_token not supported",
+    FAILED_TO_GET_USER_INFO: "Failed to get user info",
+    USER_EMAIL_NOT_FOUND: "User email not found",
+    EMAIL_NOT_VERIFIED: "Email not verified",
+    PASSWORD_TOO_SHORT: "Password too short",
+    PASSWORD_TOO_LONG: "Password too long",
+    USER_ALREADY_EXISTS: "User already exists",
+    EMAIL_CAN_NOT_BE_UPDATED: "Email can not be updated",
+    CREDENTIAL_ACCOUNT_NOT_FOUND: "Credential account not found",
+    SESSION_EXPIRED: "Session expired. Re-authenticate to perform this action.",
+    FAILED_TO_UNLINK_LAST_ACCOUNT: "You can't unlink your last account",
+    ACCOUNT_NOT_FOUND: "Account not found",
+    USER_ALREADY_HAS_PASSWORD:
+        "User already has a password. Provide that to delete the account."
+}

package/src/localization/captcha-error-codes.ts

@@ -0,0 +1,17 @@
+// These error codes are returned by the API
+const EXTERNAL_ERROR_CODES = {
+    VERIFICATION_FAILED: "Captcha verification failed",
+    MISSING_RESPONSE: "Missing CAPTCHA response",
+    UNKNOWN_ERROR: "Something went wrong"
+}
+
+// These error codes are only visible in the server logs
+const INTERNAL_ERROR_CODES = {
+    MISSING_SECRET_KEY: "Missing secret key",
+    SERVICE_UNAVAILABLE: "CAPTCHA service unavailable"
+}
+
+export const CAPTCHA_ERROR_CODES = {
+    ...EXTERNAL_ERROR_CODES,
+    ...INTERNAL_ERROR_CODES
+}

package/src/localization/email-otp-error-codes.ts

@@ -0,0 +1,7 @@
+export const EMAIL_OTP_ERROR_CODES = {
+    OTP_EXPIRED: "otp expired",
+    INVALID_OTP: "Invalid OTP",
+    INVALID_EMAIL: "Invalid email",
+    USER_NOT_FOUND: "User not found",
+    TOO_MANY_ATTEMPTS: "Too many attempts"
+}

package/src/localization/generic-oauth-error-codes.ts

@@ -0,0 +1,3 @@
+export const GENERIC_OAUTH_ERROR_CODES = {
+    INVALID_OAUTH_CONFIGURATION: "Invalid OAuth configuration"
+}

package/src/localization/haveibeenpwned-error-codes.ts

@@ -0,0 +1,4 @@
+export const HAVEIBEENPWNED_ERROR_CODES = {
+    PASSWORD_COMPROMISED:
+        "The password you entered has been compromised. Please choose a different password."
+}

package/src/localization/multi-session-error-codes.ts

@@ -0,0 +1,3 @@
+export const MULTI_SESSION_ERROR_CODES = {
+    INVALID_SESSION_TOKEN: "Invalid session token"
+}

package/src/localization/organization-error-codes.ts

@@ -0,0 +1,57 @@
+export const ORGANIZATION_ERROR_CODES = {
+    YOU_ARE_NOT_ALLOWED_TO_CREATE_A_NEW_ORGANIZATION:
+        "You are not allowed to create a new organization",
+    YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_ORGANIZATIONS:
+        "You have reached the maximum number of organizations",
+    ORGANIZATION_ALREADY_EXISTS: "Organization already exists",
+    ORGANIZATION_NOT_FOUND: "Organization not found",
+    USER_IS_NOT_A_MEMBER_OF_THE_ORGANIZATION:
+        "User is not a member of the organization",
+    YOU_ARE_NOT_ALLOWED_TO_UPDATE_THIS_ORGANIZATION:
+        "You are not allowed to update this organization",
+    YOU_ARE_NOT_ALLOWED_TO_DELETE_THIS_ORGANIZATION:
+        "You are not allowed to delete this organization",
+    NO_ACTIVE_ORGANIZATION: "No active organization",
+    USER_IS_ALREADY_A_MEMBER_OF_THIS_ORGANIZATION:
+        "User is already a member of this organization",
+    MEMBER_NOT_FOUND: "Member not found",
+    ROLE_NOT_FOUND: "Role not found",
+    YOU_ARE_NOT_ALLOWED_TO_CREATE_A_NEW_TEAM:
+        "You are not allowed to create a new team",
+    TEAM_ALREADY_EXISTS: "Team already exists",
+    TEAM_NOT_FOUND: "Team not found",
+    YOU_CANNOT_LEAVE_THE_ORGANIZATION_AS_THE_ONLY_OWNER:
+        "You cannot leave the organization as the only owner",
+    YOU_ARE_NOT_ALLOWED_TO_DELETE_THIS_MEMBER:
+        "You are not allowed to delete this member",
+    YOU_ARE_NOT_ALLOWED_TO_INVITE_USERS_TO_THIS_ORGANIZATION:
+        "You are not allowed to invite users to this organization",
+    USER_IS_ALREADY_INVITED_TO_THIS_ORGANIZATION:
+        "User is already invited to this organization",
+    INVITATION_NOT_FOUND: "Invitation not found",
+    YOU_ARE_NOT_THE_RECIPIENT_OF_THE_INVITATION:
+        "You are not the recipient of the invitation",
+    YOU_ARE_NOT_ALLOWED_TO_CANCEL_THIS_INVITATION:
+        "You are not allowed to cancel this invitation",
+    INVITER_IS_NO_LONGER_A_MEMBER_OF_THE_ORGANIZATION:
+        "Inviter is no longer a member of the organization",
+    YOU_ARE_NOT_ALLOWED_TO_INVITE_USER_WITH_THIS_ROLE:
+        "you are not allowed to invite user with this role",
+    FAILED_TO_RETRIEVE_INVITATION: "Failed to retrieve invitation",
+    YOU_HAVE_REACHED_THE_MAXIMUM_NUMBER_OF_TEAMS:
+        "You have reached the maximum number of teams",
+    UNABLE_TO_REMOVE_LAST_TEAM: "Unable to remove last team",
+    YOU_ARE_NOT_ALLOWED_TO_UPDATE_THIS_MEMBER:
+        "You are not allowed to update this member",
+    ORGANIZATION_MEMBERSHIP_LIMIT_REACHED:
+        "Organization membership limit reached",
+    YOU_ARE_NOT_ALLOWED_TO_CREATE_TEAMS_IN_THIS_ORGANIZATION:
+        "You are not allowed to create teams in this organization",
+    YOU_ARE_NOT_ALLOWED_TO_DELETE_TEAMS_IN_THIS_ORGANIZATION:
+        "You are not allowed to delete teams in this organization",
+    YOU_ARE_NOT_ALLOWED_TO_UPDATE_THIS_TEAM:
+        "You are not allowed to update this team",
+    YOU_ARE_NOT_ALLOWED_TO_DELETE_THIS_TEAM:
+        "You are not allowed to delete this team",
+    INVITATION_LIMIT_REACHED: "Invitation limit reached"
+}

package/src/localization/passkey-error-codes.ts

@@ -0,0 +1,10 @@
+export const PASSKEY_ERROR_CODES = {
+    CHALLENGE_NOT_FOUND: "Challenge not found",
+    YOU_ARE_NOT_ALLOWED_TO_REGISTER_THIS_PASSKEY:
+        "You are not allowed to register this passkey",
+    FAILED_TO_VERIFY_REGISTRATION: "Failed to verify registration",
+    PASSKEY_NOT_FOUND: "Passkey not found",
+    AUTHENTICATION_FAILED: "Authentication failed",
+    UNABLE_TO_CREATE_SESSION: "Unable to create session",
+    FAILED_TO_UPDATE_PASSKEY: "Failed to update passkey"
+}

package/src/localization/phone-number-error-codes.ts

@@ -0,0 +1,10 @@
+export const PHONE_NUMBER_ERROR_CODES = {
+    INVALID_PHONE_NUMBER: "Invalid phone number",
+    PHONE_NUMBER_EXIST: "Phone number already exists",
+    INVALID_PHONE_NUMBER_OR_PASSWORD: "Invalid phone number or password",
+    UNEXPECTED_ERROR: "Unexpected error",
+    OTP_NOT_FOUND: "OTP not found",
+    OTP_EXPIRED: "OTP expired",
+    INVALID_OTP: "Invalid OTP",
+    PHONE_NUMBER_NOT_VERIFIED: "Phone number not verified"
+}

package/src/localization/stripe-localization.ts

@@ -0,0 +1,12 @@
+export const STRIPE_ERROR_CODES = {
+    SUBSCRIPTION_NOT_FOUND: "Subscription not found",
+    SUBSCRIPTION_PLAN_NOT_FOUND: "Subscription plan not found",
+    ALREADY_SUBSCRIBED_PLAN: "You're already subscribed to this plan",
+    UNABLE_TO_CREATE_CUSTOMER: "Unable to create customer",
+    FAILED_TO_FETCH_PLANS: "Failed to fetch plans",
+    EMAIL_VERIFICATION_REQUIRED:
+        "Email verification is required before you can subscribe to a plan",
+    SUBSCRIPTION_NOT_ACTIVE: "Subscription is not active",
+    SUBSCRIPTION_NOT_SCHEDULED_FOR_CANCELLATION:
+        "Subscription is not scheduled for cancellation"
+}

package/src/localization/two-factor-error-codes.ts

@@ -0,0 +1,12 @@
+export const TWO_FACTOR_ERROR_CODES = {
+    OTP_NOT_ENABLED: "OTP not enabled",
+    OTP_HAS_EXPIRED: "OTP has expired",
+    TOTP_NOT_ENABLED: "TOTP not enabled",
+    TWO_FACTOR_NOT_ENABLED: "Two factor isn't enabled",
+    BACKUP_CODES_NOT_ENABLED: "Backup codes aren't enabled",
+    INVALID_BACKUP_CODE: "Invalid backup code",
+    INVALID_CODE: "Invalid code",
+    TOO_MANY_ATTEMPTS_REQUEST_NEW_CODE:
+        "Too many attempts. Please request a new code.",
+    INVALID_TWO_FACTOR_COOKIE: "Invalid two factor cookie"
+}

package/src/localization/username-error-codes.ts

@@ -0,0 +1,9 @@
+export const USERNAME_ERROR_CODES = {
+    INVALID_USERNAME_OR_PASSWORD: "invalid username or password",
+    EMAIL_NOT_VERIFIED: "email not verified",
+    UNEXPECTED_ERROR: "unexpected error",
+    USERNAME_IS_ALREADY_TAKEN: "username is already taken. please try another.",
+    USERNAME_TOO_SHORT: "username is too short",
+    USERNAME_TOO_LONG: "username is too long",
+    INVALID_USERNAME: "username is invalid"
+}

package/src/server.ts

@@ -0,0 +1,4 @@
+export * from "./components/email/email-template"
+export { getViewByPath } from "./lib/utils"
+export * from "./lib/view-paths"
+export * from "./localization/auth-localization"

package/src/style.css

@@ -0,0 +1 @@
+@source ".";

package/src/tanstack.ts

@@ -0,0 +1 @@
+export * from "./lib/tanstack/auth-ui-provider-tanstack"

package/src/triplit.ts

@@ -0,0 +1 @@
+export * from "./lib/triplit/use-triplit-hooks"

package/src/types/account-options.ts

@@ -0,0 +1,35 @@
+import type { AccountViewPaths } from "../lib/view-paths"
+
+export type AccountOptions = {
+    /**
+     * Base path for account-scoped views
+     * @default "/account"
+     */
+    basePath?: string
+    /**
+     * Array of fields to show in Account Settings
+     * @default ["image", "name"]
+     */
+    fields: string[]
+    /**
+     * Customize account view paths
+     */
+    viewPaths?: Partial<AccountViewPaths>
+}
+
+export type AccountOptionsContext = {
+    /**
+     * Base path for account-scoped views
+     * @default "/account"
+     */
+    basePath: string
+    /**
+     * Array of fields to show in Account Settings
+     * @default ["image", "name"]
+     */
+    fields: string[]
+    /**
+     * Customize account view paths
+     */
+    viewPaths: AccountViewPaths
+}

package/src/types/additional-fields.ts

@@ -0,0 +1,21 @@
+import type { ReactNode } from "react"
+
+export type FieldType = "string" | "number" | "boolean"
+
+export interface AdditionalField {
+    description?: ReactNode
+    instructions?: ReactNode
+    label: ReactNode
+    placeholder?: string
+    required?: boolean
+    type: FieldType
+    /**
+     * Render a multi-line textarea for string fields
+     */
+    multiline?: boolean
+    validate?: (value: string) => Promise<boolean>
+}
+
+export interface AdditionalFields {
+    [key: string]: AdditionalField
+}

package/src/types/any-auth-client.ts

@@ -0,0 +1,6 @@
+import type { createAuthClient } from "better-auth/react"
+
+export type AnyAuthClient = Omit<
+    ReturnType<typeof createAuthClient>,
+    "signUp" | "getSession"
+>

package/src/types/api-key.ts

@@ -0,0 +1,9 @@
+export type ApiKey = {
+    id: string
+    name?: string | null
+    start?: string | null
+    expiresAt?: Date | null
+    createdAt: Date
+    updatedAt: Date
+    metadata?: Record<string, unknown> | null
+}

package/src/types/auth-client.ts

@@ -0,0 +1,37 @@
+import {
+    anonymousClient,
+    apiKeyClient,
+    emailOTPClient,
+    genericOAuthClient,
+    magicLinkClient,
+    multiSessionClient,
+    oneTapClient,
+    organizationClient,
+    passkeyClient,
+    twoFactorClient,
+    usernameClient
+} from "better-auth/client/plugins"
+import { createAuthClient } from "better-auth/react"
+
+export const authClient = createAuthClient({
+    plugins: [
+        apiKeyClient(),
+        multiSessionClient(),
+        passkeyClient(),
+        oneTapClient({
+            clientId: ""
+        }),
+        genericOAuthClient(),
+        anonymousClient(),
+        usernameClient(),
+        magicLinkClient(),
+        emailOTPClient(),
+        twoFactorClient(),
+        organizationClient()
+    ]
+})
+
+export type AuthClient = typeof authClient
+
+export type Session = AuthClient["$Infer"]["Session"]["session"]
+export type User = AuthClient["$Infer"]["Session"]["user"]

package/src/types/auth-hooks.ts

@@ -0,0 +1,61 @@
+import type { BetterFetchError } from "@better-fetch/fetch"
+import type { Account, User } from "better-auth"
+import type { Member } from "better-auth/plugins/organization"
+import type { AnyAuthClient } from "./any-auth-client"
+import type { ApiKey } from "./api-key"
+import type { AuthClient } from "./auth-client"
+import type { Invitation } from "./invitation"
+import type { Refetch } from "./refetch"
+
+type AnyAuthSession = AnyAuthClient["$Infer"]["Session"]
+
+type AuthHook<T> = {
+    isPending: boolean
+    data?: T | null
+    error?: BetterFetchError | null
+    refetch?: Refetch
+}
+
+export type AuthHooks = {
+    useSession: () => ReturnType<AnyAuthClient["useSession"]>
+    useListAccounts: () => AuthHook<Account[]>
+    useAccountInfo: (
+        params: Parameters<AuthClient["accountInfo"]>[0]
+    ) => AuthHook<{ user: User }>
+    useListDeviceSessions: () => AuthHook<AnyAuthClient["$Infer"]["Session"][]>
+    useListSessions: () => AuthHook<AnyAuthSession["session"][]>
+    useListPasskeys: () => Partial<ReturnType<AuthClient["useListPasskeys"]>>
+    useListApiKeys: () => AuthHook<ApiKey[]>
+    useActiveOrganization: () => Partial<
+        ReturnType<AuthClient["useActiveOrganization"]>
+    >
+    useListOrganizations: () => Partial<
+        ReturnType<AuthClient["useListOrganizations"]>
+    >
+    useHasPermission: (
+        params: Parameters<AuthClient["organization"]["hasPermission"]>[0]
+    ) => AuthHook<{
+        error: null
+        success: boolean
+    }>
+    useInvitation: (
+        params: Parameters<AuthClient["organization"]["getInvitation"]>[0]
+    ) => AuthHook<
+        Invitation & {
+            organizationName: string
+            organizationSlug: string
+            organizationLogo?: string
+        }
+    >
+    useListInvitations: (
+        params: Parameters<AuthClient["organization"]["listInvitations"]>[0]
+    ) => AuthHook<Invitation[]>
+    useListUserInvitations: () => AuthHook<Invitation[]>
+    useListMembers: (
+        params: Parameters<AuthClient["organization"]["listMembers"]>[0]
+    ) => AuthHook<{
+        members: (Member & { user?: Partial<User> | null })[]
+        total: number
+    }>
+    useIsRestoring?: () => boolean
+}

package/src/types/auth-mutators.ts

@@ -0,0 +1,17 @@
+type MutateFn<T = Record<string, unknown>> = (
+    params: T
+) => Promise<unknown> | Promise<void>
+
+export interface AuthMutators {
+    deleteApiKey: MutateFn<{ keyId: string }>
+    deletePasskey: MutateFn<{ id: string }>
+    revokeDeviceSession: MutateFn<{ sessionToken: string }>
+    revokeSession: MutateFn<{ token: string }>
+    setActiveSession: MutateFn<{ sessionToken: string }>
+    updateOrganization: MutateFn<{
+        organizationId: string
+        data: Record<string, unknown>
+    }>
+    updateUser: MutateFn
+    unlinkAccount: MutateFn<{ providerId: string; accountId?: string }>
+}

package/src/types/avatar-options.ts

@@ -0,0 +1,29 @@
+import type { Image } from "./image"
+
+export type AvatarOptions = {
+    /**
+     * Upload an avatar image and return the URL string
+     * @remarks `(file: File) => Promise<string>`
+     */
+    upload?: (file: File) => Promise<string | undefined | null>
+    /**
+     * Delete a previously uploaded avatar image from your storage/CDN
+     * @remarks `(url: string) => Promise<void>`
+     */
+    delete?: (url: string) => Promise<void>
+    /**
+     * Avatar size for resizing
+     * @default 128 (or 256 if upload is provided)
+     */
+    size: number
+    /**
+     * File extension for avatar uploads
+     * @default "png"
+     */
+    extension: string
+    /**
+     * Custom Image component for rendering avatar images
+     * @default AvatarImage from Radix UI
+     */
+    Image?: Image
+}

package/src/types/captcha-options.ts

@@ -0,0 +1,32 @@
+import type { CaptchaProvider } from "./captcha-provider"
+
+export type CaptchaOptions = {
+    /**
+     * Captcha site key
+     */
+    siteKey: string
+    /**
+     * Captcha provider type
+     */
+    provider: CaptchaProvider
+    /**
+     * Hide the captcha badge
+     * @default false
+     */
+    hideBadge?: boolean
+    /**
+     * Use recaptcha.net domain instead of google.com
+     * @default false
+     */
+    recaptchaNet?: boolean
+    /**
+     * Enable enterprise mode for Google reCAPTCHA
+     * @default false
+     */
+    enterprise?: boolean
+    /**
+     * Overrides the default array of paths where captcha validation is enforced
+     * @default ["/sign-up/email", "/sign-in/email", "/forget-password"]
+     */
+    endpoints?: string[]
+}

package/src/types/captcha-provider.ts

@@ -0,0 +1,6 @@
+export type CaptchaProvider =
+    | "cloudflare-turnstile"
+    | "google-recaptcha-v2-checkbox"
+    | "google-recaptcha-v2-invisible"
+    | "google-recaptcha-v3"
+    | "hcaptcha"

package/src/types/credentials-options.ts

@@ -0,0 +1,32 @@
+import type { PasswordValidation } from "./password-validation"
+
+export type CredentialsOptions = {
+    /**
+     * Enable or disable the Confirm Password input
+     * @default false
+     */
+    confirmPassword?: boolean
+
+    /**
+     * Enable or disable Forgot Password flow
+     * @default true
+     */
+    forgotPassword?: boolean
+
+    /**
+     * Customize the password validation
+     */
+    passwordValidation?: PasswordValidation
+
+    /**
+     * Enable or disable Remember Me checkbox
+     * @default false
+     */
+    rememberMe?: boolean
+
+    /**
+     * Enable or disable Username support
+     * @default false
+     */
+    username?: boolean
+}

package/src/types/delete-user-options.ts

@@ -0,0 +1,7 @@
+export type DeleteUserOptions = {
+    /**
+     * Enable or disable email verification for account deletion
+     * @default undefined
+     */
+    verification?: boolean
+}

package/src/types/fetch-error.ts

@@ -0,0 +1,6 @@
+export type FetchError = {
+    code?: string | undefined
+    message?: string | undefined
+    status?: number
+    statusText?: string
+}

package/src/types/generic-oauth-options.ts

@@ -0,0 +1,16 @@
+import type { Provider } from "../lib/social-providers"
+import type { AuthClient } from "./auth-client"
+
+export type GenericOAuthOptions = {
+    /**
+     * Custom OAuth Providers
+     * @default []
+     */
+    providers: Provider[]
+    /**
+     * Custom generic OAuth sign in function
+     */
+    signIn?: (
+        params: Parameters<AuthClient["signIn"]["oauth2"]>[0]
+    ) => Promise<unknown>
+}

package/src/types/gravatar-options.ts

@@ -0,0 +1,21 @@
+export type GravatarOptions = {
+    /**
+     * Default image type or URL
+     * Options: '404', 'mp', 'identicon', 'monsterid', 'wavatar', 'retro', 'robohash', 'blank', or custom URL
+     */
+    d?: string
+    /**
+     * Image size in pixels (1-2048)
+     */
+    size?: number
+    /**
+     * Whether to append .jpg extension to the hash
+     * @default false
+     */
+    jpg?: boolean
+    /**
+     * Force default image even if user has Gravatar
+     * @default false
+     */
+    forceDefault?: boolean
+}

package/src/types/image.ts

@@ -0,0 +1,7 @@
+import type { ComponentType } from "react"
+
+export type Image = ComponentType<{
+    src: string
+    alt: string
+    className?: string
+}>

package/src/types/invitation.ts

@@ -0,0 +1,10 @@
+export type Invitation = {
+    id: string
+    organizationId: string
+    email: string
+    role: string
+    status: string
+    inviterId: string
+    expiresAt: Date
+    teamId?: string | undefined
+}

package/src/types/link.ts

@@ -0,0 +1,7 @@
+import type { ComponentType, ReactNode } from "react"
+
+export type Link = ComponentType<{
+    href: string
+    className?: string
+    children: ReactNode
+}>