@vercel/build-utils 13.24.0 → 13.25.0

package/CHANGELOG.md

@@ -1,5 +1,12 @@
 # @vercel/build-utils
 
+## 13.25.0
+
+### Minor Changes
+
+- fb0cb8d: Add normalized entrypoint detector for runtime builders.
+- 4fc110b: [services] add preDeployCommand for experimentalServices
+
 ## 13.24.0
 
 ### Minor Changes

package/dist/index.js

@@ -34489,6 +34489,7 @@ __export(src_exports, {
   BACKEND_FRAMEWORKS: () => BACKEND_FRAMEWORKS,
   BUILDER_COMPILE_STEP: () => BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP: () => BUILDER_INSTALLER_STEP,
+  BUILDER_PRE_DEPLOY_STEP: () => BUILDER_PRE_DEPLOY_STEP,
   BunVersion: () => BunVersion,
   ENV_WRAPPER_SUPPORTED_FAMILIES: () => ENV_WRAPPER_SUPPORTED_FAMILIES,
   EdgeFunction: () => EdgeFunction,
@@ -38944,6 +38945,7 @@ var Span = class _Span {
 // src/trace/constants.ts
 var BUILDER_INSTALLER_STEP = "vc.builder.install";
 var BUILDER_COMPILE_STEP = "vc.builder.build";
+var BUILDER_PRE_DEPLOY_STEP = "vc.builder.preDeploy";
 
 // src/get-installed-package-version.ts
 async function getInstalledPackageVersion(packageName, path8) {
@@ -40282,6 +40284,7 @@ function getExtendedPayload({
   BACKEND_FRAMEWORKS,
   BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP,
+  BUILDER_PRE_DEPLOY_STEP,
   BunVersion,
   ENV_WRAPPER_SUPPORTED_FAMILIES,
   EdgeFunction,

package/dist/trace/constants.d.ts

@@ -1,2 +1,3 @@
 export declare const BUILDER_INSTALLER_STEP = "vc.builder.install";
 export declare const BUILDER_COMPILE_STEP = "vc.builder.build";
+export declare const BUILDER_PRE_DEPLOY_STEP = "vc.builder.preDeploy";

package/dist/trace/constants.js

@@ -19,13 +19,16 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var constants_exports = {};
 __export(constants_exports, {
   BUILDER_COMPILE_STEP: () => BUILDER_COMPILE_STEP,
-  BUILDER_INSTALLER_STEP: () => BUILDER_INSTALLER_STEP
+  BUILDER_INSTALLER_STEP: () => BUILDER_INSTALLER_STEP,
+  BUILDER_PRE_DEPLOY_STEP: () => BUILDER_PRE_DEPLOY_STEP
 });
 module.exports = __toCommonJS(constants_exports);
 const BUILDER_INSTALLER_STEP = "vc.builder.install";
 const BUILDER_COMPILE_STEP = "vc.builder.build";
+const BUILDER_PRE_DEPLOY_STEP = "vc.builder.preDeploy";
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
   BUILDER_COMPILE_STEP,
-  BUILDER_INSTALLER_STEP
+  BUILDER_INSTALLER_STEP,
+  BUILDER_PRE_DEPLOY_STEP
 });

package/dist/trace/index.d.ts

@@ -1,3 +1,3 @@
 export { Span } from './trace';
-export { BUILDER_COMPILE_STEP, BUILDER_INSTALLER_STEP } from './constants';
+export { BUILDER_COMPILE_STEP, BUILDER_INSTALLER_STEP, BUILDER_PRE_DEPLOY_STEP, } from './constants';
 export type { SpanId, TraceEvent, Reporter } from './trace';

package/dist/trace/index.js

@@ -20,6 +20,7 @@ var trace_exports = {};
 __export(trace_exports, {
   BUILDER_COMPILE_STEP: () => import_constants.BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP: () => import_constants.BUILDER_INSTALLER_STEP,
+  BUILDER_PRE_DEPLOY_STEP: () => import_constants.BUILDER_PRE_DEPLOY_STEP,
   Span: () => import_trace.Span
 });
 module.exports = __toCommonJS(trace_exports);
@@ -29,5 +30,6 @@ var import_constants = require("./constants");
 0 && (module.exports = {
   BUILDER_COMPILE_STEP,
   BUILDER_INSTALLER_STEP,
+  BUILDER_PRE_DEPLOY_STEP,
   Span
 });

package/dist/types.d.ts

@@ -97,6 +97,12 @@ export interface BuildOptions {
      * fully processed
      */
     buildCallback?: (opts: Omit<BuildOptions, 'buildCallback'>) => Promise<void>;
+    /**
+     * Called by the builder to register a callback that will execute the
+     * service's pre-deploy command. The CLI collects these and invokes
+     * them only after every builder has succeeded.
+     */
+    registerPreDeploy?: (callback: () => Promise<void>) => void;
     /**
      * The current trace state from the internal vc tracing
      */
@@ -518,6 +524,7 @@ export interface Service {
     runtime?: string;
     buildCommand?: string;
     installCommand?: string;
+    preDeployCommand?: string;
     routePrefix?: string;
     routePrefixSource?: 'configured' | 'generated';
     subdomain?: string;
@@ -805,3 +812,37 @@ export type Services = Record<string, ServiceConfig>;
  * }
  */
 export type ExperimentalServiceGroups = Record<string, string[]>;
+/**
+ * Result of a runtime builder's normalized entrypoint detection.
+ *
+ * - `kind: 'file'` — `entrypoint` is a path relative to the scanned `workPath`
+ *   (e.g. `"src/index.ts"`, `"main.go"`, `"main.py"`).
+ * - `kind: 'py-module:attr'` — `entrypoint` is a Python `module:attr` reference
+ *   where the module is dot-separated and resolved relative to the scanned
+ *   `workPath` (e.g. `"main:app"`, `"src.main:app"`).
+ *
+ * @experimental This feature is experimental and may change.
+ */
+export type DetectedEntrypoint = {
+    kind: 'file';
+    entrypoint: string;
+} | {
+    kind: 'py-module:attr';
+    entrypoint: string;
+} | null;
+/**
+ * Input to a runtime builder's normalized entrypoint detector.
+ * @experimental This feature is experimental and may change.
+ */
+export interface DetectEntrypointOptions {
+    /** Path to the candidate service directory relative to project root. */
+    workPath: string;
+    /** Framework slug detected for this directory, if any. */
+    framework?: string;
+}
+/**
+ * Normalized entrypoint detector signature, implemented by each runtime builder
+ * and consumed by services auto-detection to populate suggested service configs.
+ * @experimental This feature is experimental and may change.
+ */
+export type DetectEntrypointFn = (opts: DetectEntrypointOptions) => Promise<DetectedEntrypoint>;

package/package.json

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