valkyries 0.1.0

package/dist/dynamic-config.mjs.map

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

package/dist/errors.d.mts

@@ -0,0 +1,4 @@
+export type ValkeyErrorHandler = (error: Error) => void;
+export declare function setValkeyErrorHandler(handler: ValkeyErrorHandler): void;
+export declare function handleValkeyError(error: unknown): void;
+//# sourceMappingURL=errors.d.mts.map

package/dist/errors.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.mts","sourceRoot":"","sources":["../errors.mts"],"names":[],"mappings":"AAAA,MAAM,MAAM,kBAAkB,GAAG,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;AASxD,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,kBAAkB,GAAG,IAAI,CAEvE;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,GAAG,IAAI,CAGtD"}

package/dist/errors.mjs

@@ -0,0 +1,15 @@
+/* v8 ignore next 4 -- default process-level fallback is replaced in tests and by applications. */
+let valkeyErrorHandler = (error) => {
+    if (process.env.NODE_ENV === "test")
+        return;
+    // oxlint-disable-next-line no-console -- default OSS error handler
+    console.error(error);
+};
+export function setValkeyErrorHandler(handler) {
+    valkeyErrorHandler = handler;
+}
+export function handleValkeyError(error) {
+    const normalized = error instanceof Error ? error : new Error(String(error));
+    valkeyErrorHandler(normalized);
+}
+//# sourceMappingURL=errors.mjs.map

package/dist/errors.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.mjs","sourceRoot":"","sources":["../errors.mts"],"names":[],"mappings":"AAEA,kGAAkG;AAClG,IAAI,kBAAkB,GAAuB,CAAC,KAAK,EAAE,EAAE;IACrD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM;QAAE,OAAO;IAC5C,mEAAmE;IACnE,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;AACvB,CAAC,CAAC;AAEF,MAAM,UAAU,qBAAqB,CAAC,OAA2B;IAC/D,kBAAkB,GAAG,OAAO,CAAC;AAC/B,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC9C,MAAM,UAAU,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;IAC7E,kBAAkB,CAAC,UAAU,CAAC,CAAC;AACjC,CAAC"}

package/dist/events.d.mts

@@ -0,0 +1,84 @@
+import { EventEmitter } from "node:events";
+export interface ValkeyEventMap {
+    "cache:call": [
+        {
+            cacheName: string;
+            batch: boolean;
+            hits: number;
+            misses: number;
+            bloomMisses: number;
+            durationMs: number;
+        }
+    ];
+    "rate-limiter:add": [{
+        prefix: string;
+        ids: string[];
+    }];
+    "rate-limiter:get": [{
+        prefix: string;
+        ids: string[];
+        counts: number[];
+    }];
+    "rate-limiter:delete": [{
+        prefix: string;
+        ids: string[];
+    }];
+    "rate-limiter:invalidate": [{
+        prefix: string;
+    }];
+    "cache:hit": [{
+        cacheName: string;
+        keys: string[];
+        count: number;
+    }];
+    "cache:miss": [{
+        cacheName: string;
+        keys: string[];
+        count: number;
+    }];
+    "cache:bloom-miss": [{
+        cacheName: string;
+        keys: string[];
+        count: number;
+    }];
+    "cache:set": [{
+        cacheName: string;
+        keys: string[];
+    }];
+    "cache:set-skipped": [{
+        cacheName: string;
+        keys: string[];
+    }];
+    "cache:delete": [{
+        cacheName: string;
+        keys: string[];
+    }];
+    "cache:invalidate": [{
+        cacheName: string;
+    }];
+    "bloom-filter:exists": [{
+        name: string;
+        item: string;
+        result: boolean | null;
+    }];
+    "bloom-filter:mexists": [{
+        name: string;
+        items: string[];
+        results: (boolean | null)[];
+    }];
+    /**
+     * Emitted after each write to the filter:
+     * - `add()`: fires once with all items after all internal batches complete (aggregate event)
+     * - `addStream()` and `rebuildFromStream()`: fires once per batch chunk
+     * During a rebuild, items are written to a staging key and not yet visible in the live
+     * filter until the atomic rename completes — do not treat this event as confirmation of
+     * live filter membership.
+     */
+    "bloom-filter:add": [{
+        name: string;
+        items: string[];
+    }];
+}
+export declare const valkeyEvents: EventEmitter<ValkeyEventMap>;
+export declare function emitValkeyEvent<K extends keyof ValkeyEventMap>(event: K, ...args: ValkeyEventMap[K]): void;
+//# sourceMappingURL=events.d.mts.map

package/dist/events.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.mts","sourceRoot":"","sources":["../events.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,MAAM,WAAW,cAAc;IAC7B,YAAY,EAAE;QACZ;YACE,SAAS,EAAE,MAAM,CAAC;YAClB,KAAK,EAAE,OAAO,CAAC;YACf,IAAI,EAAE,MAAM,CAAC;YACb,MAAM,EAAE,MAAM,CAAC;YACf,WAAW,EAAE,MAAM,CAAC;YACpB,UAAU,EAAE,MAAM,CAAC;SACpB;KACF,CAAC;IACF,kBAAkB,EAAE,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAC;QAAC,MAAM,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC1E,qBAAqB,EAAE,CAAC;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC3D,yBAAyB,EAAE,CAAC;QAAE,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAChD,WAAW,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACpE,YAAY,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACrE,kBAAkB,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3E,WAAW,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACrD,mBAAmB,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IAC7D,cAAc,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;IACxD,kBAAkB,EAAE,CAAC;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IAC5C,qBAAqB,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,MAAM,EAAE,OAAO,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;IAChF,sBAAsB,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,CAAC,OAAO,GAAG,IAAI,CAAC,EAAE,CAAA;KAAE,CAAC,CAAC;IACzF;;;;;;;OAOG;IACH,kBAAkB,EAAE,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC,CAAC;CACzD;AAED,eAAO,MAAM,YAAY,8BAAqC,CAAC;AAO/D,wBAAgB,eAAe,CAAC,CAAC,SAAS,MAAM,cAAc,EAC5D,KAAK,EAAE,CAAC,EACR,GAAG,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC,QAQ3B"}

package/dist/events.mjs

@@ -0,0 +1,18 @@
+import { EventEmitter } from "node:events";
+import { handleValkeyError } from "./errors.mjs";
+export const valkeyEvents = new EventEmitter();
+/* v8 ignore next -- NODE_ENV is controlled by the test runner. */
+if (process.env.NODE_ENV === "test") {
+    // Allow up to 1000 listeners — tests register multiple per-event handlers across parallel workers.
+    valkeyEvents.setMaxListeners(1000);
+}
+export function emitValkeyEvent(event, ...args) {
+    try {
+        // Cast needed: TypeScript can't resolve conditional types in EventEmitter.emit for generic K
+        valkeyEvents.emit(event, ...args);
+    }
+    catch (err) {
+        handleValkeyError(err);
+    }
+}
+//# sourceMappingURL=events.mjs.map

package/dist/events.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.mjs","sourceRoot":"","sources":["../events.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAoCjD,MAAM,CAAC,MAAM,YAAY,GAAG,IAAI,YAAY,EAAkB,CAAC;AAC/D,kEAAkE;AAClE,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,MAAM,EAAE,CAAC;IACpC,mGAAmG;IACnG,YAAY,CAAC,eAAe,CAAC,IAAI,CAAC,CAAC;AACrC,CAAC;AAED,MAAM,UAAU,eAAe,CAC7B,KAAQ,EACR,GAAG,IAAuB;IAE1B,IAAI,CAAC;QACH,6FAA6F;QAC7F,YAAY,CAAC,IAAI,CAAC,KAAY,EAAE,GAAG,IAAI,CAAC,CAAC;IAC3C,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iBAAiB,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;AACH,CAAC"}

package/dist/index.d.mts

@@ -0,0 +1,14 @@
+export * from "./events.mts";
+export * from "./rate-limiter.mts";
+export * from "./cache.mts";
+export * from "./bloom-filter.mts";
+export * from "./dynamic-config.mts";
+export * from "./clients.mts";
+export * from "./shutdown.mts";
+export * from "./scripts.mts";
+export * from "./utils.mts";
+export * from "./errors.mts";
+export * from "./key-normalization.mts";
+export * from "./cache-metrics.mts";
+export type { RateLimiterOptions, ValkeyBloomFilterOptions, ValkeyCacheOptions, ValkeyCacheMode, ValkeyCacheResponse, DynamicConfigField, DynamicConfigFieldType, DynamicConfigOptions, } from "./types.mts";
+//# sourceMappingURL=index.d.mts.map

package/dist/index.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.mts","sourceRoot":"","sources":["../index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC;AACpC,YAAY,EACV,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.mjs

@@ -0,0 +1,13 @@
+export * from "./events.mjs";
+export * from "./rate-limiter.mjs";
+export * from "./cache.mjs";
+export * from "./bloom-filter.mjs";
+export * from "./dynamic-config.mjs";
+export * from "./clients.mjs";
+export * from "./shutdown.mjs";
+export * from "./scripts.mjs";
+export * from "./utils.mjs";
+export * from "./errors.mjs";
+export * from "./key-normalization.mjs";
+export * from "./cache-metrics.mjs";
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.mjs","sourceRoot":"","sources":["../index.mts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,oBAAoB,CAAC;AACnC,cAAc,aAAa,CAAC;AAC5B,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AACrC,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,yBAAyB,CAAC;AACxC,cAAc,qBAAqB,CAAC"}

package/dist/key-normalization.d.mts

@@ -0,0 +1,2 @@
+export declare function normalizeKey(key: string): string;
+//# sourceMappingURL=key-normalization.d.mts.map

package/dist/key-normalization.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-normalization.d.mts","sourceRoot":"","sources":["../key-normalization.mts"],"names":[],"mappings":"AAAA,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEhD"}

package/dist/key-normalization.mjs

@@ -0,0 +1,4 @@
+export function normalizeKey(key) {
+    return key.trim().toLowerCase();
+}
+//# sourceMappingURL=key-normalization.mjs.map

package/dist/key-normalization.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"key-normalization.mjs","sourceRoot":"","sources":["../key-normalization.mts"],"names":[],"mappings":"AAAA,MAAM,UAAU,YAAY,CAAC,GAAW;IACtC,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;AAClC,CAAC"}

package/dist/rate-limiter.d.mts

@@ -0,0 +1,40 @@
+import type { RateLimiterOptions } from "./types.mts";
+import type { GlideClient } from "@valkey/valkey-glide";
+export declare class RateLimiter {
+    prefix: string;
+    ttl: number;
+    private client;
+    constructor({ prefix, ttlSeconds, client }: RateLimiterOptions);
+    add(ids: string[]): Promise<void>;
+    /**
+     * Atomically records this request and checks whether any ID exceeds the threshold.
+     * Returns `limited: true` when any post-add count >= threshold.
+     *
+     * NOTE: Unlike the old isRateLimited() + add() pattern (which only added on success),
+     * every call — including rejected ones — increments the counter. This means persistent
+     * abusers accumulate a larger count and their rate-limit window keeps refreshing,
+     * making the limiter more aggressive against sustained abuse.
+     *
+     * Falsy ids are silently filtered; `counts` aligns with the filtered ids, not the
+     * original array. Pre-filter ids before calling to maintain positional alignment.
+     */
+    addAndCheck(ids: string[], threshold: number, ttlSeconds?: number): Promise<{
+        counts: number[];
+        limited: boolean;
+    }>;
+    /**
+     * Returns true if any ID is at or above the threshold within the TTL window.
+     * Falsy ids are silently filtered (delegates to get()).
+     */
+    isRateLimited(ids: string[], threshold: number, ttlSeconds?: number): Promise<boolean>;
+    /**
+     * Returns the current request count for each ID within the TTL window.
+     * Falsy ids are silently filtered; returned counts align to filtered ids, not the input array.
+     */
+    get(ids: string[], ttlSeconds?: number): Promise<number[]>;
+    delete(...ids: string[]): Promise<number>;
+    getKey(key: string): string;
+    invalidate(): Promise<void>;
+    static invalidate(prefix: string, client?: GlideClient): Promise<void>;
+}
+//# sourceMappingURL=rate-limiter.d.mts.map

package/dist/rate-limiter.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.d.mts","sourceRoot":"","sources":["../rate-limiter.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAcxD,qBAAa,WAAW;IACtB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,CAAC,MAAM,CAAc;gBAEhB,EAAE,MAAM,EAAE,UAAU,EAAE,MAAgC,EAAE,EAAE,kBAAkB;IAMlF,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE;IAUvB;;;;;;;;;;;OAWG;IACG,WAAW,CACf,GAAG,EAAE,MAAM,EAAE,EACb,SAAS,EAAE,MAAM,EACjB,UAAU,SAAW,GACpB,OAAO,CAAC;QAAE,MAAM,EAAE,MAAM,EAAE,CAAC;QAAC,OAAO,EAAE,OAAO,CAAA;KAAE,CAAC;IA8BlD;;;OAGG;IACG,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,EAAE,UAAU,SAAW,GAAG,OAAO,CAAC,OAAO,CAAC;IAK9F;;;OAGG;IACG,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,EAAE,UAAU,SAAW,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAiB5D,MAAM,CAAC,GAAG,GAAG,EAAE,MAAM,EAAE;IAU7B,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,UAAU;WAIG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,cAA0B;CAQzE"}

package/dist/rate-limiter.mjs

@@ -0,0 +1,123 @@
+import { rateLimiterValkeyClient } from "./clients.mjs";
+import { loadScript, registerScript } from "./scripts.mjs";
+import { deleteKeysWithPrefix } from "./delete.mjs";
+import { emitValkeyEvent } from "./events.mjs";
+import { normalizeCountResult } from "./utils.mjs";
+import { handleValkeyError } from "./errors.mjs";
+const NAMESPACE = "rate-limiter";
+const rateLimiterAddScript = registerScript(loadScript("rate-limiter-add.lua", import.meta.url));
+const rateLimiterGetScript = registerScript(loadScript("rate-limiter-get.lua", import.meta.url));
+const rateLimiterAddAndCheckScript = registerScript(loadScript("rate-limiter-add-and-check.lua", import.meta.url));
+export class RateLimiter {
+    prefix;
+    ttl;
+    client;
+    constructor({ prefix, ttlSeconds, client = rateLimiterValkeyClient }) {
+        this.prefix = prefix;
+        this.ttl = ttlSeconds;
+        this.client = client;
+    }
+    async add(ids) {
+        const filteredIds = ids.filter(Boolean);
+        if (filteredIds.length === 0)
+            return;
+        const keys = filteredIds.map((id) => this.getKey(id));
+        // Single script call for all keys (server time is used in script)
+        const args = [this.ttl.toString(), ...keys.map(() => Math.random().toString())];
+        await this.client.invokeScript(rateLimiterAddScript, { keys, args });
+        emitValkeyEvent("rate-limiter:add", { prefix: this.prefix, ids: filteredIds });
+    }
+    /**
+     * Atomically records this request and checks whether any ID exceeds the threshold.
+     * Returns `limited: true` when any post-add count >= threshold.
+     *
+     * NOTE: Unlike the old isRateLimited() + add() pattern (which only added on success),
+     * every call — including rejected ones — increments the counter. This means persistent
+     * abusers accumulate a larger count and their rate-limit window keeps refreshing,
+     * making the limiter more aggressive against sustained abuse.
+     *
+     * Falsy ids are silently filtered; `counts` aligns with the filtered ids, not the
+     * original array. Pre-filter ids before calling to maintain positional alignment.
+     */
+    async addAndCheck(ids, threshold, ttlSeconds = this.ttl) {
+        const filteredIds = ids.filter(Boolean);
+        if (filteredIds.length === 0)
+            return { counts: [], limited: false };
+        const keys = filteredIds.map((id) => this.getKey(id));
+        const args = [ttlSeconds.toString(), ...keys.map(() => Math.random().toString())];
+        const results = await this.client.invokeScript(rateLimiterAddAndCheckScript, {
+            keys,
+            args,
+        });
+        // Valkey should always return an array. If not, the Lua script likely ran (atomic scripts
+        // either complete or error), but the return type is unexpected so we can't trust it.
+        // Fail open (allow the request). Skip events since the Valkey response is unreliable;
+        // return zeros so callers get a length-aligned array.
+        // This error path requires mocking invokeScript to test directly.
+        /* v8 ignore next 5 -- malformed script return requires a mocked corrupted Valkey response. */
+        if (!Array.isArray(results)) {
+            handleValkeyError(new Error(`addAndCheck: unexpected Valkey response type ${typeof results}`));
+            return { counts: filteredIds.map(() => 0), limited: false };
+        }
+        const counts = results.map((result) => normalizeCountResult(result));
+        const limited = counts.some((count) => count >= threshold);
+        // Both events fire even when limited=true, since ZADD always runs for every call.
+        // (Events are suppressed only on the fail-open path above where counts are unreliable.)
+        emitValkeyEvent("rate-limiter:add", { prefix: this.prefix, ids: filteredIds });
+        emitValkeyEvent("rate-limiter:get", { prefix: this.prefix, ids: filteredIds, counts });
+        return { counts, limited };
+    }
+    /**
+     * Returns true if any ID is at or above the threshold within the TTL window.
+     * Falsy ids are silently filtered (delegates to get()).
+     */
+    async isRateLimited(ids, threshold, ttlSeconds = this.ttl) {
+        const results = await this.get(ids, ttlSeconds);
+        return results.some((result) => result >= threshold);
+    }
+    /**
+     * Returns the current request count for each ID within the TTL window.
+     * Falsy ids are silently filtered; returned counts align to filtered ids, not the input array.
+     */
+    async get(ids, ttlSeconds = this.ttl) {
+        const filteredIds = ids.filter(Boolean);
+        if (filteredIds.length === 0)
+            return [];
+        const keys = filteredIds.map((id) => this.getKey(id));
+        // Single read-only script call for all keys (server time is used in script)
+        // Rate limiter checks need primary reads to avoid replica lag causing stale counts.
+        const results = await this.client.invokeScript(rateLimiterGetScript, {
+            keys,
+            args: [ttlSeconds.toString()],
+        });
+        // Results are an array of numbers from ZCOUNT; return zeros on unexpected type (fail open)
+        if (!Array.isArray(results))
+            return filteredIds.map(() => 0);
+        const counts = results.map((result) => normalizeCountResult(result));
+        emitValkeyEvent("rate-limiter:get", { prefix: this.prefix, ids: filteredIds, counts });
+        return counts;
+    }
+    async delete(...ids) {
+        if (ids.length === 0)
+            return 0;
+        const filteredIds = ids.filter(Boolean);
+        if (filteredIds.length === 0)
+            return 0;
+        const keys = filteredIds.map((id) => this.getKey(id));
+        const count = await this.client.unlink(keys);
+        emitValkeyEvent("rate-limiter:delete", { prefix: this.prefix, ids: filteredIds });
+        return count;
+    }
+    getKey(key) {
+        return `${NAMESPACE}:${this.prefix}:{${key}}`;
+    }
+    invalidate() {
+        return RateLimiter.invalidate(this.prefix, this.client);
+    }
+    static async invalidate(prefix, client = rateLimiterValkeyClient) {
+        const result = await deleteKeysWithPrefix(client, prefix ? `${NAMESPACE}:${prefix}:*` : `${NAMESPACE}:*`);
+        emitValkeyEvent("rate-limiter:invalidate", { prefix });
+        return result;
+    }
+}
+//# sourceMappingURL=rate-limiter.mjs.map

package/dist/rate-limiter.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limiter.mjs","sourceRoot":"","sources":["../rate-limiter.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,uBAAuB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAG3D,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,EAAE,oBAAoB,EAAE,MAAM,aAAa,CAAC;AACnD,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,SAAS,GAAG,cAAc,CAAC;AAEjC,MAAM,oBAAoB,GAAG,cAAc,CAAC,UAAU,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjG,MAAM,oBAAoB,GAAG,cAAc,CAAC,UAAU,CAAC,sBAAsB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;AACjG,MAAM,4BAA4B,GAAG,cAAc,CACjD,UAAU,CAAC,gCAAgC,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC9D,CAAC;AAEF,MAAM,OAAO,WAAW;IACtB,MAAM,CAAS;IACf,GAAG,CAAS;IACJ,MAAM,CAAc;IAE5B,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,uBAAuB,EAAsB;QACtF,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;QACrB,IAAI,CAAC,GAAG,GAAG,UAAU,CAAC;QACtB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAa;QACrB,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QACrC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,kEAAkE;QAClE,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,GAAG,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAChF,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACrE,eAAe,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;IACjF,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,WAAW,CACf,GAAa,EACb,SAAiB,EACjB,UAAU,GAAG,IAAI,CAAC,GAAG;QAErB,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QACpE,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,IAAI,GAAG,CAAC,UAAU,CAAC,QAAQ,EAAE,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAClF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,4BAA4B,EAAE;YAC3E,IAAI;YACJ,IAAI;SACL,CAAC,CAAC;QACH,0FAA0F;QAC1F,qFAAqF;QACrF,sFAAsF;QACtF,sDAAsD;QACtD,kEAAkE;QAClE,8FAA8F;QAC9F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YAC5B,iBAAiB,CACf,IAAI,KAAK,CAAC,gDAAgD,OAAO,OAAO,EAAE,CAAC,CAC5E,CAAC;YACF,OAAO,EAAE,MAAM,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;QAC9D,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,IAAI,SAAS,CAAC,CAAC;QAC3D,kFAAkF;QAClF,wFAAwF;QACxF,eAAe,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;QAC/E,eAAe,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,CAAC;IAC7B,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,aAAa,CAAC,GAAa,EAAE,SAAiB,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG;QACzE,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;QAChD,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,MAAc,EAAE,EAAE,CAAC,MAAM,IAAI,SAAS,CAAC,CAAC;IAC/D,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,GAAG,CAAC,GAAa,EAAE,UAAU,GAAG,IAAI,CAAC,GAAG;QAC5C,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,EAAE,CAAC;QACxC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,4EAA4E;QAC5E,oFAAoF;QACpF,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,YAAY,CAAC,oBAAoB,EAAE;YACnE,IAAI;YACJ,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;SAC9B,CAAC,CAAC;QACH,2FAA2F;QAC3F,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC;YAAE,OAAO,WAAW,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,CAAC;QAC7D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,oBAAoB,CAAC,MAAM,CAAC,CAAC,CAAC;QACrE,eAAe,CAAC,kBAAkB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,CAAC,CAAC;QACvF,OAAO,MAAM,CAAC;IAChB,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAG,GAAa;QAC3B,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QAC/B,MAAM,WAAW,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QACxC,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;QACvC,MAAM,IAAI,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,CAAC;QACtD,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;QAC7C,eAAe,CAAC,qBAAqB,EAAE,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC,CAAC;QAClF,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,CAAC,GAAW;QAChB,OAAO,GAAG,SAAS,IAAI,IAAI,CAAC,MAAM,KAAK,GAAG,GAAG,CAAC;IAChD,CAAC;IAED,UAAU;QACR,OAAO,WAAW,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1D,CAAC;IAED,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,MAAc,EAAE,MAAM,GAAG,uBAAuB;QACtE,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,MAAM,EACN,MAAM,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,MAAM,IAAI,CAAC,CAAC,CAAC,GAAG,SAAS,IAAI,CACvD,CAAC;QACF,eAAe,CAAC,yBAAyB,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;QACvD,OAAO,MAAM,CAAC;IAChB,CAAC;CACF"}

package/dist/scripts/bloom-filter-add.lua

@@ -0,0 +1,26 @@
+-- Add items to the live bloom filter and, if an active rebuild is running,
+-- also to the building key. No-op if neither key exists (post-#1955) so a
+-- missing filter stays missing and cache reads fall back to the DB rather
+-- than to an empty / under-provisioned auto-created filter.
+-- This script is write-only and must be executed using the write client.
+-- KEYS[1] = live key
+-- KEYS[2] = building key
+-- ARGV[1..n] = items to add
+-- Returns: 1 if any write occurred, 0 otherwise.
+if #ARGV == 0 then
+  return 0
+end
+
+local wrote = 0
+
+if redis.call('EXISTS', KEYS[1]) == 1 then
+  redis.call('BF.MADD', KEYS[1], unpack(ARGV))
+  wrote = 1
+end
+
+if redis.call('EXISTS', KEYS[2]) == 1 then
+  redis.call('BF.MADD', KEYS[2], unpack(ARGV))
+  wrote = 1
+end
+
+return wrote

package/dist/scripts/bloom-filter-ensure-exists.lua

@@ -0,0 +1,13 @@
+-- Conditionally create a bloom filter only if the key does not already exist.
+-- Unlike calling BF.RESERVE directly, this avoids a server-side "item exists"
+-- error (which the Valkey Glide logger surfaces as a WARN even when caught in JS).
+-- KEYS[1] = bloom filter key
+-- ARGV[1] = error_rate (e.g. "0.01")
+-- ARGV[2] = capacity (integer as string)
+-- ARGV[3] = expansion rate (integer as string)
+local key = KEYS[1]
+if redis.call('EXISTS', key) == 1 then
+  return 0
+end
+redis.call('BF.RESERVE', key, ARGV[1], ARGV[2], 'EXPANSION', ARGV[3])
+return 1

package/dist/scripts/bloom-filter-exists-if-ready.lua

@@ -0,0 +1,14 @@
+-- Check a ready marker, bloom filter existence, and one item in one roundtrip.
+-- KEYS[1] = ready marker key
+-- KEYS[2] = bloom filter key
+-- ARGV[1] = item
+-- Returns: 1 if item may exist, 0 if definitely not present, -1 if not ready/unavailable.
+if redis.call('EXISTS', KEYS[1]) == 0 then
+  return -1
+end
+
+if redis.call('EXISTS', KEYS[2]) == 0 then
+  return -1
+end
+
+return redis.call('BF.EXISTS', KEYS[2], ARGV[1])

package/dist/scripts/bloom-filter-exists.lua

@@ -0,0 +1,14 @@
+-- Check bloom filter existence in a single roundtrip
+-- Read-only: execute with cacheValkeyClient
+-- KEYS[1]: filter key
+-- ARGV[1]: item to check
+-- Returns: 1 if item may exist, 0 if definitely not present, -1 if filter doesn't exist
+
+local key = KEYS[1]
+local item = ARGV[1]
+
+if redis.call('EXISTS', key) == 0 then
+  return -1
+end
+
+return redis.call('BF.EXISTS', key, item)

package/dist/scripts/bloom-filter-mexists-if-ready.lua

@@ -0,0 +1,19 @@
+-- Check a ready marker, bloom filter existence, and multiple items in one roundtrip.
+-- KEYS[1] = ready marker key
+-- KEYS[2] = bloom filter key
+-- ARGV[1..n] = items
+-- Returns: array where 1=may exist, 0=definitely not present, -1=not ready/unavailable.
+local result = {}
+
+if #ARGV == 0 then
+  return result
+end
+
+if redis.call('EXISTS', KEYS[1]) == 0 or redis.call('EXISTS', KEYS[2]) == 0 then
+  for i = 1, #ARGV do
+    result[i] = -1
+  end
+  return result
+end
+
+return redis.call('BF.MEXISTS', KEYS[2], unpack(ARGV))

package/dist/scripts/bloom-filter-mexists.lua

@@ -0,0 +1,17 @@
+-- Check multiple items in bloom filter in a single roundtrip
+-- Read-only: execute with cacheValkeyClient
+-- KEYS[1]: filter key
+-- ARGV[1..n]: items to check
+-- Returns: array where 1=may exist, 0=definitely not present, -1=filter doesn't exist
+
+local key = KEYS[1]
+
+if redis.call('EXISTS', key) == 0 then
+  local result = {}
+  for i = 1, #ARGV do
+    result[i] = -1
+  end
+  return result
+end
+
+return redis.call('BF.MEXISTS', key, unpack(ARGV))

package/dist/scripts/bloom-filter-reserve.lua

@@ -0,0 +1,11 @@
+-- Atomically unlink and re-create a bloom filter key.
+-- Combining UNLINK + BF.RESERVE in a single Lua script prevents a race condition
+-- where two concurrent callers both call UNLINK and then both call BF.RESERVE,
+-- causing the second caller to receive an "item exists" error.
+-- This script is write-only and must be executed using the write client.
+-- KEYS[1] = bloom filter key
+-- ARGV[1] = error_rate (e.g. "0.01")
+-- ARGV[2] = capacity (integer as string)
+-- ARGV[3] = expansion rate (integer as string)
+redis.call('UNLINK', KEYS[1])
+return redis.call('BF.RESERVE', KEYS[1], ARGV[1], ARGV[2], 'EXPANSION', ARGV[3])

package/dist/scripts/cache-delete-with-invalidation.lua

@@ -0,0 +1,29 @@
+-- Atomically delete cache keys and record short-lived invalidation timestamps.
+-- KEYS[1..n] = cache keys
+-- KEYS[n+1..2n] = invalidation marker keys matching each cache key
+-- ARGV[1] = number of cache keys
+-- ARGV[2] = invalidation marker TTL in seconds
+if #KEYS == 0 then
+  return 0
+end
+
+local keyCount = tonumber(ARGV[1])
+local invalidationTtl = tonumber(ARGV[2])
+if keyCount == nil or invalidationTtl == nil then
+  error('cache-delete-with-invalidation: key count and invalidation TTL are required')
+end
+if keyCount == 0 then
+  return 0
+end
+if #KEYS ~= keyCount * 2 then
+  error('cache-delete-with-invalidation: expected cache keys followed by invalidation keys')
+end
+
+local cacheKeys = {}
+for i = 1, keyCount do
+  cacheKeys[i] = KEYS[i]
+  local invalidationKey = KEYS[keyCount + i]
+  redis.call('SET', invalidationKey, '1', 'EX', invalidationTtl)
+end
+
+return redis.call('UNLINK', unpack(cacheKeys))

package/dist/scripts/cache-set-if-not-invalidated.lua

@@ -0,0 +1,47 @@
+-- Conditionally set cache values unless a newer invalidation marker exists.
+-- KEYS[1..n] = cache keys
+-- KEYS[n+1..2n] = invalidation marker keys matching each cache key
+-- ARGV[1] = number of cache keys
+-- Repeated per key:
+--   ttl seconds
+--   serialized value
+-- Returns one result per key: 1 when set, 0 when skipped.
+if #KEYS == 0 then
+  return {}
+end
+
+local keyCount = tonumber(ARGV[1])
+if keyCount == nil then
+  error('cache-set-if-not-invalidated: key count is required')
+end
+if keyCount == 0 then
+  return {}
+end
+if #KEYS ~= keyCount * 2 then
+  error('cache-set-if-not-invalidated: expected cache keys followed by invalidation keys')
+end
+if #ARGV ~= 1 + (keyCount * 2) then
+  error('cache-set-if-not-invalidated: expected ttl and value for each key')
+end
+
+local results = {}
+for i = 1, keyCount do
+  local cacheKey = KEYS[i]
+  local invalidationKey = KEYS[keyCount + i]
+  local argOffset = 1 + ((i - 1) * 2)
+  local ttl = tonumber(ARGV[argOffset + 1])
+  local value = ARGV[argOffset + 2]
+
+  if ttl == nil then
+    error('cache-set-if-not-invalidated: ttl must be a number')
+  end
+
+  if redis.call('EXISTS', invalidationKey) == 1 then
+    table.insert(results, 0)
+  else
+    redis.call('SET', cacheKey, value, 'EX', ttl)
+    table.insert(results, 1)
+  end
+end
+
+return results

package/dist/scripts/dynamic-config-set-fields.lua

@@ -0,0 +1,23 @@
+-- Dynamic config set-fields operation (HSET + PUBLISH all in one roundtrip)
+-- KEYS[1]: hash key
+-- ARGV[1,3,5,...]: field names
+-- ARGV[2,4,6,...]: field values
+-- Sets all fields in the hash and publishes per-field update events
+
+-- Guard: HSET with no fields is a Valkey error
+if #ARGV == 0 then return 0 end
+-- Guard: ARGV must contain field/value pairs (even length)
+assert(#ARGV % 2 == 0, 'ARGV must contain field/value pairs (even length)')
+
+-- HSET all fields at once
+redis.call('HSET', KEYS[1], unpack(ARGV))
+
+-- PUBLISH per field so subscribers get real-time updates
+local numArgs = #ARGV
+for i = 1, numArgs, 2 do
+  local field = ARGV[i]
+  local value = ARGV[i + 1]
+  redis.call('PUBLISH', KEYS[1] .. ':' .. field, value)
+end
+
+return 1