@vercel/client 17.5.18 → 17.6.1

package/dist/collect-deployment-files.d.ts

@@ -0,0 +1,14 @@
+import type { VercelClientOptions } from './types';
+import { type Debug } from './utils';
+import { type FilesMap } from './utils/hashes';
+type CollectDeploymentFilesOptions = Pick<VercelClientOptions, 'archive' | 'bulkRedirectsPath' | 'isDirectory' | 'prebuilt' | 'projectName' | 'rootDirectory' | 'vercelOutputDir'>;
+export interface CollectedDeploymentFiles {
+    fileList: string[];
+    filesMap: FilesMap;
+    workPath: string;
+    isDirectory: boolean;
+    ignoreList: string[];
+}
+export declare function assertDeploymentPath(path: VercelClientOptions['path'] | undefined, debug: Debug): asserts path is VercelClientOptions['path'];
+export declare function collectDeploymentFiles(path: VercelClientOptions['path'] | undefined, clientOptions: CollectDeploymentFilesOptions, debug: Debug): Promise<CollectedDeploymentFiles>;
+export {};

package/dist/collect-deployment-files.js

@@ -0,0 +1,95 @@
+"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 collect_deployment_files_exports = {};
+__export(collect_deployment_files_exports, {
+  assertDeploymentPath: () => assertDeploymentPath,
+  collectDeploymentFiles: () => collectDeploymentFiles
+});
+module.exports = __toCommonJS(collect_deployment_files_exports);
+var import_error_utils = require("@vercel/error-utils");
+var import_fs_extra = require("fs-extra");
+var import_path = require("path");
+var import_errors = require("./errors");
+var import_utils = require("./utils");
+var import_archive = require("./utils/archive");
+var import_hashes = require("./utils/hashes");
+function assertDeploymentPath(path, debug) {
+  if (typeof path !== "string" && !Array.isArray(path)) {
+    debug(
+      `Error: 'path' is expected to be a string or an array. Received ${typeof path}`
+    );
+    throw new import_errors.DeploymentError({
+      code: "missing_path",
+      message: "Path not provided"
+    });
+  }
+}
+async function collectDeploymentFiles(path, clientOptions, debug) {
+  assertDeploymentPath(path, debug);
+  const isDirectory = !Array.isArray(path) && (0, import_fs_extra.lstatSync)(path).isDirectory();
+  clientOptions.isDirectory = isDirectory;
+  if (Array.isArray(path)) {
+    for (const filePath of path) {
+      if (!(0, import_path.isAbsolute)(filePath)) {
+        throw new import_errors.DeploymentError({
+          code: "invalid_path",
+          message: `Provided path ${filePath} is not absolute`
+        });
+      }
+    }
+  } else if (!(0, import_path.isAbsolute)(path)) {
+    throw new import_errors.DeploymentError({
+      code: "invalid_path",
+      message: `Provided path ${path} is not absolute`
+    });
+  }
+  if (isDirectory && !Array.isArray(path)) {
+    debug(`Provided 'path' is a directory.`);
+  } else if (Array.isArray(path)) {
+    debug(`Provided 'path' is an array of file paths`);
+  } else {
+    debug(`Provided 'path' is a single file`);
+  }
+  const { fileList, ignoreList } = await (0, import_utils.buildFileTree)(
+    path,
+    clientOptions,
+    debug
+  );
+  const workPath = typeof path === "string" ? path : path[0];
+  let filesMap;
+  try {
+    filesMap = clientOptions.archive === "tgz" ? await (0, import_archive.createTgzFiles)(workPath, fileList, debug) : await (0, import_hashes.hashes)(fileList);
+  } catch (err) {
+    if (clientOptions.prebuilt && (0, import_error_utils.isErrnoException)(err) && err.code === "ENOENT" && err.path) {
+      const errPath = (0, import_path.relative)(workPath, err.path);
+      err.message = `File does not exist: "${(0, import_path.relative)(workPath, errPath)}"`;
+      if (errPath.split(import_path.sep).includes("node_modules")) {
+        err.message = `Please ensure project dependencies have been installed:
+${err.message}`;
+      }
+    }
+    throw err;
+  }
+  return { fileList, filesMap, workPath, isDirectory, ignoreList };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  assertDeploymentPath,
+  collectDeploymentFiles
+});

package/dist/create-deployment.js

@@ -21,29 +21,18 @@ __export(create_deployment_exports, {
   default: () => buildCreateDeployment
 });
 module.exports = __toCommonJS(create_deployment_exports);
-var import_fs_extra = require("fs-extra");
-var import_path = require("path");
 var import_hashes = require("./utils/hashes");
 var import_deploy = require("./deploy");
 var import_upload = require("./upload");
 var import_utils = require("./utils");
 var import_errors = require("./errors");
-var import_error_utils = require("@vercel/error-utils");
-var import_archive = require("./utils/archive");
+var import_collect_deployment_files = require("./collect-deployment-files");
 function buildCreateDeployment() {
   return async function* createDeployment(clientOptions, deploymentOptions = {}) {
     const { path } = clientOptions;
     const debug = (0, import_utils.createDebug)(clientOptions.debug);
     debug("Creating deployment...");
-    if (typeof path !== "string" && !Array.isArray(path)) {
-      debug(
-        `Error: 'path' is expected to be a string or an array. Received ${typeof path}`
-      );
-      throw new import_errors.DeploymentError({
-        code: "missing_path",
-        message: "Path not provided"
-      });
-    }
+    (0, import_collect_deployment_files.assertDeploymentPath)(path, debug);
     if (typeof clientOptions.token !== "string") {
       debug(
         `Error: 'token' is expected to be a string. Received ${typeof clientOptions.token}`
@@ -69,30 +58,11 @@ function buildCreateDeployment() {
       yield* (0, import_deploy.deploy)(/* @__PURE__ */ new Map(), clientOptions, deploymentOptions);
       return;
     }
-    clientOptions.isDirectory = !Array.isArray(path) && (0, import_fs_extra.lstatSync)(path).isDirectory();
-    if (Array.isArray(path)) {
-      for (const filePath of path) {
-        if (!(0, import_path.isAbsolute)(filePath)) {
-          throw new import_errors.DeploymentError({
-            code: "invalid_path",
-            message: `Provided path ${filePath} is not absolute`
-          });
-        }
-      }
-    } else if (!(0, import_path.isAbsolute)(path)) {
-      throw new import_errors.DeploymentError({
-        code: "invalid_path",
-        message: `Provided path ${path} is not absolute`
-      });
-    }
-    if (clientOptions.isDirectory && !Array.isArray(path)) {
-      debug(`Provided 'path' is a directory.`);
-    } else if (Array.isArray(path)) {
-      debug(`Provided 'path' is an array of file paths`);
-    } else {
-      debug(`Provided 'path' is a single file`);
-    }
-    const { fileList } = await (0, import_utils.buildFileTree)(path, clientOptions, debug);
+    const { fileList, filesMap: files } = await (0, import_collect_deployment_files.collectDeploymentFiles)(
+      path,
+      clientOptions,
+      debug
+    );
     if (fileList.length === 0) {
       debug("Deployment path has no files. Yielding a warning event");
       yield {
@@ -100,25 +70,6 @@ function buildCreateDeployment() {
         payload: "There are no files inside your deployment."
       };
     }
-    const workPath = typeof path === "string" ? path : path[0];
-    let files;
-    try {
-      if (clientOptions.archive === "tgz") {
-        files = await (0, import_archive.createTgzFiles)(workPath, fileList, debug);
-      } else {
-        files = await (0, import_hashes.hashes)(fileList);
-      }
-    } catch (err) {
-      if (clientOptions.prebuilt && (0, import_error_utils.isErrnoException)(err) && err.code === "ENOENT" && err.path) {
-        const errPath = (0, import_path.relative)(workPath, err.path);
-        err.message = `File does not exist: "${(0, import_path.relative)(workPath, errPath)}"`;
-        if (errPath.split(import_path.sep).includes("node_modules")) {
-          err.message = `Please ensure project dependencies have been installed:
-${err.message}`;
-        }
-      }
-      throw err;
-    }
     debug(`Yielding a 'hashes-calculated' event with ${files.size} hashes`);
     yield { type: "hashes-calculated", payload: (0, import_hashes.mapToObject)(files) };
     if (clientOptions.apiUrl) {

package/dist/index.d.ts

@@ -1,5 +1,6 @@
 export { continueDeployment } from './continue';
 export { checkDeploymentStatus } from './check-deployment-status';
+export { inspectDeploymentFiles } from './inspect-deployment-files';
 export { getVercelIgnore, buildFileTree } from './utils/index';
 export declare const createDeployment: (clientOptions: import("./types").VercelClientOptions, deploymentOptions?: import("./types").DeploymentOptions) => AsyncIterableIterator<{
     type: import("./types").DeploymentEventType;

package/dist/index.js

@@ -33,12 +33,14 @@ __export(src_exports, {
   checkDeploymentStatus: () => import_check_deployment_status.checkDeploymentStatus,
   continueDeployment: () => import_continue.continueDeployment,
   createDeployment: () => createDeployment,
-  getVercelIgnore: () => import_utils.getVercelIgnore
+  getVercelIgnore: () => import_utils.getVercelIgnore,
+  inspectDeploymentFiles: () => import_inspect_deployment_files.inspectDeploymentFiles
 });
 module.exports = __toCommonJS(src_exports);
 var import_create_deployment = __toESM(require("./create-deployment"));
 var import_continue = require("./continue");
 var import_check_deployment_status = require("./check-deployment-status");
+var import_inspect_deployment_files = require("./inspect-deployment-files");
 var import_utils = require("./utils/index");
 __reExport(src_exports, require("./errors"), module.exports);
 __reExport(src_exports, require("./types"), module.exports);
@@ -50,6 +52,7 @@ const createDeployment = (0, import_create_deployment.default)();
   continueDeployment,
   createDeployment,
   getVercelIgnore,
+  inspectDeploymentFiles,
   ...require("./errors"),
   ...require("./types")
 });

package/dist/inspect-deployment-files.d.ts

@@ -0,0 +1,16 @@
+import type { VercelClientOptions } from './types';
+export interface DeploymentFileItem {
+    path: string;
+    size: number;
+    mode: number;
+    sha?: string;
+}
+export interface DeploymentFileSummary {
+    basePath: string;
+    fileCount: number;
+    totalSize: number;
+    ignoredCount: number;
+    files: DeploymentFileItem[];
+    ignored: string[];
+}
+export declare function inspectDeploymentFiles(clientOptions: Pick<VercelClientOptions, 'archive' | 'bulkRedirectsPath' | 'debug' | 'path' | 'prebuilt' | 'projectName' | 'rootDirectory' | 'vercelOutputDir'>): Promise<DeploymentFileSummary>;

package/dist/inspect-deployment-files.js

@@ -0,0 +1,63 @@
+"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 inspect_deployment_files_exports = {};
+__export(inspect_deployment_files_exports, {
+  inspectDeploymentFiles: () => inspectDeploymentFiles
+});
+module.exports = __toCommonJS(inspect_deployment_files_exports);
+var import_path = require("path");
+var import_collect_deployment_files = require("./collect-deployment-files");
+var import_utils = require("./utils");
+async function inspectDeploymentFiles(clientOptions) {
+  const { path } = clientOptions;
+  const debug = (0, import_utils.createDebug)(clientOptions.debug);
+  const { filesMap, workPath, isDirectory, ignoreList } = await (0, import_collect_deployment_files.collectDeploymentFiles)(path, { ...clientOptions }, debug);
+  const files = [];
+  let totalSize = 0;
+  for (const [sha, file] of filesMap) {
+    const size = file.data?.byteLength || file.data?.length || 0;
+    for (const name of file.names) {
+      const pathName = isDirectory ? (0, import_path.relative)(workPath, name) : name.split(import_path.sep).at(-1) || name;
+      const normalizedPath = pathName.split(import_path.sep).join("/");
+      const deploymentFile = {
+        path: normalizedPath,
+        size,
+        mode: file.mode
+      };
+      if (typeof sha !== "undefined") {
+        deploymentFile.sha = sha;
+      }
+      files.push(deploymentFile);
+      totalSize += size;
+    }
+  }
+  files.sort((a, b) => a.path.localeCompare(b.path));
+  return {
+    basePath: workPath,
+    fileCount: files.length,
+    totalSize,
+    ignoredCount: ignoreList.length,
+    files,
+    ignored: ignoreList.sort()
+  };
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  inspectDeploymentFiles
+});

package/dist/types.d.ts

@@ -1,5 +1,5 @@
 import type { Agent } from 'http';
-import type { Builder, BuilderFunctions, Images, ProjectSettings, Cron, ExperimentalServices, ExperimentalServiceGroups, ExperimentalServicesV2 } from '@vercel/build-utils';
+import type { Builder, BuilderFunctions, Images, ProjectSettings, Cron, ExperimentalServices, ExperimentalServiceGroups, ExperimentalServicesV2, Services } from '@vercel/build-utils';
 import type { Header, Route, Redirect, Rewrite } from '@vercel/routing-utils';
 export { DeploymentEventType } from './utils';
 export interface Dictionary<T> {
@@ -147,7 +147,11 @@ export interface VercelConfig {
      */
     experimentalServiceGroups?: ExperimentalServiceGroups;
     /**
-     * @experimental This feature is experimental and may change.
+     * Configures multiple services in this project.
+     */
+    services?: Services;
+    /**
+     * @deprecated Use `services` instead.
      */
     experimentalServicesV2?: ExperimentalServicesV2;
 }

package/dist/utils/index.d.ts

@@ -35,5 +35,5 @@ export interface PreparedFile {
 }
 export declare const prepareFiles: (files: FilesMap, clientOptions: VercelClientOptions) => PreparedFile[];
 export declare function createDebug(debug?: boolean): (...logs: string[]) => void;
-type Debug = ReturnType<typeof createDebug>;
+export type Debug = ReturnType<typeof createDebug>;
 export {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vercel/client",
-  "version": "17.5.18",
+  "version": "17.6.1",
   "main": "dist/index.js",
   "typings": "dist/index.d.ts",
   "homepage": "https://vercel.com",
@@ -39,9 +39,9 @@
     "querystring": "^0.2.0",
     "sleep-promise": "8.0.1",
     "tar-fs": "1.16.3",
-    "@vercel/error-utils": "2.2.0",
-    "@vercel/build-utils": "13.31.1",
-    "@vercel/routing-utils": "6.3.1"
+    "@vercel/build-utils": "13.32.1",
+    "@vercel/routing-utils": "6.3.1",
+    "@vercel/error-utils": "2.2.0"
   },
   "scripts": {
     "build": "node ../../utils/build.mjs",