feat: Add useSeamQueryWithoutWorkspace and UseSeamMutationWithoutWorkspace

Author: razor-x

src/lib/seam/index.ts

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

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

@@ -0,0 +1,53 @@
+import type {
+  SeamHttpApiError,
+  SeamHttpEndpointsWithoutWorkspace,
+  SeamHttpEndpointWithoutWorkspaceMutationPaths,
+} from '@seamapi/http/connect'
+import {
+  useMutation,
+  type UseMutationOptions,
+  type UseMutationResult,
+} from '@tanstack/react-query'
+
+import { NullSeamClientError, useSeamClient } from 'lib/seam/use-seam-client.js'
+
+export type UseSeamMutationWithoutWorkspaceVariables<
+  T extends SeamHttpEndpointWithoutWorkspaceMutationPaths,
+> = Parameters<SeamHttpEndpointsWithoutWorkspace[T]>[0]
+
+export type UseSeamMutationWithoutWorkspaceResult<
+  T extends SeamHttpEndpointWithoutWorkspaceMutationPaths,
+> = UseMutationResult<
+  MutationData<T>,
+  SeamHttpApiError,
+  UseSeamMutationWithoutWorkspaceVariables<T>
+>
+
+export function UseSeamMutationWithoutWorkspace<
+  T extends SeamHttpEndpointWithoutWorkspaceMutationPaths,
+>(
+  endpointPath: T,
+  options: Parameters<SeamHttpEndpointsWithoutWorkspace[T]>[1] &
+    MutationOptions<
+      MutationData<T>,
+      SeamHttpApiError,
+      UseSeamMutationWithoutWorkspaceVariables<T>
+    > = {}
+): UseSeamMutationWithoutWorkspaceResult<T> {
+  const { endpointClient: client } = useSeamClient()
+  return useMutation({
+    ...options,
+    mutationFn: async (variables) => {
+      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 (...args: any) => Promise<any>
+      return await endpoint(variables, options)
+    },
+  })
+}
+
+type MutationData<T extends SeamHttpEndpointWithoutWorkspaceMutationPaths> =
+  Awaited<ReturnType<SeamHttpEndpointsWithoutWorkspace[T]>>
+
+type MutationOptions<X, Y, Z> = Omit<UseMutationOptions<X, Y, Z>, 'mutationFn'>

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

@@ -0,0 +1,53 @@
+import type {
+  SeamHttpApiError,
+  SeamHttpEndpointsWithoutWorkspace,
+  SeamHttpEndpointWithoutWorkspaceQueryPaths,
+} from '@seamapi/http/connect'
+import {
+  useQuery,
+  type UseQueryOptions,
+  type UseQueryResult,
+} from '@tanstack/react-query'
+
+import { useSeamClient } from 'lib/seam/use-seam-client.js'
+
+export type UseSeamQueryWithoutWorkspaceParameters<
+  T extends SeamHttpEndpointWithoutWorkspaceQueryPaths,
+> = Parameters<SeamHttpEndpointsWithoutWorkspace[T]>[0]
+
+export type UseSeamQueryWithoutWorkspaceResult<
+  T extends SeamHttpEndpointWithoutWorkspaceQueryPaths,
+> = UseQueryResult<QueryData<T>, SeamHttpApiError>
+
+export function useSeamQueryWithoutWorkspace<
+  T extends SeamHttpEndpointWithoutWorkspaceQueryPaths,
+>(
+  endpointPath: T,
+  parameters?: UseSeamQueryWithoutWorkspaceParameters<T>,
+  options: Parameters<SeamHttpEndpointsWithoutWorkspace[T]>[1] &
+    QueryOptions<QueryData<T>, SeamHttpApiError> = {}
+): UseSeamQueryWithoutWorkspaceResult<T> {
+  const { endpointClient: client, queryKeyPrefixes } = useSeamClient()
+  return useQuery({
+    enabled: client != null,
+    ...options,
+    queryKey: [
+      ...queryKeyPrefixes,
+      ...endpointPath.split('/').filter((v) => v !== ''),
+      parameters,
+    ],
+    queryFn: async () => {
+      if (client == null) return null
+      // 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 (...args: any) => Promise<any>
+      return await endpoint(parameters, options)
+    },
+  })
+}
+
+type QueryData<T extends SeamHttpEndpointWithoutWorkspaceQueryPaths> = Awaited<
+  ReturnType<SeamHttpEndpointsWithoutWorkspace[T]>
+>
+
+type QueryOptions<X, Y> = Omit<UseQueryOptions<X, Y>, 'queryKey' | 'queryFn'>