@somewhere-cloud/sdk 0.0.0-stage → 0.13.1

package/dist/cjs/query-cache.js

@@ -0,0 +1,91 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QueryCache = void 0;
+const DEFAULT_STALE_TIME_MS = 1000;
+/** Hand back an isolated copy so a caller mutating `.data` can't poison the cache. */
+function cloneResult(r) {
+    return { ...r, data: r.data === null ? null : structuredClone(r.data) };
+}
+class QueryCache {
+    constructor(opts = {}, now = Date.now) {
+        this.entries = new Map();
+        this.inFlight = new Map();
+        /**
+         * Per-table generation counter. Bumped on every invalidate so a fetch that
+         * was already in flight when its table got invalidated does NOT repopulate
+         * the cache with a pre-write value.
+         */
+        this.generations = new Map();
+        this.staleTime = opts.staleTime ?? DEFAULT_STALE_TIME_MS;
+        this.now = now;
+    }
+    /**
+     * Read-through with dedup + staleTime. `run` performs the actual network
+     * fetch and is invoked at most once per in-flight key and generation.
+     * `fresh` bypasses hits and dedup but still fences cache warming on invalidation.
+     */
+    async read(key, table, run, fresh = false) {
+        const hit = this.entries.get(key);
+        if (!fresh && hit && this.now() - hit.storedAt < this.staleTime) {
+            return cloneResult(hit.value);
+        }
+        const flight = this.inFlight.get(key);
+        if (!fresh && flight) {
+            // Dedup: join the in-flight request instead of starting a second one.
+            return cloneResult(await flight.promise);
+        }
+        const gen = this.generations.get(table) ?? 0;
+        this.generations.set(table, gen);
+        const p = (async () => {
+            const result = await run();
+            // Only cache successes, and only if no invalidate landed mid-flight.
+            if (result.error === null && (this.generations.get(table) ?? 0) === gen) {
+                this.entries.set(key, { value: cloneResult(result), storedAt: this.now(), table });
+            }
+            return result;
+        })();
+        if (!fresh)
+            this.inFlight.set(key, { promise: p, table });
+        try {
+            return cloneResult(await p);
+        }
+        finally {
+            if (this.inFlight.get(key)?.promise === p)
+                this.inFlight.delete(key);
+        }
+    }
+    /**
+     * Store a current result directly. Reads that can overlap invalidation
+     * should use `read` so their cache warming is generation-checked.
+     */
+    store(key, table, result) {
+        if (result.error === null) {
+            this.entries.set(key, { value: cloneResult(result), storedAt: this.now(), table });
+        }
+    }
+    /**
+     * Drop every cached read for a table. Called automatically after a write to
+     * that table (read-your-own-writes); also the public event/manual seam.
+     */
+    invalidate(table) {
+        this.generations.set(table, (this.generations.get(table) ?? 0) + 1);
+        for (const [key, entry] of this.entries) {
+            if (entry.table === table)
+                this.entries.delete(key);
+        }
+        for (const [key, flight] of this.inFlight) {
+            if (flight.table === table)
+                this.inFlight.delete(key);
+        }
+    }
+    /** Drop the entire cache and detach pending reads. */
+    clear() {
+        this.entries.clear();
+        this.inFlight.clear();
+        for (const table of this.generations.keys()) {
+            this.generations.set(table, (this.generations.get(table) ?? 0) + 1);
+        }
+    }
+}
+exports.QueryCache = QueryCache;
+//# sourceMappingURL=query-cache.js.map

package/dist/cjs/query-cache.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"query-cache.js","sourceRoot":"","sources":["../../src/query-cache.ts"],"names":[],"mappings":"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"}