@productcraft/social 0.3.0 → 0.4.0

package/dist/index.d.ts

@@ -321,7 +321,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List the actor's currently-active muted terms. */
+        /** List the actor's currently-active muted terms, newest-first. Cursor-paginated (task 008 / G13 — previously an unbounded bare array). */
         get: operations["MutedTermController_list"];
         put?: never;
         /** Add (or refresh) a muted term for the actor. Re-posting the same `term` updates the scope + expires_at. */
@@ -723,7 +723,7 @@ interface paths {
         get: operations["ConversationController_getById"];
         put?: never;
         post?: never;
-        /** Leave the conversation. Drops the caller's participant row; the conversation is hard-deleted when the last participant leaves. */
+        /** Leave the conversation. Drops the caller's participant row; the conversation is hard-deleted when the last participant leaves. Pass the actor via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ConversationController_leave"];
         options?: never;
         head?: never;
@@ -794,7 +794,7 @@ interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /** Soft-delete a message. Reserved to the sender; the row stays so the conversation timeline doesn't orphan replies. Reads return body `"(deleted)"`. */
+        /** Soft-delete a message. Reserved to the sender; the row stays so the conversation timeline doesn't orphan replies. Reads return body `"(deleted)"`. Pass the sender via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ConversationController_deleteMessage"];
         options?: never;
         head?: never;
@@ -1053,7 +1053,7 @@ interface paths {
         get: operations["ActorListController_getById"];
         put?: never;
         post?: never;
-        /** Delete a list. Owner-only. */
+        /** Delete a list. Owner-only. Pass the caller via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ActorListController_delete"];
         options?: never;
         head?: never;
@@ -1106,7 +1106,7 @@ interface paths {
         get?: never;
         put?: never;
         post?: never;
-        /** Remove a member from a list. Owner-only. Idempotent — 204 either way. */
+        /** Remove a member from a list. Owner-only. Idempotent — 204 either way. Pass the caller via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["ActorListController_removeMember"];
         options?: never;
         head?: never;
@@ -1165,6 +1165,23 @@ interface paths {
         patch?: never;
         trace?: never;
     };
+    "/v1/communities/{communityId}/posts/impressions": {
+        parameters: {
+            query?: never;
+            header?: never;
+            path?: never;
+            cookie?: never;
+        };
+        get?: never;
+        put?: never;
+        /** Batch-increment impression (`view_count`) counters on a list of posts. Client-side debounced; missing post ids are silently skipped (so a deleted post mid-batch doesn’t fail the rest). Renamed from `POST /posts/views` (task 008 / G14) to disambiguate from the story-side per-post `/posts/:postId/views` route. */
+        post: operations["PostController_recordImpressions"];
+        delete?: never;
+        options?: never;
+        head?: never;
+        patch?: never;
+        trace?: never;
+    };
     "/v1/communities/{communityId}/posts/views": {
         parameters: {
             query?: never;
@@ -1174,8 +1191,11 @@ interface paths {
         };
         get?: never;
         put?: never;
-        /** Batch-increment view counts on a list of posts. Client-side debounced; missing post ids are silently skipped (so a deleted post mid-batch doesn’t fail the rest). */
-        post: operations["PostController_recordViews"];
+        /**
+         * DEPRECATED — use `POST /posts/impressions`. Batch-increment impression counters. This alias will be removed in a future version.
+         * @deprecated
+         */
+        post: operations["PostController_recordViewsDeprecated"];
         delete?: never;
         options?: never;
         head?: never;
@@ -1218,7 +1238,7 @@ interface paths {
          * @description Visibility-aware: the actor must be allowed to read the post. If they can't, returns 404 (opaque), matching the read-path opacity rule used everywhere else in Social.
          */
         post: operations["BookmarkController_create"];
-        /** Remove a bookmark on behalf of an actor. Idempotent — 204 either way. */
+        /** Remove a bookmark on behalf of an actor. Idempotent — 204 either way. Pass the actor via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["BookmarkController_delete"];
         options?: never;
         head?: never;
@@ -1403,7 +1423,7 @@ interface paths {
          * @description Visibility is inherited from the source. The reposter must be allowed to read the source (else 404). Self-repost 422; private-source repost 422. Bumps `source.repost_count` and the reposter's `post_count`. Fires a `repost` notification to the source author (subject to per-kind preferences from task 021).
          */
         post: operations["RepostController_create"];
-        /** Undo my repost of a source post. Idempotent — 204 either way. */
+        /** Undo my repost of a source post. Idempotent — 204 either way. Pass the actor via `?actor_id=` (task 008 / G12 — the request body is deprecated). */
         delete: operations["RepostController_delete"];
         options?: never;
         head?: never;
@@ -1730,7 +1750,7 @@ interface paths {
             path?: never;
             cookie?: never;
         };
-        /** List communities in a workspace */
+        /** List communities in a workspace, newest-first. Cursor-paginated as of task 008 / G13 (previously a bare array). */
         get: operations["CommunityController_list"];
         put?: never;
         /** Create an social community. `app_id` is optional — when supplied Social connects the community to an Auth app and refuses if the app belongs to a different workspace (cross-tenant gate) or is already connected. Omit `app_id` for a standalone community (no Auth integration; the customer manages actor identity). Pass an `Idempotency-Key` header to make retries safe. */
@@ -1949,6 +1969,11 @@ interface components {
             updated_at: string;
         };
         ActorEdgeDto: {
+            /**
+             * @description Acting social actor UUID (the one performing the follow / mute / block / restrict). Standardized name (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
             /**
              * @description Destination social actor UUID (the one being followed / muted / blocked / restricted).
              * @example aaaaaaaa-0000-0000-0000-000000000002
@@ -1957,10 +1982,11 @@ interface components {
             /** @description Optional free-form payload stored on the edge (e.g. mute reason). */
             payload?: Record<string, never>;
             /**
-             * @description Source social actor UUID (the one performing the follow / mute / block / restrict).
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11). Accepted for one more version.
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            src_actor_id?: string;
         };
         ActorListListResponseDto: {
             data: components["schemas"]["ActorListResponseDto"][];
@@ -2105,6 +2131,8 @@ interface components {
         ActorSearchResponseDto: {
             /** @description Up to `limit` (default 20, max 50) ranked hits. Not paginated in v1; results are bounded by `limit`. */
             data: components["schemas"]["ActorSearchHitDto"][];
+            /** @description Always `null` — this lane returns a single bounded, ranked page (no cursor in v1). Present for envelope consistency. */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         ActorsByExternalBatchResponseDto: {
             /** @description Actors found, in request order (after de-duplication). */
@@ -2524,6 +2552,10 @@ interface components {
              */
             total_posts: number;
         };
+        CommunityListResponseDto: {
+            data: components["schemas"]["CommunityResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
         CommunityRankingSettingsDto: {
             /**
              * @description Ranked-feed candidate window in days — posts older than this are not scored. Strictly positive finite number.
@@ -2832,10 +2864,16 @@ interface components {
         };
         CreateCommentReactionDto: {
             /**
-             * @description Reactor actor UUID.
+             * @description Reactor actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id?: string;
             /**
              * @description Reaction type (free-form short label, e.g. `like`, `fire`, `heart`).
              * @example like
@@ -2896,10 +2934,16 @@ interface components {
         };
         CreateDirectMessageReactionDto: {
             /**
-             * @description The reactor — social actor UUID.
+             * @description The reactor — social actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id?: string;
             /**
              * @description Reaction type (emoji or label, 1..64 chars).
              * @example heart
@@ -3031,10 +3075,16 @@ interface components {
         };
         CreateReactionDto: {
             /**
-             * @description Reactor — social actor UUID.
+             * @description Reactor — social actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            src_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            src_actor_id?: string;
             /**
              * @description Reaction type (1..64 chars).
              * @example like
@@ -3146,17 +3196,29 @@ interface components {
         };
         DeleteActorListDto: {
             /**
-             * @description Caller — social actor UUID. Must equal the list owner.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. Caller social actor UUID (must equal the list owner).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            caller_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            caller_actor_id?: string;
         };
         DeleteMessageDto: {
             /**
-             * @description The sender — must match the message's sender_id.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. The sender (must match the message's sender_id).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            sender_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            sender_id?: string;
         };
         DeliveryJobResponseDto: {
             /**
@@ -3265,6 +3327,14 @@ interface components {
             /** @description Webhook UUID. */
             webhook_id: string;
         };
+        DeprecatedActorIdBodyDto: {
+            /**
+             * @deprecated
+             * @description DEPRECATED — pass the actor via the `?actor_id=` query parameter instead. Accepted from the body for one more version.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
+        };
         DirectMessageAdminListResponseDto: {
             data: components["schemas"]["DirectMessageAdminResponseDto"][];
             pagination: components["schemas"]["PaginationResponseDto"];
@@ -3639,6 +3709,8 @@ interface components {
         };
         HashtagAutocompleteResponseDto: {
             data: components["schemas"]["HashtagResponseDto"][];
+            /** @description Always `null` — autocomplete returns a single bounded, ranked page (no cursor). Present for envelope consistency (task 008 / G13). */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         HashtagDetailResponseDto: {
             /**
@@ -3720,10 +3792,11 @@ interface components {
         };
         LeaveConversationDto: {
             /**
-             * @description The participant leaving.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. The participant leaving.
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            actor_id: string;
+            actor_id?: string;
         };
         MarkAllReadDto: {
             /**
@@ -3905,6 +3978,10 @@ interface components {
              */
             updated_at: string;
         };
+        MutedTermListResponseDto: {
+            data: components["schemas"]["MutedTermResponseDto"][];
+            pagination: components["schemas"]["PaginationResponseDto"];
+        };
         MutedTermResponseDto: {
             /**
              * @description Owning actor UUID.
@@ -4082,7 +4159,7 @@ interface components {
         };
         PaginationResponseDto: {
             /**
-             * @description `true` when at least one more page exists. Mirrors `next_cursor !== null`; published as a separate field so SDKs can drive a `while` loop without parsing the cursor.
+             * @description `true` when at least one more page exists. Mirrors `next_cursor !== null`; published as a separate field so SDKs can drive a `while` loop without parsing the cursor. A short or empty `data` array does NOT imply the end of the list when a lane post-filters — always page until this is `false`.
              * @example true
              */
             has_more: boolean;
@@ -4353,6 +4430,8 @@ interface components {
         PostSearchResponseDto: {
             /** @description Up to `limit` (default 20, max 50) hits. Not paginated in v1. */
             data: components["schemas"]["PostSearchHitDto"][];
+            /** @description Always `null` — this lane returns a single bounded, ranked page (no cursor in v1). Present for envelope consistency. */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         PostStateRequestDto: {
             /**
@@ -4467,10 +4546,16 @@ interface components {
         };
         RecordViewDto: {
             /**
-             * @description Viewer social actor UUID.
+             * @description Viewer social actor UUID. Standardized name (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000002
              */
-            viewer_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000002
+             */
+            viewer_actor_id?: string;
         };
         RecordViewsDto: {
             /**
@@ -4530,17 +4615,29 @@ interface components {
         };
         RemoveListMemberDto: {
             /**
-             * @description Caller — social actor UUID. Must equal the list owner.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. Caller social actor UUID (must equal the list owner).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            caller_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            caller_actor_id?: string;
         };
         RemoveMemberDto: {
             /**
-             * @description Social actor UUID of the acting party. Equal to the target for self-leave.
+             * @deprecated
+             * @description DEPRECATED — use `?actor_id=`. Acting actor UUID (equal to the target for self-leave).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            caller_actor_id: string;
+            actor_id?: string;
+            /**
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+             */
+            caller_actor_id?: string;
         };
         RenameGroupDto: {
             /**
@@ -4557,6 +4654,11 @@ interface components {
             pagination: components["schemas"]["PaginationResponseDto"];
         };
         SendMessageDto: {
+            /**
+             * @description The sender — social actor UUID. Standardized name (task 008 / G11); the persisted `sender_id` defaults from it.
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
             attachments?: components["schemas"]["DirectMessageAttachmentDto"][];
             /**
              * @description Message body. Required when `kind="text"`. 1..10000 chars after trim.
@@ -4571,10 +4673,11 @@ interface components {
             /** @description Threaded inline reply target. */
             reply_to_id?: string | null;
             /**
-             * @description The sender — social actor UUID.
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            sender_id: string;
+            sender_id?: string;
         };
         StoryTrayEntryResponse: {
             /**
@@ -4615,6 +4718,8 @@ interface components {
         };
         StoryTrayResponse: {
             data: components["schemas"]["StoryTrayEntryResponse"][];
+            /** @description Always `null` — the tray is a single bounded page (≤200 entries, no cursor in v1). The key is present for envelope consistency with cursor-paginated lists (task 008 / G13). */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         StoryViewerResponse: {
             /**
@@ -4664,6 +4769,8 @@ interface components {
         SuggestedFollowsListResponseDto: {
             /** @description Ordered candidates. FoF candidates are returned first (highest count first); cold-start fallbacks fill any remaining slots up to the requested limit. */
             data: components["schemas"]["SuggestedFollowResponseDto"][];
+            /** @description Always `null` — suggestions are a single bounded, scored page (no cursor in v1). Present for envelope consistency (task 008 / G13). */
+            pagination: components["schemas"]["PaginationResponseDto"] | null;
         };
         UnreadCountResponse: {
             /**
@@ -4747,16 +4854,22 @@ interface components {
             role: "member" | "admin";
         };
         UpdateMessageDto: {
+            /**
+             * @description The sender — must match the message's sender_id. Standardized name (task 008 / G11).
+             * @example aaaaaaaa-0000-0000-0000-000000000001
+             */
+            actor_id?: string;
             /**
              * @description Updated body.
              * @example edited
              */
             body: string;
             /**
-             * @description The sender — must match the message's sender_id.
+             * @deprecated
+             * @description DEPRECATED alias of `actor_id` (task 008 / G11).
              * @example aaaaaaaa-0000-0000-0000-000000000001
              */
-            sender_id: string;
+            sender_id?: string;
         };
         UpdateNotificationDto: {
             /**
@@ -5901,6 +6014,11 @@ interface operations {
                 /** @description Cursor from the prior page. */
                 cursor?: string;
                 /** @description Requester social actor UUID. Without it, only public pinned posts surface. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -5992,7 +6110,12 @@ interface operations {
     };
     MutedTermController_list: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 50, max 200). */
+                limit?: string;
+                /** @description Opaque cursor from a prior page's `pagination.next_cursor`. */
+                cursor?: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. */
@@ -6004,13 +6127,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Active muted terms. */
+            /** @description Active muted terms, paginated. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["MutedTermResponseDto"][];
+                    "application/json": components["schemas"]["MutedTermListResponseDto"];
                 };
             };
             /** @description PAK lacks `social.list`. */
@@ -7225,7 +7348,10 @@ interface operations {
     };
     ConversationController_leave: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description The leaving participant — social actor UUID. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -7248,6 +7374,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description PAK lacks `social.delete`. */
             403: {
                 headers: {
@@ -7391,7 +7526,10 @@ interface operations {
     };
     ConversationController_removeMember: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Acting actor UUID (equal to the target for self-leave). */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -7416,6 +7554,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not an admin and not the target. */
             403: {
                 headers: {
@@ -7623,7 +7770,10 @@ interface operations {
     };
     ConversationController_deleteMessage: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description The sender — must match the message's sender_id. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -7648,6 +7798,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not the sender, or PAK lacks `social.delete`. */
             403: {
                 headers: {
@@ -8076,6 +8235,12 @@ interface operations {
     FeedController_getDiscoverFeed: {
         parameters: {
             query?: {
+                /** @description Viewer actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
                 limit?: number;
                 /** @description Opaque ranked cursor; encodes (score, id). */
@@ -8514,7 +8679,12 @@ interface operations {
     ActorListController_list: {
         parameters: {
             query?: {
-                /** @description Surface the viewer's own private lists alongside the public catalog. */
+                /** @description Viewer actor UUID — surfaces the viewer's own private lists alongside the public catalog. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
                 /** @description Filter to lists owned by this actor. */
                 owner_actor_id?: string;
@@ -8619,7 +8789,12 @@ interface operations {
     ActorListController_getById: {
         parameters: {
             query?: {
-                /** @description Required to see a private list (must equal owner). */
+                /** @description Viewer actor UUID — required to see a private list (must equal owner). */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
             };
             header?: never;
@@ -8664,7 +8839,10 @@ interface operations {
     };
     ActorListController_delete: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Caller social actor UUID (must equal the list owner). */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. */
@@ -8687,6 +8865,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not the owner. */
             403: {
                 headers: {
@@ -8767,7 +8954,12 @@ interface operations {
         parameters: {
             query: {
                 /** @description Viewer — required for visibility checks + block-filter. */
-                viewer_actor_id: string;
+                actor_id: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
+                viewer_actor_id?: string;
                 limit?: number;
                 /** @description Opaque cursor; differs in shape between ranked and chronological. */
                 cursor?: string;
@@ -8793,7 +8985,7 @@ interface operations {
                     "application/json": components["schemas"]["FeedResponseDto"];
                 };
             };
-            /** @description INVALID_ORDER or INVALID_CURSOR. */
+            /** @description Missing/invalid actor_id, INVALID_ORDER, or INVALID_CURSOR. */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -8825,6 +9017,12 @@ interface operations {
     ActorListController_listMembers: {
         parameters: {
             query?: {
+                /** @description Viewer actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 viewer_actor_id?: string;
                 limit?: number;
                 cursor?: string;
@@ -8927,7 +9125,10 @@ interface operations {
     };
     ActorListController_removeMember: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Caller social actor UUID (must equal the list owner). */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. */
@@ -8952,6 +9153,15 @@ interface operations {
                 };
                 content?: never;
             };
+            /** @description Missing/invalid actor_id. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description Caller is not the owner. */
             403: {
                 headers: {
@@ -9207,7 +9417,49 @@ interface operations {
             };
         };
     };
-    PostController_recordViews: {
+    PostController_recordImpressions: {
+        parameters: {
+            query?: never;
+            header?: never;
+            path: {
+                communityId: string;
+            };
+            cookie?: never;
+        };
+        requestBody: {
+            content: {
+                "application/json": components["schemas"]["RecordViewsDto"];
+            };
+        };
+        responses: {
+            /** @description Impressions recorded (or no-op if every id was missing). */
+            204: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content?: never;
+            };
+            /** @description Empty `post_ids`, more than 200 ids, or a non-UUID in the list. */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+            /** @description PAK lacks `social.view` on the community URN. */
+            403: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
+        };
+    };
+    PostController_recordViewsDeprecated: {
         parameters: {
             query?: never;
             header?: never;
@@ -9222,7 +9474,7 @@ interface operations {
             };
         };
         responses: {
-            /** @description Views recorded (or no-op if every id was missing). */
+            /** @description Impressions recorded (or no-op if every id was missing). */
             204: {
                 headers: {
                     [name: string]: unknown;
@@ -9238,7 +9490,7 @@ interface operations {
                     "application/json": components["schemas"]["ErrorResponseDto"];
                 };
             };
-            /** @description PAK lacks `social.list` on the community URN. */
+            /** @description PAK lacks `social.view` on the community URN. */
             403: {
                 headers: {
                     [name: string]: unknown;
@@ -9253,6 +9505,11 @@ interface operations {
         parameters: {
             query?: {
                 /** @description Social actor UUID of the viewer. Surfaces non-public posts they are entitled to see. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11). Removed in a future version.
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -9456,7 +9713,10 @@ interface operations {
     };
     BookmarkController_delete: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Acting actor UUID. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -9466,9 +9726,9 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
+        requestBody?: {
             content: {
-                "application/json": components["schemas"]["CreateBookmarkDto"];
+                "application/json": components["schemas"]["DeprecatedActorIdBodyDto"];
             };
         };
         responses: {
@@ -9479,7 +9739,7 @@ interface operations {
                 };
                 content?: never;
             };
-            /** @description Validation failure. */
+            /** @description Validation failure (missing/invalid actor_id). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -9516,6 +9776,11 @@ interface operations {
                 /** @description List replies of this parent comment instead of top-level. */
                 parent_id?: string;
                 /** @description Viewer actor UUID — surfaces author_only replies they're entitled to see. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -9629,6 +9894,12 @@ interface operations {
     CommentController_getById: {
         parameters: {
             query?: {
+                /** @description Viewer actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -10356,7 +10627,10 @@ interface operations {
     };
     RepostController_delete: {
         parameters: {
-            query?: never;
+            query: {
+                /** @description Acting actor UUID. */
+                actor_id: string;
+            };
             header?: never;
             path: {
                 /** @description Social community UUID. Must belong to the PAK's workspace. */
@@ -10366,9 +10640,9 @@ interface operations {
             };
             cookie?: never;
         };
-        requestBody: {
+        requestBody?: {
             content: {
-                "application/json": components["schemas"]["CreateRepostDto"];
+                "application/json": components["schemas"]["DeprecatedActorIdBodyDto"];
             };
         };
         responses: {
@@ -10379,7 +10653,7 @@ interface operations {
                 };
                 content?: never;
             };
-            /** @description Validation failure. */
+            /** @description Validation failure (missing/invalid actor_id). */
             400: {
                 headers: {
                     [name: string]: unknown;
@@ -10503,7 +10777,12 @@ interface operations {
         parameters: {
             query: {
                 /** @description Requester social actor UUID — must resolve to the post author. */
-                requester_id: string;
+                actor_id: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
+                requester_id?: string;
                 limit?: number;
                 /** @description Cursor from the prior page. */
                 cursor?: string;
@@ -10528,6 +10807,15 @@ interface operations {
                     "application/json": components["schemas"]["StoryViewersResponse"];
                 };
             };
+            /** @description Missing/invalid actor_id (author-only endpoint). */
+            400: {
+                headers: {
+                    [name: string]: unknown;
+                };
+                content: {
+                    "application/json": components["schemas"]["ErrorResponseDto"];
+                };
+            };
             /** @description PAK lacks `social.list` OR requester is not the post author. */
             403: {
                 headers: {
@@ -10806,6 +11094,11 @@ interface operations {
                 /** @description Max hits to return. */
                 limit?: number;
                 /** @description Viewer social actor UUID — filters out blocked / muted actors. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -10915,6 +11208,12 @@ interface operations {
                 q: string;
                 limit?: number;
                 order?: "relevance" | "recent";
+                /** @description Viewer social actor UUID. */
+                actor_id?: string;
+                /**
+                 * @deprecated
+                 * @description DEPRECATED alias of `actor_id` (task 008 / G11).
+                 */
                 requester_id?: string;
             };
             header?: never;
@@ -11377,7 +11676,12 @@ interface operations {
     };
     CommunityController_list: {
         parameters: {
-            query?: never;
+            query?: {
+                /** @description Page size (default 50, max 200). */
+                limit?: string;
+                /** @description Opaque cursor from a prior page's `pagination.next_cursor`. */
+                cursor?: string;
+            };
             header?: never;
             path: {
                 /** @description ProductCraft workspace UUID owning the community. */
@@ -11387,13 +11691,13 @@ interface operations {
         };
         requestBody?: never;
         responses: {
-            /** @description Bare array of communities; not paginated (workspaces have a small handful). */
+            /** @description Paginated communities. */
             200: {
                 headers: {
                     [name: string]: unknown;
                 };
                 content: {
-                    "application/json": components["schemas"]["CommunityResponseDto"][];
+                    "application/json": components["schemas"]["CommunityListResponseDto"];
                 };
             };
             /** @description Caller lacks `social.list`, or the workspace has not enabled the `social` service. */