feat: Add useSeamMutation

Author: razor-x

src/lib/seam/index.ts

@@ -13,4 +13,5 @@ export * from './devices/use-devices.js'
 export * from './SeamProvider.js'
 export * from './use-seam-client.js'
 export * from './use-seam-query.js'
+export * from './use-seam-mutation.js'
 export * from './use-seam-query-result.js'

src/lib/seam/use-seam-mutation.ts

@@ -0,0 +1,35 @@
+import type {
+  SeamHttpApiError,
+  SeamHttpEndpointMutationPaths,
+  SeamHttpEndpoints,
+} from '@seamapi/http/connect'
+import {
+  useMutation,
+  type UseMutationOptions,
+  type UseMutationResult,
+} from '@tanstack/react-query'
+
+import { NullSeamClientError, useSeamClient } from 'lib/seam/use-seam-client.js'
+
+type MutationOptions = Omit<UseMutationOptions, 'mutationFn'>
+
+export function useSeamMutation<T extends SeamHttpEndpointMutationPaths>(
+  endpointPath: T,
+  options?: Parameters<SeamHttpEndpoints[T]>[1],
+  _mutationOptions: MutationOptions = {}
+): UseMutationResult<
+  Awaited<ReturnType<SeamHttpEndpoints[T]>>,
+  SeamHttpApiError,
+  Parameters<SeamHttpEndpoints[T]>[1]
+> {
+  const { endpointClient: client } = useSeamClient()
+  return useMutation({
+    mutationFn: async (parameters) => {
+      if (client === null) throw new NullSeamClientError()
+      // Using @ts-expect-error over any is preferred, but not possible here because TypeScript will run out of memory.
+      // Type assertion is needed here for performance reasons. The types are correct at runtime.
+      const endpoint = client[endpointPath] as any
+      return await endpoint(parameters, options)
+    },
+  })
+}

src/lib/seam/use-seam-query.ts

@@ -3,14 +3,21 @@ import type {
   SeamHttpEndpointQueryPaths,
   SeamHttpEndpoints,
 } from '@seamapi/http/connect'
-import { useQuery, type UseQueryResult } from '@tanstack/react-query'
+import {
+  useQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+} from '@tanstack/react-query'
 
 import { useSeamClient } from 'lib/seam/use-seam-client.js'
 
+type QueryOptions = Omit<UseQueryOptions, 'queryKey' | 'queryFn'>
+
 export function useSeamQuery<T extends SeamHttpEndpointQueryPaths>(
   endpointPath: T,
   parameters?: Parameters<SeamHttpEndpoints[T]>[0],
-  options?: Parameters<SeamHttpEndpoints[T]>[1]
+  options?: Parameters<SeamHttpEndpoints[T]>[1],
+  _queryOptions: QueryOptions = {}
 ): UseQueryResult<Awaited<ReturnType<SeamHttpEndpoints[T]>>, SeamHttpApiError> {
   const { endpointClient: client } = useSeamClient()
   return useQuery({