@vercel/build-utils 13.25.0 → 13.26.1

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # @vercel/build-utils
 
+## 13.26.1
+
+### Patch Changes
+
+- fa25cb7: Fix config.framework in deserializeBuildOutput
+- 972cc84: Support workflow-triggered job services in queue infrastructure
+
+  Add `isWorkflowTriggeredService()` and `isQueueBackedService()` helpers so workflow services
+  are recognized by the queue broker, dev server, and build pipeline. Update Python runtime to
+  bootstrap workflow services as queue-backed workers.
+
+## 13.26.0
+
+### Minor Changes
+
+- 137e5d1: Allow builder V2 to expose startDevServer.
+
+### Patch Changes
+
+- bb61428: Include framework slug in output/config.json
+
 ## 13.25.0
 
 ### Minor Changes

package/dist/deserialize/deserialize-build-output-types.d.ts

@@ -35,7 +35,7 @@ export type GroupLambdasOptions = {
 export type DeserializeBuildOutputLambda<TLambda extends Lambda> = (files: Files, config: SerializedLambda | SerializedNodejsLambda, repoRootPath: string, fileFsRefsCache: Map<string, FileFsRef>, options?: DeserializeBuildOutputLambdaOptions) => Promise<TLambda>;
 export type GroupLambdas<TLambda extends Lambda> = (lambdas: Record<string, TLambda>, options: GroupLambdasOptions) => Promise<Record<string, TLambda>>;
 export type InspectSerializedLambda = (path: string, config: SerializedLambda | SerializedNodejsLambda, repoRootPath: string, hasServerActions: boolean) => Promise<boolean>;
-export interface DeserializeBuildOutputOptions<TResult extends DeserializeBuildOutputResult = DeserializeBuildOutputResult, TLambda extends Lambda = Lambda> {
+export interface DeserializeBuildOutputOptions<TMeta = unknown, TLambda extends Lambda = Lambda> {
     outputDir: string;
     repoRootPath: string;
     maxBundleSizeMb?: number;
@@ -47,9 +47,7 @@ export interface DeserializeBuildOutputOptions<TResult extends DeserializeBuildO
     inspectSerializedLambda?: InspectSerializedLambda;
     warn?: (message: string) => void;
     includeDeploymentId?: boolean;
-    getMeta?: (hasServerActions: boolean) => TResult extends {
-        meta?: infer TMeta;
-    } ? TMeta : never;
+    getMeta?: (hasServerActions: boolean) => TMeta;
 }
 export type DeserializeBuildOutputFiles = BuildResultV2Typical['output'];
 export type DeserializeBuildOutputPrerenderFallback = Prerender['fallback'];

package/dist/deserialize/deserialize-build-output.d.ts

@@ -1,4 +1,4 @@
 import type { Lambda } from '../lambda';
-import type { DeserializeBuildOutputConfig, DeserializeBuildOutputOptions, DeserializeBuildOutputResult } from './deserialize-build-output-types';
+import type { DeserializeBuildOutputOptions, DeserializeBuildOutputResult } from './deserialize-build-output-types';
 export declare function validateDeploymentId(deploymentId?: string): void;
-export declare function deserializeBuildOutput<TConfig extends DeserializeBuildOutputConfig = DeserializeBuildOutputConfig, TResult extends DeserializeBuildOutputResult = DeserializeBuildOutputResult, TLambda extends Lambda = Lambda>(options: DeserializeBuildOutputOptions<TResult, TLambda>): Promise<TResult>;
+export declare function deserializeBuildOutput<TFlags = unknown, TMeta = unknown, TLambda extends Lambda = Lambda>(options: DeserializeBuildOutputOptions<TMeta, TLambda>): Promise<DeserializeBuildOutputResult<TFlags, TMeta>>;

package/dist/deserialize/deserialize-build-output.js

@@ -186,9 +186,7 @@ async function deserializeBuildOutput(options) {
     );
   }
   validateDeploymentId(config.deploymentId);
-  const flags = await (0, import_maybe_read_json.maybeReadJSON)(
-    (0, import_path.join)(outputDir, "flags.json")
-  );
+  const flags = await (0, import_maybe_read_json.maybeReadJSON)((0, import_path.join)(outputDir, "flags.json"));
   const staticDir = (0, import_path.join)(outputDir, "static");
   const output = await (0, import_glob.default)("**", {
     cwd: staticDir,
@@ -276,7 +274,7 @@ async function deserializeBuildOutput(options) {
     }
   );
   applyGroupedLambdas(output, groupedLambdas);
-  const framework = (0, import_validate_framework_version.validateFrameworkVersion)(config?.framework?.version);
+  const framework = (0, import_validate_framework_version.validateFrameworkVersion)(config?.framework);
   const meta = getMeta?.(hasServerActions);
   return {
     wildcard: config.wildcard,

package/dist/deserialize/validate-framework-version.d.ts

@@ -1,5 +1,6 @@
 type FrameworkMeta = {
+    slug: string;
     version: string;
 };
-export declare function validateFrameworkVersion(frameworkVersion: string | undefined): FrameworkMeta | undefined;
+export declare function validateFrameworkVersion(framework: FrameworkMeta | undefined): FrameworkMeta | undefined;
 export {};

package/dist/deserialize/validate-framework-version.js

@@ -22,30 +22,40 @@ __export(validate_framework_version_exports, {
 });
 module.exports = __toCommonJS(validate_framework_version_exports);
 var import_errors = require("../errors");
+const MAX_SLUG_LENGTH = 50;
 const MAX_FRAMEWORK_VERSION_LENGTH = 50;
-function validateFrameworkVersion(frameworkVersion) {
-  if (!frameworkVersion) {
+function validateFrameworkVersion(framework) {
+  if (!framework) {
     return void 0;
   }
-  if (typeof frameworkVersion !== "string") {
+  const { slug, version } = framework;
+  if (typeof slug !== "string") {
+    return void 0;
+  }
+  if (typeof version !== "string") {
     throw new import_errors.NowBuildError({
-      message: `Invalid config.json: "framework.version" type "${typeof frameworkVersion}" should be "string"`,
+      message: `Invalid config.json: "version" type "${typeof version}" should be "string"`,
       code: "VC_BUILD_INVALID_CONFIG_JSON_FRAMEWORK_VERSION_TYPE"
     });
   }
-  if (frameworkVersion.length > MAX_FRAMEWORK_VERSION_LENGTH) {
-    const trimmedFrameworkVersion = frameworkVersion.slice(
+  if (slug.length > MAX_SLUG_LENGTH) {
+    const trimmedFrameworkSlug = slug.slice(0, MAX_SLUG_LENGTH);
+    throw new import_errors.NowBuildError({
+      message: `Invalid config.json: "framework.slug" length ${slug.length} > ${MAX_SLUG_LENGTH}. "${trimmedFrameworkSlug}..."`,
+      code: "VC_BUILD_INVALID_CONFIG_JSON_FRAMEWORK_SLUG_LENGTH"
+    });
+  }
+  if (version.length > MAX_FRAMEWORK_VERSION_LENGTH) {
+    const trimmedFrameworkVersion = version.slice(
       0,
       MAX_FRAMEWORK_VERSION_LENGTH
     );
     throw new import_errors.NowBuildError({
-      message: `Invalid config.json: "framework.version" length ${frameworkVersion.length} > ${MAX_FRAMEWORK_VERSION_LENGTH}. "${trimmedFrameworkVersion}..."`,
+      message: `Invalid config.json: "framework.version" length ${version.length} > ${MAX_FRAMEWORK_VERSION_LENGTH}. "${trimmedFrameworkVersion}..."`,
       code: "VC_BUILD_INVALID_CONFIG_JSON_FRAMEWORK_VERSION_LENGTH"
     });
   }
-  return {
-    version: frameworkVersion
-  };
+  return framework;
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/dist/index.js

@@ -34586,10 +34586,12 @@ __export(src_exports, {
   isNodeEntrypoint: () => isNodeEntrypoint,
   isPythonEntrypoint: () => isPythonEntrypoint,
   isPythonFramework: () => isPythonFramework,
+  isQueueBackedService: () => isQueueBackedService,
   isQueueTriggeredService: () => isQueueTriggeredService,
   isRouteMiddleware: () => isRouteMiddleware,
   isScheduleTriggeredService: () => isScheduleTriggeredService,
   isSymbolicLink: () => isSymbolicLink,
+  isWorkflowTriggeredService: () => isWorkflowTriggeredService,
   manifestPath: () => manifestPath,
   maybeReadJSON: () => maybeReadJSON,
   md5: () => md5,
@@ -35824,6 +35826,12 @@ function isQueueTriggeredService(service) {
 function isScheduleTriggeredService(service) {
   return service.type === "cron" || service.type === "job" && service.trigger === "schedule";
 }
+function isWorkflowTriggeredService(service) {
+  return service.type === "job" && service.trigger === "workflow";
+}
+function isQueueBackedService(service) {
+  return isQueueTriggeredService(service) || isWorkflowTriggeredService(service);
+}
 function getReportedServiceType(service) {
   switch (service.type) {
     case "web":
@@ -39787,30 +39795,40 @@ function validateEnvWrapperSupport(encryptedEnvFilename, encryptedEnvContent, la
 }
 
 // src/deserialize/validate-framework-version.ts
+var MAX_SLUG_LENGTH = 50;
 var MAX_FRAMEWORK_VERSION_LENGTH = 50;
-function validateFrameworkVersion(frameworkVersion) {
-  if (!frameworkVersion) {
+function validateFrameworkVersion(framework) {
+  if (!framework) {
     return void 0;
   }
-  if (typeof frameworkVersion !== "string") {
+  const { slug, version } = framework;
+  if (typeof slug !== "string") {
+    return void 0;
+  }
+  if (typeof version !== "string") {
     throw new NowBuildError({
-      message: `Invalid config.json: "framework.version" type "${typeof frameworkVersion}" should be "string"`,
+      message: `Invalid config.json: "version" type "${typeof version}" should be "string"`,
       code: "VC_BUILD_INVALID_CONFIG_JSON_FRAMEWORK_VERSION_TYPE"
     });
   }
-  if (frameworkVersion.length > MAX_FRAMEWORK_VERSION_LENGTH) {
-    const trimmedFrameworkVersion = frameworkVersion.slice(
+  if (slug.length > MAX_SLUG_LENGTH) {
+    const trimmedFrameworkSlug = slug.slice(0, MAX_SLUG_LENGTH);
+    throw new NowBuildError({
+      message: `Invalid config.json: "framework.slug" length ${slug.length} > ${MAX_SLUG_LENGTH}. "${trimmedFrameworkSlug}..."`,
+      code: "VC_BUILD_INVALID_CONFIG_JSON_FRAMEWORK_SLUG_LENGTH"
+    });
+  }
+  if (version.length > MAX_FRAMEWORK_VERSION_LENGTH) {
+    const trimmedFrameworkVersion = version.slice(
       0,
       MAX_FRAMEWORK_VERSION_LENGTH
     );
     throw new NowBuildError({
-      message: `Invalid config.json: "framework.version" length ${frameworkVersion.length} > ${MAX_FRAMEWORK_VERSION_LENGTH}. "${trimmedFrameworkVersion}..."`,
+      message: `Invalid config.json: "framework.version" length ${version.length} > ${MAX_FRAMEWORK_VERSION_LENGTH}. "${trimmedFrameworkVersion}..."`,
       code: "VC_BUILD_INVALID_CONFIG_JSON_FRAMEWORK_VERSION_LENGTH"
     });
   }
-  return {
-    version: frameworkVersion
-  };
+  return framework;
 }
 
 // src/deserialize/hydrate-files-map.ts
@@ -40040,9 +40058,7 @@ async function deserializeBuildOutput(options) {
     );
   }
   validateDeploymentId(config.deploymentId);
-  const flags = await maybeReadJSON(
-    (0, import_path15.join)(outputDir, "flags.json")
-  );
+  const flags = await maybeReadJSON((0, import_path15.join)(outputDir, "flags.json"));
   const staticDir = (0, import_path15.join)(outputDir, "static");
   const output = await glob("**", {
     cwd: staticDir,
@@ -40130,7 +40146,7 @@ async function deserializeBuildOutput(options) {
     }
   );
   applyGroupedLambdas(output, groupedLambdas);
-  const framework = validateFrameworkVersion(config?.framework?.version);
+  const framework = validateFrameworkVersion(config?.framework);
   const meta = getMeta?.(hasServerActions);
   return {
     wildcard: config.wildcard,
@@ -40381,10 +40397,12 @@ function getExtendedPayload({
   isNodeEntrypoint,
   isPythonEntrypoint,
   isPythonFramework,
+  isQueueBackedService,
   isQueueTriggeredService,
   isRouteMiddleware,
   isScheduleTriggeredService,
   isSymbolicLink,
+  isWorkflowTriggeredService,
   manifestPath,
   maybeReadJSON,
   md5,

package/dist/types.d.ts

@@ -413,6 +413,7 @@ export interface BuilderV2 {
     diagnostics?: Diagnostics;
     prepareCache?: PrepareCache;
     shouldServe?: ShouldServe;
+    startDevServer?: StartDevServer;
 }
 export interface BuilderV3 {
     version: 3;
@@ -549,6 +550,15 @@ export declare function isScheduleTriggeredService(service: {
     type?: ServiceType;
     trigger?: JobTrigger;
 }): boolean;
+export declare function isWorkflowTriggeredService(service: {
+    type?: ServiceType;
+    trigger?: JobTrigger;
+}): boolean;
+/** Returns true for any service that consumes queue messages (worker, queue-triggered job, workflow-triggered job). */
+export declare function isQueueBackedService(service: {
+    type?: ServiceType;
+    trigger?: JobTrigger;
+}): boolean;
 export type ReportedServiceType = 'web' | 'schedule' | 'queue' | 'workflow';
 export declare function getReportedServiceType(service: {
     type?: ServiceType;
@@ -574,6 +584,7 @@ export interface BuildResultV2Typical {
         value: string;
     }>;
     framework?: {
+        slug: string;
         version: string;
     };
     flags?: {

package/dist/types.js

@@ -25,8 +25,10 @@ __export(types_exports, {
   getReportedServiceType: () => getReportedServiceType,
   getServiceQueueTopicConfigs: () => getServiceQueueTopicConfigs,
   getServiceQueueTopics: () => getServiceQueueTopics,
+  isQueueBackedService: () => isQueueBackedService,
   isQueueTriggeredService: () => isQueueTriggeredService,
-  isScheduleTriggeredService: () => isScheduleTriggeredService
+  isScheduleTriggeredService: () => isScheduleTriggeredService,
+  isWorkflowTriggeredService: () => isWorkflowTriggeredService
 });
 module.exports = __toCommonJS(types_exports);
 class Version {
@@ -69,6 +71,12 @@ function isQueueTriggeredService(service) {
 function isScheduleTriggeredService(service) {
   return service.type === "cron" || service.type === "job" && service.trigger === "schedule";
 }
+function isWorkflowTriggeredService(service) {
+  return service.type === "job" && service.trigger === "workflow";
+}
+function isQueueBackedService(service) {
+  return isQueueTriggeredService(service) || isWorkflowTriggeredService(service);
+}
 function getReportedServiceType(service) {
   switch (service.type) {
     case "web":
@@ -98,6 +106,8 @@ function getReportedServiceType(service) {
   getReportedServiceType,
   getServiceQueueTopicConfigs,
   getServiceQueueTopics,
+  isQueueBackedService,
   isQueueTriggeredService,
-  isScheduleTriggeredService
+  isScheduleTriggeredService,
+  isWorkflowTriggeredService
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.25.0",
+  "version": "13.26.1",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -55,8 +55,8 @@
     "vitest": "2.0.1",
     "typescript": "4.9.5",
     "yazl": "2.5.1",
-    "@vercel/error-utils": "2.1.0",
-    "@vercel/routing-utils": "6.2.0"
+    "@vercel/routing-utils": "6.2.0",
+    "@vercel/error-utils": "2.1.0"
   },
   "scripts": {
     "build": "node build.mjs",