api-core-lib 12.0.15 → 12.0.17

package/dist/{apiModule.types-BTtRM9wO.d.cts → apiModule.types-D0LSWRW8.d.cts}

@@ -187,6 +187,10 @@ interface UseApiConfig<T> {
     onSuccess?: (message: string, data?: T) => void;
     onError?: (message: string, error?: ApiError) => void;
 }
+interface t {
+    type: string;
+    payload?: any;
+}
 
 /** @description Extends the base ActionState with an `isStale` flag for automatic refetching. */
 interface ActionState<TOutput> extends ActionStateModule<TOutput> {
@@ -199,11 +203,16 @@ interface ActionConfigModule<TInput = unknown, TOutput = unknown> {
     description?: string;
     hasQuery?: boolean;
     autoFetch?: boolean;
+    cacheResponse?: boolean;
     invalidates?: string[];
     _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;
@@ -254,5 +263,22 @@ interface UseApiModuleReturn<TActions extends Record<string, ActionConfigModule<
     };
     dehydrate: () => string;
 }
+/**
+ * يصف دوال `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 { ActionConfigModule as A, ExecutableAction as E, InputOf as I, LogLevel as L, MiddlewareContext 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, ApiClientConfig as d, ActionOptions as e, ActionStateModule as f, UseApiQuery as g, ApiError as h, TokenManager as i, Middleware as j, RefreshTokenConfig as k, ActionConfig as l, UseApiState as m, ActionState as n, ExecuteOptions as o, ModuleActions as p, ModuleStates as q };
+export type { ActionConfigModule as A, ExecutableAction as E, InputOf as I, LogLevel as L, MiddlewareContext 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, ApiClientConfig as d, ActionOptions as e, ActionStateModule as f, UseApiQuery as g, ApiError as h, TokenManager as i, Middleware as j, RefreshTokenConfig as k, ActionConfig as l, UseApiState as m, ActionState as n, ExecuteOptions as o, ModuleActions as p, ModuleStates as q, ActionMethods as r, t };

package/dist/{apiModule.types-BTtRM9wO.d.ts → apiModule.types-D0LSWRW8.d.ts}

@@ -187,6 +187,10 @@ interface UseApiConfig<T> {
     onSuccess?: (message: string, data?: T) => void;
     onError?: (message: string, error?: ApiError) => void;
 }
+interface t {
+    type: string;
+    payload?: any;
+}
 
 /** @description Extends the base ActionState with an `isStale` flag for automatic refetching. */
 interface ActionState<TOutput> extends ActionStateModule<TOutput> {
@@ -199,11 +203,16 @@ interface ActionConfigModule<TInput = unknown, TOutput = unknown> {
     description?: string;
     hasQuery?: boolean;
     autoFetch?: boolean;
+    cacheResponse?: boolean;
     invalidates?: string[];
     _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;
@@ -254,5 +263,22 @@ interface UseApiModuleReturn<TActions extends Record<string, ActionConfigModule<
     };
     dehydrate: () => string;
 }
+/**
+ * يصف دوال `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 { ActionConfigModule as A, ExecutableAction as E, InputOf as I, LogLevel as L, MiddlewareContext 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, ApiClientConfig as d, ActionOptions as e, ActionStateModule as f, UseApiQuery as g, ApiError as h, TokenManager as i, Middleware as j, RefreshTokenConfig as k, ActionConfig as l, UseApiState as m, ActionState as n, ExecuteOptions as o, ModuleActions as p, ModuleStates as q };
+export type { ActionConfigModule as A, ExecutableAction as E, InputOf as I, LogLevel as L, MiddlewareContext 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, ApiClientConfig as d, ActionOptions as e, ActionStateModule as f, UseApiQuery as g, ApiError as h, TokenManager as i, Middleware as j, RefreshTokenConfig as k, ActionConfig as l, UseApiState as m, ActionState as n, ExecuteOptions as o, ModuleActions as p, ModuleStates as q, ActionMethods as r, t };

package/dist/client.cjs

@@ -590,7 +590,6 @@ var GlobalStateManager = class {
     if (!this.store.has(key)) {
       const initialState = createInitialState();
       this.store.set(key, { state: initialState, listeners: /* @__PURE__ */ new Set() });
-      return initialState;
     }
     return this.store.get(key).state;
   }
@@ -612,14 +611,14 @@ var GlobalStateManager = class {
    * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
    */
   setState(key, updater) {
-    const currentState = this.getSnapshot(key);
+    const item = this.store.get(key);
+    const currentState = item.state;
     const newState = updater(currentState);
-    if (!this.store.has(key)) {
-      this.store.set(key, { state: newState, listeners: /* @__PURE__ */ new Set() });
-    } else {
-      this.store.get(key).state = newState;
+    if (Object.is(currentState, newState)) {
+      return;
     }
-    this.store.get(key).listeners.forEach((listener) => listener());
+    item.state = newState;
+    item.listeners.forEach((listener) => listener());
   }
   /**
    * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).
@@ -691,24 +690,40 @@ var generateCacheKey = (moduleName, actionName, input, callOptions = {}) => {
 // src/hooks/useApiModule/useApiModule.ts
 var ApiModuleContext = (0, import_react4.createContext)(null);
 var ApiModuleProvider = ApiModuleContext.Provider;
-function useApiActionState(actionConfig, cacheKey, actionExecutor, enabled) {
+var createInitialState2 = () => ({
+  data: null,
+  lastSuccessAt: void 0,
+  meta: [],
+  validationErrors: [],
+  error: null,
+  loading: false,
+  success: false,
+  called: false,
+  isStale: false,
+  rawResponse: null
+});
+function useApiActionState(actionConfig, cacheKey, execute, input, enabled) {
   const getClientSnapshot = () => globalStateManager.getSnapshot(cacheKey);
   const getServerSnapshot = () => globalStateManager.getSnapshot(cacheKey);
   const state = (0, import_react4.useSyncExternalStore)(
     (callback) => globalStateManager.subscribe(cacheKey, callback),
     getClientSnapshot,
-    // لقطة العميل
     getServerSnapshot
-    // لقطة الخادم
   );
-  const input = actionConfig.hasQuery ? state.options : void 0;
+  const refetch = (0, import_react4.useCallback)(() => {
+    execute(input);
+  }, [execute, JSON.stringify(input)]);
+  const refetchRef = (0, import_react4.useRef)(refetch);
+  (0, import_react4.useEffect)(() => {
+    refetchRef.current = refetch;
+  }, [refetch]);
   (0, import_react4.useEffect)(() => {
     if (enabled && actionConfig.autoFetch && !state.called && !state.loading) {
-      actionExecutor(input);
+      refetchRef.current();
     } else if (enabled && state.isStale && !state.loading) {
-      actionExecutor(input);
+      refetchRef.current();
     }
-  }, [enabled, state.isStale, state.loading, state.called, actionConfig.autoFetch, actionExecutor, JSON.stringify(input)]);
+  }, [enabled, state.isStale, state.loading, state.called, actionConfig.autoFetch]);
   return state;
 }
 function useModuleContext() {
@@ -731,29 +746,62 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       globalStateManager.rehydrate(hydratedState);
     }
   }, [hydratedState]);
+  (0, import_react4.useEffect)(() => {
+    savedCallbacks.current = { onSuccess, onError };
+  }, [onSuccess, onError]);
+  (0, import_react4.useMemo)(() => {
+    if (hydratedState) {
+      globalStateManager.rehydrate(hydratedState);
+    }
+  }, [hydratedState]);
   const actions = (0, import_react4.useMemo)(() => {
     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 = { ...JSON.parse(pathParamsString), ...options2.pathParams };
-        const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
+        const cacheKey = shouldCache ? generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams }) : "";
         let mutationContext;
         try {
-          if (options2.onMutate) {
+          if (options2.onMutate && shouldCache) {
             mutationContext = await options2.onMutate(input);
           }
-          globalStateManager.setState(cacheKey, (prev) => ({ ...prev, loading: true, called: true, error: null, isStale: false }));
+          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: input,
             config: options2.config
           });
-          globalStateManager.setState(cacheKey, (prev) => ({ ...prev, ...result, loading: false }));
+          console.log("[API Result]", 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,
+              // تحديث صريح للبيانات
+              meta: result.meta,
+              // تحديث صريح
+              links: result.links,
+              // تحديث صريح
+              message: result.message,
+              validationErrors: result.validationErrors || [],
+              rawResponse: result.rawResponse
+              // isStale تم تعيينه إلى false في بداية execute، وسيظل كذلك
+            }));
+          }
           if (result.success) {
             savedCallbacks.current.onSuccess?.(actionName, result.message || "Action successful", result.data);
             options2.onSuccess?.(result.data, mutationContext);
             actionConfig.invalidates?.forEach((keyToInvalidate) => {
               const prefix = `${moduleConfig.baseEndpoint}/${keyToInvalidate}::`;
+              console.log(`[Invalidating] by prefix: ${prefix}`);
               globalStateManager.invalidateByPrefix(prefix);
             });
           } else {
@@ -762,12 +810,13 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           }
           return result;
         } catch (error) {
-          const apiError = { status: 500, message: error.message };
-          const errorResult = { data: null, error: apiError, loading: false, success: false, rawResponse: error };
-          globalStateManager.setState(cacheKey, (prev) => ({ ...prev, ...errorResult, loading: false }));
+          const apiError = error.response?.data || { status: 500, message: error.message };
+          if (shouldCache) {
+            globalStateManager.setState(cacheKey, (prev) => ({ ...prev, error: apiError, loading: false, success: false }));
+          }
           savedCallbacks.current.onError?.(actionName, apiError.message, apiError);
           options2.onError?.(apiError, mutationContext);
-          return errorResult;
+          throw error;
         } finally {
           if (options2.onSettled) {
             options2.onSettled();
@@ -775,17 +824,11 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
         }
       };
       const reset = (input, options2 = {}) => {
-        const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
-        const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
-        globalStateManager.setState(cacheKey, () => ({
-          data: null,
-          error: null,
-          loading: false,
-          success: false,
-          called: false,
-          isStale: false,
-          rawResponse: null
-        }));
+        if (shouldCache) {
+          const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+          const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
+          globalStateManager.setState(cacheKey, () => createInitialState2());
+        }
       };
       acc[actionName] = { execute, reset };
       return acc;
@@ -817,31 +860,24 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
   for (const actionName in moduleConfig.actions) {
     if (Object.prototype.hasOwnProperty.call(moduleConfig.actions, actionName)) {
       const actionConfig = moduleConfig.actions[actionName];
-      const query = queries[actionName]?.options;
-      const input = actionConfig.hasQuery ? query : void 0;
-      const pathParams = JSON.parse(pathParamsString);
-      const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams });
-      states[actionName] = useApiActionState(
-        actionConfig,
-        cacheKey,
-        actions[actionName].execute,
-        enabled
-      );
-    }
-  }
-  (0, import_react4.useEffect)(() => {
-    if (!enabled) return;
-    const actionKeys = Object.keys(moduleConfig.actions);
-    for (const actionName of actionKeys) {
-      const state = states[actionName];
-      const actionConfig = moduleConfig.actions[actionName];
-      if (actionConfig.autoFetch && state && !state.called && !state.loading) {
+      if (actionConfig.cacheResponse !== false) {
         const query = queries[actionName]?.options;
         const input = actionConfig.hasQuery ? query : void 0;
-        actions[actionName].execute(input);
+        const pathParams = JSON.parse(pathParamsString);
+        const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams });
+        states[actionName] = useApiActionState(
+          actionConfig,
+          cacheKey,
+          // [تصحيح] مرر `execute` مباشرة
+          actions[actionName].execute,
+          input,
+          enabled
+        );
+      } else {
+        states[actionName] = createInitialState2();
       }
     }
-  }, [enabled, moduleConfig, actions, states, queries]);
+  }
   const lastBlurTimestamp = (0, import_react4.useRef)(Date.now());
   (0, import_react4.useEffect)(() => {
     if (!enabled || !refetchOnWindowFocus) return;

package/dist/client.d.cts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from 'axios';
-import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn } from './apiModule.types-BTtRM9wO.cjs';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-CBP3Ufvu.cjs';
+import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn } from './apiModule.types-D0LSWRW8.cjs';
+import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-DXv1-ly6.cjs';
 import * as React from 'react';
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): any;

package/dist/client.d.ts

@@ -1,6 +1,6 @@
 import { AxiosInstance } from 'axios';
-import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn } from './apiModule.types-BTtRM9wO.js';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-BsOSJZ5l.js';
+import { U as UseApiConfig, A as ActionConfigModule, a as ApiModuleConfig, b as UseApiModuleOptions, c as UseApiModuleReturn } from './apiModule.types-D0LSWRW8.js';
+import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './useApiRecord.types-C7T0gsX_.js';
 import * as React from 'react';
 
 declare function useApi<T>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): any;

package/dist/client.js

@@ -527,7 +527,7 @@ function useDeepCompareEffect(callback, dependencies) {
 }
 
 // src/hooks/useApiModule/useApiModule.ts
-import { createContext, useContext, useEffect as useEffect4, useMemo as useMemo3, useRef as useRef4, useState as useState3, useSyncExternalStore } from "react";
+import { createContext, useCallback as useCallback3, useContext, useEffect as useEffect4, useMemo as useMemo3, useRef as useRef4, useState as useState3, useSyncExternalStore } from "react";
 
 // src/core/globalStateManager.ts
 var createInitialState = () => ({
@@ -551,7 +551,6 @@ var GlobalStateManager = class {
     if (!this.store.has(key)) {
       const initialState = createInitialState();
       this.store.set(key, { state: initialState, listeners: /* @__PURE__ */ new Set() });
-      return initialState;
     }
     return this.store.get(key).state;
   }
@@ -573,14 +572,14 @@ var GlobalStateManager = class {
    * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
    */
   setState(key, updater) {
-    const currentState = this.getSnapshot(key);
+    const item = this.store.get(key);
+    const currentState = item.state;
     const newState = updater(currentState);
-    if (!this.store.has(key)) {
-      this.store.set(key, { state: newState, listeners: /* @__PURE__ */ new Set() });
-    } else {
-      this.store.get(key).state = newState;
+    if (Object.is(currentState, newState)) {
+      return;
     }
-    this.store.get(key).listeners.forEach((listener) => listener());
+    item.state = newState;
+    item.listeners.forEach((listener) => listener());
   }
   /**
    * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).
@@ -652,24 +651,40 @@ var generateCacheKey = (moduleName, actionName, input, callOptions = {}) => {
 // src/hooks/useApiModule/useApiModule.ts
 var ApiModuleContext = createContext(null);
 var ApiModuleProvider = ApiModuleContext.Provider;
-function useApiActionState(actionConfig, cacheKey, actionExecutor, enabled) {
+var createInitialState2 = () => ({
+  data: null,
+  lastSuccessAt: void 0,
+  meta: [],
+  validationErrors: [],
+  error: null,
+  loading: false,
+  success: false,
+  called: false,
+  isStale: false,
+  rawResponse: null
+});
+function useApiActionState(actionConfig, cacheKey, execute, input, enabled) {
   const getClientSnapshot = () => globalStateManager.getSnapshot(cacheKey);
   const getServerSnapshot = () => globalStateManager.getSnapshot(cacheKey);
   const state = useSyncExternalStore(
     (callback) => globalStateManager.subscribe(cacheKey, callback),
     getClientSnapshot,
-    // لقطة العميل
     getServerSnapshot
-    // لقطة الخادم
   );
-  const input = actionConfig.hasQuery ? state.options : void 0;
+  const refetch = useCallback3(() => {
+    execute(input);
+  }, [execute, JSON.stringify(input)]);
+  const refetchRef = useRef4(refetch);
+  useEffect4(() => {
+    refetchRef.current = refetch;
+  }, [refetch]);
   useEffect4(() => {
     if (enabled && actionConfig.autoFetch && !state.called && !state.loading) {
-      actionExecutor(input);
+      refetchRef.current();
     } else if (enabled && state.isStale && !state.loading) {
-      actionExecutor(input);
+      refetchRef.current();
     }
-  }, [enabled, state.isStale, state.loading, state.called, actionConfig.autoFetch, actionExecutor, JSON.stringify(input)]);
+  }, [enabled, state.isStale, state.loading, state.called, actionConfig.autoFetch]);
   return state;
 }
 function useModuleContext() {
@@ -692,29 +707,62 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
       globalStateManager.rehydrate(hydratedState);
     }
   }, [hydratedState]);
+  useEffect4(() => {
+    savedCallbacks.current = { onSuccess, onError };
+  }, [onSuccess, onError]);
+  useMemo3(() => {
+    if (hydratedState) {
+      globalStateManager.rehydrate(hydratedState);
+    }
+  }, [hydratedState]);
   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 = { ...JSON.parse(pathParamsString), ...options2.pathParams };
-        const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
+        const cacheKey = shouldCache ? generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams }) : "";
         let mutationContext;
         try {
-          if (options2.onMutate) {
+          if (options2.onMutate && shouldCache) {
             mutationContext = await options2.onMutate(input);
           }
-          globalStateManager.setState(cacheKey, (prev) => ({ ...prev, loading: true, called: true, error: null, isStale: false }));
+          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: input,
             config: options2.config
           });
-          globalStateManager.setState(cacheKey, (prev) => ({ ...prev, ...result, loading: false }));
+          console.log("[API Result]", 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,
+              // تحديث صريح للبيانات
+              meta: result.meta,
+              // تحديث صريح
+              links: result.links,
+              // تحديث صريح
+              message: result.message,
+              validationErrors: result.validationErrors || [],
+              rawResponse: result.rawResponse
+              // isStale تم تعيينه إلى false في بداية execute، وسيظل كذلك
+            }));
+          }
           if (result.success) {
             savedCallbacks.current.onSuccess?.(actionName, result.message || "Action successful", result.data);
             options2.onSuccess?.(result.data, mutationContext);
             actionConfig.invalidates?.forEach((keyToInvalidate) => {
               const prefix = `${moduleConfig.baseEndpoint}/${keyToInvalidate}::`;
+              console.log(`[Invalidating] by prefix: ${prefix}`);
               globalStateManager.invalidateByPrefix(prefix);
             });
           } else {
@@ -723,12 +771,13 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
           }
           return result;
         } catch (error) {
-          const apiError = { status: 500, message: error.message };
-          const errorResult = { data: null, error: apiError, loading: false, success: false, rawResponse: error };
-          globalStateManager.setState(cacheKey, (prev) => ({ ...prev, ...errorResult, loading: false }));
+          const apiError = error.response?.data || { status: 500, message: error.message };
+          if (shouldCache) {
+            globalStateManager.setState(cacheKey, (prev) => ({ ...prev, error: apiError, loading: false, success: false }));
+          }
           savedCallbacks.current.onError?.(actionName, apiError.message, apiError);
           options2.onError?.(apiError, mutationContext);
-          return errorResult;
+          throw error;
         } finally {
           if (options2.onSettled) {
             options2.onSettled();
@@ -736,17 +785,11 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
         }
       };
       const reset = (input, options2 = {}) => {
-        const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
-        const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
-        globalStateManager.setState(cacheKey, () => ({
-          data: null,
-          error: null,
-          loading: false,
-          success: false,
-          called: false,
-          isStale: false,
-          rawResponse: null
-        }));
+        if (shouldCache) {
+          const finalPathParams = { ...JSON.parse(pathParamsString), ...options2.pathParams };
+          const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams: finalPathParams });
+          globalStateManager.setState(cacheKey, () => createInitialState2());
+        }
       };
       acc[actionName] = { execute, reset };
       return acc;
@@ -778,31 +821,24 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
   for (const actionName in moduleConfig.actions) {
     if (Object.prototype.hasOwnProperty.call(moduleConfig.actions, actionName)) {
       const actionConfig = moduleConfig.actions[actionName];
-      const query = queries[actionName]?.options;
-      const input = actionConfig.hasQuery ? query : void 0;
-      const pathParams = JSON.parse(pathParamsString);
-      const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams });
-      states[actionName] = useApiActionState(
-        actionConfig,
-        cacheKey,
-        actions[actionName].execute,
-        enabled
-      );
-    }
-  }
-  useEffect4(() => {
-    if (!enabled) return;
-    const actionKeys = Object.keys(moduleConfig.actions);
-    for (const actionName of actionKeys) {
-      const state = states[actionName];
-      const actionConfig = moduleConfig.actions[actionName];
-      if (actionConfig.autoFetch && state && !state.called && !state.loading) {
+      if (actionConfig.cacheResponse !== false) {
         const query = queries[actionName]?.options;
         const input = actionConfig.hasQuery ? query : void 0;
-        actions[actionName].execute(input);
+        const pathParams = JSON.parse(pathParamsString);
+        const cacheKey = generateCacheKey(moduleConfig.baseEndpoint, actionName, input, { pathParams });
+        states[actionName] = useApiActionState(
+          actionConfig,
+          cacheKey,
+          // [تصحيح] مرر `execute` مباشرة
+          actions[actionName].execute,
+          input,
+          enabled
+        );
+      } else {
+        states[actionName] = createInitialState2();
       }
     }
-  }, [enabled, moduleConfig, actions, states, queries]);
+  }
   const lastBlurTimestamp = useRef4(Date.now());
   useEffect4(() => {
     if (!enabled || !refetchOnWindowFocus) return;

package/dist/index.cjs

@@ -548,7 +548,6 @@ var GlobalStateManager = class {
     if (!this.store.has(key)) {
       const initialState = createInitialState();
       this.store.set(key, { state: initialState, listeners: /* @__PURE__ */ new Set() });
-      return initialState;
     }
     return this.store.get(key).state;
   }
@@ -570,14 +569,14 @@ var GlobalStateManager = class {
    * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
    */
   setState(key, updater) {
-    const currentState = this.getSnapshot(key);
+    const item = this.store.get(key);
+    const currentState = item.state;
     const newState = updater(currentState);
-    if (!this.store.has(key)) {
-      this.store.set(key, { state: newState, listeners: /* @__PURE__ */ new Set() });
-    } else {
-      this.store.get(key).state = newState;
+    if (Object.is(currentState, newState)) {
+      return;
     }
-    this.store.get(key).listeners.forEach((listener) => listener());
+    item.state = newState;
+    item.listeners.forEach((listener) => listener());
   }
   /**
    * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).

package/dist/index.d.cts

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

package/dist/index.js

@@ -506,7 +506,6 @@ var GlobalStateManager = class {
     if (!this.store.has(key)) {
       const initialState = createInitialState();
       this.store.set(key, { state: initialState, listeners: /* @__PURE__ */ new Set() });
-      return initialState;
     }
     return this.store.get(key).state;
   }
@@ -528,14 +527,14 @@ var GlobalStateManager = class {
    * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
    */
   setState(key, updater) {
-    const currentState = this.getSnapshot(key);
+    const item = this.store.get(key);
+    const currentState = item.state;
     const newState = updater(currentState);
-    if (!this.store.has(key)) {
-      this.store.set(key, { state: newState, listeners: /* @__PURE__ */ new Set() });
-    } else {
-      this.store.get(key).state = newState;
+    if (Object.is(currentState, newState)) {
+      return;
     }
-    this.store.get(key).listeners.forEach((listener) => listener());
+    item.state = newState;
+    item.listeners.forEach((listener) => listener());
   }
   /**
    * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).

package/dist/server.cjs

@@ -199,7 +199,6 @@ var GlobalStateManager = class {
     if (!this.store.has(key)) {
       const initialState = createInitialState();
       this.store.set(key, { state: initialState, listeners: /* @__PURE__ */ new Set() });
-      return initialState;
     }
     return this.store.get(key).state;
   }
@@ -221,14 +220,14 @@ var GlobalStateManager = class {
    * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
    */
   setState(key, updater) {
-    const currentState = this.getSnapshot(key);
+    const item = this.store.get(key);
+    const currentState = item.state;
     const newState = updater(currentState);
-    if (!this.store.has(key)) {
-      this.store.set(key, { state: newState, listeners: /* @__PURE__ */ new Set() });
-    } else {
-      this.store.get(key).state = newState;
+    if (Object.is(currentState, newState)) {
+      return;
     }
-    this.store.get(key).listeners.forEach((listener) => listener());
+    item.state = newState;
+    item.listeners.forEach((listener) => listener());
   }
   /**
    * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).

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-BTtRM9wO.cjs';
+import { A as ActionConfigModule, a as ApiModuleConfig, I as InputOf } from './apiModule.types-D0LSWRW8.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-BTtRM9wO.js';
+import { A as ActionConfigModule, a as ApiModuleConfig, I as InputOf } from './apiModule.types-D0LSWRW8.js';
 import 'react';
 
 /**

package/dist/server.js

@@ -165,7 +165,6 @@ var GlobalStateManager = class {
     if (!this.store.has(key)) {
       const initialState = createInitialState();
       this.store.set(key, { state: initialState, listeners: /* @__PURE__ */ new Set() });
-      return initialState;
     }
     return this.store.get(key).state;
   }
@@ -187,14 +186,14 @@ var GlobalStateManager = class {
    * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
    */
   setState(key, updater) {
-    const currentState = this.getSnapshot(key);
+    const item = this.store.get(key);
+    const currentState = item.state;
     const newState = updater(currentState);
-    if (!this.store.has(key)) {
-      this.store.set(key, { state: newState, listeners: /* @__PURE__ */ new Set() });
-    } else {
-      this.store.get(key).state = newState;
+    if (Object.is(currentState, newState)) {
+      return;
     }
-    this.store.get(key).listeners.forEach((listener) => listener());
+    item.state = newState;
+    item.listeners.forEach((listener) => listener());
   }
   /**
    * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).

package/dist/{useApiRecord.types-BsOSJZ5l.d.ts → useApiRecord.types-C7T0gsX_.d.ts}

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

package/dist/{useApiRecord.types-CBP3Ufvu.d.cts → useApiRecord.types-DXv1-ly6.d.cts}

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

package/package.json

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