@better-auth-ui/core 1.6.2 → 1.6.4

package/dist/config/additional-fields-config.d.ts

@@ -0,0 +1,118 @@
+/** Data type of the additional field. */
+export type AdditionalFieldType = "string" | "number" | "boolean" | "date";
+/** Runtime value held by an `AdditionalField` (matches `AdditionalFieldType`). */
+export type AdditionalFieldValue = string | number | boolean | Date;
+/** UI rendering choice. Default is inferred from `AdditionalField.type`. */
+export type AdditionalFieldInputType = "input" | "textarea" | "number" | "slider" | "switch" | "checkbox" | "select" | "combobox" | "date" | "datetime" | "hidden";
+/**
+ * Augmentation target for widening `AdditionalField` slot types
+ * (`label`, `renderProps`, `renderResult`) in UI packages.
+ *
+ * @example
+ * declare module "@better-auth-ui/core" {
+ *   interface AdditionalFieldRegister { label: ReactNode }
+ * }
+ */
+export interface AdditionalFieldRegister {
+}
+/** Resolved label type. Defaults to `string`. */
+export type AdditionalFieldLabel = AdditionalFieldRegister extends {
+    label: infer L;
+} ? L : string;
+/** Resolved argument type for `AdditionalField.render`. */
+export type AdditionalFieldRenderProps = AdditionalFieldRegister extends {
+    renderProps: infer P;
+} ? P : {
+    name: string;
+    field: AdditionalField;
+    isPending?: boolean;
+};
+/** Resolved return type for `AdditionalField.render`. */
+export type AdditionalFieldRenderResult = AdditionalFieldRegister extends {
+    renderResult: infer R;
+} ? R : unknown;
+/** Option for a `select` input. */
+export interface AdditionalFieldOption {
+    label: AdditionalFieldLabel;
+    value: string;
+}
+/** Configuration for a single additional user field. */
+export interface AdditionalField {
+    /** Field name. Used as the user object key and form input `name`. */
+    name: string;
+    /** Data type of the field. */
+    type: AdditionalFieldType;
+    /** Visible label rendered next to the input. */
+    label: AdditionalFieldLabel;
+    /** Override the default UI rendering. @default inferred from `type` */
+    inputType?: AdditionalFieldInputType;
+    /** Placeholder text. */
+    placeholder?: string;
+    /** Content rendered as a prefix addon inside the input group. */
+    prefix?: AdditionalFieldLabel;
+    /** Content rendered as a suffix addon inside the input group. */
+    suffix?: AdditionalFieldLabel;
+    /**
+     * `Intl.NumberFormat` options for number fields. Use `maximumFractionDigits`
+     * (and optionally `minimumFractionDigits`) to allow decimals, or `style: "currency"`
+     * / `style: "percent"` for richer formatting.
+     */
+    formatOptions?: Intl.NumberFormatOptions;
+    /** Minimum value. Applies to `number` and `slider` input types. */
+    min?: number;
+    /** Maximum value. Applies to `number` and `slider` input types. */
+    max?: number;
+    /** Step value. Applies to `number` and `slider` input types. */
+    step?: number;
+    /** @default false */
+    required?: boolean;
+    /**
+     * Default value used to seed the input on the sign-up form. On the user
+     * profile, the value is always re-seeded from the persisted session.
+     */
+    defaultValue?: AdditionalFieldValue | null;
+    /**
+     * Render the field but exclude it from submission payloads.
+     * @default false
+     */
+    readOnly?: boolean;
+    /**
+     * Show a copy-to-clipboard button as a suffix. Input variant only.
+     * @default false
+     */
+    copyable?: boolean;
+    /** Options for the select input type. */
+    options?: AdditionalFieldOption[];
+    /**
+     * Custom client-side validation. Throw an `Error` (the `message` is shown
+     * to the user) when invalid; return / resolve normally when valid.
+     *
+     * Receives the parsed value (after `parseAdditionalFieldValue`).
+     */
+    validate?: (value: AdditionalFieldValue | null | undefined) => void | Promise<void>;
+    /**
+     * Render on the sign-up form. Pass `"above"` to render between the `email`
+     * and `password` fields; otherwise the field renders below the password
+     * block. `true` is an alias for `"below"`.
+     * @default false
+     */
+    signUp?: boolean | "above" | "below";
+    /** Render on the user profile. @default true */
+    profile?: boolean;
+    /**
+     * Custom renderer. Replaces the host UI package's built-in input. Must emit
+     * an input named `field.name` so the value is captured by the form's
+     * `FormData`.
+     */
+    render?: (props: AdditionalFieldRenderProps) => AdditionalFieldRenderResult;
+}
+/** Ordered list of `AdditionalField` configurations. */
+export type AdditionalFields = AdditionalField[];
+/**
+ * Convert a raw form value into the JS value Better Auth expects.
+ * Returns `null` for blank input (explicit clear), `undefined` when omitted
+ * or unparseable. Booleans always return `true`/`false`.
+ */
+export declare function parseAdditionalFieldValue(field: AdditionalField, raw: string | null | undefined): AdditionalFieldValue | null | undefined;
+/** Resolve the effective `inputType`, defaulting based on `field.type`. */
+export declare function resolveInputType(field: AdditionalField): AdditionalFieldInputType;

package/dist/config/additional-fields-config.js

@@ -0,0 +1,27 @@
+//#region src/config/additional-fields-config.ts
+function e(e, t) {
+	if (e.type === "boolean") return t === "on" || t === "true";
+	if (t != null) {
+		if (t === "") return null;
+		if (e.type === "number") {
+			let e = Number(t);
+			return Number.isNaN(e) ? void 0 : e;
+		}
+		if (e.type === "date") {
+			let e = new Date(t);
+			return Number.isNaN(e.getTime()) ? void 0 : e;
+		}
+		return t;
+	}
+}
+function t(e) {
+	if (e.inputType) return e.inputType;
+	switch (e.type) {
+		case "number": return "number";
+		case "boolean": return "switch";
+		case "date": return "date";
+		default: return "input";
+	}
+}
+//#endregion
+export { e as parseAdditionalFieldValue, t as resolveInputType };

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

@@ -1,12 +1,11 @@
 import { SocialProvider } from 'better-auth/social-providers';
+import { AuthPlugin } from '../lib/auth-plugin';
 import { BasePaths } from '../lib/base-paths';
 import { Localization } from '../lib/localization';
 import { ViewPaths } from '../lib/view-paths';
-import { AppearanceConfig } from './appearance-config';
+import { AdditionalFields } from './additional-fields-config';
 import { AvatarConfig } from './avatar-config';
-import { DeleteUserConfig } from './delete-user-config';
 import { EmailAndPasswordConfig } from './email-and-password-config';
-import { UsernameConfig } from './username-config';
 /**
  * Core authentication configuration interface.
  *
@@ -15,11 +14,10 @@ import { UsernameConfig } from './username-config';
  */
 export interface AuthConfig {
     /**
-     * Appearance/theme configuration
-     * @remarks `AppearanceConfig`
-     * @default { themes: ["system", "light", "dark"] }
+     * Additional user fields rendered on sign-up and the user profile.
+     * @remarks `AdditionalFields`
      */
-    appearance: AppearanceConfig;
+    additionalFields?: AdditionalFields;
     /**
      * Avatar upload, optimization, and deletion configuration.
      * @remarks `AvatarConfig`
@@ -36,11 +34,6 @@ export interface AuthConfig {
      * @default ""
      */
     baseURL: string;
-    /**
-     * Allow users to delete their account
-     * @remarks `DeleteUserConfig`
-     */
-    deleteUser?: DeleteUserConfig;
     /**
      * Email and password authentication configuration
      * @remarks `EmailAndPasswordConfig`
@@ -51,12 +44,13 @@ export interface AuthConfig {
      * @remarks `Localization`
      */
     localization: Localization;
-    /** Whether Magic Link plugin is enabled */
-    magicLink?: boolean;
-    /** Whether Multi Session plugin is enabled */
-    multiSession?: boolean;
-    /** Whether Passkey plugin is enabled */
-    passkey?: boolean;
+    /**
+     * Registered auth plugins. UI packages widen the element type via the
+     * `AuthPluginRegister` module-augmentation slot.
+     * @remarks `AuthPlugin[]`
+     * @default []
+     */
+    plugins: AuthPlugin[];
     /**
      * Default redirect path after successful authentication
      * @default "/"
@@ -72,11 +66,6 @@ export interface AuthConfig {
      * @remarks `ViewPaths`
      */
     viewPaths: ViewPaths;
-    /**
-     * Username plugin configuration
-     * @remarks `UsernameConfig`
-     */
-    username: UsernameConfig;
     /**
      * Function to navigate to a new path
      * @param options - Navigation options with href and optional replace flag

package/dist/config/auth-config.js

@@ -4,11 +4,6 @@ import { resizeAvatar as n } from "../lib/utils.js";
 import { viewPaths as r } from "../lib/view-paths.js";
 //#region src/config/auth-config.ts
 var i = {
-	appearance: { themes: [
-		"system",
-		"light",
-		"dark"
-	] },
 	avatar: {
 		enabled: !0,
 		resize: n,
@@ -20,20 +15,15 @@ var i = {
 	emailAndPassword: {
 		enabled: !0,
 		forgotPassword: !0,
+		name: !0,
 		rememberMe: !1,
 		minPasswordLength: 8,
 		maxPasswordLength: 128
 	},
+	plugins: [],
 	redirectTo: "/",
 	viewPaths: r,
 	localization: t,
-	username: {
-		enabled: !1,
-		displayUsername: !0,
-		isUsernameAvailable: !0,
-		minUsernameLength: 3,
-		maxUsernameLength: 30
-	},
 	navigate: ({ to: e, replace: t }) => {
 		t ? window.location.replace(e) : window.location.href = e;
 	}

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

@@ -27,9 +27,11 @@ export type EmailAndPasswordConfig = {
      */
     minPasswordLength: number;
     /**
-     * Maximum password length
-     * @default 128
+     * Whether to render the name field on the sign-up form. When `false`,
+     * sign-up submits with `name: ""`.
+     * @default true
      */
+    name?: boolean;
     /** Whether to show a "Remember me" checkbox on sign-in forms */
     rememberMe?: boolean;
     /** Whether email verification is required before account activation */

package/dist/config/index.d.ts

@@ -1,6 +1,4 @@
-export * from './appearance-config';
+export * from './additional-fields-config';
 export * from './auth-config';
 export * from './avatar-config';
-export * from './delete-user-config';
 export * from './email-and-password-config';
-export * from './username-config';

package/dist/index.d.ts

@@ -1,5 +1,10 @@
 export * from './config';
+export * from './lib/auth-mutation-keys';
+export * from './lib/auth-plugin';
+export * from './lib/auth-query-keys';
 export * from './lib/base-paths';
+export * from './lib/create-auth-plugin';
+export * from './lib/deep-partial';
 export * from './lib/localization';
 export * from './lib/provider-names';
 export * from './lib/utils';

package/dist/index.js

@@ -1,7 +1,11 @@
-import { basePaths as e } from "./lib/base-paths.js";
-import { localization as t } from "./lib/localization.js";
-import { deepmerge as n, fileToBase64 as r, resizeAvatar as i } from "./lib/utils.js";
-import { viewPaths as a } from "./lib/view-paths.js";
-import { defaultAuthConfig as o } from "./config/auth-config.js";
-import { getProviderName as s, providerNames as c } from "./lib/provider-names.js";
-export { e as basePaths, n as deepmerge, o as defaultAuthConfig, r as fileToBase64, s as getProviderName, t as localization, c as providerNames, i as resizeAvatar, a as viewPaths };
+import { parseAdditionalFieldValue as e, resolveInputType as t } from "./config/additional-fields-config.js";
+import { basePaths as n } from "./lib/base-paths.js";
+import { localization as r } from "./lib/localization.js";
+import { deepmerge as i, fileToBase64 as a, resizeAvatar as o } from "./lib/utils.js";
+import { viewPaths as s } from "./lib/view-paths.js";
+import { defaultAuthConfig as c } from "./config/auth-config.js";
+import { authMutationKeys as l } from "./lib/auth-mutation-keys.js";
+import { authQueryKeys as u } from "./lib/auth-query-keys.js";
+import { createAuthPlugin as d } from "./lib/create-auth-plugin.js";
+import { getProviderName as f, providerNames as p } from "./lib/provider-names.js";
+export { l as authMutationKeys, u as authQueryKeys, n as basePaths, d as createAuthPlugin, i as deepmerge, c as defaultAuthConfig, a as fileToBase64, f as getProviderName, r as localization, e as parseAdditionalFieldValue, p as providerNames, o as resizeAvatar, t as resolveInputType, s as viewPaths };

package/dist/lib/auth-mutation-keys.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Hierarchical mutation key factory for every Better Auth mutation managed by
+ * this library.
+ *
+ * Mutation keys are mostly used for `useIsMutating` and global
+ * `MutationCache` observers (e.g. toast handling), so the keys are static
+ * tuples rather than parameterised factories. Each grouping exposes an
+ * `all` prefix so consumers can match a whole feature at once:
+ *
+ * ```ts
+ * useIsMutating({ mutationKey: authMutationKeys.all })
+ * useIsMutating({ mutationKey: authMutationKeys.signIn.all })
+ * useIsMutating({ mutationKey: authMutationKeys.signIn.email })
+ * ```
+ *
+ * This factory lives in `@better-auth-ui/core` so it can be shared across
+ * framework packages (`@better-auth-ui/react`, a future `/solid` package,
+ * etc.) — the mutation cache entries line up regardless of which framework
+ * package the mutation options factory came from.
+ *
+ * For query keys, see `authQueryKeys` in `./auth-query-keys`.
+ */
+export declare const authMutationKeys: {
+    /** Root key for every Better Auth mutation. */
+    readonly all: readonly ["auth"];
+    /** Sign-in mutations, grouped by strategy. */
+    readonly signIn: {
+        /** Prefix matching every sign-in mutation. */
+        readonly all: readonly ["auth", "signIn"];
+        /** Key for `signIn.email`. */
+        readonly email: readonly ["auth", "signIn", "email"];
+        /** Key for `signIn.social`. */
+        readonly social: readonly ["auth", "signIn", "social"];
+        /** Key for `signIn.username`. */
+        readonly username: readonly ["auth", "signIn", "username"];
+    };
+    /** Sign-up mutations, grouped by strategy. */
+    readonly signUp: {
+        /** Prefix matching every sign-up mutation. */
+        readonly all: readonly ["auth", "signUp"];
+        /** Key for `signUp.email`. */
+        readonly email: readonly ["auth", "signUp", "email"];
+    };
+    /** Key for `signOut`. */
+    readonly signOut: readonly ["auth", "signOut"];
+    /** Key for `requestPasswordReset`. */
+    readonly requestPasswordReset: readonly ["auth", "requestPasswordReset"];
+    /** Key for `resetPassword`. */
+    readonly resetPassword: readonly ["auth", "resetPassword"];
+    /** Key for `sendVerificationEmail`. */
+    readonly sendVerificationEmail: readonly ["auth", "sendVerificationEmail"];
+    /** Multi-session mutations. */
+    readonly multiSession: {
+        /** Prefix matching every multi-session mutation. */
+        readonly all: readonly ["auth", "multiSession"];
+        /** Key for `multiSession.revoke`. */
+        readonly revoke: readonly ["auth", "multiSession", "revoke"];
+        /** Key for `multiSession.setActive`. */
+        readonly setActive: readonly ["auth", "multiSession", "setActive"];
+    };
+    /** Key for `changeEmail`. */
+    readonly changeEmail: readonly ["auth", "changeEmail"];
+    /** Key for `changePassword`. */
+    readonly changePassword: readonly ["auth", "changePassword"];
+    /** Key for `deleteUser`. */
+    readonly deleteUser: readonly ["auth", "deleteUser"];
+    /** Key for `linkSocial`. */
+    readonly linkSocial: readonly ["auth", "linkSocial"];
+    /** Key for `revokeSession`. */
+    readonly revokeSession: readonly ["auth", "revokeSession"];
+    /** Key for `unlinkAccount`. */
+    readonly unlinkAccount: readonly ["auth", "unlinkAccount"];
+    /** Key for `updateUser`. */
+    readonly updateUser: readonly ["auth", "updateUser"];
+    /**
+     * Key for `isUsernameAvailable`. This is technically a read, but it's
+     * exposed via better-auth's mutation surface and lives under the mutation
+     * factories for parity with other username flows.
+     */
+    readonly isUsernameAvailable: readonly ["auth", "isUsernameAvailable"];
+};

package/dist/lib/auth-mutation-keys.js

@@ -0,0 +1,57 @@
+//#region src/lib/auth-mutation-keys.ts
+var e = {
+	all: ["auth"],
+	signIn: {
+		all: ["auth", "signIn"],
+		email: [
+			"auth",
+			"signIn",
+			"email"
+		],
+		social: [
+			"auth",
+			"signIn",
+			"social"
+		],
+		username: [
+			"auth",
+			"signIn",
+			"username"
+		]
+	},
+	signUp: {
+		all: ["auth", "signUp"],
+		email: [
+			"auth",
+			"signUp",
+			"email"
+		]
+	},
+	signOut: ["auth", "signOut"],
+	requestPasswordReset: ["auth", "requestPasswordReset"],
+	resetPassword: ["auth", "resetPassword"],
+	sendVerificationEmail: ["auth", "sendVerificationEmail"],
+	multiSession: {
+		all: ["auth", "multiSession"],
+		revoke: [
+			"auth",
+			"multiSession",
+			"revoke"
+		],
+		setActive: [
+			"auth",
+			"multiSession",
+			"setActive"
+		]
+	},
+	changeEmail: ["auth", "changeEmail"],
+	changePassword: ["auth", "changePassword"],
+	deleteUser: ["auth", "deleteUser"],
+	linkSocial: ["auth", "linkSocial"],
+	revokeSession: ["auth", "revokeSession"],
+	unlinkAccount: ["auth", "unlinkAccount"],
+	updateUser: ["auth", "updateUser"],
+	isUsernameAvailable: ["auth", "isUsernameAvailable"]
+};
+//#endregion
+export { e as authMutationKeys };

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

@@ -0,0 +1,69 @@
+import { AdditionalFields } from '../config/additional-fields-config';
+/**
+ * View-path contributions kept on the plugin object.
+ *
+ * Plugins that add routable sub-pages (e.g. `magicLinkPlugin` adds
+ * `/auth/magic-link`) declare the URL segment under the matching section.
+ * Read at runtime via `useAuthPlugin(plugin).viewPaths.*`.
+ */
+export type AuthPluginViewPaths = {
+    auth?: Record<string, string>;
+    settings?: Record<string, string>;
+};
+/**
+ * Core authentication plugin interface.
+ *
+ * Defines the identity, localization, and routing contributions every plugin
+ * may ship. UI packages extend this with framework-specific slot components
+ * (see `AuthPlugin` in `@better-auth-ui/react`).
+ */
+export interface AuthPluginBase {
+    /** Unique identifier. Used as a React key and localization namespace. */
+    id: string;
+    /** Localization defaults contributed by the plugin. */
+    localization?: Record<string, unknown>;
+    /**
+     * View-path segments the plugin contributes. Read by host components
+     * (e.g. `<Auth>`, `MagicLinkButton`) via `useAuthPlugin(plugin).viewPaths`.
+     */
+    viewPaths?: AuthPluginViewPaths;
+    /**
+     * Additional user fields contributed by the plugin. These are merged with
+     * user-defined additionalFields in the auth config.
+     */
+    additionalFields?: AdditionalFields;
+    /**
+     * Additional properties contributed by the plugin.
+     */
+    [key: string]: unknown;
+}
+/**
+ * Composable module-augmentation slot for narrowing the plugin type returned
+ * by `useAuth()`. Each augmentation registers under its own key so multiple
+ * augmentations (e.g. a UI package and a user-land template) can coexist
+ * without colliding on a single shared property.
+ *
+ * The resolved {@link AuthPlugin} type is the union of every registered
+ * value, so `useAuth().plugins` is typed as the broadest plugin shape
+ * across all augmentations a consumer has imported.
+ *
+ * Pick any unique string as the key — the key is only used to keep slots
+ * disjoint during declaration merging and is never read at runtime.
+ *
+ * @example
+ * declare module "@better-auth-ui/core" {
+ *   interface AuthPluginRegister {
+ *     // Use a key unique to your package or app, e.g. the package name.
+ *     myUiPackage: MyAuthPlugin
+ *   }
+ * }
+ */
+export interface AuthPluginRegister {
+}
+/**
+ * Resolved auth plugin type. Consumers widen this via keyed augmentations on
+ * {@link AuthPluginRegister}; the resolved type is the union of every
+ * registered value. With no augmentations it falls back to the
+ * framework-agnostic {@link AuthPluginBase}.
+ */
+export type AuthPlugin = [keyof AuthPluginRegister] extends [never] ? AuthPluginBase : AuthPluginRegister[keyof AuthPluginRegister] extends infer P ? P extends AuthPluginBase ? P : AuthPluginBase : AuthPluginBase;

package/dist/lib/auth-query-keys.d.ts

@@ -0,0 +1,40 @@
+/**
+ * Hierarchical query key factory for every Better Auth query managed by
+ * this library.
+ *
+ * Keys are nested — higher-level keys are valid prefixes of their
+ * descendants — so a single call can invalidate a whole subtree:
+ *
+ * ```ts
+ * queryClient.invalidateQueries({ queryKey: authQueryKeys.all })
+ * queryClient.invalidateQueries({ queryKey: authQueryKeys.user(userId) })
+ * queryClient.invalidateQueries({ queryKey: authQueryKeys.session })
+ * ```
+ *
+ * This factory lives in `@better-auth-ui/core` so it can be shared across
+ * framework packages (`@better-auth-ui/react`, a future `/solid` package,
+ * etc.) and across client- and server-side query variants — the cache
+ * entries line up regardless of which query options factory produced them.
+ *
+ * For mutation keys, see `authMutationKeys` in `./auth-mutation-keys`.
+ */
+export declare const authQueryKeys: {
+    /** Root key for every Better Auth query. */
+    readonly all: readonly ["auth"];
+    /** Key for the current `getSession` query. */
+    readonly session: readonly ["auth", "getSession"];
+    /** Prefix for every per-user query. */
+    readonly users: () => readonly ["auth", "user"];
+    /** Prefix for every query scoped to a specific user. */
+    readonly user: (userId: string | undefined) => readonly ["auth", "user", string | undefined];
+    /** Key for `multiSession.listDeviceSessions` for the given user. */
+    readonly listDeviceSessions: <TQuery = undefined>(userId: string | undefined, query?: TQuery) => readonly ["auth", "user", string | undefined, "listDeviceSessions", NonNullable<TQuery> | null];
+    /** Key for the user's passkey list. */
+    readonly listPasskeys: <TQuery = undefined>(userId: string | undefined, query?: TQuery) => readonly ["auth", "user", string | undefined, "listPasskeys", NonNullable<TQuery> | null];
+    /** Key for `accountInfo` for the given user. */
+    readonly accountInfo: <TQuery = undefined>(userId: string | undefined, query?: TQuery) => readonly ["auth", "user", string | undefined, "accountInfo", NonNullable<TQuery> | null];
+    /** Key for `listAccounts` for the given user. */
+    readonly listAccounts: <TQuery = undefined>(userId: string | undefined, query?: TQuery) => readonly ["auth", "user", string | undefined, "listAccounts", NonNullable<TQuery> | null];
+    /** Key for `listSessions` for the given user. */
+    readonly listSessions: <TQuery = undefined>(userId: string | undefined, query?: TQuery) => readonly ["auth", "user", string | undefined, "listSessions", NonNullable<TQuery> | null];
+};

package/dist/lib/auth-query-keys.js

@@ -0,0 +1,34 @@
+//#region src/lib/auth-query-keys.ts
+var e = {
+	all: ["auth"],
+	session: ["auth", "getSession"],
+	users: () => [...e.all, "user"],
+	user: (t) => [...e.users(), t],
+	listDeviceSessions: (t, n) => [
+		...e.user(t),
+		"listDeviceSessions",
+		n ?? null
+	],
+	listPasskeys: (t, n) => [
+		...e.user(t),
+		"listPasskeys",
+		n ?? null
+	],
+	accountInfo: (t, n) => [
+		...e.user(t),
+		"accountInfo",
+		n ?? null
+	],
+	listAccounts: (t, n) => [
+		...e.user(t),
+		"listAccounts",
+		n ?? null
+	],
+	listSessions: (t, n) => [
+		...e.user(t),
+		"listSessions",
+		n ?? null
+	]
+};
+//#endregion
+export { e as authQueryKeys };

package/dist/lib/create-auth-plugin.d.ts

@@ -0,0 +1,38 @@
+/**
+ * Creates a plugin factory and attaches its `id` as a static property.
+ *
+ * Lifts the plugin's `id` out of the factory's runtime output so consumers
+ * (e.g. `useAuthPlugin`) can read it without invoking the factory. This lets
+ * plugins keep required options (like `themePlugin`'s `setTheme`) without
+ * forcing every factory to be callable with zero arguments.
+ *
+ * The returned factory:
+ * - is callable with the original arguments and returns the factory's result
+ *   merged with `{ id }`
+ * - exposes `id` as a static property so it can be read at registration or
+ *   lookup time without allocating a plugin instance
+ *
+ * Type safety for the plugin's shape is enforced at the registration site
+ * (`<AuthProvider plugins={[…]} />`) where `plugins` is typed as `AuthPlugin[]`.
+ *
+ * @example
+ * ```ts
+ * export const themePlugin = createAuthPlugin(
+ *   "theme",
+ *   (options: ThemePluginOptions) => ({
+ *     localization: { ...themeLocalization, ...options.localization },
+ *     theme: options.theme ?? "system",
+ *     setTheme: options.setTheme,
+ *     themes: options.themes ?? ["system", "light", "dark"]
+ *   })
+ * )
+ *
+ * themePlugin.id // "theme"
+ * themePlugin({ setTheme }) // { id: "theme", localization, theme, setTheme, themes }
+ * ```
+ */
+export declare function createAuthPlugin<const TId extends string, TArgs extends unknown[], TResult extends object>(id: TId, factory: (...args: TArgs) => TResult): ((...args: TArgs) => Omit<TResult, "id"> & {
+    id: TId;
+}) & {
+    id: TId;
+};

package/dist/lib/create-auth-plugin.js

@@ -0,0 +1,9 @@
+//#region src/lib/create-auth-plugin.ts
+function e(e, t) {
+	return Object.assign((...n) => ({
+		...t(...n),
+		id: e
+	}), { id: e });
+}
+//#endregion
+export { e as createAuthPlugin };

package/dist/lib/deep-partial.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Recursive partial. Leaves functions and arrays intact so callable props
+ * stay callable and array element types are preserved.
+ */
+export type DeepPartial<T> = T extends (...args: any[]) => any ? T : T extends readonly unknown[] ? T : T extends object ? {
+    [P in keyof T]?: DeepPartial<T[P]>;
+} : T;