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

package/src/commands/native/benefit/domain.json

@@ -0,0 +1,3 @@
+{
+  "description": "权益：权益卡定义、客户持卡与发放记录"
+}

package/src/commands/native/coupon/activity/get/command.js

@@ -0,0 +1,183 @@
+'use strict';
+
+const { withTargetShopDefault } = require('../../../../../execution/target-shop-default');
+
+const { Command, Option } = require('commander');
+const { resolveScope, createShopQuery, failure, bindingPath } = require('../../shared/query');
+const { validateCommandValue } = require('../../../../../execution/command-schema');
+const { normalizeMoney } = require('../../../../../execution/money');
+const { object } = require('../../../../../execution/query-api');
+const schema = require('./schema.json');
+
+const command = 'coupon.activity.get';
+const reject = (category, stage, scope, state, facts) =>
+  failure(command, category, stage, scope, state, facts);
+
+function knownInteger(value, values) {
+  if (!Number.isSafeInteger(value)) throw new TypeError('Invalid integer');
+  if (!values.includes(value)) throw new RangeError('Unsupported rule');
+  return value;
+}
+
+function amount(value) {
+  if (!Number.isSafeInteger(value) || value < 0) throw new TypeError('Invalid amount');
+  return normalizeMoney(value, schema.definitions.money);
+}
+
+function observed(source, mapping) {
+  const result = {};
+  for (const [name, upstream] of Object.entries(mapping)) {
+    if (Object.hasOwn(source, upstream)) result[name] = source[upstream];
+  }
+  return result;
+}
+
+function projectOffer(data) {
+  const mode = knownInteger(data.preferential_mode, [1, 2, 3]);
+  const offer = { mode };
+  if (mode === 1) {
+    offer.valueRule = knownInteger(data.voucher_value_generate_type, [1, 2, 3]);
+    if (offer.valueRule === 1) offer.amount = amount(data.value);
+    else {
+      offer.minAmount = amount(data.min_value);
+      offer.maxAmount = amount(data.max_value);
+      if (data.min_value > data.max_value) throw new TypeError('Invalid amount range');
+    }
+  } else if (mode === 2) {
+    offer.discountTenths = data.value;
+    if (Object.hasOwn(data, 'max_discount_amount')) {
+      offer.maxDiscountAmount = amount(data.max_discount_amount);
+    }
+  }
+  return offer;
+}
+
+function projectThreshold(data) {
+  const type = knownInteger(data.threshold_type, [0, 1, 2]);
+  const threshold = { type };
+  if (type === 1) threshold.amount = amount(data.threshold_amount);
+  if (type === 2) {
+    threshold.minPieces = data.threshold_piece;
+    Object.assign(threshold, observed(data, { maxPieces: 'threshold_max_piece' }));
+  }
+  return threshold;
+}
+
+function projectScope(data) {
+  const scope = {};
+  const shops = observed(data, { type: 'applicable_shop_range_type', kdtIds: 'applicable_shop_ids' });
+  if (Object.hasOwn(shops, 'type')) knownInteger(shops.type, [1, 2, 3]);
+  if (Object.keys(shops).length) scope.shops = shops;
+  for (const channel of ['online', 'offline']) {
+    const group = observed(data, {
+      type: `applicable_${channel}_goods_range_type`,
+      channel_item_ids: `applicable_${channel}_goods_ids`,
+      groupIds: `applicable_${channel}_goods_group_ids`,
+      exchange_channel_item_ids: `exchangeable_${channel}_goods_ids`,
+      exchangeGroupIds: `exchangeable_${channel}_goods_group_ids`
+    });
+    if (Object.hasOwn(group, 'type')) knownInteger(group.type, [0, 1, 2, 3]);
+    if (Object.keys(group).length) scope[channel] = group;
+  }
+  return scope;
+}
+
+function project(data, input, facts) {
+  const scope = { kdtId: input.kdtId };
+  try {
+    if (!object(data) || data.id !== input.activityId) throw new TypeError('Invalid activity');
+    if (!Number.isSafeInteger(data.kdt_id) || data.kdt_id < 1) throw new TypeError('Invalid owner');
+    if (data.kdt_id !== input.kdtId) throw new RangeError('Different owner');
+    const activity = {
+      activityId: data.id, ownerKdtId: data.kdt_id, title: data.title,
+      activityType: data.activity_type, status: data.status,
+      ...observed(data, { remark: 'remark', description: 'description' }),
+      offer: projectOffer(data)
+    };
+    if (Object.hasOwn(data, 'threshold_type')) activity.threshold = projectThreshold(data);
+    const budget = observed(data, {
+      takenQty: 'taken_qty', usedQty: 'used_qty', sendTotalQty: 'budget_send_total_qty',
+      useTotalQty: 'budget_use_total_qty', sendStockQty: 'send_stock_qty', useStockQty: 'use_stock_qty'
+    });
+    const usageScope = projectScope(data);
+    const output = { data: { activity,
+      ...(Object.keys(budget).length && { budget }),
+      ...(Object.keys(usageScope).length && { scope: usageScope }) } };
+    validateCommandValue(schema, 'output', output);
+    return output;
+  } catch (error) {
+    throw reject(error instanceof RangeError ? 'scope_unresolved' : 'protocol',
+      'response', 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, { activity_id: input.activityId }, 'query');
+  } catch (error) {
+    const details = error.cliDetails;
+    if (details?.category === 'business_rejected' && details.stage === 'query' &&
+        details.api === schema.api.path && !Object.hasOwn(details, 'gatewayCode') &&
+        [161201014, '161201014'].includes(details.businessCode)) {
+      const { api, httpStatus, businessCode, trace_id, request_id } = details;
+      throw reject('not_found', 'query', scope, 'sent', {
+        api, httpStatus, businessCode, ...(trace_id && { trace_id }), ...(request_id && { request_id })
+      });
+    }
+    throw error;
+  }
+  return project(response.data, input, response.facts);
+}
+
+function createCommand({ context } = {}) {
+  return new Command('get')
+    .description('按券发行活动 ID 查询活动详情、已有预算与使用范围配置')
+    .allowExcessArguments(false)
+    .exitOverride(error => {
+      if (['commander.helpDisplayed', 'commander.version'].includes(error.code)) throw error;
+      throw reject('parameter', 'input');
+    })
+    .requiredOption('--activity-id <id>', '必填：券发行活动正安全整数 ID，不是持券 ID、码号或 alias')
+    .option('--kdt-id <id>', '目标店铺正安全整数；省略取有效上下文 shopId，凭证必须属于同店')
+    .addOption(new Option('--format <format>', 'json 或 pretty，仅改变缩进')
+      .choices(['json', 'pretty']).default('json'))
+    .option('--dry-run', '仅本地预览，不读凭证、不联网')
+    .addHelpText('after', `
+返回 data.activity，及同次响应中已有的 data.budget、data.scope；可选源缺失仍省略。
+金额为人民币元两位字符串；折扣 discountTenths 为十分之一折，88 表示 8.8 折。
+范围只表示已返回的配置引用，不展开商品、分组或店铺，不证明最终可用性。
+不返回结构化活动日期，不将活动状态、预算或范围当作客户资格及订单用券结果。
+支持微商城/零售单店、连锁 D 总部/网店/合伙人，不承诺连锁 L 或跨归属店铺。
+真实执行需有效四字段上下文及同店凭证；at: all 不证明员工授权。
+先核验凭证店铺，再发一次详情请求，最多两次；不重试、补查、切店或换身份。
+缺少上下文仅显式合法 --kdt-id 可预览；失败 stdout 为空，stderr 为脱敏错误 JSON。
+不提供 --include、--fields、--timeout、--retry 或业务版本选项；全局 --version 仅显示包版本。
+契约：zan-saas schema coupon.activity.get
+指引：zan-saas skills read zan-saas-coupon references/activity-get.md
+示例：zan-saas coupon activity get --activity-id 1001 --kdt-id 63077 --dry-run
+`)
+    .action(async options => {
+      const scope = resolveScope(options, context, command);
+      let input;
+      try {
+        if (!/^[1-9][0-9]*$/.test(options.activityId)) throw new TypeError('Invalid activity ID');
+        input = { ...scope, activityId: Number(options.activityId) };
+        validateCommandValue(schema, 'input', input);
+      } catch { throw reject('validation', 'input', scope); }
+      const preview = {
+        scope, prerequisites: ['context', 'token-shop-binding'],
+        requests: [
+          { method: 'POST', api: bindingPath, body: {} },
+          { method: 'POST', api: schema.api.path, body: { activity_id: input.activityId } }
+        ]
+      };
+      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) };