cyymall-cli 0.1.9 → 0.1.10

package/README.md

@@ -64,6 +64,10 @@ cyy shop sites --shop-id <门店ID>
 cyy shop use --shop-id <门店ID>
 cyy shop use-site --site-id <站点ID>
 cyy product search --keyword 牛奶
+cyy product category-list
+cyy product zone-tags --group-id <二级分组id>
+cyy product category-skus --group-id <同上> [--zone-key <k>] [--after-key <k>]
+cyy product skus-by-category --group-id <同上>
 cyy api call --method POST --module PRODUCT --path /app/product/getSkuList --body-file body.json
 cyy order quick --keyword 牛奶 --quantity 1 --unit 袋
 cyy serve --port 8787

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cyymall-cli",
-  "version": "0.1.9",
+  "version": "0.1.10",
   "description": "CyyMall / 菜洋洋商城 API CLI (per app-api-cli-spec)",
   "bin": {
     "cyy": "bin/cyy.js"

package/src/cli.js

@@ -146,6 +146,54 @@ prod
     await product.search(opts);
   });
 
+prod
+  .command("category-list")
+  .description("POST /app/product/getCategory — category tree (level-1 + children groups)")
+  .option("--shop-id <id>", "Override shopId (default from session)")
+  .option("--site-id <id>", "Override siteId")
+  .action(async (opts) => {
+    await product.categoryList(opts);
+  });
+
+prod
+  .command("zone-tags")
+  .description("POST /app/product/getZoneTagList — zone tags for a second-level group (--group-id)")
+  .requiredOption("--group-id <id>", "Second-level group id (children[].id from category-list)")
+  .option("--shop-id <id>", "Override shopId")
+  .option("--site-id <id>", "Override siteId")
+  .action(async (opts) => {
+    await product.zoneTags(opts);
+  });
+
+prod
+  .command("category-skus")
+  .description(
+    "POST /app/product/skuListByCategoryTagAll — SKUs under group + optional zone tag (cursor afterKey)",
+  )
+  .requiredOption("--group-id <id>", "Second-level group id")
+  .option("--zone-key <k>", "Zone tag key from zone-tags (required when zone-tags non-empty; App uses first tag, often all)")
+  .option("--after-key <k>", "Cursor from previous response data.afterKey")
+  .option("--page-size <n>", "pageSize (App TAG_PAGE_SIZE default 20)", "20")
+  .option("--shop-id <id>", "Override shopId")
+  .option("--site-id <id>", "Override siteId")
+  .action(async (opts) => {
+    await product.categorySkus(opts);
+  });
+
+prod
+  .command("skus-by-category")
+  .description(
+    "POST /app/product/skuListByCategory — fallback when zone-tags is empty (pageNum pagination)",
+  )
+  .requiredOption("--group-id <id>", "Second-level group id")
+  .option("--page <n>", "pageNum", "1")
+  .option("--page-size <n>", "pageSize (App PAGE_SIZE default 10)", "10")
+  .option("--shop-id <id>", "Override shopId")
+  .option("--site-id <id>", "Override siteId")
+  .action(async (opts) => {
+    await product.skusByCategory(opts);
+  });
+
 const shopCmd = program.command("shop").description("Member shops and delivery sites");
 
 shopCmd

package/src/commands/product.js

@@ -5,48 +5,171 @@ const http = require("../http");
 const config = require("../config");
 const biz = require("../biz");
 
-/**
- * @param {object} opts
- */
-async function search(opts) {
-  const cfg = config.requireAuthSession();
-
-  const shopId = Number(opts.shopId ?? cfg.shop_id);
-  const siteId = Number(opts.siteId ?? cfg.site_id);
-  const body = JSON.stringify({
-    pageNum: Number(opts.page || 1),
-    pageSize: Number(opts.pageSize || 10),
-    shopId,
-    siteId,
-    spuName: opts.keyword,
-    stockFlag: String(opts.stockFlag ?? "0"),
-  });
-
-  const url = http.moduleUrl("PRODUCT", "/app/product/getSkuList");
-  const headers = /** @type {Record<string,string>} */ (http.buildAuthHeaders(cfg));
-
-  const { ok, json } = await http.request(url, {
-    method: "POST",
-    headers,
-    body,
-  });
+/** App ResponseCode.TAG_PAGE_SIZE — used by skuListByCategoryTagAll */
+const DEFAULT_TAG_PAGE_SIZE = 20;
+/** App ResponseCode.PAGE_SIZE — used by skuListByCategory */
+const DEFAULT_CATEGORY_PAGE_SIZE = 10;
 
+function envelope(success, message, upstream, exitCode) {
   const traceId = `local-${crypto.randomBytes(8).toString("hex")}`;
-  const success = ok && biz.isBizSuccess(json);
   console.log(
     JSON.stringify(
       {
         success,
         code: success ? "OK" : "UPSTREAM_ERROR",
-        message: success ? "success" : "search failed",
-        data: { upstream: json },
+        message,
+        data: { upstream },
         traceId,
       },
       null,
       2,
     ),
   );
-  process.exit(success ? 0 : 2);
+  process.exit(exitCode ?? (success ? 0 : 2));
+}
+
+/**
+ * @param {object} opts
+ * @param {object} cfg
+ */
+function resolveShopSite(opts, cfg) {
+  const shopId = Number(opts.shopId ?? cfg.shop_id);
+  const siteId = Number(opts.siteId ?? cfg.site_id);
+  if (!Number.isFinite(shopId) || !Number.isFinite(siteId)) {
+    console.error("cyy: shop_id and site_id required (session or --shop-id / --site-id)");
+    process.exit(1);
+  }
+  return { shopId, siteId };
+}
+
+/**
+ * @param {string} path
+ * @param {object} bodyObj
+ * @param {string} failMessage
+ */
+async function postProduct(path, bodyObj, failMessage) {
+  const cfg = config.requireAuthSession();
+  const url = http.moduleUrl("PRODUCT", path);
+  const headers = /** @type {Record<string,string>} */ (http.buildAuthHeaders(cfg));
+  const { ok, json } = await http.request(url, {
+    method: "POST",
+    headers,
+    body: JSON.stringify(bodyObj),
+  });
+  const success = ok && biz.isBizSuccess(json);
+  envelope(success, success ? "success" : failMessage, json, success ? 0 : 2);
+}
+
+/**
+ * POST /app/product/getSkuList
+ * @param {object} opts
+ */
+async function search(opts) {
+  const cfg = config.requireAuthSession();
+  const { shopId, siteId } = resolveShopSite(opts, cfg);
+  await postProduct(
+    "/app/product/getSkuList",
+    {
+      pageNum: Number(opts.page || 1),
+      pageSize: Number(opts.pageSize || 10),
+      shopId,
+      siteId,
+      spuName: opts.keyword,
+      stockFlag: String(opts.stockFlag ?? "0"),
+    },
+    "search failed",
+  );
+}
+
+/**
+ * POST /app/product/getCategory — 一级分类树（含二级 children）
+ * @param {object} opts
+ */
+async function categoryList(opts) {
+  const cfg = config.requireAuthSession();
+  const { shopId, siteId } = resolveShopSite(opts, cfg);
+  await postProduct("/app/product/getCategory", { shopId, siteId }, "category list failed");
+}
+
+/**
+ * POST /app/product/getZoneTagList — categoryId 为二级分组 id（groupId）
+ * @param {object} opts
+ */
+async function zoneTags(opts) {
+  const groupId = opts.groupId;
+  if (groupId === undefined || groupId === null || String(groupId).trim() === "") {
+    console.error("cyy: --group-id required (second-level category id from category-list children[].id)");
+    process.exit(1);
+  }
+  const cfg = config.requireAuthSession();
+  const { shopId, siteId } = resolveShopSite(opts, cfg);
+  await postProduct(
+    "/app/product/getZoneTagList",
+    {
+      shopId,
+      siteId,
+      categoryId: Number(groupId),
+    },
+    "zone tag list failed",
+  );
+}
+
+/**
+ * POST /app/product/skuListByCategoryTagAll — 有专区标签时的商品列表（游标 afterKey）
+ * @param {object} opts
+ */
+async function categorySkus(opts) {
+  const groupId = opts.groupId;
+  if (groupId === undefined || groupId === null || String(groupId).trim() === "") {
+    console.error("cyy: --group-id required (second-level category id)");
+    process.exit(1);
+  }
+  const cfg = config.requireAuthSession();
+  const { shopId, siteId } = resolveShopSite(opts, cfg);
+  const body = {
+    shopId,
+    siteId,
+    categoryId: Number(groupId),
+    pageSize: Number(opts.pageSize || DEFAULT_TAG_PAGE_SIZE),
+  };
+  if (opts.afterKey != null && String(opts.afterKey).length > 0) {
+    body.afterKey = String(opts.afterKey);
+  }
+  if (opts.zoneKey != null && String(opts.zoneKey).length > 0) {
+    body.zoneKey = String(opts.zoneKey);
+  }
+  await postProduct("/app/product/skuListByCategoryTagAll", body, "category skus (tag all) failed");
+}
+
+/**
+ * POST /app/product/skuListByCategory — 无专区标签时的兜底（pageNum 分页）
+ * @param {object} opts
+ */
+async function skusByCategory(opts) {
+  const groupId = opts.groupId;
+  if (groupId === undefined || groupId === null || String(groupId).trim() === "") {
+    console.error("cyy: --group-id required (second-level category id)");
+    process.exit(1);
+  }
+  const cfg = config.requireAuthSession();
+  const { shopId, siteId } = resolveShopSite(opts, cfg);
+  await postProduct(
+    "/app/product/skuListByCategory",
+    {
+      shopId,
+      siteId,
+      categoryId: Number(groupId),
+      pageNum: Number(opts.page || 1),
+      pageSize: Number(opts.pageSize || DEFAULT_CATEGORY_PAGE_SIZE),
+    },
+    "category skus failed",
+  );
 }
 
-module.exports = { search };
+module.exports = {
+  search,
+  categoryList,
+  zoneTags,
+  categorySkus,
+  skusByCategory,
+};