api-core-lib 12.0.14 → 12.0.16

package/dist/{apiModule.types-Cvp9QdAc.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, UseApiQuery as f, ApiError as g, TokenManager as h, Middleware as i, RefreshTokenConfig as j, ActionConfig as k, ActionStateModule 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-Cvp9QdAc.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, UseApiQuery as f, ApiError as g, TokenManager as h, Middleware as i, RefreshTokenConfig as j, ActionConfig as k, ActionStateModule 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

@@ -34,8 +34,6 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 var client_exports = {};
 __export(client_exports, {
   ApiModuleProvider: () => ApiModuleProvider,
-  generateCacheKey: () => generateCacheKey,
-  globalStateManager: () => globalStateManager,
   useApi: () => useApi,
   useApiModule: () => useApiModule,
   useApiRecord: () => useApiRecord,
@@ -614,14 +612,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).
@@ -679,27 +677,54 @@ var GlobalStateManager = class {
 };
 var globalStateManager = new GlobalStateManager();
 
+// src/core/cacheKey.ts
+var generateCacheKey = (moduleName, actionName, input, callOptions = {}) => {
+  const params = { path: callOptions.pathParams, body: input };
+  try {
+    return `${moduleName}/${actionName}::${JSON.stringify(params)}`;
+  } catch (error) {
+    console.warn("Could not stringify cache key params, falling back to timestamp.", { moduleName, actionName, error });
+    return `${moduleName}/${actionName}::${Date.now()}`;
+  }
+};
+
 // 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() {
@@ -722,29 +747,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 {
@@ -753,12 +811,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();
@@ -766,17 +825,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;
@@ -808,31 +861,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;
@@ -863,83 +909,9 @@ function useApiModule(axiosInstance, moduleConfig, options = {}) {
   }, []);
   return { actions, states, queries, dehydrate };
 }
-
-// src/core/client.ts
-var import_axios3 = __toESM(require("axios"), 1);
-var import_uuid = require("uuid");
-
-// src/core/cache.ts
-var CacheManager = class {
-  constructor() {
-    __publicField(this, "cache", /* @__PURE__ */ new Map());
-    __publicField(this, "defaultDuration", 15 * 60 * 1e3);
-  }
-  // 15 minutes
-  set(key, data, duration) {
-    this.cache.set(key, {
-      data,
-      timestamp: Date.now(),
-      duration: duration || this.defaultDuration
-    });
-  }
-  get(key) {
-    const item = this.cache.get(key);
-    if (!item) return null;
-    const isExpired = Date.now() - item.timestamp > item.duration;
-    if (isExpired) {
-      this.cache.delete(key);
-      return null;
-    }
-    return item.data;
-  }
-  /**
-   * [FIX] تم تحويلها إلى دالة عامة (generic) لتعيد النوع الصحيح.
-   * الآن بدلًا من إرجاع CacheItem<unknown>، ستُرجع CacheItem<T>.
-   */
-  getWithMeta(key) {
-    const item = this.cache.get(key);
-    if (!item) return null;
-    const isExpired = Date.now() - item.timestamp > item.duration;
-    if (isExpired) {
-      this.cache.delete(key);
-      return null;
-    }
-    return item;
-  }
-  delete(key) {
-    this.cache.delete(key);
-  }
-  clear() {
-    this.cache.clear();
-  }
-  invalidateByPrefix(prefix) {
-    const keysToDelete = [];
-    for (const key of this.cache.keys()) {
-      if (key.startsWith(prefix)) {
-        keysToDelete.push(key);
-      }
-    }
-    keysToDelete.forEach((key) => this.cache.delete(key));
-    console.log(`Invalidated ${keysToDelete.length} cache entries with prefix: ${prefix}`);
-  }
-};
-var cacheManager = new CacheManager();
-
-// src/core/cacheKey.ts
-var generateCacheKey = (moduleName, actionName, input, callOptions = {}) => {
-  const params = { path: callOptions.pathParams, body: input };
-  try {
-    return `${moduleName}/${actionName}::${JSON.stringify(params)}`;
-  } catch (error) {
-    console.warn("Could not stringify cache key params, falling back to timestamp.", { moduleName, actionName, error });
-    return `${moduleName}/${actionName}::${Date.now()}`;
-  }
-};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   ApiModuleProvider,
-  generateCacheKey,
-  globalStateManager,
   useApi,
   useApiModule,
   useApiRecord,

package/dist/client.d.cts

@@ -1,7 +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-Cvp9QdAc.cjs';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './cacheKey-BNQ1ii6y.cjs';
-export { b as generateCacheKey, g as globalStateManager } from './cacheKey-BNQ1ii6y.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,7 +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-Cvp9QdAc.js';
-import { U as UseApiRecordConfig, a as UseApiRecordReturn } from './cacheKey-BJQaehcQ.js';
-export { b as generateCacheKey, g as globalStateManager } from './cacheKey-BJQaehcQ.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;