@vercel/build-utils 14.6.1 → 14.8.0

package/CHANGELOG.md

@@ -1,5 +1,21 @@
 # @vercel/build-utils
 
+## 14.8.0
+
+### Minor Changes
+
+- a652a99: Propagate top-level `schedules` from vercel.json into the Build Output API `config.json` during `vercel build`, and validate the property against the schedules schema
+
+## 14.7.0
+
+### Minor Changes
+
+- 37ff9da: Add build type to deploy manifest.
+
+### Patch Changes
+
+- 26b891e: Accept `schedule/v1beta` triggers in the `Lambda` runtime validation and the functions config schema
+
 ## 14.6.1
 
 ### Patch Changes

package/dist/index.js

@@ -35182,61 +35182,63 @@ var Lambda = class {
           `${prefix} is not an object`
         );
         (0, import_assert4.default)(
-          trigger.type === "queue/v1beta" || trigger.type === "queue/v2beta",
-          `${prefix}.type must be "queue/v1beta" or "queue/v2beta"`
+          trigger.type === "queue/v1beta" || trigger.type === "queue/v2beta" || trigger.type === "schedule/v1beta",
+          `${prefix}.type must be "queue/v1beta", "queue/v2beta", or "schedule/v1beta"`
         );
-        (0, import_assert4.default)(
-          typeof trigger.topic === "string",
-          `${prefix}.topic is required and must be a string`
-        );
-        (0, import_assert4.default)(trigger.topic.length > 0, `${prefix}.topic cannot be empty`);
-        (0, import_assert4.default)(
-          typeof trigger.consumer === "string",
-          `${prefix}.consumer is required and must be a string`
-        );
-        (0, import_assert4.default)(
-          trigger.consumer.length > 0,
-          `${prefix}.consumer cannot be empty`
-        );
-        if (trigger.maxDeliveries !== void 0) {
+        if (trigger.type === "queue/v1beta" || trigger.type === "queue/v2beta") {
           (0, import_assert4.default)(
-            typeof trigger.maxDeliveries === "number",
-            `${prefix}.maxDeliveries must be a number`
+            typeof trigger.topic === "string",
+            `${prefix}.topic is required and must be a string`
           );
+          (0, import_assert4.default)(trigger.topic.length > 0, `${prefix}.topic cannot be empty`);
           (0, import_assert4.default)(
-            Number.isInteger(trigger.maxDeliveries) && trigger.maxDeliveries >= 1,
-            `${prefix}.maxDeliveries must be at least 1`
+            typeof trigger.consumer === "string",
+            `${prefix}.consumer is required and must be a string`
           );
-        }
-        if (trigger.retryAfterSeconds !== void 0) {
-          (0, import_assert4.default)(
-            typeof trigger.retryAfterSeconds === "number",
-            `${prefix}.retryAfterSeconds must be a number`
-          );
-          (0, import_assert4.default)(
-            trigger.retryAfterSeconds > 0,
-            `${prefix}.retryAfterSeconds must be a positive number`
-          );
-        }
-        if (trigger.initialDelaySeconds !== void 0) {
           (0, import_assert4.default)(
-            typeof trigger.initialDelaySeconds === "number",
-            `${prefix}.initialDelaySeconds must be a number`
-          );
-          (0, import_assert4.default)(
-            trigger.initialDelaySeconds >= 0,
-            `${prefix}.initialDelaySeconds must be a non-negative number`
-          );
-        }
-        if (trigger.maxConcurrency !== void 0) {
-          (0, import_assert4.default)(
-            typeof trigger.maxConcurrency === "number",
-            `${prefix}.maxConcurrency must be a number`
-          );
-          (0, import_assert4.default)(
-            Number.isInteger(trigger.maxConcurrency) && trigger.maxConcurrency >= 1,
-            `${prefix}.maxConcurrency must be at least 1`
+            trigger.consumer.length > 0,
+            `${prefix}.consumer cannot be empty`
           );
+          if (trigger.maxDeliveries !== void 0) {
+            (0, import_assert4.default)(
+              typeof trigger.maxDeliveries === "number",
+              `${prefix}.maxDeliveries must be a number`
+            );
+            (0, import_assert4.default)(
+              Number.isInteger(trigger.maxDeliveries) && trigger.maxDeliveries >= 1,
+              `${prefix}.maxDeliveries must be at least 1`
+            );
+          }
+          if (trigger.retryAfterSeconds !== void 0) {
+            (0, import_assert4.default)(
+              typeof trigger.retryAfterSeconds === "number",
+              `${prefix}.retryAfterSeconds must be a number`
+            );
+            (0, import_assert4.default)(
+              trigger.retryAfterSeconds > 0,
+              `${prefix}.retryAfterSeconds must be a positive number`
+            );
+          }
+          if (trigger.initialDelaySeconds !== void 0) {
+            (0, import_assert4.default)(
+              typeof trigger.initialDelaySeconds === "number",
+              `${prefix}.initialDelaySeconds must be a number`
+            );
+            (0, import_assert4.default)(
+              trigger.initialDelaySeconds >= 0,
+              `${prefix}.initialDelaySeconds must be a non-negative number`
+            );
+          }
+          if (trigger.maxConcurrency !== void 0) {
+            (0, import_assert4.default)(
+              typeof trigger.maxConcurrency === "number",
+              `${prefix}.maxConcurrency must be a number`
+            );
+            (0, import_assert4.default)(
+              Number.isInteger(trigger.maxConcurrency) && trigger.maxConcurrency >= 1,
+              `${prefix}.maxConcurrency must be at least 1`
+            );
+          }
         }
       }
     }
@@ -38500,8 +38502,23 @@ var triggerEventSchemaV2 = {
   required: ["type", "topic"],
   additionalProperties: false
 };
+var scheduleTriggerEventSchemaV1 = {
+  type: "object",
+  properties: {
+    type: {
+      type: "string",
+      const: "schedule/v1beta"
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
 var triggerEventSchema = {
-  oneOf: [triggerEventSchemaV1, triggerEventSchemaV2]
+  oneOf: [
+    triggerEventSchemaV1,
+    triggerEventSchemaV2,
+    scheduleTriggerEventSchemaV1
+  ]
 };
 var getFunctionsSchema = () => ({
   type: "object",
@@ -38615,7 +38632,12 @@ var packageManifestSchema = {
     },
     serviceType: {
       type: "string",
-      description: 'Service type: one of "web", "schedule", "queue", "workflow".'
+      description: 'Deployment topology for service builds: "web", "schedule", "queue", or "workflow".'
+    },
+    buildType: {
+      type: "string",
+      enum: ["app", "api-dir", "middleware"],
+      description: 'What triggered this build: "app" (full application build), "api-dir" (api/ directory build), or "middleware" (middleware build).'
     },
     runtimeVersion: {
       type: "object",
@@ -39059,8 +39081,21 @@ async function generateProjectManifest({
 }) {
   try {
     const pkgJson = await readPackageJson(workPath);
-    if (!pkgJson)
+    if (!pkgJson) {
+      await writeProjectManifest(
+        {
+          version: MANIFEST_VERSION,
+          runtime: "node",
+          ...framework ? { framework } : {},
+          ...serviceType ? { serviceType } : {},
+          runtimeVersion: { resolved: String(nodeVersion.major) },
+          dependencies: []
+        },
+        workPath,
+        outputRuntime
+      );
       return;
+    }
     const { directScopes, directRequested } = buildDirectMaps(pkgJson);
     const lockMap = lockfilePath ? await parseLockfile(cliType, lockfilePath, lockfileVersion) : /* @__PURE__ */ new Map();
     const directDeps = [];

package/dist/lambda.js

@@ -208,61 +208,63 @@ class Lambda {
           `${prefix} is not an object`
         );
         (0, import_assert.default)(
-          trigger.type === "queue/v1beta" || trigger.type === "queue/v2beta",
-          `${prefix}.type must be "queue/v1beta" or "queue/v2beta"`
+          trigger.type === "queue/v1beta" || trigger.type === "queue/v2beta" || trigger.type === "schedule/v1beta",
+          `${prefix}.type must be "queue/v1beta", "queue/v2beta", or "schedule/v1beta"`
         );
-        (0, import_assert.default)(
-          typeof trigger.topic === "string",
-          `${prefix}.topic is required and must be a string`
-        );
-        (0, import_assert.default)(trigger.topic.length > 0, `${prefix}.topic cannot be empty`);
-        (0, import_assert.default)(
-          typeof trigger.consumer === "string",
-          `${prefix}.consumer is required and must be a string`
-        );
-        (0, import_assert.default)(
-          trigger.consumer.length > 0,
-          `${prefix}.consumer cannot be empty`
-        );
-        if (trigger.maxDeliveries !== void 0) {
+        if (trigger.type === "queue/v1beta" || trigger.type === "queue/v2beta") {
           (0, import_assert.default)(
-            typeof trigger.maxDeliveries === "number",
-            `${prefix}.maxDeliveries must be a number`
+            typeof trigger.topic === "string",
+            `${prefix}.topic is required and must be a string`
           );
+          (0, import_assert.default)(trigger.topic.length > 0, `${prefix}.topic cannot be empty`);
           (0, import_assert.default)(
-            Number.isInteger(trigger.maxDeliveries) && trigger.maxDeliveries >= 1,
-            `${prefix}.maxDeliveries must be at least 1`
+            typeof trigger.consumer === "string",
+            `${prefix}.consumer is required and must be a string`
           );
-        }
-        if (trigger.retryAfterSeconds !== void 0) {
-          (0, import_assert.default)(
-            typeof trigger.retryAfterSeconds === "number",
-            `${prefix}.retryAfterSeconds must be a number`
-          );
-          (0, import_assert.default)(
-            trigger.retryAfterSeconds > 0,
-            `${prefix}.retryAfterSeconds must be a positive number`
-          );
-        }
-        if (trigger.initialDelaySeconds !== void 0) {
           (0, import_assert.default)(
-            typeof trigger.initialDelaySeconds === "number",
-            `${prefix}.initialDelaySeconds must be a number`
-          );
-          (0, import_assert.default)(
-            trigger.initialDelaySeconds >= 0,
-            `${prefix}.initialDelaySeconds must be a non-negative number`
-          );
-        }
-        if (trigger.maxConcurrency !== void 0) {
-          (0, import_assert.default)(
-            typeof trigger.maxConcurrency === "number",
-            `${prefix}.maxConcurrency must be a number`
-          );
-          (0, import_assert.default)(
-            Number.isInteger(trigger.maxConcurrency) && trigger.maxConcurrency >= 1,
-            `${prefix}.maxConcurrency must be at least 1`
+            trigger.consumer.length > 0,
+            `${prefix}.consumer cannot be empty`
           );
+          if (trigger.maxDeliveries !== void 0) {
+            (0, import_assert.default)(
+              typeof trigger.maxDeliveries === "number",
+              `${prefix}.maxDeliveries must be a number`
+            );
+            (0, import_assert.default)(
+              Number.isInteger(trigger.maxDeliveries) && trigger.maxDeliveries >= 1,
+              `${prefix}.maxDeliveries must be at least 1`
+            );
+          }
+          if (trigger.retryAfterSeconds !== void 0) {
+            (0, import_assert.default)(
+              typeof trigger.retryAfterSeconds === "number",
+              `${prefix}.retryAfterSeconds must be a number`
+            );
+            (0, import_assert.default)(
+              trigger.retryAfterSeconds > 0,
+              `${prefix}.retryAfterSeconds must be a positive number`
+            );
+          }
+          if (trigger.initialDelaySeconds !== void 0) {
+            (0, import_assert.default)(
+              typeof trigger.initialDelaySeconds === "number",
+              `${prefix}.initialDelaySeconds must be a number`
+            );
+            (0, import_assert.default)(
+              trigger.initialDelaySeconds >= 0,
+              `${prefix}.initialDelaySeconds must be a non-negative number`
+            );
+          }
+          if (trigger.maxConcurrency !== void 0) {
+            (0, import_assert.default)(
+              typeof trigger.maxConcurrency === "number",
+              `${prefix}.maxConcurrency must be a number`
+            );
+            (0, import_assert.default)(
+              Number.isInteger(trigger.maxConcurrency) && trigger.maxConcurrency >= 1,
+              `${prefix}.maxConcurrency must be at least 1`
+            );
+          }
         }
       }
     }

package/dist/node-diagnostics.js

@@ -392,8 +392,21 @@ async function generateProjectManifest({
 }) {
   try {
     const pkgJson = await readPackageJson(workPath);
-    if (!pkgJson)
+    if (!pkgJson) {
+      await (0, import_package_manifest.writeProjectManifest)(
+        {
+          version: import_package_manifest.MANIFEST_VERSION,
+          runtime: "node",
+          ...framework ? { framework } : {},
+          ...serviceType ? { serviceType } : {},
+          runtimeVersion: { resolved: String(nodeVersion.major) },
+          dependencies: []
+        },
+        workPath,
+        outputRuntime
+      );
       return;
+    }
     const { directScopes, directRequested } = buildDirectMaps(pkgJson);
     const lockMap = lockfilePath ? await parseLockfile(cliType, lockfilePath, lockfileVersion) : /* @__PURE__ */ new Map();
     const directDeps = [];

package/dist/package-manifest.d.ts

@@ -8,11 +8,20 @@ export interface PackageManifestDependency {
     source?: string;
     sourceUrl?: string;
 }
+/**
+ * What triggered this build pipeline entry.
+ *
+ * - `'app'`        — full application build
+ * - `'api-dir'`    — api/ directory build
+ * - `'middleware'` — middleware build
+ */
+export type BuildType = 'app' | 'api-dir' | 'middleware';
 export interface PackageManifest {
     version?: string;
     runtime: string;
     framework?: string;
     serviceType?: string;
+    buildType?: BuildType;
     runtimeVersion?: {
         requested?: string;
         requestedSource?: string;

package/dist/schemas.d.ts

@@ -76,26 +76,6 @@ export declare const getFunctionsSchema: () => {
                                     type: string;
                                     const: string;
                                 };
-                                topic: {
-                                    type: string;
-                                    minLength: number;
-                                };
-                                maxDeliveries: {
-                                    type: string;
-                                    minimum: number;
-                                };
-                                retryAfterSeconds: {
-                                    type: string;
-                                    exclusiveMinimum: number;
-                                };
-                                initialDelaySeconds: {
-                                    type: string;
-                                    minimum: number;
-                                };
-                                maxConcurrency: {
-                                    type: string;
-                                    minimum: number;
-                                };
                             };
                             required: string[];
                             additionalProperties: boolean;
@@ -193,26 +173,6 @@ export declare const functionsSchema: {
                                     type: string;
                                     const: string;
                                 };
-                                topic: {
-                                    type: string;
-                                    minLength: number;
-                                };
-                                maxDeliveries: {
-                                    type: string;
-                                    minimum: number;
-                                };
-                                retryAfterSeconds: {
-                                    type: string;
-                                    exclusiveMinimum: number;
-                                };
-                                initialDelaySeconds: {
-                                    type: string;
-                                    minimum: number;
-                                };
-                                maxConcurrency: {
-                                    type: string;
-                                    minimum: number;
-                                };
                             };
                             required: string[];
                             additionalProperties: boolean;
@@ -276,7 +236,12 @@ export declare const packageManifestSchema: {
         };
         readonly serviceType: {
             readonly type: "string";
-            readonly description: "Service type: one of \"web\", \"schedule\", \"queue\", \"workflow\".";
+            readonly description: "Deployment topology for service builds: \"web\", \"schedule\", \"queue\", or \"workflow\".";
+        };
+        readonly buildType: {
+            readonly type: "string";
+            readonly enum: readonly ["app", "api-dir", "middleware"];
+            readonly description: "What triggered this build: \"app\" (full application build), \"api-dir\" (api/ directory build), or \"middleware\" (middleware build).";
         };
         readonly runtimeVersion: {
             readonly type: "object";

package/dist/schemas.js

@@ -91,8 +91,23 @@ const triggerEventSchemaV2 = {
   required: ["type", "topic"],
   additionalProperties: false
 };
+const scheduleTriggerEventSchemaV1 = {
+  type: "object",
+  properties: {
+    type: {
+      type: "string",
+      const: "schedule/v1beta"
+    }
+  },
+  required: ["type"],
+  additionalProperties: false
+};
 const triggerEventSchema = {
-  oneOf: [triggerEventSchemaV1, triggerEventSchemaV2]
+  oneOf: [
+    triggerEventSchemaV1,
+    triggerEventSchemaV2,
+    scheduleTriggerEventSchemaV1
+  ]
 };
 const getFunctionsSchema = () => ({
   type: "object",
@@ -206,7 +221,12 @@ const packageManifestSchema = {
     },
     serviceType: {
       type: "string",
-      description: 'Service type: one of "web", "schedule", "queue", "workflow".'
+      description: 'Deployment topology for service builds: "web", "schedule", "queue", or "workflow".'
+    },
+    buildType: {
+      type: "string",
+      enum: ["app", "api-dir", "middleware"],
+      description: 'What triggered this build: "app" (full application build), "api-dir" (api/ directory build), or "middleware" (middleware build).'
     },
     runtimeVersion: {
       type: "object",

package/dist/types.d.ts

@@ -565,6 +565,27 @@ export interface Cron {
     path: string;
     schedule: string;
 }
+export interface ScheduleExpression {
+    /** Cron expression describing when the schedule fires (REQUIRED) */
+    cron: string;
+    /** Maximum random delay applied to each firing, e.g. "5m" (OPTIONAL) */
+    jitter?: string;
+}
+export type ScheduleTarget = {
+    /** Build output path of the function to invoke, e.g. "api/cron" */
+    function: string;
+} | {
+    /** Name of the queue topic to publish to */
+    topic: string;
+};
+export interface Schedule {
+    /** Unique name of the schedule within the deployment (REQUIRED) */
+    name: string;
+    expression: ScheduleExpression;
+    target: ScheduleTarget;
+    /** Payload delivered with each firing (OPTIONAL) */
+    payload?: unknown;
+}
 export interface ServiceQueueTopic {
     topic: string;
     retryAfterSeconds?: number;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "14.6.1",
+  "version": "14.8.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",