@vercel/build-utils 13.27.2 → 13.29.0

package/CHANGELOG.md

@@ -1,5 +1,25 @@
 # @vercel/build-utils
 
+## 13.29.0
+
+### Minor Changes
+
+- 8d8e871: Evaluate the `maxDuration` upper bound at validation time so `VERCEL_CLI_SKIP_MAX_DURATION_LIMIT` works regardless of import order.
+
+  The gate was read when `@vercel/build-utils`' `functionsSchema` was constructed and when the CLI compiled its `vercel.json` validator — both at module load. Any process that imports these modules before setting the env var baked in the default 900-second maximum and ignored the flag, failing with `Invalid vercel.json - functions[...].maxDuration should be <= 900`.
+
+  `@vercel/build-utils` now exposes `getFunctionsSchema()`, which reads the limit at call time (the existing `functionsSchema` const is kept but deprecated). The CLI builds and compiles its config validator lazily, caching one validator per resolved limit, so setting the variable after import takes effect. Default behavior is unchanged — the 900s maximum, the lower bound, and the integer check are all still enforced when the variable is unset.
+
+## 13.28.0
+
+### Minor Changes
+
+- 4e849dd: Add a per-route `hasPostponed` signal to `Prerender`.
+
+  `@vercel/build-utils` exposes a new optional `hasPostponed?: boolean` field on `Prerender` / `PrerenderOptions`. It is a tri-state: `true` when the route's `.meta` postponed state is present (React suspended during the build-time prerender), `false` when the framework prerendered a Prerender route without postponing, and `undefined` when the framework did not provide the signal.
+
+  `@vercel/next` populates it for app-router PPR routes (computed from the route's postponed state) and leaves it `undefined` for pages-router and other non-app-router prerenders. This is an additive, finer-grained signal — it does not change the existing `chain` / `experimentalStreamingLambdaPath` behavior — so downstream consumers can distinguish a route that actually postponed from one that has PPR machinery but fully prerendered (e.g. under `cacheComponents: true`).
+
 ## 13.27.2
 
 ### Patch Changes

package/dist/index.js

@@ -34562,6 +34562,7 @@ __export(src_exports, {
   getEncryptedEnv: () => getEncryptedEnv,
   getEnvForPackageManager: () => getEnvForPackageManager,
   getExperimentalServiceUrlEnvVars: () => getExperimentalServiceUrlEnvVars,
+  getFunctionsSchema: () => getFunctionsSchema,
   getIgnoreFilter: () => get_ignore_filter_default,
   getInstalledPackageVersion: () => getInstalledPackageVersion,
   getInternalServiceCronPath: () => getInternalServiceCronPath,
@@ -35577,12 +35578,19 @@ var Prerender = class {
     experimentalStreamingLambdaPath,
     chain,
     exposeErrBody,
-    partialFallback
+    partialFallback,
+    hasPostponed
   }) {
     this.type = "Prerender";
     this.expiration = expiration;
     this.staleExpiration = staleExpiration;
     this.sourcePath = sourcePath;
+    if (hasPostponed !== void 0 && typeof hasPostponed !== "boolean") {
+      throw new Error(
+        "The `hasPostponed` argument for `Prerender` must be a boolean or undefined."
+      );
+    }
+    this.hasPostponed = hasPostponed;
     this.lambda = lambda;
     if (this.lambda) {
       this.lambda.operationType = this.lambda.operationType || "ISR";
@@ -38344,7 +38352,7 @@ var triggerEventSchemaV2 = {
 var triggerEventSchema = {
   oneOf: [triggerEventSchemaV1, triggerEventSchemaV2]
 };
-var functionsSchema = {
+var getFunctionsSchema = () => ({
   type: "object",
   minProperties: 1,
   maxProperties: 50,
@@ -38397,7 +38405,8 @@ var functionsSchema = {
       }
     }
   }
-};
+});
+var functionsSchema = getFunctionsSchema();
 var buildsSchema = {
   type: "array",
   minItems: 0,
@@ -40609,6 +40618,7 @@ function getExtendedPayload({
   getEncryptedEnv,
   getEnvForPackageManager,
   getExperimentalServiceUrlEnvVars,
+  getFunctionsSchema,
   getIgnoreFilter,
   getInstalledPackageVersion,
   getInternalServiceCronPath,

package/dist/prerender.d.ts

@@ -18,6 +18,7 @@ interface PrerenderOptions {
     chain?: Chain;
     exposeErrBody?: boolean;
     partialFallback?: boolean;
+    hasPostponed?: boolean;
 }
 export declare class Prerender {
     type: 'Prerender';
@@ -47,6 +48,13 @@ export declare class Prerender {
     chain?: Chain;
     exposeErrBody?: boolean;
     partialFallback?: boolean;
-    constructor({ expiration, staleExpiration, lambda, fallback, group, bypassToken, allowQuery, allowHeader, initialHeaders, initialStatus, passQuery, sourcePath, experimentalBypassFor, experimentalStreamingLambdaPath, chain, exposeErrBody, partialFallback, }: PrerenderOptions);
+    /**
+     * Set to `true` when the route's `.meta` postponed state is present (React
+     * suspended during build prerender). `false` when the framework prerendered
+     * a Prerender route without postponing. `undefined` when the framework did
+     * not provide the signal.
+     */
+    hasPostponed?: boolean;
+    constructor({ expiration, staleExpiration, lambda, fallback, group, bypassToken, allowQuery, allowHeader, initialHeaders, initialStatus, passQuery, sourcePath, experimentalBypassFor, experimentalStreamingLambdaPath, chain, exposeErrBody, partialFallback, hasPostponed, }: PrerenderOptions);
 }
 export {};

package/dist/prerender.js

@@ -39,12 +39,19 @@ class Prerender {
     experimentalStreamingLambdaPath,
     chain,
     exposeErrBody,
-    partialFallback
+    partialFallback,
+    hasPostponed
   }) {
     this.type = "Prerender";
     this.expiration = expiration;
     this.staleExpiration = staleExpiration;
     this.sourcePath = sourcePath;
+    if (hasPostponed !== void 0 && typeof hasPostponed !== "boolean") {
+      throw new Error(
+        "The `hasPostponed` argument for `Prerender` must be a boolean or undefined."
+      );
+    }
+    this.hasPostponed = hasPostponed;
     this.lambda = lambda;
     if (this.lambda) {
       this.lambda.operationType = this.lambda.operationType || "ISR";

package/dist/schemas.d.ts

@@ -1,3 +1,105 @@
+export declare const getFunctionsSchema: () => {
+    type: string;
+    minProperties: number;
+    maxProperties: number;
+    additionalProperties: boolean;
+    patternProperties: {
+        '^.{1,256}$': {
+            type: string;
+            additionalProperties: boolean;
+            properties: {
+                architecture: {
+                    type: string;
+                    enum: string[];
+                };
+                runtime: {
+                    type: string;
+                    maxLength: number;
+                };
+                memory: {
+                    minimum: number;
+                    maximum: number;
+                };
+                maxDuration: {
+                    oneOf: ({
+                        maximum?: number | undefined;
+                        type: string;
+                        minimum: number;
+                        enum?: undefined;
+                    } | {
+                        type: string;
+                        enum: string[];
+                    })[];
+                };
+                regions: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                functionFailoverRegions: {
+                    type: string;
+                    items: {
+                        type: string;
+                    };
+                };
+                includeFiles: {
+                    type: string;
+                    maxLength: number;
+                };
+                excludeFiles: {
+                    type: string;
+                    maxLength: number;
+                };
+                experimentalTriggers: {
+                    type: string;
+                    items: {
+                        oneOf: {
+                            type: string;
+                            properties: {
+                                type: {
+                                    type: string;
+                                    const: string;
+                                };
+                                topic: {
+                                    type: string;
+                                    minLength: number;
+                                };
+                                maxDeliveries: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                retryAfterSeconds: {
+                                    type: string;
+                                    exclusiveMinimum: number;
+                                };
+                                initialDelaySeconds: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                                maxConcurrency: {
+                                    type: string;
+                                    minimum: number;
+                                };
+                            };
+                            required: string[];
+                            additionalProperties: boolean;
+                        }[];
+                    };
+                };
+                supportsCancellation: {
+                    type: string;
+                };
+            };
+        };
+    };
+};
+/**
+ * @deprecated Evaluated once at module load, so it does not reflect
+ * `VERCEL_CLI_SKIP_MAX_DURATION_LIMIT` when the variable is set after this
+ * module is first imported. Prefer {@link getFunctionsSchema}, which reads the
+ * limit at call time.
+ */
 export declare const functionsSchema: {
     type: string;
     minProperties: number;

package/dist/schemas.js

@@ -20,6 +20,7 @@ var schemas_exports = {};
 __export(schemas_exports, {
   buildsSchema: () => buildsSchema,
   functionsSchema: () => functionsSchema,
+  getFunctionsSchema: () => getFunctionsSchema,
   packageManifestSchema: () => packageManifestSchema
 });
 module.exports = __toCommonJS(schemas_exports);
@@ -93,7 +94,7 @@ const triggerEventSchemaV2 = {
 const triggerEventSchema = {
   oneOf: [triggerEventSchemaV1, triggerEventSchemaV2]
 };
-const functionsSchema = {
+const getFunctionsSchema = () => ({
   type: "object",
   minProperties: 1,
   maxProperties: 50,
@@ -146,7 +147,8 @@ const functionsSchema = {
       }
     }
   }
-};
+});
+const functionsSchema = getFunctionsSchema();
 const buildsSchema = {
   type: "array",
   minItems: 0,
@@ -249,5 +251,6 @@ const packageManifestSchema = {
 0 && (module.exports = {
   buildsSchema,
   functionsSchema,
+  getFunctionsSchema,
   packageManifestSchema
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.27.2",
+  "version": "13.29.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -55,7 +55,7 @@
     "vitest": "2.0.1",
     "typescript": "4.9.5",
     "yazl": "2.5.1",
-    "@vercel/routing-utils": "6.2.0",
+    "@vercel/routing-utils": "6.3.0",
     "@vercel/error-utils": "2.2.0"
   },
   "scripts": {