@better-auth-ui/core 1.6.0

package/dist/lib/auth-toast.d.ts

@@ -0,0 +1,24 @@
+export type RenderToast = (message?: string, options?: {
+    action?: {
+        label: string;
+        onClick: () => Promise<void> | void;
+    };
+    actionProps?: {
+        children: string;
+        onClick: () => Promise<void> | void;
+    };
+}) => string | number | unknown;
+export type DismissToast = (id?: number | string | unknown | any) => string | number | unknown;
+export declare const defaultToast: RenderToast;
+export type Toast = {
+    /** Display an error toast notification */
+    error: RenderToast;
+    /** Display a danger toast notification */
+    danger?: RenderToast;
+    /** Display a success toast notification */
+    success: RenderToast;
+    /** Display an info toast notification */
+    info: RenderToast;
+    /** Optional function to dismiss a toast notification by its ID */
+    dismiss?: DismissToast;
+};

package/dist/lib/auth-toast.js

@@ -0,0 +1,10 @@
+export const defaultToast = (message, options) => {
+    if (options?.action) {
+        if (confirm(message)) {
+            options.action.onClick();
+        }
+    }
+    else {
+        alert(message);
+    }
+};

package/dist/lib/base-paths.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Base path configuration for authentication, settings, and organization routes.
+ */
+export type BasePaths = {
+    /**
+     * Base path for authentication routes
+     * @default "/auth"
+     */
+    auth: string;
+    /**
+     * Base path for settings routes
+     * @default "/settings"
+     */
+    settings: string;
+    /**
+     * Base path for organization management routes
+     * @default "/organization"
+     */
+    organization: string;
+};
+export declare const basePaths: BasePaths;

package/dist/lib/base-paths.js

@@ -0,0 +1,5 @@
+export const basePaths = {
+    auth: "/auth",
+    settings: "/settings",
+    organization: "/organization"
+};

package/dist/lib/config/appearance-config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Available theme options for the application.
+ */
+export type Theme = "system" | "light" | "dark";
+/**
+ * Configuration options for appearance/theme settings.
+ */
+export type AppearanceConfig = {
+    /**
+     * Function to set the application theme
+     * @param theme - The theme value to set
+     */
+    setTheme?: (theme: string) => void;
+    /**
+     * Current theme value
+     */
+    theme?: string;
+    /**
+     * Available theme options to display in the theme switcher
+     * @default ["system", "light", "dark"]
+     */
+    themes?: Theme[];
+};

package/dist/lib/config/appearance-config.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/config/auth-config.d.ts

@@ -0,0 +1,70 @@
+import type { SocialProvider } from "better-auth/social-providers";
+import { type ToastConfig } from "./toast-config";
+import { type BasePaths } from "../base-paths";
+import { type Localization } from "../localization";
+import { type ViewPaths } from "../view-paths";
+import type { EmailAndPasswordConfig } from "./email-and-password-config";
+import type { SettingsConfig } from "./settings-config";
+/**
+ * Core authentication configuration interface.
+ *
+ * Defines the base structure for authentication settings including paths,
+ * providers, navigation functions, and feature flags.
+ */
+export interface AuthConfig {
+    /** Base paths for different application sections */
+    basePaths: BasePaths;
+    /**
+     * Base URL for API endpoints (optional)
+     * @default ""
+     */
+    baseURL: string;
+    /**
+     * Email and password authentication configuration
+     * @default { enabled: true, forgotPassword: true, minPasswordLength: 8, maxPasswordLength: 128 }
+     */
+    emailAndPassword: EmailAndPasswordConfig;
+    /** Localization strings for UI components. */
+    localization: Localization;
+    /** Whether magic link (passwordless) authentication is enabled */
+    magicLink?: boolean;
+    /** Whether multi-session support is enabled */
+    multiSession?: boolean;
+    /**
+     * Default redirect path after successful authentication
+     * @default "/"
+     */
+    redirectTo: string;
+    /**
+     * Settings section configuration
+     * @default { enabled: true }
+     */
+    settings: SettingsConfig;
+    /**
+     * List of enabled social authentication providers
+     * @remarks `SocialProvider[]`
+     */
+    socialProviders?: SocialProvider[];
+    /** View path mappings for different authentication views */
+    viewPaths: ViewPaths;
+    /**
+     * Toast notification configuration for user feedback.
+     * @remarks `ToastConfig`
+     */
+    toast: ToastConfig;
+    /**
+     * Function to navigate to a new path
+     * @param options - Navigation options with href and optional replace flag
+     * @default window.location.href = href (or window.location.replace if replace: true)
+     * @example
+     * // TanStack Router
+     * navigate={navigate}
+     * // Next.js
+     * navigate={({href, replace}) => replace ? router.replace(href) : router.push(href)}
+     */
+    navigate: (options: {
+        to: string;
+        replace?: boolean;
+    }) => void;
+}
+export declare const defaultConfig: AuthConfig;

package/dist/lib/config/auth-config.js

@@ -0,0 +1,36 @@
+import { defaultToast } from "./toast-config";
+import { basePaths } from "../base-paths";
+import { localization } from "../localization";
+import { resizeAvatar } from "../utils";
+import { viewPaths } from "../view-paths";
+export const defaultConfig = {
+    basePaths,
+    baseURL: "",
+    emailAndPassword: {
+        enabled: true,
+        forgotPassword: true,
+        rememberMe: false,
+        minPasswordLength: 8,
+        maxPasswordLength: 128
+    },
+    redirectTo: "/",
+    settings: {
+        appearance: {
+            themes: ["system", "light", "dark"]
+        },
+        avatar: {
+            enabled: true,
+            resize: resizeAvatar,
+            size: 256
+        },
+        enabled: true
+    },
+    viewPaths,
+    localization,
+    navigate: () => { },
+    toast: {
+        error: defaultToast,
+        success: defaultToast,
+        info: defaultToast
+    }
+};

package/dist/lib/config/avatar-config.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Configuration options for avatar handling.
+ */
+export type AvatarConfig = {
+    /**
+     * Delete the current avatar (e.g. remove from storage).
+     * When undefined, avatar deletion is disabled.
+     */
+    delete?: (url: string) => Promise<void>;
+    /**
+     * Whether avatar changing is enabled.
+     * @default true
+     */
+    enabled?: boolean;
+    /**
+     * Output image format.
+     * @default "png"
+     */
+    extension?: "png" | "jpg" | "webp" | "inherit";
+    /**
+     * Resize an image file before upload.
+     * @default Resizes to max size, square-cropped, output as configured extension.
+     */
+    resize?: (file: File, size?: number, extension?: "png" | "jpg" | "webp" | "inherit") => Promise<File>;
+    /**
+     * Max dimension in pixels for the optimized avatar.
+     * @default 256
+     */
+    size?: number;
+    /**
+     * Upload a file and return the URL where it was stored.
+     * When undefined, the image is base64-encoded and saved directly to `user.image`.
+     */
+    upload?: (file: File) => Promise<string>;
+};

package/dist/lib/config/avatar-config.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/config/email-and-password-config.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Configuration options for email and password authentication.
+ */
+export type EmailAndPasswordConfig = {
+    /**
+     * Whether email/password authentication is enabled
+     * @default true
+     */
+    enabled: boolean;
+    /**
+     * Whether to show a confirm password field on sign-up forms
+     */
+    confirmPassword?: boolean;
+    /**
+     * Whether users can reset forgotten passwords
+     * @default true
+     */
+    forgotPassword: boolean;
+    /**
+     * Maximum password length
+     * @default 128
+     */
+    maxPasswordLength?: number;
+    /**
+     * Minimum password length
+     * @default 8
+     */
+    minPasswordLength?: number;
+    /**
+     * Maximum password length
+     * @default 128
+     */
+    /** Whether to show a "Remember me" checkbox on sign-in forms */
+    rememberMe?: boolean;
+    /** Whether email verification is required before account activation */
+    requireEmailVerification?: boolean;
+};

package/dist/lib/config/email-and-password-config.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/config/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./appearance-config";
+export * from "./auth-config";
+export * from "./avatar-config";
+export * from "./email-and-password-config";
+export * from "./settings-config";
+export * from "./toast-config";

package/dist/lib/config/index.js

@@ -0,0 +1,6 @@
+export * from "./appearance-config";
+export * from "./auth-config";
+export * from "./avatar-config";
+export * from "./email-and-password-config";
+export * from "./settings-config";
+export * from "./toast-config";

package/dist/lib/config/settings-config.d.ts

@@ -0,0 +1,22 @@
+import type { AppearanceConfig } from "./appearance-config";
+import type { AvatarConfig } from "./avatar-config";
+/**
+ * Configuration options for user settings.
+ */
+export type SettingsConfig = {
+    /**
+     * Appearance/theme configuration
+     * @default { themes: ["system", "light", "dark"] }
+     */
+    appearance: AppearanceConfig;
+    /**
+     * Avatar upload, optimization, and deletion configuration.
+     * @default { enabled: true, optimize: optimizeAvatar, size: 256 }
+     */
+    avatar: AvatarConfig;
+    /**
+     * Whether the settings section is enabled
+     * @default true
+     */
+    enabled?: boolean;
+};

package/dist/lib/config/settings-config.js

@@ -0,0 +1 @@
+export {};

package/dist/lib/config/toast-config.d.ts

@@ -0,0 +1,24 @@
+export type RenderToast = (message?: string, options?: {
+    action?: {
+        label: string;
+        onClick: () => Promise<void> | void;
+    };
+    actionProps?: {
+        children: string;
+        onClick: () => Promise<void> | void;
+    };
+}) => string | number | unknown;
+export type DismissToast = (id?: number | string | unknown | any) => string | number | unknown;
+export declare const defaultToast: RenderToast;
+export type ToastConfig = {
+    /** Display an error toast notification */
+    error: RenderToast;
+    /** Display a danger toast notification */
+    danger?: RenderToast;
+    /** Display a success toast notification */
+    success: RenderToast;
+    /** Display an info toast notification */
+    info: RenderToast;
+    /** Optional function to dismiss a toast notification by its ID */
+    dismiss?: DismissToast;
+};

package/dist/lib/config/toast-config.js

@@ -0,0 +1,10 @@
+export const defaultToast = (message, options) => {
+    if (options?.action) {
+        if (confirm(message)) {
+            options.action.onClick();
+        }
+    }
+    else {
+        alert(message);
+    }
+};

package/dist/lib/localization.d.ts

@@ -0,0 +1,175 @@
+export declare const localization: {
+    auth: {
+        /** @remarks `"Account"` */
+        account: string;
+        /** @remarks `"Add Account"` */
+        addAccount: string;
+        /** @remarks `"Already have an account?"` */
+        alreadyHaveAnAccount: string;
+        /** @remarks `"Confirm password"` */
+        confirmPassword: string;
+        /** @remarks `"Confirm your password"` */
+        confirmPasswordPlaceholder: string;
+        /** @remarks `"Continue with {{provider}}"` */
+        continueWith: string;
+        /** @remarks `"Email"` */
+        email: string;
+        /** @remarks `"Enter your email"` */
+        emailPlaceholder: string;
+        /** @remarks `"Forgot Password"` */
+        forgotPassword: string;
+        /** @remarks `"Forgot password?"` */
+        forgotPasswordLink: string;
+        /** @remarks `"Hide password"` */
+        hidePassword: string;
+        /** @remarks `"Invalid reset password token"` */
+        invalidResetPasswordToken: string;
+        /** @remarks `"Magic Link"` */
+        magicLink: string;
+        /** @remarks `"Magic link sent to your email"` */
+        magicLinkSent: string;
+        /** @remarks `"Name"` */
+        name: string;
+        /** @remarks `"Enter your name"` */
+        namePlaceholder: string;
+        /** @remarks `"Need to create an account?"` */
+        needToCreateAnAccount: string;
+        /** @remarks `"New password"` */
+        newPassword: string;
+        /** @remarks `"Enter your new password"` */
+        newPasswordPlaceholder: string;
+        /** @remarks `"OR"` */
+        or: string;
+        /** @remarks `"Password"` */
+        password: string;
+        /** @remarks `"Enter your password"` */
+        passwordPlaceholder: string;
+        /** @remarks `"Password reset email sent"` */
+        passwordResetEmailSent: string;
+        /** @remarks `"Password reset successfully"` */
+        passwordResetSuccess: string;
+        /** @remarks `"Passwords do not match"` */
+        passwordsDoNotMatch: string;
+        /** @remarks `"Remember me"` */
+        rememberMe: string;
+        /** @remarks `"Remember your password?"` */
+        rememberYourPassword: string;
+        /** @remarks `"Resend"` */
+        resend: string;
+        /** @remarks `"Reset Password"` */
+        resetPassword: string;
+        /** @remarks `"Send Magic Link"` */
+        sendMagicLink: string;
+        /** @remarks `"Send reset link"` */
+        sendResetLink: string;
+        /** @remarks `"Show password"` */
+        showPassword: string;
+        /** @remarks `"Sign In"` */
+        signIn: string;
+        /** @remarks `"Sign Out"` */
+        signOut: string;
+        /** @remarks `"Sign Up"` */
+        signUp: string;
+        /** @remarks `"Switch Account"` */
+        switchAccount: string;
+        /** @remarks `"Verification email sent!"` */
+        verificationEmailSent: string;
+        /** @remarks `"Verify your email"` */
+        verifyYourEmail: string;
+    };
+    settings: {
+        /** @remarks `"Account"` */
+        account: string;
+        /** @remarks `"Account unlinked"` */
+        accountUnlinked: string;
+        /** @remarks `"Active"` */
+        active: string;
+        /** @remarks `"Active sessions"` */
+        activeSessions: string;
+        /** @remarks `"Avatar"` */
+        avatar: string;
+        /** @remarks `"Current session"` */
+        currentSession: string;
+        /** @remarks `"Avatar changed successfully"` */
+        avatarChangedSuccess: string;
+        /** @remarks `"Avatar deleted successfully"` */
+        avatarDeletedSuccess: string;
+        /** @remarks `"Change avatar"` */
+        changeAvatar: string;
+        /** @remarks `"Delete avatar"` */
+        deleteAvatar: string;
+        /** @remarks `"Link"` */
+        link: string;
+        /** @remarks `"Linked accounts"` */
+        linkedAccounts: string;
+        /** @remarks `"Link your {{provider}} account"` */
+        linkProvider: string;
+        /** @remarks `"Appearance"` */
+        appearance: string;
+        /** @remarks `"Cancel"` */
+        cancel: string;
+        /** @remarks `"Change email"` */
+        changeEmail: string;
+        /** @remarks `"Check your email to confirm the change"` */
+        changeEmailSuccess: string;
+        /** @remarks `"Change password"` */
+        changePassword: string;
+        /** @remarks `"Password changed successfully"` */
+        changePasswordSuccess: string;
+        /** @remarks `"Current password"` */
+        currentPassword: string;
+        /** @remarks `"Enter your current password"` */
+        currentPasswordPlaceholder: string;
+        /** @remarks `"Dark"` */
+        dark: string;
+        /** @remarks `"Danger zone"` */
+        dangerZone: string;
+        /** @remarks `"Delete user"` */
+        deleteUser: string;
+        /** @remarks `"Permanently remove your account and all associated data. This cannot be undone."` */
+        deleteUserDescription: string;
+        /** @remarks `"Check your email to confirm account deletion."` */
+        deleteUserVerificationSent: string;
+        /** @remarks `"Your account has been deleted."` */
+        deleteUserSuccess: string;
+        /** @remarks `"Light"` */
+        light: string;
+        /** @remarks `"Manage accounts"` */
+        manageAccounts: string;
+        /** @remarks `"Profile"` */
+        profile: string;
+        /** @remarks `"Profile updated successfully"` */
+        profileUpdatedSuccess: string;
+        /** @remarks `"Revoke"` */
+        revoke: string;
+        /** @remarks `"Revoke session"` */
+        revokeSession: string;
+        /** @remarks `"Session revoked successfully"` */
+        revokeSessionSuccess: string;
+        /** @remarks `"Save changes"` */
+        saveChanges: string;
+        /** @remarks `"Set password"` */
+        setPassword: string;
+        /** @remarks `"You don't have a password yet. Request a reset link to set one up."` */
+        setPasswordDescription: string;
+        /** @remarks `"Security"` */
+        security: string;
+        /** @remarks `"Settings"` */
+        settings: string;
+        /** @remarks `"System"` */
+        system: string;
+        /** @remarks `"Theme"` */
+        theme: string;
+        /** @remarks `"Unlink {{provider}}"` */
+        unlinkProvider: string;
+        /** @remarks `"Update email"` */
+        updateEmail: string;
+        /** @remarks `"Update password"` */
+        updatePassword: string;
+        /** @remarks `"Upload avatar"` */
+        uploadAvatar: string;
+    };
+};
+export type Localization = typeof localization;
+export type AuthLocalization = Localization["auth"];
+export type SettingsLocalization = Localization["settings"];