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

package/.github/workflows/ci.yml

@@ -65,6 +65,7 @@ jobs:
           - next-app-15-4-11
           - next-app-16-0-11
           - next-app-16-2-6
+          - next-app-16-3-0
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
@@ -111,6 +112,11 @@ jobs:
   integration-pages:
     runs-on: ubuntu-latest
     needs: lint-and-unit
+    strategy:
+      matrix:
+        pages-test-app:
+          - next-pages-16-2-6
+          - next-pages-16-3-0
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
@@ -143,15 +149,16 @@ jobs:
         run: redis-cli config set notify-keyspace-events Exe
 
       - name: Install test project
-        run: cd test/nextjs-test-projects/next-pages-16-2-6 && pnpm install
+        run: cd test/nextjs-test-projects/${{ matrix.pages-test-app }} && pnpm install
 
       - name: Build test project
-        run: cd test/nextjs-test-projects/next-pages-16-2-6 && pnpm build
+        run: cd test/nextjs-test-projects/${{ matrix.pages-test-app }} && pnpm build
 
       - name: Run Pages Router integration tests
         run: pnpm test:integration:pages
         env:
           SKIP_BUILD: true
+          NEXT_PAGES_TEST_APP: ${{ matrix.pages-test-app }}
 
   integration-build-id-prefix:
     runs-on: ubuntu-latest
@@ -204,6 +211,7 @@ jobs:
         cache-components-app:
           - next-app-16-0-11-cache-components
           - next-app-16-2-6-cache-components
+          - next-app-16-3-0-cache-components
     steps:
       - name: Checkout code
         uses: actions/checkout@v6
@@ -254,6 +262,7 @@ jobs:
         cache-components-app:
           - next-app-16-0-11-cache-components
           - next-app-16-2-6-cache-components
+          - next-app-16-3-0-cache-components
     steps:
       - name: Checkout code
         uses: actions/checkout@v6

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+# [1.17.0](https://github.com/trieb-work/nextjs-turbo-redis-cache/compare/v1.16.2...v1.17.0) (2026-08-13)
+
+
+### Features
+
+* add Next.js 16.3.0 support ([f7b40b5](https://github.com/trieb-work/nextjs-turbo-redis-cache/commit/f7b40b54e76cb605b8986f2bd01477662d94bd06))
+
 ## [1.16.2](https://github.com/trieb-work/nextjs-turbo-redis-cache/compare/v1.16.1...v1.16.2) (2026-08-13)
 
 

package/README.md

@@ -1,7 +1,7 @@
 # nextjs-turbo-redis-cache - Next.js Cache Handler
 
 [![npm version](https://img.shields.io/npm/v/@trieb.work/nextjs-turbo-redis-cache.svg)](https://www.npmjs.com/package/@trieb.work/nextjs-turbo-redis-cache)
-![Turbo redis cache image](https://github.com/user-attachments/assets/4103191e-4f4d-4139-a519-0b5bfab3e8b4)
+<img width="2512" height="1602" alt="Turbo redis cache image" src="https://github.com/user-attachments/assets/6f46e1fb-fcf7-4157-856c-196a1483534f" />
 
 The ultimate Redis Cache Handler for Next.js 15 / 16, supporting both the App Router and the Pages Router. Built for production-ready, large-scale projects, it delivers unparalleled performance and efficiency with features tailored for high-traffic applications. This package has been created after extensibly testing the @neshca package and finding several major issues with it.
 
@@ -34,6 +34,9 @@ Tested versions are:
 - Nextjs 16.2.6 + redis client 4.7.0 (cacheComponents: false)
 - Nextjs 16.2.6 + redis client 4.7.0 (cacheComponents: true)
 - Nextjs 16.2.6 + redis client 4.7.0 (Pages Router)
+- Nextjs 16.3.0 + redis client 4.7.0 (cacheComponents: false)
+- Nextjs 16.3.0 + redis client 4.7.0 (cacheComponents: true)
+- Nextjs 16.3.0 + redis client 4.7.0 (Pages Router)
 
 _Cache Components_ (Next.js 16+) are fully supported. Automated test coverage includes `'use cache'`, `cacheTag`, and `cacheLife` flows in the Cache Components integration suite.
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trieb.work/nextjs-turbo-redis-cache",
-  "version": "1.16.2",
+  "version": "1.17.0",
   "homepage": "https://trwk.de/case-studies/nextjs-turbo-redis-cache",
   "repository": {
     "type": "git",
@@ -98,7 +98,7 @@
     "vitest": "^4.0.13"
   },
   "peerDependencies": {
-    "next": ">=15.0.3 <16.3.0",
+    "next": ">=15.0.3 <17.0.0",
     "redis": "4.7.0"
   },
   "packageManager": "pnpm@10.33.4+sha512.1c67b3b359b2d408119ba1ed289f34b8fc3c6873412bec6fd264fbdc82489e510fcbecb9ce9d22dae7f3b76269d8441046014bdca53b9979cd7a561ad631b800"

package/test/README.md

@@ -55,7 +55,7 @@ These tests spawn a real Next.js server as a child process, make `fetch()` reque
 
 ### Standard Integration (`nextjs-cache-handler.integration.test.ts`)
 
-Full cache lifecycle: static pages, fetch caching, revalidation, tag invalidation, TTL behavior. In CI this runs against a matrix of Next.js versions (15.4–16.2).
+Full cache lifecycle: static pages, fetch caching, revalidation, tag invalidation, TTL behavior. In CI this runs against Next.js 15.4, 16.0, 16.2, and 16.3. Nested fetch entries are resolved from their explicit cache tag in Redis's shared-tags map rather than Next.js's internal fetch-key hash, which changed in Next.js 16.3.
 
 ```bash
 pnpm test:integration
@@ -63,7 +63,7 @@ pnpm test:integration
 
 ### Pages Router (`pages-router.integration.test.ts`)
 
-Pages Router cache lifecycle against the `next-pages-16-2-6` app: `PAGES` entry format, TTL derivation from `getStaticProps` `revalidate`, `fallback: 'blocking'` first hits, `notFound: true` (null cache entries), `redirect:` results, and `revalidate: false` TTL fallback.
+Pages Router cache lifecycle against the `next-pages-16-2-6` and `next-pages-16-3-0` apps: `PAGES` entry format, TTL derivation from `getStaticProps` `revalidate`, `fallback: 'blocking'` first hits, `notFound: true` (null cache entries), `redirect:` results, and `revalidate: false` TTL fallback.
 
 Starts **two** `next start` instances of the same build sharing one Redis and proves that on-demand revalidation (`res.revalidate(path)`) triggered on instance A is served fresh by instance B (HTML and `/_next/data` pageData JSON) — the multi-instance ISR scenario behind a load balancer.
 
@@ -81,7 +81,7 @@ pnpm test:integration:build-id-prefix
 
 ### Cache Components (`cache-components/`)
 
-Integration tests specific to Next.js 16 Cache Components (`use cache`). Uses `next-app-16-2-6-cache-components` as the test app.
+Integration tests specific to Next.js 16 Cache Components (`use cache`). CI runs them against the 16.0, 16.2, and 16.3 Cache Components test apps.
 
 | File                                   | What it tests                                                                                          |
 | -------------------------------------- | ------------------------------------------------------------------------------------------------------ |

package/test/nextjs-test-projects/next-app-15-4-11/pnpm-lock.yaml

@@ -492,7 +492,7 @@ packages:
   '@trieb.work/nextjs-turbo-redis-cache@file:../../..':
     resolution: {directory: ../../.., type: directory}
     peerDependencies:
-      next: '>=15.0.3 <16.3.0'
+      next: '>=15.0.3 <17.0.0'
       redis: 4.7.0
 
   '@tybys/wasm-util@0.9.0':

package/test/nextjs-test-projects/next-app-16-0-11/pnpm-lock.yaml

@@ -561,7 +561,7 @@ packages:
   '@trieb.work/nextjs-turbo-redis-cache@file:../../..':
     resolution: {directory: ../../.., type: directory}
     peerDependencies:
-      next: '>=15.0.3 <16.3.0'
+      next: '>=15.0.3 <17.0.0'
       redis: 4.7.0
 
   '@tybys/wasm-util@0.10.1':

package/test/nextjs-test-projects/next-app-16-0-11-cache-components/pnpm-lock.yaml

@@ -568,7 +568,7 @@ packages:
   '@trieb.work/nextjs-turbo-redis-cache@file:../../..':
     resolution: {directory: ../../.., type: directory}
     peerDependencies:
-      next: '>=15.0.3 <16.3.0'
+      next: '>=15.0.3 <17.0.0'
       redis: 4.7.0
 
   '@tybys/wasm-util@0.10.2':

package/test/nextjs-test-projects/next-app-16-2-6/pnpm-lock.yaml

@@ -561,7 +561,7 @@ packages:
   '@trieb.work/nextjs-turbo-redis-cache@file:../../..':
     resolution: {directory: ../../.., type: directory}
     peerDependencies:
-      next: '>=15.0.3 <16.3.0'
+      next: '>=15.0.3 <17.0.0'
       redis: 4.7.0
 
   '@tybys/wasm-util@0.10.1':

package/test/nextjs-test-projects/next-app-16-2-6-cache-components/pnpm-lock.yaml

@@ -561,7 +561,7 @@ packages:
   '@trieb.work/nextjs-turbo-redis-cache@file:../../..':
     resolution: {directory: ../../.., type: directory}
     peerDependencies:
-      next: '>=15.0.3 <16.3.0'
+      next: '>=15.0.3 <17.0.0'
       redis: 4.7.0
 
   '@tybys/wasm-util@0.10.1':

package/test/nextjs-test-projects/next-app-16-3-0/README.md

@@ -0,0 +1,36 @@
+This is a [Next.js](https://nextjs.org) project bootstrapped with [`create-next-app`](https://nextjs.org/docs/app/api-reference/cli/create-next-app).
+
+## Getting Started
+
+First, run the development server:
+
+```bash
+npm run dev
+# or
+yarn dev
+# or
+pnpm dev
+# or
+bun dev
+```
+
+Open [http://localhost:3000](http://localhost:3000) with your browser to see the result.
+
+You can start editing the page by modifying `app/page.tsx`. The page auto-updates as you edit the file.
+
+This project uses [`next/font`](https://nextjs.org/docs/app/building-your-application/optimizing/fonts) to automatically optimize and load [Geist](https://vercel.com/font), a new font family for Vercel.
+
+## Learn More
+
+To learn more about Next.js, take a look at the following resources:
+
+- [Next.js Documentation](https://nextjs.org/docs) - learn about Next.js features and API.
+- [Learn Next.js](https://nextjs.org/learn) - an interactive Next.js tutorial.
+
+You can check out [the Next.js GitHub repository](https://github.com/vercel/next.js) - your feedback and contributions are welcome!
+
+## Deploy on Vercel
+
+The easiest way to deploy your Next.js app is to use the [Vercel Platform](https://vercel.com/new?utm_medium=default-template&filter=next.js&utm_source=create-next-app&utm_campaign=create-next-app-readme) from the creators of Next.js.
+
+Check out our [Next.js deployment documentation](https://nextjs.org/docs/app/building-your-application/deploying) for more details.

package/test/nextjs-test-projects/next-app-16-3-0/eslint.config.mjs

@@ -0,0 +1,18 @@
+import { defineConfig, globalIgnores } from "eslint/config";
+import nextVitals from "eslint-config-next/core-web-vitals";
+import nextTs from "eslint-config-next/typescript";
+
+const eslintConfig = defineConfig([
+  ...nextVitals,
+  ...nextTs,
+  // Override default ignores of eslint-config-next.
+  globalIgnores([
+    // Default ignores of eslint-config-next:
+    ".next/**",
+    "out/**",
+    "build/**",
+    "next-env.d.ts",
+  ]),
+]);
+
+export default eslintConfig;

package/test/nextjs-test-projects/next-app-16-3-0/next.config.ts

@@ -0,0 +1,7 @@
+import type { NextConfig } from 'next';
+
+const nextConfig: NextConfig = {
+  cacheHandler: require.resolve('@trieb.work/nextjs-turbo-redis-cache'),
+};
+
+export default nextConfig;

package/test/nextjs-test-projects/next-app-16-3-0/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "next-app-16-3-0",
+  "version": "0.1.0",
+  "private": true,
+  "scripts": {
+    "dev": "next dev",
+    "build": "next build",
+    "start": "next start",
+    "lint": "eslint"
+  },
+  "dependencies": {
+    "next": "16.3.0",
+    "react": "19.2.0",
+    "react-dom": "19.2.0",
+    "redis": "4.7.0",
+    "@trieb.work/nextjs-turbo-redis-cache": "file:../../../"
+  },
+  "devDependencies": {
+    "@tailwindcss/postcss": "^4",
+    "@types/node": "^20",
+    "@types/react": "^19",
+    "@types/react-dom": "^19",
+    "eslint": "^9",
+    "eslint-config-next": "16.3.0",
+    "tailwindcss": "^4",
+    "typescript": "^5"
+  }
+}