@prismakit/redis 2.1.1 → 2.2.0

package/dist/index.cjs

@@ -43,6 +43,7 @@ module.exports = __toCommonJS(index_exports);
 
 // src/redis-cache-adapter.ts
 var import_ioredis = __toESM(require("ioredis"), 1);
+var import_zlib = require("zlib");
 
 // src/redis-json.ts
 var BIGINT_TAG = "__bigint";
@@ -70,18 +71,33 @@ function redisJsonParse(raw) {
 
 // src/redis-cache-adapter.ts
 var INDEX_TTL_BUFFER = 60;
+var INVALIDATE_BY_INDEX_LUA = `
+local members = redis.call('SMEMBERS', KEYS[1])
+for i, member in ipairs(members) do
+  redis.call('DEL', member)
+end
+redis.call('DEL', KEYS[1])
+return #members
+`;
+var COMPRESSED_PREFIX = "gz:";
 var RedisCacheAdapter = class {
   client;
   prefix;
   ready = false;
+  compression;
+  compressionThreshold;
   constructor(options = {}) {
     const {
       url,
       host = "localhost",
       port = 6379,
-      prefix = "prismakit"
+      prefix = "prismakit",
+      compression = "none",
+      compressionThresholdBytes = 1024
     } = options;
     this.prefix = prefix;
+    this.compression = compression;
+    this.compressionThreshold = compressionThresholdBytes;
     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;
@@ -118,14 +134,30 @@ var RedisCacheAdapter = class {
   getPrefix() {
     return this.prefix;
   }
+  encode(value) {
+    const json = redisJsonStringify(value);
+    if (this.compression === "gzip" && Buffer.byteLength(json, "utf8") >= this.compressionThreshold) {
+      const compressed = (0, import_zlib.gzipSync)(Buffer.from(json, "utf8")).toString("base64");
+      return COMPRESSED_PREFIX + compressed;
+    }
+    return json;
+  }
+  decode(raw) {
+    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(raw);
+  }
   // --- low-level ops (may throw) ---
   async get(key) {
     const raw = await this.client.get(key);
     if (raw === null) return null;
-    return redisJsonParse(raw);
+    return this.decode(raw);
   }
   async set(key, value, ttlSeconds) {
-    await this.client.set(key, redisJsonStringify(value), "EX", ttlSeconds);
+    await this.client.set(key, this.encode(value), "EX", ttlSeconds);
   }
   async del(...keys) {
     if (keys.length === 0) return;
@@ -143,22 +175,21 @@ var RedisCacheAdapter = class {
     return result === "OK";
   }
   /**
-   * Atomically SET a cache key + SADD into an index SET + EXPIRE the index.
+   * 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, redisJsonStringify(value), "EX", ttlSeconds);
+    pipeline.set(key, this.encode(value), "EX", ttlSeconds);
     pipeline.sadd(indexKey, key);
     pipeline.expire(indexKey, ttlSeconds + INDEX_TTL_BUFFER);
     await pipeline.exec();
   }
+  /**
+   * Atomic invalidation via Lua (SMEMBERS + DEL members + DEL index).
+   */
   async invalidateByIndex(indexKey) {
-    const keys = await this.smembers(indexKey);
-    if (keys.length > 0) {
-      await this.del(...keys, indexKey);
-    } else {
-      await this.del(indexKey);
-    }
+    await this.client.eval(INVALIDATE_BY_INDEX_LUA, 1, indexKey);
   }
   async saddAndExpire(key, members, ttlSeconds) {
     if (members.length === 0) return;

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} 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 type { CacheAdapter } from '@prismakit/core';\nimport { redisJsonParse, redisJsonStringify } from './redis-json';\n\nconst INDEX_TTL_BUFFER = 60;\n\nexport type RedisCacheAdapterOptions = {\n  url?: string;\n  host?: string;\n  port?: number;\n  prefix?: string;\n};\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\n  constructor(options: RedisCacheAdapterOptions = {}) {\n    const {\n      url,\n      host = 'localhost',\n      port = 6379,\n      prefix = 'prismakit',\n    } = options;\n\n    this.prefix = prefix;\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  // --- 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 redisJsonParse<T>(raw);\n  }\n\n  async set(key: string, value: unknown, ttlSeconds: number): Promise<void> {\n    await this.client.set(key, redisJsonStringify(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   */\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, redisJsonStringify(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    const keys = await this.smembers(indexKey);\n    if (keys.length > 0) {\n      await this.del(...keys, indexKey);\n    } else {\n      await this.del(indexKey);\n    }\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} 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"]}

package/dist/index.d.cts

@@ -1,11 +1,19 @@
 import { CacheAdapter } from '@prismakit/core';
 export { CacheAdapter, CacheDebugStatus, cacheDebugStorage, isCacheDebugEnabled, recordCacheDebug } from '@prismakit/core';
 
+type RedisCompression = 'none' | 'gzip';
 type RedisCacheAdapterOptions = {
     url?: string;
     host?: string;
     port?: number;
     prefix?: string;
+    /**
+     * Compress payloads larger than `compressionThresholdBytes` (default 1024).
+     * Uses gzip (widely available; zstd/lz4 can be added later).
+     */
+    compression?: RedisCompression;
+    /** Minimum payload size (bytes) before compression (default 1024). */
+    compressionThresholdBytes?: number;
 };
 /**
  * Redis-backed {@link CacheAdapter}. Framework-agnostic — no NestJS / ConfigService.
@@ -14,11 +22,15 @@ declare class RedisCacheAdapter implements CacheAdapter {
     private readonly client;
     private readonly prefix;
     private ready;
+    private readonly compression;
+    private readonly compressionThreshold;
     constructor(options?: RedisCacheAdapterOptions);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     isReady(): boolean;
     getPrefix(): string;
+    private encode;
+    private decode;
     get<T>(key: string): Promise<T | null>;
     set(key: string, value: unknown, ttlSeconds: number): Promise<void>;
     del(...keys: string[]): Promise<void>;
@@ -26,9 +38,13 @@ declare class RedisCacheAdapter implements CacheAdapter {
     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.
+     * 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>;
@@ -48,4 +64,4 @@ 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, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };
+export { RedisCacheAdapter, type RedisCacheAdapterOptions, type RedisCompression, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };

package/dist/index.d.ts

@@ -1,11 +1,19 @@
 import { CacheAdapter } from '@prismakit/core';
 export { CacheAdapter, CacheDebugStatus, cacheDebugStorage, isCacheDebugEnabled, recordCacheDebug } from '@prismakit/core';
 
+type RedisCompression = 'none' | 'gzip';
 type RedisCacheAdapterOptions = {
     url?: string;
     host?: string;
     port?: number;
     prefix?: string;
+    /**
+     * Compress payloads larger than `compressionThresholdBytes` (default 1024).
+     * Uses gzip (widely available; zstd/lz4 can be added later).
+     */
+    compression?: RedisCompression;
+    /** Minimum payload size (bytes) before compression (default 1024). */
+    compressionThresholdBytes?: number;
 };
 /**
  * Redis-backed {@link CacheAdapter}. Framework-agnostic — no NestJS / ConfigService.
@@ -14,11 +22,15 @@ declare class RedisCacheAdapter implements CacheAdapter {
     private readonly client;
     private readonly prefix;
     private ready;
+    private readonly compression;
+    private readonly compressionThreshold;
     constructor(options?: RedisCacheAdapterOptions);
     connect(): Promise<void>;
     disconnect(): Promise<void>;
     isReady(): boolean;
     getPrefix(): string;
+    private encode;
+    private decode;
     get<T>(key: string): Promise<T | null>;
     set(key: string, value: unknown, ttlSeconds: number): Promise<void>;
     del(...keys: string[]): Promise<void>;
@@ -26,9 +38,13 @@ declare class RedisCacheAdapter implements CacheAdapter {
     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.
+     * 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>;
@@ -48,4 +64,4 @@ 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, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };
+export { RedisCacheAdapter, type RedisCacheAdapterOptions, type RedisCompression, redisJsonParse, redisJsonReplacer, redisJsonReviver, redisJsonStringify };

package/dist/index.js

@@ -1,5 +1,6 @@
 // src/redis-cache-adapter.ts
 import Redis from "ioredis";
+import { gzipSync, gunzipSync } from "zlib";
 
 // src/redis-json.ts
 var BIGINT_TAG = "__bigint";
@@ -27,18 +28,33 @@ function redisJsonParse(raw) {
 
 // src/redis-cache-adapter.ts
 var INDEX_TTL_BUFFER = 60;
+var INVALIDATE_BY_INDEX_LUA = `
+local members = redis.call('SMEMBERS', KEYS[1])
+for i, member in ipairs(members) do
+  redis.call('DEL', member)
+end
+redis.call('DEL', KEYS[1])
+return #members
+`;
+var COMPRESSED_PREFIX = "gz:";
 var RedisCacheAdapter = class {
   client;
   prefix;
   ready = false;
+  compression;
+  compressionThreshold;
   constructor(options = {}) {
     const {
       url,
       host = "localhost",
       port = 6379,
-      prefix = "prismakit"
+      prefix = "prismakit",
+      compression = "none",
+      compressionThresholdBytes = 1024
     } = options;
     this.prefix = prefix;
+    this.compression = compression;
+    this.compressionThreshold = compressionThresholdBytes;
     this.client = url ? new Redis(url, { lazyConnect: true }) : new Redis({ host, port, lazyConnect: true });
     this.client.on("ready", () => {
       this.ready = true;
@@ -75,14 +91,30 @@ var RedisCacheAdapter = class {
   getPrefix() {
     return this.prefix;
   }
+  encode(value) {
+    const json = redisJsonStringify(value);
+    if (this.compression === "gzip" && Buffer.byteLength(json, "utf8") >= this.compressionThreshold) {
+      const compressed = gzipSync(Buffer.from(json, "utf8")).toString("base64");
+      return COMPRESSED_PREFIX + compressed;
+    }
+    return json;
+  }
+  decode(raw) {
+    if (raw.startsWith(COMPRESSED_PREFIX)) {
+      const buf = Buffer.from(raw.slice(COMPRESSED_PREFIX.length), "base64");
+      const json = gunzipSync(buf).toString("utf8");
+      return redisJsonParse(json);
+    }
+    return redisJsonParse(raw);
+  }
   // --- low-level ops (may throw) ---
   async get(key) {
     const raw = await this.client.get(key);
     if (raw === null) return null;
-    return redisJsonParse(raw);
+    return this.decode(raw);
   }
   async set(key, value, ttlSeconds) {
-    await this.client.set(key, redisJsonStringify(value), "EX", ttlSeconds);
+    await this.client.set(key, this.encode(value), "EX", ttlSeconds);
   }
   async del(...keys) {
     if (keys.length === 0) return;
@@ -100,22 +132,21 @@ var RedisCacheAdapter = class {
     return result === "OK";
   }
   /**
-   * Atomically SET a cache key + SADD into an index SET + EXPIRE the index.
+   * 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, redisJsonStringify(value), "EX", ttlSeconds);
+    pipeline.set(key, this.encode(value), "EX", ttlSeconds);
     pipeline.sadd(indexKey, key);
     pipeline.expire(indexKey, ttlSeconds + INDEX_TTL_BUFFER);
     await pipeline.exec();
   }
+  /**
+   * Atomic invalidation via Lua (SMEMBERS + DEL members + DEL index).
+   */
   async invalidateByIndex(indexKey) {
-    const keys = await this.smembers(indexKey);
-    if (keys.length > 0) {
-      await this.del(...keys, indexKey);
-    } else {
-      await this.del(indexKey);
-    }
+    await this.client.eval(INVALIDATE_BY_INDEX_LUA, 1, indexKey);
   }
   async saddAndExpire(key, members, ttlSeconds) {
     if (members.length === 0) return;

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/redis-cache-adapter.ts","../src/redis-json.ts","../src/index.ts"],"sourcesContent":["import Redis from 'ioredis';\nimport type { CacheAdapter } from '@prismakit/core';\nimport { redisJsonParse, redisJsonStringify } from './redis-json';\n\nconst INDEX_TTL_BUFFER = 60;\n\nexport type RedisCacheAdapterOptions = {\n  url?: string;\n  host?: string;\n  port?: number;\n  prefix?: string;\n};\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\n  constructor(options: RedisCacheAdapterOptions = {}) {\n    const {\n      url,\n      host = 'localhost',\n      port = 6379,\n      prefix = 'prismakit',\n    } = options;\n\n    this.prefix = prefix;\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  // --- 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 redisJsonParse<T>(raw);\n  }\n\n  async set(key: string, value: unknown, ttlSeconds: number): Promise<void> {\n    await this.client.set(key, redisJsonStringify(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   */\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, redisJsonStringify(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    const keys = await this.smembers(indexKey);\n    if (keys.length > 0) {\n      await this.del(...keys, indexKey);\n    } else {\n      await this.del(indexKey);\n    }\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","export {\n  RedisCacheAdapter,\n  type RedisCacheAdapterOptions,\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"],"mappings":";AAAA,OAAO,WAAW;;;ACAlB,IAAM,aAAa;AAGZ,SAAS,kBAAkB,MAAc,OAAyB;AACvE,MAAI,OAAO,UAAU,UAAU;AAC7B,WAAO,EAAE,CAAC,UAAU,GAAG,MAAM,SAAS,EAAE;AAAA,EAC1C;AACA,SAAO;AACT;AAGO,SAAS,iBAAiB,MAAc,OAAyB;AACtE,MACE,UAAU,QACV,OAAO,UAAU,YACjB,CAAC,MAAM,QAAQ,KAAK,KACpB,OAAO,KAAK,KAAK,EAAE,WAAW,KAC9B,cAAc,OACd;AACA,UAAM,MAAO,MAAkC,UAAU;AACzD,QAAI,OAAO,QAAQ,UAAU;AAC3B,aAAO,OAAO,GAAG;AAAA,IACnB;AAAA,EACF;AACA,SAAO;AACT;AAEO,SAAS,mBAAmB,OAAwB;AACzD,SAAO,KAAK,UAAU,OAAO,iBAAiB;AAChD;AAEO,SAAS,eAAkB,KAAgB;AAChD,SAAO,KAAK,MAAM,KAAK,gBAAgB;AACzC;;;AD7BA,IAAM,mBAAmB;AAYlB,IAAM,oBAAN,MAAgD;AAAA,EACpC;AAAA,EACA;AAAA,EACT,QAAQ;AAAA,EAEhB,YAAY,UAAoC,CAAC,GAAG;AAClD,UAAM;AAAA,MACJ;AAAA,MACA,OAAO;AAAA,MACP,OAAO;AAAA,MACP,SAAS;AAAA,IACX,IAAI;AAEJ,SAAK,SAAS;AACd,SAAK,SAAS,MACV,IAAI,MAAM,KAAK,EAAE,aAAa,KAAK,CAAC,IACpC,IAAI,MAAM,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,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,cAAQ;AAAA,QACN;AAAA,QACC,IAAc;AAAA,MACjB;AAAA,IACF;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;AAAA,EAIA,MAAM,IAAO,KAAgC;AAC3C,UAAM,MAAM,MAAM,KAAK,OAAO,IAAI,GAAG;AACrC,QAAI,QAAQ,KAAM,QAAO;AACzB,WAAO,eAAkB,GAAG;AAAA,EAC9B;AAAA,EAEA,MAAM,IAAI,KAAa,OAAgB,YAAmC;AACxE,UAAM,KAAK,OAAO,IAAI,KAAK,mBAAmB,KAAK,GAAG,MAAM,UAAU;AAAA,EACxE;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;AAAA;AAAA;AAAA,EAKA,MAAM,aACJ,KACA,OACA,YACA,UACe;AACf,UAAM,WAAW,KAAK,OAAO,SAAS;AACtC,aAAS,IAAI,KAAK,mBAAmB,KAAK,GAAG,MAAM,UAAU;AAC7D,aAAS,KAAK,UAAU,GAAG;AAC3B,aAAS,OAAO,UAAU,aAAa,gBAAgB;AACvD,UAAM,SAAS,KAAK;AAAA,EACtB;AAAA,EAEA,MAAM,kBAAkB,UAAiC;AACvD,UAAM,OAAO,MAAM,KAAK,SAAS,QAAQ;AACzC,QAAI,KAAK,SAAS,GAAG;AACnB,YAAM,KAAK,IAAI,GAAG,MAAM,QAAQ;AAAA,IAClC,OAAO;AACL,YAAM,KAAK,IAAI,QAAQ;AAAA,IACzB;AAAA,EACF;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;AAAA,EAIA,MAAM,QAAW,KAAgC;AAC/C,QAAI;AACF,aAAO,MAAM,KAAK,IAAO,GAAG;AAAA,IAC9B,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN,8CAA8C,GAAG;AAAA,QAChD,IAAc;AAAA,MACjB;AACA,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,cAAQ;AAAA,QACN,8CAA8C,GAAG;AAAA,QAChD,IAAc;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,WAAW,MAA+B;AAC9C,QAAI;AACF,YAAM,KAAK,IAAI,GAAG,IAAI;AAAA,IACxB,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN;AAAA,QACC,IAAc;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,UAAU,KAAa,YAAsC;AACjE,QAAI;AACF,aAAO,MAAM,KAAK,MAAM,KAAK,UAAU;AAAA,IACzC,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN,gDAAgD,GAAG;AAAA,QAClD,IAAc;AAAA,MACjB;AACA,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,cAAQ;AAAA,QACN,uDAAuD,GAAG;AAAA,QACzD,IAAc;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,sBAAsB,UAAiC;AAC3D,QAAI;AACF,YAAM,KAAK,kBAAkB,QAAQ;AAAA,IACvC,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN,4DAA4D,QAAQ;AAAA,QACnE,IAAc;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,kBACJ,KACA,SACA,YACe;AACf,QAAI;AACF,YAAM,KAAK,cAAc,KAAK,SAAS,UAAU;AAAA,IACnD,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN,wDAAwD,GAAG;AAAA,QAC1D,IAAc;AAAA,MACjB;AAAA,IACF;AAAA,EACF;AAAA,EAEA,MAAM,aAAa,KAAgC;AACjD,QAAI;AACF,aAAO,MAAM,KAAK,SAAS,GAAG;AAAA,IAChC,SAAS,KAAK;AACZ,cAAQ;AAAA,QACN,mDAAmD,GAAG;AAAA,QACrD,IAAc;AAAA,MACjB;AACA,aAAO,CAAC;AAAA,IACV;AAAA,EACF;AACF;;;AE3OA;AAAA,EAEE;AAAA,EACA;AAAA,EACA;AAAA,OACK;","names":[]}
+{"version":3,"sources":["../src/redis-cache-adapter.ts","../src/redis-json.ts","../src/index.ts"],"sourcesContent":["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","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"],"mappings":"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","names":[]}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@prismakit/redis",
-  "version": "2.1.1",
+  "version": "2.2.0",
   "description": "Redis CacheAdapter for @prismakit/core",
   "license": "Apache-2.0",
   "engines": {
@@ -19,11 +19,12 @@
   },
   "files": [
     "dist",
+    "src",
     "LICENSE",
     "README.md"
   ],
   "dependencies": {
-    "@prismakit/core": "2.1.1"
+    "@prismakit/core": "2.2.0"
   },
   "peerDependencies": {
     "@prismakit/core": ">=2.1.1",

package/src/__tests__/redis-cache-adapter.spec.ts

@@ -0,0 +1,74 @@
+import { describe, it, expect, vi, beforeEach } from 'vitest';
+
+const mockClient = {
+  status: 'wait',
+  on: vi.fn(),
+  connect: vi.fn().mockResolvedValue(undefined),
+  quit: vi.fn().mockResolvedValue(undefined),
+  get: vi.fn(),
+  set: vi.fn(),
+  del: vi.fn(),
+  sadd: vi.fn(),
+  smembers: vi.fn(),
+  pipeline: vi.fn(),
+};
+
+vi.mock('ioredis', () => ({
+  default: vi.fn().mockImplementation(() => mockClient),
+}));
+
+describe('RedisCacheAdapter', () => {
+  beforeEach(() => {
+    vi.clearAllMocks();
+    mockClient.status = 'wait';
+    mockClient.on.mockImplementation(() => mockClient);
+  });
+
+  it('connects with lazyConnect and exposes prefix', async () => {
+    const { RedisCacheAdapter } = await import('../redis-cache-adapter');
+    const adapter = new RedisCacheAdapter({
+      host: '127.0.0.1',
+      port: 6379,
+      prefix: 'test',
+    });
+
+    expect(adapter.getPrefix()).toBe('test');
+    expect(mockClient.connect).toHaveBeenCalled();
+    await adapter.disconnect();
+    expect(mockClient.quit).toHaveBeenCalled();
+  });
+
+  it('safeGet returns null on failure', async () => {
+    const { RedisCacheAdapter } = await import('../redis-cache-adapter');
+    mockClient.get.mockRejectedValue(new Error('down'));
+    const adapter = new RedisCacheAdapter({ prefix: 't' });
+    await expect(adapter.safeGet('k')).resolves.toBeNull();
+  });
+
+  it('round-trips BigInt via redisJson helpers', async () => {
+    const { redisJsonParse, redisJsonStringify } = await import('../redis-json');
+    const payload = { id: '1', qty: 9007199254740993n, nested: { n: 1n } };
+    const raw = redisJsonStringify(payload);
+    expect(raw).toContain('__bigint');
+    const parsed = redisJsonParse<typeof payload>(raw);
+    expect(parsed.qty).toBe(9007199254740993n);
+    expect(parsed.nested.n).toBe(1n);
+  });
+
+  it('set/get uses BigInt-safe JSON', async () => {
+    const { RedisCacheAdapter } = await import('../redis-cache-adapter');
+    let stored: string | undefined;
+    mockClient.set.mockImplementation((_k: string, v: string) => {
+      stored = v;
+      return Promise.resolve('OK');
+    });
+    mockClient.get.mockImplementation(() => Promise.resolve(stored ?? null));
+
+    const adapter = new RedisCacheAdapter({ prefix: 't' });
+    await adapter.set('k', { amount: 42n }, 60);
+    expect(stored).toContain('__bigint');
+    await expect(adapter.get<{ amount: bigint }>('k')).resolves.toEqual({
+      amount: 42n,
+    });
+  });
+});

package/src/index.ts

@@ -0,0 +1,22 @@
+export {
+  RedisCacheAdapter,
+  type RedisCacheAdapterOptions,
+  type RedisCompression,
+} from './redis-cache-adapter';
+
+export {
+  redisJsonParse,
+  redisJsonStringify,
+  redisJsonReplacer,
+  redisJsonReviver,
+} from './redis-json';
+
+/** Re-export cache debug helpers from core — do not duplicate. */
+export {
+  type CacheDebugStatus,
+  cacheDebugStorage,
+  isCacheDebugEnabled,
+  recordCacheDebug,
+} from '@prismakit/core';
+
+export type { CacheAdapter } from '@prismakit/core';

package/src/redis-cache-adapter.ts

@@ -0,0 +1,297 @@
+import Redis from 'ioredis';
+import { gzipSync, gunzipSync } from 'zlib';
+import type { CacheAdapter } from '@prismakit/core';
+import { redisJsonParse, redisJsonStringify } from './redis-json';
+
+const INDEX_TTL_BUFFER = 60;
+
+/** Lua: atomically SMEMBERS index + DEL members + index. */
+const INVALIDATE_BY_INDEX_LUA = `
+local members = redis.call('SMEMBERS', KEYS[1])
+for i, member in ipairs(members) do
+  redis.call('DEL', member)
+end
+redis.call('DEL', KEYS[1])
+return #members
+`;
+
+export type RedisCompression = 'none' | 'gzip';
+
+export type RedisCacheAdapterOptions = {
+  url?: string;
+  host?: string;
+  port?: number;
+  prefix?: string;
+  /**
+   * Compress payloads larger than `compressionThresholdBytes` (default 1024).
+   * Uses gzip (widely available; zstd/lz4 can be added later).
+   */
+  compression?: RedisCompression;
+  /** Minimum payload size (bytes) before compression (default 1024). */
+  compressionThresholdBytes?: number;
+};
+
+const COMPRESSED_PREFIX = 'gz:';
+
+/**
+ * Redis-backed {@link CacheAdapter}. Framework-agnostic — no NestJS / ConfigService.
+ */
+export class RedisCacheAdapter implements CacheAdapter {
+  private readonly client: Redis;
+  private readonly prefix: string;
+  private ready = false;
+  private readonly compression: RedisCompression;
+  private readonly compressionThreshold: number;
+
+  constructor(options: RedisCacheAdapterOptions = {}) {
+    const {
+      url,
+      host = 'localhost',
+      port = 6379,
+      prefix = 'prismakit',
+      compression = 'none',
+      compressionThresholdBytes = 1024,
+    } = options;
+
+    this.prefix = prefix;
+    this.compression = compression;
+    this.compressionThreshold = compressionThresholdBytes;
+    this.client = url
+      ? new Redis(url, { lazyConnect: true })
+      : new Redis({ host, port, lazyConnect: true });
+
+    this.client.on('ready', () => {
+      this.ready = true;
+    });
+    this.client.on('error', (err) => {
+      this.ready = false;
+      console.warn('[RedisCacheAdapter] connection error', err.message);
+    });
+    this.client.on('close', () => {
+      this.ready = false;
+    });
+
+    void this.connect();
+  }
+
+  async connect(): Promise<void> {
+    if (this.client.status === 'ready' || this.client.status === 'connecting') {
+      return;
+    }
+    try {
+      await this.client.connect();
+    } catch (err) {
+      console.warn(
+        '[RedisCacheAdapter] failed to connect',
+        (err as Error).message,
+      );
+    }
+  }
+
+  async disconnect(): Promise<void> {
+    await this.client?.quit();
+    this.ready = false;
+  }
+
+  isReady(): boolean {
+    return this.ready;
+  }
+
+  getPrefix(): string {
+    return this.prefix;
+  }
+
+  private encode(value: unknown): string {
+    const json = redisJsonStringify(value);
+    if (
+      this.compression === 'gzip' &&
+      Buffer.byteLength(json, 'utf8') >= this.compressionThreshold
+    ) {
+      const compressed = gzipSync(Buffer.from(json, 'utf8')).toString('base64');
+      return COMPRESSED_PREFIX + compressed;
+    }
+    return json;
+  }
+
+  private decode<T>(raw: string): T {
+    if (raw.startsWith(COMPRESSED_PREFIX)) {
+      const buf = Buffer.from(raw.slice(COMPRESSED_PREFIX.length), 'base64');
+      const json = gunzipSync(buf).toString('utf8');
+      return redisJsonParse<T>(json);
+    }
+    return redisJsonParse<T>(raw);
+  }
+
+  // --- low-level ops (may throw) ---
+
+  async get<T>(key: string): Promise<T | null> {
+    const raw = await this.client.get(key);
+    if (raw === null) return null;
+    return this.decode<T>(raw);
+  }
+
+  async set(key: string, value: unknown, ttlSeconds: number): Promise<void> {
+    await this.client.set(key, this.encode(value), 'EX', ttlSeconds);
+  }
+
+  async del(...keys: string[]): Promise<void> {
+    if (keys.length === 0) return;
+    await this.client.del(...keys);
+  }
+
+  async sadd(key: string, ...members: string[]): Promise<void> {
+    if (members.length === 0) return;
+    await this.client.sadd(key, ...members);
+  }
+
+  async smembers(key: string): Promise<string[]> {
+    return this.client.smembers(key);
+  }
+
+  async setNx(key: string, ttlSeconds: number): Promise<boolean> {
+    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: string,
+    value: unknown,
+    ttlSeconds: number,
+    indexKey: string,
+  ): Promise<void> {
+    const pipeline = this.client.pipeline();
+    pipeline.set(key, this.encode(value), 'EX', ttlSeconds);
+    pipeline.sadd(indexKey, key);
+    pipeline.expire(indexKey, ttlSeconds + INDEX_TTL_BUFFER);
+    await pipeline.exec();
+  }
+
+  /**
+   * Atomic invalidation via Lua (SMEMBERS + DEL members + DEL index).
+   */
+  async invalidateByIndex(indexKey: string): Promise<void> {
+    await this.client.eval(INVALIDATE_BY_INDEX_LUA, 1, indexKey);
+  }
+
+  async saddAndExpire(
+    key: string,
+    members: string[],
+    ttlSeconds: number,
+  ): Promise<void> {
+    if (members.length === 0) return;
+    const pipeline = this.client.pipeline();
+    pipeline.sadd(key, ...members);
+    pipeline.expire(key, ttlSeconds + INDEX_TTL_BUFFER);
+    await pipeline.exec();
+  }
+
+  // --- safe wrappers (never throw — warn + return fallback) ---
+
+  async safeGet<T>(key: string): Promise<T | null> {
+    try {
+      return await this.get<T>(key);
+    } catch (err) {
+      console.warn(
+        `[RedisCacheAdapter] safeGet failed for key=${key}`,
+        (err as Error).message,
+      );
+      return null;
+    }
+  }
+
+  async safeSet(
+    key: string,
+    value: unknown,
+    ttlSeconds: number,
+  ): Promise<void> {
+    try {
+      await this.set(key, value, ttlSeconds);
+    } catch (err) {
+      console.warn(
+        `[RedisCacheAdapter] safeSet failed for key=${key}`,
+        (err as Error).message,
+      );
+    }
+  }
+
+  async safeDel(...keys: string[]): Promise<void> {
+    try {
+      await this.del(...keys);
+    } catch (err) {
+      console.warn(
+        '[RedisCacheAdapter] safeDel failed',
+        (err as Error).message,
+      );
+    }
+  }
+
+  async safeSetNx(key: string, ttlSeconds: number): Promise<boolean> {
+    try {
+      return await this.setNx(key, ttlSeconds);
+    } catch (err) {
+      console.warn(
+        `[RedisCacheAdapter] safeSetNx failed for key=${key}`,
+        (err as Error).message,
+      );
+      return false;
+    }
+  }
+
+  async safeSetWithIndex(
+    key: string,
+    value: unknown,
+    ttlSeconds: number,
+    indexKey: string,
+  ): Promise<void> {
+    try {
+      await this.setWithIndex(key, value, ttlSeconds, indexKey);
+    } catch (err) {
+      console.warn(
+        `[RedisCacheAdapter] safeSetWithIndex failed for key=${key}`,
+        (err as Error).message,
+      );
+    }
+  }
+
+  async safeInvalidateByIndex(indexKey: string): Promise<void> {
+    try {
+      await this.invalidateByIndex(indexKey);
+    } catch (err) {
+      console.warn(
+        `[RedisCacheAdapter] safeInvalidateByIndex failed for idx=${indexKey}`,
+        (err as Error).message,
+      );
+    }
+  }
+
+  async safeSaddAndExpire(
+    key: string,
+    members: string[],
+    ttlSeconds: number,
+  ): Promise<void> {
+    try {
+      await this.saddAndExpire(key, members, ttlSeconds);
+    } catch (err) {
+      console.warn(
+        `[RedisCacheAdapter] safeSaddAndExpire failed for key=${key}`,
+        (err as Error).message,
+      );
+    }
+  }
+
+  async safeSmembers(key: string): Promise<string[]> {
+    try {
+      return await this.smembers(key);
+    } catch (err) {
+      console.warn(
+        `[RedisCacheAdapter] safeSmembers failed for key=${key}`,
+        (err as Error).message,
+      );
+      return [];
+    }
+  }
+}

package/src/redis-json.ts

@@ -0,0 +1,34 @@
+const BIGINT_TAG = '__bigint';
+
+/** JSON.stringify replacer — Prisma `BigInt` fields are not JSON-serializable by default. */
+export function redisJsonReplacer(_key: string, value: unknown): unknown {
+  if (typeof value === 'bigint') {
+    return { [BIGINT_TAG]: value.toString() };
+  }
+  return value;
+}
+
+/** JSON.parse reviver — restore tagged BigInt payloads from {@link redisJsonReplacer}. */
+export function redisJsonReviver(_key: string, value: unknown): unknown {
+  if (
+    value !== null &&
+    typeof value === 'object' &&
+    !Array.isArray(value) &&
+    Object.keys(value).length === 1 &&
+    BIGINT_TAG in value
+  ) {
+    const raw = (value as Record<string, unknown>)[BIGINT_TAG];
+    if (typeof raw === 'string') {
+      return BigInt(raw);
+    }
+  }
+  return value;
+}
+
+export function redisJsonStringify(value: unknown): string {
+  return JSON.stringify(value, redisJsonReplacer);
+}
+
+export function redisJsonParse<T>(raw: string): T {
+  return JSON.parse(raw, redisJsonReviver) as T;
+}