@optima-chat/tiktok-cli 0.11.0 → 0.12.0

package/README.md

@@ -25,7 +25,7 @@ tiktok <domain> <verb> --shop <shopId> [--flags]
 | `analytics shop` | 店铺经营数据（`--from --to`，默认近30天） |
 | `analytics products` | 商品维度数据（GMV 降序） |
 | `products list` | 商品列表 |
-| `promotions list` | 促销活动（`--status`） |
+| `promotions list` | 促销活动。`--status` **省略 = 全部状态**（`ONGOING`/`NOT_START`/`EXPIRED`/`DEACTIVATED`；⚠️ 值写错平台**静默忽略并返回全部**，故 CLI **本地硬拒未知值**；平台将来新增值可用 `--force-status` 越过）；`--page-size`（默认 20）；`--page-token` 翻页，**末页无 `next_page_token`** |
 | `finance statements` | 结算单 |
 
 ### 建品前置只读辅助（拼商品体用）

package/dist/index.js

@@ -217,6 +217,7 @@ ${cmd.summary}
 var today = () => (/* @__PURE__ */ new Date()).toISOString().slice(0, 10);
 var daysAgo = (n) => new Date(Date.now() - n * 864e5).toISOString().slice(0, 10);
 var toEpoch = (v) => /^\d+$/.test(v) ? Number(v) : Math.floor(Date.parse(v) / 1e3);
+var PROMOTION_STATUSES = /* @__PURE__ */ new Set(["ONGOING", "NOT_START", "EXPIRED", "DEACTIVATED"]);
 var COMMANDS = [
   {
     name: "orders list",
@@ -598,11 +599,34 @@ var COMMANDS = [
   },
   {
     name: "promotions list",
-    summary: "\u4FC3\u9500\u6D3B\u52A8\u5217\u8868\uFF08--status ONGOING/NOT_START/EXPIRED\uFF09",
+    summary: "\u4FC3\u9500\u6D3B\u52A8\u5217\u8868\uFF08--status \u7701\u7565=\u5168\u90E8\u72B6\u6001\uFF5CONGOING/NOT_START/EXPIRED/DEACTIVATED\uFF0C\u53D6\u503C\u533A\u5206\u5927\u5C0F\u5199\u4E14\u4E0D trim\uFF0C\u672A\u77E5\u503C\u672C\u5730\u62D2\u3001\u5E73\u53F0\u4F1A\u9759\u9ED8\u8FD4\u56DE\u5168\u90E8\uFF1B--force-status \u8D8A\u8FC7\u672C\u5730\u6821\u9A8C\uFF1B--page-size \u9ED8\u8BA420\uFF1B--page-token \u7FFB\u9875\uFF0C\u672B\u9875\u65E0 next_page_token\uFF09",
     listKey: "activities",
-    run: ({ shop, args: args2 }) => proxy("POST", shop, "/promotion/202309/activities/search", {
-      body: { status: args2.status ?? "ONGOING", page_size: Number(args2["page-size"] ?? 20) }
-    })
+    run: ({ shop, args: args2 }) => {
+      const st = args2.status ? String(args2.status) : "";
+      if (st && !PROMOTION_STATUSES.has(st) && !args2["force-status"]) {
+        return Promise.resolve({
+          ok: false,
+          error: {
+            code: "VALIDATION",
+            message: `\u672A\u77E5\u7684 --status ${JSON.stringify(st)}\uFF1B\u5DF2\u77E5\u53D6\u503C\uFF1A${[...PROMOTION_STATUSES].join(" / ")}\u3002\u26A0\uFE0F \u5E73\u53F0\u5BF9\u8BA4\u4E0D\u51FA\u7684\u503C**\u4E0D\u62A5\u9519\uFF0C\u800C\u662F\u8FD4\u56DE\u5168\u90E8\u72B6\u6001** \u2014\u2014 \u6240\u4EE5\u8FD9\u91CC\u672C\u5730\u62D2\u6389\uFF0C\u26D4 \u4E0D\u53D1\u8BF7\u6C42\u3002`,
+            retryable: false
+          }
+        });
+      }
+      return proxy("POST", shop, "/promotion/202309/activities/search", {
+        body: {
+          // 🔴 省略 --status ⇒ body **不带 status 字段**（⛔ 不是传空串）⇒ 平台回全部状态。
+          //    实测（2026-09-19 cn-prod，YOHO Finds）：{page_size:100} 无 status → 51 条，
+          //    分布 {DEACTIVATED:38, ONGOING:13}；显式 DEACTIVATED → 38 条。
+          //    ⚠️ 原先硬默认 "ONGOING" 使「查全部」无法表达；已知调用点都显式传 --status，不破坏。
+          ...args2.status ? { status: String(args2.status) } : {},
+          page_size: Number(args2["page-size"] ?? 20),
+          // 照同文件 orders 的写法（有值才带）。实测 next_page_token="2"→"4" 可翻页、两页无重叠；
+          // **末页该键缺席**（不是空串）⇒ 下游可据此判「读全了」。
+          ...args2["page-token"] ? { page_token: String(args2["page-token"]) } : {}
+        }
+      });
+    }
   },
   {
     name: "finance statements",
@@ -1182,7 +1206,7 @@ function parseFlags(tokens) {
   }
   return { args: args2, positional: positional2 };
 }
-var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["apply", "default", "unprocessed", "enable"]);
+var BOOLEAN_FLAGS = /* @__PURE__ */ new Set(["apply", "default", "unprocessed", "enable", "force-status"]);
 var FLAG_TRUE = /* @__PURE__ */ new Set(["true", "1", "yes", "on"]);
 var FLAG_FALSE = /* @__PURE__ */ new Set(["false", "0", "no", "off", ""]);
 function normalizeBooleanFlags(args2) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optima-chat/tiktok-cli",
-  "version": "0.11.0",
+  "version": "0.12.0",
   "description": "TikTok Shop CLI for Optima agents — 经 tiktok-backend 操作店铺",
   "type": "module",
   "bin": {