@geoly-ai/social-hub-sdk 0.1.6 → 0.1.8

package/dist/index.d.ts

@@ -1085,6 +1085,29 @@ export type SubredditCandidatesExhaustion = {
     /** 各闸 raw 命中数,**允许重叠**,仅供排障 —— 不要用它选 reason。 */
     filtered: Record<string, number>;
 };
+export type SubredditPostAnnotationType = "style_fit" | "brand_friendliness";
+export type SubredditPostAnnotationSource = "llm" | "human";
+/** `subreddit-style-profiles` 的行视图;写操作要回传 `rowVersion` 作 If-Match。 */
+export type SubredditStyleProfileView = {
+    id: string;
+    status: "proposed" | "approved" | "retired";
+    summary: string | null;
+    proposedByUserId: string | null;
+    /** If-Match 的值。状态每次合法迁移必变。 */
+    rowVersion: string;
+    [key: string]: unknown;
+};
+export type SubredditStyleProfileTransitionInput = {
+    id: string;
+    /** 来自 `getSubredditStyleProfile(id).profile.rowVersion`;**必传**,见方法说明。 */
+    rowVersion: string;
+};
+/**
+ * If-Match token 归一,**fail-closed**:只接受单个 strong token(可带成对引号)。
+ * 拒 `W/` 弱 ETag、`*` 通配、多值(含逗号)、引号不成对 —— 非法形状本地即拒,
+ * 不留给服务端猜。与 CLI 的 `normalizeRowVersionToken` 同一口径。
+ */
+export declare function normalizeStyleProfileRowVersion(raw: string | undefined): string | undefined;
 export declare class RegistryProposalSdkError extends Error {
     readonly status: number;
     readonly code?: string;
@@ -2839,6 +2862,77 @@ export declare class SocialHubClient {
         fallback?: unknown;
         exhaustion?: SubredditCandidatesExhaustion;
     }>;
+    listSubredditPostAnnotations(teamId: string, params?: {
+        subreddit?: string;
+        permalink?: string;
+        annotationType?: SubredditPostAnnotationType;
+        brandId?: string;
+        source?: SubredditPostAnnotationSource;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: unknown[];
+        total?: number;
+    }>;
+    upsertSubredditPostAnnotation(teamId: string, body: Record<string, unknown>): Promise<unknown>;
+    listSubredditStyleProfiles(params?: {
+        subreddit?: string;
+        scope?: string;
+        brandId?: string;
+        /** 逗号分隔多值,如 `proposed,approved`。 */
+        status?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        items: unknown[];
+        total?: number;
+    }>;
+    /** 响应里的 `profile.rowVersion` 就是写操作要回传的 If-Match 值。 */
+    getSubredditStyleProfile(id: string): Promise<{
+        profile: SubredditStyleProfileView;
+    }>;
+    getActiveSubredditStyleProfile(params: {
+        subreddit: string;
+        scope?: string;
+        brandId?: string;
+    }): Promise<unknown>;
+    proposeSubredditStyleProfile(body: Record<string, unknown>): Promise<{
+        profile: SubredditStyleProfileView;
+    }>;
+    /** 四眼审批 `proposed → approved`。提案人本人不可批(服务端 409 SELF_APPROVE)。 */
+    approveSubredditStyleProfile(input: SubredditStyleProfileTransitionInput): Promise<{
+        profile: SubredditStyleProfileView;
+    }>;
+    /** 审批人驳回 `proposed → retired`(`retire_reason=rejected:<reason>`)。 */
+    rejectSubredditStyleProfile(input: SubredditStyleProfileTransitionInput & {
+        reason: string;
+    }): Promise<{
+        profile: SubredditStyleProfileView;
+    }>;
+    /** 提案人本人撤回。worker/LLM 提案(proposedByUserId=NULL)不可 cancel,请用 reject。 */
+    cancelSubredditStyleProfile(input: SubredditStyleProfileTransitionInput & {
+        reason: string;
+    }): Promise<{
+        profile: SubredditStyleProfileView;
+    }>;
+    /** 停用已生效画像 `approved → retired`。 */
+    retireSubredditStyleProfile(input: SubredditStyleProfileTransitionInput & {
+        reason: string;
+    }): Promise<{
+        profile: SubredditStyleProfileView;
+    }>;
+    /**
+     * 四个 transition 的共同形状。
+     *
+     * 🔴 **`rowVersion` 是必传的,SDK 刻意不提供「缺省自动 GET 当前值」那种便利。**
+     * CLI 有这个便利(交互式使用,人就在现场),但库里自动 GET 会让一个**本意保护
+     * 特定版本**的写悄悄作用到最新版本 —— 乐观锁就此被架空,而且失败时毫无痕迹。
+     * 调用方要先 `getSubredditStyleProfile` 拿 `profile.rowVersion` 再传进来。
+     *
+     * 🔴 **409 PROFILE_STALE 一律原样抛出,绝不自动重取重试。** 自动重试等于替用户
+     * 认可了他没看过的那一版内容。
+     */
+    private styleProfileTransition;
     listSettings(): Promise<{
         items: Array<{
             key: string;
@@ -3709,6 +3803,55 @@ export declare class SocialHubClient {
         updatedVersions: number;
         autoDerivationEnabled: boolean;
     }>;
+    /** GET .../accounts/:accountId/reddit-verification — current + 最近 N 条 observation。 */
+    getRedditAccountVerification(teamId: string, accountId: string, params?: {
+        limit?: number;
+    }): Promise<unknown>;
+    /** GET .../reddit-verification/accounts — 列表 + coverage 计数。 */
+    listRedditAccountVerificationAccounts(teamId: string, params?: {
+        needsAttention?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<unknown>;
+    /**
+     * POST .../accounts/:accountId/reddit-verification/observations — 幂等键
+     * `requestId`；响应固定三态（201 recorded=true / 200 duplicate_delivery /
+     * 409 两种专用冲突码，见 `SocialHubHttpError.code`）。
+     */
+    recordRedditAccountVerificationObservation(teamId: string, accountId: string, body: {
+        observedState: "verification_required" | "app_labeled" | "verified";
+        observedAt: string;
+        requestId: string;
+        sourceEventType: string;
+        deadlineRaw?: string | null;
+        deadlineAt?: string | null;
+        evidence: Array<{
+            kind: "dom_snapshot" | "screenshot" | "agent_narrative";
+            ref?: string | null;
+            host?: string | null;
+            capturedAt?: string | null;
+            expiresAt?: string | null;
+        }>;
+    }): Promise<{
+        observationId: string;
+        recorded: boolean;
+        advanced: boolean;
+        state: "unknown" | "verification_required" | "app_labeled" | "verified";
+        reason: "advanced" | "duplicate_delivery" | "out_of_order" | "same_instant_same_state";
+    }>;
+    /**
+     * PATCH .../reddit-verification/evidence/:evidenceId — 只改 availability；
+     * `checkedAt` 必填，较旧的检查覆盖较新的结果会被拒（409）。
+     */
+    patchRedditAccountVerificationEvidence(teamId: string, evidenceId: string, body: {
+        availability: "available" | "expired" | "missing" | "revoked";
+        checkedAt: string;
+    }): Promise<{
+        ok: boolean;
+        evidenceId: string;
+        availability: string;
+        availabilityCheckedAt: string;
+    }>;
 }
 export type NotificationSubscriptionStatus = "active" | "paused"
 /** 游标落后于保留 floor,已无法保证不漏；需人工确认后 reset。 */