@optima-chat/tiktok-cli 0.5.0 → 0.7.0

package/dist/index.js

@@ -85,6 +85,33 @@ async function createAuthLink() {
     return { ok: false, error: { code: "BACKEND_UNREACHABLE", message: e.message, retryable: true } };
   }
 }
+async function fetchEvents(shop, query) {
+  try {
+    const qs = new URLSearchParams(query).toString();
+    const r = await fetch(`${BACKEND}/events/${shop}${qs ? "?" + qs : ""}`, { headers: authHeaders() });
+    if (r.status === 401) return { ok: false, error: { code: "AUTH_EXPIRED", message: "\u672A\u767B\u5F55\u6216 token \u5931\u6548", retryable: false } };
+    if (r.status === 404) return { ok: false, error: { code: "SHOP_NOT_AUTHORIZED", message: "\u672A\u627E\u5230\u4F60\u540D\u4E0B\u7684\u5DF2\u6388\u6743\u5E97\u94FA", retryable: false }, meta: { shop } };
+    const body = await r.json();
+    return { ok: true, data: body, meta: { shop } };
+  } catch (e) {
+    return { ok: false, error: { code: "BACKEND_UNREACHABLE", message: e.message, retryable: true } };
+  }
+}
+async function ackEvents(shop, body) {
+  try {
+    const r = await fetch(`${BACKEND}/events/${shop}/ack`, {
+      method: "POST",
+      headers: { "Content-Type": "application/json", ...authHeaders() },
+      body: JSON.stringify(body)
+    });
+    if (r.status === 401) return { ok: false, error: { code: "AUTH_EXPIRED", message: "\u672A\u767B\u5F55\u6216 token \u5931\u6548", retryable: false } };
+    if (r.status === 404) return { ok: false, error: { code: "SHOP_NOT_AUTHORIZED", message: "\u672A\u627E\u5230\u4F60\u540D\u4E0B\u7684\u5DF2\u6388\u6743\u5E97\u94FA", retryable: false }, meta: { shop } };
+    const j = await r.json();
+    return { ok: true, data: j, meta: { shop } };
+  } catch (e) {
+    return { ok: false, error: { code: "BACKEND_UNREACHABLE", message: e.message, retryable: true } };
+  }
+}
 async function uploadImage(shop, filePath, useCase) {
   try {
     const buf = readFileSync(filePath);
@@ -135,6 +162,196 @@ var COMMANDS = [
     summary: "\u8BA2\u5355\u8BE6\u60C5\uFF08--id \u5FC5\u586B\uFF09",
     run: ({ shop, args: args2 }) => proxy("GET", shop, "/order/202309/orders/detail", { query: { ids: args2.id } })
   },
+  // ── 售后（退货/取消）只读 ──
+  {
+    name: "orders cancellations",
+    summary: "\u53D6\u6D88\u5355\u5217\u8868\uFF08--status \u53EF\u9009\uFF0C--page-size\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/return_refund/202309/cancellations/search", {
+      query: { page_size: String(args2["page-size"] ?? 20) },
+      body: args2.status ? { cancel_status: args2.status } : {}
+    })
+  },
+  {
+    name: "orders returns",
+    summary: "\u9000\u8D27\u5355\u5217\u8868\uFF08--status \u53EF\u9009\uFF0C--page-size\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/return_refund/202309/returns/search", {
+      query: { page_size: String(args2["page-size"] ?? 20) },
+      body: args2.status ? { return_status: args2.status } : {}
+    })
+  },
+  {
+    name: "orders return-records",
+    summary: "\u9000\u8D27\u5355\u5904\u7406\u8BB0\u5F55\uFF08--id return_id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/return_refund/202309/returns/${args2.id}/records`, {})
+  },
+  {
+    name: "orders aftersale-eligibility",
+    summary: "\u8BA2\u5355\u552E\u540E\u8D44\u683C\uFF08--order id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/return_refund/202512/orders/${args2.order}/aftersale_eligibility`, {})
+  },
+  {
+    name: "orders reject-reasons",
+    summary: "\u9A73\u56DE\u53D6\u6D88/\u9000\u8D27\u7684\u5408\u6CD5\u7406\u7531\uFF08--id return_or_cancel_id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, "/return_refund/202309/reject_reasons", {
+      query: { return_or_cancel_id: args2.id }
+    })
+  },
+  {
+    name: "orders refund-calculate",
+    summary: "\u8BA1\u7B97\u9000\u6B3E\u989D\uFF08--body-file calc.json\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/return_refund/202309/refunds/calculate", {
+      body: readBodyFile(args2["body-file"])
+    })
+  },
+  // ── 履约可见性 只读 ──
+  {
+    name: "orders tracking",
+    summary: "\u8BA2\u5355\u7269\u6D41\u8DDF\u8E2A\uFF08--order id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/fulfillment/202309/orders/${args2.order}/tracking`, {})
+  },
+  {
+    name: "orders shipping-services",
+    summary: "\u8BA2\u5355\u53EF\u7528\u627F\u8FD0/\u914D\u9001\u670D\u52A1\uFF08--order id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, `/fulfillment/202309/orders/${args2.order}/shipping_services/query`, {
+      body: {}
+    })
+  },
+  {
+    name: "packages search",
+    summary: "\u5305\u88F9\u5217\u8868\uFF08--page-size\uFF09",
+    run: ({ shop, args: args2 }) => proxy("POST", shop, "/fulfillment/202309/packages/search", {
+      query: { page_size: String(args2["page-size"] ?? 20) },
+      body: {}
+    })
+  },
+  {
+    name: "packages get",
+    summary: "\u5305\u88F9\u8BE6\u60C5\uFF08--package id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/fulfillment/202309/packages/${args2.package}`, {})
+  },
+  {
+    name: "packages documents",
+    summary: "\u5305\u88F9\u7269\u6D41\u9762\u5355\uFF08--package id\uFF09",
+    run: ({ shop, args: args2 }) => proxy("GET", shop, `/fulfillment/202309/packages/${args2.package}/shipping_documents`, {})
+  },
+  // ── 售后审批 / 发货 写（不可逆，默认 dry-run，--apply 才提交）──
+  {
+    name: "orders cancel-approve",
+    summary: "\u6279\u51C6\u53D6\u6D88\u5355\uFF08--id cancel_id\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u6279\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u6279\u51C6\u53D6\u6D88\u5355",
+      method: "POST",
+      path: `/return_refund/202309/cancellations/${args2.id}/approve`,
+      body: {}
+    }],
+    run: ({ shop, args: args2 }) => proxy("POST", shop, `/return_refund/202309/cancellations/${args2.id}/approve`, { body: {} })
+  },
+  {
+    name: "orders cancel-reject",
+    summary: "\u9A73\u56DE\u53D6\u6D88\u5355\uFF08--id --reason\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u9A73\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u9A73\u56DE\u53D6\u6D88\u5355",
+      method: "POST",
+      path: `/return_refund/202309/cancellations/${args2.id}/reject`,
+      body: { reject_reason: args2.reason }
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/return_refund/202309/cancellations/${args2.id}/reject`,
+      { body: { reject_reason: args2.reason } }
+    )
+  },
+  {
+    name: "orders return-approve",
+    summary: "\u6279\u51C6\u9000\u8D27\u5355\uFF08--id return_id\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u6279\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u6279\u51C6\u9000\u8D27\u5355",
+      method: "POST",
+      path: `/return_refund/202309/returns/${args2.id}/approve`,
+      body: {}
+    }],
+    run: ({ shop, args: args2 }) => proxy("POST", shop, `/return_refund/202309/returns/${args2.id}/approve`, { body: {} })
+  },
+  {
+    name: "orders return-reject",
+    summary: "\u9A73\u56DE\u9000\u8D27\u5355\uFF08--id --reason\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u9A73\u3002\u4E0D\u53EF\u9006",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u9A73\u56DE\u9000\u8D27\u5355",
+      method: "POST",
+      path: `/return_refund/202309/returns/${args2.id}/reject`,
+      body: { reject_reason: args2.reason }
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/return_refund/202309/returns/${args2.id}/reject`,
+      { body: { reject_reason: args2.reason } }
+    )
+  },
+  {
+    name: "orders create-package",
+    summary: "\u4E3A\u8BA2\u5355\u5EFA\u5305\u88F9\uFF08--order id --body-file pkg.json\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u5EFA\u3002\u4EC5\u76F4\u53D1\u5546\u5BB6\uFF08\u7269\u6D41\u9ED8\u8BA4 ERP \u7BA1\uFF09",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u5EFA\u5305\u88F9",
+      method: "POST",
+      path: `/fulfillment/202309/orders/${args2.order}/packages`,
+      body: readBodyFile(args2["body-file"])
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/fulfillment/202309/orders/${args2.order}/packages`,
+      { body: readBodyFile(args2["body-file"]) }
+    )
+  },
+  {
+    name: "packages ship",
+    summary: "\u53D1\u8D27\uFF08--package id --body-file ship.json\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u53D1\u3002\u4E0D\u53EF\u9006\uFF0C\u4EC5\u76F4\u53D1\u5546\u5BB6",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u53D1\u8D27",
+      method: "POST",
+      path: `/fulfillment/202309/packages/${args2.package}/ship`,
+      body: readBodyFile(args2["body-file"])
+    }],
+    run: ({ shop, args: args2 }) => proxy(
+      "POST",
+      shop,
+      `/fulfillment/202309/packages/${args2.package}/ship`,
+      { body: readBodyFile(args2["body-file"]) }
+    )
+  },
+  // ── webhook 事件流（backend 自有事件库，不走 /proxy）──
+  {
+    name: "events",
+    summary: "\u67E5\u5E97\u94FA webhook \u4E8B\u4EF6\uFF08--type \u9017\u53F7\u5206\u9694 --since 1d/unix --unprocessed --limit\uFF09",
+    run: ({ shop, args: args2 }) => {
+      const q = {};
+      if (args2.type) q.type = args2.type;
+      if (args2.since) q.since = args2.since;
+      if (args2.unprocessed) q.unprocessed = "true";
+      if (args2.limit) q.limit = String(args2.limit);
+      return fetchEvents(shop, q);
+    }
+  },
+  {
+    name: "events ack",
+    summary: "\u6807\u4E8B\u4EF6\u5DF2\u5904\u7406\uFF08--ids id1,id2 \u6216 --before <ts>\uFF09\u3002\u9ED8\u8BA4 dry-run\uFF0C--apply \u624D\u6807",
+    write: true,
+    preview: ({ args: args2 }) => [{
+      step: "\u6807\u4E8B\u4EF6\u5DF2\u5904\u7406",
+      method: "POST",
+      path: "/events/{shop}/ack",
+      body: args2.ids ? { event_ids: String(args2.ids).split(",") } : { before: args2.before }
+    }],
+    run: ({ shop, args: args2 }) => ackEvents(shop, args2.ids ? { event_ids: String(args2.ids).split(",") } : { before: args2.before })
+  },
   {
     name: "analytics shop",
     summary: "\u5E97\u94FA\u7ECF\u8425\u6570\u636E\uFF08--from --to\uFF0C\u9ED8\u8BA4\u8FD130\u5929\uFF09",

package/package.json

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