@better-auth-ui/react 1.6.6 → 1.6.8

package/dist/index.d.ts

@@ -10,6 +10,8 @@ export * from './hooks/use-auth-query';
 export type * from './lib/auth-client';
 export * from './lib/auth-plugin';
 export * from './lib/provider-icons';
+export * from './mutations/api-key/create-api-key-mutation';
+export * from './mutations/api-key/delete-api-key-mutation';
 export * from './mutations/auth/request-password-reset-mutation';
 export * from './mutations/auth/reset-password-mutation';
 export * from './mutations/auth/send-verification-email-mutation';
@@ -33,6 +35,7 @@ export * from './mutations/settings/unlink-account-mutation';
 export * from './mutations/settings/update-user-mutation';
 export * from './mutations/username/is-username-available-mutation';
 export * from './mutations/username/sign-in-username-mutation';
+export * from './queries/api-key/list-api-keys-query';
 export * from './queries/auth/session-query';
 export * from './queries/auth-query-options';
 export * from './queries/multi-session/list-device-sessions-query';

package/dist/index.js

@@ -47,31 +47,34 @@ 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 };
+import { ensureListApiKeys as te, fetchListApiKeys as ne, listApiKeysOptions as re, prefetchListApiKeys as ie, useListApiKeys as ae } from "./queries/api-key/list-api-keys-query.js";
+import { createApiKeyOptions as oe, useCreateApiKey as se } from "./mutations/api-key/create-api-key-mutation.js";
+import { deleteApiKeyOptions as ce, useDeleteApiKey as le } from "./mutations/api-key/delete-api-key-mutation.js";
+import { requestPasswordResetOptions as ue, useRequestPasswordReset as de } from "./mutations/auth/request-password-reset-mutation.js";
+import { resetPasswordOptions as fe, useResetPassword as pe } from "./mutations/auth/reset-password-mutation.js";
+import { sendVerificationEmailOptions as me, useSendVerificationEmail as he } from "./mutations/auth/send-verification-email-mutation.js";
+import { signInEmailOptions as ge, useSignInEmail as _e } from "./mutations/auth/sign-in-email-mutation.js";
+import { signInSocialOptions as ve, useSignInSocial as ye } from "./mutations/auth/sign-in-social-mutation.js";
+import { signOutOptions as be, useSignOut as xe } from "./mutations/auth/sign-out-mutation.js";
+import { signUpEmailOptions as Se, useSignUpEmail as Ce } from "./mutations/auth/sign-up-email-mutation.js";
+import { signInMagicLinkOptions as we, useSignInMagicLink as Te } from "./mutations/magic-link/sign-in-magic-link-mutation.js";
+import { ensureListDeviceSessions as Ee, fetchListDeviceSessions as De, listDeviceSessionsOptions as Oe, prefetchListDeviceSessions as ke, useListDeviceSessions as Ae } from "./queries/multi-session/list-device-sessions-query.js";
+import { revokeMultiSessionOptions as je, useRevokeMultiSession as Me } from "./mutations/multi-session/revoke-multi-session-mutation.js";
+import { setActiveSessionOptions as Ne, useSetActiveSession as Pe } from "./mutations/multi-session/set-active-session-mutation.js";
+import { ensureListPasskeys as Fe, fetchListPasskeys as Ie, listPasskeysOptions as Le, prefetchListPasskeys as Re, useListPasskeys as ze } from "./queries/passkey/list-passkeys-query.js";
+import { addPasskeyOptions as Be, useAddPasskey as Ve } from "./mutations/passkey/add-passkey-mutation.js";
+import { deletePasskeyOptions as He, useDeletePasskey as Ue } from "./mutations/passkey/delete-passkey-mutation.js";
+import { signInPasskeyOptions as We, useSignInPasskey as Ge } from "./mutations/passkey/sign-in-passkey-mutation.js";
+import { changeEmailOptions as Ke, useChangeEmail as qe } from "./mutations/settings/change-email-mutation.js";
+import { changePasswordOptions as Je, useChangePassword as Ye } from "./mutations/settings/change-password-mutation.js";
+import { deleteUserOptions as Xe, useDeleteUser as Ze } from "./mutations/settings/delete-user-mutation.js";
+import { linkSocialOptions as Qe, useLinkSocial as $e } from "./mutations/settings/link-social-mutation.js";
+import { ensureListSessions as et, fetchListSessions as tt, listSessionsOptions as nt, prefetchListSessions as rt, useListSessions as it } from "./queries/settings/list-sessions-query.js";
+import { revokeSessionOptions as at, useRevokeSession as ot } from "./mutations/settings/revoke-session-mutation.js";
+import { ensureListAccounts as st, fetchListAccounts as ct, listAccountsOptions as lt, prefetchListAccounts as ut, useListAccounts as dt } from "./queries/settings/list-accounts-query.js";
+import { unlinkAccountOptions as ft, useUnlinkAccount as pt } from "./mutations/settings/unlink-account-mutation.js";
+import { updateUserOptions as mt, useUpdateUser as ht } from "./mutations/settings/update-user-mutation.js";
+import { isUsernameAvailableOptions as gt, useIsUsernameAvailable as _t } from "./mutations/username/is-username-available-mutation.js";
+import { signInUsernameOptions as vt, useSignInUsername as yt } from "./mutations/username/sign-in-username-mutation.js";
+import { accountInfoOptions as bt, ensureAccountInfo as xt, fetchAccountInfo as St, prefetchAccountInfo as Ct, useAccountInfo as wt } 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, bt as accountInfoOptions, Be as addPasskeyOptions, Y as authMutationOptions, Q as authQueryOptions, Ke as changeEmailOptions, Je as changePasswordOptions, oe as createApiKeyOptions, ce as deleteApiKeyOptions, He as deletePasskeyOptions, Xe as deleteUserOptions, xt as ensureAccountInfo, st as ensureListAccounts, te as ensureListApiKeys, Ee as ensureListDeviceSessions, Fe as ensureListPasskeys, et as ensureListSessions, H as ensureSession, St as fetchAccountInfo, ct as fetchListAccounts, ne as fetchListApiKeys, De as fetchListDeviceSessions, Ie as fetchListPasskeys, tt as fetchListSessions, U as fetchSession, gt as isUsernameAvailableOptions, Qe as linkSocialOptions, lt as listAccountsOptions, re as listApiKeysOptions, Oe as listDeviceSessionsOptions, Le as listPasskeysOptions, nt as listSessionsOptions, Ct as prefetchAccountInfo, ut as prefetchListAccounts, ie as prefetchListApiKeys, ke as prefetchListDeviceSessions, Re as prefetchListPasskeys, rt as prefetchListSessions, W as prefetchSession, ee as providerIcons, ue as requestPasswordResetOptions, fe as resetPasswordOptions, je as revokeMultiSessionOptions, at as revokeSessionOptions, me as sendVerificationEmailOptions, G as sessionOptions, Ne as setActiveSessionOptions, ge as signInEmailOptions, we as signInMagicLinkOptions, We as signInPasskeyOptions, ve as signInSocialOptions, vt as signInUsernameOptions, be as signOutOptions, Se as signUpEmailOptions, ft as unlinkAccountOptions, mt as updateUserOptions, wt as useAccountInfo, Ve as useAddPasskey, r as useAuth, X as useAuthMutation, Z as useAuthPlugin, $ as useAuthQuery, q as useAuthenticate, qe as useChangeEmail, Ye as useChangePassword, se as useCreateApiKey, le as useDeleteApiKey, Ue as useDeletePasskey, Ze as useDeleteUser, t as useFetchOptions, _t as useIsUsernameAvailable, $e as useLinkSocial, dt as useListAccounts, ae as useListApiKeys, Ae as useListDeviceSessions, ze as useListPasskeys, it as useListSessions, de as useRequestPasswordReset, pe as useResetPassword, Me as useRevokeMultiSession, ot as useRevokeSession, he as useSendVerificationEmail, K as useSession, Pe as useSetActiveSession, _e as useSignInEmail, Te as useSignInMagicLink, Ge as useSignInPasskey, ye as useSignInSocial, yt as useSignInUsername, xe as useSignOut, Ce as useSignUpEmail, pt as useUnlinkAccount, ht as useUpdateUser, J as useUser };

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

@@ -1,3 +1,4 @@
+import { apiKeyClient } from '@better-auth/api-key/client';
 import { passkeyClient } from '@better-auth/passkey/client';
 import { magicLinkClient, multiSessionClient, usernameClient } from 'better-auth/client/plugins';
 import { createAuthClient } from 'better-auth/react';
@@ -11,6 +12,9 @@ export type MultiSessionAuthClient = ReturnType<typeof createAuthClient<{
 export type PasskeyAuthClient = ReturnType<typeof createAuthClient<{
     plugins: [ReturnType<typeof passkeyClient>];
 }>>;
+export type ApiKeyAuthClient = ReturnType<typeof createAuthClient<{
+    plugins: [ReturnType<typeof apiKeyClient>];
+}>>;
 export type UsernameAuthClient = ReturnType<typeof createAuthClient<{
     plugins: [ReturnType<typeof usernameClient>];
 }>>;

package/dist/mutations/api-key/create-api-key-mutation.d.ts

@@ -0,0 +1,65 @@
+import { BetterFetchError } from 'better-auth/react';
+import { ApiKeyAuthClient } from '../../lib/auth-client';
+export type CreateApiKeyParams<TAuthClient extends ApiKeyAuthClient> = Parameters<TAuthClient["apiKey"]["create"]>[0];
+export type CreateApiKeyOptions<TAuthClient extends ApiKeyAuthClient> = Omit<ReturnType<typeof createApiKeyOptions<TAuthClient>>, "mutationKey" | "mutationFn">;
+/**
+ * Mutation options factory for creating an API key.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ */
+export declare function createApiKeyOptions<TAuthClient extends ApiKeyAuthClient>(authClient: TAuthClient): import('@tanstack/react-query').WithRequired<import('@tanstack/react-query').UseMutationOptions<{
+    key: string;
+    metadata: any;
+    permissions: any;
+    id: string;
+    configId: string;
+    name: string | null;
+    start: string | null;
+    prefix: string | null;
+    referenceId: string;
+    refillInterval: number | null;
+    refillAmount: number | null;
+    lastRefillAt: Date | null;
+    enabled: boolean;
+    rateLimitEnabled: boolean;
+    rateLimitTimeWindow: number | null;
+    rateLimitMax: number | null;
+    requestCount: number;
+    remaining: number | null;
+    lastRequest: Date | null;
+    expiresAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}, BetterFetchError, CreateApiKeyParams<TAuthClient>, unknown>, "mutationKey">;
+/**
+ * Create a mutation for creating an API key.
+ *
+ * Refetches the user's API key list on success unless disabled via options.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export declare function useCreateApiKey<TAuthClient extends ApiKeyAuthClient>(authClient: TAuthClient, options?: CreateApiKeyOptions<TAuthClient>): import('@tanstack/react-query').UseMutationResult<{
+    key: string;
+    metadata: any;
+    permissions: any;
+    id: string;
+    configId: string;
+    name: string | null;
+    start: string | null;
+    prefix: string | null;
+    referenceId: string;
+    refillInterval: number | null;
+    refillAmount: number | null;
+    lastRefillAt: Date | null;
+    enabled: boolean;
+    rateLimitEnabled: boolean;
+    rateLimitTimeWindow: number | null;
+    rateLimitMax: number | null;
+    requestCount: number;
+    remaining: number | null;
+    lastRequest: Date | null;
+    expiresAt: Date | null;
+    createdAt: Date;
+    updatedAt: Date;
+}, BetterFetchError, CreateApiKeyParams<TAuthClient>, unknown>;

package/dist/mutations/api-key/create-api-key-mutation.js

@@ -0,0 +1,29 @@
+import { useListApiKeys as e } from "../../queries/api-key/list-api-keys-query.js";
+import { mutationOptions as t, useMutation as n } from "@tanstack/react-query";
+import { apiKeyMutationKeys as r } from "@better-auth-ui/core/plugins";
+//#region src/mutations/api-key/create-api-key-mutation.ts
+function i(e) {
+	let n = r.createApiKey;
+	return t({
+		mutationKey: n,
+		mutationFn: (t) => e.apiKey.create({
+			...t,
+			fetchOptions: {
+				...t?.fetchOptions,
+				throw: !0
+			}
+		})
+	});
+}
+function a(t, r) {
+	let { refetch: a } = e(t, { refetchOnMount: !1 });
+	return n({
+		...i(t),
+		...r,
+		onSuccess: async (...e) => {
+			await a(), await r?.onSuccess?.(...e);
+		}
+	});
+}
+//#endregion
+export { i as createApiKeyOptions, a as useCreateApiKey };

package/dist/mutations/api-key/delete-api-key-mutation.d.ts

@@ -0,0 +1,21 @@
+import { BetterFetchError } from 'better-auth/react';
+import { ApiKeyAuthClient } from '../../lib/auth-client';
+export type DeleteApiKeyParams<TAuthClient extends ApiKeyAuthClient> = Parameters<TAuthClient["apiKey"]["delete"]>[0];
+export type DeleteApiKeyOptions<TAuthClient extends ApiKeyAuthClient> = Omit<ReturnType<typeof deleteApiKeyOptions<TAuthClient>>, "mutationKey" | "mutationFn">;
+/**
+ * Mutation options factory for deleting an API key.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ */
+export declare function deleteApiKeyOptions<TAuthClient extends ApiKeyAuthClient>(authClient: TAuthClient): import('@tanstack/react-query').WithRequired<import('@tanstack/react-query').UseMutationOptions<{
+    success: boolean;
+}, BetterFetchError, DeleteApiKeyParams<TAuthClient>, unknown>, "mutationKey">;
+/**
+ * Create a mutation for deleting an API key.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export declare function useDeleteApiKey<TAuthClient extends ApiKeyAuthClient>(authClient: TAuthClient, options?: DeleteApiKeyOptions<TAuthClient>): import('@tanstack/react-query').UseMutationResult<{
+    success: boolean;
+}, BetterFetchError, DeleteApiKeyParams<TAuthClient>, unknown>;

package/dist/mutations/api-key/delete-api-key-mutation.js

@@ -0,0 +1,29 @@
+import { useListApiKeys as e } from "../../queries/api-key/list-api-keys-query.js";
+import { mutationOptions as t, useMutation as n } from "@tanstack/react-query";
+import { apiKeyMutationKeys as r } from "@better-auth-ui/core/plugins";
+//#region src/mutations/api-key/delete-api-key-mutation.ts
+function i(e) {
+	let n = r.deleteApiKey;
+	return t({
+		mutationKey: n,
+		mutationFn: (t) => e.apiKey.delete({
+			...t,
+			fetchOptions: {
+				...t?.fetchOptions,
+				throw: !0
+			}
+		})
+	});
+}
+function a(t, r) {
+	let { refetch: a } = e(t, { refetchOnMount: !1 });
+	return n({
+		...i(t),
+		...r,
+		onSuccess: async (...e) => {
+			await a(), await r?.onSuccess?.(...e);
+		}
+	});
+}
+//#endregion
+export { i as deleteApiKeyOptions, a as useDeleteApiKey };

package/dist/mutations/passkey/sign-in-passkey-mutation.d.ts

@@ -20,6 +20,14 @@ export declare function signInPasskeyOptions<TAuthClient extends PasskeyAuthClie
         user: import('better-auth').User;
     };
     error: null;
+} | {
+    data: null;
+    error: {
+        code: string;
+        message: string;
+        status: number;
+        statusText: string;
+    };
 } | {
     webauthn: {
         response: import('@better-auth/passkey/client').AuthenticationResponseJSON;
@@ -41,14 +49,6 @@ export declare function signInPasskeyOptions<TAuthClient extends PasskeyAuthClie
         user: import('better-auth').User;
     };
     error: null;
-} | {
-    data: null;
-    error: {
-        code: string;
-        message: string;
-        status: number;
-        statusText: string;
-    };
 }, BetterFetchError, void | SignInPasskeyParams<TAuthClient> | undefined, unknown>, "mutationKey">;
 /**
  * Create a mutation for passkey sign-in.
@@ -73,6 +73,14 @@ export declare function useSignInPasskey<TAuthClient extends PasskeyAuthClient>(
         user: import('better-auth').User;
     };
     error: null;
+} | {
+    data: null;
+    error: {
+        code: string;
+        message: string;
+        status: number;
+        statusText: string;
+    };
 } | {
     webauthn: {
         response: import('@better-auth/passkey/client').AuthenticationResponseJSON;
@@ -94,12 +102,4 @@ export declare function useSignInPasskey<TAuthClient extends PasskeyAuthClient>(
         user: import('better-auth').User;
     };
     error: null;
-} | {
-    data: null;
-    error: {
-        code: string;
-        message: string;
-        status: number;
-        statusText: string;
-    };
 }, BetterFetchError, void | SignInPasskeyParams<TAuthClient> | undefined, unknown>;

package/dist/mutations/username/sign-in-username-mutation.d.ts

@@ -8,7 +8,9 @@ export type SignInUsernameOptions<TAuthClient extends UsernameAuthClient> = Omit
  * @param authClient - The Better Auth client.
  */
 export declare function signInUsernameOptions<TAuthClient extends UsernameAuthClient>(authClient: TAuthClient): import('@tanstack/react-query').WithRequired<import('@tanstack/react-query').UseMutationOptions<Omit<{
+    redirect: boolean;
     token: string;
+    url: string | undefined;
     user: {
         id: string;
         createdAt: Date;
@@ -46,7 +48,9 @@ export declare function signInUsernameOptions<TAuthClient extends UsernameAuthCl
  * @param options - React Query options forwarded to `useMutation`.
  */
 export declare function useSignInUsername<TAuthClient extends UsernameAuthClient>(authClient: TAuthClient, options?: SignInUsernameOptions<TAuthClient>): import('@tanstack/react-query').UseMutationResult<Omit<{
+    redirect: boolean;
     token: string;
+    url: string | undefined;
     user: {
         id: string;
         createdAt: Date;

package/dist/queries/api-key/list-api-keys-query.d.ts

@@ -0,0 +1,64 @@
+import { DataTag, QueryClient } from '@tanstack/react-query';
+import { BetterFetchError } from 'better-auth/react';
+import { ApiKeyAuthClient, InferData } from '../../lib/auth-client';
+export type ListApiKeysData<TAuthClient extends ApiKeyAuthClient> = InferData<TAuthClient["apiKey"]["list"]>;
+export type ListApiKeysParams<TAuthClient extends ApiKeyAuthClient> = Parameters<TAuthClient["apiKey"]["list"]>[0];
+export type ListedApiKey<TAuthClient extends ApiKeyAuthClient = ApiKeyAuthClient> = NonNullable<ListApiKeysData<TAuthClient>>["apiKeys"][number];
+export type ListApiKeysOptions<TAuthClient extends ApiKeyAuthClient> = Omit<ReturnType<typeof listApiKeysOptions<TAuthClient>>, "queryKey" | "queryFn">;
+/**
+ * Query options factory for the current user's API keys.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param userId - The current signed-in user's ID. Used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.apiKey.list`.
+ */
+export declare function listApiKeysOptions<TAuthClient extends ApiKeyAuthClient>(authClient: TAuthClient, userId: string | undefined, params?: ListApiKeysParams<TAuthClient>): (import('@tanstack/react-query').OmitKeyof<import('@tanstack/react-query').UseQueryOptions<InferData<TAuthClient["apiKey"]["list"]>, BetterFetchError, InferData<TAuthClient["apiKey"]["list"]>, readonly ["auth", "user", string | undefined, "listApiKeys", {
+    configId?: string | undefined;
+    organizationId?: string | undefined;
+    limit?: unknown;
+    offset?: unknown;
+    sortBy?: string | undefined;
+    sortDirection?: "asc" | "desc" | undefined;
+} | null]>, "queryFn"> & {
+    queryFn?: import('@tanstack/react-query').QueryFunction<InferData<TAuthClient["apiKey"]["list"]>, readonly ["auth", "user", string | undefined, "listApiKeys", {
+        configId?: string | undefined;
+        organizationId?: string | undefined;
+        limit?: unknown;
+        offset?: unknown;
+        sortBy?: string | undefined;
+        sortDirection?: "asc" | "desc" | undefined;
+    } | null], never> | undefined;
+} & {
+    queryKey: readonly ["auth", "user", string | undefined, "listApiKeys", {
+        configId?: string | undefined;
+        organizationId?: string | undefined;
+        limit?: unknown;
+        offset?: unknown;
+        sortBy?: string | undefined;
+        sortDirection?: "asc" | "desc" | undefined;
+    } | null] & {
+        [dataTagSymbol]: InferData<TAuthClient["apiKey"]["list"]>;
+        [dataTagErrorSymbol]: BetterFetchError;
+    };
+}) & {
+    queryKey: DataTag<readonly ["auth", "user", string | undefined, "listApiKeys", {
+        configId?: string | undefined;
+        organizationId?: string | undefined;
+        limit?: unknown;
+        offset?: unknown;
+        sortBy?: string | undefined;
+        sortDirection?: "asc" | "desc" | undefined;
+    } | null], InferData<TAuthClient["apiKey"]["list"]>, BetterFetchError>;
+};
+export declare const ensureListApiKeys: <TAuthClient extends ApiKeyAuthClient>(queryClient: QueryClient, authClient: TAuthClient, userId: string, params?: ListApiKeysParams<TAuthClient>) => Promise<InferData<TAuthClient["apiKey"]["list"]>>;
+export declare const prefetchListApiKeys: <TAuthClient extends ApiKeyAuthClient>(queryClient: QueryClient, authClient: TAuthClient, userId: string, params?: ListApiKeysParams<TAuthClient>) => Promise<void>;
+export declare const fetchListApiKeys: <TAuthClient extends ApiKeyAuthClient>(queryClient: QueryClient, authClient: TAuthClient, userId: string, params?: ListApiKeysParams<TAuthClient>) => Promise<InferData<TAuthClient["apiKey"]["list"]>>;
+export type UseListApiKeysOptions<TAuthClient extends ApiKeyAuthClient> = ListApiKeysOptions<TAuthClient> & ListApiKeysParams<TAuthClient>;
+/**
+ * Subscribe to the current user's API keys via TanStack Query.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param options - `apiKey.list` params merged with `useQuery` options.
+ * @param queryClient - Optional custom `QueryClient`.
+ */
+export declare function useListApiKeys<TAuthClient extends ApiKeyAuthClient>(authClient: TAuthClient, options?: UseListApiKeysOptions<TAuthClient>, queryClient?: QueryClient): import('@tanstack/react-query').UseQueryResult<import('@tanstack/react-query').NoInfer<InferData<TAuthClient["apiKey"]["list"]>>, BetterFetchError>;

package/dist/queries/api-key/list-api-keys-query.js

@@ -0,0 +1,31 @@
+import { useSession as e } from "../auth/session-query.js";
+import { authQueryKeys as t } from "@better-auth-ui/core";
+import { queryOptions as n, skipToken as r, useQuery as i } from "@tanstack/react-query";
+//#region src/queries/api-key/list-api-keys-query.ts
+function a(e, r, i) {
+	return n({
+		queryKey: t.listApiKeys(r, i?.query),
+		queryFn: ({ signal: t }) => e.apiKey.list({
+			...i,
+			fetchOptions: {
+				...i?.fetchOptions,
+				signal: t,
+				throw: !0
+			}
+		})
+	});
+}
+var o = (e, t, n, r) => e.ensureQueryData(a(t, n, r)), s = (e, t, n, r) => e.prefetchQuery(a(t, n, r)), c = (e, t, n, r) => e.fetchQuery(a(t, n, r));
+function l(t, n = {}, o) {
+	let { data: s } = e(t, void 0, o), c = s?.user.id, { query: l, fetchOptions: u, ...d } = n, f = a(t, c, {
+		query: l,
+		fetchOptions: u
+	});
+	return i({
+		...d,
+		...f,
+		queryFn: c ? f.queryFn : r
+	}, o);
+}
+//#endregion
+export { o as ensureListApiKeys, c as fetchListApiKeys, a as listApiKeysOptions, s as prefetchListApiKeys, l as useListApiKeys };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-auth-ui/react",
-  "version": "1.6.6",
+  "version": "1.6.8",
   "type": "module",
   "scripts": {
     "build": "vite build",
@@ -33,7 +33,8 @@
     }
   },
   "devDependencies": {
-    "@better-auth/passkey": "^1.6.9",
+    "@better-auth/api-key": "^1.6.9",
+    "@better-auth/passkey": "^1.6.10",
     "@react-email/components": "^1.0.12",
     "@react-email/preview-server": "^5.2.10",
     "@tanstack/react-query": "^5.100.9",
@@ -42,7 +43,7 @@
     "@types/react": "^19.2.14",
     "@vitejs/plugin-react": "^6.0.1",
     "@vitest/browser-playwright": "^4.1.5",
-    "better-auth": "^1.6.9",
+    "better-auth": "^1.6.10",
     "clsx": "^2.1.1",
     "playwright": "^1.59.1",
     "react": "^19.2.6",
@@ -55,10 +56,11 @@
   },
   "peerDependencies": {
     "@better-auth-ui/core": "*",
-    "@better-auth/passkey": ">=1.6.9",
+    "@better-auth/api-key": ">=1.6.9",
+    "@better-auth/passkey": ">=1.6.10",
     "@react-email/components": ">=1.0.12",
     "@tanstack/react-query": ">=5.100.9",
-    "better-auth": ">=1.6.9",
+    "better-auth": ">=1.6.10",
     "clsx": ">=2.0.0",
     "react": ">=19.2.6",
     "react-dom": ">=19.2.6",

package/src/index.ts

@@ -12,6 +12,8 @@ export * from "./hooks/use-auth-query"
 export type * from "./lib/auth-client"
 export * from "./lib/auth-plugin"
 export * from "./lib/provider-icons"
+export * from "./mutations/api-key/create-api-key-mutation"
+export * from "./mutations/api-key/delete-api-key-mutation"
 export * from "./mutations/auth/request-password-reset-mutation"
 export * from "./mutations/auth/reset-password-mutation"
 export * from "./mutations/auth/send-verification-email-mutation"
@@ -35,6 +37,7 @@ export * from "./mutations/settings/unlink-account-mutation"
 export * from "./mutations/settings/update-user-mutation"
 export * from "./mutations/username/is-username-available-mutation"
 export * from "./mutations/username/sign-in-username-mutation"
+export * from "./queries/api-key/list-api-keys-query"
 export * from "./queries/auth/session-query"
 export * from "./queries/auth-query-options"
 export * from "./queries/multi-session/list-device-sessions-query"

package/src/lib/auth-client.ts

@@ -1,3 +1,4 @@
+import type { apiKeyClient } from "@better-auth/api-key/client"
 import type { passkeyClient } from "@better-auth/passkey/client"
 import type {
   magicLinkClient,
@@ -26,6 +27,10 @@ export type PasskeyAuthClient = ReturnType<
   typeof createAuthClient<{ plugins: [ReturnType<typeof passkeyClient>] }>
 >
 
+export type ApiKeyAuthClient = ReturnType<
+  typeof createAuthClient<{ plugins: [ReturnType<typeof apiKeyClient>] }>
+>
+
 export type UsernameAuthClient = ReturnType<
   typeof createAuthClient<{ plugins: [ReturnType<typeof usernameClient>] }>
 >

package/src/mutations/api-key/create-api-key-mutation.ts

@@ -0,0 +1,64 @@
+import { apiKeyMutationKeys } from "@better-auth-ui/core/plugins"
+import { mutationOptions, useMutation } from "@tanstack/react-query"
+import type { BetterFetchError } from "better-auth/react"
+
+import type { ApiKeyAuthClient } from "../../lib/auth-client"
+import { useListApiKeys } from "../../queries/api-key/list-api-keys-query"
+
+export type CreateApiKeyParams<TAuthClient extends ApiKeyAuthClient> =
+  Parameters<TAuthClient["apiKey"]["create"]>[0]
+
+export type CreateApiKeyOptions<TAuthClient extends ApiKeyAuthClient> = Omit<
+  ReturnType<typeof createApiKeyOptions<TAuthClient>>,
+  "mutationKey" | "mutationFn"
+>
+
+/**
+ * Mutation options factory for creating an API key.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ */
+export function createApiKeyOptions<TAuthClient extends ApiKeyAuthClient>(
+  authClient: TAuthClient
+) {
+  const mutationKey = apiKeyMutationKeys.createApiKey
+
+  const mutationFn = (params: CreateApiKeyParams<TAuthClient>) =>
+    authClient.apiKey.create({
+      ...params,
+      fetchOptions: { ...params?.fetchOptions, throw: true }
+    })
+
+  return mutationOptions<
+    Awaited<ReturnType<typeof mutationFn>>,
+    BetterFetchError,
+    Parameters<typeof mutationFn>[0]
+  >({
+    mutationKey,
+    mutationFn
+  })
+}
+
+/**
+ * Create a mutation for creating an API key.
+ *
+ * Refetches the user's API key list on success unless disabled via options.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export function useCreateApiKey<TAuthClient extends ApiKeyAuthClient>(
+  authClient: TAuthClient,
+  options?: CreateApiKeyOptions<TAuthClient>
+) {
+  const { refetch } = useListApiKeys(authClient, { refetchOnMount: false })
+
+  return useMutation({
+    ...createApiKeyOptions(authClient),
+    ...options,
+    onSuccess: async (...args) => {
+      await refetch()
+      await options?.onSuccess?.(...args)
+    }
+  })
+}

package/src/mutations/api-key/delete-api-key-mutation.ts

@@ -0,0 +1,62 @@
+import { apiKeyMutationKeys } from "@better-auth-ui/core/plugins"
+import { mutationOptions, useMutation } from "@tanstack/react-query"
+import type { BetterFetchError } from "better-auth/react"
+
+import type { ApiKeyAuthClient } from "../../lib/auth-client"
+import { useListApiKeys } from "../../queries/api-key/list-api-keys-query"
+
+export type DeleteApiKeyParams<TAuthClient extends ApiKeyAuthClient> =
+  Parameters<TAuthClient["apiKey"]["delete"]>[0]
+
+export type DeleteApiKeyOptions<TAuthClient extends ApiKeyAuthClient> = Omit<
+  ReturnType<typeof deleteApiKeyOptions<TAuthClient>>,
+  "mutationKey" | "mutationFn"
+>
+
+/**
+ * Mutation options factory for deleting an API key.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ */
+export function deleteApiKeyOptions<TAuthClient extends ApiKeyAuthClient>(
+  authClient: TAuthClient
+) {
+  const mutationKey = apiKeyMutationKeys.deleteApiKey
+
+  const mutationFn = (params: DeleteApiKeyParams<TAuthClient>) =>
+    authClient.apiKey.delete({
+      ...params,
+      fetchOptions: { ...params?.fetchOptions, throw: true }
+    })
+
+  return mutationOptions<
+    Awaited<ReturnType<typeof mutationFn>>,
+    BetterFetchError,
+    Parameters<typeof mutationFn>[0]
+  >({
+    mutationKey,
+    mutationFn
+  })
+}
+
+/**
+ * Create a mutation for deleting an API key.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export function useDeleteApiKey<TAuthClient extends ApiKeyAuthClient>(
+  authClient: TAuthClient,
+  options?: DeleteApiKeyOptions<TAuthClient>
+) {
+  const { refetch } = useListApiKeys(authClient, { refetchOnMount: false })
+
+  return useMutation({
+    ...deleteApiKeyOptions(authClient),
+    ...options,
+    onSuccess: async (...args) => {
+      await refetch()
+      await options?.onSuccess?.(...args)
+    }
+  })
+}

package/src/queries/api-key/list-api-keys-query.ts

@@ -0,0 +1,115 @@
+import { authQueryKeys } from "@better-auth-ui/core"
+import {
+  type DataTag,
+  type QueryClient,
+  queryOptions,
+  skipToken,
+  useQuery
+} from "@tanstack/react-query"
+import type { BetterFetchError } from "better-auth/react"
+
+import type { ApiKeyAuthClient, InferData } from "../../lib/auth-client"
+import { useSession } from "../auth/session-query"
+
+export type ListApiKeysData<TAuthClient extends ApiKeyAuthClient> = InferData<
+  TAuthClient["apiKey"]["list"]
+>
+
+export type ListApiKeysParams<TAuthClient extends ApiKeyAuthClient> =
+  Parameters<TAuthClient["apiKey"]["list"]>[0]
+
+export type ListedApiKey<
+  TAuthClient extends ApiKeyAuthClient = ApiKeyAuthClient
+> = NonNullable<ListApiKeysData<TAuthClient>>["apiKeys"][number]
+
+export type ListApiKeysOptions<TAuthClient extends ApiKeyAuthClient> = Omit<
+  ReturnType<typeof listApiKeysOptions<TAuthClient>>,
+  "queryKey" | "queryFn"
+>
+
+/**
+ * Query options factory for the current user's API keys.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param userId - The current signed-in user's ID. Used for cache partitioning.
+ * @param params - Parameters forwarded to `authClient.apiKey.list`.
+ */
+export function listApiKeysOptions<TAuthClient extends ApiKeyAuthClient>(
+  authClient: TAuthClient,
+  userId: string | undefined,
+  params?: ListApiKeysParams<TAuthClient>
+) {
+  type TData = ListApiKeysData<TAuthClient>
+  const queryKey = authQueryKeys.listApiKeys(userId, params?.query)
+
+  const options = queryOptions<TData, BetterFetchError, TData, typeof queryKey>(
+    {
+      queryKey,
+      queryFn: ({ signal }) =>
+        authClient.apiKey.list({
+          ...params,
+          fetchOptions: { ...params?.fetchOptions, signal, throw: true }
+        }) as Promise<TData>
+    }
+  )
+
+  return options as typeof options & {
+    queryKey: DataTag<typeof queryKey, TData, BetterFetchError>
+  }
+}
+
+export const ensureListApiKeys = <TAuthClient extends ApiKeyAuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListApiKeysParams<TAuthClient>
+) => queryClient.ensureQueryData(listApiKeysOptions(authClient, userId, params))
+
+export const prefetchListApiKeys = <TAuthClient extends ApiKeyAuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListApiKeysParams<TAuthClient>
+) => queryClient.prefetchQuery(listApiKeysOptions(authClient, userId, params))
+
+export const fetchListApiKeys = <TAuthClient extends ApiKeyAuthClient>(
+  queryClient: QueryClient,
+  authClient: TAuthClient,
+  userId: string,
+  params?: ListApiKeysParams<TAuthClient>
+) => queryClient.fetchQuery(listApiKeysOptions(authClient, userId, params))
+
+export type UseListApiKeysOptions<TAuthClient extends ApiKeyAuthClient> =
+  ListApiKeysOptions<TAuthClient> & ListApiKeysParams<TAuthClient>
+
+/**
+ * Subscribe to the current user's API keys via TanStack Query.
+ *
+ * @param authClient - The Better Auth client with the API key plugin.
+ * @param options - `apiKey.list` params merged with `useQuery` options.
+ * @param queryClient - Optional custom `QueryClient`.
+ */
+export function useListApiKeys<TAuthClient extends ApiKeyAuthClient>(
+  authClient: TAuthClient,
+  options: UseListApiKeysOptions<TAuthClient> = {},
+  queryClient?: QueryClient
+) {
+  const { data: session } = useSession(authClient, undefined, queryClient)
+  const userId = session?.user.id
+
+  const { query, fetchOptions, ...queryOptionsRest } = options
+
+  const baseOptions = listApiKeysOptions(authClient, userId, {
+    query,
+    fetchOptions
+  })
+
+  return useQuery(
+    {
+      ...queryOptionsRest,
+      ...baseOptions,
+      queryFn: userId ? baseOptions.queryFn : skipToken
+    },
+    queryClient
+  )
+}