@sebspark/promise-cache 0.1.0 → 0.2.0

package/dist/index.d.mts

@@ -1,8 +1,26 @@
 declare class PromiseCache<T, U> {
     private cache;
+    private readonly caseSensitive;
     private readonly ttl;
-    constructor(ttlInSeconds: number);
-    wrap(key: T, delegate: () => Promise<U>): Promise<U>;
+    /**
+     * Initialize a new PromiseCache.
+     * @param ttlInSeconds Default cache TTL.
+     * @param caseSensitive Set to true if you want to differentiate between keys with different casing.
+     */
+    constructor(ttlInSeconds: number, caseSensitive?: boolean);
+    /**
+     * Cache size.
+     * @returns The number of entries in the cache.
+     */
+    size(): number;
+    /**
+     * A simple promise cache wrapper.
+     * @param key Cache key.
+     * @param delegate The function to execute if the key is not in the cache.
+     * @param ttlInSeconds Time to live in seconds.
+     * @returns The result of the delegate function.
+     */
+    wrap(key: string, delegate: () => Promise<U>, ttlInSeconds?: number): Promise<U>;
 }
 
 export { PromiseCache };

package/dist/index.d.ts

@@ -1,8 +1,26 @@
 declare class PromiseCache<T, U> {
     private cache;
+    private readonly caseSensitive;
     private readonly ttl;
-    constructor(ttlInSeconds: number);
-    wrap(key: T, delegate: () => Promise<U>): Promise<U>;
+    /**
+     * Initialize a new PromiseCache.
+     * @param ttlInSeconds Default cache TTL.
+     * @param caseSensitive Set to true if you want to differentiate between keys with different casing.
+     */
+    constructor(ttlInSeconds: number, caseSensitive?: boolean);
+    /**
+     * Cache size.
+     * @returns The number of entries in the cache.
+     */
+    size(): number;
+    /**
+     * A simple promise cache wrapper.
+     * @param key Cache key.
+     * @param delegate The function to execute if the key is not in the cache.
+     * @param ttlInSeconds Time to live in seconds.
+     * @returns The result of the delegate function.
+     */
+    wrap(key: string, delegate: () => Promise<U>, ttlInSeconds?: number): Promise<U>;
 }
 
 export { PromiseCache };

package/dist/index.js

@@ -27,20 +27,55 @@ module.exports = __toCommonJS(src_exports);
 // src/promiseCache.ts
 var PromiseCache = class {
   cache;
+  caseSensitive;
   ttl;
-  // Time to live in milliseconds
-  constructor(ttlInSeconds) {
+  // Time to live in milliseconds.
+  /**
+   * Initialize a new PromiseCache.
+   * @param ttlInSeconds Default cache TTL.
+   * @param caseSensitive Set to true if you want to differentiate between keys with different casing.
+   */
+  constructor(ttlInSeconds, caseSensitive = false) {
     this.cache = /* @__PURE__ */ new Map();
+    this.caseSensitive = caseSensitive;
     this.ttl = ttlInSeconds * 1e3;
   }
-  async wrap(key, delegate) {
+  /**
+   * Cache size.
+   * @returns The number of entries in the cache.
+   */
+  size() {
+    return this.cache.size;
+  }
+  /**
+   * A simple promise cache wrapper.
+   * @param key Cache key.
+   * @param delegate The function to execute if the key is not in the cache.
+   * @param ttlInSeconds Time to live in seconds.
+   * @returns The result of the delegate function.
+   */
+  async wrap(key, delegate, ttlInSeconds) {
     const now = Date.now();
-    const cached = this.cache.get(key);
-    if (cached && now - cached.timestamp < this.ttl) {
+    const effectiveKey = this.caseSensitive ? key : key.toLowerCase();
+    const effectiveTTL = ttlInSeconds !== void 0 ? ttlInSeconds * 1e3 : this.ttl;
+    const cached = this.cache.get(effectiveKey);
+    if (cached) {
+      if (cached.ttl !== effectiveTTL) {
+        console.error(
+          `WARNING: TTL mismatch for key: ${effectiveKey}. It is recommended to use the same TTL for the same key.`
+        );
+      }
       return cached.value;
     }
     const response = await delegate();
-    this.cache.set(key, { value: response, timestamp: now });
+    this.cache.set(effectiveKey, {
+      value: response,
+      timestamp: now,
+      ttl: effectiveTTL
+    });
+    setTimeout(() => {
+      this.cache.delete(effectiveKey);
+    }, effectiveTTL);
     return response;
   }
 };

package/dist/index.mjs

@@ -1,20 +1,55 @@
 // src/promiseCache.ts
 var PromiseCache = class {
   cache;
+  caseSensitive;
   ttl;
-  // Time to live in milliseconds
-  constructor(ttlInSeconds) {
+  // Time to live in milliseconds.
+  /**
+   * Initialize a new PromiseCache.
+   * @param ttlInSeconds Default cache TTL.
+   * @param caseSensitive Set to true if you want to differentiate between keys with different casing.
+   */
+  constructor(ttlInSeconds, caseSensitive = false) {
     this.cache = /* @__PURE__ */ new Map();
+    this.caseSensitive = caseSensitive;
     this.ttl = ttlInSeconds * 1e3;
   }
-  async wrap(key, delegate) {
+  /**
+   * Cache size.
+   * @returns The number of entries in the cache.
+   */
+  size() {
+    return this.cache.size;
+  }
+  /**
+   * A simple promise cache wrapper.
+   * @param key Cache key.
+   * @param delegate The function to execute if the key is not in the cache.
+   * @param ttlInSeconds Time to live in seconds.
+   * @returns The result of the delegate function.
+   */
+  async wrap(key, delegate, ttlInSeconds) {
     const now = Date.now();
-    const cached = this.cache.get(key);
-    if (cached && now - cached.timestamp < this.ttl) {
+    const effectiveKey = this.caseSensitive ? key : key.toLowerCase();
+    const effectiveTTL = ttlInSeconds !== void 0 ? ttlInSeconds * 1e3 : this.ttl;
+    const cached = this.cache.get(effectiveKey);
+    if (cached) {
+      if (cached.ttl !== effectiveTTL) {
+        console.error(
+          `WARNING: TTL mismatch for key: ${effectiveKey}. It is recommended to use the same TTL for the same key.`
+        );
+      }
       return cached.value;
     }
     const response = await delegate();
-    this.cache.set(key, { value: response, timestamp: now });
+    this.cache.set(effectiveKey, {
+      value: response,
+      timestamp: now,
+      ttl: effectiveTTL
+    });
+    setTimeout(() => {
+      this.cache.delete(effectiveKey);
+    }, effectiveTTL);
     return response;
   }
 };

package/package.json

@@ -1,13 +1,11 @@
 {
   "name": "@sebspark/promise-cache",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "license": "Apache-2.0",
   "main": "dist/index.js",
   "module": "dist/index.mjs",
   "types": "dist/index.d.ts",
-  "files": [
-    "dist"
-  ],
+  "files": ["dist"],
   "scripts": {
     "build": "tsup-node src/index.ts --format esm,cjs --dts",
     "dev": "tsc --watch --noEmit",
@@ -18,4 +16,4 @@
   "devDependencies": {
     "tsconfig": "*"
   }
-}
+}