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

package/src/commands/native/aftersale/case/list/command.js

@@ -0,0 +1,135 @@
+'use strict';
+
+const { withTargetShopDefault } = require('../../../../../execution/target-shop-default');
+
+const { Option } = require('commander');
+const { DiagnosticCommand } = require('../../../../../cli/diagnostic-command');
+const { inputIssue, withInputScope, constraints, modelAt } = require('../../../../../execution/error-details');
+const { formatDateTime, parseDateTime } = require('../../../../../execution/datetime');
+const { validateCommandValue } = require('../../../../../execution/command-schema');
+const { bindingPath, targetScope, reject, serialize } = require('../../shared/query');
+const { listPath, filterFields, toPreviewBody, createCasePageReader } = require('../../shared/search');
+const schema = require('./schema.json');
+
+const command = 'aftersale.case.list';
+const filterModels = schema.input.properties.filters.properties;
+
+function buildInput(options, context) {
+  const scope = targetScope(options, context, command);
+  try { return withInputScope(scope, () => normalizedInput(options, scope)); }
+  catch (error) {
+    if (error.section === 'input') error.cliDetails = reject(command, 'validation', 'input', scope).cliDetails;
+    throw error;
+  }
+}
+
+function normalizedInput(options, scope) {
+  const invalid = (path, reason = 'invalid_format', expected, relatedPaths) => inputIssue(path, reason,
+    expected || constraints(modelAt(schema, 'input', path)), relatedPaths);
+  const filters = {};
+  for (const name of Object.keys(filterFields)) {
+    if (options[name] === undefined) continue;
+    const value = options[name];
+    if (filterModels[name].type === 'integer') {
+      if (typeof value !== 'string' || !/^(0|[1-9]\d*)$/.test(value)) throw invalid(`/filters/${name}`);
+      filters[name] = Number(value);
+    } else {
+      if (typeof value !== 'string' || /\p{Cc}/u.test(value)) throw invalid(`/filters/${name}`);
+      filters[name] = value;
+    }
+  }
+  const range = {};
+  for (const [name, startName, endName] of [['created', 'startCreated', 'endCreated'],
+    ['updated', 'startUpdated', 'endUpdated']]) {
+    const start = options[startName], end = options[endName];
+    if ((start === undefined) !== (end === undefined)) {
+      throw invalid(`/range/${name}/${start === undefined ? 'start' : 'end'}`, 'conditional_required',
+        { format: `${startName === 'startCreated' ? '--start-created 与 --end-created' : '--start-updated 与 --end-updated'} 必须成对提供，北京时间 YYYY-MM-DD HH:mm:ss` },
+        [`/range/${name}/${start === undefined ? 'end' : 'start'}`]);
+    }
+    if (start === undefined) continue;
+    try {
+      if (typeof start !== 'string' || typeof end !== 'string' || start !== start.trim() || end !== end.trim()) throw new Error('invalid time');
+      const startMs = parseDateTime(start), endMs = parseDateTime(end);
+      if (startMs % 1000 || endMs % 1000 || startMs >= endMs) throw new Error('invalid range');
+      range[name] = { start: formatDateTime(startMs), end: formatDateTime(endMs) };
+    } catch { throw invalid(`/range/${name}`, 'invalid_format', {
+      format: '北京时间 YYYY-MM-DD HH:mm:ss，开始结束必须成对且开始早于结束，非零毫秒不支持'
+    }); }
+  }
+  if (range.updated && !range.created) throw invalid('/range/created', 'conditional_required',
+    { format: '提供更新时间时，还必须提供完整创建时间范围' }, ['/range/updated']);
+  const pagination = {};
+  for (const [name, fallback] of [['pageNo', '1'], ['pageSize', '20']]) {
+    const value = options[name] === undefined ? fallback : options[name];
+    if (typeof value !== 'string' || !/^[1-9]\d*$/.test(value)) throw invalid(`/pagination/${name}`);
+    pagination[name] = Number(value);
+  }
+  const input = { scope, filters, range, pagination };
+  validateCommandValue(schema, 'input', input);
+  if (pagination.pageNo * pagination.pageSize > 3000) throw invalid('/pagination/pageNo', 'constraint',
+    { maximum: Math.floor(3000 / pagination.pageSize) }, ['/pagination/pageSize']);
+  return input;
+}
+
+function createCommand({ context } = {}) {
+  const instance = new DiagnosticCommand('list', { path: command, schema, optionPaths: {
+    '/scope/kdtId': 'kdtId',
+    ...Object.fromEntries(Object.keys(filterModels).map(name => [`/filters/${name}`, name])),
+    '/range/created': 'startCreated', '/range/created/start': 'startCreated', '/range/created/end': 'endCreated',
+    '/range/updated': 'startUpdated', '/range/updated/start': 'startUpdated', '/range/updated/end': 'endUpdated',
+    '/pagination/pageNo': 'pageNo', '/pagination/pageSize': 'pageSize'
+  } })
+    .description('读取同店一页售后单摘要，不追加逐行详情')
+    .allowExcessArguments(false)
+    .option('--kdt-id <id>', '目标店铺正安全整数；省略时使用当前上下文店铺');
+  for (const [name, model] of Object.entries(filterModels)) {
+    const flag = name.replace(/[A-Z]/g, letter => `-${letter.toLowerCase()}`);
+    instance.option(`--${flag} <value>`, model.description);
+  }
+  instance
+    .option('--start-created <time>', '创建开始时间，北京时间，须与结束时间成对且早于结束')
+    .option('--end-created <time>', '创建结束时间，仅整数秒精度')
+    .option('--start-updated <time>', '更新开始时间，须提供更新结束及创建时间对')
+    .option('--end-updated <time>', '更新结束时间，仅整数秒精度')
+    .option('--page-no <n>', '页码 1..100，第100页有更多时须缩小范围', '1')
+    .option('--page-size <n>', '本页数量 1..20，CLI 有界策略', '20')
+    .addOption(new Option('--format <format>', 'json 或 pretty，仅改变缩进').choices(['json', 'pretty']).default('json'))
+    .option('--dry-run', '纯本地脱敏预览，不读凭证、不联网')
+    .addHelpText('after', `
+默认只读第1页20条；无时间筛选时由上游默认查询近三个月创建记录，不伪造日期。
+时间格式 YYYY-MM-DD HH:mm:ss，可带1至3位零毫秒；非零毫秒拒绝，不截断。
+total 缺失时 total 与 hasMore 均为 null，空页或短页不能证明读完；不承诺全集或快照。
+nextPageNo 只提供窗口内可请求的下一页，null 时不能继续；windowLimitReached=true 表示已到CLI窗口但尚未确认读完，须缩小原范围。
+列表没有当前诉求字段，不从 demand 筛选回填。金额是申请退款元金额，不代表实际到账。
+执行需要有效同店上下文和公共调用前置，见 zan-saas skills read zan-saas-shared；应用 token 不证明员工权限。
+最多2次请求，先核验店铺，再读一页；不自动重试、换店或逐行补查。
+字段、筛选枚举和边界见 zan-saas schema aftersale.case.list。
+示例：zan-saas aftersale case list --kdt-id 63077 --handling-status 0 --dry-run
+`)
+    .action(async options => {
+      const input = buildInput(options, context);
+      let output = { requests: [
+        { method: 'POST', path: bindingPath, body: {} },
+        { method: 'POST', path: listPath, body: toPreviewBody(input) }
+      ] };
+      validateCommandValue(schema, 'preview', output);
+      if (!options.dryRun) {
+        const readPage = await createCasePageReader(input.scope, command);
+        output = await readPage(input);
+        try { validateCommandValue(schema, 'output', output); }
+        catch { throw reject(command, 'protocol', 'output-model', input.scope, 'sent'); }
+      }
+      console.log(serialize(output, options.format, command, input.scope));
+    });
+  const supplied = new Set();
+  for (const option of instance.options) {
+    instance.on(`option:${option.name()}`, () => {
+      if (supplied.has(option.name())) throw instance.issue('constraint', option);
+      supplied.add(option.name());
+    });
+  }
+  return instance;
+}
+
+module.exports = { kind: 'atomic', risk: 'read', at: 'shop', createCommand: withTargetShopDefault(createCommand), buildInput };