valkyries 0.5.0 → 0.6.0

package/README.md

@@ -122,6 +122,8 @@ Call `closeValkeyClients()` to close package-managed clients.
 - [Bloom filters](docs/bloom-filters.md)
 - [Dynamic config](docs/dynamic-config.md)
 - [Rate limiter](docs/rate-limiter.md)
+- [Idempotency keys](docs/idempotency-key.md)
+- [Conditional operations](docs/conditional-operations.md)
 - [Events and metrics](docs/events-and-metrics.md)
 - [Lua scripts](docs/lua-scripts.md)
 - [Utilities](docs/utilities.md)

package/dist/cache/deletes.d.mts

@@ -12,6 +12,7 @@ export declare class ValkeyCacheDeletes<K = string> extends ValkeyCacheMutations
     static deleteFromCaches<K>(entries: readonly ValkeyCacheDeleteFromCachesEntry<K>[]): Promise<number>;
     static deleteFromCaches(entries: readonly ValkeyCacheDeleteFromCachesEntry<any>[]): Promise<number>;
     static invalidate(prefix: string, client?: GlideClient): Promise<void>;
+    static invalidateMany(prefixes: readonly string[], client?: GlideClient): Promise<void>;
     private static deleteSerializedEntriesFromClient;
 }
 //# sourceMappingURL=deletes.d.mts.map

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

@@ -1 +1 @@
-{"version":3,"file":"deletes.d.mts","sourceRoot":"","sources":["../../cache/deletes.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAUhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,MAAM,gCAAgC,CAAC,CAAC,GAAG,GAAG,IAAI;IACtD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;CACpB,CAAC;AAYF,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;cA+B3B,qBAAqB,CAAC,GAAG,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnF,UAAU;WAIG,gBAAgB,CAAC,CAAC,EAC7B,OAAO,EAAE,SAAS,gCAAgC,CAAC,CAAC,CAAC,EAAE,GACtD,OAAO,CAAC,MAAM,CAAC;WACL,gBAAgB,CAC3B,OAAO,EAAE,SAAS,gCAAgC,CAAC,GAAG,CAAC,EAAE,GACxD,OAAO,CAAC,MAAM,CAAC;WAqEL,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,cAAoB;mBAQ7C,iCAAiC;CA0BvD"}
+{"version":3,"file":"deletes.d.mts","sourceRoot":"","sources":["../../cache/deletes.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAUhD,OAAO,EAAE,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAEvD,MAAM,MAAM,gCAAgC,CAAC,CAAC,GAAG,GAAG,IAAI;IACtD,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC;IACtB,IAAI,EAAE,SAAS,CAAC,EAAE,CAAC;CACpB,CAAC;AAYF,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;cA+B3B,qBAAqB,CAAC,GAAG,cAAc,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,MAAM,CAAC;IAmBnF,UAAU;WAIG,gBAAgB,CAAC,CAAC,EAC7B,OAAO,EAAE,SAAS,gCAAgC,CAAC,CAAC,CAAC,EAAE,GACtD,OAAO,CAAC,MAAM,CAAC;WACL,gBAAgB,CAC3B,OAAO,EAAE,SAAS,gCAAgC,CAAC,GAAG,CAAC,EAAE,GACxD,OAAO,CAAC,MAAM,CAAC;WAqEL,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,cAAoB;WAIrD,cAAc,CAAC,QAAQ,EAAE,SAAS,MAAM,EAAE,EAAE,MAAM,cAAoB;mBAkB9D,iCAAiC;CA0BvD"}

package/dist/cache/deletes.mjs

@@ -1,6 +1,6 @@
 import { cacheValkeyClient } from "../clients.mjs";
 import { emitValkeyEvent } from "../events.mjs";
-import { deleteKeysWithPrefix } from "../delete.mjs";
+import { deleteKeysWithLiteralPrefixes } from "../delete.mjs";
 import { normalizeCountResult } from "../utils.mjs";
 import { CACHE_NAMESPACE, INVALIDATION_MARKER_TTL_SECONDS, cacheDeleteWithInvalidationScript, } from "./constants.mjs";
 import { ValkeyCacheMutations } from "./mutations.mjs";
@@ -116,8 +116,16 @@ export class ValkeyCacheDeletes extends ValkeyCacheMutations {
         return deleted;
     }
     static async invalidate(prefix, client = cacheValkeyClient) {
-        await deleteKeysWithPrefix(client, prefix ? `${CACHE_NAMESPACE}:${prefix}:*` : `${CACHE_NAMESPACE}:*`);
-        emitValkeyEvent("cache:invalidate", { cacheName: prefix });
+        await ValkeyCacheDeletes.invalidateMany([prefix], client);
+    }
+    static async invalidateMany(prefixes, client = cacheValkeyClient) {
+        const uniquePrefixes = [...new Set(prefixes)].filter((prefix) => typeof prefix === "string");
+        if (uniquePrefixes.length === 0)
+            return;
+        await deleteKeysWithLiteralPrefixes(client, `${CACHE_NAMESPACE}:*`, uniquePrefixes.map((prefix) => prefix ? `${CACHE_NAMESPACE}:${prefix}:` : `${CACHE_NAMESPACE}:`));
+        for (const prefix of uniquePrefixes) {
+            emitValkeyEvent("cache:invalidate", { cacheName: prefix });
+        }
     }
     static async deleteSerializedEntriesFromClient(client, entries) {
         const cacheKeys = [];

package/dist/cache/deletes.mjs.map

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

package/dist/conditional.d.mts

@@ -0,0 +1,8 @@
+import type { GlideClient } from "@valkey/valkey-glide";
+export type UnlinkIfValueMatchesOptions = {
+    /** Optional Valkey client. Defaults to the package cache client. */
+    client?: GlideClient;
+};
+/** Atomically unlinks a key only when its stored string value matches the expected value. */
+export declare function unlinkIfValueMatches(key: string, expectedValue: string, options?: UnlinkIfValueMatchesOptions): Promise<boolean>;
+//# sourceMappingURL=conditional.d.mts.map

package/dist/conditional.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.d.mts","sourceRoot":"","sources":["../conditional.mts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAMxD,MAAM,MAAM,2BAA2B,GAAG;IACxC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,6FAA6F;AAC7F,wBAAsB,oBAAoB,CACxC,GAAG,EAAE,MAAM,EACX,aAAa,EAAE,MAAM,EACrB,OAAO,GAAE,2BAAgC,GACxC,OAAO,CAAC,OAAO,CAAC,CAclB"}

package/dist/conditional.mjs

@@ -0,0 +1,19 @@
+import { cacheValkeyClient } from "./clients.mjs";
+import { loadScript, registerScript } from "./scripts.mjs";
+import { stringifyValkeyResult } from "./valkey-result.mjs";
+const unlinkIfValueMatchesScript = registerScript(loadScript("unlink-if-value-matches.lua", import.meta.url));
+/** Atomically unlinks a key only when its stored string value matches the expected value. */
+export async function unlinkIfValueMatches(key, expectedValue, options = {}) {
+    if (!key)
+        throw new Error("key must not be empty");
+    const result = await (options.client ?? cacheValkeyClient).invokeScript(unlinkIfValueMatchesScript, {
+        keys: [key],
+        args: [expectedValue],
+    });
+    if (result === 1 || result === 1n)
+        return true;
+    if (result === 0 || result === 0n)
+        return false;
+    throw new Error(`Unexpected conditional unlink result: ${stringifyValkeyResult(result)}`);
+}
+//# sourceMappingURL=conditional.mjs.map

package/dist/conditional.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"conditional.mjs","sourceRoot":"","sources":["../conditional.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,EAAE,UAAU,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAG5D,MAAM,0BAA0B,GAAG,cAAc,CAC/C,UAAU,CAAC,6BAA6B,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC3D,CAAC;AAOF,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,GAAW,EACX,aAAqB,EACrB,UAAuC,EAAE;IAEzC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,uBAAuB,CAAC,CAAC;IAEnD,MAAM,MAAM,GAAG,MAAM,CAAC,OAAO,CAAC,MAAM,IAAI,iBAAiB,CAAC,CAAC,YAAY,CACrE,0BAA0B,EAC1B;QACE,IAAI,EAAE,CAAC,GAAG,CAAC;QACX,IAAI,EAAE,CAAC,aAAa,CAAC;KACtB,CACF,CAAC;IAEF,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IAC/C,IAAI,MAAM,KAAK,CAAC,IAAI,MAAM,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,IAAI,KAAK,CAAC,yCAAyC,qBAAqB,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC5F,CAAC"}

package/dist/delete.d.mts

@@ -1,3 +1,4 @@
 import type { GlideClient } from "@valkey/valkey-glide";
-export declare const deleteKeysWithPrefix: (client: GlideClient, pattern: string) => Promise<void>;
+export declare function deleteKeysWithPrefix(client: GlideClient, pattern: string): Promise<void>;
+export declare function deleteKeysWithLiteralPrefixes(client: GlideClient, pattern: string, prefixes: readonly string[]): Promise<void>;
 //# sourceMappingURL=delete.d.mts.map

package/dist/delete.d.mts.map

@@ -1 +1 @@
-{"version":3,"file":"delete.d.mts","sourceRoot":"","sources":["../delete.mts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAExD,eAAO,MAAM,oBAAoB,GAAU,QAAQ,WAAW,EAAE,SAAS,MAAM,KAAG,OAAO,CAAC,IAAI,CAmC7F,CAAC"}
+{"version":3,"file":"delete.d.mts","sourceRoot":"","sources":["../delete.mts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,sBAAsB,CAAC;AAIrE,wBAAsB,oBAAoB,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE9F;AAED,wBAAsB,6BAA6B,CACjD,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,MAAM,EACf,QAAQ,EAAE,SAAS,MAAM,EAAE,GAC1B,OAAO,CAAC,IAAI,CAAC,CASf"}

package/dist/delete.mjs

@@ -1,34 +1,32 @@
+import { Buffer } from "node:buffer";
 import { handleValkeyError } from "./errors.mjs";
-export const deleteKeysWithPrefix = async (client, pattern) => {
-    const unlinkPromises = [];
+const DEFAULT_SCAN_COUNT = 500;
+export async function deleteKeysWithPrefix(client, pattern) {
+    await scanAndUnlink(client, pattern);
+}
+export async function deleteKeysWithLiteralPrefixes(client, pattern, prefixes) {
+    const uniquePrefixes = [...new Set(prefixes)].filter((prefix) => typeof prefix === "string");
+    if (uniquePrefixes.length === 0)
+        return;
+    await scanAndUnlink(client, pattern, (key) => uniquePrefixes.some((prefix) => key.startsWith(prefix)));
+}
+async function scanAndUnlink(client, pattern, matches = () => true) {
     try {
         let cursor = "0";
         do {
-            // GlideClient scan method signature: scan(cursor: string, options?: ScanOptions)
-            const result = await client.scan(cursor, { match: pattern });
+            const result = await client.scan(cursor, { match: pattern, count: DEFAULT_SCAN_COUNT });
             cursor = result[0];
-            const keys = result[1];
+            const keys = result[1]
+                .map((key) => (typeof key === "string" ? key : Buffer.from(key).toString("utf8")))
+                .filter(matches);
             if (keys.length > 0) {
-                // Attach a no-op catch to prevent unhandled rejection crashes if scan fails
-                // before Promise.all is reached. SonarCloud complains about empty callbacks,
-                // so we call a dummy function or use a minimal expression.
-                const p = client.unlink(keys);
-                p.catch(() => undefined);
-                unlinkPromises.push(p);
-                // Prevent unbounded memory/concurrency by batching promises
-                if (unlinkPromises.length >= 100) {
-                    await Promise.all(unlinkPromises);
-                    unlinkPromises.length = 0;
-                }
+                await client.unlink(keys);
             }
         } while (cursor !== "0");
-        if (unlinkPromises.length > 0) {
-            await Promise.all(unlinkPromises);
-        }
     }
     catch (err) {
         handleValkeyError(err);
         throw err;
     }
-};
+}
 //# sourceMappingURL=delete.mjs.map

package/dist/delete.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"delete.mjs","sourceRoot":"","sources":["../delete.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,MAAmB,EAAE,OAAe,EAAiB,EAAE;IAChG,MAAM,cAAc,GAAsB,EAAE,CAAC;IAE7C,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,GAAG,CAAC;QAEjB,GAAG,CAAC;YACF,iFAAiF;YACjF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC;YAC7D,MAAM,GAAG,MAAM,CAAC,CAAC,CAAW,CAAC;YAC7B,MAAM,IAAI,GAAG,MAAM,CAAC,CAAC,CAAa,CAAC;YAEnC,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,4EAA4E;gBAC5E,6EAA6E;gBAC7E,2DAA2D;gBAC3D,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;gBAC9B,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAAC;gBACzB,cAAc,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;gBAEvB,4DAA4D;gBAC5D,IAAI,cAAc,CAAC,MAAM,IAAI,GAAG,EAAE,CAAC;oBACjC,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;oBAClC,cAAc,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC5B,CAAC;YACH,CAAC;QACH,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;QAEzB,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,OAAO,CAAC,GAAG,CAAC,cAAc,CAAC,CAAC;QACpC,CAAC;IACH,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC,CAAC"}
+{"version":3,"file":"delete.mjs","sourceRoot":"","sources":["../delete.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AACrC,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAGjD,MAAM,kBAAkB,GAAG,GAAG,CAAC;AAE/B,MAAM,CAAC,KAAK,UAAU,oBAAoB,CAAC,MAAmB,EAAE,OAAe;IAC7E,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,6BAA6B,CACjD,MAAmB,EACnB,OAAe,EACf,QAA2B;IAE3B,MAAM,cAAc,GAAG,CAAC,GAAG,IAAI,GAAG,CAAU,QAAQ,CAAC,CAAC,CAAC,MAAM,CAC3D,CAAC,MAAM,EAAoB,EAAE,CAAC,OAAO,MAAM,KAAK,QAAQ,CACzD,CAAC;IACF,IAAI,cAAc,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO;IAExC,MAAM,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE,CAC3C,cAAc,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CACxD,CAAC;AACJ,CAAC;AAED,KAAK,UAAU,aAAa,CAC1B,MAAmB,EACnB,OAAe,EACf,UAAoC,GAAG,EAAE,CAAC,IAAI;IAE9C,IAAI,CAAC;QACH,IAAI,MAAM,GAAG,GAAG,CAAC;QAEjB,GAAG,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,kBAAkB,EAAE,CAAC,CAAC;YACxF,MAAM,GAAG,MAAM,CAAC,CAAC,CAAW,CAAC;YAC7B,MAAM,IAAI,GAAI,MAAM,CAAC,CAAC,CAAmB;iBACtC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC;iBACjF,MAAM,CAAC,OAAO,CAAC,CAAC;YAEnB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,MAAM,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,QAAQ,MAAM,KAAK,GAAG,EAAE;IAC3B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,iBAAiB,CAAC,GAAG,CAAC,CAAC;QACvB,MAAM,GAAG,CAAC;IACZ,CAAC;AACH,CAAC"}

package/dist/idempotency-key.d.mts

@@ -14,6 +14,11 @@ export type IdempotencyKeyOptions = {
 export type ReserveIdempotencyKeyOptions = IdempotencyKeyOptions & {
     /** Optional reservation token. Defaults to crypto.randomUUID(). */
     token?: string;
+    /** Opt in to atomically repair persistent existing reservations. */
+    repairMissingExpiry?: {
+        /** TTL for persistent completed values. Defaults to ttlSeconds. */
+        completedTtlSeconds?: number;
+    };
 };
 export type IdempotencyReservation = {
     state: "reserved";

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

@@ -1 +1 @@
-{"version":3,"file":"idempotency-key.d.mts","sourceRoot":"","sources":["../idempotency-key.mts"],"names":[],"mappings":"AAGA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAmBjE,MAAM,MAAM,mBAAmB,GAAG;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,qBAAqB,GAAG;IACjE,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,KAAK,EAAE,YAAY,GAAG,WAAW,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9E,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,sBAAsB,CAAC,CAiBjC;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAmBtC;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAYlB"}
+{"version":3,"file":"idempotency-key.d.mts","sourceRoot":"","sources":["../idempotency-key.mts"],"names":[],"mappings":"AAKA,OAAO,EAAW,KAAK,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAejE,MAAM,MAAM,mBAAmB,GAAG;IAChC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qBAAqB,GAAG;IAClC,oEAAoE;IACpE,MAAM,CAAC,EAAE,WAAW,CAAC;IACrB,4EAA4E;IAC5E,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wEAAwE;IACxE,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG,qBAAqB,GAAG;IACjE,mEAAmE;IACnE,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,mBAAmB,CAAC,EAAE;QACpB,mEAAmE;QACnE,mBAAmB,CAAC,EAAE,MAAM,CAAC;KAC9B,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,sBAAsB,GAC9B;IAAE,KAAK,EAAE,UAAU,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpC;IAAE,KAAK,EAAE,YAAY,GAAG,WAAW,CAAA;CAAE,CAAC;AAE1C,MAAM,MAAM,2BAA2B,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,CAAC;AAE9E,wBAAsB,YAAY,CAChC,GAAG,EAAE,MAAM,EACX,OAAO,GAAE,mBAAwB,GAChC,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAOxB;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,4BAAiC,GACzC,OAAO,CAAC,sBAAsB,CAAC,CA2BjC;AAED,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAmBtC;AAED,wBAAsB,qBAAqB,CACzC,GAAG,EAAE,MAAM,EACX,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,qBAA0B,GAClC,OAAO,CAAC,OAAO,CAAC,CAQlB"}

package/dist/idempotency-key.mjs

@@ -1,6 +1,8 @@
 import { randomUUID } from "node:crypto";
 import { cacheValkeyClient } from "./clients.mjs";
+import { unlinkIfValueMatches } from "./conditional.mjs";
 import { loadScript, registerScript } from "./scripts.mjs";
+import { stringifyValkeyResult } from "./valkey-result.mjs";
 import { Decoder } from "@valkey/valkey-glide";
 const DEFAULT_PROCESSING_PREFIX = "processing";
 const DEFAULT_COMPLETED_VALUE = "completed";
@@ -10,7 +12,6 @@ const CHANGED_RESULT = "changed";
 const SCRIPT_RESULT_VALUES = new Set([RESERVED_RESULT, MISSING_RESULT, CHANGED_RESULT]);
 const idempotencyKeyReserveScript = registerScript(loadScript("idempotency-key-reserve.lua", import.meta.url));
 const idempotencyKeyCompleteIfCurrentScript = registerScript(loadScript("idempotency-key-complete-if-current.lua", import.meta.url));
-const idempotencyKeyReleaseIfCurrentScript = registerScript(loadScript("idempotency-key-release-if-current.lua", import.meta.url));
 export async function getAndDelete(key, options = {}) {
     validateKey(key);
     const result = await (options.client ?? cacheValkeyClient).customCommand(["GETDEL", key], {
@@ -22,13 +23,23 @@ export async function getAndDelete(key, options = {}) {
 }
 export async function reserveIdempotencyKey(key, ttlSeconds, options = {}) {
     validateKey(key);
-    validateTtlSeconds(ttlSeconds);
+    validateTtlSeconds("ttlSeconds", ttlSeconds);
     const settings = normalizeIdempotencyOptions(options);
     const token = options.token ?? randomUUID();
     validateNonEmpty("token", token);
+    const repairMissingExpiry = options.repairMissingExpiry !== undefined;
+    const completedTtlSeconds = options.repairMissingExpiry?.completedTtlSeconds ?? ttlSeconds;
+    validateTtlSeconds("completedTtlSeconds", completedTtlSeconds);
     const result = await settings.client.invokeScript(idempotencyKeyReserveScript, {
         keys: [key],
-        args: [String(ttlSeconds), settings.processingPrefix, settings.completedValue, token],
+        args: [
+            String(ttlSeconds),
+            settings.processingPrefix,
+            settings.completedValue,
+            token,
+            repairMissingExpiry ? "1" : "0",
+            String(completedTtlSeconds),
+        ],
         decoder: Decoder.String,
     });
     if (result === RESERVED_RESULT)
@@ -42,7 +53,7 @@ export async function reserveIdempotencyKey(key, ttlSeconds, options = {}) {
 export async function completeIdempotencyKey(key, token, ttlSeconds, options = {}) {
     validateKey(key);
     validateNonEmpty("token", token);
-    validateTtlSeconds(ttlSeconds);
+    validateTtlSeconds("ttlSeconds", ttlSeconds);
     const settings = normalizeIdempotencyOptions(options);
     const result = await settings.client.invokeScript(idempotencyKeyCompleteIfCurrentScript, {
         keys: [key],
@@ -63,12 +74,9 @@ export async function releaseIdempotencyKey(key, token, options = {}) {
     validateKey(key);
     validateNonEmpty("token", token);
     const settings = normalizeIdempotencyOptions(options);
-    const result = await settings.client.invokeScript(idempotencyKeyReleaseIfCurrentScript, {
-        keys: [key],
-        args: [processingValue(settings.processingPrefix, token)],
-        decoder: Decoder.String,
+    return await unlinkIfValueMatches(key, processingValue(settings.processingPrefix, token), {
+        client: settings.client,
     });
-    return result === 1 || result === 1n;
 }
 function normalizeIdempotencyOptions(options) {
     const processingPrefix = options.processingPrefix ?? DEFAULT_PROCESSING_PREFIX;
@@ -95,9 +103,11 @@ function processingValue(processingPrefix, token) {
 function validateKey(key) {
     validateNonEmpty("key", key);
 }
-function validateTtlSeconds(ttlSeconds) {
-    if (ttlSeconds <= 0)
-        throw new Error("ttlSeconds must be greater than 0");
+function validateTtlSeconds(name, ttlSeconds) {
+    if (!(ttlSeconds > 0))
+        throw new Error(`${name} must be greater than 0`);
+    if (!Number.isSafeInteger(ttlSeconds))
+        throw new Error(`${name} must be a positive safe integer`);
 }
 function validateNonEmpty(name, value) {
     if (!value)
@@ -108,12 +118,4 @@ function validateStoredStateValue(name, value) {
         throw new Error(`${name} must not equal a script result sentinel`);
     }
 }
-function stringifyValkeyResult(result) {
-    if (typeof result === "string")
-        return result;
-    if (typeof result === "number" || typeof result === "bigint" || typeof result === "boolean") {
-        return result.toString();
-    }
-    return JSON.stringify(result) ?? "[unserializable]";
-}
 //# sourceMappingURL=idempotency-key.mjs.map

package/dist/idempotency-key.mjs.map

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

package/dist/index.d.mts

@@ -4,6 +4,7 @@ export * from "./cache.mts";
 export * from "./bloom-filter.mts";
 export * from "./dynamic-config.mts";
 export * from "./idempotency-key.mts";
+export * from "./conditional.mts";
 export * from "./clients.mts";
 export * from "./shutdown.mts";
 export * from "./scripts.mts";

package/dist/index.d.mts.map

@@ -1 +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,uBAAuB,CAAC;AACtC,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,cAAc,aAAa,CAAC;AAC5B,YAAY,EACV,oCAAoC,EACpC,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}
+{"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,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,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,cAAc,aAAa,CAAC;AAC5B,YAAY,EACV,oCAAoC,EACpC,kBAAkB,EAClB,iBAAiB,EACjB,wBAAwB,EACxB,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,kBAAkB,EAClB,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,aAAa,CAAC"}

package/dist/index.mjs

@@ -4,6 +4,7 @@ export * from "./cache.mjs";
 export * from "./bloom-filter.mjs";
 export * from "./dynamic-config.mjs";
 export * from "./idempotency-key.mjs";
+export * from "./conditional.mjs";
 export * from "./clients.mjs";
 export * from "./shutdown.mjs";
 export * from "./scripts.mjs";

package/dist/index.mjs.map

@@ -1 +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,uBAAuB,CAAC;AACtC,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,cAAc,aAAa,CAAC"}
+{"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,uBAAuB,CAAC;AACtC,cAAc,mBAAmB,CAAC;AAClC,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,cAAc,aAAa,CAAC"}

package/dist/scripts/idempotency-key-release-if-current.lua

@@ -1,4 +1,5 @@
--- Release an idempotency reservation only if the caller still owns the token.
+-- Compatibility script for callers that load the historical idempotency-specific filename.
+-- New code should use unlink-if-value-matches.lua through unlinkIfValueMatches().
 -- KEYS[1] = idempotency key
 -- ARGV[1] = expected processing value
 -- Returns: 1 when released, 0 when absent or changed.

package/dist/scripts/idempotency-key-reserve.lua

@@ -4,6 +4,8 @@
 -- ARGV[2] = processing value prefix
 -- ARGV[3] = completed value
 -- ARGV[4] = reservation token
+-- ARGV[5] = repair missing expiry (1 or 0)
+-- ARGV[6] = completed ttl seconds
 -- Returns: reserved | processing prefix | completed value
 local ttl = tonumber(ARGV[1])
 local processingPrefix = ARGV[2]
@@ -13,8 +15,32 @@ if ttl == nil or processingPrefix == nil or completedValue == nil or token == ni
   error('idempotency-key-reserve: ttl, processing prefix, completed value, and token are required')
 end
 
+-- ARGV[5] and ARGV[6] were added after the original four-argument contract.
+-- Default them so callers that load the packaged script directly remain compatible.
+local repairMissingExpiry = ARGV[5] or '0'
+local completedTtl = ttl
+if ARGV[6] ~= nil then
+  completedTtl = tonumber(ARGV[6])
+  if completedTtl == nil then
+    error('idempotency-key-reserve: completed ttl must be a number')
+  end
+end
+if ttl <= 0 or completedTtl <= 0 then
+  error('idempotency-key-reserve: ttl and completed ttl must be positive')
+end
+if repairMissingExpiry ~= '0' and repairMissingExpiry ~= '1' then
+  error('idempotency-key-reserve: repair flag must be 0 or 1')
+end
+
 local existing = redis.call('GET', KEYS[1])
 if existing then
+  if repairMissingExpiry == '1' then
+    if existing == completedValue then
+      redis.call('EXPIRE', KEYS[1], completedTtl, 'NX')
+    else
+      redis.call('EXPIRE', KEYS[1], ttl, 'NX')
+    end
+  end
   if existing == completedValue then
     return completedValue
   end

package/dist/scripts/unlink-if-value-matches.lua

@@ -0,0 +1,14 @@
+-- Atomically unlink a key only when its stored value matches the expected value.
+-- KEYS[1] = key
+-- ARGV[1] = expected value
+-- Returns: 1 when unlinked, 0 when absent or changed.
+if ARGV[1] == nil then
+  error('unlink-if-value-matches: expected value is required')
+end
+
+local existing = redis.call('GET', KEYS[1])
+if existing and existing == ARGV[1] then
+  redis.call('UNLINK', KEYS[1])
+  return 1
+end
+return 0

package/dist/valkey-result.d.mts

@@ -0,0 +1,2 @@
+export declare function stringifyValkeyResult(result: unknown): string;
+//# sourceMappingURL=valkey-result.d.mts.map

package/dist/valkey-result.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkey-result.d.mts","sourceRoot":"","sources":["../valkey-result.mts"],"names":[],"mappings":"AAAA,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAM7D"}

package/dist/valkey-result.mjs

@@ -0,0 +1,9 @@
+export function stringifyValkeyResult(result) {
+    if (typeof result === "string")
+        return result;
+    if (typeof result === "number" || typeof result === "bigint" || typeof result === "boolean") {
+        return result.toString();
+    }
+    return JSON.stringify(result) ?? "[unserializable]";
+}
+//# sourceMappingURL=valkey-result.mjs.map

package/dist/valkey-result.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"valkey-result.mjs","sourceRoot":"","sources":["../valkey-result.mts"],"names":[],"mappings":"AAAA,MAAM,UAAU,qBAAqB,CAAC,MAAe;IACnD,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,OAAO,MAAM,KAAK,SAAS,EAAE,CAAC;QAC5F,OAAO,MAAM,CAAC,QAAQ,EAAE,CAAC;IAC3B,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,kBAAkB,CAAC;AACtD,CAAC"}

package/docs/api.md

@@ -16,7 +16,7 @@ This is the entry point for the public `valkyries` API. Detailed API documentati
 - [Events and metrics](events-and-metrics.md) - `valkeyEvents`, cache metrics, event payloads, and error handling hooks.
 - [Lua scripts](lua-scripts.md) - packaged Lua scripts and script-loading helpers.
 - [Configuration](configuration.md) - environment variables and connection behavior.
-- [Utilities](utilities.md) - key normalization, cache serialization helpers, TTL/count normalization, and timing helpers.
+- [Utilities](utilities.md) - key and Valkey result normalization helpers.
 
 ## Package Entry Points
 

package/docs/cache.md

@@ -209,6 +209,19 @@ ValkeyCache.invalidate(prefix: string, client?: GlideClient): Promise<void>
 
 Deletes every cache key for `prefix`. Passing an empty prefix invalidates all cache namespaces visible to the client.
 
+## `ValkeyCache.invalidateMany(prefixes, client?)`
+
+```ts
+ValkeyCache.invalidateMany(
+  prefixes: readonly string[],
+  client?: GlideClient,
+): Promise<void>
+```
+
+Deletes every cache key for the supplied prefixes with one cursor scan. Duplicate prefixes are
+ignored, an empty list is a no-op, and an empty prefix invalidates all cache namespaces visible to
+the client.
+
 ## `getKey(key)`
 
 ```ts

package/docs/clients.md

@@ -107,11 +107,3 @@ onGracefulShutdown(): Promise<void>
 ```
 
 Both exports point to the same idempotent shutdown function. It closes all live dynamic configs, package-managed clients, and the dynamic-config subscription client.
-
-## `deleteKeysWithPrefix(client, pattern)`
-
-```ts
-deleteKeysWithPrefix(client: GlideClient, pattern: string): Promise<void>
-```
-
-Scans keys matching `pattern` and unlinks them in batches. This helper is used by cache and rate-limiter invalidation APIs.

package/docs/conditional-operations.md

@@ -0,0 +1,24 @@
+# Conditional Operations
+
+Generic single-key operations for application-owned Valkey values.
+
+## `unlinkIfValueMatches(key, expectedValue, options?)`
+
+```ts
+unlinkIfValueMatches(
+  key: string,
+  expectedValue: string,
+  options?: { client?: GlideClient },
+): Promise<boolean>
+```
+
+Atomically reads and unlinks one key using a Lua script.
+
+- Returns `true` only when the stored string matched `expectedValue` and was unlinked.
+- Returns `false` when the key is absent or its value changed.
+- Accepts an empty expected value, but the key must be non-empty.
+- Throws Valkey/client errors and unexpected script responses.
+- Defaults to the package cache client.
+
+The helper is single-key and Redis Cluster safe. Callers own key naming and any hash tags needed
+to colocate this key with other application operations.

package/docs/idempotency-key.md

@@ -26,6 +26,9 @@ reserveIdempotencyKey(
     processingPrefix?: string;
     completedValue?: string;
     token?: string;
+    repairMissingExpiry?: {
+      completedTtlSeconds?: number;
+    };
   },
 ): Promise<
   | { state: "reserved"; token: string }
@@ -38,6 +41,10 @@ Atomically reserves a key when it is absent by storing `processing:<token>` with
 - Generates a random token by default.
 - Returns `processing` when another reservation is active.
 - Returns `completed` when the dedup key has already completed.
+- When `repairMissingExpiry` is present, persistent existing processing values receive
+  `ttlSeconds` and persistent completed values receive `completedTtlSeconds`.
+- `completedTtlSeconds` defaults to `ttlSeconds`; `EXPIRE ... NX` preserves existing expirations.
+- Missing-expiry repair is disabled by default.
 - The caller owns key naming and Redis Cluster hash tags.
 
 ## `completeIdempotencyKey(key, token, ttlSeconds, options?)`
@@ -53,10 +60,14 @@ completeIdempotencyKey(
 
 Atomically changes `processing:<token>` to `completed` with `EX ttlSeconds`.
 
-- `completed`: the caller still owned the reservation and completion was recorded.
+- `completed`: completion is recorded, including when the key was already completed.
 - `missing`: the key was absent.
 - `changed`: the key existed but did not match the caller's token.
 
+Completed values do not retain their reservation token, so an already-completed result cannot
+prove which owner originally completed it. Treating that result as success makes completion safe
+to retry after an ambiguous client or network failure.
+
 ## `releaseIdempotencyKey(key, token, options?)`
 
 ```ts
@@ -93,7 +104,7 @@ try {
 ## Validation
 
 - `key`, `token`, `processingPrefix`, and `completedValue` must be non-empty.
-- `ttlSeconds` must be greater than `0`.
+- `ttlSeconds` and `completedTtlSeconds` must be positive safe integers.
 - `processingPrefix` must not equal `completedValue`.
 - `processingPrefix` and `completedValue` must not equal script result sentinels:
   `reserved`, `missing`, or `changed`.

package/docs/lua-scripts.md

@@ -48,9 +48,13 @@ Dynamic config scripts:
 Idempotency key scripts:
 
 - `idempotency-key-complete-if-current.lua`
-- `idempotency-key-release-if-current.lua`
+- `idempotency-key-release-if-current.lua` (compatibility filename; new code uses conditional unlink)
 - `idempotency-key-reserve.lua`
 
+Conditional operation scripts:
+
+- `unlink-if-value-matches.lua`
+
 Rate limiter scripts:
 
 - `rate-limiter-add.lua`

package/docs/utilities.md

@@ -1,6 +1,6 @@
 # Utilities
 
-These helpers are exported from the package root for applications that need the same normalization and serialization behavior as the built-in classes.
+These normalization helpers are exported from the package root.
 
 ## `normalizeKey(key)`
 
@@ -25,41 +25,3 @@ normalizeCountResult(value: unknown): number
 ```
 
 Normalizes numeric or bigint Valkey counts. Returns `0` for unexpected values.
-
-## `ValkeyCacheTypeError`
-
-```ts
-class ValkeyCacheTypeError extends TypeError
-```
-
-Thrown when a cache value does not match the configured mode.
-
-## `serializeValue(value, mode)`
-
-```ts
-serializeValue(
-  value: unknown,
-  mode: "json" | "text" | "buffer",
-): Promise<string | Buffer>
-```
-
-Serializes values for cache storage and gzip-compresses payloads larger than 2 KiB.
-
-## `decodeValue(result, mode)`
-
-```ts
-decodeValue(
-  result: GlideString | null,
-  mode: "json" | "text" | "buffer",
-): Promise<string | Buffer | Record<string, unknown> | null>
-```
-
-Decodes and decompresses cache values. Returns `null` for Valkey misses.
-
-## `durationInMilliseconds(start)`
-
-```ts
-durationInMilliseconds(start: bigint): number
-```
-
-Converts a `process.hrtime.bigint()` start timestamp to elapsed milliseconds.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "valkyries",
-  "version": "0.5.0",
+  "version": "0.6.0",
   "description": "Valkey utilities for caches, bloom filters, dynamic configuration, and rate limiting.",
   "homepage": "https://github.com/jonathanong/valkyries#readme",
   "bugs": {
@@ -32,6 +32,11 @@
       "import": "./dist/cache.mjs",
       "default": "./dist/cache.mjs"
     },
+    "./conditional": {
+      "types": "./dist/conditional.d.mts",
+      "import": "./dist/conditional.mjs",
+      "default": "./dist/conditional.mjs"
+    },
     "./bloom-filter": {
       "types": "./dist/bloom-filter.d.mts",
       "import": "./dist/bloom-filter.mjs",
@@ -57,12 +62,12 @@
     "@valkey/valkey-glide": "^2.4.0"
   },
   "devDependencies": {
-    "@types/node": "^25.8.0",
+    "@types/node": "^26.1.0",
     "@vitest/coverage-v8": "^4.1.6",
     "github-actionlint": "^1.7.12",
-    "oxfmt": "^0.52.0",
+    "oxfmt": "^0.57.0",
     "oxlint": "^1.65.0",
-    "oxlint-tsgolint": "^0.23.0",
+    "oxlint-tsgolint": "^0.24.0",
     "tsx": "^4.22.1",
     "typescript": "^6.0.3",
     "vitest": "^4.1.6"