valkyries 0.1.0

package/dist/bloom-filter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-filter.d.mts","sourceRoot":"","sources":["../bloom-filter.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAgB5D,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,EAAE,sBAAsB,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAE/F,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,IAAI,CAAS;IACrB,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,MAAM,CAAc;gBAEhB,OAAO,EAAE,wBAAwB;IA0B7C;;;;OAIG;IACH,MAAM,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAI7C;;;;OAIG;IACH,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAIrD;;;;OAIG;IACH,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,GAAG,IAAI,CAAC;IAItE;;;OAGG;IACH,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAC;IAI9E;;;;;;;;;;;;OAYG;IACH,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAInC;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhD;;;;OAIG;IACG,SAAS,CAAC,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAIhE;;;OAGG;IACG,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAI7C;;;;OAIG;IACG,iBAAiB,CACrB,OAAO,EAAE,aAAa,CAAC,MAAM,EAAE,CAAC,EAChC,gBAAgB,CAAC,EAAE,MAAM,GACxB,OAAO,CAAC,IAAI,CAAC;IAIV,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvB,wBAAwB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAIvE,SAAS,IAAI,OAAO,CAAC,OAAO,CAAC;IAI7B,OAAO,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAI3C,MAAM,IAAI,MAAM;IAIhB,cAAc,IAAI,MAAM;IAIxB,SAAS;;;;;;;;IAWH,YAAY,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIpD,OAAO,CAAC,KAAK;CAYd"}

package/dist/bloom-filter.mjs

@@ -0,0 +1,154 @@
+import assert from "node:assert";
+import { cacheValkeyClient } from "./clients.mjs";
+import { deleteBloomFilter, deleteWithAdditionalKeys, ensureExists, isReady, keyExists, rebuild, rebuildFromStream, } from "./bloom-filter/rebuilds.mjs";
+import { exists, existsIfReady, mexists, mexistsIfReady } from "./bloom-filter/lookups.mjs";
+import { add, addOrThrow, addStream } from "./bloom-filter/writes.mjs";
+export { LUA_UNPACK_BATCH_SIZE } from "./bloom-filter/scripts.mjs";
+export { isBloomMissingKeyError, normalizeBloomCheckResult } from "./bloom-filter/results.mjs";
+export class ValkeyBloomFilter {
+    name;
+    capacity;
+    errorRate;
+    expansionRate;
+    batchSize;
+    liveKey;
+    buildingKey;
+    client;
+    constructor(options) {
+        const { name, capacity, errorRate, expansionRate = 2, batchSize = 10_000, client = cacheValkeyClient, } = options;
+        assert(name && typeof name === "string", "name must be a non-empty string");
+        assert(capacity > 0, "capacity must be positive");
+        assert(errorRate > 0 && errorRate < 1, "errorRate must be between 0 and 1");
+        assert(expansionRate > 0, "expansionRate must be positive");
+        assert(batchSize > 0, "batchSize must be positive");
+        this.name = name;
+        this.capacity = capacity;
+        this.errorRate = errorRate;
+        this.expansionRate = expansionRate;
+        this.batchSize = batchSize;
+        this.liveKey = `bloom-filter:${name}`;
+        this.buildingKey = `bloom-filter:${name}:building`;
+        this.client = client;
+    }
+    /**
+     * BF.EXISTS — check if a single item may be in the filter.
+     * Returns null if filter doesn't exist (caller should fall back to DB).
+     * Single roundtrip via Lua script (EXISTS + BF.EXISTS combined).
+     */
+    exists(item) {
+        return exists(this.state(), item);
+    }
+    /**
+     * BF.MEXISTS — check multiple items in the filter.
+     * Returns null per-item if filter doesn't exist (caller should fall back to DB).
+     * Single roundtrip via Lua script (EXISTS + BF.MEXISTS combined).
+     */
+    mexists(items) {
+        return mexists(this.state(), items);
+    }
+    /**
+     * BF.EXISTS guarded by a deterministic readiness key.
+     * Returns null when the ready marker or filter is absent, so callers fall back
+     * to their authoritative store instead of trusting an empty/partial filter.
+     */
+    existsIfReady(readyKey, item) {
+        return existsIfReady(this.state(), readyKey, item);
+    }
+    /**
+     * BF.MEXISTS guarded by a deterministic readiness key.
+     * Returns null per item when the ready marker or filter is absent.
+     */
+    mexistsIfReady(readyKey, items) {
+        return mexistsIfReady(this.state(), readyKey, items);
+    }
+    /**
+     * Add items to bloom filter using BF.MADD. Returns a Promise that resolves when all
+     * batches are written (errors are logged via onError, not thrown).
+     * Items are chunked at batchSize to avoid hitting Valkey argument-count limits.
+     * Each chunk is a single Lua round-trip that also writes to buildingKey if an
+     * active rebuild is in progress, so entries are not silently dropped when
+     * rebuildFromStream renames buildingKey → liveKey.
+     *
+     * If neither the live key nor the building key exists (e.g. during the window
+     * between worker startup and backfill completion), add() is a no-op. This prevents
+     * BF.MADD from auto-creating an under-provisioned filter that would cause false
+     * negatives in cache reads. See backfill-bloom-filter.mts for the warmup design.
+     */
+    add(items) {
+        return add(this.state(), items);
+    }
+    /**
+     * Add items to bloom filter — same as add(), but throws on error instead of absorbing via onError.
+     * Use when the caller needs to detect failures and take corrective action (e.g. clearing readiness).
+     */
+    async addOrThrow(items) {
+        await addOrThrow(this.state(), items);
+    }
+    /**
+     * Awaitable add — streams batches from an AsyncIterable and BF.MADDs each batch.
+     * Use for large-dataset population to avoid loading everything into memory.
+     * Unlike add(), errors are propagated (not absorbed via onError).
+     */
+    async addStream(batches) {
+        await addStream(this.state(), batches);
+    }
+    /**
+     * Rebuild the filter from a complete item list. Uses building key and atomic rename.
+     * Only deletes the building key at start (not the live key).
+     */
+    async rebuild(items) {
+        await rebuild(this.state(), items);
+    }
+    /**
+     * Rebuild the filter from an async iterable of item batches. Uses building key and atomic rename.
+     * Only deletes the building key at start (not the live key).
+     * @param capacityOverride - Optional capacity for this rebuild, such as 2x the current row count.
+     */
+    async rebuildFromStream(batches, capacityOverride) {
+        await rebuildFromStream(this.state(), batches, capacityOverride);
+    }
+    async delete() {
+        await deleteBloomFilter(this.state());
+    }
+    async deleteWithAdditionalKeys(additionalKeys) {
+        await deleteWithAdditionalKeys(this.state(), additionalKeys);
+    }
+    keyExists() {
+        return keyExists(this.state());
+    }
+    isReady(readyKey) {
+        return isReady(this.state(), readyKey);
+    }
+    getKey() {
+        return this.liveKey;
+    }
+    getBuildingKey() {
+        return this.buildingKey;
+    }
+    getConfig() {
+        return {
+            name: this.name,
+            capacity: this.capacity,
+            errorRate: this.errorRate,
+            batchSize: this.batchSize,
+            liveKey: this.liveKey,
+            buildingKey: this.buildingKey,
+        };
+    }
+    async ensureExists(capacity) {
+        await ensureExists(this.state(), capacity);
+    }
+    state() {
+        return {
+            name: this.name,
+            capacity: this.capacity,
+            errorRate: this.errorRate,
+            expansionRate: this.expansionRate,
+            batchSize: this.batchSize,
+            liveKey: this.liveKey,
+            buildingKey: this.buildingKey,
+            client: this.client,
+        };
+    }
+}
+//# sourceMappingURL=bloom-filter.mjs.map

package/dist/bloom-filter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"bloom-filter.mjs","sourceRoot":"","sources":["../bloom-filter.mts"],"names":[],"mappings":"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"}

package/dist/cache/batch-read.d.mts

@@ -0,0 +1,7 @@
+import { ValkeyCacheSingleRead } from "./single-read.mts";
+export declare abstract class ValkeyCacheBatchRead<K = string> extends ValkeyCacheSingleRead<K> {
+    cacheGetByAnyBatch<T>(batchFn: (keys: K[]) => Promise<Array<T | null | undefined>>): (keys: K[]) => Promise<Array<T | null>>;
+    getBatch(keys: K[]): Promise<Array<string | Buffer | Record<string, unknown> | null>>;
+    private trackBatchRead;
+}
+//# sourceMappingURL=batch-read.d.mts.map

package/dist/cache/batch-read.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-read.d.mts","sourceRoot":"","sources":["../../cache/batch-read.mts"],"names":[],"mappings":"AAGA,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAW1D,8BAAsB,oBAAoB,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,qBAAqB,CAAC,CAAC,CAAC;IACrF,kBAAkB,CAAC,CAAC,EAClB,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,CAAC,GAC3D,CAAC,IAAI,EAAE,CAAC,EAAE,KAAK,OAAO,CAAC,KAAK,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;IAmDpC,QAAQ,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,KAAK,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC,CAAC;IAuC3F,OAAO,CAAC,cAAc;CAWvB"}

package/dist/cache/batch-read.mjs

@@ -0,0 +1,142 @@
+import { durationInMilliseconds } from "../cache-utils.mjs";
+import { trackCacheCall } from "../cache-metrics.mjs";
+import { handleValkeyError } from "../errors.mjs";
+import { ValkeyCacheSingleRead } from "./single-read.mjs";
+class BatchReadStats {
+    hits = 0;
+    misses = 0;
+    bloomMisses = 0;
+    hitKeys = [];
+    missKeys = [];
+    bloomMissKeys = [];
+}
+export class ValkeyCacheBatchRead extends ValkeyCacheSingleRead {
+    cacheGetByAnyBatch(batchFn) {
+        return async (keys) => {
+            const { validKeys: normalizedKeys, serializedKeys, outputIndices, } = this.deduplicateKeys(keys);
+            if (normalizedKeys.length === 0) {
+                trackCacheCall({
+                    cacheName: this.prefix,
+                    batch: true,
+                    hits: 0,
+                    misses: 0,
+                    bloomMisses: 0,
+                    duration: 0,
+                });
+                return Array(keys.length).fill(null);
+            }
+            const scatter = (normalized) => outputIndices.map((idx) => (idx === -1 ? null : normalized[idx]));
+            const stats = new BatchReadStats();
+            const start = process.hrtime.bigint();
+            try {
+                const cachedEntries = await this.getValuesWithTtl(serializedKeys);
+                const cachedValues = cachedEntries.map((entry) => entry.value);
+                const missing = collectMissingKeys(cachedEntries, normalizedKeys, serializedKeys, cachedValues, stats);
+                stats.misses = missing.keys.length;
+                stats.hits = normalizedKeys.length - stats.misses - stats.bloomMisses;
+                this.refreshStaleBatchEntries(serializedKeys, normalizedKeys, cachedEntries, batchFn);
+                if (missing.keys.length === 0)
+                    return scatter(cachedValues);
+                const fetchedResults = await batchFn(missing.keys);
+                assertBatchResultLength(fetchedResults, missing.keys.length);
+                const results = mergeFetchedResults(cachedValues, missing.indices, fetchedResults);
+                const setEntries = missing.keys.map((key, i) => {
+                    const value = fetchedResults[i] ?? null;
+                    return { key, value, ttl: value === null ? this.nullTtl : undefined };
+                });
+                this.setBatchIfNotInvalidated(setEntries).catch(handleValkeyError);
+                return scatter(results);
+            }
+            finally {
+                this.trackBatchRead(start, stats);
+            }
+        };
+    }
+    async getBatch(keys) {
+        const { serializedKeys, outputIndices } = this.deduplicateKeys(keys);
+        if (serializedKeys.length === 0) {
+            trackCacheCall({
+                cacheName: this.prefix,
+                batch: true,
+                hits: 0,
+                misses: 0,
+                bloomMisses: 0,
+                duration: 0,
+            });
+            return Array(keys.length).fill(null);
+        }
+        const stats = new BatchReadStats();
+        const start = process.hrtime.bigint();
+        try {
+            const entries = await this.getValuesWithTtl(serializedKeys);
+            const values = entries.map((entry, i) => {
+                if (entry.bloomMiss) {
+                    stats.bloomMisses++;
+                    stats.bloomMissKeys.push(serializedKeys[i]);
+                    return null;
+                }
+                const keyExists = entry.ttlSecondsRemaining !== null && entry.ttlSecondsRemaining !== -2;
+                if (entry.value !== null || keyExists) {
+                    stats.hits++;
+                    stats.hitKeys.push(serializedKeys[i]);
+                }
+                else {
+                    stats.misses++;
+                    stats.missKeys.push(serializedKeys[i]);
+                }
+                return entry.value;
+            });
+            return outputIndices.map((idx) => (idx === -1 ? null : values[idx]));
+        }
+        finally {
+            this.trackBatchRead(start, stats);
+        }
+    }
+    trackBatchRead(start, stats) {
+        trackCacheCall({
+            cacheName: this.prefix,
+            batch: true,
+            hits: stats.hits,
+            misses: stats.misses,
+            bloomMisses: stats.bloomMisses,
+            duration: durationInMilliseconds(start),
+        });
+        this.emitCacheEvents(stats.hitKeys, stats.missKeys, stats.bloomMissKeys);
+    }
+}
+function collectMissingKeys(entries, normalizedKeys, serializedKeys, cachedValues, stats) {
+    const indices = [];
+    const keys = [];
+    for (let i = 0; i < cachedValues.length; i++) {
+        const entry = entries[i];
+        if (entry.bloomMiss) {
+            stats.bloomMisses++;
+            stats.bloomMissKeys.push(serializedKeys[i]);
+            cachedValues[i] = null;
+            continue;
+        }
+        const keyExists = entry.ttlSecondsRemaining !== null && entry.ttlSecondsRemaining !== -2;
+        if (entry.value === null && !keyExists) {
+            indices.push(i);
+            keys.push(normalizedKeys[i]);
+            stats.missKeys.push(serializedKeys[i]);
+        }
+        else {
+            stats.hitKeys.push(serializedKeys[i]);
+        }
+    }
+    return { indices, keys };
+}
+function assertBatchResultLength(results, expectedLength) {
+    if (!Array.isArray(results) || results.length !== expectedLength) {
+        throw new Error(`Batch function returned invalid result: expected array of ${expectedLength} items, got ${Array.isArray(results) ? results.length : typeof results}`);
+    }
+}
+function mergeFetchedResults(cachedValues, missingIndices, fetchedResults) {
+    const results = [...cachedValues];
+    for (let i = 0; i < missingIndices.length; i++) {
+        results[missingIndices[i]] = fetchedResults[i] ?? null;
+    }
+    return results;
+}
+//# sourceMappingURL=batch-read.mjs.map

package/dist/cache/batch-read.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"batch-read.mjs","sourceRoot":"","sources":["../../cache/batch-read.mts"],"names":[],"mappings":"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"}

package/dist/cache/constants.d.mts

@@ -0,0 +1,7 @@
+export declare const CACHE_NAMESPACE = "cache";
+export declare const INVALIDATION_MARKER_TTL_SECONDS = 60;
+export declare const getValueWithTtlScript: import("@valkey/valkey-glide").Script;
+export declare const getValuesWithTtlScript: import("@valkey/valkey-glide").Script;
+export declare const cacheSetIfNotInvalidatedScript: import("@valkey/valkey-glide").Script;
+export declare const cacheDeleteWithInvalidationScript: import("@valkey/valkey-glide").Script;
+//# sourceMappingURL=constants.d.mts.map

package/dist/cache/constants.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.mts","sourceRoot":"","sources":["../../cache/constants.mts"],"names":[],"mappings":"AAEA,eAAO,MAAM,eAAe,UAAU,CAAC;AACvC,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAElD,eAAO,MAAM,qBAAqB,uCAEjC,CAAC;AACF,eAAO,MAAM,sBAAsB,uCAElC,CAAC;AACF,eAAO,MAAM,8BAA8B,uCAE1C,CAAC;AACF,eAAO,MAAM,iCAAiC,uCAE7C,CAAC"}

package/dist/cache/constants.mjs

@@ -0,0 +1,8 @@
+import { loadScript, registerScript } from "../scripts.mjs";
+export const CACHE_NAMESPACE = "cache";
+export const INVALIDATION_MARKER_TTL_SECONDS = 60;
+export const getValueWithTtlScript = registerScript(loadScript("get-value-with-ttl.lua", new URL("../", import.meta.url)));
+export const getValuesWithTtlScript = registerScript(loadScript("get-values-with-ttl.lua", new URL("../", import.meta.url)));
+export const cacheSetIfNotInvalidatedScript = registerScript(loadScript("cache-set-if-not-invalidated.lua", new URL("../", import.meta.url)));
+export const cacheDeleteWithInvalidationScript = registerScript(loadScript("cache-delete-with-invalidation.lua", new URL("../", import.meta.url)));
+//# sourceMappingURL=constants.mjs.map

package/dist/cache/constants.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.mjs","sourceRoot":"","sources":["../../cache/constants.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAE5D,MAAM,CAAC,MAAM,eAAe,GAAG,OAAO,CAAC;AACvC,MAAM,CAAC,MAAM,+BAA+B,GAAG,EAAE,CAAC;AAElD,MAAM,CAAC,MAAM,qBAAqB,GAAG,cAAc,CACjD,UAAU,CAAC,wBAAwB,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACtE,CAAC;AACF,MAAM,CAAC,MAAM,sBAAsB,GAAG,cAAc,CAClD,UAAU,CAAC,yBAAyB,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CACvE,CAAC;AACF,MAAM,CAAC,MAAM,8BAA8B,GAAG,cAAc,CAC1D,UAAU,CAAC,kCAAkC,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAChF,CAAC;AACF,MAAM,CAAC,MAAM,iCAAiC,GAAG,cAAc,CAC7D,UAAU,CAAC,oCAAoC,EAAE,IAAI,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAClF,CAAC"}

package/dist/cache/core.d.mts

@@ -0,0 +1,38 @@
+import type { ValkeyCacheMode, ValkeyCacheOptions } from "../types.mts";
+import { type GlideClient, type GlideString } from "@valkey/valkey-glide";
+import type { ValkeyBloomFilter } from "../bloom-filter.mts";
+export type CacheEntry = {
+    value: string | Buffer | Record<string, unknown> | null;
+    ttlSecondsRemaining: number | null;
+    bloomMiss: boolean;
+};
+export declare abstract class ValkeyCacheCore<K = string> {
+    prefix: string;
+    ttl: number;
+    nullTtl: number;
+    mode: ValkeyCacheMode;
+    staleTtlAge: number;
+    protected bloomFilter?: ValkeyBloomFilter;
+    protected bloomFilterEnabled?: () => boolean;
+    protected refreshPromises: Map<string, Promise<void>>;
+    protected keySerializer: (key: K) => string;
+    protected client: GlideClient;
+    constructor({ prefix, ttlSeconds, nullTtlSeconds, mode, staleTtlAge, bloomFilter, bloomFilterEnabled, keySerializer, client, }: ValkeyCacheOptions<K>);
+    protected emitCacheEvents(hitKeys: string[], missKeys: string[], bloomMissKeys: string[]): void;
+    protected deduplicateKeys(keys: K[]): {
+        validKeys: K[];
+        serializedKeys: string[];
+        outputIndices: number[];
+    };
+    protected toSerializedKey(key: K): string | null;
+    protected getSerializedCacheKey(serializedKey: string): string;
+    protected getSerializedInvalidationKey(serializedKey: string): string;
+    protected getValueWithTtl(serializedKey: string): Promise<CacheEntry>;
+    protected getValuesWithTtl(serializedKeys: string[]): Promise<CacheEntry[]>;
+    protected shouldRefreshTtl(ttlSecondsRemaining: number | null): boolean;
+    protected decode(serializedKey: string, result: GlideString | null): Promise<string | Buffer | Record<string, unknown> | null>;
+    protected serializeValue(value: unknown): Promise<string | Buffer>;
+    protected abstract deleteBySerializedKey(...serializedKeys: string[]): Promise<number>;
+    private decodeCacheEntry;
+}
+//# sourceMappingURL=core.d.mts.map

package/dist/cache/core.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"core.d.mts","sourceRoot":"","sources":["../../cache/core.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC;AAGxE,OAAO,EAAW,KAAK,WAAW,EAAE,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKnF,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAG7D,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;IACxD,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,SAAS,EAAE,OAAO,CAAC;CACpB,CAAC;AAEF,8BAAsB,eAAe,CAAC,CAAC,GAAG,MAAM;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,eAAe,CAAC;IACtB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAC1C,SAAS,CAAC,kBAAkB,CAAC,EAAE,MAAM,OAAO,CAAC;IAC7C,SAAS,CAAC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IACtD,SAAS,CAAC,aAAa,EAAE,CAAC,GAAG,EAAE,CAAC,KAAK,MAAM,CAAC;IAC5C,SAAS,CAAC,MAAM,EAAE,WAAW,CAAC;gBAElB,EACV,MAAM,EACN,UAAU,EACV,cAAc,EACd,IAAa,EACb,WAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,aAAa,EACb,MAA0B,GAC3B,EAAE,kBAAkB,CAAC,CAAC,CAAC;IAmBxB,SAAS,CAAC,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,EAAE,aAAa,EAAE,MAAM,EAAE;IAqBxF,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,EAAE,GAAG;QACpC,SAAS,EAAE,CAAC,EAAE,CAAC;QACf,cAAc,EAAE,MAAM,EAAE,CAAC;QACzB,aAAa,EAAE,MAAM,EAAE,CAAC;KACzB;IAyBD,SAAS,CAAC,eAAe,CAAC,GAAG,EAAE,CAAC,GAAG,MAAM,GAAG,IAAI;IAMhD,SAAS,CAAC,qBAAqB,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;IAI9D,SAAS,CAAC,4BAA4B,CAAC,aAAa,EAAE,MAAM,GAAG,MAAM;cAIrD,eAAe,CAAC,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;cAmB3D,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAgBjF,SAAS,CAAC,gBAAgB,CAAC,mBAAmB,EAAE,MAAM,GAAG,IAAI;cAO7C,MAAM,CACpB,aAAa,EAAE,MAAM,EACrB,MAAM,EAAE,WAAW,GAAG,IAAI,GACzB,OAAO,CAAC,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,CAAC;cAkB5C,cAAc,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,MAAM,CAAC;IAGxE,SAAS,CAAC,QAAQ,CAAC,qBAAqB,CAAC,GAAG,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;YACxE,gBAAgB;CAgB/B"}

package/dist/cache/core.mjs

@@ -0,0 +1,171 @@
+import { cacheValkeyClient } from "../clients.mjs";
+import { emitValkeyEvent } from "../events.mjs";
+import { Decoder } from "@valkey/valkey-glide";
+import { normalizeKey } from "../key-normalization.mjs";
+import { handleValkeyError } from "../errors.mjs";
+import { normalizeTtlResult } from "../utils.mjs";
+import { decodeValue, serializeValue } from "../cache-utils.mjs";
+import { CACHE_NAMESPACE, getValuesWithTtlScript, getValueWithTtlScript } from "./constants.mjs";
+export class ValkeyCacheCore {
+    prefix;
+    ttl;
+    nullTtl;
+    mode;
+    staleTtlAge;
+    bloomFilter;
+    bloomFilterEnabled;
+    refreshPromises;
+    keySerializer;
+    client;
+    constructor({ prefix, ttlSeconds, nullTtlSeconds, mode = "json", staleTtlAge = 0.9, bloomFilter, bloomFilterEnabled, keySerializer, client = cacheValkeyClient, }) {
+        if (!prefix)
+            throw new Error("ValkeyCache requires a prefix");
+        if (!(ttlSeconds > 0))
+            throw new Error("ValkeyCache: ttlSeconds must be greater than 0");
+        this.prefix = prefix;
+        this.ttl = ttlSeconds;
+        this.nullTtl = nullTtlSeconds ?? Math.max(1, Math.floor(ttlSeconds / 60));
+        this.mode = mode;
+        if (Number.isNaN(staleTtlAge) || staleTtlAge < 0 || staleTtlAge > 1) {
+            throw new Error("ValkeyCache: staleTtlAge must be between 0 and 1");
+        }
+        this.staleTtlAge = staleTtlAge;
+        this.bloomFilter = bloomFilter;
+        this.bloomFilterEnabled = bloomFilterEnabled;
+        this.refreshPromises = new Map();
+        this.keySerializer =
+            keySerializer ?? ((key) => String(key));
+        this.client = client;
+    }
+    emitCacheEvents(hitKeys, missKeys, bloomMissKeys) {
+        if (hitKeys.length > 0)
+            emitValkeyEvent("cache:hit", {
+                cacheName: this.prefix,
+                keys: hitKeys,
+                count: hitKeys.length,
+            });
+        if (missKeys.length > 0)
+            emitValkeyEvent("cache:miss", {
+                cacheName: this.prefix,
+                keys: missKeys,
+                count: missKeys.length,
+            });
+        if (bloomMissKeys.length > 0)
+            emitValkeyEvent("cache:bloom-miss", {
+                cacheName: this.prefix,
+                keys: bloomMissKeys,
+                count: bloomMissKeys.length,
+            });
+    }
+    deduplicateKeys(keys) {
+        const validKeys = [];
+        const serializedKeys = [];
+        const outputIndices = [];
+        const seen = new Map();
+        for (let i = 0; i < keys.length; i++) {
+            const serialized = this.toSerializedKey(keys[i]);
+            if (serialized === null) {
+                outputIndices.push(-1);
+                continue;
+            }
+            const existing = seen.get(serialized);
+            if (existing !== undefined) {
+                outputIndices.push(existing);
+            }
+            else {
+                const idx = validKeys.length;
+                seen.set(serialized, idx);
+                validKeys.push(keys[i]);
+                serializedKeys.push(serialized);
+                outputIndices.push(idx);
+            }
+        }
+        return { validKeys, serializedKeys, outputIndices };
+    }
+    toSerializedKey(key) {
+        if (key == null)
+            return null;
+        const serialized = normalizeKey(this.keySerializer(key));
+        return serialized === "" ? null : serialized;
+    }
+    getSerializedCacheKey(serializedKey) {
+        return `${CACHE_NAMESPACE}:${this.prefix}:{${serializedKey}}`;
+    }
+    getSerializedInvalidationKey(serializedKey) {
+        return `${CACHE_NAMESPACE}:${this.prefix}:invalidation:{${serializedKey}}`;
+    }
+    async getValueWithTtl(serializedKey) {
+        const cacheKey = this.getSerializedCacheKey(serializedKey);
+        const bloomEnabled = this.bloomFilterEnabled?.() ?? true;
+        const bloomFilterKey = bloomEnabled ? (this.bloomFilter?.getKey() ?? "") : "";
+        const scriptResult = await this.client.invokeScript(getValueWithTtlScript, {
+            keys: [cacheKey],
+            args: [bloomFilterKey],
+            decoder: Decoder.Bytes,
+        });
+        const valueRaw = Array.isArray(scriptResult) ? scriptResult[0] : null;
+        const ttlSecondsRemaining = Array.isArray(scriptResult)
+            ? normalizeTtlResult(scriptResult[1])
+            : null;
+        const bloomMiss = Number(Array.isArray(scriptResult) ? (scriptResult[2] ?? 0) : 0);
+        if (bloomMiss === 1)
+            return { value: null, ttlSecondsRemaining: null, bloomMiss: true };
+        const value = await this.decode(serializedKey, valueRaw);
+        return { value, ttlSecondsRemaining: ttlSecondsRemaining ?? null, bloomMiss: false };
+    }
+    async getValuesWithTtl(serializedKeys) {
+        if (serializedKeys.length === 0)
+            return [];
+        const cacheKeys = serializedKeys.map((k) => this.getSerializedCacheKey(k));
+        const bloomEnabled = this.bloomFilterEnabled?.() ?? true;
+        const bloomFilterKey = bloomEnabled ? (this.bloomFilter?.getKey() ?? "") : "";
+        const scriptResult = await this.client.invokeScript(getValuesWithTtlScript, {
+            keys: cacheKeys,
+            args: [bloomFilterKey],
+            decoder: Decoder.Bytes,
+        });
+        const rawResults = Array.isArray(scriptResult) ? scriptResult : [];
+        return Promise.all(serializedKeys.map((key, index) => this.decodeCacheEntry(key, rawResults, index)));
+    }
+    shouldRefreshTtl(ttlSecondsRemaining) {
+        if (typeof ttlSecondsRemaining !== "number")
+            return false;
+        if (ttlSecondsRemaining < 0)
+            return false;
+        const refreshWindow = (1 - this.staleTtlAge) * this.ttl;
+        return refreshWindow > 0 && ttlSecondsRemaining < refreshWindow;
+    }
+    async decode(serializedKey, result) {
+        try {
+            return await decodeValue(result, this.mode);
+        }
+        catch (cause) {
+            if (process.env.NODE_ENV === "test")
+                throw cause;
+            const isJsonError = cause instanceof SyntaxError;
+            const err = new Error(isJsonError
+                ? "ValkeyCache: failed to parse JSON value"
+                : "ValkeyCache: failed to gunzip value", { cause });
+            handleValkeyError(err);
+            this.deleteBySerializedKey(serializedKey).catch(handleValkeyError);
+            return null;
+        }
+    }
+    async serializeValue(value) {
+        return await serializeValue(value, this.mode);
+    }
+    async decodeCacheEntry(key, rawResults, index) {
+        const offset = index * 3;
+        const bloomMiss = Number(rawResults[offset + 2] ?? 0) === 1;
+        if (bloomMiss)
+            return { value: null, ttlSecondsRemaining: null, bloomMiss: true };
+        const rawValue = rawResults[offset];
+        const value = await this.decode(key, rawValue);
+        return {
+            value,
+            ttlSecondsRemaining: normalizeTtlResult(rawResults[offset + 1]),
+            bloomMiss: false,
+        };
+    }
+}
+//# sourceMappingURL=core.mjs.map

package/dist/cache/core.mjs.map

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

package/dist/cache/deletes.d.mts

@@ -0,0 +1,8 @@
+import { ValkeyCacheMutations } from "./mutations.mts";
+export declare class ValkeyCacheDeletes<K = string> extends ValkeyCacheMutations<K> {
+    delete(...keys: K[]): Promise<number>;
+    protected deleteBySerializedKey(...serializedKeys: string[]): Promise<number>;
+    invalidate(): Promise<void>;
+    static invalidate(prefix: string, client?: import("@valkey/valkey-glide").GlideClient): Promise<void>;
+}
+//# sourceMappingURL=deletes.d.mts.map

package/dist/cache/deletes.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"deletes.d.mts","sourceRoot":"","sources":["../../cache/deletes.mts"],"names":[],"mappings":"AASA,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,qBAAa,kBAAkB,CAAC,CAAC,GAAG,MAAM,CAAE,SAAQ,oBAAoB,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,IAAI,EAAE,CAAC,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;cAmB3B,qBAAqB,CAAC,GAAG,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAQnF,UAAU;WAIG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,6CAAoB;CAOnE"}