playsocketjs 3.0.0 → 3.1.1

package/README.md

@@ -257,9 +257,10 @@ The callback signature is `callback(verified, code?, message?)` where `code` and
 |-------|-------------------|-------------|--------------|
 | `clientRegistered` | `clientId: string, customData: object` | Client registered with the server | - |
 | `clientRegistrationRequested` | `clientId: string, customData: object` | Client requests to register | Return `false` or rejection reason `string` to block |
-| `clientLeft` | `clientId: string` | Client disconnected from the server | - |
-| `clientJoinedRoom` | `clientId: string, roomId: string` | Client joined a room (clients can only leave by disconnecting) | - |
+| `clientDisconnected` | `clientId: string` | Client disconnected from the server | - |
+| `clientJoinedRoom` | `clientId: string, roomId: string` | Client joined a room | - |
 | `clientJoinRequested` | `clientId: string, roomId: string` | Client requests to join a room | Return `false` or rejection reason `string` to block |
+| `clientLeftRoom` | `clientId: string, roomId: string` | Client left a room | - |
 | `roomCreated` | `roomId: string` | Client created a room | - |
 | `roomDestroyed` | `roomId: string` | Room was destroyed (happens when all participants leave, unless room host is "server") | - |
 | `roomCreationRequested` | `{clientId: string, initialStorage: object}` | Room creation requested by client | Return `object` to override initial storage, `false` to deny |

package/dist/playsocket-client.js

@@ -2180,7 +2180,7 @@ class PlaySocket {
      */
     #createTimeout(name) {
         return new Promise((_, reject) =>
-            setTimeout(() => reject(new Error(`${name} timed out`)), TIMEOUT_MS)
+            setTimeout(() => reject(new Error(`${name} timed out.`)), TIMEOUT_MS)
         );
     }
 
@@ -2220,8 +2220,8 @@ class PlaySocket {
      * @returns {Promise} Resolves when connection is established
      */
     async init() {
-        if (this.#initialized) return Promise.reject(new Error("Already initialized"));
-        if (!this.#endpoint) return Promise.reject(new Error("No websocket endpoint provided"));
+        if (this.#initialized) return Promise.reject(new Error("Already initialized!"));
+        if (!this.#endpoint) return Promise.reject(new Error("No websocket endpoint provided!"));
         this.#triggerEvent("status", "Initializing...");
 
         // Connect to WS server
@@ -2400,7 +2400,7 @@ class PlaySocket {
         // Handle socket errors
         this.#socket.onerror = () => {
             this.#triggerEvent("error", "WebSocket error.");
-            if (this.#pendingConnect) this.#pendingConnect.reject(new Error("WebSocket error"));
+            if (this.#pendingConnect) this.#pendingConnect.reject(new Error("WebSocket error!"));
         };
 
         // Handle socket close & attempt reconnect
@@ -2467,7 +2467,7 @@ class PlaySocket {
      */
     #sendToServer(data) {
         if (!this.#socket || this.#socket?.readyState !== WebSocket.OPEN) {
-            console.warn(WARNING_PREFIX + "Cannot send message - not connected.");
+            console.warn(WARNING_PREFIX + "Failed to send message - not connected.");
             return;
         }
         try {
@@ -2486,8 +2486,8 @@ class PlaySocket {
      */
     async createRoom(initialStorage = {}, size) {
         if (!this.#initialized) {
-            this.#triggerEvent("error", "Cannot create room - not initialized");
-            return Promise.reject(new Error("Not initialized"));
+            this.#triggerEvent("error", "Failed to create room - not initialized");
+            return Promise.reject(new Error("Not initialized!"));
         }
 
         return Promise.race([
@@ -2513,8 +2513,8 @@ class PlaySocket {
      */
     async joinRoom(roomId) {
         if (!this.#initialized) {
-            this.#triggerEvent("error", "Cannot join room - not initialized");
-            return Promise.reject(new Error("Not initialized"));
+            this.#triggerEvent("error", "Failed to join room - not initialized");
+            return Promise.reject(new Error("Not initialized!"));
         }
 
         return Promise.race([
@@ -2543,7 +2543,7 @@ class PlaySocket {
      */
     updateStorage(key, type, value, updateValue) {
         if (!this.#inRoom) {
-            this.#triggerEvent("error", "Cannot update storage when not in a room.");
+            this.#triggerEvent("error", "Failed to update storage - not in a room.");
             return;
         }        if (this.#debug) console.log(LOG_PREFIX + `Property update for key ${key}, operation ${type}, value ${value} and updateValue ${updateValue}.`);
         const propUpdate = this.#crdtManager.updateProperty(key, type, value, updateValue);

package/dist/playsocket-server.js

@@ -2334,7 +2334,7 @@ class PlaySocketServer {
 
                         const newRoom = this.createRoom(data.initialStorage, data.size, ws.clientId); // Create room
 
-                        // Check if client/creator is still connected - abort if not
+                        // Check if client/creator is still connected and abort if not
                         if (!this.#clients.has(ws.clientId)) {
                             this.destroyRoom(newRoom.id);
                             if (this.#debug) console.log(`Room creation cancelled - client ${ws.clientId} disconnected during event callback.`);
@@ -2538,7 +2538,7 @@ class PlaySocketServer {
         this.#clientTokens.delete(ws.clientId);
         const roomId = this.#clientRooms.get(ws.clientId);
         if (roomId && this.#rooms[roomId]) this.#leaveRoom(ws.clientId, roomId);
-        this.#triggerEvent("clientDisconnected", ws.clientId, roomId);
+        this.#triggerEvent("clientDisconnected", ws.clientId);
     }
 
     /**
@@ -2547,7 +2547,7 @@ class PlaySocketServer {
      * @param {Function} callback - Callback function
      */
     onEvent(event, callback) {
-        const validEvents = ["clientRegistered", "clientRegistrationRequested", "clientDisconnected", "clientJoinedRoom", "clientJoinRequested", "roomCreated", "roomCreationRequested", "requestReceived", "storageUpdated", "storageUpdateRequested", "roomDestroyed"];
+        const validEvents = ["clientRegistered", "clientRegistrationRequested", "clientDisconnected", "clientJoinedRoom", "clientLeftRoom", "clientJoinRequested", "roomCreated", "roomCreationRequested", "requestReceived", "storageUpdated", "storageUpdateRequested", "roomDestroyed"];
         if (!validEvents.includes(event)) {
             console.warn(`Invalid PlaySocket event type "${event}"`);
             return;
@@ -2748,6 +2748,7 @@ class PlaySocketServer {
 
         room.participants = room.participants.filter(p => p !== clientId); // Remove client from room
         this.#clientRooms.delete(clientId);
+        this.#triggerEvent("clientLeftRoom", clientId, roomId); // Before potential room destruction to allow for accessing its data in callback
 
         if (room.participants.length === 0 && room.host !== "server") {
             this.destroyRoom(roomId); // Destroy room if now empty & not by server

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "playsocketjs",
-  "version": "3.0.0",
+  "version": "3.1.1",
   "description": "WebSocket wrapper for creating simple multiplayer systems with ease.",
   "type": "module",
   "module": "dist/playsocket-client.js",