test: stabilize CI integration tests (#78)

* test: isolate BUILD_ID prefix test by copying app to temp dir and linking local package

* test: add delay before TTL check to ensure background sync completes

* test: allow non-frozen install in temp build-id integration app

* ci: split build-id integration test into dedicated job

Author: JannikZed

.github/workflows/ci.yml

@@ -76,7 +76,7 @@ jobs:
         run: cd test/integration/${{ matrix.next-test-app }} && pnpm build
 
       - name: Run tests
-        run: pnpm test
+        run: pnpm test:ci
         env:
           SKIP_BUILD: true
           NEXT_TEST_APP: ${{ matrix.next-test-app }}
@@ -121,3 +121,50 @@ jobs:
           NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }} # NPM token for publishing
         run: |
           npx semantic-release --dry-run
+
+  build-id-prefix:
+    runs-on: ubuntu-latest
+    permissions:
+      contents: read
+    steps:
+      - name: Checkout code
+        uses: actions/checkout@v6
+
+      - name: Install pnpm
+        run: corepack enable
+
+      - name: Setup Node.js
+        uses: actions/setup-node@v6
+        with:
+          node-version: '22'
+          cache: 'pnpm'
+
+      - name: Install dependencies
+        run: pnpm install --ignore-scripts
+
+      - name: Run lint
+        run: pnpm lint
+
+      - name: Build project
+        run: pnpm build
+
+      - name: Start Redis
+        uses: supercharge/redis-github-action@1.8.0
+        with:
+          redis-version: '7'
+          redis-port: 6379
+
+      - name: Install redis-cli
+        run: sudo apt-get update && sudo apt-get install -y redis-tools
+
+      - name: Configure Redis Keyspace Notifications
+        run: redis-cli config set notify-keyspace-events Exe
+
+      - name: Install Integration Test Project
+        run: cd test/integration/next-app-15-4-7 && pnpm install
+
+      - name: Build Integration Test Project
+        run: cd test/integration/next-app-15-4-7 && pnpm build
+
+      - name: Run BUILD_ID integration test
+        run: pnpm test:integration:build-id-prefix

README.md

@@ -226,6 +226,13 @@ To run all tests you can use the following command:
 pnpm build && pnpm test
 ```
 
+For CI, we use dedicated scripts:
+
+```bash
+pnpm test:ci
+pnpm test:integration:build-id-prefix
+```
+
 Folder layout / runners:
 
 - **Vitest** (unit + integration) lives in `src/**/*.test.ts(x)` and `test/**`.
@@ -248,6 +255,12 @@ To run integration tests you can use the following command:
 pnpm build && pnpm test:integration
 ```
 
+To run the BUILD_ID integration test independently:
+
+```bash
+pnpm build && pnpm test:integration:build-id-prefix
+```
+
 ### E2E tests (Playwright)
 
 To run Playwright tests (`tests/**`) you can use:

package.json

@@ -16,6 +16,8 @@
     "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/integration/nextjs-cache-handler.integration.test.ts

@@ -618,6 +618,7 @@ describe('Next.js Turbo Redis Cache Integration', () => {
         });
 
         it('Redis should have a key for the page which should have a TTL set to 28 days (2 * 14 days default revalidate time)', async () => {
+          await delay(REDIS_BACKGROUND_SYNC_DELAY);
           // check Redis keys
           const ttl = await redisClient.ttl(
             process.env.VERCEL_URL + '/pages/no-fetch/default-page',