shipup 0.2.0

package/lib/harmony.mjs

@@ -0,0 +1,190 @@
+// AppGallery Connect Publishing API v3（HarmonyOS 应用/元服务 .app 包）。
+// 链路：预签名 OBS 传包 → app-package-info 登记 → 轮询编译解析 → （可选 newFeatures）→ app-submit 提审。
+// 依据官方 2026-06-25 版文档（agc-help-publish-api-guide-0000002271134665）。
+import { createHash } from "node:crypto";
+import { readFileSync, statSync, createReadStream, existsSync } from "node:fs";
+import { resolve, basename } from "node:path";
+import { request as httpsRequest } from "node:https";
+import {
+  CliError, ExitCode, log, agc, agcAuth, sleep, remainingMs, resolveValue, readZipEntry,
+} from "./common.mjs";
+
+// releaseState（releaseType=1 全网）→ 归一化状态
+const RELEASE_STATE = {
+  0: ["published", "已上架"],
+  1: ["rejected", "上架审核不通过"],
+  2: ["offline", "已下架（含强制下架）"],
+  3: ["approved", "待上架（预约上架）"],
+  4: ["pending_review", "审核中"],
+  5: ["pending_review", "升级审核中"],
+  6: ["pending_review", "申请下架（下架审核中）"],
+  7: ["draft", "草稿"],
+  8: ["rejected", "升级审核不通过"],
+  9: ["rejected", "下架审核不通过"],
+  10: ["offline", "应用被开发者下架"],
+  11: ["skipped", "撤销上架"],
+  12: ["pending_review", "预审中"],
+  13: ["rejected", "预审不通过"],
+};
+
+function requireAppId(creds) {
+  if (!creds.app_id) throw new CliError(ExitCode.CREDS, "harmony 凭证缺少 app_id（AGC → 我的APP → 查看应用信息）");
+}
+
+export function mapReleaseState(state) {
+  return RELEASE_STATE[state] ?? ["failed", `未知 releaseState=${state}`];
+}
+
+export function readPackInfo(filePath) {
+  try {
+    const raw = readZipEntry(readFileSync(filePath), "pack.info");
+    const app = raw && JSON.parse(raw.toString("utf8"))?.summary?.app;
+    return app ? { bundleName: app.bundleName, versionName: app.version?.name, versionCode: app.version?.code } : null;
+  } catch {
+    return null;
+  }
+}
+
+// 预签名 OBS PUT：流式上传，原样回放 urlInfo.headers
+function obsUpload(urlInfo, filePath, size, deadline) {
+  return new Promise((resolvePromise, reject) => {
+    const req = httpsRequest(new URL(urlInfo.url), {
+      method: urlInfo.method || "PUT",
+      headers: { ...(urlInfo.headers ?? {}), "Content-Length": size },
+      timeout: remainingMs(deadline),
+    }, (res) => {
+      let body = "";
+      res.on("data", (c) => (body += c));
+      res.on("end", () => {
+        if (res.statusCode === 200) resolvePromise();
+        else reject(new CliError(ExitCode.FAIL, `文件上传失败 HTTP ${res.statusCode}: ${body.slice(0, 300)}`, String(res.statusCode)));
+      });
+    });
+    req.on("timeout", () => req.destroy(new Error("upload timeout")));
+    req.on("error", (e) => reject(new CliError(ExitCode.FAIL, `文件上传失败: ${e.message}`)));
+    createReadStream(filePath).on("error", (e) => req.destroy(e)).pipe(req);
+  });
+}
+
+async function updateReleaseNote(creds, auth, opts, deadline) {
+  const lang = opts.lang || creds.default_lang || "zh-CN";
+  const note = resolveValue(opts.releaseNote, process.cwd());
+  if (note.length > 500) throw new CliError(ExitCode.USAGE, `release note 超长（${note.length} > 500）`);
+  await agc("PUT", "/publish/v3/app-language-info", {
+    auth,
+    query: { appId: creds.app_id },
+    body: { lang, newFeatures: note },
+  }, deadline);
+  log(`✓ 已更新 newFeatures（${lang}，${note.length} 字）`);
+  return { lang, length: note.length };
+}
+
+export async function upload(creds, opts, deadline) {
+  requireAppId(creds);
+  const pkgPath = resolve(opts.package);
+  if (!existsSync(pkgPath)) throw new CliError(ExitCode.MISSING_INPUT, `软件包不存在: ${pkgPath}`);
+  const size = statSync(pkgPath).size;
+  const info = readPackInfo(pkgPath);
+  if (info) {
+    log(`软件包: ${basename(pkgPath)}（${(size / 1024 / 1024).toFixed(1)}MB）`);
+    log(`  bundleName=${info.bundleName} versionName=${info.versionName} versionCode=${info.versionCode}`);
+    if (creds.package_name && info.bundleName !== creds.package_name) {
+      throw new CliError(ExitCode.MISSING_INPUT,
+        `包名不匹配: 软件包是 ${info.bundleName}，凭证 package_name 是 ${creds.package_name}（防止传错 app）`);
+    }
+  } else {
+    log(`软件包: ${basename(pkgPath)}（${(size / 1024 / 1024).toFixed(1)}MB）— pack.info 解析失败，跳过包名校验`);
+  }
+
+  if (opts.dryRun) {
+    log(`[dry-run] 将上传到 appId=${creds.app_id}，不发请求`);
+    return { status: "skipped", message: "dry-run", ...info };
+  }
+
+  log("计算 SHA256 …");
+  const sha256 = createHash("sha256").update(readFileSync(pkgPath)).digest("hex");
+  const auth = await agcAuth(creds, deadline);
+
+  log("获取上传地址 …");
+  const query = { appId: creds.app_id, fileName: basename(pkgPath), contentLength: String(size), sha256 };
+  if (creds.chinese_mainland_flag) query.chineseMainlandFlag = creds.chinese_mainland_flag;
+  const { urlInfo } = await agc("GET", "/publish/v2/upload-url/for-obs", { auth, query }, deadline);
+
+  log("上传软件包 …");
+  await obsUpload(urlInfo, pkgPath, size, deadline);
+  log("✓ 上传完成");
+
+  const { packageId } = await agc("PUT", "/publish/v3/app-package-info", {
+    auth,
+    query: { appId: creds.app_id },
+    body: { fileName: basename(pkgPath), objectId: urlInfo.objectId },
+  }, deadline);
+  log(`✓ 软件包已登记 packageId=${packageId}`);
+
+  if (!opts.noWait) {
+    log("等待编译解析（约 2 分钟）…");
+    for (;;) {
+      await sleep(15_000, deadline);
+      const { pkgStateList } = await agc("GET", "/publish/v3/package/compile/status", {
+        auth,
+        query: { appId: creds.app_id, pkgIds: packageId },
+      }, deadline);
+      const state = pkgStateList?.[0]?.successStatus;
+      if (state === 0) { log("✓ 解析正常，可提交审核"); break; }
+      if (state === 2) throw new CliError(ExitCode.FAIL, "软件包解析失败（successStatus=2），该包不可用", "compile_failed");
+      log("  … 解析中");
+    }
+  }
+
+  let noteInfo;
+  if (opts.releaseNote) noteInfo = await updateReleaseNote(creds, auth, opts, deadline);
+
+  return { status: "uploaded", packageId, ...info, releaseNote: noteInfo };
+}
+
+export async function submit(creds, opts, deadline) {
+  requireAppId(creds);
+  const body = { releaseType: 1, releasePhase: opts.phased ? 3 : 0 };
+  if (opts.remark) body.remark = opts.remark;
+  if (opts.releaseTime) body.releaseTime = opts.releaseTime;
+  if (opts.phased) body.phasedReleaseDescription = opts.phasedDesc;
+
+  if (opts.dryRun) {
+    log(`[dry-run] 将提交发布 appId=${creds.app_id} body=${JSON.stringify(body)}`);
+    return { status: "skipped", message: "dry-run" };
+  }
+  const auth = await agcAuth(creds, deadline);
+  let noteInfo;
+  if (opts.releaseNote) noteInfo = await updateReleaseNote(creds, auth, opts, deadline);
+
+  await agc("POST", "/publish/v3/app-submit", { auth, query: { appId: creds.app_id }, body }, deadline);
+  log(`✓ 已提交审核（${opts.phased ? "分阶段发布" : "全网发布"}${opts.releaseTime ? `，上架时间 ${opts.releaseTime}` : ""}）`);
+  return { status: "submitted", phased: !!opts.phased, releaseNote: noteInfo };
+}
+
+export async function status(creds, opts, deadline) {
+  requireAppId(creds);
+  if (opts.dryRun) return { status: "skipped", message: "dry-run" };
+  const auth = await agcAuth(creds, deadline);
+  const res = await agc("GET", "/publish/v3/app-info", {
+    auth,
+    query: { appId: creds.app_id, lang: opts.lang || creds.default_lang || "zh-CN" },
+  }, deadline);
+  const a = res.appInfo ?? {};
+  const [normalized, label] = mapReleaseState(a.releaseState);
+  const auditOpinion = res.auditInfo?.auditOpinion || "";
+  log(`releaseState=${a.releaseState}（${label}）`);
+  log(`  提审版本: ${a.versionNumber ?? "-"}（versionCode=${a.versionCode ?? "-"}）  在架版本: ${a.onShelfVersionNumber ?? "-"}`);
+  if (auditOpinion) log(`  审核意见: ${auditOpinion}`);
+  return {
+    status: normalized,
+    message: label,
+    releaseState: a.releaseState,
+    versionName: a.versionNumber,
+    versionCode: a.versionCode,
+    onShelfVersionName: a.onShelfVersionNumber,
+    reviewState: a.reviewState,
+    auditOpinion,
+    releaseTime: a.releaseTime,
+  };
+}

package/lib/huawei.mjs

@@ -0,0 +1,153 @@
+// 华为应用市场（AppGallery，安卓 APK），Publish API v2。
+// 发布链路：
+//   取上传地址(upload-url?suffix=apk) → multipart 直传（authCode）→ app-file-info 绑定（fileType=5）
+//   →（可选 newFeatures）→（可选 --submit-review：app-submit，204144727 处理中自动重试 ≤30 次）。
+// 已知坑：取地址返回的字段拼写是 fileDestUlr，绑定接口要的是 fileDestUrl，序列化时统一修正。
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, basename } from "node:path";
+import {
+  CliError, ExitCode, log, agc, agcAuth, fetchJson, sleep, resolveValue, AGC_API_BASE,
+} from "./common.mjs";
+
+const V2 = "/publish/v2";
+
+// 华为安卓 releaseState → 归一化
+export function mapReleaseState(state) {
+  switch (state) {
+    case 0: return ["published", "已上架"];
+    case 1: case 8: case 9: case 13: return ["rejected", "审核不通过"];
+    case 3: case 4: case 5: case 12: return ["pending_review", "审核/预审中"];
+    case 2: case 6: case 10: case 11: return ["offline", "已下架/撤销"];
+    case 7: return ["uploaded", "草稿"];
+    default: return ["submitted", `releaseState=${state}（暂无更细状态）`];
+  }
+}
+
+function requireAppId(creds) {
+  if (!creds.app_id) throw new CliError(ExitCode.CREDS, "huawei 凭证缺少 app_id（AGC → 我的APP，安卓应用的 ID）");
+}
+
+/** multipart 直传文件到华为文件服务器，返回 fileInfoList。 */
+async function uploadFileMultipart(auth, creds, bytes, fileName, deadline) {
+  const suffix = fileName.split(".").pop();
+  const { uploadUrl, authCode } = await agc("GET", `${V2}/upload-url`, {
+    auth,
+    query: { appId: creds.app_id, suffix },
+  }, deadline);
+  if (!uploadUrl || !authCode) throw new CliError(ExitCode.FAIL, "取上传地址响应缺少 uploadUrl/authCode");
+
+  const form = new FormData();
+  form.append("authCode", authCode);
+  form.append("fileCount", "1");
+  form.append("parseType", "0");
+  form.append("file", new Blob([bytes]), fileName);
+
+  // 不手动设 Content-Type，交给 fetch 生成 multipart boundary
+  const data = await fetchJson(uploadUrl, { method: "POST", headers: { ...auth }, body: form }, deadline);
+  const rsp = data?.result?.UploadFileRsp;
+  if (!rsp || !Array.isArray(rsp.fileInfoList) || rsp.fileInfoList.length === 0) {
+    throw new CliError(ExitCode.FAIL, `上传响应缺少 fileInfoList: ${JSON.stringify(rsp ?? data).slice(0, 300)}`);
+  }
+  rsp.fileInfoList[0].fileName = fileName;
+  return rsp.fileInfoList;
+}
+
+/** app-file-info 绑定（华为接口要 fileDestUrl，上游返回的是拼写错误的 fileDestUlr，需修正）。 */
+async function bindFileInfo(auth, creds, fileType, files, deadline) {
+  const serialized = JSON.stringify({ fileType, files, lang: "zh-CN" }).replace(/fileDestUlr/g, "fileDestUrl");
+  const res = await fetchJson(`${AGC_API_BASE}${V2}/app-file-info?appId=${creds.app_id}`, {
+    method: "PUT",
+    headers: { ...auth, "Content-Type": "application/json" },
+    body: serialized,
+  }, deadline);
+  if (res.ret && Number(res.ret.code) !== 0) {
+    throw new CliError(ExitCode.FAIL, `app-file-info 失败: [${res.ret.code}] ${res.ret.msg}`, String(res.ret.code));
+  }
+}
+
+async function updateReleaseNote(creds, auth, opts, deadline) {
+  const lang = opts.lang || creds.default_lang || "zh-CN";
+  const note = resolveValue(opts.releaseNote, process.cwd());
+  if (note.length > 500) throw new CliError(ExitCode.USAGE, `release note 超长（${note.length} > 500）`);
+  await agc("PUT", `${V2}/app-language-info`, {
+    auth,
+    query: { appId: creds.app_id },
+    body: { lang, newFeatures: note },
+  }, deadline);
+  log(`✓ 已更新 newFeatures（${lang}，${note.length} 字）`);
+  return { lang, length: note.length };
+}
+
+/** 提交审核：ret.code==0 成功；204144727 表示服务端处理中，2s 后重试（≤30 次）。 */
+async function submitReview(creds, auth, deadline) {
+  const body = { requestId: creds.package_name || String(Date.now()) };
+  for (let attempt = 0; attempt < 30; attempt++) {
+    const res = await fetchJson(`${AGC_API_BASE}${V2}/app-submit?appId=${creds.app_id}`, {
+      method: "POST",
+      headers: { ...auth, "Content-Type": "application/json" },
+      body: JSON.stringify(body),
+    }, deadline);
+    const code = Number(res?.ret?.code ?? -1);
+    if (code === 0) return;
+    if (code === 204144727) {
+      log("  … 服务端处理中，2s 后重试提审");
+      await sleep(2000, deadline);
+      continue;
+    }
+    throw new CliError(ExitCode.FAIL, `提交审核失败: [${code}] ${res?.ret?.msg ?? ""}`, String(code));
+  }
+  throw new CliError(ExitCode.FAIL, "提交审核失败：处理中状态重试超过 30 次", "204144727");
+}
+
+export async function upload(creds, opts, deadline) {
+  requireAppId(creds);
+  const pkgPath = resolve(opts.package);
+  if (!existsSync(pkgPath)) throw new CliError(ExitCode.MISSING_INPUT, `APK 不存在: ${pkgPath}`);
+  if (!pkgPath.endsWith(".apk")) throw new CliError(ExitCode.MISSING_INPUT, "huawei upload 只接受 .apk");
+  const bytes = readFileSync(pkgPath);
+  log(`APK: ${basename(pkgPath)}（${(bytes.length / 1024 / 1024).toFixed(1)}MB）`);
+
+  if (opts.dryRun) {
+    log(`[dry-run] 将上传到 appId=${creds.app_id}${opts.submitReview ? " 并提交审核" : ""}，不发请求`);
+    return { status: "skipped", message: "dry-run" };
+  }
+
+  const auth = await agcAuth(creds, deadline);
+  log("上传 APK …");
+  const files = await uploadFileMultipart(auth, creds, bytes, basename(pkgPath), deadline);
+  await bindFileInfo(auth, creds, 5, files, deadline);
+  log("✓ APK 已上传并绑定");
+
+  let noteInfo;
+  if (opts.releaseNote) noteInfo = await updateReleaseNote(creds, auth, opts, deadline);
+
+  if (opts.submitReview) {
+    await submitReview(creds, auth, deadline);
+    log("✓ 已提交审核");
+    return { status: "submitted", releaseNote: noteInfo };
+  }
+  log("（未提审：加 --submit-review 或稍后在 AGC 网页提交）");
+  return { status: "uploaded", releaseNote: noteInfo };
+}
+
+export async function status(creds, opts, deadline) {
+  requireAppId(creds);
+  if (opts.dryRun) return { status: "skipped", message: "dry-run" };
+  const auth = await agcAuth(creds, deadline);
+  const res = await agc("GET", `${V2}/app-info`, { auth, query: { appId: creds.app_id } }, deadline);
+  const a = res?.appInfo ?? res ?? {};
+  const raw = a.releaseState === undefined || a.releaseState === null || a.releaseState === "" ? null : Number(a.releaseState);
+  const [normalized, label] = mapReleaseState(raw);
+  const auditOpinion = res?.auditInfo?.auditOpinion || "";
+  log(`releaseState=${raw}（${label}）`);
+  log(`  提审版本: ${a.versionNumber ?? "-"}  在架版本: ${a.onShelfVersionNumber ?? "-"}`);
+  if (auditOpinion) log(`  审核意见: ${auditOpinion}`);
+  return {
+    status: normalized,
+    message: label,
+    releaseState: raw,
+    versionName: a.versionNumber,
+    onShelfVersionName: a.onShelfVersionNumber,
+    auditOpinion,
+  };
+}