@vercel/build-utils 14.2.0 → 14.4.0

package/dist/prerender.d.ts

@@ -1,17 +1,25 @@
 import type { File, HasField, Chain } from './types';
 import { Lambda } from './lambda';
 /**
- * The framework's own description of what it prerendered, mirroring the
- * Next.js prerender taxonomy rather than re-deriving it from build artifacts.
+ * The framework's own description of what it prerendered at build time,
+ * rather than re-deriving it from build artifacts. These are *initial*
+ * values: revalidation can regenerate a route's output over the lifetime of
+ * a deployment, so readers must treat them as the state as of the build,
+ * not as live state.
  */
-export interface PrerenderClassification {
-    /** What kind of entry this is within its route group. */
-    routeType: 'route' | 'page' | 'shell' | 'fallback';
-    /** How much of the response the prerender contains. */
-    response: 'empty' | 'initial' | 'complete';
-    /** What has to happen at request time to finish the response. */
+export interface PrerenderInitialMetadata {
+    /**
+     * What has to happen at request time to finish the response, as of build
+     * time: `static` needs no server compute, `resuming` streams the static
+     * response while the server resumes postponed work, and `blocking` cannot
+     * start the response until request-time compute starts.
+     */
     compute: 'blocking' | 'resuming' | 'static';
-    /** Byte size of the prerendered HTML shell, when the entry has one. */
+    /**
+     * Byte size of the prerendered HTML shell, when the entry has one. `0` is
+     * a real size — a shell that postponed everything — and `undefined` means
+     * there is no HTML shell to measure (route handlers, Pages Router).
+     */
     htmlSize?: number;
 }
 interface PrerenderOptions {
@@ -32,7 +40,7 @@ interface PrerenderOptions {
     chain?: Chain;
     exposeErrBody?: boolean;
     partialFallback?: boolean;
-    prerenderClassification?: PrerenderClassification;
+    initialMetadata?: PrerenderInitialMetadata;
 }
 export declare class Prerender {
     type: 'Prerender';
@@ -63,11 +71,12 @@ export declare class Prerender {
     exposeErrBody?: boolean;
     partialFallback?: boolean;
     /**
-     * The framework's classification of this prerender. `undefined` when the
-     * framework did not provide one, which is legitimate: not-found routes and
-     * Pages Router `fallback: false` templates have no classification.
+     * The framework's build-time serving metadata for this prerender.
+     * `undefined` when the framework did not provide it, which is legitimate:
+     * not-found routes, Pages Router `fallback: false` templates, and builds
+     * from frameworks that predate the field carry none.
      */
-    prerenderClassification?: PrerenderClassification;
-    constructor({ expiration, staleExpiration, lambda, fallback, group, bypassToken, allowQuery, allowHeader, initialHeaders, initialStatus, passQuery, sourcePath, experimentalBypassFor, experimentalStreamingLambdaPath, chain, exposeErrBody, partialFallback, prerenderClassification, }: PrerenderOptions);
+    initialMetadata?: PrerenderInitialMetadata;
+    constructor({ expiration, staleExpiration, lambda, fallback, group, bypassToken, allowQuery, allowHeader, initialHeaders, initialStatus, passQuery, sourcePath, experimentalBypassFor, experimentalStreamingLambdaPath, chain, exposeErrBody, partialFallback, initialMetadata, }: PrerenderOptions);
 }
 export {};

package/dist/prerender.js

@@ -40,13 +40,13 @@ class Prerender {
     chain,
     exposeErrBody,
     partialFallback,
-    prerenderClassification
+    initialMetadata
   }) {
     this.type = "Prerender";
     this.expiration = expiration;
     this.staleExpiration = staleExpiration;
     this.sourcePath = sourcePath;
-    this.prerenderClassification = prerenderClassification;
+    this.initialMetadata = initialMetadata;
     this.lambda = lambda;
     if (this.lambda) {
       this.lambda.operationType = this.lambda.operationType || "ISR";

package/dist/service-path-utils.d.ts

@@ -11,3 +11,5 @@ export declare const INTERNAL_SERVICE_PREFIX = "/_svc";
 export declare function getInternalServiceFunctionPath(serviceName: string): string;
 export declare function getInternalServiceCronPathPrefix(serviceName: string): string;
 export declare function getInternalServiceCronPath(serviceName: string, entrypoint: string, handler?: string): string;
+export declare function getInternalServiceWorkerPathPrefix(serviceName: string): string;
+export declare function getInternalServiceWorkerPath(serviceName: string, entrypoint: string, handler?: string): string;

package/dist/service-path-utils.js

@@ -21,7 +21,9 @@ __export(service_path_utils_exports, {
   INTERNAL_SERVICE_PREFIX: () => INTERNAL_SERVICE_PREFIX,
   getInternalServiceCronPath: () => getInternalServiceCronPath,
   getInternalServiceCronPathPrefix: () => getInternalServiceCronPathPrefix,
-  getInternalServiceFunctionPath: () => getInternalServiceFunctionPath
+  getInternalServiceFunctionPath: () => getInternalServiceFunctionPath,
+  getInternalServiceWorkerPath: () => getInternalServiceWorkerPath,
+  getInternalServiceWorkerPathPrefix: () => getInternalServiceWorkerPathPrefix
 });
 module.exports = __toCommonJS(service_path_utils_exports);
 const INTERNAL_SERVICE_PREFIX = "/_svc";
@@ -39,10 +41,19 @@ function getInternalServiceCronPath(serviceName, entrypoint, handler = "cron") {
   const normalizedEntrypoint = normalizeInternalServiceEntrypoint(entrypoint);
   return `${getInternalServiceCronPathPrefix(serviceName)}/${normalizedEntrypoint}/${handler}`;
 }
+function getInternalServiceWorkerPathPrefix(serviceName) {
+  return `${INTERNAL_SERVICE_PREFIX}/${serviceName}/workers`;
+}
+function getInternalServiceWorkerPath(serviceName, entrypoint, handler = "worker") {
+  const normalizedEntrypoint = normalizeInternalServiceEntrypoint(entrypoint);
+  return `${getInternalServiceWorkerPathPrefix(serviceName)}/${normalizedEntrypoint}/${handler}`;
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   INTERNAL_SERVICE_PREFIX,
   getInternalServiceCronPath,
   getInternalServiceCronPathPrefix,
-  getInternalServiceFunctionPath
+  getInternalServiceFunctionPath,
+  getInternalServiceWorkerPath,
+  getInternalServiceWorkerPathPrefix
 });

package/dist/types.d.ts

@@ -321,6 +321,14 @@ export declare namespace PackageJson {
         pnpm?: string;
         bun?: string;
     }
+    interface DevEnginePackageManager {
+        name?: string;
+        version?: string;
+        onFail?: 'download' | 'error' | 'warn' | 'ignore';
+    }
+    interface DevEngines {
+        packageManager?: DevEnginePackageManager | DevEnginePackageManager[];
+    }
     interface PublishConfig {
         registry?: string;
     }
@@ -359,6 +367,7 @@ export interface PackageJson {
     readonly optionalDependencies?: PackageJson.DependencyMap;
     readonly bundledDependencies?: string[];
     readonly engines?: PackageJson.Engines;
+    readonly devEngines?: PackageJson.DevEngines;
     readonly os?: string[];
     readonly cpu?: string[];
     readonly preferGlobal?: boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "14.2.0",
+  "version": "14.4.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -52,8 +52,8 @@
     "vitest": "4.1.10",
     "typescript": "4.9.5",
     "yazl": "2.5.1",
-    "@vercel/routing-utils": "6.5.0",
-    "@vercel/error-utils": "2.2.1"
+    "@vercel/error-utils": "2.2.1",
+    "@vercel/routing-utils": "6.5.0"
   },
   "scripts": {
     "build": "node build.mjs",