@vercel/build-utils 13.15.0 → 13.17.0

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

@@ -0,0 +1,13 @@
+/**
+ * Shared utilities for generating internal service paths.
+ *
+ * These are used by builders (e.g. @vercel/python) to produce cron entries
+ * and rewrite routes for service builds.
+ */
+/**
+ * Reserved internal namespace used by services routing/runtime plumbing.
+ */
+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;

package/dist/service-path-utils.js

@@ -0,0 +1,48 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+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 __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var service_path_utils_exports = {};
+__export(service_path_utils_exports, {
+  INTERNAL_SERVICE_PREFIX: () => INTERNAL_SERVICE_PREFIX,
+  getInternalServiceCronPath: () => getInternalServiceCronPath,
+  getInternalServiceCronPathPrefix: () => getInternalServiceCronPathPrefix,
+  getInternalServiceFunctionPath: () => getInternalServiceFunctionPath
+});
+module.exports = __toCommonJS(service_path_utils_exports);
+const INTERNAL_SERVICE_PREFIX = "/_svc";
+function normalizeInternalServiceEntrypoint(entrypoint) {
+  const normalized = entrypoint.replace(/\\/g, "/").replace(/^\/+/, "").replace(/\.[^/.]+$/, "");
+  return normalized || "index";
+}
+function getInternalServiceFunctionPath(serviceName) {
+  return `${INTERNAL_SERVICE_PREFIX}/${serviceName}/index`;
+}
+function getInternalServiceCronPathPrefix(serviceName) {
+  return `${INTERNAL_SERVICE_PREFIX}/${serviceName}/crons`;
+}
+function getInternalServiceCronPath(serviceName, entrypoint, handler = "cron") {
+  const normalizedEntrypoint = normalizeInternalServiceEntrypoint(entrypoint);
+  return `${getInternalServiceCronPathPrefix(serviceName)}/${normalizedEntrypoint}/${handler}`;
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  INTERNAL_SERVICE_PREFIX,
+  getInternalServiceCronPath,
+  getInternalServiceCronPathPrefix,
+  getInternalServiceFunctionPath
+});

package/dist/types.d.ts

@@ -118,6 +118,8 @@ export interface BuildOptions {
         subdomain?: string;
         /** Workspace directory for this service, relative to the project root. */
         workspace?: string;
+        /** Cron schedule expression (e.g., "0 0 * * *"). Only present for cron services. */
+        schedule?: string;
     };
 }
 export interface PrepareCacheOptions {
@@ -219,6 +221,11 @@ export interface StartDevServerSuccess {
      * dev server will forcefully be killed.
      */
     shutdown?: () => Promise<void>;
+    /**
+     * Cron entries produced by the builder for this service.
+     * Used by the dev orchestrator to schedule cron triggers.
+     */
+    crons?: Cron[];
 }
 /**
  * `startDevServer()` may return `null` to opt-out of spawning a dev server for
@@ -545,6 +552,7 @@ export interface BuildResultV2Typical {
      * @example "abc123"
      */
     deploymentId?: string;
+    crons?: Cron[];
 }
 export type BuildResultVX = {
     resultVersion: 2;
@@ -557,6 +565,7 @@ export type BuildResultV2 = BuildResultV2Typical | BuildResultBuildOutput;
 export interface BuildResultV3 {
     routes?: any[];
     output: Lambda | EdgeFunction;
+    crons?: Cron[];
 }
 export type BuildVX = (options: BuildOptions) => Promise<BuildResultVX>;
 export type BuildV2 = (options: BuildOptions) => Promise<BuildResultV2>;
@@ -671,7 +680,13 @@ export interface ServiceMount {
 export interface ExperimentalServiceConfig {
     type?: ServiceType;
     /**
-     * Service entrypoint, relative to the project root.
+     * Path to the service's root directory relative to the project root.
+     * Should contain a manifest file (package.json, pyproject.toml, etc.).
+     * Defaults to ".".
+     */
+    root?: string;
+    /**
+     * Service entrypoint, relative to the service root directory.
      * Can be either a file path (runtime entrypoint) or a directory path
      * (service workspace for framework-based services).
      * @example "apps/web", "services/api/src/index.ts", "services/fastapi/main.py"

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/build-utils",
-  "version": "13.15.0",
+  "version": "13.17.0",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
   "types": "./dist/index.d.js",
@@ -26,6 +26,7 @@
     "@types/glob": "7.2.0",
     "@types/jest": "27.4.1",
     "@types/js-yaml": "3.12.1",
+    "@types/mime-types": "2.1.0",
     "@types/minimatch": "^5.1.2",
     "@types/ms": "0.7.31",
     "@types/multistream": "2.1.1",
@@ -45,6 +46,7 @@
     "into-stream": "5.0.0",
     "jest-junit": "16.0.0",
     "js-yaml": "3.13.1",
+    "mime-types": "2.1.28",
     "minimatch": "3.1.2",
     "ms": "2.1.3",
     "multistream": "2.1.1",