feat: Generate static redirects for simple Next.js redirects

This change introduces the ability to generate static Netlify redirects for a subset of Next.js redirects defined in `next.config.js`. This offloads simple redirects to Netlify's edge, reducing function invocations and improving performance.

The new `setRedirectsConfig` function handles simple redirects, including those with placeholders and splats, by converting them to the Netlify redirect format.

Complex redirects that use `has`, `missing`, or regex-based sources will continue to be handled by the serverless function at runtime.

Unit tests have been added to verify the redirect generation logic. An E2E test has also been added to ensure that simple redirects are handled by the edge, while complex redirects are correctly passed to the serverless function. The E2E test uses the `debug-x-nf-function-type` header to differentiate between edge-handled and function-handled responses.

The E2E test has been refactored to have separate, descriptively named tests for each redirect case to improve readability and maintainability.

Author: google-labs-jules[bot]

src/build/redirects.test.ts

@@ -1,6 +1,6 @@
 import type { NetlifyPluginOptions } from '@netlify/build'
 import type { RoutesManifest } from 'next/dist/build/index.js'
-import { beforeEach, describe, expect, test, vi, type TestContext } from 'vitest'
+import { beforeEach, describe, expect, test, type TestContext, vi } from 'vitest'
 
 import { PluginContext } from './plugin-context.js'
 import { setRedirectsConfig } from './redirects.js'

src/build/redirects.ts

@@ -4,17 +4,15 @@ import type { PluginContext } from './plugin-context.js'
 
 // These are the characters that are not allowed in a simple redirect source.
 // They are all special characters in a regular expression.
+// eslint-disable-next-line unicorn/better-regex, no-useless-escape
 const DISALLOWED_SOURCE_CHARACTERS = /[()\[\]{}?+|]/
 const SPLAT_REGEX = /\/:(\w+)\*$/
 
 /**
  * Adds redirects from the Next.js routes manifest to the Netlify config.
  */
 export const setRedirectsConfig = async (ctx: PluginContext): Promise<void> => {
-  const {
-    redirects,
-    basePath,
-  } = await ctx.getRoutesManifest()
+  const { redirects, basePath } = await ctx.getRoutesManifest()
 
   for (const redirect of redirects) {
     // We can only handle simple redirects that don't have complex conditions.
@@ -32,7 +30,7 @@ export const setRedirectsConfig = async (ctx: PluginContext): Promise<void> => {
 
     const splatMatch = from.match(SPLAT_REGEX)
     if (splatMatch) {
-      const param = splatMatch[1]
+      const [, param] = splatMatch
       from = from.replace(SPLAT_REGEX, '/*')
       to = to.replace(`/:${param}`, '/:splat')
     }

src/index.ts

@@ -18,6 +18,7 @@ import { clearStaleEdgeHandlers, createEdgeHandlers } from './build/functions/ed
 import { clearStaleServerHandlers, createServerHandler } from './build/functions/server.js'
 import { setImageConfig } from './build/image-cdn.js'
 import { PluginContext } from './build/plugin-context.js'
+import { setRedirectsConfig } from './build/redirects.js'
 import {
   verifyAdvancedAPIRoutes,
   verifyNetlifyFormsWorkaround,
@@ -99,6 +100,7 @@ export const onBuild = async (options: NetlifyPluginOptions) => {
       createEdgeHandlers(ctx),
       setHeadersConfig(ctx),
       setImageConfig(ctx),
+      setRedirectsConfig(ctx),
     ])
   })
 }