stream-chat 9.43.0 → 9.43.2

package/dist/types/client.d.ts

@@ -1,5 +1,4 @@
 import type { AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
-import type WebSocket from 'isomorphic-ws';
 import { Channel } from './channel';
 import { ClientState } from './client_state';
 import { StableWSConnection } from './connection';
@@ -409,7 +408,6 @@ export declare class StreamChat {
     errorFromResponse(response: AxiosResponse<APIErrorResponse>): ErrorFromResponse<APIErrorResponse>;
     handleResponse<T>(response: AxiosResponse<T>): T;
     dispatchEvent: (event: Event) => void;
-    handleEvent: (messageEvent: WebSocket.MessageEvent) => void;
     /**
      * Updates the members, watchers and read references of the currently active channels that contain this user
      *
@@ -1033,6 +1031,8 @@ export declare class StreamChat {
         member?: import("./types").ChannelMemberResponse;
         mentioned_users?: UserResponse[];
         mentioned_channel?: boolean;
+        mentioned_here?: boolean;
+        mentioned_roles?: string[];
         message_text_updated_at?: string;
         moderation?: import("./types").ModerationResponse;
         moderation_details?: import("./types").ModerationDetailsResponse;
@@ -1730,6 +1730,8 @@ export declare class StreamChat {
         member?: import("./types").ChannelMemberResponse;
         mentioned_users?: UserResponse[];
         mentioned_channel?: boolean;
+        mentioned_here?: boolean;
+        mentioned_roles?: string[];
         message_text_updated_at?: string;
         moderation?: import("./types").ModerationResponse;
         moderation_details?: import("./types").ModerationDetailsResponse;
@@ -2037,7 +2039,7 @@ export declare class StreamChat {
      *
      * @return {Promise<PredefinedFilterResponse>} The created predefined filter
      */
-    createPredefinedFilter(options: CreatePredefinedFilterOptions): Promise<PredefinedFilterResponse>;
+    createPredefinedFilter<F extends Record<string, unknown> = Record<string, unknown>>(options: CreatePredefinedFilterOptions<F>): Promise<PredefinedFilterResponse<F>>;
     /**
      * getPredefinedFilter - Gets a predefined filter by name (server-side only)
      *
@@ -2045,7 +2047,7 @@ export declare class StreamChat {
      *
      * @return {Promise<PredefinedFilterResponse>} The predefined filter
      */
-    getPredefinedFilter(name: string): Promise<PredefinedFilterResponse>;
+    getPredefinedFilter<F extends Record<string, unknown> = Record<string, unknown>>(name: string): Promise<PredefinedFilterResponse<F>>;
     /**
      * updatePredefinedFilter - Updates a predefined filter (server-side only)
      *
@@ -2054,7 +2056,7 @@ export declare class StreamChat {
      *
      * @return {Promise<PredefinedFilterResponse>} The updated predefined filter
      */
-    updatePredefinedFilter(name: string, options: UpdatePredefinedFilterOptions): Promise<PredefinedFilterResponse>;
+    updatePredefinedFilter<F extends Record<string, unknown> = Record<string, unknown>>(name: string, options: UpdatePredefinedFilterOptions<F>): Promise<PredefinedFilterResponse<F>>;
     /**
      * deletePredefinedFilter - Deletes a predefined filter (server-side only)
      *
@@ -2070,7 +2072,7 @@ export declare class StreamChat {
      *
      * @return {Promise<ListPredefinedFiltersResponse>} The list of predefined filters
      */
-    listPredefinedFilters(options?: ListPredefinedFiltersOptions): Promise<ListPredefinedFiltersResponse>;
+    listPredefinedFilters<F extends Record<string, unknown> = Record<string, unknown>>(options?: ListPredefinedFiltersOptions): Promise<ListPredefinedFiltersResponse<F>>;
     /**
      * setRetentionPolicy - Creates or updates a retention policy for the app.
      * Server-side only.

package/dist/types/messageComposer/attachmentManager.d.ts

@@ -42,7 +42,7 @@ export declare class AttachmentManager {
     get pendingUploadsCount(): number;
     get availableUploadSlots(): number;
     getUploadsByState(state: AttachmentLoadingState): LocalAttachment[];
-    private cancelAttachmentUploads;
+    cancelAttachmentUploads: (attachments?: LocalAttachment[]) => void;
     private normalizeSnapshotAttachment;
     initState: ({ message }?: {
         message?: DraftMessage | LocalMessage;

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

@@ -2,6 +2,7 @@ export * from './activeCommandGuard';
 export * from './commands';
 export * from './commandEffects';
 export * from './commandStringExtraction';
+export * from './commandUtils';
 export * from './mentions';
 export * from './validation';
 export * from './TextComposerMiddlewareExecutor';

package/dist/types/types.d.ts

@@ -81,6 +81,7 @@ export type AppSettingsAPIResponse = APIResponse & {
             uploads?: boolean;
             url_enrichment?: boolean;
             user_message_reminders?: boolean;
+            push_level?: 'all' | 'all_mentions' | 'direct_mentions' | 'mentions' | 'none' | '';
         }>;
         reminders_interval: number;
         async_moderation_config?: AsyncModerationOptions;
@@ -115,9 +116,11 @@ export type AppSettingsAPIResponse = APIResponse & {
         max_aggregated_activities_length?: number;
         moderation_bulk_submit_action_enabled?: boolean;
         moderation_dashboard_preferences?: Record<string, unknown> | null;
+        moderation_audio_call_moderation_enabled?: boolean;
         moderation_enabled?: boolean;
         moderation_llm_configurability_enabled?: boolean;
         moderation_multitenant_blocklist_enabled?: boolean;
+        moderation_video_call_moderation_enabled?: boolean;
         moderation_webhook_url?: string;
         multi_tenant_enabled?: boolean;
         name?: string;
@@ -450,8 +453,8 @@ export type LocalMessageBase = Omit<MessageResponseBase, 'created_at' | 'deleted
     updated_at: Date;
 };
 export type LocalMessage = LocalMessageBase & {
-    error?: ErrorFromResponse<APIErrorResponse>;
-    quoted_message?: LocalMessageBase;
+    error?: ErrorFromResponse<APIErrorResponse> | null;
+    quoted_message?: LocalMessageBase | null;
 };
 /**
  * @deprecated in favor of LocalMessage
@@ -627,6 +630,8 @@ export type MessageResponseBase = MessageBase & {
     member?: ChannelMemberResponse;
     mentioned_users?: UserResponse[];
     mentioned_channel?: boolean;
+    mentioned_here?: boolean;
+    mentioned_roles?: string[];
     message_text_updated_at?: string;
     moderation?: ModerationResponse;
     moderation_details?: ModerationDetailsResponse;
@@ -658,6 +663,12 @@ export type ReactionGroupResponse = {
     sum_scores: number;
     first_reaction_at?: string;
     last_reaction_at?: string;
+    latest_reactions_by?: ReactionGroupUserResponse[];
+};
+export type ReactionGroupUserResponse = {
+    created_at: string;
+    user_id: string;
+    user?: UserResponse;
 };
 export type ModerationDetailsResponse = {
     action: 'MESSAGE_RESPONSE_ACTION_BOUNCE' | (string & {});
@@ -889,13 +900,29 @@ export type ChannelOptions = {
     user_id?: string;
     watch?: boolean;
     /**
-     * Name of a predefined filter to use instead of filter_conditions.
-     * When provided, filter_conditions and sort parameters are ignored.
+     * Name of a predefined filter to use instead of sending raw
+     * `filter_conditions`.
+     *
+     * The backend resolves the filter template by name and interpolates it using
+     * `filter_values`.
+     *
+     * A regular `sort` can still be passed to `queryChannels()`, but backend
+     * precedence rules apply:
+     *
+     * - if the predefined filter has its own stored sort template, that stored
+     *   sort takes precedence and the request `sort` is ignored
+     * - if the predefined filter does not define a sort template, the request
+     *   `sort` can still be used
      */
     predefined_filter?: string;
     /**
-     * Values to interpolate into the predefined filter template placeholders.
-     * Only used when predefined_filter is provided.
+     * Values used to interpolate placeholders inside the predefined filter's
+     * `filter` template.
+     *
+     * Example: a template value like `{{user_id}}` can be resolved with
+     * `{ user_id: 'alice' }`.
+     *
+     * Only used when `predefined_filter` is provided.
      */
     filter_values?: Record<string, unknown>;
     /**
@@ -1964,6 +1991,7 @@ export type ChannelConfigFields = {
     uploads?: boolean;
     url_enrichment?: boolean;
     user_message_reminders?: boolean;
+    push_level?: 'all' | 'all_mentions' | 'direct_mentions' | 'mentions' | 'none' | '';
 };
 export type ChannelConfigWithInfo = ChannelConfigFields & CreatedAtUpdatedAt & {
     commands?: CommandResponse[];
@@ -2184,9 +2212,12 @@ export type Mute = {
     updated_at: string;
     user: UserResponse;
 };
+export type PartialUpdateChannelFields = Partial<ChannelResponse> & {
+    config_overrides?: Partial<ChannelConfigFields>;
+};
 export type PartialUpdateChannel = {
-    set?: Partial<ChannelResponse>;
-    unset?: Array<keyof ChannelResponse>;
+    set?: PartialUpdateChannelFields;
+    unset?: Array<keyof PartialUpdateChannelFields>;
 };
 export type PartialUpdateMember = {
     set?: ChannelMemberUpdates;
@@ -3495,33 +3526,114 @@ export type UpdateChannelsBatchResponse = {
  */
 export type PredefinedFilterOperation = 'QueryChannels';
 export type PredefinedFilterSortParam = {
+    /**
+     * Field name to sort by.
+     *
+     * This may be a literal field name such as `created_at`, or a placeholder
+     * template such as `{{sort_field}}` that will be interpolated server-side.
+     */
     field: string;
+    /**
+     * Sort direction. `1` means ascending and `-1` means descending.
+     *
+     * The backend defaults this to `1` when omitted.
+     */
     direction?: AscDesc;
+    /**
+     * Optional server-side hint describing how the sort field value should be
+     * interpreted.
+     *
+     * This is mainly relevant for predefined-filter sort templates and is not
+     * part of the regular `queryChannels()` sort shape. Omitting it uses the
+     * backend default string behavior. Known backend values include:
+     *
+     * - `number`: cast custom-field values to numeric before sorting
+     * - `boolean`: cast custom-field values to boolean before sorting
+     *
+     * Other values are backend-defined. In most cases this should be omitted
+     * unless you are sorting by a custom field whose stored JSON value is not
+     * string-like.
+     */
     type?: string;
 };
-export type PredefinedFilter = {
+/**
+ * Stored predefined filter definition as returned by the server.
+ *
+ * `F` represents the raw filter template shape. It defaults to a generic record
+ * because predefined filters are server-managed templates and may include
+ * placeholders or app-specific structures.
+ */
+export type PredefinedFilter<F extends Record<string, unknown> = Record<string, unknown>> = {
+    /**
+     * Unique predefined filter name within the app.
+     */
     name: string;
+    /**
+     * Operation this predefined filter is valid for.
+     */
     operation: PredefinedFilterOperation;
-    filter: Record<string, unknown>;
+    /**
+     * Filter template stored on the server.
+     *
+     * This is not necessarily the fully interpolated runtime filter; placeholder
+     * values such as `{{user_id}}` may still be present.
+     */
+    filter: F;
+    /**
+     * Server creation timestamp in ISO-8601 format.
+     */
     created_at: string;
+    /**
+     * Server update timestamp in ISO-8601 format.
+     */
     updated_at: string;
+    /**
+     * Optional human-readable description.
+     */
     description?: string;
+    /**
+     * Optional sort template stored with the predefined filter.
+     */
     sort?: PredefinedFilterSortParam[];
+    /**
+     * Query identifier generated by the backend for the filter/sort pattern.
+     *
+     * The exact value is backend-generated and primarily useful for correlating
+     * predefined filters with query analysis / query performance data.
+     */
     query_id?: number;
 };
-export type CreatePredefinedFilterOptions = {
+export type CreatePredefinedFilterOptions<F extends Record<string, unknown> = Record<string, unknown>> = {
+    /**
+     * Unique predefined filter name.
+     */
     name: string;
+    /**
+     * Operation this predefined filter will be used with.
+     */
     operation: PredefinedFilterOperation;
-    filter: Record<string, unknown>;
+    /**
+     * Filter template to store on the server.
+     */
+    filter: F;
+    /**
+     * Optional human-readable description.
+     */
     description?: string;
+    /**
+     * Optional sort template stored with the predefined filter.
+     */
     sort?: PredefinedFilterSortParam[];
 };
-export type UpdatePredefinedFilterOptions = Omit<CreatePredefinedFilterOptions, 'name'>;
-export type PredefinedFilterResponse = APIResponse & {
-    predefined_filter: PredefinedFilter;
+export type UpdatePredefinedFilterOptions<F extends Record<string, unknown> = Record<string, unknown>> = Omit<CreatePredefinedFilterOptions<F>, 'name'>;
+export type PredefinedFilterResponse<F extends Record<string, unknown> = Record<string, unknown>> = APIResponse & {
+    predefined_filter: PredefinedFilter<F>;
 };
-export type ListPredefinedFiltersResponse = APIResponse & {
-    predefined_filters: PredefinedFilter[];
+/**
+ * Paginated response returned when listing predefined filters.
+ */
+export type ListPredefinedFiltersResponse<F extends Record<string, unknown> = Record<string, unknown>> = APIResponse & {
+    predefined_filters: PredefinedFilter<F>[];
     next?: string;
     prev?: string;
 };
@@ -3529,9 +3641,18 @@ export type ListPredefinedFiltersResponse = APIResponse & {
  * Contains the interpolated filter and sort from a predefined filter.
  * This is returned in the QueryChannels response when using a predefined filter.
  */
-export type ParsedPredefinedFilterResponse = {
+export type ParsedPredefinedFilterResponse<F extends Record<string, unknown> = Record<string, unknown>> = {
+    /**
+     * Name of the predefined filter that was resolved.
+     */
     name: string;
-    filter: Record<string, unknown>;
+    /**
+     * Fully interpolated filter that the backend executed.
+     */
+    filter: F;
+    /**
+     * Fully interpolated sort parameters resolved from the predefined filter.
+     */
     sort?: PredefinedFilterSortParam[];
 };
 export type PredefinedFilterSort = SortParam[];

package/dist/types/utils.d.ts

@@ -122,6 +122,8 @@ export declare const toDeletedMessage: ({ message, deletedAt, hardDelete, }: {
     deleted_reply_count?: number | undefined;
     member?: import("./types").ChannelMemberResponse | undefined;
     mentioned_channel?: boolean | undefined;
+    mentioned_here?: boolean | undefined;
+    mentioned_roles?: string[] | undefined;
     message_text_updated_at?: string | undefined;
     moderation?: import("./types").ModerationResponse | undefined;
     moderation_details?: import("./types").ModerationDetailsResponse | undefined;
@@ -142,8 +144,8 @@ export declare const toDeletedMessage: ({ message, deletedAt, hardDelete, }: {
     pinned_at: Date | null;
     status: string;
     updated_at: Date;
-    error?: import("./types").ErrorFromResponse<import("./types").APIErrorResponse>;
-    quoted_message?: LocalMessageBase;
+    error?: import("./types").ErrorFromResponse<import("./types").APIErrorResponse> | null;
+    quoted_message?: LocalMessageBase | null;
 };
 export declare const deleteUserMessages: ({ messages, user, hardDelete, deletedAt, }: {
     messages: Array<LocalMessage>;

package/package.json

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

package/src/client.ts

@@ -4,7 +4,6 @@
 import type { AxiosError, AxiosInstance, AxiosRequestConfig, AxiosResponse } from 'axios';
 import axios from 'axios';
 import https from 'https';
-import type WebSocket from 'isomorphic-ws';
 
 import { Channel } from './channel';
 import { ClientState } from './client_state';
@@ -1381,13 +1380,6 @@ export class StreamChat {
     });
   };
 
-  handleEvent = (messageEvent: WebSocket.MessageEvent) => {
-    // dispatch the event to the channel listeners
-    const jsonString = messageEvent.data as string;
-    const event = JSON.parse(jsonString) as Event;
-    this.dispatchEvent(event);
-  };
-
   /**
    * Updates the members, watchers and read references of the currently active channels that contain this user
    *
@@ -1915,6 +1907,7 @@ export class StreamChat {
     }
 
     const { predefined_filter, filter_values, sort_values, ...restOptions } = options;
+    const normalizedSort = normalizeQuerySort(sort);
 
     // Build payload based on whether we're using a predefined filter or traditional filters
     const payload = predefined_filter
@@ -1922,12 +1915,13 @@ export class StreamChat {
           predefined_filter,
           filter_values,
           sort_values,
+          sort: normalizedSort,
           ...defaultOptions,
           ...restOptions,
         }
       : {
           filter_conditions: filterConditions,
-          sort: normalizeQuerySort(sort),
+          sort: normalizedSort,
           ...defaultOptions,
           ...restOptions,
         };
@@ -1937,6 +1931,9 @@ export class StreamChat {
       payload,
     );
 
+    // FIXME: In the next major release, return the full QueryChannelsAPIResponse
+    // instead of only `data.channels` so top-level metadata such as
+    // `predefined_filter` is not lost.
     return data.channels;
   }
 
@@ -4989,9 +4986,11 @@ export class StreamChat {
    *
    * @return {Promise<PredefinedFilterResponse>} The created predefined filter
    */
-  async createPredefinedFilter(options: CreatePredefinedFilterOptions) {
+  async createPredefinedFilter<
+    F extends Record<string, unknown> = Record<string, unknown>,
+  >(options: CreatePredefinedFilterOptions<F>) {
     this.validateServerSideAuth();
-    return await this.post<PredefinedFilterResponse>(
+    return await this.post<PredefinedFilterResponse<F>>(
       `${this.baseURL}/predefined_filters`,
       options,
     );
@@ -5004,9 +5003,11 @@ export class StreamChat {
    *
    * @return {Promise<PredefinedFilterResponse>} The predefined filter
    */
-  async getPredefinedFilter(name: string) {
+  async getPredefinedFilter<F extends Record<string, unknown> = Record<string, unknown>>(
+    name: string,
+  ) {
     this.validateServerSideAuth();
-    return await this.get<PredefinedFilterResponse>(
+    return await this.get<PredefinedFilterResponse<F>>(
       `${this.baseURL}/predefined_filters/${encodeURIComponent(name)}`,
     );
   }
@@ -5019,9 +5020,11 @@ export class StreamChat {
    *
    * @return {Promise<PredefinedFilterResponse>} The updated predefined filter
    */
-  async updatePredefinedFilter(name: string, options: UpdatePredefinedFilterOptions) {
+  async updatePredefinedFilter<
+    F extends Record<string, unknown> = Record<string, unknown>,
+  >(name: string, options: UpdatePredefinedFilterOptions<F>) {
     this.validateServerSideAuth();
-    return await this.put<PredefinedFilterResponse>(
+    return await this.put<PredefinedFilterResponse<F>>(
       `${this.baseURL}/predefined_filters/${encodeURIComponent(name)}`,
       options,
     );
@@ -5048,10 +5051,12 @@ export class StreamChat {
    *
    * @return {Promise<ListPredefinedFiltersResponse>} The list of predefined filters
    */
-  async listPredefinedFilters(options: ListPredefinedFiltersOptions = {}) {
+  async listPredefinedFilters<
+    F extends Record<string, unknown> = Record<string, unknown>,
+  >(options: ListPredefinedFiltersOptions = {}) {
     this.validateServerSideAuth();
     const { sort, ...paginationOptions } = options;
-    return await this.get<ListPredefinedFiltersResponse>(
+    return await this.get<ListPredefinedFiltersResponse<F>>(
       `${this.baseURL}/predefined_filters`,
       {
         ...paginationOptions,

package/src/connection.ts

@@ -477,12 +477,13 @@ export class StableWSConnection {
     if (this.wsID !== wsID) return;
 
     this._log('onmessage() - onmessage callback', { event, wsID });
-    const data = typeof event.data === 'string' ? JSON.parse(event.data) : null;
+    if (typeof event.data !== 'string') return;
+    const data = JSON.parse(event.data);
 
     // we wait till the first message before we consider the connection open..
     // the reason for this is that auth errors and similar errors trigger a ws.onopen and immediately
     // after that a ws.onclose..
-    if (!this.isResolved && data) {
+    if (!this.isResolved) {
       this.isResolved = true;
       if (data.error) {
         this.rejectPromise?.(this._errorFromWSEvent(data, false));
@@ -496,11 +497,11 @@ export class StableWSConnection {
     // trigger the event..
     this.lastEvent = new Date();
 
-    if (data && data.type === 'health.check') {
+    if (data.type === 'health.check') {
       this.scheduleNextPing();
     }
 
-    this.client.handleEvent(event);
+    this.client.dispatchEvent(data);
     this.scheduleConnectionCheck();
   };
 

package/src/messageComposer/MessageComposerEffectHandlers.ts

@@ -34,7 +34,9 @@ const applyCommandActivationEffect: MessageComposerEffectHandler<
     selection: { start: 0, end: 0 },
     text: '',
   });
+  const attachmentsToCancel = composer.attachmentManager.attachments;
   composer.attachmentManager.initState();
+  composer.attachmentManager.cancelAttachmentUploads(attachmentsToCancel);
   composer.linkPreviewsManager.initState();
   composer.locationComposer.initState();
   composer.pollComposer.initState();

package/src/messageComposer/attachmentManager.ts

@@ -210,7 +210,7 @@ export class AttachmentManager {
     );
   }
 
-  private cancelAttachmentUploads = (attachments: LocalAttachment[]) => {
+  cancelAttachmentUploads = (attachments: LocalAttachment[] = this.attachments) => {
     for (const { localMetadata } of attachments) {
       this.client.uploadManager.deleteUploadRecord(localMetadata.id);
     }
@@ -232,7 +232,6 @@ export class AttachmentManager {
   };
 
   initState = ({ message }: { message?: DraftMessage | LocalMessage } = {}) => {
-    this.cancelAttachmentUploads(this.attachments);
     this.state.next(initState({ message }));
   };
 

package/src/messageComposer/middleware/textComposer/index.ts

@@ -2,6 +2,7 @@ export * from './activeCommandGuard';
 export * from './commands';
 export * from './commandEffects';
 export * from './commandStringExtraction';
+export * from './commandUtils';
 export * from './mentions';
 export * from './validation';
 export * from './TextComposerMiddlewareExecutor';