@antzsoft/chat-core 1.0.0 → 1.0.3

package/dist/chat.store-PY3YVYGN.js

@@ -0,0 +1,7 @@
+import {
+  useChatStore
+} from "./chunk-TB52RCSF.js";
+export {
+  useChatStore
+};
+//# sourceMappingURL=chat.store-PY3YVYGN.js.map

package/dist/chat.store-PY3YVYGN.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/chunk-TB52RCSF.js

@@ -0,0 +1,54 @@
+// src/stores/chat.store.ts
+import { create } from "zustand";
+var useChatStore = create((set) => ({
+  activeConversationId: null,
+  pendingTarget: null,
+  typingUsers: {},
+  onlineUsers: [],
+  lastRead: {},
+  lastSeen: {},
+  replyingTo: null,
+  editingMessage: null,
+  isSidebarOpen: true,
+  isGroupInfoOpen: false,
+  isStarredPanelOpen: false,
+  setActiveConversation: (id) => set({ activeConversationId: id, replyingTo: null, editingMessage: null }),
+  setPendingTarget: (target) => set({ pendingTarget: target }),
+  addTypingUser: (conversationId, user) => set((state) => {
+    const existing = state.typingUsers[conversationId] ?? [];
+    const deduped = existing.filter((u) => u.userId !== user.userId);
+    return { typingUsers: { ...state.typingUsers, [conversationId]: [...deduped, user] } };
+  }),
+  removeTypingUser: (conversationId, userId) => set((state) => ({
+    typingUsers: {
+      ...state.typingUsers,
+      [conversationId]: (state.typingUsers[conversationId] ?? []).filter(
+        (u) => u.userId !== userId
+      )
+    }
+  })),
+  setUserOnline: (userId) => set((state) => ({
+    onlineUsers: state.onlineUsers.includes(userId) ? state.onlineUsers : [...state.onlineUsers, userId]
+  })),
+  setUserOffline: (userId) => set((state) => ({ onlineUsers: state.onlineUsers.filter((id) => id !== userId) })),
+  setOnlineUsers: (userIds) => set({ onlineUsers: userIds }),
+  setLastRead: (conversationId, messageId, readAt) => set((state) => ({
+    lastRead: { ...state.lastRead, [conversationId]: { messageId, readAt } }
+  })),
+  setLastSeen: (userId, lastSeenAt) => set((state) => ({
+    lastSeen: { ...state.lastSeen, [userId]: lastSeenAt }
+  })),
+  setReplyingTo: (message) => set({ replyingTo: message, editingMessage: null }),
+  setEditingMessage: (message) => set({ editingMessage: message, replyingTo: null }),
+  toggleSidebar: () => set((state) => ({ isSidebarOpen: !state.isSidebarOpen })),
+  setSidebarOpen: (open) => set({ isSidebarOpen: open }),
+  toggleGroupInfo: () => set((state) => ({ isGroupInfoOpen: !state.isGroupInfoOpen })),
+  setGroupInfoOpen: (open) => set({ isGroupInfoOpen: open }),
+  toggleStarredPanel: () => set((state) => ({ isStarredPanelOpen: !state.isStarredPanelOpen })),
+  setStarredPanelOpen: (open) => set({ isStarredPanelOpen: open })
+}));
+
+export {
+  useChatStore
+};
+//# sourceMappingURL=chunk-TB52RCSF.js.map

package/dist/chunk-TB52RCSF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/stores/chat.store.ts"],"sourcesContent":["import { create } from 'zustand';\nimport type { Message } from '../types/index.js';\n\ninterface TypingUser {\n  userId: string;\n  displayName: string;\n  avatarUrl?: string;\n}\n\nexport interface LastReadEntry {\n  messageId: string;\n  readAt: string;\n}\n\ninterface ChatState {\n  activeConversationId: string | null;\n  pendingTarget: { conversationId: string; messageId: string } | null;\n  typingUsers: Record<string, TypingUser[]>;\n  onlineUsers: string[];\n  /** keyed by conversationId — current user's last read pointer per conversation */\n  lastRead: Record<string, LastReadEntry>;\n  /** keyed by userId — last seen timestamp for each user */\n  lastSeen: Record<string, string>;\n  replyingTo: Message | null;\n  editingMessage: Message | null;\n  isSidebarOpen: boolean;\n  isGroupInfoOpen: boolean;\n  isStarredPanelOpen: boolean;\n\n  setActiveConversation: (id: string | null) => void;\n  setPendingTarget: (target: { conversationId: string; messageId: string } | null) => void;\n  addTypingUser: (conversationId: string, user: TypingUser) => void;\n  removeTypingUser: (conversationId: string, userId: string) => void;\n  setUserOnline: (userId: string) => void;\n  setUserOffline: (userId: string) => void;\n  setOnlineUsers: (userIds: string[]) => void;\n  setLastRead: (conversationId: string, messageId: string, readAt: string) => void;\n  setLastSeen: (userId: string, lastSeenAt: string) => void;\n  setReplyingTo: (message: Message | null) => void;\n  setEditingMessage: (message: Message | null) => void;\n  toggleSidebar: () => void;\n  setSidebarOpen: (open: boolean) => void;\n  toggleGroupInfo: () => void;\n  setGroupInfoOpen: (open: boolean) => void;\n  toggleStarredPanel: () => void;\n  setStarredPanelOpen: (open: boolean) => void;\n}\n\nexport const useChatStore = create<ChatState>((set) => ({\n  activeConversationId: null,\n  pendingTarget: null,\n  typingUsers: {},\n  onlineUsers: [],\n  lastRead: {},\n  lastSeen: {},\n  replyingTo: null,\n  editingMessage: null,\n  isSidebarOpen: true,\n  isGroupInfoOpen: false,\n  isStarredPanelOpen: false,\n\n  setActiveConversation: (id) =>\n    set({ activeConversationId: id, replyingTo: null, editingMessage: null }),\n\n  setPendingTarget: (target) => set({ pendingTarget: target }),\n\n  addTypingUser: (conversationId, user) =>\n    set((state) => {\n      const existing = state.typingUsers[conversationId] ?? [];\n      const deduped = existing.filter((u) => u.userId !== user.userId);\n      return { typingUsers: { ...state.typingUsers, [conversationId]: [...deduped, user] } };\n    }),\n\n  removeTypingUser: (conversationId, userId) =>\n    set((state) => ({\n      typingUsers: {\n        ...state.typingUsers,\n        [conversationId]: (state.typingUsers[conversationId] ?? []).filter(\n          (u) => u.userId !== userId,\n        ),\n      },\n    })),\n\n  setUserOnline: (userId) =>\n    set((state) => ({\n      onlineUsers: state.onlineUsers.includes(userId)\n        ? state.onlineUsers\n        : [...state.onlineUsers, userId],\n    })),\n\n  setUserOffline: (userId) =>\n    set((state) => ({ onlineUsers: state.onlineUsers.filter((id) => id !== userId) })),\n\n  setOnlineUsers: (userIds) => set({ onlineUsers: userIds }),\n\n  setLastRead: (conversationId, messageId, readAt) =>\n    set((state) => ({\n      lastRead: { ...state.lastRead, [conversationId]: { messageId, readAt } },\n    })),\n\n  setLastSeen: (userId, lastSeenAt) =>\n    set((state) => ({\n      lastSeen: { ...state.lastSeen, [userId]: lastSeenAt },\n    })),\n\n  setReplyingTo: (message) => set({ replyingTo: message, editingMessage: null }),\n\n  setEditingMessage: (message) => set({ editingMessage: message, replyingTo: null }),\n\n  toggleSidebar: () => set((state) => ({ isSidebarOpen: !state.isSidebarOpen })),\n  setSidebarOpen: (open) => set({ isSidebarOpen: open }),\n\n  toggleGroupInfo: () => set((state) => ({ isGroupInfoOpen: !state.isGroupInfoOpen })),\n  setGroupInfoOpen: (open) => set({ isGroupInfoOpen: open }),\n\n  toggleStarredPanel: () => set((state) => ({ isStarredPanelOpen: !state.isStarredPanelOpen })),\n  setStarredPanelOpen: (open) => set({ isStarredPanelOpen: open }),\n}));\n"],"mappings":";AAAA,SAAS,cAAc;AAgDhB,IAAM,eAAe,OAAkB,CAAC,SAAS;AAAA,EACtD,sBAAsB;AAAA,EACtB,eAAe;AAAA,EACf,aAAa,CAAC;AAAA,EACd,aAAa,CAAC;AAAA,EACd,UAAU,CAAC;AAAA,EACX,UAAU,CAAC;AAAA,EACX,YAAY;AAAA,EACZ,gBAAgB;AAAA,EAChB,eAAe;AAAA,EACf,iBAAiB;AAAA,EACjB,oBAAoB;AAAA,EAEpB,uBAAuB,CAAC,OACtB,IAAI,EAAE,sBAAsB,IAAI,YAAY,MAAM,gBAAgB,KAAK,CAAC;AAAA,EAE1E,kBAAkB,CAAC,WAAW,IAAI,EAAE,eAAe,OAAO,CAAC;AAAA,EAE3D,eAAe,CAAC,gBAAgB,SAC9B,IAAI,CAAC,UAAU;AACb,UAAM,WAAW,MAAM,YAAY,cAAc,KAAK,CAAC;AACvD,UAAM,UAAU,SAAS,OAAO,CAAC,MAAM,EAAE,WAAW,KAAK,MAAM;AAC/D,WAAO,EAAE,aAAa,EAAE,GAAG,MAAM,aAAa,CAAC,cAAc,GAAG,CAAC,GAAG,SAAS,IAAI,EAAE,EAAE;AAAA,EACvF,CAAC;AAAA,EAEH,kBAAkB,CAAC,gBAAgB,WACjC,IAAI,CAAC,WAAW;AAAA,IACd,aAAa;AAAA,MACX,GAAG,MAAM;AAAA,MACT,CAAC,cAAc,IAAI,MAAM,YAAY,cAAc,KAAK,CAAC,GAAG;AAAA,QAC1D,CAAC,MAAM,EAAE,WAAW;AAAA,MACtB;AAAA,IACF;AAAA,EACF,EAAE;AAAA,EAEJ,eAAe,CAAC,WACd,IAAI,CAAC,WAAW;AAAA,IACd,aAAa,MAAM,YAAY,SAAS,MAAM,IAC1C,MAAM,cACN,CAAC,GAAG,MAAM,aAAa,MAAM;AAAA,EACnC,EAAE;AAAA,EAEJ,gBAAgB,CAAC,WACf,IAAI,CAAC,WAAW,EAAE,aAAa,MAAM,YAAY,OAAO,CAAC,OAAO,OAAO,MAAM,EAAE,EAAE;AAAA,EAEnF,gBAAgB,CAAC,YAAY,IAAI,EAAE,aAAa,QAAQ,CAAC;AAAA,EAEzD,aAAa,CAAC,gBAAgB,WAAW,WACvC,IAAI,CAAC,WAAW;AAAA,IACd,UAAU,EAAE,GAAG,MAAM,UAAU,CAAC,cAAc,GAAG,EAAE,WAAW,OAAO,EAAE;AAAA,EACzE,EAAE;AAAA,EAEJ,aAAa,CAAC,QAAQ,eACpB,IAAI,CAAC,WAAW;AAAA,IACd,UAAU,EAAE,GAAG,MAAM,UAAU,CAAC,MAAM,GAAG,WAAW;AAAA,EACtD,EAAE;AAAA,EAEJ,eAAe,CAAC,YAAY,IAAI,EAAE,YAAY,SAAS,gBAAgB,KAAK,CAAC;AAAA,EAE7E,mBAAmB,CAAC,YAAY,IAAI,EAAE,gBAAgB,SAAS,YAAY,KAAK,CAAC;AAAA,EAEjF,eAAe,MAAM,IAAI,CAAC,WAAW,EAAE,eAAe,CAAC,MAAM,cAAc,EAAE;AAAA,EAC7E,gBAAgB,CAAC,SAAS,IAAI,EAAE,eAAe,KAAK,CAAC;AAAA,EAErD,iBAAiB,MAAM,IAAI,CAAC,WAAW,EAAE,iBAAiB,CAAC,MAAM,gBAAgB,EAAE;AAAA,EACnF,kBAAkB,CAAC,SAAS,IAAI,EAAE,iBAAiB,KAAK,CAAC;AAAA,EAEzD,oBAAoB,MAAM,IAAI,CAAC,WAAW,EAAE,oBAAoB,CAAC,MAAM,mBAAmB,EAAE;AAAA,EAC5F,qBAAqB,CAAC,SAAS,IAAI,EAAE,oBAAoB,KAAK,CAAC;AACjE,EAAE;","names":[]}

package/dist/index.cjs

@@ -5,6 +5,9 @@ var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
 var __getProtoOf = Object.getPrototypeOf;
 var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __esm = (fn, res) => function __init() {
+  return fn && (res = (0, fn[__getOwnPropNames(fn)[0]])(fn = 0)), res;
+};
 var __export = (target, all) => {
   for (var name in all)
     __defProp(target, name, { get: all[name], enumerable: true });
@@ -27,6 +30,66 @@ var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__ge
 ));
 var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
 
+// src/stores/chat.store.ts
+var chat_store_exports = {};
+__export(chat_store_exports, {
+  useChatStore: () => useChatStore
+});
+var import_zustand, useChatStore;
+var init_chat_store = __esm({
+  "src/stores/chat.store.ts"() {
+    "use strict";
+    import_zustand = require("zustand");
+    useChatStore = (0, import_zustand.create)((set) => ({
+      activeConversationId: null,
+      pendingTarget: null,
+      typingUsers: {},
+      onlineUsers: [],
+      lastRead: {},
+      lastSeen: {},
+      replyingTo: null,
+      editingMessage: null,
+      isSidebarOpen: true,
+      isGroupInfoOpen: false,
+      isStarredPanelOpen: false,
+      setActiveConversation: (id) => set({ activeConversationId: id, replyingTo: null, editingMessage: null }),
+      setPendingTarget: (target) => set({ pendingTarget: target }),
+      addTypingUser: (conversationId, user) => set((state) => {
+        const existing = state.typingUsers[conversationId] ?? [];
+        const deduped = existing.filter((u) => u.userId !== user.userId);
+        return { typingUsers: { ...state.typingUsers, [conversationId]: [...deduped, user] } };
+      }),
+      removeTypingUser: (conversationId, userId) => set((state) => ({
+        typingUsers: {
+          ...state.typingUsers,
+          [conversationId]: (state.typingUsers[conversationId] ?? []).filter(
+            (u) => u.userId !== userId
+          )
+        }
+      })),
+      setUserOnline: (userId) => set((state) => ({
+        onlineUsers: state.onlineUsers.includes(userId) ? state.onlineUsers : [...state.onlineUsers, userId]
+      })),
+      setUserOffline: (userId) => set((state) => ({ onlineUsers: state.onlineUsers.filter((id) => id !== userId) })),
+      setOnlineUsers: (userIds) => set({ onlineUsers: userIds }),
+      setLastRead: (conversationId, messageId, readAt) => set((state) => ({
+        lastRead: { ...state.lastRead, [conversationId]: { messageId, readAt } }
+      })),
+      setLastSeen: (userId, lastSeenAt) => set((state) => ({
+        lastSeen: { ...state.lastSeen, [userId]: lastSeenAt }
+      })),
+      setReplyingTo: (message) => set({ replyingTo: message, editingMessage: null }),
+      setEditingMessage: (message) => set({ editingMessage: message, replyingTo: null }),
+      toggleSidebar: () => set((state) => ({ isSidebarOpen: !state.isSidebarOpen })),
+      setSidebarOpen: (open) => set({ isSidebarOpen: open }),
+      toggleGroupInfo: () => set((state) => ({ isGroupInfoOpen: !state.isGroupInfoOpen })),
+      setGroupInfoOpen: (open) => set({ isGroupInfoOpen: open }),
+      toggleStarredPanel: () => set((state) => ({ isStarredPanelOpen: !state.isStarredPanelOpen })),
+      setStarredPanelOpen: (open) => set({ isStarredPanelOpen: open })
+    }));
+  }
+});
+
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
@@ -47,6 +110,7 @@ __export(src_exports, {
   normalizeConversation: () => normalizeConversation,
   onSocketStatus: () => onSocketStatus,
   reconnectSocket: () => reconnectSocket,
+  refreshSocketAuth: () => refreshSocketAuth,
   resetAuthStore: () => resetAuthStore,
   resolveConfig: () => resolveConfig,
   setApiClientInstance: () => setApiClientInstance,
@@ -54,13 +118,23 @@ __export(src_exports, {
   storageApi: () => storageApi,
   tryGetSocket: () => tryGetSocket,
   uploadBatch: () => uploadBatch,
-  useChatStore: () => useChatStore
+  useChatStore: () => useChatStore,
+  usersApi: () => usersApi
 });
 module.exports = __toCommonJS(src_exports);
 
 // src/config/types.ts
 function resolveConfig(config) {
   const socketUrl = config.socketUrl ?? config.apiUrl.replace(/\/api\/v\d+\/?$/, "").replace(/\/$/, "");
+  let socketOrigin = socketUrl;
+  let socketPath = "/socket.io";
+  try {
+    const parsed = new URL(socketUrl);
+    socketOrigin = parsed.origin;
+    const pathname = parsed.pathname.replace(/\/$/, "");
+    if (pathname && pathname !== "/") socketPath = `${pathname}/socket.io`;
+  } catch {
+  }
   const raw = config.upload?.maxFileSizeMB;
   let limits;
   if (typeof raw === "number") {
@@ -78,10 +152,13 @@ function resolveConfig(config) {
   return {
     apiUrl: config.apiUrl.replace(/\/$/, ""),
     socketUrl,
+    socketOrigin,
+    socketPath,
     authToken: config.authToken,
     authProvider: config.authProvider,
     userId: config.userId,
     tenantId: config.tenantId,
+    avatar: config.avatar,
     encryptionMode: config.encryptionMode ?? "none",
     upload: {
       maxFileSizeMB: limits,
@@ -91,7 +168,10 @@ function resolveConfig(config) {
       onProgress: config.upload?.onProgress
     },
     platformUploadFn: config.platformUploadFn,
-    persistStorage: config.persistStorage
+    persistStorage: config.persistStorage,
+    messagePageSize: config.messagePageSize ?? 40,
+    starredMessagePageSize: config.starredMessagePageSize ?? 30,
+    searchPageSize: config.searchPageSize ?? 50
   };
 }
 
@@ -99,9 +179,11 @@ function resolveConfig(config) {
 var import_axios = __toESM(require("axios"), 1);
 var _tokenStore = null;
 var _config = null;
+var _avatarSent = false;
 function initApiClient(config, tokenStore) {
   _config = config;
   _tokenStore = tokenStore;
+  _avatarSent = false;
   const client = import_axios.default.create({
     baseURL: config.apiUrl,
     headers: { "Content-Type": "application/json" }
@@ -111,6 +193,11 @@ function initApiClient(config, tokenStore) {
     if (token) req.headers["Authorization"] = `Bearer ${token}`;
     if (_config?.userId) req.headers["x-user-id"] = _config.userId;
     if (_config?.tenantId) req.headers["X-Tenant-ID"] = _config.tenantId;
+    if (token && !_avatarSent && _config?.avatar) {
+      if (_config.avatar.base64) req.headers["x-avatar-base64"] = _config.avatar.base64;
+      else if (_config.avatar.url) req.headers["x-avatar-url"] = _config.avatar.url;
+      _avatarSent = true;
+    }
     return req;
   });
   let isRefreshing = false;
@@ -195,15 +282,37 @@ var authApi = {
   async getMe() {
     const { data } = await getApiClient().get("/users/me");
     return data;
+  },
+  // Upload a new avatar file (builtin mode — multipart)
+  async uploadAvatar(file, mimeType) {
+    const form = new FormData();
+    form.append("avatar", file instanceof File ? file : new File([file], "avatar.jpg", { type: mimeType ?? "image/jpeg" }));
+    const { data } = await getApiClient().put("/users/me/avatar", form, {
+      headers: { "Content-Type": "multipart/form-data" }
+    });
+    return data;
+  },
+  // Sync avatar from URL or base64 (non-builtin modes — or post-init update)
+  async syncAvatar(source) {
+    const headers = {};
+    if (source.base64) headers["x-avatar-base64"] = source.base64;
+    else if (source.url) headers["x-avatar-url"] = source.url;
+    const { data } = await getApiClient().post("/users/me/avatar/sync", {}, { headers });
+    return data;
   }
 };
 
 // src/api/messages.ts
 var messagesApi = {
   async list(conversationId, params = {}) {
+    const { cursor, direction, ...rest } = params;
+    const serverParams = { ...rest };
+    if (cursor) {
+      serverParams[direction === "after" ? "after" : "before"] = cursor;
+    }
     const { data } = await getApiClient().get(
       `/conversations/${conversationId}/messages`,
-      { params }
+      { params: serverParams }
     );
     return data;
   },
@@ -225,6 +334,9 @@ var messagesApi = {
   async delete(messageId) {
     await getApiClient().delete(`/messages/${messageId}`);
   },
+  async deleteForMe(messageId) {
+    await getApiClient().delete(`/messages/${messageId}/for-me`);
+  },
   async addReaction(messageId, emoji) {
     const { data } = await getApiClient().post(`/messages/${messageId}/reactions`, { emoji });
     return data;
@@ -249,6 +361,12 @@ var messagesApi = {
     const { data } = await getApiClient().get("/messages/search", { params });
     return data;
   },
+  async getLastRead(conversationId) {
+    const { data } = await getApiClient().get(
+      `/conversations/${conversationId}/read-receipt`
+    );
+    return data;
+  },
   async markAsRead(conversationId, messageId) {
     await getApiClient().post(`/conversations/${conversationId}/read`, messageId ? { messageId } : {});
   },
@@ -273,6 +391,7 @@ function normalizeParticipant(p) {
     userId: p.userId,
     role: p.role,
     joinedAt: p.joinedAt,
+    isActive: p.isActive,
     user: hasUserDetails ? {
       id: p.userId,
       tenantId: "",
@@ -299,7 +418,7 @@ function normalizeLastMessage(lastMsg) {
       text: lastMsg.contentPreview
     },
     reactions: [],
-    status: "sent",
+    status: lastMsg.status ?? "sent",
     isEdited: false,
     sentAt: lastMsg.sentAt ?? "",
     createdAt: lastMsg.sentAt ?? ""
@@ -376,9 +495,25 @@ var conversationsApi = {
     const { data } = await getApiClient().get(`/conversations/${conversationId}/participants`);
     return data;
   },
-  async searchUsers(query) {
-    const { data } = await getApiClient().get("/users/search", { params: { query } });
-    return data.data;
+  /**
+   * Get unread message count for a single conversation.
+   * Use this after app foreground or socket reconnect to refresh a specific count.
+   */
+  async getUnreadCount(conversationId) {
+    const { data } = await getApiClient().get(
+      `/conversations/${conversationId}/unread`
+    );
+    return data;
+  },
+  /**
+   * Get total unread count across all conversations + per-conversation breakdown.
+   * Use on app cold start, foreground resume, or after socket reconnect.
+   * The socket keeps counts live while connected — this is the source of truth
+   * when the socket was down.
+   */
+  async getUnreadSummary() {
+    const { data } = await getApiClient().get("/conversations/unread");
+    return data;
   }
 };
 
@@ -483,11 +618,52 @@ var devicesApi = {
   }
 };
 
+// src/api/users.ts
+var usersApi = {
+  async list(params = {}) {
+    const { data } = await getApiClient().get("/users", { params });
+    return data;
+  },
+  async getById(userId) {
+    const { data } = await getApiClient().get(`/users/${userId}`);
+    return data;
+  },
+  async getLastSeen(userId) {
+    const { data } = await getApiClient().get(`/users/${userId}`);
+    return { lastSeenAt: data.lastSeenAt ?? null };
+  },
+  /**
+   * Update notification preferences for the current user.
+   * Partial update — only send fields you want to change.
+   * A prefs record is automatically created with defaults when a device
+   * token is first registered, so this never fails with "not found".
+   */
+  async updatePreferences(prefs) {
+    const { data } = await getApiClient().put("/users/me/preferences", prefs);
+    return data;
+  },
+  /**
+   * Fetch current notification preferences for the current user.
+   * Returns null if no prefs record exists yet (all defaults apply).
+   */
+  async getPreferences() {
+    try {
+      const { data } = await getApiClient().get("/users/me/preferences");
+      return data;
+    } catch {
+      return null;
+    }
+  }
+};
+
 // src/socket/socket.ts
 var import_socket = require("socket.io-client");
 var _socket = null;
 var _status = "disconnected";
 var _statusListeners = /* @__PURE__ */ new Set();
+var _getToken = null;
+var _userId;
+var _tenantId;
 function setStatus(s) {
   _status = s;
   _statusListeners.forEach((l) => l(s));
@@ -507,10 +683,23 @@ function onSocketStatus(listener) {
   return () => _statusListeners.delete(listener);
 }
 async function connectSocket(config, getToken) {
-  if (_socket?.connected) return _socket;
+  if (_socket && !_socket.disconnected) return _socket;
+  _getToken = getToken;
+  _userId = config.userId;
+  _tenantId = config.tenantId;
   const token = getToken();
-  _socket = (0, import_socket.io)(`${config.socketUrl}/chat`, {
-    auth: { token: token ? `Bearer ${token}` : "" },
+  _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).
+    path: config.socketPath,
     transports: ["websocket", "polling"],
     reconnection: true,
     reconnectionAttempts: 10,
@@ -521,9 +710,30 @@ async function connectSocket(config, getToken) {
   setStatus("connecting");
   _socket.on("connect", () => setStatus("connected"));
   _socket.on("disconnect", () => setStatus("disconnected"));
-  _socket.on("connect_error", () => setStatus("error"));
+  _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) => {
+    Promise.resolve().then(() => (init_chat_store(), chat_store_exports)).then(({ useChatStore: useChatStore2 }) => {
+      useChatStore2.getState().setLastRead(event.conversationId, event.messageId, event.readAt);
+    });
+  });
+  _socket.on("user_online", (event) => {
+    Promise.resolve().then(() => (init_chat_store(), chat_store_exports)).then(({ useChatStore: useChatStore2 }) => {
+      const store = useChatStore2.getState();
+      store.setUserOnline(event.userId);
+    });
+  });
+  _socket.on("user_offline", (event) => {
+    Promise.resolve().then(() => (init_chat_store(), chat_store_exports)).then(({ useChatStore: useChatStore2 }) => {
+      const store = useChatStore2.getState();
+      store.setUserOffline(event.userId);
+      if (event.lastSeenAt) store.setLastSeen(event.userId, event.lastSeenAt);
+    });
+  });
   return _socket;
 }
 function disconnectSocket() {
@@ -532,13 +742,31 @@ function disconnectSocket() {
     _socket = null;
     setStatus("disconnected");
   }
+  _getToken = null;
+  _userId = void 0;
+  _tenantId = void 0;
 }
-function reconnectSocket(token) {
+function reconnectSocket(token, userId, tenantId) {
   if (_socket) {
-    _socket.auth = { token: `Bearer ${token}` };
+    _socket.auth = {
+      token: `Bearer ${token}`,
+      ...userId && { userId },
+      ...tenantId && { tenantId }
+    };
     _socket.connect();
   }
 }
+function refreshSocketAuth() {
+  if (!_socket || !_getToken) return false;
+  const fresh = _getToken();
+  if (!fresh) return false;
+  _socket.auth = {
+    token: `Bearer ${fresh}`,
+    ..._userId && { userId: _userId },
+    ..._tenantId && { tenantId: _tenantId }
+  };
+  return true;
+}
 
 // src/socket/emitters.ts
 var ACK_TIMEOUT = 5e3;
@@ -574,6 +802,9 @@ var socketEmit = {
   deleteMessage(messageId) {
     return withAck("delete_message", { messageId });
   },
+  deleteMessageForMe(messageId) {
+    return withAck("delete_message_for_me", { messageId });
+  },
   addReaction(messageId, emoji) {
     return withAck("add_reaction", { messageId, emoji });
   },
@@ -617,12 +848,12 @@ var socketEmit = {
 };
 
 // src/stores/auth.store.ts
-var import_zustand = require("zustand");
+var import_zustand2 = require("zustand");
 var import_middleware = require("zustand/middleware");
 function createAuthStore(storage) {
   if (!storage) throw new Error("[AntzChat] createAuthStore requires a valid PersistStorage \u2014 received undefined. Make sure the SDK config is fully resolved before initializing the store.");
   const ref = { store: null };
-  const store = (0, import_zustand.create)()(
+  const store = (0, import_zustand2.create)()(
     (0, import_middleware.persist)(
       (set) => ({
         user: null,
@@ -703,47 +934,8 @@ function resetAuthStore() {
   _authStore = null;
 }
 
-// src/stores/chat.store.ts
-var import_zustand2 = require("zustand");
-var useChatStore = (0, import_zustand2.create)((set) => ({
-  activeConversationId: null,
-  pendingTarget: null,
-  typingUsers: {},
-  onlineUsers: [],
-  replyingTo: null,
-  editingMessage: null,
-  isSidebarOpen: true,
-  isGroupInfoOpen: false,
-  isStarredPanelOpen: false,
-  setActiveConversation: (id) => set({ activeConversationId: id, replyingTo: null, editingMessage: null }),
-  setPendingTarget: (target) => set({ pendingTarget: target }),
-  addTypingUser: (conversationId, user) => set((state) => {
-    const existing = state.typingUsers[conversationId] ?? [];
-    const deduped = existing.filter((u) => u.userId !== user.userId);
-    return { typingUsers: { ...state.typingUsers, [conversationId]: [...deduped, user] } };
-  }),
-  removeTypingUser: (conversationId, userId) => set((state) => ({
-    typingUsers: {
-      ...state.typingUsers,
-      [conversationId]: (state.typingUsers[conversationId] ?? []).filter(
-        (u) => u.userId !== userId
-      )
-    }
-  })),
-  setUserOnline: (userId) => set((state) => ({
-    onlineUsers: state.onlineUsers.includes(userId) ? state.onlineUsers : [...state.onlineUsers, userId]
-  })),
-  setUserOffline: (userId) => set((state) => ({ onlineUsers: state.onlineUsers.filter((id) => id !== userId) })),
-  setOnlineUsers: (userIds) => set({ onlineUsers: userIds }),
-  setReplyingTo: (message) => set({ replyingTo: message, editingMessage: null }),
-  setEditingMessage: (message) => set({ editingMessage: message, replyingTo: null }),
-  toggleSidebar: () => set((state) => ({ isSidebarOpen: !state.isSidebarOpen })),
-  setSidebarOpen: (open) => set({ isSidebarOpen: open }),
-  toggleGroupInfo: () => set((state) => ({ isGroupInfoOpen: !state.isGroupInfoOpen })),
-  setGroupInfoOpen: (open) => set({ isGroupInfoOpen: open }),
-  toggleStarredPanel: () => set((state) => ({ isStarredPanelOpen: !state.isStarredPanelOpen })),
-  setStarredPanelOpen: (open) => set({ isStarredPanelOpen: open })
-}));
+// src/index.ts
+init_chat_store();
 
 // src/client-facade.ts
 var AntzChatClient = class {
@@ -752,6 +944,7 @@ var AntzChatClient = class {
     this.messages = messagesApi;
     this.conversations = conversationsApi;
     this.storage = storageApi;
+    this.users = usersApi;
     this.socket = {
       emit: socketEmit,
       on: (event, handler) => getSocket().on(event, handler),
@@ -799,6 +992,7 @@ var AntzChatClient = class {
   normalizeConversation,
   onSocketStatus,
   reconnectSocket,
+  refreshSocketAuth,
   resetAuthStore,
   resolveConfig,
   setApiClientInstance,
@@ -806,6 +1000,7 @@ var AntzChatClient = class {
   storageApi,
   tryGetSocket,
   uploadBatch,
-  useChatStore
+  useChatStore,
+  usersApi
 });
 //# sourceMappingURL=index.cjs.map