featurebase-node 0.3.0 → 0.5.0

package/src/resources/feedback/comments.ts

@@ -3,6 +3,7 @@
 import { APIResource } from '../../core/resource';
 import * as TicketsAPI from '../support/tickets/tickets';
 import { APIPromise } from '../../core/api-promise';
+import { CursorPage, type CursorPageParams, PagePromise } from '../../core/pagination';
 import { buildHeaders } from '../../internal/headers';
 import { RequestOptions } from '../../internal/request-options';
 import { path } from '../../internal/utils/path';
@@ -82,7 +83,11 @@ export class Comments extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -124,7 +129,11 @@ export class Comments extends APIResource {
     return this._client.get(path`/v2/comments/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -180,7 +189,11 @@ export class Comments extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -258,19 +271,26 @@ export class Comments extends APIResource {
    *
    * @example
    * ```ts
-   * const comments = await client.feedback.comments.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const comment of client.feedback.comments.list()) {
+   *   // ...
+   * }
    * ```
    */
   list(
     params: CommentListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<CommentListResponse> {
+  ): PagePromise<CommentsCursorPage, Comment> {
     const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.get('/v2/comments', {
+    return this._client.getAPIList('/v2/comments', CursorPage<Comment>, {
       query,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -333,7 +353,11 @@ export class Comments extends APIResource {
     return this._client.delete(path`/v2/comments/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -405,13 +429,19 @@ export class Comments extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
   }
 }
 
+export type CommentsCursorPage = CursorPage<Comment>;
+
 export interface Comment {
   /**
    * Unique identifier
@@ -520,55 +550,6 @@ export namespace Comment {
   }
 }
 
-export interface CommentListResponse {
-  /**
-   * Array of comments
-   */
-  data: Array<Comment>;
-
-  /**
-   * Cursor for fetching the next page (cursor-based pagination)
-   */
-  nextCursor: string | null;
-
-  /**
-   * Object type identifier
-   */
-  object: 'list';
-
-  /**
-   * Pagination metadata for page-based requests
-   */
-  pagination?: CommentListResponse.Pagination;
-}
-
-export namespace CommentListResponse {
-  /**
-   * Pagination metadata for page-based requests
-   */
-  export interface Pagination {
-    /**
-     * Items per page
-     */
-    limit: number;
-
-    /**
-     * Current page number
-     */
-    page: number;
-
-    /**
-     * Total number of items
-     */
-    total: number;
-
-    /**
-     * Total number of pages
-     */
-    totalPages: number;
-  }
-}
-
 export interface CommentDelete0Response {
   /**
    * Unique identifier of the deleted comment
@@ -650,7 +631,7 @@ export interface CommentCreateParams {
    * Header param: API version for this request. Defaults to your organization's
    * configured API version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface CommentRetrieveParams {
@@ -658,7 +639,7 @@ export interface CommentRetrieveParams {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface CommentUpdateParams {
@@ -703,30 +684,20 @@ export interface CommentUpdateParams {
    * Header param: API version for this request. Defaults to your organization's
    * configured API version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface CommentListParams {
+export interface CommentListParams extends CursorPageParams {
   /**
    * Query param: Filter comments by changelog ID
    */
   changelogId?: string;
 
-  /**
-   * Query param: Cursor for pagination. Use nextCursor from previous response.
-   */
-  cursor?: string;
-
   /**
    * Query param: Filter by review status
    */
   inReview?: boolean | null;
 
-  /**
-   * Query param: Maximum number of comments to return
-   */
-  limit?: number;
-
   /**
    * Query param: Filter comments by post ID
    */
@@ -746,7 +717,7 @@ export interface CommentListParams {
    * Header param: API version for this request. Defaults to your organization's
    * configured API version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface CommentDelete0Params {
@@ -754,7 +725,7 @@ export interface CommentDelete0Params {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface CommentDelete1Params {
@@ -767,15 +738,15 @@ export interface CommentDelete1Params {
    * Header param: API version for this request. Defaults to your organization's
    * configured API version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export declare namespace Comments {
   export {
     type Comment as Comment,
-    type CommentListResponse as CommentListResponse,
     type CommentDelete0Response as CommentDelete0Response,
     type CommentDelete1Response as CommentDelete1Response,
+    type CommentsCursorPage as CommentsCursorPage,
     type CommentCreateParams as CommentCreateParams,
     type CommentRetrieveParams as CommentRetrieveParams,
     type CommentUpdateParams as CommentUpdateParams,

package/src/resources/feedback/custom-fields.ts

@@ -49,7 +49,11 @@ export class CustomFields extends APIResource {
     return this._client.get(path`/v2/custom_fields/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -105,7 +109,11 @@ export class CustomFields extends APIResource {
     return this._client.get('/v2/custom_fields', {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -242,7 +250,7 @@ export interface CustomFieldRetrieveParams {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface CustomFieldListParams {
@@ -250,7 +258,7 @@ export interface CustomFieldListParams {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export declare namespace CustomFields {

package/src/resources/feedback/feedback.ts

@@ -12,10 +12,10 @@ import {
   CommentDelete1Params,
   CommentDelete1Response,
   CommentListParams,
-  CommentListResponse,
   CommentRetrieveParams,
   CommentUpdateParams,
   Comments,
+  CommentsCursorPage,
 } from './comments';
 import * as CustomFieldsAPI from './custom-fields';
 import {
@@ -40,10 +40,10 @@ import {
   PostDeleteParams,
   PostDeleteResponse,
   PostListParams,
-  PostListResponse,
   PostRetrieveParams,
   PostUpdateParams,
   Posts,
+  PostsCursorPage,
 } from './posts/posts';
 
 export class Feedback extends APIResource {
@@ -72,8 +72,8 @@ export declare namespace Feedback {
   export {
     Posts as Posts,
     type Post as Post,
-    type PostListResponse as PostListResponse,
     type PostDeleteResponse as PostDeleteResponse,
+    type PostsCursorPage as PostsCursorPage,
     type PostCreateParams as PostCreateParams,
     type PostRetrieveParams as PostRetrieveParams,
     type PostUpdateParams as PostUpdateParams,
@@ -92,9 +92,9 @@ export declare namespace Feedback {
   export {
     Comments as Comments,
     type Comment as Comment,
-    type CommentListResponse as CommentListResponse,
     type CommentDelete0Response as CommentDelete0Response,
     type CommentDelete1Response as CommentDelete1Response,
+    type CommentsCursorPage as CommentsCursorPage,
     type CommentCreateParams as CommentCreateParams,
     type CommentRetrieveParams as CommentRetrieveParams,
     type CommentUpdateParams as CommentUpdateParams,

package/src/resources/feedback/index.ts

@@ -10,7 +10,6 @@ export {
 export {
   Comments,
   type Comment,
-  type CommentListResponse,
   type CommentDelete0Response,
   type CommentDelete1Response,
   type CommentCreateParams,
@@ -19,6 +18,7 @@ export {
   type CommentListParams,
   type CommentDelete0Params,
   type CommentDelete1Params,
+  type CommentsCursorPage,
 } from './comments';
 export {
   CustomFields,
@@ -38,11 +38,11 @@ export {
 export {
   Posts,
   type Post,
-  type PostListResponse,
   type PostDeleteResponse,
   type PostCreateParams,
   type PostRetrieveParams,
   type PostUpdateParams,
   type PostListParams,
   type PostDeleteParams,
+  type PostsCursorPage,
 } from './posts/index';

package/src/resources/feedback/post-statuses.ts

@@ -33,7 +33,11 @@ export class PostStatuses extends APIResource {
     return this._client.get(path`/v2/post_statuses/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -66,7 +70,11 @@ export class PostStatuses extends APIResource {
     return this._client.get('/v2/post_statuses', {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -112,7 +120,7 @@ export interface PostStatusRetrieveParams {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface PostStatusListParams {
@@ -120,7 +128,7 @@ export interface PostStatusListParams {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export declare namespace PostStatuses {

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

@@ -3,13 +3,13 @@
 export {
   Posts,
   type Post,
-  type PostListResponse,
   type PostDeleteResponse,
   type PostCreateParams,
   type PostRetrieveParams,
   type PostUpdateParams,
   type PostListParams,
   type PostDeleteParams,
+  type PostsCursorPage,
 } from './posts';
 export {
   Voters,
@@ -19,4 +19,5 @@ export {
   type VoterListParams,
   type VoterAddParams,
   type VoterRemoveParams,
+  type VoterListResponsesCursorPage,
 } from './voters';

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

@@ -8,12 +8,14 @@ import {
   VoterAddResponse,
   VoterListParams,
   VoterListResponse,
+  VoterListResponsesCursorPage,
   VoterRemoveParams,
   VoterRemoveResponse,
   Voters,
 } from './voters';
 import * as TicketsAPI from '../../support/tickets/tickets';
 import { APIPromise } from '../../../core/api-promise';
+import { CursorPage, type CursorPageParams, PagePromise } from '../../../core/pagination';
 import { buildHeaders } from '../../../internal/headers';
 import { RequestOptions } from '../../../internal/request-options';
 import { path } from '../../../internal/utils/path';
@@ -81,7 +83,11 @@ export class Posts extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -115,7 +121,11 @@ export class Posts extends APIResource {
     return this._client.get(path`/v2/posts/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -165,7 +175,11 @@ export class Posts extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -225,19 +239,26 @@ export class Posts extends APIResource {
    *
    * @example
    * ```ts
-   * const posts = await client.feedback.posts.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const post of client.feedback.posts.list()) {
+   *   // ...
+   * }
    * ```
    */
   list(
     params: PostListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<PostListResponse> {
+  ): PagePromise<PostsCursorPage, Post> {
     const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.get('/v2/posts', {
+    return this._client.getAPIList('/v2/posts', CursorPage<Post>, {
       query,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -283,13 +304,19 @@ export class Posts extends APIResource {
     return this._client.delete(path`/v2/posts/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
   }
 }
 
+export type PostsCursorPage = CursorPage<Post>;
+
 export interface Post {
   /**
    * Unique identifier
@@ -629,55 +656,6 @@ export namespace Post {
   }
 }
 
-export interface PostListResponse {
-  /**
-   * Array of posts
-   */
-  data: Array<Post>;
-
-  /**
-   * Cursor for fetching the next page (cursor-based pagination)
-   */
-  nextCursor: string | null;
-
-  /**
-   * Object type identifier
-   */
-  object: 'list';
-
-  /**
-   * Pagination metadata for page-based requests
-   */
-  pagination?: PostListResponse.Pagination;
-}
-
-export namespace PostListResponse {
-  /**
-   * Pagination metadata for page-based requests
-   */
-  export interface Pagination {
-    /**
-     * Items per page
-     */
-    limit: number;
-
-    /**
-     * Current page number
-     */
-    page: number;
-
-    /**
-     * Total number of items
-     */
-    total: number;
-
-    /**
-     * Total number of pages
-     */
-    totalPages: number;
-  }
-}
-
 export interface PostDeleteResponse {
   /**
    * Unique identifier of the deleted post
@@ -791,7 +769,7 @@ export interface PostCreateParams {
    * Header param: API version for this request. Defaults to your organization's
    * configured API version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export namespace PostCreateParams {
@@ -838,7 +816,7 @@ export interface PostRetrieveParams {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface PostUpdateParams {
@@ -928,31 +906,20 @@ export interface PostUpdateParams {
    * Header param: API version for this request. Defaults to your organization's
    * configured API version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
-export interface PostListParams {
+export interface PostListParams extends CursorPageParams {
   /**
    * Query param: Filter by board (category) ID(s)
    */
   boardId?: string | Array<string>;
 
-  /**
-   * Query param: An opaque cursor for pagination. Use the nextCursor value from a
-   * previous response to fetch the next page of results.
-   */
-  cursor?: string;
-
   /**
    * Query param: Include posts that are in review
    */
   inReview?: boolean | null;
 
-  /**
-   * Query param: A limit on the number of posts to be returned, between 1 and 100.
-   */
-  limit?: number;
-
   /**
    * Query param: Search query to filter posts by title/content
    */
@@ -982,7 +949,7 @@ export interface PostListParams {
    * Header param: API version for this request. Defaults to your organization's
    * configured API version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 export interface PostDeleteParams {
@@ -990,7 +957,7 @@ export interface PostDeleteParams {
    * API version for this request. Defaults to your organization's configured API
    * version if not specified.
    */
-  'Featurebase-Version'?: string;
+  'Featurebase-Version'?: '2026-01-01.nova' | '2025-12-12.clover';
 }
 
 Posts.Voters = Voters;
@@ -998,8 +965,8 @@ Posts.Voters = Voters;
 export declare namespace Posts {
   export {
     type Post as Post,
-    type PostListResponse as PostListResponse,
     type PostDeleteResponse as PostDeleteResponse,
+    type PostsCursorPage as PostsCursorPage,
     type PostCreateParams as PostCreateParams,
     type PostRetrieveParams as PostRetrieveParams,
     type PostUpdateParams as PostUpdateParams,
@@ -1012,6 +979,7 @@ export declare namespace Posts {
     type VoterListResponse as VoterListResponse,
     type VoterAddResponse as VoterAddResponse,
     type VoterRemoveResponse as VoterRemoveResponse,
+    type VoterListResponsesCursorPage as VoterListResponsesCursorPage,
     type VoterListParams as VoterListParams,
     type VoterAddParams as VoterAddParams,
     type VoterRemoveParams as VoterRemoveParams,