stream-chat 9.50.2 → 9.51.0

package/dist/types/channel.d.ts

@@ -4,7 +4,7 @@ import { CooldownTimer } from './CooldownTimer';
 import { MessageComposer } from './messageComposer';
 import { MessageReceiptsTracker } from './messageDelivery';
 import type { StreamChat } from './client';
-import type { AIState, APIResponse, AscDesc, BanUserOptions, ChannelAPIResponse, ChannelData, ChannelMemberAPIResponse, ChannelMemberResponse, ChannelPushPreference, ChannelQueryOptions, ChannelResponse, ChannelUpdateOptions, CreateDraftResponse, DeleteChannelAPIResponse, DraftMessagePayload, Event, EventAPIResponse, EventHandler, EventTypes, GetDraftResponse, GetMultipleMessagesAPIResponse, GetReactionsAPIResponse, GetRepliesAPIResponse, LiveLocationPayload, LocalMessage, MarkReadOptions, MarkUnreadOptions, MemberFilters, MemberSort, Message, MessageFilters, MessageOptions, MessagePaginationOptions, MessageResponse, MessageSetType, MuteChannelAPIResponse, NewMemberPayload, PartialUpdateChannel, PartialUpdateChannelAPIResponse, PartialUpdateMember, PartialUpdateMemberAPIResponse, PinnedMessagePaginationOptions, PinnedMessagesSort, PollVoteData, QueryChannelAPIResponse, QueryMembersOptions, Reaction, ReactionAPIResponse, SearchAPIResponse, SearchOptions, SendMessageAPIResponse, SendMessageOptions, SendReactionOptions, StaticLocationPayload, TruncateChannelAPIResponse, TruncateOptions, UnBanUserOptions, UpdateChannelAPIResponse, UpdateChannelOptions, UpdateLocationPayload, UserResponse } from './types';
+import type { AIState, APIResponse, AscDesc, BanUserOptions, ChannelAPIResponse, ChannelData, ChannelMemberAPIResponse, ChannelMemberResponse, ChannelPushPreference, ChannelQueryOptions, ChannelResponse, ChannelUpdateOptions, CreateDraftResponse, DeleteChannelAPIResponse, DraftMessagePayload, Event, EventAPIResponse, EventHandler, EventTypes, GetDraftResponse, GetMultipleMessagesAPIResponse, GetReactionsAPIResponse, GetRepliesAPIResponse, LiveLocationPayload, LocalMessage, MarkReadOptions, MarkUnreadOptions, MemberFilters, MemberSort, Message, MessageFilters, MessageOptions, MessagePaginationOptions, MessageResponse, MessageSetType, MuteChannelAPIResponse, NewMemberPayload, PartialUpdateChannel, PartialUpdateChannelAPIResponse, PartialUpdateMember, PartialUpdateMemberAPIResponse, PinnedMessagePaginationOptions, PinnedMessagesSort, PollVoteData, QueryChannelAPIResponse, QueryMembersOptions, Reaction, ReactionAPIResponse, RequestOptions, SearchAPIResponse, SearchOptions, SendMessageAPIResponse, SendMessageOptions, SendReactionOptions, StaticLocationPayload, TruncateChannelAPIResponse, TruncateOptions, UnBanUserOptions, UpdateChannelAPIResponse, UpdateChannelOptions, UpdateLocationPayload, UserResponse } from './types';
 import type { Role } from './permissions';
 /**
  * Channel - The Channel class manages it's own state.
@@ -136,10 +136,11 @@ export declare class Channel {
      * @param {MemberSort} [sort] Sort options, for instance [{created_at: -1}].
      * When using multiple fields, make sure you use array of objects to guarantee field order, for instance [{name: -1}, {created_at: 1}]
      * @param {{ limit?: number; offset?: number }} [options] Option object, {limit: 10, offset:10}
+     * @param {RequestOptions} [requestOptions] Carries an abort signal. Not sent in the request.
      *
      * @return {Promise<ChannelMemberAPIResponse>} Query Members response
      */
-    queryMembers(filterConditions: MemberFilters, sort?: MemberSort, options?: QueryMembersOptions): Promise<ChannelMemberAPIResponse>;
+    queryMembers(filterConditions: MemberFilters, sort?: MemberSort, options?: QueryMembersOptions, requestOptions?: RequestOptions): Promise<ChannelMemberAPIResponse>;
     /**
      * updateMemberPartial - Partial update a member
      *

package/dist/types/client.d.ts

@@ -8,7 +8,7 @@ import { WSConnectionFallback } from './connection_fallback';
 import { Campaign } from './campaign';
 import { ChannelBatchUpdater } from './channel_batch_updater';
 import { Segment } from './segment';
-import type { ActiveLiveLocationsAPIResponse, AddUserGroupMembersOptions, AddUserGroupMembersResponse, APIErrorResponse, APIResponse, AppIdentifier, AppSettings, AppSettingsAPIResponse, BannedUsersFilters, BannedUsersPaginationOptions, BannedUsersResponse, BannedUsersSort, BanUserOptions, BaseDeviceFields, BlockList, BlockListResponse, BlockUserAPIResponse, CampaignData, CampaignFilters, CampaignQueryOptions, CampaignResponse, CampaignSort, CastVoteAPIResponse, ChannelAPIResponse, ChannelData, ChannelFilters, ChannelMute, ChannelOptions, ChannelResponse, ChannelSort, ChannelStateOptions, CheckPushResponse, CheckSNSResponse, CheckSQSResponse, Configs, ConnectAPIResponse, CreateChannelOptions, CreateChannelResponse, CreateCommandOptions, CreateCommandResponse, CreateImportOptions, CreateImportResponse, CreateImportURLResponse, CreatePollAPIResponse, CreatePollData, CreatePollOptionAPIResponse, CreatePredefinedFilterOptions, CreateReminderOptions, CreateRoleAPIResponse, CreateUserGroupOptions, CreateUserGroupResponse, CustomPermissionOptions, DeactivateUsersOptions, DeleteCommandResponse, DeleteMessageOptions, DeleteUserGroupOptions, DeleteUserOptions, Device, DeviceIdentifier, DraftFilters, DraftSort, EndpointName, Event, EventAPIResponse, EventHandler, ExportChannelOptions, ExportChannelRequest, ExportChannelResponse, ExportChannelStatusResponse, ExportUsersRequest, ExportUsersResponse, FlagMessageResponse, FlagReportsFilters, FlagReportsPaginationOptions, FlagReportsResponse, FlagsFilters, FlagsPaginationOptions, FlagsResponse, FlagUserResponse, FutureChannelBansResponse, GetBlockedUsersAPIResponse, GetCampaignOptions, GetChannelTypeResponse, GetCommandResponse, GetHookEventsResponse, GetImportResponse, GetMessageOptions, GetPollAPIResponse, GetRateLimitsResponse, GetRetentionPolicyResponse, GetRetentionPolicyRunsOptions, GetRetentionPolicyRunsResponse, GetThreadAPIResponse, GetThreadOptions, GetUnreadCountAPIResponse, GetUnreadCountBatchAPIResponse, GetUserGroupOptions, GetUserGroupResponse, ListChannelResponse, ListCommandsResponse, ListImportsPaginationOptions, ListImportsResponse, ListPredefinedFiltersOptions, ListPredefinedFiltersResponse, ListRolesAPIResponse, LocalMessage, Logger, MarkChannelsReadOptions, MarkDeliveredOptions, MessageFilters, MessageFlagsFilters, MessageFlagsPaginationOptions, MessageFlagsResponse, MessageResponse, Mute, MuteUserOptions, MuteUserResponse, OGAttachment, OwnUserResponse, Pager, PartialMessageUpdate, PartialPollUpdate, PartialThreadUpdate, PartialUserUpdate, PermissionAPIResponse, PermissionsAPIResponse, PollAnswersAPIResponse, PollData, PollOptionData, PollSort, PollVote, PollVoteData, PollVotesAPIResponse, PredefinedFilterResponse, Product, PushPreference, PushProvider, PushProviderConfig, PushProviderID, PushProviderListResponse, PushProviderUpsertResponse, QueryChannelsAPIResponse, QueryDraftsResponse, QueryFutureChannelBansOptions, QueryMessageHistoryFilters, QueryMessageHistoryOptions, QueryMessageHistoryResponse, QueryMessageHistorySort, QueryPollsFilters, QueryPollsOptions, QueryPollsResponse, QueryReactionsAPIResponse, QueryReactionsOptions, QueryRemindersOptions, QueryRemindersResponse, QuerySegmentsOptions, QuerySegmentTargetsFilter, QueryTeamUsageStatsOptions, QueryTeamUsageStatsResponse, QueryThreadsOptions, QueryUserGroupsOptions, QueryUserGroupsResponse, QueryVotesFilters, QueryVotesOptions, ReactionFilters, ReactionResponse, ReactionSort, ReactivateUserOptions, ReactivateUsersOptions, ReminderAPIResponse, RemoveUserGroupMembersOptions, RemoveUserGroupMembersResponse, ReviewFlagReportOptions, ReviewFlagReportResponse, SdkIdentifier, SearchAPIResponse, SearchOptions, SearchRolesAPIResponse, SearchRolesOptions, SearchUserGroupsOptions, SearchUserGroupsResponse, SegmentData, SegmentResponse, SegmentTargetsResponse, SegmentType, SendFileAPIResponse, SetRetentionPolicyResponse, SharedLocationResponse, SortParam, StreamChatOptions, SyncOptions, SyncResponse, TaskResponse, TaskStatus, TestPushDataInput, TestSNSDataInput, TestSQSDataInput, TokenOrProvider, TranslateResponse, UnBanUserOptions, UpdateChannelsBatchOptions, UpdateChannelTypeRequest, UpdateChannelTypeResponse, UpdateCommandOptions, UpdateCommandResponse, UpdateLocationPayload, UpdateMessageAPIResponse, UpdateMessageOptions, UpdatePollAPIResponse, UpdatePredefinedFilterOptions, UpdateReminderOptions, UpdateSegmentData, UpdateUserGroupOptions, UpdateUserGroupResponse, UpdateUsersAPIResponse, UpsertPushPreferencesResponse, UserCustomEvent, UserFilters, UserOptions, UserResponse, UserSort, VoteSort } from './types';
+import type { ActiveLiveLocationsAPIResponse, AddUserGroupMembersOptions, AddUserGroupMembersResponse, APIErrorResponse, APIResponse, AppIdentifier, AppSettings, AppSettingsAPIResponse, BannedUsersFilters, BannedUsersPaginationOptions, BannedUsersResponse, BannedUsersSort, BanUserOptions, BaseDeviceFields, BlockList, BlockListResponse, BlockUserAPIResponse, CampaignData, CampaignFilters, CampaignQueryOptions, CampaignResponse, CampaignSort, CastVoteAPIResponse, ChannelAPIResponse, ChannelData, ChannelFilters, ChannelMute, ChannelOptions, ChannelResponse, ChannelSort, ChannelStateOptions, CheckPushResponse, CheckSNSResponse, CheckSQSResponse, Configs, ConnectAPIResponse, CreateChannelOptions, CreateChannelResponse, CreateCommandOptions, CreateCommandResponse, CreateImportOptions, CreateImportResponse, CreateImportURLResponse, CreatePollAPIResponse, CreatePollData, CreatePollOptionAPIResponse, CreatePredefinedFilterOptions, CreateReminderOptions, CreateRoleAPIResponse, CreateUserGroupOptions, CreateUserGroupResponse, CustomPermissionOptions, DeactivateUsersOptions, DeleteCommandResponse, DeleteMessageOptions, DeleteUserGroupOptions, DeleteUserOptions, Device, DeviceIdentifier, DraftFilters, DraftSort, EndpointName, Event, EventAPIResponse, EventHandler, ExportChannelOptions, ExportChannelRequest, ExportChannelResponse, ExportChannelStatusResponse, ExportUsersRequest, ExportUsersResponse, FlagMessageResponse, FlagReportsFilters, FlagReportsPaginationOptions, FlagReportsResponse, FlagsFilters, FlagsPaginationOptions, FlagsResponse, FlagUserResponse, FutureChannelBansResponse, GetBlockedUsersAPIResponse, GetCampaignOptions, GetChannelTypeResponse, GetCommandResponse, GetHookEventsResponse, GetImportResponse, GetMessageOptions, GetPollAPIResponse, GetRateLimitsResponse, GetRetentionPolicyResponse, GetRetentionPolicyRunsOptions, GetRetentionPolicyRunsResponse, GetThreadAPIResponse, GetThreadOptions, GetUnreadCountAPIResponse, GetUnreadCountBatchAPIResponse, GetUserGroupOptions, GetUserGroupResponse, ListChannelResponse, ListCommandsResponse, ListImportsPaginationOptions, ListImportsResponse, ListPredefinedFiltersOptions, ListPredefinedFiltersResponse, ListRolesAPIResponse, LocalMessage, Logger, MarkChannelsReadOptions, MarkDeliveredOptions, MessageFilters, MessageFlagsFilters, MessageFlagsPaginationOptions, MessageFlagsResponse, MessageResponse, Mute, MuteUserOptions, MuteUserResponse, OGAttachment, OwnUserResponse, Pager, PartialMessageUpdate, PartialPollUpdate, PartialThreadUpdate, PartialUserUpdate, PermissionAPIResponse, PermissionsAPIResponse, PollAnswersAPIResponse, PollData, PollOptionData, PollSort, PollVote, PollVoteData, PollVotesAPIResponse, PredefinedFilterResponse, Product, PushPreference, PushProvider, PushProviderConfig, PushProviderID, PushProviderListResponse, PushProviderUpsertResponse, QueryChannelsAPIResponse, QueryDraftsResponse, QueryFutureChannelBansOptions, QueryMessageHistoryFilters, QueryMessageHistoryOptions, QueryMessageHistoryResponse, QueryMessageHistorySort, QueryPollsFilters, QueryPollsOptions, QueryPollsResponse, QueryReactionsAPIResponse, QueryReactionsOptions, QueryRemindersOptions, QueryRemindersResponse, QuerySegmentsOptions, QuerySegmentTargetsFilter, QueryTeamUsageStatsOptions, QueryTeamUsageStatsResponse, QueryThreadsOptions, QueryUserGroupsOptions, QueryUserGroupsResponse, QueryVotesFilters, QueryVotesOptions, ReactionFilters, ReactionResponse, ReactionSort, ReactivateUserOptions, ReactivateUsersOptions, ReminderAPIResponse, RemoveUserGroupMembersOptions, RemoveUserGroupMembersResponse, RequestOptions, ReviewFlagReportOptions, ReviewFlagReportResponse, SdkIdentifier, SearchAPIResponse, SearchOptions, SearchRolesAPIResponse, SearchRolesOptions, SearchUserGroupsOptions, SearchUserGroupsResponse, SegmentData, SegmentResponse, SegmentTargetsResponse, SegmentType, SendFileAPIResponse, SetRetentionPolicyResponse, SharedLocationResponse, SortParam, StreamChatOptions, SyncOptions, SyncResponse, TaskResponse, TaskStatus, TestPushDataInput, TestSNSDataInput, TestSQSDataInput, TokenOrProvider, TranslateResponse, UnBanUserOptions, UpdateChannelsBatchOptions, UpdateChannelTypeRequest, UpdateChannelTypeResponse, UpdateCommandOptions, UpdateCommandResponse, UpdateLocationPayload, UpdateMessageAPIResponse, UpdateMessageOptions, UpdatePollAPIResponse, UpdatePredefinedFilterOptions, UpdateReminderOptions, UpdateSegmentData, UpdateUserGroupOptions, UpdateUserGroupResponse, UpdateUsersAPIResponse, UpsertPushPreferencesResponse, UserCustomEvent, UserFilters, UserOptions, UserResponse, UserSort, VoteSort } from './types';
 import { ErrorFromResponse } from './types';
 import { InsightMetrics } from './insights';
 import { Thread } from './thread';
@@ -406,9 +406,9 @@ export declare class StreamChat {
             maxBodyLength?: number;
         };
     }) => Promise<T>;
-    get<T>(url: string, params?: AxiosRequestConfig['params']): Promise<T>;
+    get<T>(url: string, params?: AxiosRequestConfig['params'], config?: Omit<AxiosRequestConfig, 'params'>): Promise<T>;
     put<T>(url: string, data?: unknown): Promise<T>;
-    post<T>(url: string, data?: unknown): Promise<T>;
+    post<T>(url: string, data?: unknown, config?: Omit<AxiosRequestConfig, 'params'>): Promise<T>;
     patch<T>(url: string, data?: unknown): Promise<T>;
     delete<T>(url: string, params?: AxiosRequestConfig['params']): Promise<T>;
     sendFile(url: string, uri: string | NodeJS.ReadableStream | Buffer | File, name?: string, contentType?: string, user?: UserResponse, axiosRequestConfig?: AxiosRequestConfig): Promise<SendFileAPIResponse>;
@@ -487,10 +487,11 @@ export declare class StreamChat {
      * @param {UserSort} sort Sort options, for instance [{last_active: -1}].
      * When using multiple fields, make sure you use array of objects to guarantee field order, for instance [{last_active: -1}, {created_at: 1}]
      * @param {UserOptions} options Option object, {presence: true}
+     * @param {RequestOptions} [requestOptions] Carries an abort signal. Not sent in the request.
      *
      * @return {Promise<{ users: Array<UserResponse> }>} User Query Response
      */
-    queryUsers(filterConditions: UserFilters, sort?: UserSort, options?: UserOptions): Promise<APIResponse & {
+    queryUsers(filterConditions: UserFilters, sort?: UserSort, options?: UserOptions, requestOptions?: RequestOptions): Promise<APIResponse & {
         users: Array<UserResponse>;
     }>;
     /**
@@ -522,10 +523,10 @@ export declare class StreamChat {
      * searchUserGroups - Search user groups by prefix for autocomplete
      *
      * @param {SearchUserGroupsOptions} options The search options
-     *
+     * @param {RequestOptions} [requestOptions] Carries an abort signal. Not sent in the request.
      * @return {Promise<SearchUserGroupsResponse>} User Group Search Response
      */
-    searchUserGroups(options: SearchUserGroupsOptions): Promise<SearchUserGroupsResponse>;
+    searchUserGroups(options: SearchUserGroupsOptions, requestOptions?: RequestOptions): Promise<SearchUserGroupsResponse>;
     /**
      * updateUserGroup - Update a user group by ID
      *
@@ -601,10 +602,11 @@ export declare class StreamChat {
      * @param {ChannelSort} [sort] Sort options, for instance {created_at: -1}.
      * When using multiple fields, make sure you use array of objects to guarantee field order, for instance [{last_updated: -1}, {created_at: 1}]
      * @param {ChannelOptions} [options] Options object. Can include predefined_filter, filter_values, and sort_values for using predefined filters.
+     * @param {RequestOptions} [requestOptions] Carries an abort signal. Not sent in the request.
      *
      * @return {Promise<QueryChannelsAPIResponse>} full search channels response
      */
-    queryChannelsRequestWithResponse(filterConditions: ChannelFilters, sort?: ChannelSort, options?: ChannelOptions): Promise<QueryChannelsAPIResponse>;
+    queryChannelsRequestWithResponse(filterConditions: ChannelFilters, sort?: ChannelSort, options?: ChannelOptions, requestOptions?: RequestOptions): Promise<QueryChannelsAPIResponse>;
     /**
      * queryChannelsRequest - Queries channels and returns the raw channel response list.
      *
@@ -632,6 +634,7 @@ export declare class StreamChat {
      * - stateOptions.skipInitialization - Skips the initialization of the state for the channels matching the ids in the list.
      * - stateOptions.skipHydration - Skips returning the channels as instances of the Channel class and rather returns the raw query response.
      * - stateOptions.withResponse - Returns the full query response with hydrated channels. This is a compatibility bridge for internal callers that need response-level metadata while the default return value remains `Channel[]`.
+     * - stateOptions.signal - Aborts the request. See AbortController.
      *
      * @return {Promise<Array<Channel>>} search channels response
      */
@@ -656,10 +659,11 @@ export declare class StreamChat {
      * @param {ChannelFilters} filterConditions MongoDB style filter conditions
      * @param {MessageFilters | string} query search query or object MongoDB style filters
      * @param {SearchOptions} [options] Option object, {user_id: 'tommaso'}
+     * @param {RequestOptions} [requestOptions] Carries an abort signal. Not sent in the request.
      *
      * @return {Promise<SearchAPIResponse>} search messages response
      */
-    search(filterConditions: ChannelFilters, query: string | MessageFilters, options?: SearchOptions): Promise<SearchAPIResponse>;
+    search(filterConditions: ChannelFilters, query: string | MessageFilters, options?: SearchOptions, requestOptions?: RequestOptions): Promise<SearchAPIResponse>;
     /**
      * setLocalDevice - Set the device info for the current client(device) that will be sent via WS connection automatically
      *
@@ -1427,7 +1431,7 @@ export declare class StreamChat {
      *
      * @returns {Promise<APIResponse>}
      */
-    searchRoles(options: SearchRolesOptions): Promise<SearchRolesAPIResponse>;
+    searchRoles(options: SearchRolesOptions, requestOptions?: RequestOptions): Promise<SearchRolesAPIResponse>;
     /** deleteRole - deletes a custom role
      *
      * @param {string} name the role name

package/dist/types/messageComposer/middleware/textComposer/mentions.d.ts

@@ -1,4 +1,4 @@
-import { BaseSearchSource, type SearchSourceOptions } from '../../../search';
+import { BaseSearchSource, type SearchQueryOptions, type SearchSourceOptions } from '../../../search';
 import type { ChannelMentionSuggestion, HereMentionSuggestion, MentionSuggestion, RoleMentionSuggestion, TextComposerMiddlewareOptions, UserGroupMentionSuggestion, UserSuggestion } from './types';
 import type { StreamChat } from '../../../client';
 import type { MemberFilters, MemberSort, UserFilters, UserGroupResponse, UserOptions, UserResponse, UserSort } from '../../../types';
@@ -11,6 +11,13 @@ export declare const accentsMap: {
 export declare const removeDiacritics: (text?: string) => string;
 export declare const calculateLevenshtein: (query: string, name: string) => number;
 export type MentionsSearchSourceOptions = SearchSourceOptions & {
+    /** Static base filters for the app-wide user query (mentionAllAppUsers). */
+    userFilters?: UserFilters;
+    userSort?: UserSort;
+    /** Static base filters for the channel member query. */
+    memberFilters?: MemberFilters;
+    memberSort?: MemberSort;
+    searchOptions?: Omit<UserOptions, 'limit' | 'offset'>;
     mentionAllAppUsers?: boolean;
     suggestionFactoryMappers?: MentionSuggestionFactoryMapperOverrides;
     textComposerText?: string;
@@ -56,7 +63,7 @@ export declare class MentionsSearchSource extends BaseSearchSource<MentionSugges
     userSort: UserSort | undefined;
     memberSort: MemberSort | undefined;
     searchOptions: Omit<UserOptions, 'limit' | 'offset'> | undefined;
-    config: MentionsSearchSourceOptions;
+    config: Pick<MentionsSearchSourceOptions, 'mentionAllAppUsers' | 'suggestionFactoryMappers' | 'textComposerText' | 'trigger'>;
     constructor(channel: Channel, options?: MentionsSearchSourceOptions);
     get allMembersLoadedWithInitialChannelQuery(): boolean;
     normalizeSearchValue: (value?: string) => string;
@@ -81,7 +88,6 @@ export declare class MentionsSearchSource extends BaseSearchSource<MentionSugges
         next?: string | null;
         offset?: number;
     };
-    canExecuteQuery: (newSearchString?: string) => boolean;
     protected updatePaginationStateFromQuery(): {
         hasNext: boolean;
         next: undefined;
@@ -90,7 +96,7 @@ export declare class MentionsSearchSource extends BaseSearchSource<MentionSugges
     transliterate: (text: string) => string;
     getMembersAndWatchers: () => UserResponse[];
     getBuiltinMentionSuggestions: (searchQuery: string) => MentionSuggestion[];
-    getRoleMentionSuggestions: (query: string) => Promise<RoleMentionSuggestion[]>;
+    getRoleMentionSuggestions: (query: string, queryOptions?: SearchQueryOptions) => Promise<RoleMentionSuggestion[]>;
     searchMembersLocally: (searchQuery: string) => UserResponse[];
     prepareQueryUsersParams: (searchQuery: string, offset?: number) => {
         filters: UserFilters;
@@ -112,18 +118,18 @@ export declare class MentionsSearchSource extends BaseSearchSource<MentionSugges
             presence?: boolean;
         };
     };
-    queryUsers: (searchQuery: string, offset?: number) => Promise<UserResponse[]>;
-    queryMembers: (searchQuery: string, offset?: number) => Promise<UserResponse[]>;
-    getUserSuggestionsPage: (searchQuery: string, userOffset?: number) => Promise<{
+    queryUsers: (searchQuery: string, offset?: number, queryOptions?: SearchQueryOptions) => Promise<UserResponse[]>;
+    queryMembers: (searchQuery: string, offset?: number, queryOptions?: SearchQueryOptions) => Promise<UserResponse[]>;
+    getUserSuggestionsPage: (searchQuery: string, userOffset?: number, queryOptions?: SearchQueryOptions) => Promise<{
         items: UserSuggestion[];
         nextOffset: number | undefined;
     }>;
     buildUserGroupSearchCursor: (items: UserGroupResponse[]) => string | undefined;
-    getUserGroupSuggestionsPage: (searchQuery: string, cursor?: string) => Promise<{
+    getUserGroupSuggestionsPage: (searchQuery: string, cursor?: string, queryOptions?: SearchQueryOptions) => Promise<{
         items: UserGroupMentionSuggestion[];
         next: string | undefined;
     }>;
-    query(searchQuery: string): Promise<{
+    query(searchQuery: string, queryOptions?: SearchQueryOptions): Promise<{
         items: MentionSuggestion[];
     }>;
     filterMutes(data: UserSuggestion[]): UserSuggestion[];

package/dist/types/offline-support/offline_support_api.d.ts

@@ -16,8 +16,14 @@ export declare abstract class AbstractOfflineDB implements OfflineDBApi {
     private client;
     syncManager: OfflineDBSyncManager;
     state: StateStore<OfflineDBState>;
-    constructor({ client }: {
+    constructor({ client, syncMaxEventCount, }: {
         client: StreamChat;
+        /**
+         * Optional positive cap forwarded to the {@link OfflineDBSyncManager}, which
+         * owns sync. `undefined` or any non-positive value means "no limit". See
+         * {@link OfflineDBSyncManager.syncMaxEventCount}.
+         */
+        syncMaxEventCount?: number;
     });
     /**
      * @abstract

package/dist/types/offline-support/offline_sync_manager.d.ts

@@ -16,9 +16,20 @@ export declare class OfflineDBSyncManager {
     private scheduledSyncStatusCallbacks;
     private client;
     private offlineDb;
-    constructor({ client, offlineDb, }: {
+    /**
+     * Optional positive cap on the number of events a single `/sync` response may
+     * contain before this manager skips event replay into local storage and relies
+     * on the reconnect-time channel refresh (queryChannels + `channel.watch()`) to
+     * bring visible surfaces up to date.
+     *
+     * `undefined` or any non-positive value means "no limit" and event replay always
+     * runs with whatever maximum the server decides to return.
+     */
+    readonly syncMaxEventCount?: number;
+    constructor({ client, offlineDb, syncMaxEventCount, }: {
         client: StreamChat;
         offlineDb: AbstractOfflineDB;
+        syncMaxEventCount?: number;
     });
     /**
      * Initializes the sync manager. Should only be called once per session.
@@ -58,6 +69,13 @@ export declare class OfflineDBSyncManager {
     private sync;
     /**
      * Executes any tasks that were queued while offline and then performs a sync.
+     *
+     * Each step is isolated so a failure in one does not prevent the other, and
+     * neither can escape to the callers (init + the connection.changed handler).
+     * This guarantees the subsequent invokeSyncStatusListeners(true) always runs,
+     * so syncStatus recovers to true and gated channel queries are unblocked.
+     * Failed syncs degrade to "possibly stale data until the next query" rather
+     * than freezing all future queries. See issue #1816.
      */
     private syncAndExecutePendingTasks;
 }

package/dist/types/search/BaseSearchSource.d.ts

@@ -1,10 +1,23 @@
 import { StateStore } from '../store';
 import { type DebouncedFunc } from '../utils';
 import type { QueryReturnValue, SearchSourceOptions, SearchSourceState, SearchSourceType } from './types';
+/**
+ * Passed to a search source's `query()`. Carries a cancellation handle and makes no
+ * claim that the query performs a request: a source may resolve from local data and
+ * ignore the signal. Where a source does issue requests, forward this straight through
+ * as the request options.
+ */
+export type SearchQueryOptions = {
+    /** Aborted once a newer query supersedes this one. */
+    signal?: AbortSignal;
+};
 export type DebounceOptions = {
-    debounceMs: number;
+    /** Applies to both short and long queries unless overridden by the options below. */
+    debounceMs?: number;
+    shortQueryDebounceMs?: number;
+    longQueryDebounceMs?: number;
+    shortQueryMaxLength?: number;
 };
-type DebouncedExecQueryFunction = DebouncedFunc<(searchString?: string) => Promise<void>>;
 interface ISearchSource<T = any> {
     activate(): void;
     canExecuteQuery(newSearchString?: string): boolean;
@@ -33,28 +46,36 @@ export interface SearchSourceSync<T = any> extends ISearchSource<T> {
     setDebounceOptions(options: DebounceOptions): void;
     search(text?: string): void;
 }
-declare abstract class BaseSearchSourceBase<T> implements ISearchSource<T> {
+declare abstract class BaseSearchSourceBase<T, R extends void | Promise<void>> implements ISearchSource<T> {
     state: StateStore<SearchSourceState<T>>;
     pageSize: number;
     protected allowEmptySearchString: boolean;
     protected resetOnNewSearchQuery: boolean;
+    protected shortQueryDebounceMs: number;
+    protected longQueryDebounceMs: number;
+    protected shortQueryMaxLength: number;
+    protected searchDebounced: DebouncedFunc<(searchString?: string) => R>;
     abstract readonly type: SearchSourceType;
     protected constructor(options?: SearchSourceOptions);
+    abstract executeQuery(newSearchString?: string): R;
+    setDebounceOptions: (options?: DebounceOptions) => void;
+    /**
+     * Short queries match too much and are slow server-side, so they get a longer debounce.
+     * Resolved per call, which is what lets the interval switch as the user keeps typing.
+     */
+    protected getDebounceMs: (searchString?: string) => number;
+    /**
+     * A new search query preempts an in-flight one; pagination waits for it to finish
+     * and needs a next page to fetch.
+     */
+    protected canDispatchQuery(hasNewSearchQuery: boolean): boolean;
+    search: (searchQuery?: string) => R | undefined;
     get lastQueryError(): Error | undefined;
     get hasNext(): boolean;
     get hasResults(): boolean;
     get isActive(): boolean;
     get isLoading(): boolean;
-    get initialState(): {
-        hasNext: boolean;
-        isActive: boolean;
-        isLoading: boolean;
-        items: undefined;
-        lastQueryError: undefined;
-        next: undefined;
-        offset: number;
-        searchQuery: string;
-    };
+    get initialState(): SearchSourceState<T>;
     get items(): T[] | undefined;
     get next(): string | null | undefined;
     get offset(): number | undefined;
@@ -72,24 +93,21 @@ declare abstract class BaseSearchSourceBase<T> implements ISearchSource<T> {
     resetState(): void;
     resetStateAndActivate(): void;
 }
-export declare abstract class BaseSearchSource<T> extends BaseSearchSourceBase<T> implements SearchSource<T> {
-    protected searchDebounced: DebouncedExecQueryFunction;
-    constructor(options?: SearchSourceOptions);
-    protected abstract query(searchQuery: string): Promise<QueryReturnValue<T>>;
+export declare abstract class BaseSearchSource<T> extends BaseSearchSourceBase<T, Promise<void>> implements SearchSource<T> {
+    /** Aborts the in-flight request, if any, once a newer query is dispatched. */
+    protected queryAbortController: AbortController | null;
+    protected abstract query(searchQuery: string, options?: SearchQueryOptions): Promise<QueryReturnValue<T>>;
     protected abstract filterQueryResults(items: T[]): T[] | Promise<T[]>;
-    setDebounceOptions: ({ debounceMs }: DebounceOptions) => void;
+    /** Aborts the in-flight request, if any. Returns true when one was aborted. */
+    protected abortInFlightQuery(): boolean;
+    resetState(): void;
     executeQuery(newSearchString?: string): Promise<void>;
-    search: (searchQuery?: string) => Promise<void> | undefined;
     cancelScheduledQuery(): void;
 }
-export declare abstract class BaseSearchSourceSync<T> extends BaseSearchSourceBase<T> implements SearchSourceSync<T> {
-    protected searchDebounced: DebouncedExecQueryFunction;
-    constructor(options?: SearchSourceOptions);
+export declare abstract class BaseSearchSourceSync<T> extends BaseSearchSourceBase<T, void> implements SearchSourceSync<T> {
     protected abstract query(searchQuery: string): QueryReturnValue<T>;
     protected abstract filterQueryResults(items: T[]): T[];
-    setDebounceOptions: ({ debounceMs }: DebounceOptions) => void;
     executeQuery(newSearchString?: string): void;
-    search: (searchQuery?: string) => Promise<void> | undefined;
     cancelScheduledQuery(): void;
 }
 export {};

package/dist/types/search/ChannelMemberSearchSource.d.ts

@@ -1,4 +1,4 @@
-import { BaseSearchSource } from './BaseSearchSource';
+import { BaseSearchSource, type SearchQueryOptions } from './BaseSearchSource';
 import { FilterBuilder, type FilterBuilderOptions } from '../pagination';
 import type { Channel } from '../channel';
 import type { ChannelMemberResponse, MemberFilters, MemberSort, QueryMembersOptions } from '../types';
@@ -7,6 +7,12 @@ type CustomContext = Record<string, unknown>;
 export type ChannelMemberSearchSourceFilterBuilderContext<C extends CustomContext = CustomContext> = {
     searchQuery?: string;
 } & C;
+export type ChannelMemberSearchSourceOptions = SearchSourceOptions & {
+    /** Static base filters merged under the dynamically generated ones. */
+    filters?: MemberFilters;
+    sort?: MemberSort;
+    searchOptions?: Omit<QueryMembersOptions, 'limit' | 'offset'>;
+};
 export declare class ChannelMemberSearchSource<TFilterContext extends CustomContext = CustomContext> extends BaseSearchSource<ChannelMemberResponse> {
     readonly type = "members";
     channel: Channel;
@@ -14,9 +20,8 @@ export declare class ChannelMemberSearchSource<TFilterContext extends CustomCont
     sort: MemberSort | undefined;
     searchOptions: Omit<QueryMembersOptions, 'limit' | 'offset'> | undefined;
     filterBuilder: FilterBuilder<MemberFilters, ChannelMemberSearchSourceFilterBuilderContext<TFilterContext>>;
-    constructor(channel: Channel, options?: SearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<MemberFilters, ChannelMemberSearchSourceFilterBuilderContext<TFilterContext>>);
-    canExecuteQuery: (newSearchString?: string) => boolean;
-    protected query(searchQuery: string): Promise<{
+    constructor(channel: Channel, options?: ChannelMemberSearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<MemberFilters, ChannelMemberSearchSourceFilterBuilderContext<TFilterContext>>);
+    protected query(searchQuery: string, queryOptions?: SearchQueryOptions): Promise<{
         items: ChannelMemberResponse[];
     }>;
     protected filterQueryResults(items: ChannelMemberResponse[]): ChannelMemberResponse[];

package/dist/types/search/ChannelSearchSource.d.ts

@@ -1,4 +1,4 @@
-import { BaseSearchSource } from './BaseSearchSource';
+import { BaseSearchSource, type SearchQueryOptions } from './BaseSearchSource';
 import type { FilterBuilderOptions } from '../pagination';
 import { FilterBuilder } from '../pagination';
 import type { Channel } from '../channel';
@@ -9,6 +9,12 @@ type CustomContext = Record<string, unknown>;
 export type ChannelSearchSourceFilterBuilderContext<C extends CustomContext = CustomContext> = {
     searchQuery?: string;
 } & C;
+export type ChannelSearchSourceOptions = SearchSourceOptions & {
+    /** Static base filters merged under the dynamically generated ones. */
+    filters?: ChannelFilters;
+    sort?: ChannelSort;
+    searchOptions?: Omit<ChannelOptions, 'limit' | 'offset'>;
+};
 export declare class ChannelSearchSource<TFilterContext extends CustomContext = CustomContext> extends BaseSearchSource<Channel> {
     readonly type = "channels";
     client: StreamChat;
@@ -16,8 +22,8 @@ export declare class ChannelSearchSource<TFilterContext extends CustomContext =
     sort: ChannelSort | undefined;
     searchOptions: Omit<ChannelOptions, 'limit' | 'offset'> | undefined;
     filterBuilder: FilterBuilder<ChannelFilters, ChannelSearchSourceFilterBuilderContext<TFilterContext>>;
-    constructor(client: StreamChat, options?: SearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<ChannelFilters, ChannelSearchSourceFilterBuilderContext<TFilterContext>>);
-    protected query(searchQuery: string): Promise<{
+    constructor(client: StreamChat, options?: ChannelSearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<ChannelFilters, ChannelSearchSourceFilterBuilderContext<TFilterContext>>);
+    protected query(searchQuery: string, queryOptions?: SearchQueryOptions): Promise<{
         items: Channel[];
     }>;
     protected filterQueryResults(items: Channel[]): Channel[];

package/dist/types/search/MessageSearchSource.d.ts

@@ -1,4 +1,4 @@
-import { BaseSearchSource } from './BaseSearchSource';
+import { BaseSearchSource, type SearchQueryOptions } from './BaseSearchSource';
 import type { ChannelFilters, ChannelOptions, ChannelSort, MessageFilters, MessageResponse, SearchMessageSort } from '../types';
 import type { StreamChat } from '../client';
 import type { SearchSourceOptions } from './types';
@@ -26,6 +26,17 @@ export type MessageSearchSourceFilterBuilderOptions<TContexts extends MessageSea
     messageSearch: FilterBuilderOptions<MessageFilters, MergeContext<BuiltInContexts['messageSearch'], TContexts['messageSearchContext']>>;
     channelQuery: FilterBuilderOptions<ChannelFilters, MergeContext<BuiltInContexts['channelQuery'], TContexts['channelQueryContext']>>;
 }>;
+export type MessageSearchSourceOptions = SearchSourceOptions & {
+    /** Static base filters for the channel scope of the message search. */
+    messageSearchChannelFilters?: ChannelFilters;
+    /** Static base filters for the message search itself. */
+    messageSearchFilters?: MessageFilters;
+    messageSearchSort?: SearchMessageSort;
+    /** Static base filters for the follow-up query that hydrates unknown channels. */
+    channelQueryFilters?: ChannelFilters;
+    channelQuerySort?: ChannelSort;
+    channelQueryOptions?: Omit<ChannelOptions, 'limit' | 'offset'>;
+};
 export declare class MessageSearchSource<TContexts extends MessageSearchSourceContexts = {}> extends BaseSearchSource<MessageResponse> {
     readonly type = "messages";
     private client;
@@ -38,8 +49,8 @@ export declare class MessageSearchSource<TContexts extends MessageSearchSourceCo
     messageSearchChannelFilterBuilder: FilterBuilder<ChannelFilters, MergeContext<BuiltInContexts['messageSearchChannel'], TContexts['messageSearchChannelContext']>>;
     messageSearchFilterBuilder: FilterBuilder<MessageFilters, MergeContext<BuiltInContexts['messageSearch'], TContexts['messageSearchContext']>>;
     channelQueryFilterBuilder: FilterBuilder<ChannelFilters, MergeContext<BuiltInContexts['channelQuery'], TContexts['channelQueryContext']>>;
-    constructor(client: StreamChat, options?: SearchSourceOptions, filterBuilderOptions?: MessageSearchSourceFilterBuilderOptions<TContexts>);
-    protected query(searchQuery: string): Promise<{
+    constructor(client: StreamChat, options?: MessageSearchSourceOptions, filterBuilderOptions?: MessageSearchSourceFilterBuilderOptions<TContexts>);
+    protected query(searchQuery: string, queryOptions?: SearchQueryOptions): Promise<{
         items: never[];
         next?: undefined;
     } | {

package/dist/types/search/UserSearchSource.d.ts

@@ -1,4 +1,4 @@
-import { BaseSearchSource } from './BaseSearchSource';
+import { BaseSearchSource, type SearchQueryOptions } from './BaseSearchSource';
 import { FilterBuilder, type FilterBuilderOptions } from '../pagination';
 import type { StreamChat } from '../client';
 import type { UserFilters, UserOptions, UserResponse, UserSort } from '../types';
@@ -7,6 +7,12 @@ type CustomContext = Record<string, unknown>;
 export type UserSearchSourceFilterBuilderContext<C extends CustomContext = CustomContext> = {
     searchQuery?: string;
 } & C;
+export type UserSearchSourceOptions = SearchSourceOptions & {
+    /** Static base filters merged under the dynamically generated ones. */
+    filters?: UserFilters;
+    sort?: UserSort;
+    searchOptions?: Omit<UserOptions, 'limit' | 'offset'>;
+};
 export declare class UserSearchSource<TFilterContext extends CustomContext = CustomContext> extends BaseSearchSource<UserResponse> {
     readonly type = "users";
     client: StreamChat;
@@ -14,8 +20,8 @@ export declare class UserSearchSource<TFilterContext extends CustomContext = Cus
     sort: UserSort | undefined;
     searchOptions: Omit<UserOptions, 'limit' | 'offset'> | undefined;
     filterBuilder: FilterBuilder<UserFilters, UserSearchSourceFilterBuilderContext<TFilterContext>>;
-    constructor(client: StreamChat, options?: SearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<UserFilters, UserSearchSourceFilterBuilderContext<TFilterContext>>);
-    protected query(searchQuery: string): Promise<{
+    constructor(client: StreamChat, options?: UserSearchSourceOptions, filterBuilderOptions?: FilterBuilderOptions<UserFilters, UserSearchSourceFilterBuilderContext<TFilterContext>>);
+    protected query(searchQuery: string, queryOptions?: SearchQueryOptions): Promise<{
         items: UserResponse[];
     }>;
     protected filterQueryResults(items: UserResponse[]): UserResponse[];

package/dist/types/search/types.d.ts

@@ -9,8 +9,21 @@ export type SearchSourceState<T = any> = {
     offset?: number;
 };
 export type SearchSourceOptions = {
-    /** The number of milliseconds to debounce the search query. The default interval is 300ms. */
+    /**
+     * Legacy single debounce interval. When set, it applies to both short and long queries,
+     * unless overridden by `shortQueryDebounceMs` / `longQueryDebounceMs`.
+     */
     debounceMs?: number;
+    /**
+     * Debounce interval for queries no longer than `shortQueryMaxLength`. Such queries have
+     * low selectivity and are expensive server-side, so they are debounced harder.
+     * Defaults to 500ms.
+     */
+    shortQueryDebounceMs?: number;
+    /** Debounce interval for queries longer than `shortQueryMaxLength`. Defaults to 300ms. */
+    longQueryDebounceMs?: number;
+    /** Query length (inclusive) that still counts as short. Defaults to 2. */
+    shortQueryMaxLength?: number;
     pageSize?: number;
     /** When true, the source can execute queries with an empty search string. Defaults to false. */
     allowEmptySearchString?: boolean;

package/dist/types/types.d.ts

@@ -121,6 +121,7 @@ export type AppSettingsAPIResponse = APIResponse & {
         moderation_dashboard_preferences?: Record<string, unknown> | null;
         moderation_audio_call_moderation_enabled?: boolean;
         moderation_enabled?: boolean;
+        moderation_flood_rules_enabled?: boolean;
         moderation_llm_configurability_enabled?: boolean;
         moderation_multitenant_blocklist_enabled?: boolean;
         moderation_video_call_moderation_enabled?: boolean;
@@ -259,6 +260,8 @@ export type QueryFutureChannelBansOptions = {
 };
 export type BlockListResponse = BlockList & {
     created_at?: string;
+    id?: string;
+    owner_user_id?: string;
     type?: string;
     updated_at?: string;
 };
@@ -878,6 +881,8 @@ export type UserResponse = CustomUserData & {
     anon?: boolean;
     banned?: boolean;
     blocked_user_ids?: string[];
+    /** Set on the user of a read event, marking when they last read the event's channel. */
+    channel_last_read_at?: string;
     created_at?: string;
     deactivated_at?: string;
     deleted_at?: string;
@@ -1003,7 +1008,13 @@ export type ChannelQueryOptions = {
     watch?: boolean;
     watchers?: PaginationOptions;
 };
-export type ChannelStateOptions = {
+/**
+ * Composed with RequestOptions because `queryChannels` carries the abort signal in this
+ * bag; neither the state flags nor the signal are serialized into the request. Declaring
+ * the composition keeps passing a RequestOptions here intentional rather than incidental
+ * structural compatibility.
+ */
+export type ChannelStateOptions = RequestOptions & {
     offlineMode?: boolean;
     skipInitialization?: string[];
     skipHydration?: boolean;
@@ -1348,6 +1359,11 @@ export type SearchOptions = {
     offset?: number;
     sort?: SearchMessageSort;
 };
+/** Per-request options that are never part of the serialized request payload. */
+export type RequestOptions = {
+    /** Aborts the request. See AbortController. */
+    signal?: AbortSignal;
+};
 export type StreamChatOptions = AxiosRequestConfig & {
     /**
      * Used to disable warnings that are triggered by using connectUser or connectAnonymousUser server-side.
@@ -2032,6 +2048,7 @@ export type BlockList = {
     is_confusable_folding_enabled?: boolean;
     is_leet_check_enabled?: boolean;
     is_plural_check_enabled?: boolean;
+    is_substring_matching_enabled?: boolean;
 };
 export type ChannelConfig = ChannelConfigFields & CreatedAtUpdatedAt & {
     commands?: CommandVariants[];
@@ -2326,6 +2343,8 @@ export type PermissionAPIObject = {
     level?: string;
     name?: string;
     owner?: boolean;
+    /** Resource type that defines ownership for this permission's action, e.g. 'Channel' for CreateMessage. */
+    owner_resource?: string;
     same_team?: boolean;
     tags?: string[];
 };

package/dist/types/utils.d.ts

@@ -227,7 +227,7 @@ export interface DebouncedFunc<T extends (...args: any[]) => any> {
      */
     flush(): ReturnType<T> | undefined;
 }
-export declare const debounce: <T extends (...args: any[]) => any>(fn: T, timeout?: number, { leading, trailing }?: {
+export declare const debounce: <T extends (...args: any[]) => any>(fn: T, timeout?: number | ((...args: Parameters<T>) => number), { leading, trailing }?: {
     leading?: boolean;
     trailing?: boolean;
 }) => DebouncedFunc<T>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stream-chat",
-  "version": "9.50.2",
+  "version": "9.51.0",
   "description": "JS SDK for the Stream Chat API",
   "homepage": "https://getstream.io/chat/",
   "author": {
@@ -52,9 +52,9 @@
   "dependencies": {
     "@types/jsonwebtoken": "^9.0.8",
     "@types/ws": "^8.18.1",
-    "axios": "^1.16.1",
+    "axios": "^1.19.0",
     "base64-js": "^1.5.1",
-    "form-data": "^4.0.5",
+    "form-data": "^4.0.6",
     "isomorphic-ws": "^5.0.0",
     "jsonwebtoken": "^9.0.3",
     "linkifyjs": "^4.3.3",
@@ -68,22 +68,22 @@
     "@semantic-release/git": "^10.0.1",
     "@types/node": "^22.19.19",
     "@types/sinon": "^10.0.6",
-    "@vitest/coverage-v8": "^4.1.7",
+    "@vitest/coverage-v8": "^4.1.10",
     "concurrently": "^9.2.1",
     "conventional-changelog-conventionalcommits": "^9.3.1",
     "dotenv": "^17.4.2",
-    "esbuild": "^0.28.0",
+    "esbuild": "^0.28.2",
     "eslint": "^9.39.4",
     "eslint-plugin-import": "^2.32.0",
     "globals": "^17.6.0",
     "husky": "^9.1.7",
     "lint-staged": "^17.0.5",
     "prettier": "^3.8.3",
-    "semantic-release": "^25.0.3",
+    "semantic-release": "^25.0.9",
     "sinon": "^12.0.1",
     "typescript": "^6.0.3",
     "typescript-eslint": "^8.59.4",
-    "vitest": "^4.1.7"
+    "vitest": "^4.1.10"
   },
   "scripts": {
     "build": "rm -rf dist && concurrently 'tsc' './scripts/bundle.mjs'",