@elementor/http-client 4.1.0-manual → 4.2.0-839

package/dist/index.d.mts

@@ -5,6 +5,7 @@ type HttpResponse<TData, TMeta = Record<string, unknown>> = {
     data: TData;
     meta: TMeta;
 };
+declare function registerUrlForCache(partialUrl: string, ttlMs?: number): void;
 declare const httpService: () => AxiosInstance;
 
-export { type HttpResponse, httpService };
+export { type HttpResponse, httpService, registerUrlForCache };

package/dist/index.d.ts

@@ -5,6 +5,7 @@ type HttpResponse<TData, TMeta = Record<string, unknown>> = {
     data: TData;
     meta: TMeta;
 };
+declare function registerUrlForCache(partialUrl: string, ttlMs?: number): void;
 declare const httpService: () => AxiosInstance;
 
-export { type HttpResponse, httpService };
+export { type HttpResponse, httpService, registerUrlForCache };

package/dist/index.js

@@ -31,7 +31,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   AxiosError: () => import_axios2.AxiosError,
-  httpService: () => httpService
+  httpService: () => httpService,
+  registerUrlForCache: () => registerUrlForCache
 });
 module.exports = __toCommonJS(index_exports);
 var import_axios2 = require("axios");
@@ -46,6 +47,56 @@ var { env } = (0, import_env.parseEnv)("@elementor/http-client");
 // src/http.ts
 var MAX_RETRIES = 3;
 var BASE_DELAY_MS = 1e3;
+var CACHE_TTL_MS = 2e4;
+var cache = /* @__PURE__ */ new Map();
+var cacheableUrls = /* @__PURE__ */ new Map();
+function registerUrlForCache(partialUrl, ttlMs = CACHE_TTL_MS) {
+  cacheableUrls.set(partialUrl, ttlMs);
+}
+function getUrlCacheTtl(url) {
+  for (const [pattern, ttl] of cacheableUrls) {
+    if (url.includes(pattern)) {
+      return ttl;
+    }
+  }
+  return null;
+}
+function getCacheKey(config) {
+  const url = config.url ?? "";
+  const params = config.params ? JSON.stringify(config.params) : "";
+  return `${config.baseURL ?? ""}${url}${params}`;
+}
+function getCachedResponse(config) {
+  if (config.method?.toLowerCase() !== "get") {
+    return null;
+  }
+  const url = `${config.baseURL ?? ""}${config.url ?? ""}`;
+  const ttl = getUrlCacheTtl(url);
+  if (ttl === null) {
+    return null;
+  }
+  const key = getCacheKey(config);
+  const entry = cache.get(key);
+  if (!entry) {
+    return null;
+  }
+  if (Date.now() - entry.timestamp > ttl) {
+    cache.delete(key);
+    return null;
+  }
+  return entry.response;
+}
+function setCachedResponse(config, response) {
+  if (!config || config.method?.toLowerCase() !== "get") {
+    return;
+  }
+  const url = `${config.baseURL ?? ""}${config.url ?? ""}`;
+  if (getUrlCacheTtl(url) === null) {
+    return;
+  }
+  const key = getCacheKey(config);
+  cache.set(key, { response, timestamp: Date.now() });
+}
 var RETRYABLE_METHODS = /* @__PURE__ */ new Set(["get", "head", "options", "put", "delete"]);
 var instance;
 var httpService = () => {
@@ -58,10 +109,29 @@ var httpService = () => {
         ...env.headers
       }
     });
+    instance.interceptors.request.use((config) => {
+      const cachedResponse = getCachedResponse(config);
+      if (cachedResponse) {
+        const controller = new AbortController();
+        controller.abort();
+        return {
+          ...config,
+          signal: controller.signal,
+          __cachedResponse: cachedResponse
+        };
+      }
+      return config;
+    });
     instance.interceptors.response.use(
-      (response) => response,
+      (response) => {
+        setCachedResponse(response.config, response);
+        return response;
+      },
       async (error) => {
         const config = error.config;
+        if (config?.__cachedResponse) {
+          return config.__cachedResponse;
+        }
         if (!config || !shouldRetry(error)) {
           return Promise.reject(error);
         }
@@ -103,6 +173,7 @@ function sleep(ms) {
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   AxiosError,
-  httpService
+  httpService,
+  registerUrlForCache
 });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/http.ts","../src/env.ts"],"sourcesContent":["export { type AxiosResponse, AxiosError } from 'axios';\nexport { type HttpResponse, httpService } from './http';\n","import axios, { type AxiosError, type AxiosInstance } from 'axios';\n\nimport { env } from './env';\n\nexport type HttpResponse< TData, TMeta = Record< string, unknown > > = {\n\tdata: TData;\n\tmeta: TMeta;\n};\n\nconst MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1000;\n\n// Only idempotent / safe methods are retried. POST and PATCH are excluded because\n// a 500 may arrive after the server partially completed the operation, and retrying\n// could produce duplicates (e.g. create, lock, archive endpoints).\nconst RETRYABLE_METHODS = new Set( [ 'get', 'head', 'options', 'put', 'delete' ] );\n\nlet instance: AxiosInstance;\n\nexport const httpService = () => {\n\tif ( ! instance ) {\n\t\tinstance = axios.create( {\n\t\t\tbaseURL: env.base_url,\n\t\t\ttimeout: 10000,\n\t\t\theaders: {\n\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\t...env.headers,\n\t\t\t},\n\t\t} );\n\n\t\tinstance.interceptors.response.use(\n\t\t\t( response ) => response,\n\t\t\tasync ( error: AxiosError ) => {\n\t\t\t\tconst config = error.config as typeof error.config & {\n\t\t\t\t\t__retryCount?: number;\n\t\t\t\t\t__baseTimeout?: number;\n\t\t\t\t};\n\n\t\t\t\tif ( ! config || ! shouldRetry( error ) ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst retryCount = config.__retryCount ?? 0;\n\n\t\t\t\tif ( retryCount >= MAX_RETRIES ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst baseDelay = BASE_DELAY_MS * Math.pow( 2, retryCount );\n\t\t\t\tconst jitter = Math.random() * BASE_DELAY_MS * 0.1;\n\t\t\t\tawait sleep( baseDelay + jitter );\n\n\t\t\t\tconst baseTimeout = config.__baseTimeout ?? config.timeout ?? 10000;\n\n\t\t\t\treturn instance( {\n\t\t\t\t\t...config,\n\t\t\t\t\t__retryCount: retryCount + 1,\n\t\t\t\t\t__baseTimeout: baseTimeout,\n\t\t\t\t\ttimeout: baseTimeout * ( retryCount + 2 ),\n\t\t\t\t} as typeof config );\n\t\t\t}\n\t\t);\n\t}\n\n\treturn instance;\n};\n\nfunction shouldRetry( error: AxiosError ): boolean {\n\tconst method = error.config?.method?.toLowerCase();\n\tif ( method && ! RETRYABLE_METHODS.has( method ) ) {\n\t\treturn false;\n\t}\n\n\tif ( ! error.response ) {\n\t\treturn true;\n\t}\n\t// 429 Too Many Requests: transient rate-limiting, backoff helps\n\tif ( error.response.status === 429 ) {\n\t\treturn true;\n\t}\n\treturn error.response.status >= 500;\n}\n\nfunction sleep( ms: number ): Promise< void > {\n\treturn new Promise( ( resolve ) => setTimeout( resolve, ms ) );\n}\n","import { parseEnv } from '@elementor/env';\n\nexport const { env } = parseEnv< {\n\tbase_url: string;\n\theaders: Record< string, string >;\n} >( '@elementor/http-client' );\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,IAAAA,gBAA+C;;;ACA/C,mBAA2D;;;ACA3D,iBAAyB;AAElB,IAAM,EAAE,IAAI,QAAI,qBAGlB,wBAAyB;;;ADI9B,IAAM,cAAc;AACpB,IAAM,gBAAgB;AAKtB,IAAM,oBAAoB,oBAAI,IAAK,CAAE,OAAO,QAAQ,WAAW,OAAO,QAAS,CAAE;AAEjF,IAAI;AAEG,IAAM,cAAc,MAAM;AAChC,MAAK,CAAE,UAAW;AACjB,eAAW,aAAAC,QAAM,OAAQ;AAAA,MACxB,SAAS,IAAI;AAAA,MACb,SAAS;AAAA,MACT,SAAS;AAAA,QACR,gBAAgB;AAAA,QAChB,GAAG,IAAI;AAAA,MACR;AAAA,IACD,CAAE;AAEF,aAAS,aAAa,SAAS;AAAA,MAC9B,CAAE,aAAc;AAAA,MAChB,OAAQ,UAAuB;AAC9B,cAAM,SAAS,MAAM;AAKrB,YAAK,CAAE,UAAU,CAAE,YAAa,KAAM,GAAI;AACzC,iBAAO,QAAQ,OAAQ,KAAM;AAAA,QAC9B;AAEA,cAAM,aAAa,OAAO,gBAAgB;AAE1C,YAAK,cAAc,aAAc;AAChC,iBAAO,QAAQ,OAAQ,KAAM;AAAA,QAC9B;AAEA,cAAM,YAAY,gBAAgB,KAAK,IAAK,GAAG,UAAW;AAC1D,cAAM,SAAS,KAAK,OAAO,IAAI,gBAAgB;AAC/C,cAAM,MAAO,YAAY,MAAO;AAEhC,cAAM,cAAc,OAAO,iBAAiB,OAAO,WAAW;AAE9D,eAAO,SAAU;AAAA,UAChB,GAAG;AAAA,UACH,cAAc,aAAa;AAAA,UAC3B,eAAe;AAAA,UACf,SAAS,eAAgB,aAAa;AAAA,QACvC,CAAmB;AAAA,MACpB;AAAA,IACD;AAAA,EACD;AAEA,SAAO;AACR;AAEA,SAAS,YAAa,OAA6B;AAClD,QAAM,SAAS,MAAM,QAAQ,QAAQ,YAAY;AACjD,MAAK,UAAU,CAAE,kBAAkB,IAAK,MAAO,GAAI;AAClD,WAAO;AAAA,EACR;AAEA,MAAK,CAAE,MAAM,UAAW;AACvB,WAAO;AAAA,EACR;AAEA,MAAK,MAAM,SAAS,WAAW,KAAM;AACpC,WAAO;AAAA,EACR;AACA,SAAO,MAAM,SAAS,UAAU;AACjC;AAEA,SAAS,MAAO,IAA8B;AAC7C,SAAO,IAAI,QAAS,CAAE,YAAa,WAAY,SAAS,EAAG,CAAE;AAC9D;","names":["import_axios","axios"]}
+{"version":3,"sources":["../src/index.ts","../src/http.ts","../src/env.ts"],"sourcesContent":["export { type AxiosResponse, AxiosError } from 'axios';\nexport { type HttpResponse, httpService, registerUrlForCache } from './http';\n","import axios, { type AxiosError, type AxiosInstance, type AxiosResponse, type InternalAxiosRequestConfig } from 'axios';\n\nimport { env } from './env';\n\nexport type HttpResponse< TData, TMeta = Record< string, unknown > > = {\n\tdata: TData;\n\tmeta: TMeta;\n};\n\nconst MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1000;\nconst CACHE_TTL_MS = 20_000;\n\ntype CacheEntry = {\n\tresponse: AxiosResponse;\n\ttimestamp: number;\n};\n\nconst cache = new Map< string, CacheEntry >();\nconst cacheableUrls = new Map< string, number >();\n\nexport function registerUrlForCache( partialUrl: string, ttlMs: number = CACHE_TTL_MS ): void {\n\tcacheableUrls.set( partialUrl, ttlMs );\n}\n\nfunction getUrlCacheTtl( url: string ): number | null {\n\tfor ( const [ pattern, ttl ] of cacheableUrls ) {\n\t\tif ( url.includes( pattern ) ) {\n\t\t\treturn ttl;\n\t\t}\n\t}\n\n\treturn null;\n}\n\nfunction getCacheKey( config: InternalAxiosRequestConfig ): string {\n\tconst url = config.url ?? '';\n\tconst params = config.params ? JSON.stringify( config.params ) : '';\n\treturn `${ config.baseURL ?? '' }${ url }${ params }`;\n}\n\nfunction getCachedResponse( config: InternalAxiosRequestConfig ): AxiosResponse | null {\n\tif ( config.method?.toLowerCase() !== 'get' ) {\n\t\treturn null;\n\t}\n\n\tconst url = `${ config.baseURL ?? '' }${ config.url ?? '' }`;\n\tconst ttl = getUrlCacheTtl( url );\n\tif ( ttl === null ) {\n\t\treturn null;\n\t}\n\n\tconst key = getCacheKey( config );\n\tconst entry = cache.get( key );\n\n\tif ( ! entry ) {\n\t\treturn null;\n\t}\n\n\tif ( Date.now() - entry.timestamp > ttl ) {\n\t\tcache.delete( key );\n\t\treturn null;\n\t}\n\n\treturn entry.response;\n}\n\nfunction setCachedResponse( config: InternalAxiosRequestConfig | undefined, response: AxiosResponse ): void {\n\tif ( ! config || config.method?.toLowerCase() !== 'get' ) {\n\t\treturn;\n\t}\n\n\tconst url = `${ config.baseURL ?? '' }${ config.url ?? '' }`;\n\tif ( getUrlCacheTtl( url ) === null ) {\n\t\treturn;\n\t}\n\n\tconst key = getCacheKey( config );\n\tcache.set( key, { response, timestamp: Date.now() } );\n}\n\n// Only idempotent / safe methods are retried. POST and PATCH are excluded because\n// a 500 may arrive after the server partially completed the operation, and retrying\n// could produce duplicates (e.g. create, lock, archive endpoints).\nconst RETRYABLE_METHODS = new Set( [ 'get', 'head', 'options', 'put', 'delete' ] );\n\nlet instance: AxiosInstance;\n\nexport const httpService = () => {\n\tif ( ! instance ) {\n\t\tinstance = axios.create( {\n\t\t\tbaseURL: env.base_url,\n\t\t\ttimeout: 10000,\n\t\t\theaders: {\n\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\t...env.headers,\n\t\t\t},\n\t\t} );\n\n\t\tinstance.interceptors.request.use( ( config ) => {\n\t\t\tconst cachedResponse = getCachedResponse( config );\n\t\t\tif ( cachedResponse ) {\n\t\t\t\tconst controller = new AbortController();\n\t\t\t\tcontroller.abort();\n\t\t\t\treturn {\n\t\t\t\t\t...config,\n\t\t\t\t\tsignal: controller.signal,\n\t\t\t\t\t__cachedResponse: cachedResponse,\n\t\t\t\t} as typeof config;\n\t\t\t}\n\t\t\treturn config;\n\t\t} );\n\n\t\tinstance.interceptors.response.use(\n\t\t\t( response ) => {\n\t\t\t\tsetCachedResponse( response.config, response );\n\t\t\t\treturn response;\n\t\t\t},\n\t\t\tasync ( error: AxiosError ) => {\n\t\t\t\tconst config = error.config as typeof error.config & {\n\t\t\t\t\t__cachedResponse?: AxiosResponse;\n\t\t\t\t\t__retryCount?: number;\n\t\t\t\t\t__baseTimeout?: number;\n\t\t\t\t};\n\n\t\t\t\tif ( config?.__cachedResponse ) {\n\t\t\t\t\treturn config.__cachedResponse;\n\t\t\t\t}\n\n\t\t\t\tif ( ! config || ! shouldRetry( error ) ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst retryCount = config.__retryCount ?? 0;\n\n\t\t\t\tif ( retryCount >= MAX_RETRIES ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst baseDelay = BASE_DELAY_MS * Math.pow( 2, retryCount );\n\t\t\t\tconst jitter = Math.random() * BASE_DELAY_MS * 0.1;\n\t\t\t\tawait sleep( baseDelay + jitter );\n\n\t\t\t\tconst baseTimeout = config.__baseTimeout ?? config.timeout ?? 10000;\n\n\t\t\t\treturn instance( {\n\t\t\t\t\t...config,\n\t\t\t\t\t__retryCount: retryCount + 1,\n\t\t\t\t\t__baseTimeout: baseTimeout,\n\t\t\t\t\ttimeout: baseTimeout * ( retryCount + 2 ),\n\t\t\t\t} as typeof config );\n\t\t\t}\n\t\t);\n\t}\n\n\treturn instance;\n};\n\nfunction shouldRetry( error: AxiosError ): boolean {\n\tconst method = error.config?.method?.toLowerCase();\n\tif ( method && ! RETRYABLE_METHODS.has( method ) ) {\n\t\treturn false;\n\t}\n\n\tif ( ! error.response ) {\n\t\treturn true;\n\t}\n\t// 429 Too Many Requests: transient rate-limiting, backoff helps\n\tif ( error.response.status === 429 ) {\n\t\treturn true;\n\t}\n\treturn error.response.status >= 500;\n}\n\nfunction sleep( ms: number ): Promise< void > {\n\treturn new Promise( ( resolve ) => setTimeout( resolve, ms ) );\n}\n","import { parseEnv } from '@elementor/env';\n\nexport const { env } = parseEnv< {\n\tbase_url: string;\n\theaders: Record< string, string >;\n} >( '@elementor/http-client' );\n"],"mappings":"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","names":["import_axios","axios"]}

package/dist/index.mjs

@@ -11,6 +11,56 @@ var { env } = parseEnv("@elementor/http-client");
 // src/http.ts
 var MAX_RETRIES = 3;
 var BASE_DELAY_MS = 1e3;
+var CACHE_TTL_MS = 2e4;
+var cache = /* @__PURE__ */ new Map();
+var cacheableUrls = /* @__PURE__ */ new Map();
+function registerUrlForCache(partialUrl, ttlMs = CACHE_TTL_MS) {
+  cacheableUrls.set(partialUrl, ttlMs);
+}
+function getUrlCacheTtl(url) {
+  for (const [pattern, ttl] of cacheableUrls) {
+    if (url.includes(pattern)) {
+      return ttl;
+    }
+  }
+  return null;
+}
+function getCacheKey(config) {
+  const url = config.url ?? "";
+  const params = config.params ? JSON.stringify(config.params) : "";
+  return `${config.baseURL ?? ""}${url}${params}`;
+}
+function getCachedResponse(config) {
+  if (config.method?.toLowerCase() !== "get") {
+    return null;
+  }
+  const url = `${config.baseURL ?? ""}${config.url ?? ""}`;
+  const ttl = getUrlCacheTtl(url);
+  if (ttl === null) {
+    return null;
+  }
+  const key = getCacheKey(config);
+  const entry = cache.get(key);
+  if (!entry) {
+    return null;
+  }
+  if (Date.now() - entry.timestamp > ttl) {
+    cache.delete(key);
+    return null;
+  }
+  return entry.response;
+}
+function setCachedResponse(config, response) {
+  if (!config || config.method?.toLowerCase() !== "get") {
+    return;
+  }
+  const url = `${config.baseURL ?? ""}${config.url ?? ""}`;
+  if (getUrlCacheTtl(url) === null) {
+    return;
+  }
+  const key = getCacheKey(config);
+  cache.set(key, { response, timestamp: Date.now() });
+}
 var RETRYABLE_METHODS = /* @__PURE__ */ new Set(["get", "head", "options", "put", "delete"]);
 var instance;
 var httpService = () => {
@@ -23,10 +73,29 @@ var httpService = () => {
         ...env.headers
       }
     });
+    instance.interceptors.request.use((config) => {
+      const cachedResponse = getCachedResponse(config);
+      if (cachedResponse) {
+        const controller = new AbortController();
+        controller.abort();
+        return {
+          ...config,
+          signal: controller.signal,
+          __cachedResponse: cachedResponse
+        };
+      }
+      return config;
+    });
     instance.interceptors.response.use(
-      (response) => response,
+      (response) => {
+        setCachedResponse(response.config, response);
+        return response;
+      },
       async (error) => {
         const config = error.config;
+        if (config?.__cachedResponse) {
+          return config.__cachedResponse;
+        }
         if (!config || !shouldRetry(error)) {
           return Promise.reject(error);
         }
@@ -67,6 +136,7 @@ function sleep(ms) {
 }
 export {
   AxiosError,
-  httpService
+  httpService,
+  registerUrlForCache
 };
 //# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/http.ts","../src/env.ts"],"sourcesContent":["export { type AxiosResponse, AxiosError } from 'axios';\nexport { type HttpResponse, httpService } from './http';\n","import axios, { type AxiosError, type AxiosInstance } from 'axios';\n\nimport { env } from './env';\n\nexport type HttpResponse< TData, TMeta = Record< string, unknown > > = {\n\tdata: TData;\n\tmeta: TMeta;\n};\n\nconst MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1000;\n\n// Only idempotent / safe methods are retried. POST and PATCH are excluded because\n// a 500 may arrive after the server partially completed the operation, and retrying\n// could produce duplicates (e.g. create, lock, archive endpoints).\nconst RETRYABLE_METHODS = new Set( [ 'get', 'head', 'options', 'put', 'delete' ] );\n\nlet instance: AxiosInstance;\n\nexport const httpService = () => {\n\tif ( ! instance ) {\n\t\tinstance = axios.create( {\n\t\t\tbaseURL: env.base_url,\n\t\t\ttimeout: 10000,\n\t\t\theaders: {\n\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\t...env.headers,\n\t\t\t},\n\t\t} );\n\n\t\tinstance.interceptors.response.use(\n\t\t\t( response ) => response,\n\t\t\tasync ( error: AxiosError ) => {\n\t\t\t\tconst config = error.config as typeof error.config & {\n\t\t\t\t\t__retryCount?: number;\n\t\t\t\t\t__baseTimeout?: number;\n\t\t\t\t};\n\n\t\t\t\tif ( ! config || ! shouldRetry( error ) ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst retryCount = config.__retryCount ?? 0;\n\n\t\t\t\tif ( retryCount >= MAX_RETRIES ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst baseDelay = BASE_DELAY_MS * Math.pow( 2, retryCount );\n\t\t\t\tconst jitter = Math.random() * BASE_DELAY_MS * 0.1;\n\t\t\t\tawait sleep( baseDelay + jitter );\n\n\t\t\t\tconst baseTimeout = config.__baseTimeout ?? config.timeout ?? 10000;\n\n\t\t\t\treturn instance( {\n\t\t\t\t\t...config,\n\t\t\t\t\t__retryCount: retryCount + 1,\n\t\t\t\t\t__baseTimeout: baseTimeout,\n\t\t\t\t\ttimeout: baseTimeout * ( retryCount + 2 ),\n\t\t\t\t} as typeof config );\n\t\t\t}\n\t\t);\n\t}\n\n\treturn instance;\n};\n\nfunction shouldRetry( error: AxiosError ): boolean {\n\tconst method = error.config?.method?.toLowerCase();\n\tif ( method && ! RETRYABLE_METHODS.has( method ) ) {\n\t\treturn false;\n\t}\n\n\tif ( ! error.response ) {\n\t\treturn true;\n\t}\n\t// 429 Too Many Requests: transient rate-limiting, backoff helps\n\tif ( error.response.status === 429 ) {\n\t\treturn true;\n\t}\n\treturn error.response.status >= 500;\n}\n\nfunction sleep( ms: number ): Promise< void > {\n\treturn new Promise( ( resolve ) => setTimeout( resolve, ms ) );\n}\n","import { parseEnv } from '@elementor/env';\n\nexport const { env } = parseEnv< {\n\tbase_url: string;\n\theaders: Record< string, string >;\n} >( '@elementor/http-client' );\n"],"mappings":";AAAA,SAA6B,kBAAkB;;;ACA/C,OAAO,WAAoD;;;ACA3D,SAAS,gBAAgB;AAElB,IAAM,EAAE,IAAI,IAAI,SAGlB,wBAAyB;;;ADI9B,IAAM,cAAc;AACpB,IAAM,gBAAgB;AAKtB,IAAM,oBAAoB,oBAAI,IAAK,CAAE,OAAO,QAAQ,WAAW,OAAO,QAAS,CAAE;AAEjF,IAAI;AAEG,IAAM,cAAc,MAAM;AAChC,MAAK,CAAE,UAAW;AACjB,eAAW,MAAM,OAAQ;AAAA,MACxB,SAAS,IAAI;AAAA,MACb,SAAS;AAAA,MACT,SAAS;AAAA,QACR,gBAAgB;AAAA,QAChB,GAAG,IAAI;AAAA,MACR;AAAA,IACD,CAAE;AAEF,aAAS,aAAa,SAAS;AAAA,MAC9B,CAAE,aAAc;AAAA,MAChB,OAAQ,UAAuB;AAC9B,cAAM,SAAS,MAAM;AAKrB,YAAK,CAAE,UAAU,CAAE,YAAa,KAAM,GAAI;AACzC,iBAAO,QAAQ,OAAQ,KAAM;AAAA,QAC9B;AAEA,cAAM,aAAa,OAAO,gBAAgB;AAE1C,YAAK,cAAc,aAAc;AAChC,iBAAO,QAAQ,OAAQ,KAAM;AAAA,QAC9B;AAEA,cAAM,YAAY,gBAAgB,KAAK,IAAK,GAAG,UAAW;AAC1D,cAAM,SAAS,KAAK,OAAO,IAAI,gBAAgB;AAC/C,cAAM,MAAO,YAAY,MAAO;AAEhC,cAAM,cAAc,OAAO,iBAAiB,OAAO,WAAW;AAE9D,eAAO,SAAU;AAAA,UAChB,GAAG;AAAA,UACH,cAAc,aAAa;AAAA,UAC3B,eAAe;AAAA,UACf,SAAS,eAAgB,aAAa;AAAA,QACvC,CAAmB;AAAA,MACpB;AAAA,IACD;AAAA,EACD;AAEA,SAAO;AACR;AAEA,SAAS,YAAa,OAA6B;AAClD,QAAM,SAAS,MAAM,QAAQ,QAAQ,YAAY;AACjD,MAAK,UAAU,CAAE,kBAAkB,IAAK,MAAO,GAAI;AAClD,WAAO;AAAA,EACR;AAEA,MAAK,CAAE,MAAM,UAAW;AACvB,WAAO;AAAA,EACR;AAEA,MAAK,MAAM,SAAS,WAAW,KAAM;AACpC,WAAO;AAAA,EACR;AACA,SAAO,MAAM,SAAS,UAAU;AACjC;AAEA,SAAS,MAAO,IAA8B;AAC7C,SAAO,IAAI,QAAS,CAAE,YAAa,WAAY,SAAS,EAAG,CAAE;AAC9D;","names":[]}
+{"version":3,"sources":["../src/index.ts","../src/http.ts","../src/env.ts"],"sourcesContent":["export { type AxiosResponse, AxiosError } from 'axios';\nexport { type HttpResponse, httpService, registerUrlForCache } from './http';\n","import axios, { type AxiosError, type AxiosInstance, type AxiosResponse, type InternalAxiosRequestConfig } from 'axios';\n\nimport { env } from './env';\n\nexport type HttpResponse< TData, TMeta = Record< string, unknown > > = {\n\tdata: TData;\n\tmeta: TMeta;\n};\n\nconst MAX_RETRIES = 3;\nconst BASE_DELAY_MS = 1000;\nconst CACHE_TTL_MS = 20_000;\n\ntype CacheEntry = {\n\tresponse: AxiosResponse;\n\ttimestamp: number;\n};\n\nconst cache = new Map< string, CacheEntry >();\nconst cacheableUrls = new Map< string, number >();\n\nexport function registerUrlForCache( partialUrl: string, ttlMs: number = CACHE_TTL_MS ): void {\n\tcacheableUrls.set( partialUrl, ttlMs );\n}\n\nfunction getUrlCacheTtl( url: string ): number | null {\n\tfor ( const [ pattern, ttl ] of cacheableUrls ) {\n\t\tif ( url.includes( pattern ) ) {\n\t\t\treturn ttl;\n\t\t}\n\t}\n\n\treturn null;\n}\n\nfunction getCacheKey( config: InternalAxiosRequestConfig ): string {\n\tconst url = config.url ?? '';\n\tconst params = config.params ? JSON.stringify( config.params ) : '';\n\treturn `${ config.baseURL ?? '' }${ url }${ params }`;\n}\n\nfunction getCachedResponse( config: InternalAxiosRequestConfig ): AxiosResponse | null {\n\tif ( config.method?.toLowerCase() !== 'get' ) {\n\t\treturn null;\n\t}\n\n\tconst url = `${ config.baseURL ?? '' }${ config.url ?? '' }`;\n\tconst ttl = getUrlCacheTtl( url );\n\tif ( ttl === null ) {\n\t\treturn null;\n\t}\n\n\tconst key = getCacheKey( config );\n\tconst entry = cache.get( key );\n\n\tif ( ! entry ) {\n\t\treturn null;\n\t}\n\n\tif ( Date.now() - entry.timestamp > ttl ) {\n\t\tcache.delete( key );\n\t\treturn null;\n\t}\n\n\treturn entry.response;\n}\n\nfunction setCachedResponse( config: InternalAxiosRequestConfig | undefined, response: AxiosResponse ): void {\n\tif ( ! config || config.method?.toLowerCase() !== 'get' ) {\n\t\treturn;\n\t}\n\n\tconst url = `${ config.baseURL ?? '' }${ config.url ?? '' }`;\n\tif ( getUrlCacheTtl( url ) === null ) {\n\t\treturn;\n\t}\n\n\tconst key = getCacheKey( config );\n\tcache.set( key, { response, timestamp: Date.now() } );\n}\n\n// Only idempotent / safe methods are retried. POST and PATCH are excluded because\n// a 500 may arrive after the server partially completed the operation, and retrying\n// could produce duplicates (e.g. create, lock, archive endpoints).\nconst RETRYABLE_METHODS = new Set( [ 'get', 'head', 'options', 'put', 'delete' ] );\n\nlet instance: AxiosInstance;\n\nexport const httpService = () => {\n\tif ( ! instance ) {\n\t\tinstance = axios.create( {\n\t\t\tbaseURL: env.base_url,\n\t\t\ttimeout: 10000,\n\t\t\theaders: {\n\t\t\t\t'Content-Type': 'application/json',\n\t\t\t\t...env.headers,\n\t\t\t},\n\t\t} );\n\n\t\tinstance.interceptors.request.use( ( config ) => {\n\t\t\tconst cachedResponse = getCachedResponse( config );\n\t\t\tif ( cachedResponse ) {\n\t\t\t\tconst controller = new AbortController();\n\t\t\t\tcontroller.abort();\n\t\t\t\treturn {\n\t\t\t\t\t...config,\n\t\t\t\t\tsignal: controller.signal,\n\t\t\t\t\t__cachedResponse: cachedResponse,\n\t\t\t\t} as typeof config;\n\t\t\t}\n\t\t\treturn config;\n\t\t} );\n\n\t\tinstance.interceptors.response.use(\n\t\t\t( response ) => {\n\t\t\t\tsetCachedResponse( response.config, response );\n\t\t\t\treturn response;\n\t\t\t},\n\t\t\tasync ( error: AxiosError ) => {\n\t\t\t\tconst config = error.config as typeof error.config & {\n\t\t\t\t\t__cachedResponse?: AxiosResponse;\n\t\t\t\t\t__retryCount?: number;\n\t\t\t\t\t__baseTimeout?: number;\n\t\t\t\t};\n\n\t\t\t\tif ( config?.__cachedResponse ) {\n\t\t\t\t\treturn config.__cachedResponse;\n\t\t\t\t}\n\n\t\t\t\tif ( ! config || ! shouldRetry( error ) ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst retryCount = config.__retryCount ?? 0;\n\n\t\t\t\tif ( retryCount >= MAX_RETRIES ) {\n\t\t\t\t\treturn Promise.reject( error );\n\t\t\t\t}\n\n\t\t\t\tconst baseDelay = BASE_DELAY_MS * Math.pow( 2, retryCount );\n\t\t\t\tconst jitter = Math.random() * BASE_DELAY_MS * 0.1;\n\t\t\t\tawait sleep( baseDelay + jitter );\n\n\t\t\t\tconst baseTimeout = config.__baseTimeout ?? config.timeout ?? 10000;\n\n\t\t\t\treturn instance( {\n\t\t\t\t\t...config,\n\t\t\t\t\t__retryCount: retryCount + 1,\n\t\t\t\t\t__baseTimeout: baseTimeout,\n\t\t\t\t\ttimeout: baseTimeout * ( retryCount + 2 ),\n\t\t\t\t} as typeof config );\n\t\t\t}\n\t\t);\n\t}\n\n\treturn instance;\n};\n\nfunction shouldRetry( error: AxiosError ): boolean {\n\tconst method = error.config?.method?.toLowerCase();\n\tif ( method && ! RETRYABLE_METHODS.has( method ) ) {\n\t\treturn false;\n\t}\n\n\tif ( ! error.response ) {\n\t\treturn true;\n\t}\n\t// 429 Too Many Requests: transient rate-limiting, backoff helps\n\tif ( error.response.status === 429 ) {\n\t\treturn true;\n\t}\n\treturn error.response.status >= 500;\n}\n\nfunction sleep( ms: number ): Promise< void > {\n\treturn new Promise( ( resolve ) => setTimeout( resolve, ms ) );\n}\n","import { parseEnv } from '@elementor/env';\n\nexport const { env } = parseEnv< {\n\tbase_url: string;\n\theaders: Record< string, string >;\n} >( '@elementor/http-client' );\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@elementor/http-client",
   "description": "Provides a simple way to make HTTP requests",
-  "version": "4.1.0-manual",
+  "version": "4.2.0-839",
   "private": false,
   "author": "Elementor Team",
   "homepage": "https://elementor.com/",
@@ -40,7 +40,7 @@
     "dev": "tsup --config=../../tsup.dev.ts"
   },
   "dependencies": {
-    "@elementor/env": "4.1.0-manual",
+    "@elementor/env": "4.2.0-839",
     "axios": "^1.9.0"
   },
   "devDependencies": {

package/src/http.ts

@@ -1,4 +1,4 @@
-import axios, { type AxiosError, type AxiosInstance } from 'axios';
+import axios, { type AxiosError, type AxiosInstance, type AxiosResponse, type InternalAxiosRequestConfig } from 'axios';
 
 import { env } from './env';
 
@@ -9,6 +9,75 @@ export type HttpResponse< TData, TMeta = Record< string, unknown > > = {
 
 const MAX_RETRIES = 3;
 const BASE_DELAY_MS = 1000;
+const CACHE_TTL_MS = 20_000;
+
+type CacheEntry = {
+	response: AxiosResponse;
+	timestamp: number;
+};
+
+const cache = new Map< string, CacheEntry >();
+const cacheableUrls = new Map< string, number >();
+
+export function registerUrlForCache( partialUrl: string, ttlMs: number = CACHE_TTL_MS ): void {
+	cacheableUrls.set( partialUrl, ttlMs );
+}
+
+function getUrlCacheTtl( url: string ): number | null {
+	for ( const [ pattern, ttl ] of cacheableUrls ) {
+		if ( url.includes( pattern ) ) {
+			return ttl;
+		}
+	}
+
+	return null;
+}
+
+function getCacheKey( config: InternalAxiosRequestConfig ): string {
+	const url = config.url ?? '';
+	const params = config.params ? JSON.stringify( config.params ) : '';
+	return `${ config.baseURL ?? '' }${ url }${ params }`;
+}
+
+function getCachedResponse( config: InternalAxiosRequestConfig ): AxiosResponse | null {
+	if ( config.method?.toLowerCase() !== 'get' ) {
+		return null;
+	}
+
+	const url = `${ config.baseURL ?? '' }${ config.url ?? '' }`;
+	const ttl = getUrlCacheTtl( url );
+	if ( ttl === null ) {
+		return null;
+	}
+
+	const key = getCacheKey( config );
+	const entry = cache.get( key );
+
+	if ( ! entry ) {
+		return null;
+	}
+
+	if ( Date.now() - entry.timestamp > ttl ) {
+		cache.delete( key );
+		return null;
+	}
+
+	return entry.response;
+}
+
+function setCachedResponse( config: InternalAxiosRequestConfig | undefined, response: AxiosResponse ): void {
+	if ( ! config || config.method?.toLowerCase() !== 'get' ) {
+		return;
+	}
+
+	const url = `${ config.baseURL ?? '' }${ config.url ?? '' }`;
+	if ( getUrlCacheTtl( url ) === null ) {
+		return;
+	}
+
+	const key = getCacheKey( config );
+	cache.set( key, { response, timestamp: Date.now() } );
+}
 
 // Only idempotent / safe methods are retried. POST and PATCH are excluded because
 // a 500 may arrive after the server partially completed the operation, and retrying
@@ -28,14 +97,36 @@ export const httpService = () => {
 			},
 		} );
 
+		instance.interceptors.request.use( ( config ) => {
+			const cachedResponse = getCachedResponse( config );
+			if ( cachedResponse ) {
+				const controller = new AbortController();
+				controller.abort();
+				return {
+					...config,
+					signal: controller.signal,
+					__cachedResponse: cachedResponse,
+				} as typeof config;
+			}
+			return config;
+		} );
+
 		instance.interceptors.response.use(
-			( response ) => response,
+			( response ) => {
+				setCachedResponse( response.config, response );
+				return response;
+			},
 			async ( error: AxiosError ) => {
 				const config = error.config as typeof error.config & {
+					__cachedResponse?: AxiosResponse;
 					__retryCount?: number;
 					__baseTimeout?: number;
 				};
 
+				if ( config?.__cachedResponse ) {
+					return config.__cachedResponse;
+				}
+
 				if ( ! config || ! shouldRetry( error ) ) {
 					return Promise.reject( error );
 				}

package/src/index.ts

@@ -1,2 +1,2 @@
 export { type AxiosResponse, AxiosError } from 'axios';
-export { type HttpResponse, httpService } from './http';
+export { type HttpResponse, httpService, registerUrlForCache } from './http';