api-core-lib 1.1.1 → 2.2.1

package/dist/index.d.mts

@@ -1,4 +1,4 @@
-import { ResponseType, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance } from 'axios';
+import { ResponseType, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance, AxiosResponse } from 'axios';
 import * as react from 'react';
 
 /**
@@ -87,12 +87,13 @@ interface RequestConfig extends AxiosRequestConfig {
  * الواجهة الرئيسية لتهيئة عميل الـ API.
  */
 interface ApiClientConfig {
-    baseURL: string;
+    baseURL?: string;
     tokenManager: TokenManager;
     timeout?: number;
     headers?: Record<string, string>;
     withCredentials?: boolean;
     responseType?: ResponseType;
+    pathRefreshToken?: string;
     onRefreshError?: (error: any) => void;
 }
 /**
@@ -150,6 +151,24 @@ declare function createApiServices<T>(axiosInstance: AxiosInstance, endpoint: st
 
 declare function buildPaginateQuery(query: PaginateQueryOptions): string;
 
+declare class CacheManager {
+    private cache;
+    private defaultDuration;
+    set<T>(key: string, data: T, duration?: number): void;
+    get<T>(key: string): T | null;
+    delete(key: string): void;
+    clear(): void;
+}
+declare const cacheManager: CacheManager;
+
+/**
+ * @file src/core/processor.ts
+ * @description
+ * ...
+ */
+
+declare const processResponse: <T>(responseOrError: AxiosResponse<ApiResponse<T>> | ApiError) => StandardResponse<T>;
+
 declare function useApi<T extends {
     id?: string | number;
 }>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): {
@@ -176,4 +195,4 @@ declare function useApi<T extends {
     };
 };
 
-export { type ApiClientConfig, type ApiError, type ApiResponse, type PaginateQueryOptions, type PaginationMeta, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiConfig, type ValidationError, buildPaginateQuery, createApiClient, createApiServices, useApi };
+export { type ApiClientConfig, type ApiError, type ApiResponse, type PaginateQueryOptions, type PaginationMeta, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiConfig, type ValidationError, buildPaginateQuery, cacheManager, createApiClient, createApiServices, processResponse, useApi };

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { ResponseType, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance } from 'axios';
+import { ResponseType, AxiosRequestConfig, AxiosProgressEvent, AxiosInstance, AxiosResponse } from 'axios';
 import * as react from 'react';
 
 /**
@@ -87,12 +87,13 @@ interface RequestConfig extends AxiosRequestConfig {
  * الواجهة الرئيسية لتهيئة عميل الـ API.
  */
 interface ApiClientConfig {
-    baseURL: string;
+    baseURL?: string;
     tokenManager: TokenManager;
     timeout?: number;
     headers?: Record<string, string>;
     withCredentials?: boolean;
     responseType?: ResponseType;
+    pathRefreshToken?: string;
     onRefreshError?: (error: any) => void;
 }
 /**
@@ -150,6 +151,24 @@ declare function createApiServices<T>(axiosInstance: AxiosInstance, endpoint: st
 
 declare function buildPaginateQuery(query: PaginateQueryOptions): string;
 
+declare class CacheManager {
+    private cache;
+    private defaultDuration;
+    set<T>(key: string, data: T, duration?: number): void;
+    get<T>(key: string): T | null;
+    delete(key: string): void;
+    clear(): void;
+}
+declare const cacheManager: CacheManager;
+
+/**
+ * @file src/core/processor.ts
+ * @description
+ * ...
+ */
+
+declare const processResponse: <T>(responseOrError: AxiosResponse<ApiResponse<T>> | ApiError) => StandardResponse<T>;
+
 declare function useApi<T extends {
     id?: string | number;
 }>(axiosInstance: AxiosInstance, config: UseApiConfig<T>): {
@@ -176,4 +195,4 @@ declare function useApi<T extends {
     };
 };
 
-export { type ApiClientConfig, type ApiError, type ApiResponse, type PaginateQueryOptions, type PaginationMeta, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiConfig, type ValidationError, buildPaginateQuery, createApiClient, createApiServices, useApi };
+export { type ApiClientConfig, type ApiError, type ApiResponse, type PaginateQueryOptions, type PaginationMeta, type RequestConfig, type StandardResponse, type TokenManager, type Tokens, type UseApiConfig, type ValidationError, buildPaginateQuery, cacheManager, createApiClient, createApiServices, processResponse, useApi };

package/dist/index.js

@@ -31,8 +31,10 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   buildPaginateQuery: () => buildPaginateQuery,
+  cacheManager: () => cacheManager,
   createApiClient: () => createApiClient,
   createApiServices: () => createApiServices,
+  processResponse: () => processResponse,
   useApi: () => useApi
 });
 module.exports = __toCommonJS(index_exports);
@@ -248,6 +250,37 @@ function createApiServices(axiosInstance, endpoint) {
   return { get, getWithQuery, post, patch, remove };
 }
 
+// src/core/cache.ts
+var CacheManager = class {
+  cache = /* @__PURE__ */ new Map();
+  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;
+  }
+  delete(key) {
+    this.cache.delete(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+};
+var cacheManager = new CacheManager();
+
 // src/hooks/useApi.ts
 var import_react = require("react");
 function useApi(axiosInstance, config) {
@@ -352,7 +385,9 @@ function useApi(axiosInstance, config) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   buildPaginateQuery,
+  cacheManager,
   createApiClient,
   createApiServices,
+  processResponse,
   useApi
 });

package/dist/index.mjs

@@ -209,6 +209,37 @@ function createApiServices(axiosInstance, endpoint) {
   return { get, getWithQuery, post, patch, remove };
 }
 
+// src/core/cache.ts
+var CacheManager = class {
+  cache = /* @__PURE__ */ new Map();
+  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;
+  }
+  delete(key) {
+    this.cache.delete(key);
+  }
+  clear() {
+    this.cache.clear();
+  }
+};
+var cacheManager = new CacheManager();
+
 // src/hooks/useApi.ts
 import { useState, useEffect, useCallback, useRef } from "react";
 function useApi(axiosInstance, config) {
@@ -312,7 +343,9 @@ function useApi(axiosInstance, config) {
 }
 export {
   buildPaginateQuery,
+  cacheManager,
   createApiClient,
   createApiServices,
+  processResponse,
   useApi
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "api-core-lib",
-  "version": "1.1.1",
+  "version": "2.2.1",
   "description": "A flexible and powerful API client library for modern web applications.",
   "main": "dist/index.js",
   "module": "dist/index.mjs",