@antzsoft/chat-core 1.1.1 → 1.1.3

package/dist/index.cjs

@@ -116,6 +116,7 @@ __export(src_exports, {
   resetAuthStore: () => resetAuthStore,
   resolveConfig: () => resolveConfig,
   setApiClientInstance: () => setApiClientInstance,
+  setTransitSession: () => setTransitSession,
   socketEmit: () => socketEmit,
   storageApi: () => storageApi,
   tryGetSocket: () => tryGetSocket,
@@ -161,7 +162,7 @@ function resolveConfig(config) {
     userId: config.userId,
     tenantId: config.tenantId,
     avatar: config.avatar,
-    encryptionMode: config.encryptionMode ?? "none",
+    transitEncryption: config.transitEncryption ?? true,
     upload: {
       maxFileSizeMB: limits,
       maxFilesPerMessage: config.upload?.maxFilesPerMessage ?? 10,
@@ -248,6 +249,116 @@ async function compressFile(file, platformCompressFn, config) {
 
 // src/api/client.ts
 var import_axios = __toESM(require("axios"), 1);
+
+// src/crypto/transit.ts
+async function encryptPayload(data, sessionKey) {
+  const iv = globalThis.crypto.getRandomValues(new Uint8Array(12));
+  const plaintext = new TextEncoder().encode(JSON.stringify(data));
+  const encrypted = await globalThis.crypto.subtle.encrypt(
+    { name: "AES-GCM", iv },
+    sessionKey,
+    plaintext
+  );
+  const ct = encrypted.slice(0, encrypted.byteLength - 16);
+  const tag = encrypted.slice(encrypted.byteLength - 16);
+  return {
+    v: 1,
+    iv: bufToB64(iv),
+    tag: bufToB64(tag),
+    ct: bufToB64(ct)
+  };
+}
+async function decryptPayload(envelope, sessionKey) {
+  const iv = b64ToBuf(envelope.iv);
+  const tag = b64ToBuf(envelope.tag);
+  const ct = b64ToBuf(envelope.ct);
+  const combined = new Uint8Array(ct.byteLength + tag.byteLength);
+  combined.set(new Uint8Array(ct), 0);
+  combined.set(new Uint8Array(tag), ct.byteLength);
+  const decrypted = await globalThis.crypto.subtle.decrypt(
+    { name: "AES-GCM", iv: new Uint8Array(iv) },
+    sessionKey,
+    combined
+  );
+  return JSON.parse(new TextDecoder().decode(decrypted));
+}
+function isTransitEnvelope(v) {
+  return typeof v === "object" && v !== null && v.v === 1 && typeof v.iv === "string" && typeof v.tag === "string" && typeof v.ct === "string";
+}
+function bufToB64(buf) {
+  const bytes = buf instanceof Uint8Array ? buf : new Uint8Array(buf);
+  let str = "";
+  bytes.forEach((b) => {
+    str += String.fromCharCode(b);
+  });
+  return btoa(str);
+}
+function b64ToBuf(b64) {
+  const bin = atob(b64);
+  const buf = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) buf[i] = bin.charCodeAt(i);
+  return buf.buffer;
+}
+
+// src/crypto/session.ts
+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) {
+  const s = getState();
+  s.transitConfigured = enabled;
+  if (!enabled) {
+    s.readyResolve?.();
+    s.readyResolve = null;
+  }
+}
+function waitForTransitReady() {
+  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 s.readyPromise;
+}
+function setTransitSession(session) {
+  const s = getState();
+  s.session = session;
+  s.sessionEverEstablished = true;
+  s.readyResolve?.();
+  s.readyResolve = null;
+}
+function clearTransitSession() {
+  const s = getState();
+  s.session = null;
+  s.readyPromise = null;
+  s.readyResolve = null;
+}
+function isTransitEnabled() {
+  return getState().session?.enabled === true;
+}
+function getSessionKey() {
+  return getState().session?.sessionKey ?? null;
+}
+function getSessionId() {
+  return getState().session?.sessionId ?? null;
+}
+
+// src/api/client.ts
 var _tokenStore = null;
 var _config = null;
 var _avatarSent = false;
@@ -259,7 +370,8 @@ function initApiClient(config, tokenStore) {
     baseURL: config.apiUrl,
     headers: { "Content-Type": "application/json" }
   });
-  client.interceptors.request.use((req) => {
+  configureTransit(config.transitEncryption);
+  client.interceptors.request.use(async (req) => {
     const token = _tokenStore?.getAccessToken();
     if (token) req.headers["Authorization"] = `Bearer ${token}`;
     if (_config?.userId) req.headers["x-user-id"] = _config.userId;
@@ -269,18 +381,54 @@ function initApiClient(config, tokenStore) {
       else if (_config.avatar.url) req.headers["x-avatar-url"] = _config.avatar.url;
       _avatarSent = true;
     }
+    await waitForTransitReady();
+    if (isTransitEnabled()) {
+      const sessionId = getSessionId();
+      const key = getSessionKey();
+      if (sessionId && key) {
+        req.headers["x-transit-session"] = sessionId;
+        if (req.data !== void 0 && req.data !== null) {
+          const envelope = await encryptPayload(req.data, key);
+          req.data = envelope;
+          req.headers["x-transit-encrypted"] = "1";
+        }
+      }
+    }
     return req;
   });
   let isRefreshing = false;
   let refreshQueue = [];
   client.interceptors.response.use(
-    (response) => {
+    async (response) => {
+      if (isTransitEnabled()) {
+        const key = getSessionKey();
+        if (key) {
+          if (isTransitEnvelope(response.data)) {
+            response.data = await decryptPayload(response.data, key);
+          } else if (response.data?.data && isTransitEnvelope(response.data.data)) {
+            response.data.data = await decryptPayload(response.data.data, key);
+          }
+        }
+      }
       if (response.data && typeof response.data === "object" && "success" in response.data && "data" in response.data) {
         response.data = response.data.data;
       }
       return response;
     },
     async (error) => {
+      if (isTransitEnabled() && error.response?.data) {
+        const key = getSessionKey();
+        if (key) {
+          try {
+            if (isTransitEnvelope(error.response.data)) {
+              error.response.data = await decryptPayload(error.response.data, key);
+            } else if (error.response.data?.data && isTransitEnvelope(error.response.data.data)) {
+              error.response.data.data = await decryptPayload(error.response.data.data, key);
+            }
+          } catch {
+          }
+        }
+      }
       const original = error.config;
       if (error.response?.status === 401 && !original._retry) {
         const refreshToken = _tokenStore?.getRefreshToken();
@@ -567,8 +715,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(
@@ -608,6 +757,12 @@ var conversationsApi = {
       { fileId }
     );
     return normalizeConversation(data);
+  },
+  async removeIcon(conversationId) {
+    const { data } = await getApiClient().delete(
+      `/conversations/${conversationId}/icon`
+    );
+    return normalizeConversation(data);
   }
 };
 
@@ -658,7 +813,14 @@ async function uploadBatch(files, platformUploadFn, conversationId, onProgress,
     filename: f.name,
     mimeType: f.type,
     size: f.size,
-    conversationId
+    conversationId,
+    ...f.compressed && {
+      metadata: {
+        compressed: f.compressed,
+        originalSize: f.originalSize,
+        compressionAlgorithm: f.compressionAlgorithm
+      }
+    }
   }));
   const { urls, errors: requestErrors } = await storageApi.requestPresignedUrlBatch(requests);
   const progressMap = {};
@@ -729,6 +891,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.
@@ -755,6 +927,95 @@ var usersApi = {
 
 // src/socket/socket.ts
 var import_socket = require("socket.io-client");
+
+// src/crypto/detect.ts
+var _cached = null;
+async function detectTransitAlgo() {
+  if (_cached) return _cached;
+  try {
+    await globalThis.crypto.subtle.generateKey(
+      { name: "X25519" },
+      false,
+      ["deriveKey"]
+    );
+    _cached = "x25519";
+  } catch {
+    _cached = "p256";
+  }
+  return _cached;
+}
+function resetAlgoCache() {
+  _cached = null;
+}
+
+// src/crypto/handshake.ts
+async function fetchServerKeys(apiUrl) {
+  const res = await fetch(`${apiUrl}/crypto/pubkey`);
+  if (!res.ok) throw new Error(`[AntzChat] Failed to fetch server public key: ${res.status}`);
+  const body = await res.json();
+  return body?.data ?? body;
+}
+async function performHandshake(algo, serverKeys, socketHandshakeAuth) {
+  const ephemeral = await globalThis.crypto.subtle.generateKey(
+    algo === "x25519" ? { name: "X25519" } : { name: "ECDH", namedCurve: "P-256" },
+    false,
+    ["deriveBits"]
+  );
+  const pubRaw = await globalThis.crypto.subtle.exportKey("raw", ephemeral.publicKey);
+  socketHandshakeAuth["transitEphemeralPub"] = bufToB642(pubRaw);
+  socketHandshakeAuth["transitAlgo"] = algo;
+  const ephemeralPriv = ephemeral.privateKey;
+  return (sessionId) => deriveSessionKey(ephemeralPriv, algo, serverKeys, sessionId);
+}
+async function deriveSessionKey(ephemeralPriv, algo, serverKeys, sessionId) {
+  const serverPubB64 = algo === "x25519" ? serverKeys.x25519 : serverKeys.p256;
+  const serverPubRaw = b64ToBuf2(serverPubB64);
+  const keyAlgoParams = algo === "x25519" ? { name: "X25519" } : { name: "ECDH", namedCurve: "P-256" };
+  const serverPubKey = await globalThis.crypto.subtle.importKey(
+    "raw",
+    serverPubRaw,
+    keyAlgoParams,
+    false,
+    []
+  );
+  const sharedBits = await globalThis.crypto.subtle.deriveBits(
+    { name: algo === "x25519" ? "X25519" : "ECDH", public: serverPubKey },
+    ephemeralPriv,
+    256
+  );
+  const hkdfKey = await globalThis.crypto.subtle.importKey(
+    "raw",
+    sharedBits,
+    "HKDF",
+    false,
+    ["deriveKey"]
+  );
+  const salt = new TextEncoder().encode(sessionId);
+  const info = new TextEncoder().encode("antz-transit-v1");
+  return globalThis.crypto.subtle.deriveKey(
+    { name: "HKDF", hash: "SHA-256", salt, info },
+    hkdfKey,
+    { name: "AES-GCM", length: 256 },
+    false,
+    ["encrypt", "decrypt"]
+  );
+}
+function bufToB642(buf) {
+  const bytes = new Uint8Array(buf);
+  let str = "";
+  bytes.forEach((b) => {
+    str += String.fromCharCode(b);
+  });
+  return btoa(str);
+}
+function b64ToBuf2(b64) {
+  const bin = atob(b64);
+  const buf = new Uint8Array(bin.length);
+  for (let i = 0; i < bin.length; i++) buf[i] = bin.charCodeAt(i);
+  return buf.buffer;
+}
+
+// src/socket/socket.ts
 var _socket = null;
 var _status = "disconnected";
 var _statusListeners = /* @__PURE__ */ new Set();
@@ -779,23 +1040,96 @@ function onSocketStatus(listener) {
   _statusListeners.add(listener);
   return () => _statusListeners.delete(listener);
 }
+async function secureEmit(socket, event, payload, ack) {
+  if (isTransitEnabled()) {
+    const key = getSessionKey();
+    if (key) {
+      const envelope = await encryptPayload(payload, key);
+      if (ack) {
+        socket.emit(event, envelope, async (encryptedResponse) => {
+          if (isTransitEnvelope(encryptedResponse)) {
+            try {
+              const decrypted = await decryptPayload(encryptedResponse, key);
+              ack(decrypted);
+            } catch {
+              ack(encryptedResponse);
+            }
+          } else {
+            ack(encryptedResponse);
+          }
+        });
+      } else {
+        socket.emit(event, envelope);
+      }
+      return;
+    }
+  }
+  if (ack) {
+    socket.emit(event, payload, ack);
+  } else {
+    socket.emit(event, payload);
+  }
+}
+function secureOn(socket, event, handler) {
+  socket.on(event, async (raw) => {
+    if (isTransitEnabled() && isTransitEnvelope(raw)) {
+      const key = getSessionKey();
+      if (key) {
+        try {
+          const data = await decryptPayload(raw, key);
+          handler(data);
+          return;
+        } catch {
+          console.error(`[AntzChat] Transit decryption failed for event: ${event}`);
+          return;
+        }
+      }
+    }
+    handler(raw);
+  });
+}
 async function connectSocket(config, getToken) {
   if (_socket && !_socket.disconnected) return _socket;
   _getToken = getToken;
   _userId = config.userId;
   _tenantId = config.tenantId;
   const token = getToken();
+  const socketHandshakeAuth = {
+    token: token ? `Bearer ${token}` : "",
+    ...config.userId && { userId: config.userId },
+    ...config.tenantId && { tenantId: config.tenantId },
+    ...config.avatar?.url && { avatarUrl: config.avatar.url },
+    ...config.avatar?.base64 && { avatarBase64: config.avatar.base64 }
+  };
+  let boundDeriveSessionKey = null;
+  if (config.transitEncryption) {
+    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."
+        );
+      }
+      const algo = await detectTransitAlgo();
+      boundDeriveSessionKey = await performHandshake(algo, serverKeys, socketHandshakeAuth);
+    } catch (err) {
+      if (err.message?.startsWith("[AntzChat] Transit encryption mismatch")) throw err;
+      console.warn("[AntzChat] Transit handshake setup failed, connecting without transit encryption:", err.message);
+    }
+  } else {
+    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."
+        );
+      }
+    } catch (err) {
+      if (err.message?.startsWith("[AntzChat] Transit encryption mismatch")) throw err;
+    }
+  }
   _socket = (0, import_socket.io)(`${config.socketOrigin}/chat`, {
-    auth: {
-      token: token ? `Bearer ${token}` : "",
-      ...config.userId && { userId: config.userId },
-      ...config.tenantId && { tenantId: config.tenantId },
-      ...config.avatar?.url && { avatarUrl: config.avatar.url },
-      ...config.avatar?.base64 && { avatarBase64: config.avatar.base64 }
-    },
-    // path must match SOCKET_IO_PATH on the server (default '/socket.io').
-    // Set socketPath in SDK config when the server is behind a reverse proxy
-    // that adds a path prefix (e.g. '/chat-api/socket.io' for UAT).
+    auth: socketHandshakeAuth,
     path: config.socketPath,
     transports: ["websocket", "polling"],
     reconnection: true,
@@ -806,32 +1140,80 @@ async function connectSocket(config, getToken) {
   });
   setStatus("connecting");
   _socket.on("connect", () => setStatus("connected"));
-  _socket.on("disconnect", () => setStatus("disconnected"));
+  _socket.on("disconnect", () => {
+    setStatus("disconnected");
+    clearTransitSession();
+  });
   _socket.on("connect_error", (err) => {
     console.error("[AntzChat] Socket connect_error:", err?.message, err?.data);
     setStatus("error");
   });
   _socket.on("reconnecting", () => setStatus("reconnecting"));
   _socket.on("reconnect", () => setStatus("connected"));
-  _socket.on("read_receipt", (event) => {
+  if (config.transitEncryption && boundDeriveSessionKey) {
+    await new Promise((resolve) => {
+      const done = () => {
+        clearTimeout(timeout);
+        resolve();
+      };
+      const timeout = setTimeout(() => {
+        console.warn("[AntzChat] transit_session timeout \u2014 unblocking HTTP without transit encryption");
+        configureTransit(false);
+        done();
+      }, 5e3);
+      _socket.on("transit_session", async ({ sessionId }) => {
+        try {
+          if (boundDeriveSessionKey) {
+            const sessionKey = await boundDeriveSessionKey(sessionId);
+            const algo = socketHandshakeAuth["transitAlgo"] ?? "p256";
+            setTransitSession({ sessionKey, algo, sessionId, enabled: true });
+          }
+        } catch (err) {
+          console.error("[AntzChat] Failed to derive transit session key:", err.message);
+        }
+        done();
+      });
+      _socket.on("connect_error", () => done());
+    });
+  }
+  secureOn(_socket, "read_receipt", (event) => {
     Promise.resolve().then(() => (init_chat_store(), chat_store_exports)).then(({ useChatStore: useChatStore2 }) => {
-      useChatStore2.getState().setLastRead(event.conversationId, event.messageId, event.readAt);
+      const e = event;
+      useChatStore2.getState().setLastRead(e.conversationId, e.messageId, e.readAt);
     });
   });
-  _socket.on("user_online", (event) => {
+  secureOn(_socket, "user_online", (event) => {
     Promise.resolve().then(() => (init_chat_store(), chat_store_exports)).then(({ useChatStore: useChatStore2 }) => {
-      const store = useChatStore2.getState();
-      store.setUserOnline(event.userId);
+      useChatStore2.getState().setUserOnline(event.userId);
     });
   });
-  _socket.on("user_offline", (event) => {
+  secureOn(_socket, "user_offline", (event) => {
     Promise.resolve().then(() => (init_chat_store(), chat_store_exports)).then(({ useChatStore: useChatStore2 }) => {
+      const e = event;
       const store = useChatStore2.getState();
-      store.setUserOffline(event.userId);
-      if (event.lastSeenAt) store.setLastSeen(event.userId, event.lastSeenAt);
+      store.setUserOffline(e.userId);
+      if (e.lastSeenAt) store.setLastSeen(e.userId, e.lastSeenAt);
     });
   });
-  return _socket;
+  return createSecureSocketProxy(_socket);
+}
+function createSecureSocketProxy(socket) {
+  return new Proxy(socket, {
+    get(target, prop) {
+      if (prop === "on") {
+        return (event, handler) => {
+          const internal = ["connect", "disconnect", "connect_error", "reconnect", "reconnecting", "error"];
+          if (internal.includes(event)) {
+            return target.on(event, handler);
+          }
+          secureOn(target, event, handler);
+          return socket;
+        };
+      }
+      const val = target[prop];
+      return typeof val === "function" ? val.bind(target) : val;
+    }
+  });
 }
 function disconnectSocket() {
   if (_socket) {
@@ -839,6 +1221,8 @@ function disconnectSocket() {
     _socket = null;
     setStatus("disconnected");
   }
+  clearTransitSession();
+  resetAlgoCache();
   _getToken = null;
   _userId = void 0;
   _tenantId = void 0;
@@ -868,6 +1252,36 @@ 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 sendQueue = [];
+var sendQueueRunning = false;
+async function drainSendQueue() {
+  if (sendQueueRunning) return;
+  sendQueueRunning = true;
+  while (sendQueue.length > 0) {
+    const entry = sendQueue.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);
+    }
+  }
+  sendQueueRunning = false;
+}
+function queueSendMessage(payload) {
+  if (sendQueue.length >= QUEUE_MAX_SIZE) {
+    return Promise.reject(new Error("[AntzChat] Send queue full: too many messages in flight"));
+  }
+  return new Promise((resolve, reject) => {
+    sendQueue.push({ run: () => withAck("send_message", payload), resolve, reject, enqueuedAt: Date.now() });
+    drainSendQueue();
+  });
+}
 function waitForReconnect() {
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => {
@@ -896,7 +1310,7 @@ async function withAck(event, payload) {
   if (!socket) return Promise.reject(new Error(`[AntzChat] Socket not connected (event: ${event})`));
   return new Promise((resolve, reject) => {
     const timer = setTimeout(() => reject(new Error(`Socket ack timeout: ${event}`)), ACK_TIMEOUT);
-    socket.emit(event, payload, (response) => {
+    secureEmit(socket, event, payload, (response) => {
       clearTimeout(timer);
       resolve(response);
     });
@@ -905,7 +1319,7 @@ async function withAck(event, payload) {
 function fireAndForget(event, payload) {
   const socket = tryGetSocket();
   if (!socket) return;
-  socket.emit(event, payload);
+  secureEmit(socket, event, payload);
 }
 var socketEmit = {
   joinRoom(conversationId) {
@@ -915,7 +1329,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 });
@@ -950,7 +1364,7 @@ var socketEmit = {
     if (!socket) return Promise.resolve([]);
     return new Promise((resolve, reject) => {
       const timer = setTimeout(() => reject(new Error("get_online_users timeout")), ACK_TIMEOUT);
-      socket.emit("get_online_users", { userIds }, (response) => {
+      secureEmit(socket, "get_online_users", { userIds }, (response) => {
         clearTimeout(timer);
         if (response && typeof response === "object" && "onlineStatus" in response) {
           const status = response.onlineStatus;
@@ -1132,6 +1546,7 @@ var AntzChatClient = class {
   resetAuthStore,
   resolveConfig,
   setApiClientInstance,
+  setTransitSession,
   socketEmit,
   storageApi,
   tryGetSocket,