featurebase-node 0.14.3 → 0.15.0

package/src/resources/changelogs/changelogs.ts

@@ -21,84 +21,6 @@ import { path } from '../../internal/utils/path';
 export class Changelogs extends APIResource {
   subscribers: SubscribersAPI.Subscribers = new SubscribersAPI.Subscribers(this._client);
 
-  /**
-   * Returns all changelogs for the authenticated organization.
-   *
-   * Changelogs are release notes and updates that keep users informed about new
-   * features, improvements, and bug fixes. Each changelog can have:
-   *
-   * - Multiple translations (locales)
-   * - Categories for organization
-   * - Featured images
-   * - Scheduled publishing
-   *
-   * ### Pagination
-   *
-   * This endpoint uses **cursor-based pagination**:
-   *
-   * - `limit` - Number of changelogs 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/changelogs?limit=10`
-   * 2. If `nextCursor` is not null, use it for the next page
-   * 3. Next request: `GET /v2/changelogs?limit=10&cursor={nextCursor}`
-   *
-   * ### Response Format
-   *
-   * Returns a list object with:
-   *
-   * - `object` - Always "list"
-   * - `data` - Array of changelog objects
-   * - `nextCursor` - Cursor for the next page (null if no more results)
-   *
-   * ### Filtering
-   *
-   * Filter changelogs using query parameters:
-   *
-   * - `id` - Find a specific changelog by ID or slug
-   * - `q` - Search query for title/content
-   * - `categories` - Filter by category names
-   * - `locale` - Get changelogs in a specific locale (defaults to org default)
-   * - `state` - Filter by state: `live`, `draft`, or `all`
-   * - `startDate` - Include changelogs dated on or after this date
-   * - `endDate` - Include changelogs dated on or before this date
-   *
-   * ### Sorting
-   *
-   * Results are sorted by date (descending by default):
-   *
-   * - `sortBy` - Field to sort by (currently only `date`)
-   * - `sortOrder` - Sort direction: `asc` or `desc` (default: `desc`)
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const changelog of client.changelogs.list()) {
-   *   // ...
-   * }
-   * ```
-   */
-  list(
-    params: ChangelogListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<ChangelogsCursorPage, Changelog> {
-    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.getAPIList('/v2/changelogs', CursorPage<Changelog>, {
-      query,
-      ...options,
-      headers: buildHeaders([
-        {
-          ...(featurebaseVersion?.toString() != null ?
-            { 'Featurebase-Version': featurebaseVersion?.toString() }
-          : undefined),
-        },
-        options?.headers,
-      ]),
-    });
-  }
-
   /**
    * Creates a new changelog for the authenticated organization.
    *
@@ -269,6 +191,84 @@ export class Changelogs extends APIResource {
     });
   }
 
+  /**
+   * Returns all changelogs for the authenticated organization.
+   *
+   * Changelogs are release notes and updates that keep users informed about new
+   * features, improvements, and bug fixes. Each changelog can have:
+   *
+   * - Multiple translations (locales)
+   * - Categories for organization
+   * - Featured images
+   * - Scheduled publishing
+   *
+   * ### Pagination
+   *
+   * This endpoint uses **cursor-based pagination**:
+   *
+   * - `limit` - Number of changelogs 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/changelogs?limit=10`
+   * 2. If `nextCursor` is not null, use it for the next page
+   * 3. Next request: `GET /v2/changelogs?limit=10&cursor={nextCursor}`
+   *
+   * ### Response Format
+   *
+   * Returns a list object with:
+   *
+   * - `object` - Always "list"
+   * - `data` - Array of changelog objects
+   * - `nextCursor` - Cursor for the next page (null if no more results)
+   *
+   * ### Filtering
+   *
+   * Filter changelogs using query parameters:
+   *
+   * - `id` - Find a specific changelog by ID or slug
+   * - `q` - Search query for title/content
+   * - `categories` - Filter by category names
+   * - `locale` - Get changelogs in a specific locale (defaults to org default)
+   * - `state` - Filter by state: `live`, `draft`, or `all`
+   * - `startDate` - Include changelogs dated on or after this date
+   * - `endDate` - Include changelogs dated on or before this date
+   *
+   * ### Sorting
+   *
+   * Results are sorted by date (descending by default):
+   *
+   * - `sortBy` - Field to sort by (currently only `date`)
+   * - `sortOrder` - Sort direction: `asc` or `desc` (default: `desc`)
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const changelog of client.changelogs.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: ChangelogListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<ChangelogsCursorPage, Changelog> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+    return this._client.getAPIList('/v2/changelogs', CursorPage<Changelog>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Deletes a changelog by its unique identifier.
    *
@@ -530,6 +530,35 @@ export interface Changelog {
    * Locale of the changelog
    */
   locale:
+    | 'ar'
+    | 'am'
+    | 'fa'
+    | 'ht'
+    | 'lo'
+    | 'my'
+    | 'pa'
+    | 'ps'
+    | 'so'
+    | 'tl'
+    | 'ur'
+    | 'he'
+    | 'ta'
+    | 'te'
+    | 'mr'
+    | 'gu'
+    | 'kn'
+    | 'ml'
+    | 'ha'
+    | 'jv'
+    | 'yo'
+    | 'ig'
+    | 'uz'
+    | 'ne'
+    | 'sd'
+    | 'az'
+    | 'si'
+    | 'km'
+    | 'kk'
     | 'bn'
     | 'bs'
     | 'pt-BR'
@@ -699,27 +728,76 @@ export interface ChangelogDeleteResponse {
   object: 'changelog';
 }
 
-export interface ChangelogListParams extends CursorPageParams {
+export interface ChangelogCreateParams {
   /**
-   * Query param: Find changelog by its id (also accepts slug)
+   * Body param: The title of the changelog
    */
-  id?: string;
+  title: string;
 
   /**
-   * Query param: Filter changelogs by category names (single value or array)
+   * Body param: An array of segment IDs that are allowed to view the changelog
    */
-  categories?: string | Array<string>;
+  allowedSegmentIds?: Array<string>;
 
   /**
-   * Query param: Include Changelogs dated on or before the specified end date
+   * Body param: An array of category names to which the changelog belongs
    */
-  endDate?: string | null;
+  categories?: Array<string>;
 
   /**
-   * Query param: The locale of the changelogs. Defaults to the organization default
-   * locale.
+   * Body param: The date of the changelog
+   */
+  date?: string | null;
+
+  /**
+   * Body param: The URL of the featured image for the changelog. External URLs will
+   * be uploaded to our storage.
+   */
+  featuredImage?: string;
+
+  /**
+   * Body param: HTML content of the changelog. Provide either htmlContent or
+   * markdownContent. Supports Featurebase custom blocks (callouts, multi-code,
+   * accordions, columns, file/image/video, iframes) — see the **Content Components**
+   * guide. External image URLs and base64 data URIs are uploaded to our storage
+   * automatically.
+   */
+  htmlContent?: string;
+
+  /**
+   * Body param: The locale of the changelog, defaulting to the organization default
+   * locale
    */
   locale?:
+    | 'ar'
+    | 'am'
+    | 'fa'
+    | 'ht'
+    | 'lo'
+    | 'my'
+    | 'pa'
+    | 'ps'
+    | 'so'
+    | 'tl'
+    | 'ur'
+    | 'he'
+    | 'ta'
+    | 'te'
+    | 'mr'
+    | 'gu'
+    | 'kn'
+    | 'ml'
+    | 'ha'
+    | 'jv'
+    | 'yo'
+    | 'ig'
+    | 'uz'
+    | 'ne'
+    | 'sd'
+    | 'az'
+    | 'si'
+    | 'km'
+    | 'kk'
     | 'bn'
     | 'bs'
     | 'pt-BR'
@@ -764,44 +842,34 @@ export interface ChangelogListParams extends CursorPageParams {
     | 'vi';
 
   /**
-   * Query param: Search for changelogs by title or content
-   */
-  q?: string;
-
-  /**
-   * Query param: Field to sort by
-   */
-  sortBy?: 'date';
-
-  /**
-   * Query param: Sort direction
-   */
-  sortOrder?: 'asc' | 'desc';
-
-  /**
-   * Query param: Include Changelogs dated on or after the specified start date
+   * Body param: Markdown content of the changelog (CommonMark + GFM). Provide either
+   * htmlContent or markdownContent. Markdown is converted to plain HTML — to use
+   * Featurebase custom blocks (callouts, multi-code, accordions, columns) send
+   * htmlContent instead. See the **Content Components** guide.
    */
-  startDate?: string | null;
+  markdownContent?: string;
 
   /**
-   * Query param: The state of the changelog. Use "all" to get both draft and live
-   * changelogs.
+   * Body param: The state of the changelog (draft or live)
    */
-  state?: 'draft' | 'live' | 'all';
+  state?: 'draft' | 'live';
 
   /**
    * 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 ChangelogCreateParams {
+export interface ChangelogRetrieveParams {
   /**
-   * Body param: The title of the changelog
+   * API version for this request. Defaults to your organization's configured API
+   * version if not specified.
    */
-  title: string;
+  'Featurebase-Version'?: '2026-08-19.orbit' | '2026-01-01.nova' | '2025-12-12.clover';
+}
 
+export interface ChangelogUpdateParams {
   /**
    * Body param: An array of segment IDs that are allowed to view the changelog
    */
@@ -833,10 +901,75 @@ export interface ChangelogCreateParams {
   htmlContent?: string;
 
   /**
-   * Body param: The locale of the changelog, defaulting to the organization default
-   * locale
+   * Body param: Markdown content of the changelog (CommonMark + GFM). Provide either
+   * htmlContent or markdownContent. Markdown is converted to plain HTML — to use
+   * Featurebase custom blocks (callouts, multi-code, accordions, columns) send
+   * htmlContent instead. See the **Content Components** guide.
+   */
+  markdownContent?: string;
+
+  /**
+   * Body param: The title of the changelog
+   */
+  title?: 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 ChangelogListParams extends CursorPageParams {
+  /**
+   * Query param: Find changelog by its id (also accepts slug)
+   */
+  id?: string;
+
+  /**
+   * Query param: Filter changelogs by category names (single value or array)
+   */
+  categories?: string | Array<string>;
+
+  /**
+   * Query param: Include Changelogs dated on or before the specified end date
+   */
+  endDate?: string | null;
+
+  /**
+   * Query param: The locale of the changelogs. Defaults to the organization default
+   * locale.
    */
   locale?:
+    | 'ar'
+    | 'am'
+    | 'fa'
+    | 'ht'
+    | 'lo'
+    | 'my'
+    | 'pa'
+    | 'ps'
+    | 'so'
+    | 'tl'
+    | 'ur'
+    | 'he'
+    | 'ta'
+    | 'te'
+    | 'mr'
+    | 'gu'
+    | 'kn'
+    | 'ml'
+    | 'ha'
+    | 'jv'
+    | 'yo'
+    | 'ig'
+    | 'uz'
+    | 'ne'
+    | 'sd'
+    | 'az'
+    | 'si'
+    | 'km'
+    | 'kk'
     | 'bn'
     | 'bs'
     | 'pt-BR'
@@ -881,82 +1014,36 @@ export interface ChangelogCreateParams {
     | 'vi';
 
   /**
-   * Body param: Markdown content of the changelog (CommonMark + GFM). Provide either
-   * htmlContent or markdownContent. Markdown is converted to plain HTML — to use
-   * Featurebase custom blocks (callouts, multi-code, accordions, columns) send
-   * htmlContent instead. See the **Content Components** guide.
-   */
-  markdownContent?: string;
-
-  /**
-   * Body param: The state of the changelog (draft or live)
-   */
-  state?: 'draft' | 'live';
-
-  /**
-   * 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 ChangelogRetrieveParams {
-  /**
-   * 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 ChangelogUpdateParams {
-  /**
-   * Body param: An array of segment IDs that are allowed to view the changelog
-   */
-  allowedSegmentIds?: Array<string>;
-
-  /**
-   * Body param: An array of category names to which the changelog belongs
-   */
-  categories?: Array<string>;
-
-  /**
-   * Body param: The date of the changelog
+   * Query param: Search for changelogs by title or content
    */
-  date?: string | null;
+  q?: string;
 
   /**
-   * Body param: The URL of the featured image for the changelog. External URLs will
-   * be uploaded to our storage.
+   * Query param: Field to sort by
    */
-  featuredImage?: string;
+  sortBy?: 'date';
 
   /**
-   * Body param: HTML content of the changelog. Provide either htmlContent or
-   * markdownContent. Supports Featurebase custom blocks (callouts, multi-code,
-   * accordions, columns, file/image/video, iframes) — see the **Content Components**
-   * guide. External image URLs and base64 data URIs are uploaded to our storage
-   * automatically.
+   * Query param: Sort direction
    */
-  htmlContent?: string;
+  sortOrder?: 'asc' | 'desc';
 
   /**
-   * Body param: Markdown content of the changelog (CommonMark + GFM). Provide either
-   * htmlContent or markdownContent. Markdown is converted to plain HTML — to use
-   * Featurebase custom blocks (callouts, multi-code, accordions, columns) send
-   * htmlContent instead. See the **Content Components** guide.
+   * Query param: Include Changelogs dated on or after the specified start date
    */
-  markdownContent?: string;
+  startDate?: string | null;
 
   /**
-   * Body param: The title of the changelog
+   * Query param: The state of the changelog. Use "all" to get both draft and live
+   * changelogs.
    */
-  title?: string;
+  state?: 'draft' | 'live' | 'all';
 
   /**
    * 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 ChangelogDeleteParams {
@@ -964,7 +1051,7 @@ export interface ChangelogDeleteParams {
    * 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 ChangelogPublishParams {
@@ -973,6 +1060,35 @@ export interface ChangelogPublishParams {
    * publishes to all locales.
    */
   locales?: Array<
+    | 'ar'
+    | 'am'
+    | 'fa'
+    | 'ht'
+    | 'lo'
+    | 'my'
+    | 'pa'
+    | 'ps'
+    | 'so'
+    | 'tl'
+    | 'ur'
+    | 'he'
+    | 'ta'
+    | 'te'
+    | 'mr'
+    | 'gu'
+    | 'kn'
+    | 'ml'
+    | 'ha'
+    | 'jv'
+    | 'yo'
+    | 'ig'
+    | 'uz'
+    | 'ne'
+    | 'sd'
+    | 'az'
+    | 'si'
+    | 'km'
+    | 'kk'
     | 'bn'
     | 'bs'
     | 'pt-BR'
@@ -1033,7 +1149,7 @@ export interface ChangelogPublishParams {
    * 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 ChangelogUnpublishParams {
@@ -1042,6 +1158,35 @@ export interface ChangelogUnpublishParams {
    * unpublishes from all locales.
    */
   locales?: Array<
+    | 'ar'
+    | 'am'
+    | 'fa'
+    | 'ht'
+    | 'lo'
+    | 'my'
+    | 'pa'
+    | 'ps'
+    | 'so'
+    | 'tl'
+    | 'ur'
+    | 'he'
+    | 'ta'
+    | 'te'
+    | 'mr'
+    | 'gu'
+    | 'kn'
+    | 'ml'
+    | 'ha'
+    | 'jv'
+    | 'yo'
+    | 'ig'
+    | 'uz'
+    | 'ne'
+    | 'sd'
+    | 'az'
+    | 'si'
+    | 'km'
+    | 'kk'
     | 'bn'
     | 'bs'
     | 'pt-BR'
@@ -1090,7 +1235,7 @@ export interface ChangelogUnpublishParams {
    * 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';
 }
 
 Changelogs.Subscribers = Subscribers;
@@ -1101,10 +1246,10 @@ export declare namespace Changelogs {
     type PublishUnpublishSuccess as PublishUnpublishSuccess,
     type ChangelogDeleteResponse as ChangelogDeleteResponse,
     type ChangelogsCursorPage as ChangelogsCursorPage,
-    type ChangelogListParams as ChangelogListParams,
     type ChangelogCreateParams as ChangelogCreateParams,
     type ChangelogRetrieveParams as ChangelogRetrieveParams,
     type ChangelogUpdateParams as ChangelogUpdateParams,
+    type ChangelogListParams as ChangelogListParams,
     type ChangelogDeleteParams as ChangelogDeleteParams,
     type ChangelogPublishParams as ChangelogPublishParams,
     type ChangelogUnpublishParams as ChangelogUnpublishParams,

package/src/resources/changelogs/index.ts

@@ -5,10 +5,10 @@ export {
   type Changelog,
   type PublishUnpublishSuccess,
   type ChangelogDeleteResponse,
-  type ChangelogListParams,
   type ChangelogCreateParams,
   type ChangelogRetrieveParams,
   type ChangelogUpdateParams,
+  type ChangelogListParams,
   type ChangelogDeleteParams,
   type ChangelogPublishParams,
   type ChangelogUnpublishParams,

package/src/resources/changelogs/subscribers.ts

@@ -161,6 +161,35 @@ export interface SubscriberAddParams {
    * locale.
    */
   locale?:
+    | 'ar'
+    | 'am'
+    | 'fa'
+    | 'ht'
+    | 'lo'
+    | 'my'
+    | 'pa'
+    | 'ps'
+    | 'so'
+    | 'tl'
+    | 'ur'
+    | 'he'
+    | 'ta'
+    | 'te'
+    | 'mr'
+    | 'gu'
+    | 'kn'
+    | 'ml'
+    | 'ha'
+    | 'jv'
+    | 'yo'
+    | 'ig'
+    | 'uz'
+    | 'ne'
+    | 'sd'
+    | 'az'
+    | 'si'
+    | 'km'
+    | 'kk'
     | 'bn'
     | 'bs'
     | 'pt-BR'
@@ -208,7 +237,7 @@ export interface SubscriberAddParams {
    * 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 SubscriberRemoveParams {
@@ -221,7 +250,7 @@ export interface SubscriberRemoveParams {
    * 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 Subscribers {