@composy/chat-core 0.0.1 → 0.0.2

package/es/core/transport.js

@@ -0,0 +1,102 @@
+/*!
+* ***********************************
+* @composy/chat-core v0.0.2       *
+* Built with rollup               *
+* Build time: 2024-10-12 21:52:18 *
+* Build mode: production          *
+* Minified: No                    *
+* ***********************************
+*/
+//#region src/core/transport.ts
+var ChatTransportController = class {
+	constructor(transport, options = {}) {
+		this.status = "idle";
+		this.unsubscribeEvents = null;
+		this.unsubscribeStatus = null;
+		this.destroyed = false;
+		this.connectPromise = null;
+		this.lifecycle = 0;
+		this.transport = transport;
+		this.options = options;
+		this.cursor = options.cursor;
+	}
+	getStatus() {
+		return this.status;
+	}
+	getCursor() {
+		return this.cursor;
+	}
+	async connect(signal) {
+		if (this.destroyed) throw new Error("Chat transport controller is disposed.");
+		if (this.status === "connected") return;
+		if (this.connectPromise) return this.connectPromise;
+		const lifecycle = ++this.lifecycle;
+		this.setStatus("connecting");
+		this.connectPromise = (async () => {
+			this.unsubscribeEvents?.();
+			this.unsubscribeStatus?.();
+			this.unsubscribeEvents = this.transport.subscribe((event) => this.handleEvent(event));
+			this.unsubscribeStatus = this.transport.onStatusChange?.((status) => this.setStatus(status)) ?? null;
+			try {
+				await this.transport.connect({
+					conversationId: this.options.conversationId,
+					cursor: this.cursor,
+					signal
+				});
+				if (this.destroyed || lifecycle !== this.lifecycle) return;
+				this.setStatus("connected");
+			} catch (error) {
+				if (!this.destroyed && lifecycle === this.lifecycle) this.setStatus("error");
+				throw error;
+			} finally {
+				this.connectPromise = null;
+			}
+		})();
+		return this.connectPromise;
+	}
+	async disconnect() {
+		if (this.destroyed) return;
+		this.lifecycle += 1;
+		this.connectPromise = null;
+		try {
+			await this.transport.disconnect();
+		} finally {
+			this.setStatus("disconnected");
+		}
+	}
+	async send(message, options = {}) {
+		if (this.destroyed) throw new Error("Chat transport controller is disposed.");
+		if (this.status !== "connected") throw new Error(`Chat transport is not connected: ${this.status}`);
+		const result = await this.transport.send(message, options);
+		if (result && result.cursor) this.cursor = result.cursor;
+		return result;
+	}
+	dispose() {
+		if (this.destroyed) return;
+		this.destroyed = true;
+		this.lifecycle += 1;
+		this.unsubscribeEvents?.();
+		this.unsubscribeStatus?.();
+		this.unsubscribeEvents = null;
+		this.unsubscribeStatus = null;
+		this.connectPromise = null;
+		Promise.resolve(this.transport.disconnect()).catch(() => void 0);
+		this.setStatus("disconnected");
+	}
+	handleEvent(event) {
+		if (this.destroyed) return;
+		if ("cursor" in event && event.cursor) this.cursor = event.cursor;
+		if (event.type === "ack" && event.ack.cursor) this.cursor = event.ack.cursor;
+		if (event.type === "error" && !event.recoverable) this.setStatus("error");
+		this.options.onEvent?.(event);
+	}
+	setStatus(status) {
+		if (this.status === status) return;
+		this.status = status;
+		this.options.onStatusChange?.(status);
+	}
+};
+//#endregion
+export { ChatTransportController };
+/*! End of @composy/chat-core | Powered by @composy/builder */
+//# sourceMappingURL=transport.js.map

package/es/core/transport.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.js","names":[],"sources":["../../src/core/transport.ts"],"sourcesContent":["import type { ChatMessage } from '../types'\n\n/** transport 连接状态。 */\nexport type ChatTransportStatus =\n  'idle' | 'connecting' | 'connected' | 'disconnected' | 'error'\n\n/** 建立 transport 时传入的同步上下文。 */\nexport interface ChatTransportContext {\n  conversationId?: string\n  cursor?: string\n  signal?: AbortSignal\n}\n\n/** transport ack，可携带服务端补全后的消息和同步序号。 */\nexport interface ChatTransportAck {\n  clientMessageId: string\n  message?: Partial<ChatMessage>\n  sequence?: number\n  cursor?: string\n}\n\n/** transport 推送的统一事件协议。 */\nexport type ChatTransportEvent =\n  | {\n      type: 'message'\n      message: ChatMessage\n      sequence?: number\n      cursor?: string\n    }\n  | { type: 'ack'; ack: ChatTransportAck }\n  | { type: 'cursor'; cursor: string }\n  | { type: 'error'; error: unknown; recoverable?: boolean }\n\n/** 可由 HTTP/SSE/WebSocket/原生 App bridge 实现的最小 transport 协议。 */\nexport interface ChatTransport {\n  connect: (context?: ChatTransportContext) => void | Promise<void>\n  disconnect: () => void | Promise<void>\n  send: (\n    message: ChatMessage,\n    options?: { signal?: AbortSignal; clientMessageId?: string }\n  ) => Promise<ChatTransportAck | void>\n  subscribe: (listener: (event: ChatTransportEvent) => void) => () => void\n  onStatusChange?: (\n    listener: (status: ChatTransportStatus) => void\n  ) => () => void\n}\n\nexport interface ChatTransportControllerOptions {\n  conversationId?: string\n  cursor?: string\n  onEvent?: (event: ChatTransportEvent) => void\n  onStatusChange?: (status: ChatTransportStatus) => void\n}\n\n/**\n * 连接生命周期、游标和外部 transport 事件的统一控制器。\n *\n * Controller 不假设网络实现，负责避免重复 connect、转发状态、保存 cursor，\n * 并在 dispose 后拒绝迟到的异步结果。\n */\nexport class ChatTransportController {\n  private readonly transport: ChatTransport\n  private readonly options: ChatTransportControllerOptions\n  private status: ChatTransportStatus = 'idle'\n  private cursor?: string\n  private unsubscribeEvents: (() => void) | null = null\n  private unsubscribeStatus: (() => void) | null = null\n  private destroyed = false\n  private connectPromise: Promise<void> | null = null\n  private lifecycle = 0\n\n  constructor(\n    transport: ChatTransport,\n    options: ChatTransportControllerOptions = {}\n  ) {\n    this.transport = transport\n    this.options = options\n    this.cursor = options.cursor\n  }\n\n  getStatus(): ChatTransportStatus {\n    return this.status\n  }\n\n  getCursor(): string | undefined {\n    return this.cursor\n  }\n\n  async connect(signal?: AbortSignal): Promise<void> {\n    if (this.destroyed)\n      throw new Error('Chat transport controller is disposed.')\n    if (this.status === 'connected') return\n    if (this.connectPromise) return this.connectPromise\n\n    const lifecycle = ++this.lifecycle\n    this.setStatus('connecting')\n    this.connectPromise = (async () => {\n      this.unsubscribeEvents?.()\n      this.unsubscribeStatus?.()\n      this.unsubscribeEvents = this.transport.subscribe(event =>\n        this.handleEvent(event)\n      )\n      this.unsubscribeStatus =\n        this.transport.onStatusChange?.(status => this.setStatus(status)) ??\n        null\n      try {\n        await this.transport.connect({\n          conversationId: this.options.conversationId,\n          cursor: this.cursor,\n          signal,\n        })\n        if (this.destroyed || lifecycle !== this.lifecycle) return\n        this.setStatus('connected')\n      } catch (error) {\n        if (!this.destroyed && lifecycle === this.lifecycle) {\n          this.setStatus('error')\n        }\n        throw error\n      } finally {\n        this.connectPromise = null\n      }\n    })()\n\n    return this.connectPromise\n  }\n\n  async disconnect(): Promise<void> {\n    if (this.destroyed) return\n    this.lifecycle += 1\n    this.connectPromise = null\n    try {\n      await this.transport.disconnect()\n    } finally {\n      this.setStatus('disconnected')\n    }\n  }\n\n  async send(\n    message: ChatMessage,\n    options: { signal?: AbortSignal; clientMessageId?: string } = {}\n  ): Promise<ChatTransportAck | void> {\n    if (this.destroyed)\n      throw new Error('Chat transport controller is disposed.')\n    if (this.status !== 'connected') {\n      throw new Error(`Chat transport is not connected: ${this.status}`)\n    }\n    const result = await this.transport.send(message, options)\n    if (result && result.cursor) this.cursor = result.cursor\n    return result\n  }\n\n  dispose(): void {\n    if (this.destroyed) return\n    this.destroyed = true\n    this.lifecycle += 1\n    this.unsubscribeEvents?.()\n    this.unsubscribeStatus?.()\n    this.unsubscribeEvents = null\n    this.unsubscribeStatus = null\n    this.connectPromise = null\n    void Promise.resolve(this.transport.disconnect()).catch(() => undefined)\n    this.setStatus('disconnected')\n  }\n\n  private handleEvent(event: ChatTransportEvent): void {\n    if (this.destroyed) return\n    if ('cursor' in event && event.cursor) this.cursor = event.cursor\n    if (event.type === 'ack' && event.ack.cursor) {\n      this.cursor = event.ack.cursor\n    }\n    if (event.type === 'error' && !event.recoverable) this.setStatus('error')\n    this.options.onEvent?.(event)\n  }\n\n  private setStatus(status: ChatTransportStatus): void {\n    if (this.status === status) return\n    this.status = status\n    this.options.onStatusChange?.(status)\n  }\n}\n"],"mappings":";;;;;;;;;;AA4DO,IAAM,0BAAN,MAA8B;CAWnC,YACE,WACA,UAA0C,CAAC,GAC3C;EAXF,KAAQ,SAA8B;EAEtC,KAAQ,oBAAyC;EACjD,KAAQ,oBAAyC;EACjD,KAAQ,YAAY;EACpB,KAAQ,iBAAuC;EAC/C,KAAQ,YAAY;EAMlB,KAAK,YAAY;EACjB,KAAK,UAAU;EACf,KAAK,SAAS,QAAQ;CACxB;CAEA,YAAiC;EAC/B,OAAO,KAAK;CACd;CAEA,YAAgC;EAC9B,OAAO,KAAK;CACd;CAEA,MAAM,QAAQ,QAAqC;EACjD,IAAI,KAAK,WACP,MAAM,IAAI,MAAM,wCAAwC;EAC1D,IAAI,KAAK,WAAW,aAAa;EACjC,IAAI,KAAK,gBAAgB,OAAO,KAAK;EAErC,MAAM,YAAY,EAAE,KAAK;EACzB,KAAK,UAAU,YAAY;EAC3B,KAAK,kBAAkB,YAAY;GACjC,KAAK,oBAAoB;GACzB,KAAK,oBAAoB;GACzB,KAAK,oBAAoB,KAAK,UAAU,WAAU,UAChD,KAAK,YAAY,KAAK,CACxB;GACA,KAAK,oBACH,KAAK,UAAU,kBAAiB,WAAU,KAAK,UAAU,MAAM,CAAC,KAChE;GACF,IAAI;IACF,MAAM,KAAK,UAAU,QAAQ;KAC3B,gBAAgB,KAAK,QAAQ;KAC7B,QAAQ,KAAK;KACb;IACF,CAAC;IACD,IAAI,KAAK,aAAa,cAAc,KAAK,WAAW;IACpD,KAAK,UAAU,WAAW;GAC5B,SAAS,OAAO;IACd,IAAI,CAAC,KAAK,aAAa,cAAc,KAAK,WACxC,KAAK,UAAU,OAAO;IAExB,MAAM;GACR,UAAE;IACA,KAAK,iBAAiB;GACxB;EACF,EAAA,CAAG;EAEH,OAAO,KAAK;CACd;CAEA,MAAM,aAA4B;EAChC,IAAI,KAAK,WAAW;EACpB,KAAK,aAAa;EAClB,KAAK,iBAAiB;EACtB,IAAI;GACF,MAAM,KAAK,UAAU,WAAW;EAClC,UAAE;GACA,KAAK,UAAU,cAAc;EAC/B;CACF;CAEA,MAAM,KACJ,SACA,UAA8D,CAAC,GAC7B;EAClC,IAAI,KAAK,WACP,MAAM,IAAI,MAAM,wCAAwC;EAC1D,IAAI,KAAK,WAAW,aAClB,MAAM,IAAI,MAAM,oCAAoC,KAAK,QAAQ;EAEnE,MAAM,SAAS,MAAM,KAAK,UAAU,KAAK,SAAS,OAAO;EACzD,IAAI,UAAU,OAAO,QAAQ,KAAK,SAAS,OAAO;EAClD,OAAO;CACT;CAEA,UAAgB;EACd,IAAI,KAAK,WAAW;EACpB,KAAK,YAAY;EACjB,KAAK,aAAa;EAClB,KAAK,oBAAoB;EACzB,KAAK,oBAAoB;EACzB,KAAK,oBAAoB;EACzB,KAAK,oBAAoB;EACzB,KAAK,iBAAiB;EACtB,QAAa,QAAQ,KAAK,UAAU,WAAW,CAAC,CAAA,CAAE,YAAY,KAAA,CAAS;EACvE,KAAK,UAAU,cAAc;CAC/B;CAEQ,YAAY,OAAiC;EACnD,IAAI,KAAK,WAAW;EACpB,IAAI,YAAY,SAAS,MAAM,QAAQ,KAAK,SAAS,MAAM;EAC3D,IAAI,MAAM,SAAS,SAAS,MAAM,IAAI,QACpC,KAAK,SAAS,MAAM,IAAI;EAE1B,IAAI,MAAM,SAAS,WAAW,CAAC,MAAM,aAAa,KAAK,UAAU,OAAO;EACxE,KAAK,QAAQ,UAAU,KAAK;CAC9B;CAEQ,UAAU,QAAmC;EACnD,IAAI,KAAK,WAAW,QAAQ;EAC5B,KAAK,SAAS;EACd,KAAK,QAAQ,iBAAiB,MAAM;CACtC;AACF"}

package/es/index.d.ts

@@ -10,19 +10,24 @@
  */
 import type { ChatConfig, ChatInstance } from './types';
 export declare const version = "0.1.0";
-export * from './types';
-export { EventEmitter } from './core/event-emitter';
+export { COMPONENT_CSS_VAR_PREFIX, cx, DEFAULT_CLASS_PREFIX, getStyleElementId, normalizeClassPrefix, STYLE_ELEMENT_ID, } from './constants/dom';
 export { ChatManager } from './core/chat-manager';
+export type { MessageMergeOptions, MessageMergeResult, StreamAppendOptions, } from './core/chat-manager';
+export { EventEmitter } from './core/event-emitter';
 export { MentionEngine } from './core/mention-engine';
 export type { MentionState } from './core/mention-engine';
+export { cloneChatMessage, compareChatMessages, normalizeChatContentBlocks, normalizeChatMessage, normalizeChatMessages, } from './core/message-schema';
+export { ChatOutbox, MemoryChatOutboxStorage } from './core/outbox';
+export type { ChatOutboxEntry, ChatOutboxFlushOptions, ChatOutboxFlushResult, ChatOutboxOptions, ChatOutboxStorage, } from './core/outbox';
+export { ChatTransportController } from './core/transport';
+export type { ChatTransport, ChatTransportAck, ChatTransportContext, ChatTransportControllerOptions, ChatTransportEvent, ChatTransportStatus, } from './core/transport';
+export { DOMRenderer } from './renderer/dom-renderer';
+export { cls, clsx, injectStyles, removeStyles, updateStyles, } from './renderer/style-manager';
 export { ThemeManager } from './theme/theme-manager';
 export type { ThemeTokens } from './theme/tokens';
-export { lightTokens, darkTokens } from './theme/tokens';
-export { DOMRenderer } from './renderer/dom-renderer';
-export { injectStyles, updateStyles, removeStyles, cls, clsx } from './renderer/style-manager';
-export { DEFAULT_CLASS_PREFIX, COMPONENT_CSS_VAR_PREFIX, STYLE_ELEMENT_ID, getStyleElementId, normalizeClassPrefix, cx, } from './constants/dom';
+export { darkTokens, lightTokens } from './theme/tokens';
+export * from './types';
 /**
  * 创建聊天实例
  */
 export declare function createChat(config: ChatConfig): ChatInstance;
-//# sourceMappingURL=index.d.ts.map

package/es/index.js

@@ -1,25 +1,34 @@
 /*!
 * ***********************************
-* @composy/chat-core v0.0.1       *
+* @composy/chat-core v0.0.2       *
 * Built with rollup               *
-* Build time: 2024-08-17 11:30:32 *
+* Build time: 2024-10-12 21:52:18 *
 * Build mode: production          *
 * Minified: No                    *
 * ***********************************
 */
 import { COMPONENT_CSS_VAR_PREFIX, DEFAULT_CLASS_PREFIX, STYLE_ELEMENT_ID, cx, getStyleElementId, normalizeClassPrefix } from "./constants/dom.js";
+import { CHAT_MESSAGE_SCHEMA_VERSION } from "./types/index.js";
+import { cloneChatMessage, compareChatMessages, normalizeChatContentBlocks, normalizeChatMessage, normalizeChatMessages } from "./core/message-schema.js";
 import { ChatManager } from "./core/chat-manager.js";
 import { EventEmitter } from "./core/event-emitter.js";
 import { MentionEngine } from "./core/mention-engine.js";
+import { ChatOutbox, MemoryChatOutboxStorage } from "./core/outbox.js";
+import { ChatTransportController } from "./core/transport.js";
+import { cls, clsx, injectStyles, removeStyles, updateStyles } from "./renderer/style-manager.js";
+import { DOMRenderer } from "./renderer/dom-renderer.js";
 import { darkTokens, lightTokens } from "./theme/tokens.js";
 import { ThemeManager } from "./theme/theme-manager.js";
-import { DOMRenderer } from "./renderer/dom-renderer.js";
-import { cls, clsx, injectStyles, removeStyles, updateStyles } from "./renderer/style-manager.js";
 //#region src/index.ts
 const version = "0.1.0";
 function createChat(config) {
-	const container = typeof config.container === "string" ? document.querySelector(config.container) : config.container;
+	let container;
+	if (typeof config.container === "string") {
+		if (typeof document === "undefined") throw new Error("[Chat] A browser Document is required to resolve a container selector.");
+		container = document.querySelector(config.container);
+	} else container = config.container;
 	if (!container) throw new Error(`[Chat] Container not found: ${config.container}`);
+	const ownerDocument = container.ownerDocument;
 	const prefix = normalizeClassPrefix(config.classPrefix ?? "ldesign-chat");
 	const normalizedConfig = {
 		...config,
@@ -28,23 +37,70 @@ function createChat(config) {
 	const emitter = new EventEmitter();
 	const chatManager = new ChatManager(emitter, normalizedConfig.messages);
 	const mentionEngine = new MentionEngine(emitter, normalizedConfig.mentionMembers);
-	const themeManager = new ThemeManager(emitter, normalizedConfig.theme ?? "light");
+	const themeManager = new ThemeManager(emitter, normalizedConfig.theme ?? "light", ownerDocument.defaultView);
 	const renderer = new DOMRenderer(container, normalizedConfig, emitter, mentionEngine);
-	injectStyles(themeManager.getTokens(), prefix);
+	let destroyed = false;
+	const schedule = (callback) => {
+		const run = () => {
+			if (!destroyed) callback();
+		};
+		if (ownerDocument.defaultView?.requestAnimationFrame) ownerDocument.defaultView.requestAnimationFrame(run);
+		else setTimeout(run, 0);
+	};
 	renderer.init();
 	renderer.renderMessages(chatManager.getMessages());
-	requestAnimationFrame(() => {
+	renderer.setThemeTokens(themeManager.getTokens());
+	injectStyles(themeManager.getTokens(), prefix, renderer.getRootElement());
+	const applyTransportAck = async (ack) => {
+		const localId = chatManager.getMessageIdByClientMessageId(ack.clientMessageId);
+		if (localId) chatManager.updateMessage(localId, {
+			...ack.message ?? {},
+			id: localId,
+			clientMessageId: ack.clientMessageId,
+			status: "sent",
+			...ack.sequence !== void 0 && { sequence: ack.sequence },
+			...ack.cursor !== void 0 && { cursor: ack.cursor }
+		});
+		if (normalizedConfig.outbox) await normalizedConfig.outbox.remove(ack.clientMessageId);
+		emitter.emit("transport-ack", ack);
+	};
+	const handleTransportEvent = (event) => {
+		if (event.type === "message") chatManager.upsertMessage({
+			...event.message,
+			...event.cursor !== void 0 && { cursor: event.cursor }
+		}, {
+			sequence: event.sequence,
+			source: "remote"
+		});
+		else if (event.type === "ack") applyTransportAck(event.ack).catch((error) => {
+			emitter.emit("transport-error", error);
+		});
+		else if (event.type === "cursor") emitter.emit("transport-cursor", event.cursor);
+		else emitter.emit("transport-error", event.error, event.recoverable);
+	};
+	const transportController = normalizedConfig.transport ? new ChatTransportController(normalizedConfig.transport, {
+		conversationId: normalizedConfig.conversationId,
+		cursor: normalizedConfig.transportCursor,
+		onEvent: handleTransportEvent,
+		onStatusChange: (status) => {
+			emitter.emit("transport-status", status);
+		}
+	}) : null;
+	schedule(() => {
 		renderer.scrollToBottom(false);
 	});
 	emitter.on("theme-change", (_resolved, tokens) => {
-		updateStyles(tokens, prefix);
+		renderer.setThemeTokens(tokens);
 	});
 	emitter.on("message-added", (message) => {
 		renderer.appendMessage(message);
-		requestAnimationFrame(() => {
+		schedule(() => {
 			renderer.scrollToBottom(true);
 		});
 	});
+	emitter.on("mention-select", (member) => {
+		normalizedConfig.onMentionSelect?.(member);
+	});
 	emitter.on("messages-prepended", (messages) => {
 		renderer.prependMessages(messages);
 	});
@@ -56,85 +112,160 @@ function createChat(config) {
 	});
 	emitter.on("message-content-appended", (id, content) => {
 		renderer.updateMessageContent(id, content);
-		requestAnimationFrame(() => {
+		schedule(() => {
 			renderer.scrollToBottom(false);
 		});
 	});
-	return {
+	const instance = {
 		addMessage(message) {
-			chatManager.addMessage(message);
+			if (!destroyed) chatManager.addMessage(message);
 		},
 		prependMessages(messages) {
-			chatManager.prependMessages(messages);
+			if (!destroyed) chatManager.prependMessages(messages);
 		},
 		updateMessage(id, updates) {
-			chatManager.updateMessage(id, updates);
+			if (!destroyed) chatManager.updateMessage(id, updates);
 		},
 		removeMessage(id) {
-			chatManager.removeMessage(id);
+			if (!destroyed) chatManager.removeMessage(id);
 		},
 		setMessages(messages) {
+			if (destroyed) return;
 			chatManager.setMessages(messages);
 			renderer.renderMessages(chatManager.getMessages());
-			requestAnimationFrame(() => {
+			schedule(() => {
 				renderer.scrollToBottom(false);
 			});
 		},
 		clearMessages() {
-			chatManager.clearMessages();
-			renderer.renderMessages([]);
+			if (!destroyed) {
+				chatManager.clearMessages();
+				renderer.renderMessages([]);
+			}
 		},
 		scrollToBottom(smooth = true) {
-			renderer.scrollToBottom(smooth);
+			if (!destroyed) renderer.scrollToBottom(smooth);
 		},
 		setTheme(theme) {
-			themeManager.setTheme(theme);
+			if (!destroyed) themeManager.setTheme(theme);
 		},
 		setMentionMembers(members) {
-			mentionEngine.setMembers(members);
+			if (!destroyed) mentionEngine.setMembers(members);
 		},
 		setLoadingMore(loading) {
-			renderer.setLoadingMore(loading);
+			if (!destroyed) renderer.setLoadingMore(loading);
 		},
 		focusInput() {
-			renderer.focusInput();
+			if (!destroyed) renderer.focusInput();
 		},
 		setInputContent(content) {
-			renderer.setInputContent(content);
+			if (!destroyed) renderer.setInputContent(content);
 		},
 		getInputContent() {
-			return renderer.getInputContent();
+			return destroyed ? "" : renderer.getInputContent();
 		},
 		clearInput() {
-			renderer.clearInput();
+			if (!destroyed) renderer.clearInput();
 		},
 		isAtBottom(threshold) {
-			return renderer.isAtBottom(threshold);
+			return destroyed || renderer.isAtBottom(threshold);
 		},
 		on(event, handler) {
-			return emitter.on(event, handler);
+			return destroyed ? () => {} : emitter.on(event, handler);
 		},
 		getMessages() {
-			return chatManager.getMessages();
+			return destroyed ? [] : chatManager.getMessages();
 		},
 		getMessage(id) {
-			return chatManager.getMessage(id);
+			return destroyed ? void 0 : chatManager.getMessage(id);
 		},
 		appendMessageContent(id, chunk) {
-			chatManager.appendMessageContent(id, chunk);
+			return destroyed ? false : chatManager.appendMessageContent(id, chunk);
 		},
-		finishStreaming(id) {
-			chatManager.finishStreaming(id);
+		finishStreaming(id, generation) {
+			return destroyed ? false : chatManager.finishStreaming(id, generation);
+		},
+		beginStreaming(id, generation) {
+			return destroyed ? null : chatManager.beginStreaming(id, generation);
+		},
+		cancelStreaming(id, generation) {
+			return destroyed ? false : chatManager.cancelStreaming(id, generation);
+		},
+		mergeMessage(message, sequence) {
+			return destroyed ? "ignored" : chatManager.upsertMessage(message, {
+				sequence,
+				source: "remote"
+			});
+		},
+		async connectTransport(signal) {
+			if (!transportController) throw new Error("No chat transport is configured.");
+			await transportController.connect(signal);
+		},
+		async disconnectTransport() {
+			await transportController?.disconnect();
+		},
+		getTransportStatus() {
+			return transportController?.getStatus() ?? "idle";
+		},
+		async sendMessage(message, options = {}) {
+			if (!transportController) throw new Error("No chat transport is configured.");
+			if (destroyed) throw new Error("Chat instance is destroyed.");
+			const prepared = normalizeChatMessage({
+				...message,
+				clientMessageId: message.clientMessageId ?? createClientMessageId(message.id),
+				status: message.status ?? "sending"
+			});
+			chatManager.addMessage(prepared);
+			try {
+				if (normalizedConfig.outbox) await normalizedConfig.outbox.enqueue(prepared);
+				const ack = await transportController.send(prepared, {
+					signal: options.signal,
+					clientMessageId: prepared.clientMessageId
+				});
+				if (ack) await applyTransportAck(ack);
+				else chatManager.markMessageStatus(prepared.id, "sent");
+				emitter.emit("message-sent", prepared, ack);
+				return ack;
+			} catch (error) {
+				chatManager.markMessageStatus(prepared.id, "failed");
+				emitter.emit("message-send-failed", prepared, error);
+				throw error;
+			}
+		},
+		async flushOutbox(options = {}) {
+			if (!normalizedConfig.outbox) return {
+				sent: [],
+				failed: [],
+				remaining: []
+			};
+			if (!transportController) throw new Error("No chat transport is configured.");
+			return normalizedConfig.outbox.flush(async (message, sendOptions) => {
+				const ack = await transportController.send(message, sendOptions);
+				if (ack) await applyTransportAck(ack);
+				else if (message.id) chatManager.markMessageStatus(message.id, "sent");
+			}, options);
 		},
 		destroy() {
+			if (destroyed) return;
+			destroyed = true;
+			transportController?.dispose();
 			themeManager.destroy();
 			renderer.destroy();
 			emitter.removeAll();
-			removeStyles(prefix);
+			removeStyles(prefix, ownerDocument);
 		}
 	};
+	if (normalizedConfig.autoConnect && transportController) instance.connectTransport().catch((error) => {
+		emitter.emit("transport-error", error);
+	});
+	return instance;
+}
+function createClientMessageId(messageId) {
+	const cryptoObject = globalThis.crypto;
+	if (cryptoObject?.randomUUID) return cryptoObject.randomUUID();
+	return `client-${messageId}-${Date.now()}-${Math.random().toString(36).slice(2)}`;
 }
 //#endregion
-export { COMPONENT_CSS_VAR_PREFIX, ChatManager, DEFAULT_CLASS_PREFIX, DOMRenderer, EventEmitter, MentionEngine, STYLE_ELEMENT_ID, ThemeManager, cls, clsx, createChat, cx, darkTokens, getStyleElementId, injectStyles, lightTokens, normalizeClassPrefix, removeStyles, updateStyles, version };
+export { CHAT_MESSAGE_SCHEMA_VERSION, COMPONENT_CSS_VAR_PREFIX, ChatManager, ChatOutbox, ChatTransportController, DEFAULT_CLASS_PREFIX, DOMRenderer, EventEmitter, MemoryChatOutboxStorage, MentionEngine, STYLE_ELEMENT_ID, ThemeManager, cloneChatMessage, cls, clsx, compareChatMessages, createChat, cx, darkTokens, getStyleElementId, injectStyles, lightTokens, normalizeChatContentBlocks, normalizeChatMessage, normalizeChatMessages, normalizeClassPrefix, removeStyles, updateStyles, version };
 /*! End of @composy/chat-core | Powered by @composy/builder */
 //# sourceMappingURL=index.js.map

package/es/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\n * @composy/chat-core - 即时通讯/IM 组件核心库\n *\n * 提供聊天气泡、消息列表、@提及、多消息类型（文本/图片/文件/系统消息/自定义）、\n * 消息状态管理（发送中/已发送/已送达/已读/失败）、亮暗主题切换等能力。\n * 框架无关的核心实现，配合 Vue/React 适配层使用。\n *\n * @packageDocumentation\n * @module @composy/chat-core\n */\n\nimport type { ChatConfig, ChatInstance, ChatMessage, ThemeMode, MentionItem, ToolbarConfig } from './types';\nimport type { ThemeTokens } from './theme/tokens';\nimport { EventEmitter } from './core/event-emitter';\nimport { ChatManager } from './core/chat-manager';\nimport { MentionEngine } from './core/mention-engine';\nimport { ThemeManager } from './theme/theme-manager';\nimport { DOMRenderer } from './renderer/dom-renderer';\nimport { injectStyles, updateStyles, removeStyles } from './renderer/style-manager';\nimport { DEFAULT_CLASS_PREFIX, normalizeClassPrefix } from './constants/dom';\n\nexport const version = '0.1.0';\n\n// Types\nexport * from './types';\n\n// Core\nexport { EventEmitter } from './core/event-emitter';\nexport { ChatManager } from './core/chat-manager';\nexport { MentionEngine } from './core/mention-engine';\nexport type { MentionState } from './core/mention-engine';\n\n// Theme\nexport { ThemeManager } from './theme/theme-manager';\nexport type { ThemeTokens } from './theme/tokens';\nexport { lightTokens, darkTokens } from './theme/tokens';\n\n// Renderer\nexport { DOMRenderer } from './renderer/dom-renderer';\nexport { injectStyles, updateStyles, removeStyles, cls, clsx } from './renderer/style-manager';\nexport {\n  DEFAULT_CLASS_PREFIX,\n  COMPONENT_CSS_VAR_PREFIX,\n  STYLE_ELEMENT_ID,\n  getStyleElementId,\n  normalizeClassPrefix,\n  cx,\n} from './constants/dom';\n\n/**\n * 创建聊天实例\n */\nexport function createChat(config: ChatConfig): ChatInstance {\n  // 解析容器\n  const container =\n    typeof config.container === 'string'\n      ? document.querySelector<HTMLElement>(config.container)\n      : config.container;\n\n  if (!container) {\n    throw new Error(`[Chat] Container not found: ${config.container}`);\n  }\n\n  const prefix = normalizeClassPrefix(config.classPrefix ?? DEFAULT_CLASS_PREFIX);\n  const normalizedConfig = {\n    ...config,\n    classPrefix: prefix,\n  };\n  const emitter = new EventEmitter();\n  const chatManager = new ChatManager(emitter, normalizedConfig.messages);\n  const mentionEngine = new MentionEngine(emitter, normalizedConfig.mentionMembers);\n  const themeManager = new ThemeManager(emitter, normalizedConfig.theme ?? 'light');\n  const renderer = new DOMRenderer(container, normalizedConfig, emitter, mentionEngine);\n\n  // 注入样式\n  injectStyles(themeManager.getTokens(), prefix);\n\n  // 初始化渲染\n  renderer.init();\n  renderer.renderMessages(chatManager.getMessages());\n\n  // 初始滚动到底部\n  requestAnimationFrame(() => {\n    renderer.scrollToBottom(false);\n  });\n\n  // 监听主题变化\n  emitter.on('theme-change', (_resolved: string, tokens: ThemeTokens) => {\n    updateStyles(tokens, prefix);\n  });\n\n  // 监听消息变化\n  emitter.on('message-added', (message: ChatMessage) => {\n    renderer.appendMessage(message);\n    requestAnimationFrame(() => {\n      renderer.scrollToBottom(true);\n    });\n  });\n\n  emitter.on('messages-prepended', (messages: ChatMessage[]) => {\n    renderer.prependMessages(messages);\n  });\n\n  emitter.on('message-updated', (message: ChatMessage) => {\n    renderer.updateMessage(message.id, message);\n  });\n\n  emitter.on('message-removed', (message: ChatMessage) => {\n    renderer.removeMessage(message.id);\n  });\n\n  // 流式消息内容追加\n  emitter.on('message-content-appended', (id: string, content: string) => {\n    renderer.updateMessageContent(id, content);\n    requestAnimationFrame(() => {\n      renderer.scrollToBottom(false);\n    });\n  });\n\n  // 创建实例\n  const instance: ChatInstance = {\n    addMessage(message: ChatMessage) {\n      chatManager.addMessage(message);\n    },\n\n    prependMessages(messages: ChatMessage[]) {\n      chatManager.prependMessages(messages);\n    },\n\n    updateMessage(id: string, updates: Partial<ChatMessage>) {\n      chatManager.updateMessage(id, updates);\n    },\n\n    removeMessage(id: string) {\n      chatManager.removeMessage(id);\n    },\n\n    setMessages(messages: ChatMessage[]) {\n      chatManager.setMessages(messages);\n      renderer.renderMessages(chatManager.getMessages());\n      requestAnimationFrame(() => {\n        renderer.scrollToBottom(false);\n      });\n    },\n\n    clearMessages() {\n      chatManager.clearMessages();\n      renderer.renderMessages([]);\n    },\n\n    scrollToBottom(smooth = true) {\n      renderer.scrollToBottom(smooth);\n    },\n\n    setTheme(theme: ThemeMode) {\n      themeManager.setTheme(theme);\n    },\n\n    setMentionMembers(members: MentionItem[]) {\n      mentionEngine.setMembers(members);\n    },\n\n    setLoadingMore(loading: boolean) {\n      renderer.setLoadingMore(loading);\n    },\n\n    focusInput() {\n      renderer.focusInput();\n    },\n\n    setInputContent(content: string) {\n      renderer.setInputContent(content);\n    },\n\n    getInputContent() {\n      return renderer.getInputContent();\n    },\n\n    clearInput() {\n      renderer.clearInput();\n    },\n\n    isAtBottom(threshold?: number) {\n      return renderer.isAtBottom(threshold);\n    },\n\n    on(event: string, handler: (...args: unknown[]) => void) {\n      return emitter.on(event, handler);\n    },\n\n    getMessages() {\n      return chatManager.getMessages();\n    },\n\n    getMessage(id: string) {\n      return chatManager.getMessage(id);\n    },\n\n    appendMessageContent(id: string, chunk: string) {\n      chatManager.appendMessageContent(id, chunk);\n    },\n\n    finishStreaming(id: string) {\n      chatManager.finishStreaming(id);\n    },\n\n    destroy() {\n      themeManager.destroy();\n      renderer.destroy();\n      emitter.removeAll();\n      removeStyles(prefix);\n    },\n  };\n\n  return instance;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["/**\r\n * @composy/chat-core - 即时通讯/IM 组件核心库\r\n *\r\n * 提供聊天气泡、消息列表、@提及、多消息类型（文本/图片/文件/系统消息/自定义）、\r\n * 消息状态管理（发送中/已发送/已送达/已读/失败）、亮暗主题切换等能力。\r\n * 框架无关的核心实现，配合 Vue/React 适配层使用。\r\n *\r\n * @packageDocumentation\r\n * @module @composy/chat-core\r\n */\r\n\r\nimport type { ChatOutboxFlushOptions } from './core/outbox'\r\nimport type {\r\n  ChatTransportAck,\r\n  ChatTransportEvent,\r\n  ChatTransportStatus,\r\n} from './core/transport'\r\nimport type { ThemeTokens } from './theme/tokens'\r\nimport type {\r\n  ChatConfig,\r\n  ChatInstance,\r\n  ChatMessage,\r\n  MentionItem,\r\n  ThemeMode,\r\n} from './types'\r\nimport { DEFAULT_CLASS_PREFIX, normalizeClassPrefix } from './constants/dom'\r\nimport { ChatManager } from './core/chat-manager'\r\nimport { EventEmitter } from './core/event-emitter'\r\nimport { MentionEngine } from './core/mention-engine'\r\nimport { normalizeChatMessage } from './core/message-schema'\r\nimport { ChatTransportController } from './core/transport'\r\nimport { DOMRenderer } from './renderer/dom-renderer'\r\nimport { injectStyles, removeStyles } from './renderer/style-manager'\r\nimport { ThemeManager } from './theme/theme-manager'\r\n\r\nexport const version = '0.1.0'\r\n\r\nexport {\r\n  COMPONENT_CSS_VAR_PREFIX,\r\n  cx,\r\n  DEFAULT_CLASS_PREFIX,\r\n  getStyleElementId,\r\n  normalizeClassPrefix,\r\n  STYLE_ELEMENT_ID,\r\n} from './constants/dom'\r\n\r\nexport { ChatManager } from './core/chat-manager'\r\nexport type {\r\n  MessageMergeOptions,\r\n  MessageMergeResult,\r\n  StreamAppendOptions,\r\n} from './core/chat-manager'\r\n// Core\r\nexport { EventEmitter } from './core/event-emitter'\r\nexport { MentionEngine } from './core/mention-engine'\r\nexport type { MentionState } from './core/mention-engine'\r\nexport {\r\n  cloneChatMessage,\r\n  compareChatMessages,\r\n  normalizeChatContentBlocks,\r\n  normalizeChatMessage,\r\n  normalizeChatMessages,\r\n} from './core/message-schema'\r\nexport { ChatOutbox, MemoryChatOutboxStorage } from './core/outbox'\r\nexport type {\r\n  ChatOutboxEntry,\r\n  ChatOutboxFlushOptions,\r\n  ChatOutboxFlushResult,\r\n  ChatOutboxOptions,\r\n  ChatOutboxStorage,\r\n} from './core/outbox'\r\nexport { ChatTransportController } from './core/transport'\r\nexport type {\r\n  ChatTransport,\r\n  ChatTransportAck,\r\n  ChatTransportContext,\r\n  ChatTransportControllerOptions,\r\n  ChatTransportEvent,\r\n  ChatTransportStatus,\r\n} from './core/transport'\r\n\r\n// Renderer\r\nexport { DOMRenderer } from './renderer/dom-renderer'\r\nexport {\r\n  cls,\r\n  clsx,\r\n  injectStyles,\r\n  removeStyles,\r\n  updateStyles,\r\n} from './renderer/style-manager'\r\n// Theme\r\nexport { ThemeManager } from './theme/theme-manager'\r\n\r\nexport type { ThemeTokens } from './theme/tokens'\r\nexport { darkTokens, lightTokens } from './theme/tokens'\r\n// Types\r\nexport * from './types'\r\n\r\n/**\r\n * 创建聊天实例\r\n */\r\nexport function createChat(config: ChatConfig): ChatInstance {\r\n  // 解析容器\r\n  let container: HTMLElement | null\r\n  if (typeof config.container === 'string') {\r\n    if (typeof document === 'undefined') {\r\n      throw new Error(\r\n        '[Chat] A browser Document is required to resolve a container selector.'\r\n      )\r\n    }\r\n    container = document.querySelector<HTMLElement>(config.container)\r\n  } else {\r\n    container = config.container\r\n  }\r\n\r\n  if (!container) {\r\n    throw new Error(`[Chat] Container not found: ${config.container}`)\r\n  }\r\n\r\n  const ownerDocument = container.ownerDocument\r\n  const prefix = normalizeClassPrefix(\r\n    config.classPrefix ?? DEFAULT_CLASS_PREFIX\r\n  )\r\n  const normalizedConfig = {\r\n    ...config,\r\n    classPrefix: prefix,\r\n  }\r\n  const emitter = new EventEmitter()\r\n  const chatManager = new ChatManager(emitter, normalizedConfig.messages)\r\n  const mentionEngine = new MentionEngine(\r\n    emitter,\r\n    normalizedConfig.mentionMembers\r\n  )\r\n  const themeManager = new ThemeManager(\r\n    emitter,\r\n    normalizedConfig.theme ?? 'light',\r\n    ownerDocument.defaultView\r\n  )\r\n  const renderer = new DOMRenderer(\r\n    container,\r\n    normalizedConfig,\r\n    emitter,\r\n    mentionEngine\r\n  )\r\n  let destroyed = false\r\n  const schedule = (callback: () => void) => {\r\n    const run = () => {\r\n      if (!destroyed) callback()\r\n    }\r\n    if (ownerDocument.defaultView?.requestAnimationFrame) {\r\n      ownerDocument.defaultView.requestAnimationFrame(run)\r\n    } else {\r\n      setTimeout(run, 0)\r\n    }\r\n  }\r\n\r\n  // 初始化渲染\r\n  renderer.init()\r\n  renderer.renderMessages(chatManager.getMessages())\r\n  renderer.setThemeTokens(themeManager.getTokens())\r\n  injectStyles(themeManager.getTokens(), prefix, renderer.getRootElement())\r\n\r\n  const applyTransportAck = async (ack: ChatTransportAck): Promise<void> => {\r\n    const localId = chatManager.getMessageIdByClientMessageId(\r\n      ack.clientMessageId\r\n    )\r\n    if (localId) {\r\n      chatManager.updateMessage(localId, {\r\n        ...(ack.message ?? {}),\r\n        id: localId,\r\n        clientMessageId: ack.clientMessageId,\r\n        status: 'sent',\r\n        ...(ack.sequence !== undefined && { sequence: ack.sequence }),\r\n        ...(ack.cursor !== undefined && { cursor: ack.cursor }),\r\n      })\r\n    }\r\n    if (normalizedConfig.outbox) {\r\n      await normalizedConfig.outbox.remove(ack.clientMessageId)\r\n    }\r\n    emitter.emit('transport-ack', ack)\r\n  }\r\n\r\n  const handleTransportEvent = (event: ChatTransportEvent): void => {\r\n    if (event.type === 'message') {\r\n      chatManager.upsertMessage(\r\n        {\r\n          ...event.message,\r\n          ...(event.cursor !== undefined && { cursor: event.cursor }),\r\n        },\r\n        { sequence: event.sequence, source: 'remote' }\r\n      )\r\n    } else if (event.type === 'ack') {\r\n      void applyTransportAck(event.ack).catch(error => {\r\n        emitter.emit('transport-error', error)\r\n      })\r\n    } else if (event.type === 'cursor') {\r\n      emitter.emit('transport-cursor', event.cursor)\r\n    } else {\r\n      emitter.emit('transport-error', event.error, event.recoverable)\r\n    }\r\n  }\r\n\r\n  const transportController = normalizedConfig.transport\r\n    ? new ChatTransportController(normalizedConfig.transport, {\r\n        conversationId: normalizedConfig.conversationId,\r\n        cursor: normalizedConfig.transportCursor,\r\n        onEvent: handleTransportEvent,\r\n        onStatusChange: status => {\r\n          emitter.emit('transport-status', status)\r\n        },\r\n      })\r\n    : null\r\n\r\n  // 初始滚动到底部\r\n  schedule(() => {\r\n    renderer.scrollToBottom(false)\r\n  })\r\n\r\n  // 监听主题变化\r\n  emitter.on('theme-change', (_resolved: string, tokens: ThemeTokens) => {\r\n    renderer.setThemeTokens(tokens)\r\n  })\r\n\r\n  // 监听消息变化\r\n  emitter.on('message-added', (message: ChatMessage) => {\r\n    renderer.appendMessage(message)\r\n    schedule(() => {\r\n      renderer.scrollToBottom(true)\r\n    })\r\n  })\r\n\r\n  emitter.on('mention-select', (member: MentionItem) => {\r\n    normalizedConfig.onMentionSelect?.(member)\r\n  })\r\n\r\n  emitter.on('messages-prepended', (messages: ChatMessage[]) => {\r\n    renderer.prependMessages(messages)\r\n  })\r\n\r\n  emitter.on('message-updated', (message: ChatMessage) => {\r\n    renderer.updateMessage(message.id, message)\r\n  })\r\n\r\n  emitter.on('message-removed', (message: ChatMessage) => {\r\n    renderer.removeMessage(message.id)\r\n  })\r\n\r\n  // 流式消息内容追加\r\n  emitter.on('message-content-appended', (id: string, content: string) => {\r\n    renderer.updateMessageContent(id, content)\r\n    schedule(() => {\r\n      renderer.scrollToBottom(false)\r\n    })\r\n  })\r\n\r\n  // 创建实例\r\n  const instance: ChatInstance = {\r\n    addMessage(message: ChatMessage) {\r\n      if (!destroyed) chatManager.addMessage(message)\r\n    },\r\n\r\n    prependMessages(messages: ChatMessage[]) {\r\n      if (!destroyed) chatManager.prependMessages(messages)\r\n    },\r\n\r\n    updateMessage(id: string, updates: Partial<ChatMessage>) {\r\n      if (!destroyed) chatManager.updateMessage(id, updates)\r\n    },\r\n\r\n    removeMessage(id: string) {\r\n      if (!destroyed) chatManager.removeMessage(id)\r\n    },\r\n\r\n    setMessages(messages: ChatMessage[]) {\r\n      if (destroyed) return\r\n      chatManager.setMessages(messages)\r\n      renderer.renderMessages(chatManager.getMessages())\r\n      schedule(() => {\r\n        renderer.scrollToBottom(false)\r\n      })\r\n    },\r\n\r\n    clearMessages() {\r\n      if (!destroyed) {\r\n        chatManager.clearMessages()\r\n        renderer.renderMessages([])\r\n      }\r\n    },\r\n\r\n    scrollToBottom(smooth = true) {\r\n      if (!destroyed) renderer.scrollToBottom(smooth)\r\n    },\r\n\r\n    setTheme(theme: ThemeMode) {\r\n      if (!destroyed) themeManager.setTheme(theme)\r\n    },\r\n\r\n    setMentionMembers(members: MentionItem[]) {\r\n      if (!destroyed) mentionEngine.setMembers(members)\r\n    },\r\n\r\n    setLoadingMore(loading: boolean) {\r\n      if (!destroyed) renderer.setLoadingMore(loading)\r\n    },\r\n\r\n    focusInput() {\r\n      if (!destroyed) renderer.focusInput()\r\n    },\r\n\r\n    setInputContent(content: string) {\r\n      if (!destroyed) renderer.setInputContent(content)\r\n    },\r\n\r\n    getInputContent() {\r\n      return destroyed ? '' : renderer.getInputContent()\r\n    },\r\n\r\n    clearInput() {\r\n      if (!destroyed) renderer.clearInput()\r\n    },\r\n\r\n    isAtBottom(threshold?: number) {\r\n      return destroyed || renderer.isAtBottom(threshold)\r\n    },\r\n\r\n    on(event: string, handler: (...args: unknown[]) => void) {\r\n      return destroyed ? () => {} : emitter.on(event, handler)\r\n    },\r\n\r\n    getMessages() {\r\n      return destroyed ? [] : chatManager.getMessages()\r\n    },\r\n\r\n    getMessage(id: string) {\r\n      return destroyed ? undefined : chatManager.getMessage(id)\r\n    },\r\n\r\n    appendMessageContent(id: string, chunk: string) {\r\n      return destroyed ? false : chatManager.appendMessageContent(id, chunk)\r\n    },\r\n\r\n    finishStreaming(id: string, generation?: string) {\r\n      return destroyed ? false : chatManager.finishStreaming(id, generation)\r\n    },\r\n\r\n    beginStreaming(id: string, generation?: string) {\r\n      return destroyed ? null : chatManager.beginStreaming(id, generation)\r\n    },\r\n\r\n    cancelStreaming(id: string, generation?: string) {\r\n      return destroyed ? false : chatManager.cancelStreaming(id, generation)\r\n    },\r\n\r\n    mergeMessage(message: ChatMessage, sequence?: number) {\r\n      return destroyed\r\n        ? 'ignored'\r\n        : chatManager.upsertMessage(message, {\r\n            sequence,\r\n            source: 'remote',\r\n          })\r\n    },\r\n\r\n    async connectTransport(signal?: AbortSignal) {\r\n      if (!transportController) {\r\n        throw new Error('No chat transport is configured.')\r\n      }\r\n      await transportController.connect(signal)\r\n    },\r\n\r\n    async disconnectTransport() {\r\n      await transportController?.disconnect()\r\n    },\r\n\r\n    getTransportStatus(): ChatTransportStatus {\r\n      return transportController?.getStatus() ?? 'idle'\r\n    },\r\n\r\n    async sendMessage(\r\n      message: ChatMessage,\r\n      options: { signal?: AbortSignal } = {}\r\n    ): Promise<ChatTransportAck | void> {\r\n      if (!transportController) {\r\n        throw new Error('No chat transport is configured.')\r\n      }\r\n      if (destroyed) throw new Error('Chat instance is destroyed.')\r\n      const prepared = normalizeChatMessage({\r\n        ...message,\r\n        clientMessageId:\r\n          message.clientMessageId ?? createClientMessageId(message.id),\r\n        status: message.status ?? 'sending',\r\n      })\r\n      chatManager.addMessage(prepared)\r\n      try {\r\n        if (normalizedConfig.outbox) {\r\n          await normalizedConfig.outbox.enqueue(prepared)\r\n        }\r\n        const ack = await transportController.send(prepared, {\r\n          signal: options.signal,\r\n          clientMessageId: prepared.clientMessageId,\r\n        })\r\n        if (ack) await applyTransportAck(ack)\r\n        else chatManager.markMessageStatus(prepared.id, 'sent')\r\n        emitter.emit('message-sent', prepared, ack)\r\n        return ack\r\n      } catch (error) {\r\n        chatManager.markMessageStatus(prepared.id, 'failed')\r\n        emitter.emit('message-send-failed', prepared, error)\r\n        throw error\r\n      }\r\n    },\r\n\r\n    async flushOutbox(options: ChatOutboxFlushOptions = {}) {\r\n      if (!normalizedConfig.outbox) {\r\n        return { sent: [], failed: [], remaining: [] }\r\n      }\r\n      if (!transportController) {\r\n        throw new Error('No chat transport is configured.')\r\n      }\r\n      return normalizedConfig.outbox.flush(async (message, sendOptions) => {\r\n        const ack = await transportController.send(message, sendOptions)\r\n        if (ack) await applyTransportAck(ack)\r\n        else if (message.id) chatManager.markMessageStatus(message.id, 'sent')\r\n      }, options)\r\n    },\r\n\r\n    destroy() {\r\n      if (destroyed) return\r\n      destroyed = true\r\n      transportController?.dispose()\r\n      themeManager.destroy()\r\n      renderer.destroy()\r\n      emitter.removeAll()\r\n      removeStyles(prefix, ownerDocument)\r\n    },\r\n  }\r\n\r\n  if (normalizedConfig.autoConnect && transportController) {\r\n    void instance.connectTransport().catch(error => {\r\n      emitter.emit('transport-error', error)\r\n    })\r\n  }\r\n\r\n  return instance\r\n}\r\n\r\nfunction createClientMessageId(messageId: string): string {\r\n  const cryptoObject = globalThis.crypto\r\n  if (cryptoObject?.randomUUID) return cryptoObject.randomUUID()\r\n  return `client-${messageId}-${Date.now()}-${Math.random().toString(36).slice(2)}`\r\n}\r\n"],"mappings":"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"}

package/es/renderer/dom-renderer.d.ts

@@ -1,8 +1,10 @@
+import type { EventEmitter } from '../core/event-emitter';
+import type { MentionEngine } from '../core/mention-engine';
+import type { ThemeTokens } from '../theme/tokens';
 import type { ChatConfig, ChatMessage, MentionItem } from '../types';
-import { EventEmitter } from '../core/event-emitter';
-import { MentionEngine } from '../core/mention-engine';
 export declare class DOMRenderer {
     private container;
+    private document;
     private config;
     private emitter;
     private mentionEngine;
@@ -21,6 +23,8 @@ export declare class DOMRenderer {
     private isRecording;
     private recognition;
     private lastVoiceTranscript;
+    private destroyed;
+    private pendingFileInputs;
     constructor(container: HTMLElement, config: ChatConfig, emitter: EventEmitter, mentionEngine: MentionEngine);
     init(): void;
     updateMessageContent(id: string, content: string): void;
@@ -32,6 +36,8 @@ export declare class DOMRenderer {
     scrollToBottom(smooth?: boolean): void;
     isAtBottom(threshold?: number): boolean;
     setLoadingMore(loading: boolean): void;
+    setThemeTokens(tokens: ThemeTokens): void;
+    getRootElement(): HTMLElement;
     focusInput(): void;
     setInputContent(content: string): void;
     getInputContent(): string;
@@ -55,6 +61,7 @@ export declare class DOMRenderer {
     private autoResize;
     private updateSendButtonState;
     private renderLoadMoreButton;
+    private loadMore;
     private renderTimeDivider;
     private createTimeDivider;
     private renderMessageRow;
@@ -62,18 +69,23 @@ export declare class DOMRenderer {
     private createAvatar;
     private createMessageFooter;
     private createBubble;
+    private renderContentBlocks;
     private renderTextContent;
+    private setSanitizedCustomHtml;
+    private sanitizeCustomNode;
+    private safeResourceUrl;
+    private safeUrl;
     private renderEmpty;
     private removeEmpty;
     private el;
     private getMessageElements;
+    private getMessageRow;
+    private refreshTimeDividers;
     private formatTime;
     private formatShortTime;
     private formatFileSize;
     private limitInput;
-    private getCssSizeValue;
     private escapeHtml;
     private escapeAttr;
     private escapeRegex;
 }
-//# sourceMappingURL=dom-renderer.d.ts.map