@spoosh/react 0.9.0 → 0.10.1

package/README.md

@@ -69,7 +69,7 @@ Trigger mutations with loading and error states.
 ```typescript
 function CreateUser() {
   const { trigger, loading, error } = useWrite(
-    (api) => api("users").POST
+    (api) => api("users").POST()
   );
 
   const handleSubmit = async (data: CreateUserBody) => {
@@ -90,7 +90,7 @@ function CreateUser() {
 }
 
 // With path parameters
-const updateUser = useWrite((api) => api("users/:id").PUT);
+const updateUser = useWrite((api) => api("users/:id").PUT());
 
 await updateUser.trigger({
   params: { id: userId },

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ReadClient, TagMode, SpooshResponse, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteClient, StateManager, EventEmitter, PluginExecutor, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginInstanceApi, SpooshOptions } from '@spoosh/core';
+import { ReadClient, TagMode, SpooshResponse, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteSelectorClient, SpooshBody, StateManager, EventEmitter, PluginExecutor, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginInstanceApi, SpooshOptions } from '@spoosh/core';
 
 type SuccessResponse<T> = Extract<T, {
     data: unknown;
@@ -81,28 +81,28 @@ type ResponseInputFields<TQuery, TBody, TParamNames extends string> = [
 ] extends [never, never, never] ? object : {
     input: ReadInputFields<TQuery, TBody, TParamNames>;
 };
-type TriggerAwaitedReturn<T> = T extends (...args: never[]) => infer R ? Awaited<R> : never;
-type ExtractInputFromResponse<T> = T extends {
+type TriggerAwaitedReturn$1<T> = T extends (...args: never[]) => infer R ? Awaited<R> : never;
+type ExtractInputFromResponse$1<T> = T extends {
     input: infer I;
 } ? I : never;
-type ExtractTriggerQuery<I> = I extends {
+type ExtractTriggerQuery$1<I> = I extends {
     query: infer Q;
 } ? {
     query?: Q;
 } : unknown;
-type ExtractTriggerBody<I> = I extends {
+type ExtractTriggerBody$1<I> = I extends {
     body: infer B;
 } ? {
     body?: B;
 } : unknown;
-type ExtractTriggerParams<I> = I extends {
+type ExtractTriggerParams$1<I> = I extends {
     params: infer P;
 } ? {
     params?: P;
 } : unknown;
-type TriggerOptions<T> = ExtractInputFromResponse<TriggerAwaitedReturn<T>> extends infer I ? [I] extends [never] ? {
+type TriggerOptions<T> = ExtractInputFromResponse$1<TriggerAwaitedReturn$1<T>> extends infer I ? [I] extends [never] ? {
     force?: boolean;
-} : ExtractTriggerQuery<I> & ExtractTriggerBody<I> & ExtractTriggerParams<I> & {
+} : ExtractTriggerQuery$1<I> & ExtractTriggerBody$1<I> & ExtractTriggerParams$1<I> & {
     /** Force refetch even if data is cached */
     force?: boolean;
 } : {
@@ -160,6 +160,30 @@ 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 TriggerAwaitedReturn<T> = T extends (...args: any[]) => infer R ? Awaited<R> : never;
+type ExtractInputFromResponse<T> = T extends {
+    input: infer I;
+} ? I : never;
+type ExtractTriggerQuery<I> = I extends {
+    query: infer Q;
+} ? undefined extends Q ? {
+    query?: Exclude<Q, undefined>;
+} : {
+    query: Q;
+} : unknown;
+type ExtractTriggerBody<I> = I extends {
+    body: infer B;
+} ? undefined extends B ? {
+    body?: Exclude<B, undefined> | SpooshBody<Exclude<B, undefined>>;
+} : {
+    body: B | SpooshBody<B>;
+} : unknown;
+type ExtractTriggerParams<I> = I extends {
+    params: infer P;
+} ? {
+    params: P;
+} : unknown;
+type WriteTriggerInput<T> = ExtractInputFromResponse<TriggerAwaitedReturn<T>> extends infer I ? [I] extends [never] ? object : ExtractTriggerQuery<I> & ExtractTriggerBody<I> & ExtractTriggerParams<I> : object;
 /**
  * Result returned by `useWrite` hook.
  *
@@ -183,7 +207,7 @@ type BaseWriteResult<TData, TError, TOptions, TMeta = Record<string, unknown>> =
     abort: () => void;
 };
 type UseWriteResult<TData, TError, TOptions, TMeta, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]> = BaseWriteResult<TData, TError, TOptions, TMeta> & MergePluginResults<TPlugins>["write"];
-type WriteApiClient<TSchema, TDefaultError> = WriteClient<TSchema, TDefaultError>;
+type WriteApiClient<TSchema, TDefaultError> = WriteSelectorClient<TSchema, TDefaultError>;
 
 type TagModeInArray = "all" | "self";
 type AnyInfiniteRequestOptions = {
@@ -286,12 +310,13 @@ type InfiniteReadApiClient<TSchema, TDefaultError> = ReadClient<TSchema, TDefaul
 type InferError<T, TDefaultError> = [T] extends [unknown] ? TDefaultError : T;
 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> = ResolveTypes<MergePluginOptions<TPlugins>["write"], WriteResolverContext<TSchema, TMethod, TDefaultError>>;
+type ResolvedWriteTriggerOptions<TSchema, TPlugins extends PluginArray, TMethod, TDefaultError> = ResolveTypes<MergePluginOptions<TPlugins>["writeTrigger"], WriteResolverContext<TSchema, TMethod, TDefaultError>>;
 type UseReadFn<TDefaultError, TSchema, TPlugins extends PluginArray> = {
     <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, 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>, TriggerOptions<TReadFn>> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
     <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, unknown>>>(readFn: TReadFn): BaseReadResult<ExtractMethodData<TReadFn>, InferError<ExtractMethodError<TReadFn>, TDefaultError>, MergePluginResults<TPlugins>["read"], TriggerOptions<TReadFn>> & 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>>;
+    <TWriteFn extends (api: WriteApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, unknown>>, TWriteOpts extends ResolvedWriteOptions<TSchema, TPlugins, TWriteFn, TDefaultError> = ResolvedWriteOptions<TSchema, TPlugins, TWriteFn, TDefaultError>>(writeFn: TWriteFn, writeOptions?: TWriteOpts): BaseWriteResult<ExtractMethodData<TWriteFn>, InferError<ExtractMethodError<TWriteFn>, TDefaultError>, WriteTriggerInput<TWriteFn> & ResolvedWriteTriggerOptions<TSchema, TPlugins, TWriteFn, TDefaultError>, ResolveResultTypes<MergePluginResults<TPlugins>["write"], TWriteOpts>> & WriteResponseInputFields<ExtractMethodQuery<TWriteFn>, ExtractMethodBody<TWriteFn>, ExtractResponseParamNames<TWriteFn>>;
 };
 type InfiniteReadResolverContext<TSchema, TData, TError, TRequest> = ResolverContext<TSchema, TData, TError, TRequest extends {
     query: infer Q;
@@ -331,12 +356,12 @@ 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`)
+     * @param writeFn - Function that selects the API endpoint (e.g., `(api) => api("posts").POST()`)
      * @returns Object containing `trigger`, `data`, `error`, `loading`, and `abort`
      *
      * @example
      * ```tsx
-     * const { trigger, loading, data } = useWrite((api) => api("posts").POST);
+     * const { trigger, loading, data } = useWrite((api) => api("posts").POST());
      *
      * const handleSubmit = async (formData) => {
      *   const { data, error } = await trigger({ body: formData });

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ReadClient, TagMode, SpooshResponse, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteClient, StateManager, EventEmitter, PluginExecutor, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginInstanceApi, SpooshOptions } from '@spoosh/core';
+import { ReadClient, TagMode, SpooshResponse, SpooshPlugin, PluginTypeConfig, MergePluginResults, WriteSelectorClient, SpooshBody, StateManager, EventEmitter, PluginExecutor, PluginArray, ResolveTypes, MergePluginOptions, ResolverContext, ResolveResultTypes, MergePluginInstanceApi, SpooshOptions } from '@spoosh/core';
 
 type SuccessResponse<T> = Extract<T, {
     data: unknown;
@@ -81,28 +81,28 @@ type ResponseInputFields<TQuery, TBody, TParamNames extends string> = [
 ] extends [never, never, never] ? object : {
     input: ReadInputFields<TQuery, TBody, TParamNames>;
 };
-type TriggerAwaitedReturn<T> = T extends (...args: never[]) => infer R ? Awaited<R> : never;
-type ExtractInputFromResponse<T> = T extends {
+type TriggerAwaitedReturn$1<T> = T extends (...args: never[]) => infer R ? Awaited<R> : never;
+type ExtractInputFromResponse$1<T> = T extends {
     input: infer I;
 } ? I : never;
-type ExtractTriggerQuery<I> = I extends {
+type ExtractTriggerQuery$1<I> = I extends {
     query: infer Q;
 } ? {
     query?: Q;
 } : unknown;
-type ExtractTriggerBody<I> = I extends {
+type ExtractTriggerBody$1<I> = I extends {
     body: infer B;
 } ? {
     body?: B;
 } : unknown;
-type ExtractTriggerParams<I> = I extends {
+type ExtractTriggerParams$1<I> = I extends {
     params: infer P;
 } ? {
     params?: P;
 } : unknown;
-type TriggerOptions<T> = ExtractInputFromResponse<TriggerAwaitedReturn<T>> extends infer I ? [I] extends [never] ? {
+type TriggerOptions<T> = ExtractInputFromResponse$1<TriggerAwaitedReturn$1<T>> extends infer I ? [I] extends [never] ? {
     force?: boolean;
-} : ExtractTriggerQuery<I> & ExtractTriggerBody<I> & ExtractTriggerParams<I> & {
+} : ExtractTriggerQuery$1<I> & ExtractTriggerBody$1<I> & ExtractTriggerParams$1<I> & {
     /** Force refetch even if data is cached */
     force?: boolean;
 } : {
@@ -160,6 +160,30 @@ 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 TriggerAwaitedReturn<T> = T extends (...args: any[]) => infer R ? Awaited<R> : never;
+type ExtractInputFromResponse<T> = T extends {
+    input: infer I;
+} ? I : never;
+type ExtractTriggerQuery<I> = I extends {
+    query: infer Q;
+} ? undefined extends Q ? {
+    query?: Exclude<Q, undefined>;
+} : {
+    query: Q;
+} : unknown;
+type ExtractTriggerBody<I> = I extends {
+    body: infer B;
+} ? undefined extends B ? {
+    body?: Exclude<B, undefined> | SpooshBody<Exclude<B, undefined>>;
+} : {
+    body: B | SpooshBody<B>;
+} : unknown;
+type ExtractTriggerParams<I> = I extends {
+    params: infer P;
+} ? {
+    params: P;
+} : unknown;
+type WriteTriggerInput<T> = ExtractInputFromResponse<TriggerAwaitedReturn<T>> extends infer I ? [I] extends [never] ? object : ExtractTriggerQuery<I> & ExtractTriggerBody<I> & ExtractTriggerParams<I> : object;
 /**
  * Result returned by `useWrite` hook.
  *
@@ -183,7 +207,7 @@ type BaseWriteResult<TData, TError, TOptions, TMeta = Record<string, unknown>> =
     abort: () => void;
 };
 type UseWriteResult<TData, TError, TOptions, TMeta, TPlugins extends readonly SpooshPlugin<PluginTypeConfig>[]> = BaseWriteResult<TData, TError, TOptions, TMeta> & MergePluginResults<TPlugins>["write"];
-type WriteApiClient<TSchema, TDefaultError> = WriteClient<TSchema, TDefaultError>;
+type WriteApiClient<TSchema, TDefaultError> = WriteSelectorClient<TSchema, TDefaultError>;
 
 type TagModeInArray = "all" | "self";
 type AnyInfiniteRequestOptions = {
@@ -286,12 +310,13 @@ type InfiniteReadApiClient<TSchema, TDefaultError> = ReadClient<TSchema, TDefaul
 type InferError<T, TDefaultError> = [T] extends [unknown] ? TDefaultError : T;
 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> = ResolveTypes<MergePluginOptions<TPlugins>["write"], WriteResolverContext<TSchema, TMethod, TDefaultError>>;
+type ResolvedWriteTriggerOptions<TSchema, TPlugins extends PluginArray, TMethod, TDefaultError> = ResolveTypes<MergePluginOptions<TPlugins>["writeTrigger"], WriteResolverContext<TSchema, TMethod, TDefaultError>>;
 type UseReadFn<TDefaultError, TSchema, TPlugins extends PluginArray> = {
     <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, 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>, TriggerOptions<TReadFn>> & ResponseInputFields<ExtractResponseQuery<TReadFn>, ExtractResponseBody<TReadFn>, ExtractResponseParamNames<TReadFn>>;
     <TReadFn extends (api: ReadApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, unknown>>>(readFn: TReadFn): BaseReadResult<ExtractMethodData<TReadFn>, InferError<ExtractMethodError<TReadFn>, TDefaultError>, MergePluginResults<TPlugins>["read"], TriggerOptions<TReadFn>> & 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>>;
+    <TWriteFn extends (api: WriteApiClient<TSchema, TDefaultError>) => Promise<SpooshResponse<unknown, unknown>>, TWriteOpts extends ResolvedWriteOptions<TSchema, TPlugins, TWriteFn, TDefaultError> = ResolvedWriteOptions<TSchema, TPlugins, TWriteFn, TDefaultError>>(writeFn: TWriteFn, writeOptions?: TWriteOpts): BaseWriteResult<ExtractMethodData<TWriteFn>, InferError<ExtractMethodError<TWriteFn>, TDefaultError>, WriteTriggerInput<TWriteFn> & ResolvedWriteTriggerOptions<TSchema, TPlugins, TWriteFn, TDefaultError>, ResolveResultTypes<MergePluginResults<TPlugins>["write"], TWriteOpts>> & WriteResponseInputFields<ExtractMethodQuery<TWriteFn>, ExtractMethodBody<TWriteFn>, ExtractResponseParamNames<TWriteFn>>;
 };
 type InfiniteReadResolverContext<TSchema, TData, TError, TRequest> = ResolverContext<TSchema, TData, TError, TRequest extends {
     query: infer Q;
@@ -331,12 +356,12 @@ 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`)
+     * @param writeFn - Function that selects the API endpoint (e.g., `(api) => api("posts").POST()`)
      * @returns Object containing `trigger`, `data`, `error`, `loading`, and `abort`
      *
      * @example
      * ```tsx
-     * const { trigger, loading, data } = useWrite((api) => api("posts").POST);
+     * const { trigger, loading, data } = useWrite((api) => api("posts").POST());
      *
      * const handleSubmit = async (formData) => {
      *   const { data, error } = await trigger({ body: formData });

package/dist/index.js

@@ -112,7 +112,7 @@ function createUseRead(options) {
     const tagsKey = JSON.stringify(tags);
     const executeWithTracking = (0, import_react.useCallback)(
       async (force = false, overrideOptions) => {
-        setRequestState((prev) => ({ ...prev, isPending: true }));
+        setRequestState({ isPending: true, error: void 0 });
         try {
           const execOptions = overrideOptions ? { ...capturedCall.options ?? {}, ...overrideOptions } : void 0;
           const response = await controller.execute(execOptions, { force });
@@ -226,7 +226,7 @@ function createUseRead(options) {
         };
         forceUpdate((n) => n + 1);
         newController.mount();
-        setRequestState((prev) => ({ ...prev, isPending: true }));
+        setRequestState({ isPending: true, error: void 0 });
         try {
           const response = await newController.execute(mergedOptions, {
             force
@@ -294,7 +294,7 @@ var import_react2 = require("react");
 var import_core2 = require("@spoosh/core");
 function createUseWrite(options) {
   const { api, stateManager, pluginExecutor, eventEmitter } = options;
-  function useWrite(writeFn) {
+  function useWrite(writeFn, writeOptions) {
     const instanceId = (0, import_react2.useId)();
     const selectorResultRef = (0, import_react2.useRef)({
       call: null,
@@ -304,16 +304,16 @@ function createUseWrite(options) {
       selectorResultRef.current = result;
     });
     writeFn(selectorProxy);
-    const selectedEndpoint = selectorResultRef.current.selector;
-    if (!selectedEndpoint) {
+    const capturedCall = selectorResultRef.current.call;
+    if (!capturedCall) {
       throw new Error(
-        'useWrite requires selecting an HTTP method (POST, PUT, PATCH, DELETE). Example: useWrite((api) => api("posts").POST)'
+        'useWrite requires calling an HTTP method (POST, PUT, PATCH, DELETE). Example: useWrite((api) => api("posts").POST())'
       );
     }
-    const pathSegments = selectedEndpoint.path.split("/").filter(Boolean);
+    const pathSegments = capturedCall.path.split("/").filter(Boolean);
     const queryKey = stateManager.createQueryKey({
-      path: selectedEndpoint.path,
-      method: selectedEndpoint.method,
+      path: capturedCall.path,
+      method: capturedCall.method,
       options: void 0
     });
     const controllerRef = (0, import_react2.useRef)(null);
@@ -321,16 +321,16 @@ function createUseWrite(options) {
       controllerRef.current = {
         controller: (0, import_core2.createOperationController)({
           operationType: "write",
-          path: selectedEndpoint.path,
-          method: selectedEndpoint.method,
+          path: capturedCall.path,
+          method: capturedCall.method,
           tags: [],
           stateManager,
           eventEmitter,
           pluginExecutor,
           instanceId,
           fetchFn: async (fetchOpts) => {
-            const pathMethods = api(selectedEndpoint.path);
-            const method = pathMethods[selectedEndpoint.method];
+            const pathMethods = api(capturedCall.path);
+            const method = pathMethods[capturedCall.method];
             return method(fetchOpts);
           }
         }),
@@ -351,11 +351,12 @@ function createUseWrite(options) {
     const trigger = (0, import_react2.useCallback)(
       async (triggerOptions) => {
         setLastTriggerOptions(triggerOptions);
-        setRequestState((prev) => ({ ...prev, isPending: true }));
+        setRequestState({ isPending: true, error: void 0 });
         const params = triggerOptions?.params;
         const resolvedPath = (0, import_core2.resolvePath)(pathSegments, params);
         const tags = (0, import_core2.resolveTags)(triggerOptions, resolvedPath);
-        controller.setPluginOptions({ ...triggerOptions, tags });
+        const mergedOptions = { ...writeOptions, ...triggerOptions, tags };
+        controller.setPluginOptions(mergedOptions);
         try {
           const response = await controller.execute(triggerOptions, {
             force: true
@@ -371,7 +372,7 @@ function createUseWrite(options) {
           return { error: err };
         }
       },
-      [selectedEndpoint.path]
+      [capturedCall.path]
     );
     const entry = stateManager.getCache(queryKey);
     const pluginResultData = entry?.meta ? Object.fromEntries(entry.meta) : {};

package/dist/index.mjs

@@ -99,7 +99,7 @@ function createUseRead(options) {
     const tagsKey = JSON.stringify(tags);
     const executeWithTracking = useCallback(
       async (force = false, overrideOptions) => {
-        setRequestState((prev) => ({ ...prev, isPending: true }));
+        setRequestState({ isPending: true, error: void 0 });
         try {
           const execOptions = overrideOptions ? { ...capturedCall.options ?? {}, ...overrideOptions } : void 0;
           const response = await controller.execute(execOptions, { force });
@@ -213,7 +213,7 @@ function createUseRead(options) {
         };
         forceUpdate((n) => n + 1);
         newController.mount();
-        setRequestState((prev) => ({ ...prev, isPending: true }));
+        setRequestState({ isPending: true, error: void 0 });
         try {
           const response = await newController.execute(mergedOptions, {
             force
@@ -292,7 +292,7 @@ import {
 } from "@spoosh/core";
 function createUseWrite(options) {
   const { api, stateManager, pluginExecutor, eventEmitter } = options;
-  function useWrite(writeFn) {
+  function useWrite(writeFn, writeOptions) {
     const instanceId = useId2();
     const selectorResultRef = useRef2({
       call: null,
@@ -302,16 +302,16 @@ function createUseWrite(options) {
       selectorResultRef.current = result;
     });
     writeFn(selectorProxy);
-    const selectedEndpoint = selectorResultRef.current.selector;
-    if (!selectedEndpoint) {
+    const capturedCall = selectorResultRef.current.call;
+    if (!capturedCall) {
       throw new Error(
-        'useWrite requires selecting an HTTP method (POST, PUT, PATCH, DELETE). Example: useWrite((api) => api("posts").POST)'
+        'useWrite requires calling an HTTP method (POST, PUT, PATCH, DELETE). Example: useWrite((api) => api("posts").POST())'
       );
     }
-    const pathSegments = selectedEndpoint.path.split("/").filter(Boolean);
+    const pathSegments = capturedCall.path.split("/").filter(Boolean);
     const queryKey = stateManager.createQueryKey({
-      path: selectedEndpoint.path,
-      method: selectedEndpoint.method,
+      path: capturedCall.path,
+      method: capturedCall.method,
       options: void 0
     });
     const controllerRef = useRef2(null);
@@ -319,16 +319,16 @@ function createUseWrite(options) {
       controllerRef.current = {
         controller: createOperationController2({
           operationType: "write",
-          path: selectedEndpoint.path,
-          method: selectedEndpoint.method,
+          path: capturedCall.path,
+          method: capturedCall.method,
           tags: [],
           stateManager,
           eventEmitter,
           pluginExecutor,
           instanceId,
           fetchFn: async (fetchOpts) => {
-            const pathMethods = api(selectedEndpoint.path);
-            const method = pathMethods[selectedEndpoint.method];
+            const pathMethods = api(capturedCall.path);
+            const method = pathMethods[capturedCall.method];
             return method(fetchOpts);
           }
         }),
@@ -349,11 +349,12 @@ function createUseWrite(options) {
     const trigger = useCallback2(
       async (triggerOptions) => {
         setLastTriggerOptions(triggerOptions);
-        setRequestState((prev) => ({ ...prev, isPending: true }));
+        setRequestState({ isPending: true, error: void 0 });
         const params = triggerOptions?.params;
         const resolvedPath = resolvePath2(pathSegments, params);
         const tags = resolveTags2(triggerOptions, resolvedPath);
-        controller.setPluginOptions({ ...triggerOptions, tags });
+        const mergedOptions = { ...writeOptions, ...triggerOptions, tags };
+        controller.setPluginOptions(mergedOptions);
         try {
           const response = await controller.execute(triggerOptions, {
             force: true
@@ -369,7 +370,7 @@ function createUseWrite(options) {
           return { error: err };
         }
       },
-      [selectedEndpoint.path]
+      [capturedCall.path]
     );
     const entry = stateManager.getCache(queryKey);
     const pluginResultData = entry?.meta ? Object.fromEntries(entry.meta) : {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@spoosh/react",
-  "version": "0.9.0",
+  "version": "0.10.1",
   "license": "MIT",
   "description": "React hooks for Spoosh API toolkit",
   "keywords": [
@@ -34,13 +34,13 @@
     }
   },
   "peerDependencies": {
-    "@spoosh/core": ">=0.13.0",
+    "@spoosh/core": ">=0.13.2",
     "react": "^18 || ^19"
   },
   "devDependencies": {
     "@testing-library/react": "^16.0.0",
     "jsdom": "^26.0.0",
-    "@spoosh/core": "0.13.0",
+    "@spoosh/core": "0.13.2",
     "@spoosh/test-utils": "0.2.0"
   },
   "scripts": {