@zlink-systems/framework-locations-redis 0.21.0 → 0.22.0

package/dist/opaque-redis-scripts.js

@@ -39,7 +39,9 @@ local function encodeMember(originalKey, bytes, version, expiresAtMs, tombstone)
     })
 end
 `;
-exports.OPAQUE_READ_SCRIPT = PROLOGUE + DECODE_HELPERS + `
+exports.OPAQUE_READ_SCRIPT = PROLOGUE +
+    DECODE_HELPERS +
+    `
 local record = liveRecordAt(KEYS[1], nowMs)
 if not record then return {0, nowMs} end
 return {1, nowMs, record[1], record[2], record[3], tostring(tonumber(record[4]))}
@@ -54,7 +56,9 @@ return {1, nowMs, record[1], record[2], record[3], tostring(tonumber(record[4]))
 //           ['put', keyIndex, originalKey, retentionMsOrFalse]
 //           | ['delete', keyIndex, originalKey]
 // ARGV[3..] = one raw-bytes argument per 'put' mutation, in mutation order.
-exports.OPAQUE_WRITE_SCRIPT = PROLOGUE + DECODE_HELPERS + `
+exports.OPAQUE_WRITE_SCRIPT = PROLOGUE +
+    DECODE_HELPERS +
+    `
 local indexKey = KEYS[1]
 local mapKey = KEYS[2]
 local cleanupKey = KEYS[3]
@@ -163,7 +167,8 @@ return result
 // Shared body for point-in-time paged scanning. KEYS[1]=indexKey,
 // KEYS[2]=mapKey, KEYS[3]=snapshotKey, KEYS[4]=cleanupKey,
 // KEYS[5]=sequenceKey, KEYS[6]=snapshotExpiryKey, KEYS[7]=snapshotBoundaryKey.
-const SCAN_CLEANUP_AND_BOUNDARY = DECODE_HELPERS + `
+const SCAN_CLEANUP_AND_BOUNDARY = DECODE_HELPERS +
+    `
 local expiredSnapshots = redis.call('ZRANGEBYSCORE', KEYS[6], '-inf', nowMs, 'LIMIT', 0, 128)
 for _, expiredId in ipairs(expiredSnapshots) do
     redis.call('ZREM', KEYS[6], expiredId)
@@ -267,7 +272,9 @@ end
 return result
 `;
 // ARGV = [prefix, limit, snapshotId]
-exports.OPAQUE_SCAN_START_SCRIPT = PROLOGUE + SCAN_CLEANUP_AND_BOUNDARY + `
+exports.OPAQUE_SCAN_START_SCRIPT = PROLOGUE +
+    SCAN_CLEANUP_AND_BOUNDARY +
+    `
 local prefix = ARGV[1]
 local limit = tonumber(ARGV[2])
 local snapshotId = ARGV[3]
@@ -282,9 +289,12 @@ redis.call('HSET', KEYS[3], 'now', tostring(nowMs), 'boundary', tostring(boundar
 redis.call('PEXPIRE', KEYS[3], 60000)
 redis.call('ZADD', KEYS[6], nowMs + 60000, snapshotId)
 redis.call('ZADD', KEYS[7], boundary, snapshotId)
-` + SCAN_PAGE_READ;
+` +
+    SCAN_PAGE_READ;
 // ARGV = [prefix, lastKeyHex, limit, snapshotId]
-exports.OPAQUE_SCAN_CONTINUE_SCRIPT = PROLOGUE + SCAN_CLEANUP_AND_BOUNDARY + `
+exports.OPAQUE_SCAN_CONTINUE_SCRIPT = PROLOGUE +
+    SCAN_CLEANUP_AND_BOUNDARY +
+    `
 local prefix = ARGV[1]
 local lastKey = ARGV[2]
 local limit = tonumber(ARGV[3])
@@ -295,13 +305,15 @@ if redis.call('EXISTS', KEYS[3]) == 0 then
     redis.call('ZREM', KEYS[7], snapshotId)
     return {'expired'}
 end
-` + SCAN_PAGE_READ;
+` +
+    SCAN_PAGE_READ;
 // Relocation Store: raw-bytes STRING payloads at
 // {prefix}:zlink-relocation-v1:blob:{reference}, retention via PSETEX/PX
 // (23-relocation-store-redis.md#8). KEYS[1] is the blob key -- the reference
 // itself is already the key's last segment, so identity on retry is decided
 // by comparing the stored bytes against ARGV[1].
-exports.BLOB_PUT_SCRIPT = PROLOGUE + `
+exports.BLOB_PUT_SCRIPT = PROLOGUE +
+    `
 local existing = redis.call('GET', KEYS[1])
 if existing then
     if existing ~= ARGV[1] then
@@ -315,14 +327,16 @@ local retentionMs = tonumber(ARGV[2])
 redis.call('SET', KEYS[1], ARGV[1], 'PX', retentionMs)
 return {'stored', nowMs, tostring(nowMs + retentionMs)}
 `;
-exports.BLOB_READ_SCRIPT = PROLOGUE + `
+exports.BLOB_READ_SCRIPT = PROLOGUE +
+    `
 local bytes = redis.call('GET', KEYS[1])
 if not bytes then return {0, nowMs} end
 local ttl = redis.call('PTTL', KEYS[1])
 local expiresAtMs = nowMs + math.max(ttl, 0)
 return {1, nowMs, bytes, tostring(expiresAtMs)}
 `;
-exports.BLOB_RENEW_SCRIPT = PROLOGUE + `
+exports.BLOB_RENEW_SCRIPT = PROLOGUE +
+    `
 if redis.call('EXISTS', KEYS[1]) == 0 then return {0, nowMs} end
 local retentionMs = tonumber(ARGV[1])
 redis.call('PEXPIRE', KEYS[1], retentionMs)

package/dist/opaque-store.js

@@ -50,7 +50,7 @@ class ZLinkRedisLocationStore {
             this.sequenceKey(),
             this.snapshotExpiryKey(),
             this.snapshotBoundaryKey(),
-            ...encoded.keys.map(key => this.rowKey(key))
+            ...encoded.keys.map((key) => this.rowKey(key))
         ], [
             JSON.stringify(encoded.conditions),
             JSON.stringify(encoded.mutations),
@@ -161,10 +161,10 @@ class ZLinkRedisLocationStore {
 }
 exports.ZLinkRedisLocationStore = ZLinkRedisLocationStore;
 function encodeWrite(request) {
-    const conditionKeys = request.conditions.map(condition => requireKey(condition.key));
-    const mutationKeys = request.mutations.map(mutation => requireKey(mutation.key));
-    if (new Set(conditionKeys).size !== conditionKeys.length
-        || new Set(mutationKeys).size !== mutationKeys.length) {
+    const conditionKeys = request.conditions.map((condition) => requireKey(condition.key));
+    const mutationKeys = request.mutations.map((mutation) => requireKey(mutation.key));
+    if (new Set(conditionKeys).size !== conditionKeys.length ||
+        new Set(mutationKeys).size !== mutationKeys.length) {
         throw new RangeError('Location Store condition and mutation keys must be unique.');
     }
     const keys = [...new Set([...conditionKeys, ...mutationKeys])];
@@ -175,7 +175,7 @@ function encodeWrite(request) {
     // adds 6 to this 1-based index before indexing into KEYS.
     const keyIndex = new Map(keys.map((key, index) => [key, index + 1]));
     let encodedBytes = 0;
-    const conditions = request.conditions.map(condition => {
+    const conditions = request.conditions.map((condition) => {
         const key = requireKey(condition.key);
         encodedBytes += Buffer.byteLength(key, 'utf8');
         if (condition.kind === 'missing')
@@ -185,7 +185,7 @@ function encodeWrite(request) {
         return ['version', keyIndex.get(key), key, expected];
     });
     const putBytes = [];
-    const mutations = request.mutations.map(mutation => {
+    const mutations = request.mutations.map((mutation) => {
         const key = requireKey(mutation.key);
         encodedBytes += Buffer.byteLength(key, 'utf8');
         if (mutation.kind === 'delete')
@@ -193,12 +193,7 @@ function encodeWrite(request) {
         requireValue(mutation.bytes, mutation.retentionMs);
         encodedBytes += mutation.bytes.byteLength;
         putBytes.push(Buffer.from(mutation.bytes));
-        return [
-            'put',
-            keyIndex.get(key),
-            key,
-            mutation.retentionMs ?? false
-        ];
+        return ['put', keyIndex.get(key), key, mutation.retentionMs ?? false];
     });
     if (encodedBytes > MAX_WRITE_BYTES) {
         throw new RangeError('Location Store write exceeds 4 MiB encoded input.');
@@ -248,8 +243,7 @@ function requireValue(bytes, retentionMs) {
     if (bytes.byteLength > MAX_VALUE_BYTES) {
         throw new RangeError('Location Store value exceeds 1 MiB.');
     }
-    if (retentionMs !== undefined
-        && (!Number.isSafeInteger(retentionMs) || retentionMs < 1)) {
+    if (retentionMs !== undefined && (!Number.isSafeInteger(retentionMs) || retentionMs < 1)) {
         throw new RangeError('Location Store retention must be a positive safe integer.');
     }
 }
@@ -258,9 +252,9 @@ function parseCursor(cursor) {
     const separator = value.lastIndexOf(':');
     const snapshotId = separator < 0 ? '' : value.slice(0, separator);
     const lastKeyHex = separator < 0 ? '' : value.slice(separator + 1);
-    if (!/^[0-9a-f-]{36}$/.test(snapshotId)
-        || !/^[0-9a-f]*$/.test(lastKeyHex)
-        || lastKeyHex.length % 2 !== 0) {
+    if (!/^[0-9a-f-]{36}$/.test(snapshotId) ||
+        !/^[0-9a-f]*$/.test(lastKeyHex) ||
+        lastKeyHex.length % 2 !== 0) {
         throw new RangeError('Location Store scan cursor is invalid.');
     }
     return { snapshotId, lastKey: Buffer.from(lastKeyHex, 'hex').toString('utf8') };

package/dist/redis-connection.js

@@ -97,14 +97,13 @@ function requireOptions(options) {
     if (options.keyPrefix.includes('{') || options.keyPrefix.includes('}')) {
         throw new Error('Redis Store keyPrefix must not contain hash-tag braces.');
     }
-    if (options.client === undefined
-        && options.url === undefined
-        && options.clientOptions === undefined) {
+    if (options.client === undefined &&
+        options.url === undefined &&
+        options.clientOptions === undefined) {
         throw new Error('Redis Store requires url, clientOptions, or client.');
     }
-    if (options.operationTimeoutMs !== undefined
-        && (!Number.isSafeInteger(options.operationTimeoutMs)
-            || options.operationTimeoutMs < 1)) {
+    if (options.operationTimeoutMs !== undefined &&
+        (!Number.isSafeInteger(options.operationTimeoutMs) || options.operationTimeoutMs < 1)) {
         throw new RangeError('Redis Store operationTimeoutMs must be a positive safe integer.');
     }
 }
@@ -131,6 +130,6 @@ async function waitForOperation(operation, signal, timeoutMs) {
         if (timeoutMs !== undefined) {
             timeout = setTimeout(() => settle(() => reject(new Error(`Redis Store operation timed out after ${timeoutMs} ms.`))), timeoutMs);
         }
-        operation.then(value => settle(() => resolve(value)), error => settle(() => reject(error)));
+        operation.then((value) => settle(() => resolve(value)), (error) => settle(() => reject(error)));
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zlink-systems/framework-locations-redis",
-  "version": "0.21.0",
+  "version": "0.22.0",
   "license": "SEE LICENSE IN LICENSE",
   "repository": {
     "type": "git",
@@ -17,7 +17,7 @@
     }
   },
   "dependencies": {
-    "@zlink-systems/framework": "0.21.0",
+    "@zlink-systems/framework": "0.22.0",
     "@zlink-systems/zlink": "1.2.1",
     "redis": "^6.1.0"
   }

package/src/opaque-redis-scripts.ts

@@ -38,7 +38,10 @@ local function encodeMember(originalKey, bytes, version, expiresAtMs, tombstone)
 end
 `;
 
-export const OPAQUE_READ_SCRIPT = PROLOGUE + DECODE_HELPERS + `
+export const OPAQUE_READ_SCRIPT =
+  PROLOGUE +
+  DECODE_HELPERS +
+  `
 local record = liveRecordAt(KEYS[1], nowMs)
 if not record then return {0, nowMs} end
 return {1, nowMs, record[1], record[2], record[3], tostring(tonumber(record[4]))}
@@ -54,7 +57,10 @@ return {1, nowMs, record[1], record[2], record[3], tostring(tonumber(record[4]))
 //           ['put', keyIndex, originalKey, retentionMsOrFalse]
 //           | ['delete', keyIndex, originalKey]
 // ARGV[3..] = one raw-bytes argument per 'put' mutation, in mutation order.
-export const OPAQUE_WRITE_SCRIPT = PROLOGUE + DECODE_HELPERS + `
+export const OPAQUE_WRITE_SCRIPT =
+  PROLOGUE +
+  DECODE_HELPERS +
+  `
 local indexKey = KEYS[1]
 local mapKey = KEYS[2]
 local cleanupKey = KEYS[3]
@@ -164,7 +170,9 @@ return result
 // Shared body for point-in-time paged scanning. KEYS[1]=indexKey,
 // KEYS[2]=mapKey, KEYS[3]=snapshotKey, KEYS[4]=cleanupKey,
 // KEYS[5]=sequenceKey, KEYS[6]=snapshotExpiryKey, KEYS[7]=snapshotBoundaryKey.
-const SCAN_CLEANUP_AND_BOUNDARY = DECODE_HELPERS + `
+const SCAN_CLEANUP_AND_BOUNDARY =
+  DECODE_HELPERS +
+  `
 local expiredSnapshots = redis.call('ZRANGEBYSCORE', KEYS[6], '-inf', nowMs, 'LIMIT', 0, 128)
 for _, expiredId in ipairs(expiredSnapshots) do
     redis.call('ZREM', KEYS[6], expiredId)
@@ -270,7 +278,10 @@ return result
 `;
 
 // ARGV = [prefix, limit, snapshotId]
-export const OPAQUE_SCAN_START_SCRIPT = PROLOGUE + SCAN_CLEANUP_AND_BOUNDARY + `
+export const OPAQUE_SCAN_START_SCRIPT =
+  PROLOGUE +
+  SCAN_CLEANUP_AND_BOUNDARY +
+  `
 local prefix = ARGV[1]
 local limit = tonumber(ARGV[2])
 local snapshotId = ARGV[3]
@@ -285,10 +296,14 @@ redis.call('HSET', KEYS[3], 'now', tostring(nowMs), 'boundary', tostring(boundar
 redis.call('PEXPIRE', KEYS[3], 60000)
 redis.call('ZADD', KEYS[6], nowMs + 60000, snapshotId)
 redis.call('ZADD', KEYS[7], boundary, snapshotId)
-` + SCAN_PAGE_READ;
+` +
+  SCAN_PAGE_READ;
 
 // ARGV = [prefix, lastKeyHex, limit, snapshotId]
-export const OPAQUE_SCAN_CONTINUE_SCRIPT = PROLOGUE + SCAN_CLEANUP_AND_BOUNDARY + `
+export const OPAQUE_SCAN_CONTINUE_SCRIPT =
+  PROLOGUE +
+  SCAN_CLEANUP_AND_BOUNDARY +
+  `
 local prefix = ARGV[1]
 local lastKey = ARGV[2]
 local limit = tonumber(ARGV[3])
@@ -299,14 +314,17 @@ if redis.call('EXISTS', KEYS[3]) == 0 then
     redis.call('ZREM', KEYS[7], snapshotId)
     return {'expired'}
 end
-` + SCAN_PAGE_READ;
+` +
+  SCAN_PAGE_READ;
 
 // Relocation Store: raw-bytes STRING payloads at
 // {prefix}:zlink-relocation-v1:blob:{reference}, retention via PSETEX/PX
 // (23-relocation-store-redis.md#8). KEYS[1] is the blob key -- the reference
 // itself is already the key's last segment, so identity on retry is decided
 // by comparing the stored bytes against ARGV[1].
-export const BLOB_PUT_SCRIPT = PROLOGUE + `
+export const BLOB_PUT_SCRIPT =
+  PROLOGUE +
+  `
 local existing = redis.call('GET', KEYS[1])
 if existing then
     if existing ~= ARGV[1] then
@@ -321,7 +339,9 @@ redis.call('SET', KEYS[1], ARGV[1], 'PX', retentionMs)
 return {'stored', nowMs, tostring(nowMs + retentionMs)}
 `;
 
-export const BLOB_READ_SCRIPT = PROLOGUE + `
+export const BLOB_READ_SCRIPT =
+  PROLOGUE +
+  `
 local bytes = redis.call('GET', KEYS[1])
 if not bytes then return {0, nowMs} end
 local ttl = redis.call('PTTL', KEYS[1])
@@ -329,7 +349,9 @@ local expiresAtMs = nowMs + math.max(ttl, 0)
 return {1, nowMs, bytes, tostring(expiresAtMs)}
 `;
 
-export const BLOB_RENEW_SCRIPT = PROLOGUE + `
+export const BLOB_RENEW_SCRIPT =
+  PROLOGUE +
+  `
 if redis.call('EXISTS', KEYS[1]) == 0 then return {0, nowMs} end
 local retentionMs = tonumber(ARGV[1])
 redis.call('PEXPIRE', KEYS[1], retentionMs)

package/src/opaque-store.ts

@@ -43,17 +43,11 @@ export class ZLinkRedisLocationStore implements ZLinkLocationStore {
     this.domain = `${options.keyPrefix}:${NAMESPACE}`;
   }
 
-  async read(
-    key: ZLinkStoreKey,
-    signal?: AbortSignal
-  ): Promise<ZLinkStoreReadResult> {
+  async read(key: ZLinkStoreKey, signal?: AbortSignal): Promise<ZLinkStoreReadResult> {
     const logicalKey = requireKey(key);
-    const result = asArray(await this.connection.eval(
-      OPAQUE_READ_SCRIPT,
-      [this.rowKey(logicalKey)],
-      [],
-      signal
-    ));
+    const result = asArray(
+      await this.connection.eval(OPAQUE_READ_SCRIPT, [this.rowKey(logicalKey)], [], signal)
+    );
     const storeNow = fromUnixMs(toNumber(result[1]));
     if (toNumber(result[0]) !== 1) return { kind: 'missing', storeNow };
     requireMatchingKey(asString(result[2]), logicalKey);
@@ -73,24 +67,26 @@ export class ZLinkRedisLocationStore implements ZLinkLocationStore {
     signal?: AbortSignal
   ): Promise<ZLinkStoreWriteResult> {
     const encoded = encodeWrite(request);
-    const result = asArray(await this.connection.eval(
-      OPAQUE_WRITE_SCRIPT,
-      [
-        this.indexKey(),
-        this.mapKey(),
-        this.cleanupKey(),
-        this.sequenceKey(),
-        this.snapshotExpiryKey(),
-        this.snapshotBoundaryKey(),
-        ...encoded.keys.map(key => this.rowKey(key))
-      ],
-      [
-        JSON.stringify(encoded.conditions),
-        JSON.stringify(encoded.mutations),
-        ...encoded.putBytes
-      ],
-      signal
-    ));
+    const result = asArray(
+      await this.connection.eval(
+        OPAQUE_WRITE_SCRIPT,
+        [
+          this.indexKey(),
+          this.mapKey(),
+          this.cleanupKey(),
+          this.sequenceKey(),
+          this.snapshotExpiryKey(),
+          this.snapshotBoundaryKey(),
+          ...encoded.keys.map((key) => this.rowKey(key))
+        ],
+        [
+          JSON.stringify(encoded.conditions),
+          JSON.stringify(encoded.mutations),
+          ...encoded.putBytes
+        ],
+        signal
+      )
+    );
     const storeNow = fromUnixMs(toNumber(result[1]));
     const outcome = asString(result[0]);
     if (outcome === 'conflict') return { kind: 'conflict', storeNow };
@@ -110,10 +106,7 @@ export class ZLinkRedisLocationStore implements ZLinkLocationStore {
     return { kind: 'applied', putVersions, storeNow };
   }
 
-  async scan(
-    request: ZLinkStoreScanRequest,
-    signal?: AbortSignal
-  ): Promise<ZLinkStoreScanResult> {
+  async scan(request: ZLinkStoreScanRequest, signal?: AbortSignal): Promise<ZLinkStoreScanResult> {
     requireScanRequest(request);
     if (request.cursor === undefined) {
       const snapshotId = randomUUID();
@@ -143,10 +136,7 @@ export class ZLinkRedisLocationStore implements ZLinkLocationStore {
     await this.connection.dispose();
   }
 
-  private async readScanPage(
-    snapshotId: string,
-    raw: unknown
-  ): Promise<ZLinkStoreScanResult> {
+  private async readScanPage(snapshotId: string, raw: unknown): Promise<ZLinkStoreScanResult> {
     const result = asArray(raw);
     const outcome = asString(result[0]);
     if (outcome === 'expired') return { kind: 'expired' };
@@ -174,9 +164,10 @@ export class ZLinkRedisLocationStore implements ZLinkLocationStore {
       kind: 'page',
       value: {
         items,
-        nextCursor: nextKey.length === 0
-          ? undefined
-          : scanCursor(`${snapshotId}:${Buffer.from(nextKey, 'utf8').toString('hex')}`),
+        nextCursor:
+          nextKey.length === 0
+            ? undefined
+            : scanCursor(`${snapshotId}:${Buffer.from(nextKey, 'utf8').toString('hex')}`),
         storeNow
       }
     };
@@ -235,11 +226,11 @@ interface EncodedWrite {
 }
 
 function encodeWrite(request: ZLinkStoreWriteRequest): EncodedWrite {
-  const conditionKeys = request.conditions.map(condition => requireKey(condition.key));
-  const mutationKeys = request.mutations.map(mutation => requireKey(mutation.key));
+  const conditionKeys = request.conditions.map((condition) => requireKey(condition.key));
+  const mutationKeys = request.mutations.map((mutation) => requireKey(mutation.key));
   if (
-    new Set(conditionKeys).size !== conditionKeys.length
-    || new Set(mutationKeys).size !== mutationKeys.length
+    new Set(conditionKeys).size !== conditionKeys.length ||
+    new Set(mutationKeys).size !== mutationKeys.length
   ) {
     throw new RangeError('Location Store condition and mutation keys must be unique.');
   }
@@ -251,7 +242,7 @@ function encodeWrite(request: ZLinkStoreWriteRequest): EncodedWrite {
   // adds 6 to this 1-based index before indexing into KEYS.
   const keyIndex = new Map(keys.map((key, index) => [key, index + 1]));
   let encodedBytes = 0;
-  const conditions = request.conditions.map(condition => {
+  const conditions = request.conditions.map((condition) => {
     const key = requireKey(condition.key);
     encodedBytes += Buffer.byteLength(key, 'utf8');
     if (condition.kind === 'missing') return ['missing', keyIndex.get(key), key];
@@ -260,19 +251,14 @@ function encodeWrite(request: ZLinkStoreWriteRequest): EncodedWrite {
     return ['version', keyIndex.get(key), key, expected];
   });
   const putBytes: Buffer[] = [];
-  const mutations = request.mutations.map(mutation => {
+  const mutations = request.mutations.map((mutation) => {
     const key = requireKey(mutation.key);
     encodedBytes += Buffer.byteLength(key, 'utf8');
     if (mutation.kind === 'delete') return ['delete', keyIndex.get(key), key];
     requireValue(mutation.bytes, mutation.retentionMs);
     encodedBytes += mutation.bytes.byteLength;
     putBytes.push(Buffer.from(mutation.bytes));
-    return [
-      'put',
-      keyIndex.get(key),
-      key,
-      mutation.retentionMs ?? false
-    ];
+    return ['put', keyIndex.get(key), key, mutation.retentionMs ?? false];
   });
   if (encodedBytes > MAX_WRITE_BYTES) {
     throw new RangeError('Location Store write exceeds 4 MiB encoded input.');
@@ -327,10 +313,7 @@ function requireValue(bytes: Uint8Array, retentionMs: number | undefined): void
   if (bytes.byteLength > MAX_VALUE_BYTES) {
     throw new RangeError('Location Store value exceeds 1 MiB.');
   }
-  if (
-    retentionMs !== undefined
-    && (!Number.isSafeInteger(retentionMs) || retentionMs < 1)
-  ) {
+  if (retentionMs !== undefined && (!Number.isSafeInteger(retentionMs) || retentionMs < 1)) {
     throw new RangeError('Location Store retention must be a positive safe integer.');
   }
 }
@@ -344,9 +327,9 @@ function parseCursor(cursor: ZLinkStoreScanCursor): {
   const snapshotId = separator < 0 ? '' : value.slice(0, separator);
   const lastKeyHex = separator < 0 ? '' : value.slice(separator + 1);
   if (
-    !/^[0-9a-f-]{36}$/.test(snapshotId)
-    || !/^[0-9a-f]*$/.test(lastKeyHex)
-    || lastKeyHex.length % 2 !== 0
+    !/^[0-9a-f-]{36}$/.test(snapshotId) ||
+    !/^[0-9a-f]*$/.test(lastKeyHex) ||
+    lastKeyHex.length % 2 !== 0
   ) {
     throw new RangeError('Location Store scan cursor is invalid.');
   }

package/src/redis-connection.ts

@@ -1,9 +1,6 @@
 import { createClient, RESP_TYPES } from 'redis';
 import type { RedisClientType } from 'redis';
-import type {
-  ZLinkRedisLocationOptions,
-  ZLinkRedisRelocationOptions
-} from './redis-options';
+import type { ZLinkRedisLocationOptions, ZLinkRedisRelocationOptions } from './redis-options';
 
 export type RedisCommandValue = string | Buffer;
 export type RedisCommandClient = Pick<
@@ -56,10 +53,7 @@ export class RedisConnection {
     args: readonly RedisCommandValue[],
     signal?: AbortSignal
   ): Promise<unknown> {
-    return await this.command(
-      ['EVAL', script, String(keys.length), ...keys, ...args],
-      signal
-    );
+    return await this.command(['EVAL', script, String(keys.length), ...keys, ...args], signal);
   }
 
   async dispose(): Promise<void> {
@@ -110,9 +104,7 @@ function isClientReady(client: RedisCommandClient): boolean {
   return client.isReady === true;
 }
 
-function requireOptions(
-  options: ZLinkRedisLocationOptions | ZLinkRedisRelocationOptions
-): void {
+function requireOptions(options: ZLinkRedisLocationOptions | ZLinkRedisRelocationOptions): void {
   if (options.keyPrefix.length === 0) {
     throw new Error('Redis Store keyPrefix is required.');
   }
@@ -120,16 +112,15 @@ function requireOptions(
     throw new Error('Redis Store keyPrefix must not contain hash-tag braces.');
   }
   if (
-    options.client === undefined
-    && options.url === undefined
-    && options.clientOptions === undefined
+    options.client === undefined &&
+    options.url === undefined &&
+    options.clientOptions === undefined
   ) {
     throw new Error('Redis Store requires url, clientOptions, or client.');
   }
   if (
-    options.operationTimeoutMs !== undefined
-    && (!Number.isSafeInteger(options.operationTimeoutMs)
-      || options.operationTimeoutMs < 1)
+    options.operationTimeoutMs !== undefined &&
+    (!Number.isSafeInteger(options.operationTimeoutMs) || options.operationTimeoutMs < 1)
   ) {
     throw new RangeError('Redis Store operationTimeoutMs must be a positive safe integer.');
   }
@@ -154,21 +145,19 @@ async function waitForOperation<T>(
       cleanup();
       action();
     };
-    const onAbort = () => settle(
-      () => reject(signal?.reason ?? new Error('Redis Store operation aborted.'))
-    );
+    const onAbort = () =>
+      settle(() => reject(signal?.reason ?? new Error('Redis Store operation aborted.')));
     signal?.addEventListener('abort', onAbort, { once: true });
     if (timeoutMs !== undefined) {
       timeout = setTimeout(
-        () => settle(() =>
-          reject(new Error(`Redis Store operation timed out after ${timeoutMs} ms.`))
-        ),
+        () =>
+          settle(() => reject(new Error(`Redis Store operation timed out after ${timeoutMs} ms.`))),
         timeoutMs
       );
     }
     operation.then(
-      value => settle(() => resolve(value)),
-      error => settle(() => reject(error))
+      (value) => settle(() => resolve(value)),
+      (error) => settle(() => reject(error))
     );
   });
 }

package/src/relocation-store.ts

@@ -7,11 +7,7 @@ import type {
 } from '@zlink-systems/framework';
 import type { ZLinkRedisRelocationOptions } from './redis-options';
 import { RedisConnection } from './redis-connection';
-import {
-  BLOB_PUT_SCRIPT,
-  BLOB_READ_SCRIPT,
-  BLOB_RENEW_SCRIPT
-} from './opaque-redis-scripts';
+import { BLOB_PUT_SCRIPT, BLOB_READ_SCRIPT, BLOB_RENEW_SCRIPT } from './opaque-redis-scripts';
 import { asArray, asString, toNumber } from './redis-values';
 
 const MAX_ENCODED_BLOB_BYTES = 64 * 1024 * 1024 + 23;
@@ -38,12 +34,14 @@ export class ZLinkRedisRelocationStore implements ZLinkRelocationStore {
     const referenceValue = requireReference(reference);
     requirePayload(payload);
     const retention = requireRetention(retentionMs);
-    const result = asArray(await this.connection.eval(
-      BLOB_PUT_SCRIPT,
-      [this.blobKey(referenceValue)],
-      [Buffer.from(payload), String(retention)],
-      signal
-    ));
+    const result = asArray(
+      await this.connection.eval(
+        BLOB_PUT_SCRIPT,
+        [this.blobKey(referenceValue)],
+        [Buffer.from(payload), String(retention)],
+        signal
+      )
+    );
     const kind = asString(result[0]);
     const storeNow = fromUnixMs(toNumber(result[1]));
     if (kind === 'conflict') return { kind, storeNow };
@@ -54,17 +52,11 @@ export class ZLinkRedisRelocationStore implements ZLinkRelocationStore {
     };
   }
 
-  async read(
-    reference: ZLinkBlobReference,
-    signal?: AbortSignal
-  ): Promise<ZLinkBlobReadResult> {
+  async read(reference: ZLinkBlobReference, signal?: AbortSignal): Promise<ZLinkBlobReadResult> {
     const referenceValue = requireReference(reference);
-    const result = asArray(await this.connection.eval(
-      BLOB_READ_SCRIPT,
-      [this.blobKey(referenceValue)],
-      [],
-      signal
-    ));
+    const result = asArray(
+      await this.connection.eval(BLOB_READ_SCRIPT, [this.blobKey(referenceValue)], [], signal)
+    );
     const storeNow = fromUnixMs(toNumber(result[1]));
     if (toNumber(result[0]) !== 1) return { kind: 'missing', storeNow };
     return {
@@ -82,12 +74,14 @@ export class ZLinkRedisRelocationStore implements ZLinkRelocationStore {
   ): Promise<ZLinkBlobRenewResult> {
     const referenceValue = requireReference(reference);
     const retention = requireRetention(retentionMs);
-    const result = asArray(await this.connection.eval(
-      BLOB_RENEW_SCRIPT,
-      [this.blobKey(referenceValue)],
-      [String(retention)],
-      signal
-    ));
+    const result = asArray(
+      await this.connection.eval(
+        BLOB_RENEW_SCRIPT,
+        [this.blobKey(referenceValue)],
+        [String(retention)],
+        signal
+      )
+    );
     const storeNow = fromUnixMs(toNumber(result[1]));
     if (toNumber(result[0]) !== 1) return { kind: 'missing', storeNow };
     return {
@@ -97,10 +91,7 @@ export class ZLinkRedisRelocationStore implements ZLinkRelocationStore {
     };
   }
 
-  async delete(
-    reference: ZLinkBlobReference,
-    signal?: AbortSignal
-  ): Promise<void> {
+  async delete(reference: ZLinkBlobReference, signal?: AbortSignal): Promise<void> {
     const referenceValue = requireReference(reference);
     await this.connection.command(['DEL', this.blobKey(referenceValue)], signal);
   }