@vercel/build-utils 13.8.1 → 13.10.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # @vercel/build-utils
 
+## 13.10.0
+
+### Minor Changes
+
+- [services] support multiple topics for a single worker service ([#15615](https://github.com/vercel/vercel/pull/15615))
+
+- [services] support for specifying an env prefix for each service ([#15641](https://github.com/vercel/vercel/pull/15641))
+
+- Simplify python runtime by always passing in app variable ([#15635](https://github.com/vercel/vercel/pull/15635))
+
+### Patch Changes
+
+- Namespace diagnostics keys by builder and service workspace, and aggregate per-builder `package-manifest.json` files into a single `project-manifest.json` ([#15399](https://github.com/vercel/vercel/pull/15399))
+
+- Updated dependencies [[`ac87d5a5ef5d79b55765e094efc957de987d7ac4`](https://github.com/vercel/vercel/commit/ac87d5a5ef5d79b55765e094efc957de987d7ac4), [`25a6a2daa46baba6e8d7dec90eb49213b8150b8c`](https://github.com/vercel/vercel/commit/25a6a2daa46baba6e8d7dec90eb49213b8150b8c)]:
+  - @vercel/python-analysis@0.11.0
+
+## 13.9.0
+
+### Minor Changes
+
+- Ensure django static files are copied in build output. ([#15557](https://github.com/vercel/vercel/pull/15557))
+
+## 13.8.2
+
+### Patch Changes
+
+- [services] allow services to share builder source ([#15631](https://github.com/vercel/vercel/pull/15631))
+
+- Updated dependencies [[`8e8110d2eca5832e109f5efb64b192690100927d`](https://github.com/vercel/vercel/commit/8e8110d2eca5832e109f5efb64b192690100927d)]:
+  - @vercel/python-analysis@0.10.1
+
 ## 13.8.1
 
 ### Patch Changes

package/dist/framework-helpers.d.ts

@@ -18,8 +18,11 @@ export type BackendFramework = (typeof BACKEND_FRAMEWORKS)[number];
 export type PythonFramework = (typeof PYTHON_FRAMEWORKS)[number];
 /**
  * Checks if the given framework is a backend framework
+ * TODO: make this function generic to all runtimes' backend frameworks and
+ * update callers to use isNodeBackendFramework for Node-specific frameworks.
  */
 export declare function isBackendFramework(framework: string | null | undefined): framework is BackendFramework;
+export declare function isNodeBackendFramework(framework: string | null | undefined): framework is BackendFramework;
 export declare function isPythonFramework(framework: string | null | undefined): framework is (typeof PYTHON_FRAMEWORKS)[number];
 export declare function isExperimentalBackendsWithoutIntrospectionEnabled(): boolean;
 export declare function isExperimentalBackendsEnabled(): boolean;

package/dist/framework-helpers.js

@@ -27,6 +27,7 @@ __export(framework_helpers_exports, {
   isBackendFramework: () => isBackendFramework,
   isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled: () => isExperimentalBackendsWithoutIntrospectionEnabled,
+  isNodeBackendFramework: () => isNodeBackendFramework,
   isPythonFramework: () => isPythonFramework,
   shouldUseExperimentalBackends: () => shouldUseExperimentalBackends
 });
@@ -63,6 +64,11 @@ function isBackendFramework(framework) {
     return false;
   return BACKEND_FRAMEWORKS.includes(framework);
 }
+function isNodeBackendFramework(framework) {
+  if (!framework)
+    return false;
+  return BACKEND_FRAMEWORKS.includes(framework);
+}
 function isPythonFramework(framework) {
   if (!framework)
     return false;
@@ -97,6 +103,7 @@ function shouldUseExperimentalBackends(framework) {
   isBackendFramework,
   isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled,
+  isNodeBackendFramework,
   isPythonFramework,
   shouldUseExperimentalBackends
 });

package/dist/get-service-url-env-vars.d.ts

@@ -12,6 +12,7 @@ export interface GetServiceUrlEnvVarsOptions {
     currentEnv?: Envs;
     deploymentUrl?: string;
     origin?: string;
+    envPrefix?: string;
 }
 /**
  * Generate environment variables for service URLs.

package/dist/get-service-url-env-vars.js

@@ -48,7 +48,8 @@ function getServiceUrlEnvVars(options) {
     frameworkList,
     currentEnv = {},
     deploymentUrl,
-    origin
+    origin,
+    envPrefix
   } = options;
   const baseUrl = origin || deploymentUrl;
   if (!baseUrl || !services || services.length === 0) {
@@ -72,11 +73,12 @@ function getServiceUrlEnvVars(options) {
       service.routePrefix,
       !!origin
     );
-    if (!(baseEnvVarName in currentEnv)) {
-      envVars[baseEnvVarName] = absoluteUrl;
+    const effectiveBaseEnvVarName = envPrefix ? `${envPrefix}${baseEnvVarName}` : baseEnvVarName;
+    if (!(effectiveBaseEnvVarName in currentEnv)) {
+      envVars[effectiveBaseEnvVarName] = absoluteUrl;
     }
     for (const prefix of frameworkPrefixes) {
-      const prefixedEnvVarName = `${prefix}${baseEnvVarName}`;
+      const prefixedEnvVarName = envPrefix ? `${prefix}${envPrefix}${baseEnvVarName}` : `${prefix}${baseEnvVarName}`;
       if (!(prefixedEnvVarName in currentEnv)) {
         envVars[prefixedEnvVarName] = service.routePrefix;
       }

package/dist/index.d.ts

@@ -34,5 +34,5 @@ export { NODE_VERSIONS } from './fs/node-version';
 export { getInstalledPackageVersion } from './get-installed-package-version';
 export { defaultCachePathGlob } from './default-cache-path-glob';
 export { generateNodeBuilderFunctions } from './generate-node-builder-functions';
-export { BACKEND_FRAMEWORKS, BACKEND_BUILDERS, UNIFIED_BACKEND_BUILDER, BackendFramework, isBackendFramework, isBackendBuilder, isExperimentalBackendsEnabled, isExperimentalBackendsWithoutIntrospectionEnabled, shouldUseExperimentalBackends, PYTHON_FRAMEWORKS, PythonFramework, isPythonFramework, } from './framework-helpers';
+export { BACKEND_FRAMEWORKS, BACKEND_BUILDERS, UNIFIED_BACKEND_BUILDER, BackendFramework, isBackendFramework, isNodeBackendFramework, isBackendBuilder, isExperimentalBackendsEnabled, isExperimentalBackendsWithoutIntrospectionEnabled, shouldUseExperimentalBackends, PYTHON_FRAMEWORKS, PythonFramework, isPythonFramework, } from './framework-helpers';
 export * from './python';

package/dist/index.js

@@ -21869,6 +21869,7 @@ __export(src_exports, {
   getSpawnOptions: () => getSpawnOptions,
   getSupportedBunVersion: () => getSupportedBunVersion,
   getSupportedNodeVersion: () => getSupportedNodeVersion,
+  getWorkerTopics: () => getWorkerTopics,
   getWriteableDirectory: () => getWritableDirectory,
   glob: () => glob,
   hardLinkDir: () => hardLinkDir,
@@ -21879,10 +21880,12 @@ __export(src_exports, {
   isDirectory: () => isDirectory,
   isExperimentalBackendsEnabled: () => isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled: () => isExperimentalBackendsWithoutIntrospectionEnabled,
+  isNodeBackendFramework: () => isNodeBackendFramework,
   isPythonEntrypoint: () => isPythonEntrypoint,
   isPythonFramework: () => isPythonFramework,
   isSymbolicLink: () => isSymbolicLink,
   normalizePath: () => normalizePath,
+  packageManifestSchema: () => packageManifestSchema,
   readConfigFile: () => readConfigFile,
   rename: () => rename,
   resetCustomInstallCommandSet: () => resetCustomInstallCommandSet,
@@ -23077,6 +23080,9 @@ var NodeVersion = class extends Version {
 };
 var BunVersion = class extends Version {
 };
+function getWorkerTopics(config) {
+  return config.topics?.length ? config.topics : ["default"];
+}
 
 // src/fs/node-version.ts
 var NODE_VERSIONS = [
@@ -24481,7 +24487,8 @@ function getServiceUrlEnvVars(options) {
     frameworkList,
     currentEnv = {},
     deploymentUrl,
-    origin
+    origin,
+    envPrefix
   } = options;
   const baseUrl = origin || deploymentUrl;
   if (!baseUrl || !services || services.length === 0) {
@@ -24505,11 +24512,12 @@ function getServiceUrlEnvVars(options) {
       service.routePrefix,
       !!origin
     );
-    if (!(baseEnvVarName in currentEnv)) {
-      envVars[baseEnvVarName] = absoluteUrl;
+    const effectiveBaseEnvVarName = envPrefix ? `${envPrefix}${baseEnvVarName}` : baseEnvVarName;
+    if (!(effectiveBaseEnvVarName in currentEnv)) {
+      envVars[effectiveBaseEnvVarName] = absoluteUrl;
     }
     for (const prefix of frameworkPrefixes) {
-      const prefixedEnvVarName = `${prefix}${baseEnvVarName}`;
+      const prefixedEnvVarName = envPrefix ? `${prefix}${envPrefix}${baseEnvVarName}` : `${prefix}${baseEnvVarName}`;
       if (!(prefixedEnvVarName in currentEnv)) {
         envVars[prefixedEnvVarName] = service.routePrefix;
       }
@@ -24825,6 +24833,73 @@ var buildsSchema = {
     }
   }
 };
+var packageManifestSchema = {
+  type: "object",
+  required: ["runtime", "dependencies"],
+  additionalProperties: false,
+  properties: {
+    version: {
+      type: "string",
+      description: 'Manifest schema version, e.g. "20260304".'
+    },
+    runtime: {
+      type: "string",
+      description: 'Runtime identifier, e.g. "python", "node".'
+    },
+    runtimeVersion: {
+      type: "object",
+      additionalProperties: false,
+      required: ["resolved"],
+      properties: {
+        requested: {
+          type: "string",
+          description: 'Version constraint from the project manifest, e.g. ">=3.10".'
+        },
+        requestedSource: {
+          type: "string",
+          description: 'File that declared the constraint, e.g. "pyproject.toml".'
+        },
+        resolved: {
+          type: "string",
+          description: 'Actual resolved version, e.g. "3.12".'
+        }
+      }
+    },
+    dependencies: {
+      type: "array",
+      items: {
+        type: "object",
+        required: ["name", "type", "scopes", "resolved"],
+        additionalProperties: false,
+        properties: {
+          name: { type: "string" },
+          type: { type: "string", enum: ["direct", "transitive", "peer"] },
+          scopes: {
+            type: "array",
+            items: { type: "string" },
+            description: 'Dependency groups this package belongs to, e.g. ["main", "dev"].'
+          },
+          requested: {
+            type: "string",
+            description: 'Version specifier as declared, e.g. "flask>=2.0".'
+          },
+          resolved: {
+            type: "string",
+            description: 'Resolved version, e.g. "3.1.0".'
+          },
+          source: {
+            type: "string",
+            description: 'Package source type, e.g. "registry", "git", "path".'
+          },
+          sourceUrl: {
+            type: "string",
+            description: 'Source URL, e.g. "https://pypi.org".'
+          }
+        }
+      }
+    }
+  }
+};
 
 // src/trace/trace.ts
 var import_node_crypto = require("crypto");
@@ -25111,6 +25186,11 @@ function isBackendFramework(framework) {
     return false;
   return BACKEND_FRAMEWORKS.includes(framework);
 }
+function isNodeBackendFramework(framework) {
+  if (!framework)
+    return false;
+  return BACKEND_FRAMEWORKS.includes(framework);
+}
 function isPythonFramework(framework) {
   if (!framework)
     return false;
@@ -25144,7 +25224,7 @@ async function isPythonEntrypoint(file) {
     if (!fsPath)
       return false;
     const content = await import_fs3.default.promises.readFile(fsPath, "utf-8");
-    return await (0, import_python_analysis.containsAppOrHandler)(content);
+    return await (0, import_python_analysis.findAppOrHandler)(content) !== null;
   } catch (err) {
     debug(`Failed to check Python entrypoint: ${err}`);
     return false;
@@ -25204,6 +25284,7 @@ async function isPythonEntrypoint(file) {
   getSpawnOptions,
   getSupportedBunVersion,
   getSupportedNodeVersion,
+  getWorkerTopics,
   getWriteableDirectory,
   glob,
   hardLinkDir,
@@ -25214,10 +25295,12 @@ async function isPythonEntrypoint(file) {
   isDirectory,
   isExperimentalBackendsEnabled,
   isExperimentalBackendsWithoutIntrospectionEnabled,
+  isNodeBackendFramework,
   isPythonEntrypoint,
   isPythonFramework,
   isSymbolicLink,
   normalizePath,
+  packageManifestSchema,
   readConfigFile,
   rename,
   resetCustomInstallCommandSet,

package/dist/python.js

@@ -40,7 +40,7 @@ async function isPythonEntrypoint(file) {
     if (!fsPath)
       return false;
     const content = await import_fs.default.promises.readFile(fsPath, "utf-8");
-    return await (0, import_python_analysis.containsAppOrHandler)(content);
+    return await (0, import_python_analysis.findAppOrHandler)(content) !== null;
   } catch (err) {
     (0, import_debug.default)(`Failed to check Python entrypoint: ${err}`);
     return false;

package/dist/schemas.d.ts

@@ -121,3 +121,83 @@ export declare const buildsSchema: {
         };
     };
 };
+/**
+ * JSON Schema for builder-produced `package-manifest.json` files.
+ *
+ * Each builder (e.g. @vercel/python) may emit a `package-manifest.json`
+ * in its diagnostics output.
+ */
+export declare const packageManifestSchema: {
+    readonly type: "object";
+    readonly required: readonly ["runtime", "dependencies"];
+    readonly additionalProperties: false;
+    readonly properties: {
+        readonly version: {
+            readonly type: "string";
+            readonly description: "Manifest schema version, e.g. \"20260304\".";
+        };
+        readonly runtime: {
+            readonly type: "string";
+            readonly description: "Runtime identifier, e.g. \"python\", \"node\".";
+        };
+        readonly runtimeVersion: {
+            readonly type: "object";
+            readonly additionalProperties: false;
+            readonly required: readonly ["resolved"];
+            readonly properties: {
+                readonly requested: {
+                    readonly type: "string";
+                    readonly description: "Version constraint from the project manifest, e.g. \">=3.10\".";
+                };
+                readonly requestedSource: {
+                    readonly type: "string";
+                    readonly description: "File that declared the constraint, e.g. \"pyproject.toml\".";
+                };
+                readonly resolved: {
+                    readonly type: "string";
+                    readonly description: "Actual resolved version, e.g. \"3.12\".";
+                };
+            };
+        };
+        readonly dependencies: {
+            readonly type: "array";
+            readonly items: {
+                readonly type: "object";
+                readonly required: readonly ["name", "type", "scopes", "resolved"];
+                readonly additionalProperties: false;
+                readonly properties: {
+                    readonly name: {
+                        readonly type: "string";
+                    };
+                    readonly type: {
+                        readonly type: "string";
+                        readonly enum: readonly ["direct", "transitive", "peer"];
+                    };
+                    readonly scopes: {
+                        readonly type: "array";
+                        readonly items: {
+                            readonly type: "string";
+                        };
+                        readonly description: "Dependency groups this package belongs to, e.g. [\"main\", \"dev\"].";
+                    };
+                    readonly requested: {
+                        readonly type: "string";
+                        readonly description: "Version specifier as declared, e.g. \"flask>=2.0\".";
+                    };
+                    readonly resolved: {
+                        readonly type: "string";
+                        readonly description: "Resolved version, e.g. \"3.1.0\".";
+                    };
+                    readonly source: {
+                        readonly type: "string";
+                        readonly description: "Package source type, e.g. \"registry\", \"git\", \"path\".";
+                    };
+                    readonly sourceUrl: {
+                        readonly type: "string";
+                        readonly description: "Source URL, e.g. \"https://pypi.org\".";
+                    };
+                };
+            };
+        };
+    };
+};

package/dist/schemas.js

@@ -19,7 +19,8 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var schemas_exports = {};
 __export(schemas_exports, {
   buildsSchema: () => buildsSchema,
-  functionsSchema: () => functionsSchema
+  functionsSchema: () => functionsSchema,
+  packageManifestSchema: () => packageManifestSchema
 });
 module.exports = __toCommonJS(schemas_exports);
 const triggerEventSchemaV1 = {
@@ -173,8 +174,76 @@ const buildsSchema = {
     }
   }
 };
+const packageManifestSchema = {
+  type: "object",
+  required: ["runtime", "dependencies"],
+  additionalProperties: false,
+  properties: {
+    version: {
+      type: "string",
+      description: 'Manifest schema version, e.g. "20260304".'
+    },
+    runtime: {
+      type: "string",
+      description: 'Runtime identifier, e.g. "python", "node".'
+    },
+    runtimeVersion: {
+      type: "object",
+      additionalProperties: false,
+      required: ["resolved"],
+      properties: {
+        requested: {
+          type: "string",
+          description: 'Version constraint from the project manifest, e.g. ">=3.10".'
+        },
+        requestedSource: {
+          type: "string",
+          description: 'File that declared the constraint, e.g. "pyproject.toml".'
+        },
+        resolved: {
+          type: "string",
+          description: 'Actual resolved version, e.g. "3.12".'
+        }
+      }
+    },
+    dependencies: {
+      type: "array",
+      items: {
+        type: "object",
+        required: ["name", "type", "scopes", "resolved"],
+        additionalProperties: false,
+        properties: {
+          name: { type: "string" },
+          type: { type: "string", enum: ["direct", "transitive", "peer"] },
+          scopes: {
+            type: "array",
+            items: { type: "string" },
+            description: 'Dependency groups this package belongs to, e.g. ["main", "dev"].'
+          },
+          requested: {
+            type: "string",
+            description: 'Version specifier as declared, e.g. "flask>=2.0".'
+          },
+          resolved: {
+            type: "string",
+            description: 'Resolved version, e.g. "3.1.0".'
+          },
+          source: {
+            type: "string",
+            description: 'Package source type, e.g. "registry", "git", "path".'
+          },
+          sourceUrl: {
+            type: "string",
+            description: 'Source URL, e.g. "https://pypi.org".'
+          }
+        }
+      }
+    }
+  }
+};
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   buildsSchema,
-  functionsSchema
+  functionsSchema,
+  packageManifestSchema
 });

package/dist/types.d.ts

@@ -108,6 +108,10 @@ export interface BuildOptions {
      * multi-service project.
      */
     service?: {
+        /** The service name as declared in the project configuration. */
+        name?: string;
+        /** The service type (e.g., "web", "cron", "worker"). */
+        type?: ServiceType;
         /** URL path prefix where the service is mounted (e.g., "/api"). */
         routePrefix?: string;
         /** Optional subdomain this service is mounted on (e.g., "api"). */
@@ -382,6 +386,14 @@ export interface ProjectSettings {
     gitForkProtection?: boolean;
     commandForIgnoringBuildStep?: string | null;
 }
+export interface BuilderVX {
+    version: -1;
+    build: BuildVX;
+    diagnostics?: Diagnostics;
+    prepareCache?: PrepareCache;
+    shouldServe?: ShouldServe;
+    startDevServer?: StartDevServer;
+}
 export interface BuilderV2 {
     version: 2;
     build: BuildV2;
@@ -489,9 +501,17 @@ export interface Service {
     subdomain?: string;
     schedule?: string;
     handlerFunction?: string;
-    topic?: string;
+    topics?: string[];
     consumer?: string;
+    /** custom prefix to inject service URL env vars */
+    envPrefix?: string;
 }
+/**
+ * Returns the topics a worker service subscribes to, defaulting to ['default'].
+ */
+export declare function getWorkerTopics(config: {
+    topics?: string[];
+}): [string, ...string[]];
 /** The framework which created the function */
 export interface FunctionFramework {
     slug: string;
@@ -526,11 +546,19 @@ export interface BuildResultV2Typical {
      */
     deploymentId?: string;
 }
+export type BuildResultVX = {
+    resultVersion: 2;
+    result: BuildResultV2;
+} | {
+    resultVersion: 3;
+    result: BuildResultV3;
+};
 export type BuildResultV2 = BuildResultV2Typical | BuildResultBuildOutput;
 export interface BuildResultV3 {
     routes?: any[];
     output: Lambda | EdgeFunction;
 }
+export type BuildVX = (options: BuildOptions) => Promise<BuildResultVX>;
 export type BuildV2 = (options: BuildOptions) => Promise<BuildResultV2>;
 export type BuildV3 = (options: BuildOptions) => Promise<BuildResultV3>;
 export type PrepareCache = (options: PrepareCacheOptions) => Promise<Files>;
@@ -662,8 +690,10 @@ export interface ExperimentalServiceConfig {
     subdomain?: string;
     /** Cron schedule expression (e.g., "0 0 * * *") */
     schedule?: string;
-    topic?: string;
+    topics?: string[];
     consumer?: string;
+    /** Custom prefix to use to inject service URL env vars */
+    envPrefix?: string;
 }
 /**
  * Map of service name to service configuration.

package/dist/types.js

@@ -20,7 +20,8 @@ var types_exports = {};
 __export(types_exports, {
   BunVersion: () => BunVersion,
   NodeVersion: () => NodeVersion,
-  Version: () => Version
+  Version: () => Version,
+  getWorkerTopics: () => getWorkerTopics
 });
 module.exports = __toCommonJS(types_exports);
 class Version {
@@ -47,9 +48,13 @@ class NodeVersion extends Version {
 }
 class BunVersion extends Version {
 }
+function getWorkerTopics(config) {
+  return config.topics?.length ? config.topics : ["default"];
+}
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BunVersion,
   NodeVersion,
-  Version
+  Version,
+  getWorkerTopics
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.8.1",
+  "version": "13.10.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -11,7 +11,7 @@
     "directory": "packages/now-build-utils"
   },
   "dependencies": {
-    "@vercel/python-analysis": "0.10.0"
+    "@vercel/python-analysis": "0.11.0"
   },
   "devDependencies": {
     "@iarna/toml": "2.2.3",
@@ -51,7 +51,7 @@
     "vitest": "2.0.1",
     "json5": "2.2.3",
     "@vercel/error-utils": "2.0.3",
-    "@vercel/routing-utils": "6.0.2"
+    "@vercel/routing-utils": "6.1.1"
   },
   "scripts": {
     "build": "node build.mjs",