@ranger1/dx 0.1.57 → 0.1.58

package/lib/vercel-deploy.js

@@ -12,18 +12,24 @@ const TARGET_CONFIGS = {
     configFile: 'vercel.front.json',
     projectIdEnvVar: 'VERCEL_PROJECT_ID_FRONT',
     deployCwd: 'apps/front',
+    deployMode: 'prebuilt',
+    prebuiltCwd: '.',
   },
   admin: {
     configFile: 'vercel.admin.json',
     projectIdEnvVar: 'VERCEL_PROJECT_ID_ADMIN',
     deployCwd: 'apps/admin-front',
+    deployMode: 'prebuilt',
   },
   'telegram-bot': {
     configFile: 'vercel.telegram-bot.json',
     projectIdEnvVar: 'VERCEL_PROJECT_ID_TELEGRAM_BOT',
+    deployMode: 'prebuilt',
   },
 }
 
+const ALLOWED_DEPLOY_MODES = ['prebuilt']
+
 const APP_ENV_MAP = {
   development: 'dev',
   staging: 'staging',
@@ -53,6 +59,14 @@ function isMissingFilesError(err) {
   )
 }
 
+function isNextPrebuiltMissingPathError(err) {
+  const text = collectErrorText(err)
+  return (
+    text.includes('ENOENT') &&
+    (text.includes('next-server.js') || text.includes('/node_modules/.pnpm/'))
+  )
+}
+
 function listMissingVarKeys(targetConfigs, token, orgId) {
   const missing = []
 
@@ -102,6 +116,20 @@ export function resolveTargetRunCwd(projectRoot, targetConfig) {
   return join(projectRoot, targetConfig.deployCwd)
 }
 
+export function resolveTargetDeployMode(targetConfig) {
+  if (!targetConfig?.deployMode) return 'prebuilt'
+  return targetConfig.deployMode
+}
+
+export function isSupportedDeployMode(mode) {
+  return ALLOWED_DEPLOY_MODES.includes(mode)
+}
+
+export function resolveTargetPrebuiltCwd(projectRoot, targetConfig, runCwd) {
+  if (!targetConfig?.prebuiltCwd) return runCwd
+  return join(projectRoot, targetConfig.prebuiltCwd)
+}
+
 function maskIdentifier(value) {
   const raw = String(value || '').trim()
   if (raw.length <= 10) return raw || '-'
@@ -302,6 +330,8 @@ export async function deployToVercel(target, options = {}) {
     const configFile = targetConfig.configFile
     const configPath = join(projectRoot, configFile)
     const runCwd = resolveTargetRunCwd(projectRoot, targetConfig)
+    const deployMode = resolveTargetDeployMode(targetConfig)
+    const prebuiltCwd = resolveTargetPrebuiltCwd(projectRoot, targetConfig, runCwd)
 
     if (!existsSync(runCwd)) {
       logger.error(`部署目录不存在: target=${t} deployCwd=${targetConfig.deployCwd || '.'} resolved=${runCwd}`)
@@ -309,7 +339,22 @@ export async function deployToVercel(target, options = {}) {
       return
     }
 
-    const linkedContext = readLinkedProjectContext(runCwd)
+    if (!isSupportedDeployMode(deployMode)) {
+      logger.error(`不支持的部署模式: target=${t} mode=${deployMode}`)
+      logger.info(`可用部署模式: ${ALLOWED_DEPLOY_MODES.join(', ')}`)
+      process.exitCode = 1
+      return
+    }
+
+    if (!existsSync(prebuiltCwd)) {
+      logger.error(
+        `预构建部署目录不存在: target=${t} prebuiltCwd=${targetConfig.prebuiltCwd || targetConfig.deployCwd || '.'} resolved=${prebuiltCwd}`,
+      )
+      process.exitCode = 1
+      return
+    }
+
+    const linkedContext = readLinkedProjectContext(prebuiltCwd)
 
     const linkedMismatch =
       linkedContext.exists &&
@@ -343,7 +388,7 @@ export async function deployToVercel(target, options = {}) {
     }
 
     logger.info(
-      `[deploy-context] env=${environment} target=${t} strict=${strictContext ? 1 : 0} org=${maskIdentifier(orgId)} project=${maskIdentifier(projectId)} linked=${linkedContext.exists ? 'yes' : 'no'} token=env`,
+      `[deploy-context] env=${environment} target=${t} mode=${deployMode} runCwd=${runCwd} prebuiltCwd=${prebuiltCwd} strict=${strictContext ? 1 : 0} org=${maskIdentifier(orgId)} project=${maskIdentifier(projectId)} linked=${linkedContext.exists ? 'yes' : 'no'} token=env`,
     )
 
     const envVars = {
@@ -374,7 +419,7 @@ export async function deployToVercel(target, options = {}) {
 
     try {
       if (strictContext && process.env.DX_VERCEL_KEEP_LINK !== '1') {
-        clearLinkedProjectContext(runCwd)
+        clearLinkedProjectContext(prebuiltCwd)
       }
 
       // 第一步：本地构建
@@ -394,8 +439,8 @@ export async function deployToVercel(target, options = {}) {
       await run(buildArgs, { env: envVars, cwd: runCwd })
       logger.success(`${t} 本地构建成功`)
 
-      // 第二步：上传预构建产物
       logger.step(`部署 ${t} 到 Vercel (${environment})`)
+
       const baseDeployArgs = appendTargetArgs(
         ['deploy', '--prebuilt', '--local-config', configPath, '--yes'],
         {
@@ -411,7 +456,7 @@ export async function deployToVercel(target, options = {}) {
       const deployResult = await deployPrebuiltWithFallback({
         baseArgs: baseDeployArgs,
         env: envVars,
-        cwd: runCwd,
+        cwd: prebuiltCwd,
         run,
       })
 
@@ -432,6 +477,11 @@ export async function deployToVercel(target, options = {}) {
         logger.success(`${t} 部署成功`)
       }
     } catch (error) {
+      if (deployMode === 'prebuilt' && isNextPrebuiltMissingPathError(error)) {
+        logger.error(
+          '高优先级提示：检测到 Next.js 预构建产物缺失（next-server.js/node_modules/.pnpm）。请检查 front prebuiltCwd 与构建产物路径是否一致。',
+        )
+      }
       const message = error?.message || String(error)
       logger.error(`${t} 构建或部署失败: ${message}`)
       process.exitCode = 1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ranger1/dx",
-  "version": "0.1.57",
+  "version": "0.1.58",
   "type": "module",
   "license": "MIT",
   "repository": {