featurebase-node 0.14.2 → 0.15.0

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

@@ -27,85 +27,6 @@ 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.
    *
@@ -265,6 +186,85 @@ 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.
    *
@@ -315,6 +315,44 @@ export class Posts extends APIResource {
     });
   }
 
+  /**
+   * Merges a source post into a destination post.
+   *
+   * The source post is removed from public post lists. Its votes, comments, and
+   * supported integration links are moved to the destination post.
+   *
+   * Both posts must belong to the authenticated organization. Neither post can
+   * already be merged, and a post cannot be merged into itself.
+   *
+   * Retrying the same source and destination after a successful merge is safe and
+   * returns the destination post without merging the data again.
+   *
+   * The response contains the updated destination post.
+   *
+   * @example
+   * ```ts
+   * const post = await client.feedback.posts.merge({
+   *   destinationPostId: '507f1f77bcf86cd799439012',
+   *   sourcePostId: '507f1f77bcf86cd799439011',
+   * });
+   * ```
+   */
+  merge(params: PostMergeParams, options?: RequestOptions): APIPromise<Post> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.post('/v2/posts/merge', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Search feedback posts with a structured filter AST, full-text search, sorting,
    * and cursor pagination.
@@ -496,6 +534,39 @@ export class Posts extends APIResource {
       ]),
     });
   }
+
+  /**
+   * Restores a post that was previously merged.
+   *
+   * The restored post returns to public post lists. Its votes and comments are
+   * removed from the destination post and restored on the source post.
+   *
+   * Retrying an unmerge after it succeeds is safe and returns the restored post.
+   *
+   * The response contains the restored post.
+   *
+   * @example
+   * ```ts
+   * const post = await client.feedback.posts.unmerge({
+   *   postId: '507f1f77bcf86cd799439011',
+   * });
+   * ```
+   */
+  unmerge(params: PostUnmergeParams, options?: RequestOptions): APIPromise<Post> {
+    const { 'Featurebase-Version': featurebaseVersion, ...body } = params;
+    return this._client.post('/v2/posts/unmerge', {
+      body,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
 }
 
 export type PostsCursorPage = CursorPage<Post>;
@@ -1189,49 +1260,6 @@ export namespace PostSearchResponse {
   }
 }
 
-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 PostCreateParams {
   /**
    * Body param: Board ID to create post in
@@ -1328,7 +1356,7 @@ export interface PostCreateParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export namespace PostCreateParams {
@@ -1375,7 +1403,7 @@ export interface PostRetrieveParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface PostUpdateParams {
@@ -1465,7 +1493,50 @@ export interface PostUpdateParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '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-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface PostDeleteParams {
@@ -1473,7 +1544,25 @@ export interface PostDeleteParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
+}
+
+export interface PostMergeParams {
+  /**
+   * Body param: ID of the post that receives the source post data
+   */
+  destinationPostId: string;
+
+  /**
+   * Body param: ID of the post to merge into the destination post
+   */
+  sourcePostId: string;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface PostSearchParams {
@@ -1539,7 +1628,20 @@ export interface PostSearchParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
+}
+
+export interface PostUnmergeParams {
+  /**
+   * Body param: ID of the merged post to restore
+   */
+  postId: string;
+
+  /**
+   * Header param: API version for this request. Defaults to your organization's
+   * configured API version if not specified.
+   */
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 Posts.Voters = Voters;
@@ -1556,12 +1658,14 @@ export declare namespace Posts {
     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 PostMergeParams as PostMergeParams,
     type PostSearchParams as PostSearchParams,
+    type PostUnmergeParams as PostUnmergeParams,
   };
 
   export {

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

@@ -340,7 +340,7 @@ export interface VoterListParams extends CursorPageParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface VoterAddParams {
@@ -373,7 +373,7 @@ export interface VoterAddParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface VoterRemoveParams {
@@ -396,7 +396,7 @@ export interface VoterRemoveParams {
    * 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';
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export declare namespace Voters {