@trieb.work/nextjs-turbo-redis-cache 1.17.0 → 1.18.1

package/src/RedisStringsHandler.ts

@@ -1,937 +0,0 @@
-import { commandOptions, createClient, RedisClientOptions } from 'redis';
-import { SyncedMap } from './SyncedMap';
-import { DeduplicatedRequestHandler } from './DeduplicatedRequestHandler';
-import { debug } from './utils/debug';
-import { CacheValueSerializer, jsonCacheValueSerializer } from './serializer';
-
-export type CommandOptions = ReturnType<typeof commandOptions>;
-export type Client = ReturnType<typeof createClient>;
-
-export type CacheEntry = {
-  value: unknown;
-  lastModified: number;
-  tags: string[];
-};
-
-/** Discriminated union of the `ctx` argument Next.js passes to
- * {@link RedisStringsHandler.get}. The Pages Router (`PAGES`) has no PPR
- * concept, so `isRoutePPREnabled` is optional for it.
- *
- * Note: `REDIRECT` is intentionally absent. Next.js always calls `get()` with
- * `kind: 'PAGES'` for Pages Router routes, even when the stored value has
- * `kind: 'REDIRECT'`. The handler returns whatever value is cached and Next.js
- * interprets it accordingly. */
-export type GetContext =
-  | {
-      kind: 'APP_ROUTE' | 'APP_PAGE';
-      isRoutePPREnabled: boolean;
-      isFallback: boolean;
-    }
-  | {
-      kind: 'PAGES';
-      isRoutePPREnabled?: boolean;
-      isFallback: boolean;
-    }
-  | {
-      kind: 'FETCH';
-      revalidate: number;
-      fetchUrl: string;
-      fetchIdx: number;
-      tags: string[];
-      softTags: string[];
-      isFallback: boolean;
-    };
-
-/** Discriminated union of cache payloads accepted by
- * {@link RedisStringsHandler.set}. `null` is a valid payload: the Pages Router
- * stores `notFound: true` results as a cache entry with a null value. */
-export type SetCacheValue =
-  | {
-      kind: 'APP_PAGE';
-      status?: number;
-      headers: {
-        'x-nextjs-stale-time': string; // timestamp in ms
-        'x-next-cache-tags': string; // comma separated paths (tags)
-      };
-      html: string;
-      rscData: Buffer;
-      segmentData: unknown;
-      postboned: unknown;
-    }
-  | {
-      kind: 'APP_ROUTE';
-      status: number;
-      headers: {
-        'cache-control'?: string;
-        'x-nextjs-stale-time': string; // timestamp in ms
-        'x-next-cache-tags': string; // comma separated paths (tags)
-      };
-      body: Buffer;
-    }
-  | {
-      kind: 'PAGES';
-      html: string;
-      pageData: Record<string, unknown>;
-      headers?: Record<string, number | string | string[] | undefined>;
-      status?: number;
-    }
-  | {
-      kind: 'REDIRECT';
-      props: Record<string, unknown>;
-    }
-  | {
-      kind: 'FETCH';
-      data: {
-        headers: Record<string, string>;
-        body: string; // base64 encoded
-        status: number;
-        url: string;
-      };
-      revalidate: number | false;
-    }
-  | null;
-
-export function redisErrorHandler<T extends Promise<unknown>>(
-  debugInfo: string,
-  redisCommandResult: T,
-): T {
-  const beforeTimestamp = performance.now();
-  return redisCommandResult.catch((error) => {
-    console.error(
-      'Redis command error',
-      (performance.now() - beforeTimestamp).toFixed(2),
-      'ms',
-      debugInfo,
-      error,
-    );
-    throw error;
-  }) as T;
-}
-
-function isAbortError(error: unknown): boolean {
-  if (!error || typeof error !== 'object') return false;
-  const err = error as { name?: unknown; code?: unknown };
-  return err.name === 'AbortError' || err.code === 'ABORT_ERR';
-}
-
-if (process.env.DEBUG_CACHE_HANDLER) {
-  // This is a test to check if the event loop is lagging. If it lags, increase CPU of container
-  setInterval(() => {
-    const start = performance.now();
-    setImmediate(() => {
-      const duration = performance.now() - start;
-      if (duration > 100) {
-        debug(
-          'yellow',
-          `RedisStringsHandler detected an event loop lag of: ${duration.toFixed(2)}ms. If your container is hosted in a cloud provider with container suspension this is normal. If not you should increase the CPU of your container.`,
-        );
-      }
-    });
-  }, 500);
-}
-
-export type CreateRedisStringsHandlerOptions = {
-  /** Redis redisUrl to use.
-   * @default process.env.REDIS_URL? process.env.REDIS_URL : process.env.REDISHOST
-          ? `redis://${process.env.REDISHOST}:${process.env.REDISPORT}`
-          : 'redis://localhost:6379'
-   */
-  redisUrl?: string;
-  /** Redis database number to use. Uses DB 0 for production, DB 1 otherwise
-   * @default process.env.VERCEL_ENV === 'production' ? 0 : 1
-   */
-  database?: number;
-  /** Prefix added to all Redis keys
-   * @default process.env.KEY_PREFIX || process.env.VERCEL_URL || 'UNDEFINED_URL_'
-   */
-  keyPrefix?: string;
-  /** Timeout in milliseconds for time critical Redis operations (during cache get, which blocks site rendering).
-   *  If redis get is not fulfilled within this time, the cache handler will return null so site rendering will
-   *  not be blocked further and site can fallback to re-render/re-fetch the content.
-   * @default 500
-   */
-  getTimeoutMs?: number;
-  /** Number of entries to query in one batch during full sync of shared tags hash map
-   * @default 250
-   */
-  revalidateTagQuerySize?: number;
-  /** Key used to store shared tags hash map in Redis
-   * @default '__sharedTags__'
-   */
-  sharedTagsKey?: string;
-  /** Average interval in milliseconds between tag map full re-syncs
-   * @default 3600000 (1 hour)
-   */
-  avgResyncIntervalMs?: number;
-  /** Enable deduplication of Redis get requests via internal in-memory cache
-   * @default true
-   */
-  redisGetDeduplication?: boolean;
-  /** Time in milliseconds to cache Redis get results in memory. Set this to 0 to disable in-memory caching completely
-   * @default 10000
-   */
-  inMemoryCachingTime?: number;
-  /** Default stale age in seconds for cached items
-   * @default 1209600 (14 days)
-   */
-  defaultStaleAge?: number;
-  /** Function to calculate expire age (redis TTL value) from stale age
-   * @default Production: staleAge * 2, Other: staleAge * 1.2
-   */
-  estimateExpireAge?: (staleAge: number) => number;
-  /** Kill container on Redis client error if error threshold is reached
-   * @default 0 (0 means no error threshold)
-   */
-  killContainerOnErrorThreshold?: number;
-  /** Additional Redis client socket options
-   * @example { tls: true, rejectUnauthorized: false }
-   */
-  socketOptions?: RedisClientOptions['socket'];
-  /** Additional Redis client options to be passed directly to createClient
-   * @example { username: 'user', password: 'pass' }
-   */
-  clientOptions?: Omit<RedisClientOptions, 'url' | 'database' | 'socket'>;
-  /** Pluggable wire-format codec for Redis string values. Lets you plug in
-   * compression (gzip/brotli), encryption, or any other custom encoding without
-   * forking this package or losing the existing dedup / batch / keyspace features.
-   *
-   * Both `serialize` and `deserialize` may return a `Promise`, enabling
-   * non-blocking async codecs (e.g. `zlib.brotliCompress`) that don't block the
-   * Node.js event loop. Synchronous implementations continue to work unchanged.
-   *
-   * Only the main cache-entry storage path is routed through the serializer.
-   * The shared-tags map and the revalidated-tags map are not. The in-memory
-   * deduplication cache stores the wire-format string verbatim - its contents
-   * change with the serializer, but the cache itself is not re-encoded.
-   *
-   * Operational note: changing the serializer (or any of its parameters such as
-   * a compression level or encryption key) makes existing Redis keys unreadable.
-   * Either flush the affected keys or bump `keyPrefix` before deploying.
-   *
-   * @default jsonCacheValueSerializer (JSON.stringify with bufferAndMapReplacer
-   * so native Buffer and Map values inside a CacheEntry round-trip transparently)
-   */
-  valueSerializer?: CacheValueSerializer;
-};
-
-// Identifier prefix used by Next.js to mark automatically generated cache tags
-// These tags are created internally by Next.js for route-based invalidation
-const NEXT_CACHE_IMPLICIT_TAG_ID = '_N_T_';
-
-// Redis key used to store a map of tags and their last revalidation timestamps
-// This helps track when specific tags were last invalidated
-const REVALIDATED_TAGS_KEY = '__revalidated_tags__';
-
-// Cache kinds this handler is designed and tested for. Kept as the single
-// source of truth for both payload validation and the warning message, so
-// adding a kind is a one-line change here instead of edits scattered across
-// the type union, the guard chain, and the log string.
-const SUPPORTED_GET_KINDS = [
-  'APP_ROUTE',
-  'APP_PAGE',
-  'PAGES',
-  'FETCH',
-] as const;
-const SUPPORTED_SET_KINDS = [
-  'APP_ROUTE',
-  'APP_PAGE',
-  'PAGES',
-  'REDIRECT',
-  'FETCH',
-] as const;
-
-let killContainerOnErrorCount: number = 0;
-export default class RedisStringsHandler {
-  private client: Client;
-  private sharedTagsMap: SyncedMap<string[]>;
-  private revalidatedTagsMap: SyncedMap<number>;
-  private inMemoryDeduplicationCache: SyncedMap<
-    Promise<ReturnType<Client['get']>>
-  >;
-  private getTimeoutMs: number;
-  private redisGet: Client['get'];
-  private redisDeduplicationHandler: DeduplicatedRequestHandler<
-    Client['get'],
-    string | Buffer | null
-  >;
-  private deduplicatedRedisGet: (key: string) => Client['get'];
-  private keyPrefix: string;
-  private redisGetDeduplication: boolean;
-  private inMemoryCachingTime: number;
-  private defaultStaleAge: number;
-  private estimateExpireAge: (staleAge: number) => number;
-  private killContainerOnErrorThreshold: number;
-  private valueSerializer: CacheValueSerializer;
-
-  constructor({
-    redisUrl = process.env.REDIS_URL
-      ? process.env.REDIS_URL
-      : process.env.REDISHOST
-        ? `redis://${process.env.REDISHOST}:${process.env.REDISPORT}`
-        : 'redis://localhost:6379',
-    database = process.env.VERCEL_ENV === 'production' ? 0 : 1,
-    keyPrefix = process.env.KEY_PREFIX ||
-      process.env.VERCEL_URL ||
-      'UNDEFINED_URL_',
-    sharedTagsKey = '__sharedTags__',
-    getTimeoutMs = process.env.REDIS_COMMAND_TIMEOUT_MS
-      ? (Number.parseInt(process.env.REDIS_COMMAND_TIMEOUT_MS) ?? 500)
-      : 500,
-    revalidateTagQuerySize = 250,
-    avgResyncIntervalMs = 60 * 60 * 1_000,
-    redisGetDeduplication = true,
-    inMemoryCachingTime = 10_000,
-    defaultStaleAge = 60 * 60 * 24 * 14,
-    estimateExpireAge = (staleAge) =>
-      process.env.VERCEL_ENV === 'production' ? staleAge * 2 : staleAge * 1.2,
-    killContainerOnErrorThreshold = process.env
-      .KILL_CONTAINER_ON_ERROR_THRESHOLD
-      ? (Number.parseInt(process.env.KILL_CONTAINER_ON_ERROR_THRESHOLD) ?? 0)
-      : 0,
-    socketOptions,
-    clientOptions,
-    valueSerializer = jsonCacheValueSerializer,
-  }: CreateRedisStringsHandlerOptions) {
-    try {
-      this.keyPrefix = keyPrefix;
-      this.redisGetDeduplication = redisGetDeduplication;
-      this.inMemoryCachingTime = inMemoryCachingTime;
-      this.defaultStaleAge = defaultStaleAge;
-      this.estimateExpireAge = estimateExpireAge;
-      this.killContainerOnErrorThreshold = killContainerOnErrorThreshold;
-      this.getTimeoutMs = getTimeoutMs;
-      this.valueSerializer = valueSerializer;
-
-      try {
-        // Create Redis client with properly typed configuration
-        this.client = createClient({
-          url: redisUrl,
-          pingInterval: 10_000, // Useful with Redis deployments that do not use TCP Keep-Alive. Restarts the connection if it is idle for too long.
-          ...(database !== 0 ? { database } : {}),
-          ...(socketOptions ? { socket: { ...socketOptions } } : {}),
-          ...(clientOptions || {}),
-        });
-
-        this.client.on('error', (error) => {
-          console.error(
-            'Redis client error',
-            error,
-            killContainerOnErrorCount++,
-          );
-          setTimeout(() => {
-            // Avoid overlapping connect() calls which can lead to
-            // "Socket already opened" errors when a reconnect is already
-            // in progress or the socket is still open.
-            if (!this.client.isOpen && !this.client.isReady) {
-              this.client.connect().catch((error) => {
-                console.error(
-                  'Failed to reconnect Redis client after connection loss:',
-                  error,
-                );
-              });
-            }
-          }, 1000);
-          if (
-            this.killContainerOnErrorThreshold > 0 &&
-            killContainerOnErrorCount >= this.killContainerOnErrorThreshold
-          ) {
-            console.error(
-              'Redis client error threshold reached, disconnecting and exiting (please implement a restart process/container watchdog to handle this error)',
-              error,
-              killContainerOnErrorCount++,
-            );
-            this.client.disconnect();
-            this.client.quit();
-            setTimeout(() => {
-              process.exit(1);
-            }, 500);
-          }
-        });
-
-        this.client
-          .connect()
-          .then(() => {
-            debug('green', 'Redis client connected.');
-          })
-          .catch((error) => {
-            console.error('Failed to connect Redis client:', error);
-            throw error;
-          });
-      } catch (error: unknown) {
-        console.error('Failed to initialize Redis client');
-        throw error;
-      }
-
-      const filterKeys = (key: string): boolean =>
-        key !== REVALIDATED_TAGS_KEY && key !== sharedTagsKey;
-
-      this.sharedTagsMap = new SyncedMap<string[]>({
-        client: this.client,
-        keyPrefix,
-        redisKey: sharedTagsKey,
-        database,
-        querySize: revalidateTagQuerySize,
-        filterKeys,
-        resyncIntervalMs:
-          avgResyncIntervalMs -
-          avgResyncIntervalMs / 10 +
-          Math.random() * (avgResyncIntervalMs / 10),
-      });
-
-      this.revalidatedTagsMap = new SyncedMap<number>({
-        client: this.client,
-        keyPrefix,
-        redisKey: REVALIDATED_TAGS_KEY,
-        database,
-        querySize: revalidateTagQuerySize,
-        filterKeys,
-        resyncIntervalMs:
-          avgResyncIntervalMs +
-          avgResyncIntervalMs / 10 +
-          Math.random() * (avgResyncIntervalMs / 10),
-      });
-
-      this.inMemoryDeduplicationCache = new SyncedMap({
-        client: this.client,
-        keyPrefix,
-        redisKey: 'inMemoryDeduplicationCache',
-        database,
-        querySize: revalidateTagQuerySize,
-        filterKeys,
-        customizedSync: {
-          withoutRedisHashmap: true,
-          withoutSetSync: true,
-        },
-      });
-
-      const redisGet: Client['get'] = this.client.get.bind(this.client);
-      this.redisDeduplicationHandler = new DeduplicatedRequestHandler(
-        redisGet,
-        inMemoryCachingTime,
-        this.inMemoryDeduplicationCache,
-      );
-      this.redisGet = redisGet;
-      this.deduplicatedRedisGet =
-        this.redisDeduplicationHandler.deduplicatedFunction;
-    } catch (error) {
-      console.error(
-        'RedisStringsHandler constructor error',
-        error,
-        killContainerOnErrorCount++,
-      );
-      if (
-        killContainerOnErrorThreshold > 0 &&
-        killContainerOnErrorCount >= killContainerOnErrorThreshold
-      ) {
-        console.error(
-          'RedisStringsHandler constructor error threshold reached, disconnecting and exiting (please implement a restart process/container watchdog to handle this error)',
-          error,
-          killContainerOnErrorCount++,
-        );
-        process.exit(1);
-      }
-      throw error;
-    }
-  }
-
-  resetRequestCache(): void {}
-
-  private clientReadyCalls = 0;
-
-  private async assertClientIsReady(): Promise<void> {
-    if (this.clientReadyCalls > 10) {
-      throw new Error(
-        'assertClientIsReady called more than 10 times without being ready.',
-      );
-    }
-    let readyTimeout: ReturnType<typeof setTimeout> | undefined;
-    try {
-      await Promise.race([
-        Promise.all([
-          this.sharedTagsMap.waitUntilReady(),
-          this.revalidatedTagsMap.waitUntilReady(),
-        ]),
-        new Promise((_, reject) => {
-          readyTimeout = setTimeout(() => {
-            reject(
-              new Error(
-                'assertClientIsReady: Timeout waiting for Redis maps to be ready',
-              ),
-            );
-          }, 30_000);
-        }),
-      ]);
-    } finally {
-      // Always clear the timeout: once the race is won (the common case after
-      // the initial sync), the timer would otherwise stay pending for the full
-      // 30s. Timers capture the ambient async context (AsyncLocalStorage),
-      // so in a Next.js server every leaked timer pins the request's store —
-      // and with it the whole response object graph — for at least 30s on
-      // every single cache operation.
-      clearTimeout(readyTimeout);
-    }
-    this.clientReadyCalls = 0;
-    if (!this.client.isReady) {
-      throw new Error(
-        'assertClientIsReady: Redis client is not ready yet or connection is lost.',
-      );
-    }
-  }
-
-  public async get(key: string, ctx: GetContext): Promise<CacheEntry | null> {
-    try {
-      if (!(SUPPORTED_GET_KINDS as readonly string[]).includes(ctx.kind)) {
-        console.warn(
-          'RedisStringsHandler.get() called with',
-          key,
-          ctx,
-          `this cache handler is only designed and tested for kinds ${SUPPORTED_GET_KINDS.join(', ')} and not for kind`,
-          (ctx as { kind: string })?.kind,
-        );
-      }
-
-      debug('green', 'RedisStringsHandler.get() called with', key, ctx);
-      await this.assertClientIsReady();
-
-      const clientGet = this.redisGetDeduplication
-        ? this.deduplicatedRedisGet(key)
-        : this.redisGet;
-
-      const redisGetOperation = clientGet(
-        commandOptions({ signal: AbortSignal.timeout(this.getTimeoutMs) }),
-        this.keyPrefix + key,
-      ).catch((error) => {
-        if (isAbortError(error)) {
-          return null;
-        }
-        throw error;
-      });
-      const serializedCacheEntry = await redisErrorHandler(
-        'RedisStringsHandler.get(), operation: get' +
-          (this.redisGetDeduplication ? 'deduplicated' : '') +
-          ' ' +
-          this.getTimeoutMs +
-          'ms ' +
-          this.keyPrefix +
-          ' ' +
-          key,
-        redisGetOperation,
-      );
-
-      debug(
-        'green',
-        'RedisStringsHandler.get() finished with result (serializedCacheEntry)',
-        serializedCacheEntry?.substring(0, 200),
-      );
-
-      if (!serializedCacheEntry) {
-        return null;
-      }
-
-      let cacheEntry: CacheEntry | null;
-      try {
-        cacheEntry =
-          await this.valueSerializer.deserialize(serializedCacheEntry);
-      } catch (err) {
-        // A decode failure (e.g. legacy/corrupted entry after swapping codecs,
-        // bumping a compression level or rotating an encryption key) is treated
-        // as a cache miss rather than a hard error - this matches the
-        // null-from-deserialize semantics in the CacheValueSerializer contract
-        // and prevents a single unreadable entry from incrementing
-        // killContainerOnErrorCount on every read.
-        console.warn(
-          'RedisStringsHandler.get() valueSerializer.deserialize failed, treating as cache miss',
-          this.keyPrefix + key,
-          err,
-        );
-        return null;
-      }
-
-      debug(
-        'green',
-        'RedisStringsHandler.get() finished with result (cacheEntry)',
-        JSON.stringify(cacheEntry).substring(0, 200),
-      );
-
-      if (!cacheEntry) {
-        return null;
-      }
-
-      if (!cacheEntry?.tags) {
-        console.warn(
-          'RedisStringsHandler.get() called with',
-          key,
-          ctx,
-          'cacheEntry is mall formed (missing tags)',
-        );
-      }
-      // value === null is a legitimate entry: the Pages Router stores
-      // `notFound: true` results as a cache entry with a null value.
-      // Only an absent value indicates a malformed entry.
-      if (cacheEntry?.value === undefined) {
-        console.warn(
-          'RedisStringsHandler.get() called with',
-          key,
-          ctx,
-          'cacheEntry is mall formed (missing value)',
-        );
-      }
-      if (!cacheEntry?.lastModified) {
-        console.warn(
-          'RedisStringsHandler.get() called with',
-          key,
-          ctx,
-          'cacheEntry is mall formed (missing lastModified)',
-        );
-      }
-
-      if (ctx.kind === 'FETCH') {
-        const combinedTags = new Set([
-          ...(ctx?.softTags || []),
-          ...(ctx?.tags || []),
-        ]);
-
-        if (combinedTags.size === 0) {
-          return cacheEntry;
-        }
-
-        // INFO: implicit tags (revalidate of nested fetch in api route/page on revalidatePath call of the page/api route). See revalidateTag() for more information
-        //
-        // This code checks if any of the cache tags associated with this entry (normally the internal tag of the parent page/api route containing the fetch request)
-        // have been revalidated since the entry was last modified. If any tag was revalidated more recently than the entry's
-        // lastModified timestamp, then the cached content is considered stale (therefore return null) and should be removed.
-        for (const tag of combinedTags) {
-          // Get the last revalidation time for this tag from our revalidatedTagsMap
-          const revalidationTime = this.revalidatedTagsMap.get(tag);
-
-          // If we have a revalidation time for this tag and it's more recent than when
-          // this cache entry was last modified, the entry is stale
-          if (revalidationTime && revalidationTime > cacheEntry.lastModified) {
-            const redisKey = this.keyPrefix + key;
-
-            // We don't await this cleanup since it can happen asynchronously in the background.
-            // The cache entry is already considered invalid at this point.
-            this.client
-              .unlink(redisKey)
-              .catch((err) => {
-                // Log error but don't retry deletion since the cache entry will likely be
-                // updated immediately after via set(). A retry could dangerously execute
-                // after the new value is set.
-                console.error(
-                  'Error occurred while unlinking stale data. Error was:',
-                  err,
-                );
-              })
-              .finally(async () => {
-                // Clean up our tag tracking maps after the Redis key is removed
-                await this.sharedTagsMap.delete(key);
-                await this.revalidatedTagsMap.delete(tag);
-              });
-
-            debug(
-              'green',
-              'RedisStringsHandler.get() found revalidation time for tag. Cache entry is stale and will be deleted and "null" will be returned.',
-              tag,
-              redisKey,
-              revalidationTime,
-              cacheEntry,
-            );
-
-            // Return null to indicate no valid cache entry was found
-            return null;
-          }
-        }
-      }
-
-      return cacheEntry;
-    } catch (error) {
-      // This catch block is necessary to handle any errors that may occur during:
-      // 1. Redis operations (get, unlink)
-      // 2. Tag validation and cleanup
-      // (Deserialization errors are handled locally above and treated as cache misses,
-      // so they do not reach this branch and do not count toward the kill threshold.)
-      // If any error occurs, we return null to indicate no valid cache entry was found,
-      // allowing the application to regenerate the content rather than crash
-      console.error(
-        'RedisStringsHandler.get() Error occurred while getting cache entry. Returning null so site can continue to serve content while cache is disabled. The original error was:',
-        error,
-        killContainerOnErrorCount++,
-      );
-
-      if (
-        this.killContainerOnErrorThreshold > 0 &&
-        killContainerOnErrorCount >= this.killContainerOnErrorThreshold
-      ) {
-        console.error(
-          'RedisStringsHandler get() error threshold reached, disconnecting and exiting (please implement a restart process/container watchdog to handle this error)',
-          error,
-          killContainerOnErrorCount,
-        );
-        this.client.disconnect();
-        this.client.quit();
-        setTimeout(() => {
-          process.exit(1);
-        }, 500);
-      }
-      return null;
-    }
-  }
-  public async set(
-    key: string,
-    data: SetCacheValue,
-    ctx: {
-      isRoutePPREnabled: boolean;
-      isFallback: boolean;
-      tags?: string[];
-      // Different versions of Next.js use different arguments for the same functionality
-      revalidate?: number | false; // Version 15.0.3
-      cacheControl?: { revalidate: number | false; expire: number | undefined }; // Version 15.0.3+
-    },
-  ) {
-    try {
-      if (
-        data !== null &&
-        !(SUPPORTED_SET_KINDS as readonly string[]).includes(data.kind)
-      ) {
-        console.warn(
-          'RedisStringsHandler.set() called with',
-          key,
-          ctx,
-          data,
-          `this cache handler is only designed and tested for kinds ${SUPPORTED_SET_KINDS.join(', ')} and not for kind`,
-          (data as { kind: string })?.kind,
-        );
-      }
-
-      await this.assertClientIsReady();
-
-      if (data?.kind === 'APP_PAGE' || data?.kind === 'APP_ROUTE') {
-        const tags = data.headers['x-next-cache-tags']?.split(',');
-        ctx.tags = [...(ctx.tags || []), ...(tags || [])];
-      }
-
-      // Pages Router entries (PAGES, REDIRECT and null/notFound results) do not
-      // carry an x-next-cache-tags header. Attach the implicit path tag
-      // (_N_T_/<path>) so that revalidatePath()/revalidateTag('_N_T_/<path>')
-      // invalidates them the same way as App Router entries.
-      if (data === null || data.kind === 'PAGES' || data.kind === 'REDIRECT') {
-        const implicitTag = NEXT_CACHE_IMPLICIT_TAG_ID + key;
-        if (!ctx.tags?.includes(implicitTag)) {
-          ctx.tags = [...(ctx.tags || []), implicitTag];
-        }
-      }
-
-      // Constructing and serializing the value for storing it in redis
-      const cacheEntry: CacheEntry = {
-        lastModified: Date.now(),
-        tags: ctx?.tags || [],
-        value: data,
-      };
-      const serializedCacheEntry =
-        await this.valueSerializer.serialize(cacheEntry);
-
-      // pre seed data into deduplicated get client. This will reduce redis load by not requesting
-      // the same value from redis which was just set.
-      if (this.redisGetDeduplication) {
-        this.redisDeduplicationHandler.seedRequestReturn(
-          key,
-          serializedCacheEntry,
-        );
-      }
-
-      // TODO: implement expiration based on cacheControl.expire argument, -> probably relevant for cacheLife and "use cache" etc.: https://nextjs.org/docs/app/api-reference/functions/cacheLife
-      // Constructing the expire time for the cache entry
-      const revalidate =
-        // For fetch requests in newest versions, the revalidate context property is never used, and instead the revalidate property of the passed-in data is used
-        (data?.kind === 'FETCH' && data.revalidate) ||
-        ctx.revalidate ||
-        ctx.cacheControl?.revalidate ||
-        // Legacy fallback: older Next.js versions attached `revalidate` directly
-        // to the data payload. FETCH is already handled above, so this only
-        // matters for those older, non-discriminated shapes.
-        (data as { revalidate?: number | false } | null)?.revalidate;
-      const expireAt =
-        revalidate && Number.isSafeInteger(revalidate) && revalidate > 0
-          ? this.estimateExpireAge(revalidate)
-          : this.estimateExpireAge(this.defaultStaleAge);
-
-      // Setting the cache entry in redis
-      const setOperation: Promise<string | null> = redisErrorHandler(
-        'RedisStringsHandler.set(), operation: set ' +
-          this.keyPrefix +
-          ' ' +
-          key,
-        this.client.set(this.keyPrefix + key, serializedCacheEntry, {
-          EX: expireAt,
-        }),
-      );
-
-      debug(
-        'blue',
-        'RedisStringsHandler.set() will set the following serializedCacheEntry',
-        this.keyPrefix,
-        key,
-        data,
-        ctx,
-        serializedCacheEntry?.substring(0, 200),
-        expireAt,
-      );
-
-      // Setting the tags for the cache entry in the sharedTagsMap (locally stored hashmap synced via redis)
-      let setTagsOperation: Promise<void> | undefined;
-      if (ctx.tags && ctx.tags.length > 0) {
-        const currentTags = this.sharedTagsMap.get(key);
-        const currentIsSameAsNew =
-          currentTags?.length === ctx.tags.length &&
-          currentTags.every((v) => ctx.tags!.includes(v)) &&
-          ctx.tags.every((v) => currentTags.includes(v));
-
-        if (!currentIsSameAsNew) {
-          setTagsOperation = this.sharedTagsMap.set(
-            key,
-            structuredClone(ctx.tags) as string[],
-          );
-        }
-      }
-
-      debug(
-        'blue',
-        'RedisStringsHandler.set() will set the following sharedTagsMap',
-        key,
-        ctx.tags as string[],
-      );
-
-      await Promise.all([setOperation, setTagsOperation]);
-    } catch (error) {
-      console.error(
-        'RedisStringsHandler.set() Error occurred while setting cache entry. The original error was:',
-        error,
-        killContainerOnErrorCount++,
-      );
-      if (
-        this.killContainerOnErrorThreshold > 0 &&
-        killContainerOnErrorCount >= this.killContainerOnErrorThreshold
-      ) {
-        console.error(
-          'RedisStringsHandler set() error threshold reached, disconnecting and exiting (please implement a restart process/container watchdog to handle this error)',
-          error,
-          killContainerOnErrorCount,
-        );
-        this.client.disconnect();
-        this.client.quit();
-        setTimeout(() => {
-          process.exit(1);
-        }, 500);
-      }
-      throw error;
-    }
-  }
-
-  // eslint-disable-next-line @typescript-eslint/no-explicit-any
-  public async revalidateTag(tagOrTags: string | string[], ...rest: any[]) {
-    try {
-      debug(
-        'red',
-        'RedisStringsHandler.revalidateTag() called with',
-        tagOrTags,
-        rest,
-      );
-      const tags = new Set([tagOrTags || []].flat());
-      await this.assertClientIsReady();
-
-      // find all keys that are related to this tag
-      const keysToDelete: Set<string> = new Set();
-
-      for (const tag of tags) {
-        // INFO: implicit tags (revalidate of nested fetch in api route/page on revalidatePath call of the page/api route)
-        //
-        // Invalidation logic for fetch requests that are related to a invalidated page.
-        // revalidateTag is called for the page tag (_N_T_...) and the fetch request needs to be invalidated as well
-        // unfortunately this is not possible since the revalidateTag is not called with any data that would allow us to find the cache entry of the fetch request
-        // in case of a fetch request get method call, the get method of the cache handler is called with some information about the pages/routes the fetch request is inside
-        // therefore we only mark the page/route as stale here (with help of the revalidatedTagsMap)
-        // and delete the cache entry of the fetch request on the next request to the get function
-        if (tag.startsWith(NEXT_CACHE_IMPLICIT_TAG_ID)) {
-          const now = Date.now();
-          debug(
-            'red',
-            'RedisStringsHandler.revalidateTag() set revalidation time for tag',
-            tag,
-            'to',
-            now,
-          );
-          await this.revalidatedTagsMap.set(tag, now);
-        }
-      }
-
-      // Scan the whole sharedTagsMap for keys that are dependent on any of the revalidated tags
-      for (const [key, sharedTags] of this.sharedTagsMap.entries()) {
-        if (sharedTags.some((tag) => tags.has(tag))) {
-          keysToDelete.add(key);
-        }
-      }
-
-      debug(
-        'red',
-        'RedisStringsHandler.revalidateTag() found',
-        keysToDelete,
-        'keys to delete',
-      );
-
-      // exit early if no keys are related to this tag
-      if (keysToDelete.size === 0) {
-        return;
-      }
-
-      // prepare deletion of all keys in redis that are related to this tag
-      const redisKeys = Array.from(keysToDelete);
-      const fullRedisKeys = redisKeys.map((key) => this.keyPrefix + key);
-      const deleteKeysOperation = redisErrorHandler(
-        'RedisStringsHandler.revalidateTag(), operation: unlink ' +
-          this.keyPrefix +
-          ' ' +
-          fullRedisKeys,
-        this.client.unlink(fullRedisKeys),
-      );
-
-      // also delete entries from in-memory deduplication cache if they get revalidated
-      if (this.redisGetDeduplication && this.inMemoryCachingTime > 0) {
-        for (const key of keysToDelete) {
-          this.inMemoryDeduplicationCache.delete(key);
-        }
-      }
-
-      // prepare deletion of entries from shared tags map if they get revalidated so that the map will not grow indefinitely
-      const deleteTagsOperation = this.sharedTagsMap.delete(redisKeys);
-
-      // execute keys and tag maps deletion
-      await Promise.all([deleteKeysOperation, deleteTagsOperation]);
-      debug(
-        'red',
-        'RedisStringsHandler.revalidateTag() finished delete operations',
-      );
-    } catch (error) {
-      console.error(
-        'RedisStringsHandler.revalidateTag() Error occurred while revalidating tags. The original error was:',
-        error,
-        killContainerOnErrorCount++,
-      );
-      if (
-        this.killContainerOnErrorThreshold > 0 &&
-        killContainerOnErrorCount >= this.killContainerOnErrorThreshold
-      ) {
-        console.error(
-          'RedisStringsHandler revalidateTag() error threshold reached, disconnecting and exiting (please implement a restart process/container watchdog to handle this error)',
-          error,
-          killContainerOnErrorCount,
-        );
-        this.client.disconnect();
-        this.client.quit();
-        setTimeout(() => {
-          process.exit(1);
-        }, 500);
-      }
-      throw error;
-    }
-  }
-}