@geoly-ai/social-hub-sdk 0.0.43 → 0.0.45

package/dist/index.d.ts

@@ -193,6 +193,193 @@ export type UpdateContentDraftBody = {
     /** Optimistic concurrency: last-loaded version; a mismatch is rejected 409. */
     expectedVersion?: number;
 };
+/** 审核目标状态(mirrors contracts REVIEW_TARGET_STATUSES;SDK 不 hard-dep contracts)。 */
+export type ReviewTargetStatusLike = "pending" | "running" | "passed" | "needs_revision" | "blocked" | "degraded" | "superseded";
+export type ListReviewTargetsParams = {
+    limit?: number;
+    offset?: number;
+    /** 逗号拼后传服务端;空数组=不过滤。 */
+    status?: ReviewTargetStatusLike[];
+    contentType?: "post" | "comment";
+};
+/** 建审核目标 body(mirrors contracts createReviewTargetBodySchema;宽松结构由服务端 zod 校验)。 */
+export type CreateReviewTargetBody = {
+    sourceKind: "content_draft" | "comment_draft" | "calendar_entry" | "scheduled_job" | "post_performance" | "external_delegated";
+    contentType: "post" | "comment";
+    deliveryMode: "internal_publish" | "external_delegated";
+    reviewLevel: "draft" | "target";
+    contentDraftId?: string;
+    commentDraftId?: string;
+    calendarEntryId?: string;
+    scheduledJobId?: string;
+    postSnapshotId?: string;
+    externalRef?: string;
+    socialAccountId?: string;
+    subreddit?: string;
+    brandId?: string;
+    contentVersion: number;
+    contentHash: string;
+    dedupeKey: string;
+    subject: {
+        title?: string;
+        body: string;
+        threadContext?: Record<string, unknown>;
+        subreddit?: string;
+    };
+};
+export type CommentDraftStatusLike = "draft" | "scheduled" | "approved" | "archived" | "published";
+/**
+ * 评论审核语境快照(mirrors contracts commentDraftThreadContextSchema;严格对象——
+ * 服务端 `.strict()` 拒未知键)。subredditRules 由服务端注入,勿从客户端提交。
+ */
+export type CommentDraftThreadContext = {
+    postTitle?: string;
+    postBody?: string;
+    /** 父评论正文快照(回复场景)。 */
+    parentComment?: string;
+    /** 线程头部评论样本(有序)。 */
+    topComments?: string[];
+    subredditToneHint?: string;
+    commentType?: "reply" | "top_level";
+};
+export type ListCommentDraftsParams = {
+    limit?: number;
+    offset?: number;
+    /** 逗号拼后传服务端;空数组=不过滤。 */
+    brandId?: string[];
+    campaignId?: string;
+    status?: CommentDraftStatusLike[];
+    subreddit?: string;
+    search?: string;
+    /** 聚合可见团队(跨 team 列表);默认单团队。 */
+    aggregateVisibleTeams?: boolean;
+    /** 把聚合收窄到指定可见团队(逗号拼);空数组=不收窄。 */
+    scopeTeamIds?: string[];
+};
+export type CreateCommentDraftBody = {
+    brandId: string;
+    campaignId?: string;
+    body: string;
+    subreddit: string;
+    threadPermalink?: string;
+    parentCommentId?: string;
+    threadContext?: CommentDraftThreadContext;
+};
+export type UpdateCommentDraftBody = {
+    body?: string;
+    subreddit?: string;
+    /** null = 清除(回到未选帖)。 */
+    threadPermalink?: string | null;
+    parentCommentId?: string | null;
+    threadContext?: CommentDraftThreadContext | null;
+    /** 仅人工态;scheduled/published 由系统驱动,不可客户端直设。 */
+    status?: "draft" | "approved" | "archived";
+    /** Optimistic concurrency: last-loaded content version; mismatch → 409. */
+    expectedVersion?: number;
+};
+export type ScheduleCommentDraftBody = {
+    socialAccountId: string;
+    /** ISO datetime。 */
+    runAt: string;
+    windowMinutes?: number;
+};
+export type DeliveryBundleStatusLike = "open" | "closed" | "cancelled";
+/** 客户面列 bundle:brandId 服务端**必填**(客户按 brand 收窄);SDK 类型强制。 */
+export type ListClientDeliveryBundlesParams = {
+    brandId: string;
+    status?: DeliveryBundleStatusLike;
+    limit?: number;
+    offset?: number;
+};
+/** staff 建 bundle。 */
+export type CreateClientDeliveryBundleBody = {
+    brandId: string;
+    bundleCode: string;
+    name: string;
+    clientDueAt?: string | null;
+};
+/** staff upsert item(帖/评 + 矩阵规划字段)。 */
+export type UpsertClientDeliveryItemBody = {
+    kind: "post" | "comment";
+    itemCode: string;
+    contentDraftId?: string | null;
+    commentDraftId?: string | null;
+    ordinal?: number;
+    boundProductId?: string | null;
+    primaryPostType?: string[] | null;
+    writingVariant?: string | null;
+    structureFamily?: string | null;
+    contentFunction?: string | null;
+    functionDetail?: string | null;
+    brandEntryMode?: string | null;
+    anchorSlot?: string | null;
+    mappingRuleId?: string | null;
+    vocabularyVersion?: string | null;
+};
+/** staff 送审 revision(note 可选)。 */
+export type SubmitClientDeliveryRevisionBody = {
+    note?: string;
+};
+export type ClientDeliveryInventoryStatus = "in_stock" | "low_stock" | "out_of_stock" | "preorder" | "discontinued" | "unknown";
+/** 产品事实版本 body(客户面:正文/draft 字段物理不接受;仅事实)。 */
+export type ClientDeliveryFactVersionBody = {
+    positioning?: string | null;
+    materials?: string | null;
+    priceAmount?: string | null;
+    priceCurrency?: string | null;
+    inventoryStatus?: ClientDeliveryInventoryStatus | null;
+    inventoryAsOf?: string | null;
+    shippingDaysMin?: number | null;
+    shippingDaysMax?: number | null;
+    factsJson?: Record<string, string | number | boolean | null>;
+    effectiveAt?: string | null;
+    expiresAt?: string | null;
+    sourceRef?: string | null;
+};
+/** staff 事实版本 body:额外可指定 provenance(默认 staff)。 */
+export type StaffClientDeliveryFactVersionBody = ClientDeliveryFactVersionBody & {
+    provenance?: "client" | "staff" | "import";
+};
+/** staff 建产品身份。 */
+export type CreateClientDeliveryProductBody = {
+    brandId: string;
+    sku: string;
+    brandRegistryId?: string | null;
+    modelName?: string | null;
+    market?: string | null;
+    status?: string;
+};
+/** staff 建品牌内容政策版本。 */
+export type CreateClientDeliveryPolicyVersionBody = {
+    brandId: string;
+    market?: string | null;
+    provenance?: "client" | "staff" | "import";
+    policyJson?: Record<string, unknown>;
+    effectiveAt?: string | null;
+};
+/** 字段级评论(request-changes 内嵌 / 独立讨论)。 */
+export type ClientDeliveryDecisionComment = {
+    fieldKey: string;
+    quotedText?: string;
+    body: string;
+};
+/** 客户批准(CAS:expectedRevisionHash)。 */
+export type ApproveClientDeliveryRevisionBody = {
+    expectedRevisionHash: string;
+    note?: string;
+};
+/** 客户请求修改(CAS + 字段级评论,至少一条)。 */
+export type RequestChangesClientDeliveryRevisionBody = {
+    expectedRevisionHash: string;
+    comments: ClientDeliveryDecisionComment[];
+    note?: string;
+};
+/** 客户字段级讨论评论。 */
+export type AddClientDeliveryCommentBody = {
+    fieldKey: string;
+    quotedText?: string;
+    body: string;
+};
 export type UpdateNotificationChannelBody = {
     provider?: string;
     externalId?: string;
@@ -212,6 +399,24 @@ export type ListHotPostsParams = {
     subreddit?: string;
     sortBy?: "score" | "comments" | "capturedAt" | "upvoteRatio";
 };
+/**
+ * hot_post 列表每行 enrich 的 content_classification「current proposed」四轴(see contracts
+ * HotPostContentClassificationView）。`null` = 无当前 revision 的成功 run(missing/stale/无 active spec)。
+ */
+export type HotPostClassification = {
+    contentForms: string[];
+    intent: string;
+    sentiment: string;
+    format: string;
+};
+/**
+ * listHotPosts 返回的单行(除既有 hot_post 字段外,带 classification enrich;宽松索引签名保留兼容)。
+ * classification 为可选:新 SDK 连未升级的旧服务端时该字段可能缺失(滚动升级安全)。
+ */
+export type HotPostListItem = Record<string, unknown> & {
+    id: string;
+    classification?: HotPostClassification | null;
+};
 export type ListKolIntentsParams = {
     limit?: number;
     offset?: number;
@@ -486,6 +691,157 @@ export declare class SocialHubClient {
     }): Promise<{
         id: string;
     }>;
+    /**
+     * GET /content-review-targets — team-scoped 审核目标列表(status/contentType 过滤 +
+     * limit/offset 分页)。status 传数组时按逗号拼(与 commaSeparatedQueryList 契约一致)。
+     */
+    listReviewTargets(teamId: string, params?: ListReviewTargetsParams | number): Promise<{
+        items: unknown[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    /** GET /content-review-targets/:id — 审核目标详情(target + 待审正文 + 若有的 review 摘要)。 */
+    getReviewTarget(teamId: string, id: string): Promise<unknown>;
+    /**
+     * POST /content-review-targets — 建 pending 审核目标 + 存待审正文快照(幂等:dedupeKey
+     * 命中且 payload 未漂移返既有 target,HTTP 200;新建 201)。body 为完整 createReviewTargetBody。
+     */
+    createReviewTarget(teamId: string, body: CreateReviewTargetBody): Promise<{
+        target: unknown;
+    }>;
+    /** GET /comment-drafts — team-scoped 评论草稿列表(brand/campaign/status/subreddit/search 过滤 + 分页)。 */
+    listCommentDrafts(teamId: string, params?: ListCommentDraftsParams | number): Promise<{
+        items: unknown[];
+        total: number;
+        limit: number;
+        offset: number;
+    }>;
+    /** GET /comment-drafts/:draftId — 单条评论草稿。 */
+    getCommentDraft(teamId: string, draftId: string): Promise<unknown>;
+    /** POST /comment-drafts — 建评论草稿(返回 { id })。 */
+    createCommentDraft(teamId: string, body: CreateCommentDraftBody): Promise<{
+        id: string;
+    }>;
+    /**
+     * PATCH /comment-drafts/:draftId — 编辑评论草稿。expectedVersion 开乐观并发(版本不匹配 409);
+     * status 仅接受人工态(draft/approved/archived),scheduled/published 由排期/complete 系统驱动。
+     */
+    updateCommentDraft(teamId: string, draftId: string, body: UpdateCommentDraftBody): Promise<{
+        ok: boolean;
+        version: number;
+        updatedAt: string;
+    }>;
+    /** DELETE /comment-drafts/:draftId — 删评论草稿(204)。 */
+    deleteCommentDraft(teamId: string, draftId: string): Promise<void>;
+    /**
+     * POST /comment-drafts/:draftId/schedule — 评论草稿排期(唯一 publish_comment 建 job 入口)。
+     * 一事务:锁 draft + 一稿一投 + 建 job + 建 pending review target + draft→scheduled;过 publish
+     * guardrail。入队失败返 warning(job 仍 scheduled,可被 ops 领)。
+     */
+    scheduleCommentDraft(teamId: string, draftId: string, body: ScheduleCommentDraftBody): Promise<{
+        scheduledJobId: string;
+        /** 同事务建的 pending 审核目标(审核门追踪入口)。 */
+        reviewTargetId: string;
+        reviewTargetStatus: string;
+        /** BullMQ 入队失败时的告警(job 仍 scheduled,可被 ops 领)。 */
+        warning?: string;
+    }>;
+    private clientDeliveryBase;
+    /** GET client-delivery/bundles?brandId=(必填)&status=&limit=&offset= — 客户面 bundle 列表。 */
+    clientDeliveryListBundles(teamId: string, params: ListClientDeliveryBundlesParams): Promise<{
+        items: unknown[];
+    }>;
+    /** GET client-delivery/bundles/:id — 单个 bundle(client 视图脱敏 / staff 完整)。 */
+    clientDeliveryGetBundle(teamId: string, bundleId: string): Promise<unknown>;
+    /** GET client-delivery/bundles/:id/items — bundle 下条目列表。 */
+    clientDeliveryListItems(teamId: string, bundleId: string): Promise<{
+        items: unknown[];
+    }>;
+    /** GET client-delivery/items/:id — 单个条目。 */
+    clientDeliveryGetItem(teamId: string, itemId: string): Promise<unknown>;
+    /** GET client-delivery/items/:id/revisions — 条目下 revision 列表。 */
+    clientDeliveryListRevisions(teamId: string, itemId: string): Promise<{
+        items: unknown[];
+    }>;
+    /** GET client-delivery/revisions/:id — 单个 revision(含 sourceContentHash 作 CAS 凭证)。 */
+    clientDeliveryGetRevision(teamId: string, revisionId: string): Promise<unknown>;
+    /** GET client-delivery/revisions/:id/comments — revision 字段级评论列表。 */
+    clientDeliveryListComments(teamId: string, revisionId: string): Promise<{
+        items: unknown[];
+    }>;
+    /** GET client-delivery/revisions/:id/events — revision 决策事件链(append-only)。 */
+    clientDeliveryListEvents(teamId: string, revisionId: string): Promise<{
+        items: unknown[];
+    }>;
+    /**
+     * POST client-delivery/revisions/:id/approve — 客户批准(CAS)。expectedRevisionHash 与服务端
+     * 当前 revision hash 不符 → 409(SDK 透传为 `HTTP 409:` Error);须 user 凭证(拒 api_key)。
+     */
+    clientDeliveryApproveRevision(teamId: string, revisionId: string, body: ApproveClientDeliveryRevisionBody): Promise<{
+        revision: unknown;
+    }>;
+    /**
+     * POST client-delivery/revisions/:id/request-changes — 客户请求修改 + 字段级评论(CAS)。
+     * hash 不符 → 409;须 user 凭证。
+     */
+    clientDeliveryRequestChanges(teamId: string, revisionId: string, body: RequestChangesClientDeliveryRevisionBody): Promise<{
+        revision: unknown;
+    }>;
+    /** POST client-delivery/revisions/:id/comments — 客户字段级讨论(非决策);须 user 凭证。 */
+    clientDeliveryAddComment(teamId: string, revisionId: string, body: AddClientDeliveryCommentBody): Promise<{
+        comment: unknown;
+    }>;
+    /** POST client-delivery/comments/:id/resolve — 客户关闭讨论(幂等);须 user 凭证。 */
+    clientDeliveryResolveComment(teamId: string, commentId: string): Promise<{
+        comment: unknown;
+    }>;
+    /**
+     * POST client-delivery/products/:productId/fact-versions（**客户面**）— 客户提交产品事实版本。
+     * provenance 服务端强制 'client';正文/draft 字段物理不接受。须 user 凭证。
+     */
+    clientDeliveryCreateClientFactVersion(teamId: string, productId: string, body: ClientDeliveryFactVersionBody): Promise<{
+        factVersion: unknown;
+    }>;
+    /** POST client-delivery/bundles — staff 建 bundle。 */
+    clientDeliveryCreateBundle(teamId: string, body: CreateClientDeliveryBundleBody): Promise<{
+        bundle: unknown;
+    }>;
+    /** POST client-delivery/bundles/:id/items — staff upsert 条目(帖/评 + 矩阵字段)。 */
+    clientDeliveryUpsertItem(teamId: string, bundleId: string, body: UpsertClientDeliveryItemBody): Promise<{
+        item: unknown;
+    }>;
+    /** POST client-delivery/items/:id/revisions — staff 建不可变送审快照(无 body)。 */
+    clientDeliveryCreateRevision(teamId: string, itemId: string): Promise<{
+        revision: unknown;
+    }>;
+    /** POST client-delivery/revisions/:id/submit — staff 送审(not_submitted|withdrawn → pending)。 */
+    clientDeliverySubmitRevision(teamId: string, revisionId: string, body?: SubmitClientDeliveryRevisionBody): Promise<{
+        revision: unknown;
+    }>;
+    /** POST client-delivery/products — staff 建产品身份。 */
+    clientDeliveryCreateProduct(teamId: string, body: CreateClientDeliveryProductBody): Promise<{
+        product: unknown;
+    }>;
+    /**
+     * POST client-delivery/products/:productId/fact-versions（**staff 面**）— staff 提交事实版本。
+     * provenance 由 body 决定(默认 staff)。须 user 凭证。
+     */
+    clientDeliveryCreateFactVersion(teamId: string, productId: string, body: StaffClientDeliveryFactVersionBody): Promise<{
+        factVersion: unknown;
+    }>;
+    /** POST client-delivery/products/:productId/fact-versions/:fvId/activate — staff 激活 + stale 传播。 */
+    clientDeliveryActivateFactVersion(teamId: string, productId: string, factVersionId: string): Promise<{
+        factVersion: unknown;
+    }>;
+    /** POST client-delivery/policy-versions — staff 建品牌内容政策版本。 */
+    clientDeliveryCreatePolicyVersion(teamId: string, body: CreateClientDeliveryPolicyVersionBody): Promise<{
+        policyVersion: unknown;
+    }>;
+    /** POST client-delivery/policy-versions/:id/activate — staff 激活政策版本。 */
+    clientDeliveryActivatePolicyVersion(teamId: string, policyVersionId: string): Promise<{
+        policyVersion: unknown;
+    }>;
     listReports(teamId: string, options?: ListReportsParams | number): Promise<{
         items: unknown[];
     }>;
@@ -1127,7 +1483,7 @@ export declare class SocialHubClient {
     }>;
     deleteSubredditWatchlist(watchlistId: string): Promise<void>;
     listHotPosts(params?: ListHotPostsParams): Promise<{
-        items: unknown[];
+        items: HotPostListItem[];
         total: number;
         limit: number;
         offset: number;