@teneo-protocol/sdk 1.0.0

package/dist/managers/room-manager.js

@@ -0,0 +1,227 @@
+"use strict";
+/**
+ * RoomManager - Manages room state and operations
+ * Handles joining, leaving, and tracking rooms
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoomManager = void 0;
+const eventemitter3_1 = require("eventemitter3");
+const types_1 = require("../types");
+const events_1 = require("../types/events");
+const error_codes_1 = require("../types/error-codes");
+const validation_1 = require("../types/validation");
+class RoomManager extends eventemitter3_1.EventEmitter {
+    constructor(wsClient, logger) {
+        super();
+        this.rooms = new Map();
+        this.subscribedRooms = new Set();
+        this.wsClient = wsClient;
+        this.logger = logger;
+    }
+    /**
+     * Subscribes to a public room in the Teneo network.
+     * Validates room ID and sends subscribe message to the server.
+     * The actual subscription state is updated when the server confirms via room:subscribed event.
+     *
+     * @param roomId - The ID of the room to subscribe to
+     * @returns Promise that resolves when subscribed
+     * @throws {SDKError} If not connected to the network
+     * @throws {ValidationError} If roomId is empty or invalid
+     *
+     * @example
+     * ```typescript
+     * await roomManager.subscribeToRoom('general');
+     * console.log('Subscription request sent to general room');
+     * ```
+     */
+    async subscribeToRoom(roomId) {
+        if (!this.wsClient.isConnected) {
+            throw new events_1.SDKError("Not connected to Teneo network", error_codes_1.ErrorCode.NOT_CONNECTED);
+        }
+        // Validate room ID
+        const validatedRoomId = validation_1.RoomIdSchema.parse(roomId);
+        this.logger.info("RoomManager: Subscribing to room", { roomId: validatedRoomId });
+        const message = (0, types_1.createSubscribe)(validatedRoomId);
+        await this.wsClient.sendMessage(message);
+    }
+    /**
+     * Unsubscribes from a room in the Teneo network.
+     * Validates room ID and sends unsubscribe message to the server.
+     * The actual subscription state is updated when the server confirms via room:unsubscribed event.
+     *
+     * @param roomId - The ID of the room to unsubscribe from
+     * @returns Promise that resolves when unsubscribed
+     * @throws {SDKError} If not connected to the network
+     * @throws {ValidationError} If roomId is empty or invalid
+     *
+     * @example
+     * ```typescript
+     * await roomManager.unsubscribeFromRoom('general');
+     * console.log('Unsubscription request sent for general room');
+     * ```
+     */
+    async unsubscribeFromRoom(roomId) {
+        if (!this.wsClient.isConnected) {
+            throw new events_1.SDKError("Not connected to Teneo network", error_codes_1.ErrorCode.NOT_CONNECTED);
+        }
+        // Validate room ID
+        const validatedRoomId = validation_1.RoomIdSchema.parse(roomId);
+        this.logger.info("RoomManager: Unsubscribing from room", { roomId: validatedRoomId });
+        const message = (0, types_1.createUnsubscribe)(validatedRoomId);
+        await this.wsClient.sendMessage(message);
+    }
+    /**
+     * Updates the subscription state from server response.
+     * This is the authoritative source of which rooms you're subscribed to.
+     * Called internally when receiving subscribe/unsubscribe responses.
+     *
+     * @internal
+     * @param subscriptions - Array of room IDs from server response
+     *
+     * @example
+     * ```typescript
+     * // Internal SDK usage
+     * roomManager.updateSubscriptions(['general', 'support', 'trading']);
+     * ```
+     */
+    updateSubscriptions(subscriptions) {
+        this.subscribedRooms.clear();
+        subscriptions.forEach(roomId => this.subscribedRooms.add(roomId));
+        this.logger.debug("RoomManager: Subscriptions updated", {
+            count: subscriptions.length,
+            rooms: subscriptions
+        });
+    }
+    /**
+     * Gets all rooms currently subscribed to.
+     * Returns array of room IDs that you're actively listening to.
+     *
+     * @returns Array of subscribed room IDs
+     *
+     * @example
+     * ```typescript
+     * const rooms = roomManager.getSubscribedRooms();
+     * console.log(`Subscribed to ${rooms.length} rooms:`, rooms);
+     * ```
+     */
+    getSubscribedRooms() {
+        return Array.from(this.subscribedRooms);
+    }
+    /**
+     * Gets a list of all available rooms.
+     * Returns rooms the user has access to based on authentication.
+     * Returns a read-only array with defensive copies to prevent external modification.
+     *
+     * @returns Read-only array of room copies
+     *
+     * @example
+     * ```typescript
+     * const rooms = roomManager.getRooms();
+     * rooms.forEach(room => console.log(`${room.id}: ${room.name}`));
+     * ```
+     */
+    getRooms() {
+        return Array.from(this.rooms.values()).map((room) => ({ ...room }));
+    }
+    /**
+     * Gets a specific room by its ID.
+     * Returns a defensive copy to prevent external modification of room state.
+     * Returns undefined if room doesn't exist or user doesn't have access.
+     *
+     * @param roomId - The ID of the room to retrieve
+     * @returns Copy of the room object if found, undefined otherwise
+     *
+     * @example
+     * ```typescript
+     * const room = roomManager.getRoom('general');
+     * if (room) {
+     *   console.log(`Room: ${room.name}`);
+     *   console.log(`Members: ${room.members?.length ?? 0}`);
+     * }
+     * ```
+     */
+    getRoom(roomId) {
+        const room = this.rooms.get(roomId);
+        return room ? { ...room } : undefined;
+    }
+    /**
+     * Fetches the list of rooms from the server.
+     * Sends list_rooms message and waits for response from server.
+     * Returns array of rooms the user owns or has access to.
+     *
+     * @returns Promise that resolves to array of room information
+     * @throws {SDKError} If not connected to the network
+     *
+     * @example
+     * ```typescript
+     * const rooms = await roomManager.listRooms();
+     * rooms.forEach(room => {
+     *   console.log(`${room.name} (${room.is_public ? 'public' : 'private'})`);
+     *   console.log(`Owner: ${room.is_owner}`);
+     * });
+     * ```
+     */
+    async listRooms() {
+        if (!this.wsClient.isConnected) {
+            throw new events_1.SDKError("Not connected to Teneo network", error_codes_1.ErrorCode.NOT_CONNECTED);
+        }
+        this.logger.info("RoomManager: Listing rooms");
+        const message = (0, types_1.createListRooms)();
+        await this.wsClient.sendMessage(message);
+        // Room list will be received via list_rooms response handler
+        // For now, return empty array as this is async
+        // TODO: Implement response waiting mechanism
+        return [];
+    }
+    /**
+     * Updates the room list from authentication state.
+     * Called internally after successful authentication to populate accessible rooms.
+     *
+     * @internal This method is for internal SDK use
+     * @param rooms - Array of rooms to update in the manager
+     *
+     * @example
+     * ```typescript
+     * // Internal SDK usage after auth
+     * roomManager.updateRoomsFromAuth(authState.roomObjects);
+     * ```
+     */
+    updateRoomsFromAuth(rooms) {
+        this.logger.debug("RoomManager: Updating rooms from auth", { count: rooms.length });
+        for (const room of rooms) {
+            this.rooms.set(room.id, room);
+        }
+    }
+    /**
+     * Clears all rooms from the manager.
+     * Clears subscription state.
+     *
+     * @example
+     * ```typescript
+     * roomManager.clear();
+     * console.log('All rooms cleared');
+     * ```
+     */
+    clear() {
+        this.rooms.clear();
+        this.subscribedRooms.clear();
+    }
+    /**
+     * Destroys the room manager and cleans up resources.
+     * Clears all rooms and removes all event listeners.
+     * After destruction, the manager cannot be reused.
+     *
+     * @example
+     * ```typescript
+     * roomManager.destroy();
+     * console.log('Room manager destroyed');
+     * ```
+     */
+    destroy() {
+        this.logger.info("RoomManager: Destroying");
+        this.clear();
+        this.removeAllListeners();
+    }
+}
+exports.RoomManager = RoomManager;
+//# sourceMappingURL=room-manager.js.map

package/dist/managers/room-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"room-manager.js","sourceRoot":"","sources":["../../src/managers/room-manager.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAEH,iDAA6C;AAE7C,oCAAuG;AACvG,4CAAsD;AACtD,sDAAiD;AACjD,oDAAmD;AAEnD,MAAa,WAAY,SAAQ,4BAAuB;IAMtD,YAAY,QAAyB,EAAE,MAAc;QACnD,KAAK,EAAE,CAAC;QAJO,UAAK,GAAG,IAAI,GAAG,EAAgB,CAAC;QAChC,oBAAe,GAAG,IAAI,GAAG,EAAU,CAAC;QAInD,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC;IACvB,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,KAAK,CAAC,eAAe,CAAC,MAAc;QACzC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,iBAAQ,CAAC,gCAAgC,EAAE,uBAAS,CAAC,aAAa,CAAC,CAAC;QAChF,CAAC;QAED,mBAAmB;QACnB,MAAM,eAAe,GAAG,yBAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,kCAAkC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QAElF,MAAM,OAAO,GAAG,IAAA,uBAAe,EAAC,eAAe,CAAC,CAAC;QACjD,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACI,KAAK,CAAC,mBAAmB,CAAC,MAAc;QAC7C,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,iBAAQ,CAAC,gCAAgC,EAAE,uBAAS,CAAC,aAAa,CAAC,CAAC;QAChF,CAAC;QAED,mBAAmB;QACnB,MAAM,eAAe,GAAG,yBAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;QAEnD,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,sCAAsC,EAAE,EAAE,MAAM,EAAE,eAAe,EAAE,CAAC,CAAC;QAEtF,MAAM,OAAO,GAAG,IAAA,yBAAiB,EAAC,eAAe,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;IAC3C,CAAC;IAED;;;;;;;;;;;;;OAaG;IACI,mBAAmB,CAAC,aAAuB;QAChD,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;QAC7B,aAAa,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC;QAClE,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,oCAAoC,EAAE;YACtD,KAAK,EAAE,aAAa,CAAC,MAAM;YAC3B,KAAK,EAAE,aAAa;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;;;;;OAWG;IACI,kBAAkB;QACvB,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,QAAQ;QACb,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC;IACtE,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,OAAO,CAAC,MAAc;QAC3B,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACpC,OAAO,IAAI,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;IACxC,CAAC;IAED;;;;;;;;;;;;;;;;OAgBG;IACI,KAAK,CAAC,SAAS;QACpB,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC/B,MAAM,IAAI,iBAAQ,CAAC,gCAAgC,EAAE,uBAAS,CAAC,aAAa,CAAC,CAAC;QAChF,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;QAE/C,MAAM,OAAO,GAAG,IAAA,uBAAe,GAAE,CAAC;QAClC,MAAM,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,OAAO,CAAC,CAAC;QAEzC,6DAA6D;QAC7D,+CAA+C;QAC/C,6CAA6C;QAC7C,OAAO,EAAE,CAAC;IACZ,CAAC;IAED;;;;;;;;;;;;OAYG;IACI,mBAAmB,CAAC,KAAa;QACtC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uCAAuC,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;QAEpF,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;IACH,CAAC;IAED;;;;;;;;;OASG;IACI,KAAK;QACV,IAAI,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QACnB,IAAI,CAAC,eAAe,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED;;;;;;;;;;OAUG;IACI,OAAO;QACZ,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,yBAAyB,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,IAAI,CAAC,kBAAkB,EAAE,CAAC;IAC5B,CAAC;CACF;AA3OD,kCA2OC"}