playsocketjs 3.0.0 → 3.1.0

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-server.js

@@ -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.0",
   "description": "WebSocket wrapper for creating simple multiplayer systems with ease.",
   "type": "module",
   "module": "dist/playsocket-client.js",