api-core-lib 16.12.134 → 16.12.136

package/dist/{apiModule.types-DEskFzOY.d.cts → apiModule.types-hGWAkTwf.d.cts}

@@ -196,10 +196,12 @@ interface t {
     payload?: any;
 }
 
+/** @description Extends the base ActionState with an `isStale` flag for automatic refetching. */
 interface ActionState<TOutput> extends ActionStateModule<TOutput> {
     isStale?: boolean;
 }
-interface ActionConfigModule<TInput extends Record<string, any> | undefined = undefined, TOutput = unknown> {
+/** @description Defines the configuration for a single API action within a module. */
+interface ActionConfigModule<TInput = unknown, TOutput = unknown> {
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     path: string;
     description?: string;
@@ -213,17 +215,17 @@ interface ActionConfigModule<TInput extends Record<string, any> | undefined = un
     _input?: TInput;
     _output?: TOutput;
 }
+/** @description Defines the complete structure of an API module. */
+/**
+ * يصف إعدادات موديول API كامل.
+ * @template TActions كائن يصف جميع الإجراءات المتاحة في الموديول.
+ */
 interface ApiModuleConfig<TActions extends Record<string, ActionConfigModule<any, any>>> {
     baseEndpoint: string;
     actions: TActions;
 }
-interface UrlSyncOptions<TModule extends ApiModuleConfig<any>> {
-    searchParams: string;
-    updateUrl: (newSearchParams: string) => void;
-    actionsToSync: (keyof TModule['actions'])[];
-    defaultSyncAction?: keyof TModule['actions'];
-}
-interface UseApiModuleOptions<TModule extends ApiModuleConfig<any>, TExtra = {}> {
+/** @description Configuration options passed directly to the `useApiModule` hook. */
+interface UseApiModuleOptions<TExtra = {}> {
     onSuccess?: (actionName: string, message: string, data: unknown) => void;
     onError?: (actionName: string, message: string, error?: ApiError | null) => void;
     refetchOnWindowFocus?: boolean;
@@ -231,12 +233,12 @@ interface UseApiModuleOptions<TModule extends ApiModuleConfig<any>, TExtra = {}>
     enabled?: boolean;
     hydratedState?: string;
     extraContextData?: TExtra;
-    urlSync?: UrlSyncOptions<TModule>;
-    defaultQueryOptions?: Partial<Record<keyof TModule['actions'], QueryOptions>>;
-    initialActionsToExecute?: (keyof TModule['actions'])[];
 }
+/** A utility type to infer the Input type (`TInput`) from an ActionConfigModule. */
 type InputOf<TActionConfig> = TActionConfig extends ActionConfigModule<infer TInput, any> ? TInput : never;
+/** A utility type to infer the Output type (`TOutput`) from an ActionConfigModule. */
 type OutputOf<TActionConfig> = TActionConfig extends ActionConfigModule<any, infer TOutput> ? TOutput : never;
+/** @description Defines the options for the `execute` function, enabling optimistic updates. */
 interface ExecuteOptions<TInput, TOutput, TContext = unknown> {
     pathParams?: Record<string, any>;
     config?: AxiosRequestConfig;
@@ -245,6 +247,7 @@ interface ExecuteOptions<TInput, TOutput, TContext = unknown> {
     onError?: (error: ApiError, context?: TContext) => void;
     onSettled?: (data?: TOutput, error?: ApiError, context?: TContext) => void;
 }
+/** @description A fully-typed object representing the callable actions for a module. */
 type ModuleActions<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in keyof TActions]: {
         execute: <TContext = unknown>(input?: InputOf<TActions[K]>, options?: ExecuteOptions<InputOf<TActions[K]>, OutputOf<TActions[K]>, TContext>) => Promise<StandardResponse<OutputOf<TActions[K]>>>;
@@ -253,26 +256,44 @@ type ModuleActions<TActions extends Record<string, ActionConfigModule<any, any>>
         }) => void;
     };
 };
+/** @description A fully-typed object representing the reactive states for each action in a module. */
 type ModuleStates<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in keyof TActions]: ActionState<OutputOf<TActions[K]>>;
 };
 type ActionsWithQuery<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in keyof TActions]: TActions[K] extends ActionConfigModule<QueryOptions, any> ? K : never;
 }[keyof TActions];
+/**
+ * يُنشئ نوعًا لكائن `queries` يحتوي فقط على الإجراءات التي تقبل الكويري.
+ */
 type ModuleQueries<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in ActionsWithQuery<TActions>]: UseApiQuery;
 };
+/**
+ * @description The complete, fully-typed return object of the `useApiModule` hook.
+ */
 type UseApiModuleReturn<TActions extends Record<string, ActionConfigModule<any, any>>, TExtra extends object = {}> = {
     states: ModuleStates<TActions>;
     actions: ModuleActions<TActions>;
     queries: ModuleQueries<TActions>;
     dehydrate: () => string;
 } & TExtra;
+/**
+ * يصف دوال `execute` و `reset` لإجراء واحد.
+ * هذا النوع عام (generic) ليتناسب مع أنواع الإدخال والإخراج المختلفة لكل إجراء.
+ * @template TAction يمثل إعدادات الإجراء الواحد.
+ */
 type ActionMethods<TAction extends ActionConfigModule<any, any>> = {
+    /**
+     * الدالة الأساسية لتنفيذ طلب ה-API.
+     */
     execute: <TContext = unknown>(input?: InputOf<TAction>, options?: ExecuteOptions<InputOf<TAction>, OutputOf<TAction>, TContext>) => Promise<StandardResponse<OutputOf<TAction>>>;
+    /**
+     * دالة لإعادة تعيين حالة إجراء معين في ذاكرة التخزين المؤقت إلى حالته الأولية.
+     */
     reset: (input?: InputOf<TAction>, options?: {
         pathParams?: Record<string, any>;
     }) => void;
 };
 
-export type { ApiModuleConfig as A, ExecutableAction as E, InputOf as I, LogLevel as L, ModuleStates as M, OutputOf as O, PaginationMeta as P, QueryOptions as Q, RequestConfig as R, StandardResponse as S, Tokens as T, UseApiConfig as U, ValidationError as V, UseApiModuleOptions as a, UseApiModuleReturn as b, ModuleActions as c, ModuleQueries as d, ApiClientConfig as e, ActionConfigModule as f, ActionOptions as g, ActionStateModule as h, UseApiQuery as i, ApiError as j, TokenManager as k, MiddlewareContext as l, Middleware as m, RefreshTokenConfig as n, ActionConfig as o, UseApiState as p, ActionState as q, UrlSyncOptions as r, ExecuteOptions as s, t, ActionsWithQuery as u, ActionMethods as v };
+export type { ActionConfigModule as A, ExecutableAction as E, InputOf as I, LogLevel as L, ModuleStates as M, OutputOf as O, PaginationMeta as P, QueryOptions as Q, RequestConfig as R, StandardResponse as S, Tokens as T, UseApiConfig as U, ValidationError as V, ApiModuleConfig as a, UseApiModuleOptions as b, UseApiModuleReturn as c, ModuleActions as d, ModuleQueries as e, ApiClientConfig as f, ActionOptions as g, ActionStateModule as h, UseApiQuery as i, ApiError as j, TokenManager as k, MiddlewareContext as l, Middleware as m, RefreshTokenConfig as n, ActionConfig as o, UseApiState as p, ActionState as q, ExecuteOptions as r, ActionsWithQuery as s, t, ActionMethods as u };

package/dist/{apiModule.types-DEskFzOY.d.ts → apiModule.types-hGWAkTwf.d.ts}

@@ -196,10 +196,12 @@ interface t {
     payload?: any;
 }
 
+/** @description Extends the base ActionState with an `isStale` flag for automatic refetching. */
 interface ActionState<TOutput> extends ActionStateModule<TOutput> {
     isStale?: boolean;
 }
-interface ActionConfigModule<TInput extends Record<string, any> | undefined = undefined, TOutput = unknown> {
+/** @description Defines the configuration for a single API action within a module. */
+interface ActionConfigModule<TInput = unknown, TOutput = unknown> {
     method: 'GET' | 'POST' | 'PUT' | 'PATCH' | 'DELETE';
     path: string;
     description?: string;
@@ -213,17 +215,17 @@ interface ActionConfigModule<TInput extends Record<string, any> | undefined = un
     _input?: TInput;
     _output?: TOutput;
 }
+/** @description Defines the complete structure of an API module. */
+/**
+ * يصف إعدادات موديول API كامل.
+ * @template TActions كائن يصف جميع الإجراءات المتاحة في الموديول.
+ */
 interface ApiModuleConfig<TActions extends Record<string, ActionConfigModule<any, any>>> {
     baseEndpoint: string;
     actions: TActions;
 }
-interface UrlSyncOptions<TModule extends ApiModuleConfig<any>> {
-    searchParams: string;
-    updateUrl: (newSearchParams: string) => void;
-    actionsToSync: (keyof TModule['actions'])[];
-    defaultSyncAction?: keyof TModule['actions'];
-}
-interface UseApiModuleOptions<TModule extends ApiModuleConfig<any>, TExtra = {}> {
+/** @description Configuration options passed directly to the `useApiModule` hook. */
+interface UseApiModuleOptions<TExtra = {}> {
     onSuccess?: (actionName: string, message: string, data: unknown) => void;
     onError?: (actionName: string, message: string, error?: ApiError | null) => void;
     refetchOnWindowFocus?: boolean;
@@ -231,12 +233,12 @@ interface UseApiModuleOptions<TModule extends ApiModuleConfig<any>, TExtra = {}>
     enabled?: boolean;
     hydratedState?: string;
     extraContextData?: TExtra;
-    urlSync?: UrlSyncOptions<TModule>;
-    defaultQueryOptions?: Partial<Record<keyof TModule['actions'], QueryOptions>>;
-    initialActionsToExecute?: (keyof TModule['actions'])[];
 }
+/** A utility type to infer the Input type (`TInput`) from an ActionConfigModule. */
 type InputOf<TActionConfig> = TActionConfig extends ActionConfigModule<infer TInput, any> ? TInput : never;
+/** A utility type to infer the Output type (`TOutput`) from an ActionConfigModule. */
 type OutputOf<TActionConfig> = TActionConfig extends ActionConfigModule<any, infer TOutput> ? TOutput : never;
+/** @description Defines the options for the `execute` function, enabling optimistic updates. */
 interface ExecuteOptions<TInput, TOutput, TContext = unknown> {
     pathParams?: Record<string, any>;
     config?: AxiosRequestConfig;
@@ -245,6 +247,7 @@ interface ExecuteOptions<TInput, TOutput, TContext = unknown> {
     onError?: (error: ApiError, context?: TContext) => void;
     onSettled?: (data?: TOutput, error?: ApiError, context?: TContext) => void;
 }
+/** @description A fully-typed object representing the callable actions for a module. */
 type ModuleActions<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in keyof TActions]: {
         execute: <TContext = unknown>(input?: InputOf<TActions[K]>, options?: ExecuteOptions<InputOf<TActions[K]>, OutputOf<TActions[K]>, TContext>) => Promise<StandardResponse<OutputOf<TActions[K]>>>;
@@ -253,26 +256,44 @@ type ModuleActions<TActions extends Record<string, ActionConfigModule<any, any>>
         }) => void;
     };
 };
+/** @description A fully-typed object representing the reactive states for each action in a module. */
 type ModuleStates<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in keyof TActions]: ActionState<OutputOf<TActions[K]>>;
 };
 type ActionsWithQuery<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in keyof TActions]: TActions[K] extends ActionConfigModule<QueryOptions, any> ? K : never;
 }[keyof TActions];
+/**
+ * يُنشئ نوعًا لكائن `queries` يحتوي فقط على الإجراءات التي تقبل الكويري.
+ */
 type ModuleQueries<TActions extends Record<string, ActionConfigModule<any, any>>> = {
     [K in ActionsWithQuery<TActions>]: UseApiQuery;
 };
+/**
+ * @description The complete, fully-typed return object of the `useApiModule` hook.
+ */
 type UseApiModuleReturn<TActions extends Record<string, ActionConfigModule<any, any>>, TExtra extends object = {}> = {
     states: ModuleStates<TActions>;
     actions: ModuleActions<TActions>;
     queries: ModuleQueries<TActions>;
     dehydrate: () => string;
 } & TExtra;
+/**
+ * يصف دوال `execute` و `reset` لإجراء واحد.
+ * هذا النوع عام (generic) ليتناسب مع أنواع الإدخال والإخراج المختلفة لكل إجراء.
+ * @template TAction يمثل إعدادات الإجراء الواحد.
+ */
 type ActionMethods<TAction extends ActionConfigModule<any, any>> = {
+    /**
+     * الدالة الأساسية لتنفيذ طلب ה-API.
+     */
     execute: <TContext = unknown>(input?: InputOf<TAction>, options?: ExecuteOptions<InputOf<TAction>, OutputOf<TAction>, TContext>) => Promise<StandardResponse<OutputOf<TAction>>>;
+    /**
+     * دالة لإعادة تعيين حالة إجراء معين في ذاكرة التخزين المؤقت إلى حالته الأولية.
+     */
     reset: (input?: InputOf<TAction>, options?: {
         pathParams?: Record<string, any>;
     }) => void;
 };
 
-export type { ApiModuleConfig as A, ExecutableAction as E, InputOf as I, LogLevel as L, ModuleStates as M, OutputOf as O, PaginationMeta as P, QueryOptions as Q, RequestConfig as R, StandardResponse as S, Tokens as T, UseApiConfig as U, ValidationError as V, UseApiModuleOptions as a, UseApiModuleReturn as b, ModuleActions as c, ModuleQueries as d, ApiClientConfig as e, ActionConfigModule as f, ActionOptions as g, ActionStateModule as h, UseApiQuery as i, ApiError as j, TokenManager as k, MiddlewareContext as l, Middleware as m, RefreshTokenConfig as n, ActionConfig as o, UseApiState as p, ActionState as q, UrlSyncOptions as r, ExecuteOptions as s, t, ActionsWithQuery as u, ActionMethods as v };
+export type { ActionConfigModule as A, ExecutableAction as E, InputOf as I, LogLevel as L, ModuleStates as M, OutputOf as O, PaginationMeta as P, QueryOptions as Q, RequestConfig as R, StandardResponse as S, Tokens as T, UseApiConfig as U, ValidationError as V, ApiModuleConfig as a, UseApiModuleOptions as b, UseApiModuleReturn as c, ModuleActions as d, ModuleQueries as e, ApiClientConfig as f, ActionOptions as g, ActionStateModule as h, UseApiQuery as i, ApiError as j, TokenManager as k, MiddlewareContext as l, Middleware as m, RefreshTokenConfig as n, ActionConfig as o, UseApiState as p, ActionState as q, ExecuteOptions as r, ActionsWithQuery as s, t, ActionMethods as u };

package/dist/client.cjs

@@ -279,8 +279,7 @@ var ApiModuleProvider = ApiModuleContext.Provider;
 var createInitialState = () => ({
   data: null,
   lastSuccessAt: void 0,
-  meta: void 0,
-  links: void 0,
+  meta: [],
   validationErrors: [],
   error: null,
   loading: false,
@@ -322,117 +321,40 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
     refetchOnWindowFocus = true,
     onSuccess,
     onError,
-    pathParams: globalPathParams,
+    pathParams: modulePathParams,
     enabled = true,
     hydratedState,
-    extraContextData,
-    urlSync,
-    defaultQueryOptions,
-    initialActionsToExecute
+    extraContextData
   } = options;
-  const [queryOptions, setQueryOptions] = _react.useState.call(void 0, () => {
-    const initialOptions = {};
-    for (const actionName in moduleConfig.actions) {
-      const actionConfig = moduleConfig.actions[actionName];
-      if (actionConfig.hasQuery) {
-        initialOptions[actionName] = { ..._optionalChain([defaultQueryOptions, 'optionalAccess', _6 => _6[actionName]]) || {} };
-      }
-    }
-    return initialOptions;
-  });
-  const queryOptionsRef = _react.useRef.call(void 0, queryOptions);
-  const pathParamsRef = _react.useRef.call(void 0, globalPathParams);
-  const savedCallbacksRef = _react.useRef.call(void 0, { onSuccess, onError });
-  _react.useEffect.call(void 0, () => {
-    queryOptionsRef.current = queryOptions;
-  }, [queryOptions]);
+  const pathParamsString = _react.useMemo.call(void 0, () => JSON.stringify(modulePathParams || {}), [modulePathParams]);
+  const [queryOptions, setQueryOptions] = _react.useState.call(void 0, {});
+  const savedCallbacks = _react.useRef.call(void 0, { onSuccess, onError });
   _react.useEffect.call(void 0, () => {
-    pathParamsRef.current = globalPathParams;
-  }, [globalPathParams]);
-  _react.useEffect.call(void 0, () => {
-    savedCallbacksRef.current = { onSuccess, onError };
+    savedCallbacks.current = { onSuccess, onError };
   }, [onSuccess, onError]);
-  const stableActionsRef = _react.useRef.call(void 0, {});
-  _react.useEffect.call(void 0, () => {
+  _react.useMemo.call(void 0, () => {
     if (hydratedState) {
       _chunkJAMEOM7Tcjs.globalStateManager.rehydrate(hydratedState);
     }
   }, [hydratedState]);
-  _react.useEffect.call(void 0, () => {
-    if (!urlSync) return;
-    const { searchParams, actionsToSync, defaultSyncAction } = urlSync;
-    const params = new URLSearchParams(searchParams);
-    const queryFromUrl = {};
-    params.forEach((value, key) => {
-      const parts = key.split(".");
-      const hasPrefix = parts.length > 1;
-      const actionName = hasPrefix ? parts[0] : defaultSyncAction;
-      const paramKey = hasPrefix ? parts[1] : parts[0];
-      if (actionName && paramKey && actionsToSync.some((a) => a === actionName)) {
-        if (!queryFromUrl[actionName]) queryFromUrl[actionName] = {};
-        const isNum = !isNaN(Number(value)) && value.trim() !== "";
-        queryFromUrl[actionName][paramKey] = isNum ? Number(value) : value;
-      }
-    });
-    if (Object.keys(queryFromUrl).length > 0) {
-      setQueryOptions((prev) => {
-        const newState = { ...prev };
-        for (const actionName in queryFromUrl) {
-          newState[actionName] = { ...newState[actionName], ...queryFromUrl[actionName] };
-        }
-        return newState;
-      });
-    }
-  }, [_optionalChain([urlSync, 'optionalAccess', _7 => _7.searchParams]), _optionalChain([urlSync, 'optionalAccess', _8 => _8.actionsToSync]), _optionalChain([urlSync, 'optionalAccess', _9 => _9.defaultSyncAction])]);
-  _react.useEffect.call(void 0, () => {
-    if (!urlSync) return;
-    const { searchParams, updateUrl, actionsToSync, defaultSyncAction } = urlSync;
-    const currentParams = new URLSearchParams(searchParams);
-    let hasChanged = false;
-    for (const actionName in queryOptions) {
-      if (actionsToSync.some((a) => a === actionName)) {
-        const params = queryOptions[actionName];
-        const isDefaultAction = actionName === defaultSyncAction;
-        for (const key in params) {
-          const fullKey = isDefaultAction ? key : `${actionName}.${key}`;
-          const value = params[key];
-          const stringValue = value !== void 0 && value !== null ? String(value) : "";
-          if (currentParams.get(fullKey) !== stringValue) {
-            if (stringValue) currentParams.set(fullKey, stringValue);
-            else currentParams.delete(fullKey);
-            hasChanged = true;
-          }
-        }
-      }
-    }
-    if (hasChanged) {
-      updateUrl(currentParams.toString());
-    }
-  }, [queryOptions, _optionalChain([urlSync, 'optionalAccess', _10 => _10.updateUrl]), _optionalChain([urlSync, 'optionalAccess', _11 => _11.searchParams]), _optionalChain([urlSync, 'optionalAccess', _12 => _12.actionsToSync]), _optionalChain([urlSync, 'optionalAccess', _13 => _13.defaultSyncAction])]);
-  _react.useMemo.call(void 0, () => {
-    for (const actionName in moduleConfig.actions) {
+  const actions = _react.useMemo.call(void 0, () => {
+    return Object.keys(moduleConfig.actions).reduce((acc, actionName) => {
       const actionConfig = moduleConfig.actions[actionName];
       const shouldCache = actionConfig.cacheResponse !== false;
       const execute = async (input, options2 = {}) => {
-        const finalPathParams = { ...pathParamsRef.current, ...options2.pathParams };
-        const currentQueryOptions = queryOptionsRef.current[actionName];
-        let bodyForCall = input;
-        if (actionConfig.method === "GET" && actionConfig.hasQuery) {
-          bodyForCall = { ...currentQueryOptions, ..._optionalChain([options2, 'access', _14 => _14.config, 'optionalAccess', _15 => _15.params]), ...input };
-        } else if (actionConfig.upload && input) {
-          bodyForCall = new FormData();
-          for (const key in input) {
-            bodyForCall.append(key, input[key]);
-          }
-        }
-        const cacheKey = shouldCache ? _chunkJAMEOM7Tcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, bodyForCall, { pathParams: finalPathParams }) : "";
-        if (shouldCache) {
-          _chunkJAMEOM7Tcjs.globalStateManager.setState(cacheKey, (prev) => ({ ...prev, loading: true, called: true, error: null, isStale: false }));
-        }
+        const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+        const cacheKey = shouldCache ? _chunkJAMEOM7Tcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams }) : "";
+        let mutationContext;
         try {
+          if (options2.onMutate && shouldCache) {
+            mutationContext = await options2.onMutate(input);
+          }
+          if (shouldCache) {
+            _chunkJAMEOM7Tcjs.globalStateManager.setState(cacheKey, (prev) => ({ ...prev, loading: true, called: true, error: null, isStale: false }));
+          }
           const result = await _chunkJAMEOM7Tcjs.callDynamicApi.call(void 0, axiosInstance, moduleConfig.baseEndpoint, actionConfig, {
             pathParams: finalPathParams,
-            body: bodyForCall,
+            body: input,
             config: options2.config
           });
           if (shouldCache) {
@@ -446,69 +368,57 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
               links: result.links,
               message: result.message,
               validationErrors: result.validationErrors || [],
-              rawResponse: result.rawResponse,
-              lastSuccessAt: result.success ? Date.now() : prev.lastSuccessAt
+              rawResponse: result.rawResponse
             }));
           }
           if (result.success) {
-            _optionalChain([savedCallbacksRef, 'access', _16 => _16.current, 'access', _17 => _17.onSuccess, 'optionalCall', _18 => _18(actionName, result.message || "Action successful", result.data)]);
-            _optionalChain([options2, 'access', _19 => _19.onSuccess, 'optionalCall', _20 => _20(result.data, void 0)]);
-            _optionalChain([actionConfig, 'access', _21 => _21.invalidates, 'optionalAccess', _22 => _22.forEach, 'call', _23 => _23((keyToInvalidate) => {
+            _optionalChain([savedCallbacks, 'access', _6 => _6.current, 'access', _7 => _7.onSuccess, 'optionalCall', _8 => _8(actionName, result.message || "Action successful", result.data)]);
+            _optionalChain([options2, 'access', _9 => _9.onSuccess, 'optionalCall', _10 => _10(result.data, mutationContext)]);
+            _optionalChain([actionConfig, 'access', _11 => _11.invalidates, 'optionalAccess', _12 => _12.forEach, 'call', _13 => _13((keyToInvalidate) => {
               const prefix = `${moduleConfig.baseEndpoint}/${keyToInvalidate}::`;
               _chunkJAMEOM7Tcjs.globalStateManager.invalidateByPrefix(prefix);
             })]);
           } else {
-            _optionalChain([savedCallbacksRef, 'access', _24 => _24.current, 'access', _25 => _25.onError, 'optionalCall', _26 => _26(actionName, result.message || "Action failed", _nullishCoalesce(result.error, () => ( void 0)))]);
-            _optionalChain([options2, 'access', _27 => _27.onError, 'optionalCall', _28 => _28(result.error, void 0)]);
+            _optionalChain([savedCallbacks, 'access', _14 => _14.current, 'access', _15 => _15.onError, 'optionalCall', _16 => _16(actionName, result.message || "Action failed", _nullishCoalesce(result.error, () => ( void 0)))]);
+            _optionalChain([options2, 'access', _17 => _17.onError, 'optionalCall', _18 => _18(result.error, mutationContext)]);
           }
           return result;
         } catch (error) {
-          const apiError = _optionalChain([error, 'access', _29 => _29.response, 'optionalAccess', _30 => _30.data]) || { status: 500, message: error.message };
+          const apiError = _optionalChain([error, 'access', _19 => _19.response, 'optionalAccess', _20 => _20.data]) || { status: 500, message: error.message };
           if (shouldCache) {
             _chunkJAMEOM7Tcjs.globalStateManager.setState(cacheKey, (prev) => ({ ...prev, error: apiError, loading: false, success: false }));
           }
-          _optionalChain([savedCallbacksRef, 'access', _31 => _31.current, 'access', _32 => _32.onError, 'optionalCall', _33 => _33(actionName, apiError.message, apiError)]);
-          _optionalChain([options2, 'access', _34 => _34.onError, 'optionalCall', _35 => _35(apiError, void 0)]);
+          _optionalChain([savedCallbacks, 'access', _21 => _21.current, 'access', _22 => _22.onError, 'optionalCall', _23 => _23(actionName, apiError.message, apiError)]);
+          _optionalChain([options2, 'access', _24 => _24.onError, 'optionalCall', _25 => _25(apiError, mutationContext)]);
           throw error;
+        } finally {
+          if (options2.onSettled) {
+            options2.onSettled();
+          }
         }
       };
       const reset = (input, options2 = {}) => {
         if (shouldCache) {
-          const finalPathParams = { ...pathParamsRef.current, ...options2.pathParams };
+          const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
           const cacheKey = _chunkJAMEOM7Tcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
           _chunkJAMEOM7Tcjs.globalStateManager.setState(cacheKey, () => createInitialState());
         }
       };
-      stableActionsRef.current[actionName] = { execute, reset };
-    }
-  }, [axiosInstance, moduleConfig]);
-  const actions = _react.useMemo.call(void 0, () => stableActionsRef.current, []);
-  const initialFetchRef = _react.useRef.call(void 0, false);
-  _react.useEffect.call(void 0, () => {
-    if (typeof window === "undefined" || initialFetchRef.current || !enabled) return;
-    const actionsToRun = initialActionsToExecute ? initialActionsToExecute.map(String) : Object.keys(moduleConfig.actions).filter(
-      (actionName) => moduleConfig.actions[actionName].autoFetch
-    );
-    actionsToRun.forEach((actionName) => {
-      const key = actionName;
-      const executeAction = _optionalChain([actions, 'access', _36 => _36[key], 'optionalAccess', _37 => _37.execute]);
-      if (typeof executeAction === "function") {
-        executeAction();
-      }
-    });
-    initialFetchRef.current = true;
-  }, [actions, initialActionsToExecute, moduleConfig.actions, enabled]);
+      acc[actionName] = { execute, reset };
+      return acc;
+    }, {});
+  }, [axiosInstance, moduleConfig, pathParamsString]);
   const queries = _react.useMemo.call(void 0, () => {
     return Object.keys(moduleConfig.actions).reduce((acc, actionName) => {
       const actionConfig = moduleConfig.actions[actionName];
-      if (_optionalChain([actionConfig, 'optionalAccess', _38 => _38.hasQuery])) {
+      if (_optionalChain([actionConfig, 'optionalAccess', _26 => _26.hasQuery])) {
         const setActionQueryOptions = (updater) => {
           const key = actionName;
           setQueryOptions((prev) => ({ ...prev, [key]: typeof updater === "function" ? updater(prev[key] || {}) : updater }));
         };
+        const specificActionExecute = actions[actionName].execute;
         const refetch = () => {
-          const execute = actions[actionName].execute;
-          execute(queryOptions[actionName] || {});
+          specificActionExecute(queryOptions[actionName] || {});
         };
         acc[actionName] = {
           options: queryOptions[actionName] || {},
@@ -520,29 +430,39 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           setFilters: (filter) => setActionQueryOptions((p) => ({ ...p, filter, page: 1 })),
           setSorting: (sortBy) => setActionQueryOptions((p) => ({ ...p, sortBy })),
           setQueryParam: (key, value) => setActionQueryOptions((p) => ({ ...p, [key]: value, page: key !== "page" ? value : p.page })),
-          reset: () => setActionQueryOptions(_optionalChain([defaultQueryOptions, 'optionalAccess', _39 => _39[actionName]]) || {})
+          reset: () => setActionQueryOptions({})
         };
       }
       return acc;
     }, {});
-  }, [actions, queryOptions, moduleConfig.actions, defaultQueryOptions]);
+  }, [actions, queryOptions, moduleConfig.actions]);
   const states = {};
   function isActionWithQuery(key, actions2) {
-    return _optionalChain([actions2, 'access', _40 => _40[key], 'optionalAccess', _41 => _41.hasQuery]) === true;
+    return _optionalChain([actions2, 'access', _27 => _27[key], 'optionalAccess', _28 => _28.hasQuery]) === true;
   }
   for (const actionName in moduleConfig.actions) {
     if (Object.prototype.hasOwnProperty.call(moduleConfig.actions, actionName)) {
-      const key = actionName;
-      const actionConfig = moduleConfig.actions[key];
+      const actionConfig = moduleConfig.actions[actionName];
       if (actionConfig.cacheResponse !== false) {
         let currentQueryOptions;
-        if (isActionWithQuery(key, moduleConfig.actions)) {
-          currentQueryOptions = _optionalChain([queries, 'access', _42 => _42[key], 'optionalAccess', _43 => _43.options]);
+        if (isActionWithQuery(actionName, moduleConfig.actions)) {
+          currentQueryOptions = _optionalChain([queries, 'access', _29 => _29[actionName], 'optionalAccess', _30 => _30.options]);
         }
         const input = currentQueryOptions;
-        const pathParams = globalPathParams || {};
-        const cacheKey = _chunkJAMEOM7Tcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, input, { pathParams });
-        states[actionName] = useApiActionState(actionConfig, cacheKey, actions[key].execute, input, enabled);
+        const pathParams = JSON.parse(pathParamsString);
+        const cacheKey = _chunkJAMEOM7Tcjs.generateCacheKey.call(void 0, 
+          moduleConfig.baseEndpoint,
+          actionName,
+          input,
+          { pathParams }
+        );
+        states[actionName] = useApiActionState(
+          actionConfig,
+          cacheKey,
+          actions[actionName].execute,
+          input,
+          enabled
+        );
       } else {
         states[actionName] = createInitialState();
       }
@@ -553,10 +473,12 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
     if (!enabled || !refetchOnWindowFocus) return;
     const onFocus = () => {
       if (Date.now() - lastBlurTimestamp.current > 1e4) {
-        for (const actionName of Object.keys(moduleConfig.actions)) {
+        const actionKeys = Object.keys(moduleConfig.actions);
+        for (const actionName of actionKeys) {
           const state = states[actionName];
           if (state && state.called && !state.loading) {
-            _chunkJAMEOM7Tcjs.globalStateManager.invalidateByPrefix(`${moduleConfig.baseEndpoint}/${actionName}::`);
+            const prefix = `${moduleConfig.baseEndpoint}/${actionName}::`;
+            _chunkJAMEOM7Tcjs.globalStateManager.invalidateByPrefix(prefix);
           }
         }
       }
@@ -571,16 +493,14 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       window.removeEventListener("blur", onBlur);
     };
   }, [enabled, refetchOnWindowFocus, moduleConfig, states]);
-  const dehydrate = _react.useCallback.call(void 0, () => _chunkJAMEOM7Tcjs.globalStateManager.dehydrate(), []);
+  const dehydrate = _react.useMemo.call(void 0, () => {
+    return () => _chunkJAMEOM7Tcjs.globalStateManager.dehydrate();
+  }, []);
+  const baseApiReturn = { actions, states, queries, dehydrate };
   const finalApiReturn = _react.useMemo.call(void 0, () => ({
-    actions,
-    states,
-    queries,
-    dehydrate,
+    ...baseApiReturn,
     ...extraContextData || {}
-    // [REFACTOR] `states` and `queries` are now dependencies because they are recalculated on re-renders.
-    // `actions` is stable and doesn't need to be a dependency.
-  }), [actions, states, queries, dehydrate, extraContextData]);
+  }), [baseApiReturn, extraContextData]);
   return finalApiReturn;
 }
 

package/dist/client.d.cts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from 'axios';
-import { U as UseApiConfig, A as ApiModuleConfig, a as UseApiModuleOptions, b as UseApiModuleReturn, M as ModuleStates, c as ModuleActions, d as ModuleQueries } from './apiModule.types-DEskFzOY.cjs';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-mpeiDoxm.cjs';
+import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, M as ModuleStates, d as ModuleActions, e as ModuleQueries } from './apiModule.types-hGWAkTwf.cjs';
+import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-V-4fiB7L.cjs';
 import * as react from 'react';
 import { ReactNode } from 'react';
 
@@ -28,7 +28,7 @@ declare const ApiModuleProvider: react.Provider<{
     queries: ModuleQueries<any>;
     dehydrate: () => string;
 } | null>;
-declare function useApiModule<TModule extends ApiModuleConfig<any>, TExtra extends object = {}>(axiosInstance: AxiosInstance, moduleConfig: TModule, options?: UseApiModuleOptions<TModule, TExtra>): UseApiModuleReturn<TModule['actions'], TExtra>;
+declare function useApiModule<TActions extends Record<string, ActionConfigModule<any, any>>, TExtra extends object = {}>(axiosInstance: AxiosInstance, moduleConfig: ApiModuleConfig<TActions>, options?: UseApiModuleOptions<TExtra>): UseApiModuleReturn<TActions, TExtra>;
 
 /**
  * Creates a strongly-typed React Context, Provider, and consumer hook for a specific API module.

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from 'axios';
-import { U as UseApiConfig, A as ApiModuleConfig, a as UseApiModuleOptions, b as UseApiModuleReturn, M as ModuleStates, c as ModuleActions, d as ModuleQueries } from './apiModule.types-DEskFzOY.js';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-C31nzgeP.js';
+import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, M as ModuleStates, d as ModuleActions, e as ModuleQueries } from './apiModule.types-hGWAkTwf.js';
+import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-BJop2XPB.js';
 import * as react from 'react';
 import { ReactNode } from 'react';
 
@@ -28,7 +28,7 @@ declare const ApiModuleProvider: react.Provider<{
     queries: ModuleQueries<any>;
     dehydrate: () => string;
 } | null>;
-declare function useApiModule<TModule extends ApiModuleConfig<any>, TExtra extends object = {}>(axiosInstance: AxiosInstance, moduleConfig: TModule, options?: UseApiModuleOptions<TModule, TExtra>): UseApiModuleReturn<TModule['actions'], TExtra>;
+declare function useApiModule<TActions extends Record<string, ActionConfigModule<any, any>>, TExtra extends object = {}>(axiosInstance: AxiosInstance, moduleConfig: ApiModuleConfig<TActions>, options?: UseApiModuleOptions<TExtra>): UseApiModuleReturn<TActions, TExtra>;
 
 /**
  * Creates a strongly-typed React Context, Provider, and consumer hook for a specific API module.

package/dist/client.js

@@ -279,8 +279,7 @@ var ApiModuleProvider = ApiModuleContext.Provider;
 var createInitialState = () => ({
   data: null,
   lastSuccessAt: void 0,
-  meta: void 0,
-  links: void 0,
+  meta: [],
   validationErrors: [],
   error: null,
   loading: false,
@@ -322,117 +321,40 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
     refetchOnWindowFocus = true,
     onSuccess,
     onError,
-    pathParams: globalPathParams,
+    pathParams: modulePathParams,
     enabled = true,
     hydratedState,
-    extraContextData,
-    urlSync,
-    defaultQueryOptions,
-    initialActionsToExecute
+    extraContextData
   } = options;
-  const [queryOptions, setQueryOptions] = useState3(() => {
-    const initialOptions = {};
-    for (const actionName in moduleConfig.actions) {
-      const actionConfig = moduleConfig.actions[actionName];
-      if (actionConfig.hasQuery) {
-        initialOptions[actionName] = { ...defaultQueryOptions?.[actionName] || {} };
-      }
-    }
-    return initialOptions;
-  });
-  const queryOptionsRef = useRef4(queryOptions);
-  const pathParamsRef = useRef4(globalPathParams);
-  const savedCallbacksRef = useRef4({ onSuccess, onError });
-  useEffect4(() => {
-    queryOptionsRef.current = queryOptions;
-  }, [queryOptions]);
+  const pathParamsString = useMemo3(() => JSON.stringify(modulePathParams || {}), [modulePathParams]);
+  const [queryOptions, setQueryOptions] = useState3({});
+  const savedCallbacks = useRef4({ onSuccess, onError });
   useEffect4(() => {
-    pathParamsRef.current = globalPathParams;
-  }, [globalPathParams]);
-  useEffect4(() => {
-    savedCallbacksRef.current = { onSuccess, onError };
+    savedCallbacks.current = { onSuccess, onError };
   }, [onSuccess, onError]);
-  const stableActionsRef = useRef4({});
-  useEffect4(() => {
+  useMemo3(() => {
     if (hydratedState) {
       globalStateManager.rehydrate(hydratedState);
     }
   }, [hydratedState]);
-  useEffect4(() => {
-    if (!urlSync) return;
-    const { searchParams, actionsToSync, defaultSyncAction } = urlSync;
-    const params = new URLSearchParams(searchParams);
-    const queryFromUrl = {};
-    params.forEach((value, key) => {
-      const parts = key.split(".");
-      const hasPrefix = parts.length > 1;
-      const actionName = hasPrefix ? parts[0] : defaultSyncAction;
-      const paramKey = hasPrefix ? parts[1] : parts[0];
-      if (actionName && paramKey && actionsToSync.some((a) => a === actionName)) {
-        if (!queryFromUrl[actionName]) queryFromUrl[actionName] = {};
-        const isNum = !isNaN(Number(value)) && value.trim() !== "";
-        queryFromUrl[actionName][paramKey] = isNum ? Number(value) : value;
-      }
-    });
-    if (Object.keys(queryFromUrl).length > 0) {
-      setQueryOptions((prev) => {
-        const newState = { ...prev };
-        for (const actionName in queryFromUrl) {
-          newState[actionName] = { ...newState[actionName], ...queryFromUrl[actionName] };
-        }
-        return newState;
-      });
-    }
-  }, [urlSync?.searchParams, urlSync?.actionsToSync, urlSync?.defaultSyncAction]);
-  useEffect4(() => {
-    if (!urlSync) return;
-    const { searchParams, updateUrl, actionsToSync, defaultSyncAction } = urlSync;
-    const currentParams = new URLSearchParams(searchParams);
-    let hasChanged = false;
-    for (const actionName in queryOptions) {
-      if (actionsToSync.some((a) => a === actionName)) {
-        const params = queryOptions[actionName];
-        const isDefaultAction = actionName === defaultSyncAction;
-        for (const key in params) {
-          const fullKey = isDefaultAction ? key : `${actionName}.${key}`;
-          const value = params[key];
-          const stringValue = value !== void 0 && value !== null ? String(value) : "";
-          if (currentParams.get(fullKey) !== stringValue) {
-            if (stringValue) currentParams.set(fullKey, stringValue);
-            else currentParams.delete(fullKey);
-            hasChanged = true;
-          }
-        }
-      }
-    }
-    if (hasChanged) {
-      updateUrl(currentParams.toString());
-    }
-  }, [queryOptions, urlSync?.updateUrl, urlSync?.searchParams, urlSync?.actionsToSync, urlSync?.defaultSyncAction]);
-  useMemo3(() => {
-    for (const actionName in moduleConfig.actions) {
+  const actions = useMemo3(() => {
+    return Object.keys(moduleConfig.actions).reduce((acc, actionName) => {
       const actionConfig = moduleConfig.actions[actionName];
       const shouldCache = actionConfig.cacheResponse !== false;
       const execute = async (input, options2 = {}) => {
-        const finalPathParams = { ...pathParamsRef.current, ...options2.pathParams };
-        const currentQueryOptions = queryOptionsRef.current[actionName];
-        let bodyForCall = input;
-        if (actionConfig.method === "GET" && actionConfig.hasQuery) {
-          bodyForCall = { ...currentQueryOptions, ...options2.config?.params, ...input };
-        } else if (actionConfig.upload && input) {
-          bodyForCall = new FormData();
-          for (const key in input) {
-            bodyForCall.append(key, input[key]);
-          }
-        }
-        const cacheKey = shouldCache ? generateCacheKey(moduleConfig.baseEndpoint, actionName, bodyForCall, { pathParams: finalPathParams }) : "";
-        if (shouldCache) {
-          globalStateManager.setState(cacheKey, (prev) => ({ ...prev, loading: true, called: true, error: null, isStale: false }));
-        }
+        const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+        const cacheKey = shouldCache ? generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams }) : "";
+        let mutationContext;
         try {
+          if (options2.onMutate && shouldCache) {
+            mutationContext = await options2.onMutate(input);
+          }
+          if (shouldCache) {
+            globalStateManager.setState(cacheKey, (prev) => ({ ...prev, loading: true, called: true, error: null, isStale: false }));
+          }
           const result = await callDynamicApi(axiosInstance, moduleConfig.baseEndpoint, actionConfig, {
             pathParams: finalPathParams,
-            body: bodyForCall,
+            body: input,
             config: options2.config
           });
           if (shouldCache) {
@@ -446,20 +368,19 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
               links: result.links,
               message: result.message,
               validationErrors: result.validationErrors || [],
-              rawResponse: result.rawResponse,
-              lastSuccessAt: result.success ? Date.now() : prev.lastSuccessAt
+              rawResponse: result.rawResponse
             }));
           }
           if (result.success) {
-            savedCallbacksRef.current.onSuccess?.(actionName, result.message || "Action successful", result.data);
-            options2.onSuccess?.(result.data, void 0);
+            savedCallbacks.current.onSuccess?.(actionName, result.message || "Action successful", result.data);
+            options2.onSuccess?.(result.data, mutationContext);
             actionConfig.invalidates?.forEach((keyToInvalidate) => {
               const prefix = `${moduleConfig.baseEndpoint}/${keyToInvalidate}::`;
               globalStateManager.invalidateByPrefix(prefix);
             });
           } else {
-            savedCallbacksRef.current.onError?.(actionName, result.message || "Action failed", result.error ?? void 0);
-            options2.onError?.(result.error, void 0);
+            savedCallbacks.current.onError?.(actionName, result.message || "Action failed", result.error ?? void 0);
+            options2.onError?.(result.error, mutationContext);
           }
           return result;
         } catch (error) {
@@ -467,37 +388,26 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           if (shouldCache) {
             globalStateManager.setState(cacheKey, (prev) => ({ ...prev, error: apiError, loading: false, success: false }));
           }
-          savedCallbacksRef.current.onError?.(actionName, apiError.message, apiError);
-          options2.onError?.(apiError, void 0);
+          savedCallbacks.current.onError?.(actionName, apiError.message, apiError);
+          options2.onError?.(apiError, mutationContext);
           throw error;
+        } finally {
+          if (options2.onSettled) {
+            options2.onSettled();
+          }
         }
       };
       const reset = (input, options2 = {}) => {
         if (shouldCache) {
-          const finalPathParams = { ...pathParamsRef.current, ...options2.pathParams };
+          const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
           const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
           globalStateManager.setState(cacheKey, () => createInitialState());
         }
       };
-      stableActionsRef.current[actionName] = { execute, reset };
-    }
-  }, [axiosInstance, moduleConfig]);
-  const actions = useMemo3(() => stableActionsRef.current, []);
-  const initialFetchRef = useRef4(false);
-  useEffect4(() => {
-    if (typeof window === "undefined" || initialFetchRef.current || !enabled) return;
-    const actionsToRun = initialActionsToExecute ? initialActionsToExecute.map(String) : Object.keys(moduleConfig.actions).filter(
-      (actionName) => moduleConfig.actions[actionName].autoFetch
-    );
-    actionsToRun.forEach((actionName) => {
-      const key = actionName;
-      const executeAction = actions[key]?.execute;
-      if (typeof executeAction === "function") {
-        executeAction();
-      }
-    });
-    initialFetchRef.current = true;
-  }, [actions, initialActionsToExecute, moduleConfig.actions, enabled]);
+      acc[actionName] = { execute, reset };
+      return acc;
+    }, {});
+  }, [axiosInstance, moduleConfig, pathParamsString]);
   const queries = useMemo3(() => {
     return Object.keys(moduleConfig.actions).reduce((acc, actionName) => {
       const actionConfig = moduleConfig.actions[actionName];
@@ -506,9 +416,9 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           const key = actionName;
           setQueryOptions((prev) => ({ ...prev, [key]: typeof updater === "function" ? updater(prev[key] || {}) : updater }));
         };
+        const specificActionExecute = actions[actionName].execute;
         const refetch = () => {
-          const execute = actions[actionName].execute;
-          execute(queryOptions[actionName] || {});
+          specificActionExecute(queryOptions[actionName] || {});
         };
         acc[actionName] = {
           options: queryOptions[actionName] || {},
@@ -520,29 +430,39 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           setFilters: (filter) => setActionQueryOptions((p) => ({ ...p, filter, page: 1 })),
           setSorting: (sortBy) => setActionQueryOptions((p) => ({ ...p, sortBy })),
           setQueryParam: (key, value) => setActionQueryOptions((p) => ({ ...p, [key]: value, page: key !== "page" ? value : p.page })),
-          reset: () => setActionQueryOptions(defaultQueryOptions?.[actionName] || {})
+          reset: () => setActionQueryOptions({})
         };
       }
       return acc;
     }, {});
-  }, [actions, queryOptions, moduleConfig.actions, defaultQueryOptions]);
+  }, [actions, queryOptions, moduleConfig.actions]);
   const states = {};
   function isActionWithQuery(key, actions2) {
     return actions2[key]?.hasQuery === true;
   }
   for (const actionName in moduleConfig.actions) {
     if (Object.prototype.hasOwnProperty.call(moduleConfig.actions, actionName)) {
-      const key = actionName;
-      const actionConfig = moduleConfig.actions[key];
+      const actionConfig = moduleConfig.actions[actionName];
       if (actionConfig.cacheResponse !== false) {
         let currentQueryOptions;
-        if (isActionWithQuery(key, moduleConfig.actions)) {
-          currentQueryOptions = queries[key]?.options;
+        if (isActionWithQuery(actionName, moduleConfig.actions)) {
+          currentQueryOptions = queries[actionName]?.options;
         }
         const input = currentQueryOptions;
-        const pathParams = globalPathParams || {};
-        const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams });
-        states[actionName] = useApiActionState(actionConfig, cacheKey, actions[key].execute, input, enabled);
+        const pathParams = JSON.parse(pathParamsString);
+        const cacheKey = generateCacheKey(
+          moduleConfig.baseEndpoint,
+          actionName,
+          input,
+          { pathParams }
+        );
+        states[actionName] = useApiActionState(
+          actionConfig,
+          cacheKey,
+          actions[actionName].execute,
+          input,
+          enabled
+        );
       } else {
         states[actionName] = createInitialState();
       }
@@ -553,10 +473,12 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
     if (!enabled || !refetchOnWindowFocus) return;
     const onFocus = () => {
       if (Date.now() - lastBlurTimestamp.current > 1e4) {
-        for (const actionName of Object.keys(moduleConfig.actions)) {
+        const actionKeys = Object.keys(moduleConfig.actions);
+        for (const actionName of actionKeys) {
           const state = states[actionName];
           if (state && state.called && !state.loading) {
-            globalStateManager.invalidateByPrefix(`${moduleConfig.baseEndpoint}/${actionName}::`);
+            const prefix = `${moduleConfig.baseEndpoint}/${actionName}::`;
+            globalStateManager.invalidateByPrefix(prefix);
           }
         }
       }
@@ -571,21 +493,19 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       window.removeEventListener("blur", onBlur);
     };
   }, [enabled, refetchOnWindowFocus, moduleConfig, states]);
-  const dehydrate = useCallback3(() => globalStateManager.dehydrate(), []);
+  const dehydrate = useMemo3(() => {
+    return () => globalStateManager.dehydrate();
+  }, []);
+  const baseApiReturn = { actions, states, queries, dehydrate };
   const finalApiReturn = useMemo3(() => ({
-    actions,
-    states,
-    queries,
-    dehydrate,
+    ...baseApiReturn,
     ...extraContextData || {}
-    // [REFACTOR] `states` and `queries` are now dependencies because they are recalculated on re-renders.
-    // `actions` is stable and doesn't need to be a dependency.
-  }), [actions, states, queries, dehydrate, extraContextData]);
+  }), [baseApiReturn, extraContextData]);
   return finalApiReturn;
 }
 
 // src/hooks/useApiModule/apiModuleContext.ts
-import { createContext as createContext2, useContext, createElement } from "react";
+import { createContext as createContext2, useContext as useContext2, createElement } from "react";
 function createApiModuleContext() {
   const Context = createContext2(null);
   Context.displayName = "ApiModuleContext";
@@ -593,7 +513,7 @@ function createApiModuleContext() {
     return createElement(Context.Provider, { value }, children);
   };
   const useConsumer = () => {
-    const context = useContext(Context);
+    const context = useContext2(Context);
     if (!context) {
       throw new Error("This component must be used within its corresponding ApiModuleProvider.");
     }

package/dist/index.d.cts

@@ -1,7 +1,7 @@
 import { AxiosInstance, AxiosRequestConfig, Method, AxiosResponse, AxiosError } from 'axios';
-import { e as ApiClientConfig, f as ActionConfigModule, S as StandardResponse, g as ActionOptions, R as RequestConfig, h as ActionStateModule, Q as QueryOptions, i as UseApiQuery, j as ApiError, L as LogLevel } from './apiModule.types-DEskFzOY.cjs';
-export { o as ActionConfig, v as ActionMethods, q as ActionState, u as ActionsWithQuery, A as ApiModuleConfig, E as ExecutableAction, s as ExecuteOptions, I as InputOf, m as Middleware, l as MiddlewareContext, c as ModuleActions, d as ModuleQueries, M as ModuleStates, O as OutputOf, P as PaginationMeta, n as RefreshTokenConfig, k as TokenManager, T as Tokens, r as UrlSyncOptions, U as UseApiConfig, a as UseApiModuleOptions, b as UseApiModuleReturn, p as UseApiState, V as ValidationError, t } from './apiModule.types-DEskFzOY.cjs';
-export { c as UseApiRecordActions, U as UseApiRecordConfig, a as UseApiRecordReturn, b as UseApiRecordState } from './useApiRecord.types-mpeiDoxm.cjs';
+import { f as ApiClientConfig, A as ActionConfigModule, S as StandardResponse, g as ActionOptions, R as RequestConfig, h as ActionStateModule, Q as QueryOptions, i as UseApiQuery, j as ApiError, L as LogLevel } from './apiModule.types-hGWAkTwf.cjs';
+export { o as ActionConfig, u as ActionMethods, q as ActionState, s as ActionsWithQuery, a as ApiModuleConfig, E as ExecutableAction, r as ExecuteOptions, I as InputOf, m as Middleware, l as MiddlewareContext, d as ModuleActions, e as ModuleQueries, M as ModuleStates, O as OutputOf, P as PaginationMeta, n as RefreshTokenConfig, k as TokenManager, T as Tokens, U as UseApiConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, p as UseApiState, V as ValidationError, t } from './apiModule.types-hGWAkTwf.cjs';
+export { c as UseApiRecordActions, U as UseApiRecordConfig, a as UseApiRecordReturn, b as UseApiRecordState } from './useApiRecord.types-V-4fiB7L.cjs';
 import 'react';
 
 declare function createApiClient(config: ApiClientConfig): AxiosInstance;

package/dist/index.d.ts

@@ -1,7 +1,7 @@
 import { AxiosInstance, AxiosRequestConfig, Method, AxiosResponse, AxiosError } from 'axios';
-import { e as ApiClientConfig, f as ActionConfigModule, S as StandardResponse, g as ActionOptions, R as RequestConfig, h as ActionStateModule, Q as QueryOptions, i as UseApiQuery, j as ApiError, L as LogLevel } from './apiModule.types-DEskFzOY.js';
-export { o as ActionConfig, v as ActionMethods, q as ActionState, u as ActionsWithQuery, A as ApiModuleConfig, E as ExecutableAction, s as ExecuteOptions, I as InputOf, m as Middleware, l as MiddlewareContext, c as ModuleActions, d as ModuleQueries, M as ModuleStates, O as OutputOf, P as PaginationMeta, n as RefreshTokenConfig, k as TokenManager, T as Tokens, r as UrlSyncOptions, U as UseApiConfig, a as UseApiModuleOptions, b as UseApiModuleReturn, p as UseApiState, V as ValidationError, t } from './apiModule.types-DEskFzOY.js';
-export { c as UseApiRecordActions, U as UseApiRecordConfig, a as UseApiRecordReturn, b as UseApiRecordState } from './useApiRecord.types-C31nzgeP.js';
+import { f as ApiClientConfig, A as ActionConfigModule, S as StandardResponse, g as ActionOptions, R as RequestConfig, h as ActionStateModule, Q as QueryOptions, i as UseApiQuery, j as ApiError, L as LogLevel } from './apiModule.types-hGWAkTwf.js';
+export { o as ActionConfig, u as ActionMethods, q as ActionState, s as ActionsWithQuery, a as ApiModuleConfig, E as ExecutableAction, r as ExecuteOptions, I as InputOf, m as Middleware, l as MiddlewareContext, d as ModuleActions, e as ModuleQueries, M as ModuleStates, O as OutputOf, P as PaginationMeta, n as RefreshTokenConfig, k as TokenManager, T as Tokens, U as UseApiConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, p as UseApiState, V as ValidationError, t } from './apiModule.types-hGWAkTwf.js';
+export { c as UseApiRecordActions, U as UseApiRecordConfig, a as UseApiRecordReturn, b as UseApiRecordState } from './useApiRecord.types-BJop2XPB.js';
 import 'react';
 
 declare function createApiClient(config: ApiClientConfig): AxiosInstance;

package/dist/server.d.cts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from 'axios';
-import { f as ActionConfigModule, A as ApiModuleConfig, I as InputOf } from './apiModule.types-DEskFzOY.cjs';
+import { A as ActionConfigModule, a as ApiModuleConfig, I as InputOf } from './apiModule.types-hGWAkTwf.cjs';
 import 'react';
 
 /**

package/dist/server.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance } from 'axios';
-import { f as ActionConfigModule, A as ApiModuleConfig, I as InputOf } from './apiModule.types-DEskFzOY.js';
+import { A as ActionConfigModule, a as ApiModuleConfig, I as InputOf } from './apiModule.types-hGWAkTwf.js';
 import 'react';
 
 /**

package/dist/{useApiRecord.types-C31nzgeP.d.ts → useApiRecord.types-BJop2XPB.d.ts}

@@ -1,5 +1,5 @@
 import { Dispatch, SetStateAction } from 'react';
-import { R as RequestConfig, j as ApiError, S as StandardResponse, g as ActionOptions } from './apiModule.types-DEskFzOY.js';
+import { R as RequestConfig, j as ApiError, S as StandardResponse, g as ActionOptions } from './apiModule.types-hGWAkTwf.js';
 
 /**
  * Represents the internal state of the `useApiRecord` hook.

package/dist/{useApiRecord.types-mpeiDoxm.d.cts → useApiRecord.types-V-4fiB7L.d.cts}

@@ -1,5 +1,5 @@
 import { Dispatch, SetStateAction } from 'react';
-import { R as RequestConfig, j as ApiError, S as StandardResponse, g as ActionOptions } from './apiModule.types-DEskFzOY.cjs';
+import { R as RequestConfig, j as ApiError, S as StandardResponse, g as ActionOptions } from './apiModule.types-hGWAkTwf.cjs';
 
 /**
  * Represents the internal state of the `useApiRecord` hook.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-core-lib",
-  "version": "16.12.134",
+  "version": "16.12.136",
   "description": "A flexible and powerful API client library for modern web applications.",
   "type": "module",
   "exports": {