@vercel/build-utils 13.17.0 → 13.18.0

package/dist/package-manifest.d.ts

@@ -0,0 +1,25 @@
+import type { Diagnostics } from './types';
+export interface PackageManifestDependency {
+    name: string;
+    type: 'direct' | 'transitive' | 'peer';
+    scopes: string[];
+    requested?: string;
+    resolved: string;
+    source?: string;
+    sourceUrl?: string;
+}
+export interface PackageManifest {
+    version?: string;
+    runtime: string;
+    runtimeVersion?: {
+        requested?: string;
+        requestedSource?: string;
+        resolved: string;
+    };
+    dependencies: PackageManifestDependency[];
+}
+export declare const MANIFEST_VERSION = "20260304";
+export declare const MANIFEST_FILENAME = "package-manifest.json";
+export declare function manifestPath(runtime: string): string;
+export declare function writeProjectManifest(manifest: PackageManifest, workPath: string, runtime: string): Promise<void>;
+export declare function createDiagnostics(runtime: string): Diagnostics;

package/dist/package-manifest.js

@@ -0,0 +1,71 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var package_manifest_exports = {};
+__export(package_manifest_exports, {
+  MANIFEST_FILENAME: () => MANIFEST_FILENAME,
+  MANIFEST_VERSION: () => MANIFEST_VERSION,
+  createDiagnostics: () => createDiagnostics,
+  manifestPath: () => manifestPath,
+  writeProjectManifest: () => writeProjectManifest
+});
+module.exports = __toCommonJS(package_manifest_exports);
+var import_fs = __toESM(require("fs"));
+var import_path = require("path");
+var import_file_blob = __toESM(require("./file-blob"));
+const MANIFEST_VERSION = "20260304";
+const MANIFEST_FILENAME = "package-manifest.json";
+function manifestPath(runtime) {
+  return (0, import_path.join)(".vercel", runtime, MANIFEST_FILENAME);
+}
+async function writeProjectManifest(manifest, workPath, runtime) {
+  const outPath = (0, import_path.join)(workPath, manifestPath(runtime));
+  await import_fs.default.promises.mkdir((0, import_path.dirname)(outPath), { recursive: true });
+  await import_fs.default.promises.writeFile(outPath, JSON.stringify(manifest, null, 2));
+}
+function createDiagnostics(runtime) {
+  return async ({ workPath }) => {
+    try {
+      const filePath = (0, import_path.join)(workPath, manifestPath(runtime));
+      const data = await import_fs.default.promises.readFile(filePath, "utf-8");
+      return {
+        [MANIFEST_FILENAME]: new import_file_blob.default({ data })
+      };
+    } catch {
+      return {};
+    }
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  MANIFEST_FILENAME,
+  MANIFEST_VERSION,
+  createDiagnostics,
+  manifestPath,
+  writeProjectManifest
+});

package/dist/types.d.ts

@@ -110,8 +110,10 @@ export interface BuildOptions {
     service?: {
         /** The service name as declared in the project configuration. */
         name?: string;
-        /** The service type (e.g., "web", "cron", "worker"). */
+        /** The service type (e.g., "web", "worker", "job"). */
         type?: ServiceType;
+        /** The job trigger type (e.g., "queue", "schedule", "workflow"). */
+        trigger?: JobTrigger;
         /** URL path prefix where the service is mounted (e.g., "/api"). */
         routePrefix?: string;
         /** Optional subdomain this service is mounted on (e.g., "api"). */
@@ -492,9 +494,18 @@ export interface Cron {
     path: string;
     schedule: string;
 }
+export interface ServiceQueueTopic {
+    topic: string;
+    retryAfterSeconds?: number;
+    initialDelaySeconds?: number;
+}
+export type ServiceTopics = string[] | ServiceQueueTopic[];
+export declare const JOB_TRIGGERS: readonly ["queue", "schedule", "workflow"];
+export type JobTrigger = (typeof JOB_TRIGGERS)[number];
 export interface Service {
     name: string;
     type: ServiceType;
+    trigger?: JobTrigger;
     group?: string;
     workspace: string;
     entrypoint?: string;
@@ -508,17 +519,27 @@ export interface Service {
     subdomain?: string;
     schedule?: string;
     handlerFunction?: string;
-    topics?: string[];
+    topics?: ServiceTopics;
     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[]];
+export declare function getServiceQueueTopicConfigs(config: {
+    type?: ServiceType;
+    topics?: ServiceTopics;
+}): ServiceQueueTopic[];
+export declare function getServiceQueueTopics(config: {
+    type?: ServiceType;
+    topics?: ServiceTopics;
+}): string[];
+export declare function isQueueTriggeredService(service: {
+    type?: ServiceType;
+    trigger?: JobTrigger;
+}): boolean;
+export declare function isScheduleTriggeredService(service: {
+    type?: ServiceType;
+    trigger?: JobTrigger;
+}): boolean;
 /** The framework which created the function */
 export interface FunctionFramework {
     slug: string;
@@ -666,7 +687,7 @@ export interface TriggerEvent extends TriggerEventBase {
     consumer: string;
 }
 export type ServiceRuntime = 'node' | 'python' | 'go' | 'rust' | 'ruby';
-export type ServiceType = 'web' | 'cron' | 'worker';
+export type ServiceType = 'web' | 'cron' | 'worker' | 'job';
 export interface ServiceMount {
     /** URL path prefix where the service is mounted. */
     path?: string;
@@ -679,6 +700,7 @@ export interface ServiceMount {
  */
 export interface ExperimentalServiceConfig {
     type?: ServiceType;
+    trigger?: JobTrigger;
     /**
      * Path to the service's root directory relative to the project root.
      * Should contain a manifest file (package.json, pyproject.toml, etc.).
@@ -711,9 +733,9 @@ export interface ExperimentalServiceConfig {
     routePrefix?: string;
     /** Subdomain this service should respond to (web services only). */
     subdomain?: string;
-    /** Cron schedule expression (e.g., "0 0 * * *") */
+    /** Cron schedule expression(s) (e.g., "0 0 * * *") */
     schedule?: string;
-    topics?: string[];
+    topics?: ServiceTopics;
     consumer?: string;
     /** Custom prefix to use to inject service URL env vars */
     envPrefix?: string;

package/dist/types.js

@@ -19,9 +19,13 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var types_exports = {};
 __export(types_exports, {
   BunVersion: () => BunVersion,
+  JOB_TRIGGERS: () => JOB_TRIGGERS,
   NodeVersion: () => NodeVersion,
   Version: () => Version,
-  getWorkerTopics: () => getWorkerTopics
+  getServiceQueueTopicConfigs: () => getServiceQueueTopicConfigs,
+  getServiceQueueTopics: () => getServiceQueueTopics,
+  isQueueTriggeredService: () => isQueueTriggeredService,
+  isScheduleTriggeredService: () => isScheduleTriggeredService
 });
 module.exports = __toCommonJS(types_exports);
 class Version {
@@ -48,13 +52,30 @@ class NodeVersion extends Version {
 }
 class BunVersion extends Version {
 }
-function getWorkerTopics(config) {
-  return config.topics?.length ? config.topics : ["default"];
+const JOB_TRIGGERS = ["queue", "schedule", "workflow"];
+function getServiceQueueTopicConfigs(config) {
+  if (Array.isArray(config.topics) && config.topics.length > 0) {
+    return typeof config.topics[0] === "string" ? config.topics.map((topic) => ({ topic })) : config.topics;
+  }
+  return config.type === "worker" ? [{ topic: "default" }] : [];
+}
+function getServiceQueueTopics(config) {
+  return getServiceQueueTopicConfigs(config).map((topic) => topic.topic);
+}
+function isQueueTriggeredService(service) {
+  return service.type === "worker" || service.type === "job" && service.trigger === "queue";
+}
+function isScheduleTriggeredService(service) {
+  return service.type === "cron" || service.type === "job" && service.trigger === "schedule";
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BunVersion,
+  JOB_TRIGGERS,
   NodeVersion,
   Version,
-  getWorkerTopics
+  getServiceQueueTopicConfigs,
+  getServiceQueueTopics,
+  isQueueTriggeredService,
+  isScheduleTriggeredService
 });

package/package.json

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