feat: Add useSeamQuery

Author: razor-x

src/lib/seam/index.ts

@@ -12,4 +12,5 @@ export * from './devices/use-device-providers.js'
 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-query-result.js'

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

@@ -0,0 +1,27 @@
+import type { SeamHttpApiError, SeamHttpEndpoints } from '@seamapi/http/connect'
+import { useQuery, type UseQueryResult } from '@tanstack/react-query'
+
+import { useSeamClient } from 'lib/seam/use-seam-client.js'
+
+type EndpointsOnly = Pick<
+  SeamHttpEndpoints,
+  '/devices/list' | '/devices/get' | '/action_attempts/get'
+>
+
+export function useSeamQuery<T extends keyof EndpointsOnly>(
+  endpointPath: T,
+  params?: Parameters<EndpointsOnly[T]>[0],
+  options?: Parameters<EndpointsOnly[T]>[1]
+): UseQueryResult<Awaited<ReturnType<EndpointsOnly[T]>>, SeamHttpApiError> {
+  const { endpointClient: client } = useSeamClient()
+  return useQuery({
+    enabled: client != null,
+    queryKey: [endpointPath, params],
+    queryFn: async () => {
+      if (client == null) return null
+      const endpoint = client[endpointPath] as EndpointsOnly[T]
+      // @ts-expect-error: The types are correct at runtime, but TypeScript can't infer the specific endpoint types
+      return await endpoint(params, options)
+    },
+  })
+}