@antzsoft/chat-core 1.3.7 → 1.3.9

package/dist/index.d.cts

@@ -1,5 +1,5 @@
-import { R as ResolvedCompressionConfig, L as LoginCredentials, A as AuthResponse, a as RegisterData, b as AuthTokens, U as User, C as CrossConversationSyncResponse, c as ConversationSyncResponse, d as AppConfig, S as SendMessagePayload, e as CursorPaginatedResponse, M as Message, f as MessageReactionsResponse, P as PaginatedResponse, g as MessageReceiptsResponse, h as ConversationListParams, i as Conversation, j as Participant, k as ConversationUnreadCount, l as UnreadSummary, m as UserPreferences, n as ResolvedConfig, o as PersistStorage, p as PresignedUrlRequest, q as PresignedUrlResponse, F as FileResponse, r as CompletedPart, s as FileType, t as AntzChatConfig, u as UploadableFile, B as BatchUploadResult } from './storage-DJh54pps.cjs';
-export { v as Attachment, w as CompressedFile, x as CompressionAlgorithm, y as CompressionConfig, z as ConversationType, D as ConversationUpdatedEvent, E as FileSizeLimits, G as LastReaction, H as MessageAckEvent, I as MessageContent, J as MessageDeletedEvent, K as MessageDeletedForMeEvent, N as MessageDeliveredEvent, O as MessageMetadata, Q as MessageReaction, T as MessageReceiptEntry, V as MessageReplyReference, W as MessageStarUpdatedEvent, X as MessageUpdatedEvent, Y as MessagesDeliveredEvent, Z as MultipartPartUrl, _ as MultipartUploadInfo, $ as NewMessageEvent, a0 as OptimisticAttachment, a1 as PlatformCompressFn, a2 as PlatformUploadFn, a3 as PlatformUploadPartFn, a4 as QuietHours, a5 as ReactionGroup, a6 as ReactionUpdatedEvent, a7 as ReactionUser, a8 as ReadReceiptEvent, a9 as ReplyAttachmentSnapshot, aa as ResolvedFileSizeLimits, ab as SendMessageAttachment, ac as SyncDeletedForMe, ad as SyncDeliveredReceipt, ae as SyncParticipantChange, af as SyncReactionEntry, ag as SyncReactions, ah as SyncReadReceipt, ai as SyncStarEntry, aj as SystemMessageMetadata, ak as TypingIndicatorEvent, al as UploadConfig, am as UploadProgress, an as UserStatusEvent, ao as resolveConfig, ap as storageApi, aq as uploadBatch } from './storage-DJh54pps.cjs';
+import { R as ResolvedCompressionConfig, L as LoginCredentials, A as AuthResponse, a as RegisterData, b as AuthTokens, U as User, C as CrossConversationSyncResponse, c as ConversationSyncResponse, d as AppConfig, S as SendMessagePayload, e as CursorPaginatedResponse, M as Message, f as MessageReactionsResponse, P as PaginatedResponse, g as MessageReceiptsResponse, h as ConversationListParams, i as Conversation, j as Participant, k as ConversationUnreadCount, l as UnreadSummary, m as UserPreferences, n as ResolvedConfig, o as PersistStorage, p as PresignedUrlRequest, q as PresignedUrlResponse, F as FileResponse, r as CompletedPart, s as FileType, t as AntzChatConfig, u as UploadableFile, B as BatchUploadResult } from './storage-C_b-SFFH.cjs';
+export { v as Attachment, w as CompressedFile, x as CompressionAlgorithm, y as CompressionConfig, z as ConversationType, D as ConversationUpdatedEvent, E as FileSizeLimits, G as LastReaction, H as MENTION_ALL_ID, I as MessageAckEvent, J as MessageContent, K as MessageDeletedEvent, N as MessageDeletedForMeEvent, O as MessageDeliveredEvent, Q as MessageMetadata, T as MessageReaction, V as MessageReceiptEntry, W as MessageReplyReference, X as MessageStarUpdatedEvent, Y as MessageUpdatedEvent, Z as MessagesDeliveredEvent, _ as MultipartPartUrl, $ as MultipartUploadInfo, a0 as NewMessageEvent, a1 as OptimisticAttachment, a2 as PlatformCompressFn, a3 as PlatformUploadFn, a4 as PlatformUploadPartFn, a5 as QuietHours, a6 as ReactionGroup, a7 as ReactionUpdatedEvent, a8 as ReactionUser, a9 as ReadReceiptEvent, aa as ReplyAttachmentSnapshot, ab as ResolvedFileSizeLimits, ac as SendMessageAttachment, ad as SyncDeletedForMe, ae as SyncDeliveredReceipt, af as SyncParticipantChange, ag as SyncReactionEntry, ah as SyncReactions, ai as SyncReadReceipt, aj as SyncStarEntry, ak as SystemMessageMetadata, al as TypingIndicatorEvent, am as UploadConfig, an as UploadProgress, ao as UserStatusEvent, ap as resolveConfig, aq as storageApi, ar as uploadBatch } from './storage-C_b-SFFH.cjs';
 import { AxiosInstance } from 'axios';
 import { Socket } from 'socket.io-client';
 import * as zustand_middleware from 'zustand/middleware';
@@ -536,6 +536,66 @@ declare function normalizeAxiosError(error: unknown): AntzChatError;
  */
 declare function resolveSystemMessageText(message: Message, currentUserId: string): string;
 
+interface ParsedMention {
+    /** userId, or "all" */
+    id: string;
+    /** display name captured from the token (fallback for rendering) */
+    displayName: string;
+    /** start index of the whole token in the text (UTF-16) */
+    start: number;
+    /** end index (exclusive) of the whole token in the text (UTF-16) */
+    end: number;
+}
+/** A segment of a message: either plain text or a mention to render specially. */
+type MentionPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'mention';
+    id: string;
+    displayName: string;
+};
+/**
+ * A piece used to compose outgoing text. Plain strings pass through verbatim;
+ * mention objects are serialized to `@[displayName](id)` tokens.
+ */
+type MentionSegment = string | {
+    id: string;
+    displayName: string;
+};
+/**
+ * Finds every `@[name](id)` mention token in the text, in order of appearance.
+ * Pure/computed — nothing is stored. Safe to call on every render.
+ */
+declare function parseMentions(text: string | undefined | null): ParsedMention[];
+/**
+ * Splits text into ordered parts (plain text + mentions) for rendering.
+ * The caller supplies `resolveName(id, fallbackName)` to look up the current
+ * display name from its own directory; return the fallback when unresolvable.
+ * When no resolver is given, the token's embedded name is used.
+ */
+declare function renderMentionParts(text: string | undefined | null, resolveName?: (id: string, fallbackName: string) => string): MentionPart[];
+/**
+ * Builds outgoing message text + the `mentions` id array from composer segments.
+ * Deduplicates ids (a user mentioned twice is fanned out once).
+ *
+ * Example:
+ *   buildMentionText(['Hey ', { id: 'u1', displayName: 'Alice' }, ', look'])
+ *   → { text: 'Hey @[Alice](u1), look', mentions: ['u1'] }
+ */
+declare function buildMentionText(segments: MentionSegment[]): {
+    text: string;
+    mentions: string[];
+};
+/**
+ * Re-derives the `mentions` id array from message text — the source of truth is
+ * always the tokens present in the text. Use this after an edit so a mention whose
+ * token was removed drops out of the array (FR-10).
+ */
+declare function extractMentionIds(text: string | undefined | null): string[];
+/** True when the mentions list targets everyone (@all). */
+declare function isMentionAll(mentions: string[] | undefined): boolean;
+
 interface ClientSocketHandle {
     emit: typeof socketEmit;
     on(event: string, handler: (...args: unknown[]) => void): void;
@@ -667,4 +727,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatAuthError, AntzChatClient, AntzChatConfig, AntzChatError, AntzChatNetworkError, AntzChatPermissionError, AntzChatServerError, AntzChatValidationError, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationSyncResponse, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CrossConversationSyncResponse, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, Message, MessageReactionsResponse, MessageReceiptsResponse, type MobileDeviceToken, PaginatedResponse, Participant, PersistStorage, PresignedUrlRequest, PresignedUrlResponse, RegisterData, type RegisterDeviceTokenPayload, ResolvedCompressionConfig, ResolvedConfig, type SearchParams, type SendData, SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, UnreadSummary, type UpdateConversationData, type UpdateProfilePayload, UploadableFile, User, UserPreferences, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, createRestTransitSession, decryptPayload, devicesApi, disconnectSocket, encryptPayload, fetchServerKeys, generateEphemeralKey, getApiClient, getAuthStore, getCompressionStrategy, getSessionId, getSessionKey, getSocket, getSocketStatus, initApiClient, initAuthStore, isTransitEnvelope, messagesApi, normalizeAxiosError, normalizeConversation, onSocketStatus, performHandshake, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveSystemMessageText, setApiClientInstance, setTransitSession, socketEmit, syncApi, tryGetSocket, useChatStore, usersApi };
+export { AntzChatAuthError, AntzChatClient, AntzChatConfig, AntzChatError, AntzChatNetworkError, AntzChatPermissionError, AntzChatServerError, AntzChatValidationError, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationSyncResponse, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CrossConversationSyncResponse, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, type MentionPart, type MentionSegment, Message, MessageReactionsResponse, MessageReceiptsResponse, type MobileDeviceToken, PaginatedResponse, type ParsedMention, Participant, PersistStorage, PresignedUrlRequest, PresignedUrlResponse, RegisterData, type RegisterDeviceTokenPayload, ResolvedCompressionConfig, ResolvedConfig, type SearchParams, type SendData, SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, UnreadSummary, type UpdateConversationData, type UpdateProfilePayload, UploadableFile, User, UserPreferences, type WebPushDeviceToken, appConfigApi, authApi, buildMentionText, connectSocket, conversationsApi, createAuthStore, createRestTransitSession, decryptPayload, devicesApi, disconnectSocket, encryptPayload, extractMentionIds, fetchServerKeys, generateEphemeralKey, getApiClient, getAuthStore, getCompressionStrategy, getSessionId, getSessionKey, getSocket, getSocketStatus, initApiClient, initAuthStore, isMentionAll, isTransitEnvelope, messagesApi, normalizeAxiosError, normalizeConversation, onSocketStatus, parseMentions, performHandshake, reconnectSocket, refreshSocketAuth, renderMentionParts, resetAuthStore, resolveSystemMessageText, setApiClientInstance, setTransitSession, socketEmit, syncApi, tryGetSocket, useChatStore, usersApi };

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-import { R as ResolvedCompressionConfig, L as LoginCredentials, A as AuthResponse, a as RegisterData, b as AuthTokens, U as User, C as CrossConversationSyncResponse, c as ConversationSyncResponse, d as AppConfig, S as SendMessagePayload, e as CursorPaginatedResponse, M as Message, f as MessageReactionsResponse, P as PaginatedResponse, g as MessageReceiptsResponse, h as ConversationListParams, i as Conversation, j as Participant, k as ConversationUnreadCount, l as UnreadSummary, m as UserPreferences, n as ResolvedConfig, o as PersistStorage, p as PresignedUrlRequest, q as PresignedUrlResponse, F as FileResponse, r as CompletedPart, s as FileType, t as AntzChatConfig, u as UploadableFile, B as BatchUploadResult } from './storage-DJh54pps.js';
-export { v as Attachment, w as CompressedFile, x as CompressionAlgorithm, y as CompressionConfig, z as ConversationType, D as ConversationUpdatedEvent, E as FileSizeLimits, G as LastReaction, H as MessageAckEvent, I as MessageContent, J as MessageDeletedEvent, K as MessageDeletedForMeEvent, N as MessageDeliveredEvent, O as MessageMetadata, Q as MessageReaction, T as MessageReceiptEntry, V as MessageReplyReference, W as MessageStarUpdatedEvent, X as MessageUpdatedEvent, Y as MessagesDeliveredEvent, Z as MultipartPartUrl, _ as MultipartUploadInfo, $ as NewMessageEvent, a0 as OptimisticAttachment, a1 as PlatformCompressFn, a2 as PlatformUploadFn, a3 as PlatformUploadPartFn, a4 as QuietHours, a5 as ReactionGroup, a6 as ReactionUpdatedEvent, a7 as ReactionUser, a8 as ReadReceiptEvent, a9 as ReplyAttachmentSnapshot, aa as ResolvedFileSizeLimits, ab as SendMessageAttachment, ac as SyncDeletedForMe, ad as SyncDeliveredReceipt, ae as SyncParticipantChange, af as SyncReactionEntry, ag as SyncReactions, ah as SyncReadReceipt, ai as SyncStarEntry, aj as SystemMessageMetadata, ak as TypingIndicatorEvent, al as UploadConfig, am as UploadProgress, an as UserStatusEvent, ao as resolveConfig, ap as storageApi, aq as uploadBatch } from './storage-DJh54pps.js';
+import { R as ResolvedCompressionConfig, L as LoginCredentials, A as AuthResponse, a as RegisterData, b as AuthTokens, U as User, C as CrossConversationSyncResponse, c as ConversationSyncResponse, d as AppConfig, S as SendMessagePayload, e as CursorPaginatedResponse, M as Message, f as MessageReactionsResponse, P as PaginatedResponse, g as MessageReceiptsResponse, h as ConversationListParams, i as Conversation, j as Participant, k as ConversationUnreadCount, l as UnreadSummary, m as UserPreferences, n as ResolvedConfig, o as PersistStorage, p as PresignedUrlRequest, q as PresignedUrlResponse, F as FileResponse, r as CompletedPart, s as FileType, t as AntzChatConfig, u as UploadableFile, B as BatchUploadResult } from './storage-C_b-SFFH.js';
+export { v as Attachment, w as CompressedFile, x as CompressionAlgorithm, y as CompressionConfig, z as ConversationType, D as ConversationUpdatedEvent, E as FileSizeLimits, G as LastReaction, H as MENTION_ALL_ID, I as MessageAckEvent, J as MessageContent, K as MessageDeletedEvent, N as MessageDeletedForMeEvent, O as MessageDeliveredEvent, Q as MessageMetadata, T as MessageReaction, V as MessageReceiptEntry, W as MessageReplyReference, X as MessageStarUpdatedEvent, Y as MessageUpdatedEvent, Z as MessagesDeliveredEvent, _ as MultipartPartUrl, $ as MultipartUploadInfo, a0 as NewMessageEvent, a1 as OptimisticAttachment, a2 as PlatformCompressFn, a3 as PlatformUploadFn, a4 as PlatformUploadPartFn, a5 as QuietHours, a6 as ReactionGroup, a7 as ReactionUpdatedEvent, a8 as ReactionUser, a9 as ReadReceiptEvent, aa as ReplyAttachmentSnapshot, ab as ResolvedFileSizeLimits, ac as SendMessageAttachment, ad as SyncDeletedForMe, ae as SyncDeliveredReceipt, af as SyncParticipantChange, ag as SyncReactionEntry, ah as SyncReactions, ai as SyncReadReceipt, aj as SyncStarEntry, ak as SystemMessageMetadata, al as TypingIndicatorEvent, am as UploadConfig, an as UploadProgress, ao as UserStatusEvent, ap as resolveConfig, aq as storageApi, ar as uploadBatch } from './storage-C_b-SFFH.js';
 import { AxiosInstance } from 'axios';
 import { Socket } from 'socket.io-client';
 import * as zustand_middleware from 'zustand/middleware';
@@ -536,6 +536,66 @@ declare function normalizeAxiosError(error: unknown): AntzChatError;
  */
 declare function resolveSystemMessageText(message: Message, currentUserId: string): string;
 
+interface ParsedMention {
+    /** userId, or "all" */
+    id: string;
+    /** display name captured from the token (fallback for rendering) */
+    displayName: string;
+    /** start index of the whole token in the text (UTF-16) */
+    start: number;
+    /** end index (exclusive) of the whole token in the text (UTF-16) */
+    end: number;
+}
+/** A segment of a message: either plain text or a mention to render specially. */
+type MentionPart = {
+    type: 'text';
+    text: string;
+} | {
+    type: 'mention';
+    id: string;
+    displayName: string;
+};
+/**
+ * A piece used to compose outgoing text. Plain strings pass through verbatim;
+ * mention objects are serialized to `@[displayName](id)` tokens.
+ */
+type MentionSegment = string | {
+    id: string;
+    displayName: string;
+};
+/**
+ * Finds every `@[name](id)` mention token in the text, in order of appearance.
+ * Pure/computed — nothing is stored. Safe to call on every render.
+ */
+declare function parseMentions(text: string | undefined | null): ParsedMention[];
+/**
+ * Splits text into ordered parts (plain text + mentions) for rendering.
+ * The caller supplies `resolveName(id, fallbackName)` to look up the current
+ * display name from its own directory; return the fallback when unresolvable.
+ * When no resolver is given, the token's embedded name is used.
+ */
+declare function renderMentionParts(text: string | undefined | null, resolveName?: (id: string, fallbackName: string) => string): MentionPart[];
+/**
+ * Builds outgoing message text + the `mentions` id array from composer segments.
+ * Deduplicates ids (a user mentioned twice is fanned out once).
+ *
+ * Example:
+ *   buildMentionText(['Hey ', { id: 'u1', displayName: 'Alice' }, ', look'])
+ *   → { text: 'Hey @[Alice](u1), look', mentions: ['u1'] }
+ */
+declare function buildMentionText(segments: MentionSegment[]): {
+    text: string;
+    mentions: string[];
+};
+/**
+ * Re-derives the `mentions` id array from message text — the source of truth is
+ * always the tokens present in the text. Use this after an edit so a mention whose
+ * token was removed drops out of the array (FR-10).
+ */
+declare function extractMentionIds(text: string | undefined | null): string[];
+/** True when the mentions list targets everyone (@all). */
+declare function isMentionAll(mentions: string[] | undefined): boolean;
+
 interface ClientSocketHandle {
     emit: typeof socketEmit;
     on(event: string, handler: (...args: unknown[]) => void): void;
@@ -667,4 +727,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatAuthError, AntzChatClient, AntzChatConfig, AntzChatError, AntzChatNetworkError, AntzChatPermissionError, AntzChatServerError, AntzChatValidationError, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationSyncResponse, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CrossConversationSyncResponse, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, Message, MessageReactionsResponse, MessageReceiptsResponse, type MobileDeviceToken, PaginatedResponse, Participant, PersistStorage, PresignedUrlRequest, PresignedUrlResponse, RegisterData, type RegisterDeviceTokenPayload, ResolvedCompressionConfig, ResolvedConfig, type SearchParams, type SendData, SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, UnreadSummary, type UpdateConversationData, type UpdateProfilePayload, UploadableFile, User, UserPreferences, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, createRestTransitSession, decryptPayload, devicesApi, disconnectSocket, encryptPayload, fetchServerKeys, generateEphemeralKey, getApiClient, getAuthStore, getCompressionStrategy, getSessionId, getSessionKey, getSocket, getSocketStatus, initApiClient, initAuthStore, isTransitEnvelope, messagesApi, normalizeAxiosError, normalizeConversation, onSocketStatus, performHandshake, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveSystemMessageText, setApiClientInstance, setTransitSession, socketEmit, syncApi, tryGetSocket, useChatStore, usersApi };
+export { AntzChatAuthError, AntzChatClient, AntzChatConfig, AntzChatError, AntzChatNetworkError, AntzChatPermissionError, AntzChatServerError, AntzChatValidationError, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationSyncResponse, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CrossConversationSyncResponse, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, type MentionPart, type MentionSegment, Message, MessageReactionsResponse, MessageReceiptsResponse, type MobileDeviceToken, PaginatedResponse, type ParsedMention, Participant, PersistStorage, PresignedUrlRequest, PresignedUrlResponse, RegisterData, type RegisterDeviceTokenPayload, ResolvedCompressionConfig, ResolvedConfig, type SearchParams, type SendData, SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, UnreadSummary, type UpdateConversationData, type UpdateProfilePayload, UploadableFile, User, UserPreferences, type WebPushDeviceToken, appConfigApi, authApi, buildMentionText, connectSocket, conversationsApi, createAuthStore, createRestTransitSession, decryptPayload, devicesApi, disconnectSocket, encryptPayload, extractMentionIds, fetchServerKeys, generateEphemeralKey, getApiClient, getAuthStore, getCompressionStrategy, getSessionId, getSessionKey, getSocket, getSocketStatus, initApiClient, initAuthStore, isMentionAll, isTransitEnvelope, messagesApi, normalizeAxiosError, normalizeConversation, onSocketStatus, parseMentions, performHandshake, reconnectSocket, refreshSocketAuth, renderMentionParts, resetAuthStore, resolveSystemMessageText, setApiClientInstance, setTransitSession, socketEmit, syncApi, tryGetSocket, useChatStore, usersApi };

package/dist/index.js

@@ -401,11 +401,13 @@ function normalizeParticipant(p) {
   const hasUserDetails = p.displayName || p.username || p.avatarUrl;
   return {
     userId: p.userId,
+    externalId: p.externalId ?? p.user?.externalId,
     role: p.role,
     joinedAt: p.joinedAt,
     isActive: p.isActive,
     user: hasUserDetails ? {
       id: p.userId,
+      externalId: p.externalId,
       tenantId: "",
       email: "",
       username: p.username ?? "",
@@ -513,7 +515,7 @@ var conversationsApi = {
       `/conversations/${conversationId}/participants`,
       filter ? { params: { filter } } : void 0
     );
-    return data;
+    return (data ?? []).map(normalizeParticipant);
   },
   /**
    * Get unread message count for a single conversation.
@@ -1062,6 +1064,80 @@ var socketEmit = {
   }
 };
 
+// src/types/index.ts
+var MENTION_ALL_ID = "all";
+
+// src/utils/mentions.ts
+var MENTION_TOKEN_SOURCE = "@\\[([^\\]]+)\\]\\((all|[a-fA-F0-9]{24})\\)";
+function sanitizeDisplayName(name) {
+  return name.replace(/[\[\]()]/g, "").trim() || "user";
+}
+function parseMentions(text) {
+  if (!text) return [];
+  const re = new RegExp(MENTION_TOKEN_SOURCE, "g");
+  const out = [];
+  let m;
+  while ((m = re.exec(text)) !== null) {
+    out.push({
+      id: m[2],
+      displayName: m[1],
+      start: m.index,
+      end: m.index + m[0].length
+    });
+  }
+  return out;
+}
+function renderMentionParts(text, resolveName) {
+  if (!text) return [];
+  const mentions = parseMentions(text);
+  if (mentions.length === 0) return [{ type: "text", text }];
+  const parts = [];
+  let cursor = 0;
+  for (const mn of mentions) {
+    if (mn.start > cursor) {
+      parts.push({ type: "text", text: text.slice(cursor, mn.start) });
+    }
+    const displayName = resolveName ? resolveName(mn.id, mn.displayName) : mn.displayName;
+    parts.push({ type: "mention", id: mn.id, displayName });
+    cursor = mn.end;
+  }
+  if (cursor < text.length) {
+    parts.push({ type: "text", text: text.slice(cursor) });
+  }
+  return parts;
+}
+function buildMentionText(segments) {
+  let text = "";
+  const ids = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const seg of segments) {
+    if (typeof seg === "string") {
+      text += seg;
+    } else {
+      text += `@[${sanitizeDisplayName(seg.displayName)}](${seg.id})`;
+      if (!seen.has(seg.id)) {
+        seen.add(seg.id);
+        ids.push(seg.id);
+      }
+    }
+  }
+  return { text, mentions: ids };
+}
+function extractMentionIds(text) {
+  const ids = [];
+  const seen = /* @__PURE__ */ new Set();
+  for (const mn of parseMentions(text)) {
+    if (!seen.has(mn.id)) {
+      seen.add(mn.id);
+      ids.push(mn.id);
+    }
+  }
+  return ids;
+}
+function isMentionAll(mentions) {
+  return !!mentions?.includes(MENTION_ALL_ID);
+}
+
 // src/client-facade.ts
 var AntzChatClient = class {
   constructor(rawConfig) {
@@ -1119,8 +1195,10 @@ export {
   AntzChatPermissionError,
   AntzChatServerError,
   AntzChatValidationError,
+  MENTION_ALL_ID,
   appConfigApi,
   authApi,
+  buildMentionText,
   connectSocket,
   conversationsApi,
   createAuthStore,
@@ -1129,6 +1207,7 @@ export {
   devicesApi,
   disconnectSocket,
   encryptPayload,
+  extractMentionIds,
   fetchServerKeys,
   generateEphemeralKey,
   getApiClient,
@@ -1140,14 +1219,17 @@ export {
   getSocketStatus,
   initApiClient,
   initAuthStore,
+  isMentionAll,
   isTransitEnvelope,
   messagesApi,
   normalizeAxiosError,
   normalizeConversation,
   onSocketStatus,
+  parseMentions,
   performHandshake,
   reconnectSocket,
   refreshSocketAuth,
+  renderMentionParts,
   resetAuthStore,
   resolveConfig,
   resolveSystemMessageText,