playsocketjs 4.2.1 → 4.3.0

package/README.md

@@ -43,8 +43,7 @@ const socket = new PlaySocket("unique-client-id", {
 
 // Set up the event handlers you need
 socket.onEvent("status", status => console.log(status));
-socket.onEvent("error", error => console.error(error));
-...
+socket.onEvent("storageUpdated", storage => { /* ... */ });
 
 const clientId = await socket.init(); // Connect
 ```
@@ -128,7 +127,7 @@ new PlaySocket(id?: string, options: PlaySocketOptions)
 | `init()` | - | `Promise<string>` | Initialize the WebSocket connection, resolves with the client ID. |
 | `createRoom()` | `initialStorage?: object, size?: number` | `Promise<string>` | Create a new room, resolves with the room ID. Max. 500 participants. |
 | `joinRoom()` | `roomId: string` | `Promise<void>` | Join an existing room. |
-| `destroy()` | - | `void` | Leave room, close the connection, and destroy the instance. |
+| `destroy()` | `reason?: string` | `void` | Leave room, close the connection, and destroy the instance. |
 | `updateStorage()` | `key: string, type: string, value: any, secondValue?: any` | `void` | Update a key in the shared storage. |
 | `sendRequest()` | `name: string, data?: any` | `Promise<void>` | Send a request to the server with optional attached data. |
 | `onEvent()` | `event: string, callback: Function` | `() => void` | Register an event callback. Returns unsubscribe function. |
@@ -137,10 +136,9 @@ new PlaySocket(id?: string, options: PlaySocketOptions)
 
 | Event | Callback parameter | Description |
 |-------|-------------------|-------------|
-| `status` | `status: string` | Connection or room status updated. |
-| `error` | `error: string` | Error occurred. |
+| `status` | `status: string` | Connection or room status changed, e.g. display in UI during joining or room creation. |
 | `moved` | `roomId: string` | Moved to different room. |
-| `instanceDestroyed` | - | Instance destroyed through `destroy()` or fatal error. |
+| `instanceDestroyed` | `reason: string` | Instance destroyed through `destroy()` or error. |
 | `storageUpdated` | `storage: object` | Storage state changed. Does not trigger on no-op updates. |
 | `hostMigrated` | `roomId: string` | Host was changed. |
 | `clientJoined` | `clientId: string` | New client joined the room. |
@@ -196,7 +194,7 @@ const playSocketServer = new PlaySocketServer({
 
 // Start the server
 httpServer.listen(3000, () => {
-  console.log("Server running on port 3000");
+  console.log("Server running on port 3000.");
 });
 
 function shutdown() {
@@ -236,7 +234,7 @@ server.onEvent("requestReceived", async ({ roomId, clientId, name, data }) => {
         const players = server.getRoomStorage(roomId)?.players || [];
 
         // Returning false or string rejects sendRequest() on the client
-        if (players.find(p => p.id === clientId)) return "Player already added!";
+        if (players.find(p => p.id === clientId)) return "Player already added";
 
         server.updateRoomStorage(roomId, "players", "array-add", { id: clientId, timestamp: Date.now() });
     }
@@ -255,7 +253,7 @@ server.onEvent("clientRegistrationRequested", async (clientId, data) => {
         // For example, data could contain a token
         authedClients.push(clientId);
     } catch (error) {
-        return "Error occurred during auth."; // Blocks the registration
+        return "Error occurred during auth"; // Blocks the registration
     }
 });
 
@@ -295,7 +293,7 @@ const server = new PlaySocketServer({
         const forwarded = info.req.headers["x-forwarded-for"];
         const ip = forwarded ? forwarded.split(",")[0].trim() : info.req.socket.remoteAddress;
         if (isRateLimited(ip)) {
-            return callback(false, 429, "Too Many Requests");
+            return callback(false, 429, "Too many requests");
         }
         callback(true);
     }

package/package.json

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

package/src/client/client.js

@@ -1,10 +1,7 @@
 import { encode, decode } from "@msgpack/msgpack";
 import CRDTManager from "../universal/crdtManager.js";
-import { VERSION } from "../universal/constants.js";
+import { VERSION, ERROR_PREFIX, WARNING_PREFIX, LOG_PREFIX } from "../universal/constants.js";
 
-const ERROR_PREFIX = "PlaySocket error: ";
-const WARNING_PREFIX = "PlaySocket warning: ";
-const LOG_PREFIX = "PlaySocket log: ";
 const TIMEOUT_MS = 3000; // 3 second timeout for WS messages
 
 /** @typedef {import("../universal/crdtManager.js").PropertyUpdateType} PropertyUpdateType */
@@ -96,7 +93,7 @@ export default 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)
         );
     }
 
@@ -107,9 +104,9 @@ export default class PlaySocket {
      * @returns {Function} - Unsubscribe
      */
     onEvent(event, callback) {
-        const validEvents = ["status", "error", "moved", "instanceDestroyed", "storageUpdated", "hostMigrated", "clientJoined", "clientLeft"];
+        const validEvents = ["status", "moved", "instanceDestroyed", "storageUpdated", "hostMigrated", "clientJoined", "clientLeft"];
         if (!validEvents.includes(event)) {
-            console.warn(WARNING_PREFIX + `Invalid event type "${event}".`);
+            console.warn(WARNING_PREFIX + `Invalid event type ${event}`);
             return () => { };
         };
         if (!this.#callbacks.has(event)) this.#callbacks.set(event, []);
@@ -145,9 +142,9 @@ export default class PlaySocket {
      * @returns {Promise<string>} Resolves with the client ID when the connection is established
      */
     async init() {
-        if (this.#initialized) throw new Error("Already initialized!");
-        if (!this.#endpoint) throw new Error("No websocket endpoint provided!");
-        this.#triggerEvent("status", "Initializing...");
+        if (this.#initialized) throw new Error("Already initialized");
+        if (!this.#endpoint) throw new Error("No websocket endpoint provided");
+        this.#triggerEvent("status", "Initializing.");
 
         // Connect to WS server
         await this.#connect();
@@ -205,8 +202,7 @@ export default class PlaySocket {
 
                 switch (message.type) {
                     case "registration_failed":
-                        this.#triggerEvent("error", "Failed to register: " + (message.reason || "No reason provided."));
-                        if (this.#pendingRegistration) this.#pendingRegistration.reject(new Error("Failed to register: " + (message.reason || "No reason provided.")));
+                        if (this.#pendingRegistration) this.#pendingRegistration.reject(new Error("Failed to register: " + (message.reason || "No reason provided")));
                         break;
 
                     case "registered":
@@ -234,8 +230,8 @@ export default class PlaySocket {
                         break;
 
                     case "join_rejected":
-                        this.#triggerEvent("status", "Failed to join room: " + (message.reason || "No reason provided."));
-                        if (this.#pendingJoin) this.#pendingJoin.reject(new Error("Failed to join room: " + (message.reason || "No reason provided.")));
+                        this.#triggerEvent("status", "Failed to join room: " + (message.reason || "No reason provided"));
+                        if (this.#pendingJoin) this.#pendingJoin.reject(new Error("Failed to join room: " + (message.reason || "No reason provided")));
                         break;
 
                     case "reconnected":
@@ -249,9 +245,8 @@ export default class PlaySocket {
                             this.#setHost(message.roomData.host); // Set host before in case there are .isHost checks in the storageUpdate fallback
                             this.#triggerEvent("storageUpdated", this.storage);
                         } else if (this.#inRoom) {
-                            // If no room data received, but client thinks they were in a room...
-                            this.#triggerEvent("error", "Reconnected, but room no longer exists.");
-                            return this.destroy();
+                            // If no room data was received, but client thinks they are in a room
+                            return this.destroy("Reconnected, but room no longer exists.");
                         }
                         this.#triggerEvent("status", "Reconnected.");
                         if (this.#pendingReconnect) this.#pendingReconnect.resolve();
@@ -271,8 +266,7 @@ export default class PlaySocket {
                         break;
 
                     case "room_creation_failed":
-                        this.#triggerEvent("error", "Failed to create room: " + (message.reason || "No reason provided."));
-                        if (this.#pendingCreate) this.#pendingCreate.reject(new Error("Failed to create room: " + (message.reason || "No reason provided.")));
+                        if (this.#pendingCreate) this.#pendingCreate.reject(new Error("Failed to create room: " + (message.reason || "No reason provided")));
                         break;
 
                     case "property_updated":
@@ -281,20 +275,19 @@ export default class PlaySocket {
                         this.#crdtManager.importPropertyUpdate(message.update);
                         if (this.#crdtManager.didPropertiesChange) this.#triggerEvent("storageUpdated", this.storage);
                         if (this.#roomVersion != message.version && this.#initialized && this.#socket?.readyState === WebSocket.OPEN) {
-                            this.#triggerEvent("error", "Detected skipped update – forcing reconnect.");
+                            console.error(ERROR_PREFIX + "Detected skipped property update, forcing reconnect");
                             this.#socket?.close();
                         }
                         break;
 
                     case "property_update_rejected":
-                        this.#triggerEvent("error", "Property update rejected, reverting: " + (message.reason || "No reason provided."));
+                        console.warn(LOG_PREFIX + "Property update rejected: " + (message.reason || "No reason provided"));
                         this.#crdtManager.revertPropertyUpdate(message.update);
                         if (this.#crdtManager.didPropertiesChange) this.#triggerEvent("storageUpdated", this.storage);
                         break;
 
                     case "kicked":
-                        this.#triggerEvent("error", `Kicked out of room: ${message.reason || "No reason provided."}`);
-                        this.destroy();
+                        this.destroy(`Kicked out of room: ${message.reason || "No reason provided"}`);
                         break;
 
                     case "host_migrated":
@@ -318,7 +311,7 @@ export default class PlaySocket {
                         break;
 
                     case "request_failed":
-                        this.#pendingRequests.get(message.request.uuid)?.reject(new Error(message.reason || "No reason provided."));
+                        this.#pendingRequests.get(message.request.uuid)?.reject(new Error(message.reason || "No reason provided"));
                         break;
                 }
             } catch (error) {
@@ -328,8 +321,7 @@ export default 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
@@ -347,12 +339,11 @@ export default class PlaySocket {
     async #attemptReconnect() {
         this.#reconnectCount++;
         if (this.#reconnectCount > 9) {
-            this.#triggerEvent("error", "Disconnected from server.");
-            this.destroy();
+            this.destroy("Disconnected, reconnection failed.");
             return;
         }
 
-        this.#triggerEvent("status", `Attempting to reconnect... (${this.#reconnectCount})`);
+        this.#triggerEvent("status", `Trying to reconnect: Attempt ${this.#reconnectCount}`);
         this.#isReconnecting = true;
         try {
             await this.#connect();
@@ -393,14 +384,13 @@ export default class PlaySocket {
      */
     #sendToServer(data) {
         if (!this.#socket || this.#socket?.readyState !== WebSocket.OPEN) {
-            console.warn(WARNING_PREFIX + "Failed to send message - not connected.");
+            console.warn(WARNING_PREFIX + "Failed to send message, not connected");
             return;
         }
         try {
             this.#socket.send(encode(data));
         } catch (error) {
             console.error(ERROR_PREFIX + "Error sending message:", error);
-            this.#triggerEvent("error", "Error sending message: " + error.message);
         }
     }
 
@@ -411,10 +401,7 @@ export default class PlaySocket {
      * @returns {Promise<string>} Resolves with room ID
      */
     async createRoom(initialStorage = {}, size) {
-        if (!this.#initialized) {
-            this.#triggerEvent("error", "Failed to create room - not initialized");
-            throw new Error("Not initialized!");
-        }
+        if (!this.#initialized) throw new Error("Not initialized");
 
         return /** @type {Promise<string>} */ (Promise.race([
             new Promise((resolve, reject) => {
@@ -438,17 +425,14 @@ export default class PlaySocket {
      * @returns {Promise<void>} - Resolves when connected
      */
     async joinRoom(roomId) {
-        if (!this.#initialized) {
-            this.#triggerEvent("error", "Failed to join room - not initialized");
-            throw new Error("Not initialized!");
-        }
+        if (!this.#initialized) throw new Error("Not initialized");
 
         return /** @type {Promise<void>} */ (Promise.race([
             new Promise((resolve, reject) => {
                 this.#pendingJoin = { resolve, reject };
 
                 // Send connection request
-                this.#triggerEvent("status", `Connecting to room ${roomId}...`);
+                this.#triggerEvent("status", `Connecting to room ${roomId}.`);
                 this.#sendToServer({
                     type: "join_room",
                     roomId
@@ -469,10 +453,10 @@ export default class PlaySocket {
      */
     updateStorage(key, type, value, secondValue) {
         if (!this.#inRoom) {
-            this.#triggerEvent("error", "Failed to update storage - not in a room.");
+            console.error(ERROR_PREFIX + "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 secondValue ${secondValue}.`);
+        if (this.#debug) console.log(LOG_PREFIX + `Property update for key ${key}, operation ${type}, value ${value} and secondValue ${secondValue}`);
         const propUpdate = this.#crdtManager.updateProperty(key, type, value, secondValue);
         this.#sendToServer({
             type: "update_property",
@@ -488,10 +472,8 @@ export default class PlaySocket {
      * @returns {Promise<void>} - Request promise
      */
     async sendRequest(name, data) {
-        if (!this.#initialized) {
-            this.#triggerEvent("error", "Failed to send request - not initialized");
-            throw new Error("Not initialized!");
-        }
+        if (!this.#initialized) throw new Error("Not initialized");
+
         if (this.#debug) console.log(LOG_PREFIX + `Server request with name ${name} and data:`, data);
         const uuid = crypto.randomUUID();
         return /** @type {Promise<void>} */ (Promise.race([
@@ -511,8 +493,9 @@ export default class PlaySocket {
 
     /**
      * Destroy the PlaySocket instance and disconnect
+     * @param {string} [reason] - Optional reason
      */
-    destroy() {
+    destroy(reason) {
         this.#initialized = false; // Set this immediately to prevent automatic reconnection
 
         if (this.#socket) {
@@ -526,7 +509,7 @@ export default class PlaySocket {
 
             // Trigger events
             this.#triggerEvent("status", "Destroyed.");
-            this.#triggerEvent("instanceDestroyed");
+            this.#triggerEvent("instanceDestroyed", reason);
         }
 
         // Reset state
@@ -539,13 +522,13 @@ export default class PlaySocket {
         this.#roomVersion = 0;
 
         // Reject pending promises if currently active
-        if (this.#pendingJoin) this.#pendingJoin.reject(new Error("Destroyed."));
-        if (this.#pendingCreate) this.#pendingCreate.reject(new Error("Destroyed."));
-        if (this.#pendingRegistration) this.#pendingRegistration.reject(new Error("Destroyed."));
-        if (this.#pendingConnect) this.#pendingConnect.reject(new Error("Destroyed."));
-        if (this.#pendingReconnect) this.#pendingReconnect.reject(new Error("Destroyed."));
+        if (this.#pendingJoin) this.#pendingJoin.reject(new Error("Destroyed"));
+        if (this.#pendingCreate) this.#pendingCreate.reject(new Error("Destroyed"));
+        if (this.#pendingRegistration) this.#pendingRegistration.reject(new Error("Destroyed"));
+        if (this.#pendingConnect) this.#pendingConnect.reject(new Error("Destroyed"));
+        if (this.#pendingReconnect) this.#pendingReconnect.reject(new Error("Destroyed"));
         this.#pendingRequests.forEach((request) => {
-            request.reject(new Error("Destroyed."));
+            request.reject(new Error("Destroyed"));
         });
     }
 

package/src/server/server.js

@@ -2,7 +2,7 @@ import { WebSocketServer } from "ws";
 import { createServer } from "node:http";
 import { encode, decode } from "@msgpack/msgpack";
 import CRDTManager, { getUpdateDetails } from "../universal/crdtManager.js";
-import { HEARTBEAT_INTERVAL, VERSION } from "../universal/constants.js";
+import { HEARTBEAT_INTERVAL, VERSION, ERROR_PREFIX, WARNING_PREFIX, LOG_PREFIX } from "../universal/constants.js";
 
 const MAX_ROOM_SIZE = 500;
 export const RECONNECT_GRACE_PERIOD = 5000; // Exported for use in tests
@@ -85,7 +85,7 @@ export default class PlaySocketServer {
             this.#ownsServer = true;
             this.#server = createServer(); // Create HTTP server and start it
             this.#server.listen(port, () => {
-                console.log(`PlaySocket server running on port ${port}.`);
+                console.log(LOG_PREFIX + `Server running on port ${port}`);
             });
         }
 
@@ -104,13 +104,13 @@ export default class PlaySocketServer {
             ws.on("message", msg => this.#handleMessage(ws, msg));
             ws.on("close", () => this.#handleDisconnection(ws));
             ws.on("error", (error) => {
-                console.error(`PlaySocket WebSocket connection error for client ${ws.clientId || "unknown"}:`, error); // Catch conn errors
+                console.error(ERROR_PREFIX + `WebSocket connection error for client ${ws.clientId || "unknown"}:`, error); // Catch conn errors
             });
         });
 
         // Log & catch server-level errors
         this.#wss.on("error", (error) => {
-            console.error("PlaySocket WebSocket server error:", error);
+            console.error(ERROR_PREFIX + "WebSocket server error:", error);
         });
 
         // Start heartbeat
@@ -138,7 +138,7 @@ export default class PlaySocketServer {
                 if (!ws.isTerminating) {
                     ws.isTerminating = true; // Prevent multiple terminate calls (it is async)
                     ws.terminate();
-                    console.error(`PlaySocket connection ${ws.uuid} terminated due to rate limit violations.`);
+                    console.error(ERROR_PREFIX + `Connection ${ws.uuid} terminated due to rate limit violations`);
                     return;
                 }
             }
@@ -147,13 +147,13 @@ export default class PlaySocketServer {
                 case "register": {
                     // Ensure client uses the same version as server
                     if (data.version !== VERSION) {
-                        ws.send(encode({ type: "registration_failed", reason: `Version mismatch (client ${data.version ? "v" + data.version : "legacy"}, server v${VERSION}). Please reload the page, an update may have been released.` }), { binary: true });
+                        ws.send(encode({ type: "registration_failed", reason: `Version mismatch (client ${data.version ? "v" + data.version : "legacy"}, server v${VERSION}), please reload the page` }), { binary: true });
                         return;
                     }
 
                     // Register client ID if provided & check for a duplicate
                     if (data.id && (this.#clients.get(data.id) || data.id === "server")) {
-                        ws.send(encode({ type: "registration_failed", reason: "ID is taken." }), { binary: true });
+                        ws.send(encode({ type: "registration_failed", reason: "ID is taken" }), { binary: true });
                         return;
                     }
 
@@ -167,8 +167,8 @@ export default class PlaySocketServer {
                             }
                         }
                         if (!data.id) {
-                            ws.send(encode({ type: "registration_failed", reason: "No available ID found." }), { binary: true });
-                            throw new Error("Failed to generate unique ID!");
+                            ws.send(encode({ type: "registration_failed", reason: "No available ID found" }), { binary: true });
+                            throw new Error("Failed to generate unique ID");
                         }
                     }
 
@@ -198,7 +198,7 @@ export default class PlaySocketServer {
                         if (data.sessionToken !== this.#clientTokens.get(data.id)) {
                             ws.send(encode({
                                 type: "reconnection_failed",
-                                reason: "Session token does not match."
+                                reason: "Session token does not match"
                             }), { binary: true });
                             return;
                         }
@@ -216,7 +216,7 @@ export default class PlaySocketServer {
                         if (formerRoom) {
                             // If the room has no host (they were the only one and disconnected), restore them as host
                             if (formerRoom.host === null) formerRoom.host = data.id;
-                            if (this.#debug) console.log(`State sent for reconnection for room ${formerRoomId}:`, formerRoom.crdtManager.state);
+                            if (this.#debug) console.log(LOG_PREFIX + `State sent for reconnection for room ${formerRoomId}:`, formerRoom.crdtManager.state);
                             roomData = {
                                 state: formerRoom.crdtManager.state,
                                 participantCount: formerRoom.participants.length,
@@ -227,7 +227,7 @@ export default class PlaySocketServer {
 
                         ws.send(encode({ type: "reconnected", roomData }), { binary: true });
                     } else {
-                        ws.send(encode({ type: "reconnection_failed", reason: "Client unknown to server." }), { binary: true });
+                        ws.send(encode({ type: "reconnection_failed", reason: "Client unknown to server" }), { binary: true });
                     }
                     break;
                 }
@@ -238,7 +238,7 @@ export default class PlaySocketServer {
                     if (this.#clientRooms.get(ws.clientId)) {
                         ws.send(encode({
                             type: "room_creation_failed",
-                            reason: "Already in a room."
+                            reason: "Already in a room"
                         }), { binary: true });
                         return;
                     }
@@ -254,7 +254,7 @@ export default class PlaySocketServer {
                     try {
                         // Verify client is still connected and abort if not
                         if (!this.#clients.has(ws.clientId)) {
-                            if (this.#debug) console.log(`Room creation cancelled - client ${ws.clientId} disconnected during event callback.`);
+                            if (this.#debug) console.log(LOG_PREFIX + `Room creation cancelled, client ${ws.clientId} disconnected during event callback`);
                             return;
                         }
 
@@ -264,7 +264,7 @@ export default class PlaySocketServer {
                         this.#clientRooms.set(ws.clientId, newRoom.id); // Add client to the client-room map
                         ws.send(encode({ type: "room_created", state: newRoom.state, roomId: newRoom.id, participantCount: this.#rooms[newRoom.id].participants.length }), { binary: true });
                     } catch (error) {
-                        console.error("PlaySocket error creating room:", error);
+                        console.error(ERROR_PREFIX + "Error creating room:", error);
                         ws.send(encode({ type: "room_creation_failed", reason: error.message }), { binary: true });
                     }
                     break;
@@ -285,7 +285,7 @@ export default class PlaySocketServer {
 
                     // Verify client is still connected and abort if not
                     if (!this.#clients.has(ws.clientId)) {
-                        if (this.#debug) console.log(`Room join cancelled - client ${ws.clientId} disconnected during event callback.`);
+                        if (this.#debug) console.log(LOG_PREFIX + `Room join cancelled, client ${ws.clientId} disconnected during event callback`);
                         return;
                     }
 
@@ -332,7 +332,7 @@ export default class PlaySocketServer {
                         });
 
                         this.#triggerEvent("storageUpdated", { roomId, clientId: ws.clientId, update: structuredClone(data.update), storage: this.getRoomStorage(roomId) });
-                        if (this.#debug) console.log("Property update received and imported:", data.update);
+                        if (this.#debug) console.log(LOG_PREFIX + "Property update received and imported:", data.update);
                     }
                     break;
                 }
@@ -352,7 +352,7 @@ export default class PlaySocketServer {
                     break;
             }
         } catch (error) {
-            console.error("PlaySocket error in message handler:", error);
+            console.error(ERROR_PREFIX + "Error in message handler:", error);
         }
     }
 
@@ -372,8 +372,8 @@ export default class PlaySocketServer {
      */
     #migrateHost(roomId, clientId) {
         const room = this.#rooms[roomId];
-        if (!room) throw new Error("Room not found.");
-        if (room.host !== clientId) throw new Error("Client is not the host.");
+        if (!room) throw new Error("Room not found");
+        if (room.host !== clientId) throw new Error("Client is not the host");
 
         const remainingParticipants = room.participants.filter(p => p !== clientId);
 
@@ -476,7 +476,7 @@ export default class PlaySocketServer {
     onEvent(event, callback) {
         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}"`);
+            console.warn(WARNING_PREFIX + `Invalid event type ${event}`);
             return () => { };
         };
         if (!this.#callbacks.has(event)) this.#callbacks.set(event, []);
@@ -508,13 +508,13 @@ export default class PlaySocketServer {
                 if (typeof result?.then === "function") {
                     if (syncOnlyEvents.includes(event)) {
                         result.catch(() => { });
-                        console.error(`PlaySocket ${event} callbacks must be synchronous.`);
+                        console.error(ERROR_PREFIX + `${event} callbacks must be synchronous`);
                         result = `${event} callback must be synchronous.`; // Rejection string to explicitly block this practice
                     } else result = await result;
                 }
                 if (firstResult == null && result != null) firstResult = result;
             } catch (error) {
-                console.error(`PlaySocket ${event} callback error:`, error);
+                console.error(ERROR_PREFIX + `${event} callback error:`, error);
                 if (firstResult == null) firstResult = false; // Fail closed (false blocks for most events)
             }
         }
@@ -544,12 +544,12 @@ export default class PlaySocketServer {
         const oldRoomId = this.#clientRooms.get(clientId);
         const oldRoom = this.#rooms[oldRoomId];
         const targetRoom = this.#rooms[roomId];
-        if (!client && !this.#pendingDisconnects.has(clientId)) throw new Error("Client not found.");
-        if (!oldRoomId) throw new Error("Client is not in a room.");
-        if (!oldRoom) throw new Error("Client room not found.");
-        if (oldRoomId === roomId) throw new Error("Client is already in target room.");
-        if (!targetRoom) throw new Error("Target room not found.");
-        if (targetRoom.participants.length >= targetRoom.size) throw new Error("Target room is full.");
+        if (!client && !this.#pendingDisconnects.has(clientId)) throw new Error("Client not found");
+        if (!oldRoomId) throw new Error("Client is not in a room");
+        if (!oldRoom) throw new Error("Client room not found");
+        if (oldRoomId === roomId) throw new Error("Client is already in target room");
+        if (!targetRoom) throw new Error("Target room not found");
+        if (targetRoom.participants.length >= targetRoom.size) throw new Error("Target room is full");
         if (oldRoom.host === clientId) this.#migrateHost(oldRoomId, clientId);
         this.#leaveRoom(clientId, oldRoomId);
         this.#joinRoom(clientId, roomId);
@@ -583,7 +583,7 @@ export default class PlaySocketServer {
      * @param {*} [secondValue] - Second value (needed for some operations)
      */
     updateRoomStorage(roomId, key, type, value, secondValue) {
-        if (this.#debug) console.log(`Playsocket server property update for room ${roomId}, key ${key}, operation ${type}, value ${value} and secondValue ${secondValue}.`);
+        if (this.#debug) console.log(LOG_PREFIX + `Property update for room ${roomId}, key ${key}, operation ${type}, value ${value} and secondValue ${secondValue}`);
         const room = this.#rooms[roomId];
         if (room) {
             const propertyUpdate = room.crdtManager.updateProperty(key, type, value, secondValue);
@@ -622,7 +622,7 @@ export default class PlaySocketServer {
             }
         }
 
-        if (!newRoomId) throw new Error("No available ID found.");
+        if (!newRoomId) throw new Error("No available ID found");
         const roomCrdtManager = new CRDTManager(this.#debug);
 
         if (initialStorage) Object.entries(initialStorage)?.forEach(([key, value]) => {
@@ -638,7 +638,7 @@ export default class PlaySocketServer {
         };
 
         this.#triggerEvent("roomCreated", newRoomId);
-        if (this.#debug) console.log(`Room ${newRoomId} created with initial storage:`, initialStorage);
+        if (this.#debug) console.log(LOG_PREFIX + `Room ${newRoomId} created with initial storage:`, initialStorage);
         return { state: roomCrdtManager.state, id: newRoomId };
     }
 
@@ -650,17 +650,17 @@ export default class PlaySocketServer {
     #joinRoom(clientId, roomId) {
         const room = this.#rooms[roomId];
         const client = this.#clients.get(clientId);
-        if (!room) throw new Error("Room not found.");
-        if (!client && !this.#pendingDisconnects.has(clientId)) throw new Error("Client not found.");
-        if (this.#clientRooms.get(clientId)) throw new Error("Already in a room.");
-        if (room.participants.length >= room.size) throw new Error("Room full.");
+        if (!room) throw new Error("Room not found");
+        if (!client && !this.#pendingDisconnects.has(clientId)) throw new Error("Client not found");
+        if (this.#clientRooms.get(clientId)) throw new Error("Already in a room");
+        if (room.participants.length >= room.size) throw new Error("Room full");
 
         room.participants.push(clientId);
         this.#clientRooms.set(clientId, roomId);
 
         // Notify joiner with initial storage (only if connected - pending disconnect clients get state on reconnect)
         if (client) {
-            if (this.#debug) console.log("Room state sent for join:", room.crdtManager.state);
+            if (this.#debug) console.log(LOG_PREFIX + "Room state sent for join:", room.crdtManager.state);
             client.send(encode({
                 type: "join_accepted",
                 roomId,
@@ -706,7 +706,7 @@ export default class PlaySocketServer {
      */
     #leaveRoom(clientId, roomId) {
         const room = this.#rooms[roomId];
-        if (!room) throw new Error("Room not found.");
+        if (!room) throw new Error("Room not found");
 
         room.participants = room.participants.filter(p => p !== clientId); // Remove client from room
         this.#clientRooms.delete(clientId);
@@ -733,19 +733,19 @@ export default class PlaySocketServer {
      */
     destroyRoom(roomId) {
         const room = this.#rooms[roomId];
-        if (!room) throw new Error("Room not found.");
+        if (!room) throw new Error("Room not found");
 
         // Disconnect clients if still in room
         const participants = room.participants;
         participants.forEach((clientId) => {
-            this.kick(clientId, "Room destroyed by server.");
+            this.kick(clientId, "Room destroyed by server");
         });
 
         // Delete the room
         delete this.#rooms[roomId];
         this.#roomVersions.delete(roomId); // Delete room version (used to ensure all clients are up-2-date)
         this.#triggerEvent("roomDestroyed", roomId);
-        if (this.#debug) console.log("Deleted room with id " + roomId + ".");
+        if (this.#debug) console.log(LOG_PREFIX + "Deleted room with id " + roomId);
     }
 
     /**
@@ -754,10 +754,10 @@ export default class PlaySocketServer {
     stop() {
         clearInterval(this.#heartbeatInterval);
         if (this.#wss) {
-            this.#clients.forEach((client, clientId) => this.kick(clientId, "Server restart."));
+            this.#clients.forEach((client, clientId) => this.kick(clientId, "Server restart"));
             this.#wss.close();
         }
-        if (this.#server && this.#ownsServer) this.#server.close(() => { console.log("PlaySocket server stopped."); });
+        if (this.#server && this.#ownsServer) this.#server.close(() => { console.log(LOG_PREFIX + "Server stopped"); });
         this.#pendingDisconnects.forEach((data) => {
             clearTimeout(data.timeout);
         });

package/src/universal/constants.js

@@ -9,4 +9,11 @@ export const HEARTBEAT_INTERVAL = 5000;
 /**
  * Library version, must match package.json
  */
-export const VERSION = "4.2.1";
+export const VERSION = "4.3.0";
+
+/**
+ * Logging prefixes
+ */
+export const ERROR_PREFIX = "PlaySocket error: ";
+export const WARNING_PREFIX = "PlaySocket warning: ";
+export const LOG_PREFIX = "PlaySocket log: ";

package/types/client/client.d.ts

@@ -88,8 +88,9 @@ export default class PlaySocket {
     sendRequest(name: string, data?: any): Promise<void>;
     /**
      * Destroy the PlaySocket instance and disconnect
+     * @param {string} [reason] - Optional reason
      */
-    destroy(): void;
+    destroy(reason?: string): void;
     get participantCount(): number;
     get storage(): Record<string, any>;
     get isHost(): boolean;

package/types/universal/constants.d.ts

@@ -8,4 +8,10 @@ export declare const HEARTBEAT_INTERVAL = 5000;
 /**
  * Library version, must match package.json
  */
-export declare const VERSION = "4.2.1";
+export declare const VERSION = "4.3.0";
+/**
+ * Logging prefixes
+ */
+export declare const ERROR_PREFIX = "PlaySocket error: ";
+export declare const WARNING_PREFIX = "PlaySocket warning: ";
+export declare const LOG_PREFIX = "PlaySocket log: ";