@spoosh/react 0.5.0 → 0.6.0

package/README.md

@@ -1,6 +1,6 @@
 # @spoosh/react
 
-React hooks for Spoosh - `useRead`, `useWrite`, and `useInfiniteRead`.
+React hooks for Spoosh - `useRead`, `useLazyRead`, `useWrite`, and `useInfiniteRead`.
 
 **[Documentation](https://spoosh.dev/docs/integrations/react)** · **Requirements:** TypeScript >= 5.0, React >= 18.0
 
@@ -23,7 +23,8 @@ const spoosh = new Spoosh<ApiSchema, Error>("/api").use([
   cachePlugin({ staleTime: 5000 }),
 ]);
 
-export const { useRead, useWrite, useInfiniteRead } = createReactSpoosh(spoosh);
+export const { useRead, useLazyRead, useWrite, useInfiniteRead } =
+  createReactSpoosh(spoosh);
 ```
 
 ### useRead
@@ -32,7 +33,7 @@ Fetch data with automatic caching and refetching.
 
 ```typescript
 function UserList() {
-  const { data, loading, error, refetch } = useRead(
+  const { data, loading, error, trigger } = useRead(
     (api) => api("users").GET()
   );
 
@@ -62,6 +63,27 @@ const { data: user } = useRead(
 );
 ```
 
+### useLazyRead
+
+Lazy data fetching for print/download/export scenarios. Does not auto-fetch on mount.
+
+```typescript
+function PrintOrder() {
+  const { trigger, loading } = useLazyRead((api) => api("orders/:id").GET);
+
+  const handlePrint = async (orderId: string) => {
+    const { data } = await trigger({ params: { id: orderId } });
+    if (data) printReceipt(data);
+  };
+
+  return (
+    <button onClick={() => handlePrint("123")} disabled={loading}>
+      {loading ? "Loading..." : "Print"}
+    </button>
+  );
+}
+```
+
 ### useWrite
 
 Trigger mutations with loading and error states.
@@ -177,7 +199,7 @@ function PostList() {
 | `error`    | `TError \| undefined` | Error if request failed  |
 | `loading`  | `boolean`             | True during initial load |
 | `fetching` | `boolean`             | True during any fetch    |
-| `refetch`  | `() => Promise`       | Manually trigger refetch |
+| `trigger`  | `() => Promise`       | Manually trigger fetch   |
 | `abort`    | `() => void`          | Abort current request    |
 
 ### useWrite(writeFn)
@@ -190,7 +212,6 @@ function PostList() {
 | `data`    | `TData \| undefined`   | Response data                      |
 | `error`   | `TError \| undefined`  | Error if request failed            |
 | `loading` | `boolean`              | True while mutation is in progress |
-| `reset`   | `() => void`           | Reset state                        |
 | `abort`   | `() => void`           | Abort current request              |
 
 ### useInfiniteRead(readFn, options)

package/dist/index.d.mts

@@ -1,5 +1,4 @@
-import * as _spoosh_core from '@spoosh/core';
-import { ReadClient, TagMode, SpooshResponse, WriteClient, SpooshPlugin, PluginTypeConfig, SpooshOptions, MergePluginResults, StateManager, EventEmitter, PluginExecutor, PluginArray, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginInstanceApi } from '@spoosh/core';
+import { ReadClient, TagMode, SpooshResponse, WriteClient, SpooshPlugin, PluginTypeConfig, SpooshOptions, MergePluginResults, StateManager, EventEmitter, PluginExecutor, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginInstanceApi } from '@spoosh/core';
 
 type PluginHooksConfig<TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]> = {
     baseUrl: string;
@@ -22,15 +21,14 @@ type BaseReadOptions = {
      */
     tags?: TagMode | (TagModeInArray | (string & {}))[];
 };
-
 /**
  * Result returned by `useRead` hook.
  *
  * @template TData - The response data type
  * @template TError - The error type
- * @template TPluginResult - Plugin-provided result fields
+ * @template TMeta - Plugin-provided metadata fields
  */
-type BaseReadResult<TData, TError, TPluginResult = Record<string, unknown>> = {
+type BaseReadResult<TData, TError, TMeta = Record<string, unknown>> = {
     /** True during the initial load (no data yet) */
     loading: boolean;
     /** True during any fetch operation */
@@ -40,11 +38,11 @@ type BaseReadResult<TData, TError, TPluginResult = Record<string, unknown>> = {
     /** Error from the last failed request */
     error: TError | undefined;
     /** Plugin-provided metadata */
-    meta: TPluginResult;
+    meta: TMeta;
     /** Abort the current fetch operation */
     abort: () => void;
-    /** Manually trigger a refetch */
-    refetch: () => Promise<SpooshResponse<TData, TError>>;
+    /** Manually trigger a fetch */
+    trigger: () => Promise<SpooshResponse<TData, TError>>;
 };
 /**
  * Result returned by `useWrite` hook.
@@ -52,9 +50,9 @@ type BaseReadResult<TData, TError, TPluginResult = Record<string, unknown>> = {
  * @template TData - The response data type
  * @template TError - The error type
  * @template TOptions - The trigger options type
- * @template TPluginResult - Plugin-provided result fields
+ * @template TMeta - Plugin-provided metadata fields
  */
-type BaseWriteResult<TData, TError, TOptions, TPluginResult = Record<string, unknown>> = {
+type BaseWriteResult<TData, TError, TOptions, TMeta = Record<string, unknown>> = {
     /** Execute the mutation with optional options */
     trigger: (options?: TOptions) => Promise<SpooshResponse<TData, TError>>;
     /** True while the mutation is in progress */
@@ -64,12 +62,29 @@ type BaseWriteResult<TData, TError, TOptions, TPluginResult = Record<string, unk
     /** Error from the last failed request */
     error: TError | undefined;
     /** Plugin-provided metadata */
-    meta: TPluginResult;
-    /** Reset the state to initial values */
-    reset: () => void;
+    meta: TMeta;
     /** Abort the current mutation */
     abort: () => void;
 };
+/**
+ * Result returned by `useLazyRead` hook.
+ *
+ * @template TData - The response data type
+ * @template TError - The error type
+ * @template TOptions - The trigger options type
+ */
+type BaseLazyReadResult<TData, TError, TOptions> = {
+    /** Execute the fetch with optional options */
+    trigger: (options?: TOptions) => Promise<SpooshResponse<TData, TError>>;
+    /** True while the fetch is in progress */
+    loading: boolean;
+    /** Response data from the API */
+    data: TData | undefined;
+    /** Error from the last failed request */
+    error: TError | undefined;
+    /** Abort the current fetch */
+    abort: () => void;
+};
 type OptionalQueryField<TQuery> = [TQuery] extends [never] ? object : undefined extends TQuery ? {
     query?: Exclude<TQuery, undefined>;
 } : {
@@ -89,8 +104,8 @@ type InputFields<TQuery, TBody, TParamNames extends string> = OptionalQueryField
 type WriteResponseInputFields<TQuery, TBody, TParamNames extends string> = [TQuery, TBody, TParamNames] extends [never, never, never] ? object : {
     input: InputFields<TQuery, TBody, TParamNames> | undefined;
 };
-type UseReadResult<TData, TError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]> = BaseReadResult<TData, TError> & MergePluginResults<TPlugins>["read"];
-type UseWriteResult<TData, TError, TOptions, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]> = BaseWriteResult<TData, TError, TOptions> & MergePluginResults<TPlugins>["write"];
+type UseReadResult<TData, TError, TMeta, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]> = BaseReadResult<TData, TError, TMeta> & MergePluginResults<TPlugins>["read"];
+type UseWriteResult<TData, TError, TOptions, TMeta, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]> = BaseWriteResult<TData, TError, TOptions, TMeta> & MergePluginResults<TPlugins>["write"];
 type ReadApiClient<TSchema, TDefaultError> = ReadClient<TSchema, TDefaultError>;
 type WriteApiClient<TSchema, TDefaultError> = WriteClient<TSchema, TDefaultError>;
 type SuccessResponse<T> = Extract<T, {
@@ -108,6 +123,7 @@ type ExtractMethodError<T> = T extends (...args: never[]) => infer R ? ErrorResp
     error: infer E;
 } ? E : unknown : unknown;
 type ExtractMethodOptions<T> = T extends (...args: infer A) => unknown ? A[0] : never;
+type ExtractCoreMethodOptions<T> = T extends (...args: infer A) => unknown ? A[0] extends object ? Pick<A[0], Extract<keyof A[0], "query" | "params" | "body">> : object : object;
 type ExtractMethodQuery<T> = ExtractMethodOptions<T> extends {
     query: infer Q;
 } ? Q : never;
@@ -239,8 +255,8 @@ type BaseInfiniteReadResult<TData, TError, TItem, TPluginResult = Record<string,
     fetchNext: () => Promise<void>;
     /** Fetch the previous page */
     fetchPrev: () => Promise<void>;
-    /** Refetch all pages from the beginning */
-    refetch: () => Promise<void>;
+    /** Trigger refetch of all pages from the beginning */
+    trigger: () => Promise<void>;
     /** Abort the current fetch operation */
     abort: () => void;
     /** Error from the last failed request */
@@ -250,16 +266,24 @@ type UseInfiniteReadResult<TData, TError, TItem, TPlugins extends readonly Spoos
 type InfiniteReadApiClient<TSchema, TDefaultError> = ReadClient<TSchema, TDefaultError>;
 
 type InferError<T, TDefaultError> = [T] extends [unknown] ? TDefaultError : T;
-type ExtractParamsRecord<T> = ExtractResponseParamNames<T> extends never ? never : Record<ExtractResponseParamNames<T>, string | number>;
-type ReadResolverContext<TSchema, TReadFn, TDefaultError> = ResolverContext<TSchema, ExtractMethodData<TReadFn>, InferError<ExtractMethodError<TReadFn>, TDefaultError>, ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractParamsRecord<TReadFn>>;
-type ResolvedReadOptions<TSchema, TPlugins extends PluginArray, TReadFn, TDefaultError> = _spoosh_core.ResolveTypes<MergePluginOptions<TPlugins>["read"], ReadResolverContext<TSchema, TReadFn, TDefaultError>>;
 type WriteResolverContext<TSchema, TMethod, TDefaultError> = ResolverContext<TSchema, ExtractMethodData<TMethod>, InferError<ExtractMethodError<TMethod>, TDefaultError>, ExtractMethodQuery<TMethod>, ExtractMethodBody<TMethod>, ExtractResponseParamNames<TMethod> extends never ? never : Record<ExtractResponseParamNames<TMethod>, string | number>>;
-type ResolvedWriteOptions<TSchema, TPlugins extends PluginArray, TMethod, TDefaultError> = _spoosh_core.ResolveTypes<MergePluginOptions<TPlugins>["write"], WriteResolverContext<TSchema, TMethod, TDefaultError>>;
-type UseReadFn<TDefaultError, TSchema, TPlugins extends PluginArray> = <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<{
-    data?: unknown;
-    error?: unknown;
-}>>(readFn: TReadFn, readOptions?: BaseReadOptions & ResolvedReadOptions<TSchema, TPlugins, TReadFn, TDefaultError>) => BaseReadResult<ExtractMethodData<TReadFn>, InferError<ExtractMethodError<TReadFn>, TDefaultError>, ResolveResultTypes<MergePluginResults<TPlugins>["read"], BaseReadOptions & ResolvedReadOptions<TSchema, TPlugins, TReadFn, TDefaultError>>> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
-type UseWriteFn<TDefaultError, TSchema, TPlugins extends PluginArray> = <TMethod extends (...args: never) => Promise<SpooshResponse<unknown, unknown>>>(writeFn: (api: WriteApiClient<TSchema, TDefaultError>) => TMethod) => BaseWriteResult<ExtractMethodData<TMethod>, InferError<ExtractMethodError<TMethod>, TDefaultError>, Parameters<TMethod>[0] & ResolvedWriteOptions<TSchema, TPlugins, TMethod, TDefaultError>, ResolveResultTypes<MergePluginResults<TPlugins>["write"], Parameters<TMethod>[0] & ResolvedWriteOptions<TSchema, TPlugins, TMethod, TDefaultError>>> & WriteResponseInputFields<ExtractMethodQuery<TMethod>, ExtractMethodBody<TMethod>, ExtractResponseParamNames<TMethod>>;
+type ResolvedWriteOptions<TSchema, TPlugins extends PluginArray, TMethod, TDefaultError> = ResolveTypes<MergePluginOptions<TPlugins>["write"], WriteResolverContext<TSchema, TMethod, TDefaultError>>;
+type UseReadFn<TDefaultError, TSchema, TPlugins extends PluginArray> = {
+    <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<{
+        data?: unknown;
+        error?: unknown;
+    }>, TReadOpts>(readFn: TReadFn, readOptions: TReadOpts & BaseReadOptions & ResolveTypes<MergePluginOptions<TPlugins>["read"], ResolverContext<TSchema, ExtractMethodData<TReadFn>, InferError<ExtractMethodError<TReadFn>, TDefaultError>, ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn> extends never ? never : Record<ExtractResponseParamNames<TReadFn>, string | number>>>): BaseReadResult<ExtractMethodData<TReadFn>, InferError<ExtractMethodError<TReadFn>, TDefaultError>, ResolveResultTypes<MergePluginResults<TPlugins>["read"], TReadOpts>> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
+    <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<{
+        data?: unknown;
+        error?: unknown;
+    }>>(readFn: TReadFn): BaseReadResult<ExtractMethodData<TReadFn>, InferError<ExtractMethodError<TReadFn>, TDefaultError>, MergePluginResults<TPlugins>["read"]> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
+};
+type UseWriteFn<TDefaultError, TSchema, TPlugins extends PluginArray> = {
+    <TMethod extends (...args: never) => Promise<SpooshResponse<unknown, unknown>>>(writeFn: (api: WriteApiClient<TSchema, TDefaultError>) => TMethod): BaseWriteResult<ExtractMethodData<TMethod>, InferError<ExtractMethodError<TMethod>, TDefaultError>, Parameters<TMethod>[0] & ResolvedWriteOptions<TSchema, TPlugins, TMethod, TDefaultError>, MergePluginResults<TPlugins>["write"]> & WriteResponseInputFields<ExtractMethodQuery<TMethod>, ExtractMethodBody<TMethod>, ExtractResponseParamNames<TMethod>>;
+};
+type UseLazyReadFn<TDefaultError, TSchema> = {
+    <TMethod extends (...args: never) => Promise<SpooshResponse<unknown, unknown>>>(readFn: (api: ReadApiClient<TSchema, TDefaultError>) => TMethod): BaseLazyReadResult<ExtractMethodData<TMethod>, InferError<ExtractMethodError<TMethod>, TDefaultError>, ExtractCoreMethodOptions<TMethod>> & WriteResponseInputFields<ExtractResponseQuery<TMethod>, ExtractResponseBody<TMethod>, ExtractResponseParamNames<TMethod>>;
+};
 type InfiniteReadResolverContext<TSchema, TData, TError, TRequest> = ResolverContext<TSchema, TData, TError, TRequest extends {
     query: infer Q;
 } ? Q : never, TRequest extends {
@@ -267,7 +291,7 @@ type InfiniteReadResolverContext<TSchema, TData, TError, TRequest> = ResolverCon
 } ? B : never, TRequest extends {
     params: infer P;
 } ? P : never>;
-type ResolvedInfiniteReadOptions<TSchema, TPlugins extends PluginArray, TData, TError, TRequest> = _spoosh_core.ResolveTypes<MergePluginOptions<TPlugins>["infiniteRead"], InfiniteReadResolverContext<TSchema, TData, TError, TRequest>>;
+type ResolvedInfiniteReadOptions<TSchema, TPlugins extends PluginArray, TData, TError, TRequest> = ResolveTypes<MergePluginOptions<TPlugins>["infiniteRead"], InfiniteReadResolverContext<TSchema, TData, TError, TRequest>>;
 type UseInfiniteReadFn<TDefaultError, TSchema, TPlugins extends PluginArray> = <TData, TItem, TError = TDefaultError, TRequest extends AnyInfiniteRequestOptions = AnyInfiniteRequestOptions>(readFn: (api: InfiniteReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<TData, TError>>, readOptions: BaseInfiniteReadOptions<TData, TItem, TRequest> & ResolvedInfiniteReadOptions<TSchema, TPlugins, TData, TError, TRequest>) => BaseInfiniteReadResult<TData, TError, TItem, MergePluginResults<TPlugins>["read"]>;
 /**
  * Spoosh React hooks interface containing useRead, useWrite, and useInfiniteRead.
@@ -282,7 +306,7 @@ type SpooshReactHooks<TDefaultError, TSchema, TPlugins extends PluginArray> = {
      *
      * @param readFn - Function that selects the API endpoint to call (e.g., `(api) => api("posts").GET()`)
      * @param readOptions - Optional configuration including `enabled`, `tags`, and plugin-specific options
-     * @returns Object containing `data`, `error`, `loading`, `fetching`, `refetch`, and `abort`
+     * @returns Object containing `data`, `error`, `loading`, `fetching`, `trigger`, and `abort`
      *
      * @example
      * ```tsx
@@ -299,7 +323,7 @@ type SpooshReactHooks<TDefaultError, TSchema, TPlugins extends PluginArray> = {
      * React hook for mutations (POST, PUT, PATCH, DELETE) with manual triggering.
      *
      * @param writeFn - Function that selects the API endpoint (e.g., `(api) => api("posts").POST`)
-     * @returns Object containing `trigger`, `data`, `error`, `loading`, `reset`, and `abort`
+     * @returns Object containing `trigger`, `data`, `error`, `loading`, and `abort`
      *
      * @example
      * ```tsx
@@ -312,6 +336,23 @@ type SpooshReactHooks<TDefaultError, TSchema, TPlugins extends PluginArray> = {
      * ```
      */
     useWrite: UseWriteFn<TDefaultError, TSchema, TPlugins>;
+    /**
+     * React hook for lazy GET requests with manual triggering (does not auto-fetch on mount).
+     *
+     * @param readFn - Function that selects the API endpoint (e.g., `(api) => api("posts").GET`)
+     * @returns Object containing `trigger`, `data`, `error`, `loading`, and `abort`
+     *
+     * @example
+     * ```tsx
+     * const { trigger, loading, data } = useLazyRead((api) => api("posts/:id").GET);
+     *
+     * const handleClick = async (id) => {
+     *   const { data, error } = await trigger({ params: { id } });
+     *   if (data) console.log('Fetched:', data);
+     * };
+     * ```
+     */
+    useLazyRead: UseLazyReadFn<TDefaultError, TSchema>;
     /**
      * React hook for infinite/paginated data fetching with automatic pagination control.
      *
@@ -375,42 +416,46 @@ type SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins> = {
  */
 declare function createReactSpoosh<TSchema, TDefaultError, TPlugins extends PluginArray, TApi>(instance: SpooshInstanceShape<TApi, TSchema, TDefaultError, TPlugins>): SpooshReactHooks<TDefaultError, TSchema, TPlugins>;
 
-declare function createUseRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<{
-    data?: unknown;
-    error?: unknown;
-}>, TReadOpts extends BaseReadOptions & (((TPlugins[number] extends infer T_3 ? T_3 extends TPlugins[number] ? T_3 extends SpooshPlugin<infer Types_1 extends PluginTypeConfig> ? Types_1 extends {
-    readOptions: infer R_1;
-} ? R_1 : object : object : never : never) extends infer T_4 ? T_4 extends (TPlugins[number] extends infer T_5 ? T_5 extends TPlugins[number] ? T_5 extends SpooshPlugin<infer Types_1 extends PluginTypeConfig> ? Types_1 extends {
-    readOptions: infer R_1;
-} ? R_1 : object : object : never : never) ? T_4 extends unknown ? (x: T_4) => void : never : never : never) extends (x: infer I) => void ? I : never) = BaseReadOptions & (((TPlugins[number] extends infer T_6 ? T_6 extends TPlugins[number] ? T_6 extends SpooshPlugin<infer Types_1 extends PluginTypeConfig> ? Types_1 extends {
-    readOptions: infer R_1;
-} ? R_1 : object : object : never : never) extends infer T_7 ? T_7 extends (TPlugins[number] extends infer T_8 ? T_8 extends TPlugins[number] ? T_8 extends SpooshPlugin<infer Types_1 extends PluginTypeConfig> ? Types_1 extends {
-    readOptions: infer R_1;
-} ? R_1 : object : object : never : never) ? T_7 extends unknown ? (x: T_7) => void : never : never : never) extends (x: infer I) => void ? I : never)>(readFn: TReadFn, readOptions?: TReadOpts) => BaseReadResult<TReadFn extends (...args: unknown[]) => Promise<{
-    data: infer D;
-}> ? D : unknown, [TReadFn extends (...args: unknown[]) => Promise<{
-    error: infer E;
-}> ? E : unknown] extends [unknown] ? TDefaultError : TReadFn extends (...args: unknown[]) => Promise<{
-    error: infer E;
-}> ? E : unknown, ResolveResultTypes<((TPlugins[number] extends infer T ? T extends TPlugins[number] ? T extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
-    readResult: infer R;
-} ? R : object : object : never : never) extends infer T_1 ? T_1 extends (TPlugins[number] extends infer T_2 ? T_2 extends TPlugins[number] ? T_2 extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
-    readResult: infer R;
-} ? R : object : object : never : never) ? T_1 extends unknown ? (x: T_1) => void : never : never : never) extends (x: infer I) => void ? I : never, TReadOpts>> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
+declare function createUseRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): {
+    <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<{
+        data?: unknown;
+        error?: unknown;
+    }>, TReadOpts>(readFn: TReadFn, readOptions: TReadOpts & BaseReadOptions & ResolveTypes<((TPlugins[number] extends infer T ? T extends TPlugins[number] ? T extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
+        readOptions: infer R;
+    } ? R : object : object : never : never) extends infer T_1 ? T_1 extends (TPlugins[number] extends infer T_2 ? T_2 extends TPlugins[number] ? T_2 extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
+        readOptions: infer R;
+    } ? R : object : object : never : never) ? T_1 extends unknown ? (x: T_1) => void : never : never : never) extends (x: infer I) => void ? I : never, ResolverContext<TSchema, TReadFn extends (...args: unknown[]) => Promise<{
+        data: infer D;
+    }> ? D : unknown, [TReadFn extends (...args: unknown[]) => Promise<{
+        error: infer E;
+    }> ? E : unknown] extends [unknown] ? TDefaultError : TReadFn extends (...args: unknown[]) => Promise<{
+        error: infer E;
+    }> ? E : unknown, ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn> extends never ? never : Record<ExtractResponseParamNames<TReadFn>, string | number>>>): BaseReadResult<TReadFn extends (...args: unknown[]) => Promise<{
+        data: infer D;
+    }> ? D : unknown, [TReadFn extends (...args: unknown[]) => Promise<{
+        error: infer E;
+    }> ? E : unknown] extends [unknown] ? TDefaultError : TReadFn extends (...args: unknown[]) => Promise<{
+        error: infer E;
+    }> ? E : unknown, ResolveResultTypes<MergePluginResults<TPlugins>["read"], TReadOpts>> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
+    <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<{
+        data?: unknown;
+        error?: unknown;
+    }>>(readFn: TReadFn): BaseReadResult<TReadFn extends (...args: unknown[]) => Promise<{
+        data: infer D;
+    }> ? D : unknown, [TReadFn extends (...args: unknown[]) => Promise<{
+        error: infer E;
+    }> ? E : unknown] extends [unknown] ? TDefaultError : TReadFn extends (...args: unknown[]) => Promise<{
+        error: infer E;
+    }> ? E : unknown, MergePluginResults<TPlugins>["read"]> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
+};
+
+declare function createUseLazyRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TMethod extends (...args: never[]) => Promise<SpooshResponse<unknown, unknown>>>(readFn: (api: ReadApiClient<TSchema, TDefaultError>) => TMethod) => BaseLazyReadResult<ExtractMethodData<TMethod>, [ExtractMethodError<TMethod>] extends [unknown] ? TDefaultError : ExtractMethodError<TMethod>, ExtractCoreMethodOptions<TMethod>> & WriteResponseInputFields<ExtractResponseQuery<TMethod>, ExtractResponseBody<TMethod>, ExtractResponseParamNames<TMethod>>;
 
-declare function createUseWrite<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TMethod extends (...args: never[]) => Promise<SpooshResponse<unknown, unknown>>>(writeFn: (api: WriteApiClient<TSchema, TDefaultError>) => TMethod) => BaseWriteResult<ExtractMethodData<TMethod>, [ExtractMethodError<TMethod>] extends [unknown] ? TDefaultError : ExtractMethodError<TMethod>, ExtractMethodOptions<TMethod> & _spoosh_core.ResolveTypes<((TPlugins[number] extends infer T ? T extends TPlugins[number] ? T extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
+declare function createUseWrite<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TMethod extends (...args: never[]) => Promise<SpooshResponse<unknown, unknown>>>(writeFn: (api: WriteApiClient<TSchema, TDefaultError>) => TMethod) => BaseWriteResult<ExtractMethodData<TMethod>, [ExtractMethodError<TMethod>] extends [unknown] ? TDefaultError : ExtractMethodError<TMethod>, ExtractMethodOptions<TMethod> & ResolveTypes<((TPlugins[number] extends infer T ? T extends TPlugins[number] ? T extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
     writeOptions: infer W;
 } ? W : object : object : never : never) extends infer T_1 ? T_1 extends (TPlugins[number] extends infer T_2 ? T_2 extends TPlugins[number] ? T_2 extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
     writeOptions: infer W;
-} ? W : object : object : never : never) ? T_1 extends unknown ? (x: T_1) => void : never : never : never) extends (x: infer I) => void ? I : never, ResolverContext<TSchema, ExtractMethodData<TMethod>, [ExtractMethodError<TMethod>] extends [unknown] ? TDefaultError : ExtractMethodError<TMethod>, ExtractMethodQuery<TMethod>, ExtractMethodBody<TMethod>, ExtractResponseParamNames<TMethod> extends never ? never : Record<ExtractResponseParamNames<TMethod>, string | number>>>, ResolveResultTypes<((TPlugins[number] extends infer T_3 ? T_3 extends TPlugins[number] ? T_3 extends SpooshPlugin<infer Types_1 extends PluginTypeConfig> ? Types_1 extends {
-    writeResult: infer W_1;
-} ? W_1 : object : object : never : never) extends infer T_4 ? T_4 extends (TPlugins[number] extends infer T_5 ? T_5 extends TPlugins[number] ? T_5 extends SpooshPlugin<infer Types_1 extends PluginTypeConfig> ? Types_1 extends {
-    writeResult: infer W_1;
-} ? W_1 : object : object : never : never) ? T_4 extends unknown ? (x: T_4) => void : never : never : never) extends (x: infer I) => void ? I : never, ExtractMethodOptions<TMethod> & _spoosh_core.ResolveTypes<((TPlugins[number] extends infer T_6 ? T_6 extends TPlugins[number] ? T_6 extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
-    writeOptions: infer W;
-} ? W : object : object : never : never) extends infer T_7 ? T_7 extends (TPlugins[number] extends infer T_8 ? T_8 extends TPlugins[number] ? T_8 extends SpooshPlugin<infer Types extends PluginTypeConfig> ? Types extends {
-    writeOptions: infer W;
-} ? W : object : object : never : never) ? T_7 extends unknown ? (x: T_7) => void : never : never : never) extends (x: infer I) => void ? I : never, ResolverContext<TSchema, ExtractMethodData<TMethod>, [ExtractMethodError<TMethod>] extends [unknown] ? TDefaultError : ExtractMethodError<TMethod>, ExtractMethodQuery<TMethod>, ExtractMethodBody<TMethod>, ExtractResponseParamNames<TMethod> extends never ? never : Record<ExtractResponseParamNames<TMethod>, string | number>>>>> & WriteResponseInputFields<ExtractResponseQuery<TMethod>, ExtractResponseBody<TMethod>, ExtractResponseParamNames<TMethod>>;
+} ? W : object : object : never : never) ? T_1 extends unknown ? (x: T_1) => void : never : never : never) extends (x: infer I) => void ? I : never, ResolverContext<TSchema, ExtractMethodData<TMethod>, [ExtractMethodError<TMethod>] extends [unknown] ? TDefaultError : ExtractMethodError<TMethod>, ExtractMethodQuery<TMethod>, ExtractMethodBody<TMethod>, ExtractResponseParamNames<TMethod> extends never ? never : Record<ExtractResponseParamNames<TMethod>, string | number>>>, MergePluginResults<TPlugins>["write"]> & WriteResponseInputFields<ExtractResponseQuery<TMethod>, ExtractResponseBody<TMethod>, ExtractResponseParamNames<TMethod>>;
 
 declare function createUseInfiniteRead<TSchema, TDefaultError, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]>(options: Omit<SpooshInstanceShape<unknown, TSchema, TDefaultError, TPlugins>, "_types">): <TData, TItem, TError = TDefaultError, TRequest extends AnyInfiniteRequestOptions = AnyInfiniteRequestOptions>(readFn: (api: InfiniteReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<TData, TError>>, readOptions: BaseInfiniteReadOptions<TData, TItem, TRequest> & (((TPlugins[number] extends infer T_3 ? T_3 extends TPlugins[number] ? T_3 extends SpooshPlugin<infer Types_1 extends PluginTypeConfig> ? Types_1 extends {
     infiniteReadOptions: infer I_1;
@@ -422,4 +467,4 @@ declare function createUseInfiniteRead<TSchema, TDefaultError, TPlugins extends
     readResult: infer R;
 } ? R : object : object : never : never) ? T_1 extends unknown ? (x: T_1) => void : never : never : never) extends (x: infer I) => void ? I : never>;
 
-export { type BaseInfiniteReadOptions, type BaseInfiniteReadResult, type BaseReadOptions, type BaseReadResult, type BaseWriteResult, type PluginHooksConfig, type SpooshReactHooks, type UseInfiniteReadResult, type UseReadResult, type UseWriteResult, createReactSpoosh, createUseInfiniteRead, createUseRead, createUseWrite };
+export { type BaseInfiniteReadOptions, type BaseInfiniteReadResult, type BaseLazyReadResult, type BaseReadOptions, type BaseReadResult, type BaseWriteResult, type PluginHooksConfig, type SpooshReactHooks, type UseInfiniteReadResult, type UseReadResult, type UseWriteResult, createReactSpoosh, createUseInfiniteRead, createUseLazyRead, createUseRead, createUseWrite };