@better-auth-ui/core 1.6.0 → 1.6.2

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

@@ -1,198 +0,0 @@
-import type { SocialProvider } from "better-auth/social-providers";
-import { type Toast } from "./auth-toast";
-import { type Localization } from "./localization";
-import { type ViewPaths } from "./view-paths";
-/**
- * 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;
-};
-/**
- * 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>;
-};
-/**
- * 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[];
-};
-/**
- * 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;
-};
-/**
- * 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: {
-        /**
-         * 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;
-    };
-    /**
-     * 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 `Toast`
-     */
-    toast: Toast;
-    /**
-     * 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/auth-config.js

@@ -1,36 +0,0 @@
-import { defaultToast } from "./auth-toast";
-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/auth-error.d.ts

@@ -1,9 +0,0 @@
-/**
- * Error type returned by Better Auth client methods.
- */
-export type AuthError = {
-    code?: string;
-    message?: string;
-    status: number;
-    statusText: string;
-};

package/dist/lib/auth-error.js

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

package/dist/lib/auth-hook-options.d.ts

@@ -1,8 +0,0 @@
-import type { AuthError } from "./auth-error";
-/**
- * Common options for auth hooks.
- */
-export interface AuthHookOptions {
-    onError?: (error: AuthError) => unknown | Promise<unknown>;
-    onSuccess?: () => unknown | Promise<unknown>;
-}

package/dist/lib/auth-hook-options.js

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

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

@@ -1,24 +0,0 @@
-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

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

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

@@ -1,23 +0,0 @@
-/**
- * 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

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

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

@@ -1,70 +0,0 @@
-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

@@ -1,36 +0,0 @@
-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

@@ -1,35 +0,0 @@
-/**
- * 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

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

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

@@ -1,37 +0,0 @@
-/**
- * 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

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

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

@@ -1,6 +0,0 @@
-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

@@ -1,6 +0,0 @@
-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

@@ -1,22 +0,0 @@
-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

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

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

@@ -1,24 +0,0 @@
-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

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

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

@@ -1,24 +0,0 @@
-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/toast-config.js

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

package/dist/localization/index.d.ts

@@ -1,35 +0,0 @@
-export declare const localization: {
-    auth: {
-        alreadyHaveAnAccount: string;
-        continueWith: string;
-        email: string;
-        emailPlaceholder: string;
-        forgotPassword: string;
-        invalidResetPasswordToken: string;
-        magicLink: string;
-        magicLinkSent: string;
-        name: string;
-        namePlaceholder: string;
-        newPassword: string;
-        newPasswordPlaceholder: string;
-        password: string;
-        passwordPlaceholder: string;
-        passwordResetEmailSent: string;
-        passwordResetSuccess: string;
-        needToCreateAnAccount: string;
-        or: string;
-        rememberYourPassword: string;
-        rememberMe: string;
-        resend: string;
-        resetPassword: string;
-        sendMagicLink: string;
-        sendResetLink: string;
-        /** @default "Sign In" */
-        signIn: string;
-        /** @default "Sign Up" */
-        signUp: string;
-        verificationEmailSent: string;
-        verifyYourEmail: string;
-    };
-};
-export type Localization = typeof localization;