@antzsoft/chat-core 1.1.2 → 1.1.4

package/dist/index.d.cts

@@ -681,7 +681,7 @@ declare const conversationsApi: {
     unmute(conversationId: string): Promise<void>;
     pin(conversationId: string): Promise<void>;
     unpin(conversationId: string): Promise<void>;
-    leave(conversationId: string): Promise<void>;
+    leave(conversationId: string, andDelete?: boolean): Promise<void>;
     getMembers(conversationId: string, filter?: "deleted" | "all"): Promise<Participant[]>;
     /**
      * Get unread message count for a single conversation.
@@ -701,6 +701,7 @@ declare const conversationsApi: {
      * Server copies storageKey into conversation.iconMeta and deletes the chat_files record.
      */
     uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
+    removeIcon(conversationId: string): Promise<Conversation>;
 };
 
 declare const storageApi: {
@@ -791,6 +792,30 @@ declare const devicesApi: {
     remove(deviceId: string): Promise<void>;
 };
 
+/**
+ * Fields for updating the current user's profile.
+ *
+ * Works in both builtin and non-builtin (external/SSO/WSO2) modes.
+ *
+ * In non-builtin modes, firstName/lastName/email/displayName/phone are also
+ * synced from the upstream user-service (on socket connect if stale, and every
+ * 2 hours via cron). Calling updateProfile() is the way to push an immediate
+ * update to the chat server without waiting for the next sync cycle — useful
+ * when the host app knows a profile change just happened in the identity provider.
+ *
+ * Uniqueness constraints: email and phone must each be unique within the tenant.
+ * A 409 is returned if another user already holds the same email or phone.
+ *
+ * username and status are intentionally excluded — username is a system
+ * identifier and status is lifecycle-managed by user-service.
+ */
+interface UpdateProfilePayload {
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    displayName?: string;
+    phone?: string;
+}
 declare const usersApi: {
     list(params?: {
         query?: string;
@@ -801,6 +826,13 @@ declare const usersApi: {
     getLastSeen(userId: string): Promise<{
         lastSeenAt: string | null;
     }>;
+    /**
+     * Update basic profile fields for the current user.
+     * Works in both builtin and non-builtin modes. Use this to push an immediate
+     * profile update to the chat server when the host app knows a change just
+     * happened — without waiting for the next 2-hour sync cycle.
+     */
+    updateProfile(payload: UpdateProfilePayload): Promise<User>;
     /**
      * Update notification preferences for the current user.
      * Partial update — only send fields you want to change.
@@ -1075,11 +1107,12 @@ declare class AntzChatClient {
         unmute(conversationId: string): Promise<void>;
         pin(conversationId: string): Promise<void>;
         unpin(conversationId: string): Promise<void>;
-        leave(conversationId: string): Promise<void>;
+        leave(conversationId: string, andDelete?: boolean): Promise<void>;
         getMembers(conversationId: string, filter?: "deleted" | "all"): Promise<Participant[]>;
         getUnreadCount(conversationId: string): Promise<ConversationUnreadCount>;
         getUnreadSummary(): Promise<UnreadSummary>;
         uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
+        removeIcon(conversationId: string): Promise<Conversation>;
     };
     readonly storage: {
         requestPresignedUrl(payload: PresignedUrlRequest): Promise<PresignedUrlResponse>;
@@ -1117,6 +1150,7 @@ declare class AntzChatClient {
         getLastSeen(userId: string): Promise<{
             lastSeenAt: string | null;
         }>;
+        updateProfile(payload: UpdateProfilePayload): Promise<User>;
         updatePreferences(prefs: UserPreferences): Promise<User>;
         getPreferences(): Promise<UserPreferences | null>;
     };
@@ -1128,4 +1162,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ReplyAttachmentSnapshot, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, setTransitSession, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };
+export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ReplyAttachmentSnapshot, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UpdateProfilePayload, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, setTransitSession, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };

package/dist/index.d.ts

@@ -681,7 +681,7 @@ declare const conversationsApi: {
     unmute(conversationId: string): Promise<void>;
     pin(conversationId: string): Promise<void>;
     unpin(conversationId: string): Promise<void>;
-    leave(conversationId: string): Promise<void>;
+    leave(conversationId: string, andDelete?: boolean): Promise<void>;
     getMembers(conversationId: string, filter?: "deleted" | "all"): Promise<Participant[]>;
     /**
      * Get unread message count for a single conversation.
@@ -701,6 +701,7 @@ declare const conversationsApi: {
      * Server copies storageKey into conversation.iconMeta and deletes the chat_files record.
      */
     uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
+    removeIcon(conversationId: string): Promise<Conversation>;
 };
 
 declare const storageApi: {
@@ -791,6 +792,30 @@ declare const devicesApi: {
     remove(deviceId: string): Promise<void>;
 };
 
+/**
+ * Fields for updating the current user's profile.
+ *
+ * Works in both builtin and non-builtin (external/SSO/WSO2) modes.
+ *
+ * In non-builtin modes, firstName/lastName/email/displayName/phone are also
+ * synced from the upstream user-service (on socket connect if stale, and every
+ * 2 hours via cron). Calling updateProfile() is the way to push an immediate
+ * update to the chat server without waiting for the next sync cycle — useful
+ * when the host app knows a profile change just happened in the identity provider.
+ *
+ * Uniqueness constraints: email and phone must each be unique within the tenant.
+ * A 409 is returned if another user already holds the same email or phone.
+ *
+ * username and status are intentionally excluded — username is a system
+ * identifier and status is lifecycle-managed by user-service.
+ */
+interface UpdateProfilePayload {
+    firstName?: string;
+    lastName?: string;
+    email?: string;
+    displayName?: string;
+    phone?: string;
+}
 declare const usersApi: {
     list(params?: {
         query?: string;
@@ -801,6 +826,13 @@ declare const usersApi: {
     getLastSeen(userId: string): Promise<{
         lastSeenAt: string | null;
     }>;
+    /**
+     * Update basic profile fields for the current user.
+     * Works in both builtin and non-builtin modes. Use this to push an immediate
+     * profile update to the chat server when the host app knows a change just
+     * happened — without waiting for the next 2-hour sync cycle.
+     */
+    updateProfile(payload: UpdateProfilePayload): Promise<User>;
     /**
      * Update notification preferences for the current user.
      * Partial update — only send fields you want to change.
@@ -1075,11 +1107,12 @@ declare class AntzChatClient {
         unmute(conversationId: string): Promise<void>;
         pin(conversationId: string): Promise<void>;
         unpin(conversationId: string): Promise<void>;
-        leave(conversationId: string): Promise<void>;
+        leave(conversationId: string, andDelete?: boolean): Promise<void>;
         getMembers(conversationId: string, filter?: "deleted" | "all"): Promise<Participant[]>;
         getUnreadCount(conversationId: string): Promise<ConversationUnreadCount>;
         getUnreadSummary(): Promise<UnreadSummary>;
         uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
+        removeIcon(conversationId: string): Promise<Conversation>;
     };
     readonly storage: {
         requestPresignedUrl(payload: PresignedUrlRequest): Promise<PresignedUrlResponse>;
@@ -1117,6 +1150,7 @@ declare class AntzChatClient {
         getLastSeen(userId: string): Promise<{
             lastSeenAt: string | null;
         }>;
+        updateProfile(payload: UpdateProfilePayload): Promise<User>;
         updatePreferences(prefs: UserPreferences): Promise<User>;
         getPreferences(): Promise<UserPreferences | null>;
     };
@@ -1128,4 +1162,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ReplyAttachmentSnapshot, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, setTransitSession, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };
+export { AntzChatClient, type AntzChatConfig, type AppConfig, type Attachment, type AuthResponse, type AuthTokens, type BatchUploadResult, type CompressedFile, type CompressionAlgorithm, type CompressionConfig, type Conversation, type ConversationListParams, type ConversationUnreadCount, type CreateDirectData, type CreateGroupData, type CursorPaginatedResponse, type FileResponse, type FileSizeLimits, type FileType, type LastReadEntry, type ListMessagesParams, type LoginCredentials, type Message, type MessageAckEvent, type MessageContent, type MessageDeletedEvent, type MessageDeletedForMeEvent, type MessageDeliveredEvent, type MessageReaction, type MessageReplyReference, type MessageUpdatedEvent, type MessagesDeliveredEvent, type MobileDeviceToken, type NewMessageEvent, type OptimisticAttachment, type PaginatedResponse, type Participant, type PersistStorage, type PlatformCompressFn, type PlatformUploadFn, type PresignedUrlRequest, type PresignedUrlResponse, type QuietHours, type ReactionUpdatedEvent, type ReadReceiptEvent, type RegisterData, type RegisterDeviceTokenPayload, type ReplyAttachmentSnapshot, type ResolvedCompressionConfig, type ResolvedConfig, type ResolvedFileSizeLimits, type SearchParams, type SendData, type SendMessageAttachment, type SendMessagePayload, type SocketStatus, type StatusListener, type TokenStore, type TypingIndicatorEvent, type UnreadSummary, type UpdateConversationData, type UpdateProfilePayload, type UploadConfig, type UploadProgress, type UploadableFile, type User, type UserPreferences, type UserStatusEvent, type WebPushDeviceToken, appConfigApi, authApi, connectSocket, conversationsApi, createAuthStore, devicesApi, disconnectSocket, getApiClient, getAuthStore, getCompressionStrategy, getSocket, getSocketStatus, initApiClient, initAuthStore, messagesApi, normalizeConversation, onSocketStatus, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveConfig, setApiClientInstance, setTransitSession, socketEmit, storageApi, tryGetSocket, uploadBatch, useChatStore, usersApi };

package/dist/index.js

@@ -177,45 +177,61 @@ function b64ToBuf(b64) {
 }
 
 // src/crypto/session.ts
-var _session = null;
-var _readyResolve = null;
-var _readyPromise = null;
-var _transitConfigured = null;
+var _KEY = /* @__PURE__ */ Symbol.for("__antz_chat_transit__");
+function getState() {
+  const g = globalThis;
+  if (!g[_KEY]) {
+    g[_KEY] = {
+      session: null,
+      sessionEverEstablished: false,
+      readyResolve: null,
+      readyPromise: null,
+      transitConfigured: null
+    };
+  }
+  return g[_KEY];
+}
 function configureTransit(enabled) {
-  _transitConfigured = enabled;
+  const s = getState();
+  s.transitConfigured = enabled;
   if (!enabled) {
-    _readyResolve?.();
-    _readyResolve = null;
+    s.readyResolve?.();
+    s.readyResolve = null;
   }
 }
 function waitForTransitReady() {
-  if (!_transitConfigured) return Promise.resolve();
-  if (_session) return Promise.resolve();
-  if (!_readyPromise) {
-    _readyPromise = new Promise((resolve) => {
-      _readyResolve = resolve;
+  const s = getState();
+  if (!s.transitConfigured) return Promise.resolve();
+  if (s.session) return Promise.resolve();
+  if (s.sessionEverEstablished) return Promise.resolve();
+  if (!s.readyPromise) {
+    s.readyPromise = new Promise((resolve) => {
+      s.readyResolve = resolve;
     });
   }
-  return _readyPromise;
+  return s.readyPromise;
 }
 function setTransitSession(session) {
-  _session = session;
-  _readyResolve?.();
-  _readyResolve = null;
+  const s = getState();
+  s.session = session;
+  s.sessionEverEstablished = true;
+  s.readyResolve?.();
+  s.readyResolve = null;
 }
 function clearTransitSession() {
-  _session = null;
-  _readyPromise = null;
-  _readyResolve = null;
+  const s = getState();
+  s.session = null;
+  s.readyPromise = null;
+  s.readyResolve = null;
 }
 function isTransitEnabled() {
-  return _session?.enabled === true;
+  return getState().session?.enabled === true;
 }
 function getSessionKey() {
-  return _session?.sessionKey ?? null;
+  return getState().session?.sessionKey ?? null;
 }
 function getSessionId() {
-  return _session?.sessionId ?? null;
+  return getState().session?.sessionId ?? null;
 }
 
 // src/api/client.ts
@@ -575,8 +591,9 @@ var conversationsApi = {
   async unpin(conversationId) {
     await getApiClient().delete(`/conversations/${conversationId}/pin`);
   },
-  async leave(conversationId) {
-    await getApiClient().delete(`/conversations/${conversationId}/leave`);
+  async leave(conversationId, andDelete) {
+    const url = andDelete ? `/conversations/${conversationId}/leave?delete=true` : `/conversations/${conversationId}/leave`;
+    await getApiClient().delete(url);
   },
   async getMembers(conversationId, filter) {
     const { data } = await getApiClient().get(
@@ -616,6 +633,12 @@ var conversationsApi = {
       { fileId }
     );
     return normalizeConversation(data);
+  },
+  async removeIcon(conversationId) {
+    const { data } = await getApiClient().delete(
+      `/conversations/${conversationId}/icon`
+    );
+    return normalizeConversation(data);
   }
 };
 
@@ -744,6 +767,16 @@ var usersApi = {
     const { data } = await getApiClient().get(`/users/${userId}`);
     return { lastSeenAt: data.lastSeenAt ?? null };
   },
+  /**
+   * Update basic profile fields for the current user.
+   * Works in both builtin and non-builtin modes. Use this to push an immediate
+   * profile update to the chat server when the host app knows a change just
+   * happened — without waiting for the next 2-hour sync cycle.
+   */
+  async updateProfile(payload) {
+    const { data } = await getApiClient().put("/users/me", payload);
+    return data;
+  },
   /**
    * Update notification preferences for the current user.
    * Partial update — only send fields you want to change.
@@ -1095,6 +1128,41 @@ function refreshSocketAuth() {
 // src/socket/emitters.ts
 var ACK_TIMEOUT = 5e3;
 var RECONNECT_WAIT_TIMEOUT = 15e3;
+var QUEUE_MAX_SIZE = 100;
+var QUEUE_ENTRY_TTL = 3e4;
+var sendQueues = /* @__PURE__ */ new Map();
+var sendQueueRunning = /* @__PURE__ */ new Map();
+async function drainSendQueue(conversationId) {
+  if (sendQueueRunning.get(conversationId)) return;
+  sendQueueRunning.set(conversationId, true);
+  const queue = sendQueues.get(conversationId);
+  while (queue.length > 0) {
+    const entry = queue.shift();
+    if (Date.now() - entry.enqueuedAt > QUEUE_ENTRY_TTL) {
+      entry.reject(new Error("[AntzChat] Message dropped: queued too long"));
+      continue;
+    }
+    try {
+      entry.resolve(await entry.run());
+    } catch (e) {
+      entry.reject(e);
+    }
+  }
+  sendQueues.delete(conversationId);
+  sendQueueRunning.delete(conversationId);
+}
+function queueSendMessage(payload) {
+  const conversationId = payload.conversationId;
+  if (!sendQueues.has(conversationId)) sendQueues.set(conversationId, []);
+  const queue = sendQueues.get(conversationId);
+  if (queue.length >= QUEUE_MAX_SIZE) {
+    return Promise.reject(new Error("[AntzChat] Send queue full: too many messages in flight"));
+  }
+  return new Promise((resolve, reject) => {
+    queue.push({ run: () => withAck("send_message", payload), resolve, reject, enqueuedAt: Date.now() });
+    drainSendQueue(conversationId);
+  });
+}
 function waitForReconnect() {
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
@@ -1142,7 +1210,7 @@ var socketEmit = {
     fireAndForget("leave_room", { conversationId });
   },
   sendMessage(payload) {
-    return withAck("send_message", payload);
+    return queueSendMessage(payload);
   },
   updateMessage(messageId, text) {
     return withAck("update_message", { messageId, text });