featurebase-node 0.14.2 → 0.15.0

package/src/resources/help-center/redirect-rules.ts

@@ -11,69 +11,6 @@ import { path } from '../../internal/utils/path';
  * Help centers allow organizations to create and manage knowledge bases with articles and collections. Currently, Featurebase supports one help center per organization.
  */
 export class RedirectRules extends APIResource {
-  /**
-   * Returns a paginated list of redirect rules within your organization.
-   *
-   * Redirect rules map old Help Center URLs to new article or collection
-   * destinations, enabling seamless migration from legacy help center systems. Only
-   * Help Centers with a custom domain configured support redirect rules.
-   *
-   * ### Query Parameters
-   *
-   * - `limit` - Number of items to return (1-100, default 10)
-   * - `cursor` - Cursor for pagination
-   * - `helpCenterId` - Filter by help center ID
-   * - `locale` - Filter by locale code
-   * - `targetType` - Filter by target type ("article" or "collection")
-   *
-   * ### Response Format
-   *
-   * Returns a list object with:
-   *
-   * - `object` - Always "list"
-   * - `data` - Array of redirect rule objects
-   * - `nextCursor` - Cursor for next page (null if no more results)
-   *
-   * ### Redirect Rule Object
-   *
-   * Each redirect rule includes:
-   *
-   * - `id` - Unique identifier (MongoDB ObjectId)
-   * - `helpCenterId` - Help center this rule belongs to
-   * - `locale` - Locale code used to resolve the target translation
-   * - `fromUrl` - Canonical source URL (query/hash stripped, hostname lowercased)
-   * - `targetType` - "article" or "collection"
-   * - `targetId` - ID of the target article or collection
-   * - `createdAt` - ISO 8601 timestamp when created
-   * - `updatedAt` - ISO 8601 timestamp when last updated
-   *
-   * @example
-   * ```ts
-   * // Automatically fetches more pages as needed.
-   * for await (const redirectRule of client.helpCenter.redirectRules.list()) {
-   *   // ...
-   * }
-   * ```
-   */
-  list(
-    params: RedirectRuleListParams | null | undefined = {},
-    options?: RequestOptions,
-  ): PagePromise<RedirectRulesCursorPage, RedirectRule> {
-    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
-    return this._client.getAPIList('/v2/help_center/redirect_rules', CursorPage<RedirectRule>, {
-      query,
-      ...options,
-      headers: buildHeaders([
-        {
-          ...(featurebaseVersion?.toString() != null ?
-            { 'Featurebase-Version': featurebaseVersion?.toString() }
-          : undefined),
-        },
-        options?.headers,
-      ]),
-    });
-  }
-
   /**
    * Creates a new redirect rule in your organization.
    *
@@ -133,60 +70,6 @@ export class RedirectRules extends APIResource {
     });
   }
 
-  /**
-   * Retrieves a specific redirect rule by its source URL.
-   *
-   * The `url` query parameter is normalized before matching: query parameters and
-   * hash fragments are stripped, the hostname is lowercased, and trailing slashes
-   * are removed. This is the same normalization applied when creating a redirect
-   * rule.
-   *
-   * ### Query Parameters
-   *
-   * - `url` (required) - Full absolute URL to look up (http or https)
-   *
-   * ### Response
-   *
-   * Returns a redirect rule object with:
-   *
-   * - `id` - Unique identifier (MongoDB ObjectId)
-   * - `helpCenterId` - Help center this rule belongs to
-   * - `locale` - Locale code
-   * - `fromUrl` - Canonical source URL being redirected from
-   * - `targetType` - "article" or "collection"
-   * - `targetId` - ID of the target article or collection
-   * - `createdAt` - ISO 8601 timestamp when created
-   * - `updatedAt` - ISO 8601 timestamp when last updated
-   *
-   * ### Errors
-   *
-   * - `400` - Invalid URL format
-   * - `404` - No redirect rule exists for the given URL
-   *
-   * @example
-   * ```ts
-   * const redirectRule =
-   *   await client.helpCenter.redirectRules.retrieveByURL({
-   *     url: 'https://help.example.com/en/old/getting-started',
-   *   });
-   * ```
-   */
-  retrieveByURL(params: RedirectRuleRetrieveByURLParams, options?: RequestOptions): APIPromise<RedirectRule> {
-    const { 'Featurebase-Version': featurebaseVersion, ...query } = params;
-    return this._client.get('/v2/help_center/redirect_rules/by-url', {
-      query,
-      ...options,
-      headers: buildHeaders([
-        {
-          ...(featurebaseVersion?.toString() != null ?
-            { 'Featurebase-Version': featurebaseVersion?.toString() }
-          : undefined),
-        },
-        options?.headers,
-      ]),
-    });
-  }
-
   /**
    * Retrieves a specific redirect rule by its unique identifier.
    *
@@ -290,6 +173,69 @@ export class RedirectRules extends APIResource {
     });
   }
 
+  /**
+   * Returns a paginated list of redirect rules within your organization.
+   *
+   * Redirect rules map old Help Center URLs to new article or collection
+   * destinations, enabling seamless migration from legacy help center systems. Only
+   * Help Centers with a custom domain configured support redirect rules.
+   *
+   * ### Query Parameters
+   *
+   * - `limit` - Number of items to return (1-100, default 10)
+   * - `cursor` - Cursor for pagination
+   * - `helpCenterId` - Filter by help center ID
+   * - `locale` - Filter by locale code
+   * - `targetType` - Filter by target type ("article" or "collection")
+   *
+   * ### Response Format
+   *
+   * Returns a list object with:
+   *
+   * - `object` - Always "list"
+   * - `data` - Array of redirect rule objects
+   * - `nextCursor` - Cursor for next page (null if no more results)
+   *
+   * ### Redirect Rule Object
+   *
+   * Each redirect rule includes:
+   *
+   * - `id` - Unique identifier (MongoDB ObjectId)
+   * - `helpCenterId` - Help center this rule belongs to
+   * - `locale` - Locale code used to resolve the target translation
+   * - `fromUrl` - Canonical source URL (query/hash stripped, hostname lowercased)
+   * - `targetType` - "article" or "collection"
+   * - `targetId` - ID of the target article or collection
+   * - `createdAt` - ISO 8601 timestamp when created
+   * - `updatedAt` - ISO 8601 timestamp when last updated
+   *
+   * @example
+   * ```ts
+   * // Automatically fetches more pages as needed.
+   * for await (const redirectRule of client.helpCenter.redirectRules.list()) {
+   *   // ...
+   * }
+   * ```
+   */
+  list(
+    params: RedirectRuleListParams | null | undefined = {},
+    options?: RequestOptions,
+  ): PagePromise<RedirectRulesCursorPage, RedirectRule> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params ?? {};
+    return this._client.getAPIList('/v2/help_center/redirect_rules', CursorPage<RedirectRule>, {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
+
   /**
    * Deletes an existing redirect rule. The associated Redis cache entry is also
    * invalidated.
@@ -336,6 +282,60 @@ export class RedirectRules extends APIResource {
       ]),
     });
   }
+
+  /**
+   * Retrieves a specific redirect rule by its source URL.
+   *
+   * The `url` query parameter is normalized before matching: query parameters and
+   * hash fragments are stripped, the hostname is lowercased, and trailing slashes
+   * are removed. This is the same normalization applied when creating a redirect
+   * rule.
+   *
+   * ### Query Parameters
+   *
+   * - `url` (required) - Full absolute URL to look up (http or https)
+   *
+   * ### Response
+   *
+   * Returns a redirect rule object with:
+   *
+   * - `id` - Unique identifier (MongoDB ObjectId)
+   * - `helpCenterId` - Help center this rule belongs to
+   * - `locale` - Locale code
+   * - `fromUrl` - Canonical source URL being redirected from
+   * - `targetType` - "article" or "collection"
+   * - `targetId` - ID of the target article or collection
+   * - `createdAt` - ISO 8601 timestamp when created
+   * - `updatedAt` - ISO 8601 timestamp when last updated
+   *
+   * ### Errors
+   *
+   * - `400` - Invalid URL format
+   * - `404` - No redirect rule exists for the given URL
+   *
+   * @example
+   * ```ts
+   * const redirectRule =
+   *   await client.helpCenter.redirectRules.retrieveByURL({
+   *     url: 'https://help.example.com/en/old/getting-started',
+   *   });
+   * ```
+   */
+  retrieveByURL(params: RedirectRuleRetrieveByURLParams, options?: RequestOptions): APIPromise<RedirectRule> {
+    const { 'Featurebase-Version': featurebaseVersion, ...query } = params;
+    return this._client.get('/v2/help_center/redirect_rules/by-url', {
+      query,
+      ...options,
+      headers: buildHeaders([
+        {
+          ...(featurebaseVersion?.toString() != null ?
+            { 'Featurebase-Version': featurebaseVersion?.toString() }
+          : undefined),
+        },
+        options?.headers,
+      ]),
+    });
+  }
 }
 
 export type RedirectRulesCursorPage = CursorPage<RedirectRule>;
@@ -365,6 +365,35 @@ export interface RedirectRule {
    * Locale code for the redirect rule
    */
   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'
@@ -446,16 +475,53 @@ export interface RedirectRuleDeleteResponse {
   object: 'redirect_rule';
 }
 
-export interface RedirectRuleListParams extends CursorPageParams {
+export interface RedirectRuleCreateParams {
   /**
-   * Query param: Filter redirect rules by help center ID
+   * Body param: Full absolute URL to redirect from. Must use http or https protocol.
+   * Query parameters and hash fragments are stripped during normalization. The
+   * hostname must match the Help Center custom domain.
    */
-  helpCenterId?: string;
+  fromUrl: string;
 
   /**
-   * Query param: Filter redirect rules by locale
+   * Body param: Help center identifier this redirect rule belongs to
    */
-  locale?:
+  helpCenterId: string;
+
+  /**
+   * Body param: Locale code for the redirect rule. Used to resolve the target
+   * article/collection translation.
+   */
+  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'
@@ -500,35 +566,76 @@ export interface RedirectRuleListParams extends CursorPageParams {
     | 'vi';
 
   /**
-   * Query param: Filter redirect rules by target type
+   * Body param: ID of the target article or collection
    */
-  targetType?: 'article' | 'collection';
+  targetId: string;
+
+  /**
+   * Body param: Type of content the redirect points to
+   */
+  targetType: 'article' | 'collection';
 
   /**
    * 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 RedirectRuleCreateParams {
+export interface RedirectRuleRetrieveParams {
+  /**
+   * 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 RedirectRuleUpdateParams {
   /**
    * Body param: Full absolute URL to redirect from. Must use http or https protocol.
    * Query parameters and hash fragments are stripped during normalization. The
    * hostname must match the Help Center custom domain.
    */
-  fromUrl: string;
+  fromUrl?: string;
 
   /**
-   * Body param: Help center identifier this redirect rule belongs to
+   * Body param: Help center identifier
    */
-  helpCenterId: string;
+  helpCenterId?: string;
 
   /**
-   * Body param: Locale code for the redirect rule. Used to resolve the target
-   * article/collection translation.
+   * Body param: Locale code for the redirect rule
    */
-  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'
@@ -575,60 +682,59 @@ export interface RedirectRuleCreateParams {
   /**
    * Body param: ID of the target article or collection
    */
-  targetId: string;
+  targetId?: string;
 
   /**
    * Body param: Type of content the redirect points to
    */
-  targetType: 'article' | 'collection';
-
-  /**
-   * 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 RedirectRuleRetrieveByURLParams {
-  /**
-   * Query param: Full absolute URL to look up. The URL is normalized before
-   * matching: query parameters and hash fragments are stripped, the hostname is
-   * lowercased, and trailing slashes are removed.
-   */
-  url: string;
+  targetType?: 'article' | 'collection';
 
   /**
    * 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 RedirectRuleRetrieveParams {
-  /**
-   * 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 RedirectRuleUpdateParams {
-  /**
-   * Body param: Full absolute URL to redirect from. Must use http or https protocol.
-   * Query parameters and hash fragments are stripped during normalization. The
-   * hostname must match the Help Center custom domain.
-   */
-  fromUrl?: string;
-
+export interface RedirectRuleListParams extends CursorPageParams {
   /**
-   * Body param: Help center identifier
+   * Query param: Filter redirect rules by help center ID
    */
   helpCenterId?: string;
 
   /**
-   * Body param: Locale code for the redirect rule
+   * Query param: Filter redirect rules by 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'
@@ -673,12 +779,7 @@ export interface RedirectRuleUpdateParams {
     | 'vi';
 
   /**
-   * Body param: ID of the target article or collection
-   */
-  targetId?: string;
-
-  /**
-   * Body param: Type of content the redirect points to
+   * Query param: Filter redirect rules by target type
    */
   targetType?: 'article' | 'collection';
 
@@ -686,7 +787,7 @@ export interface RedirectRuleUpdateParams {
    * 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 RedirectRuleDeleteParams {
@@ -694,7 +795,22 @@ export interface RedirectRuleDeleteParams {
    * 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 RedirectRuleRetrieveByURLParams {
+  /**
+   * Query param: Full absolute URL to look up. The URL is normalized before
+   * matching: query parameters and hash fragments are stripped, the hostname is
+   * lowercased, and trailing slashes are removed.
+   */
+  url: 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 declare namespace RedirectRules {
@@ -702,11 +818,11 @@ export declare namespace RedirectRules {
     type RedirectRule as RedirectRule,
     type RedirectRuleDeleteResponse as RedirectRuleDeleteResponse,
     type RedirectRulesCursorPage as RedirectRulesCursorPage,
-    type RedirectRuleListParams as RedirectRuleListParams,
     type RedirectRuleCreateParams as RedirectRuleCreateParams,
-    type RedirectRuleRetrieveByURLParams as RedirectRuleRetrieveByURLParams,
     type RedirectRuleRetrieveParams as RedirectRuleRetrieveParams,
     type RedirectRuleUpdateParams as RedirectRuleUpdateParams,
+    type RedirectRuleListParams as RedirectRuleListParams,
     type RedirectRuleDeleteParams as RedirectRuleDeleteParams,
+    type RedirectRuleRetrieveByURLParams as RedirectRuleRetrieveByURLParams,
   };
 }

package/src/resources/index.ts

@@ -11,10 +11,10 @@ export {
   type Changelog,
   type PublishUnpublishSuccess,
   type ChangelogDeleteResponse,
-  type ChangelogListParams,
   type ChangelogCreateParams,
   type ChangelogRetrieveParams,
   type ChangelogUpdateParams,
+  type ChangelogListParams,
   type ChangelogDeleteParams,
   type ChangelogPublishParams,
   type ChangelogUnpublishParams,
@@ -25,8 +25,8 @@ export {
   type ConversationAttribute,
   type ConversationAttributeOption,
   type ConversationAttributeListResponse,
-  type ConversationAttributeListParams,
   type ConversationAttributeRetrieveParams,
+  type ConversationAttributeListParams,
 } from './conversation-attributes';
 export { Feedback } from './feedback/feedback';
 export { HelpCenter } from './help-center/help-center';
@@ -46,10 +46,10 @@ export {
   type ReportListDatasetsResponse,
   type ReportLookupFilterValuesResponse,
   type ReportQueryResponse,
+  type ReportDrillInParams,
   type ReportListDatasetsParams,
-  type ReportQueryParams,
   type ReportLookupFilterValuesParams,
-  type ReportDrillInParams,
+  type ReportQueryParams,
 } from './reports';
 export { Support } from './support/support';
 export {
@@ -57,8 +57,8 @@ export {
   type Survey,
   type SurveyNextAction,
   type SurveyListResponsesResponse,
-  type SurveyListParams,
   type SurveyRetrieveParams,
+  type SurveyListParams,
   type SurveyListResponsesParams,
   type SurveysCursorPage,
   type SurveyListResponsesResponsesCursorPage,
@@ -69,10 +69,10 @@ export {
   type Webhook,
   type WebhookRequestConfigInput,
   type WebhookDeleteResponse,
-  type WebhookListParams,
   type WebhookCreateParams,
   type WebhookRetrieveParams,
   type WebhookUpdateParams,
+  type WebhookListParams,
   type WebhookDeleteParams,
   type WebhookRefreshSecretParams,
   type WebhooksCursorPage,