featurebase-node 0.3.0 → 0.5.0

package/src/resources/surveys.ts

@@ -4,6 +4,7 @@ import { APIResource } from '../core/resource';
 import * as SurveysAPI from './surveys';
 import * as ContactsAPI from './users/contacts/contacts';
 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';
@@ -54,7 +55,11 @@ export class Surveys extends APIResource {
     return this._client.get(path`/v2/surveys/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -95,13 +100,17 @@ export class Surveys extends APIResource {
   list(
     params: SurveyListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<SurveyListResponse> {
+  ): PagePromise<SurveysCursorPage, Survey> {
     const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.get('/v2/surveys', {
+    return this._client.getAPIList('/v2/surveys', CursorPage<Survey>, {
       query,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -145,23 +154,35 @@ export class Surveys extends APIResource {
    *
    * - `404` - Survey not found in your organization
    */
-  retrieveResponses(
+  listResponses(
     id: string,
-    params: SurveyRetrieveResponsesParams | null | undefined = {},
+    params: SurveyListResponsesParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<SurveyRetrieveResponsesResponse> {
+  ): PagePromise<SurveyListResponsesResponsesCursorPage, SurveyListResponsesResponse> {
     const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.get(path`/v2/surveys/${id}/responses`, {
-      query,
-      ...options,
-      headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
-        options?.headers,
-      ]),
-    });
+    return this._client.getAPIList(
+      path`/v2/surveys/${id}/responses`,
+      CursorPage<SurveyListResponsesResponse>,
+      {
+        query,
+        ...options,
+        headers: buildHeaders([
+          {
+            ...(featurebaseVersion?.toString() != null ?
+              { 'Featurebase-Version': featurebaseVersion?.toString() }
+            : undefined),
+          },
+          options?.headers,
+        ]),
+      },
+    );
   }
 }
 
+export type SurveysCursorPage = CursorPage<Survey>;
+
+export type SurveyListResponsesResponsesCursorPage = CursorPage<SurveyListResponsesResponse>;
+
 export interface Survey {
   /**
    * Unique identifier
@@ -405,100 +426,64 @@ export interface SurveyNextAction {
   pageId?: string;
 }
 
-export interface SurveyListResponse {
+export interface SurveyListResponsesResponse {
   /**
-   * Array of surveys
+   * Unique identifier
    */
-  data: Array<Survey>;
+  id: string;
 
   /**
-   * Cursor for fetching the next page (cursor-based pagination)
+   * ISO 8601 timestamp when created
    */
-  nextCursor: string | null;
+  createdAt: string;
 
   /**
    * Object type identifier
    */
-  object: 'list';
-}
-
-export interface SurveyRetrieveResponsesResponse {
-  /**
-   * Array of survey responses
-   */
-  data: Array<SurveyRetrieveResponsesResponse.Data>;
+  object: 'survey_response';
 
   /**
-   * Cursor for fetching the next page (cursor-based pagination)
+   * Individual responses to questions
    */
-  nextCursor: string | null;
+  responses: Array<SurveyListResponsesResponse.Response>;
 
   /**
-   * Object type identifier
+   * User who submitted the response
    */
-  object: 'list';
+  user: ContactsAPI.Contact | null;
 }
 
-export namespace SurveyRetrieveResponsesResponse {
-  export interface Data {
+export namespace SurveyListResponsesResponse {
+  export interface Response {
     /**
-     * Unique identifier
+     * Page ID this response is for
      */
-    id: string;
+    pageId: string;
 
     /**
-     * ISO 8601 timestamp when created
+     * Response type
      */
-    createdAt: string;
+    type: 'text' | 'link' | 'rating' | 'multiple-choice';
 
     /**
-     * Object type identifier
+     * Response value
      */
-    object: 'survey_response';
+    value: string | number | boolean | Array<string>;
 
     /**
-     * Individual responses to questions
+     * Response ID
      */
-    responses: Array<Data.Response>;
+    id?: string;
 
     /**
-     * User who submitted the response
+     * ISO 8601 timestamp when created
      */
-    user: ContactsAPI.Contact | null;
-  }
-
-  export namespace Data {
-    export interface Response {
-      /**
-       * Page ID this response is for
-       */
-      pageId: string;
-
-      /**
-       * Response type
-       */
-      type: 'text' | 'link' | 'rating' | 'multiple-choice';
+    createdAt?: string;
 
-      /**
-       * Response value
-       */
-      value: string | number | boolean | Array<string>;
-
-      /**
-       * Response ID
-       */
-      id?: string;
-
-      /**
-       * ISO 8601 timestamp when created
-       */
-      createdAt?: string;
-
-      /**
-       * ISO 8601 timestamp when updated
-       */
-      updatedAt?: string;
-    }
+    /**
+     * ISO 8601 timestamp when updated
+     */
+    updatedAt?: string;
   }
 }
 
@@ -507,26 +492,15 @@ export interface SurveyRetrieveParams {
    * 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 SurveyListParams {
-  /**
-   * Query param: An opaque cursor for pagination. Use the nextCursor value from a
-   * previous response to fetch the next page.
-   */
-  cursor?: string;
-
+export interface SurveyListParams extends CursorPageParams {
   /**
    * Query param: Filter by active status
    */
   isActive?: boolean | null;
 
-  /**
-   * Query param: A limit on the number of objects to be returned, between 1 and 100.
-   */
-  limit?: number;
-
   /**
    * Query param: Filter by survey page type
    */
@@ -536,21 +510,10 @@ export interface SurveyListParams {
    * 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 SurveyRetrieveResponsesParams {
-  /**
-   * Query param: An opaque cursor for pagination. Use the nextCursor value from a
-   * previous response to fetch the next page.
-   */
-  cursor?: string;
-
-  /**
-   * Query param: A limit on the number of objects to be returned, between 1 and 100.
-   */
-  limit?: number;
-
+export interface SurveyListResponsesParams extends CursorPageParams {
   /**
    * Query param: Filter by survey page ID
    */
@@ -560,17 +523,18 @@ export interface SurveyRetrieveResponsesParams {
    * 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 Surveys {
   export {
     type Survey as Survey,
     type SurveyNextAction as SurveyNextAction,
-    type SurveyListResponse as SurveyListResponse,
-    type SurveyRetrieveResponsesResponse as SurveyRetrieveResponsesResponse,
+    type SurveyListResponsesResponse as SurveyListResponsesResponse,
+    type SurveysCursorPage as SurveysCursorPage,
+    type SurveyListResponsesResponsesCursorPage as SurveyListResponsesResponsesCursorPage,
     type SurveyRetrieveParams as SurveyRetrieveParams,
     type SurveyListParams as SurveyListParams,
-    type SurveyRetrieveResponsesParams as SurveyRetrieveResponsesParams,
+    type SurveyListResponsesParams as SurveyListResponsesParams,
   };
 }

package/src/resources/users/companies/companies.ts

@@ -11,6 +11,7 @@ import {
   Contacts,
 } from './contacts';
 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 Companies extends APIResource {
     return this._client.get(path`/v2/companies/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -164,19 +169,26 @@ export class Companies extends APIResource {
    *
    * @example
    * ```ts
-   * const companies = await client.users.companies.list();
+   * // Automatically fetches more pages as needed.
+   * for await (const company of client.users.companies.list()) {
+   *   // ...
+   * }
    * ```
    */
   list(
     params: CompanyListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<CompanyListResponse> {
+  ): PagePromise<CompaniesCursorPage, Company> {
     const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.get('/v2/companies', {
+    return this._client.getAPIList('/v2/companies', CursorPage<Company>, {
       query,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -227,7 +239,11 @@ export class Companies extends APIResource {
     return this._client.delete(path`/v2/companies/${id}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -314,7 +330,11 @@ export class Companies extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -382,13 +402,19 @@ export class Companies extends APIResource {
     return this._client.delete(path`/v2/companies/by-company-id/${companyID}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
   }
 }
 
+export type CompaniesCursorPage = CursorPage<Company>;
+
 export interface Company {
   /**
    * Featurebase internal ID
@@ -478,49 +504,20 @@ export interface DeletedCompany {
   object: 'company';
 }
 
-export interface CompanyListResponse {
-  /**
-   * Array of companies
-   */
-  data: Array<Company>;
-
-  /**
-   * Cursor for fetching the next page (cursor-based pagination)
-   */
-  nextCursor: string | null;
-
-  /**
-   * Object type identifier
-   */
-  object: 'list';
-}
-
 export interface CompanyRetrieveParams {
   /**
    * 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 CompanyListParams {
-  /**
-   * 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: A limit on the number of companies to be returned, between 1
-   * and 100.
-   */
-  limit?: number;
-
+export interface CompanyListParams extends CursorPageParams {
   /**
    * 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 CompanyDeleteParams {
@@ -528,7 +525,7 @@ export interface CompanyDeleteParams {
    * 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 CompanyCreateOrUpdateParams {
@@ -583,7 +580,7 @@ export interface CompanyCreateOrUpdateParams {
    * 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 CompanyCreateOrUpdateParams {
@@ -605,7 +602,7 @@ export interface CompanyDeleteByCompanyIDParams {
    * 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';
 }
 
 Companies.Contacts = Contacts;
@@ -614,7 +611,7 @@ export declare namespace Companies {
   export {
     type Company as Company,
     type DeletedCompany as DeletedCompany,
-    type CompanyListResponse as CompanyListResponse,
+    type CompaniesCursorPage as CompaniesCursorPage,
     type CompanyRetrieveParams as CompanyRetrieveParams,
     type CompanyListParams as CompanyListParams,
     type CompanyDeleteParams as CompanyDeleteParams,

package/src/resources/users/companies/contacts.ts

@@ -2,7 +2,9 @@
 
 import { APIResource } from '../../../core/resource';
 import * as UsersContactsAPI from '../contacts/contacts';
+import { ContactListDataCursorPage } from '../contacts/contacts';
 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';
@@ -65,26 +67,36 @@ export class Contacts extends APIResource {
    *
    * @example
    * ```ts
-   * const contactList =
-   *   await client.users.companies.contacts.list(
-   *     '507f1f77bcf86cd799439011',
-   *   );
+   * // Automatically fetches more pages as needed.
+   * for await (const contact of client.users.companies.contacts.list(
+   *   '507f1f77bcf86cd799439011',
+   * )) {
+   *   // ...
+   * }
    * ```
    */
   list(
     id: string,
     params: ContactListParams | null | undefined = {},
     options?: RequestOptions,
-  ): APIPromise<UsersContactsAPI.ContactList> {
+  ): PagePromise<ContactListDataCursorPage, UsersContactsAPI.ContactList.Data> {
     const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.get(path`/v2/companies/${id}/contacts`, {
-      query,
-      ...options,
-      headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
-        options?.headers,
-      ]),
-    });
+    return this._client.getAPIList(
+      path`/v2/companies/${id}/contacts`,
+      CursorPage<UsersContactsAPI.ContactList.Data>,
+      {
+        query,
+        ...options,
+        headers: buildHeaders([
+          {
+            ...(featurebaseVersion?.toString() != null ?
+              { 'Featurebase-Version': featurebaseVersion?.toString() }
+            : undefined),
+          },
+          options?.headers,
+        ]),
+      },
+    );
   }
 
   /**
@@ -164,7 +176,11 @@ export class Contacts extends APIResource {
       body,
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -227,7 +243,11 @@ export class Contacts extends APIResource {
     return this._client.delete(path`/v2/companies/${id}/contacts/${contactID}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -244,24 +264,12 @@ export type ContactAttachResponse = UsersContactsAPI.Contact | (null & {});
  */
 export type ContactRemoveResponse = UsersContactsAPI.Contact | (null & {});
 
-export interface ContactListParams {
-  /**
-   * 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: A limit on the number of contacts to be returned, between 1
-   * and 100.
-   */
-  limit?: number;
-
+export interface ContactListParams extends CursorPageParams {
   /**
    * 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 ContactAttachParams {
@@ -275,7 +283,7 @@ export interface ContactAttachParams {
    * 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 ContactRemoveParams {
@@ -288,7 +296,7 @@ export interface ContactRemoveParams {
    * 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 Contacts {
@@ -300,3 +308,5 @@ export declare namespace Contacts {
     type ContactRemoveParams as ContactRemoveParams,
   };
 }
+
+export { type ContactListDataCursorPage };

package/src/resources/users/companies/index.ts

@@ -4,12 +4,12 @@ export {
   Companies,
   type Company,
   type DeletedCompany,
-  type CompanyListResponse,
   type CompanyRetrieveParams,
   type CompanyListParams,
   type CompanyDeleteParams,
   type CompanyCreateOrUpdateParams,
   type CompanyDeleteByCompanyIDParams,
+  type CompaniesCursorPage,
 } from './companies';
 export {
   Contacts,

package/src/resources/users/contacts/by-user-id/by-user-id.ts

@@ -89,7 +89,11 @@ export class ByUserID extends APIResource {
     return this._client.get(path`/v2/contacts/by-user-id/${userID}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -156,7 +160,11 @@ export class ByUserID extends APIResource {
     return this._client.delete(path`/v2/contacts/by-user-id/${userID}`, {
       ...options,
       headers: buildHeaders([
-        { ...(featurebaseVersion != null ? { 'Featurebase-Version': featurebaseVersion } : undefined) },
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
         options?.headers,
       ]),
     });
@@ -173,7 +181,7 @@ export interface ByUserIDRetrieveParams {
    * 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 ByUserIDDeleteParams {
@@ -181,7 +189,7 @@ export interface ByUserIDDeleteParams {
    * 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';
 }
 
 ByUserID.EmailPreferences = EmailPreferences;