@better-auth-ui/react 1.6.30 → 1.6.31

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

@@ -1,11 +1,14 @@
 import { apiKeyClient } from '@better-auth/api-key/client';
 import { passkeyClient } from '@better-auth/passkey/client';
-import { lastLoginMethodClient, magicLinkClient, multiSessionClient, organizationClient, usernameClient } from 'better-auth/client/plugins';
+import { deviceAuthorizationClient, lastLoginMethodClient, magicLinkClient, multiSessionClient, organizationClient, usernameClient } from 'better-auth/client/plugins';
 import { createAuthClient } from 'better-auth/react';
 export type AuthClient = ReturnType<typeof createAuthClient>;
 export type MagicLinkAuthClient = ReturnType<typeof createAuthClient<{
     plugins: [ReturnType<typeof magicLinkClient>];
 }>>;
+export type DeviceAuthorizationAuthClient = ReturnType<typeof createAuthClient<{
+    plugins: [ReturnType<typeof deviceAuthorizationClient>];
+}>>;
 export type LastLoginMethodAuthClient = ReturnType<typeof createAuthClient<{
     plugins: [ReturnType<typeof lastLoginMethodClient>];
 }>>;

package/dist/mutations/device-authorization/approve-device-mutation.d.ts

@@ -0,0 +1,33 @@
+import { DeviceAuthorizationAuthClient } from '../../lib/auth-client';
+export type ApproveDeviceParams<TAuthClient extends DeviceAuthorizationAuthClient> = Parameters<TAuthClient["device"]["approve"]>[0];
+export type ApproveDeviceOptions<TAuthClient extends DeviceAuthorizationAuthClient> = Omit<ReturnType<typeof approveDeviceOptions<TAuthClient>>, "mutationKey" | "mutationFn">;
+/**
+ * Mutation options factory for approving a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ */
+export declare function approveDeviceOptions<TAuthClient extends DeviceAuthorizationAuthClient>(authClient: TAuthClient): import('../auth-mutation-options').AuthMutationOptions<(<FetchOptions extends import('better-auth').ClientFetchOption<Partial<{
+    userCode: string;
+}> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import('better-auth').Prettify<{
+    userCode: string;
+} & {
+    fetchOptions?: FetchOptions | undefined;
+}>, data_1?: FetchOptions | undefined) => Promise<import('better-auth/client').BetterFetchResponse<{
+    success: boolean;
+}, {
+    error: "invalid_request" | "expired_token" | "access_denied" | "device_code_already_processed" | "unauthorized";
+    error_description: string;
+}, FetchOptions["throw"] extends true ? true : false>>), readonly ["auth", "deviceAuthorization", "approve"]>;
+/**
+ * Create a mutation for approving a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export declare function useApproveDevice<TAuthClient extends DeviceAuthorizationAuthClient>(authClient: TAuthClient, options?: ApproveDeviceOptions<TAuthClient>): import('@tanstack/react-query').UseMutationResult<any, import('better-auth/client').BetterFetchError, import('better-auth').Prettify<{
+    userCode: string;
+} & {
+    fetchOptions?: import('better-auth').ClientFetchOption<Partial<{
+        userCode: string;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined> | undefined;
+}>, unknown>;

package/dist/mutations/device-authorization/deny-device-mutation.d.ts

@@ -0,0 +1,33 @@
+import { DeviceAuthorizationAuthClient } from '../../lib/auth-client';
+export type DenyDeviceParams<TAuthClient extends DeviceAuthorizationAuthClient> = Parameters<TAuthClient["device"]["deny"]>[0];
+export type DenyDeviceOptions<TAuthClient extends DeviceAuthorizationAuthClient> = Omit<ReturnType<typeof denyDeviceOptions<TAuthClient>>, "mutationKey" | "mutationFn">;
+/**
+ * Mutation options factory for denying a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ */
+export declare function denyDeviceOptions<TAuthClient extends DeviceAuthorizationAuthClient>(authClient: TAuthClient): import('../auth-mutation-options').AuthMutationOptions<(<FetchOptions extends import('better-auth').ClientFetchOption<Partial<{
+    userCode: string;
+}> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import('better-auth').Prettify<{
+    userCode: string;
+} & {
+    fetchOptions?: FetchOptions | undefined;
+}>, data_1?: FetchOptions | undefined) => Promise<import('better-auth/client').BetterFetchResponse<{
+    success: boolean;
+}, {
+    error: "invalid_request" | "expired_token" | "access_denied" | "unauthorized";
+    error_description: string;
+}, FetchOptions["throw"] extends true ? true : false>>), readonly ["auth", "deviceAuthorization", "deny"]>;
+/**
+ * Create a mutation for denying a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export declare function useDenyDevice<TAuthClient extends DeviceAuthorizationAuthClient>(authClient: TAuthClient, options?: DenyDeviceOptions<TAuthClient>): import('@tanstack/react-query').UseMutationResult<any, import('better-auth/client').BetterFetchError, import('better-auth').Prettify<{
+    userCode: string;
+} & {
+    fetchOptions?: import('better-auth').ClientFetchOption<Partial<{
+        userCode: string;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined> | undefined;
+}>, unknown>;

package/dist/mutations/device-authorization/verify-device-code-mutation.d.ts

@@ -0,0 +1,107 @@
+import { DeviceAuthorizationAuthClient } from '../../lib/auth-client';
+export type VerifyDeviceCodeParams<TAuthClient extends DeviceAuthorizationAuthClient> = Parameters<TAuthClient["device"]>[0];
+export type VerifyDeviceCodeOptions<TAuthClient extends DeviceAuthorizationAuthClient> = Omit<ReturnType<typeof verifyDeviceCodeOptions<TAuthClient>>, "mutationKey" | "mutationFn">;
+/**
+ * Mutation options factory for verifying and claiming a device user code.
+ *
+ * The Better Auth endpoint uses GET, but this operation is modeled as a
+ * mutation because verification binds the code to the current session.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ */
+export declare function verifyDeviceCodeOptions<TAuthClient extends DeviceAuthorizationAuthClient>(authClient: TAuthClient): import('../auth-mutation-options').AuthMutationOptions<{
+    code: <FetchOptions extends import('better-auth').ClientFetchOption<Partial<{
+        client_id: string;
+        user_id?: string | undefined;
+        scope?: string | undefined;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import('better-auth').Prettify<{
+        client_id: string;
+        user_id?: string | undefined;
+        scope?: string | undefined;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<import('better-auth/client').BetterFetchResponse<{
+        device_code: string;
+        user_code: string;
+        verification_uri: string;
+        verification_uri_complete: string;
+        expires_in: number;
+        interval: number;
+    }, {
+        error: "invalid_request" | "invalid_client";
+        error_description: string;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    token: <FetchOptions extends import('better-auth').ClientFetchOption<Partial<{
+        grant_type: "urn:ietf:params:oauth:grant-type:device_code";
+        device_code: string;
+        client_id: string;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import('better-auth').Prettify<{
+        grant_type: "urn:ietf:params:oauth:grant-type:device_code";
+        device_code: string;
+        client_id: string;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<import('better-auth/client').BetterFetchResponse<{
+        access_token: string;
+        token_type: string;
+        expires_in: number;
+        scope: string;
+    }, {
+        error: "invalid_request" | "authorization_pending" | "slow_down" | "expired_token" | "access_denied" | "invalid_grant";
+        error_description: string;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & (<FetchOptions extends import('better-auth').ClientFetchOption<never, Partial<{
+    user_code: string;
+}> & Record<string, any>, Record<string, any> | undefined>>(data_0: import('better-auth').Prettify<{
+    query: {
+        user_code: string;
+    };
+    fetchOptions?: FetchOptions | undefined;
+}>, data_1?: FetchOptions | undefined) => Promise<import('better-auth/client').BetterFetchResponse<{
+    user_code: string;
+    status: string;
+}, {
+    error: "invalid_request";
+    error_description: string;
+}, FetchOptions["throw"] extends true ? true : false>>) & {
+    approve: <FetchOptions extends import('better-auth').ClientFetchOption<Partial<{
+        userCode: string;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import('better-auth').Prettify<{
+        userCode: string;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<import('better-auth/client').BetterFetchResponse<{
+        success: boolean;
+    }, {
+        error: "invalid_request" | "expired_token" | "access_denied" | "device_code_already_processed" | "unauthorized";
+        error_description: string;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+} & {
+    deny: <FetchOptions extends import('better-auth').ClientFetchOption<Partial<{
+        userCode: string;
+    }> & Record<string, any>, Partial<Record<string, any>> & Record<string, any>, Record<string, any> | undefined>>(data_0: import('better-auth').Prettify<{
+        userCode: string;
+    } & {
+        fetchOptions?: FetchOptions | undefined;
+    }>, data_1?: FetchOptions | undefined) => Promise<import('better-auth/client').BetterFetchResponse<{
+        success: boolean;
+    }, {
+        error: "invalid_request" | "expired_token" | "access_denied" | "unauthorized";
+        error_description: string;
+    }, FetchOptions["throw"] extends true ? true : false>>;
+}, readonly ["auth", "deviceAuthorization", "verify"]>;
+/**
+ * Create a mutation for verifying and claiming a device user code.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export declare function useVerifyDeviceCode<TAuthClient extends DeviceAuthorizationAuthClient>(authClient: TAuthClient, options?: VerifyDeviceCodeOptions<TAuthClient>): import('@tanstack/react-query').UseMutationResult<any, import('better-auth/client').BetterFetchError, import('better-auth').Prettify<{
+    query: {
+        user_code: string;
+    };
+    fetchOptions?: import('better-auth').ClientFetchOption<never, Partial<{
+        user_code: string;
+    }> & Record<string, any>, Record<string, any> | undefined> | undefined;
+}>, unknown>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@better-auth-ui/react",
-  "version": "1.6.30",
+  "version": "1.6.31",
   "type": "module",
   "scripts": {
     "build": "vite build",

package/src/index.ts

@@ -24,6 +24,9 @@ export * from "./mutations/auth/sign-in-social-mutation"
 export * from "./mutations/auth/sign-out-mutation"
 export * from "./mutations/auth/sign-up-email-mutation"
 export * from "./mutations/auth-mutation-options"
+export * from "./mutations/device-authorization/approve-device-mutation"
+export * from "./mutations/device-authorization/deny-device-mutation"
+export * from "./mutations/device-authorization/verify-device-code-mutation"
 export * from "./mutations/magic-link/sign-in-magic-link-mutation"
 export * from "./mutations/multi-session/revoke-multi-session-mutation"
 export * from "./mutations/multi-session/set-active-session-mutation"

package/src/lib/auth-client.ts

@@ -1,6 +1,7 @@
 import type { apiKeyClient } from "@better-auth/api-key/client"
 import type { passkeyClient } from "@better-auth/passkey/client"
 import type {
+  deviceAuthorizationClient,
   lastLoginMethodClient,
   magicLinkClient,
   multiSessionClient,
@@ -21,6 +22,12 @@ export type MagicLinkAuthClient = ReturnType<
   typeof createAuthClient<{ plugins: [ReturnType<typeof magicLinkClient>] }>
 >
 
+export type DeviceAuthorizationAuthClient = ReturnType<
+  typeof createAuthClient<{
+    plugins: [ReturnType<typeof deviceAuthorizationClient>]
+  }>
+>
+
 export type LastLoginMethodAuthClient = ReturnType<
   typeof createAuthClient<{
     plugins: [ReturnType<typeof lastLoginMethodClient>]

package/src/mutations/device-authorization/approve-device-mutation.ts

@@ -0,0 +1,45 @@
+import { deviceAuthorizationMutationKeys } from "@better-auth-ui/core/plugins"
+import { useMutation } from "@tanstack/react-query"
+
+import type { DeviceAuthorizationAuthClient } from "../../lib/auth-client"
+import { authMutationOptions } from "../auth-mutation-options"
+
+export type ApproveDeviceParams<
+  TAuthClient extends DeviceAuthorizationAuthClient
+> = Parameters<TAuthClient["device"]["approve"]>[0]
+
+export type ApproveDeviceOptions<
+  TAuthClient extends DeviceAuthorizationAuthClient
+> = Omit<
+  ReturnType<typeof approveDeviceOptions<TAuthClient>>,
+  "mutationKey" | "mutationFn"
+>
+
+/**
+ * Mutation options factory for approving a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ */
+export function approveDeviceOptions<
+  TAuthClient extends DeviceAuthorizationAuthClient
+>(authClient: TAuthClient) {
+  return authMutationOptions(
+    authClient.device.approve,
+    deviceAuthorizationMutationKeys.approve
+  )
+}
+
+/**
+ * Create a mutation for approving a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export function useApproveDevice<
+  TAuthClient extends DeviceAuthorizationAuthClient
+>(authClient: TAuthClient, options?: ApproveDeviceOptions<TAuthClient>) {
+  return useMutation({
+    ...approveDeviceOptions(authClient),
+    ...options
+  })
+}

package/src/mutations/device-authorization/deny-device-mutation.ts

@@ -0,0 +1,45 @@
+import { deviceAuthorizationMutationKeys } from "@better-auth-ui/core/plugins"
+import { useMutation } from "@tanstack/react-query"
+
+import type { DeviceAuthorizationAuthClient } from "../../lib/auth-client"
+import { authMutationOptions } from "../auth-mutation-options"
+
+export type DenyDeviceParams<
+  TAuthClient extends DeviceAuthorizationAuthClient
+> = Parameters<TAuthClient["device"]["deny"]>[0]
+
+export type DenyDeviceOptions<
+  TAuthClient extends DeviceAuthorizationAuthClient
+> = Omit<
+  ReturnType<typeof denyDeviceOptions<TAuthClient>>,
+  "mutationKey" | "mutationFn"
+>
+
+/**
+ * Mutation options factory for denying a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ */
+export function denyDeviceOptions<
+  TAuthClient extends DeviceAuthorizationAuthClient
+>(authClient: TAuthClient) {
+  return authMutationOptions(
+    authClient.device.deny,
+    deviceAuthorizationMutationKeys.deny
+  )
+}
+
+/**
+ * Create a mutation for denying a pending device request.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export function useDenyDevice<
+  TAuthClient extends DeviceAuthorizationAuthClient
+>(authClient: TAuthClient, options?: DenyDeviceOptions<TAuthClient>) {
+  return useMutation({
+    ...denyDeviceOptions(authClient),
+    ...options
+  })
+}

package/src/mutations/device-authorization/verify-device-code-mutation.ts

@@ -0,0 +1,48 @@
+import { deviceAuthorizationMutationKeys } from "@better-auth-ui/core/plugins"
+import { useMutation } from "@tanstack/react-query"
+
+import type { DeviceAuthorizationAuthClient } from "../../lib/auth-client"
+import { authMutationOptions } from "../auth-mutation-options"
+
+export type VerifyDeviceCodeParams<
+  TAuthClient extends DeviceAuthorizationAuthClient
+> = Parameters<TAuthClient["device"]>[0]
+
+export type VerifyDeviceCodeOptions<
+  TAuthClient extends DeviceAuthorizationAuthClient
+> = Omit<
+  ReturnType<typeof verifyDeviceCodeOptions<TAuthClient>>,
+  "mutationKey" | "mutationFn"
+>
+
+/**
+ * Mutation options factory for verifying and claiming a device user code.
+ *
+ * The Better Auth endpoint uses GET, but this operation is modeled as a
+ * mutation because verification binds the code to the current session.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ */
+export function verifyDeviceCodeOptions<
+  TAuthClient extends DeviceAuthorizationAuthClient
+>(authClient: TAuthClient) {
+  return authMutationOptions(
+    authClient.device,
+    deviceAuthorizationMutationKeys.verify
+  )
+}
+
+/**
+ * Create a mutation for verifying and claiming a device user code.
+ *
+ * @param authClient - The Better Auth client with the device-authorization plugin.
+ * @param options - React Query options forwarded to `useMutation`.
+ */
+export function useVerifyDeviceCode<
+  TAuthClient extends DeviceAuthorizationAuthClient
+>(authClient: TAuthClient, options?: VerifyDeviceCodeOptions<TAuthClient>) {
+  return useMutation({
+    ...verifyDeviceCodeOptions(authClient),
+    ...options
+  })
+}