npm - @trieb.work/nextjs-turbo-redis-cache - Versions diffs - 1.14.1 → 1.15.1 - Mend

@trieb.work/nextjs-turbo-redis-cache 1.14.1 → 1.15.1

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (256) hide show

package/docs/index.html ADDED Viewed

@@ -0,0 +1,139 @@
+<!doctype html>
+<html lang="en">
+  <head>
+    <meta charset="UTF-8" />
+    <meta name="viewport" content="width=device-width, initial-scale=1" />
+    <title>nextjs-turbo-redis-cache | High-Performance Redis Cache Handler for Next.js</title>
+    <meta
+      name="description"
+      content="High-performance Redis cache handler for Next.js 15/16 App Router. Get request deduplication, batch tag invalidation, in-memory caching, and production-ready scalability."
+    />
+    <meta
+      name="keywords"
+      content="Next.js cache handler, Redis cache, App Router cache, Next.js performance, cache components, batch tag invalidation"
+    />
+    <meta name="robots" content="index, follow" />
+    <meta name="author" content="TRWK" />
+    <link rel="canonical" href="https://trieb-work.github.io/nextjs-turbo-redis-cache/" />
+    <meta property="og:type" content="website" />
+    <meta property="og:title" content="nextjs-turbo-redis-cache | High-Performance Redis Cache Handler for Next.js" />
+    <meta
+      property="og:description"
+      content="The production-ready Redis cache handler for Next.js 15/16 with request deduplication, in-memory caching, and efficient tag invalidation."
+    />
+    <meta property="og:url" content="https://trieb-work.github.io/nextjs-turbo-redis-cache/" />
+    <meta
+      property="og:image"
+      content="https://github.com/user-attachments/assets/4103191e-4f4d-4139-a519-0b5bfab3e8b4"
+    />
+    <meta name="twitter:card" content="summary_large_image" />
+    <meta name="twitter:title" content="nextjs-turbo-redis-cache" />
+    <meta
+      name="twitter:description"
+      content="Production-ready Redis cache handler for Next.js 15/16 App Router workloads."
+    />
+    <meta
+      name="twitter:image"
+      content="https://github.com/user-attachments/assets/4103191e-4f4d-4139-a519-0b5bfab3e8b4"
+    />
+    <link rel="stylesheet" href="./styles.css" />
+    <script type="application/ld+json">
+      {
+        "@context": "https://schema.org",
+        "@type": "SoftwareSourceCode",
+        "name": "nextjs-turbo-redis-cache",
+        "description": "High-performance Redis cache handler for Next.js 15/16 App Router with request deduplication, in-memory caching, and batch tag invalidation.",
+        "codeRepository": "https://github.com/trieb-work/nextjs-turbo-redis-cache",
+        "programmingLanguage": "TypeScript",
+        "runtimePlatform": "Node.js",
+        "license": "https://opensource.org/license/mit",
+        "author": {
+          "@type": "Organization",
+          "name": "TRWK",
+          "url": "https://trwk.de"
+        },
+        "keywords": [
+          "Next.js",
+          "Redis",
+          "Cache Handler",
+          "App Router",
+          "Performance"
+        ]
+      }
+    </script>
+  </head>
+  <body>
+    <header class="hero">
+      <p class="eyebrow">Open-source · MIT Licensed</p>
+      <h1>Redis Cache Handler Built for High-Traffic Next.js Apps</h1>
+      <p class="lead">
+        nextjs-turbo-redis-cache is a production-ready cache handler for Next.js 15/16 App Router, designed for
+        speed, consistency tradeoff awareness, and scale.
+      </p>
+      <div class="actions">
+        <a class="button primary" href="https://www.npmjs.com/package/@trieb.work/nextjs-turbo-redis-cache">Install from npm</a>
+        <a class="button" href="https://github.com/trieb-work/nextjs-turbo-redis-cache">View on GitHub</a>
+      </div>
+    </header>
+    <main>
+      <section aria-labelledby="features-title">
+        <h2 id="features-title">Why teams use nextjs-turbo-redis-cache</h2>
+        <ul class="feature-list">
+          <li>
+            <h3>Batch tag invalidation</h3>
+            <p>Groups and optimizes delete operations to reduce Redis load during revalidation spikes.</p>
+          </li>
+          <li>
+            <h3>Request deduplication</h3>
+            <p>Prevents duplicate Redis reads in hot paths to lower latency and improve throughput.</p>
+          </li>
+          <li>
+            <h3>In-memory acceleration</h3>
+            <p>Local memory caching reduces repetitive lookups and keeps frequent reads fast.</p>
+          </li>
+          <li>
+            <h3>Cache Components support</h3>
+            <p>Supports Next.js 16+ Cache Components flows including use cache, cacheTag, and cacheLife.</p>
+          </li>
+        </ul>
+      </section>
+      <section aria-labelledby="quickstart-title">
+        <h2 id="quickstart-title">Quick start</h2>
+        <p>Install the package and wire it as your cache handler in a Next.js App Router project.</p>
+        <pre><code>pnpm add @trieb.work/nextjs-turbo-redis-cache</code></pre>
+        <p>Then follow the setup guide in the README for configuration, Redis environment variables, and advanced options.</p>
+      </section>
+      <section aria-labelledby="links-title" class="links">
+        <h2 id="links-title">Resources</h2>
+        <ul>
+          <li><a href="https://github.com/trieb-work/nextjs-turbo-redis-cache">GitHub Repository</a></li>
+          <li><a href="https://www.npmjs.com/package/@trieb.work/nextjs-turbo-redis-cache">npm Package</a></li>
+          <li><a href="https://trwk.de/case-studies/nextjs-turbo-redis-cache">TRWK Case Study</a></li>
+        </ul>
+      </section>
+      <section aria-labelledby="alternatives-title" class="links">
+        <h2 id="alternatives-title">Other cache handler projects</h2>
+        <p>Compare this project with other open-source handlers used in the Next.js ecosystem:</p>
+        <ul>
+          <li><a href="https://github.com/fortedigital/nextjs-cache-handler">fortedigital/nextjs-cache-handler</a></li>
+          <li><a href="https://github.com/mrjasonroy/cache-components-cache-handler">mrjasonroy/cache-components-cache-handler</a></li>
+          <li><a href="https://github.com/leejpsd/nextjs-cache-handler">leejpsd/nextjs-cache-handler</a></li>
+          <li><a href="https://github.com/caching-tools/next-shared-cache">caching-tools/next-shared-cache (@neshca/cache-handler)</a></li>
+          <li><a href="https://github.com/vercel/next.js/tree/canary/examples/cache-handler-redis">vercel/next.js cache-handler-redis example</a></li>
+        </ul>
+      </section>
+    </main>
+    <footer>
+      <p>Maintained by <a href="https://trwk.de">TRWK</a>.</p>
+    </footer>
+  </body>
+</html>

package/docs/robots.txt ADDED Viewed

@@ -0,0 +1,4 @@
+User-agent: *
+Allow: /
+Sitemap: https://trieb-work.github.io/nextjs-turbo-redis-cache/sitemap.xml

package/docs/sitemap.xml ADDED Viewed

@@ -0,0 +1,8 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
+  <url>
+    <loc>https://trieb-work.github.io/nextjs-turbo-redis-cache/</loc>
+    <changefreq>weekly</changefreq>
+    <priority>1.0</priority>
+  </url>
+</urlset>

package/docs/styles.css ADDED Viewed

@@ -0,0 +1,141 @@
+:root {
+  --bg: #0a1628;
+  --bg-alt: #0f2139;
+  --card: #112a49;
+  --text: #e8f1ff;
+  --muted: #b8c8de;
+  --accent: #56c2ff;
+  --accent-strong: #1fa6f3;
+  --border: #2a476b;
+}
+* {
+  box-sizing: border-box;
+}
+body {
+  margin: 0;
+  font-family: "Segoe UI", "Helvetica Neue", Arial, sans-serif;
+  background: radial-gradient(circle at top, var(--bg-alt), var(--bg));
+  color: var(--text);
+  line-height: 1.6;
+}
+.hero,
+main,
+footer {
+  width: min(1080px, 92vw);
+  margin: 0 auto;
+}
+.hero {
+  padding: 4.5rem 0 2.2rem;
+}
+.eyebrow {
+  color: var(--accent);
+  font-weight: 700;
+  text-transform: uppercase;
+  letter-spacing: 0.06em;
+  font-size: 0.82rem;
+}
+h1 {
+  font-size: clamp(2rem, 4vw, 3.2rem);
+  line-height: 1.15;
+  margin: 0.5rem 0 1rem;
+  max-width: 18ch;
+}
+.lead {
+  color: var(--muted);
+  font-size: 1.1rem;
+  max-width: 64ch;
+}
+.actions {
+  display: flex;
+  gap: 0.8rem;
+  flex-wrap: wrap;
+  margin-top: 1.5rem;
+}
+.button {
+  display: inline-block;
+  text-decoration: none;
+  color: var(--text);
+  border: 1px solid var(--border);
+  padding: 0.75rem 1rem;
+  border-radius: 0.7rem;
+  font-weight: 600;
+}
+.button.primary {
+  background: var(--accent-strong);
+  border-color: var(--accent-strong);
+}
+main {
+  padding: 1.5rem 0 3rem;
+  display: grid;
+  gap: 1.2rem;
+}
+section {
+  background: color-mix(in srgb, var(--card) 82%, black);
+  border: 1px solid var(--border);
+  border-radius: 1rem;
+  padding: 1.2rem;
+}
+h2 {
+  margin-top: 0;
+}
+.feature-list {
+  margin: 0;
+  padding-left: 1rem;
+  display: grid;
+  gap: 0.75rem;
+}
+.feature-list li {
+  list-style: square;
+}
+.feature-list h3 {
+  margin-bottom: 0.2rem;
+}
+.feature-list p,
+.links li,
+footer p {
+  color: var(--muted);
+}
+pre {
+  overflow-x: auto;
+  background: #081323;
+  border: 1px solid var(--border);
+  border-radius: 0.7rem;
+  padding: 0.8rem;
+}
+a {
+  color: var(--accent);
+}
+footer {
+  padding: 0 0 2rem;
+}
+@media (max-width: 700px) {
+  .hero {
+    padding-top: 2.8rem;
+  }
+  .button {
+    width: 100%;
+    text-align: center;
+  }
+}

package/eslint.config.mjs CHANGED Viewed

@@ -3,7 +3,7 @@ import tsParser from '@typescript-eslint/parser';
 const config = [
   {
-    ignores: ['dist', 'node_modules'],
+    ignores: ['**/dist/**', '**/node_modules/**', '**/.next/**'],
   },
   {
     files: ['src/**/*.ts', 'src/**/*.tsx'],

package/package.json CHANGED Viewed

@@ -1,30 +1,28 @@
 {
   "name": "@trieb.work/nextjs-turbo-redis-cache",
-  "version": "1.14.1",
+  "version": "1.15.1",
   "homepage": "https://trwk.de/case-studies/nextjs-turbo-redis-cache",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/trieb-work/nextjs-turbo-redis-cache.git"
   },
   "scripts": {
-    "dev": "pnpm test",
-    "run-dev-server": "pnpm run-dev-server-15-4-7",
-    "run-dev-server-15-3-2": "cd ./test/integration/next-app-15-3-2 && pnpm dev",
-    "run-dev-server-15-0-3": "cd ./test/integration/next-app-15-0-3 && pnpm dev",
-    "run-dev-server-15-4-7": "cd ./test/integration/next-app-15-4-7 && pnpm dev",
+    "dev": "pnpm test:unit",
     "build": "tsup",
     "lint": "eslint -c eslint.config.mjs --fix",
     "format": "prettier --write 'src/**/*.ts' 'src/*.ts'",
-    "test": "vitest --coverage --config vite.config.ts",
-    "test:ci": "vitest --run --coverage --config vite.config.ts src/**/*.test.ts src/**/*.test.tsx test/integration/nextjs-cache-handler.integration.test.ts",
-    "test:integration:build-id-prefix": "vitest --run --coverage --config vite.config.ts test/integration/build-id-prefix.integration.test.ts",
-    "test:ui": "vitest --ui  --config vite.config.ts",
-    "test:unit": "vitest --config vite.config.ts src/**/*.test.ts src/**/*.test.tsx",
-    "test:integration": "vitest --config vite.config.ts ./test/integration/nextjs-cache-handler.integration.test.ts",
-    "test:cache-components": "vitest --run --config vitest.cache-components.config.ts",
     "prepare": "./scripts/prepare.sh",
-    "test:browser": "vitest --config=vitest.browser.config.ts",
-    "test:e2e": "playwright test"
+    "test": "vitest --coverage --config vite.config.ts",
+    "test:ui": "vitest --ui --config vite.config.ts",
+    "test:unit": "vitest --run --config vite.config.ts test/vitest/unit",
+    "test:unit:watch": "vitest --config vite.config.ts test/vitest/unit",
+    "test:unit:coverage": "vitest --run --coverage --config vite.config.ts test/vitest/unit",
+    "test:integration": "vitest --run --config vite.config.ts test/vitest/integration/nextjs-cache-handler.integration.test.ts",
+    "test:integration:build-id-prefix": "vitest --run --config vite.config.ts test/vitest/integration/build-id-prefix.integration.test.ts",
+    "test:integration:cache-components": "vitest --run --config vitest.cache-components.config.ts",
+    "test:e2e": "playwright test",
+    "run-dev-server": "pnpm run-dev-server-15-4-11",
+    "run-dev-server-15-4-11": "cd ./test/nextjs-test-projects/next-app-15-4-11 && pnpm dev"
   },
   "main": "dist/index.js",
   "module": "dist/index.mjs",
@@ -56,9 +54,9 @@
     "tags-cache",
     "nextjs-turbo-redis-cache"
   ],
-  "author": "Designed for speed, scalability, and optimized performance, nextjs-turbo-redis-cache is your go-to solution for Next.js caching in demanding production environments.",
+  "author": "TRWK <info@trwk.de>",
   "license": "ISC",
-  "description": "Next.js redis cache handler",
+  "description": "Designed for speed, scalability, and optimized performance, nextjs-turbo-redis-cache is your custom cache handler for demanding production environments.",
   "publishConfig": {
     "access": "public",
     "provenance": true
@@ -78,7 +76,7 @@
   "devDependencies": {
     "@commitlint/cli": "^19.6.0",
     "@commitlint/config-conventional": "^19.6.0",
-    "@playwright/test": "^1.56.1",
+    "@playwright/test": "^1.62.0",
     "@semantic-release/changelog": "^6.0.3",
     "@semantic-release/git": "^10.0.1",
     "@semantic-release/github": "^12.0.2",

package/playwright.config.ts CHANGED Viewed

@@ -1,14 +1,16 @@
 import { defineConfig } from '@playwright/test';
+const testApp =
+  process.env.PLAYWRIGHT_TEST_APP || 'next-app-16-2-6-cache-components';
 export default defineConfig({
-  testDir: 'tests',
+  testDir: 'test/playwright',
   use: {
     baseURL: process.env.PLAYWRIGHT_BASE_URL || 'http://localhost:3101',
     trace: 'on-first-retry',
   },
   webServer: {
-    command:
-      'pnpm -C test/integration/next-app-16-2-3-cache-components dev -p 3101',
+    command: `pnpm -C test/nextjs-test-projects/${testApp} dev -p 3101`,
     url: 'http://localhost:3101',
     reuseExistingServer: true,
     timeout: 120_000,

package/src/CacheComponentsHandler.ts CHANGED Viewed

@@ -6,6 +6,7 @@ import {
   redisErrorHandler,
 } from './RedisStringsHandler';
 import { SyncedMap } from './SyncedMap';
+import { DeduplicatedRequestHandler } from './DeduplicatedRequestHandler';
 import { debug } from './utils/debug';
 import { resolveKeyPrefix } from './utils/prefix';
@@ -87,8 +88,19 @@ class RedisCacheComponentsHandler implements CacheComponentsHandler {
   private client: Client;
   private revalidatedTagsMap: SyncedMap<number>;
   private sharedTagsMap: SyncedMap<string[]>;
+  private inMemoryDeduplicationCache: SyncedMap<
+    Promise<ReturnType<Client['get']>>
+  >;
   private keyPrefix: string;
   private getTimeoutMs: number;
+  private redisGet: Client['get'];
+  private redisDeduplicationHandler: DeduplicatedRequestHandler<
+    Client['get'],
+    string | Buffer | null
+  >;
+  private deduplicatedRedisGet: (key: string) => Client['get'];
+  private redisGetDeduplication: boolean;
+  private inMemoryCachingTime: number;
   constructor({
     redisUrl = process.env.REDIS_URL
@@ -103,6 +115,8 @@ class RedisCacheComponentsHandler implements CacheComponentsHandler {
       : 500,
     revalidateTagQuerySize = 250,
     avgResyncIntervalMs = 60 * 60 * 1_000,
+    redisGetDeduplication = true,
+    inMemoryCachingTime = 10_000,
     socketOptions,
     clientOptions,
     killContainerOnErrorThreshold = process.env
@@ -118,6 +132,8 @@ class RedisCacheComponentsHandler implements CacheComponentsHandler {
         env: process.env,
       });
       this.getTimeoutMs = getTimeoutMs;
+      this.redisGetDeduplication = redisGetDeduplication;
+      this.inMemoryCachingTime = inMemoryCachingTime;
       this.client = createClient({
         url: redisUrl,
@@ -208,6 +224,29 @@ class RedisCacheComponentsHandler implements CacheComponentsHandler {
           avgResyncIntervalMs / 10 +
           Math.random() * (avgResyncIntervalMs / 10),
       });
+      this.inMemoryDeduplicationCache = new SyncedMap({
+        client: this.client,
+        keyPrefix: this.keyPrefix,
+        redisKey: '__cacheComponents_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('RedisCacheComponentsHandler constructor error', error);
       throw error;
@@ -253,12 +292,18 @@ class RedisCacheComponentsHandler implements CacheComponentsHandler {
     try {
       await this.assertClientIsReady();
+      const clientGet = this.redisGetDeduplication
+        ? this.deduplicatedRedisGet(cacheKey)
+        : this.redisGet;
       const serialized = await redisErrorHandler(
-        'RedisCacheComponentsHandler.get(), operation: get ' +
+        'RedisCacheComponentsHandler.get(), operation: get' +
+          (this.redisGetDeduplication ? ' deduplicated' : '') +
+          ' ' +
           this.getTimeoutMs +
           'ms ' +
           redisKey,
-        this.client.get(
+        clientGet(
           commandOptions({ signal: AbortSignal.timeout(this.getTimeoutMs) }),
           redisKey,
         ),
@@ -355,6 +400,10 @@ class RedisCacheComponentsHandler implements CacheComponentsHandler {
         throw jsonError;
       }
+      if (this.redisGetDeduplication) {
+        this.redisDeduplicationHandler.seedRequestReturn(cacheKey, serialized);
+      }
       // expire is already a duration in seconds, use it directly
       const ttlSeconds =
         Number.isFinite(stored.expire) && stored.expire > 0
@@ -450,6 +499,12 @@ class RedisCacheComponentsHandler implements CacheComponentsHandler {
         this.client.unlink(fullRedisKeys),
       );
+      if (this.redisGetDeduplication && this.inMemoryCachingTime > 0) {
+        for (const key of keysToDelete) {
+          this.inMemoryDeduplicationCache.delete(key);
+        }
+      }
       // Delete from sharedTagsMap
       const deleteTagsOperation = this.sharedTagsMap.delete(cacheKeys);
       await deleteTagsOperation;

package/src/RedisStringsHandler.ts CHANGED Viewed

@@ -2,7 +2,7 @@ import { commandOptions, createClient, RedisClientOptions } from 'redis';
 import { SyncedMap } from './SyncedMap';
 import { DeduplicatedRequestHandler } from './DeduplicatedRequestHandler';
 import { debug } from './utils/debug';
-import { bufferAndMapReviver, bufferAndMapReplacer } from './utils/json';
+import { CacheValueSerializer, jsonCacheValueSerializer } from './serializer';
 export type CommandOptions = ReturnType<typeof commandOptions>;
 export type Client = ReturnType<typeof createClient>;
@@ -113,6 +113,27 @@ export type CreateRedisStringsHandlerOptions = {
    * @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
@@ -144,6 +165,7 @@ export default class RedisStringsHandler {
   private defaultStaleAge: number;
   private estimateExpireAge: (staleAge: number) => number;
   private killContainerOnErrorThreshold: number;
+  private valueSerializer: CacheValueSerializer;
   constructor({
     redisUrl = process.env.REDIS_URL
@@ -172,6 +194,7 @@ export default class RedisStringsHandler {
       : 0,
     socketOptions,
     clientOptions,
+    valueSerializer = jsonCacheValueSerializer,
   }: CreateRedisStringsHandlerOptions) {
     try {
       this.keyPrefix = keyPrefix;
@@ -181,6 +204,7 @@ export default class RedisStringsHandler {
       this.estimateExpireAge = estimateExpireAge;
       this.killContainerOnErrorThreshold = killContainerOnErrorThreshold;
       this.getTimeoutMs = getTimeoutMs;
+      this.valueSerializer = valueSerializer;
       try {
         // Create Redis client with properly typed configuration
@@ -418,10 +442,24 @@ export default class RedisStringsHandler {
         return null;
       }
-      const cacheEntry: CacheEntry | null = JSON.parse(
-        serializedCacheEntry,
-        bufferAndMapReviver,
-      );
+      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',
@@ -520,8 +558,9 @@ export default class RedisStringsHandler {
     } catch (error) {
       // This catch block is necessary to handle any errors that may occur during:
       // 1. Redis operations (get, unlink)
-      // 2. JSON parsing of cache entries
-      // 3. Tag validation and cleanup
+      // 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(
@@ -621,10 +660,8 @@ export default class RedisStringsHandler {
         tags: ctx?.tags || [],
         value: data,
       };
-      const serializedCacheEntry = JSON.stringify(
-        cacheEntry,
-        bufferAndMapReplacer,
-      );
+      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.