@geoly-ai/social-hub-sdk 0.1.19 → 0.1.21

package/dist/index.js

@@ -1,3 +1,7 @@
+// 派单品牌映射 / 接单团队(B4)的类型。
+export * from "./intake-admin.js";
+// 派单运营面(B5-ext E3)的类型。
+export * from "./intake-ops.js";
 // 板块限制(阶段 A4)的类型与受限拦截识别 helper(getSubredditRestrictionBlock)。
 export * from "./subreddit-restrictions.js";
 /** 自动翻页的页大小 —— contracts `listSubredditBlocklistsQuerySchema.limit` 的硬上限。 */
@@ -3188,9 +3192,10 @@ export class SocialHubClient {
     /**
      * POST :id/weekly-stats/refresh — 手动刷新该板块的页面周指标(202 入队)。
      *
-     * 每板块每业务日最多真实抓一次:当日已抓/已入队 → 409,`error.details.code` 为
-     * `refresh_already_charged_today`,`details.nextAllowedAt` 是下一业务日起点;
-     * 其余稳定码见 contracts `WEEKLY_STATS_REFRESH_REJECT_CODES`。
+     * 每板块每业务日最多手动真实抓 2 次(与每日补跑的 1 次互不占用,合计 3 次):
+     * 该板块已有抓取在排队/运行 → 409 `refresh_already_charged_today`;当日 2 次手动用完 →
+     * 409 `manual_refresh_limit_reached`(`details.dailyLimit`=2);两者的 `details.nextAllowedAt`
+     * 都是下一业务日起点;其余稳定码见 contracts `WEEKLY_STATS_REFRESH_REJECT_CODES`。
      * 仅 active 资产;写权限同其它写端点(真实登录 admin,拒 API Key)。
      */
     async refreshOwnedSubredditWeeklyStats(ownedSubredditId) {
@@ -3614,6 +3619,101 @@ export class SocialHubClient {
     async patchRedditAccountVerificationEvidence(teamId, evidenceId, body) {
         return this.fetchJson(`${this.teamBase(teamId)}/reddit-verification/evidence/${evidenceId}`, { method: "PATCH", body: JSON.stringify(body) });
     }
+    // ── 派单品牌映射与接单团队(B4)──────────────────────────────────────────
+    // 系统级(不拼 /teams),仅不受限登录的 admin。映射补齐后订单会自动标记为「品牌已解析」,
+    // 接单(accepted)在后续版本上线。
+    /** GET /v1/system/intake-admin/brand-mappings — 列表(status / mapped=mapped|pending / 分页)。 */
+    async listIntakeBrandMappings(params = {}) {
+        const q = buildQuery({
+            status: params.status,
+            mapped: params.mapped,
+            limit: params.limit,
+            offset: params.offset,
+        });
+        return this.fetchJson(`/v1/system/intake-admin/brand-mappings${q}`);
+    }
+    /** GET /v1/system/intake-admin/brand-mappings/:id */
+    async getIntakeBrandMapping(id) {
+        return this.fetchJson(`/v1/system/intake-admin/brand-mappings/${encodeURIComponent(id)}`);
+    }
+    /** PATCH /v1/system/intake-admin/brand-mappings/:id — `rowVersion` 必填(409 = 版本过期,重新 get)。 */
+    async updateIntakeBrandMapping(id, body) {
+        return this.fetchJson(`/v1/system/intake-admin/brand-mappings/${encodeURIComponent(id)}`, { method: "PATCH", body: JSON.stringify(body) });
+    }
+    /** GET /v1/system/intake-admin/order-team */
+    async getIntakeOrderTeam() {
+        return this.fetchJson(`/v1/system/intake-admin/order-team`);
+    }
+    /** PUT /v1/system/intake-admin/order-team — 设置接单团队(团队须存在;最后写入者覆盖,留审计)。 */
+    async setIntakeOrderTeam(teamId) {
+        return this.fetchJson(`/v1/system/intake-admin/order-team`, {
+            method: "PUT",
+            body: JSON.stringify({ teamId }),
+        });
+    }
+    // ── 派单运营面(B5-ext E3)──────────────────────────────────────────────
+    // 系统级(不拼 /teams)。准入:admin,或全局 manager 且是接单团队的真实 active 成员;
+    // API key / 服务凭据 / 受限 CLI token 全 403。订单标识 hubRef;写入口 rowVersion 乐观锁(409 = 过期,重新 get)。
+    // schedule / re-review / start 受执行开关 INTAKE_OPS_EXECUTION_ENABLED 闸(默认关 → 503)。
+    /** GET /v1/system/intake-ops/orders — 列表(status / kind / deliveryChannel / brandId / 分页)。 */
+    async listIntakeOpsOrders(params = {}) {
+        const q = buildQuery({
+            status: params.status,
+            kind: params.kind,
+            deliveryChannel: params.deliveryChannel,
+            brandId: params.brandId,
+            limit: params.limit,
+            offset: params.offset,
+        });
+        return this.fetchJson(`/v1/system/intake-ops/orders${q}`);
+    }
+    /** GET /v1/system/intake-ops/orders/:hubRef — 详情(含 rowVersion / checks / allowedActions)。 */
+    async getIntakeOpsOrder(hubRef) {
+        return this.fetchJson(`/v1/system/intake-ops/orders/${encodeURIComponent(hubRef)}`);
+    }
+    /** POST …/orders/:hubRef/thread-context — 人工粘贴线程语境(递增订单 rowVersion)。 */
+    async provideIntakeThreadContext(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "thread-context", "POST", body);
+    }
+    /** POST …/orders/:hubRef/accept */
+    async acceptIntakeOrder(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "accept", "POST", body);
+    }
+    /** POST …/orders/:hubRef/reject */
+    async rejectIntakeOrder(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "reject", "POST", body);
+    }
+    /** PUT …/orders/:hubRef/draft — 改稿(新内容版本,旧审核失效,须重审)。 */
+    async editIntakeOrderDraft(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "draft", "PUT", body);
+    }
+    /** POST …/orders/:hubRef/schedule — 排期并建审核目标(受执行开关闸)。 */
+    async scheduleIntakeOrder(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "schedule", "POST", body);
+    }
+    /** POST …/orders/:hubRef/re-review — 重新审核(受执行开关闸)。 */
+    async reReviewIntakeOrder(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "re-review", "POST", body);
+    }
+    /** POST …/orders/:hubRef/start — 标记开始执行(可选步骤;受执行开关闸)。 */
+    async startIntakeOrder(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "start", "POST", body);
+    }
+    /** POST …/orders/:hubRef/confirm-published — 回填已发布(需当前审核 passed + 内容身份一致)。 */
+    async confirmIntakeOrderPublished(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "confirm-published", "POST", body);
+    }
+    /** POST …/orders/:hubRef/fail — 置失败(须声明帖子不在 Reddit 上)。 */
+    async failIntakeOrder(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "fail", "POST", body);
+    }
+    /** POST …/orders/:hubRef/anomalies — 异常事实登记(不改订单状态、不产生 published 事件);rowVersion 可选。 */
+    async registerIntakeOrderAnomaly(hubRef, body) {
+        return this.intakeOpsWrite(hubRef, "anomalies", "POST", body);
+    }
+    intakeOpsWrite(hubRef, action, method, body) {
+        return this.fetchJson(`/v1/system/intake-ops/orders/${encodeURIComponent(hubRef)}/${action}`, { method, body: JSON.stringify(body) });
+    }
     // ── 板块限制(板块限制阶段 A4)──────────────────────────────────────────
     // 系统级管理面仅**不受限登录的 admin**(API key / 绑定 job·account / 带动作白名单的
     // CLI token 读写全 403);runner 自查用 team 级 checkSubredditRestriction。