stream-chat 9.52.0 → 9.53.0

package/dist/types/channel.d.ts

@@ -491,14 +491,16 @@ export declare class Channel {
      */
     markRead(data?: MarkReadOptions): Promise<EventAPIResponse | null>;
     /**
-     * markReadRequest - Send the mark read event for this user, only works if the `read_events` setting is enabled
+     * markReadRequest - Send the mark read event for this user, only works if the `read_events` setting is
+     * enabled and the user holds the `read-events` capability on this channel
      *
      * @param {MarkReadOptions} data
      * @return {Promise<EventAPIResponse | null>} Description
      */
     markAsReadRequest(data?: MarkReadOptions): Promise<EventAPIResponse | null>;
     /**
-     * markUnread - Mark the channel as unread from messageID, only works if the `read_events` setting is enabled
+     * markUnread - Mark the channel as unread from messageID, only works if the `read_events` setting is
+     * enabled and the user holds the `read-events` capability on this channel
      *
      * @param {MarkUnreadOptions} data
      * @return {APIResponse} An API response

package/dist/types/channel_batch_updater.d.ts

@@ -1,5 +1,5 @@
 import type { StreamChat } from './client';
-import type { APIResponse, BatchChannelDataUpdate, NewMemberPayload, UpdateChannelsBatchFilters, UpdateChannelsBatchResponse } from './types';
+import type { APIResponse, BatchChannelDataUpdate, ChannelBatchDataUpdateOptions, NewMemberPayload, UpdateChannelsBatchFilters, UpdateChannelsBatchResponse } from './types';
 /**
  * ChannelBatchUpdater - A class that provides convenience methods for batch channel operations
  */
@@ -85,9 +85,16 @@ export declare class ChannelBatchUpdater {
     /**
      * updateData - Update data on channels matching the filter
      *
+     * `data.custom` replaces the channel's whole custom object. To patch
+     * individual custom keys, pass an options object with `custom_set` or
+     * `custom_unset`. The client sends those fields at the request root rather
+     * than inside `data`. The options object can also include `data` to update
+     * channel fields in the same request.
+     *
      * @param {UpdateChannelsBatchFilters} filter Filter to select channels
-     * @param {BatchChannelDataUpdate} data Data to update
+     * @param {BatchChannelDataUpdate | ChannelBatchDataUpdateOptions} update Data or update options
      * @return {Promise<APIResponse & UpdateChannelsBatchResponse>} The server response
      */
     updateData(filter: UpdateChannelsBatchFilters, data: BatchChannelDataUpdate): Promise<APIResponse & UpdateChannelsBatchResponse>;
+    updateData(filter: UpdateChannelsBatchFilters, options: ChannelBatchDataUpdateOptions): Promise<APIResponse & UpdateChannelsBatchResponse>;
 }

package/dist/types/client.d.ts

@@ -105,6 +105,10 @@ export declare class StreamChat {
     wsConnection: StableWSConnection | null;
     wsFallback?: WSConnectionFallback;
     wsPromise: ConnectAPIResponse | null;
+    private _wsPromiseSettled;
+    private _wsConnectId;
+    private _resolveWsPromise?;
+    private _rejectWsPromise?;
     consecutiveFailures: number;
     insightMetrics: InsightMetrics;
     defaultWSTimeoutWithFallback: number;
@@ -224,6 +228,15 @@ export declare class StreamChat {
      * Creates a new WebSocket connection with the current user. Returns empty promise, if there is an active connection
      */
     openConnection: () => ConnectAPIResponse | undefined;
+    /**
+     * Rejects the shared `wsPromise`, invalidates any in-flight connect attempt
+     */
+    private _rejectPendingWsPromise;
+    /**
+     * Keep a single pending `wsPromise` across close/reopen so callers that already
+     * `await this.wsPromise` are not stranded when `openConnection` starts a new connect.
+     */
+    private _bindWsPromise;
     /**
      * @deprecated Please use client.openConnction instead.
      * @private
@@ -2183,6 +2196,10 @@ export declare class StreamChat {
     /**
      *  Update Channels Batch
      *
+     *  For the `updateData` operation, `data.custom` replaces the channel's whole
+     *  custom object, while the root-level `custom_set` / `custom_unset` patch
+     *  individual keys and leave the rest untouched.
+     *
      *  @param {UpdateChannelsBatchOptions} payload for updating channels in batch
      *  @return {Promise<APIResponse & UpdateChannelsBatchResponse>} The server response
      */

package/dist/types/types.d.ts

@@ -48,6 +48,7 @@ export type TranslateResponse = {
 export type AppSettingsAPIResponse = APIResponse & {
     app?: {
         id?: string | number;
+        activity_metrics_config?: Record<string, number>;
         allow_multi_user_devices?: boolean;
         feed_audit_logs_enabled?: boolean;
         moderation_onboarding_complete?: boolean | null;
@@ -93,6 +94,7 @@ export type AppSettingsAPIResponse = APIResponse & {
         before_message_send_hook_attempt_timeout_ms?: number;
         campaign_enabled?: boolean;
         cdn_expiration_seconds?: number;
+        chat_primary_use_case?: string;
         custom_action_handler_url?: string;
         datadog_info?: {
             api_key: string;
@@ -117,13 +119,18 @@ export type AppSettingsAPIResponse = APIResponse & {
         image_upload_config?: FileUploadConfig;
         allowed_flag_reasons?: string[];
         max_aggregated_activities_length?: number;
+        member_custom_on_mentioned_users_enabled?: boolean;
+        member_custom_on_messages_enabled?: boolean;
+        member_custom_on_typing_events_enabled?: boolean;
         moderation_bulk_submit_action_enabled?: boolean;
         moderation_dashboard_preferences?: Record<string, unknown> | null;
         moderation_audio_call_moderation_enabled?: boolean;
         moderation_enabled?: boolean;
         moderation_flood_rules_enabled?: boolean;
+        moderation_keyframe_video_enabled?: boolean;
         moderation_llm_configurability_enabled?: boolean;
         moderation_multitenant_blocklist_enabled?: boolean;
+        moderation_s3_image_access_role_arn?: string;
         moderation_video_call_moderation_enabled?: boolean;
         moderation_webhook_url?: string;
         multi_tenant_enabled?: boolean;
@@ -160,6 +167,7 @@ export type AppSettingsAPIResponse = APIResponse & {
         use_hook_v2?: boolean;
         user_response_time_enabled?: boolean;
         user_search_disallowed_roles?: string[] | null;
+        video_primary_use_case?: string;
         video_provider?: string;
         webhook_events?: Array<string>;
         webhook_url?: string;
@@ -3713,7 +3721,32 @@ export type UpdateChannelsBatchOptions = {
     filter: UpdateChannelsBatchFilters;
     members?: string[] | Array<NewMemberPayload>;
     data?: BatchChannelDataUpdate;
+    /**
+     * `updateData` only. Merges these keys into each matched channel's existing
+     * custom object, leaving every other custom key untouched — unlike
+     * `data.custom`, which replaces the whole object. Keys are dot-paths, so
+     * `a.b` sets key `b` inside object `a` (the parent object must already
+     * exist). Cannot be combined with `data.custom`.
+     *
+     * Lives at the request root, not inside `data`.
+     */
+    custom_set?: Record<string, unknown>;
+    /**
+     * `updateData` only. Deletes these keys from each matched channel's existing
+     * custom object, leaving every other custom key untouched. Keys are
+     * dot-paths; deleting a key that does not exist is a no-op. Cannot be
+     * combined with `data.custom`.
+     *
+     * Lives at the request root, not inside `data`.
+     */
+    custom_unset?: string[];
 };
+/**
+ * Options for {@link ChannelBatchUpdater.updateData}. `custom_set` and
+ * `custom_unset` are sent at the request root, while `data` contains the
+ * channel fields to update.
+ */
+export type ChannelBatchDataUpdateOptions = Pick<UpdateChannelsBatchOptions, 'data' | 'custom_set' | 'custom_unset'>;
 export type UpdateChannelsBatchFilters = QueryFilters<{
     cids?: RequireOnlyOne<Pick<QueryFilter<string>, '$in' | '$eq'>> | PrimitiveFilter<string[]>;
     types?: RequireOnlyOne<Pick<QueryFilter<string>, '$in' | '$eq'>> | PrimitiveFilter<string[]>;

package/dist/types/utils.d.ts

@@ -12,6 +12,15 @@ import type { AxiosRequestConfig } from 'axios';
  *
  */
 export declare function logChatPromiseExecution<T>(promise: Promise<T>, name: string): void;
+/**
+ * The default no-op client logger.
+ */
+export declare const noopLogger: Logger;
+/**
+ * Invokes a single event listener in isolation, so that a faulty listener cannot
+ * abort the dispatch loop or the bookkeeping that follows it.
+ */
+export declare const invokeEventListener: <T>(listener: (event: T) => unknown, event: T, logger: Logger) => void;
 export declare const sleep: (m: number) => Promise<void>;
 export declare function isFunction(value: unknown): value is (...args: unknown[]) => unknown;
 export declare const chatCodes: {
@@ -28,11 +37,6 @@ export declare const channelHasReadEvents: (channel?: Channel) => boolean;
  * channelTracksReadLocally - Whether a channel maintains a client local unread count.
  */
 export declare const channelTracksReadLocally: (channel?: Channel) => boolean;
-/**
- * userHasReadReceipts - Whether the current user allows read receipts, per their privacy settings.
- * Read receipts are treated as enabled unless the user has explicitly disabled them.
- */
-export declare const userHasReadReceipts: (client: StreamChat) => boolean;
 export declare function addFileToFormData(uri: string | NodeJS.ReadableStream | Buffer | File, name?: string, contentType?: string): FormData;
 export declare function normalizeQuerySort<T extends Record<string, AscDesc | undefined>>(sort: T | T[]): {
     direction: AscDesc;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stream-chat",
-  "version": "9.52.0",
+  "version": "9.53.0",
   "description": "JS SDK for the Stream Chat API",
   "homepage": "https://getstream.io/chat/",
   "author": {

package/src/channel.ts

@@ -6,6 +6,7 @@ import { MessageReceiptsTracker } from './messageDelivery';
 import {
   channelHasReadEvents,
   generateChannelTempCid,
+  invokeEventListener,
   logChatPromiseExecution,
   messageSetPagination,
   normalizeQuerySort,
@@ -1221,7 +1222,8 @@ export class Channel {
   }
 
   /**
-   * markReadRequest - Send the mark read event for this user, only works if the `read_events` setting is enabled
+   * markReadRequest - Send the mark read event for this user, only works if the `read_events` setting is
+   * enabled and the user holds the `read-events` capability on this channel
    *
    * @param {MarkReadOptions} data
    * @return {Promise<EventAPIResponse | null>} Description
@@ -1229,7 +1231,13 @@ export class Channel {
   async markAsReadRequest(data: MarkReadOptions = {}) {
     this._checkInitialized();
 
-    if (!this.getConfig()?.read_events && !this.getClient()._isUsingServerAuth()) {
+    // Server-side auth acts on behalf of a user with no own capabilities, so only the client-side
+    // flow is gated. Channels the user has no `read-events` capability on do not track read state
+    // on the backend at all - see `markReadLocally` for the client-local unread count.
+    if (
+      !this.getClient()._isUsingServerAuth() &&
+      (!this.getConfig()?.read_events || !channelHasReadEvents(this))
+    ) {
       return null;
     }
 
@@ -1239,7 +1247,8 @@ export class Channel {
   }
 
   /**
-   * markUnread - Mark the channel as unread from messageID, only works if the `read_events` setting is enabled
+   * markUnread - Mark the channel as unread from messageID, only works if the `read_events` setting is
+   * enabled and the user holds the `read-events` capability on this channel
    *
    * @param {MarkUnreadOptions} data
    * @return {APIResponse} An API response
@@ -1247,7 +1256,11 @@ export class Channel {
   async markUnread(data: MarkUnreadOptions) {
     this._checkInitialized();
 
-    if (!this.getConfig()?.read_events && !this.getClient()._isUsingServerAuth()) {
+    // Gated the same way as `markAsReadRequest` - see the comment there.
+    if (
+      !this.getClient()._isUsingServerAuth() &&
+      (!this.getConfig()?.read_events || !channelHasReadEvents(this))
+    ) {
       return Promise.resolve(null);
     }
 
@@ -2354,22 +2367,17 @@ export class Channel {
   }
 
   _callChannelListeners = (event: Event) => {
-    // eslint-disable-next-line @typescript-eslint/no-this-alias
-    const channel = this;
-    // gather and call the listeners
-    const listeners = [];
-    if (channel.listeners.all) {
-      listeners.push(...channel.listeners.all);
-    }
-    if (channel.listeners[event.type]) {
-      listeners.push(...channel.listeners[event.type]);
-    }
+    // snapshot before dispatching: `on` pushes into these arrays in place, so a
+    // listener that subscribes while handling an event must not be invoked for it
+    const listeners = [
+      ...(this.listeners.all ?? []),
+      ...(this.listeners[event.type] ?? []),
+    ];
 
-    // call the event and send it to the listeners
+    const { logger } = this._client;
     for (const listener of listeners) {
-      if (typeof listener !== 'string') {
-        listener(event);
-      }
+      if (typeof listener === 'string') continue;
+      invokeEventListener(listener, event, logger);
     }
   };
 

package/src/channel_batch_updater.ts

@@ -2,11 +2,17 @@ import type { StreamChat } from './client';
 import type {
   APIResponse,
   BatchChannelDataUpdate,
+  ChannelBatchDataUpdateOptions,
   NewMemberPayload,
   UpdateChannelsBatchFilters,
   UpdateChannelsBatchResponse,
 } from './types';
 
+const isChannelBatchDataUpdateOptions = (
+  update: BatchChannelDataUpdate | ChannelBatchDataUpdateOptions,
+): update is ChannelBatchDataUpdateOptions =>
+  'data' in update || 'custom_set' in update || 'custom_unset' in update;
+
 /**
  * ChannelBatchUpdater - A class that provides convenience methods for batch channel operations
  */
@@ -194,18 +200,38 @@ export class ChannelBatchUpdater {
   /**
    * updateData - Update data on channels matching the filter
    *
+   * `data.custom` replaces the channel's whole custom object. To patch
+   * individual custom keys, pass an options object with `custom_set` or
+   * `custom_unset`. The client sends those fields at the request root rather
+   * than inside `data`. The options object can also include `data` to update
+   * channel fields in the same request.
+   *
    * @param {UpdateChannelsBatchFilters} filter Filter to select channels
-   * @param {BatchChannelDataUpdate} data Data to update
+   * @param {BatchChannelDataUpdate | ChannelBatchDataUpdateOptions} update Data or update options
    * @return {Promise<APIResponse & UpdateChannelsBatchResponse>} The server response
    */
   async updateData(
     filter: UpdateChannelsBatchFilters,
     data: BatchChannelDataUpdate,
+  ): Promise<APIResponse & UpdateChannelsBatchResponse>;
+  async updateData(
+    filter: UpdateChannelsBatchFilters,
+    options: ChannelBatchDataUpdateOptions,
+  ): Promise<APIResponse & UpdateChannelsBatchResponse>;
+  async updateData(
+    filter: UpdateChannelsBatchFilters,
+    update: BatchChannelDataUpdate | ChannelBatchDataUpdateOptions,
   ): Promise<APIResponse & UpdateChannelsBatchResponse> {
+    const { data, custom_set, custom_unset } = isChannelBatchDataUpdateOptions(update)
+      ? update
+      : { data: update };
+
     return await this.client.updateChannelsBatch({
       operation: 'updateData',
       filter,
-      data,
+      ...(data && { data }),
+      ...(custom_set && { custom_set }),
+      ...(custom_unset && { custom_unset }),
     });
   }
 }

package/src/client.ts

@@ -29,10 +29,12 @@ import {
   axiosParamsSerializer,
   chatCodes,
   generateChannelTempCid,
+  invokeEventListener,
   isFunction,
   isOnline,
   isOwnUserBaseProperty,
   messageSetPagination,
+  noopLogger,
   normalizeQuerySort,
   randomId,
   retryInterval,
@@ -391,6 +393,10 @@ export class StreamChat {
   wsConnection: StableWSConnection | null;
   wsFallback?: WSConnectionFallback;
   wsPromise: ConnectAPIResponse | null;
+  private _wsPromiseSettled = true;
+  private _wsConnectId = 0;
+  private _resolveWsPromise?: (value: Awaited<ConnectAPIResponse>) => void;
+  private _rejectWsPromise?: (reason?: unknown) => void;
   consecutiveFailures: number;
   insightMetrics: InsightMetrics;
   defaultWSTimeoutWithFallback: number;
@@ -575,7 +581,7 @@ export class StreamChat {
      *    channel: object
      * }
      */
-    this.logger = isFunction(inputOptions.logger) ? inputOptions.logger : () => null;
+    this.logger = isFunction(inputOptions.logger) ? inputOptions.logger : noopLogger;
     this.recoverStateOnReconnect = this.options.recoverStateOnReconnect;
     this.threads = new ThreadManager({ client: this });
     this.polls = new PollManager({ client: this });
@@ -711,18 +717,25 @@ export class StreamChat {
 
     const wsPromise = this.openConnection();
 
-    this.setUserPromise = Promise.all([setTokenPromise, wsPromise]).then(
+    const setUserPromise = Promise.all([setTokenPromise, wsPromise]).then(
       (result) => result[1], // We only return connection promise;
     );
+    this.setUserPromise = setUserPromise;
 
     try {
-      return await this.setUserPromise;
+      return await setUserPromise;
     } catch (err) {
-      if (this.persistUserOnConnectionFailure) {
-        // cleanup client to allow the user to retry connectUser again
-        this.closeConnection();
-      } else {
-        this.disconnectUser();
+      // disconnectUser() rejects an in-flight handshake so this catch can run *after* something else has taken over.
+      // Cleaning up then would tear down whatever replaced us. setUserPromise catches a
+      // newer connectUser(); userID additionally catches connectAnonymousUser(), which
+      // never sets setUserPromise, and a bare disconnectUser() that already cleaned up.
+      if (this.setUserPromise === setUserPromise && this.userID === user.id) {
+        if (this.persistUserOnConnectionFailure) {
+          // cleanup client to allow the user to retry connectUser again
+          this.closeConnection();
+        } else {
+          this.disconnectUser();
+        }
       }
       throw err;
     }
@@ -850,9 +863,58 @@ export class StreamChat {
     }
 
     this.clientID = `${this.userID}--${randomId()}`;
-    this.wsPromise = this.connect();
+    const wsPromise = this._bindWsPromise(this.connect());
     this._startCleaning();
-    return this.wsPromise;
+    return wsPromise;
+  };
+
+  /**
+   * Rejects the shared `wsPromise`, invalidates any in-flight connect attempt
+   */
+  private _rejectPendingWsPromise = (reason: Error) => {
+    if (!this._wsPromiseSettled) {
+      // invalidate in-flight attempts so a late settle cannot revive this promise
+      this._wsConnectId += 1;
+      this._wsPromiseSettled = true;
+      // Avoid unhandled promise rejection errors
+      this.wsPromise?.catch(() => {
+        // noop - real awaiters still observe the rejection
+      });
+      this._rejectWsPromise?.(reason);
+    }
+  };
+
+  /**
+   * Keep a single pending `wsPromise` across close/reopen so callers that already
+   * `await this.wsPromise` are not stranded when `openConnection` starts a new connect.
+   */
+  private _bindWsPromise = (connectPromise: ConnectAPIResponse): ConnectAPIResponse => {
+    const connectId = ++this._wsConnectId;
+
+    let pending = this.wsPromise;
+    if (this._wsPromiseSettled || !pending) {
+      this._wsPromiseSettled = false;
+      pending = new Promise((resolve, reject) => {
+        this._resolveWsPromise = resolve;
+        this._rejectWsPromise = reject;
+      });
+      this.wsPromise = pending;
+    }
+
+    connectPromise.then(
+      (value) => {
+        if (connectId !== this._wsConnectId) return;
+        this._wsPromiseSettled = true;
+        this._resolveWsPromise?.(value);
+      },
+      (error) => {
+        if (connectId !== this._wsConnectId) return;
+        this._wsPromiseSettled = true;
+        this._rejectWsPromise?.(error);
+      },
+    );
+
+    return pending;
   };
 
   /**
@@ -1057,6 +1119,11 @@ export class StreamChat {
 
     this.anonymous = false;
 
+    this._rejectPendingWsPromise(
+      new Error('Connection was closed because disconnectUser() was called'),
+    );
+    this.wsPromise = null;
+
     const closePromise = this.closeConnection(timeout);
 
     for (const channel of Object.values(this.activeChannels)) {
@@ -1700,20 +1767,15 @@ export class StreamChat {
   }
 
   _callClientListeners = (event: Event) => {
-    // eslint-disable-next-line @typescript-eslint/no-this-alias
-    const client = this;
-    // gather and call the listeners
-    const listeners: Array<(event: Event) => void> = [];
-    if (client.listeners.all) {
-      listeners.push(...client.listeners.all);
-    }
-    if (client.listeners[event.type]) {
-      listeners.push(...client.listeners[event.type]);
-    }
+    // snapshot before dispatching: `on` pushes into these arrays in place, so a
+    // listener that subscribes while handling an event must not be invoked for it
+    const listeners = [
+      ...(this.listeners.all ?? []),
+      ...(this.listeners[event.type] ?? []),
+    ];
 
-    // call the event and send it to the listeners
     for (const listener of listeners) {
-      listener(event);
+      invokeEventListener(listener, event, this.logger);
     }
   };
 
@@ -1754,7 +1816,12 @@ export class StreamChat {
       } as Event);
     }
 
-    this.wsPromise = Promise.resolve();
+    // If state recovery happens afer a failed connect (for example on persistUserOnConnectionFailure: true) we need to flip the wsPromise from rejected to resolved
+    // Otherwise all API calls that wait for the promise will fail
+    // If promise is not yet settled - we leave it for the connect sequence to resolve the promise
+    if (this._wsPromiseSettled) {
+      this.wsPromise = Promise.resolve();
+    }
     this.setUserPromise = Promise.resolve();
   };
 
@@ -5309,6 +5376,10 @@ export class StreamChat {
   /**
    *  Update Channels Batch
    *
+   *  For the `updateData` operation, `data.custom` replaces the channel's whole
+   *  custom object, while the root-level `custom_set` / `custom_unset` patch
+   *  individual keys and leave the rest untouched.
+   *
    *  @param {UpdateChannelsBatchOptions} payload for updating channels in batch
    *  @return {Promise<APIResponse & UpdateChannelsBatchResponse>} The server response
    */

package/src/messageDelivery/MessageDeliveryReporter.ts

@@ -10,7 +10,7 @@ import type {
   MarkReadOptions,
 } from '../types';
 import { type APIErrorResponse } from '../types';
-import { throttle, userHasReadReceipts } from '../utils';
+import { throttle } from '../utils';
 import { isAPIError, isErrorRetryable } from '../errors';
 
 const MAX_DELIVERED_MESSAGE_COUNT_IN_PAYLOAD = 100 as const;
@@ -279,8 +279,6 @@ export class MessageDeliveryReporter {
    * @param options
    */
   public markRead = async (collection: Channel | Thread, options?: MarkReadOptions) => {
-    if (!userHasReadReceipts(this.client)) return null;
-
     let result: EventAPIResponse | null = null;
     if (isChannel(collection)) {
       result = await collection.markAsReadRequest(options);
@@ -291,7 +289,10 @@ export class MessageDeliveryReporter {
       });
     }
 
-    this.removeCandidateFor(collection);
+    // A read implies delivery, so the candidate is only dropped once the request actually went
+    // out. `markAsReadRequest` returns null for channels that do not track read state on the
+    // backend, and those candidates must survive for the next delivery report.
+    if (result) this.removeCandidateFor(collection);
     return result;
   };
 

package/src/types.ts

@@ -83,6 +83,7 @@ export type TranslateResponse = {
 export type AppSettingsAPIResponse = APIResponse & {
   app?: {
     id?: string | number;
+    activity_metrics_config?: Record<string, number>;
     allow_multi_user_devices?: boolean;
     feed_audit_logs_enabled?: boolean;
     moderation_onboarding_complete?: boolean | null;
@@ -139,6 +140,7 @@ export type AppSettingsAPIResponse = APIResponse & {
     before_message_send_hook_attempt_timeout_ms?: number;
     campaign_enabled?: boolean;
     cdn_expiration_seconds?: number;
+    chat_primary_use_case?: string;
     custom_action_handler_url?: string;
     datadog_info?: {
       api_key: string;
@@ -163,13 +165,18 @@ export type AppSettingsAPIResponse = APIResponse & {
     image_upload_config?: FileUploadConfig;
     allowed_flag_reasons?: string[];
     max_aggregated_activities_length?: number;
+    member_custom_on_mentioned_users_enabled?: boolean;
+    member_custom_on_messages_enabled?: boolean;
+    member_custom_on_typing_events_enabled?: boolean;
     moderation_bulk_submit_action_enabled?: boolean;
     moderation_dashboard_preferences?: Record<string, unknown> | null;
     moderation_audio_call_moderation_enabled?: boolean;
     moderation_enabled?: boolean;
     moderation_flood_rules_enabled?: boolean;
+    moderation_keyframe_video_enabled?: boolean;
     moderation_llm_configurability_enabled?: boolean;
     moderation_multitenant_blocklist_enabled?: boolean;
+    moderation_s3_image_access_role_arn?: string;
     moderation_video_call_moderation_enabled?: boolean;
     moderation_webhook_url?: string;
     multi_tenant_enabled?: boolean;
@@ -206,6 +213,7 @@ export type AppSettingsAPIResponse = APIResponse & {
     use_hook_v2?: boolean;
     user_response_time_enabled?: boolean;
     user_search_disallowed_roles?: string[] | null;
+    video_primary_use_case?: string;
     video_provider?: string;
     webhook_events?: Array<string>;
     webhook_url?: string;
@@ -4990,8 +4998,37 @@ export type UpdateChannelsBatchOptions = {
   filter: UpdateChannelsBatchFilters;
   members?: string[] | Array<NewMemberPayload>;
   data?: BatchChannelDataUpdate;
+  /**
+   * `updateData` only. Merges these keys into each matched channel's existing
+   * custom object, leaving every other custom key untouched — unlike
+   * `data.custom`, which replaces the whole object. Keys are dot-paths, so
+   * `a.b` sets key `b` inside object `a` (the parent object must already
+   * exist). Cannot be combined with `data.custom`.
+   *
+   * Lives at the request root, not inside `data`.
+   */
+  custom_set?: Record<string, unknown>;
+  /**
+   * `updateData` only. Deletes these keys from each matched channel's existing
+   * custom object, leaving every other custom key untouched. Keys are
+   * dot-paths; deleting a key that does not exist is a no-op. Cannot be
+   * combined with `data.custom`.
+   *
+   * Lives at the request root, not inside `data`.
+   */
+  custom_unset?: string[];
 };
 
+/**
+ * Options for {@link ChannelBatchUpdater.updateData}. `custom_set` and
+ * `custom_unset` are sent at the request root, while `data` contains the
+ * channel fields to update.
+ */
+export type ChannelBatchDataUpdateOptions = Pick<
+  UpdateChannelsBatchOptions,
+  'data' | 'custom_set' | 'custom_unset'
+>;
+
 export type UpdateChannelsBatchFilters = QueryFilters<{
   cids?:
     | RequireOnlyOne<Pick<QueryFilter<string>, '$in' | '$eq'>>