@optima-chat/tiktok-cli 0.7.1 → 0.8.0

package/dist/index.js

@@ -75,16 +75,60 @@ async function listShops() {
     return { ok: false, error: { code: "BACKEND_UNREACHABLE", message: e.message, retryable: true } };
   }
 }
-async function createAuthLink() {
+async function availableApps() {
   try {
-    const r = await fetch(`${BACKEND}/auth/link`, { method: "POST", headers: authHeaders() });
+    const r = await fetch(`${BACKEND}/auth/apps`, { headers: authHeaders() });
     if (r.status === 401) return { ok: false, error: { code: "AUTH_EXPIRED", message: "\u672A\u767B\u5F55\u6216 token \u5931\u6548", retryable: false } };
-    const body = await r.json();
+    const body = await r.json().catch(() => ({}));
+    if (!r.ok || body?.error) {
+      return { ok: false, error: { code: "VALIDATION", message: body?.error ?? `HTTP ${r.status}`, retryable: false } };
+    }
+    return { ok: true, data: body };
+  } catch (e) {
+    return { ok: false, error: { code: "BACKEND_UNREACHABLE", message: e.message, retryable: true } };
+  }
+}
+async function authLink(app) {
+  try {
+    const r = await fetch(`${BACKEND}/auth/link`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...authHeaders() },
+      body: JSON.stringify({ app })
+    });
+    if (r.status === 401) return { ok: false, error: { code: "AUTH_EXPIRED", message: "\u672A\u767B\u5F55\u6216 token \u5931\u6548", retryable: false } };
+    const body = await r.json().catch(() => ({}));
+    if (!r.ok || body?.error) {
+      return { ok: false, error: { code: "VALIDATION", message: body?.error ?? body?.message ?? `HTTP ${r.status}`, retryable: false } };
+    }
     return { ok: true, data: { authorize_url: body.authorize_url, expires_in_minutes: 15 } };
   } catch (e) {
     return { ok: false, error: { code: "BACKEND_UNREACHABLE", message: e.message, retryable: true } };
   }
 }
+async function adminApps(method, opts = {}) {
+  const url = `${BACKEND}/admin/apps${opts.id ? `/${opts.id}` : ""}`;
+  const token = process.env.TIKTOK_ADMIN_TOKEN;
+  try {
+    const r = await fetch(url, {
+      method,
+      headers: {
+        "Content-Type": "application/json",
+        ...token ? { "x-admin-token": token } : {}
+      },
+      body: method === "GET" ? void 0 : JSON.stringify(opts.body ?? {})
+    });
+    const body = await r.json().catch(() => ({}));
+    if (r.status === 401 || r.status === 403) {
+      return { ok: false, error: { code: "VALIDATION", message: body?.error ?? "admin token \u65E0\u6548\u6216\u7F3A\u5931", retryable: false } };
+    }
+    if (!r.ok) {
+      return { ok: false, error: { code: "VALIDATION", message: body?.error ?? body?.message ?? `HTTP ${r.status}`, retryable: false } };
+    }
+    return { ok: true, data: body };
+  } catch (e) {
+    return { ok: false, error: { code: "BACKEND_UNREACHABLE", message: e.message, retryable: true } };
+  }
+}
 async function fetchEvents(shop, query) {
   try {
     const qs = new URLSearchParams(query).toString();
@@ -145,15 +189,25 @@ function mergeSkus(existing, add) {
 }
 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 COMMANDS = [
   {
     name: "orders list",
-    summary: "\u8BA2\u5355\u5217\u8868\uFF08\u9ED8\u8BA4\u8FD130\u5929\uFF0C\u53EF --status --page-size\uFF09",
+    summary: "\u8BA2\u5355\u5217\u8868\uFF08\u9ED8\u8BA4\u8FD130\u5929\u3001\u6309\u521B\u5EFA\u65F6\u95F4\u5012\u5E8F\uFF1B--from/--to\uFF08unix\u79D2\u6216YYYY-MM-DD\uFF09--status --page-size --sort-order ASC/DESC --sort-field create_time/update_time\uFF09",
     run: ({ shop, args: args2 }) => proxy("POST", shop, "/order/202309/orders/search", {
-      query: { page_size: args2["page-size"] ?? "20" },
+      query: {
+        page_size: args2["page-size"] ?? "20",
+        // 默认倒序（最新在前）——高单量店查「最近订单」不必翻爆全量
+        sort_order: (args2["sort-order"] ?? "DESC").toUpperCase(),
+        sort_field: args2["sort-field"] ?? "create_time",
+        ...args2["page-token"] ? { page_token: args2["page-token"] } : {}
+      },
       body: {
         ...args2.status ? { order_status: args2.status } : {},
-        create_time_ge: args2.since ? Number(args2.since) : Math.floor(Date.parse(daysAgo(30)) / 1e3)
+        // 下界：--from 优先，其次兼容 --since，默认近 30 天
+        create_time_ge: args2.from ? toEpoch(args2.from) : args2.since ? toEpoch(args2.since) : toEpoch(daysAgo(30)),
+        // 上界：--to（可选）
+        ...args2.to ? { create_time_lt: toEpoch(args2.to) } : {}
       }
     })
   },
@@ -826,6 +880,49 @@ var COMMANDS = [
       body: { auto_add_product: { commission_rate: Number(args2.rate), enable: args2.enable === "true" } }
     }),
     readback: ({ shop }) => proxy("GET", shop, "/affiliate_seller/202409/open_collaboration_settings", {})
+  },
+  // ── 多 App 管理（admin 配置操作，鉴权走 x-admin-token，不走商家 --shop，也不走三道阀 dry-run/--apply）──
+  {
+    name: "apps add",
+    summary: "\u767B\u8BB0\u4E00\u4E2A TikTok App\uFF08--service-id --app-key --app-secret --type --label\uFF0C[--markets a,b] [--redirect] [--owner-entity]\uFF09",
+    run: ({ args: args2 }) => adminApps("POST", {
+      body: {
+        serviceId: args2["service-id"],
+        appKey: args2["app-key"],
+        appSecret: args2["app-secret"],
+        appType: args2.type,
+        label: args2.label,
+        ...args2.markets ? { markets: args2.markets.split(",") } : {},
+        redirectUri: args2.redirect,
+        ...args2["owner-entity"] ? { ownerEntity: args2["owner-entity"] } : {}
+      }
+    })
+  },
+  {
+    name: "apps list",
+    summary: "\u5217\u51FA\u5DF2\u767B\u8BB0\u7684 TikTok App\uFF08admin\uFF0C\u542B appKey/status\uFF09",
+    run: () => adminApps("GET")
+  },
+  {
+    name: "apps available",
+    summary: "\u5217\u51FA\u53EF\u9009 App\uFF08\u7528\u6237\u9274\u6743\uFF0C\u4EC5 active\uFF0C\u65E0 secret\uFF09\u2014\u2014\u9009 serviceId \u4F20\u7ED9 auth link --app",
+    run: () => availableApps()
+  },
+  {
+    name: "apps disable",
+    summary: "\u505C\u7528\u4E00\u4E2A TikTok App\uFF08--id\uFF09",
+    run: ({ args: args2 }) => adminApps("PATCH", { id: args2.id, body: { status: "disabled" } })
+  },
+  // ── auth link（多 app：--app 必填 serviceId，决定 backend 用哪个 app_key/secret 生成授权链接）──
+  {
+    name: "auth link",
+    summary: "\u751F\u6210\u5E97\u94FA\u7ED1\u5B9A\u6388\u6743\u94FE\u63A5\uFF08--app serviceId \u5FC5\u586B\uFF0C\u53D1\u7ED9\u5546\u5BB6\u70B9\u51FB\uFF09",
+    run: async ({ args: args2 }) => {
+      if (!args2.app) {
+        return { ok: false, error: { code: "VALIDATION", message: "--app \u5FC5\u586B\uFF08serviceId\uFF09", retryable: false } };
+      }
+      return authLink(args2.app);
+    }
   }
 ];
 function sampleReviewBody(args2) {
@@ -891,6 +988,7 @@ function findCommand(tokens) {
 }
 
 // src/index.ts
+var NO_SHOP_COMMANDS = /* @__PURE__ */ new Set(["auth link", "apps add", "apps list", "apps disable", "apps available"]);
 function parseFlags(tokens) {
   const args2 = {};
   const positional2 = [];
@@ -914,9 +1012,8 @@ function usage() {
   const lines = ["tiktok <domain> <verb> --shop <shopId> [--flags]", "", "\u547D\u4EE4\uFF1A"];
   for (const c of COMMANDS) lines.push(`  ${c.name.padEnd(22)} ${c.summary}`);
   lines.push(`  ${"shops".padEnd(22)} \u67E5\u5F53\u524D\u767B\u5F55\u7528\u6237\u5DF2\u6388\u6743\u5E97\u94FA`);
-  lines.push(`  ${"auth link".padEnd(22)} \u751F\u6210\u5E97\u94FA\u7ED1\u5B9A\u6388\u6743\u94FE\u63A5\uFF08\u53D1\u7ED9\u5546\u5BB6\u70B9\u51FB\uFF09`);
   lines.push(`  ${"images upload".padEnd(22)} \u4E0A\u4F20\u672C\u5730\u56FE\u7247\uFF08--file --use-case [--out]\uFF09`);
-  lines.push("", "\u901A\u7528\uFF1A--shop \u5FC5\u586B\uFF08\u9664 shops / auth link\uFF09\uFF1B\u9ED8\u8BA4 JSON \u8F93\u51FA\uFF1BTIKTOK_BACKEND_URL \u663E\u5F0F\u6307\u5B9A backend\uFF08\u672A\u8BBE\u5219\u6309 OPTIMA_ENV \u6620\u5C04 cn-stage/cn-prod\uFF0C\u5426\u5219 localhost\uFF09\u3002");
+  lines.push("", "\u901A\u7528\uFF1A--shop \u5FC5\u586B\uFF08\u9664 shops / auth link / apps add|list|disable\uFF09\uFF1B\u9ED8\u8BA4 JSON \u8F93\u51FA\uFF1BTIKTOK_BACKEND_URL \u663E\u5F0F\u6307\u5B9A backend\uFF08\u672A\u8BBE\u5219\u6309 OPTIMA_ENV \u6620\u5C04 cn-stage/cn-prod\uFF0C\u5426\u5219 localhost\uFF09\u3002");
   process.stderr.write(lines.join("\n") + "\n");
 }
 var argv = process.argv.slice(2);
@@ -929,10 +1026,6 @@ if (positional[0] === "shops") {
   out(await listShops());
   process.exit(0);
 }
-if (positional[0] === "auth" && positional[1] === "link") {
-  out(await createAuthLink());
-  process.exit(0);
-}
 if (positional[0] === "images" && positional[1] === "upload") {
   if (!args.file) {
     out({ ok: false, error: { code: "VALIDATION", message: "\u7F3A\u5C11 --file", retryable: false } });
@@ -956,11 +1049,11 @@ if (!match) {
   usage();
   process.exit(1);
 }
-if (!args.shop) {
+if (!args.shop && !NO_SHOP_COMMANDS.has(match.cmd.name)) {
   out({ ok: false, error: { code: "VALIDATION", message: "\u7F3A\u5C11 --shop\uFF08\u591A\u5E97\u663E\u5F0F\u8DEF\u7531\uFF09", retryable: false } });
   process.exit(1);
 }
-var ctx = { shop: args.shop, args, actor: args.actor };
+var ctx = { shop: args.shop ?? "", args, actor: args.actor };
 if (match.cmd.write && !("apply" in args)) {
   if (match.cmd.precheck) {
     const pc = await match.cmd.precheck(ctx);

package/package.json

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