@colyseus/core 0.18.23 → 0.18.25

package/build/rooms/LobbyRoom.cjs

@@ -35,6 +35,7 @@ __export(LobbyRoom_exports, {
 });
 module.exports = __toCommonJS(LobbyRoom_exports);
 var matchMaker = __toESM(require("../MatchMaker.cjs"), 1);
+var import_Debug = require("../Debug.cjs");
 var import_Lobby = require("../matchmaker/Lobby.cjs");
 var import_Room = require("../Room.cjs");
 var LobbyRoom = class extends import_Room.Room {
@@ -55,30 +56,29 @@ var LobbyRoom = class extends import_Room.Room {
     });
     this.unsubscribeLobby = await (0, import_Lobby.subscribeLobby)((roomId, data) => {
       const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);
-      const clients = this.clients.filter((client) => this.clientOptions[client.sessionId]);
       if (!data) {
         if (roomIndex !== -1) {
           const previousData = this.rooms[roomIndex];
           this.rooms.splice(roomIndex, 1);
-          clients.forEach((client) => {
-            if (this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter)) {
+          this.#notifyClients((client, filter) => {
+            if (this.filterItemForClient(previousData, filter)) {
               client.send("-", roomId);
             }
           });
         }
       } else if (roomIndex === -1) {
         this.rooms.push(data);
-        clients.forEach((client) => {
-          if (this.filterItemForClient(data, this.clientOptions[client.sessionId].filter)) {
+        this.#notifyClients((client, filter) => {
+          if (this.filterItemForClient(data, filter)) {
             client.send("+", [roomId, data]);
           }
         });
       } else {
         const previousData = this.rooms[roomIndex];
         this.rooms[roomIndex] = data;
-        clients.forEach((client) => {
-          const hadData = this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter);
-          const hasData = this.filterItemForClient(data, this.clientOptions[client.sessionId].filter);
+        this.#notifyClients((client, filter) => {
+          const hadData = this.filterItemForClient(previousData, filter);
+          const hasData = this.filterItemForClient(data, filter);
           if (hadData && !hasData) {
             client.send("-", roomId);
           } else if (hasData) {
@@ -102,6 +102,19 @@ var LobbyRoom = class extends import_Room.Room {
       this.unsubscribeLobby();
     }
   }
+  #notifyClients(notify) {
+    this.clients.forEach((client) => {
+      const options = this.clientOptions[client.sessionId];
+      if (!options) {
+        return;
+      }
+      try {
+        notify(client, options.filter);
+      } catch (e) {
+        (0, import_Debug.debugAndPrintError)(e);
+      }
+    });
+  }
   filterItemsForClient(options) {
     const filter = options.filter;
     return filter ? this.rooms.filter((room) => this.filterItemForClient(room, filter)) : this.rooms;
@@ -116,7 +129,7 @@ var LobbyRoom = class extends import_Room.Room {
     }
     if (filter.metadata) {
       for (const field in filter.metadata) {
-        if (room.metadata[field] !== filter.metadata[field]) {
+        if (room.metadata?.[field] !== filter.metadata[field]) {
           isAllowed = false;
           break;
         }

package/build/rooms/LobbyRoom.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/rooms/LobbyRoom.ts"],
-  "sourcesContent": ["import * as matchMaker from '../MatchMaker.ts';\nimport type { IRoomCache } from '../matchmaker/LocalDriver/LocalDriver.ts';\nimport type { Client } from '../Transport.ts';\nimport { subscribeLobby } from '../matchmaker/Lobby.ts';\nimport { Room } from '../Room.ts';\n\n// TODO: use Schema state & filters on version 1.0.0\n\n// class DummyLobbyState extends Schema { // tslint:disable-line\n//   @type(\"number\") public _: number;\n// }\n\n//\n// Strongly-typed client messages for LobbyRoom\n// (This is optional, but recommended for better type safety and code generation for native SDKs)\n//\ntype LobbyClient = Client<{\n  messages: {\n    rooms: IRoomCache[];\n    '+': [roomId: string, room: IRoomCache];\n    '-': string;\n  }\n}>;\n\nexport interface FilterInput {\n  name?: string;\n  metadata?: any;\n}\n\nexport interface LobbyOptions {\n  filter?: FilterInput;\n}\n\nexport type LobbyMessages = {\n  filter: (client: LobbyClient, filter: FilterInput) => void;\n};\n\nexport class LobbyRoom<Metadata = any> extends Room {\n  public rooms: IRoomCache<Metadata>[] = [];\n  public unsubscribeLobby: () => void;\n\n  public clientOptions: { [sessionId: string]: LobbyOptions } = {};\n\n  declare messages: LobbyMessages;\n\n  public async onCreate(options: any) {\n    // prevent LobbyRoom to notify itself\n    this['_listing'].unlisted = true;\n\n    this.onMessage('filter', (client, filter) => {\n      const clientOptions = this.clientOptions[client.sessionId];\n      if (!clientOptions) { return; }\n\n      clientOptions.filter = filter;\n      client.send('rooms', this.filterItemsForClient(clientOptions));\n    });\n\n    this.unsubscribeLobby = await subscribeLobby((roomId, data) => {\n      const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);\n      const clients = this.clients.filter((client) => this.clientOptions[client.sessionId]);\n\n      if (!data) {\n        // remove room listing data\n        if (roomIndex !== -1) {\n          const previousData = this.rooms[roomIndex];\n\n          this.rooms.splice(roomIndex, 1);\n\n          clients.forEach((client) => {\n            if (this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter)) {\n              client.send('-', roomId);\n            }\n          });\n        }\n\n      } else if (roomIndex === -1) {\n        // append room listing data\n        this.rooms.push(data);\n\n        clients.forEach((client) => {\n          if (this.filterItemForClient(data, this.clientOptions[client.sessionId].filter)) {\n            client.send('+', [roomId, data]);\n          }\n        });\n\n      } else {\n        const previousData = this.rooms[roomIndex];\n\n        // replace room listing data\n        this.rooms[roomIndex] = data;\n\n        clients.forEach((client) => {\n          const hadData = this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter);\n          const hasData = this.filterItemForClient(data, this.clientOptions[client.sessionId].filter);\n\n          if (hadData && !hasData) {\n            client.send('-', roomId);\n\n          } else if (hasData) {\n            client.send('+', [roomId, data]);\n          }\n        });\n      }\n    });\n\n    this.rooms = await matchMaker.query({ private: false, unlisted: false });\n  }\n\n  public onJoin(client: LobbyClient, options: LobbyOptions) {\n    this.clientOptions[client.sessionId] = (\n      !Array.isArray(options) && // Defold (Lua) sends empty objects as Array instead of object\n      options\n    ) || {};\n    client.send('rooms', this.filterItemsForClient(this.clientOptions[client.sessionId]));\n  }\n\n  public onLeave(client: LobbyClient) {\n    delete this.clientOptions[client.sessionId];\n  }\n\n  public onDispose() {\n    if (this.unsubscribeLobby) {\n      this.unsubscribeLobby();\n    }\n  }\n\n  protected filterItemsForClient(options: LobbyOptions): IRoomCache<Metadata>[] {\n    const filter = options.filter;\n\n    return (filter)\n      ? this.rooms.filter((room) => this.filterItemForClient(room, filter))\n      : this.rooms;\n  }\n\n  protected filterItemForClient(room: IRoomCache, filter?: LobbyOptions['filter']) {\n    if (!filter) {\n      return true;\n    }\n\n    let isAllowed = true;\n\n    if (filter.name !== room.name) {\n      isAllowed = false;\n    }\n\n    if (filter.metadata) {\n      for (const field in filter.metadata) {\n        if (room.metadata[field] !== filter.metadata[field]) {\n          isAllowed = false;\n          break;\n        }\n      }\n    }\n\n    return isAllowed;\n  }\n\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,iBAA4B;AAG5B,mBAA+B;AAC/B,kBAAqB;AAiCd,IAAM,YAAN,cAAwC,iBAAK;AAAA,EAA7C;AAAA;AACL,SAAO,QAAgC,CAAC;AAGxC,SAAO,gBAAuD,CAAC;AAAA;AAAA,EAI/D,MAAa,SAAS,SAAc;AAElC,SAAK,UAAU,EAAE,WAAW;AAE5B,SAAK,UAAU,UAAU,CAAC,QAAQ,WAAW;AAC3C,YAAM,gBAAgB,KAAK,cAAc,OAAO,SAAS;AACzD,UAAI,CAAC,eAAe;AAAE;AAAA,MAAQ;AAE9B,oBAAc,SAAS;AACvB,aAAO,KAAK,SAAS,KAAK,qBAAqB,aAAa,CAAC;AAAA,IAC/D,CAAC;AAED,SAAK,mBAAmB,UAAM,6BAAe,CAAC,QAAQ,SAAS;AAC7D,YAAM,YAAY,KAAK,MAAM,UAAU,CAAC,SAAS,KAAK,WAAW,MAAM;AACvE,YAAM,UAAU,KAAK,QAAQ,OAAO,CAAC,WAAW,KAAK,cAAc,OAAO,SAAS,CAAC;AAEpF,UAAI,CAAC,MAAM;AAET,YAAI,cAAc,IAAI;AACpB,gBAAM,eAAe,KAAK,MAAM,SAAS;AAEzC,eAAK,MAAM,OAAO,WAAW,CAAC;AAE9B,kBAAQ,QAAQ,CAAC,WAAW;AAC1B,gBAAI,KAAK,oBAAoB,cAAc,KAAK,cAAc,OAAO,SAAS,EAAE,MAAM,GAAG;AACvF,qBAAO,KAAK,KAAK,MAAM;AAAA,YACzB;AAAA,UACF,CAAC;AAAA,QACH;AAAA,MAEF,WAAW,cAAc,IAAI;AAE3B,aAAK,MAAM,KAAK,IAAI;AAEpB,gBAAQ,QAAQ,CAAC,WAAW;AAC1B,cAAI,KAAK,oBAAoB,MAAM,KAAK,cAAc,OAAO,SAAS,EAAE,MAAM,GAAG;AAC/E,mBAAO,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC;AAAA,UACjC;AAAA,QACF,CAAC;AAAA,MAEH,OAAO;AACL,cAAM,eAAe,KAAK,MAAM,SAAS;AAGzC,aAAK,MAAM,SAAS,IAAI;AAExB,gBAAQ,QAAQ,CAAC,WAAW;AAC1B,gBAAM,UAAU,KAAK,oBAAoB,cAAc,KAAK,cAAc,OAAO,SAAS,EAAE,MAAM;AAClG,gBAAM,UAAU,KAAK,oBAAoB,MAAM,KAAK,cAAc,OAAO,SAAS,EAAE,MAAM;AAE1F,cAAI,WAAW,CAAC,SAAS;AACvB,mBAAO,KAAK,KAAK,MAAM;AAAA,UAEzB,WAAW,SAAS;AAClB,mBAAO,KAAK,KAAK,CAAC,QAAQ,IAAI,CAAC;AAAA,UACjC;AAAA,QACF,CAAC;AAAA,MACH;AAAA,IACF,CAAC;AAED,SAAK,QAAQ,MAAiB,iBAAM,EAAE,SAAS,OAAO,UAAU,MAAM,CAAC;AAAA,EACzE;AAAA,EAEO,OAAO,QAAqB,SAAuB;AACxD,SAAK,cAAc,OAAO,SAAS,IACjC,CAAC,MAAM,QAAQ,OAAO;AAAA,IACtB,WACG,CAAC;AACN,WAAO,KAAK,SAAS,KAAK,qBAAqB,KAAK,cAAc,OAAO,SAAS,CAAC,CAAC;AAAA,EACtF;AAAA,EAEO,QAAQ,QAAqB;AAClC,WAAO,KAAK,cAAc,OAAO,SAAS;AAAA,EAC5C;AAAA,EAEO,YAAY;AACjB,QAAI,KAAK,kBAAkB;AACzB,WAAK,iBAAiB;AAAA,IACxB;AAAA,EACF;AAAA,EAEU,qBAAqB,SAA+C;AAC5E,UAAM,SAAS,QAAQ;AAEvB,WAAQ,SACJ,KAAK,MAAM,OAAO,CAAC,SAAS,KAAK,oBAAoB,MAAM,MAAM,CAAC,IAClE,KAAK;AAAA,EACX;AAAA,EAEU,oBAAoB,MAAkB,QAAiC;AAC/E,QAAI,CAAC,QAAQ;AACX,aAAO;AAAA,IACT;AAEA,QAAI,YAAY;AAEhB,QAAI,OAAO,SAAS,KAAK,MAAM;AAC7B,kBAAY;AAAA,IACd;AAEA,QAAI,OAAO,UAAU;AACnB,iBAAW,SAAS,OAAO,UAAU;AACnC,YAAI,KAAK,SAAS,KAAK,MAAM,OAAO,SAAS,KAAK,GAAG;AACnD,sBAAY;AACZ;AAAA,QACF;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAEF;",
+  "sourcesContent": ["import * as matchMaker from '../MatchMaker.ts';\nimport { debugAndPrintError } from '../Debug.ts';\nimport type { IRoomCache } from '../matchmaker/LocalDriver/LocalDriver.ts';\nimport type { Client } from '../Transport.ts';\nimport { subscribeLobby } from '../matchmaker/Lobby.ts';\nimport { Room } from '../Room.ts';\n\n// TODO: use Schema state & filters on version 1.0.0\n\n// class DummyLobbyState extends Schema { // tslint:disable-line\n//   @type(\"number\") public _: number;\n// }\n\n//\n// Strongly-typed client messages for LobbyRoom\n// (This is optional, but recommended for better type safety and code generation for native SDKs)\n//\ntype LobbyClient = Client<{\n  messages: {\n    rooms: IRoomCache[];\n    '+': [roomId: string, room: IRoomCache];\n    '-': string;\n  }\n}>;\n\nexport interface FilterInput {\n  /** Room name to list. Required: a filter without it matches nothing. */\n  name: string;\n\n  /** Narrows the listing to rooms whose metadata has these exact values. */\n  metadata?: any;\n}\n\nexport interface LobbyOptions {\n  filter?: FilterInput;\n}\n\nexport type LobbyMessages = {\n  filter: (client: LobbyClient, filter: FilterInput) => void;\n};\n\nexport class LobbyRoom<Metadata = any> extends Room {\n  public rooms: IRoomCache<Metadata>[] = [];\n  public unsubscribeLobby: () => void;\n\n  public clientOptions: { [sessionId: string]: LobbyOptions } = {};\n\n  declare messages: LobbyMessages;\n\n  public async onCreate(options: any) {\n    // prevent LobbyRoom to notify itself\n    this['_listing'].unlisted = true;\n\n    this.onMessage('filter', (client, filter) => {\n      const clientOptions = this.clientOptions[client.sessionId];\n      if (!clientOptions) { return; }\n\n      clientOptions.filter = filter;\n      client.send('rooms', this.filterItemsForClient(clientOptions));\n    });\n\n    this.unsubscribeLobby = await subscribeLobby((roomId, data) => {\n      const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);\n\n      if (!data) {\n        // remove room listing data\n        if (roomIndex !== -1) {\n          const previousData = this.rooms[roomIndex];\n\n          this.rooms.splice(roomIndex, 1);\n\n          this.#notifyClients((client, filter) => {\n            if (this.filterItemForClient(previousData, filter)) {\n              client.send('-', roomId);\n            }\n          });\n        }\n\n      } else if (roomIndex === -1) {\n        // append room listing data\n        this.rooms.push(data);\n\n        this.#notifyClients((client, filter) => {\n          if (this.filterItemForClient(data, filter)) {\n            client.send('+', [roomId, data]);\n          }\n        });\n\n      } else {\n        const previousData = this.rooms[roomIndex];\n\n        // replace room listing data\n        this.rooms[roomIndex] = data;\n\n        this.#notifyClients((client, filter) => {\n          const hadData = this.filterItemForClient(previousData, filter);\n          const hasData = this.filterItemForClient(data, filter);\n\n          if (hadData && !hasData) {\n            client.send('-', roomId);\n\n          } else if (hasData) {\n            client.send('+', [roomId, data]);\n          }\n        });\n      }\n    });\n\n    this.rooms = await matchMaker.query({ private: false, unlisted: false });\n  }\n\n  public onJoin(client: LobbyClient, options: LobbyOptions) {\n    this.clientOptions[client.sessionId] = (\n      !Array.isArray(options) && // Defold (Lua) sends empty objects as Array instead of object\n      options\n    ) || {};\n    client.send('rooms', this.filterItemsForClient(this.clientOptions[client.sessionId]));\n  }\n\n  public onLeave(client: LobbyClient) {\n    delete this.clientOptions[client.sessionId];\n  }\n\n  public onDispose() {\n    if (this.unsubscribeLobby) {\n      this.unsubscribeLobby();\n    }\n  }\n\n  #notifyClients(notify: (client: LobbyClient, filter: FilterInput) => void) {\n    this.clients.forEach((client) => {\n      const options = this.clientOptions[client.sessionId];\n      if (!options) { return; }\n\n      try {\n        notify(client, options.filter);\n      } catch (e: any) {\n        debugAndPrintError(e); // one client's failure must not skip the rest\n      }\n    });\n  }\n\n  protected filterItemsForClient(options: LobbyOptions): IRoomCache<Metadata>[] {\n    const filter = options.filter;\n\n    return (filter)\n      ? this.rooms.filter((room) => this.filterItemForClient(room, filter))\n      : this.rooms;\n  }\n\n  protected filterItemForClient(room: IRoomCache, filter?: LobbyOptions['filter']) {\n    if (!filter) {\n      return true;\n    }\n\n    let isAllowed = true;\n\n    if (filter.name !== room.name) {\n      isAllowed = false;\n    }\n\n    if (filter.metadata) {\n      for (const field in filter.metadata) {\n        if (room.metadata?.[field] !== filter.metadata[field]) {\n          isAllowed = false;\n          break;\n        }\n      }\n    }\n\n    return isAllowed;\n  }\n\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/rooms/LobbyRoom.d.ts

@@ -9,7 +9,9 @@ type LobbyClient = Client<{
     };
 }>;
 export interface FilterInput {
-    name?: string;
+    /** Room name to list. Required: a filter without it matches nothing. */
+    name: string;
+    /** Narrows the listing to rooms whose metadata has these exact values. */
     metadata?: any;
 }
 export interface LobbyOptions {
@@ -19,6 +21,7 @@ export type LobbyMessages = {
     filter: (client: LobbyClient, filter: FilterInput) => void;
 };
 export declare class LobbyRoom<Metadata = any> extends Room {
+    #private;
     rooms: IRoomCache<Metadata>[];
     unsubscribeLobby: () => void;
     clientOptions: {

package/build/rooms/LobbyRoom.mjs

@@ -1,5 +1,6 @@
 // packages/core/src/rooms/LobbyRoom.ts
 import * as matchMaker from "../MatchMaker.mjs";
+import { debugAndPrintError } from "../Debug.mjs";
 import { subscribeLobby } from "../matchmaker/Lobby.mjs";
 import { Room } from "../Room.mjs";
 var LobbyRoom = class extends Room {
@@ -20,30 +21,29 @@ var LobbyRoom = class extends Room {
     });
     this.unsubscribeLobby = await subscribeLobby((roomId, data) => {
       const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);
-      const clients = this.clients.filter((client) => this.clientOptions[client.sessionId]);
       if (!data) {
         if (roomIndex !== -1) {
           const previousData = this.rooms[roomIndex];
           this.rooms.splice(roomIndex, 1);
-          clients.forEach((client) => {
-            if (this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter)) {
+          this.#notifyClients((client, filter) => {
+            if (this.filterItemForClient(previousData, filter)) {
               client.send("-", roomId);
             }
           });
         }
       } else if (roomIndex === -1) {
         this.rooms.push(data);
-        clients.forEach((client) => {
-          if (this.filterItemForClient(data, this.clientOptions[client.sessionId].filter)) {
+        this.#notifyClients((client, filter) => {
+          if (this.filterItemForClient(data, filter)) {
             client.send("+", [roomId, data]);
           }
         });
       } else {
         const previousData = this.rooms[roomIndex];
         this.rooms[roomIndex] = data;
-        clients.forEach((client) => {
-          const hadData = this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter);
-          const hasData = this.filterItemForClient(data, this.clientOptions[client.sessionId].filter);
+        this.#notifyClients((client, filter) => {
+          const hadData = this.filterItemForClient(previousData, filter);
+          const hasData = this.filterItemForClient(data, filter);
           if (hadData && !hasData) {
             client.send("-", roomId);
           } else if (hasData) {
@@ -67,6 +67,19 @@ var LobbyRoom = class extends Room {
       this.unsubscribeLobby();
     }
   }
+  #notifyClients(notify) {
+    this.clients.forEach((client) => {
+      const options = this.clientOptions[client.sessionId];
+      if (!options) {
+        return;
+      }
+      try {
+        notify(client, options.filter);
+      } catch (e) {
+        debugAndPrintError(e);
+      }
+    });
+  }
   filterItemsForClient(options) {
     const filter = options.filter;
     return filter ? this.rooms.filter((room) => this.filterItemForClient(room, filter)) : this.rooms;
@@ -81,7 +94,7 @@ var LobbyRoom = class extends Room {
     }
     if (filter.metadata) {
       for (const field in filter.metadata) {
-        if (room.metadata[field] !== filter.metadata[field]) {
+        if (room.metadata?.[field] !== filter.metadata[field]) {
           isAllowed = false;
           break;
         }

package/build/rooms/LobbyRoom.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/rooms/LobbyRoom.ts"],
-  "sourcesContent": ["import * as matchMaker from '../MatchMaker.ts';\nimport type { IRoomCache } from '../matchmaker/LocalDriver/LocalDriver.ts';\nimport type { Client } from '../Transport.ts';\nimport { subscribeLobby } from '../matchmaker/Lobby.ts';\nimport { Room } from '../Room.ts';\n\n// TODO: use Schema state & filters on version 1.0.0\n\n// class DummyLobbyState extends Schema { // tslint:disable-line\n//   @type(\"number\") public _: number;\n// }\n\n//\n// Strongly-typed client messages for LobbyRoom\n// (This is optional, but recommended for better type safety and code generation for native SDKs)\n//\ntype LobbyClient = Client<{\n  messages: {\n    rooms: IRoomCache[];\n    '+': [roomId: string, room: IRoomCache];\n    '-': string;\n  }\n}>;\n\nexport interface FilterInput {\n  name?: string;\n  metadata?: any;\n}\n\nexport interface LobbyOptions {\n  filter?: FilterInput;\n}\n\nexport type LobbyMessages = {\n  filter: (client: LobbyClient, filter: FilterInput) => void;\n};\n\nexport class LobbyRoom<Metadata = any> extends Room {\n  public rooms: IRoomCache<Metadata>[] = [];\n  public unsubscribeLobby: () => void;\n\n  public clientOptions: { [sessionId: string]: LobbyOptions } = {};\n\n  declare messages: LobbyMessages;\n\n  public async onCreate(options: any) {\n    // prevent LobbyRoom to notify itself\n    this['_listing'].unlisted = true;\n\n    this.onMessage('filter', (client, filter) => {\n      const clientOptions = this.clientOptions[client.sessionId];\n      if (!clientOptions) { return; }\n\n      clientOptions.filter = filter;\n      client.send('rooms', this.filterItemsForClient(clientOptions));\n    });\n\n    this.unsubscribeLobby = await subscribeLobby((roomId, data) => {\n      const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);\n      const clients = this.clients.filter((client) => this.clientOptions[client.sessionId]);\n\n      if (!data) {\n        // remove room listing data\n        if (roomIndex !== -1) {\n          const previousData = this.rooms[roomIndex];\n\n          this.rooms.splice(roomIndex, 1);\n\n          clients.forEach((client) => {\n            if (this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter)) {\n              client.send('-', roomId);\n            }\n          });\n        }\n\n      } else if (roomIndex === -1) {\n        // append room listing data\n        this.rooms.push(data);\n\n        clients.forEach((client) => {\n          if (this.filterItemForClient(data, this.clientOptions[client.sessionId].filter)) {\n            client.send('+', [roomId, data]);\n          }\n        });\n\n      } else {\n        const previousData = this.rooms[roomIndex];\n\n        // replace room listing data\n        this.rooms[roomIndex] = data;\n\n        clients.forEach((client) => {\n          const hadData = this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter);\n          const hasData = this.filterItemForClient(data, this.clientOptions[client.sessionId].filter);\n\n          if (hadData && !hasData) {\n            client.send('-', roomId);\n\n          } else if (hasData) {\n            client.send('+', [roomId, data]);\n          }\n        });\n      }\n    });\n\n    this.rooms = await matchMaker.query({ private: false, unlisted: false });\n  }\n\n  public onJoin(client: LobbyClient, options: LobbyOptions) {\n    this.clientOptions[client.sessionId] = (\n      !Array.isArray(options) && // Defold (Lua) sends empty objects as Array instead of object\n      options\n    ) || {};\n    client.send('rooms', this.filterItemsForClient(this.clientOptions[client.sessionId]));\n  }\n\n  public onLeave(client: LobbyClient) {\n    delete this.clientOptions[client.sessionId];\n  }\n\n  public onDispose() {\n    if (this.unsubscribeLobby) {\n      this.unsubscribeLobby();\n    }\n  }\n\n  protected filterItemsForClient(options: LobbyOptions): IRoomCache<Metadata>[] {\n    const filter = options.filter;\n\n    return (filter)\n      ? this.rooms.filter((room) => this.filterItemForClient(room, filter))\n      : this.rooms;\n  }\n\n  protected filterItemForClient(room: IRoomCache, filter?: LobbyOptions['filter']) {\n    if (!filter) {\n      return true;\n    }\n\n    let isAllowed = true;\n\n    if (filter.name !== room.name) {\n      isAllowed = false;\n    }\n\n    if (filter.metadata) {\n      for (const field in filter.metadata) {\n        if (room.metadata[field] !== filter.metadata[field]) {\n          isAllowed = false;\n          break;\n        }\n      }\n    }\n\n    return isAllowed;\n  }\n\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import * as matchMaker from '../MatchMaker.ts';\nimport { debugAndPrintError } from '../Debug.ts';\nimport type { IRoomCache } from '../matchmaker/LocalDriver/LocalDriver.ts';\nimport type { Client } from '../Transport.ts';\nimport { subscribeLobby } from '../matchmaker/Lobby.ts';\nimport { Room } from '../Room.ts';\n\n// TODO: use Schema state & filters on version 1.0.0\n\n// class DummyLobbyState extends Schema { // tslint:disable-line\n//   @type(\"number\") public _: number;\n// }\n\n//\n// Strongly-typed client messages for LobbyRoom\n// (This is optional, but recommended for better type safety and code generation for native SDKs)\n//\ntype LobbyClient = Client<{\n  messages: {\n    rooms: IRoomCache[];\n    '+': [roomId: string, room: IRoomCache];\n    '-': string;\n  }\n}>;\n\nexport interface FilterInput {\n  /** Room name to list. Required: a filter without it matches nothing. */\n  name: string;\n\n  /** Narrows the listing to rooms whose metadata has these exact values. */\n  metadata?: any;\n}\n\nexport interface LobbyOptions {\n  filter?: FilterInput;\n}\n\nexport type LobbyMessages = {\n  filter: (client: LobbyClient, filter: FilterInput) => void;\n};\n\nexport class LobbyRoom<Metadata = any> extends Room {\n  public rooms: IRoomCache<Metadata>[] = [];\n  public unsubscribeLobby: () => void;\n\n  public clientOptions: { [sessionId: string]: LobbyOptions } = {};\n\n  declare messages: LobbyMessages;\n\n  public async onCreate(options: any) {\n    // prevent LobbyRoom to notify itself\n    this['_listing'].unlisted = true;\n\n    this.onMessage('filter', (client, filter) => {\n      const clientOptions = this.clientOptions[client.sessionId];\n      if (!clientOptions) { return; }\n\n      clientOptions.filter = filter;\n      client.send('rooms', this.filterItemsForClient(clientOptions));\n    });\n\n    this.unsubscribeLobby = await subscribeLobby((roomId, data) => {\n      const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);\n\n      if (!data) {\n        // remove room listing data\n        if (roomIndex !== -1) {\n          const previousData = this.rooms[roomIndex];\n\n          this.rooms.splice(roomIndex, 1);\n\n          this.#notifyClients((client, filter) => {\n            if (this.filterItemForClient(previousData, filter)) {\n              client.send('-', roomId);\n            }\n          });\n        }\n\n      } else if (roomIndex === -1) {\n        // append room listing data\n        this.rooms.push(data);\n\n        this.#notifyClients((client, filter) => {\n          if (this.filterItemForClient(data, filter)) {\n            client.send('+', [roomId, data]);\n          }\n        });\n\n      } else {\n        const previousData = this.rooms[roomIndex];\n\n        // replace room listing data\n        this.rooms[roomIndex] = data;\n\n        this.#notifyClients((client, filter) => {\n          const hadData = this.filterItemForClient(previousData, filter);\n          const hasData = this.filterItemForClient(data, filter);\n\n          if (hadData && !hasData) {\n            client.send('-', roomId);\n\n          } else if (hasData) {\n            client.send('+', [roomId, data]);\n          }\n        });\n      }\n    });\n\n    this.rooms = await matchMaker.query({ private: false, unlisted: false });\n  }\n\n  public onJoin(client: LobbyClient, options: LobbyOptions) {\n    this.clientOptions[client.sessionId] = (\n      !Array.isArray(options) && // Defold (Lua) sends empty objects as Array instead of object\n      options\n    ) || {};\n    client.send('rooms', this.filterItemsForClient(this.clientOptions[client.sessionId]));\n  }\n\n  public onLeave(client: LobbyClient) {\n    delete this.clientOptions[client.sessionId];\n  }\n\n  public onDispose() {\n    if (this.unsubscribeLobby) {\n      this.unsubscribeLobby();\n    }\n  }\n\n  #notifyClients(notify: (client: LobbyClient, filter: FilterInput) => void) {\n    this.clients.forEach((client) => {\n      const options = this.clientOptions[client.sessionId];\n      if (!options) { return; }\n\n      try {\n        notify(client, options.filter);\n      } catch (e: any) {\n        debugAndPrintError(e); // one client's failure must not skip the rest\n      }\n    });\n  }\n\n  protected filterItemsForClient(options: LobbyOptions): IRoomCache<Metadata>[] {\n    const filter = options.filter;\n\n    return (filter)\n      ? this.rooms.filter((room) => this.filterItemForClient(room, filter))\n      : this.rooms;\n  }\n\n  protected filterItemForClient(room: IRoomCache, filter?: LobbyOptions['filter']) {\n    if (!filter) {\n      return true;\n    }\n\n    let isAllowed = true;\n\n    if (filter.name !== room.name) {\n      isAllowed = false;\n    }\n\n    if (filter.metadata) {\n      for (const field in filter.metadata) {\n        if (room.metadata?.[field] !== filter.metadata[field]) {\n          isAllowed = false;\n          break;\n        }\n      }\n    }\n\n    return isAllowed;\n  }\n\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@colyseus/core",
-  "version": "0.18.23",
+  "version": "0.18.25",
   "description": "Multiplayer Framework for Node.js.",
   "type": "module",
   "input": "./src/index.ts",
@@ -61,9 +61,9 @@
     "@colyseus/schema": "^5.0.8",
     "express": "^5.0.0",
     "vitest": "^3.1.1",
-    "@colyseus/tools": "^0.18.10",
     "@colyseus/redis-driver": "^0.18.7",
-    "@colyseus/redis-presence": "^0.18.6"
+    "@colyseus/redis-presence": "^0.18.6",
+    "@colyseus/tools": "^0.18.11"
   },
   "peerDependencies": {
     "@colyseus/auth": "0.18.x",

package/src/Room.ts

@@ -797,6 +797,9 @@ export class Room<T extends RoomOptions = RoomOptions> {
    * - `clock.setTimeout` / `clock.setInterval`
    * - `setTimestep` / `setFixedTimestep`
    *
+   * Without this method, an error thrown by an `onMessage` handler is logged and the
+   * room keeps running, while an error thrown by a timer shuts the server down.
+   *
    * (Experimental: this feature is subject to change in the future - we're currently getting feedback to improve it)
    */
   public onUncaughtException?(error: RoomException, methodName: RoomMethodName): void;

package/src/RoomMessages.ts

@@ -197,16 +197,36 @@ export class RoomMessages {
     }
 
     if (this.events.events[messageType]) {
-      this.events.emit(messageType as string, client, message, SEND_CONTEXT);
+      this.#dispatch(this.events.events[messageType], client, message, SEND_CONTEXT);
 
     } else if (this.events.events['*']) {
-      this.events.emit('*', client, messageType, message);
+      this.#dispatch(this.events.events['*'], client, messageType, message);
 
     } else {
       this.#noHandler(client, messageType, message);
     }
   }
 
+  /**
+   * Call the handlers of a fire-and-forget frame. With no reply to carry an error
+   * and nothing above this to catch one, a throw would reach the socket's event
+   * listener and shut the process down, along with every other room in it. So
+   * errors are logged, and the remaining handlers still run. Handlers wrapped for
+   * `onUncaughtException` report their own errors and never throw here.
+   */
+  #dispatch(handlers: Array<(...args: any[]) => any>, ...args: any[]): void {
+    for (let i = 0, length = handlers.length; i < length; i++) {
+      try {
+        const result = handlers[i](...args);
+        if (typeof result?.catch === 'function') {
+          result.catch(debugAndPrintError);
+        }
+      } catch (e: any) {
+        debugAndPrintError(e);
+      }
+    }
+  }
+
   /** Dispatch a `ROOM_REQUEST` frame: same handlers as ROOM_DATA, but the client
    *  opted into a reply, so echo the `requestId` with the outcome. The handler's
    *  reply is decided by what it returns / does to `ctx`: `ctx.reject(reason)` →
@@ -314,10 +334,10 @@ export class RoomMessages {
     }
 
     if (this.events.events[bytesMessageType]) {
-      this.events.emit(bytesMessageType, client, message);
+      this.#dispatch(this.events.events[bytesMessageType], client, message);
 
     } else if (this.events.events['*']) {
-      this.events.emit('*', client, messageType, message);
+      this.#dispatch(this.events.events['*'], client, messageType, message);
 
     } else {
       this.#noHandler(client, messageType, message);

package/src/index.ts

@@ -20,7 +20,7 @@ export {
 // Core classes
 export { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, applySimulatedLatency, parseLatencyEnv, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';
 export { Room, RoomInternalState, validate, type RoomOptions, type DefineInputOptions, type SimulationCallback, type FixedTimestepCallback, type StepContext, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';
-export { InputBufferImpl, compileSanitizer } from './input/InputBuffer.ts';
+export { InputBufferImpl, compileSanitizer, compileSnapshot } from './input/InputBuffer.ts';
 export { type InputAccessor, type InputAPI, type NormalizedInputOptions, type ConsumeOptions, type IdleInput, type IdleContext, type SanitizeInput, type NumericFieldsOf } from './input/types.ts';
 export { Rewind, RewindView, type RewindOptions, type RewindMode } from './Rewind.ts';
 export {

package/src/input/InputBuffer.ts

@@ -1,3 +1,5 @@
+import { $values } from '@colyseus/schema';
+
 import type { ClientPrivate } from '../Transport.ts';
 import { $METADATA } from '../utils/Utils.ts';
 
@@ -43,7 +45,9 @@ export function compileSanitizer<I>(spec: SanitizeInput<I>): (input: I) => void
       // never assigned; the range floor turned "no input" into "held stick").
       if (v === undefined) { continue; }
       // NaN-safe: NaN fails both comparisons → clamp floor.
-      inst[names[i]] = v >= mins[i] ? (v <= maxs[i] ? v : maxs[i]) : mins[i];
+      const clamped = v >= mins[i] ? (v <= maxs[i] ? v : maxs[i]) : mins[i];
+      // Honest frames clamp nothing: a keyed write through the setter costs more than the walk.
+      if (clamped !== v) { inst[names[i]] = clamped; }
     }
   };
 }
@@ -63,6 +67,59 @@ function fieldNamesOf(ctor: new () => any): string[] {
   return names;
 }
 
+/** One per input schema, so every room's frames share a hidden class. */
+const _snapshots = new WeakMap<new () => any, (input: any) => any>();
+
+/**
+ * @internal Compile how a decoded input is copied into the buffer. `clone()`
+ * builds a Schema and its ChangeTree per input, for a frame that's never
+ * encoded, so a schema of plain values gets a lighter frame: its own array of
+ * values behind the ctor's prototype. Methods, getters, `instanceof`, `clone()`
+ * and `toJSON()` all hold, and a field write lands on the copy, untracked. A
+ * nested schema or collection keeps `clone()`, whose copy is deep.
+ *
+ * Fields are read by name, as `clone()` reads them, never by copying `$values`:
+ * native class fields (`useDefineForClassFields`) shadow the schema's accessors,
+ * so the decoder's values sit on the instance and `$values` stays empty.
+ */
+export function compileSnapshot<I>(ctor: new () => I): (input: I) => I {
+  let snapshot = _snapshots.get(ctor);
+  if (snapshot !== undefined) { return snapshot; }
+
+  const md = (ctor as any)[$METADATA] as Record<number, { type?: unknown }> | undefined;
+  const names = fieldNamesOf(ctor);
+  const plain = md !== undefined && names.every((_, i) => {
+    const type = md[i].type;
+    return typeof type === "string" || (type !== null && typeof type === "object" && "quantized" in type);
+  });
+
+  if (plain) {
+    const fields: PropertyDescriptorMap = {};
+    names.forEach((name, i) => {
+      fields[name] = {
+        get(this: any) { return this[$values][i]; },
+        set(this: any, value: unknown) { this[$values][i] = value; },
+        enumerable: true,
+        configurable: true,
+      };
+    });
+    // A function, not a class: `constructor` must stay the schema's (clone/toJSON read its metadata).
+    function Frame(this: any, values: unknown[]) { this[$values] = values; }
+    Frame.prototype = Object.create(ctor.prototype, fields);
+    const count = names.length;
+    snapshot = (input) => {
+      const values = new Array(count);
+      for (let i = 0; i < count; i++) { values[i] = input[names[i]]; }
+      return new (Frame as any)(values);
+    };
+  } else {
+    snapshot = (input) => input.clone();
+  }
+
+  _snapshots.set(ctor, snapshot!);
+  return snapshot!;
+}
+
 /**
  * @internal Seed every declared field that has no construction default with
  * its wire-neutral zero value (0 / false / ""; quantized: 0 clamped into the

package/src/input/RoomInput.ts

@@ -4,7 +4,7 @@ import { HandshakeSection, InputFlags, ProtocolModifier } from '@colyseus/shared
 
 import {
   InputAccessorImpl, InputBufferImpl, NO_OP_INPUT_ACCESSOR,
-  compileSanitizer, seedInputZeroValues, validateSubSteps,
+  compileSanitizer, compileSnapshot, seedInputZeroValues, validateSubSteps,
 } from './InputBuffer.ts';
 import type {
   InputAccessor, InputAPI, NormalizedInputOptions,
@@ -148,6 +148,7 @@ export class RoomInput {
       idle: opts?.idle,
       // Compiled once (map → dense min/max walk); applied per decoded frame.
       sanitize: opts?.sanitize !== undefined ? compileSanitizer(opts.sanitize) : undefined,
+      snapshot: compileSnapshot(type),
       tickRate,
       subSteps: validateSubSteps(opts?.subSteps, 'defineInput'),
     };
@@ -220,15 +221,15 @@ export class RoomInput {
 
   /**
    * Sanitize the freshly-decoded `client._input`, then (when buffering is on)
-   * push a clone into the per-client buffer. Honors the framework seq
+   * push a snapshot into the per-client buffer. Honors the framework seq
    * (unreliable) / a user `inputOptions.seqField` (reliable) to dedupe the
    * redundancy ring.
    */
   capture(client: ClientPrivate, renderTime: number = 0, reckonTime: number = 0, seq?: number): void {
-    // Sanitize before anything reads it (latest, the clone below, the idle ctx).
+    // Sanitize before anything reads it (latest, the snapshot below, the idle ctx).
     this.options.sanitize?.(client._input);
     const buf = client._inputBuffer;
-    if (!buf) { return; } // no consumer registered — skip the clone allocation
+    if (!buf) { return; } // no consumer registered — skip the snapshot allocation
     const inst = client._input!;
     if (seq !== undefined) {
       // Unreliable: dedup the ring by the framework wire seq (user seqField is for .at() only).
@@ -241,7 +242,7 @@ export class RoomInput {
         if (typeof value === 'number' && !buf.accept(value)) { return; }
       }
     }
-    buf.push(inst.clone() as any, renderTime, reckonTime, seq);
+    buf.push(this.options.snapshot(inst), renderTime, reckonTime, seq);
   }
 
   /** Decode a `ROOM_INPUT_RELIABLE` frame: an optional TIMED stamp prefix (shape

package/src/input/types.ts

@@ -193,7 +193,7 @@ export interface NormalizedInputOptions {
   seqField?: string;
 
   /**
-   * > 0 enables per-client buffering of cloned snapshots — required for
+   * > 0 enables per-client buffering of input snapshots — required for
    * `room.inputs.get(sessionId).drain() / .peek() / .at()` to return populated
    * data. Oldest drops on overflow. Set to `0` to disable (`.latest` still
    * works).
@@ -229,6 +229,12 @@ export interface NormalizedInputOptions {
    * `latest` / the buffer / the idle ctx.
    */
   sanitize?: (instance: any) => void;
+
+  /**
+   * COMPILED copy of a decoded frame for the buffer (see `compileSnapshot`).
+   * Reads and writes like the schema, without its change tracking.
+   */
+  snapshot: (instance: any) => any;
 }
 
 /**

package/src/matchmaker/Lobby.ts

@@ -1,4 +1,5 @@
 import * as matchMaker from '../MatchMaker.ts';
+import { debugAndPrintError } from '../Debug.ts';
 
 import type { Room } from '../Room.ts';
 import type { IRoomCache } from './driver.ts';
@@ -38,27 +39,33 @@ export async function subscribeLobby(callback: (roomId: string, roomListing: IRo
   const cb = async (message: string) => {
     const [roomId, isRemove] = message.split(',');
 
-    if (isRemove === '1') {
-      // Mark as removed and process immediately
-      removedRoomIds.add(roomId);
-      callback(roomId, null);
+    try {
+      if (isRemove === '1') {
+        // Mark as removed and process immediately
+        removedRoomIds.add(roomId);
 
-      // Clean up after a short timeout to prevent memory leaks
-      setTimeout(() => removedRoomIds.delete(roomId), 2000);
+        // Clean up after a short timeout to prevent memory leaks
+        setTimeout(() => removedRoomIds.delete(roomId), 2000);
 
-    } else {
-      // Clear removed status - room might be coming back (e.g., visibility change)
-      removedRoomIds.delete(roomId);
+        callback(roomId, null);
 
-      const room = (await matchMaker.query({ roomId }))[0];
+      } else {
+        // Clear removed status - room might be coming back (e.g., visibility change)
+        removedRoomIds.delete(roomId);
 
-      // Check if room was removed while we were querying
-      // See "updating metadata should not cause race condition" test in LobbyRoom.test.ts
-      if (removedRoomIds.has(roomId)) {
-        return;
+        const room = (await matchMaker.query({ roomId }))[0];
+
+        // Check if room was removed while we were querying
+        // See "updating metadata should not cause race condition" test in LobbyRoom.test.ts
+        if (removedRoomIds.has(roomId)) {
+          return;
+        }
+
+        callback(roomId, room);
       }
 
-      callback(roomId, room);
+    } catch (e: any) {
+      debugAndPrintError(e); // presence listener: nothing above this can catch it
     }
   };
 

package/src/rooms/LobbyRoom.ts

@@ -1,4 +1,5 @@
 import * as matchMaker from '../MatchMaker.ts';
+import { debugAndPrintError } from '../Debug.ts';
 import type { IRoomCache } from '../matchmaker/LocalDriver/LocalDriver.ts';
 import type { Client } from '../Transport.ts';
 import { subscribeLobby } from '../matchmaker/Lobby.ts';
@@ -23,7 +24,10 @@ type LobbyClient = Client<{
 }>;
 
 export interface FilterInput {
-  name?: string;
+  /** Room name to list. Required: a filter without it matches nothing. */
+  name: string;
+
+  /** Narrows the listing to rooms whose metadata has these exact values. */
   metadata?: any;
 }
 
@@ -57,7 +61,6 @@ export class LobbyRoom<Metadata = any> extends Room {
 
     this.unsubscribeLobby = await subscribeLobby((roomId, data) => {
       const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);
-      const clients = this.clients.filter((client) => this.clientOptions[client.sessionId]);
 
       if (!data) {
         // remove room listing data
@@ -66,8 +69,8 @@ export class LobbyRoom<Metadata = any> extends Room {
 
           this.rooms.splice(roomIndex, 1);
 
-          clients.forEach((client) => {
-            if (this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter)) {
+          this.#notifyClients((client, filter) => {
+            if (this.filterItemForClient(previousData, filter)) {
               client.send('-', roomId);
             }
           });
@@ -77,8 +80,8 @@ export class LobbyRoom<Metadata = any> extends Room {
         // append room listing data
         this.rooms.push(data);
 
-        clients.forEach((client) => {
-          if (this.filterItemForClient(data, this.clientOptions[client.sessionId].filter)) {
+        this.#notifyClients((client, filter) => {
+          if (this.filterItemForClient(data, filter)) {
             client.send('+', [roomId, data]);
           }
         });
@@ -89,9 +92,9 @@ export class LobbyRoom<Metadata = any> extends Room {
         // replace room listing data
         this.rooms[roomIndex] = data;
 
-        clients.forEach((client) => {
-          const hadData = this.filterItemForClient(previousData, this.clientOptions[client.sessionId].filter);
-          const hasData = this.filterItemForClient(data, this.clientOptions[client.sessionId].filter);
+        this.#notifyClients((client, filter) => {
+          const hadData = this.filterItemForClient(previousData, filter);
+          const hasData = this.filterItemForClient(data, filter);
 
           if (hadData && !hasData) {
             client.send('-', roomId);
@@ -124,6 +127,19 @@ export class LobbyRoom<Metadata = any> extends Room {
     }
   }
 
+  #notifyClients(notify: (client: LobbyClient, filter: FilterInput) => void) {
+    this.clients.forEach((client) => {
+      const options = this.clientOptions[client.sessionId];
+      if (!options) { return; }
+
+      try {
+        notify(client, options.filter);
+      } catch (e: any) {
+        debugAndPrintError(e); // one client's failure must not skip the rest
+      }
+    });
+  }
+
   protected filterItemsForClient(options: LobbyOptions): IRoomCache<Metadata>[] {
     const filter = options.filter;
 
@@ -145,7 +161,7 @@ export class LobbyRoom<Metadata = any> extends Room {
 
     if (filter.metadata) {
       for (const field in filter.metadata) {
-        if (room.metadata[field] !== filter.metadata[field]) {
+        if (room.metadata?.[field] !== filter.metadata[field]) {
           isAllowed = false;
           break;
         }