@ranger1/dx 0.1.108 → 0.1.110

package/lib/backend-artifact-deploy/config.js

@@ -16,6 +16,36 @@ function requirePositiveInteger(value, fieldPath) {
   return parsed
 }
 
+function requireEnvName(value, fieldPath) {
+  const name = requireString(value, fieldPath)
+  if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
+    throw new Error(`缺少必填配置: ${fieldPath}`)
+  }
+  return name
+}
+
+function resolveHealthCheckEndpoint(healthCheckConfig) {
+  if (healthCheckConfig.url != null) {
+    const url = requireString(healthCheckConfig.url, 'verify.healthCheck.url')
+    try {
+      new URL(url)
+    } catch {
+      throw new Error(`缺少必填配置: verify.healthCheck.url`)
+    }
+    return { url }
+  }
+
+  if (healthCheckConfig.envPort != null) {
+    const rawPath = healthCheckConfig.path == null ? '/health' : requireString(healthCheckConfig.path, 'verify.healthCheck.path')
+    return {
+      envPort: requireEnvName(healthCheckConfig.envPort, 'verify.healthCheck.envPort'),
+      path: rawPath.startsWith('/') ? rawPath : `/${rawPath}`,
+    }
+  }
+
+  throw new Error(`缺少必填配置: verify.healthCheck.url`)
+}
+
 function resolveVerifyConfig(verifyConfig = {}) {
   const healthCheckConfig = verifyConfig?.healthCheck
   if (healthCheckConfig == null) {
@@ -24,16 +54,9 @@ function resolveVerifyConfig(verifyConfig = {}) {
     }
   }
 
-  const url = requireString(healthCheckConfig.url, 'verify.healthCheck.url')
-  try {
-    new URL(url)
-  } catch {
-    throw new Error(`缺少必填配置: verify.healthCheck.url`)
-  }
-
   return {
     healthCheck: {
-      url,
+      ...resolveHealthCheckEndpoint(healthCheckConfig),
       timeoutSeconds:
         healthCheckConfig.timeoutSeconds == null
           ? 10

package/lib/backend-artifact-deploy/remote-script.js

@@ -32,6 +32,8 @@ export function buildRemoteDeployScript(phaseModel = []) {
   const shouldMigrate = deploy.prismaMigrateDeploy !== false && deploy.skipMigration !== true
   const shouldSeed = deploy.prismaSeed === true
   const healthCheckUrl = healthCheck?.url ? String(healthCheck.url) : ''
+  const healthCheckEnvPort = healthCheck?.envPort ? String(healthCheck.envPort) : ''
+  const healthCheckPath = healthCheck?.path ? String(healthCheck.path) : ''
   const healthCheckTimeoutSeconds = Number(healthCheck?.timeoutSeconds || 10)
   const healthCheckMaxWaitSeconds = Number(healthCheck?.maxWaitSeconds || 24)
   const healthCheckRetryIntervalSeconds = Number(healthCheck?.retryIntervalSeconds || 2)
@@ -57,6 +59,8 @@ START_MODE=${escapeShell(startupMode)}
 SERVICE_NAME=${escapeShell(serviceName)}
 START_ENTRY=${escapeShell(startupEntry)}
 HEALTHCHECK_URL=${escapeShell(healthCheckUrl)}
+HEALTHCHECK_ENV_PORT=${escapeShell(healthCheckEnvPort)}
+HEALTHCHECK_PATH=${escapeShell(healthCheckPath)}
 HEALTHCHECK_TIMEOUT_SECONDS=${healthCheckTimeoutSeconds}
 HEALTHCHECK_MAX_WAIT_SECONDS=${healthCheckMaxWaitSeconds}
 HEALTHCHECK_RETRY_DELAY_SECONDS=${healthCheckRetryIntervalSeconds}
@@ -226,6 +230,34 @@ read_pm2_status() {
   ' "$SERVICE_NAME"
 }
 
+resolve_healthcheck_url() {
+  if [[ -n "$HEALTHCHECK_URL" ]]; then
+    printf '%s\n' "$HEALTHCHECK_URL"
+    return
+  fi
+
+  if [[ -z "$HEALTHCHECK_ENV_PORT" ]]; then
+    return
+  fi
+
+  local healthcheck_port
+  healthcheck_port="$(run_with_env "$CURRENT_LINK" env | awk -F= -v key="$HEALTHCHECK_ENV_PORT" '$1 == key { print substr($0, index($0, "=") + 1); exit }')"
+  if ! [[ "$healthcheck_port" =~ ^[0-9]+$ ]]; then
+    echo "health check port env $HEALTHCHECK_ENV_PORT is missing or invalid" >&2
+    exit 1
+  fi
+
+  if [[ -z "$HEALTHCHECK_PATH" ]]; then
+    HEALTHCHECK_PATH="/health"
+  fi
+  if [[ "$HEALTHCHECK_PATH" != /* ]]; then
+    HEALTHCHECK_PATH="/$HEALTHCHECK_PATH"
+  fi
+
+  HEALTHCHECK_URL="http://127.0.0.1:\${healthcheck_port}\${HEALTHCHECK_PATH}"
+  printf '%s\n' "$HEALTHCHECK_URL"
+}
+
 build_summary_json() {
   local release_name="$1"
   local current_release_path="$2"
@@ -436,6 +468,8 @@ if [[ "$START_MODE" == "pm2" ]]; then
   fi
 fi
 
+HEALTHCHECK_URL="$(resolve_healthcheck_url)"
+
 if [[ -n "$HEALTHCHECK_URL" ]]; then
   healthcheck_started_at="$(date +%s)"
   until curl -fsS --max-time "$HEALTHCHECK_TIMEOUT_SECONDS" "$HEALTHCHECK_URL" >/dev/null; do

package/lib/vercel-deploy.js

@@ -38,10 +38,10 @@ const TARGET_CONFIGS = {
 
 const ALLOWED_DEPLOY_MODES = ['prebuilt']
 
-const APP_ENV_MAP = {
-  development: 'dev',
-  staging: 'staging',
-  production: 'prod'
+const DX_ENV_FLAG_MAP = {
+  development: '--dev',
+  staging: '--staging',
+  production: '--prod'
 }
 
 const VERCEL_PROJECT_LINK_PATH = '.vercel/project.json'
@@ -351,8 +351,7 @@ export async function deployToVercel(target, options = {}) {
   // - 前置构建/生成（shared/contracts/backend 等）应由项目自己的 Nx 依赖图或 Vercel buildCommand 负责。
   // - 这样 dx deploy 能兼容不同 monorepo 布局（不强依赖 apps/sdk 等目录）。
 
-  // 映射环境标识：development -> dev, staging -> staging, production -> prod
-  const buildEnv = APP_ENV_MAP[environment]
+  const dxEnvFlag = DX_ENV_FLAG_MAP[environment]
 
   for (const t of targets) {
     const targetConfig = getTargetConfig(t)
@@ -425,7 +424,10 @@ export async function deployToVercel(target, options = {}) {
     const envVars = {
       ...process.env,
       VERCEL_PROJECT_ID: projectId,
-      APP_ENV: buildEnv,
+      APP_ENV: environment,
+      NEXT_PUBLIC_APP_ENV: environment,
+      VITE_APP_ENV: environment,
+      DX_ENV_FLAG: dxEnvFlag,
       NODE_ENV: envManager.mapAppEnvToNodeEnv(environment),
       VERCEL_ORG_ID: orgId
     }

package/package.json

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