@markwharton/liquidplanner 1.8.1 → 1.8.2

package/dist/cache.d.ts

@@ -1,19 +1,27 @@
 /**
- * Simple in-memory TTL cache
+ * Simple in-memory TTL cache with request coalescing
  *
  * Provides per-instance memoization for LPClient API responses.
  * In serverless environments (Azure Functions, Static Web Apps),
  * module-level state persists across warm invocations within the
  * same instance — this cache leverages that behavior.
  *
+ * Request coalescing: when multiple concurrent callers request the
+ * same expired key, only one factory call is made. All callers
+ * receive the same resolved value (or the same rejection).
+ *
  * Not a distributed cache: each instance has its own cache.
  * Cold starts and instance recycling naturally clear stale data.
  */
 export declare class TTLCache {
     private store;
+    private inflight;
     /**
      * Get a cached value, or call the factory to populate it.
      *
+     * If a factory call is already in progress for this key,
+     * returns the existing promise instead of starting a duplicate.
+     *
      * @param key - Cache key
      * @param ttlMs - Time-to-live in milliseconds
      * @param factory - Async function to produce the value on cache miss
@@ -22,11 +30,14 @@ export declare class TTLCache {
     /**
      * Invalidate cache entries matching a key prefix.
      *
+     * Also cancels any in-flight requests for matching keys,
+     * so subsequent calls will start fresh factory invocations.
+     *
      * Example: invalidate('timesheet:') clears all timesheet entries.
      */
     invalidate(prefix: string): void;
     /**
-     * Clear all cached data.
+     * Clear all cached data and in-flight requests.
      */
     clear(): void;
 }

package/dist/cache.js

@@ -1,21 +1,29 @@
 /**
- * Simple in-memory TTL cache
+ * Simple in-memory TTL cache with request coalescing
  *
  * Provides per-instance memoization for LPClient API responses.
  * In serverless environments (Azure Functions, Static Web Apps),
  * module-level state persists across warm invocations within the
  * same instance — this cache leverages that behavior.
  *
+ * Request coalescing: when multiple concurrent callers request the
+ * same expired key, only one factory call is made. All callers
+ * receive the same resolved value (or the same rejection).
+ *
  * Not a distributed cache: each instance has its own cache.
  * Cold starts and instance recycling naturally clear stale data.
  */
 export class TTLCache {
     constructor() {
         this.store = new Map();
+        this.inflight = new Map();
     }
     /**
      * Get a cached value, or call the factory to populate it.
      *
+     * If a factory call is already in progress for this key,
+     * returns the existing promise instead of starting a duplicate.
+     *
      * @param key - Cache key
      * @param ttlMs - Time-to-live in milliseconds
      * @param factory - Async function to produce the value on cache miss
@@ -25,13 +33,27 @@ export class TTLCache {
         if (existing && existing.expiresAt > Date.now()) {
             return existing.data;
         }
-        const data = await factory();
-        this.store.set(key, { data, expiresAt: Date.now() + ttlMs });
-        return data;
+        const pending = this.inflight.get(key);
+        if (pending) {
+            return pending;
+        }
+        const promise = factory().then((data) => {
+            this.store.set(key, { data, expiresAt: Date.now() + ttlMs });
+            this.inflight.delete(key);
+            return data;
+        }, (err) => {
+            this.inflight.delete(key);
+            throw err;
+        });
+        this.inflight.set(key, promise);
+        return promise;
     }
     /**
      * Invalidate cache entries matching a key prefix.
      *
+     * Also cancels any in-flight requests for matching keys,
+     * so subsequent calls will start fresh factory invocations.
+     *
      * Example: invalidate('timesheet:') clears all timesheet entries.
      */
     invalidate(prefix) {
@@ -40,11 +62,17 @@ export class TTLCache {
                 this.store.delete(key);
             }
         }
+        for (const key of this.inflight.keys()) {
+            if (key.startsWith(prefix)) {
+                this.inflight.delete(key);
+            }
+        }
     }
     /**
-     * Clear all cached data.
+     * Clear all cached data and in-flight requests.
      */
     clear() {
         this.store.clear();
+        this.inflight.clear();
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@markwharton/liquidplanner",
-  "version": "1.8.1",
+  "version": "1.8.2",
   "description": "LiquidPlanner API client for timesheet integration",
   "type": "module",
   "main": "dist/index.js",