@acorex/components 20.7.8 → 20.7.10

package/conversation2/index.d.ts

@@ -1416,7 +1416,13 @@ declare class AXComposerService {
     focusComposer(): void;
     clear(): void;
     sendTypingIndicator(conversationId: string): Promise<void>;
-    sendMessage(command: AXSendMessageCommand): Promise<void>;
+    /**
+     * Send through the conversation API with optional {@link AXComposerPipeline} hooks.
+     * @param options.clearComposer Clear reply/edit state after send (default `true`). Use `false` when sending multiple messages in one action.
+     */
+    sendMessage(command: AXSendMessageCommand, options?: {
+        clearComposer?: boolean;
+    }): Promise<void>;
     /**
      * Show a component in the composer (full-width mode)
      */
@@ -1706,6 +1712,14 @@ interface AXPaginatedResult<T> {
     /** Total pages */
     totalPages?: number;
 }
+/**
+ * Pagination cursor state for a single list (conversations or messages).
+ */
+interface AXPaginationState {
+    page: number;
+    hasMore: boolean;
+    nextCursor?: string;
+}
 /**
  * Connection status
  */
@@ -3293,6 +3307,44 @@ declare class AXInfoBarService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXInfoBarService>;
 }
 
+/**
+ * Optional pipeline hooks for composer-originated sends (pickers, text input, stickers, etc.).
+ * Register via `provideConversation({ composerPipeline: [...] })` or
+ * `{ provide: AX_COMPOSER_PIPELINE, useValue: pipeline, multi: true }`.
+ */
+
+/** Context after the message API returns a persisted message. */
+interface AXComposerPipelineAfterApiContext {
+    command: AXSendMessageCommand;
+    message: AXMessage;
+}
+/**
+ * Transform composer output before/after the message API.
+ * Lower `order` runs first (default 0).
+ */
+interface AXComposerPipeline {
+    order?: number;
+    /** Runs after validation, before optimistic UI and `messageApi.sendMessage`. */
+    transformOutgoing?(command: AXSendMessageCommand): AXSendMessageCommand | Promise<AXSendMessageCommand>;
+    /** Runs on the API response before the temp message is replaced in the store. */
+    transformAfterApi?(context: AXComposerPipelineAfterApiContext): AXMessage | Promise<AXMessage>;
+}
+declare const AX_COMPOSER_PIPELINE: InjectionToken<AXComposerPipeline[]>;
+declare class AXComposerPipelineRunner {
+    private readonly pipelines;
+    get hasPipelines(): boolean;
+    runOutgoing(command: AXSendMessageCommand): Promise<AXSendMessageCommand>;
+    runAfterApi(context: AXComposerPipelineAfterApiContext): Promise<AXMessage>;
+    private sortedPipelines;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXComposerPipelineRunner, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXComposerPipelineRunner>;
+}
+/** Options for {@link AXConversationService.sendMessage} when the send originates from the composer. */
+interface AXComposerSendMessageOptions {
+    /** Apply registered {@link AXComposerPipeline} hooks. */
+    composerPipeline?: boolean;
+}
+
 /**
  * Central Registry Service
  * Provides unified access to all registries
@@ -3323,6 +3375,13 @@ declare class AXRegistryService {
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXRegistryService>;
 }
 
+/** Result of loading a message page (newest-first APIs, merged ascending in the store). */
+interface AXLoadMessagesResult {
+    items: AXMessage[];
+    hasMore: boolean;
+    page: number;
+    nextCursor?: string;
+}
 /**
  * Main Conversation Service
  *
@@ -3348,9 +3407,14 @@ declare class AXConversationService {
     private readonly destroy$;
     /** Registry service - exposed for child services */
     readonly registry: AXRegistryService;
+    private readonly composerPipeline;
+    private readonly messagePipeline;
     private readonly _activeConversationId;
     private readonly _loading;
+    private readonly _loadingActiveMessages;
     private readonly _error;
+    private readonly _conversationsPagination;
+    private readonly _messagesPaginationByConversation;
     /** Emits when the active conversation changes, cancelling per-conversation subscriptions. */
     private readonly _conversationSwitch$;
     private readonly _messageReceived$;
@@ -3366,8 +3430,14 @@ declare class AXConversationService {
     readonly activeConversation: _angular_core.Signal<AXConversation>;
     /** Messages for active conversation */
     readonly activeMessages: _angular_core.Signal<AXMessage[]>;
-    /** Loading state */
+    /** Loading state (conversation list initial load) */
     readonly loading: _angular_core.Signal<boolean>;
+    /** Loading state for the active conversation's message history */
+    readonly loadingActiveMessages: _angular_core.Signal<boolean>;
+    /** Sidebar conversation list pagination */
+    readonly conversationsPagination: _angular_core.Signal<AXPaginationState>;
+    /** Active conversation message pagination */
+    readonly activeMessagesPagination: _angular_core.Signal<AXPaginationState>;
     /** Error state */
     readonly error: _angular_core.Signal<Error>;
     /** Connection status */
@@ -3418,13 +3488,15 @@ declare class AXConversationService {
      * Load messages for a conversation
      * Fetches messages from server with request cancellation support
      */
-    loadMessages(conversationId: string, page?: number): Promise<AXMessage[]>;
+    loadMessages(conversationId: string, page?: number): Promise<AXLoadMessagesResult>;
+    /** Reset sidebar conversation pagination (e.g. after filters change). */
+    resetConversationsPagination(): void;
     /**
      * Send a message
      * Uses optimistic UI updates - message appears immediately
      * Improved with better temp ID generation to prevent collisions
      */
-    sendMessage(command: AXSendMessageCommand): Promise<void>;
+    sendMessage(command: AXSendMessageCommand, options?: AXComposerSendMessageOptions): Promise<void>;
     /**
      * Retry a failed message
      */
@@ -3477,6 +3549,8 @@ declare class AXConversationService {
      * Handle message update
      */
     private handleMessageUpdate;
+    private processIncomingMessage;
+    private processIncomingMessages;
     /**
      * Handle message count update
      * Emits events when a message is a reply or forward so components can refresh counts
@@ -3868,6 +3942,7 @@ declare class AXMessageListComponent implements OnDestroy {
     private readonly conversationService;
     private readonly messageListService;
     private readonly translation;
+    private readonly messagePipeline;
     protected readonly config: Required<AXConversationConfig>;
     /**
      * Background for the message list scroll area from config, or the built-in soft gradient when unset/empty.
@@ -3887,6 +3962,8 @@ declare class AXMessageListComponent implements OnDestroy {
     readonly reactionPopover: _angular_core.Signal<any>;
     /** Message id whose context menu is open (for active row styling). */
     readonly contextMenuMessageId: _angular_core.WritableSignal<string>;
+    /** While true, older history is being prepended — do not auto-scroll to the latest message. */
+    private restoringScrollAfterPrepend;
     readonly availableReactions: _angular_core.WritableSignal<string[]>;
     private get registry();
     /** Message list element reference */
@@ -3894,9 +3971,11 @@ declare class AXMessageListComponent implements OnDestroy {
     /** Messages container element reference */
     private readonly messagesContainerRef;
     /** Loading state - use service */
-    readonly loading: _angular_core.WritableSignal<boolean>;
+    readonly loading: _angular_core.Signal<boolean>;
     /** Loading more messages state - use service */
     readonly loadingMore: _angular_core.WritableSignal<boolean>;
+    /** Whether older messages remain on the server */
+    readonly hasMoreMessages: _angular_core.Signal<boolean>;
     /** Show scroll to bottom button - use service */
     readonly showScrollButton: _angular_core.WritableSignal<boolean>;
     /** Active conversation */
@@ -4000,8 +4079,12 @@ declare class AXMessageListComponent implements OnDestroy {
     onScroll(event: Event): void;
     /** Handle infinite scroll threshold */
     onScrollThreshold(edge: 'top' | 'bottom'): Promise<void>;
-    /** Load older messages - delegate to service */
+    /** Load older messages - delegate to service and preserve scroll anchor */
     private loadOlderMessages;
+    /**
+     * Keep the user's viewport on the same messages after older rows are inserted above.
+     */
+    private restoreScrollPositionAfterPrepend;
     /** Check if user is near bottom of scroll */
     private isUserNearBottom;
     /**
@@ -4065,22 +4148,23 @@ interface AXMessageAvatarTemplateContext {
 declare class AXMessageListService {
     private readonly conversationService;
     private readonly config;
+    private readonly messagePipeline;
+    /** Message passed to renderers (applies optional display pipeline). */
+    toDisplayMessage(message: AXMessage): AXMessage;
     private get registry();
     readonly activeConversation: _angular_core.Signal<AXConversation>;
     readonly activeMessages: _angular_core.Signal<AXMessage[]>;
     readonly currentUser: _angular_core.Signal<AXParticipant>;
-    /** Loading state */
-    readonly loading: _angular_core.WritableSignal<boolean>;
-    /** Loading more messages state */
+    /** Initial message history load (conversation switch) */
+    readonly loading: _angular_core.Signal<boolean>;
+    /** Loading older messages (scroll-up pagination) */
     readonly loadingMore: _angular_core.WritableSignal<boolean>;
+    /** Whether older messages can be loaded */
+    readonly hasMoreMessages: _angular_core.Signal<boolean>;
     /** Show scroll to bottom button */
     readonly showScrollButton: _angular_core.WritableSignal<boolean>;
     /** Scroll requests counter */
     readonly scrollRequests: _angular_core.WritableSignal<number>;
-    /** Current page for pagination */
-    private readonly currentPage;
-    /** Has more messages to load */
-    private readonly hasMoreMessages;
     /** Message grouped by date */
     readonly messageGroups: _angular_core.Signal<{
         date: string;
@@ -4088,11 +4172,11 @@ declare class AXMessageListService {
         messages: AXMessage[];
     }[]>;
     /**
-     * Load more messages (pagination)
+     * Load older messages when the user scrolls near the top.
      */
-    loadMoreMessages(): Promise<void>;
+    loadMoreMessages(): Promise<boolean>;
     /**
-     * Reset pagination (call when conversation changes)
+     * Reset pagination when switching conversations (page 0 is loaded by {@link AXConversationService.selectConversation}).
      */
     resetPagination(): void;
     getMenuActions(message: AXMessage): _acorex_components_conversation2.AXMessageAction[];
@@ -4110,11 +4194,10 @@ declare class AXSidebarService {
     private get registry();
     readonly searchQuery: _angular_core.WritableSignal<string>;
     readonly activeTabId: _angular_core.WritableSignal<string>;
-    private readonly currentPage;
-    private readonly hasMoreConversations;
     readonly loadingMore: _angular_core.WritableSignal<boolean>;
     readonly conversations: _angular_core.Signal<AXConversation[]>;
     readonly loading: _angular_core.Signal<boolean>;
+    readonly hasMoreConversations: _angular_core.Signal<boolean>;
     readonly enabledTabs: _angular_core.Signal<_acorex_components_conversation2.AXConversationTab[]>;
     private filterCache;
     readonly filteredConversations: _angular_core.Signal<AXConversation[]>;
@@ -4127,7 +4210,7 @@ declare class AXSidebarService {
     selectConversation(conversation: AXConversation): void;
     getBadgeValue(tabId: string): string | undefined;
     /**
-     * Load more conversations (pagination)
+     * Load more conversations when the user scrolls near the bottom of the sidebar list.
      */
     loadMoreConversations(): Promise<void>;
     /**
@@ -4135,9 +4218,9 @@ declare class AXSidebarService {
      */
     onScrollThreshold(edge: 'top' | 'bottom'): Promise<void>;
     /**
-     * Reset pagination (call when filters change)
+     * Reload conversation list from the first page (e.g. pull-to-refresh).
      */
-    resetPagination(): void;
+    reloadConversations(): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXSidebarService, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXSidebarService>;
 }
@@ -4157,6 +4240,7 @@ declare class AXSidebarComponent implements OnDestroy {
     readonly filteredConversations: _angular_core.Signal<AXConversation[]>;
     readonly loading: _angular_core.Signal<boolean>;
     readonly loadingMore: _angular_core.WritableSignal<boolean>;
+    readonly hasMoreConversations: _angular_core.Signal<boolean>;
     constructor();
     /** Handle search input change with debouncing */
     onSearchChange(value: string): void;
@@ -4235,15 +4319,22 @@ declare class AXInfiniteScrollDirective {
     readonly threshold: _angular_core.InputSignal<number>;
     /** Which edge to watch: 'top', 'bottom', or 'both' */
     readonly edge: _angular_core.InputSignal<"top" | "bottom" | "both">;
+    /** When true, scroll events are ignored (e.g. while a page is loading). */
+    readonly scrollDisabled: _angular_core.InputSignal<boolean>;
+    /** Minimum time between emissions (ms) to avoid duplicate API calls. */
+    readonly cooldownMs: _angular_core.InputSignal<number>;
     /** Event emitted when scrolling reaches the threshold */
     readonly scrollThreshold: _angular_core.OutputEmitterRef<"top" | "bottom">;
     private lastScrollTop;
     private ticking;
+    private lastEmitAt;
+    private pendingEmit;
     constructor();
     private setupScrollListener;
     private handleScroll;
+    private emitThreshold;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXInfiniteScrollDirective, never>;
-    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXInfiniteScrollDirective, "[axInfiniteScroll]", never, { "threshold": { "alias": "threshold"; "required": false; "isSignal": true; }; "edge": { "alias": "edge"; "required": false; "isSignal": true; }; }, { "scrollThreshold": "scrollThreshold"; }, never, never, true, never>;
+    static ɵdir: _angular_core.ɵɵDirectiveDeclaration<AXInfiniteScrollDirective, "[axInfiniteScroll]", never, { "threshold": { "alias": "threshold"; "required": false; "isSignal": true; }; "edge": { "alias": "edge"; "required": false; "isSignal": true; }; "scrollDisabled": { "alias": "scrollDisabled"; "required": false; "isSignal": true; }; "cooldownMs": { "alias": "cooldownMs"; "required": false; "isSignal": true; }; }, { "scrollThreshold": "scrollThreshold"; }, never, never, true, never>;
 }
 
 /**
@@ -4355,6 +4446,59 @@ declare class AXConversationSharedStorage {
 }
 declare const conversationSharedStorage: AXConversationSharedStorage;
 
+/**
+ * Chat-oriented pagination helpers for IndexedDB demo APIs.
+ *
+ * Convention (matches {@link AXConversationService}):
+ * - Page 0: newest items (sidebar: recent chats; messages: latest history window).
+ * - Page 1+ or `cursor`: older items before the previous window.
+ * - `hasMore`: true when older items remain.
+ * - `nextCursor`: id of the oldest item in the current page (use as `pagination.cursor` for the next request).
+ */
+
+declare const AX_MESSAGE_CURSOR_PREFIX = "msg:";
+declare const AX_CONVERSATION_CURSOR_PREFIX = "conv:";
+type AXChatCursorKind = 'message' | 'conversation';
+interface AXParsedChatCursor {
+    kind: AXChatCursorKind;
+    id: string;
+}
+declare function encodeMessageCursor(messageId: string): string;
+declare function encodeConversationCursor(conversationId: string): string;
+/** Decode cursor from API pagination (supports prefixed or legacy raw message id). */
+declare function parseChatCursor(cursor?: string): AXParsedChatCursor | null;
+/**
+ * Paginate a list sorted newest-first (chats, message history windows).
+ */
+declare function paginateChatNewestFirst<T extends {
+    id: string;
+}>(sortedNewestFirst: T[], pagination: AXPagination, cursorKind: AXChatCursorKind): AXPaginatedResult<T>;
+/**
+ * Paginate a list sorted oldest-first (replies, forward history).
+ */
+declare function paginateChatOldestFirst<T extends {
+    id: string;
+}>(sortedOldestFirst: T[], pagination: AXPagination): AXPaginatedResult<T>;
+
+/**
+ * Shared read/write helpers for IndexedDB chat storage (in-memory + persistence).
+ */
+
+declare function getConversationLastActivity(conv: AXConversation): number;
+/** Messages for a conversation, newest first (API / pagination order). */
+declare function getConversationMessagesNewestFirst(conversationId: string): AXMessage[];
+/** Keep per-conversation id list sorted ascending by timestamp (store order). */
+declare function sortConversationMessageIds(conversationId: string): void;
+/** Register a message in maps and keep the conversation index sorted. */
+declare function registerChatMessage(message: AXMessage): void;
+/** Remove a message from conversation index and global map. */
+declare function unregisterChatMessage(messageId: string, conversationId: string): void;
+declare function applyConversationFilters(conversations: AXConversation[], filters?: AXConversationFilters): AXConversation[];
+/** Sidebar list order: pinned first, then by last activity (newest first). */
+declare function getSortedConversationsForInbox(filters?: AXConversationFilters): AXConversation[];
+/** Sort all loaded conversation message indexes (after IndexedDB hydration). */
+declare function normalizeAllConversationMessageIndexes(): void;
+
 declare class AXConversationIndexedDbUserApi extends AXUserApi {
     getCurrentUser(): Promise<AXParticipant>;
     updateProfile(updates: AXUserProfileUpdate): Promise<AXParticipant>;
@@ -4378,34 +4522,38 @@ declare class AXConversationIndexedDbUserApi extends AXUserApi {
 declare class AXConversationIndexedDbConversationApi extends AXConversationApi {
     createConversation(data: AXConversationCreateData): Promise<AXConversation>;
     getConversation(conversationId: string): Promise<AXConversation>;
-    getConversations(pagination: AXPagination, _filters?: AXConversationFilters): Promise<AXPaginatedResult<AXConversation>>;
+    /**
+     * Inbox page (pinned + recent activity, newest first).
+     * Page 0 / cursor align with {@link AXConversationService.loadConversations} and sidebar infinite scroll.
+     */
+    getConversations(pagination: AXPagination, filters?: AXConversationFilters): Promise<AXPaginatedResult<AXConversation>>;
     updateConversation(conversationId: string, updates: AXConversationUpdateData): Promise<AXConversation>;
     deleteConversation(conversationId: string): Promise<boolean>;
     archiveConversation(conversationId: string): Promise<void>;
     unarchiveConversation(conversationId: string): Promise<void>;
-    pinConversation(_conversationId: string): Promise<void>;
-    unpinConversation(_conversationId: string): Promise<void>;
+    pinConversation(conversationId: string): Promise<void>;
+    unpinConversation(conversationId: string): Promise<void>;
     markConversationAsRead(conversationId: string): Promise<void>;
     markConversationAsUnread(conversationId: string): Promise<void>;
     searchConversations(query: string): Promise<AXConversation[]>;
-    filterConversations(_filters: AXConversationFilters, pagination?: AXPagination): Promise<AXPaginatedResult<AXConversation>>;
+    filterConversations(filters: AXConversationFilters, pagination?: AXPagination): Promise<AXPaginatedResult<AXConversation>>;
     getParticipants(conversationId: string): Promise<AXParticipant[]>;
     addParticipants(_conversationId: string, _userIds: string[]): Promise<AXConversation>;
     removeParticipant(conversationId: string, _userId: string): Promise<AXConversation>;
     leaveConversation(_conversationId: string): Promise<void>;
     updateParticipant(conversationId: string, _update: AXParticipantUpdate): Promise<AXConversation>;
     getConversationSettings(conversationId: string): Promise<AXConversationSettingsUpdate>;
-    updateConversationSettings(_conversationId: string, _settings: AXConversationSettingsUpdate): Promise<void>;
-    muteConversation(_conversationId: string, _duration?: number): Promise<void>;
-    unmuteConversation(_conversationId: string): Promise<void>;
+    updateConversationSettings(conversationId: string, settings: AXConversationSettingsUpdate): Promise<void>;
+    muteConversation(conversationId: string, duration?: number): Promise<void>;
+    unmuteConversation(conversationId: string): Promise<void>;
     uploadConversationAvatar(_conversationId: string, file: File): Promise<string>;
-    getConversationMedia(_conversationId: string, _pagination?: AXPagination): Promise<AXPaginatedResult<unknown>>;
-    addConversationTags(_conversationId: string, _tags: string[]): Promise<void>;
-    removeConversationTags(_conversationId: string, _tags: string[]): Promise<void>;
-    getConversationTags(_conversationId: string): Promise<string[]>;
-    saveDraft(_conversationId: string, _draft: string): Promise<void>;
-    getDraft(_conversationId: string): Promise<string | null>;
-    clearDraft(_conversationId: string): Promise<void>;
+    getConversationMedia(conversationId: string, pagination?: AXPagination): Promise<AXPaginatedResult<unknown>>;
+    addConversationTags(conversationId: string, tags: string[]): Promise<void>;
+    removeConversationTags(conversationId: string, tags: string[]): Promise<void>;
+    getConversationTags(conversationId: string): Promise<string[]>;
+    saveDraft(conversationId: string, draft: string): Promise<void>;
+    getDraft(conversationId: string): Promise<string | null>;
+    clearDraft(conversationId: string): Promise<void>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXConversationIndexedDbConversationApi, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXConversationIndexedDbConversationApi>;
 }
@@ -4413,12 +4561,17 @@ declare class AXConversationIndexedDbConversationApi extends AXConversationApi {
 declare class AXConversationIndexedDbMessageApi extends AXMessageApi {
     sendMessage(command: AXSendMessageCommand): Promise<AXMessage>;
     getMessage(messageId: string): Promise<AXMessage>;
+    /**
+     * Message history for a chat (newest-first pages).
+     * - Page 0: latest `pageSize` messages.
+     * - Page 1+ or `pagination.cursor`: older messages before the previous window.
+     */
     getMessages(conversationId: string, pagination: AXPagination): Promise<AXPaginatedResult<AXMessage>>;
     editMessage(messageId: string, payload: AXMessagePayload): Promise<AXMessage>;
     deleteMessage(messageId: string, _forEveryone?: boolean): Promise<void>;
     deleteMessages(messageIds: string[], forEveryone?: boolean): Promise<void>;
-    searchMessages(conversationId: string, filters: AXMessageSearchFilters, _pagination?: AXPagination): Promise<AXPaginatedResult<AXMessage>>;
-    searchAllMessages(_filters: AXMessageSearchFilters, _pagination?: AXPagination): Promise<AXPaginatedResult<AXMessage>>;
+    searchMessages(conversationId: string, filters: AXMessageSearchFilters, pagination?: AXPagination): Promise<AXPaginatedResult<AXMessage>>;
+    searchAllMessages(filters: AXMessageSearchFilters, pagination?: AXPagination): Promise<AXPaginatedResult<AXMessage>>;
     addReaction(messageId: string, emoji: string): Promise<void>;
     removeReaction(messageId: string, emoji: string): Promise<void>;
     getAvailableReactions(): Promise<string[]>;
@@ -4441,17 +4594,17 @@ declare class AXConversationIndexedDbMessageApi extends AXMessageApi {
         mimeType: string;
         metadata?: Record<string, unknown>;
     }>;
-    updateMessageMetadata(_messageId: string, _metadata: Record<string, unknown>): Promise<void>;
-    getMessageMetadata(_messageId: string): Promise<Record<string, unknown>>;
-    updateMessageStatus(_messageId: string, _status: 'sending' | 'sent' | 'delivered' | 'read' | 'failed'): Promise<void>;
+    updateMessageMetadata(messageId: string, metadata: Record<string, unknown>): Promise<void>;
+    getMessageMetadata(messageId: string): Promise<Record<string, unknown>>;
+    updateMessageStatus(messageId: string, status: 'sending' | 'sent' | 'delivered' | 'read' | 'failed'): Promise<void>;
     getMessageDeliveryStatus(_messageId: string): Promise<{
         delivered: number;
         read: number;
         total: number;
     }>;
-    markMessagesAsRead(_messageIds: string[]): Promise<void>;
-    bulkDeleteMessages(_conversationId: string, _messageIds: string[], _forEveryone?: boolean): Promise<void>;
-    exportMessages(_conversationId: string, _format: 'json' | 'csv' | 'txt'): Promise<string | Blob>;
+    markMessagesAsRead(messageIds: string[]): Promise<void>;
+    bulkDeleteMessages(conversationId: string, messageIds: string[], forEveryone?: boolean): Promise<void>;
+    exportMessages(conversationId: string, _format: 'json' | 'csv' | 'txt'): Promise<string | Blob>;
     static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXConversationIndexedDbMessageApi, never>;
     static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXConversationIndexedDbMessageApi>;
 }
@@ -5438,6 +5591,41 @@ declare const AX_CONVERSATION_STICKER_RENDERER: AXMessageRenderer;
 declare const AX_CONVERSATION_SYSTEM_RENDERER: AXMessageRenderer;
 declare const AX_CONVERSATION_FALLBACK_RENDERER: AXMessageRenderer;
 
+/**
+ * Optional pipeline hooks for incoming/display {@link AXMessage} data.
+ * Register via `provideConversation({ messagePipeline: [...] })` or
+ * `{ provide: AX_MESSAGE_PIPELINE, useValue: pipeline, multi: true }`.
+ */
+
+/**
+ * Transform messages when they enter the store or when passed to renderers.
+ * Lower `order` runs first (default 0).
+ */
+interface AXMessagePipeline {
+    order?: number;
+    /**
+     * Runs when messages are loaded or received (store shape).
+     * Use for wire-format → UI model (e.g. map server `imageId` to `payload.assetId`).
+     */
+    transformIncoming?(message: AXMessage): AXMessage | Promise<AXMessage>;
+    /**
+     * Runs when a renderer is resolved (display-only, sync).
+     * Use for cheap view tweaks; prefer `transformIncoming` for async URL resolution
+     * unless renderers handle loading themselves.
+     */
+    transformForDisplay?(message: AXMessage): AXMessage;
+}
+declare const AX_MESSAGE_PIPELINE: InjectionToken<AXMessagePipeline[]>;
+declare class AXMessagePipelineRunner {
+    private readonly pipelines;
+    get hasPipelines(): boolean;
+    runIncoming(message: AXMessage): Promise<AXMessage>;
+    runForDisplay(message: AXMessage): AXMessage;
+    private sortedPipelines;
+    static ɵfac: _angular_core.ɵɵFactoryDeclaration<AXMessagePipelineRunner, never>;
+    static ɵprov: _angular_core.ɵɵInjectableDeclaration<AXMessagePipelineRunner>;
+}
+
 /**
  * Default Conversation Item Actions Plugin
  * Individual action constants with AX_ prefix naming convention
@@ -5504,6 +5692,10 @@ interface AXConversationOptions {
     config?: Partial<AXConversationConfig>;
     /** Registry configuration */
     registry?: Partial<AXRegistryConfiguration>;
+    /** Optional hooks for composer-originated sends (before/after message API). */
+    composerPipeline?: AXComposerPipeline | AXComposerPipeline[];
+    /** Optional hooks for incoming/display messages. */
+    messagePipeline?: AXMessagePipeline | AXMessagePipeline[];
 }
 declare class AXConversation2Module {
     /**
@@ -6149,5 +6341,5 @@ declare function getErrorMessage(code: string, params?: Record<string, string |
  */
 type AXErrorCode = typeof MESSAGE_ERRORS[keyof typeof MESSAGE_ERRORS]['code'] | typeof FILE_ERRORS[keyof typeof FILE_ERRORS]['code'] | typeof USER_ERRORS[keyof typeof USER_ERRORS]['code'] | typeof CONVERSATION_ERRORS[keyof typeof CONVERSATION_ERRORS]['code'] | typeof CONNECTION_ERRORS[keyof typeof CONNECTION_ERRORS]['code'] | typeof LOCATION_ERRORS[keyof typeof LOCATION_ERRORS]['code'] | typeof URL_ERRORS[keyof typeof URL_ERRORS]['code'];
 
-export { AXAudioInfoBarBannerComponent, AXAudioPickerComponent, AXAudioRendererComponent, AXBaseRegistry, AXComposerActionRegistry, AXComposerComponent, AXComposerPopupComponent, AXComposerService, AXComposerTabRegistry, AXConversation2Module, AXConversationAiApiKey, AXConversationAiResponderService, AXConversationApi, AXConversationContainerComponent, AXConversationContainerDirective, AXConversationDateUtilsService, AXConversationIndexedDbConversationApi, AXConversationIndexedDbMessageAiApi, AXConversationIndexedDbMessageApi, AXConversationIndexedDbRealtimeApi, AXConversationIndexedDbStorage, AXConversationIndexedDbStores, AXConversationIndexedDbUserApi, AXConversationInfoPanelComponent, AXConversationItemActionRegistry, AXConversationMessageRendererStateComponent, AXConversationMessageUtilsService, AXConversationService, AXConversationSharedStorage, AXConversationTabRegistry, AXEmojiTabComponent, AXErrorHandlerService, AXFallbackRendererComponent, AXFilePickerComponent, AXFileRendererComponent, AXFileUploadService, AXForwardMessageDialogComponent, AXImagePickerComponent, AXImageRendererComponent, AXInfiniteScrollDirective, AXInfoBarActionRegistry, AXInfoBarComponent, AXInfoBarSearchComponent, AXInfoBarService, AXLocationPickerComponent, AXLocationRendererComponent, AXMessageActionRegistry, AXMessageApi, AXMessageListComponent, AXMessageListNoActiveDefaultComponent, AXMessageListService, AXMessageRendererRegistry, AXNewConversationDialogComponent, AXPickerFooterComponent, AXPickerHeaderComponent, AXRealtimeApi, AXRegistryService, AXSidebarComponent, AXSidebarService, AXStickerRendererComponent, AXStickerTabComponent, AXSystemRendererComponent, AXTextRendererComponent, AXUserApi, AXVideoInfoBarBannerComponent, AXVideoPickerComponent, AXVideoRendererComponent, AXVoiceInfoBarBannerComponent, AXVoiceRecorderComponent, AXVoiceRendererComponent, AX_CONVERSATION_AUDIO_RENDERER, AX_CONVERSATION_COMPOSER_AUDIO_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_TAB, AX_CONVERSATION_COMPOSER_FILE_ACTION, AX_CONVERSATION_COMPOSER_IMAGE_ACTION, AX_CONVERSATION_COMPOSER_LOCATION_ACTION, AX_CONVERSATION_COMPOSER_STICKER_TAB, AX_CONVERSATION_COMPOSER_VIDEO_ACTION, AX_CONVERSATION_COMPOSER_VOICE_RECORDING_ACTION, AX_CONVERSATION_FALLBACK_RENDERER, AX_CONVERSATION_FILE_RENDERER, AX_CONVERSATION_IMAGE_RENDERER, AX_CONVERSATION_INFO_BAR_ARCHIVE_ACTION, AX_CONVERSATION_INFO_BAR_BLOCK_ACTION, AX_CONVERSATION_INFO_BAR_DELETE_ACTION, AX_CONVERSATION_INFO_BAR_DIVIDER, AX_CONVERSATION_INFO_BAR_INFO_ACTION, AX_CONVERSATION_INFO_BAR_MUTE_ACTION, AX_CONVERSATION_INFO_BAR_SEARCH_ACTION, AX_CONVERSATION_ITEM_BLOCK_ACTION, AX_CONVERSATION_ITEM_DELETE_ACTION, AX_CONVERSATION_ITEM_DIVIDER, AX_CONVERSATION_ITEM_MARK_READ_ACTION, AX_CONVERSATION_ITEM_MUTE_ACTION, AX_CONVERSATION_ITEM_PIN_ACTION, AX_CONVERSATION_LOCATION_RENDERER, AX_CONVERSATION_MESSAGE_COPY_ACTION, AX_CONVERSATION_MESSAGE_DELETE_ACTION, AX_CONVERSATION_MESSAGE_EDIT_ACTION, AX_CONVERSATION_MESSAGE_FORWARD_ACTION, AX_CONVERSATION_MESSAGE_REPLY_ACTION, AX_CONVERSATION_STICKER_RENDERER, AX_CONVERSATION_SYSTEM_RENDERER, AX_CONVERSATION_TAB_ALL, AX_CONVERSATION_TAB_ARCHIVED, AX_CONVERSATION_TAB_BOT, AX_CONVERSATION_TAB_CHANNELS, AX_CONVERSATION_TAB_GROUPS, AX_CONVERSATION_TAB_PRIVATE, AX_CONVERSATION_TAB_UNREAD, AX_CONVERSATION_TEXT_RENDERER, AX_CONVERSATION_VIDEO_RENDERER, AX_CONVERSATION_VOICE_RENDERER, AX_DEFAULT_CONVERSATION_CONFIG, AX_STICKER_API_KEY, CONNECTION_ERRORS, CONVERSATION_CONFIG, CONVERSATION_ERRORS, DEFAULT_COMPOSER_ACTIONS, DEFAULT_COMPOSER_TABS, DEFAULT_CONVERSATION_ITEM_ACTIONS, DEFAULT_CONVERSATION_TABS, DEFAULT_INFO_BAR_ACTIONS, DEFAULT_MESSAGE_ACTIONS, DEFAULT_MESSAGE_RENDERERS, ERROR_HANDLER_CONFIG, ERROR_MESSAGES, FILE_ERRORS, LOCATION_ERRORS, MESSAGE_ERRORS, REGISTRY_CONFIG, URL_ERRORS, USER_ERRORS, axConversationIndexedDbStorage, conversationSharedStorage, formatErrorMessage, getDefaultConversationItemActions, getErrorMessage, mergeWithDefaults, provideConversation, sanitizeInput, validateConversationId, validateEmail, validateFile, validateLatitude, validateLongitude, validateMessagePayload, validateMessageText, validateMessageType, validateUrl, validateUserId, validateUserIds };
-export type { AXApiError, AXAudioPayload, AXBlockReportReason, AXCallEvent, AXComposerAction, AXComposerActionComponent, AXComposerActionContext, AXComposerActiveComponent, AXComposerTab, AXConnectionEvent, AXConnectionOptions, AXConnectionStatus, AXConversation, AXConversationAiResponderConfig, AXConversationConfig, AXConversationCreateData, AXConversationError, AXConversationFilter, AXConversationFilters, AXConversationItemAction, AXConversationItemActionContext, AXConversationMetadata, AXConversationOptions, AXConversationSettings, AXConversationSettingsUpdate, AXConversationSort, AXConversationStatus, AXConversationTab, AXConversationType, AXConversationUpdateData, AXDeleteMessageCommand, AXEditMessageCommand, AXErrorCode, AXErrorHandlerConfig, AXErrorMessage, AXErrorSeverity, AXFilePayload, AXFileValidationResult, AXGroupedReaction, AXImagePayload, AXInfoBarAction, AXInfoBarActionComponent, AXInfoBarActionContext, AXInfoBarActiveBanner, AXInfoBarActiveComponent, AXLink, AXLinkPreview, AXLocationPayload, AXMention, AXMessage, AXMessageAction, AXMessageActionContext, AXMessageAvatarTemplateContext, AXMessageForwardData, AXMessageInfoBarBannerComponent, AXMessageListEmptyComponent, AXMessagePayload, AXMessageRenderer, AXMessageRendererCapabilities, AXMessageRendererComponent, AXMessageRendererContentState, AXMessageRendererState, AXMessageSearchFilters, AXMessageStatus, AXMessageType, AXNotificationEvent, AXPaginatedResult, AXPagination, AXParticipant, AXParticipantRole, AXParticipantStatus, AXParticipantUpdate, AXPinnedMessage, AXPollOption, AXPollPayload, AXPresenceStatus, AXPresenceUpdate, AXReaction, AXReadReceipt, AXRegistryConfiguration, AXRegistryItem, AXSendMessageCommand, AXStickerPayload, AXSystemPayload, AXTextFormat, AXTextPayload, AXTypingIndicator, AXUserProfileUpdate, AXUserRole, AXUserSearchFilters, AXValidationResult, AXVideoPayload, AXVoicePayload, DropdownMenuItem, FilePreview };
+export { AXAudioInfoBarBannerComponent, AXAudioPickerComponent, AXAudioRendererComponent, AXBaseRegistry, AXComposerActionRegistry, AXComposerComponent, AXComposerPipelineRunner, AXComposerPopupComponent, AXComposerService, AXComposerTabRegistry, AXConversation2Module, AXConversationAiApiKey, AXConversationAiResponderService, AXConversationApi, AXConversationContainerComponent, AXConversationContainerDirective, AXConversationDateUtilsService, AXConversationIndexedDbConversationApi, AXConversationIndexedDbMessageAiApi, AXConversationIndexedDbMessageApi, AXConversationIndexedDbRealtimeApi, AXConversationIndexedDbStorage, AXConversationIndexedDbStores, AXConversationIndexedDbUserApi, AXConversationInfoPanelComponent, AXConversationItemActionRegistry, AXConversationMessageRendererStateComponent, AXConversationMessageUtilsService, AXConversationService, AXConversationSharedStorage, AXConversationTabRegistry, AXEmojiTabComponent, AXErrorHandlerService, AXFallbackRendererComponent, AXFilePickerComponent, AXFileRendererComponent, AXFileUploadService, AXForwardMessageDialogComponent, AXImagePickerComponent, AXImageRendererComponent, AXInfiniteScrollDirective, AXInfoBarActionRegistry, AXInfoBarComponent, AXInfoBarSearchComponent, AXInfoBarService, AXLocationPickerComponent, AXLocationRendererComponent, AXMessageActionRegistry, AXMessageApi, AXMessageListComponent, AXMessageListNoActiveDefaultComponent, AXMessageListService, AXMessagePipelineRunner, AXMessageRendererRegistry, AXNewConversationDialogComponent, AXPickerFooterComponent, AXPickerHeaderComponent, AXRealtimeApi, AXRegistryService, AXSidebarComponent, AXSidebarService, AXStickerRendererComponent, AXStickerTabComponent, AXSystemRendererComponent, AXTextRendererComponent, AXUserApi, AXVideoInfoBarBannerComponent, AXVideoPickerComponent, AXVideoRendererComponent, AXVoiceInfoBarBannerComponent, AXVoiceRecorderComponent, AXVoiceRendererComponent, AX_COMPOSER_PIPELINE, AX_CONVERSATION_AUDIO_RENDERER, AX_CONVERSATION_COMPOSER_AUDIO_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_ACTION, AX_CONVERSATION_COMPOSER_EMOJI_TAB, AX_CONVERSATION_COMPOSER_FILE_ACTION, AX_CONVERSATION_COMPOSER_IMAGE_ACTION, AX_CONVERSATION_COMPOSER_LOCATION_ACTION, AX_CONVERSATION_COMPOSER_STICKER_TAB, AX_CONVERSATION_COMPOSER_VIDEO_ACTION, AX_CONVERSATION_COMPOSER_VOICE_RECORDING_ACTION, AX_CONVERSATION_CURSOR_PREFIX, AX_CONVERSATION_FALLBACK_RENDERER, AX_CONVERSATION_FILE_RENDERER, AX_CONVERSATION_IMAGE_RENDERER, AX_CONVERSATION_INFO_BAR_ARCHIVE_ACTION, AX_CONVERSATION_INFO_BAR_BLOCK_ACTION, AX_CONVERSATION_INFO_BAR_DELETE_ACTION, AX_CONVERSATION_INFO_BAR_DIVIDER, AX_CONVERSATION_INFO_BAR_INFO_ACTION, AX_CONVERSATION_INFO_BAR_MUTE_ACTION, AX_CONVERSATION_INFO_BAR_SEARCH_ACTION, AX_CONVERSATION_ITEM_BLOCK_ACTION, AX_CONVERSATION_ITEM_DELETE_ACTION, AX_CONVERSATION_ITEM_DIVIDER, AX_CONVERSATION_ITEM_MARK_READ_ACTION, AX_CONVERSATION_ITEM_MUTE_ACTION, AX_CONVERSATION_ITEM_PIN_ACTION, AX_CONVERSATION_LOCATION_RENDERER, AX_CONVERSATION_MESSAGE_COPY_ACTION, AX_CONVERSATION_MESSAGE_DELETE_ACTION, AX_CONVERSATION_MESSAGE_EDIT_ACTION, AX_CONVERSATION_MESSAGE_FORWARD_ACTION, AX_CONVERSATION_MESSAGE_REPLY_ACTION, AX_CONVERSATION_STICKER_RENDERER, AX_CONVERSATION_SYSTEM_RENDERER, AX_CONVERSATION_TAB_ALL, AX_CONVERSATION_TAB_ARCHIVED, AX_CONVERSATION_TAB_BOT, AX_CONVERSATION_TAB_CHANNELS, AX_CONVERSATION_TAB_GROUPS, AX_CONVERSATION_TAB_PRIVATE, AX_CONVERSATION_TAB_UNREAD, AX_CONVERSATION_TEXT_RENDERER, AX_CONVERSATION_VIDEO_RENDERER, AX_CONVERSATION_VOICE_RENDERER, AX_DEFAULT_CONVERSATION_CONFIG, AX_MESSAGE_CURSOR_PREFIX, AX_MESSAGE_PIPELINE, AX_STICKER_API_KEY, CONNECTION_ERRORS, CONVERSATION_CONFIG, CONVERSATION_ERRORS, DEFAULT_COMPOSER_ACTIONS, DEFAULT_COMPOSER_TABS, DEFAULT_CONVERSATION_ITEM_ACTIONS, DEFAULT_CONVERSATION_TABS, DEFAULT_INFO_BAR_ACTIONS, DEFAULT_MESSAGE_ACTIONS, DEFAULT_MESSAGE_RENDERERS, ERROR_HANDLER_CONFIG, ERROR_MESSAGES, FILE_ERRORS, LOCATION_ERRORS, MESSAGE_ERRORS, REGISTRY_CONFIG, URL_ERRORS, USER_ERRORS, applyConversationFilters, axConversationIndexedDbStorage, conversationSharedStorage, encodeConversationCursor, encodeMessageCursor, formatErrorMessage, getConversationLastActivity, getConversationMessagesNewestFirst, getDefaultConversationItemActions, getErrorMessage, getSortedConversationsForInbox, mergeWithDefaults, normalizeAllConversationMessageIndexes, paginateChatNewestFirst, paginateChatOldestFirst, parseChatCursor, provideConversation, registerChatMessage, sanitizeInput, sortConversationMessageIds, unregisterChatMessage, validateConversationId, validateEmail, validateFile, validateLatitude, validateLongitude, validateMessagePayload, validateMessageText, validateMessageType, validateUrl, validateUserId, validateUserIds };
+export type { AXApiError, AXAudioPayload, AXBlockReportReason, AXCallEvent, AXChatCursorKind, AXComposerAction, AXComposerActionComponent, AXComposerActionContext, AXComposerActiveComponent, AXComposerPipeline, AXComposerPipelineAfterApiContext, AXComposerSendMessageOptions, AXComposerTab, AXConnectionEvent, AXConnectionOptions, AXConnectionStatus, AXConversation, AXConversationAiResponderConfig, AXConversationConfig, AXConversationCreateData, AXConversationError, AXConversationFilter, AXConversationFilters, AXConversationItemAction, AXConversationItemActionContext, AXConversationMetadata, AXConversationOptions, AXConversationSettings, AXConversationSettingsUpdate, AXConversationSort, AXConversationStatus, AXConversationTab, AXConversationType, AXConversationUpdateData, AXDeleteMessageCommand, AXEditMessageCommand, AXErrorCode, AXErrorHandlerConfig, AXErrorMessage, AXErrorSeverity, AXFilePayload, AXFileValidationResult, AXGroupedReaction, AXImagePayload, AXInfoBarAction, AXInfoBarActionComponent, AXInfoBarActionContext, AXInfoBarActiveBanner, AXInfoBarActiveComponent, AXLink, AXLinkPreview, AXLoadMessagesResult, AXLocationPayload, AXMention, AXMessage, AXMessageAction, AXMessageActionContext, AXMessageAvatarTemplateContext, AXMessageForwardData, AXMessageInfoBarBannerComponent, AXMessageListEmptyComponent, AXMessagePayload, AXMessagePipeline, AXMessageRenderer, AXMessageRendererCapabilities, AXMessageRendererComponent, AXMessageRendererContentState, AXMessageRendererState, AXMessageSearchFilters, AXMessageStatus, AXMessageType, AXNotificationEvent, AXPaginatedResult, AXPagination, AXPaginationState, AXParsedChatCursor, AXParticipant, AXParticipantRole, AXParticipantStatus, AXParticipantUpdate, AXPinnedMessage, AXPollOption, AXPollPayload, AXPresenceStatus, AXPresenceUpdate, AXReaction, AXReadReceipt, AXRegistryConfiguration, AXRegistryItem, AXSendMessageCommand, AXStickerPayload, AXSystemPayload, AXTextFormat, AXTextPayload, AXTypingIndicator, AXUserProfileUpdate, AXUserRole, AXUserSearchFilters, AXValidationResult, AXVideoPayload, AXVoicePayload, DropdownMenuItem, FilePreview };