api-core-lib 12.0.26 → 12.0.27

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

@@ -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 { ApiError 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, ActionOptions as a, ActionConfigModule as b, ApiModuleConfig as c, UseApiModuleOptions as d, UseApiModuleReturn as e, ModuleActions as f, UseApiQuery as g, ApiClientConfig as h, ActionStateModule 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 };

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

@@ -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 { ApiError 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, ActionOptions as a, ActionConfigModule as b, ApiModuleConfig as c, UseApiModuleOptions as d, UseApiModuleReturn as e, ModuleActions as f, UseApiQuery as g, ApiClientConfig as h, ActionStateModule 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 };

package/dist/chunk-NCMDUWNO.cjs

@@ -0,0 +1,388 @@
+#!/usr/bin/env node
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+var _chunkQOOQGLEXcjs = require('./chunk-QOOQGLEX.cjs');
+
+// src/core/utils.ts
+var _axios = require('axios'); var _axios2 = _interopRequireDefault(_axios);
+function isAxiosResponse(obj) {
+  return obj && obj.data !== void 0 && obj.status !== void 0 && obj.config !== void 0;
+}
+function buildPaginateQuery(options) {
+  const params = new URLSearchParams();
+  for (const key in options) {
+    const value = options[key];
+    if (value === null || value === void 0) {
+      continue;
+    }
+    if (key === "filter" && typeof value === "object" && !Array.isArray(value)) {
+      for (const filterKey in value) {
+        const filterValue = value[filterKey];
+        if (filterValue !== null && filterValue !== void 0) {
+          params.append(`filter[${filterKey}]`, String(filterValue));
+        }
+      }
+    } else if (key === "sortBy" && Array.isArray(value)) {
+      value.forEach((sortItem) => {
+        if (sortItem && sortItem.key && sortItem.direction) {
+          params.append("sortBy[]", `${sortItem.key}:${sortItem.direction}`);
+        }
+      });
+    } else {
+      params.append(key, String(value));
+    }
+  }
+  return params.toString();
+}
+function isServerError(error) {
+  return _axios2.default.isAxiosError(error) && error.response !== void 0;
+}
+function isNetworkError(error) {
+  return _axios2.default.isAxiosError(error) && error.response === void 0 && error.request !== void 0;
+}
+
+// src/core/processor.ts
+
+var processResponse = (responseOrError) => {
+  if (isAxiosResponse(responseOrError)) {
+    const response = responseOrError;
+    const rawData = response.data;
+    const isStandardApiResponse = rawData && typeof rawData.success === "boolean" && rawData.data !== void 0;
+    return {
+      data: isStandardApiResponse ? rawData.data : rawData,
+      links: isStandardApiResponse ? rawData.links : void 0,
+      meta: isStandardApiResponse ? rawData.meta : void 0,
+      rawResponse: rawData,
+      loading: false,
+      success: true,
+      error: null,
+      message: isStandardApiResponse ? rawData.message : "Request successful.",
+      validationErrors: []
+    };
+  }
+  if (isServerError(responseOrError)) {
+    const error = responseOrError;
+    const responseData = error.response.data;
+    const status = error.response.status;
+    let defaultMessage = "An unexpected server error occurred.";
+    switch (status) {
+      case 400:
+        defaultMessage = "Bad Request";
+        break;
+      case 401:
+        defaultMessage = "Unauthorized";
+        break;
+      case 403:
+        defaultMessage = "Forbidden";
+        break;
+      case 404:
+        defaultMessage = "Not Found";
+        break;
+      case 422:
+        defaultMessage = "Validation Failed";
+        break;
+      case 500:
+        defaultMessage = "Internal Server Error";
+        break;
+      case 503:
+        defaultMessage = "Service Unavailable";
+        break;
+      default:
+        defaultMessage = `Server Error (${status})`;
+    }
+    const finalApiError = {
+      message: _optionalChain([responseData, 'optionalAccess', _ => _.message]) || defaultMessage,
+      status,
+      code: _optionalChain([responseData, 'optionalAccess', _2 => _2.code]) || error.code,
+      errors: _optionalChain([responseData, 'optionalAccess', _3 => _3.errors]) || []
+    };
+    return {
+      data: null,
+      rawResponse: responseData,
+      error: finalApiError,
+      validationErrors: finalApiError.errors,
+      success: false,
+      loading: false,
+      message: finalApiError.message
+    };
+  }
+  if (isNetworkError(responseOrError)) {
+    const error = responseOrError;
+    return {
+      data: null,
+      rawResponse: error.request,
+      error: { message: "Network Error: Unable to connect.", status: 0, code: error.code },
+      success: false,
+      loading: false,
+      message: "Network Error."
+    };
+  }
+  if (_axios2.default.isCancel(responseOrError)) {
+    return {
+      data: null,
+      rawResponse: null,
+      error: { message: "Request Canceled.", status: 499 },
+      success: false,
+      loading: false,
+      message: "Request Canceled."
+    };
+  }
+  return {
+    data: null,
+    rawResponse: responseOrError,
+    error: { message: "An unknown error occurred.", status: -1 },
+    success: false,
+    loading: false,
+    message: "An unknown error occurred."
+  };
+};
+
+// src/core/buildDynamicUrl.ts
+function buildDynamicUrl(template, params) {
+  if (!params) {
+    return template;
+  }
+  return template.replace(/\{(\w+)\}/g, (placeholder, key) => {
+    return params.hasOwnProperty(key) ? String(params[key]) : placeholder;
+  });
+}
+
+// src/services/crud.ts
+function createApiServices(axiosInstance, baseEndpoint) {
+  const resolveUrl = (config = {}, id) => {
+    const endpointTemplate = config.endpoint || (id != null ? `${baseEndpoint}/{id}` : baseEndpoint);
+    const params = id != null ? { id, tenant: id, tenantId: id, recordId: id } : {};
+    return buildDynamicUrl(endpointTemplate, params);
+  };
+  const get = async (id, config) => {
+    const url = resolveUrl(config, id);
+    try {
+      const response = await axiosInstance.get(url, config);
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const getWithQuery = async (query, config) => {
+    const url = `${baseEndpoint}?${query}`;
+    try {
+      const response = await axiosInstance.get(url, config);
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const post = async (data, config) => {
+    const url = resolveUrl(config);
+    try {
+      const response = await axiosInstance.post(url, data, config);
+      console.log("[lib] response POST: ", response);
+      console.log("[lib] response processResponse POST: ", processResponse(response));
+      return processResponse(response);
+    } catch (error) {
+      console.log("[lib] response error POST: ", processResponse(error));
+      return processResponse(error);
+    }
+  };
+  const put = async (id, data, config) => {
+    const url = resolveUrl(config, id);
+    try {
+      const response = await axiosInstance.put(url, data, config);
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const patch = async (id, data, config) => {
+    const url = resolveUrl(config, id);
+    try {
+      const response = await axiosInstance.patch(url, data, config);
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const remove = async (id, config) => {
+    const url = resolveUrl(config, id);
+    try {
+      const response = await axiosInstance.delete(url, config);
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const bulkDelete = async (ids, config) => {
+    const url = resolveUrl(config);
+    try {
+      const response = await axiosInstance.delete(url, { data: { ids }, ...config });
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  const upload = async (file, additionalData, config) => {
+    const url = resolveUrl(config);
+    const formData = new FormData();
+    formData.append("file", file);
+    if (additionalData) {
+      Object.keys(additionalData).forEach((key) => formData.append(key, String(additionalData[key])));
+    }
+    try {
+      const response = await axiosInstance.post(url, formData, {
+        ...config,
+        headers: { ..._optionalChain([config, 'optionalAccess', _4 => _4.headers]), "Content-Type": "multipart/form-data" }
+      });
+      return processResponse(response);
+    } catch (error) {
+      return processResponse(error);
+    }
+  };
+  return { get, getWithQuery, post, put, patch, remove, bulkDelete, upload };
+}
+async function callDynamicApi(axiosInstance, baseEndpoint, actionConfig, params) {
+  const { pathParams, body, config } = params;
+  const urlTemplate = `${baseEndpoint}${actionConfig.path}`;
+  const finalUrl = buildDynamicUrl(urlTemplate, pathParams || {});
+  try {
+    const { method } = actionConfig;
+    let response;
+    if (method === "POST" || method === "PUT" || method === "PATCH") {
+      response = await axiosInstance[method.toLowerCase()](finalUrl, body, config);
+    } else if (method === "DELETE") {
+      response = await axiosInstance.delete(finalUrl, { data: body, ...config });
+    } else {
+      response = await axiosInstance.get(finalUrl, { params: body, ...config });
+    }
+    return processResponse(response);
+  } catch (error) {
+    return processResponse(error);
+  }
+}
+
+// src/core/globalStateManager.ts
+var createInitialState = () => ({
+  data: null,
+  links: void 0,
+  meta: void 0,
+  error: null,
+  loading: false,
+  success: false,
+  called: false,
+  isStale: false,
+  message: void 0,
+  validationErrors: [],
+  rawResponse: null
+});
+var GlobalStateManager = class {
+  constructor() {
+    _chunkQOOQGLEXcjs.__publicField.call(void 0, this, "store", /* @__PURE__ */ new Map());
+  }
+  getSnapshot(key) {
+    if (!this.store.has(key)) {
+      const initialState = createInitialState();
+      this.store.set(key, { state: initialState, listeners: /* @__PURE__ */ new Set() });
+    }
+    return this.store.get(key).state;
+  }
+  /**
+   * يسجل دالة callback للاستماع إلى التغييرات على مفتاح معين.
+   * @returns دالة لإلغاء الاشتراك.
+   */
+  subscribe(key, callback) {
+    if (!this.store.has(key)) {
+      this.store.set(key, { state: createInitialState(), listeners: /* @__PURE__ */ new Set() });
+    }
+    const item = this.store.get(key);
+    item.listeners.add(callback);
+    return () => {
+      item.listeners.delete(callback);
+    };
+  }
+  /**
+   * يحدّث الحالة لمفتاح معين ويقوم بإعلام جميع المشتركين.
+   */
+  setState(key, updater) {
+    const currentState = this.getSnapshot(key);
+    const newState = updater(currentState);
+    if (Object.is(currentState, newState)) {
+      return;
+    }
+    const item = this.store.get(key);
+    item.state = newState;
+    item.listeners.forEach((listener) => listener());
+  }
+  /**
+   * يجعل البيانات المرتبطة بمفتاح معين "قديمة" (stale).
+   */
+  invalidate(key) {
+    const state = this.getSnapshot(key);
+    if (state.called) {
+      this.setState(key, (prev) => ({ ...prev, isStale: true }));
+    }
+  }
+  /**
+  * [نسخة محدثة وأكثر قوة]
+  * يجعل كل البيانات التي تبدأ بمفتاح معين "قديمة" (stale).
+  * @example invalidateByPrefix('myModule/list::') سيبطل كل صفحات القائمة.
+  */
+  invalidateByPrefix(prefix) {
+    this.store.forEach((value, key) => {
+      if (key.startsWith(prefix)) {
+        const state = this.getSnapshot(key);
+        if (state.called) {
+          this.setState(key, (prev) => ({ ...prev, isStale: true }));
+        }
+      }
+    });
+  }
+  /**
+  * Serializes the current state of the query store into a JSON string.
+  * This is used on the server to pass the initial state to the client.
+  * @returns A JSON string representing the dehydrated state.
+  */
+  dehydrate() {
+    const stateToPersist = {};
+    this.store.forEach((value, key) => {
+      if (value.state.called) {
+        stateToPersist[key] = value.state;
+      }
+    });
+    return JSON.stringify(stateToPersist);
+  }
+  /**
+   * Merges a dehydrated state object into the current store.
+   * This is used on the client to hydrate the state received from the server.
+   * @param hydratedState - A JSON string from the `dehydrate` method.
+   */
+  rehydrate(hydratedState) {
+    try {
+      const parsedState = JSON.parse(hydratedState);
+      for (const key in parsedState) {
+        this.setState(key, () => parsedState[key]);
+      }
+    } catch (e) {
+      console.error("[api-core-lib] Failed to rehydrate state:", e);
+    }
+  }
+};
+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()}`;
+  }
+};
+
+
+
+
+
+
+
+
+exports.buildPaginateQuery = buildPaginateQuery; exports.processResponse = processResponse; exports.createApiServices = createApiServices; exports.callDynamicApi = callDynamicApi; exports.globalStateManager = globalStateManager; exports.generateCacheKey = generateCacheKey;

package/dist/chunk-NRV3EMIJ.js

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+export {
+  __publicField
+};

package/dist/chunk-QOOQGLEX.cjs

@@ -0,0 +1,8 @@
+#!/usr/bin/env node
+"use strict";Object.defineProperty(exports, "__esModule", {value: true});var __defProp = Object.defineProperty;
+var __defNormalProp = (obj, key, value) => key in obj ? __defProp(obj, key, { enumerable: true, configurable: true, writable: true, value }) : obj[key] = value;
+var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "symbol" ? key + "" : key, value);
+
+
+
+exports.__publicField = __publicField;