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

package/src/commands/native/item/commands.index.json

@@ -0,0 +1,87 @@
+{
+  "schemaVersion": 3,
+  "domain": "item",
+  "businessCommands": [
+    {
+      "path": "item.attribute.list",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/attribute/list/command.js",
+      "fingerprint": "273908ed220bfa22480f57ef7f9652a5df7c8ad9689a74ce8f07509824959a4c"
+    },
+    {
+      "path": "item.brand.list",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/brand/list/command.js",
+      "fingerprint": "96f4e309aa87ea5253a01c38c7ba1e2fe292d11d738b2d02364c1aaa80405ebe"
+    },
+    {
+      "path": "item.classification.get",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/classification/get/command.js",
+      "fingerprint": "5c1ef86d254aea22d1fec9e5b843b44b3f0bd4075b9595c10c63aefa590a5a7a"
+    },
+    {
+      "path": "item.classification.list",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/classification/list/command.js",
+      "fingerprint": "52193dd19054ca7643bdd947ba3f7bac19764543fb251564a8d003ca352e78eb"
+    },
+    {
+      "path": "item.group.list",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/group/list/command.js",
+      "fingerprint": "57826cb0e6f1808f5154fbfd31a99654c850b5c9af46eb8d6cab524812d2af01"
+    },
+    {
+      "path": "item.item.get",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/item/get/command.js",
+      "fingerprint": "175549ef14c9f70912860bd8bdabc70d1d1e827cfa80373cfc01c6167e1f8088"
+    },
+    {
+      "path": "item.item.list",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/item/list/command.js",
+      "fingerprint": "7c8da44ca21834ed7690129cec7e873c1335c691e4a2af85eccadfb21534be2b"
+    },
+    {
+      "path": "item.item.scan",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/item/scan/command.js",
+      "fingerprint": "1c8e3bd999a7f60945e2181b4d4e87c23dd9322469928244087cc38fcbbee3ec"
+    },
+    {
+      "path": "item.item-content.get",
+      "kind": "atomic",
+      "risk": "read",
+      "availability": "available",
+      "at": "all",
+      "module": "item/item-content/get/command.js",
+      "fingerprint": "73f2acaa56ea305cd4ed75930da660cdc8db4f114e9a14f58bdf585520f032c9"
+    }
+  ]
+}

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

@@ -0,0 +1 @@
+{"description":"商品：商品资料、规格与关联内容"}

package/src/commands/native/item/group/list/command.js

@@ -0,0 +1,122 @@
+'use strict';
+
+const { withTargetShopDefault } = require('../../../../../execution/target-shop-default');
+
+const { Option } = require('commander');
+const { DiagnosticCommand } = require('../../../../../cli/diagnostic-command');
+const { inputIssue, parseIntegerOption, withInputScope, constraints, modelAt } = require('../../../../../execution/error-details');
+const schema = require('./schema.json');
+const diagnostics = require('../../shared/diagnostics');
+const { validateCommandValue } = require('../../../../../execution/command-schema');
+const { readApi, ItemQueryError, object } = require('../../shared/api');
+
+const commandPath = 'item.group.list';
+const SEARCH = 'youzan.item.group.search/1.0.0';
+const CHILDREN = 'youzan.item.group.children.get/1.0.0';
+const PAGE_SIZE = 20;
+function failure(category, stage, scope = {}, facts = {}, sent = 'not_sent') {
+  return new ItemQueryError(category, stage, scope, facts, sent, commandPath);
+}
+function integer(raw, path) {
+  return parseIntegerOption(typeof raw === 'string' ? raw.trim() : raw, schema, path);
+}
+
+function buildInput(options) {
+  const scope = { kdtId: integer(options.kdtId, '/kdtId'), channel: Number(options.channel) };
+  return withInputScope(scope, () => {
+    if (!['0', '1'].includes(options.channel)) {
+      throw inputIssue('/channel', 'invalid_choice', constraints(modelAt(schema, 'input', '/channel')));
+    }
+    const pageNo = integer(options.pageNo, '/pageNo');
+    if (options.parentGroupId !== undefined) {
+      scope.parentGroupId = integer(options.parentGroupId, '/parentGroupId');
+    }
+    const input = { ...scope, pageNo };
+    if (options.title !== undefined) {
+      if (typeof options.title !== 'string') throw inputIssue('/title', 'invalid_type', { type: 'string', minLength: 1 });
+      input.title = options.title.trim();
+    }
+    if (input.parentGroupId !== undefined && input.title !== undefined) {
+      throw inputIssue('/parentGroupId', 'constraint',
+        constraints(modelAt(schema, 'input', '/parentGroupId')), ['/title']);
+    }
+    validateCommandValue(schema, 'input', input);
+    const request = { kdt_id: scope.kdtId, channel: scope.channel, page_no: pageNo };
+    if (scope.parentGroupId !== undefined) request.group_id = scope.parentGroupId;
+    if (input.title !== undefined) request.title = input.title;
+    return { scope, pageNo, request: { method: 'POST',
+      path: scope.parentGroupId === undefined ? SEARCH : CHILDREN, body: { request } } };
+  });
+}
+
+async function execute(input) {
+  const { scope, pageNo, request } = input;
+  const raw = await readApi(request.path, request.body, 'groups', scope, commandPath);
+  const invalid = () => failure('protocol', 'groups-model', scope, { api: request.path }, 'sent');
+  if (!object(raw) || !Array.isArray(raw.items) || raw.items.length > PAGE_SIZE ||
+      (raw.paginator !== undefined && !object(raw.paginator))) throw invalid();
+  const paginator = raw.paginator || {};
+  if ((paginator.page_no !== undefined && paginator.page_no !== pageNo) ||
+      (paginator.page_size !== undefined && paginator.page_size !== PAGE_SIZE) ||
+      (paginator.total_count != null &&
+        (!Number.isSafeInteger(paginator.total_count) || paginator.total_count < 0))) throw invalid();
+  for (const group of raw.items) {
+    if (!object(group) || group.kdt_id !== scope.kdtId ||
+        (group.channel !== undefined && group.channel !== scope.channel)) throw invalid();
+  }
+  const total = paginator.total_count ?? null;
+  // A short page can result from filtering within the API; total may still report later pages.
+  const reportedMore = total !== null && total > pageNo * PAGE_SIZE;
+  const exhausted = raw.items.length < PAGE_SIZE && total !== null && !reportedMore;
+  const result = { data: { groups: raw.items, pagination: diagnostics.pagination(pageNo, raw.items.length, reportedMore ? true : exhausted ? false : null, null) } };
+  result.data.groups = diagnostics.normalize(raw.items, schema, '/data/groups', invalid);
+  diagnostics.validateOutput(schema, result, invalid);
+  return result;
+}
+
+function createCommand() {
+  return new DiagnosticCommand('list', { path: commandPath, schema, parameterCategory: 'parameter' })
+    .description('查询店铺商品分组目录，返回一级分组或指定父分组的直接子分组')
+    .allowExcessArguments(false)
+    .option('--kdt-id <id>', '目标店铺 ID；省略时使用当前上下文店铺')
+    .requiredOption('--channel <channel>', '必填：0 网店分组，1 门店分组')
+    .option('--parent-group-id <id>', '查询父分组下的直接子分组；0 表示一级分组，不支持同时传 --title')
+    .option('--title <text>', '一级分组的服务端名称条件，不承诺匹配方式；不能与 --parent-group-id 同用')
+    .option('--page-no <n>', '页码从 1 开始，最大 2147483647；固定每页20条', '1')
+    .addOption(new Option('--format <format>', 'json 或 pretty（仅改变缩进）').choices(['json', 'pretty']).default('json'))
+    .option('--dry-run', '仅本地预览一次分页请求，不读凭证、不联网')
+    .addHelpText('after', `
+返回 data.groups 和 data.pagination，只查当前页，不递归读取子分组、不组装树。
+--title 不承诺精确、包含、前缀或唯一匹配，不在本地筛选或自动选择第一条。
+需要名称完全相等时，只能比较已取得记录的原始名称；本页单一同名项不证明全范围唯一，空页不证明全店不存在。
+无父分组时只搜索一级分组；指定父分组时切换子分组接口，不回退另一接口。
+${schema.errors.parentTitleConflict.message}
+${schema.errors.parentTitleConflict.nextStep}
+时间点统一输出北京时间 YYYY-MM-DD HH:mm:ss.SSS，字段声明的业务哨兵保留。
+两个接口都固定20条/页，按创建时间、分组ID倒序；不提供 --page-size、--group-id、--is-sub 或 --tree。
+总数超过当前分页窗口时，短页也保留下一页；缺总数时是否还有下一页为未知。
+仅短页且已提供总数未超过窗口时报告结束信号；hasMore=true 时在相同筛选下将 pageNo 加1继续，达到最大页码时停止。
+分页结束信号不表示全店分组、完整树或并发数据的快照保证。
+当前接口计数可能早于最终过滤与渠道转换，不能证明匹配总数，因此省略 total。
+nextPageNo 非空时继续，windowLimitReached=true 时停止翻页。
+查询商品属于哪些分组使用 item item get --include group；独立 group tree 尚未发布。
+适用接口支持的单店、总部及非总部位置；真实权限与目标归属由服务端校验。
+执行需要有效的用户、组织与店铺上下文，可通过登录后选店或 ZAN_SAAS_CONTEXT 提供；目标范围和服务端授权按本命令契约校验，公共调用前置见 zan-saas skills read zan-saas-shared。
+缺少上下文可以本地预览，提供无效上下文则拒绝。失败stdout为空，stderr为错误JSON。
+无自动翻页、重试、身份/目标切换，不查商品详情、店铺角色或H5。
+
+示例：
+  zan-saas item group list --kdt-id 63077 --channel 0 --title 热销
+  zan-saas item group list --kdt-id 63077 --channel 1 --parent-group-id 123 --page-no 2
+  zan-saas item group list --kdt-id 63077 --channel 0 --dry-run
+`)
+    .action(async options => {
+      const input = buildInput(options);
+      const result = options.dryRun ? input.request : await execute(input);
+      if (options.dryRun) validateCommandValue(schema, 'preview', result);
+      process.stdout.write(`${JSON.stringify(result, null, options.format === 'pretty' ? 2 : 0)}\n`);
+    });
+}
+
+module.exports = { kind: 'atomic', risk: 'read', at: 'all' };
+module.exports.createCommand = withTargetShopDefault(createCommand);