@leejpsd/nextjs-cache-handler 0.1.0-rc.1

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

@@ -0,0 +1,125 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/shared/client/adapter-ioredis.ts
+function adapt(client, isClusterClient = false) {
+  return {
+    get isOpen() {
+      return client.status === "ready";
+    },
+    connect: async () => {
+      if (client.status !== "ready" && client.status !== "connecting") {
+        await client.connect();
+      }
+    },
+    get: (k) => client.get(k),
+    set: (k, v, opts) => opts?.EX !== void 0 ? client.set(k, v, "EX", opts.EX) : client.set(k, v),
+    del: async (keys) => {
+      const arr = Array.isArray(keys) ? keys : [keys];
+      if (arr.length === 0) return 0;
+      return client.del(...arr);
+    },
+    sAdd: async (k, m) => {
+      const arr = Array.isArray(m) ? m : [m];
+      if (arr.length === 0) return 0;
+      return client.sadd(k, ...arr);
+    },
+    sMembers: (k) => client.smembers(k),
+    expire: async (k, s) => {
+      const r = await client.expire(k, s);
+      return r;
+    },
+    mGet: async (keys) => {
+      if (keys.length === 0) return [];
+      return client.mget(...keys);
+    },
+    eval: (script, opts) => client.eval(
+      script,
+      opts.keys.length,
+      ...opts.keys,
+      ...opts.arguments
+    ),
+    evalSha: (sha, opts) => client.evalsha(
+      sha,
+      opts.keys.length,
+      ...opts.keys,
+      ...opts.arguments
+    ),
+    scriptLoad: async (script) => await client.script("LOAD", script),
+    scanIterator: async function* ({ MATCH, COUNT }) {
+      if (isClusterClient) {
+        const cluster = client;
+        for (const node of cluster.nodes("master")) {
+          let cursor = "0";
+          do {
+            const [next, batch] = await node.scan(
+              cursor,
+              "MATCH",
+              MATCH,
+              "COUNT",
+              COUNT ?? 100
+            );
+            cursor = next;
+            if (batch.length > 0) yield batch;
+          } while (cursor !== "0");
+        }
+      } else {
+        const redis = client;
+        let cursor = "0";
+        do {
+          const [next, batch] = await redis.scan(
+            cursor,
+            "MATCH",
+            MATCH,
+            "COUNT",
+            COUNT ?? 100
+          );
+          cursor = next;
+          if (batch.length > 0) yield batch;
+        } while (cursor !== "0");
+      }
+    },
+    ping: () => client.ping(),
+    on: (event, listener) => {
+      client.on(event, listener);
+      return client;
+    }
+  };
+}
+function adaptIoredis(client) {
+  return adapt(client, false);
+}
+function adaptCluster(cluster) {
+  return adapt(cluster, true);
+}
+function createIoredisClient(config) {
+  const IORedis = __require("ioredis");
+  const Ctor = IORedis.default ?? IORedis;
+  return new Ctor(config.url, {
+    password: config.password,
+    connectTimeout: config.connectTimeout ?? 1500,
+    tls: config.tls ? {} : void 0,
+    lazyConnect: true,
+    maxRetriesPerRequest: 1
+  });
+}
+function createIoredisCluster(config) {
+  const IORedis = __require("ioredis");
+  const ClusterCtor = IORedis.Cluster ?? IORedis.default.Cluster;
+  return new ClusterCtor(config.nodes, {
+    redisOptions: {
+      password: config.password,
+      tls: config.tls ? {} : void 0
+    },
+    enableReadyCheck: true,
+    lazyConnect: true
+  });
+}
+
+export { adaptCluster, adaptIoredis, createIoredisClient, createIoredisCluster };
+//# sourceMappingURL=adapter-ioredis.js.map
+//# sourceMappingURL=adapter-ioredis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/client/adapter-ioredis.ts"],"names":[],"mappings":"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","file":"adapter-ioredis.js","sourcesContent":["/**\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\";\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  };\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 = require(\"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  });\n}\n\nexport function createIoredisCluster(\n  config: Extract<RedisClientConfig, { type: \"cluster\" }>\n): Cluster {\n   \n  const IORedis = require(\"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  });\n}\n"]}

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

@@ -0,0 +1,32 @@
+'use strict';
+
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/shared/client/adapter-redis.ts
+function adaptRedisV5(client) {
+  return client;
+}
+function createRedisV5Client(config) {
+  const { createClient } = __require("redis");
+  const useTls = config.tls ?? config.url.startsWith("rediss://");
+  const opts = {
+    url: config.url,
+    socket: {
+      connectTimeout: config.connectTimeout ?? 1500,
+      reconnectStrategy: false,
+      ...useTls ? { tls: true } : {}
+    }
+  };
+  if (config.password !== void 0) opts.password = config.password;
+  return createClient(opts);
+}
+
+exports.adaptRedisV5 = adaptRedisV5;
+exports.createRedisV5Client = createRedisV5Client;
+//# sourceMappingURL=adapter-redis.cjs.map
+//# sourceMappingURL=adapter-redis.cjs.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/client/adapter-redis.ts"],"names":[],"mappings":";;;;;;;;;;AAcO,SAAS,aAAa,MAAA,EAA0C;AACrE,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,oBACd,MAAA,EACiB;AAKjB,EAAA,MAAM,EAAE,YAAA,EAAa,GAAI,SAAA,CAAQ,OAAO,CAAA;AACxC,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":["/**\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\";\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 } = require(\"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

@@ -0,0 +1,19 @@
+import { RedisClientType } from 'redis';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-CgriT7My.cjs';
+
+/**
+ * Adapter for `redis@5` (the official `node-redis` client).
+ *
+ * v5 already uses camelCase methods that match `RedisClientLike` almost
+ * exactly, so this adapter is mostly a type assertion plus the
+ * `createRedisV5Client` factory that codifies the "1.5s connectTimeout,
+ * reconnectStrategy: false" defaults validated in production by the reference
+ * implementation.
+ */
+
+declare function adaptRedisV5(client: RedisClientType): RedisClientLike;
+declare function createRedisV5Client(config: Extract<RedisClientConfig, {
+    type: "redis";
+}>): RedisClientType;
+
+export { adaptRedisV5, createRedisV5Client };

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

@@ -0,0 +1,19 @@
+import { RedisClientType } from 'redis';
+import { R as RedisClientLike, a as RedisClientConfig } from '../../types-CgriT7My.js';
+
+/**
+ * Adapter for `redis@5` (the official `node-redis` client).
+ *
+ * v5 already uses camelCase methods that match `RedisClientLike` almost
+ * exactly, so this adapter is mostly a type assertion plus the
+ * `createRedisV5Client` factory that codifies the "1.5s connectTimeout,
+ * reconnectStrategy: false" defaults validated in production by the reference
+ * implementation.
+ */
+
+declare function adaptRedisV5(client: RedisClientType): RedisClientLike;
+declare function createRedisV5Client(config: Extract<RedisClientConfig, {
+    type: "redis";
+}>): RedisClientType;
+
+export { adaptRedisV5, createRedisV5Client };

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

@@ -0,0 +1,29 @@
+var __require = /* @__PURE__ */ ((x) => typeof require !== "undefined" ? require : typeof Proxy !== "undefined" ? new Proxy(x, {
+  get: (a, b) => (typeof require !== "undefined" ? require : a)[b]
+}) : x)(function(x) {
+  if (typeof require !== "undefined") return require.apply(this, arguments);
+  throw Error('Dynamic require of "' + x + '" is not supported');
+});
+
+// src/shared/client/adapter-redis.ts
+function adaptRedisV5(client) {
+  return client;
+}
+function createRedisV5Client(config) {
+  const { createClient } = __require("redis");
+  const useTls = config.tls ?? config.url.startsWith("rediss://");
+  const opts = {
+    url: config.url,
+    socket: {
+      connectTimeout: config.connectTimeout ?? 1500,
+      reconnectStrategy: false,
+      ...useTls ? { tls: true } : {}
+    }
+  };
+  if (config.password !== void 0) opts.password = config.password;
+  return createClient(opts);
+}
+
+export { adaptRedisV5, createRedisV5Client };
+//# sourceMappingURL=adapter-redis.js.map
+//# sourceMappingURL=adapter-redis.js.map

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

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/shared/client/adapter-redis.ts"],"names":[],"mappings":";;;;;;;;AAcO,SAAS,aAAa,MAAA,EAA0C;AACrE,EAAA,OAAO,MAAA;AACT;AAEO,SAAS,oBACd,MAAA,EACiB;AAKjB,EAAA,MAAM,EAAE,YAAA,EAAa,GAAI,SAAA,CAAQ,OAAO,CAAA;AACxC,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 * 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\";\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 } = require(\"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-CgriT7My.d.cts

@@ -0,0 +1,193 @@
+/**
+ * Minimal Redis client surface used by both handlers. Adapters in
+ * `src/shared/client/` translate redis@5 / ioredis / Cluster to this shape.
+ *
+ * Methods follow `redis@5` (camelCase) naming. The ioredis adapter normalizes
+ * snake_case calls into this contract.
+ */
+interface RedisClientLike {
+    isOpen: boolean;
+    connect(): Promise<unknown>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: {
+        EX?: number;
+    }): Promise<unknown>;
+    del(keys: string | string[]): Promise<number>;
+    sAdd(key: string, member: string | string[]): Promise<number>;
+    sMembers(key: string): Promise<string[]>;
+    expire(key: string, seconds: number): Promise<number | boolean>;
+    mGet(keys: string[]): Promise<(string | null)[]>;
+    eval(script: string, opts: {
+        keys: string[];
+        arguments: string[];
+    }): Promise<unknown>;
+    evalSha?(sha: string, opts: {
+        keys: string[];
+        arguments: string[];
+    }): Promise<unknown>;
+    scriptLoad?(script: string): Promise<string>;
+    scanIterator(opts: {
+        MATCH: string;
+        COUNT?: number;
+    }): AsyncIterable<string[] | string>;
+    ping(): Promise<string>;
+    on(event: "error", listener: (err: Error) => void): unknown;
+}
+type RedisClientFactory = () => RedisClientLike | Promise<RedisClientLike>;
+type RedisClientConfig = {
+    type: "redis";
+    url: string;
+    password?: string;
+    tls?: boolean;
+    connectTimeout?: number;
+} | {
+    type: "ioredis";
+    url: string;
+    password?: string;
+    tls?: boolean;
+    connectTimeout?: number;
+} | {
+    type: "cluster";
+    nodes: Array<{
+        host: string;
+        port: number;
+    }>;
+    password?: string;
+    tls?: boolean;
+};
+/**
+ * Fallback strategy when Redis is unavailable.
+ *
+ * - `auto` (default): try Redis; on connection failure or timeout, transparently
+ *   fall back to an in-memory store. Multi-instance correctness is degraded but
+ *   the app stays up.
+ * - `always`: never connect to Redis. Useful for `next build` or local
+ *   development. Equivalent to legacy `CACHE_HANDLER_FALLBACK=memory` env.
+ * - `never`: connection failures are surfaced as cache misses. No memory fallback.
+ */
+type FallbackStrategy = "auto" | "always" | "never";
+/**
+ * Telemetry hook. Called from inside the handlers on every meaningful event.
+ * Optional — when not provided, only the process-local counters in
+ * `src/shared/metrics.ts` are updated.
+ */
+type MetricEventType = "cache.hit" | "cache.miss" | "cache.stale" | "cache.set" | "cache.set.failed" | "tag.invalidate.soft" | "tag.invalidate.hard" | "tag.expiration.read" | "redis.connect.failed" | "redis.timeout" | "fallback.activated" | "build_phase.skip";
+interface MetricEvent {
+    type: MetricEventType;
+    /** Operation latency in milliseconds, when measurable. */
+    ms?: number;
+    /** Free-form tags. Keep cardinality low (no user IDs, no cache keys). */
+    meta?: Record<string, string | number | boolean>;
+}
+type MetricEmitter = (event: MetricEvent) => void;
+/**
+ * Logger interface, compatible with `console`. Levels follow standard severity.
+ */
+interface Logger {
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    error: (message: string, meta?: Record<string, unknown>) => void;
+}
+/**
+ * Options shared by both `createCacheComponentsHandler` and
+ * `createIncrementalCacheHandler`.
+ */
+interface CacheHandlerOptions {
+    /**
+     * Redis client. Either:
+     *  - a factory function returning a connected (or connectable) `RedisClientLike`
+     *  - a config object describing how to construct one (lazy)
+     */
+    client: RedisClientFactory | RedisClientConfig;
+    /**
+     * Key prefix for namespace isolation. Defaults differ per handler:
+     *  - cacheHandlers: `next-cache:`
+     *  - incremental:   `next-incremental:`
+     *
+     * Useful when multiple Next.js apps share one Redis.
+     */
+    keyPrefix?: string;
+    /**
+     * Deployment-isolation namespace. Combined with `keyPrefix` so entries from
+     * different deployments never collide.
+     *
+     * Resolution order if not provided:
+     *   process.env.DEPLOYMENT_VERSION
+     *   ?? process.env.GIT_HASH
+     *   ?? "unversioned"
+     *
+     * Pass a function to defer reading process.env until first use (useful when
+     * env is set after module load).
+     */
+    buildNamespace?: string | (() => string);
+    /**
+     * Per-operation timeout in milliseconds. Wraps every Redis call in an
+     * AbortController. Default: 1500ms (matches the validated `pingRedis` value
+     * from the reference implementation).
+     *
+     * On timeout:
+     *  - `get` / `getExpiration` → cache miss (graceful)
+     *  - `set` / `refreshTags`   → ignored (best-effort)
+     *  - `updateTags` (hard expire) → propagated (revalidation must not be silent)
+     */
+    abortTimeoutMs?: number;
+    /** Fallback strategy. See {@link FallbackStrategy}. */
+    fallback?: FallbackStrategy;
+    /**
+     * Whether to keep returning a stale entry in the SWR window
+     * (`revalidate < age < expire`) while Next.js triggers a background refresh.
+     *
+     * Default: `true`. Set to `false` to revert to "expire on revalidate" behavior.
+     */
+    staleWhileRevalidate?: boolean;
+    /**
+     * Override the build-phase detector. Default checks
+     * `process.env.NEXT_PHASE === "phase-production-build"`.
+     *
+     * During build phase, all Redis calls are skipped and the in-memory fallback
+     * is used. Prevents PR #207-style ECONNREFUSED at build time.
+     */
+    isBuildPhase?: () => boolean;
+    /** Metrics emitter. */
+    onMetric?: MetricEmitter;
+    /** Custom logger. Defaults to a `console` adapter (warn level and above). */
+    logger?: Logger;
+    /**
+     * Use Redis Cluster hash tags in keys (`next-cache:{ns}:entry:...`). Required
+     * when running against a cluster so multi-key Lua scripts land on the same
+     * slot. Default: `false`.
+     */
+    hashTag?: boolean;
+}
+/**
+ * Cache entry shape used by `cacheHandlers` (the `'use cache'` interface).
+ * Mirrors Next.js 16's internal CacheEntry type.
+ */
+interface CacheComponentsEntry {
+    /** Rendered RSC payload. Streamed during write, materialized to base64 in storage. */
+    value: ReadableStream<Uint8Array>;
+    tags: string[];
+    /** SWR window start (seconds). */
+    stale: number;
+    /** Creation time (ms since epoch). */
+    timestamp: number;
+    /** Hard expiration (seconds since timestamp). */
+    expire: number;
+    /** Background refresh trigger time (seconds since timestamp). */
+    revalidate: number;
+}
+/**
+ * Cache data shape used by the legacy `cacheHandler` (singular) interface for
+ * ISR / route handlers. Value is a fully materialized buffer, not a stream.
+ */
+interface IncrementalCacheData {
+    value: Buffer | string | {
+        kind: string;
+        [key: string]: unknown;
+    } | null;
+    lastModified?: number;
+    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 };

package/dist/types-CgriT7My.d.ts

@@ -0,0 +1,193 @@
+/**
+ * Minimal Redis client surface used by both handlers. Adapters in
+ * `src/shared/client/` translate redis@5 / ioredis / Cluster to this shape.
+ *
+ * Methods follow `redis@5` (camelCase) naming. The ioredis adapter normalizes
+ * snake_case calls into this contract.
+ */
+interface RedisClientLike {
+    isOpen: boolean;
+    connect(): Promise<unknown>;
+    get(key: string): Promise<string | null>;
+    set(key: string, value: string, opts?: {
+        EX?: number;
+    }): Promise<unknown>;
+    del(keys: string | string[]): Promise<number>;
+    sAdd(key: string, member: string | string[]): Promise<number>;
+    sMembers(key: string): Promise<string[]>;
+    expire(key: string, seconds: number): Promise<number | boolean>;
+    mGet(keys: string[]): Promise<(string | null)[]>;
+    eval(script: string, opts: {
+        keys: string[];
+        arguments: string[];
+    }): Promise<unknown>;
+    evalSha?(sha: string, opts: {
+        keys: string[];
+        arguments: string[];
+    }): Promise<unknown>;
+    scriptLoad?(script: string): Promise<string>;
+    scanIterator(opts: {
+        MATCH: string;
+        COUNT?: number;
+    }): AsyncIterable<string[] | string>;
+    ping(): Promise<string>;
+    on(event: "error", listener: (err: Error) => void): unknown;
+}
+type RedisClientFactory = () => RedisClientLike | Promise<RedisClientLike>;
+type RedisClientConfig = {
+    type: "redis";
+    url: string;
+    password?: string;
+    tls?: boolean;
+    connectTimeout?: number;
+} | {
+    type: "ioredis";
+    url: string;
+    password?: string;
+    tls?: boolean;
+    connectTimeout?: number;
+} | {
+    type: "cluster";
+    nodes: Array<{
+        host: string;
+        port: number;
+    }>;
+    password?: string;
+    tls?: boolean;
+};
+/**
+ * Fallback strategy when Redis is unavailable.
+ *
+ * - `auto` (default): try Redis; on connection failure or timeout, transparently
+ *   fall back to an in-memory store. Multi-instance correctness is degraded but
+ *   the app stays up.
+ * - `always`: never connect to Redis. Useful for `next build` or local
+ *   development. Equivalent to legacy `CACHE_HANDLER_FALLBACK=memory` env.
+ * - `never`: connection failures are surfaced as cache misses. No memory fallback.
+ */
+type FallbackStrategy = "auto" | "always" | "never";
+/**
+ * Telemetry hook. Called from inside the handlers on every meaningful event.
+ * Optional — when not provided, only the process-local counters in
+ * `src/shared/metrics.ts` are updated.
+ */
+type MetricEventType = "cache.hit" | "cache.miss" | "cache.stale" | "cache.set" | "cache.set.failed" | "tag.invalidate.soft" | "tag.invalidate.hard" | "tag.expiration.read" | "redis.connect.failed" | "redis.timeout" | "fallback.activated" | "build_phase.skip";
+interface MetricEvent {
+    type: MetricEventType;
+    /** Operation latency in milliseconds, when measurable. */
+    ms?: number;
+    /** Free-form tags. Keep cardinality low (no user IDs, no cache keys). */
+    meta?: Record<string, string | number | boolean>;
+}
+type MetricEmitter = (event: MetricEvent) => void;
+/**
+ * Logger interface, compatible with `console`. Levels follow standard severity.
+ */
+interface Logger {
+    debug: (message: string, meta?: Record<string, unknown>) => void;
+    info: (message: string, meta?: Record<string, unknown>) => void;
+    warn: (message: string, meta?: Record<string, unknown>) => void;
+    error: (message: string, meta?: Record<string, unknown>) => void;
+}
+/**
+ * Options shared by both `createCacheComponentsHandler` and
+ * `createIncrementalCacheHandler`.
+ */
+interface CacheHandlerOptions {
+    /**
+     * Redis client. Either:
+     *  - a factory function returning a connected (or connectable) `RedisClientLike`
+     *  - a config object describing how to construct one (lazy)
+     */
+    client: RedisClientFactory | RedisClientConfig;
+    /**
+     * Key prefix for namespace isolation. Defaults differ per handler:
+     *  - cacheHandlers: `next-cache:`
+     *  - incremental:   `next-incremental:`
+     *
+     * Useful when multiple Next.js apps share one Redis.
+     */
+    keyPrefix?: string;
+    /**
+     * Deployment-isolation namespace. Combined with `keyPrefix` so entries from
+     * different deployments never collide.
+     *
+     * Resolution order if not provided:
+     *   process.env.DEPLOYMENT_VERSION
+     *   ?? process.env.GIT_HASH
+     *   ?? "unversioned"
+     *
+     * Pass a function to defer reading process.env until first use (useful when
+     * env is set after module load).
+     */
+    buildNamespace?: string | (() => string);
+    /**
+     * Per-operation timeout in milliseconds. Wraps every Redis call in an
+     * AbortController. Default: 1500ms (matches the validated `pingRedis` value
+     * from the reference implementation).
+     *
+     * On timeout:
+     *  - `get` / `getExpiration` → cache miss (graceful)
+     *  - `set` / `refreshTags`   → ignored (best-effort)
+     *  - `updateTags` (hard expire) → propagated (revalidation must not be silent)
+     */
+    abortTimeoutMs?: number;
+    /** Fallback strategy. See {@link FallbackStrategy}. */
+    fallback?: FallbackStrategy;
+    /**
+     * Whether to keep returning a stale entry in the SWR window
+     * (`revalidate < age < expire`) while Next.js triggers a background refresh.
+     *
+     * Default: `true`. Set to `false` to revert to "expire on revalidate" behavior.
+     */
+    staleWhileRevalidate?: boolean;
+    /**
+     * Override the build-phase detector. Default checks
+     * `process.env.NEXT_PHASE === "phase-production-build"`.
+     *
+     * During build phase, all Redis calls are skipped and the in-memory fallback
+     * is used. Prevents PR #207-style ECONNREFUSED at build time.
+     */
+    isBuildPhase?: () => boolean;
+    /** Metrics emitter. */
+    onMetric?: MetricEmitter;
+    /** Custom logger. Defaults to a `console` adapter (warn level and above). */
+    logger?: Logger;
+    /**
+     * Use Redis Cluster hash tags in keys (`next-cache:{ns}:entry:...`). Required
+     * when running against a cluster so multi-key Lua scripts land on the same
+     * slot. Default: `false`.
+     */
+    hashTag?: boolean;
+}
+/**
+ * Cache entry shape used by `cacheHandlers` (the `'use cache'` interface).
+ * Mirrors Next.js 16's internal CacheEntry type.
+ */
+interface CacheComponentsEntry {
+    /** Rendered RSC payload. Streamed during write, materialized to base64 in storage. */
+    value: ReadableStream<Uint8Array>;
+    tags: string[];
+    /** SWR window start (seconds). */
+    stale: number;
+    /** Creation time (ms since epoch). */
+    timestamp: number;
+    /** Hard expiration (seconds since timestamp). */
+    expire: number;
+    /** Background refresh trigger time (seconds since timestamp). */
+    revalidate: number;
+}
+/**
+ * Cache data shape used by the legacy `cacheHandler` (singular) interface for
+ * ISR / route handlers. Value is a fully materialized buffer, not a stream.
+ */
+interface IncrementalCacheData {
+    value: Buffer | string | {
+        kind: string;
+        [key: string]: unknown;
+    } | null;
+    lastModified?: number;
+    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 };