@localess/js-client 0.9.0 → 0.9.1

package/dist/index.d.mts

@@ -194,6 +194,11 @@ type LocalessClientOptions = {
      * Enable debug mode
      */
     debug?: boolean;
+    /**
+     * Cache TTL (time to live) for API responses. Default is 5 minutes (300000 ms).
+     * Set to false to disable caching.
+     */
+    cacheTTL?: number | false;
 };
 type LinksFetchParams = {
     /**

package/dist/index.d.ts

@@ -194,6 +194,11 @@ type LocalessClientOptions = {
      * Enable debug mode
      */
     debug?: boolean;
+    /**
+     * Cache TTL (time to live) for API responses. Default is 5 minutes (300000 ms).
+     * Set to false to disable caching.
+     */
+    cacheTTL?: number | false;
 };
 type LinksFetchParams = {
     /**

package/dist/index.js

@@ -39,6 +39,44 @@ var isBrowser = () => typeof window !== "undefined";
 var isServer = () => typeof window === "undefined";
 var isIframe = () => isBrowser() && window.self !== window.top;
 
+// src/cache.ts
+var NoCache = class {
+  set(key, value) {
+  }
+  get(key) {
+    return void 0;
+  }
+  has(key) {
+    return false;
+  }
+};
+var TTLCache = class {
+  /**
+   * Creates a TTLCache with a specified time-to-live (TTL) for each entry.
+   * default is 5 minutes (300000 ms).
+   * @param ttlMs
+   */
+  constructor(ttlMs = 3e5) {
+    this.ttlMs = ttlMs;
+  }
+  cache = /* @__PURE__ */ new Map();
+  set(key, value) {
+    this.cache.set(key, { value, expiresAt: Date.now() + this.ttlMs });
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  has(key) {
+    return this.get(key) !== void 0;
+  }
+};
+
 // src/client.ts
 var LOG_GROUP = `${FG_BLUE}[Localess:Client]${RESET}`;
 function localessClient(options) {
@@ -54,7 +92,7 @@ function localessClient(options) {
       "X-Localess-Agent-Version": "0.9.0"
     }
   };
-  const cache = /* @__PURE__ */ new Map();
+  const cache = options.cacheTTL === false ? new NoCache() : new TTLCache(options.cacheTTL);
   return {
     async getLinks(params) {
       if (options.debug) {

package/dist/index.mjs

@@ -5,6 +5,44 @@ var isBrowser = () => typeof window !== "undefined";
 var isServer = () => typeof window === "undefined";
 var isIframe = () => isBrowser() && window.self !== window.top;
 
+// src/cache.ts
+var NoCache = class {
+  set(key, value) {
+  }
+  get(key) {
+    return void 0;
+  }
+  has(key) {
+    return false;
+  }
+};
+var TTLCache = class {
+  /**
+   * Creates a TTLCache with a specified time-to-live (TTL) for each entry.
+   * default is 5 minutes (300000 ms).
+   * @param ttlMs
+   */
+  constructor(ttlMs = 3e5) {
+    this.ttlMs = ttlMs;
+  }
+  cache = /* @__PURE__ */ new Map();
+  set(key, value) {
+    this.cache.set(key, { value, expiresAt: Date.now() + this.ttlMs });
+  }
+  get(key) {
+    const entry = this.cache.get(key);
+    if (!entry) return void 0;
+    if (Date.now() > entry.expiresAt) {
+      this.cache.delete(key);
+      return void 0;
+    }
+    return entry.value;
+  }
+  has(key) {
+    return this.get(key) !== void 0;
+  }
+};
+
 // src/client.ts
 var LOG_GROUP = `${FG_BLUE}[Localess:Client]${RESET}`;
 function localessClient(options) {
@@ -20,7 +58,7 @@ function localessClient(options) {
       "X-Localess-Agent-Version": "0.9.0"
     }
   };
-  const cache = /* @__PURE__ */ new Map();
+  const cache = options.cacheTTL === false ? new NoCache() : new TTLCache(options.cacheTTL);
   return {
     async getLinks(params) {
       if (options.debug) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@localess/js-client",
-  "version": "0.9.0",
+  "version": "0.9.1",
   "description": "Universal JavaScript/TypeScript SDK for Localess's API.",
   "keywords": [
     "localess",