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

package/src/commands/native/item/item-content/get/command.js

@@ -0,0 +1,54 @@
+'use strict';
+
+const { withTargetShopDefault } = require('../../../../../execution/target-shop-default');
+
+const { Option } = require('commander');
+const { DiagnosticCommand } = require('../../../../../cli/diagnostic-command');
+const diagnostics = require('../../shared/diagnostics');
+const schema = require('./schema.json');
+const { validateCommandValue } = require('../../../../../execution/command-schema');
+const { ItemQueryError } = require('../../shared/api');
+
+const { contentRequest, readContent, CONTENT_API } = require('../../shared/content');
+
+const path = 'item.item-content.get';
+
+function createCommand() {
+  return new DiagnosticCommand('get', { path, schema, parameterCategory: 'parameter', optionPaths: { '/item_id': 'itemId' } })
+    .description('只查询指定商品的图文内容、组件配置和封面')
+    .allowExcessArguments(false)
+    .option('--kdt-id <id>', '目标店铺 ID；省略时使用当前上下文店铺')
+    .requiredOption('--item-id <id>', '必填：新版商品 ID，与目标店铺和渠道一起使用；不是渠道商品 ID')
+    .option('--channel <channel>', '渠道：0 网店，1 门店', '0')
+    .addOption(new Option('--format <format>', 'json 或 pretty（仅改变缩进）').choices(['json', 'pretty']).default('json'))
+    .option('--dry-run', '仅本地校验并预览一次图文请求，不读凭证、不联网')
+    .addHelpText('after', `
+返回 data.content 图文对象，HTML 和 components JSON 字符串按接口形态保留。
+只调用图文接口，不附带商品资料、H5、店铺角色或组织查询。
+需要商品资料和图文时使用 item item get --include content。
+适用于接口支持的单店、总部和非总部店铺；不支持分店查总部及分店渠道互查。
+执行需要有效的用户、组织与店铺上下文，可通过登录后选店或 ZAN_SAAS_CONTEXT 提供；目标范围和服务端授权按本命令契约校验，公共调用前置见 zan-saas skills read zan-saas-shared。
+按目标店铺和 --channel 查询，店铺省略时使用当前上下文，由服务端校验权限。缺少上下文可本地预览，无效上下文拒绝。
+失败 stdout 为空，stderr 为错误 JSON；无自动重试，不切店铺、渠道或身份。
+
+示例：
+  zan-saas item item-content get --kdt-id 63077 --item-id 123
+  zan-saas item item-content get --kdt-id 63077 --item-id 123 --channel 1 --dry-run
+`)
+    .action(async options => {
+      const scope = diagnostics.itemScope(options, schema);
+      let result;
+      if (options.dryRun) {
+        result = contentRequest(scope);
+        validateCommandValue(schema, 'preview', result);
+      } else {
+        result = { data: { content: await readContent(scope, path) } };
+        diagnostics.validateOutput(schema, result, () => new ItemQueryError('protocol', 'content-model', scope,
+          { api: CONTENT_API }, 'sent', path));
+      }
+      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);