@netlify/plugin-nextjs 5.10.0 → 5.10.2

package/dist/build/plugin-context.js

@@ -5,12 +5,298 @@
       })();
     
 import {
-  EDGE_HANDLER_NAME,
-  PluginContext,
-  SERVER_HANDLER_NAME
-} from "../esm-chunks/chunk-GFYWJNQR.js";
-import "../esm-chunks/chunk-APO262HE.js";
-import "../esm-chunks/chunk-OEQOKJGE.js";
+  require_semver
+} from "../esm-chunks/chunk-APO262HE.js";
+import {
+  __toESM
+} from "../esm-chunks/chunk-OEQOKJGE.js";
+
+// src/build/plugin-context.ts
+var import_semver = __toESM(require_semver(), 1);
+import { existsSync, readFileSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { createRequire } from "node:module";
+import { join, relative, resolve } from "node:path";
+import { join as posixJoin } from "node:path/posix";
+import { fileURLToPath } from "node:url";
+var MODULE_DIR = fileURLToPath(new URL(".", import.meta.url));
+var PLUGIN_DIR = join(MODULE_DIR, "../..");
+var DEFAULT_PUBLISH_DIR = ".next";
+var SERVER_HANDLER_NAME = "___netlify-server-handler";
+var EDGE_HANDLER_NAME = "___netlify-edge-handler";
+var PluginContext = class {
+  featureFlags;
+  netlifyConfig;
+  pluginName;
+  pluginVersion;
+  utils;
+  constants;
+  packageJSON;
+  /** Absolute path of the next runtime plugin directory */
+  pluginDir = PLUGIN_DIR;
+  get relPublishDir() {
+    return this.constants.PUBLISH_DIR ?? join(this.constants.PACKAGE_PATH || "", DEFAULT_PUBLISH_DIR);
+  }
+  /** Temporary directory for stashing the build output */
+  get tempPublishDir() {
+    return this.resolveFromPackagePath(".netlify/.next");
+  }
+  /** Absolute path of the publish directory */
+  get publishDir() {
+    return resolve(this.relPublishDir);
+  }
+  /**
+   * Relative package path in non monorepo setups this is an empty string
+   * This path is provided by Next.js RequiredServerFiles manifest
+   * @example ''
+   * @example 'apps/my-app'
+   */
+  get relativeAppDir() {
+    return this.requiredServerFiles.relativeAppDir ?? "";
+  }
+  /**
+   * The working directory inside the lambda that is used for monorepos to execute the serverless function
+   */
+  get lambdaWorkingDirectory() {
+    return join("/var/task", this.distDirParent);
+  }
+  /**
+   * Retrieves the root of the `.next/standalone` directory
+   */
+  get standaloneRootDir() {
+    return join(this.publishDir, "standalone");
+  }
+  /**
+   * The resolved relative next dist directory defaults to `.next`,
+   * but can be configured through the next.config.js. For monorepos this will include the packagePath
+   * If we need just the plain dist dir use the `nextDistDir`
+   */
+  get distDir() {
+    const dir = this.buildConfig.distDir ?? DEFAULT_PUBLISH_DIR;
+    return relative(process.cwd(), resolve(this.relativeAppDir, dir));
+  }
+  /** Represents the parent directory of the .next folder or custom distDir */
+  get distDirParent() {
+    return join(this.distDir, "..");
+  }
+  /** The `.next` folder or what the custom dist dir is set to */
+  get nextDistDir() {
+    return relative(this.distDirParent, this.distDir);
+  }
+  /** Retrieves the `.next/standalone/` directory monorepo aware */
+  get standaloneDir() {
+    return join(this.standaloneRootDir, this.distDirParent);
+  }
+  /**
+   * Absolute path of the directory that is published and deployed to the Netlify CDN
+   * Will be swapped with the publish directory
+   * `.netlify/static`
+   */
+  get staticDir() {
+    return this.resolveFromPackagePath(".netlify/static");
+  }
+  /**
+   * Absolute path of the directory that will be deployed to the blob store
+   * region aware: `.netlify/deploy/v1/blobs/deploy`
+   * default: `.netlify/blobs/deploy`
+   */
+  get blobDir() {
+    if (this.useRegionalBlobs) {
+      return this.resolveFromPackagePath(".netlify/deploy/v1/blobs/deploy");
+    }
+    return this.resolveFromPackagePath(".netlify/blobs/deploy");
+  }
+  get buildVersion() {
+    return this.constants.NETLIFY_BUILD_VERSION || "v0.0.0";
+  }
+  get useRegionalBlobs() {
+    const REQUIRED_BUILD_VERSION = ">=29.41.5";
+    return (0, import_semver.satisfies)(this.buildVersion, REQUIRED_BUILD_VERSION, { includePrerelease: true });
+  }
+  /**
+   * Absolute path of the directory containing the files for the serverless lambda function
+   * `.netlify/functions-internal`
+   */
+  get serverFunctionsDir() {
+    return this.resolveFromPackagePath(".netlify/functions-internal");
+  }
+  /** Absolute path of the server handler */
+  get serverHandlerRootDir() {
+    return join(this.serverFunctionsDir, SERVER_HANDLER_NAME);
+  }
+  get serverHandlerDir() {
+    if (this.relativeAppDir.length === 0) {
+      return this.serverHandlerRootDir;
+    }
+    return join(this.serverHandlerRootDir, this.distDirParent);
+  }
+  get serverHandlerRuntimeModulesDir() {
+    return join(this.serverHandlerDir, ".netlify");
+  }
+  get nextServerHandler() {
+    if (this.relativeAppDir.length !== 0) {
+      return join(this.lambdaWorkingDirectory, ".netlify/dist/run/handlers/server.js");
+    }
+    return "./.netlify/dist/run/handlers/server.js";
+  }
+  /**
+   * Absolute path of the directory containing the files for deno edge functions
+   * `.netlify/edge-functions`
+   */
+  get edgeFunctionsDir() {
+    return this.resolveFromPackagePath(".netlify/edge-functions");
+  }
+  /** Absolute path of the edge handler */
+  get edgeHandlerDir() {
+    return join(this.edgeFunctionsDir, EDGE_HANDLER_NAME);
+  }
+  constructor(options) {
+    this.constants = options.constants;
+    this.featureFlags = options.featureFlags;
+    this.netlifyConfig = options.netlifyConfig;
+    this.packageJSON = JSON.parse(readFileSync(join(PLUGIN_DIR, "package.json"), "utf-8"));
+    this.pluginName = this.packageJSON.name;
+    this.pluginVersion = this.packageJSON.version;
+    this.utils = options.utils;
+  }
+  /** Resolves a path correctly with mono repository awareness for .netlify directories mainly  */
+  resolveFromPackagePath(...args) {
+    return resolve(this.constants.PACKAGE_PATH || "", ...args);
+  }
+  /** Resolves a path correctly from site directory */
+  resolveFromSiteDir(...args) {
+    return resolve(this.requiredServerFiles.appDir, ...args);
+  }
+  /** Get the next prerender-manifest.json */
+  async getPrerenderManifest() {
+    return JSON.parse(await readFile(join(this.publishDir, "prerender-manifest.json"), "utf-8"));
+  }
+  /**
+   * Uses various heuristics to try to find the .next dir.
+   * Works by looking for BUILD_ID, so requires the site to have been built
+   */
+  findDotNext() {
+    for (const dir of [
+      // The publish directory
+      this.publishDir,
+      // In the root
+      resolve(DEFAULT_PUBLISH_DIR),
+      // The sibling of the publish directory
+      resolve(this.publishDir, "..", DEFAULT_PUBLISH_DIR),
+      // In the package dir
+      resolve(this.constants.PACKAGE_PATH || "", DEFAULT_PUBLISH_DIR)
+    ]) {
+      if (existsSync(join(dir, "BUILD_ID"))) {
+        return dir;
+      }
+    }
+    return false;
+  }
+  /**
+   * Get Next.js middleware config from the build output
+   */
+  async getMiddlewareManifest() {
+    return JSON.parse(
+      await readFile(join(this.publishDir, "server/middleware-manifest.json"), "utf-8")
+    );
+  }
+  // don't make private as it is handy inside testing to override the config
+  _requiredServerFiles = null;
+  /** Get RequiredServerFiles manifest from build output **/
+  get requiredServerFiles() {
+    if (!this._requiredServerFiles) {
+      let requiredServerFilesJson = join(this.publishDir, "required-server-files.json");
+      if (!existsSync(requiredServerFilesJson)) {
+        const dotNext = this.findDotNext();
+        if (dotNext) {
+          requiredServerFilesJson = join(dotNext, "required-server-files.json");
+        }
+      }
+      this._requiredServerFiles = JSON.parse(
+        readFileSync(requiredServerFilesJson, "utf-8")
+      );
+    }
+    return this._requiredServerFiles;
+  }
+  #exportDetail = null;
+  /** Get metadata when output = export */
+  get exportDetail() {
+    if (this.buildConfig.output !== "export") {
+      return null;
+    }
+    if (!this.#exportDetail) {
+      const detailFile = join(
+        this.requiredServerFiles.appDir,
+        this.buildConfig.distDir,
+        "export-detail.json"
+      );
+      if (!existsSync(detailFile)) {
+        return null;
+      }
+      try {
+        this.#exportDetail = JSON.parse(readFileSync(detailFile, "utf-8"));
+      } catch {
+      }
+    }
+    return this.#exportDetail;
+  }
+  /** Get Next Config from build output **/
+  get buildConfig() {
+    return this.requiredServerFiles.config;
+  }
+  /**
+   * Get Next.js routes manifest from the build output
+   */
+  async getRoutesManifest() {
+    return JSON.parse(await readFile(join(this.publishDir, "routes-manifest.json"), "utf-8"));
+  }
+  #nextVersion = void 0;
+  /**
+   * Get Next.js version that was used to build the site
+   */
+  get nextVersion() {
+    if (this.#nextVersion === void 0) {
+      try {
+        const serverHandlerRequire = createRequire(posixJoin(this.standaloneRootDir, ":internal:"));
+        const { version } = serverHandlerRequire("next/package.json");
+        this.#nextVersion = version;
+      } catch {
+        this.#nextVersion = null;
+      }
+    }
+    return this.#nextVersion;
+  }
+  #fallbacks = null;
+  /**
+   * Get an array of localized fallback routes
+   *
+   * Example return value for non-i18n site: `['blog/[slug]']`
+   *
+   * Example return value for i18n site: `['en/blog/[slug]', 'fr/blog/[slug]']`
+   */
+  getFallbacks(prerenderManifest) {
+    if (!this.#fallbacks) {
+      const locales = this.buildConfig.i18n?.locales ?? [""];
+      this.#fallbacks = Object.entries(prerenderManifest.dynamicRoutes).reduce(
+        (fallbacks, [route, meta]) => {
+          if (typeof meta.fallback === "string") {
+            for (const locale of locales) {
+              const localizedRoute = posixJoin(locale, route.replace(/^\/+/g, ""));
+              fallbacks.push(localizedRoute);
+            }
+          }
+          return fallbacks;
+        },
+        []
+      );
+    }
+    return this.#fallbacks;
+  }
+  /** Fails a build with a message and an optional error */
+  failBuild(message, error) {
+    return this.utils.build.failBuild(message, error instanceof Error ? { error } : void 0);
+  }
+};
 export {
   EDGE_HANDLER_NAME,
   PluginContext,

package/dist/build/verification.js

@@ -5,15 +5,110 @@
       })();
     
 import {
-  verifyAdvancedAPIRoutes,
-  verifyNetlifyForms,
-  verifyNetlifyFormsWorkaround,
-  verifyPublishDir
-} from "../esm-chunks/chunk-ZSVHJNNY.js";
-import "../esm-chunks/chunk-KGYJQ2U2.js";
-import "../esm-chunks/chunk-ZENB67PD.js";
-import "../esm-chunks/chunk-APO262HE.js";
-import "../esm-chunks/chunk-OEQOKJGE.js";
+  require_out
+} from "../esm-chunks/chunk-KGYJQ2U2.js";
+import {
+  require_semver
+} from "../esm-chunks/chunk-APO262HE.js";
+import {
+  __toESM
+} from "../esm-chunks/chunk-OEQOKJGE.js";
+
+// src/build/verification.ts
+var import_fast_glob = __toESM(require_out(), 1);
+var import_semver = __toESM(require_semver(), 1);
+import { existsSync } from "node:fs";
+import { readFile } from "node:fs/promises";
+import { join } from "node:path";
+import { ApiRouteType, getAPIRoutesConfigs } from "./advanced-api-routes.js";
+var SUPPORTED_NEXT_VERSIONS = ">=13.5.0";
+var verifications = /* @__PURE__ */ new Set();
+function verifyPublishDir(ctx) {
+  if (!existsSync(ctx.publishDir)) {
+    ctx.failBuild(
+      `Your publish directory was not found at: ${ctx.publishDir}. Please check your build settings`
+    );
+  }
+  if (ctx.publishDir === ctx.resolveFromPackagePath("")) {
+    ctx.failBuild(
+      `Your publish directory cannot be the same as the base directory of your site. Please check your build settings`
+    );
+  }
+  try {
+    ctx.buildConfig;
+  } catch {
+    ctx.failBuild(
+      "Your publish directory does not contain expected Next.js build output. Please check your build settings"
+    );
+  }
+  if (ctx.buildConfig.output === "standalone" || ctx.buildConfig.output === void 0) {
+    if (!existsSync(join(ctx.publishDir, "BUILD_ID"))) {
+      ctx.failBuild(
+        "Your publish directory does not contain expected Next.js build output. Please check your build settings"
+      );
+    }
+    if (!existsSync(ctx.standaloneRootDir)) {
+      ctx.failBuild(
+        `Your publish directory does not contain expected Next.js build output. Please make sure you are using Next.js version (${SUPPORTED_NEXT_VERSIONS})`
+      );
+    }
+    if (ctx.nextVersion && !(0, import_semver.satisfies)(ctx.nextVersion, SUPPORTED_NEXT_VERSIONS, { includePrerelease: true })) {
+      ctx.failBuild(
+        `@netlify/plugin-nextjs@5 requires Next.js version ${SUPPORTED_NEXT_VERSIONS}, but found ${ctx.nextVersion}. Please upgrade your project's Next.js version.`
+      );
+    }
+  }
+  if (ctx.buildConfig.output === "export") {
+    if (!ctx.exportDetail?.success) {
+      ctx.failBuild(`Your export failed to build. Please check your build settings`);
+    }
+    if (!existsSync(ctx.exportDetail?.outDirectory)) {
+      ctx.failBuild(
+        `Your export directory was not found at: ${ctx.exportDetail?.outDirectory}. Please check your build settings`
+      );
+    }
+  }
+}
+async function verifyAdvancedAPIRoutes(ctx) {
+  const apiRoutesConfigs = await getAPIRoutesConfigs(ctx);
+  const unsupportedAPIRoutes = apiRoutesConfigs.filter((apiRouteConfig) => {
+    return apiRouteConfig.config.type === ApiRouteType.BACKGROUND || apiRouteConfig.config.type === ApiRouteType.SCHEDULED;
+  });
+  if (unsupportedAPIRoutes.length !== 0) {
+    ctx.failBuild(
+      `@netlify/plugin-nextjs@5 does not support advanced API routes. The following API routes should be migrated to Netlify background or scheduled functions:
+${unsupportedAPIRoutes.map((apiRouteConfig) => ` - ${apiRouteConfig.apiRoute} (type: "${apiRouteConfig.config.type}")`).join("\n")}
+
+Refer to https://ntl.fyi/next-scheduled-bg-function-migration as migration example.`
+    );
+  }
+}
+var formDetectionRegex = /<form[^>]*?\s(netlify|data-netlify)[=>\s]/;
+async function verifyNetlifyFormsWorkaround(ctx) {
+  const srcDir = ctx.resolveFromSiteDir("public");
+  const paths = await (0, import_fast_glob.glob)("**/*.html", {
+    cwd: srcDir,
+    dot: true
+  });
+  try {
+    for (const path of paths) {
+      const html = await readFile(join(srcDir, path), "utf-8");
+      if (formDetectionRegex.test(html)) {
+        verifications.add("netlifyFormsWorkaround");
+        return;
+      }
+    }
+  } catch (error) {
+    ctx.failBuild("Failed verifying public files", error);
+  }
+}
+function verifyNetlifyForms(ctx, html) {
+  if (process.env.NETLIFY_NEXT_VERIFY_FORMS !== "0" && process.env.NETLIFY_NEXT_VERIFY_FORMS?.toUpperCase() !== "FALSE" && !verifications.has("netlifyFormsWorkaround") && formDetectionRegex.test(html)) {
+    ctx.failBuild(
+      "@netlify/plugin-nextjs@5 requires migration steps to support Netlify Forms. Refer to https://ntl.fyi/next-runtime-forms-migration for migration example."
+    );
+  }
+}
 export {
   verifyAdvancedAPIRoutes,
   verifyNetlifyForms,

package/dist/esm-chunks/{package-F536DQ6H.js → package-7HACW4PO.js}

@@ -8,7 +8,7 @@ import "./chunk-OEQOKJGE.js";
 
 // package.json
 var name = "@netlify/plugin-nextjs";
-var version = "5.10.0";
+var version = "5.10.2";
 var description = "Run Next.js seamlessly on Netlify";
 var main = "./dist/index.js";
 var type = "module";
@@ -56,15 +56,15 @@ var bugs = {
 };
 var homepage = "https://opennext.js.org/netlify";
 var devDependencies = {
-  "@fastly/http-compute-js": "1.1.4",
-  "@netlify/blobs": "^8.1.0",
-  "@netlify/build": "^29.55.4",
-  "@netlify/edge-bundler": "^12.2.3",
-  "@netlify/edge-functions": "^2.11.0",
+  "@fastly/http-compute-js": "1.1.5",
+  "@netlify/blobs": "^8.1.2",
+  "@netlify/build": "^30.1.0",
+  "@netlify/edge-bundler": "^12.4.0",
+  "@netlify/edge-functions": "^2.11.1",
   "@netlify/eslint-config-node": "^7.0.1",
-  "@netlify/functions": "^3.0.0",
-  "@netlify/serverless-functions-api": "^1.30.1",
-  "@netlify/zip-it-and-ship-it": "^9.41.0",
+  "@netlify/functions": "^3.0.4",
+  "@netlify/serverless-functions-api": "^1.36.0",
+  "@netlify/zip-it-and-ship-it": "^10.0.4",
   "@opentelemetry/api": "^1.8.0",
   "@opentelemetry/exporter-trace-otlp-http": "^0.51.0",
   "@opentelemetry/resources": "^1.24.0",
@@ -84,10 +84,11 @@ var devDependencies = {
   "fs-monkey": "^1.0.6",
   "get-port": "^7.1.0",
   "lambda-local": "^2.2.0",
+  "lru-cache": "^10.4.3",
   memfs: "^4.9.2",
   "mock-require": "^3.0.3",
   msw: "^2.0.7",
-  "netlify-cli": "^17.37.1",
+  "netlify-cli": "^19.1.4",
   next: "^15.0.0-canary.28",
   os: "^0.1.2",
   outdent: "^0.8.0",

package/dist/index.js

@@ -4,26 +4,6 @@
         return createRequire(import.meta.url);
       })();
     
-import {
-  copyPrerenderedContent
-} from "./esm-chunks/chunk-DLBTTDNJ.js";
-import {
-  copyStaticAssets,
-  copyStaticContent,
-  copyStaticExport,
-  publishStaticDir,
-  setHeadersConfig,
-  unpublishStaticDir
-} from "./esm-chunks/chunk-VTKZZRGT.js";
-import {
-  clearStaleEdgeHandlers,
-  createEdgeHandlers
-} from "./esm-chunks/chunk-3RQSTU2O.js";
-import {
-  clearStaleServerHandlers,
-  createServerHandler
-} from "./esm-chunks/chunk-DLVROEVU.js";
-import "./esm-chunks/chunk-IJZEDP6B.js";
 import {
   wrapTracer
 } from "./esm-chunks/chunk-5QSXBV7L.js";
@@ -31,31 +11,30 @@ import {
   init_esm,
   trace
 } from "./esm-chunks/chunk-GNGHTHMQ.js";
-import {
-  restoreBuildCache,
-  saveBuildCache
-} from "./esm-chunks/chunk-72ZI2IVI.js";
-import {
-  setImageConfig
-} from "./esm-chunks/chunk-AMY4NOT5.js";
-import {
-  PluginContext
-} from "./esm-chunks/chunk-GFYWJNQR.js";
-import {
-  verifyAdvancedAPIRoutes,
-  verifyNetlifyFormsWorkaround,
-  verifyPublishDir
-} from "./esm-chunks/chunk-ZSVHJNNY.js";
-import "./esm-chunks/chunk-KGYJQ2U2.js";
-import "./esm-chunks/chunk-ZENB67PD.js";
-import "./esm-chunks/chunk-APO262HE.js";
-import "./esm-chunks/chunk-TYCYFZ22.js";
-import "./esm-chunks/chunk-UYKENJEU.js";
 import "./esm-chunks/chunk-OEQOKJGE.js";
 
 // src/index.ts
 init_esm();
 import { rm } from "fs/promises";
+import { restoreBuildCache, saveBuildCache } from "./build/cache.js";
+import { copyPrerenderedContent } from "./build/content/prerendered.js";
+import {
+  copyStaticAssets,
+  copyStaticContent,
+  copyStaticExport,
+  publishStaticDir,
+  setHeadersConfig,
+  unpublishStaticDir
+} from "./build/content/static.js";
+import { clearStaleEdgeHandlers, createEdgeHandlers } from "./build/functions/edge.js";
+import { clearStaleServerHandlers, createServerHandler } from "./build/functions/server.js";
+import { setImageConfig } from "./build/image-cdn.js";
+import { PluginContext } from "./build/plugin-context.js";
+import {
+  verifyAdvancedAPIRoutes,
+  verifyNetlifyFormsWorkaround,
+  verifyPublishDir
+} from "./build/verification.js";
 var tracer = wrapTracer(trace.getTracer("Next.js runtime"));
 var onPreDev = async (options) => {
   await tracer.withActiveSpan("onPreDev", async () => {

package/dist/run/config.js

@@ -4,16 +4,14 @@
         return createRequire(import.meta.url);
       })();
     
-import {
-  PLUGIN_DIR,
-  RUN_CONFIG
-} from "../esm-chunks/chunk-UYKENJEU.js";
 import "../esm-chunks/chunk-OEQOKJGE.js";
 
 // src/run/config.ts
 import { existsSync } from "node:fs";
 import { readFile } from "node:fs/promises";
 import { join, resolve } from "node:path";
+import { PLUGIN_DIR, RUN_CONFIG } from "./constants.js";
+import { setInMemoryCacheMaxSizeFromNextConfig } from "./storage/storage.cjs";
 var getRunConfig = async () => {
   return JSON.parse(await readFile(resolve(PLUGIN_DIR, RUN_CONFIG), "utf-8"));
 };
@@ -24,12 +22,13 @@ var setRunConfig = (config) => {
   }
   config.experimental = {
     ...config.experimental,
-    // @ts-expect-error incrementalCacheHandlerPath was removed from config type
-    // but we still need to set it for older Next.js versions
+    // Before Next.js 14.1.0 path to the cache handler was in experimental section, see NextConfigForMultipleVersions type
     incrementalCacheHandlerPath: cacheHandler
   };
   config.cacheHandler = cacheHandler;
-  config.cacheMaxMemorySize = 0;
+  setInMemoryCacheMaxSizeFromNextConfig(
+    config.cacheMaxMemorySize ?? config.experimental?.isrMemoryCacheSize
+  );
   process.env.__NEXT_PRIVATE_STANDALONE_CONFIG = JSON.stringify(config);
 };
 export {

package/dist/run/constants.js

@@ -4,12 +4,14 @@
         return createRequire(import.meta.url);
       })();
     
-import {
-  MODULE_DIR,
-  PLUGIN_DIR,
-  RUN_CONFIG
-} from "../esm-chunks/chunk-UYKENJEU.js";
 import "../esm-chunks/chunk-OEQOKJGE.js";
+
+// src/run/constants.ts
+import { resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+var MODULE_DIR = fileURLToPath(new URL(".", import.meta.url));
+var PLUGIN_DIR = resolve(`${MODULE_DIR}../../..`);
+var RUN_CONFIG = "run-config.json";
 export {
   MODULE_DIR,
   PLUGIN_DIR,