@forklaunch/infrastructure-redis 1.2.10 → 1.3.0

package/lib/eject/infrastructure/redis.ts

@@ -6,6 +6,10 @@ import {
   OpenTelemetryCollector,
   TelemetryOptions
 } from '@forklaunch/core/http';
+import {
+  getCurrentTenantId,
+  type FieldEncryptor
+} from '@forklaunch/core/persistence';
 import { createClient, RedisClientOptions } from 'redis';
 
 /**
@@ -20,36 +24,81 @@ type RedisCommandRawReply =
   | undefined
   | Array<RedisCommandRawReply>;
 
+const ENCRYPTED_PREFIXES = ['v1:', 'v2:'] as const;
+
+function isEncrypted(value: string): boolean {
+  return ENCRYPTED_PREFIXES.some((p) => value.startsWith(p));
+}
+
+/**
+ * Options for configuring encryption on the Redis cache.
+ * Required — every consumer must explicitly configure encryption.
+ */
+export interface RedisCacheEncryptionOptions {
+  /** The FieldEncryptor instance to use for encrypting cache values. */
+  encryptor: FieldEncryptor;
+  /** Set to true to disable encryption. Defaults to false (encryption enabled). */
+  disabled?: boolean;
+}
+
 /**
  * Class representing a Redis-based TTL (Time-To-Live) cache.
  * Implements the TtlCache interface to provide caching functionality with automatic expiration.
+ *
+ * Encryption is enabled by default when an encryptor is provided. Values are encrypted
+ * before storage and decrypted on read using AES-256-GCM with per-tenant key derivation.
  */
 export class RedisTtlCache implements TtlCache {
   private client;
   private telemetryOptions;
+  private encryptor?: FieldEncryptor;
+  private encryptionDisabled: boolean;
 
   /**
    * Creates an instance of RedisTtlCache.
    *
    * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries
    * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics
-   * @param {RedisClientOptions} hostingOptions - Configuration options for the Redis client
+   * @param {RedisClientOptions} options - Configuration options for the Redis client
    * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry
+   * @param {RedisCacheEncryptionOptions} encryption - Encryption configuration (enabled by default)
    */
   constructor(
     private ttlMilliseconds: number,
     private openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,
     options: RedisClientOptions,
-    telemetryOptions: TelemetryOptions
+    telemetryOptions: TelemetryOptions,
+    encryption: RedisCacheEncryptionOptions
   ) {
     this.telemetryOptions = evaluateTelemetryOptions(telemetryOptions);
     this.client = createClient(options);
+    this.encryptor = encryption.encryptor;
+    this.encryptionDisabled = encryption.disabled ?? false;
     if (this.telemetryOptions.enabled.logging) {
       this.client.on('error', (err) => this.openTelemetryCollector.error(err));
       this.client.connect().catch(this.openTelemetryCollector.error);
     }
   }
 
+  // ---------------------------------------------------------------------------
+  // Encryption helpers
+  // ---------------------------------------------------------------------------
+
+  private encryptValue(serialized: string): string {
+    if (!this.encryptor || this.encryptionDisabled) return serialized;
+    return this.encryptor.encrypt(serialized, getCurrentTenantId()) ?? serialized;
+  }
+
+  private decryptValue(value: string): string {
+    if (!this.encryptor || this.encryptionDisabled) return value;
+    if (!isEncrypted(value)) return value;
+    try {
+      return this.encryptor.decrypt(value, getCurrentTenantId()) ?? value;
+    } catch {
+      return value;
+    }
+  }
+
   /**
    * Parses a raw Redis reply into the expected type.
    * Handles null values, arrays, buffers, and JSON strings.
@@ -74,7 +123,7 @@ export class RedisTtlCache implements TtlCache {
     switch (typeof value) {
       case 'object':
       case 'string':
-        return safeParse(value) as T;
+        return safeParse(this.decryptValue(String(value))) as T;
       case 'number':
         return value as T;
     }
@@ -98,7 +147,7 @@ export class RedisTtlCache implements TtlCache {
     if (this.telemetryOptions.enabled.logging) {
       this.openTelemetryCollector.info(`Putting record into cache: ${key}`);
     }
-    await this.client.set(key, safeStringify(value), {
+    await this.client.set(key, this.encryptValue(safeStringify(value)), {
       PX: ttlMilliseconds
     });
   }
@@ -113,7 +162,7 @@ export class RedisTtlCache implements TtlCache {
   async putBatchRecords<T>(cacheRecords: TtlCacheRecord<T>[]): Promise<void> {
     const multiCommand = this.client.multi();
     for (const { key, value, ttlMilliseconds } of cacheRecords) {
-      multiCommand.set(key, safeStringify(value), {
+      multiCommand.set(key, this.encryptValue(safeStringify(value)), {
         PX: ttlMilliseconds || this.ttlMilliseconds
       });
     }
@@ -129,7 +178,10 @@ export class RedisTtlCache implements TtlCache {
    * @returns {Promise<void>} A promise that resolves when the value is enqueued
    */
   async enqueueRecord<T>(queueName: string, value: T): Promise<void> {
-    await this.client.lPush(queueName, safeStringify(value));
+    await this.client.lPush(
+      queueName,
+      this.encryptValue(safeStringify(value))
+    );
   }
 
   /**
@@ -143,7 +195,10 @@ export class RedisTtlCache implements TtlCache {
   async enqueueBatchRecords<T>(queueName: string, values: T[]): Promise<void> {
     const multiCommand = this.client.multi();
     for (const value of values) {
-      multiCommand.lPush(queueName, safeStringify(value));
+      multiCommand.lPush(
+        queueName,
+        this.encryptValue(safeStringify(value))
+      );
     }
     await multiCommand.exec();
   }
@@ -185,7 +240,7 @@ export class RedisTtlCache implements TtlCache {
     if (value === null) {
       throw new Error(`Queue is empty: ${queueName}`);
     }
-    return safeParse(value) as T;
+    return safeParse(this.decryptValue(value)) as T;
   }
 
   /**
@@ -339,7 +394,10 @@ export class RedisTtlCache implements TtlCache {
    * @param {number} pageSize - The number of records to peek at
    * @returns {Promise<T[]>} A promise that resolves with an array of peeked values
    */
-  async peekQueueRecords<T>(queueName: string, pageSize: number): Promise<T[]> {
+  async peekQueueRecords<T>(
+    queueName: string,
+    pageSize: number
+  ): Promise<T[]> {
     const values = await this.client.lRange(queueName, 0, pageSize - 1);
     return values.map((value) => this.parseValue<T>(value)).filter(Boolean);
   }

package/lib/index.d.mts

@@ -1,25 +1,44 @@
 import { TtlCache, TtlCacheRecord } from '@forklaunch/core/cache';
 import { OpenTelemetryCollector, MetricsDefinition, TelemetryOptions } from '@forklaunch/core/http';
+import { FieldEncryptor } from '@forklaunch/core/persistence';
 import { RedisClientOptions } from 'redis';
 
+/**
+ * Options for configuring encryption on the Redis cache.
+ * Required — every consumer must explicitly configure encryption.
+ */
+interface RedisCacheEncryptionOptions {
+    /** The FieldEncryptor instance to use for encrypting cache values. */
+    encryptor: FieldEncryptor;
+    /** Set to true to disable encryption. Defaults to false (encryption enabled). */
+    disabled?: boolean;
+}
 /**
  * Class representing a Redis-based TTL (Time-To-Live) cache.
  * Implements the TtlCache interface to provide caching functionality with automatic expiration.
+ *
+ * Encryption is enabled by default when an encryptor is provided. Values are encrypted
+ * before storage and decrypted on read using AES-256-GCM with per-tenant key derivation.
  */
 declare class RedisTtlCache implements TtlCache {
     private ttlMilliseconds;
     private openTelemetryCollector;
     private client;
     private telemetryOptions;
+    private encryptor?;
+    private encryptionDisabled;
     /**
      * Creates an instance of RedisTtlCache.
      *
      * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries
      * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics
-     * @param {RedisClientOptions} hostingOptions - Configuration options for the Redis client
+     * @param {RedisClientOptions} options - Configuration options for the Redis client
      * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry
+     * @param {RedisCacheEncryptionOptions} encryption - Encryption configuration (enabled by default)
      */
-    constructor(ttlMilliseconds: number, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options: RedisClientOptions, telemetryOptions: TelemetryOptions);
+    constructor(ttlMilliseconds: number, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options: RedisClientOptions, telemetryOptions: TelemetryOptions, encryption: RedisCacheEncryptionOptions);
+    private encryptValue;
+    private decryptValue;
     /**
      * Parses a raw Redis reply into the expected type.
      * Handles null values, arrays, buffers, and JSON strings.
@@ -173,4 +192,4 @@ declare class RedisTtlCache implements TtlCache {
     getClient(): typeof this.client;
 }
 
-export { RedisTtlCache };
+export { type RedisCacheEncryptionOptions, RedisTtlCache };

package/lib/index.d.ts

@@ -1,25 +1,44 @@
 import { TtlCache, TtlCacheRecord } from '@forklaunch/core/cache';
 import { OpenTelemetryCollector, MetricsDefinition, TelemetryOptions } from '@forklaunch/core/http';
+import { FieldEncryptor } from '@forklaunch/core/persistence';
 import { RedisClientOptions } from 'redis';
 
+/**
+ * Options for configuring encryption on the Redis cache.
+ * Required — every consumer must explicitly configure encryption.
+ */
+interface RedisCacheEncryptionOptions {
+    /** The FieldEncryptor instance to use for encrypting cache values. */
+    encryptor: FieldEncryptor;
+    /** Set to true to disable encryption. Defaults to false (encryption enabled). */
+    disabled?: boolean;
+}
 /**
  * Class representing a Redis-based TTL (Time-To-Live) cache.
  * Implements the TtlCache interface to provide caching functionality with automatic expiration.
+ *
+ * Encryption is enabled by default when an encryptor is provided. Values are encrypted
+ * before storage and decrypted on read using AES-256-GCM with per-tenant key derivation.
  */
 declare class RedisTtlCache implements TtlCache {
     private ttlMilliseconds;
     private openTelemetryCollector;
     private client;
     private telemetryOptions;
+    private encryptor?;
+    private encryptionDisabled;
     /**
      * Creates an instance of RedisTtlCache.
      *
      * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries
      * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics
-     * @param {RedisClientOptions} hostingOptions - Configuration options for the Redis client
+     * @param {RedisClientOptions} options - Configuration options for the Redis client
      * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry
+     * @param {RedisCacheEncryptionOptions} encryption - Encryption configuration (enabled by default)
      */
-    constructor(ttlMilliseconds: number, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options: RedisClientOptions, telemetryOptions: TelemetryOptions);
+    constructor(ttlMilliseconds: number, openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>, options: RedisClientOptions, telemetryOptions: TelemetryOptions, encryption: RedisCacheEncryptionOptions);
+    private encryptValue;
+    private decryptValue;
     /**
      * Parses a raw Redis reply into the expected type.
      * Handles null values, arrays, buffers, and JSON strings.
@@ -173,4 +192,4 @@ declare class RedisTtlCache implements TtlCache {
     getClient(): typeof this.client;
 }
 
-export { RedisTtlCache };
+export { type RedisCacheEncryptionOptions, RedisTtlCache };

package/lib/index.js

@@ -25,21 +25,29 @@ __export(index_exports, {
 module.exports = __toCommonJS(index_exports);
 var import_common = require("@forklaunch/common");
 var import_http = require("@forklaunch/core/http");
+var import_persistence = require("@forklaunch/core/persistence");
 var import_redis = require("redis");
+var ENCRYPTED_PREFIXES = ["v1:", "v2:"];
+function isEncrypted(value) {
+  return ENCRYPTED_PREFIXES.some((p) => value.startsWith(p));
+}
 var RedisTtlCache = class {
   /**
    * Creates an instance of RedisTtlCache.
    *
    * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries
    * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics
-   * @param {RedisClientOptions} hostingOptions - Configuration options for the Redis client
+   * @param {RedisClientOptions} options - Configuration options for the Redis client
    * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry
+   * @param {RedisCacheEncryptionOptions} encryption - Encryption configuration (enabled by default)
    */
-  constructor(ttlMilliseconds, openTelemetryCollector, options, telemetryOptions) {
+  constructor(ttlMilliseconds, openTelemetryCollector, options, telemetryOptions, encryption) {
     this.ttlMilliseconds = ttlMilliseconds;
     this.openTelemetryCollector = openTelemetryCollector;
     this.telemetryOptions = (0, import_http.evaluateTelemetryOptions)(telemetryOptions);
     this.client = (0, import_redis.createClient)(options);
+    this.encryptor = encryption.encryptor;
+    this.encryptionDisabled = encryption.disabled ?? false;
     if (this.telemetryOptions.enabled.logging) {
       this.client.on("error", (err) => this.openTelemetryCollector.error(err));
       this.client.connect().catch(this.openTelemetryCollector.error);
@@ -47,6 +55,24 @@ var RedisTtlCache = class {
   }
   client;
   telemetryOptions;
+  encryptor;
+  encryptionDisabled;
+  // ---------------------------------------------------------------------------
+  // Encryption helpers
+  // ---------------------------------------------------------------------------
+  encryptValue(serialized) {
+    if (!this.encryptor || this.encryptionDisabled) return serialized;
+    return this.encryptor.encrypt(serialized, (0, import_persistence.getCurrentTenantId)()) ?? serialized;
+  }
+  decryptValue(value) {
+    if (!this.encryptor || this.encryptionDisabled) return value;
+    if (!isEncrypted(value)) return value;
+    try {
+      return this.encryptor.decrypt(value, (0, import_persistence.getCurrentTenantId)()) ?? value;
+    } catch {
+      return value;
+    }
+  }
   /**
    * Parses a raw Redis reply into the expected type.
    * Handles null values, arrays, buffers, and JSON strings.
@@ -68,7 +94,7 @@ var RedisTtlCache = class {
     switch (typeof value) {
       case "object":
       case "string":
-        return (0, import_common.safeParse)(value);
+        return (0, import_common.safeParse)(this.decryptValue(String(value)));
       case "number":
         return value;
     }
@@ -91,7 +117,7 @@ var RedisTtlCache = class {
     if (this.telemetryOptions.enabled.logging) {
       this.openTelemetryCollector.info(`Putting record into cache: ${key}`);
     }
-    await this.client.set(key, (0, import_common.safeStringify)(value), {
+    await this.client.set(key, this.encryptValue((0, import_common.safeStringify)(value)), {
       PX: ttlMilliseconds
     });
   }
@@ -105,7 +131,7 @@ var RedisTtlCache = class {
   async putBatchRecords(cacheRecords) {
     const multiCommand = this.client.multi();
     for (const { key, value, ttlMilliseconds } of cacheRecords) {
-      multiCommand.set(key, (0, import_common.safeStringify)(value), {
+      multiCommand.set(key, this.encryptValue((0, import_common.safeStringify)(value)), {
         PX: ttlMilliseconds || this.ttlMilliseconds
       });
     }
@@ -120,7 +146,10 @@ var RedisTtlCache = class {
    * @returns {Promise<void>} A promise that resolves when the value is enqueued
    */
   async enqueueRecord(queueName, value) {
-    await this.client.lPush(queueName, (0, import_common.safeStringify)(value));
+    await this.client.lPush(
+      queueName,
+      this.encryptValue((0, import_common.safeStringify)(value))
+    );
   }
   /**
    * Adds multiple values to the left end of a Redis list in a single transaction.
@@ -133,7 +162,10 @@ var RedisTtlCache = class {
   async enqueueBatchRecords(queueName, values) {
     const multiCommand = this.client.multi();
     for (const value of values) {
-      multiCommand.lPush(queueName, (0, import_common.safeStringify)(value));
+      multiCommand.lPush(
+        queueName,
+        this.encryptValue((0, import_common.safeStringify)(value))
+      );
     }
     await multiCommand.exec();
   }
@@ -172,7 +204,7 @@ var RedisTtlCache = class {
     if (value === null) {
       throw new Error(`Queue is empty: ${queueName}`);
     }
-    return (0, import_common.safeParse)(value);
+    return (0, import_common.safeParse)(this.decryptValue(value));
   }
   /**
    * Removes and returns multiple elements from the right end of a Redis list.

package/lib/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["import { safeParse, safeStringify } from '@forklaunch/common';\nimport { TtlCache, TtlCacheRecord } from '@forklaunch/core/cache';\nimport {\n  evaluateTelemetryOptions,\n  MetricsDefinition,\n  OpenTelemetryCollector,\n  TelemetryOptions\n} from '@forklaunch/core/http';\nimport { createClient, RedisClientOptions } from 'redis';\n\n/**\n * Type representing a raw reply from Redis commands.\n * Can be a string, number, Buffer, null, undefined, or array of raw replies.\n */\ntype RedisCommandRawReply =\n  | string\n  | number\n  | Buffer\n  | null\n  | undefined\n  | Array<RedisCommandRawReply>;\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface to provide caching functionality with automatic expiration.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n  private telemetryOptions;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries\n   * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics\n   * @param {RedisClientOptions} hostingOptions - Configuration options for the Redis client\n   * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    private openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,\n    options: RedisClientOptions,\n    telemetryOptions: TelemetryOptions\n  ) {\n    this.telemetryOptions = evaluateTelemetryOptions(telemetryOptions);\n    this.client = createClient(options);\n    if (this.telemetryOptions.enabled.logging) {\n      this.client.on('error', (err) => this.openTelemetryCollector.error(err));\n      this.client.connect().catch(this.openTelemetryCollector.error);\n    }\n  }\n\n  /**\n   * Parses a raw Redis reply into the expected type.\n   * Handles null values, arrays, buffers, and JSON strings.\n   *\n   * @template T - The expected type of the parsed value\n   * @param {RedisCommandRawReply} value - The raw value from Redis to parse\n   * @returns {T} The parsed value cast to type T\n   */\n  private parseValue<T>(value: RedisCommandRawReply): T {\n    if (value == null) {\n      return null as T;\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((v) => this.parseValue<T>(v)) as T;\n    }\n\n    if (Buffer.isBuffer(value)) {\n      return value.toJSON() as T;\n    }\n\n    switch (typeof value) {\n      case 'object':\n      case 'string':\n        return safeParse(value) as T;\n      case 'number':\n        return value as T;\n    }\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @template T - The type of value being cached\n   * @param {TtlCacheRecord<T>} param0 - The cache record containing key, value and optional TTL\n   * @param {string} param0.key - The key to store the value under\n   * @param {T} param0.value - The value to cache\n   * @param {number} [param0.ttlMilliseconds] - Optional TTL in milliseconds, defaults to constructor value\n   * @returns {Promise<void>} A promise that resolves when the value is cached\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    if (this.telemetryOptions.enabled.logging) {\n      this.openTelemetryCollector.info(`Putting record into cache: ${key}`);\n    }\n    await this.client.set(key, safeStringify(value), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Puts multiple records into the Redis cache in a single transaction.\n   *\n   * @template T - The type of values being cached\n   * @param {TtlCacheRecord<T>[]} cacheRecords - Array of cache records to store\n   * @returns {Promise<void>} A promise that resolves when all values are cached\n   */\n  async putBatchRecords<T>(cacheRecords: TtlCacheRecord<T>[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const { key, value, ttlMilliseconds } of cacheRecords) {\n      multiCommand.set(key, safeStringify(value), {\n        PX: ttlMilliseconds || this.ttlMilliseconds\n      });\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Adds a value to the left end of a Redis list.\n   *\n   * @template T - The type of value being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T} value - The value to add to the list\n   * @returns {Promise<void>} A promise that resolves when the value is enqueued\n   */\n  async enqueueRecord<T>(queueName: string, value: T): Promise<void> {\n    await this.client.lPush(queueName, safeStringify(value));\n  }\n\n  /**\n   * Adds multiple values to the left end of a Redis list in a single transaction.\n   *\n   * @template T - The type of values being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T[]} values - Array of values to add to the list\n   * @returns {Promise<void>} A promise that resolves when all values are enqueued\n   */\n  async enqueueBatchRecords<T>(queueName: string, values: T[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const value of values) {\n      multiCommand.lPush(queueName, safeStringify(value));\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the record to delete\n   * @returns {Promise<void>} A promise that resolves when the record is deleted\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Deletes multiple records from the Redis cache in a single transaction.\n   *\n   * @param {string[]} cacheRecordKeys - Array of keys to delete\n   * @returns {Promise<void>} A promise that resolves when all records are deleted\n   */\n  async deleteBatchRecords(cacheRecordKeys: string[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const key of cacheRecordKeys) {\n      multiCommand.del(key);\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Removes and returns the rightmost element from a Redis list.\n   *\n   * @template T - The type of value being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @returns {Promise<T>} A promise that resolves with the dequeued value\n   * @throws {Error} If the queue is empty\n   */\n  async dequeueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.rPop(queueName);\n    if (value === null) {\n      throw new Error(`Queue is empty: ${queueName}`);\n    }\n    return safeParse(value) as T;\n  }\n\n  /**\n   * Removes and returns multiple elements from the right end of a Redis list.\n   *\n   * @template T - The type of values being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @param {number} pageSize - Maximum number of elements to dequeue\n   * @returns {Promise<T[]>} A promise that resolves with an array of dequeued values\n   */\n  async dequeueBatchRecords<T>(\n    queueName: string,\n    pageSize: number\n  ): Promise<T[]> {\n    const multiCommand = this.client.multi();\n    for (let i = 0; i < pageSize; i++) {\n      multiCommand.rPop(queueName);\n    }\n    const values = await multiCommand.exec();\n    return values\n      .map((value) =>\n        this.parseValue<T>(value as unknown as RedisCommandRawReply)\n      )\n      .filter(Boolean);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @template T - The type of value being read\n   * @param {string} cacheRecordKey - The key of the record to read\n   * @returns {Promise<TtlCacheRecord<T>>} A promise that resolves with the cache record\n   * @throws {Error} If the record is not found\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const [value, ttl] = await this.client\n      .multi()\n      .get(cacheRecordKey)\n      .ttl(cacheRecordKey)\n      .exec();\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n\n    return {\n      key: cacheRecordKey,\n      value: this.parseValue<T>(value as unknown as RedisCommandRawReply),\n      ttlMilliseconds:\n        this.parseValue<number>(ttl as unknown as RedisCommandRawReply) * 1000\n    };\n  }\n\n  /**\n   * Reads multiple records from the Redis cache.\n   *\n   * @template T - The type of values being read\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to read, or a prefix pattern\n   * @returns {Promise<TtlCacheRecord<T>[]>} A promise that resolves with an array of cache records\n   */\n  async readBatchRecords<T>(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<TtlCacheRecord<T>[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.get(key);\n      multiCommand.ttl(key);\n    }\n    const values = await multiCommand.exec();\n    return values.reduce<TtlCacheRecord<T>[]>((acc, value, index) => {\n      if (index % 2 === 0) {\n        const maybeValue = this.parseValue<T>(\n          value as unknown as RedisCommandRawReply\n        );\n        const ttl = this.parseValue<number>(\n          values[index + 1] as unknown as RedisCommandRawReply\n        );\n        if (maybeValue && ttl) {\n          acc.push({\n            key: keys[index / 2],\n            value: maybeValue,\n            ttlMilliseconds: ttl * 1000\n          });\n        }\n      }\n      return acc;\n    }, []);\n  }\n\n  /**\n   * Lists all keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The prefix pattern to match keys against\n   * @returns {Promise<string[]>} A promise that resolves with an array of matching keys\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Checks if a record exists in the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key to check\n   * @returns {Promise<boolean>} A promise that resolves with true if the record exists, false otherwise\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Checks if multiple records exist in the Redis cache.\n   *\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to check, or a prefix pattern\n   * @returns {Promise<boolean[]>} A promise that resolves with an array of existence booleans\n   */\n  async peekBatchRecords(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<boolean[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.exists(key);\n    }\n    const results = await multiCommand.exec();\n    return results.map((result) => (result as unknown as number) === 1);\n  }\n\n  /**\n   * Peeks at a record in the Redis cache.\n   *\n   * @template T - The type of value being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @returns {Promise<T>} A promise that resolves with the peeked value\n   */\n  async peekQueueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.lRange(queueName, 0, 0);\n    return this.parseValue<T>(value[0]);\n  }\n\n  /**\n   * Peeks at multiple records in the Redis cache.\n   *\n   * @template T - The type of values being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @param {number} pageSize - The number of records to peek at\n   * @returns {Promise<T[]>} A promise that resolves with an array of peeked values\n   */\n  async peekQueueRecords<T>(queueName: string, pageSize: number): Promise<T[]> {\n    const values = await this.client.lRange(queueName, 0, pageSize - 1);\n    return values.map((value) => this.parseValue<T>(value)).filter(Boolean);\n  }\n\n  /**\n   * Gracefully disconnects from the Redis server.\n   *\n   * @returns {Promise<void>} A promise that resolves when the connection is closed\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default Time-To-Live value in milliseconds.\n   *\n   * @returns {number} The default TTL in milliseconds\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n\n  /**\n   * Gets the underlying Redis client instance.\n   *\n   * @returns {typeof this.client} The Redis client instance\n   */\n  getClient(): typeof this.client {\n    return this.client;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../index.ts"],"sourcesContent":["import { safeParse, safeStringify } from '@forklaunch/common';\nimport { TtlCache, TtlCacheRecord } from '@forklaunch/core/cache';\nimport {\n  evaluateTelemetryOptions,\n  MetricsDefinition,\n  OpenTelemetryCollector,\n  TelemetryOptions\n} from '@forklaunch/core/http';\nimport {\n  getCurrentTenantId,\n  type FieldEncryptor\n} from '@forklaunch/core/persistence';\nimport { createClient, RedisClientOptions } from 'redis';\n\n/**\n * Type representing a raw reply from Redis commands.\n * Can be a string, number, Buffer, null, undefined, or array of raw replies.\n */\ntype RedisCommandRawReply =\n  | string\n  | number\n  | Buffer\n  | null\n  | undefined\n  | Array<RedisCommandRawReply>;\n\nconst ENCRYPTED_PREFIXES = ['v1:', 'v2:'] as const;\n\nfunction isEncrypted(value: string): boolean {\n  return ENCRYPTED_PREFIXES.some((p) => value.startsWith(p));\n}\n\n/**\n * Options for configuring encryption on the Redis cache.\n * Required — every consumer must explicitly configure encryption.\n */\nexport interface RedisCacheEncryptionOptions {\n  /** The FieldEncryptor instance to use for encrypting cache values. */\n  encryptor: FieldEncryptor;\n  /** Set to true to disable encryption. Defaults to false (encryption enabled). */\n  disabled?: boolean;\n}\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface to provide caching functionality with automatic expiration.\n *\n * Encryption is enabled by default when an encryptor is provided. Values are encrypted\n * before storage and decrypted on read using AES-256-GCM with per-tenant key derivation.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n  private telemetryOptions;\n  private encryptor?: FieldEncryptor;\n  private encryptionDisabled: boolean;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries\n   * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics\n   * @param {RedisClientOptions} options - Configuration options for the Redis client\n   * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry\n   * @param {RedisCacheEncryptionOptions} encryption - Encryption configuration (enabled by default)\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    private openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,\n    options: RedisClientOptions,\n    telemetryOptions: TelemetryOptions,\n    encryption: RedisCacheEncryptionOptions\n  ) {\n    this.telemetryOptions = evaluateTelemetryOptions(telemetryOptions);\n    this.client = createClient(options);\n    this.encryptor = encryption.encryptor;\n    this.encryptionDisabled = encryption.disabled ?? false;\n    if (this.telemetryOptions.enabled.logging) {\n      this.client.on('error', (err) => this.openTelemetryCollector.error(err));\n      this.client.connect().catch(this.openTelemetryCollector.error);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Encryption helpers\n  // ---------------------------------------------------------------------------\n\n  private encryptValue(serialized: string): string {\n    if (!this.encryptor || this.encryptionDisabled) return serialized;\n    return this.encryptor.encrypt(serialized, getCurrentTenantId()) ?? serialized;\n  }\n\n  private decryptValue(value: string): string {\n    if (!this.encryptor || this.encryptionDisabled) return value;\n    if (!isEncrypted(value)) return value;\n    try {\n      return this.encryptor.decrypt(value, getCurrentTenantId()) ?? value;\n    } catch {\n      return value;\n    }\n  }\n\n  /**\n   * Parses a raw Redis reply into the expected type.\n   * Handles null values, arrays, buffers, and JSON strings.\n   *\n   * @template T - The expected type of the parsed value\n   * @param {RedisCommandRawReply} value - The raw value from Redis to parse\n   * @returns {T} The parsed value cast to type T\n   */\n  private parseValue<T>(value: RedisCommandRawReply): T {\n    if (value == null) {\n      return null as T;\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((v) => this.parseValue<T>(v)) as T;\n    }\n\n    if (Buffer.isBuffer(value)) {\n      return value.toJSON() as T;\n    }\n\n    switch (typeof value) {\n      case 'object':\n      case 'string':\n        return safeParse(this.decryptValue(String(value))) as T;\n      case 'number':\n        return value as T;\n    }\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @template T - The type of value being cached\n   * @param {TtlCacheRecord<T>} param0 - The cache record containing key, value and optional TTL\n   * @param {string} param0.key - The key to store the value under\n   * @param {T} param0.value - The value to cache\n   * @param {number} [param0.ttlMilliseconds] - Optional TTL in milliseconds, defaults to constructor value\n   * @returns {Promise<void>} A promise that resolves when the value is cached\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    if (this.telemetryOptions.enabled.logging) {\n      this.openTelemetryCollector.info(`Putting record into cache: ${key}`);\n    }\n    await this.client.set(key, this.encryptValue(safeStringify(value)), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Puts multiple records into the Redis cache in a single transaction.\n   *\n   * @template T - The type of values being cached\n   * @param {TtlCacheRecord<T>[]} cacheRecords - Array of cache records to store\n   * @returns {Promise<void>} A promise that resolves when all values are cached\n   */\n  async putBatchRecords<T>(cacheRecords: TtlCacheRecord<T>[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const { key, value, ttlMilliseconds } of cacheRecords) {\n      multiCommand.set(key, this.encryptValue(safeStringify(value)), {\n        PX: ttlMilliseconds || this.ttlMilliseconds\n      });\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Adds a value to the left end of a Redis list.\n   *\n   * @template T - The type of value being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T} value - The value to add to the list\n   * @returns {Promise<void>} A promise that resolves when the value is enqueued\n   */\n  async enqueueRecord<T>(queueName: string, value: T): Promise<void> {\n    await this.client.lPush(\n      queueName,\n      this.encryptValue(safeStringify(value))\n    );\n  }\n\n  /**\n   * Adds multiple values to the left end of a Redis list in a single transaction.\n   *\n   * @template T - The type of values being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T[]} values - Array of values to add to the list\n   * @returns {Promise<void>} A promise that resolves when all values are enqueued\n   */\n  async enqueueBatchRecords<T>(queueName: string, values: T[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const value of values) {\n      multiCommand.lPush(\n        queueName,\n        this.encryptValue(safeStringify(value))\n      );\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the record to delete\n   * @returns {Promise<void>} A promise that resolves when the record is deleted\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Deletes multiple records from the Redis cache in a single transaction.\n   *\n   * @param {string[]} cacheRecordKeys - Array of keys to delete\n   * @returns {Promise<void>} A promise that resolves when all records are deleted\n   */\n  async deleteBatchRecords(cacheRecordKeys: string[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const key of cacheRecordKeys) {\n      multiCommand.del(key);\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Removes and returns the rightmost element from a Redis list.\n   *\n   * @template T - The type of value being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @returns {Promise<T>} A promise that resolves with the dequeued value\n   * @throws {Error} If the queue is empty\n   */\n  async dequeueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.rPop(queueName);\n    if (value === null) {\n      throw new Error(`Queue is empty: ${queueName}`);\n    }\n    return safeParse(this.decryptValue(value)) as T;\n  }\n\n  /**\n   * Removes and returns multiple elements from the right end of a Redis list.\n   *\n   * @template T - The type of values being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @param {number} pageSize - Maximum number of elements to dequeue\n   * @returns {Promise<T[]>} A promise that resolves with an array of dequeued values\n   */\n  async dequeueBatchRecords<T>(\n    queueName: string,\n    pageSize: number\n  ): Promise<T[]> {\n    const multiCommand = this.client.multi();\n    for (let i = 0; i < pageSize; i++) {\n      multiCommand.rPop(queueName);\n    }\n    const values = await multiCommand.exec();\n    return values\n      .map((value) =>\n        this.parseValue<T>(value as unknown as RedisCommandRawReply)\n      )\n      .filter(Boolean);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @template T - The type of value being read\n   * @param {string} cacheRecordKey - The key of the record to read\n   * @returns {Promise<TtlCacheRecord<T>>} A promise that resolves with the cache record\n   * @throws {Error} If the record is not found\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const [value, ttl] = await this.client\n      .multi()\n      .get(cacheRecordKey)\n      .ttl(cacheRecordKey)\n      .exec();\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n\n    return {\n      key: cacheRecordKey,\n      value: this.parseValue<T>(value as unknown as RedisCommandRawReply),\n      ttlMilliseconds:\n        this.parseValue<number>(ttl as unknown as RedisCommandRawReply) * 1000\n    };\n  }\n\n  /**\n   * Reads multiple records from the Redis cache.\n   *\n   * @template T - The type of values being read\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to read, or a prefix pattern\n   * @returns {Promise<TtlCacheRecord<T>[]>} A promise that resolves with an array of cache records\n   */\n  async readBatchRecords<T>(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<TtlCacheRecord<T>[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.get(key);\n      multiCommand.ttl(key);\n    }\n    const values = await multiCommand.exec();\n    return values.reduce<TtlCacheRecord<T>[]>((acc, value, index) => {\n      if (index % 2 === 0) {\n        const maybeValue = this.parseValue<T>(\n          value as unknown as RedisCommandRawReply\n        );\n        const ttl = this.parseValue<number>(\n          values[index + 1] as unknown as RedisCommandRawReply\n        );\n        if (maybeValue && ttl) {\n          acc.push({\n            key: keys[index / 2],\n            value: maybeValue,\n            ttlMilliseconds: ttl * 1000\n          });\n        }\n      }\n      return acc;\n    }, []);\n  }\n\n  /**\n   * Lists all keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The prefix pattern to match keys against\n   * @returns {Promise<string[]>} A promise that resolves with an array of matching keys\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Checks if a record exists in the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key to check\n   * @returns {Promise<boolean>} A promise that resolves with true if the record exists, false otherwise\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Checks if multiple records exist in the Redis cache.\n   *\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to check, or a prefix pattern\n   * @returns {Promise<boolean[]>} A promise that resolves with an array of existence booleans\n   */\n  async peekBatchRecords(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<boolean[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.exists(key);\n    }\n    const results = await multiCommand.exec();\n    return results.map((result) => (result as unknown as number) === 1);\n  }\n\n  /**\n   * Peeks at a record in the Redis cache.\n   *\n   * @template T - The type of value being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @returns {Promise<T>} A promise that resolves with the peeked value\n   */\n  async peekQueueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.lRange(queueName, 0, 0);\n    return this.parseValue<T>(value[0]);\n  }\n\n  /**\n   * Peeks at multiple records in the Redis cache.\n   *\n   * @template T - The type of values being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @param {number} pageSize - The number of records to peek at\n   * @returns {Promise<T[]>} A promise that resolves with an array of peeked values\n   */\n  async peekQueueRecords<T>(\n    queueName: string,\n    pageSize: number\n  ): Promise<T[]> {\n    const values = await this.client.lRange(queueName, 0, pageSize - 1);\n    return values.map((value) => this.parseValue<T>(value)).filter(Boolean);\n  }\n\n  /**\n   * Gracefully disconnects from the Redis server.\n   *\n   * @returns {Promise<void>} A promise that resolves when the connection is closed\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default Time-To-Live value in milliseconds.\n   *\n   * @returns {number} The default TTL in milliseconds\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n\n  /**\n   * Gets the underlying Redis client instance.\n   *\n   * @returns {typeof this.client} The Redis client instance\n   */\n  getClient(): typeof this.client {\n    return this.client;\n  }\n}\n"],"mappings":"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","names":[]}

package/lib/index.mjs

@@ -3,21 +3,31 @@ import { safeParse, safeStringify } from "@forklaunch/common";
 import {
   evaluateTelemetryOptions
 } from "@forklaunch/core/http";
+import {
+  getCurrentTenantId
+} from "@forklaunch/core/persistence";
 import { createClient } from "redis";
+var ENCRYPTED_PREFIXES = ["v1:", "v2:"];
+function isEncrypted(value) {
+  return ENCRYPTED_PREFIXES.some((p) => value.startsWith(p));
+}
 var RedisTtlCache = class {
   /**
    * Creates an instance of RedisTtlCache.
    *
    * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries
    * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics
-   * @param {RedisClientOptions} hostingOptions - Configuration options for the Redis client
+   * @param {RedisClientOptions} options - Configuration options for the Redis client
    * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry
+   * @param {RedisCacheEncryptionOptions} encryption - Encryption configuration (enabled by default)
    */
-  constructor(ttlMilliseconds, openTelemetryCollector, options, telemetryOptions) {
+  constructor(ttlMilliseconds, openTelemetryCollector, options, telemetryOptions, encryption) {
     this.ttlMilliseconds = ttlMilliseconds;
     this.openTelemetryCollector = openTelemetryCollector;
     this.telemetryOptions = evaluateTelemetryOptions(telemetryOptions);
     this.client = createClient(options);
+    this.encryptor = encryption.encryptor;
+    this.encryptionDisabled = encryption.disabled ?? false;
     if (this.telemetryOptions.enabled.logging) {
       this.client.on("error", (err) => this.openTelemetryCollector.error(err));
       this.client.connect().catch(this.openTelemetryCollector.error);
@@ -25,6 +35,24 @@ var RedisTtlCache = class {
   }
   client;
   telemetryOptions;
+  encryptor;
+  encryptionDisabled;
+  // ---------------------------------------------------------------------------
+  // Encryption helpers
+  // ---------------------------------------------------------------------------
+  encryptValue(serialized) {
+    if (!this.encryptor || this.encryptionDisabled) return serialized;
+    return this.encryptor.encrypt(serialized, getCurrentTenantId()) ?? serialized;
+  }
+  decryptValue(value) {
+    if (!this.encryptor || this.encryptionDisabled) return value;
+    if (!isEncrypted(value)) return value;
+    try {
+      return this.encryptor.decrypt(value, getCurrentTenantId()) ?? value;
+    } catch {
+      return value;
+    }
+  }
   /**
    * Parses a raw Redis reply into the expected type.
    * Handles null values, arrays, buffers, and JSON strings.
@@ -46,7 +74,7 @@ var RedisTtlCache = class {
     switch (typeof value) {
       case "object":
       case "string":
-        return safeParse(value);
+        return safeParse(this.decryptValue(String(value)));
       case "number":
         return value;
     }
@@ -69,7 +97,7 @@ var RedisTtlCache = class {
     if (this.telemetryOptions.enabled.logging) {
       this.openTelemetryCollector.info(`Putting record into cache: ${key}`);
     }
-    await this.client.set(key, safeStringify(value), {
+    await this.client.set(key, this.encryptValue(safeStringify(value)), {
       PX: ttlMilliseconds
     });
   }
@@ -83,7 +111,7 @@ var RedisTtlCache = class {
   async putBatchRecords(cacheRecords) {
     const multiCommand = this.client.multi();
     for (const { key, value, ttlMilliseconds } of cacheRecords) {
-      multiCommand.set(key, safeStringify(value), {
+      multiCommand.set(key, this.encryptValue(safeStringify(value)), {
         PX: ttlMilliseconds || this.ttlMilliseconds
       });
     }
@@ -98,7 +126,10 @@ var RedisTtlCache = class {
    * @returns {Promise<void>} A promise that resolves when the value is enqueued
    */
   async enqueueRecord(queueName, value) {
-    await this.client.lPush(queueName, safeStringify(value));
+    await this.client.lPush(
+      queueName,
+      this.encryptValue(safeStringify(value))
+    );
   }
   /**
    * Adds multiple values to the left end of a Redis list in a single transaction.
@@ -111,7 +142,10 @@ var RedisTtlCache = class {
   async enqueueBatchRecords(queueName, values) {
     const multiCommand = this.client.multi();
     for (const value of values) {
-      multiCommand.lPush(queueName, safeStringify(value));
+      multiCommand.lPush(
+        queueName,
+        this.encryptValue(safeStringify(value))
+      );
     }
     await multiCommand.exec();
   }
@@ -150,7 +184,7 @@ var RedisTtlCache = class {
     if (value === null) {
       throw new Error(`Queue is empty: ${queueName}`);
     }
-    return safeParse(value);
+    return safeParse(this.decryptValue(value));
   }
   /**
    * Removes and returns multiple elements from the right end of a Redis list.

package/lib/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../index.ts"],"sourcesContent":["import { safeParse, safeStringify } from '@forklaunch/common';\nimport { TtlCache, TtlCacheRecord } from '@forklaunch/core/cache';\nimport {\n  evaluateTelemetryOptions,\n  MetricsDefinition,\n  OpenTelemetryCollector,\n  TelemetryOptions\n} from '@forklaunch/core/http';\nimport { createClient, RedisClientOptions } from 'redis';\n\n/**\n * Type representing a raw reply from Redis commands.\n * Can be a string, number, Buffer, null, undefined, or array of raw replies.\n */\ntype RedisCommandRawReply =\n  | string\n  | number\n  | Buffer\n  | null\n  | undefined\n  | Array<RedisCommandRawReply>;\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface to provide caching functionality with automatic expiration.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n  private telemetryOptions;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries\n   * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics\n   * @param {RedisClientOptions} hostingOptions - Configuration options for the Redis client\n   * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    private openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,\n    options: RedisClientOptions,\n    telemetryOptions: TelemetryOptions\n  ) {\n    this.telemetryOptions = evaluateTelemetryOptions(telemetryOptions);\n    this.client = createClient(options);\n    if (this.telemetryOptions.enabled.logging) {\n      this.client.on('error', (err) => this.openTelemetryCollector.error(err));\n      this.client.connect().catch(this.openTelemetryCollector.error);\n    }\n  }\n\n  /**\n   * Parses a raw Redis reply into the expected type.\n   * Handles null values, arrays, buffers, and JSON strings.\n   *\n   * @template T - The expected type of the parsed value\n   * @param {RedisCommandRawReply} value - The raw value from Redis to parse\n   * @returns {T} The parsed value cast to type T\n   */\n  private parseValue<T>(value: RedisCommandRawReply): T {\n    if (value == null) {\n      return null as T;\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((v) => this.parseValue<T>(v)) as T;\n    }\n\n    if (Buffer.isBuffer(value)) {\n      return value.toJSON() as T;\n    }\n\n    switch (typeof value) {\n      case 'object':\n      case 'string':\n        return safeParse(value) as T;\n      case 'number':\n        return value as T;\n    }\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @template T - The type of value being cached\n   * @param {TtlCacheRecord<T>} param0 - The cache record containing key, value and optional TTL\n   * @param {string} param0.key - The key to store the value under\n   * @param {T} param0.value - The value to cache\n   * @param {number} [param0.ttlMilliseconds] - Optional TTL in milliseconds, defaults to constructor value\n   * @returns {Promise<void>} A promise that resolves when the value is cached\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    if (this.telemetryOptions.enabled.logging) {\n      this.openTelemetryCollector.info(`Putting record into cache: ${key}`);\n    }\n    await this.client.set(key, safeStringify(value), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Puts multiple records into the Redis cache in a single transaction.\n   *\n   * @template T - The type of values being cached\n   * @param {TtlCacheRecord<T>[]} cacheRecords - Array of cache records to store\n   * @returns {Promise<void>} A promise that resolves when all values are cached\n   */\n  async putBatchRecords<T>(cacheRecords: TtlCacheRecord<T>[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const { key, value, ttlMilliseconds } of cacheRecords) {\n      multiCommand.set(key, safeStringify(value), {\n        PX: ttlMilliseconds || this.ttlMilliseconds\n      });\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Adds a value to the left end of a Redis list.\n   *\n   * @template T - The type of value being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T} value - The value to add to the list\n   * @returns {Promise<void>} A promise that resolves when the value is enqueued\n   */\n  async enqueueRecord<T>(queueName: string, value: T): Promise<void> {\n    await this.client.lPush(queueName, safeStringify(value));\n  }\n\n  /**\n   * Adds multiple values to the left end of a Redis list in a single transaction.\n   *\n   * @template T - The type of values being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T[]} values - Array of values to add to the list\n   * @returns {Promise<void>} A promise that resolves when all values are enqueued\n   */\n  async enqueueBatchRecords<T>(queueName: string, values: T[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const value of values) {\n      multiCommand.lPush(queueName, safeStringify(value));\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the record to delete\n   * @returns {Promise<void>} A promise that resolves when the record is deleted\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Deletes multiple records from the Redis cache in a single transaction.\n   *\n   * @param {string[]} cacheRecordKeys - Array of keys to delete\n   * @returns {Promise<void>} A promise that resolves when all records are deleted\n   */\n  async deleteBatchRecords(cacheRecordKeys: string[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const key of cacheRecordKeys) {\n      multiCommand.del(key);\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Removes and returns the rightmost element from a Redis list.\n   *\n   * @template T - The type of value being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @returns {Promise<T>} A promise that resolves with the dequeued value\n   * @throws {Error} If the queue is empty\n   */\n  async dequeueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.rPop(queueName);\n    if (value === null) {\n      throw new Error(`Queue is empty: ${queueName}`);\n    }\n    return safeParse(value) as T;\n  }\n\n  /**\n   * Removes and returns multiple elements from the right end of a Redis list.\n   *\n   * @template T - The type of values being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @param {number} pageSize - Maximum number of elements to dequeue\n   * @returns {Promise<T[]>} A promise that resolves with an array of dequeued values\n   */\n  async dequeueBatchRecords<T>(\n    queueName: string,\n    pageSize: number\n  ): Promise<T[]> {\n    const multiCommand = this.client.multi();\n    for (let i = 0; i < pageSize; i++) {\n      multiCommand.rPop(queueName);\n    }\n    const values = await multiCommand.exec();\n    return values\n      .map((value) =>\n        this.parseValue<T>(value as unknown as RedisCommandRawReply)\n      )\n      .filter(Boolean);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @template T - The type of value being read\n   * @param {string} cacheRecordKey - The key of the record to read\n   * @returns {Promise<TtlCacheRecord<T>>} A promise that resolves with the cache record\n   * @throws {Error} If the record is not found\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const [value, ttl] = await this.client\n      .multi()\n      .get(cacheRecordKey)\n      .ttl(cacheRecordKey)\n      .exec();\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n\n    return {\n      key: cacheRecordKey,\n      value: this.parseValue<T>(value as unknown as RedisCommandRawReply),\n      ttlMilliseconds:\n        this.parseValue<number>(ttl as unknown as RedisCommandRawReply) * 1000\n    };\n  }\n\n  /**\n   * Reads multiple records from the Redis cache.\n   *\n   * @template T - The type of values being read\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to read, or a prefix pattern\n   * @returns {Promise<TtlCacheRecord<T>[]>} A promise that resolves with an array of cache records\n   */\n  async readBatchRecords<T>(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<TtlCacheRecord<T>[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.get(key);\n      multiCommand.ttl(key);\n    }\n    const values = await multiCommand.exec();\n    return values.reduce<TtlCacheRecord<T>[]>((acc, value, index) => {\n      if (index % 2 === 0) {\n        const maybeValue = this.parseValue<T>(\n          value as unknown as RedisCommandRawReply\n        );\n        const ttl = this.parseValue<number>(\n          values[index + 1] as unknown as RedisCommandRawReply\n        );\n        if (maybeValue && ttl) {\n          acc.push({\n            key: keys[index / 2],\n            value: maybeValue,\n            ttlMilliseconds: ttl * 1000\n          });\n        }\n      }\n      return acc;\n    }, []);\n  }\n\n  /**\n   * Lists all keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The prefix pattern to match keys against\n   * @returns {Promise<string[]>} A promise that resolves with an array of matching keys\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Checks if a record exists in the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key to check\n   * @returns {Promise<boolean>} A promise that resolves with true if the record exists, false otherwise\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Checks if multiple records exist in the Redis cache.\n   *\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to check, or a prefix pattern\n   * @returns {Promise<boolean[]>} A promise that resolves with an array of existence booleans\n   */\n  async peekBatchRecords(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<boolean[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.exists(key);\n    }\n    const results = await multiCommand.exec();\n    return results.map((result) => (result as unknown as number) === 1);\n  }\n\n  /**\n   * Peeks at a record in the Redis cache.\n   *\n   * @template T - The type of value being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @returns {Promise<T>} A promise that resolves with the peeked value\n   */\n  async peekQueueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.lRange(queueName, 0, 0);\n    return this.parseValue<T>(value[0]);\n  }\n\n  /**\n   * Peeks at multiple records in the Redis cache.\n   *\n   * @template T - The type of values being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @param {number} pageSize - The number of records to peek at\n   * @returns {Promise<T[]>} A promise that resolves with an array of peeked values\n   */\n  async peekQueueRecords<T>(queueName: string, pageSize: number): Promise<T[]> {\n    const values = await this.client.lRange(queueName, 0, pageSize - 1);\n    return values.map((value) => this.parseValue<T>(value)).filter(Boolean);\n  }\n\n  /**\n   * Gracefully disconnects from the Redis server.\n   *\n   * @returns {Promise<void>} A promise that resolves when the connection is closed\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default Time-To-Live value in milliseconds.\n   *\n   * @returns {number} The default TTL in milliseconds\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n\n  /**\n   * Gets the underlying Redis client instance.\n   *\n   * @returns {typeof this.client} The Redis client instance\n   */\n  getClient(): typeof this.client {\n    return this.client;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../index.ts"],"sourcesContent":["import { safeParse, safeStringify } from '@forklaunch/common';\nimport { TtlCache, TtlCacheRecord } from '@forklaunch/core/cache';\nimport {\n  evaluateTelemetryOptions,\n  MetricsDefinition,\n  OpenTelemetryCollector,\n  TelemetryOptions\n} from '@forklaunch/core/http';\nimport {\n  getCurrentTenantId,\n  type FieldEncryptor\n} from '@forklaunch/core/persistence';\nimport { createClient, RedisClientOptions } from 'redis';\n\n/**\n * Type representing a raw reply from Redis commands.\n * Can be a string, number, Buffer, null, undefined, or array of raw replies.\n */\ntype RedisCommandRawReply =\n  | string\n  | number\n  | Buffer\n  | null\n  | undefined\n  | Array<RedisCommandRawReply>;\n\nconst ENCRYPTED_PREFIXES = ['v1:', 'v2:'] as const;\n\nfunction isEncrypted(value: string): boolean {\n  return ENCRYPTED_PREFIXES.some((p) => value.startsWith(p));\n}\n\n/**\n * Options for configuring encryption on the Redis cache.\n * Required — every consumer must explicitly configure encryption.\n */\nexport interface RedisCacheEncryptionOptions {\n  /** The FieldEncryptor instance to use for encrypting cache values. */\n  encryptor: FieldEncryptor;\n  /** Set to true to disable encryption. Defaults to false (encryption enabled). */\n  disabled?: boolean;\n}\n\n/**\n * Class representing a Redis-based TTL (Time-To-Live) cache.\n * Implements the TtlCache interface to provide caching functionality with automatic expiration.\n *\n * Encryption is enabled by default when an encryptor is provided. Values are encrypted\n * before storage and decrypted on read using AES-256-GCM with per-tenant key derivation.\n */\nexport class RedisTtlCache implements TtlCache {\n  private client;\n  private telemetryOptions;\n  private encryptor?: FieldEncryptor;\n  private encryptionDisabled: boolean;\n\n  /**\n   * Creates an instance of RedisTtlCache.\n   *\n   * @param {number} ttlMilliseconds - The default Time-To-Live in milliseconds for cache entries\n   * @param {OpenTelemetryCollector<MetricsDefinition>} openTelemetryCollector - Collector for OpenTelemetry metrics\n   * @param {RedisClientOptions} options - Configuration options for the Redis client\n   * @param {TelemetryOptions} telemetryOptions - Configuration options for telemetry\n   * @param {RedisCacheEncryptionOptions} encryption - Encryption configuration (enabled by default)\n   */\n  constructor(\n    private ttlMilliseconds: number,\n    private openTelemetryCollector: OpenTelemetryCollector<MetricsDefinition>,\n    options: RedisClientOptions,\n    telemetryOptions: TelemetryOptions,\n    encryption: RedisCacheEncryptionOptions\n  ) {\n    this.telemetryOptions = evaluateTelemetryOptions(telemetryOptions);\n    this.client = createClient(options);\n    this.encryptor = encryption.encryptor;\n    this.encryptionDisabled = encryption.disabled ?? false;\n    if (this.telemetryOptions.enabled.logging) {\n      this.client.on('error', (err) => this.openTelemetryCollector.error(err));\n      this.client.connect().catch(this.openTelemetryCollector.error);\n    }\n  }\n\n  // ---------------------------------------------------------------------------\n  // Encryption helpers\n  // ---------------------------------------------------------------------------\n\n  private encryptValue(serialized: string): string {\n    if (!this.encryptor || this.encryptionDisabled) return serialized;\n    return this.encryptor.encrypt(serialized, getCurrentTenantId()) ?? serialized;\n  }\n\n  private decryptValue(value: string): string {\n    if (!this.encryptor || this.encryptionDisabled) return value;\n    if (!isEncrypted(value)) return value;\n    try {\n      return this.encryptor.decrypt(value, getCurrentTenantId()) ?? value;\n    } catch {\n      return value;\n    }\n  }\n\n  /**\n   * Parses a raw Redis reply into the expected type.\n   * Handles null values, arrays, buffers, and JSON strings.\n   *\n   * @template T - The expected type of the parsed value\n   * @param {RedisCommandRawReply} value - The raw value from Redis to parse\n   * @returns {T} The parsed value cast to type T\n   */\n  private parseValue<T>(value: RedisCommandRawReply): T {\n    if (value == null) {\n      return null as T;\n    }\n\n    if (Array.isArray(value)) {\n      return value.map((v) => this.parseValue<T>(v)) as T;\n    }\n\n    if (Buffer.isBuffer(value)) {\n      return value.toJSON() as T;\n    }\n\n    switch (typeof value) {\n      case 'object':\n      case 'string':\n        return safeParse(this.decryptValue(String(value))) as T;\n      case 'number':\n        return value as T;\n    }\n  }\n\n  /**\n   * Puts a record into the Redis cache.\n   *\n   * @template T - The type of value being cached\n   * @param {TtlCacheRecord<T>} param0 - The cache record containing key, value and optional TTL\n   * @param {string} param0.key - The key to store the value under\n   * @param {T} param0.value - The value to cache\n   * @param {number} [param0.ttlMilliseconds] - Optional TTL in milliseconds, defaults to constructor value\n   * @returns {Promise<void>} A promise that resolves when the value is cached\n   */\n  async putRecord<T>({\n    key,\n    value,\n    ttlMilliseconds = this.ttlMilliseconds\n  }: TtlCacheRecord<T>): Promise<void> {\n    if (this.telemetryOptions.enabled.logging) {\n      this.openTelemetryCollector.info(`Putting record into cache: ${key}`);\n    }\n    await this.client.set(key, this.encryptValue(safeStringify(value)), {\n      PX: ttlMilliseconds\n    });\n  }\n\n  /**\n   * Puts multiple records into the Redis cache in a single transaction.\n   *\n   * @template T - The type of values being cached\n   * @param {TtlCacheRecord<T>[]} cacheRecords - Array of cache records to store\n   * @returns {Promise<void>} A promise that resolves when all values are cached\n   */\n  async putBatchRecords<T>(cacheRecords: TtlCacheRecord<T>[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const { key, value, ttlMilliseconds } of cacheRecords) {\n      multiCommand.set(key, this.encryptValue(safeStringify(value)), {\n        PX: ttlMilliseconds || this.ttlMilliseconds\n      });\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Adds a value to the left end of a Redis list.\n   *\n   * @template T - The type of value being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T} value - The value to add to the list\n   * @returns {Promise<void>} A promise that resolves when the value is enqueued\n   */\n  async enqueueRecord<T>(queueName: string, value: T): Promise<void> {\n    await this.client.lPush(\n      queueName,\n      this.encryptValue(safeStringify(value))\n    );\n  }\n\n  /**\n   * Adds multiple values to the left end of a Redis list in a single transaction.\n   *\n   * @template T - The type of values being enqueued\n   * @param {string} queueName - The name of the Redis list\n   * @param {T[]} values - Array of values to add to the list\n   * @returns {Promise<void>} A promise that resolves when all values are enqueued\n   */\n  async enqueueBatchRecords<T>(queueName: string, values: T[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const value of values) {\n      multiCommand.lPush(\n        queueName,\n        this.encryptValue(safeStringify(value))\n      );\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Deletes a record from the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key of the record to delete\n   * @returns {Promise<void>} A promise that resolves when the record is deleted\n   */\n  async deleteRecord(cacheRecordKey: string): Promise<void> {\n    await this.client.del(cacheRecordKey);\n  }\n\n  /**\n   * Deletes multiple records from the Redis cache in a single transaction.\n   *\n   * @param {string[]} cacheRecordKeys - Array of keys to delete\n   * @returns {Promise<void>} A promise that resolves when all records are deleted\n   */\n  async deleteBatchRecords(cacheRecordKeys: string[]): Promise<void> {\n    const multiCommand = this.client.multi();\n    for (const key of cacheRecordKeys) {\n      multiCommand.del(key);\n    }\n    await multiCommand.exec();\n  }\n\n  /**\n   * Removes and returns the rightmost element from a Redis list.\n   *\n   * @template T - The type of value being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @returns {Promise<T>} A promise that resolves with the dequeued value\n   * @throws {Error} If the queue is empty\n   */\n  async dequeueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.rPop(queueName);\n    if (value === null) {\n      throw new Error(`Queue is empty: ${queueName}`);\n    }\n    return safeParse(this.decryptValue(value)) as T;\n  }\n\n  /**\n   * Removes and returns multiple elements from the right end of a Redis list.\n   *\n   * @template T - The type of values being dequeued\n   * @param {string} queueName - The name of the Redis list\n   * @param {number} pageSize - Maximum number of elements to dequeue\n   * @returns {Promise<T[]>} A promise that resolves with an array of dequeued values\n   */\n  async dequeueBatchRecords<T>(\n    queueName: string,\n    pageSize: number\n  ): Promise<T[]> {\n    const multiCommand = this.client.multi();\n    for (let i = 0; i < pageSize; i++) {\n      multiCommand.rPop(queueName);\n    }\n    const values = await multiCommand.exec();\n    return values\n      .map((value) =>\n        this.parseValue<T>(value as unknown as RedisCommandRawReply)\n      )\n      .filter(Boolean);\n  }\n\n  /**\n   * Reads a record from the Redis cache.\n   *\n   * @template T - The type of value being read\n   * @param {string} cacheRecordKey - The key of the record to read\n   * @returns {Promise<TtlCacheRecord<T>>} A promise that resolves with the cache record\n   * @throws {Error} If the record is not found\n   */\n  async readRecord<T>(cacheRecordKey: string): Promise<TtlCacheRecord<T>> {\n    const [value, ttl] = await this.client\n      .multi()\n      .get(cacheRecordKey)\n      .ttl(cacheRecordKey)\n      .exec();\n    if (value === null) {\n      throw new Error(`Record not found for key: ${cacheRecordKey}`);\n    }\n\n    return {\n      key: cacheRecordKey,\n      value: this.parseValue<T>(value as unknown as RedisCommandRawReply),\n      ttlMilliseconds:\n        this.parseValue<number>(ttl as unknown as RedisCommandRawReply) * 1000\n    };\n  }\n\n  /**\n   * Reads multiple records from the Redis cache.\n   *\n   * @template T - The type of values being read\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to read, or a prefix pattern\n   * @returns {Promise<TtlCacheRecord<T>[]>} A promise that resolves with an array of cache records\n   */\n  async readBatchRecords<T>(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<TtlCacheRecord<T>[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.get(key);\n      multiCommand.ttl(key);\n    }\n    const values = await multiCommand.exec();\n    return values.reduce<TtlCacheRecord<T>[]>((acc, value, index) => {\n      if (index % 2 === 0) {\n        const maybeValue = this.parseValue<T>(\n          value as unknown as RedisCommandRawReply\n        );\n        const ttl = this.parseValue<number>(\n          values[index + 1] as unknown as RedisCommandRawReply\n        );\n        if (maybeValue && ttl) {\n          acc.push({\n            key: keys[index / 2],\n            value: maybeValue,\n            ttlMilliseconds: ttl * 1000\n          });\n        }\n      }\n      return acc;\n    }, []);\n  }\n\n  /**\n   * Lists all keys in the Redis cache that match a pattern prefix.\n   *\n   * @param {string} pattern_prefix - The prefix pattern to match keys against\n   * @returns {Promise<string[]>} A promise that resolves with an array of matching keys\n   */\n  async listKeys(pattern_prefix: string): Promise<string[]> {\n    const keys = await this.client.keys(pattern_prefix + '*');\n    return keys;\n  }\n\n  /**\n   * Checks if a record exists in the Redis cache.\n   *\n   * @param {string} cacheRecordKey - The key to check\n   * @returns {Promise<boolean>} A promise that resolves with true if the record exists, false otherwise\n   */\n  async peekRecord(cacheRecordKey: string): Promise<boolean> {\n    const result = await this.client.exists(cacheRecordKey);\n    return result === 1;\n  }\n\n  /**\n   * Checks if multiple records exist in the Redis cache.\n   *\n   * @param {string[] | string} cacheRecordKeysOrPrefix - Array of keys to check, or a prefix pattern\n   * @returns {Promise<boolean[]>} A promise that resolves with an array of existence booleans\n   */\n  async peekBatchRecords(\n    cacheRecordKeysOrPrefix: string[] | string\n  ): Promise<boolean[]> {\n    const keys = Array.isArray(cacheRecordKeysOrPrefix)\n      ? cacheRecordKeysOrPrefix\n      : await this.client.keys(cacheRecordKeysOrPrefix + '*');\n    const multiCommand = this.client.multi();\n    for (const key of keys) {\n      multiCommand.exists(key);\n    }\n    const results = await multiCommand.exec();\n    return results.map((result) => (result as unknown as number) === 1);\n  }\n\n  /**\n   * Peeks at a record in the Redis cache.\n   *\n   * @template T - The type of value being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @returns {Promise<T>} A promise that resolves with the peeked value\n   */\n  async peekQueueRecord<T>(queueName: string): Promise<T> {\n    const value = await this.client.lRange(queueName, 0, 0);\n    return this.parseValue<T>(value[0]);\n  }\n\n  /**\n   * Peeks at multiple records in the Redis cache.\n   *\n   * @template T - The type of values being peeked at\n   * @param {string} queueName - The name of the Redis queue\n   * @param {number} pageSize - The number of records to peek at\n   * @returns {Promise<T[]>} A promise that resolves with an array of peeked values\n   */\n  async peekQueueRecords<T>(\n    queueName: string,\n    pageSize: number\n  ): Promise<T[]> {\n    const values = await this.client.lRange(queueName, 0, pageSize - 1);\n    return values.map((value) => this.parseValue<T>(value)).filter(Boolean);\n  }\n\n  /**\n   * Gracefully disconnects from the Redis server.\n   *\n   * @returns {Promise<void>} A promise that resolves when the connection is closed\n   */\n  async disconnect(): Promise<void> {\n    await this.client.quit();\n  }\n\n  /**\n   * Gets the default Time-To-Live value in milliseconds.\n   *\n   * @returns {number} The default TTL in milliseconds\n   */\n  getTtlMilliseconds(): number {\n    return this.ttlMilliseconds;\n  }\n\n  /**\n   * Gets the underlying Redis client instance.\n   *\n   * @returns {typeof this.client} The Redis client instance\n   */\n  getClient(): typeof this.client {\n    return this.client;\n  }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forklaunch/infrastructure-redis",
-  "version": "1.2.10",
+  "version": "1.3.0",
   "description": "Redis infrastructure for ForkLaunch components.",
   "homepage": "https://github.com/forklaunch/forklaunch-js#readme",
   "bugs": {
@@ -29,8 +29,8 @@
   ],
   "dependencies": {
     "redis": "^5.11.0",
-    "@forklaunch/common": "1.2.4",
-    "@forklaunch/core": "1.3.0"
+    "@forklaunch/common": "1.2.6",
+    "@forklaunch/core": "1.3.2"
   },
   "devDependencies": {
     "@eslint/js": "^10.0.1",