feat: added mutate and query

Author: tiesen243

.tegami/2026-08-16-msvkm335.md

@@ -0,0 +1,9 @@
+---
+packages:
+  npm:@tiesen/effect-tanstack-query: patch
+---
+
+## Add direct `query` and `mutate` support
+
+- Added the `query` method to allow executing `GET` endpoints directly.
+- Added the `mutate` method to support executing `non-GET` mutation endpoints directly.

README.md

@@ -138,6 +138,13 @@ const queryClient = useQueryClient()
 void queryClient.invalidateQueries({
   queryKey: api.group.hello.getQueryKey(),
 })
+
+// Call Query / Mutate Directly Example
+const result = await api.group.hello.query({
+  params: { name: 'John' },
+  query: { greeting: 'Hi' },
+})
+const result2 = await api.group.goodbye.mutate({ payload: { name: 'John' } })
 ```
 
 ## Downloads

src/create-proxy.ts

@@ -125,6 +125,8 @@ export function createTanstackQueryOptionsProxy<TServiceTag, TService>(
             ...(inp ? [inp] : []),
           ]
 
+          if (action === 'query' || action === 'mutate') return execute(input)
+
           if (action === 'queryOptions')
             return {
               ...options,

src/types.ts

@@ -32,6 +32,22 @@ export type TanstackQueryOptionsProxy<T> =
     infer _Requires
   >
     ? {
+        query: Method extends 'GET'
+          ? (
+              input: MakeOptionalInput<
+                ([Params] extends [never]
+                  ? unknown
+                  : { params: UnwrapCodec<Params> }) &
+                  ([Query] extends [never]
+                    ? unknown
+                    : { query: UnwrapCodec<Query> }) &
+                  ([Headers] extends [never]
+                    ? unknown
+                    : { headers: UnwrapCodec<Headers> })
+              >
+            ) => UnwrapCodec<Success> | Promise<UnwrapCodec<Success>>
+          : never
+
         queryOptions: Method extends 'GET'
           ? <TQuery = QueryOptions<UnwrapCodec<Success>, UnwrapCodec<Error>>>(
               input: MakeOptionalInput<
@@ -79,6 +95,22 @@ export type TanstackQueryOptionsProxy<T> =
             >
           : never
 
+        mutate: Method extends 'GET'
+          ? never
+          : (
+              input: MakeOptionalInput<
+                ([Params] extends [never]
+                  ? unknown
+                  : { params: UnwrapCodec<Params> }) &
+                  ([Headers] extends [never]
+                    ? unknown
+                    : { headers: UnwrapCodec<Headers> }) &
+                  ([Payload] extends [never]
+                    ? unknown
+                    : { payload: UnwrapCodec<Payload> })
+              >
+            ) => UnwrapCodec<Success> | Promise<UnwrapCodec<Success>>
+
         mutationOptions: Method extends 'GET'
           ? never
           : <