routesync 1.0.20 → 1.0.22

package/dist/cli.js

@@ -8461,9 +8461,9 @@ foreach ($routes as $route) {
                     $resourceName = null;
                     $collection = false;
                     
-                    if (preg_match('/returns+news+([a-zA-Z0-9_]+Resource)/', $methodSource, $matches)) {
+                    if (preg_match('/return\\s+new\\s+([a-zA-Z0-9_]+Resource)/', $methodSource, $matches)) {
                         $resourceName = $matches[1];
-                    } elseif (preg_match('/returns+([a-zA-Z0-9_]+Resource)::collection/', $methodSource, $matches)) {
+                    } elseif (preg_match('/return\\s+([a-zA-Z0-9_]+Resource)::collection/', $methodSource, $matches)) {
                         $resourceName = $matches[1];
                         $collection = true;
                     }
@@ -8489,7 +8489,7 @@ foreach ($routes as $route) {
                             
                             if (!$responseMetadata) {
                                 $docComment = $resReflector->getDocComment();
-                                if ($docComment && preg_match('/@mixins+([\\\\a-zA-Z0-9_]+)/', $docComment, $mixinMatches)) {
+                                if ($docComment && preg_match('/@mixin\\s+([\\\\\\\\a-zA-Z0-9_]+)/', $docComment, $mixinMatches)) {
                                     $responseMetadata = [
                                         'type' => class_basename($mixinMatches[1]),
                                         'collection' => $collection
@@ -8755,6 +8755,7 @@ var SDKGenerator = class {
     if (usesZod) {
       lines.push(`import { z } from 'zod'`);
       lines.push(`import * as Schemas from './schemas'`);
+      lines.push(`export * as Schemas from './schemas'`);
     }
     if (usesTypes) {
       lines.push(`import * as Types from './types'`);
@@ -8766,7 +8767,7 @@ var SDKGenerator = class {
         const TitleCaseAction = route.actionName.charAt(0).toUpperCase() + route.actionName.slice(1);
         const ContractName = `${TitleCaseGroup}${TitleCaseAction}Contract`;
         const pathParams = Array.from(route.runtimePath.matchAll(/:([a-zA-Z0-9_]+)/g)).map((m) => m[1]);
-        const paramsType = pathParams.length > 0 ? `{ ${pathParams.map((p) => `${p}: string`).join(", ")} }` : `Record<string, never>`;
+        const paramsType = pathParams.length > 0 ? `{ ${pathParams.map((p) => `${p}: string`).join(", ")} }` : `unknown`;
         const methodActionName = TitleCaseGroup + TitleCaseAction;
         const bodyType = route.schema?.rules && usesZod ? `z.infer<typeof Schemas.${methodActionName}Schema>` : `unknown`;
         const responseType = route.response ? `Types.${route.response.type}${route.response.collection ? "[]" : ""}` : `unknown`;
@@ -8797,7 +8798,7 @@ var SDKGenerator = class {
           lines.push(`        body: Schemas.${ContractName.replace("Contract", "Schema")}`);
           lines.push(`      },`);
         }
-        if (options.zod && route.response) {
+        if (options.zod && route.response && options.models) {
           lines.push(`      responseSchema: Schemas.${route.response.type}Schema${route.response.collection ? ".array()" : ""},`);
         }
         lines.push(`    }),`);
@@ -9041,7 +9042,7 @@ var HookGenerator = class _HookGenerator {
     const lines = [];
     lines.push(`// Auto-generated by routesync. Do not edit manually.`);
     lines.push(``);
-    lines.push(`import { useApiQuery, useApiMutation } from '@routesync/react'`);
+    lines.push(`import { useApiQuery, useApiMutation } from 'routesync/react'`);
     lines.push(`import { api } from './api'`);
     lines.push(``);
     const grouped = buildGeneratedRoutes(manifest.routes);
@@ -9053,7 +9054,8 @@ var HookGenerator = class _HookGenerator {
         const queryKey = `['${group}', '${route.actionName}']`;
         if (method === "GET") {
           lines.push(`/**`);
-          lines.push(` * @deprecated Use \`useApiQuery(api.${group}.${route.actionName}, ...args)\` instead.`);
+          lines.push(` * @deprecated Generated hooks will become optional in v2.`);
+          lines.push(` * Prefer \`useApiQuery(api.${group}.${route.actionName}, ...args)\` for future compatibility.`);
           lines.push(` */`);
           lines.push(`export function ${hookName}(...args: Parameters<typeof api.${group}.${route.actionName}>) {`);
           lines.push(`  return useApiQuery(api.${group}.${route.actionName}, ...args as any)`);
@@ -9061,7 +9063,8 @@ var HookGenerator = class _HookGenerator {
           lines.push(``);
         } else {
           lines.push(`/**`);
-          lines.push(` * @deprecated Use \`useApiMutation(api.${group}.${route.actionName}, options)\` instead.`);
+          lines.push(` * @deprecated Generated hooks will become optional in v2.`);
+          lines.push(` * Prefer \`useApiMutation(api.${group}.${route.actionName}, options)\` for future compatibility.`);
           lines.push(` */`);
           lines.push(`export function ${hookName}() {`);
           lines.push(`  return useApiMutation(api.${group}.${route.actionName})`);
@@ -9100,23 +9103,35 @@ var NextActionGenerator = class {
     for (const [groupName, routes] of Object.entries(grouped)) {
       for (const route of routes) {
         const actionName = `${groupName}${toTypeName(route.actionName)}`;
-        lines.push(`export async function ${actionName}Action(payload?: Record<string, unknown>) {`);
+        const TitleCaseGroup = groupName.charAt(0).toUpperCase() + groupName.slice(1);
+        const TitleCaseAction = route.actionName.charAt(0).toUpperCase() + route.actionName.slice(1);
+        const ContractName = `${TitleCaseGroup}${TitleCaseAction}Contract`;
+        const hasBody = route.schema && route.schema.rules && Object.keys(route.schema.rules).length > 0;
+        const hasQuery = route.method === "GET";
+        const hasParams = route.path.includes(":");
+        let payloadType = "never";
+        if (hasBody) payloadType = `${ContractName}['request']['body']`;
+        else if (hasQuery) payloadType = `${ContractName}['request']['query']`;
+        else if (hasParams) payloadType = `${ContractName}['request']['params']`;
+        const payloadParam = hasBody || hasQuery || hasParams ? `payload: ${payloadType}` : `payload?: unknown`;
+        lines.push(`export async function ${actionName}Action(${payloadParam}) {`);
         const args = [];
-        if (route.path.includes(":")) {
-          args.push(`params: payload as any`);
+        if (hasParams) {
+          args.push(`params: payload`);
         }
-        if (route.method === "GET") {
+        if (hasQuery) {
           args.push(`query: payload`);
-        } else {
+        } else if (hasBody) {
           args.push(`body: payload`);
         }
         if (route.auth) {
           args.push(`headers: await getAuthHeaders()`);
         }
-        const apiCall = `await api.${groupName}.${route.actionName}({ ${args.join(", ")} })`;
+        const argsString = args.length > 0 ? `{ ${args.join(", ")} }` : "";
+        const apiCall = `await api.${groupName}.${route.actionName}(${argsString})`;
         lines.push(`  try {`);
         lines.push(`    const response = ${apiCall}`);
-        lines.push(`    return { success: true, data: response.data }`);
+        lines.push(`    return { success: true, data: response }`);
         lines.push(`  } catch (error: unknown) {`);
         lines.push(`    return { success: false, error: error instanceof Error ? error.message : String(error) }`);
         lines.push(`  }`);
@@ -9124,6 +9139,10 @@ var NextActionGenerator = class {
         lines.push(``);
       }
     }
+    lines.splice(3, 1, `import { api, type ${Object.values(grouped).flatMap((routes) => routes.map((r) => {
+      const g = r.groupName || Object.keys(grouped).find((k) => grouped[k] === routes) || "";
+      return g.charAt(0).toUpperCase() + g.slice(1) + r.actionName.charAt(0).toUpperCase() + r.actionName.slice(1) + "Contract";
+    })).join(", type ")} } from './api'`);
     await import_fs_extra7.default.writeFile(import_path6.default.join(outputDir, "actions.ts"), lines.join("\n"));
   }
 };

package/dist/react.d.mts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { UseQueryOptions, InfiniteData, UseInfiniteQueryOptions, UseSuspenseQueryOptions, UseMutationOptions, QueryClient } from '@tanstack/react-query';
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 type RouteTransform = (value: unknown) => unknown;
@@ -80,6 +80,20 @@ declare function useApiQuery<TResponse = unknown, TParams = unknown, TBody = unk
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
     queryOptions?: Omit<UseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
 ]): _tanstack_react_query.UseQueryResult<NoInfer<TData>, TError>;
+/**
+ * useApiSuspenseQuery — generic wrapper for Suspense-enabled data fetching (TanStack v5).
+ */
+declare function useApiSuspenseQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = TResponse>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
+    ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
+    queryOptions?: Omit<UseSuspenseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
+]): _tanstack_react_query.UseSuspenseQueryResult<TData, TError>;
+/**
+ * useApiInfiniteQuery — framework agnostic paginated fetching.
+ */
+declare function useApiInfiniteQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = InfiniteData<TResponse>, TPageParam = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
+    ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
+    queryOptions: Omit<UseInfiniteQueryOptions<TResponse, TError, TData, any, TPageParam>, 'queryKey' | 'queryFn'>
+]): _tanstack_react_query.UseInfiniteQueryResult<TData, TError>;
 
 /**
  * useApiMutation — accepts an endpoint callable directly.
@@ -94,11 +108,40 @@ declare function useApiQuery<TResponse = unknown, TParams = unknown, TBody = unk
  *     invalidate: [api.cart.list, api.orders.index],
  *   })
  */
-interface ApiMutationOptions<TData, TError, TVariables> extends Omit<UseMutationOptions<TData, TError, TVariables>, 'mutationFn'> {
+interface ApiMutationOptions<TData, TError, TVariables, TContext = unknown> extends Omit<UseMutationOptions<TData, TError, TVariables, TContext>, 'mutationFn'> {
     /** Extra endpoints to invalidate on success (in addition to the auto group invalidation). */
     invalidate?: EndpointCallable<any, any, any>[];
 }
-declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, unknown>;
+declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TContext = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>;
+
+/**
+ * useApiQueryClient — a typed wrapper over TanStack's QueryClient
+ *
+ * Provides ergonomic helpers like invalidateEndpoint and prefetchEndpoint
+ * with strong typing based on the RouteSync SDK contracts.
+ */
+declare function useApiQueryClient(): {
+    queryClient: QueryClient;
+    /**
+     * Invalidate specific queries related to an endpoint.
+     * Optionally pass parameters to invalidate a more specific cache entry.
+     */
+    invalidateEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
+    /**
+     * Prefetch data for an endpoint into the cache.
+     * Useful for SSR, RSC hydration, or proactive prefetching.
+     */
+    prefetchEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
+    /**
+     * Manually update the cache for a specific endpoint.
+     * Often used for optimistic updates in mutations.
+     */
+    setEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options: EndpointCallableOptions<TParams, TBody> | undefined, updater: TResponse | ((oldData: TResponse | undefined) => TResponse)) => unknown;
+    /**
+     * Retrieve the current cached data for a specific endpoint.
+     */
+    getEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => TResponse | undefined;
+};
 
 /**
  * createHooks — generate typed hooks from an api group.
@@ -113,4 +156,19 @@ declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody =
  */
 declare function createHooks<T extends Record<string, EndpointCallable>>(group: T): { [K in keyof T as `use${Capitalize<string & K>}`]: T[K] extends EndpointCallable ? T[K]["$def"]["method"] extends "GET" | "DELETE" ? (options?: any, queryOptions?: any) => ReturnType<typeof useApiQuery> : (options?: any) => ReturnType<typeof useApiMutation> : never; };
 
-export { type ApiMutationOptions, createHooks, useApiMutation, useApiQuery };
+interface UseFormSetError<TFieldValues extends Record<string, any>> {
+    (name: keyof TFieldValues | string, error: {
+        type: string;
+        message?: string;
+    }): void;
+}
+/**
+ * Parses an unknown error and safely pipes 422 Unprocessable Entity
+ * validation messages to react-hook-form's setError.
+ *
+ * @param error - The error thrown by a RouteSync mutation
+ * @param setError - The `setError` function destructured from `useForm()`
+ */
+declare function setFormErrors<TFieldValues extends Record<string, any>>(error: unknown, setError: UseFormSetError<TFieldValues>): void;
+
+export { type ApiMutationOptions, createHooks, setFormErrors, useApiInfiniteQuery, useApiMutation, useApiQuery, useApiQueryClient, useApiSuspenseQuery };

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import * as _tanstack_react_query from '@tanstack/react-query';
-import { UseQueryOptions, UseMutationOptions } from '@tanstack/react-query';
+import { UseQueryOptions, InfiniteData, UseInfiniteQueryOptions, UseSuspenseQueryOptions, UseMutationOptions, QueryClient } from '@tanstack/react-query';
 
 type HttpMethod = 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
 type RouteTransform = (value: unknown) => unknown;
@@ -80,6 +80,20 @@ declare function useApiQuery<TResponse = unknown, TParams = unknown, TBody = unk
     ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
     queryOptions?: Omit<UseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
 ]): _tanstack_react_query.UseQueryResult<NoInfer<TData>, TError>;
+/**
+ * useApiSuspenseQuery — generic wrapper for Suspense-enabled data fetching (TanStack v5).
+ */
+declare function useApiSuspenseQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = TResponse>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
+    ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
+    queryOptions?: Omit<UseSuspenseQueryOptions<TResponse, TError, TData>, 'queryKey' | 'queryFn'>
+]): _tanstack_react_query.UseSuspenseQueryResult<TData, TError>;
+/**
+ * useApiInfiniteQuery — framework agnostic paginated fetching.
+ */
+declare function useApiInfiniteQuery<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TData = InfiniteData<TResponse>, TPageParam = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, ...args: [
+    ...OptionalIfEmpty<EndpointCallableOptions<TParams, TBody>>,
+    queryOptions: Omit<UseInfiniteQueryOptions<TResponse, TError, TData, any, TPageParam>, 'queryKey' | 'queryFn'>
+]): _tanstack_react_query.UseInfiniteQueryResult<TData, TError>;
 
 /**
  * useApiMutation — accepts an endpoint callable directly.
@@ -94,11 +108,40 @@ declare function useApiQuery<TResponse = unknown, TParams = unknown, TBody = unk
  *     invalidate: [api.cart.list, api.orders.index],
  *   })
  */
-interface ApiMutationOptions<TData, TError, TVariables> extends Omit<UseMutationOptions<TData, TError, TVariables>, 'mutationFn'> {
+interface ApiMutationOptions<TData, TError, TVariables, TContext = unknown> extends Omit<UseMutationOptions<TData, TError, TVariables, TContext>, 'mutationFn'> {
     /** Extra endpoints to invalidate on success (in addition to the auto group invalidation). */
     invalidate?: EndpointCallable<any, any, any>[];
 }
-declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, unknown>;
+declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody = unknown, TError = ApiError, TContext = unknown>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: ApiMutationOptions<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>): _tanstack_react_query.UseMutationResult<TResponse, TError, EndpointCallableOptions<TParams, TBody>, TContext>;
+
+/**
+ * useApiQueryClient — a typed wrapper over TanStack's QueryClient
+ *
+ * Provides ergonomic helpers like invalidateEndpoint and prefetchEndpoint
+ * with strong typing based on the RouteSync SDK contracts.
+ */
+declare function useApiQueryClient(): {
+    queryClient: QueryClient;
+    /**
+     * Invalidate specific queries related to an endpoint.
+     * Optionally pass parameters to invalidate a more specific cache entry.
+     */
+    invalidateEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
+    /**
+     * Prefetch data for an endpoint into the cache.
+     * Useful for SSR, RSC hydration, or proactive prefetching.
+     */
+    prefetchEndpoint: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => Promise<void>;
+    /**
+     * Manually update the cache for a specific endpoint.
+     * Often used for optimistic updates in mutations.
+     */
+    setEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options: EndpointCallableOptions<TParams, TBody> | undefined, updater: TResponse | ((oldData: TResponse | undefined) => TResponse)) => unknown;
+    /**
+     * Retrieve the current cached data for a specific endpoint.
+     */
+    getEndpointData: <TResponse, TParams, TBody>(endpoint: EndpointCallable<TResponse, TParams, TBody>, options?: EndpointCallableOptions<TParams, TBody>) => TResponse | undefined;
+};
 
 /**
  * createHooks — generate typed hooks from an api group.
@@ -113,4 +156,19 @@ declare function useApiMutation<TResponse = unknown, TParams = unknown, TBody =
  */
 declare function createHooks<T extends Record<string, EndpointCallable>>(group: T): { [K in keyof T as `use${Capitalize<string & K>}`]: T[K] extends EndpointCallable ? T[K]["$def"]["method"] extends "GET" | "DELETE" ? (options?: any, queryOptions?: any) => ReturnType<typeof useApiQuery> : (options?: any) => ReturnType<typeof useApiMutation> : never; };
 
-export { type ApiMutationOptions, createHooks, useApiMutation, useApiQuery };
+interface UseFormSetError<TFieldValues extends Record<string, any>> {
+    (name: keyof TFieldValues | string, error: {
+        type: string;
+        message?: string;
+    }): void;
+}
+/**
+ * Parses an unknown error and safely pipes 422 Unprocessable Entity
+ * validation messages to react-hook-form's setError.
+ *
+ * @param error - The error thrown by a RouteSync mutation
+ * @param setError - The `setError` function destructured from `useForm()`
+ */
+declare function setFormErrors<TFieldValues extends Record<string, any>>(error: unknown, setError: UseFormSetError<TFieldValues>): void;
+
+export { type ApiMutationOptions, createHooks, setFormErrors, useApiInfiniteQuery, useApiMutation, useApiQuery, useApiQueryClient, useApiSuspenseQuery };

package/dist/react.js

@@ -21,8 +21,12 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var src_exports = {};
 __export(src_exports, {
   createHooks: () => createHooks,
+  setFormErrors: () => setFormErrors,
+  useApiInfiniteQuery: () => useApiInfiniteQuery,
   useApiMutation: () => useApiMutation,
-  useApiQuery: () => useApiQuery
+  useApiQuery: () => useApiQuery,
+  useApiQueryClient: () => useApiQueryClient,
+  useApiSuspenseQuery: () => useApiSuspenseQuery
 });
 module.exports = __toCommonJS(src_exports);
 
@@ -38,6 +42,32 @@ function useApiQuery(endpoint, ...args) {
     ...queryOptions
   });
 }
+function useApiSuspenseQuery(endpoint, ...args) {
+  const options = args[0];
+  const queryOptions = args[1];
+  const queryKey = endpoint.$queryKey(options);
+  return (0, import_react_query.useSuspenseQuery)({
+    queryKey,
+    queryFn: () => endpoint(options),
+    ...queryOptions
+  });
+}
+function useApiInfiniteQuery(endpoint, ...args) {
+  const options = args[0];
+  const queryOptions = args.length > 1 ? args[1] : args[0];
+  const queryKey = endpoint.$queryKey(options);
+  return (0, import_react_query.useInfiniteQuery)({
+    queryKey,
+    queryFn: ({ pageParam }) => {
+      const fetchOptions = { ...options };
+      if (pageParam !== void 0) {
+        fetchOptions.query = { ...fetchOptions.query || {}, page: pageParam };
+      }
+      return endpoint(fetchOptions);
+    },
+    ...queryOptions
+  });
+}
 
 // packages/react/src/hooks/useMutation.ts
 var import_react_query2 = require("@tanstack/react-query");
@@ -57,6 +87,47 @@ function useApiMutation(endpoint, options) {
   });
 }
 
+// packages/react/src/hooks/useQueryClient.ts
+var import_react_query3 = require("@tanstack/react-query");
+function useApiQueryClient() {
+  const queryClient = (0, import_react_query3.useQueryClient)();
+  return {
+    queryClient,
+    /**
+     * Invalidate specific queries related to an endpoint.
+     * Optionally pass parameters to invalidate a more specific cache entry.
+     */
+    invalidateEndpoint: (endpoint, options) => {
+      return queryClient.invalidateQueries({
+        queryKey: endpoint.$queryKey(options)
+      });
+    },
+    /**
+     * Prefetch data for an endpoint into the cache.
+     * Useful for SSR, RSC hydration, or proactive prefetching.
+     */
+    prefetchEndpoint: (endpoint, options) => {
+      return queryClient.prefetchQuery({
+        queryKey: endpoint.$queryKey(options),
+        queryFn: () => endpoint(options)
+      });
+    },
+    /**
+     * Manually update the cache for a specific endpoint.
+     * Often used for optimistic updates in mutations.
+     */
+    setEndpointData: (endpoint, options, updater) => {
+      return queryClient.setQueryData(endpoint.$queryKey(options), updater);
+    },
+    /**
+     * Retrieve the current cached data for a specific endpoint.
+     */
+    getEndpointData: (endpoint, options) => {
+      return queryClient.getQueryData(endpoint.$queryKey(options));
+    }
+  };
+}
+
 // packages/react/src/hooks/createHooks.ts
 function createHooks(group) {
   const hooks = {};
@@ -71,9 +142,30 @@ function createHooks(group) {
   }
   return hooks;
 }
+
+// packages/react/src/utils/form.ts
+function setFormErrors(error, setError) {
+  if (error && typeof error === "object" && "status" in error && error.status === 422) {
+    const apiError = error;
+    const errors = apiError.errors;
+    if (errors && typeof errors === "object") {
+      for (const [field, messages] of Object.entries(errors)) {
+        if (Array.isArray(messages) && messages.length > 0) {
+          setError(field, { type: "server", message: String(messages[0]) });
+        } else if (typeof messages === "string") {
+          setError(field, { type: "server", message: messages });
+        }
+      }
+    }
+  }
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   createHooks,
+  setFormErrors,
+  useApiInfiniteQuery,
   useApiMutation,
-  useApiQuery
+  useApiQuery,
+  useApiQueryClient,
+  useApiSuspenseQuery
 });

package/dist/react.mjs

@@ -1,5 +1,5 @@
 // packages/react/src/hooks/useQuery.ts
-import { useQuery } from "@tanstack/react-query";
+import { useQuery, useSuspenseQuery, useInfiniteQuery } from "@tanstack/react-query";
 function useApiQuery(endpoint, ...args) {
   const options = args[0];
   const queryOptions = args[1];
@@ -10,6 +10,32 @@ function useApiQuery(endpoint, ...args) {
     ...queryOptions
   });
 }
+function useApiSuspenseQuery(endpoint, ...args) {
+  const options = args[0];
+  const queryOptions = args[1];
+  const queryKey = endpoint.$queryKey(options);
+  return useSuspenseQuery({
+    queryKey,
+    queryFn: () => endpoint(options),
+    ...queryOptions
+  });
+}
+function useApiInfiniteQuery(endpoint, ...args) {
+  const options = args[0];
+  const queryOptions = args.length > 1 ? args[1] : args[0];
+  const queryKey = endpoint.$queryKey(options);
+  return useInfiniteQuery({
+    queryKey,
+    queryFn: ({ pageParam }) => {
+      const fetchOptions = { ...options };
+      if (pageParam !== void 0) {
+        fetchOptions.query = { ...fetchOptions.query || {}, page: pageParam };
+      }
+      return endpoint(fetchOptions);
+    },
+    ...queryOptions
+  });
+}
 
 // packages/react/src/hooks/useMutation.ts
 import { useMutation, useQueryClient } from "@tanstack/react-query";
@@ -29,6 +55,47 @@ function useApiMutation(endpoint, options) {
   });
 }
 
+// packages/react/src/hooks/useQueryClient.ts
+import { useQueryClient as useQueryClient2 } from "@tanstack/react-query";
+function useApiQueryClient() {
+  const queryClient = useQueryClient2();
+  return {
+    queryClient,
+    /**
+     * Invalidate specific queries related to an endpoint.
+     * Optionally pass parameters to invalidate a more specific cache entry.
+     */
+    invalidateEndpoint: (endpoint, options) => {
+      return queryClient.invalidateQueries({
+        queryKey: endpoint.$queryKey(options)
+      });
+    },
+    /**
+     * Prefetch data for an endpoint into the cache.
+     * Useful for SSR, RSC hydration, or proactive prefetching.
+     */
+    prefetchEndpoint: (endpoint, options) => {
+      return queryClient.prefetchQuery({
+        queryKey: endpoint.$queryKey(options),
+        queryFn: () => endpoint(options)
+      });
+    },
+    /**
+     * Manually update the cache for a specific endpoint.
+     * Often used for optimistic updates in mutations.
+     */
+    setEndpointData: (endpoint, options, updater) => {
+      return queryClient.setQueryData(endpoint.$queryKey(options), updater);
+    },
+    /**
+     * Retrieve the current cached data for a specific endpoint.
+     */
+    getEndpointData: (endpoint, options) => {
+      return queryClient.getQueryData(endpoint.$queryKey(options));
+    }
+  };
+}
+
 // packages/react/src/hooks/createHooks.ts
 function createHooks(group) {
   const hooks = {};
@@ -43,8 +110,29 @@ function createHooks(group) {
   }
   return hooks;
 }
+
+// packages/react/src/utils/form.ts
+function setFormErrors(error, setError) {
+  if (error && typeof error === "object" && "status" in error && error.status === 422) {
+    const apiError = error;
+    const errors = apiError.errors;
+    if (errors && typeof errors === "object") {
+      for (const [field, messages] of Object.entries(errors)) {
+        if (Array.isArray(messages) && messages.length > 0) {
+          setError(field, { type: "server", message: String(messages[0]) });
+        } else if (typeof messages === "string") {
+          setError(field, { type: "server", message: messages });
+        }
+      }
+    }
+  }
+}
 export {
   createHooks,
+  setFormErrors,
+  useApiInfiniteQuery,
   useApiMutation,
-  useApiQuery
+  useApiQuery,
+  useApiQueryClient,
+  useApiSuspenseQuery
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "routesync",
-  "version": "1.0.20",
+  "version": "1.0.22",
   "description": "Laravel routes to typed frontend SDKs.",
   "main": "./dist/sdk.js",
   "module": "./dist/sdk.mjs",