vercel 57.0.0 → 58.0.0

package/dist/chunks/{chunk-TBR2Q37Y.js → chunk-TPX7RZBM.js}

@@ -23280,7 +23280,7 @@ var require_utils3 = __commonJS({
           };
         }
       }
-      const hasVercelToml = process.env.VERCEL_TOML_CONFIG_ENABLED === "1" && await fs5.hasPath("vercel.toml");
+      const hasVercelToml = await fs5.hasPath("vercel.toml");
       if (hasVercelToml) {
         try {
           const { parse: tomlParse3 } = await import("smol-toml");
@@ -29584,7 +29584,9 @@ var require_detect_builders = __commonJS({
       detectApiExtensions: () => detectApiExtensions2,
       detectBuilders: () => detectBuilders2,
       detectOutputDirectory: () => detectOutputDirectory2,
-      sortFiles: () => sortFiles
+      getProxyBuilder: () => getProxyBuilder2,
+      sortFiles: () => sortFiles,
+      validateProxyConfig: () => validateProxyConfig3
     });
     module.exports = __toCommonJS2(detect_builders_exports);
     var import_minimatch = __toESM2(require_minimatch());
@@ -29595,7 +29597,7 @@ var require_detect_builders = __commonJS({
     var import_build_utils7 = __require("@vercel/build-utils");
     var import_get_services_builders = require_get_services_builders();
     var REGEX_MIDDLEWARE_FILES = "middleware.[jt]s";
-    var REGEX_VERCEL_PLATFORM_FILES = [
+    var VERCEL_PLATFORM_FILES = [
       "api/**",
       "node_modules/**",
       REGEX_MIDDLEWARE_FILES,
@@ -29607,8 +29609,18 @@ var require_detect_builders = __commonJS({
       "bun.lockb",
       ".gitignore",
       "README.md"
-    ].join(",");
-    var REGEX_NON_VERCEL_PLATFORM_FILES2 = `!{${REGEX_VERCEL_PLATFORM_FILES}}`;
+    ];
+    var REGEX_VERCEL_PLATFORM_FILES = VERCEL_PLATFORM_FILES.join(",");
+    function escapeMinimatchPath(path3) {
+      return path3.replace(/([\\,*?[\]{}()!+@])/g, "\\$1");
+    }
+    function getStaticFilesPattern(additionalExclusions = []) {
+      return `!{${[
+        ...VERCEL_PLATFORM_FILES,
+        ...additionalExclusions.map(escapeMinimatchPath)
+      ].join(",")}}`;
+    }
+    var REGEX_NON_VERCEL_PLATFORM_FILES2 = getStaticFilesPattern();
     var slugToFramework = new Map(
       import_frameworks2.frameworkList.map((f) => [f.slug, f])
     );
@@ -29664,6 +29676,18 @@ var require_detect_builders = __commonJS({
         };
       }
       const { framework } = projectSettings;
+      const proxyError = validateProxy(options, files, framework);
+      if (proxyError) {
+        return {
+          builders: null,
+          errors: [proxyError],
+          warnings: [],
+          defaultRoutes: null,
+          redirectRoutes: null,
+          rewriteRoutes: null,
+          errorRoutes: null
+        };
+      }
       const servicesConfig = services ?? experimentalServicesV2;
       const configuredServices = servicesConfig ?? experimentalServicesV1;
       const configuredServicesType = servicesConfig ? services ? "services" : "experimentalServicesV2" : "experimentalServices";
@@ -29680,6 +29704,12 @@ var require_detect_builders = __commonJS({
             ...(0, import_get_services_builders.warnIgnoredDirectories)(files, configuredServices)
           );
         }
+        if (!result.errors && options.proxy) {
+          result.builders = [
+            getProxyBuilder2(options.proxy, options.tag, options.functions),
+            ...result.builders ?? []
+          ];
+        }
         return result;
       }
       const errors = [];
@@ -29730,6 +29760,9 @@ var require_detect_builders = __commonJS({
       const apiRoutes = [];
       const dynamicRoutes = [];
       for (const fileName of sortedFiles) {
+        if (fileName === options.proxy?.entrypoint) {
+          continue;
+        }
         const apiBuilder = await maybeGetApiBuilder(fileName, apiMatches, options);
         if (apiBuilder) {
           const { routeError, apiRoute, isDynamic } = getApiRoute(
@@ -29772,6 +29805,15 @@ var require_detect_builders = __commonJS({
           fallbackEntrypoint = fileName;
         }
       }
+      if (options.proxy) {
+        const proxyBuilder = getProxyBuilder2(
+          options.proxy,
+          options.tag,
+          options.functions
+        );
+        addToUsedFunctions(proxyBuilder);
+        apiBuilders.unshift(proxyBuilder);
+      }
       if (!makeFrontendStatic && (hasBuildScript(pkg) || buildCommand || framework)) {
         frontendBuilder = detectFrontBuilder(
           pkg,
@@ -29805,13 +29847,31 @@ var require_detect_builders = __commonJS({
         } else if (apiBuilders.length && hasNoneApiFiles) {
           frontendBuilder = {
             use: "@vercel/static",
-            src: REGEX_NON_VERCEL_PLATFORM_FILES2,
+            src: getStaticFilesPattern(
+              options.proxy ? [options.proxy.entrypoint] : []
+            ),
             config: {
               zeroConfig: true
             }
           };
         }
       }
+      if (options.proxy && frontendBuilder && (0, import_is_official_runtime.isOfficialRuntime)("next", frontendBuilder.use)) {
+        return {
+          builders: null,
+          errors: [
+            {
+              code: "proxy_framework_conflict",
+              message: "The `proxy` property cannot be used with Next.js because the framework builds its own routing middleware."
+            }
+          ],
+          warnings,
+          defaultRoutes: null,
+          redirectRoutes: null,
+          rewriteRoutes: null,
+          errorRoutes: null
+        };
+      }
       const unusedFunctionError = checkUnusedFunctions(
         frontendBuilder,
         usedFunctions,
@@ -29878,7 +29938,7 @@ var require_detect_builders = __commonJS({
       };
     }
     async function maybeGetApiBuilder(fileName, apiMatches, options) {
-      const middleware = fileName === "middleware.js" || fileName === "middleware.ts";
+      const middleware = !options.proxy && (fileName === "middleware.js" || fileName === "middleware.ts");
       if (middleware && options.projectSettings?.framework === "nextjs") {
         return null;
       }
@@ -29951,6 +30011,30 @@ var require_detect_builders = __commonJS({
       const func = keys.find((key) => key === fileName || (0, import_minimatch.default)(fileName, key));
       return func ? { fnPattern: func, func: functions[func] } : { fnPattern: null, func: null };
     }
+    function getProxyBuilder2(proxy, tag, functions = {}) {
+      const { fnPattern, func } = getFunction(proxy.entrypoint, { functions });
+      const runtime = func?.runtime;
+      const config3 = {
+        zeroConfig: true,
+        middleware: true,
+        ...!runtime ? { middlewareRuntime: "nodejs" } : {},
+        ...proxy.matcher ? { middlewareMatcher: proxy.matcher } : {}
+      };
+      if (fnPattern && func) {
+        config3.functions = { [fnPattern]: func };
+        if (func.includeFiles) {
+          config3.includeFiles = func.includeFiles;
+        }
+        if (func.excludeFiles) {
+          config3.excludeFiles = func.excludeFiles;
+        }
+      }
+      return {
+        src: proxy.entrypoint,
+        use: runtime || `@vercel/node${tag ? `@${tag}` : ""}`,
+        config: config3
+      };
+    }
     function getApiMatches() {
       const config3 = { zeroConfig: true };
       return [
@@ -29966,6 +30050,63 @@ var require_detect_builders = __commonJS({
         { src: "api/**/*.rs", use: `@vercel/rust`, config: config3 }
       ];
     }
+    function validateProxyConfig3(proxy) {
+      if (typeof proxy !== "object" || typeof proxy.entrypoint !== "string" || !proxy.entrypoint) {
+        return {
+          code: "invalid_proxy",
+          message: "The `proxy` property must contain an `entrypoint` string that references a `.js` or `.ts` file."
+        };
+      }
+      const entrypoint = proxy.entrypoint;
+      const segments = entrypoint.split("/");
+      if (entrypoint.startsWith("/") || entrypoint.includes("\\") || segments.includes(".") || segments.includes("..") || /[?#\u0000-\u001f]/.test(entrypoint)) {
+        return {
+          code: "invalid_proxy_entrypoint",
+          message: "The `proxy.entrypoint` path must be relative to the project root and cannot contain traversal, query, fragment, or control characters."
+        };
+      }
+      if (!/\.(?:js|ts)$/.test(entrypoint) || entrypoint.endsWith(".d.ts")) {
+        return {
+          code: "invalid_proxy_entrypoint",
+          message: "The `proxy.entrypoint` path must end in `.js` or `.ts` and reference an executable file."
+        };
+      }
+      if (proxy.matcher !== void 0) {
+        const matchers = Array.isArray(proxy.matcher) ? proxy.matcher : [proxy.matcher];
+        if (matchers.length === 0 || matchers.some(
+          (matcher) => typeof matcher !== "string" || !matcher.startsWith("/")
+        )) {
+          return {
+            code: "invalid_proxy_matcher",
+            message: "The `proxy.matcher` value must be a path matcher starting with `/`, or an array of path matchers starting with `/`."
+          };
+        }
+      }
+      return null;
+    }
+    function validateProxy(options, files, framework) {
+      const { proxy } = options;
+      if (!proxy) {
+        return null;
+      }
+      const configError = validateProxyConfig3(proxy);
+      if (configError) {
+        return configError;
+      }
+      if (!files.includes(proxy.entrypoint)) {
+        return {
+          code: "proxy_entrypoint_not_found",
+          message: `The proxy entrypoint \`${proxy.entrypoint}\` does not exist. Set \`proxy.entrypoint\` to an existing \`.js\` or \`.ts\` file.`
+        };
+      }
+      if (framework === "nextjs" || framework === "astro") {
+        return {
+          code: "proxy_framework_conflict",
+          message: `The \`proxy\` property cannot be used with ${framework === "nextjs" ? "Next.js" : "Astro"} because the framework builds its own routing middleware.`
+        };
+      }
+      return null;
+    }
     function hasBuildScript(pkg) {
       const { scripts = {} } = pkg || {};
       return Boolean(scripts && scripts["build"]);
@@ -34924,6 +35065,7 @@ var require_dist6 = __commonJS({
       getInternalServiceWorkerPath: () => import_utils4.getInternalServiceWorkerPath,
       getInternalServiceWorkerPathPrefix: () => import_utils4.getInternalServiceWorkerPathPrefix,
       getProjectPaths: () => import_get_project_paths.getProjectPaths,
+      getProxyBuilder: () => import_detect_builders.getProxyBuilder,
       getServicesBuilders: () => import_get_services_builders.getServicesBuilders,
       getWorkspacePackagePaths: () => import_get_workspace_package_paths.getWorkspacePackagePaths,
       getWorkspaces: () => import_get_workspaces.getWorkspaces,
@@ -34937,6 +35079,7 @@ var require_dist6 = __commonJS({
       packageManagers: () => import_package_managers.packageManagers,
       resolveAllConfiguredServicesV2: () => import_resolve_v2.resolveAllConfiguredServicesV2,
       resolveConfiguredServiceV2: () => import_resolve_v2.resolveConfiguredServiceV2,
+      validateProxyConfig: () => import_detect_builders.validateProxyConfig,
       validateServiceConfigV2: () => import_resolve_v2.validateServiceConfigV2,
       workspaceManagers: () => import_workspace_managers.workspaceManagers
     });
@@ -38004,7 +38147,7 @@ var require_package = __commonJS({
   "../client/package.json"(exports, module) {
     module.exports = {
       name: "@vercel/client",
-      version: "18.1.1",
+      version: "18.2.0",
       main: "dist/index.js",
       typings: "dist/index.d.ts",
       homepage: "https://vercel.com",
@@ -56320,7 +56463,19 @@ async function performDeviceCodeFlow(client, options) {
   );
   const [deviceAuthorizationError, deviceAuthorization] = await processDeviceAuthorizationResponse(deviceAuthorizationResponse);
   if (deviceAuthorizationError) {
-    printError(deviceAuthorizationError);
+    if (options?.fallbackToLoginOnStepUpFailure && options.refreshToken && isOAuthError(deviceAuthorizationError) && (deviceAuthorizationError.code === "invalid_grant" || deviceAuthorizationError.code === "invalid_scope")) {
+      output_manager_default.debug(
+        `Step-up device authorization failed: ${deviceAuthorizationError.cause.message}`
+      );
+      output_manager_default.log("Couldn't refresh the saved login. Starting a new login.");
+      return performDeviceCodeFlow(
+        client,
+        options.teamId ? { teamId: options.teamId } : void 0
+      );
+    }
+    printError(
+      isOAuthError(deviceAuthorizationError) ? deviceAuthorizationError.cause : deviceAuthorizationError
+    );
     return null;
   }
   const { device_code, user_code, verification_uri, expiresAt, interval } = deviceAuthorization;
@@ -56481,38 +56636,47 @@ async function wait(intervalMs) {
 }
 
 // src/util/env/challenge-recovery.ts
+var RECOVERABLE_CHALLENGE_CODES = /* @__PURE__ */ new Set([
+  "challenge_required",
+  "challenge_required_email_otp",
+  "user_auth_required"
+]);
 async function withEnvChallengeRecovery(client, fn) {
+  const hadStoredSession = Boolean(
+    client.authConfig.token || client.authConfig.refreshToken
+  );
   try {
     return await fn();
   } catch (error) {
-    if (!isAPIError(error) || error.code !== "challenge_required") {
+    if (!isAPIError(error)) {
       throw error;
     }
-    const refreshToken = client.authConfig.refreshToken;
-    if (!refreshToken || client.authConfig.tokenSource || !client.stdin.isTTY) {
+    const isRecoverableChallenge = RECOVERABLE_CHALLENGE_CODES.has(error.code);
+    const isRejectedStoredSession = hadStoredSession && error.invalidToken === true;
+    if (!isRecoverableChallenge && !isRejectedStoredSession) {
+      throw error;
+    }
+    if (client.authConfig.tokenSource || !client.stdin.isTTY || client.nonInteractive) {
       throw error;
     }
     output_manager_default.stopSpinner();
     output_manager_default.log("Sensitive Environment Variables require fresh authentication.");
+    const refreshToken = client.authConfig.refreshToken;
     const acrValues = getAcrValuesFromWWWAuthenticate(error.wwwAuthenticate);
-    if (!acrValues) {
-      throw error;
-    }
-    const tokens = await performDeviceCodeFlow(client, {
+    const tokens = isRecoverableChallenge && refreshToken && acrValues ? await performDeviceCodeFlow(client, {
       refreshToken,
-      acrValues
-    });
+      acrValues,
+      fallbackToLoginOnStepUpFailure: true
+    }) : await performDeviceCodeFlow(client);
     if (!tokens) {
       throw error;
     }
     client.updateAuthConfig({
       token: tokens.access_token,
       userId: void 0,
-      expiresAt: Math.floor(Date.now() / 1e3) + tokens.expires_in
+      expiresAt: Math.floor(Date.now() / 1e3) + tokens.expires_in,
+      refreshToken: tokens.refresh_token
     });
-    if (tokens.refresh_token) {
-      client.updateAuthConfig({ refreshToken: tokens.refresh_token });
-    }
     client.persistAuthConfig();
     return await fn();
   }
@@ -57215,13 +57379,6 @@ function getGlobalPathConfig2(argvSlice = process.argv.slice(2), cwd = process.c
 // src/util/config/local-path.ts
 import path2 from "path";
 import { existsSync } from "fs";
-
-// src/util/is-vercel-toml-enabled.ts
-function isVercelTomlEnabled() {
-  return process.env.VERCEL_TOML_CONFIG_ENABLED === "1";
-}
-
-// src/util/config/local-path.ts
 function getLocalPathConfig(prefix) {
   const argv = parseArguments(process.argv.slice(2), {}, { permissive: true });
   const customPath = argv.flags["--local-config"];
@@ -57235,7 +57392,7 @@ function getLocalPathConfig(prefix) {
   const vercelTomlPath = path2.join(prefix, "vercel.toml");
   const nowConfigPath = path2.join(prefix, "now.json");
   const vercelConfigExists = existsSync(vercelConfigPath);
-  const vercelTomlExists = isVercelTomlEnabled() && existsSync(vercelTomlPath);
+  const vercelTomlExists = existsSync(vercelTomlPath);
   const nowConfigExists = existsSync(nowConfigPath);
   const foundConfigs = [];
   if (vercelConfigExists)
@@ -57367,7 +57524,7 @@ function readLocalConfig(prefix = process.cwd()) {
       } catch {
       }
     }
-    if (!sourceFile && isVercelTomlEnabled()) {
+    if (!sourceFile) {
       const tomlPath = join6(workPath, "vercel.toml");
       try {
         accessSync(tomlPath, constants.F_OK);
@@ -57998,7 +58155,7 @@ import { stat } from "fs/promises";
 import { join as join9, dirname as dirname2 } from "path";
 
 // src/util/projects/detect-services.ts
-var import_fs_detectors2 = __toESM(require_dist6(), 1);
+var import_fs_detectors3 = __toESM(require_dist6(), 1);
 import { readFile as readFile4, writeFile as writeFile2 } from "fs/promises";
 import { basename as basename3, join as join8 } from "path";
 import { parse as tomlParse, stringify as tomlStringify } from "smol-toml";
@@ -58030,6 +58187,7 @@ async function readFileSafe(file) {
 // src/util/validate-config.ts
 var import_routing_utils = __toESM(require_dist5(), 1);
 var import_client2 = __toESM(require_dist7(), 1);
+var import_fs_detectors2 = __toESM(require_dist6(), 1);
 import {
   getFunctionsSchema,
   buildsSchema,
@@ -58564,6 +58722,33 @@ var getServicesSchema = () => ({
   },
   additionalProperties: getServicesServiceConfigSchema()
 });
+var proxySchema = {
+  type: "object",
+  additionalProperties: false,
+  required: ["entrypoint"],
+  properties: {
+    entrypoint: {
+      type: "string",
+      minLength: 1
+    },
+    matcher: {
+      oneOf: [
+        {
+          type: "string",
+          minLength: 1
+        },
+        {
+          type: "array",
+          minItems: 1,
+          items: {
+            type: "string",
+            minLength: 1
+          }
+        }
+      ]
+    }
+  }
+};
 function buildVercelConfigSchema() {
   return {
     type: "object",
@@ -58582,6 +58767,7 @@ function buildVercelConfigSchema() {
       images: imagesSchema,
       crons: cronsSchema,
       bunVersion: { type: "string" },
+      proxy: proxySchema,
       experimentalServices: getExperimentalServicesSchema(),
       experimentalServiceGroups: experimentalServiceGroupsSchema,
       services: getServicesSchema(),
@@ -58600,6 +58786,15 @@ function validateConfig(config3) {
       return niceError;
     }
   }
+  if (config3.proxy) {
+    const proxyError = (0, import_fs_detectors2.validateProxyConfig)(config3.proxy);
+    if (proxyError) {
+      return new NowBuildError({
+        code: proxyError.code.toUpperCase(),
+        message: proxyError.message
+      });
+    }
+  }
   if (config3.functions && config3.builds) {
     return new NowBuildError({
       code: "FUNCTIONS_AND_BUILDS",
@@ -58607,6 +58802,12 @@ function validateConfig(config3) {
       link: "https://vercel.link/functions-and-builds"
     });
   }
+  if (config3.proxy && config3.builds) {
+    return new NowBuildError({
+      code: "PROXY_AND_BUILDS",
+      message: "The `proxy` property cannot be used with the `builds` property. Remove `builds` to use an explicit proxy entrypoint."
+    });
+  }
   const hasExperimentalServices = Boolean(config3.experimentalServices);
   if (hasExperimentalServices && config3.builds) {
     return new NowBuildError({
@@ -58754,8 +58955,8 @@ async function tryDetectServices(cwd) {
   if (!isServicesEnabled) {
     return null;
   }
-  const fs5 = new import_fs_detectors2.LocalFileSystemDetector(cwd);
-  const result = await (0, import_fs_detectors2.detectServices)({
+  const fs5 = new import_fs_detectors3.LocalFileSystemDetector(cwd);
+  const result = await (0, import_fs_detectors3.detectServices)({
     fs: fs5,
     detectEntrypoint: createDetectEntrypoint(cwd)
   });
@@ -58815,7 +59016,7 @@ function toProjectServicesConfigPatch(config3) {
 async function prepareServicesConfigWrite(cwd, config3) {
   const compileResult = await compileVercelConfig(cwd);
   const configPath = join8(cwd, "vercel.json");
-  if (isVercelTomlEnabled() && compileResult.sourceFile === "vercel.toml") {
+  if (compileResult.sourceFile === "vercel.toml") {
     return prepareTomlServicesConfigWrite(join8(cwd, "vercel.toml"), config3);
   }
   if (compileResult.wasCompiled) {
@@ -58908,7 +59109,7 @@ async function findProjectRoot(startDir) {
     }
     const hasVercelDir = await (0, import_fs_extra7.pathExists)(join9(dir, ".vercel"));
     const hasVercelJson = await (0, import_fs_extra7.pathExists)(join9(dir, "vercel.json"));
-    const hasVercelToml = isVercelTomlEnabled() && await (0, import_fs_extra7.pathExists)(join9(dir, "vercel.toml"));
+    const hasVercelToml = await (0, import_fs_extra7.pathExists)(join9(dir, "vercel.toml"));
     const hasGit = await (0, import_fs_extra7.pathExists)(join9(dir, ".git"));
     if (hasVercelDir || hasVercelJson || hasVercelToml || hasGit) {
       return dir;
@@ -59448,11 +59649,9 @@ async function findSourceVercelConfigFile(workPath) {
       return basename4(configPath);
     }
   }
-  if (isVercelTomlEnabled()) {
-    const tomlPath = join11(workPath, "vercel.toml");
-    if (await fileExists(tomlPath)) {
-      return "vercel.toml";
-    }
+  const tomlPath = join11(workPath, "vercel.toml");
+  if (await fileExists(tomlPath)) {
+    return "vercel.toml";
   }
   return null;
 }
@@ -59496,7 +59695,7 @@ async function compileVercelConfig(workPath) {
   const vercelTomlPath = join11(workPath, "vercel.toml");
   const hasVercelJson = await fileExists(vercelJsonPath);
   const hasNowJson = await fileExists(nowJsonPath);
-  const hasVercelToml = isVercelTomlEnabled() && await fileExists(vercelTomlPath);
+  const hasVercelToml = await fileExists(vercelTomlPath);
   const vercelConfigPath = await findVercelConfigFile(workPath);
   const vercelDir = join11(workPath, VERCEL_DIR);
   const compiledConfigPath = join11(vercelDir, "vercel.json");
@@ -59675,7 +59874,7 @@ async function getVercelConfigPath(workPath) {
   if (await fileExists(vercelJsonPath)) {
     return vercelJsonPath;
   }
-  if (isVercelTomlEnabled() && await fileExists(vercelTomlPath)) {
+  if (await fileExists(vercelTomlPath)) {
     return vercelTomlPath;
   }
   if (await fileExists(compiledConfigPath)) {
@@ -59726,6 +59925,7 @@ export {
   revocationRequest,
   processRevocationResponse,
   refreshTokenRequest,
+  isOAuthError,
   performDeviceCodeFlow,
   login,
   modify,
@@ -59789,7 +59989,6 @@ export {
   pull,
   envPullCommandLogic,
   require_main,
-  isVercelTomlEnabled,
   normalizeConfig,
   VERCEL_CONFIG_EXTENSIONS,
   DEFAULT_VERCEL_CONFIG_FILENAME,

package/dist/chunks/{chunk-GP5VCTEU.js → chunk-VUESC3YO.js}

@@ -14,7 +14,7 @@ import {
   getLinkedProject,
   getProjectByNameOrId,
   getScope
-} from "./chunk-TBR2Q37Y.js";
+} from "./chunk-TPX7RZBM.js";
 import {
   AGENT_REASON,
   buildCommandWithGlobalFlags,

package/dist/chunks/{chunk-A2TYQBX2.js → chunk-WANVKOVB.js}

@@ -31,10 +31,10 @@ import {
 import {
   buildCommand,
   pullCommand
-} from "./chunk-NH43BFJ3.js";
+} from "./chunk-EA22NMFU.js";
 import {
   envCommand
-} from "./chunk-TBR2Q37Y.js";
+} from "./chunk-TPX7RZBM.js";
 import {
   confirmOption,
   deploymentOption,
@@ -2440,7 +2440,7 @@ var attachSubcommand = {
       type: [String],
       argument: "ENV",
       deprecated: false,
-      description: "Environments to enable. Repeatable and comma-separated (e.g. -e production -e preview, or -e production,preview). Defaults to all environments."
+      description: "Environments to enable by system name, custom slug, or custom ID. Repeatable and comma-separated. Defaults to production, preview, and development."
     },
     {
       ...projectOption,
@@ -2462,6 +2462,14 @@ var attachSubcommand = {
       deprecated: false,
       description: "Target a specific git branch for the trigger destination (default: production). Only valid with --triggers."
     },
+    {
+      name: "trigger-environment",
+      shorthand: null,
+      type: String,
+      argument: "ENV",
+      deprecated: false,
+      description: "Target a custom environment by slug or stable ID. Mutually exclusive with --trigger-branch and only valid with --triggers."
+    },
     {
       name: "trigger-path",
       shorthand: null,
@@ -2478,13 +2486,21 @@ var attachSubcommand = {
   ],
   examples: [
     {
-      name: "Attach the current project to a connector for all environments",
+      name: "Attach the current project for all system environments",
       value: `${packageName} connect attach scl_abc123`
     },
     {
       name: "Restrict to specific environments",
       value: `${packageName} connect attach scl_abc123 -e production -e preview`
     },
+    {
+      name: "Attach to a custom environment by slug",
+      value: `${packageName} connect attach scl_abc123 -e qa`
+    },
+    {
+      name: "Attach to a custom environment by stable ID",
+      value: `${packageName} connect attach scl_abc123 -e env_qa123`
+    },
     {
       name: "Attach a different project by name",
       value: `${packageName} connect attach slack/my-bot --project my-app`
@@ -2497,6 +2513,10 @@ var attachSubcommand = {
       name: "Attach and register a preview-branch trigger destination",
       value: `${packageName} connect attach scl_abc123 --triggers --trigger-branch staging --trigger-path /slack`
     },
+    {
+      name: "Attach and register a custom-environment trigger destination",
+      value: `${packageName} connect attach scl_abc123 --triggers --trigger-environment qa --trigger-path /slack`
+    },
     {
       name: "Non-interactive output as JSON",
       value: `${packageName} connect attach scl_abc123 --yes --format=json`

package/dist/chunks/{chunk-HD7B425F.js → chunk-WDE2EDYX.js}

@@ -6,14 +6,14 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   setupAndLink
-} from "./chunk-NRNMT43R.js";
+} from "./chunk-KGVT2RSG.js";
 import {
   detectExplicitScope,
   getLinkedProject,
   param,
   printProjectNotFoundError,
   resolveProjectCwd
-} from "./chunk-TBR2Q37Y.js";
+} from "./chunk-TPX7RZBM.js";
 import {
   buildCommandWithYes,
   outputActionRequired

package/dist/chunks/{chunk-YOZCJHLZ.js → chunk-YZMZCQP3.js}

@@ -6,7 +6,7 @@ const __filename = __fileURLToPath(import.meta.url);
 const __dirname = __dirname_(__filename);
 import {
   writeProjectSettings
-} from "./chunk-3242RXCN.js";
+} from "./chunk-AZTV7WPZ.js";
 import {
   autoInstallVercelPlugin
 } from "./chunk-NJUPUGOE.js";
@@ -15,10 +15,10 @@ import {
 } from "./chunk-64IF634X.js";
 import {
   ensureLink
-} from "./chunk-HD7B425F.js";
+} from "./chunk-WDE2EDYX.js";
 import {
   pullCommand
-} from "./chunk-NH43BFJ3.js";
+} from "./chunk-EA22NMFU.js";
 import {
   help
 } from "./chunk-DMSLNAVH.js";
@@ -28,7 +28,7 @@ import {
   envPullCommandLogic,
   humanizePath,
   parseTarget
-} from "./chunk-TBR2Q37Y.js";
+} from "./chunk-TPX7RZBM.js";
 import {
   TelemetryClient
 } from "./chunk-ECCWJHC6.js";

package/dist/chunks/{chunk-IOAZNR6Z.js → chunk-ZMVFTCQF.js}

@@ -8,7 +8,7 @@ import {
   formatCondition,
   formatTransform,
   isTargetTransform
-} from "./chunk-555WJSO5.js";
+} from "./chunk-DGFASMSE.js";
 import {
   output_manager_default
 } from "./chunk-OX7KI3LF.js";