@better-auth-ui/core 1.6.0

package/dist/lib/localization.js

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

package/dist/lib/provider-names.d.ts

@@ -0,0 +1,12 @@
+import type { SocialProvider } from "better-auth/social-providers";
+/**
+ * Mapping of social authentication provider identifiers to their human-readable display names.
+ */
+export declare const providerNames: Record<SocialProvider, string>;
+/**
+ * Get the human-readable display name for an authentication provider.
+ *
+ * @param provider - The provider identifier (e.g., "github", "google").
+ * @returns The mapped display name for `provider` if available, otherwise `provider` with its first character capitalized.
+ */
+export declare function getProviderName(provider: string): string;

package/dist/lib/provider-names.js

@@ -0,0 +1,50 @@
+/**
+ * Mapping of social authentication provider identifiers to their human-readable display names.
+ */
+export const providerNames = {
+    apple: "Apple",
+    atlassian: "Atlassian",
+    cognito: "Cognito",
+    discord: "Discord",
+    dropbox: "Dropbox",
+    facebook: "Facebook",
+    figma: "Figma",
+    github: "GitHub",
+    gitlab: "GitLab",
+    google: "Google",
+    huggingface: "Hugging Face",
+    kakao: "Kakao",
+    kick: "Kick",
+    line: "LINE",
+    linear: "Linear",
+    linkedin: "LinkedIn",
+    microsoft: "Microsoft",
+    naver: "Naver",
+    notion: "Notion",
+    paybin: "Paybin",
+    paypal: "PayPal",
+    polar: "Polar",
+    railway: "Railway",
+    reddit: "Reddit",
+    roblox: "Roblox",
+    salesforce: "Salesforce",
+    slack: "Slack",
+    spotify: "Spotify",
+    tiktok: "TikTok",
+    twitch: "Twitch",
+    twitter: "X",
+    vercel: "Vercel",
+    vk: "VK",
+    wechat: "WeChat",
+    zoom: "Zoom"
+};
+/**
+ * Get the human-readable display name for an authentication provider.
+ *
+ * @param provider - The provider identifier (e.g., "github", "google").
+ * @returns The mapped display name for `provider` if available, otherwise `provider` with its first character capitalized.
+ */
+export function getProviderName(provider) {
+    return (providerNames[provider] ||
+        provider.charAt(0).toUpperCase() + provider.slice(1));
+}

package/dist/lib/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/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/utils.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Resize and square-crop an image file for use as an avatar.
+ *
+ * The image is center-cropped to a square, scaled down to at most {@link size} pixels,
+ * and converted to the specified output format.
+ *
+ * @param file - The source image file.
+ * @param size - Max dimension in pixels for the output image.
+ * @param extension - Output format. Use `"inherit"` to keep the original format.
+ * @returns A promise that resolves to the processed `File`.
+ */
+export declare function resizeAvatar(file: File, size?: number, extension?: "png" | "jpg" | "webp" | "inherit"): Promise<File>;
+/**
+ * Convert a `File` to a base64-encoded data URL string.
+ *
+ * @param file - The file to encode.
+ * @returns A promise that resolves to the base64 data URL.
+ */
+export declare function fileToBase64(file: File): Promise<string>;
+/**
+ * Recursively merge `source` into `target`, producing a new object.
+ *
+ * - Plain objects are merged key-by-key; nested objects are merged recursively.
+ * - `undefined` values in `source` are skipped (existing `target` values are preserved).
+ * - Non-plain values (arrays, `Date`, `RegExp`, primitives, functions) in `source`
+ *   replace the corresponding `target` value outright.
+ *
+ * @param target - The base object.
+ * @param source - Partial overrides to apply on top of `target`.
+ * @returns A new merged object of type `T`.
+ */
+export declare function deepmerge<T>(target: T, source: Partial<T>): T;

package/dist/lib/utils.js

@@ -0,0 +1,116 @@
+/**
+ * Type guard that checks whether a value is a non-null, non-array object.
+ */
+function isObject(item) {
+    return item !== null && typeof item === "object" && !Array.isArray(item);
+}
+/**
+ * Type guard that checks whether a value is a plain object suitable for deep merging.
+ * Excludes `Date`, `RegExp`, and other special object types.
+ */
+function isPlainObject(item) {
+    if (!isObject(item))
+        return false;
+    // Handle special object types that should not be merged
+    if (item instanceof Date)
+        return false;
+    if (item instanceof RegExp)
+        return false;
+    return true;
+}
+/**
+ * Resize and square-crop an image file for use as an avatar.
+ *
+ * The image is center-cropped to a square, scaled down to at most {@link size} pixels,
+ * and converted to the specified output format.
+ *
+ * @param file - The source image file.
+ * @param size - Max dimension in pixels for the output image.
+ * @param extension - Output format. Use `"inherit"` to keep the original format.
+ * @returns A promise that resolves to the processed `File`.
+ */
+export function resizeAvatar(file, size = 256, extension = "png") {
+    const MAX_SIZE = size;
+    const resolvedExtension = extension === "inherit" ? file.name.split(".").pop() : extension;
+    const mimeType = extension === "inherit"
+        ? file.type
+        : `image/${extension === "jpg" ? "jpeg" : extension}`;
+    return new Promise((resolve, reject) => {
+        const img = new Image();
+        const url = URL.createObjectURL(file);
+        img.onload = () => {
+            URL.revokeObjectURL(url);
+            const { naturalWidth: w, naturalHeight: h } = img;
+            const side = Math.min(w, h);
+            const cropX = (w - side) / 2;
+            const cropY = (h - side) / 2;
+            const outSize = Math.min(side, MAX_SIZE);
+            const canvas = document.createElement("canvas");
+            canvas.width = outSize;
+            canvas.height = outSize;
+            const ctx = canvas.getContext("2d");
+            if (!ctx) {
+                reject(new Error("Could not get canvas context"));
+                return;
+            }
+            ctx.drawImage(img, cropX, cropY, side, side, 0, 0, outSize, outSize);
+            canvas.toBlob((blob) => {
+                if (!blob) {
+                    reject(new Error("Could not create blob from canvas"));
+                    return;
+                }
+                resolve(new File([blob], file.name.replace(/\.[^.]+$/, `.${resolvedExtension}`), {
+                    type: mimeType
+                }));
+            }, mimeType, 1);
+        };
+        img.onerror = () => {
+            URL.revokeObjectURL(url);
+            reject(new Error("Failed to load image"));
+        };
+        img.src = url;
+    });
+}
+/**
+ * Convert a `File` to a base64-encoded data URL string.
+ *
+ * @param file - The file to encode.
+ * @returns A promise that resolves to the base64 data URL.
+ */
+export function fileToBase64(file) {
+    return new Promise((resolve, reject) => {
+        const reader = new FileReader();
+        reader.onload = () => resolve(reader.result);
+        reader.onerror = () => reject(new Error("Failed to read file"));
+        reader.readAsDataURL(file);
+    });
+}
+/**
+ * Recursively merge `source` into `target`, producing a new object.
+ *
+ * - Plain objects are merged key-by-key; nested objects are merged recursively.
+ * - `undefined` values in `source` are skipped (existing `target` values are preserved).
+ * - Non-plain values (arrays, `Date`, `RegExp`, primitives, functions) in `source`
+ *   replace the corresponding `target` value outright.
+ *
+ * @param target - The base object.
+ * @param source - Partial overrides to apply on top of `target`.
+ * @returns A new merged object of type `T`.
+ */
+export function deepmerge(target, source) {
+    if (isPlainObject(target) && isPlainObject(source)) {
+        const result = { ...target };
+        for (const [key, value] of Object.entries(source)) {
+            if (value === undefined)
+                continue; // skip undefineds
+            if (key in target) {
+                result[key] = deepmerge(target[key], value);
+            }
+            else {
+                result[key] = value;
+            }
+        }
+        return result;
+    }
+    return source;
+}

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

@@ -0,0 +1,68 @@
+/**
+ * View path segments for authentication routes.
+ */
+export type AuthViewPaths = {
+    /**
+     * Path segment for the sign-in view
+     * @default "sign-in"
+     */
+    signIn: string;
+    /**
+     * Path segment for the sign-up view
+     * @default "sign-up"
+     */
+    signUp: string;
+    /**
+     * Path segment for the magic link authentication view
+     * @default "magic-link"
+     */
+    magicLink: string;
+    /**
+     * Path segment for the forgot password view
+     * @default "forgot-password"
+     */
+    forgotPassword: string;
+    /**
+     * Path segment for the reset password view
+     * @default "reset-password"
+     */
+    resetPassword: string;
+    /**
+     * Path segment for the sign-out view
+     * @default "sign-out"
+     */
+    signOut: string;
+};
+/**
+ * View path segments for settings routes.
+ */
+export type SettingsViewPaths = {
+    /**
+     * Path segment for the account settings view
+     * @default "account"
+     */
+    account: string;
+    /**
+     * Path segment for the security settings view
+     * @default "security"
+     */
+    security: string;
+};
+/**
+ * View path configuration for authentication and settings routes.
+ */
+export type ViewPaths = {
+    /** Auth view path segments */
+    auth: AuthViewPaths;
+    /** Settings view path segments */
+    settings: SettingsViewPaths;
+};
+export declare const viewPaths: ViewPaths;
+/**
+ * Valid auth view key.
+ */
+export type AuthView = keyof AuthViewPaths;
+/**
+ * Valid settings view key.
+ */
+export type SettingsView = keyof SettingsViewPaths;

package/dist/lib/view-paths.js

@@ -0,0 +1,14 @@
+export const viewPaths = {
+    auth: {
+        signIn: "sign-in",
+        signUp: "sign-up",
+        magicLink: "magic-link",
+        forgotPassword: "forgot-password",
+        resetPassword: "reset-password",
+        signOut: "sign-out"
+    },
+    settings: {
+        account: "account",
+        security: "security"
+    }
+};

package/dist/localization/index.d.ts

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

package/dist/localization/index.js

@@ -0,0 +1,34 @@
+export const localization = {
+    auth: {
+        alreadyHaveAnAccount: "Already have an account?",
+        continueWith: "Continue with {{provider}}",
+        email: "Email",
+        emailPlaceholder: "Enter your email",
+        forgotPassword: "Forgot password?",
+        invalidResetPasswordToken: "Invalid reset password token",
+        magicLink: "Magic link",
+        magicLinkSent: "Magic link sent to your email",
+        name: "Name",
+        namePlaceholder: "Enter your name",
+        newPassword: "New password",
+        newPasswordPlaceholder: "Enter your new password",
+        password: "Password",
+        passwordPlaceholder: "Enter your password",
+        passwordResetEmailSent: "Password reset email sent",
+        passwordResetSuccess: "Password reset successfully",
+        needToCreateAnAccount: "Need to create an account?",
+        or: "OR",
+        rememberYourPassword: "Remember your password?",
+        rememberMe: "Remember me",
+        resend: "Resend",
+        resetPassword: "Reset Password",
+        sendMagicLink: "Send Magic Link",
+        sendResetLink: "Send Reset Link",
+        /** @default "Sign In" */
+        signIn: "Sign In",
+        /** @default "Sign Up" */
+        signUp: "Sign Up",
+        verificationEmailSent: "Verification email sent!",
+        verifyYourEmail: "Verify your email"
+    }
+};

package/dist/localization/localization.d.ts

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

package/dist/localization/localization.js

@@ -0,0 +1,34 @@
+export const localization = {
+    auth: {
+        alreadyHaveAnAccount: "Already have an account?",
+        continueWith: "Continue with {{provider}}",
+        email: "Email",
+        emailPlaceholder: "Enter your email",
+        forgotPassword: "Forgot password?",
+        invalidResetPasswordToken: "Invalid reset password token",
+        magicLink: "Magic link",
+        magicLinkSent: "Magic link sent to your email",
+        name: "Name",
+        namePlaceholder: "Enter your name",
+        newPassword: "New password",
+        newPasswordPlaceholder: "Enter your new password",
+        password: "Password",
+        passwordPlaceholder: "Enter your password",
+        passwordResetEmailSent: "Password reset email sent",
+        passwordResetSuccess: "Password reset successfully",
+        needToCreateAnAccount: "Need to create an account?",
+        or: "OR",
+        rememberYourPassword: "Remember your password?",
+        rememberMe: "Remember me",
+        resend: "Resend",
+        resetPassword: "Reset Password",
+        sendMagicLink: "Send Magic Link",
+        sendResetLink: "Send Reset Link",
+        /** @default "Sign In" */
+        signIn: "Sign In",
+        /** @default "Sign Up" */
+        signUp: "Sign Up",
+        verificationEmailSent: "Verification email sent!",
+        verifyYourEmail: "Verify your email"
+    }
+};