@ethora/sdk-backend 25.12.20 → 26.2.1

package/dist/repositories/EthoraSDKService.d.ts

@@ -7,7 +7,7 @@
  *
  * @format
  */
-import type { UUID, ChatRepository, ApiResponse, UpdateUserData, GetUsersQueryParams } from "../types";
+import type { UUID, ChatRepository, ApiResponse, UpdateUserData, GetUsersQueryParams } from '../types';
 /**
  * EthoraSDKService - Concrete implementation of ChatRepository
  */
@@ -17,16 +17,16 @@ export declare class EthoraSDKService implements ChatRepository {
     private readonly httpClient;
     constructor();
     /**
-     * Generates a fully-qualified chat room JID from a workspace ID
+     * Generates a fully-qualified chat room JID from a chat ID
      *
-     * The JID is constructed in the format `<appId>_<workspace_id>@conference.xmpp.ethoradev.com`.
+     * The JID is constructed in the format `<appId>_<chat_id>@conference.xmpp.ethoradev.com`.
      * This method uses a static JID domain to provide a unique identifier for a chat room.
      *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
      * @param full - Whether to include the full JID domain
      * @returns The fully-qualified JID string for the chat room
      */
-    createChatName(workspaceId: UUID, full?: boolean): string;
+    createChatName(chatId: UUID, full?: boolean): string;
     /**
      * Creates a client-side JWT token for a specific user ID
      *
@@ -64,30 +64,36 @@ export declare class EthoraSDKService implements ChatRepository {
      */
     createUser(userId: UUID, userData?: Record<string, unknown>): Promise<ApiResponse>;
     /**
-     * Creates a chat room for a workspace
+     * Creates a chat room
      *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
      * @param roomData - Additional room data (optional)
      * @returns The API response
      */
-    createChatRoom(workspaceId: UUID, roomData?: Record<string, unknown>): Promise<ApiResponse>;
+    createChatRoom(chatId: UUID, roomData?: Record<string, unknown>): Promise<ApiResponse>;
     /**
      * Grants a user access to a chat room
      *
-     * Uses plain userIds without prefixing (matching how users are created)
-     *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
      * @param userId - The unique identifier of the user (or array of user IDs)
      * @returns The API response
      */
-    grantUserAccessToChatRoom(workspaceId: UUID, userId: UUID | UUID[]): Promise<ApiResponse>;
+    grantUserAccessToChatRoom(chatId: UUID, userId: UUID | UUID[]): Promise<ApiResponse>;
     /**
      * Grants chatbot access to a chat room
      *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
+     * @returns The API response
+     */
+    grantChatbotAccessToChatRoom(chatId: UUID): Promise<ApiResponse>;
+    /**
+     * Removes a user's access to a chat room
+     *
+     * @param chatId - The unique identifier of the chat
+     * @param userId - The unique identifier of the user (or array of user IDs)
      * @returns The API response
      */
-    grantChatbotAccessToChatRoom(workspaceId: UUID): Promise<ApiResponse>;
+    removeUserAccessFromChatRoom(chatId: UUID, userId: UUID | UUID[]): Promise<ApiResponse>;
     /**
      * Deletes users from the chat service
      *
@@ -96,16 +102,16 @@ export declare class EthoraSDKService implements ChatRepository {
      */
     deleteUsers(userIds: UUID[]): Promise<ApiResponse>;
     /**
-     * Deletes a chat room from the chat service by its workspace ID
+     * Deletes a chat room from the chat service by its chat ID
      *
-     * This method sends a DELETE request to the Ethora API using the workspace ID
+     * This method sends a DELETE request to the Ethora API using the chat ID
      * to construct the chat name. It gracefully handles the case where the chat room
      * is already non-existent (422 Not Found).
      *
-     * @param workspaceId - The unique identifier of the workspace associated with the chat room
+     * @param chatId - The unique identifier of the chat associated with the chat room
      * @returns The JSON response from the chat service upon successful deletion or a success status if not found
      */
-    deleteChatRoom(workspaceId: UUID): Promise<ApiResponse>;
+    deleteChatRoom(chatId: UUID): Promise<ApiResponse>;
     /**
      * Updates multiple users in the chat service
      *
@@ -119,6 +125,9 @@ export declare class EthoraSDKService implements ChatRepository {
      * - not-found: user was not found
      * - skipped: user update was skipped
      *
+     * Note: The API only accepts xmppUsername, firstName, lastName, username, and profileImage fields.
+     * Other fields will be filtered out automatically.
+     *
      * @param users - Array of user data to update (1-100 users)
      * @returns The API response with results array containing status for each user
      */
@@ -133,6 +142,9 @@ export declare class EthoraSDKService implements ChatRepository {
      *   - For 1-on-1 chats: use xmppUsernameA-xmppUsernameB format
      * - xmppUsername parameter: returns a specific user by XMPP username
      *
+     * Note: The xmppUsername query parameter may not be supported by the API yet.
+     * In that case, you can get all users and filter client-side.
+     *
      * @param params - Query parameters for filtering users (optional)
      * @returns The API response
      */

package/dist/repositories/EthoraSDKService.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"EthoraSDKService.d.ts","sourceRoot":"","sources":["../../src/repositories/EthoraSDKService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,IAAI,EACJ,cAAc,EACd,WAAW,EAIX,cAAc,EAEd,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAWlB;;GAEG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;;IAgB3C;;;;;;;;;OASG;IACH,cAAc,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,GAAE,OAAc,GAAG,MAAM;IAa/D;;;;;;;;;OASG;IACH,sBAAsB,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAK5C;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAOlB;;;;;OAKG;YACW,WAAW;IA4BzB;;;;;;;;;;OAUG;IACG,UAAU,CACd,MAAM,EAAE,IAAI,EACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IA0EvB;;;;;;OAMG;IACG,cAAc,CAClB,WAAW,EAAE,IAAI,EACjB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IAwBvB;;;;;;;;OAQG;IACG,yBAAyB,CAC7B,WAAW,EAAE,IAAI,EACjB,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,GACpB,OAAO,CAAC,WAAW,CAAC;IA8CvB;;;;;OAKG;IACG,4BAA4B,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAoB3E;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAkCxD;;;;;;;;;OASG;IACG,cAAc,CAAC,WAAW,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAgD7D;;;;;;;;;;;;;;;OAeG;IACG,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAkChE;;;;;;;;;;;;OAYG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;CA6BnE;AAaD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD"}
+{"version":3,"file":"EthoraSDKService.d.ts","sourceRoot":"","sources":["../../src/repositories/EthoraSDKService.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EACV,IAAI,EACJ,cAAc,EACd,WAAW,EAIX,cAAc,EAEd,mBAAmB,EACpB,MAAM,UAAU,CAAC;AAWlB;;GAEG;AACH,qBAAa,gBAAiB,YAAW,cAAc;IACrD,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAS;IACvC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAgB;IACxC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgB;;IAgB3C;;;;;;;;;OASG;IACH,cAAc,CAAC,MAAM,EAAE,IAAI,EAAE,IAAI,GAAE,OAAc,GAAG,MAAM;IAW1D;;;;;;;;;OASG;IACH,sBAAsB,CAAC,MAAM,EAAE,IAAI,GAAG,MAAM;IAK5C;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAOlB;;;;;OAKG;YACW,WAAW;IA4BzB;;;;;;;;;;OAUG;IACG,UAAU,CACd,MAAM,EAAE,IAAI,EACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IA0EvB;;;;;;OAMG;IACG,cAAc,CAClB,MAAM,EAAE,IAAI,EACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,WAAW,CAAC;IAsBvB;;;;;;OAMG;IACG,yBAAyB,CAC7B,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,GACpB,OAAO,CAAC,WAAW,CAAC;IAsDvB;;;;;OAKG;IACG,4BAA4B,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IAkBtE;;;;;;OAMG;IACG,4BAA4B,CAChC,MAAM,EAAE,IAAI,EACZ,MAAM,EAAE,IAAI,GAAG,IAAI,EAAE,GACpB,OAAO,CAAC,WAAW,CAAC;IAoDvB;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,IAAI,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IAkCxD;;;;;;;;;OASG;IACG,cAAc,CAAC,MAAM,EAAE,IAAI,GAAG,OAAO,CAAC,WAAW,CAAC;IA8CxD;;;;;;;;;;;;;;;;;;OAkBG;IACG,WAAW,CAAC,KAAK,EAAE,cAAc,EAAE,GAAG,OAAO,CAAC,WAAW,CAAC;IA2ChE;;;;;;;;;;;;;;;OAeG;IACG,QAAQ,CAAC,MAAM,CAAC,EAAE,mBAAmB,GAAG,OAAO,CAAC,WAAW,CAAC;CA6BnE;AAaD,wBAAgB,mBAAmB,IAAI,gBAAgB,CAMtD"}

package/dist/repositories/EthoraSDKService.js

@@ -19,7 +19,7 @@ const axios_1 = __importDefault(require("axios"));
 const secrets_1 = require("../config/secrets");
 const jwt_1 = require("../utils/jwt");
 const logger_1 = require("../utils/logger");
-const logger = (0, logger_1.getLogger)("EthoraSDKService");
+const logger = (0, logger_1.getLogger)('EthoraSDKService');
 /**
  * EthoraSDKService - Concrete implementation of ChatRepository
  */
@@ -31,26 +31,26 @@ class EthoraSDKService {
         this.httpClient = axios_1.default.create({
             timeout: secrets_1.DEFAULT_TIMEOUT.total,
             headers: {
-                "Content-Type": "application/json",
+                'Content-Type': 'application/json',
             },
         });
-        logger.debug("EthoraSDKService instance initialized");
+        logger.debug('EthoraSDKService instance initialized');
     }
     /**
-     * Generates a fully-qualified chat room JID from a workspace ID
+     * Generates a fully-qualified chat room JID from a chat ID
      *
-     * The JID is constructed in the format `<appId>_<workspace_id>@conference.xmpp.ethoradev.com`.
+     * The JID is constructed in the format `<appId>_<chat_id>@conference.xmpp.ethoradev.com`.
      * This method uses a static JID domain to provide a unique identifier for a chat room.
      *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
      * @param full - Whether to include the full JID domain
      * @returns The fully-qualified JID string for the chat room
      */
-    createChatName(workspaceId, full = true) {
-        logger.debug(`Creating chat room name (JID) for workspace ID: ${workspaceId}`);
+    createChatName(chatId, full = true) {
+        logger.debug(`Creating chat room name (JID) for chat ID: ${chatId}`);
         const chatName = full
-            ? `${this.secrets.chatAppId}_${workspaceId}${secrets_1.ETHORA_JID_DOMAIN}`
-            : `${this.secrets.chatAppId}_${workspaceId}`;
+            ? `${this.secrets.chatAppId}_${chatId}${secrets_1.ETHORA_JID_DOMAIN}`
+            : `${this.secrets.chatAppId}_${chatId}`;
         logger.info(`Chat room name created: '${chatName}'`);
         return chatName;
     }
@@ -74,9 +74,9 @@ class EthoraSDKService {
      * @returns The headers dictionary containing the `x-custom-token` field
      */
     getHeaders() {
-        logger.debug("Retrieving headers for a server-to-server API call");
+        logger.debug('Retrieving headers for a server-to-server API call');
         return {
-            "x-custom-token": (0, jwt_1.createServerToken)(),
+            'x-custom-token': (0, jwt_1.createServerToken)(),
         };
     }
     /**
@@ -104,7 +104,7 @@ class EthoraSDKService {
                     `Response: ${axiosError.response?.data}`, error);
                 throw error;
             }
-            logger.error("An unexpected error occurred during API call", error);
+            logger.error('An unexpected error occurred during API call', error);
             throw error;
         }
     }
@@ -121,7 +121,7 @@ class EthoraSDKService {
      */
     async createUser(userId, userData) {
         logger.info(`Attempting to create user with ID: ${userId}`);
-        const createUrl = `${this.baseEthoraUrl}/v1/users/batch`;
+        const createUrl = `${this.baseEthoraUrl}/v2/users/batch`;
         // Extract user fields from userData or use defaults
         // Generate unique email using UUID if not provided
         const email = userData?.email || `${(0, crypto_1.randomUUID)()}@example.com`;
@@ -132,22 +132,22 @@ class EthoraSDKService {
         let lastName;
         if (userData?.firstName) {
             firstName = userData.firstName;
-            lastName = userData?.lastName || "";
+            lastName = userData?.lastName || '';
         }
         else if (userData?.displayName) {
             const displayName = userData.displayName;
             const nameParts = displayName.trim().split(/\s+/);
-            firstName = nameParts[0] || "User";
-            lastName = nameParts.slice(1).join(" ") || "";
+            firstName = nameParts[0] || 'User';
+            lastName = nameParts.slice(1).join(' ') || '';
         }
         else {
-            firstName = "User";
-            lastName = "";
+            firstName = 'User';
+            lastName = '';
         }
         // Ensure lastName meets API requirements: at least 2 characters, not empty
         if (!lastName || lastName.length < 2) {
             // Use a default lastName if empty or too short
-            lastName = "User";
+            lastName = 'User';
         }
         // Use plain userId without prefixing
         const userIdStr = String(userId);
@@ -162,13 +162,13 @@ class EthoraSDKService {
                     password: password,
                     ...(userData &&
                         Object.fromEntries(Object.entries(userData).filter(([key]) => ![
-                            "email",
-                            "firstName",
-                            "lastName",
-                            "password",
-                            "uuid",
-                            "displayName",
-                            "role", // Role is not allowed in user creation payload
+                            'email',
+                            'firstName',
+                            'lastName',
+                            'password',
+                            'uuid',
+                            'displayName',
+                            'role',
                         ].includes(key)))),
                 },
             ],
@@ -176,32 +176,32 @@ class EthoraSDKService {
         logger.debug(`Chat service API URL: ${createUrl}`);
         logger.debug(`Request payload: ${JSON.stringify(payload)}`);
         return this.makeRequest({
-            method: "POST",
+            method: 'POST',
             url: createUrl,
             data: payload,
         });
     }
     /**
-     * Creates a chat room for a workspace
+     * Creates a chat room
      *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
      * @param roomData - Additional room data (optional)
      * @returns The API response
      */
-    async createChatRoom(workspaceId, roomData) {
-        logger.info(`Attempting to create chat room for workspace ID: ${workspaceId}`);
-        const createUrl = `${this.baseEthoraUrl}/v1/chats`;
+    async createChatRoom(chatId, roomData) {
+        logger.info(`Attempting to create chat room with ID: ${chatId}`);
+        const createUrl = `${this.baseEthoraUrl}/v2/chats`;
         // Create chat room - API expects title, uuid, and type
         const payload = {
-            title: roomData?.title || `Chat Room ${workspaceId}`,
-            uuid: String(workspaceId),
-            type: roomData?.type || "group",
+            title: roomData?.title || `Chat Room ${chatId}`,
+            uuid: String(chatId), // Use chatId as uuid
+            type: roomData?.type || 'group',
             ...roomData, // Allow roomData to override fields if provided
         };
         logger.debug(`Chat service API URL: ${createUrl}`);
         logger.debug(`Request payload: ${JSON.stringify(payload)}`);
         return this.makeRequest({
-            method: "POST",
+            method: 'POST',
             url: createUrl,
             data: payload,
         });
@@ -209,32 +209,42 @@ class EthoraSDKService {
     /**
      * Grants a user access to a chat room
      *
-     * Uses plain userIds without prefixing (matching how users are created)
-     *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
      * @param userId - The unique identifier of the user (or array of user IDs)
      * @returns The API response
      */
-    async grantUserAccessToChatRoom(workspaceId, userId) {
-        logger.info(`Granting user(s) access to chat room for workspace ${workspaceId}`);
-        const chatName = this.createChatName(workspaceId, false);
-        // Use /v1/chats/users-access endpoint with chatName and members array
-        const grantUrl = `${this.baseEthoraUrl}/v1/chats/users-access`;
+    async grantUserAccessToChatRoom(chatId, userId) {
+        logger.info(`Granting user(s) access to chat room ${chatId}`);
+        const chatName = this.createChatName(chatId, false);
+        // Use /v2/chats/users-access endpoint with chatName and members array
+        const grantUrl = `${this.baseEthoraUrl}/v2/chats/users-access`;
         // Convert single userId to array if needed
-        // Use plain userIds without prefixing
+        // API requires usernames to start with appId, so prefix them
         const members = Array.isArray(userId)
-            ? userId.map((id) => String(id))
-            : [String(userId)];
+            ? userId.map((id) => {
+                const userIdStr = String(id);
+                // If userId doesn't start with appId, prefix it
+                return userIdStr.startsWith(this.secrets.chatAppId)
+                    ? userIdStr
+                    : `${this.secrets.chatAppId}_${userIdStr}`;
+            })
+            : [
+                (() => {
+                    const userIdStr = String(userId);
+                    return userIdStr.startsWith(this.secrets.chatAppId)
+                        ? userIdStr
+                        : `${this.secrets.chatAppId}_${userIdStr}`;
+                })(),
+            ];
         const payload = {
             chatName: chatName,
             members: members,
         };
         logger.debug(`Chat service API URL: ${grantUrl}`);
         logger.debug(`Request payload: ${JSON.stringify(payload)}`);
-        logger.debug(`Using XMPP usernames for members: ${members.join(", ")}`);
         try {
             return await this.makeRequest({
-                method: "POST",
+                method: 'POST',
                 url: grantUrl,
                 data: payload,
             });
@@ -243,8 +253,6 @@ class EthoraSDKService {
             if (axios_1.default.isAxiosError(error)) {
                 const errorData = error.response?.data;
                 logger.error(`Failed to grant user access. Status: ${error.response?.status}, Response: ${JSON.stringify(errorData)}`, error);
-                // Log the XMPP usernames that were attempted for debugging
-                logger.debug(`Attempted XMPP usernames: ${members.join(", ")}`);
             }
             throw error;
         }
@@ -252,20 +260,69 @@ class EthoraSDKService {
     /**
      * Grants chatbot access to a chat room
      *
-     * @param workspaceId - The unique identifier of the workspace
+     * @param chatId - The unique identifier of the chat
      * @returns The API response
      */
-    async grantChatbotAccessToChatRoom(workspaceId) {
-        logger.info(`Granting chatbot access to chat room for workspace ${workspaceId}`);
+    async grantChatbotAccessToChatRoom(chatId) {
+        logger.info(`Granting chatbot access to chat room ${chatId}`);
         if (!this.secrets.chatBotJid) {
-            const error = new Error("Chatbot JID not configured. Set ETHORA_CHAT_BOT_JID environment variable.");
-            logger.error("Cannot grant chatbot access", error);
+            const error = new Error('Chatbot JID not configured. Set ETHORA_CHAT_BOT_JID environment variable.');
+            logger.error('Cannot grant chatbot access', error);
             throw error;
         }
         // Extract username from JID (format: "username@domain" -> "username")
-        const chatbotUsername = this.secrets.chatBotJid.split("@")[0];
+        const chatbotUsername = this.secrets.chatBotJid.split('@')[0];
         // Use the same grant access method with chatbot JID
-        return this.grantUserAccessToChatRoom(workspaceId, chatbotUsername);
+        return this.grantUserAccessToChatRoom(chatId, chatbotUsername);
+    }
+    /**
+     * Removes a user's access to a chat room
+     *
+     * @param chatId - The unique identifier of the chat
+     * @param userId - The unique identifier of the user (or array of user IDs)
+     * @returns The API response
+     */
+    async removeUserAccessFromChatRoom(chatId, userId) {
+        logger.info(`Removing user(s) access from chat room ${chatId}`);
+        const chatName = this.createChatName(chatId, false);
+        // Use /v2/chats/usersAccess/remove DELETE endpoint (fallback to legacy /v2/chats/users-access)
+        const revokeUrl = `${this.baseEthoraUrl}/v2/chats/users-access`;
+        // Convert single userId to array if needed
+        const members = Array.isArray(userId)
+            ? userId.map((id) => {
+                const userIdStr = String(id);
+                return userIdStr.startsWith(this.secrets.chatAppId)
+                    ? userIdStr
+                    : `${this.secrets.chatAppId}_${userIdStr}`;
+            })
+            : [
+                (() => {
+                    const userIdStr = String(userId);
+                    return userIdStr.startsWith(this.secrets.chatAppId)
+                        ? userIdStr
+                        : `${this.secrets.chatAppId}_${userIdStr}`;
+                })(),
+            ];
+        const payload = {
+            chatName: chatName,
+            members: members,
+        };
+        logger.debug(`Chat service API URL: ${revokeUrl}`);
+        logger.debug(`Request payload: ${JSON.stringify(payload)}`);
+        try {
+            return await this.makeRequest({
+                method: 'DELETE',
+                url: revokeUrl,
+                data: payload,
+            });
+        }
+        catch (error) {
+            if (axios_1.default.isAxiosError(error)) {
+                const errorData = error.response?.data;
+                logger.error(`Failed to remove user access. Status: ${error.response?.status}, Response: ${JSON.stringify(errorData)}`, error);
+            }
+            throw error;
+        }
     }
     /**
      * Deletes users from the chat service
@@ -274,7 +331,7 @@ class EthoraSDKService {
      * @returns The API response
      */
     async deleteUsers(userIds) {
-        logger.info(`Attempting to delete users: ${userIds.join(", ")}`);
+        logger.info(`Attempting to delete users: ${userIds.join(', ')}`);
         const deleteUrl = `${this.baseEthoraUrl}/v1/users/batch`;
         const payload = {
             usersIdList: userIds.map((id) => String(id)),
@@ -283,7 +340,7 @@ class EthoraSDKService {
         logger.debug(`Request payload: ${JSON.stringify(payload)}`);
         try {
             return await this.makeRequest({
-                method: "DELETE",
+                method: 'DELETE',
                 url: deleteUrl,
                 data: payload,
             });
@@ -292,29 +349,29 @@ class EthoraSDKService {
             // Handle the case where users don't exist (422 with "not found")
             if (axios_1.default.isAxiosError(error) &&
                 error.response?.status === 422 &&
-                typeof error.response.data === "string" &&
-                error.response.data.includes("not found")) {
-                logger.info("No users to delete from the chat service. The request contained non-existent users.");
+                typeof error.response.data === 'string' &&
+                error.response.data.includes('not found')) {
+                logger.info('No users to delete from the chat service. The request contained non-existent users.');
                 return { ok: false };
             }
             throw error;
         }
     }
     /**
-     * Deletes a chat room from the chat service by its workspace ID
+     * Deletes a chat room from the chat service by its chat ID
      *
-     * This method sends a DELETE request to the Ethora API using the workspace ID
+     * This method sends a DELETE request to the Ethora API using the chat ID
      * to construct the chat name. It gracefully handles the case where the chat room
      * is already non-existent (422 Not Found).
      *
-     * @param workspaceId - The unique identifier of the workspace associated with the chat room
+     * @param chatId - The unique identifier of the chat associated with the chat room
      * @returns The JSON response from the chat service upon successful deletion or a success status if not found
      */
-    async deleteChatRoom(workspaceId) {
-        logger.info(`Attempting to delete chat room for workspace ID: ${workspaceId}`);
+    async deleteChatRoom(chatId) {
+        logger.info(`Attempting to delete chat room with ID: ${chatId}`);
         const deleteUrl = `${this.baseEthoraUrl}/v1/chats`;
         // We must use the short name when deleting the chat room
-        const chatName = this.createChatName(workspaceId, false);
+        const chatName = this.createChatName(chatId, false);
         const payload = {
             name: chatName,
         };
@@ -322,7 +379,7 @@ class EthoraSDKService {
         logger.debug(`Request payload: ${JSON.stringify(payload)}`);
         try {
             const response = await this.makeRequest({
-                method: "DELETE",
+                method: 'DELETE',
                 url: deleteUrl,
                 data: payload,
             });
@@ -336,10 +393,10 @@ class EthoraSDKService {
                 const responseText = axiosError.response?.data;
                 // Handle the case where the room does not exist (Ethora returns 422 with "not found" in body)
                 if (statusCode === 422 &&
-                    typeof responseText === "string" &&
-                    responseText.toLowerCase().includes("not found")) {
+                    typeof responseText === 'string' &&
+                    responseText.toLowerCase().includes('not found')) {
                     logger.warn(`Chat room '${chatName}' not found during deletion attempt (Ignored 422)`);
-                    return { ok: false, reason: "Chat room not found" };
+                    return { ok: false, reason: 'Chat room not found' };
                 }
             }
             // Re-throw if it's not a "not found" case
@@ -359,24 +416,39 @@ class EthoraSDKService {
      * - not-found: user was not found
      * - skipped: user update was skipped
      *
+     * Note: The API only accepts xmppUsername, firstName, lastName, username, and profileImage fields.
+     * Other fields will be filtered out automatically.
+     *
      * @param users - Array of user data to update (1-100 users)
      * @returns The API response with results array containing status for each user
      */
     async updateUsers(users) {
         // Validate user count limit
         if (users.length === 0) {
-            throw new Error("At least 1 user is required for update");
+            throw new Error('At least 1 user is required for update');
         }
         if (users.length > 100) {
-            throw new Error("Maximum 100 users allowed per update request");
+            throw new Error('Maximum 100 users allowed per update request');
         }
         logger.info(`Attempting to update ${users.length} user(s)`);
-        const updateUrl = `${this.baseEthoraUrl}/v1/chats/users`;
+        const updateUrl = `${this.baseEthoraUrl}/v2/chats/users`;
         // Remove userId from payload if present, as API doesn't accept it
         // API expects xmppUsername or other identifier fields instead
+        // Also filter to only include allowed fields: xmppUsername, firstName, lastName, username, profileImage
         const cleanedUsers = users.map((user) => {
             const { userId, ...rest } = user;
-            return rest;
+            const allowedFields = {};
+            if (rest.xmppUsername)
+                allowedFields.xmppUsername = rest.xmppUsername;
+            if (rest.firstName)
+                allowedFields.firstName = rest.firstName;
+            if (rest.lastName)
+                allowedFields.lastName = rest.lastName;
+            if (rest.username)
+                allowedFields.username = rest.username;
+            if (rest.profileImage)
+                allowedFields.profileImage = rest.profileImage;
+            return allowedFields;
         });
         const payload = {
             users: cleanedUsers,
@@ -384,7 +456,7 @@ class EthoraSDKService {
         logger.debug(`Chat service API URL: ${updateUrl}`);
         logger.debug(`Request payload: ${JSON.stringify(payload)}`);
         return this.makeRequest({
-            method: "PATCH",
+            method: 'PATCH',
             url: updateUrl,
             data: payload,
         });
@@ -399,11 +471,14 @@ class EthoraSDKService {
      *   - For 1-on-1 chats: use xmppUsernameA-xmppUsernameB format
      * - xmppUsername parameter: returns a specific user by XMPP username
      *
+     * Note: The xmppUsername query parameter may not be supported by the API yet.
+     * In that case, you can get all users and filter client-side.
+     *
      * @param params - Query parameters for filtering users (optional)
      * @returns The API response
      */
     async getUsers(params) {
-        const getUrl = `${this.baseEthoraUrl}/v1/chats/users`;
+        const getUrl = `${this.baseEthoraUrl}/v2/chats/users`;
         // Build query parameters
         const queryParams = [];
         if (params?.chatName) {
@@ -412,13 +487,13 @@ class EthoraSDKService {
         if (params?.xmppUsername) {
             queryParams.push(`xmppUsername=${encodeURIComponent(params.xmppUsername)}`);
         }
-        const urlWithParams = queryParams.length > 0 ? `${getUrl}?${queryParams.join("&")}` : getUrl;
+        const urlWithParams = queryParams.length > 0 ? `${getUrl}?${queryParams.join('&')}` : getUrl;
         logger.info(params
             ? `Getting users with params: ${JSON.stringify(params)}`
-            : "Getting all users of the app");
+            : 'Getting all users of the app');
         logger.debug(`Chat service API URL: ${urlWithParams}`);
         return this.makeRequest({
-            method: "GET",
+            method: 'GET',
             url: urlWithParams,
         });
     }
@@ -436,7 +511,7 @@ exports.EthoraSDKService = EthoraSDKService;
 let repositoryInstance = null;
 function getEthoraSDKService() {
     if (!repositoryInstance) {
-        logger.debug("Creating new EthoraSDKService instance");
+        logger.debug('Creating new EthoraSDKService instance');
         repositoryInstance = new EthoraSDKService();
     }
     return repositoryInstance;