@prismakit/redis 3.0.2 → 3.2.0

package/dist/index.cjs

@@ -32,6 +32,8 @@ var index_exports = {};
 __export(index_exports, {
   RedisCacheAdapter: () => RedisCacheAdapter,
   cacheDebugStorage: () => import_core.cacheDebugStorage,
+  cloneWithCodec: () => cloneWithCodec,
+  createRedisJsonReviver: () => createRedisJsonReviver,
   isCacheDebugEnabled: () => import_core.isCacheDebugEnabled,
   recordCacheDebug: () => import_core.recordCacheDebug,
   redisJsonParse: () => redisJsonParse,
@@ -47,26 +49,83 @@ var import_zlib = require("zlib");
 
 // src/redis-json.ts
 var BIGINT_TAG = "__bigint";
+var DATE_TAG = "__date";
+var BYTES_TAG = "__bytes";
+var DECIMAL_TAG = "__decimal";
+function isPlainObject(value) {
+  return value !== null && typeof value === "object" && !Array.isArray(value) && !(value instanceof Date) && !Buffer.isBuffer(value);
+}
+function isDecimalLike(value) {
+  return isPlainObject(value) && typeof value.constructor?.name === "string" && (value.constructor.name === "Decimal" || typeof value.toFixed === "function" && typeof value.d === "object");
+}
 function redisJsonReplacer(_key, value) {
   if (typeof value === "bigint") {
     return { [BIGINT_TAG]: value.toString() };
   }
+  if (value instanceof Date) {
+    return { [DATE_TAG]: value.toISOString() };
+  }
+  if (Buffer.isBuffer(value)) {
+    return { [BYTES_TAG]: value.toString("base64") };
+  }
+  if (value && typeof value === "object" && value.type === "Buffer" && Array.isArray(value.data)) {
+    return {
+      [BYTES_TAG]: Buffer.from(
+        value.data
+      ).toString("base64")
+    };
+  }
+  if (isDecimalLike(value)) {
+    return { [DECIMAL_TAG]: value.toFixed() };
+  }
   return value;
 }
-function redisJsonReviver(_key, value) {
-  if (value !== null && typeof value === "object" && !Array.isArray(value) && Object.keys(value).length === 1 && BIGINT_TAG in value) {
-    const raw = value[BIGINT_TAG];
-    if (typeof raw === "string") {
-      return BigInt(raw);
+function createRedisJsonReviver(options = {}) {
+  const decimalFactory = options.decimalFactory ?? ((s) => s);
+  return (_key, value) => {
+    if (!isPlainObject(value)) return value;
+    const keys = Object.keys(value);
+    if (keys.length !== 1) return value;
+    if (BIGINT_TAG in value && typeof value[BIGINT_TAG] === "string") {
+      return BigInt(value[BIGINT_TAG]);
     }
-  }
-  return value;
+    if (DATE_TAG in value && typeof value[DATE_TAG] === "string") {
+      return new Date(value[DATE_TAG]);
+    }
+    if (BYTES_TAG in value && typeof value[BYTES_TAG] === "string") {
+      return Buffer.from(value[BYTES_TAG], "base64");
+    }
+    if (DECIMAL_TAG in value && typeof value[DECIMAL_TAG] === "string") {
+      return decimalFactory(value[DECIMAL_TAG]);
+    }
+    return value;
+  };
+}
+function redisJsonReviver(_key, value) {
+  return createRedisJsonReviver()(_key, value);
 }
 function redisJsonStringify(value) {
-  return JSON.stringify(value, redisJsonReplacer);
+  return JSON.stringify(value, function(key, val) {
+    const holder = this;
+    const raw = key === "" ? value : holder[key];
+    if (raw instanceof Date) {
+      return redisJsonReplacer(key, raw);
+    }
+    return redisJsonReplacer(key, val);
+  });
 }
-function redisJsonParse(raw) {
-  return JSON.parse(raw, redisJsonReviver);
+function redisJsonParse(raw, options) {
+  return JSON.parse(raw, createRedisJsonReviver(options));
+}
+function cloneWithCodec(value, options) {
+  if (value === null || value === void 0) return value;
+  if (typeof structuredClone === "function") {
+    try {
+      return structuredClone(value);
+    } catch {
+    }
+  }
+  return redisJsonParse(redisJsonStringify(value), options);
 }
 
 // src/redis-cache-adapter.ts
@@ -86,6 +145,8 @@ var RedisCacheAdapter = class {
   ready = false;
   compression;
   compressionThreshold;
+  jsonOptions;
+  onError;
   constructor(options = {}) {
     const {
       url,
@@ -93,11 +154,15 @@ var RedisCacheAdapter = class {
       port = 6379,
       prefix = "prismakit",
       compression = "none",
-      compressionThresholdBytes = 1024
+      compressionThresholdBytes = 1024,
+      decimalFactory,
+      onError
     } = options;
     this.prefix = prefix;
     this.compression = compression;
     this.compressionThreshold = compressionThresholdBytes;
+    this.jsonOptions = { decimalFactory };
+    this.onError = onError;
     this.client = url ? new import_ioredis.default(url, { lazyConnect: true }) : new import_ioredis.default({ host, port, lazyConnect: true });
     this.client.on("ready", () => {
       this.ready = true;
@@ -111,6 +176,16 @@ var RedisCacheAdapter = class {
     });
     void this.connect();
   }
+  report(op, err) {
+    console.warn(
+      `[RedisCacheAdapter] ${op} failed`,
+      err?.message ?? err
+    );
+    try {
+      this.onError?.(err, op);
+    } catch {
+    }
+  }
   async connect() {
     if (this.client.status === "ready" || this.client.status === "connecting") {
       return;
@@ -118,10 +193,7 @@ var RedisCacheAdapter = class {
     try {
       await this.client.connect();
     } catch (err) {
-      console.warn(
-        "[RedisCacheAdapter] failed to connect",
-        err.message
-      );
+      this.report("connect", err);
     }
   }
   async disconnect() {
@@ -146,11 +218,10 @@ var RedisCacheAdapter = class {
     if (raw.startsWith(COMPRESSED_PREFIX)) {
       const buf = Buffer.from(raw.slice(COMPRESSED_PREFIX.length), "base64");
       const json = (0, import_zlib.gunzipSync)(buf).toString("utf8");
-      return redisJsonParse(json);
+      return redisJsonParse(json, this.jsonOptions);
     }
-    return redisJsonParse(raw);
+    return redisJsonParse(raw, this.jsonOptions);
   }
-  // --- low-level ops (may throw) ---
   async get(key) {
     const raw = await this.client.get(key);
     if (raw === null) return null;
@@ -174,10 +245,6 @@ var RedisCacheAdapter = class {
     const result = await this.client.set(key, "1", "EX", ttlSeconds, "NX");
     return result === "OK";
   }
-  /**
-   * Atomically SET a cache key + SADD into an index SET + EXPIRE the index
-   * via a single Redis pipeline.
-   */
   async setWithIndex(key, value, ttlSeconds, indexKey) {
     const pipeline = this.client.pipeline();
     pipeline.set(key, this.encode(value), "EX", ttlSeconds);
@@ -185,9 +252,6 @@ var RedisCacheAdapter = class {
     pipeline.expire(indexKey, ttlSeconds + INDEX_TTL_BUFFER);
     await pipeline.exec();
   }
-  /**
-   * Atomic invalidation via Lua (SMEMBERS + DEL members + DEL index).
-   */
   async invalidateByIndex(indexKey) {
     await this.client.eval(INVALIDATE_BY_INDEX_LUA, 1, indexKey);
   }
@@ -198,15 +262,11 @@ var RedisCacheAdapter = class {
     pipeline.expire(key, ttlSeconds + INDEX_TTL_BUFFER);
     await pipeline.exec();
   }
-  // --- safe wrappers (never throw — warn + return fallback) ---
   async safeGet(key) {
     try {
       return await this.get(key);
     } catch (err) {
-      console.warn(
-        `[RedisCacheAdapter] safeGet failed for key=${key}`,
-        err.message
-      );
+      this.report(`safeGet key=${key}`, err);
       return null;
     }
   }
@@ -214,30 +274,21 @@ var RedisCacheAdapter = class {
     try {
       await this.set(key, value, ttlSeconds);
     } catch (err) {
-      console.warn(
-        `[RedisCacheAdapter] safeSet failed for key=${key}`,
-        err.message
-      );
+      this.report(`safeSet key=${key}`, err);
     }
   }
   async safeDel(...keys) {
     try {
       await this.del(...keys);
     } catch (err) {
-      console.warn(
-        "[RedisCacheAdapter] safeDel failed",
-        err.message
-      );
+      this.report("safeDel", err);
     }
   }
   async safeSetNx(key, ttlSeconds) {
     try {
       return await this.setNx(key, ttlSeconds);
     } catch (err) {
-      console.warn(
-        `[RedisCacheAdapter] safeSetNx failed for key=${key}`,
-        err.message
-      );
+      this.report(`safeSetNx key=${key}`, err);
       return false;
     }
   }
@@ -245,40 +296,28 @@ var RedisCacheAdapter = class {
     try {
       await this.setWithIndex(key, value, ttlSeconds, indexKey);
     } catch (err) {
-      console.warn(
-        `[RedisCacheAdapter] safeSetWithIndex failed for key=${key}`,
-        err.message
-      );
+      this.report(`safeSetWithIndex key=${key}`, err);
     }
   }
   async safeInvalidateByIndex(indexKey) {
     try {
       await this.invalidateByIndex(indexKey);
     } catch (err) {
-      console.warn(
-        `[RedisCacheAdapter] safeInvalidateByIndex failed for idx=${indexKey}`,
-        err.message
-      );
+      this.report(`safeInvalidateByIndex idx=${indexKey}`, err);
     }
   }
   async safeSaddAndExpire(key, members, ttlSeconds) {
     try {
       await this.saddAndExpire(key, members, ttlSeconds);
     } catch (err) {
-      console.warn(
-        `[RedisCacheAdapter] safeSaddAndExpire failed for key=${key}`,
-        err.message
-      );
+      this.report(`safeSaddAndExpire key=${key}`, err);
     }
   }
   async safeSmembers(key) {
     try {
       return await this.smembers(key);
     } catch (err) {
-      console.warn(
-        `[RedisCacheAdapter] safeSmembers failed for key=${key}`,
-        err.message
-      );
+      this.report(`safeSmembers key=${key}`, err);
       return [];
     }
   }
@@ -290,6 +329,8 @@ var import_core = require("@prismakit/core");
 0 && (module.exports = {
   RedisCacheAdapter,
   cacheDebugStorage,
+  cloneWithCodec,
+  createRedisJsonReviver,
   isCacheDebugEnabled,
   recordCacheDebug,
   redisJsonParse,

package/dist/index.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/index.ts","../src/redis-cache-adapter.ts","../src/redis-json.ts"],"sourcesContent":["export {\n  RedisCacheAdapter,\n  type RedisCacheAdapterOptions,\n  type RedisCompression,\n} from './redis-cache-adapter';\n\nexport {\n  redisJsonParse,\n  redisJsonStringify,\n  redisJsonReplacer,\n  redisJsonReviver,\n} from './redis-json';\n\n/** Re-export cache debug helpers from core — do not duplicate. */\nexport {\n  type CacheDebugStatus,\n  cacheDebugStorage,\n  isCacheDebugEnabled,\n  recordCacheDebug,\n} from '@prismakit/core';\n\nexport type { CacheAdapter } from '@prismakit/core';\n","import Redis from 'ioredis';\nimport { gzipSync, gunzipSync } from 'zlib';\nimport type { CacheAdapter } from '@prismakit/core';\nimport { redisJsonParse, redisJsonStringify } from './redis-json';\n\nconst INDEX_TTL_BUFFER = 60;\n\n/** Lua: atomically SMEMBERS index + DEL members + index. */\nconst INVALIDATE_BY_INDEX_LUA = `\nlocal members = redis.call('SMEMBERS', KEYS[1])\nfor i, member in ipairs(members) do\n  redis.call('DEL', member)\nend\nredis.call('DEL', KEYS[1])\nreturn #members\n`;\n\nexport type RedisCompression = 'none' | 'gzip';\n\nexport type RedisCacheAdapterOptions = {\n  url?: string;\n  host?: string;\n  port?: number;\n  prefix?: string;\n  /**\n   * Compress payloads larger than `compressionThresholdBytes` (default 1024).\n   * Uses gzip (widely available; zstd/lz4 can be added later).\n   */\n  compression?: RedisCompression;\n  /** Minimum payload size (bytes) before compression (default 1024). */\n  compressionThresholdBytes?: number;\n};\n\nconst COMPRESSED_PREFIX = 'gz:';\n\n/**\n * Redis-backed {@link CacheAdapter}. Framework-agnostic — no NestJS / ConfigService.\n */\nexport class RedisCacheAdapter implements CacheAdapter {\n  private readonly client: Redis;\n  private readonly prefix: string;\n  private ready = false;\n  private readonly compression: RedisCompression;\n  private readonly compressionThreshold: number;\n\n  constructor(options: RedisCacheAdapterOptions = {}) {\n    const {\n      url,\n      host = 'localhost',\n      port = 6379,\n      prefix = 'prismakit',\n      compression = 'none',\n      compressionThresholdBytes = 1024,\n    } = options;\n\n    this.prefix = prefix;\n    this.compression = compression;\n    this.compressionThreshold = compressionThresholdBytes;\n    this.client = url\n      ? new Redis(url, { lazyConnect: true })\n      : new Redis({ host, port, lazyConnect: true });\n\n    this.client.on('ready', () => {\n      this.ready = true;\n    });\n    this.client.on('error', (err) => {\n      this.ready = false;\n      console.warn('[RedisCacheAdapter] connection error', err.message);\n    });\n    this.client.on('close', () => {\n      this.ready = false;\n    });\n\n    void this.connect();\n  }\n\n  async connect(): Promise<void> {\n    if (this.client.status === 'ready' || this.client.status === 'connecting') {\n      return;\n    }\n    try {\n      await this.client.connect();\n    } catch (err) {\n      console.warn(\n        '[RedisCacheAdapter] failed to connect',\n        (err as Error).message,\n      );\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    await this.client?.quit();\n    this.ready = false;\n  }\n\n  isReady(): boolean {\n    return this.ready;\n  }\n\n  getPrefix(): string {\n    return this.prefix;\n  }\n\n  private encode(value: unknown): string {\n    const json = redisJsonStringify(value);\n    if (\n      this.compression === 'gzip' &&\n      Buffer.byteLength(json, 'utf8') >= this.compressionThreshold\n    ) {\n      const compressed = gzipSync(Buffer.from(json, 'utf8')).toString('base64');\n      return COMPRESSED_PREFIX + compressed;\n    }\n    return json;\n  }\n\n  private decode<T>(raw: string): T {\n    if (raw.startsWith(COMPRESSED_PREFIX)) {\n      const buf = Buffer.from(raw.slice(COMPRESSED_PREFIX.length), 'base64');\n      const json = gunzipSync(buf).toString('utf8');\n      return redisJsonParse<T>(json);\n    }\n    return redisJsonParse<T>(raw);\n  }\n\n  // --- low-level ops (may throw) ---\n\n  async get<T>(key: string): Promise<T | null> {\n    const raw = await this.client.get(key);\n    if (raw === null) return null;\n    return this.decode<T>(raw);\n  }\n\n  async set(key: string, value: unknown, ttlSeconds: number): Promise<void> {\n    await this.client.set(key, this.encode(value), 'EX', ttlSeconds);\n  }\n\n  async del(...keys: string[]): Promise<void> {\n    if (keys.length === 0) return;\n    await this.client.del(...keys);\n  }\n\n  async sadd(key: string, ...members: string[]): Promise<void> {\n    if (members.length === 0) return;\n    await this.client.sadd(key, ...members);\n  }\n\n  async smembers(key: string): Promise<string[]> {\n    return this.client.smembers(key);\n  }\n\n  async setNx(key: string, ttlSeconds: number): Promise<boolean> {\n    const result = await this.client.set(key, '1', 'EX', ttlSeconds, 'NX');\n    return result === 'OK';\n  }\n\n  /**\n   * Atomically SET a cache key + SADD into an index SET + EXPIRE the index\n   * via a single Redis pipeline.\n   */\n  async setWithIndex(\n    key: string,\n    value: unknown,\n    ttlSeconds: number,\n    indexKey: string,\n  ): Promise<void> {\n    const pipeline = this.client.pipeline();\n    pipeline.set(key, this.encode(value), 'EX', ttlSeconds);\n    pipeline.sadd(indexKey, key);\n    pipeline.expire(indexKey, ttlSeconds + INDEX_TTL_BUFFER);\n    await pipeline.exec();\n  }\n\n  /**\n   * Atomic invalidation via Lua (SMEMBERS + DEL members + DEL index).\n   */\n  async invalidateByIndex(indexKey: string): Promise<void> {\n    await this.client.eval(INVALIDATE_BY_INDEX_LUA, 1, indexKey);\n  }\n\n  async saddAndExpire(\n    key: string,\n    members: string[],\n    ttlSeconds: number,\n  ): Promise<void> {\n    if (members.length === 0) return;\n    const pipeline = this.client.pipeline();\n    pipeline.sadd(key, ...members);\n    pipeline.expire(key, ttlSeconds + INDEX_TTL_BUFFER);\n    await pipeline.exec();\n  }\n\n  // --- safe wrappers (never throw — warn + return fallback) ---\n\n  async safeGet<T>(key: string): Promise<T | null> {\n    try {\n      return await this.get<T>(key);\n    } catch (err) {\n      console.warn(\n        `[RedisCacheAdapter] safeGet failed for key=${key}`,\n        (err as Error).message,\n      );\n      return null;\n    }\n  }\n\n  async safeSet(\n    key: string,\n    value: unknown,\n    ttlSeconds: number,\n  ): Promise<void> {\n    try {\n      await this.set(key, value, ttlSeconds);\n    } catch (err) {\n      console.warn(\n        `[RedisCacheAdapter] safeSet failed for key=${key}`,\n        (err as Error).message,\n      );\n    }\n  }\n\n  async safeDel(...keys: string[]): Promise<void> {\n    try {\n      await this.del(...keys);\n    } catch (err) {\n      console.warn(\n        '[RedisCacheAdapter] safeDel failed',\n        (err as Error).message,\n      );\n    }\n  }\n\n  async safeSetNx(key: string, ttlSeconds: number): Promise<boolean> {\n    try {\n      return await this.setNx(key, ttlSeconds);\n    } catch (err) {\n      console.warn(\n        `[RedisCacheAdapter] safeSetNx failed for key=${key}`,\n        (err as Error).message,\n      );\n      return false;\n    }\n  }\n\n  async safeSetWithIndex(\n    key: string,\n    value: unknown,\n    ttlSeconds: number,\n    indexKey: string,\n  ): Promise<void> {\n    try {\n      await this.setWithIndex(key, value, ttlSeconds, indexKey);\n    } catch (err) {\n      console.warn(\n        `[RedisCacheAdapter] safeSetWithIndex failed for key=${key}`,\n        (err as Error).message,\n      );\n    }\n  }\n\n  async safeInvalidateByIndex(indexKey: string): Promise<void> {\n    try {\n      await this.invalidateByIndex(indexKey);\n    } catch (err) {\n      console.warn(\n        `[RedisCacheAdapter] safeInvalidateByIndex failed for idx=${indexKey}`,\n        (err as Error).message,\n      );\n    }\n  }\n\n  async safeSaddAndExpire(\n    key: string,\n    members: string[],\n    ttlSeconds: number,\n  ): Promise<void> {\n    try {\n      await this.saddAndExpire(key, members, ttlSeconds);\n    } catch (err) {\n      console.warn(\n        `[RedisCacheAdapter] safeSaddAndExpire failed for key=${key}`,\n        (err as Error).message,\n      );\n    }\n  }\n\n  async safeSmembers(key: string): Promise<string[]> {\n    try {\n      return await this.smembers(key);\n    } catch (err) {\n      console.warn(\n        `[RedisCacheAdapter] safeSmembers failed for key=${key}`,\n        (err as Error).message,\n      );\n      return [];\n    }\n  }\n}\n","const BIGINT_TAG = '__bigint';\n\n/** JSON.stringify replacer — Prisma `BigInt` fields are not JSON-serializable by default. */\nexport function redisJsonReplacer(_key: string, value: unknown): unknown {\n  if (typeof value === 'bigint') {\n    return { [BIGINT_TAG]: value.toString() };\n  }\n  return value;\n}\n\n/** JSON.parse reviver — restore tagged BigInt payloads from {@link redisJsonReplacer}. */\nexport function redisJsonReviver(_key: string, value: unknown): unknown {\n  if (\n    value !== null &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    Object.keys(value).length === 1 &&\n    BIGINT_TAG in value\n  ) {\n    const raw = (value as Record<string, unknown>)[BIGINT_TAG];\n    if (typeof raw === 'string') {\n      return BigInt(raw);\n    }\n  }\n  return value;\n}\n\nexport function redisJsonStringify(value: unknown): string {\n  return JSON.stringify(value, redisJsonReplacer);\n}\n\nexport function redisJsonParse<T>(raw: string): T {\n  return JSON.parse(raw, redisJsonReviver) as T;\n}\n"],"mappings":"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","names":["Redis"]}
+{"version":3,"sources":["../src/index.ts","../src/redis-cache-adapter.ts","../src/redis-json.ts"],"sourcesContent":["export {\n  RedisCacheAdapter,\n  type RedisCacheAdapterOptions,\n  type RedisCompression,\n} from './redis-cache-adapter';\n\nexport {\n  redisJsonParse,\n  redisJsonStringify,\n  redisJsonReplacer,\n  redisJsonReviver,\n  createRedisJsonReviver,\n  cloneWithCodec,\n  type DecimalFactory,\n  type RedisJsonOptions,\n} from './redis-json';\n\n/** Re-export cache debug helpers from core — do not duplicate. */\nexport {\n  type CacheDebugStatus,\n  cacheDebugStorage,\n  isCacheDebugEnabled,\n  recordCacheDebug,\n} from '@prismakit/core';\n\nexport type { CacheAdapter } from '@prismakit/core';\n","import Redis from 'ioredis';\nimport { gzipSync, gunzipSync } from 'zlib';\nimport type { CacheAdapter } from '@prismakit/core';\nimport {\n  redisJsonParse,\n  redisJsonStringify,\n  type DecimalFactory,\n  type RedisJsonOptions,\n} from './redis-json';\n\nconst INDEX_TTL_BUFFER = 60;\n\n/** Lua: atomically SMEMBERS index + DEL members + index. */\nconst INVALIDATE_BY_INDEX_LUA = `\nlocal members = redis.call('SMEMBERS', KEYS[1])\nfor i, member in ipairs(members) do\n  redis.call('DEL', member)\nend\nredis.call('DEL', KEYS[1])\nreturn #members\n`;\n\nexport type RedisCompression = 'none' | 'gzip';\n\nexport type RedisCacheAdapterOptions = {\n  url?: string;\n  host?: string;\n  port?: number;\n  prefix?: string;\n  /**\n   * Compress payloads larger than `compressionThresholdBytes` (default 1024).\n   * Uses gzip (widely available; zstd/lz4 can be added later).\n   */\n  compression?: RedisCompression;\n  /** Minimum payload size (bytes) before compression (default 1024). */\n  compressionThresholdBytes?: number;\n  /**\n   * Reconstruct Prisma Decimal from tagged cache payloads.\n   * @example decimalFactory: (s) => new Prisma.Decimal(s)\n   */\n  decimalFactory?: DecimalFactory;\n  /** Optional error hook for safe* wrappers (also used by telemetry). */\n  onError?: (err: unknown, op?: string) => void;\n};\n\nconst COMPRESSED_PREFIX = 'gz:';\n\n/**\n * Redis-backed {@link CacheAdapter}. Framework-agnostic — no NestJS / ConfigService.\n */\nexport class RedisCacheAdapter implements CacheAdapter {\n  private readonly client: Redis;\n  private readonly prefix: string;\n  private ready = false;\n  private readonly compression: RedisCompression;\n  private readonly compressionThreshold: number;\n  private readonly jsonOptions: RedisJsonOptions;\n  onError?: (err: unknown, op?: string) => void;\n\n  constructor(options: RedisCacheAdapterOptions = {}) {\n    const {\n      url,\n      host = 'localhost',\n      port = 6379,\n      prefix = 'prismakit',\n      compression = 'none',\n      compressionThresholdBytes = 1024,\n      decimalFactory,\n      onError,\n    } = options;\n\n    this.prefix = prefix;\n    this.compression = compression;\n    this.compressionThreshold = compressionThresholdBytes;\n    this.jsonOptions = { decimalFactory };\n    this.onError = onError;\n    this.client = url\n      ? new Redis(url, { lazyConnect: true })\n      : new Redis({ host, port, lazyConnect: true });\n\n    this.client.on('ready', () => {\n      this.ready = true;\n    });\n    this.client.on('error', (err) => {\n      this.ready = false;\n      console.warn('[RedisCacheAdapter] connection error', err.message);\n    });\n    this.client.on('close', () => {\n      this.ready = false;\n    });\n\n    void this.connect();\n  }\n\n  private report(op: string, err: unknown): void {\n    console.warn(\n      `[RedisCacheAdapter] ${op} failed`,\n      (err as Error)?.message ?? err,\n    );\n    try {\n      this.onError?.(err, op);\n    } catch {\n      /* ignore hook errors */\n    }\n  }\n\n  async connect(): Promise<void> {\n    if (this.client.status === 'ready' || this.client.status === 'connecting') {\n      return;\n    }\n    try {\n      await this.client.connect();\n    } catch (err) {\n      this.report('connect', err);\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    await this.client?.quit();\n    this.ready = false;\n  }\n\n  isReady(): boolean {\n    return this.ready;\n  }\n\n  getPrefix(): string {\n    return this.prefix;\n  }\n\n  private encode(value: unknown): string {\n    const json = redisJsonStringify(value);\n    if (\n      this.compression === 'gzip' &&\n      Buffer.byteLength(json, 'utf8') >= this.compressionThreshold\n    ) {\n      const compressed = gzipSync(Buffer.from(json, 'utf8')).toString('base64');\n      return COMPRESSED_PREFIX + compressed;\n    }\n    return json;\n  }\n\n  private decode<T>(raw: string): T {\n    if (raw.startsWith(COMPRESSED_PREFIX)) {\n      const buf = Buffer.from(raw.slice(COMPRESSED_PREFIX.length), 'base64');\n      const json = gunzipSync(buf).toString('utf8');\n      return redisJsonParse<T>(json, this.jsonOptions);\n    }\n    return redisJsonParse<T>(raw, this.jsonOptions);\n  }\n\n  async get<T>(key: string): Promise<T | null> {\n    const raw = await this.client.get(key);\n    if (raw === null) return null;\n    return this.decode<T>(raw);\n  }\n\n  async set(key: string, value: unknown, ttlSeconds: number): Promise<void> {\n    await this.client.set(key, this.encode(value), 'EX', ttlSeconds);\n  }\n\n  async del(...keys: string[]): Promise<void> {\n    if (keys.length === 0) return;\n    await this.client.del(...keys);\n  }\n\n  async sadd(key: string, ...members: string[]): Promise<void> {\n    if (members.length === 0) return;\n    await this.client.sadd(key, ...members);\n  }\n\n  async smembers(key: string): Promise<string[]> {\n    return this.client.smembers(key);\n  }\n\n  async setNx(key: string, ttlSeconds: number): Promise<boolean> {\n    const result = await this.client.set(key, '1', 'EX', ttlSeconds, 'NX');\n    return result === 'OK';\n  }\n\n  async setWithIndex(\n    key: string,\n    value: unknown,\n    ttlSeconds: number,\n    indexKey: string,\n  ): Promise<void> {\n    const pipeline = this.client.pipeline();\n    pipeline.set(key, this.encode(value), 'EX', ttlSeconds);\n    pipeline.sadd(indexKey, key);\n    pipeline.expire(indexKey, ttlSeconds + INDEX_TTL_BUFFER);\n    await pipeline.exec();\n  }\n\n  async invalidateByIndex(indexKey: string): Promise<void> {\n    await this.client.eval(INVALIDATE_BY_INDEX_LUA, 1, indexKey);\n  }\n\n  async saddAndExpire(\n    key: string,\n    members: string[],\n    ttlSeconds: number,\n  ): Promise<void> {\n    if (members.length === 0) return;\n    const pipeline = this.client.pipeline();\n    pipeline.sadd(key, ...members);\n    pipeline.expire(key, ttlSeconds + INDEX_TTL_BUFFER);\n    await pipeline.exec();\n  }\n\n  async safeGet<T>(key: string): Promise<T | null> {\n    try {\n      return await this.get<T>(key);\n    } catch (err) {\n      this.report(`safeGet key=${key}`, err);\n      return null;\n    }\n  }\n\n  async safeSet(\n    key: string,\n    value: unknown,\n    ttlSeconds: number,\n  ): Promise<void> {\n    try {\n      await this.set(key, value, ttlSeconds);\n    } catch (err) {\n      this.report(`safeSet key=${key}`, err);\n    }\n  }\n\n  async safeDel(...keys: string[]): Promise<void> {\n    try {\n      await this.del(...keys);\n    } catch (err) {\n      this.report('safeDel', err);\n    }\n  }\n\n  async safeSetNx(key: string, ttlSeconds: number): Promise<boolean> {\n    try {\n      return await this.setNx(key, ttlSeconds);\n    } catch (err) {\n      this.report(`safeSetNx key=${key}`, err);\n      return false;\n    }\n  }\n\n  async safeSetWithIndex(\n    key: string,\n    value: unknown,\n    ttlSeconds: number,\n    indexKey: string,\n  ): Promise<void> {\n    try {\n      await this.setWithIndex(key, value, ttlSeconds, indexKey);\n    } catch (err) {\n      this.report(`safeSetWithIndex key=${key}`, err);\n    }\n  }\n\n  async safeInvalidateByIndex(indexKey: string): Promise<void> {\n    try {\n      await this.invalidateByIndex(indexKey);\n    } catch (err) {\n      this.report(`safeInvalidateByIndex idx=${indexKey}`, err);\n    }\n  }\n\n  async safeSaddAndExpire(\n    key: string,\n    members: string[],\n    ttlSeconds: number,\n  ): Promise<void> {\n    try {\n      await this.saddAndExpire(key, members, ttlSeconds);\n    } catch (err) {\n      this.report(`safeSaddAndExpire key=${key}`, err);\n    }\n  }\n\n  async safeSmembers(key: string): Promise<string[]> {\n    try {\n      return await this.smembers(key);\n    } catch (err) {\n      this.report(`safeSmembers key=${key}`, err);\n      return [];\n    }\n  }\n}\n","const BIGINT_TAG = '__bigint';\nconst DATE_TAG = '__date';\nconst BYTES_TAG = '__bytes';\nconst DECIMAL_TAG = '__decimal';\n\nexport type DecimalFactory = (value: string) => unknown;\n\nexport type RedisJsonOptions = {\n  /**\n   * Reconstruct Prisma `Decimal` (or equivalent) from the tagged string.\n   * Default keeps the precision-preserving string so values are not silently\n   * coerced to numbers.\n   *\n   * @example\n   * decimalFactory: (s) => new Prisma.Decimal(s)\n   */\n  decimalFactory?: DecimalFactory;\n};\n\nfunction isPlainObject(value: unknown): value is Record<string, unknown> {\n  return (\n    value !== null &&\n    typeof value === 'object' &&\n    !Array.isArray(value) &&\n    !(value instanceof Date) &&\n    !Buffer.isBuffer(value)\n  );\n}\n\nfunction isDecimalLike(value: unknown): value is { toFixed: () => string } {\n  return (\n    isPlainObject(value) &&\n    typeof (value as { constructor?: { name?: string } }).constructor?.name ===\n      'string' &&\n    ((value as { constructor: { name: string } }).constructor.name ===\n      'Decimal' ||\n      (typeof (value as { toFixed?: unknown }).toFixed === 'function' &&\n        typeof (value as { d?: unknown }).d === 'object'))\n  );\n}\n\n/** JSON.stringify replacer — Prisma BigInt / Date / Bytes / Decimal. */\nexport function redisJsonReplacer(_key: string, value: unknown): unknown {\n  if (typeof value === 'bigint') {\n    return { [BIGINT_TAG]: value.toString() };\n  }\n  if (value instanceof Date) {\n    return { [DATE_TAG]: value.toISOString() };\n  }\n  if (Buffer.isBuffer(value)) {\n    return { [BYTES_TAG]: value.toString('base64') };\n  }\n  if (\n    value &&\n    typeof value === 'object' &&\n    (value as { type?: string }).type === 'Buffer' &&\n    Array.isArray((value as { data?: unknown }).data)\n  ) {\n    return {\n      [BYTES_TAG]: Buffer.from(\n        (value as { data: number[] }).data,\n      ).toString('base64'),\n    };\n  }\n  if (isDecimalLike(value)) {\n    return { [DECIMAL_TAG]: value.toFixed() };\n  }\n  return value;\n}\n\n/** JSON.parse reviver — restore tagged payloads from {@link redisJsonReplacer}. */\nexport function createRedisJsonReviver(options: RedisJsonOptions = {}) {\n  const decimalFactory = options.decimalFactory ?? ((s: string) => s);\n  return (_key: string, value: unknown): unknown => {\n    if (!isPlainObject(value)) return value;\n    const keys = Object.keys(value);\n    if (keys.length !== 1) return value;\n\n    if (BIGINT_TAG in value && typeof value[BIGINT_TAG] === 'string') {\n      return BigInt(value[BIGINT_TAG] as string);\n    }\n    if (DATE_TAG in value && typeof value[DATE_TAG] === 'string') {\n      return new Date(value[DATE_TAG] as string);\n    }\n    if (BYTES_TAG in value && typeof value[BYTES_TAG] === 'string') {\n      return Buffer.from(value[BYTES_TAG] as string, 'base64');\n    }\n    if (DECIMAL_TAG in value && typeof value[DECIMAL_TAG] === 'string') {\n      return decimalFactory(value[DECIMAL_TAG] as string);\n    }\n    return value;\n  };\n}\n\n/** @deprecated Prefer {@link createRedisJsonReviver} when a decimalFactory is needed. */\nexport function redisJsonReviver(_key: string, value: unknown): unknown {\n  return createRedisJsonReviver()(_key, value);\n}\n\nexport function redisJsonStringify(value: unknown): string {\n  return JSON.stringify(value, function (key, val) {\n    const holder = this as Record<string, unknown>;\n    const raw = key === '' ? value : holder[key];\n    if (raw instanceof Date) {\n      return redisJsonReplacer(key, raw);\n    }\n    return redisJsonReplacer(key, val);\n  });\n}\n\nexport function redisJsonParse<T>(\n  raw: string,\n  options?: RedisJsonOptions,\n): T {\n  return JSON.parse(raw, createRedisJsonReviver(options)) as T;\n}\n\n/**\n * Deep clone via structuredClone, falling back to the tagged JSON codec so\n * Date / BigInt / Buffer / Decimal survive (unlike plain JSON.stringify).\n */\nexport function cloneWithCodec<T>(value: T, options?: RedisJsonOptions): T {\n  if (value === null || value === undefined) return value;\n  if (typeof structuredClone === 'function') {\n    try {\n      return structuredClone(value);\n    } catch {\n      // Fall through for non-cloneable values (e.g. Decimal)\n    }\n  }\n  return redisJsonParse(redisJsonStringify(value), options);\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,qBAAkB;AAClB,kBAAqC;;;ACDrC,IAAM,aAAa;AACnB,IAAM,WAAW;AACjB,IAAM,YAAY;AAClB,IAAM,cAAc;AAgBpB,SAAS,cAAc,OAAkD;AACvE,SACE,UAAU,QACV,OAAO,UAAU,YACjB,CAAC,MAAM,QAAQ,KAAK,KACpB,EAAE,iBAAiB,SACnB,CAAC,OAAO,SAAS,KAAK;AAE1B;AAEA,SAAS,cAAc,OAAoD;AACzE,SACE,cAAc,KAAK,KACnB,OAAQ,MAA8C,aAAa,SACjE,aACA,MAA4C,YAAY,SACxD,aACC,OAAQ,MAAgC,YAAY,cACnD,OAAQ,MAA0B,MAAM;AAEhD;AAGO,SAAS,kBAAkB,MAAc,OAAyB;AACvE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,CAAC,UAAU,GAAG,MAAM,SAAS,EAAE;AAAA,EAC1C;AACA,MAAI,iBAAiB,MAAM;AACzB,WAAO,EAAE,CAAC,QAAQ,GAAG,MAAM,YAAY,EAAE;AAAA,EAC3C;AACA,MAAI,OAAO,SAAS,KAAK,GAAG;AAC1B,WAAO,EAAE,CAAC,SAAS,GAAG,MAAM,SAAS,QAAQ,EAAE;AAAA,EACjD;AACA,MACE,SACA,OAAO,UAAU,YAChB,MAA4B,SAAS,YACtC,MAAM,QAAS,MAA6B,IAAI,GAChD;AACA,WAAO;AAAA,MACL,CAAC,SAAS,GAAG,OAAO;AAAA,QACjB,MAA6B;AAAA,MAChC,EAAE,SAAS,QAAQ;AAAA,IACrB;AAAA,EACF;AACA,MAAI,cAAc,KAAK,GAAG;AACxB,WAAO,EAAE,CAAC,WAAW,GAAG,MAAM,QAAQ,EAAE;AAAA,EAC1C;AACA,SAAO;AACT;AAGO,SAAS,uBAAuB,UAA4B,CAAC,GAAG;AACrE,QAAM,iBAAiB,QAAQ,mBAAmB,CAAC,MAAc;AACjE,SAAO,CAAC,MAAc,UAA4B;AAChD,QAAI,CAAC,cAAc,KAAK,EAAG,QAAO;AAClC,UAAM,OAAO,OAAO,KAAK,KAAK;AAC9B,QAAI,KAAK,WAAW,EAAG,QAAO;AAE9B,QAAI,cAAc,SAAS,OAAO,MAAM,UAAU,MAAM,UAAU;AAChE,aAAO,OAAO,MAAM,UAAU,CAAW;AAAA,IAC3C;AACA,QAAI,YAAY,SAAS,OAAO,MAAM,QAAQ,MAAM,UAAU;AAC5D,aAAO,IAAI,KAAK,MAAM,QAAQ,CAAW;AAAA,IAC3C;AACA,QAAI,aAAa,SAAS,OAAO,MAAM,SAAS,MAAM,UAAU;AAC9D,aAAO,OAAO,KAAK,MAAM,SAAS,GAAa,QAAQ;AAAA,IACzD;AACA,QAAI,eAAe,SAAS,OAAO,MAAM,WAAW,MAAM,UAAU;AAClE,aAAO,eAAe,MAAM,WAAW,CAAW;AAAA,IACpD;AACA,WAAO;AAAA,EACT;AACF;AAGO,SAAS,iBAAiB,MAAc,OAAyB;AACtE,SAAO,uBAAuB,EAAE,MAAM,KAAK;AAC7C;AAEO,SAAS,mBAAmB,OAAwB;AACzD,SAAO,KAAK,UAAU,OAAO,SAAU,KAAK,KAAK;AAC/C,UAAM,SAAS;AACf,UAAM,MAAM,QAAQ,KAAK,QAAQ,OAAO,GAAG;AAC3C,QAAI,eAAe,MAAM;AACvB,aAAO,kBAAkB,KAAK,GAAG;AAAA,IACnC;AACA,WAAO,kBAAkB,KAAK,GAAG;AAAA,EACnC,CAAC;AACH;AAEO,SAAS,eACd,KACA,SACG;AACH,SAAO,KAAK,MAAM,KAAK,uBAAuB,OAAO,CAAC;AACxD;AAMO,SAAS,eAAkB,OAAU,SAA+B;AACzE,MAAI,UAAU,QAAQ,UAAU,OAAW,QAAO;AAClD,MAAI,OAAO,oBAAoB,YAAY;AACzC,QAAI;AACF,aAAO,gBAAgB,KAAK;AAAA,IAC9B,QAAQ;AAAA,IAER;AAAA,EACF;AACA,SAAO,eAAe,mBAAmB,KAAK,GAAG,OAAO;AAC1D;;;ADzHA,IAAM,mBAAmB;AAGzB,IAAM,0BAA0B;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAgChC,IAAM,oBAAoB;AAKnB,IAAM,oBAAN,MAAgD;AAAA,EACpC;AAAA,EACA;AAAA,EACT,QAAQ;AAAA,EACC;AAAA,EACA;AAAA,EACA;AAAA,EACjB;AAAA,EAEA,YAAY,UAAoC,CAAC,GAAG;AAClD,UAAM;AAAA,MACJ;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,MACP,SAAS;AAAA,MACT,cAAc;AAAA,MACd,4BAA4B;AAAA,MAC5B;AAAA,MACA;AAAA,IACF,IAAI;AAEJ,SAAK,SAAS;AACd,SAAK,cAAc;AACnB,SAAK,uBAAuB;AAC5B,SAAK,cAAc,EAAE,eAAe;AACpC,SAAK,UAAU;AACf,SAAK,SAAS,MACV,IAAI,eAAAA,QAAM,KAAK,EAAE,aAAa,KAAK,CAAC,IACpC,IAAI,eAAAA,QAAM,EAAE,MAAM,MAAM,aAAa,KAAK,CAAC;AAE/C,SAAK,OAAO,GAAG,SAAS,MAAM;AAC5B,WAAK,QAAQ;AAAA,IACf,CAAC;AACD,SAAK,OAAO,GAAG,SAAS,CAAC,QAAQ;AAC/B,WAAK,QAAQ;AACb,cAAQ,KAAK,wCAAwC,IAAI,OAAO;AAAA,IAClE,CAAC;AACD,SAAK,OAAO,GAAG,SAAS,MAAM;AAC5B,WAAK,QAAQ;AAAA,IACf,CAAC;AAED,SAAK,KAAK,QAAQ;AAAA,EACpB;AAAA,EAEQ,OAAO,IAAY,KAAoB;AAC7C,YAAQ;AAAA,MACN,uBAAuB,EAAE;AAAA,MACxB,KAAe,WAAW;AAAA,IAC7B;AACA,QAAI;AACF,WAAK,UAAU,KAAK,EAAE;AAAA,IACxB,QAAQ;AAAA,IAER;AAAA,EACF;AAAA,EAEA,MAAM,UAAyB;AAC7B,QAAI,KAAK,OAAO,WAAW,WAAW,KAAK,OAAO,WAAW,cAAc;AACzE;AAAA,IACF;AACA,QAAI;AACF,YAAM,KAAK,OAAO,QAAQ;AAAA,IAC5B,SAAS,KAAK;AACZ,WAAK,OAAO,WAAW,GAAG;AAAA,IAC5B;AAAA,EACF;AAAA,EAEA,MAAM,aAA4B;AAChC,UAAM,KAAK,QAAQ,KAAK;AACxB,SAAK,QAAQ;AAAA,EACf;AAAA,EAEA,UAAmB;AACjB,WAAO,KAAK;AAAA,EACd;AAAA,EAEA,YAAoB;AAClB,WAAO,KAAK;AAAA,EACd;AAAA,EAEQ,OAAO,OAAwB;AACrC,UAAM,OAAO,mBAAmB,KAAK;AACrC,QACE,KAAK,gBAAgB,UACrB,OAAO,WAAW,MAAM,MAAM,KAAK,KAAK,sBACxC;AACA,YAAM,iBAAa,sBAAS,OAAO,KAAK,MAAM,MAAM,CAAC,EAAE,SAAS,QAAQ;AACxE,aAAO,oBAAoB;AAAA,IAC7B;AACA,WAAO;AAAA,EACT;AAAA,EAEQ,OAAU,KAAgB;AAChC,QAAI,IAAI,WAAW,iBAAiB,GAAG;AACrC,YAAM,MAAM,OAAO,KAAK,IAAI,MAAM,kBAAkB,MAAM,GAAG,QAAQ;AACrE,YAAM,WAAO,wBAAW,GAAG,EAAE,SAAS,MAAM;AAC5C,aAAO,eAAkB,MAAM,KAAK,WAAW;AAAA,IACjD;AACA,WAAO,eAAkB,KAAK,KAAK,WAAW;AAAA,EAChD;AAAA,EAEA,MAAM,IAAO,KAAgC;AAC3C,UAAM,MAAM,MAAM,KAAK,OAAO,IAAI,GAAG;AACrC,QAAI,QAAQ,KAAM,QAAO;AACzB,WAAO,KAAK,OAAU,GAAG;AAAA,EAC3B;AAAA,EAEA,MAAM,IAAI,KAAa,OAAgB,YAAmC;AACxE,UAAM,KAAK,OAAO,IAAI,KAAK,KAAK,OAAO,KAAK,GAAG,MAAM,UAAU;AAAA,EACjE;AAAA,EAEA,MAAM,OAAO,MAA+B;AAC1C,QAAI,KAAK,WAAW,EAAG;AACvB,UAAM,KAAK,OAAO,IAAI,GAAG,IAAI;AAAA,EAC/B;AAAA,EAEA,MAAM,KAAK,QAAgB,SAAkC;AAC3D,QAAI,QAAQ,WAAW,EAAG;AAC1B,UAAM,KAAK,OAAO,KAAK,KAAK,GAAG,OAAO;AAAA,EACxC;AAAA,EAEA,MAAM,SAAS,KAAgC;AAC7C,WAAO,KAAK,OAAO,SAAS,GAAG;AAAA,EACjC;AAAA,EAEA,MAAM,MAAM,KAAa,YAAsC;AAC7D,UAAM,SAAS,MAAM,KAAK,OAAO,IAAI,KAAK,KAAK,MAAM,YAAY,IAAI;AACrE,WAAO,WAAW;AAAA,EACpB;AAAA,EAEA,MAAM,aACJ,KACA,OACA,YACA,UACe;AACf,UAAM,WAAW,KAAK,OAAO,SAAS;AACtC,aAAS,IAAI,KAAK,KAAK,OAAO,KAAK,GAAG,MAAM,UAAU;AACtD,aAAS,KAAK,UAAU,GAAG;AAC3B,aAAS,OAAO,UAAU,aAAa,gBAAgB;AACvD,UAAM,SAAS,KAAK;AAAA,EACtB;AAAA,EAEA,MAAM,kBAAkB,UAAiC;AACvD,UAAM,KAAK,OAAO,KAAK,yBAAyB,GAAG,QAAQ;AAAA,EAC7D;AAAA,EAEA,MAAM,cACJ,KACA,SACA,YACe;AACf,QAAI,QAAQ,WAAW,EAAG;AAC1B,UAAM,WAAW,KAAK,OAAO,SAAS;AACtC,aAAS,KAAK,KAAK,GAAG,OAAO;AAC7B,aAAS,OAAO,KAAK,aAAa,gBAAgB;AAClD,UAAM,SAAS,KAAK;AAAA,EACtB;AAAA,EAEA,MAAM,QAAW,KAAgC;AAC/C,QAAI;AACF,aAAO,MAAM,KAAK,IAAO,GAAG;AAAA,IAC9B,SAAS,KAAK;AACZ,WAAK,OAAO,eAAe,GAAG,IAAI,GAAG;AACrC,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,QACJ,KACA,OACA,YACe;AACf,QAAI;AACF,YAAM,KAAK,IAAI,KAAK,OAAO,UAAU;AAAA,IACvC,SAAS,KAAK;AACZ,WAAK,OAAO,eAAe,GAAG,IAAI,GAAG;AAAA,IACvC;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,MAA+B;AAC9C,QAAI;AACF,YAAM,KAAK,IAAI,GAAG,IAAI;AAAA,IACxB,SAAS,KAAK;AACZ,WAAK,OAAO,WAAW,GAAG;AAAA,IAC5B;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,KAAa,YAAsC;AACjE,QAAI;AACF,aAAO,MAAM,KAAK,MAAM,KAAK,UAAU;AAAA,IACzC,SAAS,KAAK;AACZ,WAAK,OAAO,iBAAiB,GAAG,IAAI,GAAG;AACvC,aAAO;AAAA,IACT;AAAA,EACF;AAAA,EAEA,MAAM,iBACJ,KACA,OACA,YACA,UACe;AACf,QAAI;AACF,YAAM,KAAK,aAAa,KAAK,OAAO,YAAY,QAAQ;AAAA,IAC1D,SAAS,KAAK;AACZ,WAAK,OAAO,wBAAwB,GAAG,IAAI,GAAG;AAAA,IAChD;AAAA,EACF;AAAA,EAEA,MAAM,sBAAsB,UAAiC;AAC3D,QAAI;AACF,YAAM,KAAK,kBAAkB,QAAQ;AAAA,IACvC,SAAS,KAAK;AACZ,WAAK,OAAO,6BAA6B,QAAQ,IAAI,GAAG;AAAA,IAC1D;AAAA,EACF;AAAA,EAEA,MAAM,kBACJ,KACA,SACA,YACe;AACf,QAAI;AACF,YAAM,KAAK,cAAc,KAAK,SAAS,UAAU;AAAA,IACnD,SAAS,KAAK;AACZ,WAAK,OAAO,yBAAyB,GAAG,IAAI,GAAG;AAAA,IACjD;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,KAAgC;AACjD,QAAI;AACF,aAAO,MAAM,KAAK,SAAS,GAAG;AAAA,IAChC,SAAS,KAAK;AACZ,WAAK,OAAO,oBAAoB,GAAG,IAAI,GAAG;AAC1C,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;;;AD9QA,kBAKO;","names":["Redis"]}

package/dist/index.d.cts

@@ -1,6 +1,32 @@
 import { CacheAdapter } from '@prismakit/core';
 export { CacheAdapter, CacheDebugStatus, cacheDebugStorage, isCacheDebugEnabled, recordCacheDebug } from '@prismakit/core';
 
+type DecimalFactory = (value: string) => unknown;
+type RedisJsonOptions = {
+    /**
+     * Reconstruct Prisma `Decimal` (or equivalent) from the tagged string.
+     * Default keeps the precision-preserving string so values are not silently
+     * coerced to numbers.
+     *
+     * @example
+     * decimalFactory: (s) => new Prisma.Decimal(s)
+     */
+    decimalFactory?: DecimalFactory;
+};
+/** JSON.stringify replacer — Prisma BigInt / Date / Bytes / Decimal. */
+declare function redisJsonReplacer(_key: string, value: unknown): unknown;
+/** JSON.parse reviver — restore tagged payloads from {@link redisJsonReplacer}. */
+declare function createRedisJsonReviver(options?: RedisJsonOptions): (_key: string, value: unknown) => unknown;
+/** @deprecated Prefer {@link createRedisJsonReviver} when a decimalFactory is needed. */
+declare function redisJsonReviver(_key: string, value: unknown): unknown;
+declare function redisJsonStringify(value: unknown): string;
+declare function redisJsonParse<T>(raw: string, options?: RedisJsonOptions): T;
+/**
+ * Deep clone via structuredClone, falling back to the tagged JSON codec so
+ * Date / BigInt / Buffer / Decimal survive (unlike plain JSON.stringify).
+ */
+declare function cloneWithCodec<T>(value: T, options?: RedisJsonOptions): T;
+
 type RedisCompression = 'none' | 'gzip';
 type RedisCacheAdapterOptions = {
     url?: string;
@@ -14,6 +40,13 @@ type RedisCacheAdapterOptions = {
     compression?: RedisCompression;
     /** Minimum payload size (bytes) before compression (default 1024). */
     compressionThresholdBytes?: number;
+    /**
+     * Reconstruct Prisma Decimal from tagged cache payloads.
+     * @example decimalFactory: (s) => new Prisma.Decimal(s)
+     */
+    decimalFactory?: DecimalFactory;
+    /** Optional error hook for safe* wrappers (also used by telemetry). */
+    onError?: (err: unknown, op?: string) => void;
 };
 /**
  * Redis-backed {@link CacheAdapter}. Framework-agnostic — no NestJS / ConfigService.
@@ -24,7 +57,10 @@ declare class RedisCacheAdapter implements CacheAdapter {
     private ready;
     private readonly compression;
     private readonly compressionThreshold;
+    private readonly jsonOptions;
+    onError?: (err: unknown, op?: string) => void;
     constructor(options?: RedisCacheAdapterOptions);
+    private report;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     isReady(): boolean;
@@ -37,14 +73,7 @@ declare class RedisCacheAdapter implements CacheAdapter {
     sadd(key: string, ...members: string[]): Promise<void>;
     smembers(key: string): Promise<string[]>;
     setNx(key: string, ttlSeconds: number): Promise<boolean>;
-    /**
-     * Atomically SET a cache key + SADD into an index SET + EXPIRE the index
-     * via a single Redis pipeline.
-     */
     setWithIndex(key: string, value: unknown, ttlSeconds: number, indexKey: string): Promise<void>;
-    /**
-     * Atomic invalidation via Lua (SMEMBERS + DEL members + DEL index).
-     */
     invalidateByIndex(indexKey: string): Promise<void>;
     saddAndExpire(key: string, members: string[], ttlSeconds: number): Promise<void>;
     safeGet<T>(key: string): Promise<T | null>;
@@ -57,11 +86,4 @@ declare class RedisCacheAdapter implements CacheAdapter {
     safeSmembers(key: string): Promise<string[]>;
 }
 
-/** JSON.stringify replacer — Prisma `BigInt` fields are not JSON-serializable by default. */
-declare function redisJsonReplacer(_key: string, value: unknown): unknown;
-/** JSON.parse reviver — restore tagged BigInt payloads from {@link redisJsonReplacer}. */
-declare function redisJsonReviver(_key: string, value: unknown): unknown;
-declare function redisJsonStringify(value: unknown): string;
-declare function redisJsonParse<T>(raw: string): T;
-
-export { RedisCacheAdapter, type RedisCacheAdapterOptions, type RedisCompression, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };
+export { type DecimalFactory, RedisCacheAdapter, type RedisCacheAdapterOptions, type RedisCompression, type RedisJsonOptions, cloneWithCodec, createRedisJsonReviver, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };

package/dist/index.d.ts

@@ -1,6 +1,32 @@
 import { CacheAdapter } from '@prismakit/core';
 export { CacheAdapter, CacheDebugStatus, cacheDebugStorage, isCacheDebugEnabled, recordCacheDebug } from '@prismakit/core';
 
+type DecimalFactory = (value: string) => unknown;
+type RedisJsonOptions = {
+    /**
+     * Reconstruct Prisma `Decimal` (or equivalent) from the tagged string.
+     * Default keeps the precision-preserving string so values are not silently
+     * coerced to numbers.
+     *
+     * @example
+     * decimalFactory: (s) => new Prisma.Decimal(s)
+     */
+    decimalFactory?: DecimalFactory;
+};
+/** JSON.stringify replacer — Prisma BigInt / Date / Bytes / Decimal. */
+declare function redisJsonReplacer(_key: string, value: unknown): unknown;
+/** JSON.parse reviver — restore tagged payloads from {@link redisJsonReplacer}. */
+declare function createRedisJsonReviver(options?: RedisJsonOptions): (_key: string, value: unknown) => unknown;
+/** @deprecated Prefer {@link createRedisJsonReviver} when a decimalFactory is needed. */
+declare function redisJsonReviver(_key: string, value: unknown): unknown;
+declare function redisJsonStringify(value: unknown): string;
+declare function redisJsonParse<T>(raw: string, options?: RedisJsonOptions): T;
+/**
+ * Deep clone via structuredClone, falling back to the tagged JSON codec so
+ * Date / BigInt / Buffer / Decimal survive (unlike plain JSON.stringify).
+ */
+declare function cloneWithCodec<T>(value: T, options?: RedisJsonOptions): T;
+
 type RedisCompression = 'none' | 'gzip';
 type RedisCacheAdapterOptions = {
     url?: string;
@@ -14,6 +40,13 @@ type RedisCacheAdapterOptions = {
     compression?: RedisCompression;
     /** Minimum payload size (bytes) before compression (default 1024). */
     compressionThresholdBytes?: number;
+    /**
+     * Reconstruct Prisma Decimal from tagged cache payloads.
+     * @example decimalFactory: (s) => new Prisma.Decimal(s)
+     */
+    decimalFactory?: DecimalFactory;
+    /** Optional error hook for safe* wrappers (also used by telemetry). */
+    onError?: (err: unknown, op?: string) => void;
 };
 /**
  * Redis-backed {@link CacheAdapter}. Framework-agnostic — no NestJS / ConfigService.
@@ -24,7 +57,10 @@ declare class RedisCacheAdapter implements CacheAdapter {
     private ready;
     private readonly compression;
     private readonly compressionThreshold;
+    private readonly jsonOptions;
+    onError?: (err: unknown, op?: string) => void;
     constructor(options?: RedisCacheAdapterOptions);
+    private report;
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     isReady(): boolean;
@@ -37,14 +73,7 @@ declare class RedisCacheAdapter implements CacheAdapter {
     sadd(key: string, ...members: string[]): Promise<void>;
     smembers(key: string): Promise<string[]>;
     setNx(key: string, ttlSeconds: number): Promise<boolean>;
-    /**
-     * Atomically SET a cache key + SADD into an index SET + EXPIRE the index
-     * via a single Redis pipeline.
-     */
     setWithIndex(key: string, value: unknown, ttlSeconds: number, indexKey: string): Promise<void>;
-    /**
-     * Atomic invalidation via Lua (SMEMBERS + DEL members + DEL index).
-     */
     invalidateByIndex(indexKey: string): Promise<void>;
     saddAndExpire(key: string, members: string[], ttlSeconds: number): Promise<void>;
     safeGet<T>(key: string): Promise<T | null>;
@@ -57,11 +86,4 @@ declare class RedisCacheAdapter implements CacheAdapter {
     safeSmembers(key: string): Promise<string[]>;
 }
 
-/** JSON.stringify replacer — Prisma `BigInt` fields are not JSON-serializable by default. */
-declare function redisJsonReplacer(_key: string, value: unknown): unknown;
-/** JSON.parse reviver — restore tagged BigInt payloads from {@link redisJsonReplacer}. */
-declare function redisJsonReviver(_key: string, value: unknown): unknown;
-declare function redisJsonStringify(value: unknown): string;
-declare function redisJsonParse<T>(raw: string): T;
-
-export { RedisCacheAdapter, type RedisCacheAdapterOptions, type RedisCompression, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };
+export { type DecimalFactory, RedisCacheAdapter, type RedisCacheAdapterOptions, type RedisCompression, type RedisJsonOptions, cloneWithCodec, createRedisJsonReviver, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };