@leejpsd/nextjs-cache-handler 0.3.3 → 0.4.0

package/dist/shared/client/adapter-ioredis.cjs

@@ -34,7 +34,12 @@ function adapt(client, isClusterClient = false) {
       }
     },
     get: (k) => client.get(k),
-    set: (k, v, opts) => opts?.EX !== void 0 ? client.set(k, v, "EX", opts.EX) : client.set(k, v),
+    set: (k, v, opts) => {
+      const args = [];
+      if (opts?.EX !== void 0) args.push("EX", opts.EX);
+      if (opts?.NX) args.push("NX");
+      return client.set(k, v, ...args);
+    },
     del: async (keys) => {
       const arr = Array.isArray(keys) ? keys : [keys];
       if (arr.length === 0) return 0;
@@ -105,6 +110,40 @@ function adapt(client, isClusterClient = false) {
       client.on(event, listener);
       return client;
     },
+    publish: (channel, message) => client.publish(channel, message),
+    ...isClusterClient ? {} : {
+      subscribe: async (channel, onMessage, onDown) => {
+        const sub = client.duplicate();
+        let down = false;
+        const markDown = () => {
+          if (down) return;
+          down = true;
+          try {
+            sub.disconnect();
+          } catch {
+          }
+          onDown?.();
+        };
+        sub.on("error", markDown);
+        sub.on("end", markDown);
+        try {
+          if (sub.status !== "ready" && sub.status !== "connecting") {
+            await sub.connect();
+          }
+          await sub.subscribe(channel);
+        } catch (err) {
+          markDown();
+          throw err;
+        }
+        sub.on("message", (ch, message) => {
+          if (ch === channel) onMessage(message);
+        });
+        return async () => {
+          down = true;
+          sub.disconnect();
+        };
+      }
+    },
     dispose: () => {
       client.disconnect();
     }

package/dist/shared/client/adapter-ioredis.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../node_modules/tsup/assets/cjs_shims.js","../../../src/shared/node-require.ts","../../../src/shared/client/adapter-ioredis.ts"],"names":["createRequire","path"],"mappings":"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","file":"adapter-ioredis.cjs","sourcesContent":["// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `ioredis` (and `ioredis.Cluster`).\n *\n * ioredis uses snake_case method names (`sadd`, `smembers`, `mget`) and a\n * stream-based scan. We normalize both into the camelCase / async-iterable\n * `RedisClientLike` contract so the handlers don't need to know which client\n * is underneath.\n */\n\nimport type { Cluster, Redis } from \"ioredis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\ntype AnyRedis = Redis | Cluster;\n\nfunction adapt(client: AnyRedis, isClusterClient = false): RedisClientLike {\n  return {\n    get isOpen() {\n      // ioredis exposes a `status` string. Both single-node and cluster\n      // report \"ready\" once connected.\n      return client.status === \"ready\";\n    },\n    connect: async () => {\n      if (client.status !== \"ready\" && client.status !== \"connecting\") {\n        await client.connect();\n      }\n    },\n    get: (k) => client.get(k),\n    set: (k, v, opts) =>\n      opts?.EX !== undefined\n        ? client.set(k, v, \"EX\", opts.EX)\n        : client.set(k, v),\n    del: async (keys) => {\n      const arr = Array.isArray(keys) ? keys : [keys];\n      if (arr.length === 0) return 0;\n      return client.del(...arr);\n    },\n    sAdd: async (k, m) => {\n      const arr = Array.isArray(m) ? m : [m];\n      if (arr.length === 0) return 0;\n      return client.sadd(k, ...arr);\n    },\n    sMembers: (k) => client.smembers(k),\n    expire: async (k, s) => {\n      const r = await client.expire(k, s);\n      return r;\n    },\n    mGet: async (keys) => {\n      if (keys.length === 0) return [];\n      return client.mget(...keys);\n    },\n    eval: (script, opts) =>\n      client.eval(\n        script,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    evalSha: (sha, opts) =>\n      client.evalsha(\n        sha,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    scriptLoad: async (script) =>\n      (await client.script(\"LOAD\", script)) as string,\n    scanIterator: async function* ({ MATCH, COUNT }) {\n      // Cluster does not support a single SCAN cursor across slots; use\n      // ioredis's per-node iterator there. Single-node: standard SCAN cursor.\n      if (isClusterClient) {\n        const cluster = client as Cluster;\n        for (const node of cluster.nodes(\"master\")) {\n          let cursor = \"0\";\n          do {\n            const [next, batch]: [string, string[]] = await node.scan(\n              cursor,\n              \"MATCH\",\n              MATCH,\n              \"COUNT\",\n              COUNT ?? 100\n            );\n            cursor = next;\n            if (batch.length > 0) yield batch;\n          } while (cursor !== \"0\");\n        }\n      } else {\n        const redis = client as Redis;\n        let cursor = \"0\";\n        do {\n          const [next, batch]: [string, string[]] = await redis.scan(\n            cursor,\n            \"MATCH\",\n            MATCH,\n            \"COUNT\",\n            COUNT ?? 100\n          );\n          cursor = next;\n          if (batch.length > 0) yield batch;\n        } while (cursor !== \"0\");\n      }\n    },\n    ping: () => client.ping(),\n    on: (event, listener) => {\n      client.on(event, listener);\n      return client;\n    },\n    dispose: () => {\n      client.disconnect();\n    },\n  };\n}\n\nexport function adaptIoredis(client: Redis): RedisClientLike {\n  return adapt(client, false);\n}\n\nexport function adaptCluster(cluster: Cluster): RedisClientLike {\n  return adapt(cluster, true);\n}\n\nexport function createIoredisClient(\n  config: Extract<RedisClientConfig, { type: \"ioredis\" }>\n): Redis {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  // ioredis exports the class as both `default` and a named property.\n  // Hitting the default works for both ESM and CJS consumers.\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor(config.url, {\n    password: config.password,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    // Batch same-tick commands into one RTT (matches redis@5's default\n    // behavior) — makes Promise.all fan-outs a single pipeline.\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisSentinel(\n  config: Extract<RedisClientConfig, { type: \"sentinel\" }>\n): Redis {\n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor({\n    sentinels: config.sentinels,\n    name: config.name,\n    password: config.password,\n    sentinelPassword: config.sentinelPassword,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisCluster(\n  config: Extract<RedisClientConfig, { type: \"cluster\" }>\n): Cluster {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const ClusterCtor =\n    IORedis.Cluster ??\n    (IORedis.default as unknown as { Cluster: typeof import(\"ioredis\").Cluster })\n      .Cluster;\n  return new ClusterCtor(config.nodes, {\n    redisOptions: {\n      password: config.password,\n      tls: config.tls ? {} : undefined,\n    },\n    enableReadyCheck: true,\n    lazyConnect: true,\n    // Same-slot commands issued in the same tick share one pipeline.\n    enableAutoPipelining: true,\n  });\n}\n"]}
+{"version":3,"sources":["../../../node_modules/tsup/assets/cjs_shims.js","../../../src/shared/node-require.ts","../../../src/shared/client/adapter-ioredis.ts"],"names":["createRequire","path"],"mappings":"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","file":"adapter-ioredis.cjs","sourcesContent":["// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `ioredis` (and `ioredis.Cluster`).\n *\n * ioredis uses snake_case method names (`sadd`, `smembers`, `mget`) and a\n * stream-based scan. We normalize both into the camelCase / async-iterable\n * `RedisClientLike` contract so the handlers don't need to know which client\n * is underneath.\n */\n\nimport type { Cluster, Redis } from \"ioredis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\ntype AnyRedis = Redis | Cluster;\n\nfunction adapt(client: AnyRedis, isClusterClient = false): RedisClientLike {\n  return {\n    get isOpen() {\n      // ioredis exposes a `status` string. Both single-node and cluster\n      // report \"ready\" once connected.\n      return client.status === \"ready\";\n    },\n    connect: async () => {\n      if (client.status !== \"ready\" && client.status !== \"connecting\") {\n        await client.connect();\n      }\n    },\n    get: (k) => client.get(k),\n    set: (k, v, opts) => {\n      const args: (string | number)[] = [];\n      if (opts?.EX !== undefined) args.push(\"EX\", opts.EX);\n      if (opts?.NX) args.push(\"NX\");\n      return (client.set as (...a: unknown[]) => Promise<unknown>)(k, v, ...args);\n    },\n    del: async (keys) => {\n      const arr = Array.isArray(keys) ? keys : [keys];\n      if (arr.length === 0) return 0;\n      return client.del(...arr);\n    },\n    sAdd: async (k, m) => {\n      const arr = Array.isArray(m) ? m : [m];\n      if (arr.length === 0) return 0;\n      return client.sadd(k, ...arr);\n    },\n    sMembers: (k) => client.smembers(k),\n    expire: async (k, s) => {\n      const r = await client.expire(k, s);\n      return r;\n    },\n    mGet: async (keys) => {\n      if (keys.length === 0) return [];\n      return client.mget(...keys);\n    },\n    eval: (script, opts) =>\n      client.eval(\n        script,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    evalSha: (sha, opts) =>\n      client.evalsha(\n        sha,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    scriptLoad: async (script) =>\n      (await client.script(\"LOAD\", script)) as string,\n    scanIterator: async function* ({ MATCH, COUNT }) {\n      // Cluster does not support a single SCAN cursor across slots; use\n      // ioredis's per-node iterator there. Single-node: standard SCAN cursor.\n      if (isClusterClient) {\n        const cluster = client as Cluster;\n        for (const node of cluster.nodes(\"master\")) {\n          let cursor = \"0\";\n          do {\n            const [next, batch]: [string, string[]] = await node.scan(\n              cursor,\n              \"MATCH\",\n              MATCH,\n              \"COUNT\",\n              COUNT ?? 100\n            );\n            cursor = next;\n            if (batch.length > 0) yield batch;\n          } while (cursor !== \"0\");\n        }\n      } else {\n        const redis = client as Redis;\n        let cursor = \"0\";\n        do {\n          const [next, batch]: [string, string[]] = await redis.scan(\n            cursor,\n            \"MATCH\",\n            MATCH,\n            \"COUNT\",\n            COUNT ?? 100\n          );\n          cursor = next;\n          if (batch.length > 0) yield batch;\n        } while (cursor !== \"0\");\n      }\n    },\n    ping: () => client.ping(),\n    on: (event, listener) => {\n      client.on(event, listener);\n      return client;\n    },\n    publish: (channel, message) => client.publish(channel, message),\n    ...(isClusterClient\n      ? {}\n      : {\n          subscribe: async (\n            channel: string,\n            onMessage: (message: string) => void,\n            onDown?: () => void\n          ) => {\n            const sub = (client as Redis).duplicate();\n            let down = false;\n            const markDown = () => {\n              if (down) return;\n              down = true;\n              try {\n                sub.disconnect();\n              } catch {\n                /* already closed */\n              }\n              onDown?.();\n            };\n            sub.on(\"error\", markDown);\n            sub.on(\"end\", markDown);\n            try {\n              if (sub.status !== \"ready\" && sub.status !== \"connecting\") {\n                await sub.connect();\n              }\n              await sub.subscribe(channel);\n            } catch (err) {\n              markDown();\n              throw err;\n            }\n            sub.on(\"message\", (ch: string, message: string) => {\n              if (ch === channel) onMessage(message);\n            });\n            return async () => {\n              down = true;\n              sub.disconnect();\n            };\n          },\n        }),\n    dispose: () => {\n      client.disconnect();\n    },\n  };\n}\n\nexport function adaptIoredis(client: Redis): RedisClientLike {\n  return adapt(client, false);\n}\n\nexport function adaptCluster(cluster: Cluster): RedisClientLike {\n  return adapt(cluster, true);\n}\n\nexport function createIoredisClient(\n  config: Extract<RedisClientConfig, { type: \"ioredis\" }>\n): Redis {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  // ioredis exports the class as both `default` and a named property.\n  // Hitting the default works for both ESM and CJS consumers.\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor(config.url, {\n    password: config.password,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    // Batch same-tick commands into one RTT (matches redis@5's default\n    // behavior) — makes Promise.all fan-outs a single pipeline.\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisSentinel(\n  config: Extract<RedisClientConfig, { type: \"sentinel\" }>\n): Redis {\n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor({\n    sentinels: config.sentinels,\n    name: config.name,\n    password: config.password,\n    sentinelPassword: config.sentinelPassword,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisCluster(\n  config: Extract<RedisClientConfig, { type: \"cluster\" }>\n): Cluster {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const ClusterCtor =\n    IORedis.Cluster ??\n    (IORedis.default as unknown as { Cluster: typeof import(\"ioredis\").Cluster })\n      .Cluster;\n  return new ClusterCtor(config.nodes, {\n    redisOptions: {\n      password: config.password,\n      tls: config.tls ? {} : undefined,\n    },\n    enableReadyCheck: true,\n    lazyConnect: true,\n    // Same-slot commands issued in the same tick share one pipeline.\n    enableAutoPipelining: true,\n  });\n}\n"]}

package/dist/shared/client/adapter-ioredis.d.cts

@@ -1,5 +1,5 @@
 import { Cluster, Redis } from 'ioredis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-Bl-rkLKX.cjs';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.cjs';
 
 /**
  * Adapter for `ioredis` (and `ioredis.Cluster`).

package/dist/shared/client/adapter-ioredis.d.ts

@@ -1,5 +1,5 @@
 import { Cluster, Redis } from 'ioredis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-Bl-rkLKX.js';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.js';
 
 /**
  * Adapter for `ioredis` (and `ioredis.Cluster`).

package/dist/shared/client/adapter-ioredis.js

@@ -26,7 +26,12 @@ function adapt(client, isClusterClient = false) {
       }
     },
     get: (k) => client.get(k),
-    set: (k, v, opts) => opts?.EX !== void 0 ? client.set(k, v, "EX", opts.EX) : client.set(k, v),
+    set: (k, v, opts) => {
+      const args = [];
+      if (opts?.EX !== void 0) args.push("EX", opts.EX);
+      if (opts?.NX) args.push("NX");
+      return client.set(k, v, ...args);
+    },
     del: async (keys) => {
       const arr = Array.isArray(keys) ? keys : [keys];
       if (arr.length === 0) return 0;
@@ -97,6 +102,40 @@ function adapt(client, isClusterClient = false) {
       client.on(event, listener);
       return client;
     },
+    publish: (channel, message) => client.publish(channel, message),
+    ...isClusterClient ? {} : {
+      subscribe: async (channel, onMessage, onDown) => {
+        const sub = client.duplicate();
+        let down = false;
+        const markDown = () => {
+          if (down) return;
+          down = true;
+          try {
+            sub.disconnect();
+          } catch {
+          }
+          onDown?.();
+        };
+        sub.on("error", markDown);
+        sub.on("end", markDown);
+        try {
+          if (sub.status !== "ready" && sub.status !== "connecting") {
+            await sub.connect();
+          }
+          await sub.subscribe(channel);
+        } catch (err) {
+          markDown();
+          throw err;
+        }
+        sub.on("message", (ch, message) => {
+          if (ch === channel) onMessage(message);
+        });
+        return async () => {
+          down = true;
+          sub.disconnect();
+        };
+      }
+    },
     dispose: () => {
       client.disconnect();
     }

package/dist/shared/client/adapter-ioredis.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/shared/node-require.ts","../../../src/shared/client/adapter-ioredis.ts"],"names":[],"mappings":"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","file":"adapter-ioredis.js","sourcesContent":["/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `ioredis` (and `ioredis.Cluster`).\n *\n * ioredis uses snake_case method names (`sadd`, `smembers`, `mget`) and a\n * stream-based scan. We normalize both into the camelCase / async-iterable\n * `RedisClientLike` contract so the handlers don't need to know which client\n * is underneath.\n */\n\nimport type { Cluster, Redis } from \"ioredis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\ntype AnyRedis = Redis | Cluster;\n\nfunction adapt(client: AnyRedis, isClusterClient = false): RedisClientLike {\n  return {\n    get isOpen() {\n      // ioredis exposes a `status` string. Both single-node and cluster\n      // report \"ready\" once connected.\n      return client.status === \"ready\";\n    },\n    connect: async () => {\n      if (client.status !== \"ready\" && client.status !== \"connecting\") {\n        await client.connect();\n      }\n    },\n    get: (k) => client.get(k),\n    set: (k, v, opts) =>\n      opts?.EX !== undefined\n        ? client.set(k, v, \"EX\", opts.EX)\n        : client.set(k, v),\n    del: async (keys) => {\n      const arr = Array.isArray(keys) ? keys : [keys];\n      if (arr.length === 0) return 0;\n      return client.del(...arr);\n    },\n    sAdd: async (k, m) => {\n      const arr = Array.isArray(m) ? m : [m];\n      if (arr.length === 0) return 0;\n      return client.sadd(k, ...arr);\n    },\n    sMembers: (k) => client.smembers(k),\n    expire: async (k, s) => {\n      const r = await client.expire(k, s);\n      return r;\n    },\n    mGet: async (keys) => {\n      if (keys.length === 0) return [];\n      return client.mget(...keys);\n    },\n    eval: (script, opts) =>\n      client.eval(\n        script,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    evalSha: (sha, opts) =>\n      client.evalsha(\n        sha,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    scriptLoad: async (script) =>\n      (await client.script(\"LOAD\", script)) as string,\n    scanIterator: async function* ({ MATCH, COUNT }) {\n      // Cluster does not support a single SCAN cursor across slots; use\n      // ioredis's per-node iterator there. Single-node: standard SCAN cursor.\n      if (isClusterClient) {\n        const cluster = client as Cluster;\n        for (const node of cluster.nodes(\"master\")) {\n          let cursor = \"0\";\n          do {\n            const [next, batch]: [string, string[]] = await node.scan(\n              cursor,\n              \"MATCH\",\n              MATCH,\n              \"COUNT\",\n              COUNT ?? 100\n            );\n            cursor = next;\n            if (batch.length > 0) yield batch;\n          } while (cursor !== \"0\");\n        }\n      } else {\n        const redis = client as Redis;\n        let cursor = \"0\";\n        do {\n          const [next, batch]: [string, string[]] = await redis.scan(\n            cursor,\n            \"MATCH\",\n            MATCH,\n            \"COUNT\",\n            COUNT ?? 100\n          );\n          cursor = next;\n          if (batch.length > 0) yield batch;\n        } while (cursor !== \"0\");\n      }\n    },\n    ping: () => client.ping(),\n    on: (event, listener) => {\n      client.on(event, listener);\n      return client;\n    },\n    dispose: () => {\n      client.disconnect();\n    },\n  };\n}\n\nexport function adaptIoredis(client: Redis): RedisClientLike {\n  return adapt(client, false);\n}\n\nexport function adaptCluster(cluster: Cluster): RedisClientLike {\n  return adapt(cluster, true);\n}\n\nexport function createIoredisClient(\n  config: Extract<RedisClientConfig, { type: \"ioredis\" }>\n): Redis {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  // ioredis exports the class as both `default` and a named property.\n  // Hitting the default works for both ESM and CJS consumers.\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor(config.url, {\n    password: config.password,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    // Batch same-tick commands into one RTT (matches redis@5's default\n    // behavior) — makes Promise.all fan-outs a single pipeline.\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisSentinel(\n  config: Extract<RedisClientConfig, { type: \"sentinel\" }>\n): Redis {\n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor({\n    sentinels: config.sentinels,\n    name: config.name,\n    password: config.password,\n    sentinelPassword: config.sentinelPassword,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisCluster(\n  config: Extract<RedisClientConfig, { type: \"cluster\" }>\n): Cluster {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const ClusterCtor =\n    IORedis.Cluster ??\n    (IORedis.default as unknown as { Cluster: typeof import(\"ioredis\").Cluster })\n      .Cluster;\n  return new ClusterCtor(config.nodes, {\n    redisOptions: {\n      password: config.password,\n      tls: config.tls ? {} : undefined,\n    },\n    enableReadyCheck: true,\n    lazyConnect: true,\n    // Same-slot commands issued in the same tick share one pipeline.\n    enableAutoPipelining: true,\n  });\n}\n"]}
+{"version":3,"sources":["../../../src/shared/node-require.ts","../../../src/shared/client/adapter-ioredis.ts"],"names":[],"mappings":"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","file":"adapter-ioredis.js","sourcesContent":["/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `ioredis` (and `ioredis.Cluster`).\n *\n * ioredis uses snake_case method names (`sadd`, `smembers`, `mget`) and a\n * stream-based scan. We normalize both into the camelCase / async-iterable\n * `RedisClientLike` contract so the handlers don't need to know which client\n * is underneath.\n */\n\nimport type { Cluster, Redis } from \"ioredis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\ntype AnyRedis = Redis | Cluster;\n\nfunction adapt(client: AnyRedis, isClusterClient = false): RedisClientLike {\n  return {\n    get isOpen() {\n      // ioredis exposes a `status` string. Both single-node and cluster\n      // report \"ready\" once connected.\n      return client.status === \"ready\";\n    },\n    connect: async () => {\n      if (client.status !== \"ready\" && client.status !== \"connecting\") {\n        await client.connect();\n      }\n    },\n    get: (k) => client.get(k),\n    set: (k, v, opts) => {\n      const args: (string | number)[] = [];\n      if (opts?.EX !== undefined) args.push(\"EX\", opts.EX);\n      if (opts?.NX) args.push(\"NX\");\n      return (client.set as (...a: unknown[]) => Promise<unknown>)(k, v, ...args);\n    },\n    del: async (keys) => {\n      const arr = Array.isArray(keys) ? keys : [keys];\n      if (arr.length === 0) return 0;\n      return client.del(...arr);\n    },\n    sAdd: async (k, m) => {\n      const arr = Array.isArray(m) ? m : [m];\n      if (arr.length === 0) return 0;\n      return client.sadd(k, ...arr);\n    },\n    sMembers: (k) => client.smembers(k),\n    expire: async (k, s) => {\n      const r = await client.expire(k, s);\n      return r;\n    },\n    mGet: async (keys) => {\n      if (keys.length === 0) return [];\n      return client.mget(...keys);\n    },\n    eval: (script, opts) =>\n      client.eval(\n        script,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    evalSha: (sha, opts) =>\n      client.evalsha(\n        sha,\n        opts.keys.length,\n        ...opts.keys,\n        ...opts.arguments\n      ) as Promise<unknown>,\n    scriptLoad: async (script) =>\n      (await client.script(\"LOAD\", script)) as string,\n    scanIterator: async function* ({ MATCH, COUNT }) {\n      // Cluster does not support a single SCAN cursor across slots; use\n      // ioredis's per-node iterator there. Single-node: standard SCAN cursor.\n      if (isClusterClient) {\n        const cluster = client as Cluster;\n        for (const node of cluster.nodes(\"master\")) {\n          let cursor = \"0\";\n          do {\n            const [next, batch]: [string, string[]] = await node.scan(\n              cursor,\n              \"MATCH\",\n              MATCH,\n              \"COUNT\",\n              COUNT ?? 100\n            );\n            cursor = next;\n            if (batch.length > 0) yield batch;\n          } while (cursor !== \"0\");\n        }\n      } else {\n        const redis = client as Redis;\n        let cursor = \"0\";\n        do {\n          const [next, batch]: [string, string[]] = await redis.scan(\n            cursor,\n            \"MATCH\",\n            MATCH,\n            \"COUNT\",\n            COUNT ?? 100\n          );\n          cursor = next;\n          if (batch.length > 0) yield batch;\n        } while (cursor !== \"0\");\n      }\n    },\n    ping: () => client.ping(),\n    on: (event, listener) => {\n      client.on(event, listener);\n      return client;\n    },\n    publish: (channel, message) => client.publish(channel, message),\n    ...(isClusterClient\n      ? {}\n      : {\n          subscribe: async (\n            channel: string,\n            onMessage: (message: string) => void,\n            onDown?: () => void\n          ) => {\n            const sub = (client as Redis).duplicate();\n            let down = false;\n            const markDown = () => {\n              if (down) return;\n              down = true;\n              try {\n                sub.disconnect();\n              } catch {\n                /* already closed */\n              }\n              onDown?.();\n            };\n            sub.on(\"error\", markDown);\n            sub.on(\"end\", markDown);\n            try {\n              if (sub.status !== \"ready\" && sub.status !== \"connecting\") {\n                await sub.connect();\n              }\n              await sub.subscribe(channel);\n            } catch (err) {\n              markDown();\n              throw err;\n            }\n            sub.on(\"message\", (ch: string, message: string) => {\n              if (ch === channel) onMessage(message);\n            });\n            return async () => {\n              down = true;\n              sub.disconnect();\n            };\n          },\n        }),\n    dispose: () => {\n      client.disconnect();\n    },\n  };\n}\n\nexport function adaptIoredis(client: Redis): RedisClientLike {\n  return adapt(client, false);\n}\n\nexport function adaptCluster(cluster: Cluster): RedisClientLike {\n  return adapt(cluster, true);\n}\n\nexport function createIoredisClient(\n  config: Extract<RedisClientConfig, { type: \"ioredis\" }>\n): Redis {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  // ioredis exports the class as both `default` and a named property.\n  // Hitting the default works for both ESM and CJS consumers.\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor(config.url, {\n    password: config.password,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    // Batch same-tick commands into one RTT (matches redis@5's default\n    // behavior) — makes Promise.all fan-outs a single pipeline.\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisSentinel(\n  config: Extract<RedisClientConfig, { type: \"sentinel\" }>\n): Redis {\n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const Ctor = IORedis.default ?? (IORedis as unknown as typeof import(\"ioredis\").default);\n  return new Ctor({\n    sentinels: config.sentinels,\n    name: config.name,\n    password: config.password,\n    sentinelPassword: config.sentinelPassword,\n    connectTimeout: config.connectTimeout ?? 1500,\n    tls: config.tls ? {} : undefined,\n    lazyConnect: true,\n    maxRetriesPerRequest: 1,\n    enableAutoPipelining: true,\n  });\n}\n\nexport function createIoredisCluster(\n  config: Extract<RedisClientConfig, { type: \"cluster\" }>\n): Cluster {\n   \n  const IORedis = nodeRequire(\"ioredis\") as typeof import(\"ioredis\");\n  const ClusterCtor =\n    IORedis.Cluster ??\n    (IORedis.default as unknown as { Cluster: typeof import(\"ioredis\").Cluster })\n      .Cluster;\n  return new ClusterCtor(config.nodes, {\n    redisOptions: {\n      password: config.password,\n      tls: config.tls ? {} : undefined,\n    },\n    enableReadyCheck: true,\n    lazyConnect: true,\n    // Same-slot commands issued in the same tick share one pipeline.\n    enableAutoPipelining: true,\n  });\n}\n"]}

package/dist/shared/client/adapter-redis.cjs

@@ -24,7 +24,40 @@ function nodeRequire(id) {
 
 // src/shared/client/adapter-redis.ts
 function adaptRedisV5(client) {
-  return client;
+  const like = client;
+  like.dispose = () => {
+    try {
+      client.destroy();
+    } catch {
+    }
+  };
+  like.subscribe = async (channel, onMessage, onDown) => {
+    const sub = client.duplicate();
+    const teardown = () => {
+      try {
+        sub.destroy();
+      } catch {
+      }
+    };
+    let down = false;
+    const markDown = () => {
+      if (down) return;
+      down = true;
+      teardown();
+      onDown?.();
+    };
+    sub.on("error", markDown);
+    sub.on("end", markDown);
+    try {
+      await sub.connect();
+      await sub.subscribe(channel, (message) => onMessage(message));
+    } catch (err) {
+      teardown();
+      throw err;
+    }
+    return async () => teardown();
+  };
+  return like;
 }
 function createRedisV5Client(config) {
   const { createClient } = nodeRequire("redis");

package/dist/shared/client/adapter-redis.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../node_modules/tsup/assets/cjs_shims.js","../../../src/shared/node-require.ts","../../../src/shared/client/adapter-redis.ts"],"names":["createRequire","path"],"mappings":";;;;;;;;;;AAKA,IAAM,gBAAA,GAAmB,MACvB,OAAO,QAAA,KAAa,WAAA,GAChB,IAAI,GAAA,CAAI,CAAA,KAAA,EAAQ,UAAU,CAAA,CAAE,CAAA,CAAE,IAAA,GAC7B,QAAA,CAAS,aAAA,IAAiB,QAAA,CAAS,aAAA,CAAc,OAAA,CAAQ,WAAA,EAAY,KAAM,QAAA,GAC1E,QAAA,CAAS,aAAA,CAAc,GAAA,GACvB,IAAI,GAAA,CAAI,SAAA,EAAW,QAAA,CAAS,OAAO,CAAA,CAAE,IAAA;AAEtC,IAAM,gCAAgC,gBAAA,EAAiB;ACC9D,IAAM,cAAA,GAAiBA,uBAAc,aAAe,CAAA;AACpD,IAAM,UAAA,GAAaA,sBAAA;AAAA,EACjBC,qBAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,GAAA,IAAO,uBAAuB;AAClD,CAAA;AAEO,SAAS,YAAY,EAAA,EAAqB;AAC/C,EAAA,IAAI;AACF,IAAA,OAAO,eAAe,EAAE,CAAA;AAAA,EAC1B,CAAA,CAAA,MAAQ;AAKN,IAAA,OAAO,WAAW,EAAE,CAAA;AAAA,EACtB;AACF;;;ACbO,SAAS,aAAa,MAAA,EAA0C;AACrE,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,oBACd,MAAA,EACiB;AAKjB,EAAA,MAAM,EAAE,YAAA,EAAa,GAAI,WAAA,CAAY,OAAO,CAAA;AAC5C,EAAA,MAAM,SAAS,MAAA,CAAO,GAAA,IAAO,MAAA,CAAO,GAAA,CAAI,WAAW,WAAW,CAAA;AAM9D,EAAA,MAAM,IAAA,GAAY;AAAA,IAChB,KAAK,MAAA,CAAO,GAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,cAAA,EAAgB,OAAO,cAAA,IAAkB,IAAA;AAAA,MACzC,iBAAA,EAAmB,KAAA;AAAA,MACnB,GAAI,MAAA,GAAS,EAAE,GAAA,EAAK,IAAA,KAAS;AAAC;AAChC,GACF;AACA,EAAA,IAAI,MAAA,CAAO,QAAA,KAAa,MAAA,EAAW,IAAA,CAAK,WAAW,MAAA,CAAO,QAAA;AAE1D,EAAA,OAAO,aAAa,IAAI,CAAA;AAC1B","file":"adapter-redis.cjs","sourcesContent":["// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `redis@5` (the official `node-redis` client).\n *\n * v5 already uses camelCase methods that match `RedisClientLike` almost\n * exactly, so this adapter is mostly a type assertion plus the\n * `createRedisV5Client` factory that codifies the \"1.5s connectTimeout,\n * reconnectStrategy: false\" defaults validated in production by the reference\n * implementation.\n */\n\nimport type { RedisClientType } from \"redis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\nexport function adaptRedisV5(client: RedisClientType): RedisClientLike {\n  return client as unknown as RedisClientLike;\n}\n\nexport function createRedisV5Client(\n  config: Extract<RedisClientConfig, { type: \"redis\" }>\n): RedisClientType {\n  // Lazy require so consumers using ioredis only don't pay the cost.\n  // We do `require` instead of `await import` here because the parent\n  // `buildClient` is already in an async context that handles awaiting.\n   \n  const { createClient } = nodeRequire(\"redis\") as typeof import(\"redis\");\n  const useTls = config.tls ?? config.url.startsWith(\"rediss://\");\n\n  // redis@5 has a discriminated socket union (TCP / TLS / IPC) and disallows\n  // explicit `undefined` under exactOptionalPropertyTypes. Build the options\n  // object incrementally so optional fields stay absent when not set.\n   \n  const opts: any = {\n    url: config.url,\n    socket: {\n      connectTimeout: config.connectTimeout ?? 1500,\n      reconnectStrategy: false,\n      ...(useTls ? { tls: true } : {}),\n    },\n  };\n  if (config.password !== undefined) opts.password = config.password;\n\n  return createClient(opts) as RedisClientType;\n}\n"]}
+{"version":3,"sources":["../../../node_modules/tsup/assets/cjs_shims.js","../../../src/shared/node-require.ts","../../../src/shared/client/adapter-redis.ts"],"names":["createRequire","path"],"mappings":"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","file":"adapter-redis.cjs","sourcesContent":["// Shim globals in cjs bundle\n// There's a weird bug that esbuild will always inject importMetaUrl\n// if we export it as `const importMetaUrl = ... __filename ...`\n// But using a function will not cause this issue\n\nconst getImportMetaUrl = () => \n  typeof document === \"undefined\" \n    ? new URL(`file:${__filename}`).href \n    : (document.currentScript && document.currentScript.tagName.toUpperCase() === 'SCRIPT') \n      ? document.currentScript.src \n      : new URL(\"main.js\", document.baseURI).href;\n\nexport const importMetaUrl = /* @__PURE__ */ getImportMetaUrl()\n","/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `redis@5` (the official `node-redis` client).\n *\n * v5 already uses camelCase methods that match `RedisClientLike` almost\n * exactly, so this adapter is mostly a type assertion plus the\n * `createRedisV5Client` factory that codifies the \"1.5s connectTimeout,\n * reconnectStrategy: false\" defaults validated in production by the reference\n * implementation.\n */\n\nimport type { RedisClientType } from \"redis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\nexport function adaptRedisV5(client: RedisClientType): RedisClientLike {\n  const like = client as unknown as RedisClientLike;\n  like.dispose = () => {\n    try {\n      client.destroy();\n    } catch {\n      /* already closed */\n    }\n  };\n  // redis@5 exposes publish natively; subscribe needs a duplicate connection.\n  like.subscribe = async (channel, onMessage, onDown) => {\n    const sub = client.duplicate();\n    const teardown = () => {\n      try {\n        sub.destroy();\n      } catch {\n        /* already closed */\n      }\n    };\n    let down = false;\n    const markDown = () => {\n      if (down) return;\n      down = true;\n      teardown();\n      onDown?.();\n    };\n    sub.on(\"error\", markDown);\n    // reconnectStrategy is false on duplicates — a dropped socket is final,\n    // so surface it instead of latching a dead subscription as active.\n    sub.on(\"end\", markDown);\n    try {\n      await sub.connect();\n      await sub.subscribe(channel, (message: string) => onMessage(message));\n    } catch (err) {\n      // CRITICAL: without this, every failed SUBSCRIBE (e.g. ACL without\n      // channel permissions) leaks one connected duplicate per retry.\n      teardown();\n      throw err;\n    }\n    return async () => teardown();\n  };\n  return like;\n}\n\nexport function createRedisV5Client(\n  config: Extract<RedisClientConfig, { type: \"redis\" }>\n): RedisClientType {\n  // Lazy require so consumers using ioredis only don't pay the cost.\n  // We do `require` instead of `await import` here because the parent\n  // `buildClient` is already in an async context that handles awaiting.\n   \n  const { createClient } = nodeRequire(\"redis\") as typeof import(\"redis\");\n  const useTls = config.tls ?? config.url.startsWith(\"rediss://\");\n\n  // redis@5 has a discriminated socket union (TCP / TLS / IPC) and disallows\n  // explicit `undefined` under exactOptionalPropertyTypes. Build the options\n  // object incrementally so optional fields stay absent when not set.\n   \n  const opts: any = {\n    url: config.url,\n    socket: {\n      connectTimeout: config.connectTimeout ?? 1500,\n      reconnectStrategy: false,\n      ...(useTls ? { tls: true } : {}),\n    },\n  };\n  if (config.password !== undefined) opts.password = config.password;\n\n  return createClient(opts) as RedisClientType;\n}\n"]}

package/dist/shared/client/adapter-redis.d.cts

@@ -1,5 +1,5 @@
 import { RedisClientType } from 'redis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-Bl-rkLKX.cjs';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.cjs';
 
 /**
  * Adapter for `redis@5` (the official `node-redis` client).

package/dist/shared/client/adapter-redis.d.ts

@@ -1,5 +1,5 @@
 import { RedisClientType } from 'redis';
-import { R as RedisClientLike, a as RedisClientConfig } from '../../types-Bl-rkLKX.js';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-C1vJ_sED.js';
 
 /**
  * Adapter for `redis@5` (the official `node-redis` client).

package/dist/shared/client/adapter-redis.js

@@ -16,7 +16,40 @@ function nodeRequire(id) {
 
 // src/shared/client/adapter-redis.ts
 function adaptRedisV5(client) {
-  return client;
+  const like = client;
+  like.dispose = () => {
+    try {
+      client.destroy();
+    } catch {
+    }
+  };
+  like.subscribe = async (channel, onMessage, onDown) => {
+    const sub = client.duplicate();
+    const teardown = () => {
+      try {
+        sub.destroy();
+      } catch {
+      }
+    };
+    let down = false;
+    const markDown = () => {
+      if (down) return;
+      down = true;
+      teardown();
+      onDown?.();
+    };
+    sub.on("error", markDown);
+    sub.on("end", markDown);
+    try {
+      await sub.connect();
+      await sub.subscribe(channel, (message) => onMessage(message));
+    } catch (err) {
+      teardown();
+      throw err;
+    }
+    return async () => teardown();
+  };
+  return like;
 }
 function createRedisV5Client(config) {
   const { createClient } = nodeRequire("redis");

package/dist/shared/client/adapter-redis.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/shared/node-require.ts","../../../src/shared/client/adapter-redis.ts"],"names":[],"mappings":";;;;AAaA,IAAM,cAAA,GAAiB,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AACpD,IAAM,UAAA,GAAa,aAAA;AAAA,EACjB,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,GAAA,IAAO,uBAAuB;AAClD,CAAA;AAEO,SAAS,YAAY,EAAA,EAAqB;AAC/C,EAAA,IAAI;AACF,IAAA,OAAO,eAAe,EAAE,CAAA;AAAA,EAC1B,CAAA,CAAA,MAAQ;AAKN,IAAA,OAAO,WAAW,EAAE,CAAA;AAAA,EACtB;AACF;;;ACbO,SAAS,aAAa,MAAA,EAA0C;AACrE,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,oBACd,MAAA,EACiB;AAKjB,EAAA,MAAM,EAAE,YAAA,EAAa,GAAI,WAAA,CAAY,OAAO,CAAA;AAC5C,EAAA,MAAM,SAAS,MAAA,CAAO,GAAA,IAAO,MAAA,CAAO,GAAA,CAAI,WAAW,WAAW,CAAA;AAM9D,EAAA,MAAM,IAAA,GAAY;AAAA,IAChB,KAAK,MAAA,CAAO,GAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,cAAA,EAAgB,OAAO,cAAA,IAAkB,IAAA;AAAA,MACzC,iBAAA,EAAmB,KAAA;AAAA,MACnB,GAAI,MAAA,GAAS,EAAE,GAAA,EAAK,IAAA,KAAS;AAAC;AAChC,GACF;AACA,EAAA,IAAI,MAAA,CAAO,QAAA,KAAa,MAAA,EAAW,IAAA,CAAK,WAAW,MAAA,CAAO,QAAA;AAE1D,EAAA,OAAO,aAAa,IAAI,CAAA;AAC1B","file":"adapter-redis.js","sourcesContent":["/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `redis@5` (the official `node-redis` client).\n *\n * v5 already uses camelCase methods that match `RedisClientLike` almost\n * exactly, so this adapter is mostly a type assertion plus the\n * `createRedisV5Client` factory that codifies the \"1.5s connectTimeout,\n * reconnectStrategy: false\" defaults validated in production by the reference\n * implementation.\n */\n\nimport type { RedisClientType } from \"redis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\nexport function adaptRedisV5(client: RedisClientType): RedisClientLike {\n  return client as unknown as RedisClientLike;\n}\n\nexport function createRedisV5Client(\n  config: Extract<RedisClientConfig, { type: \"redis\" }>\n): RedisClientType {\n  // Lazy require so consumers using ioredis only don't pay the cost.\n  // We do `require` instead of `await import` here because the parent\n  // `buildClient` is already in an async context that handles awaiting.\n   \n  const { createClient } = nodeRequire(\"redis\") as typeof import(\"redis\");\n  const useTls = config.tls ?? config.url.startsWith(\"rediss://\");\n\n  // redis@5 has a discriminated socket union (TCP / TLS / IPC) and disallows\n  // explicit `undefined` under exactOptionalPropertyTypes. Build the options\n  // object incrementally so optional fields stay absent when not set.\n   \n  const opts: any = {\n    url: config.url,\n    socket: {\n      connectTimeout: config.connectTimeout ?? 1500,\n      reconnectStrategy: false,\n      ...(useTls ? { tls: true } : {}),\n    },\n  };\n  if (config.password !== undefined) opts.password = config.password;\n\n  return createClient(opts) as RedisClientType;\n}\n"]}
+{"version":3,"sources":["../../../src/shared/node-require.ts","../../../src/shared/client/adapter-redis.ts"],"names":[],"mappings":";;;;AAaA,IAAM,cAAA,GAAiB,aAAA,CAAc,MAAA,CAAA,IAAA,CAAY,GAAG,CAAA;AACpD,IAAM,UAAA,GAAa,aAAA;AAAA,EACjB,IAAA,CAAK,IAAA,CAAK,OAAA,CAAQ,GAAA,IAAO,uBAAuB;AAClD,CAAA;AAEO,SAAS,YAAY,EAAA,EAAqB;AAC/C,EAAA,IAAI;AACF,IAAA,OAAO,eAAe,EAAE,CAAA;AAAA,EAC1B,CAAA,CAAA,MAAQ;AAKN,IAAA,OAAO,WAAW,EAAE,CAAA;AAAA,EACtB;AACF;;;ACbO,SAAS,aAAa,MAAA,EAA0C;AACrE,EAAA,MAAM,IAAA,GAAO,MAAA;AACb,EAAA,IAAA,CAAK,UAAU,MAAM;AACnB,IAAA,IAAI;AACF,MAAA,MAAA,CAAO,OAAA,EAAQ;AAAA,IACjB,CAAA,CAAA,MAAQ;AAAA,IAER;AAAA,EACF,CAAA;AAEA,EAAA,IAAA,CAAK,SAAA,GAAY,OAAO,OAAA,EAAS,SAAA,EAAW,MAAA,KAAW;AACrD,IAAA,MAAM,GAAA,GAAM,OAAO,SAAA,EAAU;AAC7B,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,IAAI;AACF,QAAA,GAAA,CAAI,OAAA,EAAQ;AAAA,MACd,CAAA,CAAA,MAAQ;AAAA,MAER;AAAA,IACF,CAAA;AACA,IAAA,IAAI,IAAA,GAAO,KAAA;AACX,IAAA,MAAM,WAAW,MAAM;AACrB,MAAA,IAAI,IAAA,EAAM;AACV,MAAA,IAAA,GAAO,IAAA;AACP,MAAA,QAAA,EAAS;AACT,MAAA,MAAA,IAAS;AAAA,IACX,CAAA;AACA,IAAA,GAAA,CAAI,EAAA,CAAG,SAAS,QAAQ,CAAA;AAGxB,IAAA,GAAA,CAAI,EAAA,CAAG,OAAO,QAAQ,CAAA;AACtB,IAAA,IAAI;AACF,MAAA,MAAM,IAAI,OAAA,EAAQ;AAClB,MAAA,MAAM,IAAI,SAAA,CAAU,OAAA,EAAS,CAAC,OAAA,KAAoB,SAAA,CAAU,OAAO,CAAC,CAAA;AAAA,IACtE,SAAS,GAAA,EAAK;AAGZ,MAAA,QAAA,EAAS;AACT,MAAA,MAAM,GAAA;AAAA,IACR;AACA,IAAA,OAAO,YAAY,QAAA,EAAS;AAAA,EAC9B,CAAA;AACA,EAAA,OAAO,IAAA;AACT;AAEO,SAAS,oBACd,MAAA,EACiB;AAKjB,EAAA,MAAM,EAAE,YAAA,EAAa,GAAI,WAAA,CAAY,OAAO,CAAA;AAC5C,EAAA,MAAM,SAAS,MAAA,CAAO,GAAA,IAAO,MAAA,CAAO,GAAA,CAAI,WAAW,WAAW,CAAA;AAM9D,EAAA,MAAM,IAAA,GAAY;AAAA,IAChB,KAAK,MAAA,CAAO,GAAA;AAAA,IACZ,MAAA,EAAQ;AAAA,MACN,cAAA,EAAgB,OAAO,cAAA,IAAkB,IAAA;AAAA,MACzC,iBAAA,EAAmB,KAAA;AAAA,MACnB,GAAI,MAAA,GAAS,EAAE,GAAA,EAAK,IAAA,KAAS;AAAC;AAChC,GACF;AACA,EAAA,IAAI,MAAA,CAAO,QAAA,KAAa,MAAA,EAAW,IAAA,CAAK,WAAW,MAAA,CAAO,QAAA;AAE1D,EAAA,OAAO,aAAa,IAAI,CAAA;AAC1B","file":"adapter-redis.js","sourcesContent":["/**\n * A require() that works from BOTH build outputs.\n *\n * The client/OTel factories load optional peers (`redis`, `ioredis`,\n * `@opentelemetry/api`) lazily at runtime. A bare `require()` compiles fine\n * for CJS but becomes esbuild's `__require` fallback in the ESM build, which\n * throws \"Dynamic require of X is not supported\" in pure-ESM consumers.\n * `createRequire(import.meta.url)` is real in ESM, and tsup's `shims: true`\n * provides an `import.meta.url` polyfill for the CJS build.\n */\nimport { createRequire } from \"node:module\";\nimport path from \"node:path\";\n\nconst packageRequire = createRequire(import.meta.url);\nconst cwdRequire = createRequire(\n  path.join(process.cwd(), \"__resolve-anchor__.js\")\n);\n\nexport function nodeRequire(id: string): unknown {\n  try {\n    return packageRequire(id);\n  } catch {\n    // Symlinked installs (npm i <local-path>, pnpm's virtual store) resolve\n    // import.meta.url to the package's REAL location, outside the app tree —\n    // so peers installed by the app aren't reachable from that anchor. Retry\n    // from the process CWD, which under a Next.js server is the app root.\n    return cwdRequire(id);\n  }\n}\n","/**\n * Adapter for `redis@5` (the official `node-redis` client).\n *\n * v5 already uses camelCase methods that match `RedisClientLike` almost\n * exactly, so this adapter is mostly a type assertion plus the\n * `createRedisV5Client` factory that codifies the \"1.5s connectTimeout,\n * reconnectStrategy: false\" defaults validated in production by the reference\n * implementation.\n */\n\nimport type { RedisClientType } from \"redis\";\n\nimport type { RedisClientConfig, RedisClientLike } from \"../../types.js\";\nimport { nodeRequire } from \"../node-require.js\";\n\nexport function adaptRedisV5(client: RedisClientType): RedisClientLike {\n  const like = client as unknown as RedisClientLike;\n  like.dispose = () => {\n    try {\n      client.destroy();\n    } catch {\n      /* already closed */\n    }\n  };\n  // redis@5 exposes publish natively; subscribe needs a duplicate connection.\n  like.subscribe = async (channel, onMessage, onDown) => {\n    const sub = client.duplicate();\n    const teardown = () => {\n      try {\n        sub.destroy();\n      } catch {\n        /* already closed */\n      }\n    };\n    let down = false;\n    const markDown = () => {\n      if (down) return;\n      down = true;\n      teardown();\n      onDown?.();\n    };\n    sub.on(\"error\", markDown);\n    // reconnectStrategy is false on duplicates — a dropped socket is final,\n    // so surface it instead of latching a dead subscription as active.\n    sub.on(\"end\", markDown);\n    try {\n      await sub.connect();\n      await sub.subscribe(channel, (message: string) => onMessage(message));\n    } catch (err) {\n      // CRITICAL: without this, every failed SUBSCRIBE (e.g. ACL without\n      // channel permissions) leaks one connected duplicate per retry.\n      teardown();\n      throw err;\n    }\n    return async () => teardown();\n  };\n  return like;\n}\n\nexport function createRedisV5Client(\n  config: Extract<RedisClientConfig, { type: \"redis\" }>\n): RedisClientType {\n  // Lazy require so consumers using ioredis only don't pay the cost.\n  // We do `require` instead of `await import` here because the parent\n  // `buildClient` is already in an async context that handles awaiting.\n   \n  const { createClient } = nodeRequire(\"redis\") as typeof import(\"redis\");\n  const useTls = config.tls ?? config.url.startsWith(\"rediss://\");\n\n  // redis@5 has a discriminated socket union (TCP / TLS / IPC) and disallows\n  // explicit `undefined` under exactOptionalPropertyTypes. Build the options\n  // object incrementally so optional fields stay absent when not set.\n   \n  const opts: any = {\n    url: config.url,\n    socket: {\n      connectTimeout: config.connectTimeout ?? 1500,\n      reconnectStrategy: false,\n      ...(useTls ? { tls: true } : {}),\n    },\n  };\n  if (config.password !== undefined) opts.password = config.password;\n\n  return createClient(opts) as RedisClientType;\n}\n"]}

package/dist/{types-Bl-rkLKX.d.cts → types-C1vJ_sED.d.cts}

@@ -11,6 +11,7 @@ interface RedisClientLike {
     get(key: string): Promise<string | null>;
     set(key: string, value: string, opts?: {
         EX?: number;
+        NX?: boolean;
     }): Promise<unknown>;
     del(keys: string | string[]): Promise<number>;
     sAdd(key: string, member: string | string[]): Promise<number>;
@@ -32,6 +33,17 @@ interface RedisClientLike {
     }): AsyncIterable<string[] | string>;
     ping(): Promise<string>;
     on(event: "error", listener: (err: Error) => void): unknown;
+    /**
+     * Publish a message to a channel. Optional — used by the opt-in
+     * `tagPubSub` acceleration; absence simply disables it.
+     */
+    publish?(channel: string, message: string): Promise<unknown>;
+    /**
+     * Subscribe to a channel on a DEDICATED duplicate connection (Redis
+     * protocol requirement). Resolves to an unsubscribe/teardown function.
+     * Optional — absence disables `tagPubSub` on this client.
+     */
+    subscribe?(channel: string, onMessage: (message: string) => void, onDown?: () => void): Promise<() => Promise<void>>;
     /**
      * Close the underlying connection without waiting for pending replies.
      * Called by the connection manager when a dead client is replaced. Optional:
@@ -177,6 +189,18 @@ interface CacheHandlerOptions {
      * Default: `true`. Set to `false` to revert to "expire on revalidate" behavior.
      */
     staleWhileRevalidate?: boolean;
+    /**
+     * Push-based cross-instance tag propagation (plural handler only).
+     *
+     * When enabled, `updateTags()` publishes invalidations on a namespaced
+     * channel and every instance keeps a subscription on a dedicated
+     * connection, updating its local tag mirror within milliseconds instead
+     * of waiting for the next `refreshTags()` scan. The scan keeps running as
+     * the consistency safety net, so a dropped subscription degrades to the
+     * default behavior rather than to staleness. Not available on Cluster
+     * clients (falls back to polling with a warning). Default: `false`.
+     */
+    tagPubSub?: boolean;
     /**
      * Single-flight refresh lock for the SWR boundary.
      *
@@ -248,4 +272,4 @@ interface IncrementalCacheData {
     tags?: string[];
 }
 
-export type { CacheComponentsEntry as C, FallbackStrategy as F, IncrementalCacheData as I, Logger as L, MetricEmitter as M, RedisClientLike as R, RedisClientConfig as a, CacheHandlerOptions as b, MetricEvent as c, MetricEventType as d, RedisClientFactory as e };
+export type { CacheComponentsEntry as C, FallbackStrategy as F, IncrementalCacheData as I, Logger as L, MetricEmitter as M, RedisClientLike as R, RedisClientConfig as a, RedisClientFactory as b, CacheHandlerOptions as c, MetricEvent as d, MetricEventType as e };

package/dist/{types-Bl-rkLKX.d.ts → types-C1vJ_sED.d.ts}

@@ -11,6 +11,7 @@ interface RedisClientLike {
     get(key: string): Promise<string | null>;
     set(key: string, value: string, opts?: {
         EX?: number;
+        NX?: boolean;
     }): Promise<unknown>;
     del(keys: string | string[]): Promise<number>;
     sAdd(key: string, member: string | string[]): Promise<number>;
@@ -32,6 +33,17 @@ interface RedisClientLike {
     }): AsyncIterable<string[] | string>;
     ping(): Promise<string>;
     on(event: "error", listener: (err: Error) => void): unknown;
+    /**
+     * Publish a message to a channel. Optional — used by the opt-in
+     * `tagPubSub` acceleration; absence simply disables it.
+     */
+    publish?(channel: string, message: string): Promise<unknown>;
+    /**
+     * Subscribe to a channel on a DEDICATED duplicate connection (Redis
+     * protocol requirement). Resolves to an unsubscribe/teardown function.
+     * Optional — absence disables `tagPubSub` on this client.
+     */
+    subscribe?(channel: string, onMessage: (message: string) => void, onDown?: () => void): Promise<() => Promise<void>>;
     /**
      * Close the underlying connection without waiting for pending replies.
      * Called by the connection manager when a dead client is replaced. Optional:
@@ -177,6 +189,18 @@ interface CacheHandlerOptions {
      * Default: `true`. Set to `false` to revert to "expire on revalidate" behavior.
      */
     staleWhileRevalidate?: boolean;
+    /**
+     * Push-based cross-instance tag propagation (plural handler only).
+     *
+     * When enabled, `updateTags()` publishes invalidations on a namespaced
+     * channel and every instance keeps a subscription on a dedicated
+     * connection, updating its local tag mirror within milliseconds instead
+     * of waiting for the next `refreshTags()` scan. The scan keeps running as
+     * the consistency safety net, so a dropped subscription degrades to the
+     * default behavior rather than to staleness. Not available on Cluster
+     * clients (falls back to polling with a warning). Default: `false`.
+     */
+    tagPubSub?: boolean;
     /**
      * Single-flight refresh lock for the SWR boundary.
      *
@@ -248,4 +272,4 @@ interface IncrementalCacheData {
     tags?: string[];
 }
 
-export type { CacheComponentsEntry as C, FallbackStrategy as F, IncrementalCacheData as I, Logger as L, MetricEmitter as M, RedisClientLike as R, RedisClientConfig as a, CacheHandlerOptions as b, MetricEvent as c, MetricEventType as d, RedisClientFactory as e };
+export type { CacheComponentsEntry as C, FallbackStrategy as F, IncrementalCacheData as I, Logger as L, MetricEmitter as M, RedisClientLike as R, RedisClientConfig as a, RedisClientFactory as b, CacheHandlerOptions as c, MetricEvent as d, MetricEventType as e };

package/llms.txt

@@ -0,0 +1,27 @@
+# @leejpsd/nextjs-cache-handler
+
+> Redis cache handler for self-hosted Next.js 15/16 — the only one shipping
+> both cacheHandler (ISR) and cacheHandlers ('use cache') with built-in
+> compression, Redis Sentinel, OpenTelemetry, stale-while-revalidate tag
+> invalidation, per-deploy namespace isolation, and a bounded in-memory
+> fallback with automatic reconnection. Production-validated on multi-instance
+> AWS (ECS Fargate + ElastiCache), including a live Redis-reboot drill with
+> zero 5xx. Install version >= 0.3.3.
+
+Key facts: peer `next >=15.0.0 <17` (cacheHandlers needs >= 16.1.5); clients:
+redis (node-redis v5), ioredis, ioredis Cluster (set hashTag: true), Sentinel;
+zero runtime dependencies; ESM + CJS.
+
+## Docs
+
+- [README](https://github.com/leejpsd/nextjs-cache-handler/blob/main/README.md): quick start, wiring, options, production checklist
+- [API reference](https://github.com/leejpsd/nextjs-cache-handler/blob/main/docs/api.md): entry points, options, client configs, metric events
+- [Agent skill](https://github.com/leejpsd/nextjs-cache-handler/blob/main/skills/nextjs-redis-cache/SKILL.md): decision tables, invalidation semantics, troubleshooting playbook
+- [Agent setup instructions](https://github.com/leejpsd/nextjs-cache-handler/blob/main/setup-instructions/setup.md): step-by-step executable install flow
+- [Architecture](https://github.com/leejpsd/nextjs-cache-handler/blob/main/docs/architecture.md): key layout, tag propagation, single-flight
+- [Staging verification](https://github.com/leejpsd/nextjs-cache-handler/blob/main/docs/staging-verification-2026-08-01.md): AWS multi-instance evidence
+
+## Optional
+
+- [Next 16 cacheHandlers spec notes](https://github.com/leejpsd/nextjs-cache-handler/blob/main/docs/next16-spec.md): verified division of labor between Next and handlers
+- [Changelog](https://github.com/leejpsd/nextjs-cache-handler/blob/main/CHANGELOG.md)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@leejpsd/nextjs-cache-handler",
-  "version": "0.3.3",
+  "version": "0.4.0",
   "description": "Redis cache handler for Next.js 15/16 — the only one shipping both cacheHandler (ISR) and cacheHandlers ('use cache') with built-in compression, Redis Sentinel, and OpenTelemetry. Production-validated on multi-instance AWS: reconnect backoff, cross-instance tag invalidation, zero-downtime Redis failover.",
   "keywords": [
     "next",
@@ -55,6 +55,9 @@
       ],
       "otel": [
         "./dist/otel/index.d.ts"
+      ],
+      "seed": [
+        "./dist/seed/index.d.ts"
       ]
     }
   },
@@ -119,6 +122,16 @@
         "default": "./dist/ops/index.cjs"
       }
     },
+    "./seed": {
+      "import": {
+        "types": "./dist/seed/index.d.ts",
+        "default": "./dist/seed/index.js"
+      },
+      "require": {
+        "types": "./dist/seed/index.d.cts",
+        "default": "./dist/seed/index.cjs"
+      }
+    },
     "./otel": {
       "import": {
         "types": "./dist/otel/index.d.ts",
@@ -133,6 +146,12 @@
   },
   "files": [
     "dist/",
+    "bin/",
+    "skills/",
+    "rules/",
+    "setup-instructions/",
+    "AGENTS.md",
+    "llms.txt",
     "README.md",
     "CHANGELOG.md",
     "LICENSE"
@@ -156,7 +175,10 @@
     "attw": "attw --pack .",
     "version:changesets": "changeset version",
     "publish:changesets": "npm run build && changeset publish",
-    "prepublishOnly": "npm run verify && npm run publint && npm run attw"
+    "prepublishOnly": "npm run verify && npm run publint && npm run attw",
+    "test:cluster": "vitest run --config vitest.cluster.config.ts",
+    "test:cluster:up": "scripts/cluster-test-env.sh up",
+    "test:cluster:down": "scripts/cluster-test-env.sh down"
   },
   "peerDependencies": {
     "next": ">=15.0.0 <17",
@@ -198,5 +220,8 @@
   },
   "publishConfig": {
     "access": "public"
+  },
+  "bin": {
+    "nextjs-cache-handler": "./bin/cli.cjs"
   }
 }