featurebase-node 0.12.0 → 0.14.0

package/src/resources/feedback/posts/posts.ts

@@ -1,6 +1,7 @@
 // File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
 
 import { APIResource } from '../../../core/resource';
+import * as PostsAPI from './posts';
 import * as PostStatusesAPI from '../post-statuses';
 import * as VotersAPI from './voters';
 import {
@@ -26,6 +27,85 @@ import { path } from '../../../internal/utils/path';
 export class Posts extends APIResource {
   voters: VotersAPI.Voters = new VotersAPI.Voters(this._client);
 
+  /**
+   * Returns all posts (feedback submissions) for the authenticated organization.
+   *
+   * Posts are user-submitted feedback items. Each post belongs to a board and can
+   * have:
+   *
+   * - Status (in progress, complete, etc.)
+   * - Tags for categorization
+   * - Upvotes from users
+   * - Comments (if enabled)
+   * - Custom field values
+   *
+   * ### Pagination
+   *
+   * This endpoint uses **cursor-based pagination**:
+   *
+   * - `limit` - Number of posts to return (1-100, default 10)
+   * - `cursor` - Opaque cursor from a previous response's `nextCursor` field
+   *
+   * **Example:** To paginate through results:
+   *
+   * 1. First request: `GET /v2/posts?limit=10`
+   * 2. If `nextCursor` is not null, use it for the next page
+   * 3. Next request: `GET /v2/posts?limit=10&cursor={nextCursor}`
+   *
+   * ### Response Format
+   *
+   * Returns a list object with:
+   *
+   * - `object` - Always "list"
+   * - `data` - Array of post objects
+   * - `nextCursor` - Cursor for the next page (null if no more results)
+   *
+   * ### Filtering
+   *
+   * Filter posts using query parameters:
+   *
+   * - `boardId` - Filter by board (category) ID
+   * - `statusId` - Filter by status ID
+   * - `tags` - Filter by tag names (can be comma-separated or repeated)
+   * - `q` - Search query for title/content
+   * - `inReview` - Include posts pending moderation
+   *
+   * ### Sorting
+   *
+   * Use `sortBy` to sort results:
+   *
+   * - `createdAt` - Sort by creation date (default)
+   * - `upvotes` - Sort by vote count
+   * - `trending` - Sort by trending score
+   * - `recent` - Sort by most recently updated
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const post of client.feedback.posts.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: PostListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<PostsCursorPage, Post> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+    return this._client.getAPIList('/v2/posts', CursorPage<Post>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Creates a new post (feedback submission) in the specified board.
    *
@@ -185,85 +265,6 @@ export class Posts extends APIResource {
     });
   }
 
-  /**
-   * Returns all posts (feedback submissions) for the authenticated organization.
-   *
-   * Posts are user-submitted feedback items. Each post belongs to a board and can
-   * have:
-   *
-   * - Status (in progress, complete, etc.)
-   * - Tags for categorization
-   * - Upvotes from users
-   * - Comments (if enabled)
-   * - Custom field values
-   *
-   * ### Pagination
-   *
-   * This endpoint uses **cursor-based pagination**:
-   *
-   * - `limit` - Number of posts to return (1-100, default 10)
-   * - `cursor` - Opaque cursor from a previous response's `nextCursor` field
-   *
-   * **Example:** To paginate through results:
-   *
-   * 1. First request: `GET /v2/posts?limit=10`
-   * 2. If `nextCursor` is not null, use it for the next page
-   * 3. Next request: `GET /v2/posts?limit=10&cursor={nextCursor}`
-   *
-   * ### Response Format
-   *
-   * Returns a list object with:
-   *
-   * - `object` - Always "list"
-   * - `data` - Array of post objects
-   * - `nextCursor` - Cursor for the next page (null if no more results)
-   *
-   * ### Filtering
-   *
-   * Filter posts using query parameters:
-   *
-   * - `boardId` - Filter by board (category) ID
-   * - `statusId` - Filter by status ID
-   * - `tags` - Filter by tag names (can be comma-separated or repeated)
-   * - `q` - Search query for title/content
-   * - `inReview` - Include posts pending moderation
-   *
-   * ### Sorting
-   *
-   * Use `sortBy` to sort results:
-   *
-   * - `createdAt` - Sort by creation date (default)
-   * - `upvotes` - Sort by vote count
-   * - `trending` - Sort by trending score
-   * - `recent` - Sort by most recently updated
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const post of client.feedback.posts.list()) {
-   *   // ...
-   * }
-   * ```
-   */
-  list(
-    params: PostListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<PostsCursorPage, Post> {
-    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.getAPIList('/v2/posts', CursorPage<Post>, {
-      query,
-      ...options,
-      headers: buildHeaders([
-        {
-          ...(featurebaseVersion?.toString() != null ?
-            { 'Featurebase-Version': featurebaseVersion?.toString() }
-          : undefined),
-        },
-        options?.headers,
-      ]),
-    });
-  }
-
   /**
    * Permanently deletes a post. This action cannot be undone.
    *
@@ -322,7 +323,7 @@ export class Posts extends APIResource {
    *
    * - **Filter mode** — pass a structured `query` AST (and/or `sort`) and the
    *   endpoint returns posts matching the filter, ordered by `sort` (default
-   *   `created_at:desc`). Same shape as `/v2/conversations/search`,
+   *   `createdAt:desc`). Same shape as `/v2/conversations/search`,
    *   `/v2/companies/search`, `/v2/contacts/search`.
    * - **Search mode** — pass a top-level `search` string and the endpoint runs a
    *   hybrid full-text + vector search (BM25 + embeddings, semanticRatio 0.5) over
@@ -337,7 +338,7 @@ export class Posts extends APIResource {
    *     "operator": "AND",
    *     "value": [
    *       {
-   *         "field": "board_id",
+   *         "field": "boardId",
    *         "operator": "IN",
    *         "value": ["507f1f77bcf86cd799439011"]
    *       }
@@ -363,7 +364,7 @@ export class Posts extends APIResource {
    *     "operator": "AND",
    *     "value": [
    *       {
-   *         "field": "board_id",
+   *         "field": "boardId",
    *         "operator": "IN",
    *         "value": ["507f1f77bcf86cd799439011"]
    *       },
@@ -375,21 +376,44 @@ export class Posts extends APIResource {
    * }
    * ```
    *
+   * To list every post a contact has upvoted (the inverse of
+   * `feedback.posts.voters.list(postId)`):
+   *
+   * ```json
+   * {
+   *   "query": {
+   *     "field": "voterId",
+   *     "operator": "=",
+   *     "value": "507f1f77bcf86cd799439011"
+   *   },
+   *   "sort": "upvotes:desc",
+   *   "limit": 100
+   * }
+   * ```
+   *
    * Top-level `OR` groups and nested groups are not supported in this version.
    *
    * ### Supported fields and operators
    *
-   * | Field                                                             | Type                         | Operators                                          |
-   * | ----------------------------------------------------------------- | ---------------------------- | -------------------------------------------------- |
-   * | `board_id`                                                        | id (categoryId)              | `=`, `!=`, `IN`, `NIN`                             |
-   * | `status_id`                                                       | id (postStatus)              | `=`, `!=`, `IN`, `NIN`                             |
-   * | `tag_id`                                                          | id (postTags)                | `=`, `!=`, `IN`, `NIN`                             |
-   * | `author_id`                                                       | string (user id)             | `=`, `!=`, `IN`, `NIN`                             |
-   * | `assignee_id`                                                     | id or null (admin)           | `=`, `!=`, `IN`, `NIN` (use `null` for unassigned) |
-   * | `company_id`                                                      | string (external company id) | `=`, `!=`, `IN`, `NIN`                             |
-   * | `created_at`, `updated_at`, `eta`                                 | unix seconds                 | `=`, `!=`, `>`, `<`, `>=`, `<=`                    |
-   * | `upvotes`, `comment_count`, `monthly_spend`, `opportunity_amount` | number                       | `=`, `!=`, `>`, `<`, `>=`, `<=`                    |
-   * | `in_review`, `is_pinned`                                          | boolean                      | `=`, `!=`                                          |
+   * Field names are camelCase, matching the rest of the v2 public API. Snake_case
+   * names that this endpoint originally shipped with (`board_id`, `status_id`,
+   * `tag_id`, `author_id`, `voter_id`, `assignee_id`, `company_id`, `created_at`,
+   * `updated_at`, `comment_count`, `monthly_spend`, `opportunity_amount`,
+   * `in_review`, `is_pinned`) are still accepted for back-compat but are deprecated
+   * — please migrate to camelCase in new code.
+   *
+   * | Field                                                          | Type                         | Operators                                                                                                                                |
+   * | -------------------------------------------------------------- | ---------------------------- | ---------------------------------------------------------------------------------------------------------------------------------------- |
+   * | `boardId`                                                      | id (categoryId)              | `=`, `!=`, `IN`, `NIN`                                                                                                                   |
+   * | `statusId`                                                     | id (postStatus)              | `=`, `!=`, `IN`, `NIN`                                                                                                                   |
+   * | `tagId`                                                        | id (postTags)                | `=`, `!=`, `IN`, `NIN`                                                                                                                   |
+   * | `authorId`                                                     | string (user id)             | `=`, `!=`, `IN`, `NIN`                                                                                                                   |
+   * | `voterId`                                                      | id (customer)                | `=`, `IN` (use to list every post a contact has upvoted; only matches `type: customer` upvoters — guests/admins are not searchable here) |
+   * | `assigneeId`                                                   | id or null (admin)           | `=`, `!=`, `IN`, `NIN` (use `null` for unassigned)                                                                                       |
+   * | `companyId`                                                    | string (external company id) | `=`, `!=`, `IN`, `NIN`                                                                                                                   |
+   * | `createdAt`, `updatedAt`, `eta`                                | unix seconds                 | `=`, `!=`, `>`, `<`, `>=`, `<=`                                                                                                          |
+   * | `upvotes`, `commentCount`, `monthlySpend`, `opportunityAmount` | number                       | `=`, `!=`, `>`, `<`, `>=`, `<=`                                                                                                          |
+   * | `inReview`, `isPinned`                                         | boolean                      | `=`, `!=`                                                                                                                                |
    *
    * Use the top-level `search` field for full-text search across `title` and
    * `content` (see "Search mode" above). The clause-level operators `~`, `!~`, `^`,
@@ -398,7 +422,7 @@ export class Posts extends APIResource {
    * A filter-mode query (no `search`) consisting only of `!=` or `NIN` clauses on
    * unbounded fields is rejected with `query_too_broad` to prevent full-org scans.
    * Combine the negation with at least one positive clause (`=`, `IN`, `>`, `<`)
-   * instead. Boolean fields (`in_review`, `is_pinned`) are bounded so a standalone
+   * instead. Boolean fields (`inReview`, `isPinned`) are bounded so a standalone
    * negation on them is allowed. Search mode (with `search` set) relaxes this — the
    * FTS query itself acts as the positive constraint.
    *
@@ -406,15 +430,18 @@ export class Posts extends APIResource {
    *
    * Allowed values:
    *
-   * - `created_at:desc` (default), `created_at:asc`
-   * - `updated_at:desc`, `updated_at:asc`
+   * - `createdAt:desc` (default), `createdAt:asc`
+   * - `updatedAt:desc`, `updatedAt:asc`
    * - `upvotes:desc`, `upvotes:asc`
    * - `eta:desc`, `eta:asc`
-   * - `trending_score:desc`, `trending_score:asc`
-   * - `monthly_spend:desc`, `monthly_spend:asc` (sum of upvoters' monthly spend)
-   * - `opportunity_amount:desc`, `opportunity_amount:asc` (linked HubSpot/Salesforce
+   * - `monthlySpend:desc`, `monthlySpend:asc` (sum of upvoters' monthly spend)
+   * - `opportunityAmount:desc`, `opportunityAmount:asc` (linked HubSpot/Salesforce
    *   value)
-   * - `comment_count:desc`, `comment_count:asc`
+   * - `commentCount:desc`, `commentCount:asc`
+   *
+   * Snake_case sort axes (`created_at:desc`, `monthly_spend:asc`, etc.) are accepted
+   * for back-compat — the cursor encodes the canonical camelCase identity, so a
+   * caller can switch naming conventions mid-pagination without restarting.
    *
    * When `search` is set, results are ranked by relevance unless `sort` is also set,
    * in which case the matching posts are returned in the requested order. The chosen
@@ -479,14 +506,14 @@ export interface Post {
    */
   id: string;
 
-  access: Post.Access;
+  access: PostAccess;
 
   /**
    * ID of the admin assigned to this post, null if unassigned
    */
   assigneeId: string | null;
 
-  author: Post.Author | null;
+  author: PostAuthor | null;
 
   /**
    * Board (category) ID this post belongs to
@@ -518,7 +545,7 @@ export interface Post {
    */
   eta: string | null;
 
-  features: Post.Features;
+  features: PostFeatures;
 
   /**
    * Whether the post is pending moderation review
@@ -560,7 +587,7 @@ export interface Post {
   /**
    * Tags attached to this post
    */
-  tags: Array<Post.Tag>;
+  tags: Array<PostTag>;
 
   /**
    * Post title
@@ -579,56 +606,6 @@ export interface Post {
 }
 
 export namespace Post {
-  export interface Access {
-    /**
-     * External company IDs explicitly granted access to this post. Empty array means
-     * no company-level restrictions. Non-empty means only users belonging to these
-     * companies can see the post.
-     */
-    companyExternalIds: Array<string>;
-
-    /**
-     * User IDs explicitly granted access to this post. Empty array means no user-level
-     * restrictions (post uses board/org visibility). Non-empty means only these users
-     * (plus admins) can see the post.
-     */
-    userIds: Array<string>;
-  }
-
-  export interface Author {
-    /**
-     * Author unique identifier
-     */
-    id: string | null;
-
-    /**
-     * Author email (if available)
-     */
-    email: string | null;
-
-    /**
-     * Author display name
-     */
-    name: string;
-
-    /**
-     * Author profile picture URL
-     */
-    profilePicture: string | null;
-
-    /**
-     * Type of user who authored the post
-     */
-    type: 'admin' | 'customer' | 'guest' | 'integration' | 'bot' | 'lead';
-  }
-
-  export interface Features {
-    /**
-     * Whether comments are allowed on this post
-     */
-    commentsEnabled: boolean;
-  }
-
   /**
    * Third-party integration links associated with this post
    */
@@ -793,23 +770,102 @@ export namespace Post {
       objectType: 'Opportunity' | 'Case';
     }
   }
+}
 
-  export interface Tag {
-    /**
-     * Tag unique identifier
-     */
-    id: string;
+export interface PostAccess {
+  /**
+   * External company IDs explicitly granted access to this post. Empty array means
+   * no company-level restrictions. Non-empty means only users belonging to these
+   * companies can see the post.
+   */
+  companyExternalIds: Array<string>;
 
-    /**
-     * Tag color hex code
-     */
-    color: string | null;
+  /**
+   * User IDs explicitly granted access to this post. Empty array means no user-level
+   * restrictions (post uses board/org visibility). Non-empty means only these users
+   * (plus admins) can see the post.
+   */
+  userIds: Array<string>;
+}
 
-    /**
-     * Tag name
-     */
-    name: string;
-  }
+export interface PostAuthor {
+  /**
+   * Author unique identifier
+   */
+  id: string | null;
+
+  /**
+   * Author email (if available)
+   */
+  email: string | null;
+
+  /**
+   * Author display name
+   */
+  name: string;
+
+  /**
+   * Author profile picture URL
+   */
+  profilePicture: string | null;
+
+  /**
+   * Type of user who authored the post
+   */
+  type: 'admin' | 'customer' | 'guest' | 'integration' | 'bot' | 'lead';
+}
+
+export interface PostFeatures {
+  /**
+   * Whether comments are allowed on this post
+   */
+  commentsEnabled: boolean;
+}
+
+export interface PostTag {
+  /**
+   * Tag unique identifier
+   */
+  id: string;
+
+  /**
+   * Tag color hex code
+   */
+  color: string | null;
+
+  /**
+   * Tag name
+   */
+  name: string;
+}
+
+export interface SearchFilter {
+  /**
+   * Field name to filter on (e.g. `state`, `tag_ids`, `created_at`)
+   */
+  field: string;
+
+  /**
+   * Comparison operator
+   */
+  operator: '=' | '!=' | 'IN' | 'NIN' | '>' | '<' | '>=' | '<=' | '~' | '!~' | '^' | '$';
+
+  /**
+   * Value to compare against (primitive or array of primitives)
+   */
+  value: string | number | boolean | Array<string | number> | null;
+}
+
+export interface SearchFilterGroup {
+  /**
+   * Group operator: AND (all match) or OR (any match)
+   */
+  operator: 'AND' | 'OR';
+
+  /**
+   * Array of filter clauses (1-15 entries)
+   */
+  value: Array<SearchFilter>;
 }
 
 export interface PostDeleteResponse {
@@ -866,14 +922,14 @@ export namespace PostSearchResponse {
      */
     id: string;
 
-    access: Data.Access;
+    access: PostsAPI.PostAccess;
 
     /**
      * ID of the admin assigned to this post, null if unassigned
      */
     assigneeId: string | null;
 
-    author: Data.Author | null;
+    author: PostsAPI.PostAuthor | null;
 
     /**
      * Board (category) ID this post belongs to
@@ -905,7 +961,7 @@ export namespace PostSearchResponse {
      */
     eta: string | null;
 
-    features: Data.Features;
+    features: PostsAPI.PostFeatures;
 
     /**
      * Whether the post is pending moderation review
@@ -947,7 +1003,7 @@ export namespace PostSearchResponse {
     /**
      * Tags attached to this post
      */
-    tags: Array<Data.Tag>;
+    tags: Array<PostsAPI.PostTag>;
 
     /**
      * Post title
@@ -966,56 +1022,6 @@ export namespace PostSearchResponse {
   }
 
   export namespace Data {
-    export interface Access {
-      /**
-       * External company IDs explicitly granted access to this post. Empty array means
-       * no company-level restrictions. Non-empty means only users belonging to these
-       * companies can see the post.
-       */
-      companyExternalIds: Array<string>;
-
-      /**
-       * User IDs explicitly granted access to this post. Empty array means no user-level
-       * restrictions (post uses board/org visibility). Non-empty means only these users
-       * (plus admins) can see the post.
-       */
-      userIds: Array<string>;
-    }
-
-    export interface Author {
-      /**
-       * Author unique identifier
-       */
-      id: string | null;
-
-      /**
-       * Author email (if available)
-       */
-      email: string | null;
-
-      /**
-       * Author display name
-       */
-      name: string;
-
-      /**
-       * Author profile picture URL
-       */
-      profilePicture: string | null;
-
-      /**
-       * Type of user who authored the post
-       */
-      type: 'admin' | 'customer' | 'guest' | 'integration' | 'bot' | 'lead';
-    }
-
-    export interface Features {
-      /**
-       * Whether comments are allowed on this post
-       */
-      commentsEnabled: boolean;
-    }
-
     /**
      * Third-party integration links associated with this post
      */
@@ -1180,24 +1186,50 @@ export namespace PostSearchResponse {
         objectType: 'Opportunity' | 'Case';
       }
     }
+  }
+}
 
-    export interface Tag {
-      /**
-       * Tag unique identifier
-       */
-      id: string;
+export interface PostListParams extends CursorPageParams {
+  /**
+   * Query param: Filter by board (category) ID(s)
+   */
+  boardId?: string | Array<string>;
 
-      /**
-       * Tag color hex code
-       */
-      color: string | null;
+  /**
+   * Query param: Include posts that are in review
+   */
+  inReview?: boolean | null;
 
-      /**
-       * Tag name
-       */
-      name: string;
-    }
-  }
+  /**
+   * Query param: Search query to filter posts by title/content
+   */
+  q?: string;
+
+  /**
+   * Query param: Sort order for posts
+   */
+  sortBy?: 'createdAt' | 'upvotes' | 'trending' | 'recent';
+
+  /**
+   * Query param: Sort direction
+   */
+  sortOrder?: 'asc' | 'desc';
+
+  /**
+   * Query param: Filter by status ID(s)
+   */
+  statusId?: string | Array<string>;
+
+  /**
+   * Query param: Filter by tag names
+   */
+  tags?: string | Array<string>;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface PostCreateParams {
@@ -1436,49 +1468,6 @@ export interface PostUpdateParams {
   'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface PostListParams extends CursorPageParams {
-  /**
-   * Query param: Filter by board (category) ID(s)
-   */
-  boardId?: string | Array<string>;
-
-  /**
-   * Query param: Include posts that are in review
-   */
-  inReview?: boolean | null;
-
-  /**
-   * Query param: Search query to filter posts by title/content
-   */
-  q?: string;
-
-  /**
-   * Query param: Sort order for posts
-   */
-  sortBy?: 'createdAt' | 'upvotes' | 'trending' | 'recent';
-
-  /**
-   * Query param: Sort direction
-   */
-  sortOrder?: 'asc' | 'desc';
-
-  /**
-   * Query param: Filter by status ID(s)
-   */
-  statusId?: string | Array<string>;
-
-  /**
-   * Query param: Filter by tag names
-   */
-  tags?: string | Array<string>;
-
-  /**
-   * Header param: API version for this request. Defaults to your organization's
-   * configured API version if not specified.
-   */
-  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
-}
-
 export interface PostDeleteParams {
   /**
    * API version for this request. Defaults to your organization's configured API
@@ -1503,7 +1492,7 @@ export interface PostSearchParams {
    * Body param: Structured filter AST. Either a single filter clause or one
    * top-level AND group (max 15 clauses). Top-level OR groups are not yet supported.
    */
-  query?: PostSearchParams.SearchFilter | PostSearchParams.SearchFilterGroup;
+  query?: SearchFilter | SearchFilterGroup;
 
   /**
    * Body param: Plain-text full-text search across post `title` and `content`.
@@ -1515,21 +1504,30 @@ export interface PostSearchParams {
   search?: string;
 
   /**
-   * Body param: Sort field + direction. Defaults to `created_at:desc`. The chosen
+   * Body param: Sort field + direction. Defaults to `createdAt:desc`. The chosen
    * sort axis is encoded in the cursor; switching `sort` mid-pagination returns
-   * `400 invalid_cursor`.
+   * `400 invalid_cursor`. Snake_case names (`created_at:desc`, `monthly_spend:asc`,
+   * …) are accepted for back-compat — prefer camelCase in new code.
    */
   sort?:
-    | 'created_at:desc'
-    | 'created_at:asc'
-    | 'updated_at:desc'
-    | 'updated_at:asc'
+    | 'createdAt:desc'
+    | 'createdAt:asc'
+    | 'updatedAt:desc'
+    | 'updatedAt:asc'
     | 'upvotes:desc'
     | 'upvotes:asc'
     | 'eta:desc'
     | 'eta:asc'
-    | 'trending_score:desc'
-    | 'trending_score:asc'
+    | 'monthlySpend:desc'
+    | 'monthlySpend:asc'
+    | 'opportunityAmount:desc'
+    | 'opportunityAmount:asc'
+    | 'commentCount:desc'
+    | 'commentCount:asc'
+    | 'created_at:desc'
+    | 'created_at:asc'
+    | 'updated_at:desc'
+    | 'updated_at:asc'
     | 'monthly_spend:desc'
     | 'monthly_spend:asc'
     | 'opportunity_amount:desc'
@@ -1544,68 +1542,24 @@ export interface PostSearchParams {
   'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export namespace PostSearchParams {
-  export interface SearchFilter {
-    /**
-     * Field name to filter on (e.g. `state`, `tag_ids`, `created_at`)
-     */
-    field: string;
-
-    /**
-     * Comparison operator
-     */
-    operator: '=' | '!=' | 'IN' | 'NIN' | '>' | '<' | '>=' | '<=' | '~' | '!~' | '^' | '$';
-
-    /**
-     * Value to compare against (primitive or array of primitives)
-     */
-    value: string | number | boolean | Array<string | number> | null;
-  }
-
-  export interface SearchFilterGroup {
-    /**
-     * Group operator: AND (all match) or OR (any match)
-     */
-    operator: 'AND' | 'OR';
-
-    /**
-     * Array of filter clauses (1-15 entries)
-     */
-    value: Array<SearchFilterGroup.Value>;
-  }
-
-  export namespace SearchFilterGroup {
-    export interface Value {
-      /**
-       * Field name to filter on (e.g. `state`, `tag_ids`, `created_at`)
-       */
-      field: string;
-
-      /**
-       * Comparison operator
-       */
-      operator: '=' | '!=' | 'IN' | 'NIN' | '>' | '<' | '>=' | '<=' | '~' | '!~' | '^' | '$';
-
-      /**
-       * Value to compare against (primitive or array of primitives)
-       */
-      value: string | number | boolean | Array<string | number> | null;
-    }
-  }
-}
-
 Posts.Voters = Voters;
 
 export declare namespace Posts {
   export {
     type Post as Post,
+    type PostAccess as PostAccess,
+    type PostAuthor as PostAuthor,
+    type PostFeatures as PostFeatures,
+    type PostTag as PostTag,
+    type SearchFilter as SearchFilter,
+    type SearchFilterGroup as SearchFilterGroup,
     type PostDeleteResponse as PostDeleteResponse,
     type PostSearchResponse as PostSearchResponse,
     type PostsCursorPage as PostsCursorPage,
+    type PostListParams as PostListParams,
     type PostCreateParams as PostCreateParams,
     type PostRetrieveParams as PostRetrieveParams,
     type PostUpdateParams as PostUpdateParams,
-    type PostListParams as PostListParams,
     type PostDeleteParams as PostDeleteParams,
     type PostSearchParams as PostSearchParams,
   };