featurebase-node 0.3.0 → 0.5.0

package/src/resources/support/conversations/tags.ts

@@ -66,7 +66,11 @@ export class Tags extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -134,7 +138,11 @@ export class Tags extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -220,7 +228,7 @@ export interface TagAttachParams {
    * 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 TagDetachParams {
@@ -239,7 +247,7 @@ export interface TagDetachParams {
    * 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 Tags {

package/src/resources/support/index.ts

@@ -21,7 +21,6 @@ export {
   type CsatRatedAgent,
   type CsatWorkflowLink,
   type EmailRecipients,
-  type ConversationListResponse,
   type ConversationDeleteResponse,
   type ConversationCreateParams,
   type ConversationRetrieveParams,
@@ -30,13 +29,13 @@ export {
   type ConversationDeleteParams,
   type ConversationRedactParams,
   type ConversationReplyParams,
+  type ConversationsCursorPage,
 } from './conversations/index';
 export { Support } from './support';
 export {
   Tickets,
   type AuthorInput,
   type Ticket,
-  type TicketListResponse,
   type TicketDeleteResponse,
   type TicketCreateParams,
   type TicketRetrieveParams,
@@ -44,4 +43,5 @@ export {
   type TicketListParams,
   type TicketDeleteParams,
   type TicketReplyParams,
+  type TicketsCursorPage,
 } from './tickets/index';

package/src/resources/support/support.ts

@@ -19,7 +19,6 @@ import {
   ConversationDeleteParams,
   ConversationDeleteResponse,
   ConversationListParams,
-  ConversationListResponse,
   ConversationPart,
   ConversationPartAuthor,
   ConversationParticipant,
@@ -29,6 +28,7 @@ import {
   ConversationTagApplication,
   ConversationUpdateParams,
   Conversations,
+  ConversationsCursorPage,
   CsatEmailDelivery,
   CsatRatedAgent,
   CsatWorkflowLink,
@@ -42,11 +42,11 @@ import {
   TicketDeleteParams,
   TicketDeleteResponse,
   TicketListParams,
-  TicketListResponse,
   TicketReplyParams,
   TicketRetrieveParams,
   TicketUpdateParams,
   Tickets,
+  TicketsCursorPage,
 } from './tickets/tickets';
 
 export class Support extends APIResource {
@@ -73,8 +73,8 @@ export declare namespace Support {
     type CsatRatedAgent as CsatRatedAgent,
     type CsatWorkflowLink as CsatWorkflowLink,
     type EmailRecipients as EmailRecipients,
-    type ConversationListResponse as ConversationListResponse,
     type ConversationDeleteResponse as ConversationDeleteResponse,
+    type ConversationsCursorPage as ConversationsCursorPage,
     type ConversationCreateParams as ConversationCreateParams,
     type ConversationRetrieveParams as ConversationRetrieveParams,
     type ConversationUpdateParams as ConversationUpdateParams,
@@ -99,8 +99,8 @@ export declare namespace Support {
     Tickets as Tickets,
     type AuthorInput as AuthorInput,
     type Ticket as Ticket,
-    type TicketListResponse as TicketListResponse,
     type TicketDeleteResponse as TicketDeleteResponse,
+    type TicketsCursorPage as TicketsCursorPage,
     type TicketCreateParams as TicketCreateParams,
     type TicketRetrieveParams as TicketRetrieveParams,
     type TicketUpdateParams as TicketUpdateParams,

package/src/resources/support/tickets/categories.ts

@@ -34,7 +34,11 @@ export class Categories extends APIResource {
     return this._client.get(path`/v2/tickets/categories/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -69,7 +73,11 @@ export class Categories extends APIResource {
     return this._client.get('/v2/tickets/categories', {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -83,7 +91,7 @@ export interface CategoryRetrieveParams {
    * 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 CategoryListParams {
@@ -91,7 +99,7 @@ export interface CategoryListParams {
    * 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 Categories {

package/src/resources/support/tickets/custom-fields.ts

@@ -45,7 +45,11 @@ export class CustomFields extends APIResource {
     return this._client.get(path`/v2/tickets/custom_fields/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -85,7 +89,11 @@ export class CustomFields extends APIResource {
     return this._client.get('/v2/tickets/custom_fields', {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -97,7 +105,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 {
@@ -105,7 +113,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/support/tickets/index.ts

@@ -17,7 +17,6 @@ export {
   Tickets,
   type AuthorInput,
   type Ticket,
-  type TicketListResponse,
   type TicketDeleteResponse,
   type TicketCreateParams,
   type TicketRetrieveParams,
@@ -25,4 +24,5 @@ export {
   type TicketListParams,
   type TicketDeleteParams,
   type TicketReplyParams,
+  type TicketsCursorPage,
 } from './tickets';

package/src/resources/support/tickets/statuses.ts

@@ -33,7 +33,11 @@ export class Statuses extends APIResource {
     return this._client.get(path`/v2/tickets/statuses/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -65,7 +69,11 @@ export class Statuses extends APIResource {
     return this._client.get('/v2/tickets/statuses', {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -79,7 +87,7 @@ export interface StatusRetrieveParams {
    * 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 StatusListParams {
@@ -87,7 +95,7 @@ export interface StatusListParams {
    * 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 Statuses {

package/src/resources/support/tickets/tickets.ts

@@ -10,6 +10,7 @@ import { CustomFieldListParams, CustomFieldRetrieveParams, CustomFields } from '
 import * as StatusesAPI from './statuses';
 import { StatusListParams, StatusListResponse, StatusRetrieveParams, Statuses } from './statuses';
 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';
@@ -91,7 +92,11 @@ export class Tickets extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -123,7 +128,11 @@ export class Tickets extends APIResource {
     return this._client.get(path`/v2/tickets/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -181,7 +190,11 @@ export class Tickets extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -210,19 +223,26 @@ export class Tickets extends APIResource {
    *
    * @example
    * ```ts
-   * const tickets = await client.support.tickets.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const ticket of client.support.tickets.list()) {
+   *   // ...
+   * }
    * ```
    */
   list(
     params: TicketListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<TicketListResponse> {
+  ): PagePromise<TicketsCursorPage, Ticket> {
     const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.get('/v2/tickets', {
+    return this._client.getAPIList('/v2/tickets', CursorPage<Ticket>, {
       query,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -271,7 +291,11 @@ export class Tickets extends APIResource {
     return this._client.delete(path`/v2/tickets/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -330,13 +354,19 @@ export class Tickets extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
   }
 }
 
+export type TicketsCursorPage = CursorPage<Ticket>;
+
 /**
  * Author to attribute the post to. If not provided, uses the authenticated user.
  * Supports multiple identification methods: id (Featurebase ID), userId (external
@@ -663,23 +693,6 @@ export namespace Ticket {
   }
 }
 
-export interface TicketListResponse {
-  /**
-   * Array of tickets
-   */
-  data: Array<Ticket>;
-
-  /**
-   * Cursor for fetching the next page
-   */
-  nextCursor: string | null;
-
-  /**
-   * Object type identifier
-   */
-  object: 'list';
-}
-
 export interface TicketDeleteResponse {
   /**
    * Unique identifier of the deleted ticket
@@ -759,7 +772,7 @@ export interface TicketCreateParams {
    * 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 TicketRetrieveParams {
@@ -767,7 +780,7 @@ export interface TicketRetrieveParams {
    * 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 TicketUpdateParams {
@@ -820,10 +833,10 @@ export interface TicketUpdateParams {
    * 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 TicketListParams {
+export interface TicketListParams extends CursorPageParams {
   /**
    * Query param
    */
@@ -834,17 +847,6 @@ export interface TicketListParams {
    */
   categoryType?: 'customer' | 'tracker' | 'back-office';
 
-  /**
-   * 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
-   */
-  limit?: number;
-
   /**
    * Query param
    */
@@ -874,7 +876,7 @@ export interface TicketListParams {
    * 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 TicketDeleteParams {
@@ -882,7 +884,7 @@ export interface TicketDeleteParams {
    * 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 type TicketReplyParams = TicketReplyParams.Variant0 | TicketReplyParams.Variant1;
@@ -933,7 +935,7 @@ export declare namespace TicketReplyParams {
      * 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 Variant1 {
@@ -976,7 +978,7 @@ export declare namespace TicketReplyParams {
      * 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';
   }
 }
 
@@ -988,8 +990,8 @@ export declare namespace Tickets {
   export {
     type AuthorInput as AuthorInput,
     type Ticket as Ticket,
-    type TicketListResponse as TicketListResponse,
     type TicketDeleteResponse as TicketDeleteResponse,
+    type TicketsCursorPage as TicketsCursorPage,
     type TicketCreateParams as TicketCreateParams,
     type TicketRetrieveParams as TicketRetrieveParams,
     type TicketUpdateParams as TicketUpdateParams,