@antzsoft/chat-core 1.2.5 → 1.2.6

package/dist/index.cjs

@@ -99,7 +99,13 @@ var init_chat_store = __esm({
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  AntzChatAuthError: () => AntzChatAuthError,
   AntzChatClient: () => AntzChatClient,
+  AntzChatError: () => AntzChatError,
+  AntzChatNetworkError: () => AntzChatNetworkError,
+  AntzChatPermissionError: () => AntzChatPermissionError,
+  AntzChatServerError: () => AntzChatServerError,
+  AntzChatValidationError: () => AntzChatValidationError,
   appConfigApi: () => appConfigApi,
   authApi: () => authApi,
   connectSocket: () => connectSocket,
@@ -123,6 +129,7 @@ __export(src_exports, {
   initAuthStore: () => initAuthStore,
   isTransitEnvelope: () => isTransitEnvelope,
   messagesApi: () => messagesApi,
+  normalizeAxiosError: () => normalizeAxiosError,
   normalizeConversation: () => normalizeConversation,
   onSocketStatus: () => onSocketStatus,
   performHandshake: () => performHandshake,
@@ -265,7 +272,7 @@ async function compressFile(file, platformCompressFn, config) {
 }
 
 // src/api/client.ts
-var import_axios = __toESM(require("axios"), 1);
+var import_axios2 = __toESM(require("axios"), 1);
 
 // src/crypto/transit.ts
 function hasWebCrypto() {
@@ -561,6 +568,94 @@ function base64ToUint82(b64) {
   return buf;
 }
 
+// src/errors.ts
+var import_axios = require("axios");
+var AntzChatError = class extends Error {
+  constructor(code, message, retryable = false, context) {
+    super(message);
+    this.name = "AntzChatError";
+    this.code = code;
+    this.retryable = retryable;
+    this.context = context;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AntzChatAuthError = class extends AntzChatError {
+  constructor(message, code = "AUTH_FAILED", context) {
+    super(code, message, false, context);
+    this.name = "AntzChatAuthError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AntzChatValidationError = class extends AntzChatError {
+  constructor(message, context) {
+    const msg = Array.isArray(message) ? message.join("; ") : message;
+    super("VALIDATION_ERROR", msg, false, context);
+    this.name = "AntzChatValidationError";
+    this.fields = Array.isArray(message) ? message : void 0;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AntzChatNetworkError = class extends AntzChatError {
+  constructor(message, code = "NETWORK_ERROR", context) {
+    super(code, message, true, context);
+    this.name = "AntzChatNetworkError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AntzChatPermissionError = class extends AntzChatError {
+  constructor(message, context) {
+    super("PERMISSION_DENIED", message, false, context);
+    this.name = "AntzChatPermissionError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+var AntzChatServerError = class extends AntzChatError {
+  constructor(message, httpStatus, context) {
+    super("SERVER_ERROR", message, true, context);
+    this.name = "AntzChatServerError";
+    this.httpStatus = httpStatus;
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+};
+function normalizeAxiosError(error) {
+  if (error instanceof AntzChatError) return error;
+  if ((0, import_axios.isAxiosError)(error)) {
+    const status = error.response?.status;
+    const body = error.response?.data;
+    const decryptionFailed = body != null && isTransitEnvelope(body);
+    const rawMessage = decryptionFailed ? void 0 : body?.message ?? void 0;
+    const message = (Array.isArray(rawMessage) ? rawMessage.join("; ") : rawMessage) || error.message || "Request failed";
+    const ctx = {
+      ...status != null && { httpStatus: status },
+      ...body?.path != null && { path: body.path },
+      ...body?.error != null && { serverError: body.error },
+      ...error.code != null && { axiosCode: error.code },
+      ...decryptionFailed && { decryptionFailed: true, note: "Transit decryption failed \u2014 server error body is an encrypted envelope" }
+    };
+    if (!error.response) {
+      return new AntzChatNetworkError(message || "Network error", "NETWORK_ERROR", ctx);
+    }
+    if (status === 401) {
+      const code = error.config?._retry ? "AUTH_FAILED" : "SESSION_EXPIRED";
+      return new AntzChatAuthError(message, code, ctx);
+    }
+    if (status === 403) return new AntzChatPermissionError(message, ctx);
+    if (status === 400 || status === 422) {
+      return new AntzChatValidationError(
+        Array.isArray(rawMessage) ? rawMessage : message,
+        ctx
+      );
+    }
+    if (status === 404) return new AntzChatServerError(message, 404, ctx);
+    if (status === 429) return new AntzChatNetworkError(message, "RATE_LIMITED", ctx);
+    if (status != null && status >= 500) return new AntzChatServerError(message, status, ctx);
+    return new AntzChatServerError(message, status, ctx);
+  }
+  const msg = error instanceof Error ? error.message : String(error);
+  return new AntzChatError("UNKNOWN_ERROR", msg, false);
+}
+
 // src/api/client.ts
 var _tokenStore = null;
 var _config = null;
@@ -573,7 +668,7 @@ function initApiClient(config, tokenStore) {
   _config = config;
   _tokenStore = tokenStore;
   _avatarSent = false;
-  const client = import_axios.default.create({
+  const client = import_axios2.default.create({
     baseURL: config.apiUrl,
     headers: { "Content-Type": "application/json" }
   });
@@ -658,7 +753,7 @@ function initApiClient(config, tokenStore) {
         const refreshToken = _tokenStore?.getRefreshToken();
         if (!refreshToken) {
           _tokenStore?.clearTokens();
-          return Promise.reject(error);
+          return Promise.reject(normalizeAxiosError(error));
         }
         if (isRefreshing) {
           return new Promise((resolve) => {
@@ -671,7 +766,7 @@ function initApiClient(config, tokenStore) {
         original._retry = true;
         isRefreshing = true;
         try {
-          const { data } = await import_axios.default.post(
+          const { data } = await import_axios2.default.post(
             `${_config.apiUrl}/auth/refresh`,
             { refreshToken }
           );
@@ -683,12 +778,12 @@ function initApiClient(config, tokenStore) {
           return client(original);
         } catch {
           _tokenStore?.clearTokens();
-          return Promise.reject(error);
+          return Promise.reject(normalizeAxiosError(error));
         } finally {
           isRefreshing = false;
         }
       }
-      return Promise.reject(error);
+      return Promise.reject(normalizeAxiosError(error));
     }
   );
   return client;
@@ -1116,6 +1211,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`);
   }
 };
 
@@ -1483,8 +1581,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";
@@ -1497,12 +1598,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 = (0, import_socket.io)(`${config.socketOrigin}/chat`, {
@@ -1646,7 +1750,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);
@@ -1659,7 +1763,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() });
@@ -1670,7 +1774,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") {
@@ -1680,7 +1784,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"));
       }
     });
   });
@@ -1691,14 +1795,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);
   });
 }
@@ -1726,6 +1830,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 });
   },
@@ -1761,7 +1868,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);
     });
   },
@@ -1824,7 +1931,13 @@ var AntzChatClient = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  AntzChatAuthError,
   AntzChatClient,
+  AntzChatError,
+  AntzChatNetworkError,
+  AntzChatPermissionError,
+  AntzChatServerError,
+  AntzChatValidationError,
   appConfigApi,
   authApi,
   connectSocket,
@@ -1848,6 +1961,7 @@ var AntzChatClient = class {
   initAuthStore,
   isTransitEnvelope,
   messagesApi,
+  normalizeAxiosError,
   normalizeConversation,
   onSocketStatus,
   performHandshake,