@colyseus/core 0.16.0-preview.9 → 0.16.0

package/build/Room.js

@@ -17,6 +17,10 @@ var __copyProps = (to, from, except, desc) => {
   return to;
 };
 var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
   isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
   mod
 ));
@@ -28,19 +32,20 @@ __export(Room_exports, {
   RoomInternalState: () => RoomInternalState
 });
 module.exports = __toCommonJS(Room_exports);
-var import_msgpackr = require("msgpackr");
+var import_msgpackr = require("@colyseus/msgpackr");
 var import_schema = require("@colyseus/schema");
-var import_timer = __toESM(require("@gamestdio/timer"));
+var import_timer = __toESM(require("@colyseus/timer"));
 var import_events = require("events");
-var import_Logger = require("./Logger");
-var import_NoneSerializer = require("./serializer/NoneSerializer");
-var import_SchemaSerializer = require("./serializer/SchemaSerializer");
+var import_Logger = require("./Logger.js");
+var import_NoneSerializer = require("./serializer/NoneSerializer.js");
+var import_SchemaSerializer = require("./serializer/SchemaSerializer.js");
 var import_Protocol = require("./Protocol");
-var import_Utils = require("./utils/Utils");
-var import_DevMode = require("./utils/DevMode");
-var import_Debug = require("./Debug");
-var import_ServerError = require("./errors/ServerError");
+var import_Utils = require("./utils/Utils.js");
+var import_DevMode = require("./utils/DevMode.js");
+var import_Debug = require("./Debug.js");
+var import_ServerError = require("./errors/ServerError.js");
 var import_Transport = require("./Transport");
+var import_RoomExceptions = require("./errors/RoomExceptions.js");
 const DEFAULT_PATCH_RATE = 1e3 / 20;
 const DEFAULT_SIMULATION_INTERVAL = 1e3 / 60;
 const noneSerializer = new import_NoneSerializer.NoneSerializer();
@@ -53,131 +58,308 @@ var RoomInternalState = /* @__PURE__ */ ((RoomInternalState2) => {
 })(RoomInternalState || {});
 class Room {
   constructor() {
+    /**
+     * Timing events tied to the room instance.
+     * Intervals and timeouts are cleared when the room is disposed.
+     */
     this.clock = new import_timer.default();
-    this.#_autoDispose = true;
+    this.#_onLeaveConcurrent = 0;
+    // number of onLeave calls in progress
+    /**
+     * Maximum number of clients allowed to connect into the room. When room reaches this limit,
+     * it is locked automatically. Unless the room was explicitly locked by you via `lock()` method,
+     * the room will be unlocked as soon as a client disconnects from it.
+     */
     this.maxClients = Infinity;
+    this.#_maxClientsReached = false;
+    /**
+     * Automatically dispose the room when last client disconnects.
+     *
+     * @default true
+     */
+    this.autoDispose = true;
+    /**
+     * Frequency to send the room state to connected clients, in milliseconds.
+     *
+     * @default 50ms (20fps)
+     */
     this.patchRate = DEFAULT_PATCH_RATE;
+    /**
+     * The array of connected clients.
+     *
+     * @see {@link https://docs.colyseus.io/colyseus/server/room/#client|Client instance}
+     */
     this.clients = new import_Transport.ClientArray();
+    /** @internal */
     this._events = new import_events.EventEmitter();
+    // seat reservation & reconnection
     this.seatReservationTime = DEFAULT_SEAT_RESERVATION_TIME;
     this.reservedSeats = {};
     this.reservedSeatTimeouts = {};
     this._reconnections = {};
     this._reconnectingSessionId = /* @__PURE__ */ new Map();
-    this.onMessageHandlers = {};
+    this.onMessageHandlers = {
+      "__no_message_handler": {
+        callback: (client, messageType, _) => {
+          const errorMessage = `room onMessage for "${messageType}" not registered.`;
+          (0, import_Debug.debugAndPrintError)(`${errorMessage} (roomId: ${this.roomId})`);
+          if (import_DevMode.isDevMode) {
+            client.error(import_Protocol.ErrorCode.INVALID_PAYLOAD, errorMessage);
+          } else {
+            client.leave(import_Protocol.Protocol.WS_CLOSE_WITH_ERROR, errorMessage);
+          }
+        }
+      }
+    };
     this._serializer = noneSerializer;
     this._afterNextPatchQueue = [];
     this._internalState = 0 /* CREATING */;
-    this._locked = false;
     this._lockedExplicitly = false;
-    this._maxClientsReached = false;
-    this._events.once("dispose", async () => {
-      try {
-        await this._dispose();
-      } catch (e) {
-        (0, import_Debug.debugAndPrintError)(`onDispose error: ${e && e.message || e || "promise rejected"}`);
-      }
-      this._events.emit("disconnect");
+    this.#_locked = false;
+    this._events.once("dispose", () => {
+      this._dispose().catch((e) => (0, import_Debug.debugAndPrintError)(`onDispose error: ${e && e.stack || e.message || e || "promise rejected"} (roomId: ${this.roomId})`)).finally(() => this._events.emit("disconnect"));
     });
-    this.setPatchRate(this.patchRate);
-    this.resetAutoDisposeTimeout(this.seatReservationTime);
+    if (this.onUncaughtException !== void 0) {
+      this.#registerUncaughtExceptionHandlers();
+    }
   }
+  /**
+   * This property will change on these situations:
+   * - The maximum number of allowed clients has been reached (`maxClients`)
+   * - You manually locked, or unlocked the room using lock() or `unlock()`.
+   *
+   * @readonly
+   */
   get locked() {
-    return this._locked;
+    return this.#_locked;
   }
   get metadata() {
     return this.listing.metadata;
   }
   #_roomId;
   #_roomName;
+  #_onLeaveConcurrent;
+  #_maxClientsReached;
+  #_maxClients;
   #_autoDispose;
-  get autoDispose() {
-    return this.#_autoDispose;
-  }
-  set autoDispose(value) {
-    if (value !== this.#_autoDispose && this._internalState !== 2 /* DISPOSING */) {
-      this.#_autoDispose = value;
-      this.resetAutoDisposeTimeout();
+  #_patchRate;
+  #_patchInterval;
+  #_state;
+  #_locked;
+  /**
+   * This method is called by the MatchMaker before onCreate()
+   * @internal
+   */
+  __init() {
+    this.#_state = this.state;
+    this.#_autoDispose = this.autoDispose;
+    this.#_patchRate = this.patchRate;
+    this.#_maxClients = this.maxClients;
+    Object.defineProperties(this, {
+      state: {
+        enumerable: true,
+        get: () => this.#_state,
+        set: (newState) => {
+          if (newState[import_schema.$changes] !== void 0) {
+            this.setSerializer(new import_SchemaSerializer.SchemaSerializer());
+          } else if ("_definition" in newState) {
+            throw new Error("@colyseus/schema v2 compatibility currently missing (reach out if you need it)");
+          } else if (import_schema.$changes === void 0) {
+            throw new Error("Multiple @colyseus/schema versions detected. Please make sure you don't have multiple versions of @colyseus/schema installed.");
+          }
+          this._serializer.reset(newState);
+          this.#_state = newState;
+        }
+      },
+      maxClients: {
+        enumerable: true,
+        get: () => this.#_maxClients,
+        set: (value) => {
+          this.#_maxClients = value;
+          if (this._internalState === 1 /* CREATED */) {
+            const hasReachedMaxClients = this.hasReachedMaxClients();
+            if (!this._lockedExplicitly && this.#_maxClientsReached && !hasReachedMaxClients) {
+              this.#_maxClientsReached = false;
+              this.#_locked = false;
+              this.listing.locked = false;
+            }
+            if (hasReachedMaxClients) {
+              this.#_maxClientsReached = true;
+              this.#_locked = true;
+              this.listing.locked = true;
+            }
+            this.listing.maxClients = value;
+            this.listing.save();
+          }
+        }
+      },
+      autoDispose: {
+        enumerable: true,
+        get: () => this.#_autoDispose,
+        set: (value) => {
+          if (value !== this.#_autoDispose && this._internalState !== 2 /* DISPOSING */) {
+            this.#_autoDispose = value;
+            this.resetAutoDisposeTimeout();
+          }
+        }
+      },
+      patchRate: {
+        enumerable: true,
+        get: () => this.#_patchRate,
+        set: (milliseconds) => {
+          this.#_patchRate = milliseconds;
+          if (this.#_patchInterval) {
+            clearInterval(this.#_patchInterval);
+            this.#_patchInterval = void 0;
+          }
+          if (milliseconds !== null && milliseconds !== 0) {
+            this.#_patchInterval = setInterval(() => this.broadcastPatch(), milliseconds);
+          }
+        }
+      }
+    });
+    this.patchRate = this.#_patchRate;
+    if (this.#_state) {
+      this.state = this.#_state;
     }
+    this.resetAutoDisposeTimeout(this.seatReservationTime);
+    this.clock.start();
   }
+  /**
+   * The name of the room you provided as first argument for `gameServer.define()`.
+   *
+   * @returns roomName string
+   */
   get roomName() {
     return this.#_roomName;
   }
+  /**
+   * Setting the name of the room. Overwriting this property is restricted.
+   *
+   * @param roomName
+   */
   set roomName(roomName) {
     if (this.#_roomName) {
       throw new import_ServerError.ServerError(import_Protocol.ErrorCode.APPLICATION_ERROR, "'roomName' cannot be overwritten.");
     }
     this.#_roomName = roomName;
   }
+  /**
+   * A unique, auto-generated, 9-character-long id of the room.
+   * You may replace `this.roomId` during `onCreate()`.
+   *
+   * @returns roomId string
+   */
   get roomId() {
     return this.#_roomId;
   }
+  /**
+   * Setting the roomId, is restricted in room lifetime except upon room creation.
+   *
+   * @param roomId
+   * @returns roomId string
+   */
   set roomId(roomId) {
     if (this._internalState !== 0 /* CREATING */ && !import_DevMode.isDevMode) {
       throw new import_ServerError.ServerError(import_Protocol.ErrorCode.APPLICATION_ERROR, "'roomId' can only be overridden upon room creation.");
     }
     this.#_roomId = roomId;
   }
-  onAuth(client, options, request) {
+  onAuth(client, options, context) {
     return true;
   }
-  static async onAuth(token, req) {
+  static async onAuth(token, options, context) {
     return true;
   }
+  /**
+   * This method is called during graceful shutdown of the server process
+   * You may override this method to dispose the room in your own way.
+   *
+   * Once process reaches room count of 0, the room process will be terminated.
+   */
+  onBeforeShutdown() {
+    this.disconnect(
+      import_DevMode.isDevMode ? import_Protocol.Protocol.WS_CLOSE_DEVMODE_RESTART : import_Protocol.Protocol.WS_CLOSE_CONSENTED
+    );
+  }
+  /**
+   * Returns whether the sum of connected clients and reserved seats exceeds maximum number of clients.
+   *
+   * @returns boolean
+   */
   hasReachedMaxClients() {
     return this.clients.length + Object.keys(this.reservedSeats).length >= this.maxClients || this._internalState === 2 /* DISPOSING */;
   }
+  /**
+   * Set the number of seconds a room can wait for a client to effectively join the room.
+   * You should consider how long your `onAuth()` will have to wait for setting a different seat reservation time.
+   * The default value is 15 seconds. You may set the `COLYSEUS_SEAT_RESERVATION_TIME`
+   * environment variable if you'd like to change the seat reservation time globally.
+   *
+   * @default 15 seconds
+   *
+   * @param seconds - number of seconds.
+   * @returns The modified Room object.
+   */
   setSeatReservationTime(seconds) {
     this.seatReservationTime = seconds;
     return this;
   }
   hasReservedSeat(sessionId, reconnectionToken) {
-    if (reconnectionToken) {
-      const reconnection = this._reconnections[reconnectionToken];
-      return reconnection && reconnection[0] === sessionId && this.reservedSeats[sessionId] !== void 0 && this._reconnectingSessionId.has(sessionId);
+    const reservedSeat = this.reservedSeats[sessionId];
+    if (reservedSeat === void 0) {
+      return false;
+    }
+    if (reservedSeat[3]) {
+      return reconnectionToken && this._reconnections[reconnectionToken]?.[0] === sessionId && this._reconnectingSessionId.has(sessionId);
     } else {
-      return this.reservedSeats[sessionId] !== void 0 && (!this._reconnectingSessionId.has(sessionId) || this._reconnectingSessionId.get(sessionId) === sessionId);
+      return reservedSeat[2] === false;
     }
   }
   checkReconnectionToken(reconnectionToken) {
-    const reconnection = this._reconnections[reconnectionToken];
-    const sessionId = reconnection && reconnection[0];
-    if (this.hasReservedSeat(sessionId)) {
+    const sessionId = this._reconnections[reconnectionToken]?.[0];
+    const reservedSeat = this.reservedSeats[sessionId];
+    if (reservedSeat && reservedSeat[3]) {
       this._reconnectingSessionId.set(sessionId, reconnectionToken);
       return sessionId;
     } else {
       return void 0;
     }
   }
+  /**
+   * (Optional) Set a simulation interval that can change the state of the game.
+   * The simulation interval is your game loop.
+   *
+   * @default 16.6ms (60fps)
+   *
+   * @param onTickCallback - You can implement your physics or world updates here!
+   *  This is a good place to update the room state.
+   * @param delay - Interval delay on executing `onTickCallback` in milliseconds.
+   */
   setSimulationInterval(onTickCallback, delay = DEFAULT_SIMULATION_INTERVAL) {
     if (this._simulationInterval) {
       clearInterval(this._simulationInterval);
     }
     if (onTickCallback) {
+      if (this.onUncaughtException !== void 0) {
+        onTickCallback = (0, import_Utils.wrapTryCatch)(onTickCallback, this.onUncaughtException.bind(this), import_RoomExceptions.SimulationIntervalException, "setSimulationInterval");
+      }
       this._simulationInterval = setInterval(() => {
         this.clock.tick();
         onTickCallback(this.clock.deltaTime);
       }, delay);
     }
   }
+  /**
+   * @deprecated Use `.patchRate=` instead.
+   */
   setPatchRate(milliseconds) {
     this.patchRate = milliseconds;
-    if (this._patchInterval) {
-      clearInterval(this._patchInterval);
-      this._patchInterval = void 0;
-    }
-    if (milliseconds !== null && milliseconds !== 0) {
-      this._patchInterval = setInterval(() => this.broadcastPatch(), milliseconds);
-    }
   }
+  /**
+   * @deprecated Use `.state =` instead.
+   */
   setState(newState) {
-    this.clock.start();
-    if (newState[import_schema.$changes] !== void 0) {
-      this.setSerializer(new import_SchemaSerializer.SchemaSerializer());
-    } else if (import_schema.$changes === void 0) {
-      throw new Error("@colyseus/schema v2 compatibility currently missing (reach out if you need it)");
-    }
-    this._serializer.reset(newState);
     this.state = newState;
   }
   setSerializer(serializer) {
@@ -202,35 +384,40 @@ class Room {
     }
   }
   async setPrivate(bool = true) {
-    if (this.listing.private === bool)
-      return;
+    if (this.listing.private === bool) return;
     this.listing.private = bool;
     if (this._internalState === 1 /* CREATED */) {
       await this.listing.save();
     }
     this._events.emit("visibility-change", bool);
   }
+  /**
+   * Locking the room will remove it from the pool of available rooms for new clients to connect to.
+   */
   async lock() {
     this._lockedExplicitly = arguments[0] === void 0;
-    if (this._locked) {
+    if (this.#_locked) {
       return;
     }
-    this._locked = true;
+    this.#_locked = true;
     await this.listing.updateOne({
-      $set: { locked: this._locked }
+      $set: { locked: this.#_locked }
     });
     this._events.emit("lock");
   }
+  /**
+   * Unlocking the room returns it to the pool of available rooms for new clients to connect to.
+   */
   async unlock() {
     if (arguments[0] === void 0) {
       this._lockedExplicitly = false;
     }
-    if (!this._locked) {
+    if (!this.#_locked) {
       return;
     }
-    this._locked = false;
+    this.#_locked = false;
     await this.listing.updateOne({
-      $set: { locked: this._locked }
+      $set: { locked: this.#_locked }
     });
     this._events.emit("unlock");
   }
@@ -238,16 +425,28 @@ class Room {
     import_Logger.logger.warn("DEPRECATION WARNING: use client.send(...) instead of this.send(client, ...)");
     client.send(messageOrType, messageOrOptions, options);
   }
-  broadcast(typeOrSchema, messageOrOptions, options) {
-    const isSchema = typeof typeOrSchema === "object";
-    const opts = isSchema ? messageOrOptions : options;
-    if (opts && opts.afterNextPatch) {
-      delete opts.afterNextPatch;
+  broadcast(type, message, options) {
+    if (options && options.afterNextPatch) {
+      delete options.afterNextPatch;
       this._afterNextPatchQueue.push(["broadcast", arguments]);
       return;
     }
-    this.broadcastMessageType(typeOrSchema, messageOrOptions, opts);
+    this.broadcastMessageType(type, message, options);
   }
+  /**
+   * Broadcast bytes (UInt8Arrays) to a particular room
+   */
+  broadcastBytes(type, message, options) {
+    if (options && options.afterNextPatch) {
+      delete options.afterNextPatch;
+      this._afterNextPatchQueue.push(["broadcastBytes", arguments]);
+      return;
+    }
+    this.broadcastMessageType(type, message, options);
+  }
+  /**
+   * Checks whether mutations have occurred in the state, and broadcast them to all connected clients.
+   */
   broadcastPatch() {
     if (this.onBeforePatch) {
       this.onBeforePatch(this.state);
@@ -262,10 +461,16 @@ class Room {
     this._dequeueAfterPatchMessages();
     return hasChanges;
   }
-  onMessage(messageType, callback) {
-    this.onMessageHandlers[messageType] = callback;
+  onMessage(messageType, callback, validate) {
+    this.onMessageHandlers[messageType] = this.onUncaughtException !== void 0 ? { validate, callback: (0, import_Utils.wrapTryCatch)(callback, this.onUncaughtException.bind(this), import_RoomExceptions.OnMessageException, "onMessage", false, messageType) } : { validate, callback };
     return () => delete this.onMessageHandlers[messageType];
   }
+  /**
+   * Disconnect all connected clients, and then dispose the room.
+   *
+   * @param closeCode WebSocket close code (default = 4000, which is a "consented leave")
+   * @returns Promise<void>
+   */
   disconnect(closeCode = import_Protocol.Protocol.WS_CLOSE_CONSENTED) {
     if (this._internalState === 2 /* DISPOSING */) {
       return Promise.resolve(`disconnect() ignored: room (${this.roomId}) is already disposing.`);
@@ -277,7 +482,7 @@ class Room {
     this.#_autoDispose = true;
     const delayedDisconnection = new Promise((resolve) => this._events.once("disconnect", () => resolve()));
     for (const [_, reconnection] of Object.values(this._reconnections)) {
-      reconnection.reject();
+      reconnection.reject(new Error("disconnecting"));
     }
     let numClients = this.clients.length;
     if (numClients > 0) {
@@ -289,7 +494,7 @@ class Room {
     }
     return delayedDisconnection;
   }
-  async ["_onJoin"](client, req) {
+  async ["_onJoin"](client, authContext) {
     const sessionId = client.sessionId;
     client.reconnectionToken = (0, import_Utils.generateId)();
     if (this.reservedSeatTimeouts[sessionId]) {
@@ -300,26 +505,38 @@ class Room {
       clearTimeout(this._autoDisposeTimeout);
       this._autoDisposeTimeout = void 0;
     }
-    const [joinOptions, authData] = this.reservedSeats[sessionId];
-    if (this.reservedSeats[sessionId].length > 2) {
+    const [joinOptions, authData, isConsumed, isWaitingReconnection] = this.reservedSeats[sessionId];
+    if (isConsumed) {
       throw new import_ServerError.ServerError(import_Protocol.ErrorCode.MATCHMAKE_EXPIRED, "already consumed");
     }
-    this.reservedSeats[sessionId].push(true);
+    this.reservedSeats[sessionId][2] = true;
+    (0, import_Debug.debugMatchMaking)("consuming seat reservation, sessionId: '%s' (roomId: %s)", client.sessionId, this.roomId);
     client._afterNextPatchQueue = this._afterNextPatchQueue;
     client.ref["onleave"] = (_) => client.state = import_Transport.ClientState.LEAVING;
     client.ref.once("close", client.ref["onleave"]);
-    const previousReconnectionToken = this._reconnectingSessionId.get(sessionId);
-    if (previousReconnectionToken) {
-      this.clients.push(client);
-      this._reconnections[previousReconnectionToken]?.[1].resolve(client);
+    if (isWaitingReconnection) {
+      const previousReconnectionToken = this._reconnectingSessionId.get(sessionId);
+      if (previousReconnectionToken) {
+        this.clients.push(client);
+        await this._reconnections[previousReconnectionToken]?.[1].resolve(client);
+      } else {
+        const errorMessage = process.env.NODE_ENV === "production" ? "already consumed" : "bad reconnection token";
+        throw new import_ServerError.ServerError(import_Protocol.ErrorCode.MATCHMAKE_EXPIRED, errorMessage);
+      }
     } else {
       try {
         if (authData) {
           client.auth = authData;
         } else if (this.onAuth !== Room.prototype.onAuth) {
-          client.auth = await this.onAuth(client, joinOptions, req);
-          if (!client.auth) {
-            throw new import_ServerError.ServerError(import_Protocol.ErrorCode.AUTH_FAILED, "onAuth failed");
+          try {
+            client.auth = await this.onAuth(client, joinOptions, authContext);
+            if (!client.auth) {
+              throw new import_ServerError.ServerError(import_Protocol.ErrorCode.AUTH_FAILED, "onAuth failed");
+            }
+          } catch (e) {
+            delete this.reservedSeats[sessionId];
+            await this._decrementClientCount();
+            throw e;
           }
         }
         if (client.state === import_Transport.ClientState.LEAVING) {
@@ -333,15 +550,15 @@ class Room {
         if (this.onJoin) {
           await this.onJoin(client, joinOptions, client.auth);
         }
-        this._events.emit("join", client);
-        delete this.reservedSeats[sessionId];
         if (client.state === import_Transport.ClientState.LEAVING) {
-          await this._onLeave(client, import_Protocol.Protocol.WS_CLOSE_GOING_AWAY);
+          throw new Error("early_leave");
+        } else {
+          delete this.reservedSeats[sessionId];
+          this._events.emit("join", client);
         }
       } catch (e) {
-        this.clients.delete(client);
+        await this._onLeave(client, import_Protocol.Protocol.WS_CLOSE_GOING_AWAY);
         delete this.reservedSeats[sessionId];
-        this._decrementClientCount();
         if (!e.code) {
           e.code = import_Protocol.ErrorCode.APPLICATION_ERROR;
         }
@@ -360,9 +577,19 @@ class Room {
       ));
     }
   }
+  /**
+   * Allow the specified client to reconnect into the room. Must be used inside `onLeave()` method.
+   * If seconds is provided, the reconnection is going to be cancelled after the provided amount of seconds.
+   *
+   * @param previousClient - The client which is to be waiting until re-connection happens.
+   * @param seconds - Timeout period on re-connection in seconds.
+   *
+   * @returns Deferred<Client> - The differed is a promise like type.
+   *  This type can forcibly reject the promise by calling `.reject()`.
+   */
   allowReconnection(previousClient, seconds) {
     if (previousClient._enqueuedMessages !== void 0) {
-      return;
+      return Promise.reject(new Error("not joined"));
     }
     if (seconds === void 0) {
       console.warn('DEPRECATED: allowReconnection() requires a second argument. Using "manual" mode.');
@@ -372,8 +599,7 @@ class Room {
       seconds = Infinity;
     }
     if (this._internalState === 2 /* DISPOSING */) {
-      this._disposeIfEmpty();
-      throw new Error("disconnecting");
+      return Promise.reject(new Error("disposing"));
     }
     const sessionId = previousClient.sessionId;
     const reconnectionToken = previousClient.reconnectionToken;
@@ -392,8 +618,9 @@ class Room {
     reconnection.then((newClient) => {
       newClient.auth = previousClient.auth;
       newClient.userData = previousClient.userData;
-      previousClient.ref = newClient.ref;
       previousClient.state = import_Transport.ClientState.RECONNECTED;
+      previousClient.ref = newClient.ref;
+      previousClient.reconnectionToken = newClient.reconnectionToken;
       clearTimeout(this.reservedSeatTimeouts[sessionId]);
       cleanup();
     }).catch(() => {
@@ -413,8 +640,8 @@ class Room {
     }, timeoutInSeconds * 1e3);
   }
   broadcastMessageType(type, message, options = {}) {
-    (0, import_Debug.debugMessage)("broadcast: %O", message);
-    const encodedMessage = import_Protocol.getMessageBytes.raw(import_Protocol.Protocol.ROOM_DATA, type, message);
+    (0, import_Debug.debugMessage)("broadcast: %O (roomId: %s)", message, this.roomId);
+    const encodedMessage = message instanceof Uint8Array ? import_Protocol.getMessageBytes.raw(import_Protocol.Protocol.ROOM_DATA_BYTES, type, void 0, message) : import_Protocol.getMessageBytes.raw(import_Protocol.Protocol.ROOM_DATA, type, message);
     const except = typeof options.except !== "undefined" ? Array.isArray(options.except) ? options.except : [options.except] : void 0;
     let numClients = this.clients.length;
     while (numClients--) {
@@ -445,7 +672,7 @@ class Room {
     if (!allowReconnection && this.hasReachedMaxClients()) {
       return false;
     }
-    this.reservedSeats[sessionId] = [joinOptions, authData];
+    this.reservedSeats[sessionId] = [joinOptions, authData, false, allowReconnection];
     if (!allowReconnection) {
       await this._incrementClientCount();
       this.reservedSeatTimeouts[sessionId] = setTimeout(async () => {
@@ -461,7 +688,8 @@ class Room {
     return true;
   }
   _disposeIfEmpty() {
-    const willDispose = this.#_autoDispose && this._autoDisposeTimeout === void 0 && this.clients.length === 0 && Object.keys(this.reservedSeats).length === 0;
+    const willDispose = this.#_onLeaveConcurrent === 0 && // no "onLeave" calls in progress
+    this.#_autoDispose && this._autoDisposeTimeout === void 0 && this.clients.length === 0 && Object.keys(this.reservedSeats).length === 0;
     if (willDispose) {
       this._events.emit("dispose");
     }
@@ -469,14 +697,14 @@ class Room {
   }
   async _dispose() {
     this._internalState = 2 /* DISPOSING */;
-    await this.listing.remove();
+    this.listing.remove();
     let userReturnData;
     if (this.onDispose) {
       userReturnData = this.onDispose();
     }
-    if (this._patchInterval) {
-      clearInterval(this._patchInterval);
-      this._patchInterval = void 0;
+    if (this.#_patchInterval) {
+      clearInterval(this.#_patchInterval);
+      this.#_patchInterval = void 0;
     }
     if (this._simulationInterval) {
       clearInterval(this._simulationInterval);
@@ -490,56 +718,48 @@ class Room {
     this.clock.stop();
     return await (userReturnData || Promise.resolve());
   }
-  _onMessage(client, bytes) {
+  _onMessage(client, buffer) {
     if (client.state === import_Transport.ClientState.LEAVING) {
       return;
     }
-    const it = { offset: 0 };
-    const code = import_schema.decode.uint8(bytes, it);
-    if (!bytes) {
-      (0, import_Debug.debugAndPrintError)(`${this.roomName} (${this.roomId}), couldn't decode message: ${bytes}`);
+    const it = { offset: 1 };
+    const code = buffer[0];
+    if (!buffer) {
+      (0, import_Debug.debugAndPrintError)(`${this.roomName} (roomId: ${this.roomId}), couldn't decode message: ${buffer}`);
       return;
     }
     if (code === import_Protocol.Protocol.ROOM_DATA) {
-      const messageType = import_schema.decode.stringCheck(bytes, it) ? import_schema.decode.string(bytes, it) : import_schema.decode.number(bytes, it);
+      const messageType = import_schema.decode.stringCheck(buffer, it) ? import_schema.decode.string(buffer, it) : import_schema.decode.number(buffer, it);
+      const messageTypeHandler = this.onMessageHandlers[messageType];
       let message;
       try {
-        message = bytes.length > it.offset ? (0, import_msgpackr.unpack)(new Uint8Array(bytes.slice(it.offset, bytes.length))) : void 0;
-        (0, import_Debug.debugMessage)("received: '%s' -> %j", messageType, message);
+        message = buffer.byteLength > it.offset ? (0, import_msgpackr.unpack)(buffer.subarray(it.offset, buffer.byteLength)) : void 0;
+        (0, import_Debug.debugMessage)("received: '%s' -> %j (roomId: %s)", messageType, message, this.roomId);
+        if (messageTypeHandler?.validate !== void 0) {
+          message = messageTypeHandler.validate(message);
+        }
       } catch (e) {
         (0, import_Debug.debugAndPrintError)(e);
         client.leave(import_Protocol.Protocol.WS_CLOSE_WITH_ERROR);
         return;
       }
-      if (this.onMessageHandlers[messageType]) {
-        this.onMessageHandlers[messageType](client, message);
-      } else if (this.onMessageHandlers["*"]) {
-        this.onMessageHandlers["*"](client, messageType, message);
+      if (messageTypeHandler) {
+        messageTypeHandler.callback(client, message);
       } else {
-        const errorMessage = `onMessage for "${messageType}" not registered.`;
-        (0, import_Debug.debugAndPrintError)(errorMessage);
-        if (import_DevMode.isDevMode) {
-          client.error(import_Protocol.ErrorCode.INVALID_PAYLOAD, errorMessage);
-        } else {
-          client.leave(import_Protocol.Protocol.WS_CLOSE_WITH_ERROR, errorMessage);
-        }
+        (this.onMessageHandlers["*"] || this.onMessageHandlers["__no_message_handler"]).callback(client, messageType, message);
       }
     } else if (code === import_Protocol.Protocol.ROOM_DATA_BYTES) {
-      const messageType = import_schema.decode.stringCheck(bytes, it) ? import_schema.decode.string(bytes, it) : import_schema.decode.number(bytes, it);
-      const message = bytes.slice(it.offset, bytes.length);
-      (0, import_Debug.debugMessage)("received: '%s' -> %j", messageType, message);
-      if (this.onMessageHandlers[messageType]) {
-        this.onMessageHandlers[messageType](client, message);
-      } else if (this.onMessageHandlers["*"]) {
-        this.onMessageHandlers["*"](client, messageType, message);
+      const messageType = import_schema.decode.stringCheck(buffer, it) ? import_schema.decode.string(buffer, it) : import_schema.decode.number(buffer, it);
+      const messageTypeHandler = this.onMessageHandlers[messageType];
+      let message = buffer.subarray(it.offset, buffer.byteLength);
+      (0, import_Debug.debugMessage)("received: '%s' -> %j (roomId: %s)", messageType, message, this.roomId);
+      if (messageTypeHandler?.validate !== void 0) {
+        message = messageTypeHandler.validate(message);
+      }
+      if (messageTypeHandler) {
+        messageTypeHandler.callback(client, message);
       } else {
-        const errorMessage = `onMessage for "${messageType}" not registered.`;
-        (0, import_Debug.debugAndPrintError)(errorMessage);
-        if (import_DevMode.isDevMode) {
-          client.error(import_Protocol.ErrorCode.INVALID_PAYLOAD, errorMessage);
-        } else {
-          client.leave(import_Protocol.Protocol.WS_CLOSE_WITH_ERROR, errorMessage);
-        }
+        (this.onMessageHandlers["*"] || this.onMessageHandlers["__no_message_handler"]).callback(client, messageType, message);
       }
     } else if (code === import_Protocol.Protocol.JOIN_ROOM && client.state === import_Transport.ClientState.JOINING) {
       client.state = import_Transport.ClientState.JOINED;
@@ -561,32 +781,43 @@ class Room {
     this._onLeave(client, closeCode).then(() => client.leave(closeCode));
   }
   async _onLeave(client, code) {
-    const success = this.clients.delete(client);
-    if (success) {
-      client.state = import_Transport.ClientState.LEAVING;
-      if (this.onLeave) {
-        try {
-          await this.onLeave(client, code === import_Protocol.Protocol.WS_CLOSE_CONSENTED);
-        } catch (e) {
-          (0, import_Debug.debugAndPrintError)(`onLeave error: ${e && e.message || e || "promise rejected"}`);
-        }
-      }
+    (0, import_Debug.debugMatchMaking)("onLeave, sessionId: '%s' (close code: %d, roomId: %s)", client.sessionId, code, this.roomId);
+    client.state = import_Transport.ClientState.LEAVING;
+    if (!this.clients.delete(client)) {
+      return;
     }
-    if (client.state !== import_Transport.ClientState.RECONNECTED) {
-      const willDispose = await this._decrementClientCount();
-      if (this.reservedSeats[client.sessionId] === void 0) {
-        this._events.emit("leave", client, willDispose);
+    if (this.onLeave) {
+      try {
+        this.#_onLeaveConcurrent++;
+        await this.onLeave(client, code === import_Protocol.Protocol.WS_CLOSE_CONSENTED);
+      } catch (e) {
+        (0, import_Debug.debugAndPrintError)(`onLeave error: ${e && e.message || e || "promise rejected"} (roomId: ${this.roomId})`);
+      } finally {
+        this.#_onLeaveConcurrent--;
       }
     }
+    if (this._reconnections[client.reconnectionToken]) {
+      this._reconnections[client.reconnectionToken][1].catch(async () => {
+        await this._onAfterLeave(client);
+      });
+    } else if (client.state !== import_Transport.ClientState.RECONNECTED) {
+      await this._onAfterLeave(client);
+    }
+  }
+  async _onAfterLeave(client) {
+    const willDispose = await this._decrementClientCount();
+    if (this.reservedSeats[client.sessionId] === void 0) {
+      this._events.emit("leave", client, willDispose);
+    }
   }
   async _incrementClientCount() {
-    if (!this._locked && this.hasReachedMaxClients()) {
-      this._maxClientsReached = true;
+    if (!this.#_locked && this.hasReachedMaxClients()) {
+      this.#_maxClientsReached = true;
       this.lock.call(this, true);
     }
     await this.listing.updateOne({
       $inc: { clients: 1 },
-      $set: { locked: this._locked }
+      $set: { locked: this.#_locked }
     });
   }
   async _decrementClientCount() {
@@ -595,17 +826,43 @@ class Room {
       return true;
     }
     if (!willDispose) {
-      if (this._maxClientsReached && !this._lockedExplicitly) {
-        this._maxClientsReached = false;
+      if (this.#_maxClientsReached && !this._lockedExplicitly) {
+        this.#_maxClientsReached = false;
         this.unlock.call(this, true);
       }
       await this.listing.updateOne({
         $inc: { clients: -1 },
-        $set: { locked: this._locked }
+        $set: { locked: this.#_locked }
       });
     }
     return willDispose;
   }
+  #registerUncaughtExceptionHandlers() {
+    const onUncaughtException = this.onUncaughtException.bind(this);
+    const originalSetTimeout = this.clock.setTimeout;
+    this.clock.setTimeout = (cb, timeout, ...args) => {
+      return originalSetTimeout.call(this.clock, (0, import_Utils.wrapTryCatch)(cb, onUncaughtException, import_RoomExceptions.TimedEventException, "setTimeout"), timeout, ...args);
+    };
+    const originalSetInterval = this.clock.setInterval;
+    this.clock.setInterval = (cb, timeout, ...args) => {
+      return originalSetInterval.call(this.clock, (0, import_Utils.wrapTryCatch)(cb, onUncaughtException, import_RoomExceptions.TimedEventException, "setInterval"), timeout, ...args);
+    };
+    if (this.onCreate !== void 0) {
+      this.onCreate = (0, import_Utils.wrapTryCatch)(this.onCreate.bind(this), onUncaughtException, import_RoomExceptions.OnCreateException, "onCreate", true);
+    }
+    if (this.onAuth !== void 0) {
+      this.onAuth = (0, import_Utils.wrapTryCatch)(this.onAuth.bind(this), onUncaughtException, import_RoomExceptions.OnAuthException, "onAuth", true);
+    }
+    if (this.onJoin !== void 0) {
+      this.onJoin = (0, import_Utils.wrapTryCatch)(this.onJoin.bind(this), onUncaughtException, import_RoomExceptions.OnJoinException, "onJoin", true);
+    }
+    if (this.onLeave !== void 0) {
+      this.onLeave = (0, import_Utils.wrapTryCatch)(this.onLeave.bind(this), onUncaughtException, import_RoomExceptions.OnLeaveException, "onLeave", true);
+    }
+    if (this.onDispose !== void 0) {
+      this.onDispose = (0, import_Utils.wrapTryCatch)(this.onDispose.bind(this), onUncaughtException, import_RoomExceptions.OnDisposeException, "onDispose");
+    }
+  }
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {