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

package/src/commands/native/aftersale/shared/search.js

@@ -0,0 +1,128 @@
+'use strict';
+
+const { apiSeconds, parseDateTime, formatDateTime } = require('../../../../execution/datetime');
+const { object } = require('../../../../execution/query-api');
+const { createAftersaleQuery, reject } = require('./query');
+
+const listPath = 'youzan.trade.refund.search/3.0.1';
+const filterFields = Object.freeze({
+  orderNo: 'tid', caseId: 'refund_id', yzOpenId: 'yz_open_id', buyerPhone: 'buyer_phone',
+  demand: 'demand', status: 'status', type: 'type', phase: 'phase', handlingStatus: 'search_tag',
+  serviceStatus: 'cs_status', itemTitle: 'goods_title', skuNo: 'sku_no', deliveryStatus: 'delivery_status',
+  refundMode: 'refund_mode', returnStockStatus: 'return_stock_status', saleWay: 'sale_way', payType: 'pay_type'
+});
+
+function toRequestBody(input) {
+  const body = { page_no: input.pagination.pageNo, page_size: input.pagination.pageSize };
+  for (const [name, upstream] of Object.entries(filterFields)) {
+    if (Object.hasOwn(input.filters, name)) body[upstream] = input.filters[name];
+  }
+  for (const [name, upstream] of [['created', 'create'], ['updated', 'update']]) {
+    if (!input.range[name]) continue;
+    body[`${upstream}_time_start`] = apiSeconds(input.range[name].start);
+    body[`${upstream}_time_end`] = apiSeconds(input.range[name].end);
+  }
+  return body;
+}
+
+function toPreviewBody(input) {
+  const body = toRequestBody(input);
+  for (const name of ['yz_open_id', 'buyer_phone', 'goods_title']) {
+    if (Object.hasOwn(body, name)) body[name] = '***';
+  }
+  return body;
+}
+
+function amount(value) {
+  if (typeof value !== 'string' || !/^\d+(?:\.\d+)?$/.test(value)) throw new Error('invalid amount');
+  const [whole, fraction = ''] = value.split('.');
+  if (/[1-9]/.test(fraction.slice(2))) throw new Error('inexact amount');
+  const cents = BigInt(whole) * 100n + BigInt(fraction.slice(0, 2).padEnd(2, '0'));
+  if (cents > 9223372036854775807n) throw new Error('amount out of range');
+  return `${cents / 100n}.${String(cents % 100n).padStart(2, '0')}`;
+}
+
+function identifier(value) {
+  if (typeof value !== 'string' || !value || /[\s\p{Cc}]/u.test(value)) throw new Error('invalid identity');
+  return value;
+}
+
+function shopId(value) {
+  if (!Number.isSafeInteger(value) || value < 1) throw new Error('invalid shop');
+  return value;
+}
+
+function adaptPage(data, input, facts = {}, command = 'aftersale.case.list') {
+  try {
+    if (!object(data) || !Array.isArray(data.refunds) || data.refunds.length > input.pagination.pageSize) {
+      throw new Error('invalid collection');
+    }
+    if (command !== 'aftersale.case.list' && data.total === null) throw new Error('invalid scan total');
+    const total = data.total ?? null;
+    if (total !== null && (!Number.isSafeInteger(total) || total < 0)) {
+      throw new Error('invalid total');
+    }
+    const offset = (input.pagination.pageNo - 1) * input.pagination.pageSize;
+    if (total !== null && (data.refunds.length ? offset + data.refunds.length > total : offset < total)) {
+      throw new Error('contradictory total');
+    }
+    const seen = new Set();
+    const cases = data.refunds.map(row => {
+      if (!object(row)) throw new Error('invalid row');
+      const result = { caseId: identifier(row.refund_id), orderNo: identifier(row.tid), kdtId: shopId(row.kdt_id) };
+      if (result.kdtId !== input.scope.kdtId) {
+        throw reject(command, 'scope_unresolved', 'cases', input.scope, 'sent', facts);
+      }
+      if (seen.has(result.caseId)) throw new Error('duplicate case');
+      seen.add(result.caseId);
+      if (typeof row.status !== 'string' || !row.status.trim() || /\p{Cc}/u.test(row.status)) {
+        throw new Error('invalid status');
+      }
+      result.status = row.status;
+      result.amount = amount(row.refund_fee);
+      for (const [source, target] of [['node_kdt_id', 'nodeKdtId'], ['return_goods', 'hasReturnGoods'],
+        ['created', 'createdAt'], ['modified', 'updatedAt'], ['cs_status', 'serviceStatus'],
+        ['delivery_status', 'deliveryStatus']]) {
+        if (!Object.hasOwn(row, source)) continue;
+        const value = row[source];
+        if (source === 'node_kdt_id') result[target] = shopId(value);
+        else if (source === 'return_goods') {
+          if (typeof value !== 'boolean') throw new Error('invalid return goods');
+          result[target] = value;
+        } else if (source === 'created' || source === 'modified') {
+          if (typeof value !== 'string' || value !== value.trim()) throw new Error('invalid time');
+          result[target] = formatDateTime(parseDateTime(value));
+        } else {
+          if (!Number.isSafeInteger(value)) throw new Error('invalid state');
+          result[target] = value;
+        }
+      }
+      return result;
+    });
+    const pagination = { ...input.pagination, ...(command === 'aftersale.case.list' && total === null ? {} : { total }),
+      hasMore: total === null ? null : input.pagination.pageNo * input.pagination.pageSize < total };
+    if (command === 'aftersale.case.list') {
+      pagination.nextPageNo = pagination.hasMore === true && pagination.pageNo < 100 ? pagination.pageNo + 1 : null;
+      pagination.windowLimitReached = pagination.hasMore !== false && pagination.pageNo >= 100;
+    }
+    return { data: { cases, pagination } };
+  } catch (error) {
+    if (error.cliDetails) throw error;
+    throw reject(command, 'protocol', 'output-model', input.scope, 'sent', facts);
+  }
+}
+
+async function createCasePageReader(scope, command = 'aftersale.case.list', options) {
+  const read = await createAftersaleQuery(scope, command, options);
+  return async input => {
+    const { pageNo, pageSize } = input.pagination;
+    if (input.scope.kdtId !== scope.kdtId || !Number.isSafeInteger(pageNo) || pageNo < 1 || pageNo > 100 ||
+        !Number.isSafeInteger(pageSize) || pageSize < 1 || pageSize > 20 || pageNo * pageSize > 3000) {
+      throw reject(command, 'validation', 'input', scope);
+    }
+    const { data, facts } = await read(listPath, toRequestBody(input));
+    return adaptPage(data, input, facts, command);
+  };
+}
+
+module.exports = { listPath, filterFields, toRequestBody, toPreviewBody, adaptPage, createCasePageReader };

package/src/commands/native/benefit/card-definition/get/command.js

@@ -0,0 +1,110 @@
+'use strict';
+
+const { withTargetShopDefault } = require('../../../../../execution/target-shop-default');
+
+const { Command, Option } = require('commander');
+const { resolveTargetShop } = require('../../../../../execution/target-shop');
+const { parseIncludeModules } = require('../../../../../execution/command-io');
+const { validateCommandValue } = require('../../../../../execution/command-schema');
+const { object } = require('../../../../../execution/query-api');
+const { createShopQuery, failure, bindingPath } = require('../../../../../execution/shop-query');
+const schema = require('./schema.json');
+const { normalizeTimes } = require('../../../../../execution/datetime');
+
+const command = 'benefit.card-definition.get';
+const reject = (category, stage, scope, state, facts) =>
+  failure(command, category, stage, scope, state, facts);
+
+function project(value, model) {
+  if (model.$ref) return project(value, schema.definitions[model.$ref.split('/').at(-1)]);
+  if (model.type === 'array') {
+    if (!Array.isArray(value)) throw new Error('invalid array');
+    return value.map(entry => project(entry, model.items));
+  }
+  if (model.type !== 'object') return value;
+  if (!object(value)) throw new Error('invalid object');
+  return Object.fromEntries(Object.entries(model.properties).flatMap(([field, definition]) => {
+    const source = field.replace(/[A-Z]/g, letter => `_${letter.toLowerCase()}`);
+    return Object.hasOwn(value, source) ? [[field, project(value[source], definition)]] : [];
+  }));
+}
+
+async function execute(input, request) {
+  const scope = { kdtId: input.kdtId };
+  const read = await createShopQuery(scope, command);
+  let response;
+  try {
+    response = await read(request.path, request.body, 'card-get');
+  } catch (error) {
+    const details = error.cliDetails;
+    if (details?.category === 'business_rejected' && details.api === schema.api.path &&
+        details.stage === 'card-get' && details.businessCode === 141502105 &&
+        !Object.hasOwn(details, 'gatewayCode')) {
+      throw reject('not_found', 'card-get', scope, 'sent', {
+        api: details.api, httpStatus: details.httpStatus, businessCode: details.businessCode,
+        ...Object.fromEntries(['trace_id', 'request_id'].filter(field => Object.hasOwn(details, field))
+          .map(field => [field, details[field]]))
+      });
+    }
+    throw error;
+  }
+  const { data, facts } = response;
+  try {
+    if (!object(data) || data.card_alias !== input.cardAlias) throw new Error('invalid target');
+    const output = { data: { card: normalizeTimes(project(data, schema.definitions.card),
+      schema.definitions.card, schema.definitions) } };
+    if (input.include.includes('rights')) {
+      output.data.rights = project(data.rights, schema.output.properties.data.properties.rights);
+    }
+    validateCommandValue(schema, 'output', output);
+    return output;
+  } catch {
+    throw reject('protocol', 'card-get-model', scope, 'sent', facts);
+  }
+}
+
+function createCommand({ context } = {}) {
+  return new Command('get')
+    .description('查询店铺配置的单个权益卡定义，可追加权益配置')
+    .allowExcessArguments(false)
+    .exitOverride(error => {
+      if (['commander.helpDisplayed', 'commander.version'].includes(error.code)) throw error;
+      throw reject('parameter', 'input');
+    })
+    .requiredOption('--card-alias <alias>', '必填：完整权益卡定义 alias；不是卡号或商品 ID')
+    .option('--kdt-id <id>', '目标店铺正安全整数；省略取上下文 shopId，非总部不可跨店')
+    .option('--include <modules>', '追加 rights；逗号分隔、去重，空项或未知项失败')
+    .addOption(new Option('--format <format>', 'json 或 pretty，仅改变缩进')
+      .choices(['json', 'pretty']).default('json'))
+    .option('--dry-run', '仅校验并预览店铺核验和详情请求，不读凭证、不联网')
+    .addHelpText('after', `
+时间点统一输出北京时间 YYYY-MM-DD HH:mm:ss.SSS，字段声明的业务哨兵保留。
+默认 data.card；--include rights 追加有限递归配置视图，不代表客户已获得或可使用权益。
+cardType 为 1 无门槛、2 规则、3 付费；status 为 1 可用、2 禁用、3 删除；未知整数保留。
+权益 discount/rate/cpsRate 保留上游编码；不返回金额、付费商品或完整发卡规则。
+先核验同店凭证，再直接查询一次；不遍历列表、不重试、不回退旧接口。
+支持微商城单店、零售单店及连锁 D 总部/网店/合伙人；暂不承诺教育多校区总部。
+真实执行需四字段上下文及同店授权凭证；店铺核验不证明员工 OAuth 或跨店授权。
+契约：zan-saas schema benefit.card-definition.get
+示例：zan-saas benefit card-definition get --card-alias card-definition-a --kdt-id 63077 --include rights --dry-run
+`)
+    .action(async options => {
+      const scope = resolveTargetShop(options, context, command);
+      let input;
+      try {
+        if (/[\u0000-\u001f\u007f-\u009f]/.test(options.cardAlias)) throw new Error('invalid alias');
+        input = { ...scope, cardAlias: options.cardAlias.trim(),
+          include: [...parseIncludeModules(options.include, ['rights'])] };
+        validateCommandValue(schema, 'input', input);
+      } catch { throw reject('parameter', 'input', scope); }
+      const request = { method: 'POST', path: schema.api.path,
+        body: { params: { card_alias: input.cardAlias } } };
+      const preview = { scope, prerequisites: [{ method: 'POST', path: bindingPath, body: {} }],
+        requests: [request], selection: { include: input.include } };
+      validateCommandValue(schema, 'preview', preview);
+      const output = options.dryRun ? preview : await execute(input, request);
+      process.stdout.write(`${JSON.stringify(output, null, options.format === 'pretty' ? 2 : 0)}\n`);
+    });
+}
+
+module.exports = { kind: 'atomic', risk: 'read', at: 'all', createCommand: withTargetShopDefault(createCommand) };