@better-auth-ui/react 1.6.4 → 1.6.6

package/dist/components/auth/auth-provider.js

@@ -1,43 +1,44 @@
 "use client";
-import { deepmerge as e, defaultAuthConfig as t } from "@better-auth-ui/core";
-import { QueryClient as n, QueryClientContext as r, QueryClientProvider as i } from "@tanstack/react-query";
-import { createContext as a, useContext as o } from "react";
-import { jsx as s } from "react/jsx-runtime";
+import { FetchOptionsProvider as e } from "./fetch-options-provider.js";
+import { deepmerge as t, defaultAuthConfig as n } from "@better-auth-ui/core";
+import { QueryClient as r, QueryClientContext as i, QueryClientProvider as a } from "@tanstack/react-query";
+import { createContext as o, useContext as s } from "react";
+import { jsx as c } from "react/jsx-runtime";
 //#region src/components/auth/auth-provider.tsx
-var c = a(void 0), l = new n({ defaultOptions: { queries: { staleTime: 5e3 } } });
-function u({ children: n, queryClient: a, ...u }) {
-	let d = e(t, {
-		...u,
+var l = o(void 0), u = new r({ defaultOptions: { queries: { staleTime: 5e3 } } });
+function d({ children: r, queryClient: o, ...d }) {
+	let f = t(n, {
+		...d,
 		viewPaths: {
 			auth: {
-				...t.viewPaths.auth,
-				...u.viewPaths?.auth
+				...n.viewPaths.auth,
+				...d.viewPaths?.auth
 			},
 			settings: {
-				...t.viewPaths.settings,
-				...u.viewPaths?.settings
+				...n.viewPaths.settings,
+				...d.viewPaths?.settings
 			}
 		}
 	});
-	d.redirectTo = typeof window < "u" && new URLSearchParams(window.location.search).get("redirectTo")?.trim() || d.redirectTo;
-	let f = /* @__PURE__ */ new Map();
-	for (let e of d.plugins ?? []) for (let t of e.additionalFields ?? []) f.set(t.name, t);
-	for (let e of d.additionalFields ?? []) f.set(e.name, e);
-	return d.additionalFields = Array.from(f.values()), o(r) ? /* @__PURE__ */ s(c.Provider, {
-		value: d,
-		children: n
-	}) : /* @__PURE__ */ s(i, {
-		client: a || l,
-		children: /* @__PURE__ */ s(c.Provider, {
-			value: d,
-			children: n
+	f.redirectTo = typeof window < "u" && new URLSearchParams(window.location.search).get("redirectTo")?.trim() || f.redirectTo;
+	let p = /* @__PURE__ */ new Map();
+	for (let e of f.plugins ?? []) for (let t of e.additionalFields ?? []) p.set(t.name, t);
+	for (let e of f.additionalFields ?? []) p.set(e.name, e);
+	return f.additionalFields = Array.from(p.values()), s(i) ? /* @__PURE__ */ c(l.Provider, {
+		value: f,
+		children: /* @__PURE__ */ c(e, { children: r })
+	}) : /* @__PURE__ */ c(a, {
+		client: o || u,
+		children: /* @__PURE__ */ c(l.Provider, {
+			value: f,
+			children: /* @__PURE__ */ c(e, { children: r })
 		})
 	});
 }
-function d() {
-	let e = o(c);
+function f() {
+	let e = s(l);
 	if (!e) throw Error("[Better Auth UI] AuthProvider is required");
 	return e;
 }
 //#endregion
-export { u as AuthProvider, d as useAuth };
+export { d as AuthProvider, f as useAuth };

package/dist/components/auth/fetch-options-provider.d.ts

@@ -0,0 +1,19 @@
+import { PropsWithChildren } from 'react';
+/** Subset of BetterFetchOptions we expose. Add fields as use-cases arise. */
+export type FetchOptions = {
+    headers?: Record<string, string>;
+    body?: Record<string, unknown>;
+};
+type FetchOptionsContextValue = {
+    /** Current fetchOptions, or `undefined` when none are set. */
+    fetchOptions: FetchOptions | undefined;
+    /** OVERRIDES the entire fetchOptions object. Pass `undefined` to clear. */
+    setFetchOptions: (fetchOptions: FetchOptions | undefined) => void;
+    /** Clears `fetchOptions` and runs the registered reset (e.g. captcha widget). Call from form `onError`. */
+    resetFetchOptions: () => void;
+    /** Register a reset handler. Used by `captchaPlugin`. Pass `null` to clear. */
+    registerReset: (reset: (() => void) | null) => void;
+};
+export declare function FetchOptionsProvider({ children }: PropsWithChildren): import("react/jsx-runtime").JSX.Element;
+export declare function useFetchOptions(): FetchOptionsContextValue;
+export {};

package/dist/components/auth/fetch-options-provider.js

@@ -0,0 +1,30 @@
+"use client";
+import { createContext as e, useCallback as t, useContext as n, useRef as r, useState as i } from "react";
+import { jsx as a } from "react/jsx-runtime";
+//#region src/components/auth/fetch-options-provider.tsx
+var o = e(void 0);
+function s({ children: e }) {
+	let [n, s] = i(void 0), c = r(null), l = t((e) => {
+		s(e);
+	}, []), u = t((e) => {
+		c.current = e;
+	}, []), d = t(() => {
+		s(void 0), c.current?.();
+	}, []);
+	return /* @__PURE__ */ a(o.Provider, {
+		value: {
+			fetchOptions: n,
+			setFetchOptions: l,
+			resetFetchOptions: d,
+			registerReset: u
+		},
+		children: e
+	});
+}
+function c() {
+	let e = n(o);
+	if (!e) throw Error("[Better Auth UI] useFetchOptions must be used within FetchOptionsProvider");
+	return e;
+}
+//#endregion
+export { s as FetchOptionsProvider, c as useFetchOptions };

package/dist/index.d.ts

@@ -1,4 +1,5 @@
 export * from './components/auth/auth-provider';
+export * from './components/auth/fetch-options-provider';
 export * from './components/icons';
 export * from './components/settings/account/theme-preview';
 export * from './hooks/auth/use-authenticate';

package/dist/index.js

@@ -1,76 +1,77 @@
 "use client";
-import { AuthProvider as e, useAuth as t } from "./components/auth/auth-provider.js";
-import { Apple as n } from "./components/icons/apple.js";
-import { Atlassian as r } from "./components/icons/atlassian.js";
-import { Cognito as i } from "./components/icons/cognito.js";
-import { Discord as a } from "./components/icons/discord.js";
-import { Dropbox as o } from "./components/icons/dropbox.js";
-import { Facebook as s } from "./components/icons/facebook.js";
-import { Figma as c } from "./components/icons/figma.js";
-import { GitHub as l } from "./components/icons/github.js";
-import { GitLab as u } from "./components/icons/gitlab.js";
-import { Google as d } from "./components/icons/google.js";
-import { HuggingFace as f } from "./components/icons/huggingface.js";
-import { Kakao as p } from "./components/icons/kakao.js";
-import { Kick as m } from "./components/icons/kick.js";
-import { Line as h } from "./components/icons/line.js";
-import { Linear as g } from "./components/icons/linear.js";
-import { LinkedIn as _ } from "./components/icons/linkedin.js";
-import { Microsoft as v } from "./components/icons/microsoft.js";
-import { Naver as y } from "./components/icons/naver.js";
-import { Notion as b } from "./components/icons/notion.js";
-import { Paybin as x } from "./components/icons/paybin.js";
-import { PayPal as S } from "./components/icons/paypal.js";
-import { Polar as C } from "./components/icons/polar.js";
-import { Railway as w } from "./components/icons/railway.js";
-import { Reddit as T } from "./components/icons/reddit.js";
-import { Roblox as E } from "./components/icons/roblox.js";
-import { Salesforce as D } from "./components/icons/salesforce.js";
-import { Slack as O } from "./components/icons/slack.js";
-import { Spotify as k } from "./components/icons/spotify.js";
-import { TikTok as A } from "./components/icons/tiktok.js";
-import { Twitch as j } from "./components/icons/twitch.js";
-import { Vercel as M } from "./components/icons/vercel.js";
-import { VK as N } from "./components/icons/vk.js";
-import { WeChat as P } from "./components/icons/wechat.js";
-import { X as F } from "./components/icons/x.js";
-import { Zoom as I } from "./components/icons/zoom.js";
+import { FetchOptionsProvider as e, useFetchOptions as t } from "./components/auth/fetch-options-provider.js";
+import { AuthProvider as n, useAuth as r } from "./components/auth/auth-provider.js";
+import { Apple as i } from "./components/icons/apple.js";
+import { Atlassian as a } from "./components/icons/atlassian.js";
+import { Cognito as o } from "./components/icons/cognito.js";
+import { Discord as s } from "./components/icons/discord.js";
+import { Dropbox as c } from "./components/icons/dropbox.js";
+import { Facebook as l } from "./components/icons/facebook.js";
+import { Figma as u } from "./components/icons/figma.js";
+import { GitHub as d } from "./components/icons/github.js";
+import { GitLab as f } from "./components/icons/gitlab.js";
+import { Google as p } from "./components/icons/google.js";
+import { HuggingFace as m } from "./components/icons/huggingface.js";
+import { Kakao as h } from "./components/icons/kakao.js";
+import { Kick as g } from "./components/icons/kick.js";
+import { Line as _ } from "./components/icons/line.js";
+import { Linear as v } from "./components/icons/linear.js";
+import { LinkedIn as y } from "./components/icons/linkedin.js";
+import { Microsoft as b } from "./components/icons/microsoft.js";
+import { Naver as x } from "./components/icons/naver.js";
+import { Notion as S } from "./components/icons/notion.js";
+import { Paybin as C } from "./components/icons/paybin.js";
+import { PayPal as w } from "./components/icons/paypal.js";
+import { Polar as T } from "./components/icons/polar.js";
+import { Railway as E } from "./components/icons/railway.js";
+import { Reddit as D } from "./components/icons/reddit.js";
+import { Roblox as O } from "./components/icons/roblox.js";
+import { Salesforce as k } from "./components/icons/salesforce.js";
+import { Slack as A } from "./components/icons/slack.js";
+import { Spotify as j } from "./components/icons/spotify.js";
+import { TikTok as M } from "./components/icons/tiktok.js";
+import { Twitch as N } from "./components/icons/twitch.js";
+import { Vercel as P } from "./components/icons/vercel.js";
+import { VK as F } from "./components/icons/vk.js";
+import { WeChat as I } from "./components/icons/wechat.js";
+import { X as L } from "./components/icons/x.js";
+import { Zoom as R } from "./components/icons/zoom.js";
 import "./components/icons/index.js";
-import { ThemePreviewDark as L, ThemePreviewLight as R, ThemePreviewSystem as z } from "./components/settings/account/theme-preview.js";
-import { ensureSession as B, fetchSession as V, prefetchSession as H, sessionOptions as U, useSession as W } from "./queries/auth/session-query.js";
-import { useAuthenticate as G } from "./hooks/auth/use-authenticate.js";
-import { useUser as K } from "./hooks/auth/use-user.js";
-import { authMutationOptions as q } from "./mutations/auth-mutation-options.js";
-import { useAuthMutation as J } from "./hooks/use-auth-mutation.js";
-import { useAuthPlugin as Y } from "./hooks/use-auth-plugin.js";
-import { authQueryOptions as X } from "./queries/auth-query-options.js";
-import { useAuthQuery as Z } from "./hooks/use-auth-query.js";
-import { providerIcons as Q } from "./lib/provider-icons.js";
-import { requestPasswordResetOptions as $, useRequestPasswordReset as ee } from "./mutations/auth/request-password-reset-mutation.js";
-import { resetPasswordOptions as te, useResetPassword as ne } from "./mutations/auth/reset-password-mutation.js";
-import { sendVerificationEmailOptions as re, useSendVerificationEmail as ie } from "./mutations/auth/send-verification-email-mutation.js";
-import { signInEmailOptions as ae, useSignInEmail as oe } from "./mutations/auth/sign-in-email-mutation.js";
-import { signInSocialOptions as se, useSignInSocial as ce } from "./mutations/auth/sign-in-social-mutation.js";
-import { signOutOptions as le, useSignOut as ue } from "./mutations/auth/sign-out-mutation.js";
-import { signUpEmailOptions as de, useSignUpEmail as fe } from "./mutations/auth/sign-up-email-mutation.js";
-import { signInMagicLinkOptions as pe, useSignInMagicLink as me } from "./mutations/magic-link/sign-in-magic-link-mutation.js";
-import { ensureListDeviceSessions as he, fetchListDeviceSessions as ge, listDeviceSessionsOptions as _e, prefetchListDeviceSessions as ve, useListDeviceSessions as ye } from "./queries/multi-session/list-device-sessions-query.js";
-import { revokeMultiSessionOptions as be, useRevokeMultiSession as xe } from "./mutations/multi-session/revoke-multi-session-mutation.js";
-import { setActiveSessionOptions as Se, useSetActiveSession as Ce } from "./mutations/multi-session/set-active-session-mutation.js";
-import { ensureListPasskeys as we, fetchListPasskeys as Te, listPasskeysOptions as Ee, prefetchListPasskeys as De, useListPasskeys as Oe } from "./queries/passkey/list-passkeys-query.js";
-import { addPasskeyOptions as ke, useAddPasskey as Ae } from "./mutations/passkey/add-passkey-mutation.js";
-import { deletePasskeyOptions as je, useDeletePasskey as Me } from "./mutations/passkey/delete-passkey-mutation.js";
-import { signInPasskeyOptions as Ne, useSignInPasskey as Pe } from "./mutations/passkey/sign-in-passkey-mutation.js";
-import { changeEmailOptions as Fe, useChangeEmail as Ie } from "./mutations/settings/change-email-mutation.js";
-import { changePasswordOptions as Le, useChangePassword as Re } from "./mutations/settings/change-password-mutation.js";
-import { deleteUserOptions as ze, useDeleteUser as Be } from "./mutations/settings/delete-user-mutation.js";
-import { linkSocialOptions as Ve, useLinkSocial as He } from "./mutations/settings/link-social-mutation.js";
-import { ensureListSessions as Ue, fetchListSessions as We, listSessionsOptions as Ge, prefetchListSessions as Ke, useListSessions as qe } from "./queries/settings/list-sessions-query.js";
-import { revokeSessionOptions as Je, useRevokeSession as Ye } from "./mutations/settings/revoke-session-mutation.js";
-import { ensureListAccounts as Xe, fetchListAccounts as Ze, listAccountsOptions as Qe, prefetchListAccounts as $e, useListAccounts as et } from "./queries/settings/list-accounts-query.js";
-import { unlinkAccountOptions as tt, useUnlinkAccount as nt } from "./mutations/settings/unlink-account-mutation.js";
-import { updateUserOptions as rt, useUpdateUser as it } from "./mutations/settings/update-user-mutation.js";
-import { isUsernameAvailableOptions as at, useIsUsernameAvailable as ot } from "./mutations/username/is-username-available-mutation.js";
-import { signInUsernameOptions as st, useSignInUsername as ct } from "./mutations/username/sign-in-username-mutation.js";
-import { accountInfoOptions as lt, ensureAccountInfo as ut, fetchAccountInfo as dt, prefetchAccountInfo as ft, useAccountInfo as pt } from "./queries/settings/account-info-query.js";
-export { n as Apple, r as Atlassian, e as AuthProvider, i as Cognito, a as Discord, o as Dropbox, s as Facebook, c as Figma, l as GitHub, u as GitLab, d as Google, f as HuggingFace, p as Kakao, m as Kick, h as Line, g as Linear, _ as LinkedIn, v as Microsoft, y as Naver, b as Notion, S as PayPal, x as Paybin, C as Polar, w as Railway, T as Reddit, E as Roblox, D as Salesforce, O as Slack, k as Spotify, L as ThemePreviewDark, R as ThemePreviewLight, z as ThemePreviewSystem, A as TikTok, j as Twitch, N as VK, M as Vercel, P as WeChat, F as X, I as Zoom, lt as accountInfoOptions, ke as addPasskeyOptions, q as authMutationOptions, X as authQueryOptions, Fe as changeEmailOptions, Le as changePasswordOptions, je as deletePasskeyOptions, ze as deleteUserOptions, ut as ensureAccountInfo, Xe as ensureListAccounts, he as ensureListDeviceSessions, we as ensureListPasskeys, Ue as ensureListSessions, B as ensureSession, dt as fetchAccountInfo, Ze as fetchListAccounts, ge as fetchListDeviceSessions, Te as fetchListPasskeys, We as fetchListSessions, V as fetchSession, at as isUsernameAvailableOptions, Ve as linkSocialOptions, Qe as listAccountsOptions, _e as listDeviceSessionsOptions, Ee as listPasskeysOptions, Ge as listSessionsOptions, ft as prefetchAccountInfo, $e as prefetchListAccounts, ve as prefetchListDeviceSessions, De as prefetchListPasskeys, Ke as prefetchListSessions, H as prefetchSession, Q as providerIcons, $ as requestPasswordResetOptions, te as resetPasswordOptions, be as revokeMultiSessionOptions, Je as revokeSessionOptions, re as sendVerificationEmailOptions, U as sessionOptions, Se as setActiveSessionOptions, ae as signInEmailOptions, pe as signInMagicLinkOptions, Ne as signInPasskeyOptions, se as signInSocialOptions, st as signInUsernameOptions, le as signOutOptions, de as signUpEmailOptions, tt as unlinkAccountOptions, rt as updateUserOptions, pt as useAccountInfo, Ae as useAddPasskey, t as useAuth, J as useAuthMutation, Y as useAuthPlugin, Z as useAuthQuery, G as useAuthenticate, Ie as useChangeEmail, Re as useChangePassword, Me as useDeletePasskey, Be as useDeleteUser, ot as useIsUsernameAvailable, He as useLinkSocial, et as useListAccounts, ye as useListDeviceSessions, Oe as useListPasskeys, qe as useListSessions, ee as useRequestPasswordReset, ne as useResetPassword, xe as useRevokeMultiSession, Ye as useRevokeSession, ie as useSendVerificationEmail, W as useSession, Ce as useSetActiveSession, oe as useSignInEmail, me as useSignInMagicLink, Pe as useSignInPasskey, ce as useSignInSocial, ct as useSignInUsername, ue as useSignOut, fe as useSignUpEmail, nt as useUnlinkAccount, it as useUpdateUser, K as useUser };
+import { ThemePreviewDark as z, ThemePreviewLight as B, ThemePreviewSystem as V } from "./components/settings/account/theme-preview.js";
+import { ensureSession as H, fetchSession as U, prefetchSession as W, sessionOptions as G, useSession as K } from "./queries/auth/session-query.js";
+import { useAuthenticate as q } from "./hooks/auth/use-authenticate.js";
+import { useUser as J } from "./hooks/auth/use-user.js";
+import { authMutationOptions as Y } from "./mutations/auth-mutation-options.js";
+import { useAuthMutation as X } from "./hooks/use-auth-mutation.js";
+import { useAuthPlugin as Z } from "./hooks/use-auth-plugin.js";
+import { authQueryOptions as Q } from "./queries/auth-query-options.js";
+import { useAuthQuery as $ } from "./hooks/use-auth-query.js";
+import { providerIcons as ee } from "./lib/provider-icons.js";
+import { requestPasswordResetOptions as te, useRequestPasswordReset as ne } from "./mutations/auth/request-password-reset-mutation.js";
+import { resetPasswordOptions as re, useResetPassword as ie } from "./mutations/auth/reset-password-mutation.js";
+import { sendVerificationEmailOptions as ae, useSendVerificationEmail as oe } from "./mutations/auth/send-verification-email-mutation.js";
+import { signInEmailOptions as se, useSignInEmail as ce } from "./mutations/auth/sign-in-email-mutation.js";
+import { signInSocialOptions as le, useSignInSocial as ue } from "./mutations/auth/sign-in-social-mutation.js";
+import { signOutOptions as de, useSignOut as fe } from "./mutations/auth/sign-out-mutation.js";
+import { signUpEmailOptions as pe, useSignUpEmail as me } from "./mutations/auth/sign-up-email-mutation.js";
+import { signInMagicLinkOptions as he, useSignInMagicLink as ge } from "./mutations/magic-link/sign-in-magic-link-mutation.js";
+import { ensureListDeviceSessions as _e, fetchListDeviceSessions as ve, listDeviceSessionsOptions as ye, prefetchListDeviceSessions as be, useListDeviceSessions as xe } from "./queries/multi-session/list-device-sessions-query.js";
+import { revokeMultiSessionOptions as Se, useRevokeMultiSession as Ce } from "./mutations/multi-session/revoke-multi-session-mutation.js";
+import { setActiveSessionOptions as we, useSetActiveSession as Te } from "./mutations/multi-session/set-active-session-mutation.js";
+import { ensureListPasskeys as Ee, fetchListPasskeys as De, listPasskeysOptions as Oe, prefetchListPasskeys as ke, useListPasskeys as Ae } from "./queries/passkey/list-passkeys-query.js";
+import { addPasskeyOptions as je, useAddPasskey as Me } from "./mutations/passkey/add-passkey-mutation.js";
+import { deletePasskeyOptions as Ne, useDeletePasskey as Pe } from "./mutations/passkey/delete-passkey-mutation.js";
+import { signInPasskeyOptions as Fe, useSignInPasskey as Ie } from "./mutations/passkey/sign-in-passkey-mutation.js";
+import { changeEmailOptions as Le, useChangeEmail as Re } from "./mutations/settings/change-email-mutation.js";
+import { changePasswordOptions as ze, useChangePassword as Be } from "./mutations/settings/change-password-mutation.js";
+import { deleteUserOptions as Ve, useDeleteUser as He } from "./mutations/settings/delete-user-mutation.js";
+import { linkSocialOptions as Ue, useLinkSocial as We } from "./mutations/settings/link-social-mutation.js";
+import { ensureListSessions as Ge, fetchListSessions as Ke, listSessionsOptions as qe, prefetchListSessions as Je, useListSessions as Ye } from "./queries/settings/list-sessions-query.js";
+import { revokeSessionOptions as Xe, useRevokeSession as Ze } from "./mutations/settings/revoke-session-mutation.js";
+import { ensureListAccounts as Qe, fetchListAccounts as $e, listAccountsOptions as et, prefetchListAccounts as tt, useListAccounts as nt } from "./queries/settings/list-accounts-query.js";
+import { unlinkAccountOptions as rt, useUnlinkAccount as it } from "./mutations/settings/unlink-account-mutation.js";
+import { updateUserOptions as at, useUpdateUser as ot } from "./mutations/settings/update-user-mutation.js";
+import { isUsernameAvailableOptions as st, useIsUsernameAvailable as ct } from "./mutations/username/is-username-available-mutation.js";
+import { signInUsernameOptions as lt, useSignInUsername as ut } from "./mutations/username/sign-in-username-mutation.js";
+import { accountInfoOptions as dt, ensureAccountInfo as ft, fetchAccountInfo as pt, prefetchAccountInfo as mt, useAccountInfo as ht } from "./queries/settings/account-info-query.js";
+export { i as Apple, a as Atlassian, n as AuthProvider, o as Cognito, s as Discord, c as Dropbox, l as Facebook, e as FetchOptionsProvider, u as Figma, d as GitHub, f as GitLab, p as Google, m as HuggingFace, h as Kakao, g as Kick, _ as Line, v as Linear, y as LinkedIn, b as Microsoft, x as Naver, S as Notion, w as PayPal, C as Paybin, T as Polar, E as Railway, D as Reddit, O as Roblox, k as Salesforce, A as Slack, j as Spotify, z as ThemePreviewDark, B as ThemePreviewLight, V as ThemePreviewSystem, M as TikTok, N as Twitch, F as VK, P as Vercel, I as WeChat, L as X, R as Zoom, dt as accountInfoOptions, je as addPasskeyOptions, Y as authMutationOptions, Q as authQueryOptions, Le as changeEmailOptions, ze as changePasswordOptions, Ne as deletePasskeyOptions, Ve as deleteUserOptions, ft as ensureAccountInfo, Qe as ensureListAccounts, _e as ensureListDeviceSessions, Ee as ensureListPasskeys, Ge as ensureListSessions, H as ensureSession, pt as fetchAccountInfo, $e as fetchListAccounts, ve as fetchListDeviceSessions, De as fetchListPasskeys, Ke as fetchListSessions, U as fetchSession, st as isUsernameAvailableOptions, Ue as linkSocialOptions, et as listAccountsOptions, ye as listDeviceSessionsOptions, Oe as listPasskeysOptions, qe as listSessionsOptions, mt as prefetchAccountInfo, tt as prefetchListAccounts, be as prefetchListDeviceSessions, ke as prefetchListPasskeys, Je as prefetchListSessions, W as prefetchSession, ee as providerIcons, te as requestPasswordResetOptions, re as resetPasswordOptions, Se as revokeMultiSessionOptions, Xe as revokeSessionOptions, ae as sendVerificationEmailOptions, G as sessionOptions, we as setActiveSessionOptions, se as signInEmailOptions, he as signInMagicLinkOptions, Fe as signInPasskeyOptions, le as signInSocialOptions, lt as signInUsernameOptions, de as signOutOptions, pe as signUpEmailOptions, rt as unlinkAccountOptions, at as updateUserOptions, ht as useAccountInfo, Me as useAddPasskey, r as useAuth, X as useAuthMutation, Z as useAuthPlugin, $ as useAuthQuery, q as useAuthenticate, Re as useChangeEmail, Be as useChangePassword, Pe as useDeletePasskey, He as useDeleteUser, t as useFetchOptions, ct as useIsUsernameAvailable, We as useLinkSocial, nt as useListAccounts, xe as useListDeviceSessions, Ae as useListPasskeys, Ye as useListSessions, ne as useRequestPasswordReset, ie as useResetPassword, Ce as useRevokeMultiSession, Ze as useRevokeSession, oe as useSendVerificationEmail, K as useSession, Te as useSetActiveSession, ce as useSignInEmail, ge as useSignInMagicLink, Ie as useSignInPasskey, ue as useSignInSocial, ut as useSignInUsername, fe as useSignOut, me as useSignUpEmail, it as useUnlinkAccount, ot as useUpdateUser, J as useUser };

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

@@ -26,6 +26,8 @@ export type UserMenuItemProps = {
 export type AuthPluginComponents = {
     /** Rendered below the submit button in auth forms. */
     authButtons?: ComponentType<AuthButtonProps>[];
+    /** Captcha widget rendered above the submit button, below additionalFields. Singular — only one captcha can be active at a time. */
+    captchaComponent?: ReactNode;
     /** Rendered as cards inside security settings. */
     securityCards?: ComponentType<SecurityCardProps>[];
     /** Rendered as cards inside account settings. */

package/dist/plugins/captcha-plugin.d.ts

@@ -0,0 +1,29 @@
+import { ComponentType } from 'react';
+/** Props passed to the consumer's `render` component. */
+export type CaptchaRenderProps = {
+    /** Call once the user solves the captcha. */
+    setToken: (token: string) => void;
+    /** Call on error/expire to clear the token. */
+    clearToken: () => void;
+    /**
+     * Register your widget's `reset()`. Forms call it after a failed
+     * submission since captcha tokens are single-use. Pass `null` on unmount.
+     */
+    setReset: (reset: (() => void) | null) => void;
+};
+export type CaptchaPluginOptions = {
+    /** Renders the captcha widget. Wire `setToken`, `clearToken`, `setReset`. */
+    render: ComponentType<CaptchaRenderProps>;
+};
+/**
+ * Provider-agnostic captcha plugin. Forwards the resolved token via the
+ * `x-captcha-response` header on Better Auth requests.
+ */
+export declare const captchaPlugin: ((args_0: CaptchaPluginOptions) => Omit<{
+    render: ComponentType<CaptchaRenderProps>;
+    captchaComponent: import("react/jsx-runtime").JSX.Element;
+}, "id"> & {
+    id: "captcha";
+}) & {
+    id: "captcha";
+};

package/dist/plugins/captcha-plugin.js

@@ -0,0 +1,29 @@
+"use client";
+import { useFetchOptions as e } from "../components/auth/fetch-options-provider.js";
+import { useAuthPlugin as t } from "../hooks/use-auth-plugin.js";
+import { createAuthPlugin as n } from "@better-auth-ui/core";
+import { useCallback as r, useEffect as i } from "react";
+import { jsx as a } from "react/jsx-runtime";
+//#region src/plugins/captcha-plugin.tsx
+function o() {
+	let { render: n } = t(s), { setFetchOptions: o, registerReset: c } = e(), l = r((e) => {
+		o({ headers: { "x-captcha-response": e } });
+	}, [o]), u = r(() => {
+		o(void 0);
+	}, [o]), d = r((e) => {
+		c(e);
+	}, [c]);
+	return i(() => () => {
+		o(void 0), c(null);
+	}, [o, c]), /* @__PURE__ */ a(n, {
+		setToken: l,
+		clearToken: u,
+		setReset: d
+	});
+}
+var s = n("captcha", ({ render: e }) => ({
+	render: e,
+	captchaComponent: /* @__PURE__ */ a(o, {})
+}));
+//#endregion
+export { s as captchaPlugin };

package/dist/plugins.d.ts

@@ -0,0 +1 @@
+export * from './plugins/captcha-plugin';

package/dist/plugins.js

@@ -0,0 +1,3 @@
+"use client";
+import { captchaPlugin as e } from "./plugins/captcha-plugin.js";
+export { e as captchaPlugin };

package/package.json

@@ -1,10 +1,10 @@
 {
   "name": "@better-auth-ui/react",
-  "version": "1.6.4",
+  "version": "1.6.6",
   "type": "module",
   "scripts": {
     "build": "vite build",
-    "dev": "vite build --watch",
+    "dev": "tsc --watch",
     "email": "email dev --dir src/components/auth/email -p 9000",
     "test": "vitest"
   },
@@ -26,13 +26,17 @@
     "./server": {
       "types": "./dist/server.d.ts",
       "import": "./dist/server.js"
+    },
+    "./plugins": {
+      "types": "./dist/plugins.d.ts",
+      "import": "./dist/plugins.js"
     }
   },
   "devDependencies": {
     "@better-auth/passkey": "^1.6.9",
     "@react-email/components": "^1.0.12",
     "@react-email/preview-server": "^5.2.10",
-    "@tanstack/react-query": "^5.100.8",
+    "@tanstack/react-query": "^5.100.9",
     "@testing-library/react": "^16.3.2",
     "@testing-library/user-event": "^14.5.2",
     "@types/react": "^19.2.14",
@@ -41,26 +45,26 @@
     "better-auth": "^1.6.9",
     "clsx": "^2.1.1",
     "playwright": "^1.59.1",
-    "react": "^19.2.5",
-    "react-dom": "^19.2.5",
-    "react-email": "^6.0.5",
+    "react": "^19.2.6",
+    "react-dom": "^19.2.6",
+    "react-email": "^6.1.1",
     "tailwind-merge": "^3.5.0",
-    "tailwindcss": "^4.2.4",
+    "tailwindcss": "^4.3.0",
     "vitest": "^4.1.5",
-    "zod": "^4.4.2"
+    "zod": "^4.4.3"
   },
   "peerDependencies": {
     "@better-auth-ui/core": "*",
     "@better-auth/passkey": ">=1.6.9",
     "@react-email/components": ">=1.0.12",
-    "@tanstack/react-query": ">=5.100.8",
+    "@tanstack/react-query": ">=5.100.9",
     "better-auth": ">=1.6.9",
     "clsx": ">=2.0.0",
-    "react": ">=19.2.5",
-    "react-dom": ">=19.2.5",
+    "react": ">=19.2.6",
+    "react-dom": ">=19.2.6",
     "tailwind-merge": ">=3.5.0",
-    "tailwindcss": ">=4.2.4",
-    "zod": ">=4.4.2"
+    "tailwindcss": ">=4.3.0",
+    "zod": ">=4.4.3"
   },
   "repository": {
     "type": "git",

package/src/components/auth/auth-provider.tsx

@@ -18,8 +18,8 @@ import {
   type ReactNode,
   useContext
 } from "react"
-
 import type { AuthClient } from "../../lib/auth-client"
+import { FetchOptionsProvider } from "./fetch-options-provider"
 
 const AuthContext = createContext<AuthConfig | undefined>(undefined)
 
@@ -108,7 +108,7 @@ export function AuthProvider({
   if (contextQueryClient) {
     return (
       <AuthContext.Provider value={mergedConfig}>
-        {children}
+        <FetchOptionsProvider>{children}</FetchOptionsProvider>
       </AuthContext.Provider>
     )
   }
@@ -116,7 +116,7 @@ export function AuthProvider({
   return (
     <QueryClientProvider client={queryClient || fallbackQueryClient}>
       <AuthContext.Provider value={mergedConfig}>
-        {children}
+        <FetchOptionsProvider>{children}</FetchOptionsProvider>
       </AuthContext.Provider>
     </QueryClientProvider>
   )

package/src/components/auth/fetch-options-provider.tsx

@@ -0,0 +1,77 @@
+"use client"
+
+import {
+  createContext,
+  type PropsWithChildren,
+  useCallback,
+  useContext,
+  useRef,
+  useState
+} from "react"
+
+/** Subset of BetterFetchOptions we expose. Add fields as use-cases arise. */
+export type FetchOptions = {
+  headers?: Record<string, string>
+  body?: Record<string, unknown>
+}
+
+type FetchOptionsContextValue = {
+  /** Current fetchOptions, or `undefined` when none are set. */
+  fetchOptions: FetchOptions | undefined
+  /** OVERRIDES the entire fetchOptions object. Pass `undefined` to clear. */
+  setFetchOptions: (fetchOptions: FetchOptions | undefined) => void
+  /** Clears `fetchOptions` and runs the registered reset (e.g. captcha widget). Call from form `onError`. */
+  resetFetchOptions: () => void
+  /** Register a reset handler. Used by `captchaPlugin`. Pass `null` to clear. */
+  registerReset: (reset: (() => void) | null) => void
+}
+
+const FetchOptionsContext = createContext<FetchOptionsContextValue | undefined>(
+  undefined
+)
+
+export function FetchOptionsProvider({ children }: PropsWithChildren) {
+  const [current, setCurrent] = useState<FetchOptions | undefined>(undefined)
+  const resetRef = useRef<(() => void) | null>(null)
+
+  const setFetchOptions = useCallback(
+    (fetchOptions: FetchOptions | undefined) => {
+      setCurrent(fetchOptions)
+    },
+    []
+  )
+
+  const registerReset = useCallback((reset: (() => void) | null) => {
+    resetRef.current = reset
+  }, [])
+
+  const resetFetchOptions = useCallback(() => {
+    setCurrent(undefined)
+    resetRef.current?.()
+  }, [])
+
+  return (
+    <FetchOptionsContext.Provider
+      value={{
+        fetchOptions: current,
+        setFetchOptions,
+        resetFetchOptions,
+        registerReset
+      }}
+    >
+      {children}
+    </FetchOptionsContext.Provider>
+  )
+}
+
+export function useFetchOptions(): FetchOptionsContextValue {
+  const ctx = useContext(FetchOptionsContext)
+
+  if (!ctx) {
+    throw new Error(
+      "[Better Auth UI] useFetchOptions must be used within FetchOptionsProvider"
+    )
+  }
+
+  return ctx
+}

package/src/index.ts

@@ -1,6 +1,7 @@
 "use client"
 
 export * from "./components/auth/auth-provider"
+export * from "./components/auth/fetch-options-provider"
 export * from "./components/icons"
 export * from "./components/settings/account/theme-preview"
 export * from "./hooks/auth/use-authenticate"

package/src/lib/auth-plugin.ts

@@ -32,6 +32,8 @@ export type UserMenuItemProps = {
 export type AuthPluginComponents = {
   /** Rendered below the submit button in auth forms. */
   authButtons?: ComponentType<AuthButtonProps>[]
+  /** Captcha widget rendered above the submit button, below additionalFields. Singular — only one captcha can be active at a time. */
+  captchaComponent?: ReactNode
   /** Rendered as cards inside security settings. */
   securityCards?: ComponentType<SecurityCardProps>[]
   /** Rendered as cards inside account settings. */

package/src/plugins/captcha-plugin.tsx

@@ -0,0 +1,75 @@
+"use client"
+
+import { createAuthPlugin } from "@better-auth-ui/core"
+import {
+  type ComponentType,
+  type ReactNode,
+  useCallback,
+  useEffect
+} from "react"
+import { useFetchOptions } from "../components/auth/fetch-options-provider"
+import { useAuthPlugin } from "../hooks/use-auth-plugin"
+
+/** Props passed to the consumer's `render` component. */
+export type CaptchaRenderProps = {
+  /** Call once the user solves the captcha. */
+  setToken: (token: string) => void
+  /** Call on error/expire to clear the token. */
+  clearToken: () => void
+  /**
+   * Register your widget's `reset()`. Forms call it after a failed
+   * submission since captcha tokens are single-use. Pass `null` on unmount.
+   */
+  setReset: (reset: (() => void) | null) => void
+}
+
+export type CaptchaPluginOptions = {
+  /** Renders the captcha widget. Wire `setToken`, `clearToken`, `setReset`. */
+  render: ComponentType<CaptchaRenderProps>
+}
+
+function CaptchaWidget(): ReactNode {
+  const { render: Render } = useAuthPlugin(captchaPlugin)
+  const { setFetchOptions, registerReset } = useFetchOptions()
+
+  const setToken = useCallback(
+    (token: string) => {
+      setFetchOptions({ headers: { "x-captcha-response": token } })
+    },
+    [setFetchOptions]
+  )
+
+  const clearToken = useCallback(() => {
+    setFetchOptions(undefined)
+  }, [setFetchOptions])
+
+  const setReset = useCallback(
+    (reset: (() => void) | null) => {
+      registerReset(reset)
+    },
+    [registerReset]
+  )
+
+  useEffect(() => {
+    return () => {
+      setFetchOptions(undefined)
+      registerReset(null)
+    }
+  }, [setFetchOptions, registerReset])
+
+  return (
+    <Render setToken={setToken} clearToken={clearToken} setReset={setReset} />
+  )
+}
+
+/**
+ * Provider-agnostic captcha plugin. Forwards the resolved token via the
+ * `x-captcha-response` header on Better Auth requests.
+ */
+export const captchaPlugin = createAuthPlugin(
+  "captcha",
+  ({ render }: CaptchaPluginOptions) => ({
+    render,
+    captchaComponent: <CaptchaWidget />
+  })
+)

package/src/plugins.ts

@@ -0,0 +1,3 @@
+"use client"
+
+export * from "./plugins/captcha-plugin"