@youzan-cloud/zan-saas-cli 0.0.0-stage → 0.1.0-beta.3

package/src/commands/native/valuecard/card/get/command.js

@@ -0,0 +1,107 @@
+'use strict';
+
+const { withTargetShopDefault } = require('../../../../../execution/target-shop-default');
+
+const { Option } = require('commander');
+const { DiagnosticCommand } = require('../../../../../cli/diagnostic-command');
+const { inputIssue, parseIntegerOption, constraints, modelAt } = require('../../../../../execution/error-details');
+const { resolveTargetShop } = require('../../../../../execution/target-shop');
+const { validateCommandValue } = require('../../../../../execution/command-schema');
+const { createShopQuery, failure, bindingPath } = require('../../../../../execution/shop-query');
+const { object } = require('../../../../../execution/query-api');
+const { parseInclude, projectCardType, projectBalance, projectTemplate } = require('../../shared/projection');
+const schema = require('./schema.json');
+
+const command = 'valuecard.card.get';
+const reject = (category, stage, scope, state, facts) =>
+  failure(command, category, stage, scope, state, facts);
+
+function project(data, input, facts) {
+  const scope = { kdtId: input.kdtId };
+  try {
+    if (!object(data) || data.card_no !== input.cardNo) throw new TypeError('Invalid card');
+    const card = {
+      cardNo: data.card_no,
+      cardType: projectCardType(data.template_type, 'template_type'),
+      cardStatus: data.card_status,
+      balance: projectBalance(data)
+    };
+    if (input.include.includes('template')) card.template = projectTemplate(data);
+    const output = { data: { card } };
+    validateCommandValue(schema, 'output', output);
+    return output;
+  } catch (error) {
+    throw reject(error instanceof RangeError ? 'scope_unresolved' : 'protocol',
+      'card-model', scope, 'sent', facts);
+  }
+}
+
+async function execute(input) {
+  const scope = { kdtId: input.kdtId };
+  const read = await createShopQuery(scope, command);
+  let response;
+  try {
+    response = await read(schema.api.path, { card_no: input.cardNo }, 'card');
+  } catch (error) {
+    const details = error.cliDetails;
+    if (details?.category === 'business_rejected' && details.stage === 'card' &&
+        details.api === schema.api.path && !Object.hasOwn(details, 'gatewayCode') &&
+        [118703049, '118703049'].includes(details.businessCode)) {
+      throw reject('not_found', 'card', scope, 'sent', {
+        api: details.api, httpStatus: details.httpStatus, businessCode: details.businessCode,
+        ...(details.trace_id && { trace_id: details.trace_id }),
+        ...(details.request_id && { request_id: details.request_id })
+      });
+    }
+    throw error;
+  }
+  return project(response.data, input, response.facts);
+}
+
+function createCommand({ context } = {}) {
+  return new DiagnosticCommand('get', { path: command, schema, parameterCategory: 'parameter' })
+    .description('根据系统卡号查询一张储值卡的状态和余额')
+    .allowExcessArguments(false)
+    .requiredOption('--card-no <no>', '必填：完整系统卡号字符串；不是卡面号、兑换码或模板号')
+    .option('--kdt-id <id>', '目标店铺正安全整数；省略取有效上下文 shopId，非总部不可跨店')
+    .option('--include <modules>', '仅支持 template；本地追加模板关联，不新增请求')
+    .addOption(new Option('--format <format>', 'json 或 pretty，仅改变缩进')
+      .choices(['json', 'pretty']).default('json'))
+    .option('--dry-run', '本地脱敏预览；不读凭证、不联网、不回显卡号')
+    .addHelpText('after', `
+输出固定为 data.card 对象：cardNo、cardType、cardStatus 和 balance。
+cardType 为 balance 或 gift；状态保留源编码，不保证当前订单可支付。
+balance 含 totalBalance、principalBalance、bonusBalance，金额为元两位字符串；不汇总客户资产。
+--include template 追加 templateNo 与可选 templateName，不表示完整模板详情。
+不返回持有人、手机号、有效期或交易流水；不接受手机号、客户 ID 或模板号替代卡号。
+先核验同凭证店铺 sid，再查一张卡；最多两次请求，不重试、切店或换身份。
+真实执行需有效四字段上下文及同店凭证；at: all 不证明员工 OAuth 或跨店权限。
+支持微商城/零售单店、连锁 D 总部/网店/合伙人及连锁 L 总部高级版。
+缺少上下文仅显式合法目标可 dry-run；失败 stdout 为空，stderr 为脱敏错误 JSON。
+契约：zan-saas schema valuecard.card.get
+示例：zan-saas valuecard card get --card-no 000-card-1 --include template --kdt-id 63077 --dry-run
+`)
+    .action(async options => {
+      const scope = resolveTargetShop(options, context, command);
+      let input;
+      try {
+        if (/[\u0000-\u001f\u007f-\u009f]/u.test(options.cardNo)) throw inputIssue('/cardNo', 'invalid_format', constraints(modelAt(schema, 'input', '/cardNo')));
+        let include;
+        try { include = parseInclude(options.include); }
+        catch { throw inputIssue('/include', 'invalid_choice', { items: { enum: ['template'] }, maxItems: 1 }); }
+        input = { ...scope, cardNo: options.cardNo.trim(), include };
+        validateCommandValue(schema, 'input', input);
+      } catch (error) { error.inputScope = scope; throw error; }
+      const preview = {
+        scope,
+        prerequisites: [{ method: 'POST', path: bindingPath, body: {} }],
+        requests: [{ method: 'POST', path: schema.api.path, body: { card_no: '<redacted>' } }],
+        selection: input.include
+      };
+      validateCommandValue(schema, 'preview', preview);
+      const output = options.dryRun ? preview : await execute(input);
+      process.stdout.write(`${JSON.stringify(output, null, options.format === 'pretty' ? 2 : 0)}\n`);
+    });
+}
+
+module.exports = { kind: 'atomic', risk: 'read', at: 'all', createCommand: withTargetShopDefault(createCommand) };