valkyries 0.4.0 → 0.6.0

package/dist/types.d.mts

@@ -12,11 +12,13 @@ export type RateLimiterOptions = {
     /** Optional Valkey client. Defaults to the package rate limiter client. */
     client?: GlideClient;
     /**
-     * Maximum number of retry attempts on inflight-saturation errors (default: VALKEY_INFLIGHT_RETRY_ATTEMPTS env or 3).
+     * Maximum number of retry attempts on inflight-saturation errors
+     * (default: VALKEY_INFLIGHT_RETRY_ATTEMPTS env or 3).
      */
     inflightRetryAttempts?: number;
     /**
-     * Minimum delay in milliseconds between saturation-retry attempts (default: VALKEY_INFLIGHT_RETRY_DELAY_MS env or 1000).
+     * Minimum delay in milliseconds between saturation-retry attempts
+     * (default: VALKEY_INFLIGHT_RETRY_DELAY_MS env or 1000).
      * Actual delay is jittered in [delayMs, delayMs * 5].
      */
     inflightRetryDelayMs?: number;
@@ -38,14 +40,19 @@ export type RateLimiterWindow = {
 export type RateLimiterAddAndCheckWindowsOptions = {
     /** Optional Valkey client. Defaults to the package rate limiter client. */
     client?: GlideClient;
-    /** Stop processing later windows as soon as an earlier window is limited. Defaults to record-all. */
+    /**
+     * Stop processing later windows as soon as an earlier window is limited.
+     * Defaults to record-all.
+     */
     mode?: "record-all" | "stop-on-limited";
     /**
-     * Maximum number of retry attempts on inflight-saturation errors (default: VALKEY_INFLIGHT_RETRY_ATTEMPTS env or 3).
+     * Maximum number of retry attempts on inflight-saturation errors
+     * (default: VALKEY_INFLIGHT_RETRY_ATTEMPTS env or 3).
      */
     inflightRetryAttempts?: number;
     /**
-     * Minimum delay in milliseconds between saturation-retry attempts (default: VALKEY_INFLIGHT_RETRY_DELAY_MS env or 1000).
+     * Minimum delay in milliseconds between saturation-retry attempts
+     * (default: VALKEY_INFLIGHT_RETRY_DELAY_MS env or 1000).
      * Actual delay is jittered in [delayMs, delayMs * 5].
      */
     inflightRetryDelayMs?: number;
@@ -57,7 +64,10 @@ export type ValkeyCacheOptions<K = string> = {
     ttlSeconds: number;
     /** The TTL in seconds for null values, defaults to ttlSeconds / 60 */
     nullTtlSeconds?: number;
-    /** The mode to use: 'json' (default) for JSON serialization, 'text' for raw text storage, 'buffer' for Buffer storage */
+    /**
+     * The mode to use: 'json' (default) for JSON serialization, 'text' for raw
+     * text storage, 'buffer' for Buffer storage
+     */
     mode?: "json" | "text" | "buffer";
     /**
      * Fraction of ttlSeconds representing the age threshold; values are stale when
@@ -66,9 +76,15 @@ export type ValkeyCacheOptions<K = string> = {
     staleTtlAge?: number;
     /** When false, stale cache hits are returned without a background refresh. Defaults to true. */
     staleRefresh?: boolean;
-    /** Optional bloom filter for negative lookups — skip DB calls for entities that definitely don't exist */
+    /**
+     * Optional bloom filter for negative lookups — skip DB calls for entities
+     * that definitely don't exist
+     */
     bloomFilter?: import("./bloom-filter.mts").ValkeyBloomFilter;
-    /** Optional runtime feature flag — if provided, called per-request; bloom filter is bypassed when it returns false */
+    /**
+     * Optional runtime feature flag — if provided, called per-request;
+     * bloom filter is bypassed when it returns false
+     */
     bloomFilterEnabled?: () => boolean;
     /** Optional Valkey client. Defaults to the package cache client. */
     client?: GlideClient;
@@ -80,11 +96,13 @@ export type ValkeyCacheOptions<K = string> = {
      */
     fallbackOnReadError?: boolean;
     /**
-     * Maximum number of retry attempts on inflight-saturation errors (default: VALKEY_INFLIGHT_RETRY_ATTEMPTS env or 3).
+     * Maximum number of retry attempts on inflight-saturation errors
+     * (default: VALKEY_INFLIGHT_RETRY_ATTEMPTS env or 3).
      */
     inflightRetryAttempts?: number;
     /**
-     * Minimum delay in milliseconds between saturation-retry attempts (default: VALKEY_INFLIGHT_RETRY_DELAY_MS env or 1000).
+     * Minimum delay in milliseconds between saturation-retry attempts
+     * (default: VALKEY_INFLIGHT_RETRY_DELAY_MS env or 1000).
      * Actual delay is jittered in [delayMs, delayMs * 5].
      */
     inflightRetryDelayMs?: number;

package/dist/types.d.mts.map

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

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.4.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"