magicbell-js 1.2.0 → 1.4.0

package/src/user-client/services/channels/channels-service.ts

@@ -41,6 +41,7 @@ import {
   teamsTokenPayloadRequest,
   teamsTokenPayloadResponse,
 } from './models/teams-token-payload.js';
+import { UserPreferences, userPreferencesRequest, userPreferencesResponse } from './models/user-preferences.js';
 import { WebPushToken, webPushTokenResponse } from './models/web-push-token.js';
 import { WebPushTokenCollection, webPushTokenCollectionResponse } from './models/web-push-token-collection.js';
 import {
@@ -48,6 +49,7 @@ import {
   ListExpoTokensParams,
   ListFcmTokensParams,
   ListInboxTokensParams,
+  ListMagicbellSlackbotTokensParams,
   ListSlackTokensParams,
   ListTeamsTokensParams,
   ListWebPushTokensParams,
@@ -59,8 +61,8 @@ export class ChannelsService extends BaseService {
    * @param {number} [params.limit] -
    * @param {string} [params.startingAfter] -
    * @param {string} [params.endingBefore] -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<InboxTokenResponseCollection>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<InboxTokenResponseCollection>>} - OK
    */
   async listInboxTokens(
     params?: ListInboxTokensParams,
@@ -100,8 +102,8 @@ export class ChannelsService extends BaseService {
 
   /**
    * Saves the Inbox token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<InboxToken>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<InboxToken>>} - OK
    */
   async saveInboxToken(body: InboxToken, requestConfig?: RequestConfig): Promise<HttpResponse<InboxToken>> {
     const request = new RequestBuilder()
@@ -129,8 +131,8 @@ export class ChannelsService extends BaseService {
   /**
    * Fetches details of a specific Inbox token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<InboxTokenResponse>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<InboxTokenResponse>>} - OK
    */
   async fetchInboxToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<InboxTokenResponse>> {
     const request = new RequestBuilder()
@@ -160,8 +162,8 @@ export class ChannelsService extends BaseService {
   /**
    * Deletes one of the authenticated user's Inbox tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<DiscardResult>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
    */
   async deleteInboxToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<DiscardResult>> {
     const request = new RequestBuilder()
@@ -193,8 +195,8 @@ export class ChannelsService extends BaseService {
    * @param {number} [params.limit] -
    * @param {string} [params.startingAfter] -
    * @param {string} [params.endingBefore] -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<ApnsTokenCollection>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<ApnsTokenCollection>>} - OK
    */
   async listApnsTokens(
     params?: ListApnsTokensParams,
@@ -234,8 +236,8 @@ export class ChannelsService extends BaseService {
 
   /**
    * Saves the APNs token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<ApnsTokenPayload>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<ApnsTokenPayload>>} - OK
    */
   async saveApnsToken(body: ApnsTokenPayload, requestConfig?: RequestConfig): Promise<HttpResponse<ApnsTokenPayload>> {
     const request = new RequestBuilder()
@@ -263,8 +265,8 @@ export class ChannelsService extends BaseService {
   /**
    * Fetches details of a specific APNs token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<ApnsToken>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<ApnsToken>>} - OK
    */
   async fetchApnsToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<ApnsToken>> {
     const request = new RequestBuilder()
@@ -294,8 +296,8 @@ export class ChannelsService extends BaseService {
   /**
    * Deletes one of the authenticated user's APNs tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<DiscardResult>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
    */
   async deleteApnsToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<DiscardResult>> {
     const request = new RequestBuilder()
@@ -327,8 +329,8 @@ export class ChannelsService extends BaseService {
    * @param {number} [params.limit] -
    * @param {string} [params.startingAfter] -
    * @param {string} [params.endingBefore] -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<ExpoTokenCollection>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<ExpoTokenCollection>>} - OK
    */
   async listExpoTokens(
     params?: ListExpoTokensParams,
@@ -368,8 +370,8 @@ export class ChannelsService extends BaseService {
 
   /**
    * Saves the Expo token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<ExpoTokenPayload>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<ExpoTokenPayload>>} - OK
    */
   async saveExpoToken(body: ExpoTokenPayload, requestConfig?: RequestConfig): Promise<HttpResponse<ExpoTokenPayload>> {
     const request = new RequestBuilder()
@@ -397,8 +399,8 @@ export class ChannelsService extends BaseService {
   /**
    * Fetches details of a specific Expo token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<ExpoToken>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<ExpoToken>>} - OK
    */
   async fetchExpoToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<ExpoToken>> {
     const request = new RequestBuilder()
@@ -428,8 +430,8 @@ export class ChannelsService extends BaseService {
   /**
    * Deletes one of the authenticated user's Expo tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<DiscardResult>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
    */
   async deleteExpoToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<DiscardResult>> {
     const request = new RequestBuilder()
@@ -461,8 +463,8 @@ export class ChannelsService extends BaseService {
    * @param {number} [params.limit] -
    * @param {string} [params.startingAfter] -
    * @param {string} [params.endingBefore] -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<FcmTokenCollection>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<FcmTokenCollection>>} - OK
    */
   async listFcmTokens(
     params?: ListFcmTokensParams,
@@ -502,8 +504,8 @@ export class ChannelsService extends BaseService {
 
   /**
    * Saves the FCM token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<FcmTokenPayload>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<FcmTokenPayload>>} - OK
    */
   async saveFcmToken(body: FcmTokenPayload, requestConfig?: RequestConfig): Promise<HttpResponse<FcmTokenPayload>> {
     const request = new RequestBuilder()
@@ -531,8 +533,8 @@ export class ChannelsService extends BaseService {
   /**
    * Fetches details of a specific FCM token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<FcmToken>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<FcmToken>>} - OK
    */
   async fetchFcmToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<FcmToken>> {
     const request = new RequestBuilder()
@@ -562,8 +564,8 @@ export class ChannelsService extends BaseService {
   /**
    * Deletes one of the authenticated user's FCM tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<DiscardResult>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
    */
   async deleteFcmToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<DiscardResult>> {
     const request = new RequestBuilder()
@@ -590,13 +592,153 @@ export class ChannelsService extends BaseService {
     return this.client.call<DiscardResult>(request);
   }
 
+  /**
+   * Lists all MagicBell SlackBot tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata.
+   * @param {number} [params.limit] -
+   * @param {string} [params.startingAfter] -
+   * @param {string} [params.endingBefore] -
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<SlackTokenCollection>>} - OK
+   */
+  async listMagicbellSlackbotTokens(
+    params?: ListMagicbellSlackbotTokensParams,
+    requestConfig?: RequestConfig,
+  ): Promise<HttpResponse<SlackTokenCollection>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('GET')
+      .setPath('/channels/slack/magicbell_slackbot/tokens')
+      .setRequestSchema(z.any())
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: slackTokenCollectionResponse,
+        contentType: ContentType.Json,
+        status: 200,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addQueryParam({
+        key: 'limit',
+        value: params?.limit,
+      })
+      .addQueryParam({
+        key: 'starting_after',
+        value: params?.startingAfter,
+      })
+      .addQueryParam({
+        key: 'ending_before',
+        value: params?.endingBefore,
+      })
+      .build();
+    return this.client.call<SlackTokenCollection>(request);
+  }
+
+  /**
+   * Saves the MagicBell SlackBot token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<SlackTokenPayload>>} - OK
+   */
+  async saveMagicbellSlackbotToken(
+    body: SlackTokenPayload,
+    requestConfig?: RequestConfig,
+  ): Promise<HttpResponse<SlackTokenPayload>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('PUT')
+      .setPath('/channels/slack/magicbell_slackbot/tokens')
+      .setRequestSchema(slackTokenPayloadRequest)
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: slackTokenPayloadResponse,
+        contentType: ContentType.Json,
+        status: 200,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addHeaderParam({ key: 'Content-Type', value: 'application/json' })
+      .addBody(body)
+      .build();
+    return this.client.call<SlackTokenPayload>(request);
+  }
+
+  /**
+   * Fetches details of a specific MagicBell SlackBot token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
+   * @param {string} tokenId -
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<SlackToken>>} - OK
+   */
+  async fetchMagicbellSlackbotToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<SlackToken>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('GET')
+      .setPath('/channels/slack/magicbell_slackbot/tokens/{token_id}')
+      .setRequestSchema(z.any())
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: slackTokenResponse,
+        contentType: ContentType.Json,
+        status: 200,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addPathParam({
+        key: 'token_id',
+        value: tokenId,
+      })
+      .build();
+    return this.client.call<SlackToken>(request);
+  }
+
+  /**
+   * Deletes one of the authenticated user's MagicBell SlackBot tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
+   * @param {string} tokenId -
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
+   */
+  async deleteMagicbellSlackbotToken(
+    tokenId: string,
+    requestConfig?: RequestConfig,
+  ): Promise<HttpResponse<DiscardResult>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('DELETE')
+      .setPath('/channels/slack/magicbell_slackbot/tokens/{token_id}')
+      .setRequestSchema(z.any())
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: discardResultResponse,
+        contentType: ContentType.Json,
+        status: 200,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addPathParam({
+        key: 'token_id',
+        value: tokenId,
+      })
+      .build();
+    return this.client.call<DiscardResult>(request);
+  }
+
   /**
    * Lists all Slack tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata.
    * @param {number} [params.limit] -
    * @param {string} [params.startingAfter] -
    * @param {string} [params.endingBefore] -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<SlackTokenCollection>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<SlackTokenCollection>>} - OK
    */
   async listSlackTokens(
     params?: ListSlackTokensParams,
@@ -636,8 +778,8 @@ export class ChannelsService extends BaseService {
 
   /**
    * Saves the Slack token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<SlackTokenPayload>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<SlackTokenPayload>>} - OK
    */
   async saveSlackToken(
     body: SlackTokenPayload,
@@ -668,8 +810,8 @@ export class ChannelsService extends BaseService {
   /**
    * Fetches details of a specific Slack token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<SlackToken>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<SlackToken>>} - OK
    */
   async fetchSlackToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<SlackToken>> {
     const request = new RequestBuilder()
@@ -699,8 +841,8 @@ export class ChannelsService extends BaseService {
   /**
    * Deletes one of the authenticated user's Slack tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<DiscardResult>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
    */
   async deleteSlackToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<DiscardResult>> {
     const request = new RequestBuilder()
@@ -732,8 +874,8 @@ export class ChannelsService extends BaseService {
    * @param {number} [params.limit] -
    * @param {string} [params.startingAfter] -
    * @param {string} [params.endingBefore] -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<TeamsTokenCollection>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<TeamsTokenCollection>>} - OK
    */
   async listTeamsTokens(
     params?: ListTeamsTokensParams,
@@ -773,8 +915,8 @@ export class ChannelsService extends BaseService {
 
   /**
    * Saves the Teams token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<TeamsTokenPayload>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<TeamsTokenPayload>>} - OK
    */
   async saveTeamsToken(
     body: TeamsTokenPayload,
@@ -805,8 +947,8 @@ export class ChannelsService extends BaseService {
   /**
    * Fetches details of a specific Teams token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<TeamsToken>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<TeamsToken>>} - OK
    */
   async fetchTeamsToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<TeamsToken>> {
     const request = new RequestBuilder()
@@ -836,8 +978,8 @@ export class ChannelsService extends BaseService {
   /**
    * Deletes one of the authenticated user's Teams tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<DiscardResult>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
    */
   async deleteTeamsToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<DiscardResult>> {
     const request = new RequestBuilder()
@@ -864,13 +1006,67 @@ export class ChannelsService extends BaseService {
     return this.client.call<DiscardResult>(request);
   }
 
+  /**
+   * Fetch a user's channel delivery preferences.
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<UserPreferences>>} - OK
+   */
+  async fetchUserPreferences(requestConfig?: RequestConfig): Promise<HttpResponse<UserPreferences>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('GET')
+      .setPath('/channels/user_preferences')
+      .setRequestSchema(z.any())
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: userPreferencesResponse,
+        contentType: ContentType.Json,
+        status: 200,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .build();
+    return this.client.call<UserPreferences>(request);
+  }
+
+  /**
+   * Save a user's channel preferences.
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<any>>} - No Content
+   */
+  async saveUserPreferences(body: UserPreferences, requestConfig?: RequestConfig): Promise<HttpResponse<void>> {
+    const request = new RequestBuilder()
+      .setBaseUrl(requestConfig?.baseUrl || this.config.baseUrl || this.config.environment || Environment.DEFAULT)
+      .setConfig(this.config)
+      .setMethod('PUT')
+      .setPath('/channels/user_preferences')
+      .setRequestSchema(userPreferencesRequest)
+      .addAccessTokenAuth(this.config.token, 'Bearer')
+      .setRequestContentType(ContentType.Json)
+      .addResponse({
+        schema: z.undefined(),
+        contentType: ContentType.NoContent,
+        status: 204,
+      })
+      .setRetryAttempts(this.config, requestConfig)
+      .setRetryDelayMs(this.config, requestConfig)
+      .setResponseValidation(this.config, requestConfig)
+      .addHeaderParam({ key: 'Content-Type', value: 'application/json' })
+      .addBody(body)
+      .build();
+    return this.client.call<void>(request);
+  }
+
   /**
    * Lists all Web Push tokens belonging to the authenticated user. Returns a paginated list of tokens, including their status, creation dates, and associated metadata.
    * @param {number} [params.limit] -
    * @param {string} [params.startingAfter] -
    * @param {string} [params.endingBefore] -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<WebPushTokenCollection>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<WebPushTokenCollection>>} - OK
    */
   async listWebPushTokens(
     params?: ListWebPushTokensParams,
@@ -910,8 +1106,8 @@ export class ChannelsService extends BaseService {
 
   /**
    * Saves the Web Push token for the authenticated user. This token serves as a credential for accessing channel-specific functionality. Each token is unique to the user and channel combination, allowing for direct communication with the user via the channel.
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<WebPushTokenPayload>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<WebPushTokenPayload>>} - OK
    */
   async saveWebPushToken(
     body: WebPushTokenPayload,
@@ -942,8 +1138,8 @@ export class ChannelsService extends BaseService {
   /**
    * Fetches details of a specific Web Push token belonging to the authenticated user. Returns information about the token's status, creation date, and any associated metadata. Users can only access their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<WebPushToken>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<WebPushToken>>} - OK
    */
   async fetchWebPushToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<WebPushToken>> {
     const request = new RequestBuilder()
@@ -973,8 +1169,8 @@ export class ChannelsService extends BaseService {
   /**
    * Deletes one of the authenticated user's Web Push tokens. This permanently invalidates the specified token, preventing it from being used for future channel access. This action cannot be undone. Users can only revoke their own tokens.
    * @param {string} tokenId -
-   * @param {RequestConfig} requestConfig - (Optional) The request configuration for retry and validation.
-   * @returns {Promise<HttpResponse<DiscardResult>>} OK
+   * @param {RequestConfig} [requestConfig] - The request configuration for retry and validation.
+   * @returns {Promise<HttpResponse<DiscardResult>>} - OK
    */
   async deleteWebPushToken(tokenId: string, requestConfig?: RequestConfig): Promise<HttpResponse<DiscardResult>> {
     const request = new RequestBuilder()

package/src/user-client/services/channels/models/categories.ts

@@ -0,0 +1,71 @@
+import { z } from 'zod';
+
+import { Channels, channels, channelsRequest, channelsResponse } from './channels.js';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const categories = z.lazy(() => {
+  return z.object({
+    channels: z.array(channels).optional(),
+    key: z
+      .string()
+      .max(255)
+      .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+      .optional(),
+    label: z.string().max(255).optional().nullable(),
+  });
+});
+
+/**
+ *
+ * @typedef  {Categories} categories
+ * @property {Channels[]}
+ * @property {string}
+ * @property {string}
+ */
+export type Categories = z.infer<typeof categories>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const categoriesResponse = z.lazy(() => {
+  return z
+    .object({
+      channels: z.array(channelsResponse).optional(),
+      key: z
+        .string()
+        .max(255)
+        .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+        .optional(),
+      label: z.string().max(255).optional().nullable(),
+    })
+    .transform((data) => ({
+      channels: data['channels'],
+      key: data['key'],
+      label: data['label'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const categoriesRequest = z.lazy(() => {
+  return z
+    .object({
+      channels: z.array(channelsRequest).optional(),
+      key: z
+        .string()
+        .max(255)
+        .regex(/^[A-Za-z0-9_\.\-\/:]+$/)
+        .optional(),
+      label: z.string().max(255).optional().nullable(),
+    })
+    .transform((data) => ({
+      channels: data['channels'],
+      key: data['key'],
+      label: data['label'],
+    }));
+});

package/src/user-client/services/channels/models/channels.ts

@@ -0,0 +1,51 @@
+import { z } from 'zod';
+
+/**
+ * The shape of the model inside the application code - what the users use
+ */
+export const channels = z.lazy(() => {
+  return z.object({
+    enabled: z.boolean().optional(),
+    name: z.string().optional(),
+  });
+});
+
+/**
+ *
+ * @typedef  {Channels} channels
+ * @property {boolean}
+ * @property {string}
+ */
+export type Channels = z.infer<typeof channels>;
+
+/**
+ * The shape of the model mapping from the api schema into the application shape.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const channelsResponse = z.lazy(() => {
+  return z
+    .object({
+      enabled: z.boolean().optional(),
+      name: z.string().optional(),
+    })
+    .transform((data) => ({
+      enabled: data['enabled'],
+      name: data['name'],
+    }));
+});
+
+/**
+ * The shape of the model mapping from the application shape into the api schema.
+ * Is equal to application shape if all property names match the api schema
+ */
+export const channelsRequest = z.lazy(() => {
+  return z
+    .object({
+      enabled: z.boolean().optional(),
+      name: z.string().optional(),
+    })
+    .transform((data) => ({
+      enabled: data['enabled'],
+      name: data['name'],
+    }));
+});

package/src/user-client/services/channels/models/index.ts

@@ -3,6 +3,8 @@ export type { ApnsTokenCollection } from './apns-token-collection.js';
 export { ApnsTokenInstallationId } from './apns-token-installation-id.js';
 export type { ApnsTokenPayload } from './apns-token-payload.js';
 export { ApnsTokenPayloadInstallationId } from './apns-token-payload-installation-id.js';
+export type { Categories } from './categories.js';
+export type { Channels } from './channels.js';
 export type { DiscardResult } from './discard-result.js';
 export type { ExpoToken } from './expo-token.js';
 export type { ExpoTokenCollection } from './expo-token-collection.js';
@@ -27,6 +29,7 @@ export type { TeamsTokenCollection } from './teams-token-collection.js';
 export type { TeamsTokenPayload } from './teams-token-payload.js';
 export type { TeamsTokenPayloadWebhook } from './teams-token-payload-webhook.js';
 export type { TeamsTokenWebhook } from './teams-token-webhook.js';
+export type { UserPreferences } from './user-preferences.js';
 export type { WebPushToken } from './web-push-token.js';
 export type { WebPushTokenCollection } from './web-push-token-collection.js';
 export type { WebPushTokenKeys } from './web-push-token-keys.js';