stream-chat 9.12.0 → 9.14.0

package/dist/types/client.d.ts

@@ -7,7 +7,7 @@ import { TokenManager } from './token_manager';
 import { WSConnectionFallback } from './connection_fallback';
 import { Campaign } from './campaign';
 import { Segment } from './segment';
-import type { ActiveLiveLocationsAPIResponse, APIErrorResponse, APIResponse, 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, CreateReminderOptions, CustomPermissionOptions, DeactivateUsersOptions, DeleteCommandResponse, DeleteUserOptions, Device, DeviceIdentifier, DraftFilters, DraftSort, EndpointName, Event, EventHandler, ExportChannelOptions, ExportChannelRequest, ExportChannelResponse, ExportChannelStatusResponse, ExportUsersRequest, ExportUsersResponse, FlagMessageResponse, FlagReportsFilters, FlagReportsPaginationOptions, FlagReportsResponse, FlagsFilters, FlagsPaginationOptions, FlagsResponse, FlagUserResponse, GetBlockedUsersAPIResponse, GetCampaignOptions, GetChannelTypeResponse, GetCommandResponse, GetImportResponse, GetMessageOptions, GetPollAPIResponse, GetRateLimitsResponse, GetThreadAPIResponse, GetThreadOptions, GetUnreadCountAPIResponse, GetUnreadCountBatchAPIResponse, ListChannelResponse, ListCommandsResponse, ListImportsPaginationOptions, ListImportsResponse, LocalMessage, Logger, MarkChannelsReadOptions, MessageFilters, MessageFlagsFilters, MessageFlagsPaginationOptions, MessageFlagsResponse, MessageResponse, Mute, MuteUserOptions, MuteUserResponse, OGAttachment, OwnUserResponse, Pager, PartialMessageUpdate, PartialPollUpdate, PartialThreadUpdate, PartialUserUpdate, PermissionAPIResponse, PermissionsAPIResponse, PollAnswersAPIResponse, PollData, PollOptionData, PollSort, PollVote, PollVoteData, PollVotesAPIResponse, PushPreference, PushProvider, PushProviderConfig, PushProviderID, PushProviderListResponse, PushProviderUpsertResponse, QueryDraftsResponse, QueryMessageHistoryFilters, QueryMessageHistoryOptions, QueryMessageHistoryResponse, QueryMessageHistorySort, QueryPollsFilters, QueryPollsOptions, QueryPollsResponse, QueryReactionsAPIResponse, QueryReactionsOptions, QueryRemindersOptions, QueryRemindersResponse, QuerySegmentsOptions, QuerySegmentTargetsFilter, QueryThreadsOptions, QueryVotesFilters, QueryVotesOptions, ReactionFilters, ReactionResponse, ReactionSort, ReactivateUserOptions, ReactivateUsersOptions, ReminderAPIResponse, ReviewFlagReportOptions, ReviewFlagReportResponse, SdkIdentifier, SearchAPIResponse, SearchOptions, SegmentData, SegmentResponse, SegmentTargetsResponse, SegmentType, SendFileAPIResponse, SharedLocationResponse, SortParam, StreamChatOptions, SyncOptions, SyncResponse, TaskResponse, TaskStatus, TestPushDataInput, TestSNSDataInput, TestSQSDataInput, TokenOrProvider, TranslateResponse, UnBanUserOptions, UpdateChannelTypeRequest, UpdateChannelTypeResponse, UpdateCommandOptions, UpdateCommandResponse, UpdateLocationPayload, UpdateMessageAPIResponse, UpdateMessageOptions, UpdatePollAPIResponse, UpdateReminderOptions, UpdateSegmentData, UpsertPushPreferencesResponse, UserCustomEvent, UserFilters, UserOptions, UserResponse, UserSort, VoteSort } from './types';
+import type { ActiveLiveLocationsAPIResponse, APIErrorResponse, APIResponse, 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, CreateReminderOptions, CustomPermissionOptions, DeactivateUsersOptions, DeleteCommandResponse, DeleteUserOptions, Device, DeviceIdentifier, DraftFilters, DraftSort, EndpointName, Event, EventHandler, ExportChannelOptions, ExportChannelRequest, ExportChannelResponse, ExportChannelStatusResponse, ExportUsersRequest, ExportUsersResponse, FlagMessageResponse, FlagReportsFilters, FlagReportsPaginationOptions, FlagReportsResponse, FlagsFilters, FlagsPaginationOptions, FlagsResponse, FlagUserResponse, GetBlockedUsersAPIResponse, GetCampaignOptions, GetChannelTypeResponse, GetCommandResponse, GetHookEventsResponse, GetImportResponse, GetMessageOptions, GetPollAPIResponse, GetRateLimitsResponse, GetThreadAPIResponse, GetThreadOptions, GetUnreadCountAPIResponse, GetUnreadCountBatchAPIResponse, ListChannelResponse, ListCommandsResponse, ListImportsPaginationOptions, ListImportsResponse, LocalMessage, Logger, MarkChannelsReadOptions, MessageFilters, MessageFlagsFilters, MessageFlagsPaginationOptions, MessageFlagsResponse, MessageResponse, Mute, MuteUserOptions, MuteUserResponse, OGAttachment, OwnUserResponse, Pager, PartialMessageUpdate, PartialPollUpdate, PartialThreadUpdate, PartialUserUpdate, PermissionAPIResponse, PermissionsAPIResponse, PollAnswersAPIResponse, PollData, PollOptionData, PollSort, PollVote, PollVoteData, PollVotesAPIResponse, Product, PushPreference, PushProvider, PushProviderConfig, PushProviderID, PushProviderListResponse, PushProviderUpsertResponse, QueryDraftsResponse, QueryMessageHistoryFilters, QueryMessageHistoryOptions, QueryMessageHistoryResponse, QueryMessageHistorySort, QueryPollsFilters, QueryPollsOptions, QueryPollsResponse, QueryReactionsAPIResponse, QueryReactionsOptions, QueryRemindersOptions, QueryRemindersResponse, QuerySegmentsOptions, QuerySegmentTargetsFilter, QueryThreadsOptions, QueryVotesFilters, QueryVotesOptions, ReactionFilters, ReactionResponse, ReactionSort, ReactivateUserOptions, ReactivateUsersOptions, ReminderAPIResponse, ReviewFlagReportOptions, ReviewFlagReportResponse, SdkIdentifier, SearchAPIResponse, SearchOptions, SegmentData, SegmentResponse, SegmentTargetsResponse, SegmentType, SendFileAPIResponse, SharedLocationResponse, SortParam, StreamChatOptions, SyncOptions, SyncResponse, TaskResponse, TaskStatus, TestPushDataInput, TestSNSDataInput, TestSQSDataInput, TokenOrProvider, TranslateResponse, UnBanUserOptions, UpdateChannelTypeRequest, UpdateChannelTypeResponse, UpdateCommandOptions, UpdateCommandResponse, UpdateLocationPayload, UpdateMessageAPIResponse, UpdateMessageOptions, UpdatePollAPIResponse, UpdateReminderOptions, UpdateSegmentData, UpsertPushPreferencesResponse, UserCustomEvent, UserFilters, UserOptions, UserResponse, UserSort, VoteSort } from './types';
 import { ErrorFromResponse } from './types';
 import { InsightMetrics } from './insights';
 import { Thread } from './thread';
@@ -619,6 +619,13 @@ export declare class StreamChat {
         serverSide?: boolean;
         web?: boolean;
     }): Promise<GetRateLimitsResponse>;
+    /**
+     * getHookEvents - Get available events for hooks (webhook, SQS, and SNS)
+     *
+     * @param {Product[]} [products] Optional array of products to filter events by (e.g., [Product.Chat, Product.Video])
+     * @returns {Promise<GetHookEventsResponse>} Response containing available hook events
+     */
+    getHookEvents(products?: Product[]): Promise<GetHookEventsResponse>;
     _addChannelConfig({ cid, config }: ChannelResponse): void;
     /**
      * channel - Returns a new channel with the given type, id and custom data

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

@@ -1,4 +1,5 @@
-import type { AttachmentManagerConfig, MinimumUploadRequestResult, UploadRequestFn } from './configuration';
+import type { AttachmentManagerConfig, UploadRequestFn } from './configuration';
+import { AttachmentPostUploadMiddlewareExecutor, AttachmentPreUploadMiddlewareExecutor } from './middleware/attachmentManager';
 import { StateStore } from '../store';
 import type { AttachmentLoadingState, FileLike, FileReference, LocalAttachment, LocalUploadAttachment, UploadPermissionCheckResult } from './types';
 import type { DraftMessage, LocalMessage } from '../types';
@@ -14,6 +15,8 @@ export type AttachmentManagerOptions = {
 export declare class AttachmentManager {
     readonly state: StateStore<AttachmentManagerState>;
     readonly composer: MessageComposer;
+    readonly preUploadMiddlewareExecutor: AttachmentPreUploadMiddlewareExecutor;
+    readonly postUploadMiddlewareExecutor: AttachmentPostUploadMiddlewareExecutor;
     private attachmentsByIdGetterCache;
     constructor({ composer, message }: AttachmentManagerOptions);
     get attachmentsById(): Record<string, LocalAttachment>;
@@ -47,6 +50,7 @@ export declare class AttachmentManager {
     upsertAttachments: (attachmentsToUpsert: LocalAttachment[]) => void;
     removeAttachments: (localAttachmentIds: string[]) => void;
     getUploadConfigCheck: (fileLike: FileReference | FileLike) => Promise<UploadPermissionCheckResult>;
+    static toLocalUploadAttachment: (fileLike: FileReference | FileLike) => LocalUploadAttachment;
     fileToLocalUploadAttachment: (fileLike: FileReference | FileLike) => Promise<LocalUploadAttachment>;
     private ensureLocalUploadAttachment;
     /**
@@ -60,7 +64,11 @@ export declare class AttachmentManager {
     /**
      * todo: docs how to customize the image and file upload by overriding do
      */
-    doUploadRequest: (fileLike: FileReference | FileLike) => Promise<MinimumUploadRequestResult>;
+    doUploadRequest: (fileLike: FileReference | FileLike) => Promise<{
+        file: string;
+        thumb_url?: string;
+    }>;
     uploadAttachment: (attachment: LocalUploadAttachment) => Promise<LocalUploadAttachment | undefined>;
-    uploadFiles: (files: FileReference[] | FileList | FileLike[]) => Promise<(LocalUploadAttachment | undefined)[] | undefined>;
+    uploadFile: (file: FileReference | FileLike) => Promise<LocalUploadAttachment>;
+    uploadFiles: (files: FileReference[] | FileList | FileLike[]) => Promise<LocalUploadAttachment[] | undefined>;
 }

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

@@ -4,7 +4,7 @@ import type { FileLike, FileReference } from '../types';
 export type MinimumUploadRequestResult = {
     file: string;
     thumb_url?: string;
-};
+} & Partial<Record<string, unknown>>;
 export type UploadRequestFn = (fileLike: FileReference | FileLike) => Promise<MinimumUploadRequestResult>;
 export type DraftsConfiguration = {
     enabled: boolean;

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

@@ -0,0 +1,3 @@
+export * from './postUpload';
+export * from './preUpload';
+export * from './types';

package/dist/types/messageComposer/middleware/attachmentManager/postUpload/AttachmentPostUploadMiddlewareExecutor.d.ts

@@ -0,0 +1,5 @@
+import { MiddlewareExecutor } from '../../../../middleware';
+import type { AttachmentPostUploadMiddlewareExecutorOptions, AttachmentPostUploadMiddlewareState } from '../types';
+export declare class AttachmentPostUploadMiddlewareExecutor extends MiddlewareExecutor<AttachmentPostUploadMiddlewareState, 'postProcess'> {
+    constructor({ composer }: AttachmentPostUploadMiddlewareExecutorOptions);
+}

package/dist/types/messageComposer/middleware/attachmentManager/postUpload/attachmentEnrichment.d.ts

@@ -0,0 +1,2 @@
+import type { AttachmentPostUploadMiddleware } from '../types';
+export declare const createPostUploadAttachmentEnrichmentMiddleware: () => AttachmentPostUploadMiddleware;

package/dist/types/messageComposer/middleware/attachmentManager/postUpload/index.d.ts

@@ -0,0 +1,3 @@
+export * from './attachmentEnrichment';
+export * from './AttachmentPostUploadMiddlewareExecutor';
+export * from './uploadErrorHandler';

package/dist/types/messageComposer/middleware/attachmentManager/postUpload/uploadErrorHandler.d.ts

@@ -0,0 +1,3 @@
+import type { MessageComposer } from '../../../messageComposer';
+import type { AttachmentPostUploadMiddleware } from '../types';
+export declare const createUploadErrorHandlerMiddleware: (composer: MessageComposer) => AttachmentPostUploadMiddleware;

package/dist/types/messageComposer/middleware/attachmentManager/preUpload/AttachmentPreUploadMiddlewareExecutor.d.ts

@@ -0,0 +1,5 @@
+import { MiddlewareExecutor } from '../../../../middleware';
+import type { AttachmentPreUploadMiddlewareExecutorOptions, AttachmentPreUploadMiddlewareState } from '../types';
+export declare class AttachmentPreUploadMiddlewareExecutor extends MiddlewareExecutor<AttachmentPreUploadMiddlewareState, 'prepare'> {
+    constructor({ composer }: AttachmentPreUploadMiddlewareExecutorOptions);
+}

package/dist/types/messageComposer/middleware/attachmentManager/preUpload/blockedUploadNotification.d.ts

@@ -0,0 +1,3 @@
+import type { MessageComposer } from '../../../messageComposer';
+import type { AttachmentPreUploadMiddleware } from '../types';
+export declare const createBlockedAttachmentUploadNotificationMiddleware: (composer: MessageComposer) => AttachmentPreUploadMiddleware;

package/dist/types/messageComposer/middleware/attachmentManager/preUpload/index.d.ts

@@ -0,0 +1,3 @@
+export * from './AttachmentPreUploadMiddlewareExecutor';
+export * from './blockedUploadNotification';
+export * from './serverUploadConfigCheck';

package/dist/types/messageComposer/middleware/attachmentManager/preUpload/serverUploadConfigCheck.d.ts

@@ -0,0 +1,3 @@
+import type { MessageComposer } from '../../../messageComposer';
+import type { AttachmentPreUploadMiddleware } from '../types';
+export declare const createUploadConfigCheckMiddleware: (composer: MessageComposer) => AttachmentPreUploadMiddleware;

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

@@ -0,0 +1,20 @@
+import type { LocalUploadAttachment } from '../../types';
+import type { Middleware } from '../../../middleware';
+import type { MessageComposer } from '../../messageComposer';
+import type { MinimumUploadRequestResult } from '../../configuration';
+export type AttachmentPreUploadMiddlewareState = {
+    attachment: LocalUploadAttachment;
+};
+export type AttachmentPostUploadMiddlewareState = {
+    attachment: LocalUploadAttachment;
+    error?: Error;
+    response?: MinimumUploadRequestResult;
+};
+export type AttachmentPreUploadMiddleware = Middleware<AttachmentPreUploadMiddlewareState, 'prepare'>;
+export type AttachmentPostUploadMiddleware = Middleware<AttachmentPostUploadMiddlewareState, 'postProcess'>;
+export type AttachmentPostUploadMiddlewareExecutorOptions = {
+    composer: MessageComposer;
+};
+export type AttachmentPreUploadMiddlewareExecutorOptions = {
+    composer: MessageComposer;
+};

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

@@ -61,6 +61,7 @@ export type LocalAttachmentUploadMetadata = {
 export type LocalImageAttachmentUploadMetadata = LocalAttachmentUploadMetadata & {
     previewUri?: string;
 };
+export type LocalNotImageAttachment = LocalFileAttachment | LocalAudioAttachment | LocalVideoAttachment | LocalVoiceRecordingAttachment;
 export type AttachmentLoadingState = 'uploading' | 'finished' | 'failed' | 'blocked' | 'pending';
 export type UploadPermissionCheckResult = {
     uploadBlocked: boolean;

package/dist/types/middleware.d.ts

@@ -13,6 +13,7 @@ export type MiddlewareExecutionResult<TValue> = {
 export type ExecuteParams<TValue> = {
     eventName: string;
     initialValue: TValue;
+    mode?: 'concurrent' | 'cancelable';
 };
 export type MiddlewareHandlerParams<TValue> = {
     state: TValue;
@@ -41,6 +42,6 @@ export declare class MiddlewareExecutor<TValue, THandlers extends string> {
         unique?: boolean;
     }): this;
     setOrder(order: string[]): void;
-    protected executeMiddlewareChain({ eventName, initialValue, }: ExecuteParams<TValue>): Promise<MiddlewareExecutionResult<TValue>>;
-    execute({ eventName, initialValue: initialState, }: ExecuteParams<TValue>): Promise<MiddlewareExecutionResult<TValue>>;
+    protected executeMiddlewareChain({ eventName, initialValue, mode, }: ExecuteParams<TValue>): Promise<MiddlewareExecutionResult<TValue>>;
+    execute({ eventName, initialValue: initialState, mode, }: ExecuteParams<TValue>): Promise<MiddlewareExecutionResult<TValue>>;
 }

package/dist/types/types.d.ts

@@ -478,6 +478,20 @@ export type GetRateLimitsResponse = APIResponse & {
     server_side?: RateLimitsMap;
     web?: RateLimitsMap;
 };
+export declare enum Product {
+    Chat = "chat",
+    Video = "video",
+    Moderation = "moderation",
+    Feeds = "feeds"
+}
+export type HookEvent = {
+    name: string;
+    description: string;
+    products: Product[];
+};
+export type GetHookEventsResponse = APIResponse & {
+    events: HookEvent[];
+};
 export type GetReactionsAPIResponse = APIResponse & {
     reactions: ReactionResponse[];
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "stream-chat",
-  "version": "9.12.0",
+  "version": "9.14.0",
   "description": "JS SDK for the Stream Chat API",
   "homepage": "https://getstream.io/chat/",
   "author": {
@@ -53,7 +53,7 @@
     "@types/ws": "^8.5.14",
     "axios": "^1.6.0",
     "base64-js": "^1.5.1",
-    "form-data": "^4.0.0",
+    "form-data": "^4.0.4",
     "isomorphic-ws": "^5.0.0",
     "jsonwebtoken": "^9.0.2",
     "linkifyjs": "^4.2.0",

package/src/channel_manager.ts

@@ -317,7 +317,19 @@ export class ChannelManager extends WithSubscriptions {
           `Maximum number of retries reached in queryChannels. Last error message is: ${err}`,
         );
 
-        this.state.partialNext({ error: wrappedError });
+        const state = this.state.getLatestValue();
+        // If the offline support is enabled, and there are channels in the DB, we should not error out.
+        const isOfflineSupportEnabledWithChannels =
+          this.client.offlineDb && state.channels.length > 0;
+
+        this.state.partialNext({
+          error: isOfflineSupportEnabledWithChannels ? undefined : wrappedError,
+          pagination: {
+            ...state.pagination,
+            isLoading: false,
+            isLoadingNext: false,
+          },
+        });
         return;
       }
 
@@ -444,7 +456,11 @@ export class ChannelManager extends WithSubscriptions {
       this.client.logger('error', (error as Error).message);
       this.state.next((currentState) => ({
         ...currentState,
-        pagination: { ...currentState.pagination, isLoadingNext: false },
+        pagination: {
+          ...currentState.pagination,
+          isLoadingNext: false,
+          isLoading: false,
+        },
       }));
       throw error;
     }

package/src/client.ts

@@ -106,6 +106,7 @@ import type {
   GetCampaignOptions,
   GetChannelTypeResponse,
   GetCommandResponse,
+  GetHookEventsResponse,
   GetImportResponse,
   GetMessageAPIResponse,
   GetMessageOptions,
@@ -148,6 +149,7 @@ import type {
   PollVote,
   PollVoteData,
   PollVotesAPIResponse,
+  Product,
   PushPreference,
   PushProvider,
   PushProviderConfig,
@@ -2164,6 +2166,17 @@ export class StreamChat {
     });
   }
 
+  /**
+   * getHookEvents - Get available events for hooks (webhook, SQS, and SNS)
+   *
+   * @param {Product[]} [products] Optional array of products to filter events by (e.g., [Product.Chat, Product.Video])
+   * @returns {Promise<GetHookEventsResponse>} Response containing available hook events
+   */
+  async getHookEvents(products?: Product[]) {
+    const params = products && products.length > 0 ? { product: products.join(',') } : {};
+    return await this.get<GetHookEventsResponse>(this.baseURL + '/hook/events', params);
+  }
+
   _addChannelConfig({ cid, config }: ChannelResponse) {
     if (this._cacheEnabled()) {
       this.configs[cid] = config;

package/src/messageComposer/attachmentManager.ts

@@ -14,6 +14,10 @@ import {
   isFileReference,
   isImageFile,
 } from './fileUtils';
+import {
+  AttachmentPostUploadMiddlewareExecutor,
+  AttachmentPreUploadMiddlewareExecutor,
+} from './middleware/attachmentManager';
 import { StateStore } from '../store';
 import { generateUUIDv4 } from '../utils';
 import { DEFAULT_UPLOAD_SIZE_LIMIT_BYTES } from '../constants';
@@ -22,23 +26,14 @@ import type {
   FileLike,
   FileReference,
   LocalAttachment,
-  LocalAudioAttachment,
-  LocalFileAttachment,
+  LocalNotImageAttachment,
   LocalUploadAttachment,
-  LocalVideoAttachment,
-  LocalVoiceRecordingAttachment,
   UploadPermissionCheckResult,
 } from './types';
 import type { ChannelResponse, DraftMessage, LocalMessage } from '../types';
 import type { MessageComposer } from './messageComposer';
 import { mergeWithDiff } from '../utils/mergeWith';
 
-type LocalNotImageAttachment =
-  | LocalFileAttachment
-  | LocalAudioAttachment
-  | LocalVideoAttachment
-  | LocalVoiceRecordingAttachment;
-
 export type FileUploadFilter = (file: Partial<LocalUploadAttachment>) => boolean;
 
 export type AttachmentManagerState = {
@@ -71,6 +66,8 @@ const initState = ({
 export class AttachmentManager {
   readonly state: StateStore<AttachmentManagerState>;
   readonly composer: MessageComposer;
+  readonly preUploadMiddlewareExecutor: AttachmentPreUploadMiddlewareExecutor;
+  readonly postUploadMiddlewareExecutor: AttachmentPostUploadMiddlewareExecutor;
   private attachmentsByIdGetterCache: {
     attachmentsById: Record<string, LocalAttachment>;
     attachments: LocalAttachment[];
@@ -80,6 +77,13 @@ export class AttachmentManager {
     this.composer = composer;
     this.state = new StateStore<AttachmentManagerState>(initState({ message }));
     this.attachmentsByIdGetterCache = { attachmentsById: {}, attachments: [] };
+
+    this.preUploadMiddlewareExecutor = new AttachmentPreUploadMiddlewareExecutor({
+      composer,
+    });
+    this.postUploadMiddlewareExecutor = new AttachmentPostUploadMiddlewareExecutor({
+      composer,
+    });
   }
 
   get attachmentsById() {
@@ -122,10 +126,16 @@ export class AttachmentManager {
     this.composer.updateConfig({ attachments: { acceptedFiles } });
   }
 
+  /*
+  @deprecated attachments can be filtered using injecting pre-upload middleware
+   */
   get fileUploadFilter() {
     return this.config.fileUploadFilter;
   }
 
+  /*
+  @deprecated attachments can be filtered using injecting pre-upload middleware
+   */
   set fileUploadFilter(fileUploadFilter: AttachmentManagerConfig['fileUploadFilter']) {
     this.composer.updateConfig({ attachments: { fileUploadFilter } });
   }
@@ -333,9 +343,9 @@ export class AttachmentManager {
     return { uploadBlocked: false };
   };
 
-  fileToLocalUploadAttachment = async (
+  static toLocalUploadAttachment = (
     fileLike: FileReference | FileLike,
-  ): Promise<LocalUploadAttachment> => {
+  ): LocalUploadAttachment => {
     const file =
       isFileReference(fileLike) || isFile(fileLike)
         ? fileLike
@@ -345,16 +355,13 @@ export class AttachmentManager {
             mimeType: fileLike.type,
           });
 
-    const uploadPermissionCheck = await this.getUploadConfigCheck(file);
-
     const localAttachment: LocalUploadAttachment = {
       file_size: file.size,
       mime_type: file.type,
       localMetadata: {
         file,
         id: generateUUIDv4(),
-        uploadPermissionCheck,
-        uploadState: uploadPermissionCheck.uploadBlocked ? 'blocked' : 'pending',
+        uploadState: 'pending',
       },
       type: getAttachmentTypeFromMimeType(file.type),
     };
@@ -383,10 +390,26 @@ export class AttachmentManager {
     return localAttachment;
   };
 
+  // @deprecated use AttachmentManager.toLocalUploadAttachment(file)
+  fileToLocalUploadAttachment = async (
+    fileLike: FileReference | FileLike,
+  ): Promise<LocalUploadAttachment> => {
+    const localAttachment = AttachmentManager.toLocalUploadAttachment(fileLike);
+    const uploadPermissionCheck = await this.getUploadConfigCheck(
+      localAttachment.localMetadata.file,
+    );
+    localAttachment.localMetadata.uploadPermissionCheck = uploadPermissionCheck;
+    localAttachment.localMetadata.uploadState = uploadPermissionCheck.uploadBlocked
+      ? 'blocked'
+      : 'pending';
+
+    return localAttachment;
+  };
+
   private ensureLocalUploadAttachment = async (
     attachment: Partial<LocalUploadAttachment>,
   ) => {
-    if (!attachment.localMetadata?.file || !attachment.localMetadata.id) {
+    if (!attachment.localMetadata?.file) {
       this.client.notifications.addError({
         message: 'File is required for upload attachment',
         origin: { emitter: 'AttachmentManager', context: { attachment } },
@@ -395,6 +418,15 @@ export class AttachmentManager {
       return;
     }
 
+    if (!attachment.localMetadata.id) {
+      this.client.notifications.addError({
+        message: 'Local upload attachment missing local id',
+        origin: { emitter: 'AttachmentManager', context: { attachment } },
+        options: { type: 'validation:attachment:id:missing' },
+      });
+      return;
+    }
+
     if (!this.fileUploadFilter(attachment)) return;
 
     const newAttachment = await this.fileToLocalUploadAttachment(
@@ -446,6 +478,7 @@ export class AttachmentManager {
     return this.doDefaultUploadRequest(fileLike);
   };
 
+  // @deprecated use attachmentManager.uploadFile(file)
   uploadAttachment = async (attachment: LocalUploadAttachment) => {
     if (!this.isUploadEnabled) return;
 
@@ -546,20 +579,78 @@ export class AttachmentManager {
     return uploadedAttachment;
   };
 
+  uploadFile = async (file: FileReference | FileLike) => {
+    const preUpload = await this.preUploadMiddlewareExecutor.execute({
+      eventName: 'prepare',
+      initialValue: {
+        attachment: AttachmentManager.toLocalUploadAttachment(file),
+      },
+      mode: 'concurrent',
+    });
+
+    let attachment: LocalUploadAttachment = preUpload.state.attachment;
+
+    if (preUpload.status === 'discard') return attachment;
+    // todo: remove with the next major release as filtering can be done in middleware
+    // should we return the attachment object?
+    if (!this.fileUploadFilter(attachment)) return attachment;
+
+    if (attachment.localMetadata.uploadState === 'blocked') {
+      this.upsertAttachments([attachment]);
+      return preUpload.state.attachment;
+    }
+
+    attachment = {
+      ...attachment,
+      localMetadata: {
+        ...attachment.localMetadata,
+        uploadState: 'uploading',
+      },
+    };
+    this.upsertAttachments([attachment]);
+
+    let response: MinimumUploadRequestResult | undefined;
+    let error: Error | undefined;
+    try {
+      response = await this.doUploadRequest(file);
+    } catch (err) {
+      error = err instanceof Error ? err : undefined;
+    }
+
+    const postUpload = await this.postUploadMiddlewareExecutor.execute({
+      eventName: 'postProcess',
+      initialValue: {
+        attachment: {
+          ...attachment,
+          localMetadata: {
+            ...attachment.localMetadata,
+            uploadState: error ? 'failed' : 'finished',
+          },
+        },
+        error,
+        response,
+      },
+      mode: 'concurrent',
+    });
+    attachment = postUpload.state.attachment;
+
+    if (postUpload.status === 'discard') {
+      this.removeAttachments([attachment.localMetadata.id]);
+      return attachment;
+    }
+
+    this.updateAttachment(attachment);
+    return attachment;
+  };
+
   uploadFiles = async (files: FileReference[] | FileList | FileLike[]) => {
     if (!this.isUploadEnabled) return;
     const iterableFiles: FileReference[] | FileLike[] = isFileList(files)
       ? Array.from(files)
       : files;
-    const attachments = await Promise.all(
-      iterableFiles.map(this.fileToLocalUploadAttachment),
-    );
 
-    return Promise.all(
-      attachments
-        .filter(this.fileUploadFilter)
-        .slice(0, this.availableUploadSlots)
-        .map(this.uploadAttachment),
+    return await Promise.all(
+      iterableFiles.slice(0, this.availableUploadSlots).map(this.uploadFile),
     );
   };
 }

package/src/messageComposer/configuration/types.ts

@@ -2,7 +2,9 @@ import type { LinkPreview } from '../linkPreviewsManager';
 import type { FileUploadFilter } from '../attachmentManager';
 import type { FileLike, FileReference } from '../types';
 
-export type MinimumUploadRequestResult = { file: string; thumb_url?: string };
+export type MinimumUploadRequestResult = { file: string; thumb_url?: string } & Partial<
+  Record<string, unknown>
+>;
 
 export type UploadRequestFn = (
   fileLike: FileReference | FileLike,
@@ -39,7 +41,6 @@ export type AttachmentManagerConfig = {
    * describing which file types are allowed to be selected when uploading files.
    */
   acceptedFiles: string[];
-  // todo: refactor this. We want a pipeline where it would be possible to customize the preparation, upload, and post-upload steps.
   /** Function that allows to customize the upload request. */
   doUploadRequest?: UploadRequestFn;
 };

package/src/messageComposer/messageComposer.ts

@@ -700,7 +700,7 @@ export class MessageComposer extends WithSubscriptions {
           id: this.id,
           mentioned_users: [],
           parent_id: this.threadId ?? undefined,
-          pinned_at: null,
+          pinned_at: this.editedMessage?.pinned_at || null,
           reaction_groups: null,
           status: this.editedMessage ? this.editedMessage.status : 'sending',
           text,

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

@@ -0,0 +1,3 @@
+export * from './postUpload';
+export * from './preUpload';
+export * from './types';

package/src/messageComposer/middleware/attachmentManager/postUpload/AttachmentPostUploadMiddlewareExecutor.ts

@@ -0,0 +1,20 @@
+import { MiddlewareExecutor } from '../../../../middleware';
+import type {
+  AttachmentPostUploadMiddlewareExecutorOptions,
+  AttachmentPostUploadMiddlewareState,
+} from '../types';
+import { createPostUploadAttachmentEnrichmentMiddleware } from './attachmentEnrichment';
+import { createUploadErrorHandlerMiddleware } from './uploadErrorHandler';
+
+export class AttachmentPostUploadMiddlewareExecutor extends MiddlewareExecutor<
+  AttachmentPostUploadMiddlewareState,
+  'postProcess'
+> {
+  constructor({ composer }: AttachmentPostUploadMiddlewareExecutorOptions) {
+    super();
+    this.use([
+      createUploadErrorHandlerMiddleware(composer),
+      createPostUploadAttachmentEnrichmentMiddleware(),
+    ]);
+  }
+}

package/src/messageComposer/middleware/attachmentManager/postUpload/attachmentEnrichment.ts

@@ -0,0 +1,43 @@
+import type { MiddlewareHandlerParams } from '../../../../middleware';
+import type {
+  AttachmentPostUploadMiddleware,
+  AttachmentPostUploadMiddlewareState,
+} from '../types';
+import { isLocalImageAttachment } from '../../../attachmentIdentity';
+import type { LocalNotImageAttachment } from '../../../types';
+
+export const createPostUploadAttachmentEnrichmentMiddleware =
+  (): AttachmentPostUploadMiddleware => ({
+    id: 'stream-io/attachment-manager-middleware/post-upload-enrichment',
+    handlers: {
+      postProcess: ({
+        state,
+        discard,
+        forward,
+        next,
+      }: MiddlewareHandlerParams<AttachmentPostUploadMiddlewareState>) => {
+        const { attachment, error, response } = state;
+        if (error) return forward();
+        if (!attachment || !response) return discard();
+
+        const enrichedAttachment = { ...attachment };
+        if (isLocalImageAttachment(attachment)) {
+          if (attachment.localMetadata.previewUri) {
+            URL.revokeObjectURL(attachment.localMetadata.previewUri);
+            delete enrichedAttachment.localMetadata.previewUri;
+          }
+          enrichedAttachment.image_url = response.file;
+        } else {
+          (enrichedAttachment as LocalNotImageAttachment).asset_url = response.file;
+        }
+        if (response.thumb_url) {
+          (enrichedAttachment as LocalNotImageAttachment).thumb_url = response.thumb_url;
+        }
+
+        return next({
+          ...state,
+          attachment: enrichedAttachment,
+        });
+      },
+    },
+  });

package/src/messageComposer/middleware/attachmentManager/postUpload/index.ts

@@ -0,0 +1,3 @@
+export * from './attachmentEnrichment';
+export * from './AttachmentPostUploadMiddlewareExecutor';
+export * from './uploadErrorHandler';