@milian/linker-cli 0.0.0-stage → 0.17.3

package/src/commands/api-list.js

@@ -0,0 +1,247 @@
+'use strict';
+
+const { loadCredentials } = require('../config');
+const { authedRequest } = require('../api');
+const { fetchPlatforms, MAX_PAGE_SIZE } = require('./platforms');
+const { renderTable } = require('../ui');
+
+// 默认每页 10 条：API 资源可能很多，默认全量既慢又难读
+const DEFAULT_PAGE_SIZE = 10;
+
+// API 资源状态（平台权威定义）
+const STATUS_NAMES = {
+  10: '草稿',
+  20: '待发布',
+  30: '启用中',
+  40: '停用中',
+  50: '异常'
+};
+
+// 内容类型（平台权威定义）
+const CONTENT_TYPE_NAMES = {
+  0: 'none',
+  1: 'json',
+  2: 'soap+xml',
+  3: 'xml',
+  4: 'form',
+  5: 'multipart',
+  6: 'octet-stream'
+};
+
+function statusLabel(raw) {
+  const n = Number(raw);
+  return STATUS_NAMES[n] ? `${n} ${STATUS_NAMES[n]}` : String(raw);
+}
+
+function contentTypeLabel(raw) {
+  const n = Number(raw);
+  return CONTENT_TYPE_NAMES[n] ? `${n} ${CONTENT_TYPE_NAMES[n]}` : String(raw);
+}
+
+const USAGE = `用法: wb api list --platform <platformId|连接器名称> [--name <关键词>] [选项]
+
+必填:
+  --platform, -p <id|名称>   目标连接器应用。可给 platformId，也可给名称（自动模糊查后唯一定位）
+
+可选:
+  --name, -n <关键词>        API 资源名称，模糊查询（结果多时强烈建议带上）
+  --page <N>                 页码，默认 1
+  --size <N>                 每页条数，默认 ${DEFAULT_PAGE_SIZE}，上限 ${MAX_PAGE_SIZE}
+  --all                      取全部（等价 --size ${MAX_PAGE_SIZE}，不推荐，可能很慢）
+  --json                     输出接口原始 JSON
+
+示例:
+  wb api list --platform 泛微E10 --name 用户
+  wb api list --platform 2034441470421749761 --all
+  wb api list                       # 不带 --platform 会列出所有连接器供选择`;
+
+function parseArgs(argv) {
+  const opts = { platform: '', name: '', page: 1, size: DEFAULT_PAGE_SIZE, json: false };
+
+  for (let i = 0; i < argv.length; i += 1) {
+    const a = argv[i];
+    const next = () => {
+      const v = argv[i + 1];
+      i += 1;
+      return v === undefined ? '' : v;
+    };
+    if (a === '--platform' || a === '-p') opts.platform = next();
+    else if (a === '--name' || a === '-n') opts.name = next();
+    else if (a === '--page') {
+      const v = Number(next());
+      opts.page = Number.isFinite(v) && v > 0 ? v : 1;
+    } else if (a === '--size') {
+      const v = Number(next());
+      opts.size = Number.isFinite(v) && v > 0 ? Math.min(v, MAX_PAGE_SIZE) : DEFAULT_PAGE_SIZE;
+    } else if (a === '--all') {
+      opts.size = MAX_PAGE_SIZE;
+    } else if (a === '--json') {
+      opts.json = true;
+    } else if (a === '--help' || a === '-h') {
+      opts.help = true;
+    } else if (!a.startsWith('-')) {
+      if (!opts.platform) opts.platform = a;
+      else if (!opts.name) opts.name = a;
+    }
+  }
+  return opts;
+}
+
+/** 把「platformId 或连接器名称」解析成确定的 platformId */
+async function resolvePlatform(cfg, cred, input, out) {
+  const raw = String(input || '').trim();
+
+  // 纯数字视为 platformId，直接用，避免多打一次接口
+  if (/^\d+$/.test(raw)) return { platformId: raw, platformName: '' };
+
+  const { total, records } = await fetchPlatforms(cfg, cred, { name: raw, size: MAX_PAGE_SIZE });
+
+  if (total === 1) {
+    return { platformId: String(records[0].platformId), platformName: String(records[0].platformName || '') };
+  }
+
+  if (total === 0) {
+    throw new Error(
+      `没有找到名称包含 "${raw}" 的连接器应用。\n        查看全部：wb platforms`
+    );
+  }
+
+  // 命中多个：列出来让用户选，绝不猜
+  const rows = records.map((r, i) => [
+    String(i + 1),
+    String(r.platformName || ''),
+    String(r.platformId || ''),
+    String(r.platformType),
+    String(r.enabled)
+  ]);
+  out.write(`名称 "${raw}" 命中 ${total} 个连接器，请指定其中一个：\n\n`);
+  out.write(renderTable(['#', 'platformName', 'platformId', 'type', 'enabled'], rows) + '\n\n');
+  throw new Error('请用 --platform <platformId> 指定具体连接器（或给更精确的名称）');
+}
+
+/** 未指定 --platform 时，列出全部连接器供用户选择 */
+async function printPlatformChoices(cfg, cred, out) {
+  const { total, records } = await fetchPlatforms(cfg, cred, { size: MAX_PAGE_SIZE });
+
+  out.write(`未指定连接器应用。系统现有 ${total} 个，请先选一个：\n\n`);
+  if (!records.length) {
+    out.write('（系统里还没有连接器，先用 platform create 创建一个）\n');
+    return;
+  }
+  const rows = records.map((r, i) => [
+    String(i + 1),
+    String(r.platformName || ''),
+    String(r.platformId || ''),
+    String(r.platformType),
+    String(r.enabled)
+  ]);
+  out.write(renderTable(['#', 'platformName', 'platformId', 'type', 'enabled'], rows) + '\n');
+  out.write(`\n再执行：wb api list --platform <platformId 或 名称> [--name <关键词>]\n`);
+}
+
+/**
+ * 查询某个连接器应用下的 API 资源列表
+ * 接口：GET /index/sys/api/v1/platforms/{platformId}/papis
+ *        ?apiName=&platformId={platformId}&pageNum=1&pageSize=10
+ */
+async function commandApiList(cfg, argv) {
+  const opts = parseArgs(argv);
+  if (opts.help) {
+    process.stdout.write(USAGE + '\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  const cred = loadCredentials();
+  if (!cred || !cred.tokenValue) {
+    throw new Error('未登录或授权已失效，请先执行 auth login');
+  }
+
+  if (!opts.platform) {
+    await printPlatformChoices(cfg, cred, process.stdout);
+    process.exitCode = 1;
+    return;
+  }
+
+  const target = await resolvePlatform(cfg, cred, opts.platform, process.stdout);
+  const pid = target.platformId;
+
+  const qs =
+    `/sys/api/v1/platforms/${encodeURIComponent(pid)}/papis` +
+    `?apiName=${encodeURIComponent(opts.name || '')}&platformId=${encodeURIComponent(pid)}` +
+    `&pageNum=${opts.page}&pageSize=${opts.size}`;
+
+  const res = await authedRequest(cfg, cred, 'GET', qs);
+  const json = res.json;
+
+  if (opts.json) {
+    process.stdout.write(JSON.stringify(json, null, 2) + '\n');
+    process.exitCode = json && json.code === 200 ? 0 : 1;
+    return;
+  }
+
+  if (!json || typeof json !== 'object') {
+    throw new Error(`接口返回异常（HTTP ${res.status}）：${String(res.text).slice(0, 200)}`);
+  }
+  if (json.code !== 200) {
+    process.stdout.write(JSON.stringify(json, null, 2) + '\n');
+    throw new Error(`查询失败：code=${json.code} msg=${json.msg || '未知错误'}`);
+  }
+
+  const data = json.data || {};
+  const records = Array.isArray(data.records) ? data.records : [];
+  const total = typeof data.total === 'number' ? data.total : records.length;
+  const current = typeof data.current === 'number' ? data.current : opts.page;
+  const size = typeof data.size === 'number' ? data.size : opts.size;
+
+  const platLabel = target.platformName ? `${target.platformName}(${pid})` : pid;
+  process.stdout.write(`连接器: ${platLabel}\n`);
+  process.stdout.write(
+    `查询条件: apiName=${opts.name ? `"${opts.name}"` : '（全部）'}  pageNum=${current} pageSize=${size}\n`
+  );
+  process.stdout.write(`共 ${total} 个 API 资源，本次返回 ${records.length} 条\n\n`);
+
+  if (!records.length) {
+    process.stdout.write('（无匹配结果）\n');
+    if (opts.name) process.stdout.write('换个关键词试试，或去掉 --name 查看该连接器下全部 API 资源\n');
+    else process.stdout.write('该连接器下还没有 API 资源\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  const header = ['#', 'apiName', 'outboundApiId', 'method', 'url', 'content', 'status'];
+  const rows = records.map((r, i) => [
+    String(i + 1),
+    String(r.apiName || ''),
+    String(r.outboundApiId || ''),
+    String(r.httpMethod || ''),
+    String(r.url || ''),
+    contentTypeLabel(r.contentType),
+    statusLabel(r.status)
+  ]);
+  process.stdout.write(renderTable(header, rows) + '\n');
+
+  // flowId 是发布后生成的发布 ID，有值即已走过发布流程
+  const published = records.filter((r) => r.flowId).length;
+  process.stdout.write(`\n本页已发布（有 flowId）${published} 条 / 共 ${records.length} 条；flowId 需 --json 查看\n`);
+  process.stdout.write('status: 10 草稿 / 20 待发布 / 30 启用中 / 40 停用中 / 50 异常\n');
+
+  if (!opts.name && total > records.length) {
+    process.stdout.write(
+      `\n结果较多（共 ${total} 条，本页 ${records.length} 条）：建议加 --name <关键词> 过滤，或 --page 翻页\n`
+    );
+  }
+  process.stdout.write('\n提示：加 --json 可输出完整字段（含 contentType、paramExample、flowId 等）\n');
+  process.exitCode = 0;
+}
+
+module.exports = {
+  commandApiList,
+  parseArgs,
+  resolvePlatform,
+  statusLabel,
+  contentTypeLabel,
+  STATUS_NAMES,
+  CONTENT_TYPE_NAMES,
+  DEFAULT_PAGE_SIZE
+};

package/src/commands/api-publish.js

@@ -0,0 +1,288 @@
+'use strict';
+
+const { loadCredentials } = require('../config');
+const { authedRequest } = require('../api');
+const { MAX_PAGE_SIZE, resolvePlatformRecord } = require('./platforms');
+const { urlForAttempt } = require('../schema');
+const { renderTable } = require('../ui');
+
+/** 发布路径被占用的业务错误码（业务方给定） */
+const PATH_CONFLICT_CODE = 40011037;
+
+const DEFAULT_MAX_RETRY = 3;
+
+const USAGE = `用法: wb api publish --platform <platformId|名称> --api <outboundApiId|api名称> [选项]
+
+说明: 已保存过的 API 资源重新走"发布准备 + 发布"。新资源请用 api create。
+
+可选:
+  --max-retry <N>        路径冲突时自动改路径重试次数，默认 ${DEFAULT_MAX_RETRY}
+  --url-suffix <word>    路径冲突时使用的后缀单词（默认按 api 名称推导）
+  --dry-run              只做发布准备，不真正发布
+  --json                 输出接口原始 JSON
+
+示例:
+  wb api publish --platform 泛微E10 --api 2118594622711623680
+  wb api publish --platform 泛微E10 --api zw1 --dry-run`;
+
+function parseArgs(argv) {
+  const opts = { platform: '', api: '', maxRetry: DEFAULT_MAX_RETRY, urlSuffix: '', dryRun: false, json: false };
+  for (let i = 0; i < argv.length; i += 1) {
+    const a = argv[i];
+    const next = () => {
+      const v = argv[i + 1];
+      i += 1;
+      return v === undefined ? '' : v;
+    };
+    if (a === '--platform' || a === '-p') opts.platform = next();
+    else if (a === '--api' || a === '-a') opts.api = next();
+    else if (a === '--max-retry') {
+      const v = Number(next());
+      opts.maxRetry = Number.isFinite(v) && v > 0 ? Math.min(Math.floor(v), 10) : DEFAULT_MAX_RETRY;
+    } else if (a === '--url-suffix') opts.urlSuffix = next();
+    else if (a === '--dry-run') opts.dryRun = true;
+    else if (a === '--json') opts.json = true;
+    else if (a === '--help' || a === '-h') opts.help = true;
+  }
+  return opts;
+}
+
+function papisPath(platformId, outboundApiId, tail) {
+  const base =
+    `/sys/api/v1/platforms/${encodeURIComponent(platformId)}/papis` +
+    (outboundApiId ? `/${encodeURIComponent(outboundApiId)}` : '');
+  return tail ? `${base}/${tail}` : base;
+}
+
+/**
+ * 在连接器下按 outboundApiId 或名称定位一条 API 资源
+ * @returns {{outboundApiId:string, apiName:string, url:string, httpMethod:string, status:number}}
+ */
+async function findApi(cfg, cred, platformId, input, out) {
+  const raw = String(input == null ? '' : input).trim();
+  if (!raw) throw new Error('缺少 --api（outboundApiId 或 api 名称）');
+
+  const qs =
+    papisPath(platformId) +
+    `?apiName=${encodeURIComponent(/^\d+$/.test(raw) ? '' : raw)}` +
+    `&platformId=${encodeURIComponent(platformId)}&pageNum=1&pageSize=${MAX_PAGE_SIZE}`;
+
+  const res = await authedRequest(cfg, cred, 'GET', qs);
+  const json = res.json;
+  if (!json || typeof json !== 'object') {
+    throw new Error(`查询 API 资源失败（HTTP ${res.status}）：${String(res.text).slice(0, 200)}`);
+  }
+  if (json.code !== 200) {
+    throw new Error(`查询 API 资源失败：code=${json.code} msg=${json.msg || '未知错误'}`);
+  }
+
+  const records = Array.isArray((json.data || {}).records) ? json.data.records : [];
+  let hit = null;
+  if (/^\d+$/.test(raw)) {
+    hit = records.find((r) => String(r.outboundApiId) === raw) || null;
+    if (!hit) {
+      // 列表可能被过滤掉，退化为直接用 id（apiName 拿不到，冲突重试后缀会用兜底词池）
+      return { outboundApiId: raw, apiName: '', url: '', httpMethod: '', status: null };
+    }
+  } else {
+    const matched = records.filter((r) => String(r.apiName || '').includes(raw));
+    if (matched.length === 1) hit = matched[0];
+    else if (matched.length === 0) {
+      throw new Error(
+        `连接器下没有找到名称包含 "${raw}" 的 API 资源。\n        查看列表：wb api list --platform ${platformId}`
+      );
+    } else {
+      const rows = matched.map((r, i) => [
+        String(i + 1),
+        String(r.apiName || ''),
+        String(r.outboundApiId || ''),
+        String(r.httpMethod || ''),
+        String(r.url || ''),
+        String(r.status)
+      ]);
+      out.write(`名称 "${raw}" 命中 ${matched.length} 条 API 资源，请指定其中一条：\n\n`);
+      out.write(renderTable(['#', 'apiName', 'outboundApiId', 'method', 'url', 'status'], rows) + '\n\n');
+      throw new Error('请用 --api <outboundApiId> 指定具体 API 资源');
+    }
+  }
+
+  return {
+    outboundApiId: String(hit.outboundApiId || ''),
+    apiName: String(hit.apiName || ''),
+    url: String(hit.url || ''),
+    httpMethod: String(hit.httpMethod || ''),
+    status: typeof hit.status === 'number' ? hit.status : null
+  };
+}
+
+/**
+ * 发布准备：返回 groupCode / 发布后 url / packageResponse / isPublished
+ * POST /index/sys/api/v1/platforms/{platformId}/papis/{outboundApiId}/publish-record
+ */
+async function preparePublish(cfg, cred, platformId, outboundApiId) {
+  const res = await authedRequest(cfg, cred, 'POST', papisPath(platformId, outboundApiId, 'publish-record'), {
+    platformId,
+    outboundApiId
+  });
+  const json = res.json;
+  if (!json || typeof json !== 'object') {
+    throw new Error(`发布准备失败（HTTP ${res.status}）：${String(res.text).slice(0, 200)}`);
+  }
+  if (json.code !== 200) {
+    throw new Error(`发布准备失败：code=${json.code} msg=${json.msg || '未知错误'}`);
+  }
+  const data = json.data || {};
+  return {
+    groupCode: String(data.groupCode || ''),
+    url: String(data.url || ''),
+    packageResponse: data.packageResponse === undefined ? 0 : data.packageResponse,
+    isPublished: Boolean(data.isPublished),
+    raw: json
+  };
+}
+
+/** 单次发布 PUT .../publish。overwrite 恒为 false：不覆盖已占用路径，冲突就改路径重试 */
+async function publishOnce(cfg, cred, body) {
+  const res = await authedRequest(
+    cfg,
+    cred,
+    'PUT',
+    papisPath(body.platformId, body.outboundApiId, 'publish'),
+    body
+  );
+  return { status: res.status, json: res.json, text: res.text, body };
+}
+
+/**
+ * 发布（含路径冲突自动重试）
+ * 冲突时在「原始发布 url」后追加语义化英文单词重试，不是层层叠加。
+ *
+ * @param {object} p {platformId, outboundApiId, apiName}
+ * @param {object} o {maxRetry, urlSuffix, log}
+ */
+async function publishWithRetry(cfg, cred, p, o) {
+  const opts = o || {};
+  const log = opts.log || (() => {});
+  const maxRetry = Math.max(1, Number(opts.maxRetry) || DEFAULT_MAX_RETRY);
+
+  const prep = await preparePublish(cfg, cred, p.platformId, p.outboundApiId);
+  if (!prep.url) {
+    throw new Error('发布准备未返回 url，无法继续发布（请先在平台页面确认该 API 资源是否保存成功）');
+  }
+  log(`发布路径: ${prep.url}`);
+  log(`分组 code: ${prep.groupCode || '(空)'}   是否已发布过: ${prep.isPublished ? '是（再次发布）' : '否（首次发布）'}`);
+
+  const baseUrl = prep.url;
+  const attempts = [];
+
+  for (let attempt = 1; attempt <= maxRetry; attempt += 1) {
+    const url = urlForAttempt(baseUrl, p.apiName, attempt, opts.urlSuffix);
+    const body = {
+      platformId: p.platformId,
+      outboundApiId: p.outboundApiId,
+      url,
+      packageResponse: prep.packageResponse,
+      overwrite: false
+    };
+
+    const r = await publishOnce(cfg, cred, body);
+    const json = r.json;
+
+    if (!json || typeof json !== 'object') {
+      throw new Error(`发布失败（HTTP ${r.status}）：${String(r.text).slice(0, 200)}`);
+    }
+
+    if (json.code === 200) {
+      attempts.push({ attempt, url, code: 200, ok: true });
+      const data = json.data || {};
+      return {
+        prep,
+        attempts,
+        url,
+        flowId: String(data.flowId || ''),
+        apiId: String(data.apiId || ''),
+        raw: json
+      };
+    }
+
+    if (json.code === PATH_CONFLICT_CODE) {
+      attempts.push({ attempt, url, code: json.code, ok: false, msg: json.msg || '路径已存在，请修改' });
+      log(`  第 ${attempt} 次被占用：${url}`);
+      continue;
+    }
+
+    attempts.push({ attempt, url, code: json.code, ok: false, msg: json.msg || '' });
+    throw new Error(
+      `发布失败：code=${json.code} msg=${json.msg || '未知错误'}\n        提交路径: ${url}`
+    );
+  }
+
+  const tried = attempts.map((a) => a.url).join('\n          ');
+  throw new Error(
+    `发布失败：连续 ${maxRetry} 次路径冲突（${PATH_CONFLICT_CODE} 路径已存在）。\n` +
+      `        已尝试: ${tried}\n` +
+      `        可用 --url-suffix <单词> 指定后缀，或 --max-retry 加大次数`
+  );
+}
+
+/** api publish 命令 */
+async function commandApiPublish(cfg, argv) {
+  const opts = parseArgs(argv);
+  if (opts.help) {
+    process.stdout.write(USAGE + '\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  const cred = loadCredentials();
+  if (!cred || !cred.tokenValue) {
+    throw new Error('未登录或授权已失效，请先执行 auth login');
+  }
+  if (!opts.platform) throw new Error(`缺少 --platform\n\n${USAGE}`);
+  if (!opts.api) throw new Error(`缺少 --api\n\n${USAGE}`);
+
+  const target = await resolvePlatformRecord(cfg, cred, opts.platform, process.stdout);
+  process.stdout.write(`[1/3] 连接器: ${target.platformName || '(未知名称)'}(${target.platformId})\n`);
+
+  const api = await findApi(cfg, cred, target.platformId, opts.api, process.stdout);
+  process.stdout.write(`[2/3] API 资源: ${api.apiName || '(未知名称)'}(${api.outboundApiId})\n`);
+
+  if (opts.dryRun) {
+    const prep = await preparePublish(cfg, cred, target.platformId, api.outboundApiId);
+    process.stdout.write(`[3/3] --dry-run，未发布。发布准备返回：\n`);
+    process.stdout.write(JSON.stringify(prep.raw, null, 2) + '\n');
+    process.exitCode = 0;
+    return;
+  }
+
+  const result = await publishWithRetry(
+    cfg,
+    cred,
+    { platformId: target.platformId, outboundApiId: api.outboundApiId, apiName: api.apiName },
+    { maxRetry: opts.maxRetry, urlSuffix: opts.urlSuffix, log: (s) => process.stdout.write('      ' + s + '\n') }
+  );
+
+  if (opts.json) {
+    process.stdout.write(JSON.stringify(result.raw, null, 2) + '\n');
+  }
+
+  process.stdout.write(`[3/3] 发布成功\n`);
+  process.stdout.write(`      发布路径 = ${result.url}\n`);
+  if (result.flowId) process.stdout.write(`      flowId  = ${result.flowId}\n`);
+  if (result.attempts.length > 1) {
+    process.stdout.write(`      共尝试 ${result.attempts.length} 次（前 ${result.attempts.length - 1} 次路径被占用）\n`);
+  }
+  process.exitCode = 0;
+}
+
+module.exports = {
+  commandApiPublish,
+  preparePublish,
+  publishOnce,
+  publishWithRetry,
+  findApi,
+  papisPath,
+  parseArgs,
+  PATH_CONFLICT_CODE,
+  DEFAULT_MAX_RETRY
+};