api-core-lib 12.0.88 → 12.0.91

package/dist/{apiModule.types-Bn0tJF7b.d.cts → apiModule.types-CZX-M2Ub.d.cts}

@@ -1,5 +1,5 @@
 import { AxiosRequestConfig, AxiosProgressEvent, InternalAxiosRequestConfig, AxiosResponse } from 'axios';
-import React__default from 'react';
+import react__default from 'react';
 
 /**
  * يمثل معلومات الترقيم (Pagination) التي قد تعود من ה-API.
@@ -156,7 +156,7 @@ interface UseApiQuery {
     /** The current query options state. */
     options: QueryOptions;
     /** A function to set the entire query options object at once. */
-    setOptions: React__default.Dispatch<React__default.SetStateAction<QueryOptions>>;
+    setOptions: react__default.Dispatch<react__default.SetStateAction<QueryOptions>>;
     /** Sets the current page number. */
     setPage: (page: number) => void;
     /** Sets the number of items per page and resets to the first page. */
@@ -287,4 +287,4 @@ type ActionMethods<TAction extends ActionConfigModule<any, any>> = {
     }) => void;
 };
 
-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, UseApiQuery as e, ApiClientConfig as f, ActionOptions as g, ActionStateModule as h, ApiError as i, TokenManager as j, MiddlewareContext as k, Middleware as l, RefreshTokenConfig as m, ActionConfig as n, UseApiState as o, ActionState as p, ExecuteOptions as q, ActionsWithQuery as r, ActionMethods as s, t };
+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, UseApiQuery as e, ActionsWithQuery as f, ApiClientConfig as g, ActionOptions as h, ActionStateModule 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, ActionMethods as s, t };

package/dist/{apiModule.types-Bn0tJF7b.d.ts → apiModule.types-CZX-M2Ub.d.ts}

@@ -1,5 +1,5 @@
 import { AxiosRequestConfig, AxiosProgressEvent, InternalAxiosRequestConfig, AxiosResponse } from 'axios';
-import React__default from 'react';
+import react__default from 'react';
 
 /**
  * يمثل معلومات الترقيم (Pagination) التي قد تعود من ה-API.
@@ -156,7 +156,7 @@ interface UseApiQuery {
     /** The current query options state. */
     options: QueryOptions;
     /** A function to set the entire query options object at once. */
-    setOptions: React__default.Dispatch<React__default.SetStateAction<QueryOptions>>;
+    setOptions: react__default.Dispatch<react__default.SetStateAction<QueryOptions>>;
     /** Sets the current page number. */
     setPage: (page: number) => void;
     /** Sets the number of items per page and resets to the first page. */
@@ -287,4 +287,4 @@ type ActionMethods<TAction extends ActionConfigModule<any, any>> = {
     }) => void;
 };
 
-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, UseApiQuery as e, ApiClientConfig as f, ActionOptions as g, ActionStateModule as h, ApiError as i, TokenManager as j, MiddlewareContext as k, Middleware as l, RefreshTokenConfig as m, ActionConfig as n, UseApiState as o, ActionState as p, ExecuteOptions as q, ActionsWithQuery as r, ActionMethods as s, t };
+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, UseApiQuery as e, ActionsWithQuery as f, ApiClientConfig as g, ActionOptions as h, ActionStateModule 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, ActionMethods as s, t };

package/dist/cli.cjs

@@ -328,7 +328,7 @@ async function generateModuleFiles(module2, allSchemas, allEnums, outputDir) {
   const createdFileExports = ["config"];
   let configContent = `// This file is auto-generated. Do not edit directly.
 
-import type { ApiModuleConfig, ActionConfigModule } from 'api-core-lib';
+import type { ApiModuleConfig, ActionConfigModule, QueryOptions } from 'api-core-lib';
 `;
   if (schemasToImport.length > 0) configContent += `import type { ${schemasToImport.join(", ")} } from './types';
 `;
@@ -447,15 +447,13 @@ import type { ${schemasToImport.join(", ")} } from './types';
   }
   const indexFilePath = import_path.default.join(moduleOutputPath, "index.ts");
   const initialIndexContent = `// This file is auto-generated. Do not edit directly.
+// This file is the main entry point for client-side code.
 
 ` + createdFileExports.map((e) => `export * from './${e}';`).join("\n");
   import_fs.default.writeFileSync(indexFilePath, initialIndexContent);
-  console.log(import_chalk.default.gray(`    \u2713 index.ts (Initial)`));
+  console.log(import_chalk.default.gray(`    \u2713 index.ts (Initial Client Entry Point)`));
   const moduleBaseName = module2.moduleName.replace(/Api$/, "");
   const camelCaseModuleName = toCamelCase(moduleBaseName);
-  const allPathParams = /* @__PURE__ */ new Set();
-  Object.values(module2.actions).forEach((action) => action.pathParams.forEach((param) => allPathParams.add(param)));
-  const pathParamsType = allPathParams.size > 0 ? `{ ${[...allPathParams].map((p) => `${p}?: string | number`).join("; ")} }` : "Record<string, never>";
   let endpointsContent = `// This file is auto-generated. Do not edit directly.
 
 `;
@@ -463,7 +461,7 @@ import type { ${schemasToImport.join(", ")} } from './types';
 `;
   const endpointTypesToImport = /* @__PURE__ */ new Set();
   Object.values(module2.actions).forEach((action) => {
-    if (action.inputType !== "undefined" && action.inputType !== "QueryOptions") {
+    if (action.inputType !== "undefined" && action.inputType !== "QueryOptions" && !BUILT_IN_TYPES.has(action.inputType)) {
       endpointTypesToImport.add(action.inputType);
     }
   });
@@ -498,7 +496,7 @@ import type { ${schemasToImport.join(", ")} } from './types';
 `;
     if (action.inputType !== "undefined" && action.inputType !== "QueryOptions") endpointsContent += `    input: body,
 `;
-    if (action.hasQuery) endpointsContent += `    input: query,
+    else if (action.hasQuery) endpointsContent += `    input: query,
 `;
     endpointsContent += `  }),
 
@@ -506,38 +504,24 @@ import type { ${schemasToImport.join(", ")} } from './types';
   }
   endpointsContent += `};
 `;
-  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, `${camelCaseModuleName}.endpoints.ts`), endpointsContent);
+  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, `${camelCaseModuleName}.endpoints.ts`), endpointsContent.trim());
   console.log(import_chalk.default.gray(`    \u2713 ${camelCaseModuleName}.endpoints.ts (Type-Safe Endpoints)`));
-  const hookContent = `// This file is auto-generated. Do not edit directly.
+  const contextFileContent = `// This file is auto-generated. Do not edit directly.
+'use client';
 
-import { useApiModule, UseApiModuleOptions } from 'api-core-lib/client';
+import React from 'react';
+import { createApiModuleContext, useApiModule, UseApiModuleOptions } from 'api-core-lib/client';
 import { apiClient } from '@/lib/api-core/clientApi'; // Assuming a fixed path
-import { ${module2.moduleName} as TModuleType } from './config';
-import { ${module2.moduleName} } from './config';
+import { ${module2.moduleName}, ${module2.moduleName} as TModuleType } from './config';
 
-type ModulePathParams = ${pathParamsType};
+const { 
+  Provider, 
+  useContext: use${moduleBaseName}Context 
+} = createApiModuleContext<typeof TModuleType['actions']>();
 
-type ${moduleBaseName}ApiOptions = Omit<UseApiModuleOptions, 'pathParams'> & {
-  pathParams?: ModulePathParams;
-};
+export { use${moduleBaseName}Context };
 
-/**
- * Custom hook for interacting with the ${moduleBaseName} API module.
- */
-export const use${moduleBaseName}Api = (options: ${moduleBaseName}ApiOptions = {}) => {
-  return useApiModule<typeof TModuleType['actions']>(apiClient, ${module2.moduleName}, options);
-};
-`;
-  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, `use${moduleBaseName}.ts`), hookContent);
-  console.log(import_chalk.default.gray(`    \u2713 use${moduleBaseName}.ts (Custom Hook)`));
-  const providerContent = `// This file is auto-generated. Do not edit directly.
-'use client';
-
-import React from 'react';
-import { ApiModuleProvider } from 'api-core-lib/client';
-import { use${moduleBaseName}Api } from './use${moduleBaseName}';
-
-type Options = Parameters<typeof use${moduleBaseName}Api>[0];
+type Options = Parameters<typeof useApiModule>[2];
 
 interface ${moduleBaseName}ProviderProps {
   children: React.ReactNode;
@@ -548,14 +532,14 @@ interface ${moduleBaseName}ProviderProps {
  * A dedicated React Provider that initializes and provides the ${moduleBaseName} API context.
  */
 export function ${moduleBaseName}Provider({ children, options = {} }: ${moduleBaseName}ProviderProps) {
-  const api = use${moduleBaseName}Api(options);
-  return <ApiModuleProvider value={api}>{children}</ApiModuleProvider>;
+  const api = useApiModule(apiClient, ${module2.moduleName}, options);
+  return <Provider value={api}>{children}</Provider>;
 }
 `;
-  const providerFileName = `${moduleBaseName}.provider.tsx`;
-  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, providerFileName), providerContent);
-  console.log(import_chalk.default.gray(`    \u2713 ${providerFileName} (React Provider)`));
-  const serverContent = `// This file is auto-generated. For server-side use only.
+  const contextFileName = `${camelCaseModuleName}.context.tsx`;
+  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, contextFileName), contextFileContent.trim());
+  console.log(import_chalk.default.gray(`    \u2713 ${contextFileName} (Strongly-Typed Context & Provider)`));
+  const serverHelperContent = `// This file is auto-generated. For server-side use only.
 
 import { createServerApi } from 'api-core-lib/server';
 import { serverApiClient } from '@/lib/api-core/serverApi'; // Assuming a fixed path
@@ -568,18 +552,25 @@ export const create${moduleBaseName}ServerApi = () => {
   return createServerApi(serverApiClient, ${module2.moduleName});
 };
 `;
-  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, `${camelCaseModuleName}.server.ts`), serverContent);
+  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, `${camelCaseModuleName}.server.ts`), serverHelperContent.trim());
   console.log(import_chalk.default.gray(`    \u2713 ${camelCaseModuleName}.server.ts (Server-Side Helper)`));
-  const newExports = [
+  const clientExports = [
     `
-// Generated API helpers`,
+// Generated API client helpers`,
     `export * from './${camelCaseModuleName}.endpoints';`,
-    `export * from './use${moduleBaseName}';`,
-    `export * from './${moduleBaseName}.provider';`,
-    `export * from './${camelCaseModuleName}.server';`
+    `export * from './${camelCaseModuleName}.context';`
   ].join("\n");
-  import_fs.default.appendFileSync(indexFilePath, newExports);
-  console.log(import_chalk.default.gray(`    \u2713 index.ts (Updated with helpers)`));
+  import_fs.default.appendFileSync(indexFilePath, clientExports);
+  console.log(import_chalk.default.gray(`    \u2713 index.ts (Updated with client helpers)`));
+  const serverEntryPointContent = `// This file is auto-generated. For server-side use only.
+// It serves as the entry point for server-specific utilities.
+
+export * from './${camelCaseModuleName}.server';
+// Also exporting endpoints, as they are environment-agnostic and useful on the server.
+export * from './${camelCaseModuleName}.endpoints';
+`;
+  import_fs.default.writeFileSync(import_path.default.join(moduleOutputPath, "server.ts"), serverEntryPointContent);
+  console.log(import_chalk.default.gray(`    \u2713 server.ts (New Server Entry Point)`));
 }
 function _propToMock(prop) {
   if (prop.example) return prop.example;

package/dist/client.cjs

@@ -270,15 +270,19 @@ function useDeepCompareEffect(callback, dependencies) {
   _react.useEffect.call(void 0, callback, [currentDependenciesRef.current]);
 }
 
-// src/hooks/useApiModule/useApiModule.ts
+// src/hooks/useApiModule/useApiModule.v1.ts
 
 var ApiModuleContext = _react.createContext.call(void 0, null);
 var ApiModuleProvider = ApiModuleContext.Provider;
 var createInitialState = () => ({
   data: null,
   lastSuccessAt: void 0,
-  meta: [],
-  validationErrors: [],
+  meta: void 0,
+  // meta هو كائن، وليس مصفوفة
+  links: void 0,
+  // links هو كائن، وليس مصفوفة
+  validationErrors: void 0,
+  // validationErrors هو مصفوفة، ولكن يمكن أن يكون غير موجود
   error: null,
   loading: false,
   success: false,
@@ -287,34 +291,29 @@ var createInitialState = () => ({
   rawResponse: null
 });
 function useApiActionState(actionConfig, cacheKey, execute, input, enabled) {
-  const getClientSnapshot = () => _chunk25UFVV4Fcjs.globalStateManager.getSnapshot(cacheKey);
-  const getServerSnapshot = () => _chunk25UFVV4Fcjs.globalStateManager.getSnapshot(cacheKey);
+  const getClientSnapshot = _react.useCallback.call(void 0, () => _chunk25UFVV4Fcjs.globalStateManager.getSnapshot(cacheKey), [cacheKey]);
+  const getServerSnapshot = _react.useCallback.call(void 0, () => _chunk25UFVV4Fcjs.globalStateManager.getSnapshot(cacheKey), [cacheKey]);
   const state = _react.useSyncExternalStore.call(void 0, 
     (callback) => _chunk25UFVV4Fcjs.globalStateManager.subscribe(cacheKey, callback),
     getClientSnapshot,
     getServerSnapshot
   );
-  const inputRef = _react.useRef.call(void 0, input);
-  _react.useEffect.call(void 0, () => {
-    inputRef.current = input;
-  }, [input]);
   const refetch = _react.useCallback.call(void 0, () => {
-    execute(inputRef.current);
-  }, [execute]);
-  const prevCacheKeyRef = _react.useRef.call(void 0, cacheKey);
+    execute(input);
+  }, [execute, input]);
+  const prevStateRef = _react.useRef.call(void 0, );
   _react.useEffect.call(void 0, () => {
-    if (prevCacheKeyRef.current !== cacheKey && enabled && state.called) {
-      console.log(`[Cache Key Changed] from ${prevCacheKeyRef.current} to ${cacheKey}. Refetching...`);
+    const currentState = state || createInitialState();
+    const previousState = prevStateRef.current;
+    if (enabled && actionConfig.autoFetch && !currentState.called && !currentState.loading) {
       refetch();
-    } else if (enabled && actionConfig.autoFetch && !state.called && !state.loading) {
-      console.log(`[Auto Fetch] for ${cacheKey}. Fetching...`);
+    } else if (enabled && currentState.isStale && !currentState.loading) {
       refetch();
-    } else if (enabled && state.isStale && !state.loading) {
-      console.log(`[Stale State] for ${cacheKey}. Refetching...`);
+    } else if (enabled && _optionalChain([previousState, 'optionalAccess', _6 => _6.called]) && !currentState.loading && cacheKey !== _optionalChain([prevStateRef, 'access', _7 => _7.current, 'optionalAccess', _8 => _8.cacheKey])) {
       refetch();
     }
-    prevCacheKeyRef.current = cacheKey;
-  }, [cacheKey, enabled, state.isStale, state.loading, state.called, actionConfig.autoFetch, refetch]);
+    prevStateRef.current = { ...currentState, cacheKey };
+  }, [cacheKey, enabled, state, actionConfig.autoFetch, refetch]);
   return state;
 }
 function useModuleContext() {
@@ -340,15 +339,7 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
   _react.useEffect.call(void 0, () => {
     savedCallbacks.current = { onSuccess, onError };
   }, [onSuccess, onError]);
-  _react.useMemo.call(void 0, () => {
-    if (hydratedState) {
-      _chunk25UFVV4Fcjs.globalStateManager.rehydrate(hydratedState);
-    }
-  }, [hydratedState]);
   _react.useEffect.call(void 0, () => {
-    savedCallbacks.current = { onSuccess, onError };
-  }, [onSuccess, onError]);
-  _react.useMemo.call(void 0, () => {
     if (hydratedState) {
       _chunk25UFVV4Fcjs.globalStateManager.rehydrate(hydratedState);
     }
@@ -358,7 +349,7 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       const actionConfig = moduleConfig.actions[actionName];
       const shouldCache = actionConfig.cacheResponse !== false;
       const execute = async (input, options2 = {}) => {
-        const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+        const finalPathParams = { ...modulePathParams || {}, ...options2.pathParams };
         const cacheKey = shouldCache ? _chunk25UFVV4Fcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams }) : "";
         let mutationContext;
         try {
@@ -373,48 +364,41 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
             body: input,
             config: options2.config
           });
-          console.log("[API Result execute]", result);
           if (shouldCache) {
             _chunk25UFVV4Fcjs.globalStateManager.setState(cacheKey, (prev) => ({
               ...prev,
-              // احتفظ بالخصائص القديمة مثل 'called'
               loading: false,
               success: result.success,
-              // تحديث صريح
               error: result.success ? null : result.error || prev.error,
-              // تحديث صريح
-              data: result.data,
-              // تحديث صريح للبيانات
+              data: result.success ? result.data : prev.data,
+              // ✅ [تحسين] لا تمسح البيانات القديمة عند حدوث خطأ
               meta: result.meta,
-              // تحديث صريح
               links: result.links,
-              // تحديث صريح
               message: result.message,
-              validationErrors: result.validationErrors || [],
-              rawResponse: result.rawResponse
-              // isStale تم تعيينه إلى false في بداية execute، وسيظل كذلك
+              validationErrors: result.validationErrors,
+              rawResponse: result.rawResponse,
+              lastSuccessAt: result.success ? Date.now() : prev.lastSuccessAt
             }));
           }
           if (result.success) {
-            _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) => {
+            _optionalChain([savedCallbacks, 'access', _9 => _9.current, 'access', _10 => _10.onSuccess, 'optionalCall', _11 => _11(actionName, result.message || "Action successful", result.data)]);
+            _optionalChain([options2, 'access', _12 => _12.onSuccess, 'optionalCall', _13 => _13(result.data, mutationContext)]);
+            _optionalChain([actionConfig, 'access', _14 => _14.invalidates, 'optionalAccess', _15 => _15.forEach, 'call', _16 => _16((keyToInvalidate) => {
               const prefix = `${moduleConfig.baseEndpoint}/${keyToInvalidate}::`;
-              console.log(`[Invalidating] by prefix: ${prefix}`);
               _chunk25UFVV4Fcjs.globalStateManager.invalidateByPrefix(prefix);
             })]);
           } else {
-            _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)]);
+            _optionalChain([savedCallbacks, 'access', _17 => _17.current, 'access', _18 => _18.onError, 'optionalCall', _19 => _19(actionName, result.message || "Action failed", _nullishCoalesce(result.error, () => ( void 0)))]);
+            _optionalChain([options2, 'access', _20 => _20.onError, 'optionalCall', _21 => _21(result.error, mutationContext)]);
           }
           return result;
         } catch (error) {
-          const apiError = _optionalChain([error, 'access', _19 => _19.response, 'optionalAccess', _20 => _20.data]) || { status: 500, message: error.message };
+          const apiError = _optionalChain([error, 'access', _22 => _22.response, 'optionalAccess', _23 => _23.data]) || { status: 500, message: error.message };
           if (shouldCache) {
             _chunk25UFVV4Fcjs.globalStateManager.setState(cacheKey, (prev) => ({ ...prev, error: apiError, loading: false, success: false }));
           }
-          _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)]);
+          _optionalChain([savedCallbacks, 'access', _24 => _24.current, 'access', _25 => _25.onError, 'optionalCall', _26 => _26(actionName, apiError.message, apiError)]);
+          _optionalChain([options2, 'access', _27 => _27.onError, 'optionalCall', _28 => _28(apiError, mutationContext)]);
           throw error;
         } finally {
           if (options2.onSettled) {
@@ -424,7 +408,7 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       };
       const reset = (input, options2 = {}) => {
         if (shouldCache) {
-          const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+          const finalPathParams = { ...modulePathParams || {}, ...options2.pathParams };
           const cacheKey = _chunk25UFVV4Fcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
           _chunk25UFVV4Fcjs.globalStateManager.setState(cacheKey, () => createInitialState());
         }
@@ -432,11 +416,11 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       acc[actionName] = { execute, reset };
       return acc;
     }, {});
-  }, [axiosInstance, moduleConfig, pathParamsString]);
+  }, [axiosInstance, moduleConfig, modulePathParams]);
   const queries = _react.useMemo.call(void 0, () => {
     const builtQueries = {};
     for (const actionName in moduleConfig.actions) {
-      if (_optionalChain([moduleConfig, 'access', _26 => _26.actions, 'access', _27 => _27[actionName], 'optionalAccess', _28 => _28.hasQuery])) {
+      if (_optionalChain([moduleConfig, 'access', _29 => _29.actions, 'access', _30 => _30[actionName], 'optionalAccess', _31 => _31.hasQuery])) {
         const setActionQueryOptions = (updater) => {
           setQueryOptions((prev) => ({ ...prev, [actionName]: typeof updater === "function" ? updater(prev[actionName] || {}) : updater }));
         };
@@ -448,50 +432,42 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           setSearchTerm: (search) => setActionQueryOptions((p) => ({ ...p, search, page: 1 })),
           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 })),
+          setQueryParam: (key, value) => setActionQueryOptions((p) => ({ ...p, [key]: value, page: key !== "page" ? 1 : value })),
           reset: () => setActionQueryOptions({})
         };
       }
     }
     return builtQueries;
   }, [queryOptions, moduleConfig.actions]);
-  const states = {};
-  function isActionWithQuery(key, actions2) {
-    return _optionalChain([actions2, 'access', _29 => _29[key], 'optionalAccess', _30 => _30.hasQuery]) === true;
-  }
-  for (const actionName in moduleConfig.actions) {
-    if (Object.prototype.hasOwnProperty.call(moduleConfig.actions, actionName)) {
-      const actionConfig = moduleConfig.actions[actionName];
-      if (actionConfig.cacheResponse !== false) {
-        let queryOptions2;
-        if (isActionWithQuery(actionName, moduleConfig.actions)) {
-          queryOptions2 = _optionalChain([queries, 'access', _31 => _31[actionName], 'optionalAccess', _32 => _32.options]);
+  const states = _react.useMemo.call(void 0, () => {
+    const builtStates = {};
+    for (const actionName in moduleConfig.actions) {
+      if (Object.prototype.hasOwnProperty.call(moduleConfig.actions, actionName)) {
+        const actionConfig = moduleConfig.actions[actionName];
+        if (actionConfig.cacheResponse !== false) {
+          const query = _optionalChain([queries, 'access', _32 => _32[actionName], 'optionalAccess', _33 => _33.options]);
+          const input = actionConfig.hasQuery ? query : void 0;
+          const cacheKey = _chunk25UFVV4Fcjs.generateCacheKey.call(void 0, moduleConfig.baseEndpoint, actionName, input, { pathParams: modulePathParams });
+          builtStates[actionName] = useApiActionState(
+            actionConfig,
+            cacheKey,
+            actions[actionName].execute,
+            input,
+            enabled
+          );
+        } else {
+          builtStates[actionName] = createInitialState();
         }
-        const input = queryOptions2;
-        const pathParams = JSON.parse(pathParamsString);
-        const cacheKey = _chunk25UFVV4Fcjs.generateCacheKey.call(void 0, 
-          moduleConfig.baseEndpoint,
-          actionName,
-          input,
-          { pathParams }
-        );
-        states[actionName] = useApiActionState(
-          actionConfig,
-          cacheKey,
-          actions[actionName].execute,
-          input,
-          enabled
-        );
-      } else {
-        states[actionName] = createInitialState();
       }
     }
-  }
+    return builtStates;
+  }, [moduleConfig, queries, actions, modulePathParams, enabled]);
   const lastBlurTimestamp = _react.useRef.call(void 0, Date.now());
   _react.useEffect.call(void 0, () => {
     if (!enabled || !refetchOnWindowFocus) return;
     const onFocus = () => {
-      if (Date.now() - lastBlurTimestamp.current > 1e4) {
+      if (Date.now() - lastBlurTimestamp.current > 3e4) {
+        console.log("[Refetch on Focus] Invalidating all called queries for this module.");
         const actionKeys = Object.keys(moduleConfig.actions);
         for (const actionName of actionKeys) {
           const state = states[actionName];
@@ -512,15 +488,37 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       window.removeEventListener("blur", onBlur);
     };
   }, [enabled, refetchOnWindowFocus, moduleConfig, states]);
-  const dehydrate = _react.useMemo.call(void 0, () => {
-    return () => _chunk25UFVV4Fcjs.globalStateManager.dehydrate();
+  const dehydrate = _react.useCallback.call(void 0, () => {
+    return _chunk25UFVV4Fcjs.globalStateManager.dehydrate();
   }, []);
-  const baseApiReturn = { actions, states, queries, dehydrate };
-  const finalApiReturn = _react.useMemo.call(void 0, () => ({
-    ...baseApiReturn,
+  return _react.useMemo.call(void 0, () => ({
+    actions,
+    states,
+    queries,
+    dehydrate,
     ...extraContextData || {}
-  }), [baseApiReturn, extraContextData]);
-  return finalApiReturn;
+  }), [actions, states, queries, dehydrate, extraContextData]);
+}
+
+// src/hooks/useApiModule/apiModuleContext.ts
+
+function createApiModuleContext() {
+  const Context = _react.createContext.call(void 0, null);
+  const Provider = ({ value, children }) => {
+    return _react.createElement.call(void 0, Context.Provider, { value }, children);
+  };
+  const useConsumer = () => {
+    const context = _react.useContext.call(void 0, Context);
+    if (!context) {
+      throw new Error("This component must be used within its corresponding ApiModuleProvider.");
+    }
+    return context;
+  };
+  return {
+    Context,
+    Provider,
+    useContext: useConsumer
+  };
 }
 
 
@@ -529,4 +527,5 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
 
 
 
-exports.ApiModuleProvider = ApiModuleProvider; exports.useApi = useApi; exports.useApiModule = useApiModule; exports.useApiRecord = useApiRecord; exports.useDeepCompareEffect = useDeepCompareEffect; exports.useModuleContext = useModuleContext;
+
+exports.ApiModuleProvider = ApiModuleProvider; exports.createApiModuleContext = createApiModuleContext; exports.useApi = useApi; exports.useApiModule = useApiModule; exports.useApiRecord = useApiRecord; exports.useDeepCompareEffect = useDeepCompareEffect; exports.useModuleContext = useModuleContext;

package/dist/client.d.cts

@@ -1,7 +1,8 @@
 import { AxiosInstance } from 'axios';
-import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, M as ModuleStates, d as ModuleActions, e as UseApiQuery } from './apiModule.types-Bn0tJF7b.cjs';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-NZtPRga3.cjs';
-import * as React from 'react';
+import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, M as ModuleStates, d as ModuleActions, e as UseApiQuery, f as ActionsWithQuery } from './apiModule.types-CZX-M2Ub.cjs';
+import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-Cq9AlZX2.cjs';
+import * as react from 'react';
+import { ReactNode } from 'react';
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): any;
 
@@ -21,7 +22,7 @@ type EffectCallback = () => (void | (() => void));
 type DependencyList = readonly any[];
 declare function useDeepCompareEffect(callback: EffectCallback, dependencies: DependencyList): void;
 
-declare const ApiModuleProvider: React.Provider<{
+declare const ApiModuleProvider: react.Provider<{
     states: ModuleStates<any>;
     actions: ModuleActions<any>;
     queries: {
@@ -32,4 +33,30 @@ declare const ApiModuleProvider: React.Provider<{
 declare function useModuleContext<TModule extends ApiModuleConfig<any>, 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>;
 
-export { ApiModuleProvider, useApi, useApiModule, useApiRecord, useDeepCompareEffect, useModuleContext };
+/**
+ * Creates a strongly-typed React Context, Provider, and consumer hook for a specific API module.
+ * This pattern avoids the need for manual type assertions in consuming components.
+ *
+ * @template TActions - The shape of the actions in the API module.
+ * @returns An object containing the typed Context, Provider, and a `useContext` hook.
+ */
+declare function createApiModuleContext<TActions extends Record<string, any>>(): {
+    Context: react.Context<{
+        states: ModuleStates<TActions>;
+        actions: ModuleActions<TActions>;
+        queries: { [K in ActionsWithQuery<TActions>]: UseApiQuery; };
+        dehydrate: () => string;
+    } | null>;
+    Provider: ({ value, children }: {
+        value: UseApiModuleReturn<TActions>;
+        children: ReactNode;
+    }) => react.FunctionComponentElement<react.ProviderProps<{
+        states: ModuleStates<TActions>;
+        actions: ModuleActions<TActions>;
+        queries: { [K in ActionsWithQuery<TActions>]: UseApiQuery; };
+        dehydrate: () => string;
+    } | null>>;
+    useContext: () => UseApiModuleReturn<TActions>;
+};
+
+export { ApiModuleProvider, createApiModuleContext, useApi, useApiModule, useApiRecord, useDeepCompareEffect, useModuleContext };

package/dist/client.d.ts

@@ -1,7 +1,8 @@
 import { AxiosInstance } from 'axios';
-import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, M as ModuleStates, d as ModuleActions, e as UseApiQuery } from './apiModule.types-Bn0tJF7b.js';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-CWhwCAB6.js';
-import * as React from 'react';
+import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn, M as ModuleStates, d as ModuleActions, e as UseApiQuery, f as ActionsWithQuery } from './apiModule.types-CZX-M2Ub.js';
+import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-Cye9a7zh.js';
+import * as react from 'react';
+import { ReactNode } from 'react';
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): any;
 
@@ -21,7 +22,7 @@ type EffectCallback = () => (void | (() => void));
 type DependencyList = readonly any[];
 declare function useDeepCompareEffect(callback: EffectCallback, dependencies: DependencyList): void;
 
-declare const ApiModuleProvider: React.Provider<{
+declare const ApiModuleProvider: react.Provider<{
     states: ModuleStates<any>;
     actions: ModuleActions<any>;
     queries: {
@@ -32,4 +33,30 @@ declare const ApiModuleProvider: React.Provider<{
 declare function useModuleContext<TModule extends ApiModuleConfig<any>, 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>;
 
-export { ApiModuleProvider, useApi, useApiModule, useApiRecord, useDeepCompareEffect, useModuleContext };
+/**
+ * Creates a strongly-typed React Context, Provider, and consumer hook for a specific API module.
+ * This pattern avoids the need for manual type assertions in consuming components.
+ *
+ * @template TActions - The shape of the actions in the API module.
+ * @returns An object containing the typed Context, Provider, and a `useContext` hook.
+ */
+declare function createApiModuleContext<TActions extends Record<string, any>>(): {
+    Context: react.Context<{
+        states: ModuleStates<TActions>;
+        actions: ModuleActions<TActions>;
+        queries: { [K in ActionsWithQuery<TActions>]: UseApiQuery; };
+        dehydrate: () => string;
+    } | null>;
+    Provider: ({ value, children }: {
+        value: UseApiModuleReturn<TActions>;
+        children: ReactNode;
+    }) => react.FunctionComponentElement<react.ProviderProps<{
+        states: ModuleStates<TActions>;
+        actions: ModuleActions<TActions>;
+        queries: { [K in ActionsWithQuery<TActions>]: UseApiQuery; };
+        dehydrate: () => string;
+    } | null>>;
+    useContext: () => UseApiModuleReturn<TActions>;
+};
+
+export { ApiModuleProvider, createApiModuleContext, useApi, useApiModule, useApiRecord, useDeepCompareEffect, useModuleContext };

package/dist/client.js

@@ -270,15 +270,19 @@ function useDeepCompareEffect(callback, dependencies) {
   useEffect3(callback, [currentDependenciesRef.current]);
 }
 
-// src/hooks/useApiModule/useApiModule.ts
+// src/hooks/useApiModule/useApiModule.v1.ts
 import { createContext, useCallback as useCallback3, useContext, useEffect as useEffect4, useMemo as useMemo3, useRef as useRef4, useState as useState3, useSyncExternalStore } from "react";
 var ApiModuleContext = createContext(null);
 var ApiModuleProvider = ApiModuleContext.Provider;
 var createInitialState = () => ({
   data: null,
   lastSuccessAt: void 0,
-  meta: [],
-  validationErrors: [],
+  meta: void 0,
+  // meta هو كائن، وليس مصفوفة
+  links: void 0,
+  // links هو كائن، وليس مصفوفة
+  validationErrors: void 0,
+  // validationErrors هو مصفوفة، ولكن يمكن أن يكون غير موجود
   error: null,
   loading: false,
   success: false,
@@ -287,34 +291,29 @@ var createInitialState = () => ({
   rawResponse: null
 });
 function useApiActionState(actionConfig, cacheKey, execute, input, enabled) {
-  const getClientSnapshot = () => globalStateManager.getSnapshot(cacheKey);
-  const getServerSnapshot = () => globalStateManager.getSnapshot(cacheKey);
+  const getClientSnapshot = useCallback3(() => globalStateManager.getSnapshot(cacheKey), [cacheKey]);
+  const getServerSnapshot = useCallback3(() => globalStateManager.getSnapshot(cacheKey), [cacheKey]);
   const state = useSyncExternalStore(
     (callback) => globalStateManager.subscribe(cacheKey, callback),
     getClientSnapshot,
     getServerSnapshot
   );
-  const inputRef = useRef4(input);
-  useEffect4(() => {
-    inputRef.current = input;
-  }, [input]);
   const refetch = useCallback3(() => {
-    execute(inputRef.current);
-  }, [execute]);
-  const prevCacheKeyRef = useRef4(cacheKey);
+    execute(input);
+  }, [execute, input]);
+  const prevStateRef = useRef4();
   useEffect4(() => {
-    if (prevCacheKeyRef.current !== cacheKey && enabled && state.called) {
-      console.log(`[Cache Key Changed] from ${prevCacheKeyRef.current} to ${cacheKey}. Refetching...`);
+    const currentState = state || createInitialState();
+    const previousState = prevStateRef.current;
+    if (enabled && actionConfig.autoFetch && !currentState.called && !currentState.loading) {
       refetch();
-    } else if (enabled && actionConfig.autoFetch && !state.called && !state.loading) {
-      console.log(`[Auto Fetch] for ${cacheKey}. Fetching...`);
+    } else if (enabled && currentState.isStale && !currentState.loading) {
       refetch();
-    } else if (enabled && state.isStale && !state.loading) {
-      console.log(`[Stale State] for ${cacheKey}. Refetching...`);
+    } else if (enabled && previousState?.called && !currentState.loading && cacheKey !== prevStateRef.current?.cacheKey) {
       refetch();
     }
-    prevCacheKeyRef.current = cacheKey;
-  }, [cacheKey, enabled, state.isStale, state.loading, state.called, actionConfig.autoFetch, refetch]);
+    prevStateRef.current = { ...currentState, cacheKey };
+  }, [cacheKey, enabled, state, actionConfig.autoFetch, refetch]);
   return state;
 }
 function useModuleContext() {
@@ -340,15 +339,7 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
   useEffect4(() => {
     savedCallbacks.current = { onSuccess, onError };
   }, [onSuccess, onError]);
-  useMemo3(() => {
-    if (hydratedState) {
-      globalStateManager.rehydrate(hydratedState);
-    }
-  }, [hydratedState]);
   useEffect4(() => {
-    savedCallbacks.current = { onSuccess, onError };
-  }, [onSuccess, onError]);
-  useMemo3(() => {
     if (hydratedState) {
       globalStateManager.rehydrate(hydratedState);
     }
@@ -358,7 +349,7 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       const actionConfig = moduleConfig.actions[actionName];
       const shouldCache = actionConfig.cacheResponse !== false;
       const execute = async (input, options2 = {}) => {
-        const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+        const finalPathParams = { ...modulePathParams || {}, ...options2.pathParams };
         const cacheKey = shouldCache ? generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams }) : "";
         let mutationContext;
         try {
@@ -373,26 +364,20 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
             body: input,
             config: options2.config
           });
-          console.log("[API Result execute]", result);
           if (shouldCache) {
             globalStateManager.setState(cacheKey, (prev) => ({
               ...prev,
-              // احتفظ بالخصائص القديمة مثل 'called'
               loading: false,
               success: result.success,
-              // تحديث صريح
               error: result.success ? null : result.error || prev.error,
-              // تحديث صريح
-              data: result.data,
-              // تحديث صريح للبيانات
+              data: result.success ? result.data : prev.data,
+              // ✅ [تحسين] لا تمسح البيانات القديمة عند حدوث خطأ
               meta: result.meta,
-              // تحديث صريح
               links: result.links,
-              // تحديث صريح
               message: result.message,
-              validationErrors: result.validationErrors || [],
-              rawResponse: result.rawResponse
-              // isStale تم تعيينه إلى false في بداية execute، وسيظل كذلك
+              validationErrors: result.validationErrors,
+              rawResponse: result.rawResponse,
+              lastSuccessAt: result.success ? Date.now() : prev.lastSuccessAt
             }));
           }
           if (result.success) {
@@ -400,7 +385,6 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
             options2.onSuccess?.(result.data, mutationContext);
             actionConfig.invalidates?.forEach((keyToInvalidate) => {
               const prefix = `${moduleConfig.baseEndpoint}/${keyToInvalidate}::`;
-              console.log(`[Invalidating] by prefix: ${prefix}`);
               globalStateManager.invalidateByPrefix(prefix);
             });
           } else {
@@ -424,7 +408,7 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       };
       const reset = (input, options2 = {}) => {
         if (shouldCache) {
-          const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+          const finalPathParams = { ...modulePathParams || {}, ...options2.pathParams };
           const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
           globalStateManager.setState(cacheKey, () => createInitialState());
         }
@@ -432,7 +416,7 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       acc[actionName] = { execute, reset };
       return acc;
     }, {});
-  }, [axiosInstance, moduleConfig, pathParamsString]);
+  }, [axiosInstance, moduleConfig, modulePathParams]);
   const queries = useMemo3(() => {
     const builtQueries = {};
     for (const actionName in moduleConfig.actions) {
@@ -448,50 +432,42 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           setSearchTerm: (search) => setActionQueryOptions((p) => ({ ...p, search, page: 1 })),
           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 })),
+          setQueryParam: (key, value) => setActionQueryOptions((p) => ({ ...p, [key]: value, page: key !== "page" ? 1 : value })),
           reset: () => setActionQueryOptions({})
         };
       }
     }
     return builtQueries;
   }, [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 actionConfig = moduleConfig.actions[actionName];
-      if (actionConfig.cacheResponse !== false) {
-        let queryOptions2;
-        if (isActionWithQuery(actionName, moduleConfig.actions)) {
-          queryOptions2 = queries[actionName]?.options;
+  const states = useMemo3(() => {
+    const builtStates = {};
+    for (const actionName in moduleConfig.actions) {
+      if (Object.prototype.hasOwnProperty.call(moduleConfig.actions, actionName)) {
+        const actionConfig = moduleConfig.actions[actionName];
+        if (actionConfig.cacheResponse !== false) {
+          const query = queries[actionName]?.options;
+          const input = actionConfig.hasQuery ? query : void 0;
+          const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: modulePathParams });
+          builtStates[actionName] = useApiActionState(
+            actionConfig,
+            cacheKey,
+            actions[actionName].execute,
+            input,
+            enabled
+          );
+        } else {
+          builtStates[actionName] = createInitialState();
         }
-        const input = queryOptions2;
-        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();
       }
     }
-  }
+    return builtStates;
+  }, [moduleConfig, queries, actions, modulePathParams, enabled]);
   const lastBlurTimestamp = useRef4(Date.now());
   useEffect4(() => {
     if (!enabled || !refetchOnWindowFocus) return;
     const onFocus = () => {
-      if (Date.now() - lastBlurTimestamp.current > 1e4) {
+      if (Date.now() - lastBlurTimestamp.current > 3e4) {
+        console.log("[Refetch on Focus] Invalidating all called queries for this module.");
         const actionKeys = Object.keys(moduleConfig.actions);
         for (const actionName of actionKeys) {
           const state = states[actionName];
@@ -512,18 +488,41 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       window.removeEventListener("blur", onBlur);
     };
   }, [enabled, refetchOnWindowFocus, moduleConfig, states]);
-  const dehydrate = useMemo3(() => {
-    return () => globalStateManager.dehydrate();
+  const dehydrate = useCallback3(() => {
+    return globalStateManager.dehydrate();
   }, []);
-  const baseApiReturn = { actions, states, queries, dehydrate };
-  const finalApiReturn = useMemo3(() => ({
-    ...baseApiReturn,
+  return useMemo3(() => ({
+    actions,
+    states,
+    queries,
+    dehydrate,
     ...extraContextData || {}
-  }), [baseApiReturn, extraContextData]);
-  return finalApiReturn;
+  }), [actions, states, queries, dehydrate, extraContextData]);
+}
+
+// src/hooks/useApiModule/apiModuleContext.ts
+import { createContext as createContext2, useContext as useContext2, createElement } from "react";
+function createApiModuleContext() {
+  const Context = createContext2(null);
+  const Provider = ({ value, children }) => {
+    return createElement(Context.Provider, { value }, children);
+  };
+  const useConsumer = () => {
+    const context = useContext2(Context);
+    if (!context) {
+      throw new Error("This component must be used within its corresponding ApiModuleProvider.");
+    }
+    return context;
+  };
+  return {
+    Context,
+    Provider,
+    useContext: useConsumer
+  };
 }
 export {
   ApiModuleProvider,
+  createApiModuleContext,
   useApi,
   useApiModule,
   useApiRecord,

package/dist/index.d.cts

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

package/dist/server.d.cts

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

package/dist/server.d.ts

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

package/dist/{useApiRecord.types-NZtPRga3.d.cts → useApiRecord.types-Cq9AlZX2.d.cts}

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

package/dist/{useApiRecord.types-CWhwCAB6.d.ts → useApiRecord.types-Cye9a7zh.d.ts}

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

package/package.json

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