@vercel/build-utils 13.27.2 → 13.28.0

package/CHANGELOG.md

@@ -1,5 +1,15 @@
 # @vercel/build-utils
 
+## 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

@@ -35577,12 +35577,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";

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.27.2",
+  "version": "13.28.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",