@antzsoft/chat-core 1.2.5 → 1.2.6

package/dist/index.d.cts

@@ -123,6 +123,7 @@ declare const conversationsApi: {
      */
     uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
     removeIcon(conversationId: string): Promise<Conversation>;
+    clearChat(conversationId: string): Promise<void>;
 };
 
 /** Shared fields for every device registration. */
@@ -267,6 +268,7 @@ declare const socketEmit: {
     updateMessage(messageId: string, text: string): Promise<unknown>;
     deleteMessage(messageId: string): Promise<unknown>;
     deleteMessageForMe(messageId: string): Promise<unknown>;
+    clearChat(conversationId: string): Promise<unknown>;
     addReaction(messageId: string, emoji: string): Promise<unknown>;
     removeReaction(messageId: string, emoji: string): Promise<unknown>;
     pinMessage(messageId: string): Promise<unknown>;
@@ -453,6 +455,45 @@ interface ChatState {
 }
 declare const useChatStore: zustand.UseBoundStore<zustand.StoreApi<ChatState>>;
 
+declare class AntzChatError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly context?: Record<string, unknown>;
+    constructor(code: string, message: string, retryable?: boolean, context?: Record<string, unknown>);
+}
+/** Thrown on 401 (after refresh also fails) or when no refresh token exists. */
+declare class AntzChatAuthError extends AntzChatError {
+    constructor(message: string, code?: string, context?: Record<string, unknown>);
+}
+/** Thrown on 400 / 422 — bad input, validation failure. */
+declare class AntzChatValidationError extends AntzChatError {
+    /** Server-returned field error array (when the server sends message as string[]). */
+    readonly fields?: string[];
+    constructor(message: string | string[], context?: Record<string, unknown>);
+}
+/** Thrown on network failures, timeouts, socket disconnections, and queue overflow. retryable = true. */
+declare class AntzChatNetworkError extends AntzChatError {
+    constructor(message: string, code?: string, context?: Record<string, unknown>);
+}
+/** Thrown on 403 — insufficient permissions. */
+declare class AntzChatPermissionError extends AntzChatError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Thrown on 5xx or other unexpected server errors. retryable = true. */
+declare class AntzChatServerError extends AntzChatError {
+    readonly httpStatus?: number;
+    constructor(message: string, httpStatus?: number, context?: Record<string, unknown>);
+}
+/**
+ * Converts a raw axios error (or any unknown throw) into a typed AntzChatError.
+ *
+ * Call site: client.ts response interceptor — runs AFTER transit decryption,
+ * so error.response.data is always plaintext by the time this function sees it.
+ * If decryption itself failed, error.response.data remains the raw encrypted
+ * envelope — detected via isTransitEnvelope() and noted in context.
+ */
+declare function normalizeAxiosError(error: unknown): AntzChatError;
+
 /**
  * Resolves viewer-aware display text for system messages.
  *
@@ -544,6 +585,7 @@ declare class AntzChatClient {
         getUnreadSummary(): Promise<UnreadSummary>;
         uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
         removeIcon(conversationId: string): Promise<Conversation>;
+        clearChat(conversationId: string): Promise<void>;
     };
     readonly storage: {
         requestPresignedUrl(payload: PresignedUrlRequest): Promise<PresignedUrlResponse>;
@@ -595,4 +637,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatClient, AntzChatConfig, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, Message, 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, normalizeConversation, onSocketStatus, performHandshake, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveSystemMessageText, setApiClientInstance, setTransitSession, socketEmit, tryGetSocket, useChatStore, usersApi };
+export { AntzChatAuthError, AntzChatClient, AntzChatConfig, AntzChatError, AntzChatNetworkError, AntzChatPermissionError, AntzChatServerError, AntzChatValidationError, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, Message, 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, tryGetSocket, useChatStore, usersApi };

package/dist/index.d.ts

@@ -123,6 +123,7 @@ declare const conversationsApi: {
      */
     uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
     removeIcon(conversationId: string): Promise<Conversation>;
+    clearChat(conversationId: string): Promise<void>;
 };
 
 /** Shared fields for every device registration. */
@@ -267,6 +268,7 @@ declare const socketEmit: {
     updateMessage(messageId: string, text: string): Promise<unknown>;
     deleteMessage(messageId: string): Promise<unknown>;
     deleteMessageForMe(messageId: string): Promise<unknown>;
+    clearChat(conversationId: string): Promise<unknown>;
     addReaction(messageId: string, emoji: string): Promise<unknown>;
     removeReaction(messageId: string, emoji: string): Promise<unknown>;
     pinMessage(messageId: string): Promise<unknown>;
@@ -453,6 +455,45 @@ interface ChatState {
 }
 declare const useChatStore: zustand.UseBoundStore<zustand.StoreApi<ChatState>>;
 
+declare class AntzChatError extends Error {
+    readonly code: string;
+    readonly retryable: boolean;
+    readonly context?: Record<string, unknown>;
+    constructor(code: string, message: string, retryable?: boolean, context?: Record<string, unknown>);
+}
+/** Thrown on 401 (after refresh also fails) or when no refresh token exists. */
+declare class AntzChatAuthError extends AntzChatError {
+    constructor(message: string, code?: string, context?: Record<string, unknown>);
+}
+/** Thrown on 400 / 422 — bad input, validation failure. */
+declare class AntzChatValidationError extends AntzChatError {
+    /** Server-returned field error array (when the server sends message as string[]). */
+    readonly fields?: string[];
+    constructor(message: string | string[], context?: Record<string, unknown>);
+}
+/** Thrown on network failures, timeouts, socket disconnections, and queue overflow. retryable = true. */
+declare class AntzChatNetworkError extends AntzChatError {
+    constructor(message: string, code?: string, context?: Record<string, unknown>);
+}
+/** Thrown on 403 — insufficient permissions. */
+declare class AntzChatPermissionError extends AntzChatError {
+    constructor(message: string, context?: Record<string, unknown>);
+}
+/** Thrown on 5xx or other unexpected server errors. retryable = true. */
+declare class AntzChatServerError extends AntzChatError {
+    readonly httpStatus?: number;
+    constructor(message: string, httpStatus?: number, context?: Record<string, unknown>);
+}
+/**
+ * Converts a raw axios error (or any unknown throw) into a typed AntzChatError.
+ *
+ * Call site: client.ts response interceptor — runs AFTER transit decryption,
+ * so error.response.data is always plaintext by the time this function sees it.
+ * If decryption itself failed, error.response.data remains the raw encrypted
+ * envelope — detected via isTransitEnvelope() and noted in context.
+ */
+declare function normalizeAxiosError(error: unknown): AntzChatError;
+
 /**
  * Resolves viewer-aware display text for system messages.
  *
@@ -544,6 +585,7 @@ declare class AntzChatClient {
         getUnreadSummary(): Promise<UnreadSummary>;
         uploadIcon(conversationId: string, fileId: string): Promise<Conversation>;
         removeIcon(conversationId: string): Promise<Conversation>;
+        clearChat(conversationId: string): Promise<void>;
     };
     readonly storage: {
         requestPresignedUrl(payload: PresignedUrlRequest): Promise<PresignedUrlResponse>;
@@ -595,4 +637,4 @@ declare class AntzChatClient {
     uploadIcon(conversationId: string, file: UploadableFile): Promise<Conversation>;
 }
 
-export { AntzChatClient, AntzChatConfig, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, Message, 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, normalizeConversation, onSocketStatus, performHandshake, reconnectSocket, refreshSocketAuth, resetAuthStore, resolveSystemMessageText, setApiClientInstance, setTransitSession, socketEmit, tryGetSocket, useChatStore, usersApi };
+export { AntzChatAuthError, AntzChatClient, AntzChatConfig, AntzChatError, AntzChatNetworkError, AntzChatPermissionError, AntzChatServerError, AntzChatValidationError, AppConfig, AuthResponse, AuthTokens, BatchUploadResult, CompletedPart, Conversation, ConversationListParams, ConversationUnreadCount, type CreateDirectData, type CreateGroupData, CursorPaginatedResponse, FileResponse, FileType, type LastReadEntry, type ListMessagesParams, LoginCredentials, Message, 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, tryGetSocket, useChatStore, usersApi };

package/dist/index.js

@@ -1,4 +1,10 @@
 import {
+  AntzChatAuthError,
+  AntzChatError,
+  AntzChatNetworkError,
+  AntzChatPermissionError,
+  AntzChatServerError,
+  AntzChatValidationError,
   clearTransitSession,
   configureTransit,
   createRestTransitSession,
@@ -16,13 +22,14 @@ import {
   initApiClient,
   isTransitEnabled,
   isTransitEnvelope,
+  normalizeAxiosError,
   performHandshake,
   resetAlgoCache,
   setApiClientInstance,
   setTransitSession,
   storageApi,
   uploadBatch
-} from "./chunk-ZNA6B2R5.js";
+} from "./chunk-XTQYF5HU.js";
 import {
   useChatStore
 } from "./chunk-EOL5B7GS.js";
@@ -501,6 +508,9 @@ var conversationsApi = {
   async removeIcon(conversationId) {
     const { data } = await getApiClient().post(`/conversations/${conversationId}/icon/remove`);
     return normalizeConversation(data);
+  },
+  async clearChat(conversationId) {
+    await getApiClient().post(`/conversations/${conversationId}/clear-for-me`);
   }
 };
 
@@ -694,8 +704,11 @@ async function _doConnect(config, getToken) {
       try {
         const serverKeys = await fetchServerKeys(config.apiUrl);
         if (!serverKeys.enabled) {
-          throw new Error(
-            "[AntzChat] Transit encryption mismatch: SDK has transitEncryption=true but server has TRANSIT_ENCRYPTION_ENABLED=false. Align the config on both sides."
+          throw new AntzChatError(
+            "TRANSIT_MISMATCH",
+            "[AntzChat] Transit encryption mismatch: SDK has transitEncryption=true but server has TRANSIT_ENCRYPTION_ENABLED=false. Align the config on both sides.",
+            false,
+            { sdkEnabled: true, serverEnabled: false }
           );
         }
         const algo = globalThis.crypto?.subtle ? await detectTransitAlgo() : "x25519";
@@ -708,12 +721,15 @@ async function _doConnect(config, getToken) {
     try {
       const serverKeys = await fetchServerKeys(config.apiUrl);
       if (serverKeys.enabled) {
-        throw new Error(
-          "[AntzChat] Transit encryption mismatch: SDK has transitEncryption=false but server has TRANSIT_ENCRYPTION_ENABLED=true. Align the config on both sides."
+        throw new AntzChatError(
+          "TRANSIT_MISMATCH",
+          "[AntzChat] Transit encryption mismatch: SDK has transitEncryption=false but server has TRANSIT_ENCRYPTION_ENABLED=true. Align the config on both sides.",
+          false,
+          { sdkEnabled: false, serverEnabled: true }
         );
       }
     } catch (err) {
-      if (err.message?.startsWith("[AntzChat] Transit encryption mismatch")) throw err;
+      if (err?.code === "TRANSIT_MISMATCH") throw err;
     }
   }
   _socket = io(`${config.socketOrigin}/chat`, {
@@ -857,7 +873,7 @@ async function drainSendQueue(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"));
+      entry.reject(new AntzChatNetworkError("Message dropped: queued too long", "MESSAGE_DROPPED"));
       continue;
     }
     entry.run().then(entry.resolve).catch(entry.reject);
@@ -870,7 +886,7 @@ function queueSendMessage(payload) {
   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 Promise.reject(new AntzChatNetworkError("Send queue full: too many messages in flight", "SEND_QUEUE_FULL", { conversationId }));
   }
   return new Promise((resolve, reject) => {
     queue.push({ run: () => withAck("send_message", payload), resolve, reject, enqueuedAt: Date.now() });
@@ -881,7 +897,7 @@ function waitForReconnect() {
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
       unsubscribe();
-      reject(new Error("[AntzChat] Socket reconnect timeout"));
+      reject(new AntzChatNetworkError("Socket reconnect timeout", "SOCKET_TIMEOUT"));
     }, RECONNECT_WAIT_TIMEOUT);
     const unsubscribe = onSocketStatus((status) => {
       if (status === "connected") {
@@ -891,7 +907,7 @@ function waitForReconnect() {
       } else if (status === "error") {
         clearTimeout(timer);
         unsubscribe();
-        reject(new Error("[AntzChat] Socket reconnect failed"));
+        reject(new AntzChatNetworkError("Socket reconnect failed", "SOCKET_NOT_CONNECTED"));
       }
     });
   });
@@ -902,14 +918,14 @@ async function withAck(event, payload) {
     await waitForReconnect();
     socket = tryGetSocket();
   }
-  if (!socket) return Promise.reject(new Error(`[AntzChat] Socket not connected (event: ${event})`));
+  if (!socket) return Promise.reject(new AntzChatNetworkError(`Socket not connected (event: ${event})`, "SOCKET_NOT_CONNECTED", { event }));
   return new Promise((resolve, reject) => {
     let timer;
     secureEmit(socket, event, payload, (response) => {
       clearTimeout(timer);
       resolve(response);
     }).then(() => {
-      timer = setTimeout(() => reject(new Error(`Socket ack timeout: ${event}`)), ACK_TIMEOUT);
+      timer = setTimeout(() => reject(new AntzChatNetworkError(`Socket ack timeout: ${event}`, "SOCKET_TIMEOUT", { event })), ACK_TIMEOUT);
     }).catch(reject);
   });
 }
@@ -937,6 +953,9 @@ var socketEmit = {
   deleteMessageForMe(messageId) {
     return withAck("delete_message_for_me", { messageId });
   },
+  clearChat(conversationId) {
+    return withAck("clear_chat_for_me", { conversationId });
+  },
   addReaction(messageId, emoji) {
     return withAck("add_reaction", { messageId, emoji });
   },
@@ -972,7 +991,7 @@ var socketEmit = {
           resolve([]);
         }
       }).then(() => {
-        timer = setTimeout(() => reject(new Error("get_online_users timeout")), ACK_TIMEOUT);
+        timer = setTimeout(() => reject(new AntzChatNetworkError("Socket ack timeout: get_online_users", "SOCKET_TIMEOUT", { event: "get_online_users" })), ACK_TIMEOUT);
       }).catch(reject);
     });
   },
@@ -1031,7 +1050,13 @@ var AntzChatClient = class {
   }
 };
 export {
+  AntzChatAuthError,
   AntzChatClient,
+  AntzChatError,
+  AntzChatNetworkError,
+  AntzChatPermissionError,
+  AntzChatServerError,
+  AntzChatValidationError,
   appConfigApi,
   authApi,
   connectSocket,
@@ -1055,6 +1080,7 @@ export {
   initAuthStore,
   isTransitEnvelope,
   messagesApi,
+  normalizeAxiosError,
   normalizeConversation,
   onSocketStatus,
   performHandshake,