openxiangda 1.0.230 → 1.0.232

package/lib/delivery-v2-cli.js

@@ -0,0 +1,216 @@
+const crypto = require('crypto');
+const { createDeliveryV2Executor } = require('./delivery-v2-executor');
+const { parseArgs, print, warn, writeJson } = require('./utils');
+
+function createDeliveryV2Cli(dependencies) {
+  const deps = assertDependencies(dependencies);
+  const executor = createDeliveryV2Executor(deps);
+
+  async function run(command, argv = []) {
+    const { flags, positional } = parseArgs(argv);
+    if (flags.help || flags.h) {
+      printHelp(command);
+      return;
+    }
+    const config = deps.loadConfig();
+    if (command === 'check') {
+      const target = resolveTarget(config, flags, positional, false);
+      const inspected = await executor.inspect({
+        config,
+        target,
+        workspaceRoot: process.cwd(),
+        skipBuild: flags.build !== true,
+        buildCommand: stringFlag(flags, 'build-command'),
+        distDir: stringFlag(flags, 'dist'),
+        onBuildOutput: buildOutput(flags),
+      });
+      return output(
+        flags,
+        {
+          ok: true,
+          appType: target.appType,
+          environment: target.targetName || target.environmentKind || null,
+          packageDigest: inspected.compiled.packageDigest,
+          summary: inspected.compiled.summary,
+          targets: inspected.targets,
+          previousPackageDigest: inspected.previous?.packageDigest || null,
+        },
+        `Delivery V2 检查通过: ${inspected.compiled.packageDigest}`
+      );
+    }
+    if (command === 'deploy') {
+      const target = resolveTarget(config, flags, positional, true);
+      const packageDigest = stringFlag(flags, 'package');
+      const result = await executor.deploy({
+        config,
+        target,
+        workspaceRoot: process.cwd(),
+        packageDigest,
+        buildCommand: stringFlag(flags, 'build-command'),
+        distDir: stringFlag(flags, 'dist'),
+        clientSessionId: createClientSessionId(),
+        onBuildOutput: buildOutput(flags),
+      });
+      return output(
+        flags,
+        result,
+        `Delivery V2 发布成功: run=${result.run.id} package=${result.packageDigest}`
+      );
+    }
+    if (command === 'status') {
+      const runId = positional[0] || stringFlag(flags, 'run');
+      if (!runId) {
+        throw usageError('用法: openxiangda status <runId> [--json]');
+      }
+      const target = resolveTarget(config, flags, [], false);
+      const result = await executor.status({ config, target, runId });
+      return output(
+        flags,
+        result,
+        `Delivery V2: run=${result.id} status=${result.status} stage=${result.stage}`
+      );
+    }
+    if (command === 'retry') {
+      const runId = positional[0] || stringFlag(flags, 'run');
+      if (!runId) {
+        throw usageError('用法: openxiangda retry <runId> [--json]');
+      }
+      const target = resolveTarget(config, flags, [], false);
+      const result = await executor.retry({
+        config,
+        target,
+        runId,
+        workspaceRoot: process.cwd(),
+      });
+      return output(
+        flags,
+        result,
+        `Delivery V2 重试成功: run=${result.run.id} status=${result.run.status}`
+      );
+    }
+    if (command === 'rollback') {
+      const target = resolveTarget(config, flags, positional, true);
+      const releaseId = stringFlag(flags, 'to');
+      if (!releaseId) {
+        throw usageError(
+          '用法: openxiangda rollback <environment> --to <appReleaseId>'
+        );
+      }
+      const result = await executor.rollback({
+        config,
+        target,
+        releaseId,
+        workspaceRoot: process.cwd(),
+        clientSessionId: createClientSessionId(),
+      });
+      return output(
+        flags,
+        result,
+        `Delivery V2 回滚成功: run=${result.run.id} package=${result.packageDigest}`
+      );
+    }
+    throw usageError(`未知 Delivery V2 命令: ${command}`);
+  }
+
+  function resolveTarget(config, flags, positional, environmentRequired) {
+    const environment =
+      positional[0] ||
+      stringFlag(flags, 'environment') ||
+      stringFlag(flags, 'target');
+    if (environmentRequired && !environment) {
+      throw usageError(
+        '必须指定环境，例如 openxiangda deploy preproduction'
+      );
+    }
+    return deps.getWorkspaceTarget(
+      config,
+      stringFlag(flags, 'profile') || config.currentProfile,
+      {
+        ...flags,
+        ...(environment ? { environment } : {}),
+      }
+    );
+  }
+
+  return { run };
+}
+
+function output(flags, value, message) {
+  if (flags.json) return writeJson(value);
+  print(message);
+  if (value?.run?.failure?.code) {
+    warn(
+      `${value.run.failure.code}: ${value.run.failure.message || '发布失败'}`
+    );
+  }
+  return value;
+}
+
+function buildOutput(flags) {
+  if (flags.json || flags.quiet) return undefined;
+  return (stream, text) => {
+    if (stream === 'stderr') warn(text.trimEnd());
+    else print(text.trimEnd());
+  };
+}
+
+function stringFlag(flags, name) {
+  const value = flags?.[name];
+  if (value === undefined || value === null || value === false) return '';
+  return String(value).trim();
+}
+
+function createClientSessionId() {
+  return `delivery-v2-${process.pid}-${crypto
+    .randomBytes(10)
+    .toString('hex')}`;
+}
+
+function usageError(message) {
+  const error = new Error(message);
+  error.code = 'DELIVERY_USAGE_ERROR';
+  error.retryable = false;
+  return error;
+}
+
+function printHelp(command) {
+  const lines = {
+    check: [
+      '用法: openxiangda check [--environment <name>] [--build] [--json]',
+      '编译并校验 App Package V2；默认复用现有 dist，不执行 Runtime 构建。',
+    ],
+    deploy: [
+      '用法: openxiangda deploy <environment> [--package <sha256>] [--json]',
+      '不带 --package 时从当前工作区构建；带 --package 时直接部署已封存制品。',
+    ],
+    status: ['用法: openxiangda status <runId> [--json]'],
+    retry: ['用法: openxiangda retry <runId> [--json]'],
+    rollback: [
+      '用法: openxiangda rollback <environment> --to <appReleaseId> [--json]',
+    ],
+  };
+  print((lines[command] || ['Delivery V2']).join('\n'));
+}
+
+function assertDependencies(value) {
+  const required = [
+    'clearDeliveryContext',
+    'downloadWithAuth',
+    'getWorkspaceTarget',
+    'installDeliveryContext',
+    'loadConfig',
+    'requestFormWithAuth',
+    'requestWithAuth',
+    'runOpenXiangdaInProcess',
+  ];
+  for (const key of required) {
+    if (typeof value?.[key] !== 'function') {
+      throw new Error(`Delivery V2 CLI dependency 缺失: ${key}`);
+    }
+  }
+  return value;
+}
+
+module.exports = {
+  createDeliveryV2Cli,
+};