@colyseus/core 0.14.26 → 0.14.29

package/build/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"index.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}

package/build/index.mjs

@@ -11,7 +11,7 @@ export { LocalDriver } from './matchmaker/driver/index.mjs';
 export { ClientState, Transport } from './Transport.mjs';
 export { LocalPresence } from './presence/LocalPresence.mjs';
 export { SchemaSerializer } from './serializer/SchemaSerializer.mjs';
-export { Deferred, generateId, spliceOne } from './Utils.mjs';
+export { Deferred, DummyServer, generateId, spliceOne } from './Utils.mjs';
 export { debugAndPrintError, debugConnection, debugDriver, debugError, debugMatchMaking, debugPatch, debugPresence } from './Debug.mjs';
 export { LobbyRoom } from './rooms/LobbyRoom.mjs';
 export { RelayRoom } from './rooms/RelayRoom.mjs';

package/build/matchmaker/driver/interfaces.js

@@ -0,0 +1,15 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var interfaces_exports = {};
+module.exports = __toCommonJS(interfaces_exports);

package/build/matchmaker/driver/interfaces.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../../src/matchmaker/driver/interfaces.ts"],
+  "sourcesContent": ["export interface SortOptions { [fieldName: string]: 1 | -1 | 'asc' | 'desc' | 'ascending' | 'descending'; }\n\nexport interface IRoomListingData {\n  clients: number;\n  locked: boolean;\n  private: boolean;\n  maxClients: number;\n  metadata: any;\n  name: string;\n  publicAddress?: string;\n  processId: string;\n  roomId: string;\n  unlisted: boolean;\n  [property: string]: any;\n}\n\nexport interface RoomListingData<Metadata= any> extends IRoomListingData {\n  metadata: Metadata;\n\n  updateOne(operations: any);\n  save();\n  remove();\n}\n\nexport interface QueryHelpers<T> {\n  then: Promise<T>['then'];\n  sort(options: SortOptions);\n}\n\nexport interface MatchMakerDriver {\n  createInstance(initialValues: any): RoomListingData;\n\n  find(\n    conditions: Partial<IRoomListingData>,\n    additionalProjectionFields?: any,\n  ): Promise<RoomListingData[]> | RoomListingData[];\n\n  findOne(conditions: Partial<IRoomListingData>): QueryHelpers<RoomListingData>;\n\n  clear(): void;\n  shutdown(): void;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/build/matchmaker/driver/interfaces.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/presence/Presence.js

@@ -0,0 +1,15 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Presence_exports = {};
+module.exports = __toCommonJS(Presence_exports);

package/build/presence/Presence.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/presence/Presence.ts"],
+  "sourcesContent": ["export interface Presence {\n    subscribe(topic: string, callback: Function);\n    unsubscribe(topic: string, callback?: Function);\n    publish(topic: string, data: any);\n\n    exists(roomId: string): Promise<boolean>;\n\n    setex(key: string, value: string, seconds: number);\n    get(key: string);\n\n    del(key: string): void;\n    sadd(key: string, value: any);\n    smembers(key: string): Promise<string[]>;\n    sismember(key: string, field: string);\n    srem(key: string, value: any);\n    scard(key: string);\n    sinter(...keys: string[]): Promise<string[]>;\n\n    hset(key: string, field: string, value: string);\n    hincrby(key: string, field: string, value: number): number | Promise<number>;\n    hget(key: string, field: string): Promise<string>;\n    hgetall(key: string): Promise<{ [key: string]: string }>;\n    hdel(key: string, field: string);\n    hlen(key: string): Promise<number>;\n\n    incr(key: string): number | Promise<number>;\n    decr(key: string): number | Promise<number>;\n\n    shutdown(): void;\n}\n"],
+  "mappings": ";;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/build/presence/Presence.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/serializer/Serializer.js

@@ -0,0 +1,15 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var Serializer_exports = {};
+module.exports = __toCommonJS(Serializer_exports);

package/build/serializer/Serializer.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/serializer/Serializer.ts"],
+  "sourcesContent": ["import { Client } from '..';\n\nexport interface Serializer<T> {\n  id: string;\n  reset(data: any): void;\n  getFullState(client?: Client): any;\n  applyPatches(clients: Client[], state: T): boolean;\n  handshake?(): number[];\n}\n"],
+  "mappings": ";;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/build/serializer/Serializer.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/types.js

@@ -0,0 +1,15 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var types_exports = {};
+module.exports = __toCommonJS(types_exports);

package/build/types.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/types.ts"],
+  "sourcesContent": ["export type Type<T> = new (...args: any[]) => T;\n"],
+  "mappings": ";;;;;;;;;;;;;AAAA;AAAA;",
+  "names": []
+}

package/build/types.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": [],
+  "sourcesContent": [],
+  "mappings": "",
+  "names": []
+}

package/build/utils/DevMode.d.ts

@@ -0,0 +1,12 @@
+import debug from "debug";
+import type { Room } from "../Room";
+export declare const debugDevMode: debug.IDebugger;
+export declare let isDevMode: boolean;
+export declare function setDevMode(bool: boolean): void;
+export declare function reloadFromCache(): Promise<void>;
+export declare function cacheRoomHistory(rooms: {
+    [roomId: string]: Room;
+}): Promise<void>;
+export declare function getPreviousProcessId(hostname: any): Promise<string>;
+export declare function getRoomRestoreListKey(): string;
+export declare function getProcessRestoreKey(): string;

package/build/utils/DevMode.js

@@ -0,0 +1,108 @@
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target, mod));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var DevMode_exports = {};
+__export(DevMode_exports, {
+  cacheRoomHistory: () => cacheRoomHistory,
+  debugDevMode: () => debugDevMode,
+  getPreviousProcessId: () => getPreviousProcessId,
+  getProcessRestoreKey: () => getProcessRestoreKey,
+  getRoomRestoreListKey: () => getRoomRestoreListKey,
+  isDevMode: () => isDevMode,
+  reloadFromCache: () => reloadFromCache,
+  setDevMode: () => setDevMode
+});
+module.exports = __toCommonJS(DevMode_exports);
+var import_debug = __toESM(require("debug"));
+var import_Debug = require("../Debug");
+var import_MatchMaker = require("../MatchMaker");
+const debugDevMode = (0, import_debug.default)("colyseus:devmode");
+let isDevMode = false;
+function setDevMode(bool) {
+  isDevMode = bool;
+}
+async function reloadFromCache() {
+  const roomHistoryList = Object.entries(await import_MatchMaker.presence.hgetall(getRoomRestoreListKey()));
+  debugDevMode("rooms to restore: %i", roomHistoryList.length);
+  for (const [roomId, value] of roomHistoryList) {
+    let recreatedRoom;
+    const roomHistory = JSON.parse(value);
+    debugDevMode("restoring room %s (%s)", roomHistory.roomName, roomId);
+    const recreatedRoomListing = await (0, import_MatchMaker.handleCreateRoom)(roomHistory.roomName, roomHistory.clientOptions, roomId);
+    console.debug(`\u{1F504} room '${roomId}' has been restored.`);
+    if (roomHistory.hasOwnProperty("state")) {
+      recreatedRoom = (0, import_MatchMaker.getRoomById)(recreatedRoomListing.roomId);
+      recreatedRoom.state.decode(roomHistory.state);
+      recreatedRoom.setState(recreatedRoom.state.clone());
+      console.debug(`\u{1F4CB} room '${roomId}' state =>`, recreatedRoom.state.toJSON());
+    }
+    recreatedRoom.onRestoreRoom?.(roomHistory["cache"]);
+    for (const previousSessionId of roomHistory.clients) {
+      await (0, import_MatchMaker.remoteRoomCall)(recreatedRoomListing.roomId, "_reserveSeat", [previousSessionId, {}, 20, false, true]);
+    }
+  }
+  if (roomHistoryList.length > 0) {
+    console.debug("\u2705", roomHistoryList.length, "room(s) have been restored.");
+  }
+}
+async function cacheRoomHistory(rooms) {
+  for (const room of Object.values(rooms)) {
+    const roomHistoryResult = await import_MatchMaker.presence.hget(getRoomRestoreListKey(), room.roomId);
+    if (roomHistoryResult) {
+      try {
+        const roomHistory = JSON.parse(roomHistoryResult);
+        roomHistory["cache"] = room.onCacheRoom?.();
+        debugDevMode("caching room %s (%s)", room.roomName, room.roomId);
+        if (room.state) {
+          roomHistory["state"] = room.state.encodeAll();
+        }
+        roomHistory["clients"] = room.clients.map((client) => client.sessionId);
+        for (const sessionId in room["reservedSeats"]) {
+          roomHistory["clients"].push(sessionId);
+        }
+        await import_MatchMaker.presence.hset(getRoomRestoreListKey(), room.roomId, JSON.stringify(roomHistory));
+        console.debug(`\u{1F4BE} caching room '${room.roomId}' (clients: ${room.clients.length}, state size: ${(roomHistory["state"] || []).length} bytes)`);
+      } catch (e) {
+        (0, import_Debug.debugAndPrintError)(`\u274C couldn't cache room '${room.roomId}', due to:
+${e.stack}`);
+      }
+    }
+  }
+}
+async function getPreviousProcessId(hostname) {
+  return await import_MatchMaker.presence.hget(getProcessRestoreKey(), hostname);
+}
+function getRoomRestoreListKey() {
+  return "roomhistory";
+}
+function getProcessRestoreKey() {
+  return "processhistory";
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  cacheRoomHistory,
+  debugDevMode,
+  getPreviousProcessId,
+  getProcessRestoreKey,
+  getRoomRestoreListKey,
+  isDevMode,
+  reloadFromCache,
+  setDevMode
+});

package/build/utils/DevMode.js.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/DevMode.ts"],
+  "sourcesContent": ["import debug from \"debug\";\nimport { debugAndPrintError } from \"../Debug\";\n\nimport { getRoomById, handleCreateRoom, presence, remoteRoomCall } from \"../MatchMaker\";\nimport type { Room } from \"../Room\";\n\nexport const debugDevMode = debug('colyseus:devmode');\n\nexport let isDevMode: boolean = false;\n\nexport function setDevMode(bool: boolean) {\n  isDevMode = bool;\n}\n\nexport async function reloadFromCache() {\n  const roomHistoryList = Object.entries(await presence.hgetall(getRoomRestoreListKey()));\n  debugDevMode(\"rooms to restore: %i\", roomHistoryList.length);\n\n  for (const [roomId, value] of roomHistoryList) {\n    let recreatedRoom: Room;\n\n    const roomHistory = JSON.parse(value);\n    debugDevMode(\"restoring room %s (%s)\", roomHistory.roomName, roomId);\n\n    const recreatedRoomListing = await handleCreateRoom(roomHistory.roomName, roomHistory.clientOptions, roomId);\n    console.debug(`\uD83D\uDD04 room '${roomId}' has been restored.`);\n\n    // Set previous state\n    if (roomHistory.hasOwnProperty(\"state\")) {\n      recreatedRoom = getRoomById(recreatedRoomListing.roomId);\n      recreatedRoom.state.decode(roomHistory.state);\n\n      //\n      // WORKAROUND: @colyseus/schema is not capable of encoding a decoded\n      // state. thus, we need a fresh clone immediately after decoding\n      //\n      recreatedRoom.setState(recreatedRoom.state.clone());\n      console.debug(`\uD83D\uDCCB room '${roomId}' state =>`, recreatedRoom.state.toJSON());\n    }\n\n    // call `onRestoreRoom` with custom 'cache'd property.\n    recreatedRoom.onRestoreRoom?.(roomHistory[\"cache\"]);\n\n    // Reserve seats for clients from cached history\n    for (const previousSessionId of roomHistory.clients) {\n      await remoteRoomCall(recreatedRoomListing.roomId, '_reserveSeat',\n        [previousSessionId, {}, 20, false, true]); // reserve seat for 20 seconds\n    }\n  }\n\n  if (roomHistoryList.length > 0) {\n    console.debug(\"\u2705\", roomHistoryList.length, \"room(s) have been restored.\");\n  }\n}\n\nexport async function cacheRoomHistory(rooms: { [roomId: string]: Room }) {\n  for (const room of Object.values(rooms)) {\n    const roomHistoryResult = await presence.hget(getRoomRestoreListKey(), room.roomId);\n    if (roomHistoryResult) {\n      try {\n        const roomHistory = JSON.parse(roomHistoryResult);\n\n        // custom cache method\n        roomHistory[\"cache\"] = room.onCacheRoom?.();\n\n        // encode state\n        debugDevMode(\"caching room %s (%s)\", room.roomName, room.roomId);\n\n        if (room.state) {\n          roomHistory[\"state\"] = room.state.encodeAll();\n        }\n\n        // cache active clients and reserved seats\n        roomHistory[\"clients\"] = room.clients.map((client) => client.sessionId);\n\n        for (const sessionId in room['reservedSeats']) {\n          roomHistory[\"clients\"].push(sessionId);\n        }\n\n        await presence.hset(getRoomRestoreListKey(), room.roomId, JSON.stringify(roomHistory));\n\n        // Rewrite updated room history\n        console.debug(`\uD83D\uDCBE caching room '${room.roomId}' (clients: ${room.clients.length}, state size: ${(roomHistory[\"state\"] || []).length} bytes)`);\n\n      } catch (e) {\n        debugAndPrintError(`\u274C couldn't cache room '${room.roomId}', due to:\\n${e.stack}`);\n      }\n    }\n  }\n}\n\nexport async function getPreviousProcessId(hostname) {\n  return await presence.hget(getProcessRestoreKey(), hostname);\n}\n\nexport function getRoomRestoreListKey() {\n  return 'roomhistory';\n}\n\nexport function getProcessRestoreKey() {\n  return 'processhistory';\n}"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAkB;AAClB,mBAAmC;AAEnC,wBAAwE;AAGjE,MAAM,eAAe,0BAAM,kBAAkB;AAE7C,IAAI,YAAqB;AAEzB,oBAAoB,MAAe;AACxC,cAAY;AACd;AAEA,iCAAwC;AACtC,QAAM,kBAAkB,OAAO,QAAQ,MAAM,2BAAS,QAAQ,sBAAsB,CAAC,CAAC;AACtF,eAAa,wBAAwB,gBAAgB,MAAM;AAE3D,aAAW,CAAC,QAAQ,UAAU,iBAAiB;AAC7C,QAAI;AAEJ,UAAM,cAAc,KAAK,MAAM,KAAK;AACpC,iBAAa,0BAA0B,YAAY,UAAU,MAAM;AAEnE,UAAM,uBAAuB,MAAM,wCAAiB,YAAY,UAAU,YAAY,eAAe,MAAM;AAC3G,YAAQ,MAAM,mBAAY,4BAA4B;AAGtD,QAAI,YAAY,eAAe,OAAO,GAAG;AACvC,sBAAgB,mCAAY,qBAAqB,MAAM;AACvD,oBAAc,MAAM,OAAO,YAAY,KAAK;AAM5C,oBAAc,SAAS,cAAc,MAAM,MAAM,CAAC;AAClD,cAAQ,MAAM,mBAAY,oBAAoB,cAAc,MAAM,OAAO,CAAC;AAAA,IAC5E;AAGA,kBAAc,gBAAgB,YAAY,QAAQ;AAGlD,eAAW,qBAAqB,YAAY,SAAS;AACnD,YAAM,sCAAe,qBAAqB,QAAQ,gBAChD,CAAC,mBAAmB,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC;AAAA,IAC5C;AAAA,EACF;AAEA,MAAI,gBAAgB,SAAS,GAAG;AAC9B,YAAQ,MAAM,UAAK,gBAAgB,QAAQ,6BAA6B;AAAA,EAC1E;AACF;AAEA,gCAAuC,OAAmC;AACxE,aAAW,QAAQ,OAAO,OAAO,KAAK,GAAG;AACvC,UAAM,oBAAoB,MAAM,2BAAS,KAAK,sBAAsB,GAAG,KAAK,MAAM;AAClF,QAAI,mBAAmB;AACrB,UAAI;AACF,cAAM,cAAc,KAAK,MAAM,iBAAiB;AAGhD,oBAAY,WAAW,KAAK,cAAc;AAG1C,qBAAa,wBAAwB,KAAK,UAAU,KAAK,MAAM;AAE/D,YAAI,KAAK,OAAO;AACd,sBAAY,WAAW,KAAK,MAAM,UAAU;AAAA,QAC9C;AAGA,oBAAY,aAAa,KAAK,QAAQ,IAAI,CAAC,WAAW,OAAO,SAAS;AAEtE,mBAAW,aAAa,KAAK,kBAAkB;AAC7C,sBAAY,WAAW,KAAK,SAAS;AAAA,QACvC;AAEA,cAAM,2BAAS,KAAK,sBAAsB,GAAG,KAAK,QAAQ,KAAK,UAAU,WAAW,CAAC;AAGrF,gBAAQ,MAAM,2BAAoB,KAAK,qBAAqB,KAAK,QAAQ,uBAAwB,aAAY,YAAY,CAAC,GAAG,eAAe;AAAA,MAE9I,SAAS,GAAP;AACA,6CAAmB,+BAA0B,KAAK;AAAA,EAAqB,EAAE,OAAO;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AACF;AAEA,oCAA2C,UAAU;AACnD,SAAO,MAAM,2BAAS,KAAK,qBAAqB,GAAG,QAAQ;AAC7D;AAEO,iCAAiC;AACtC,SAAO;AACT;AAEO,gCAAgC;AACrC,SAAO;AACT;",
+  "names": []
+}

package/build/utils/DevMode.mjs

@@ -0,0 +1,75 @@
+import debug from "debug";
+import { debugAndPrintError } from "../Debug";
+import { getRoomById, handleCreateRoom, presence, remoteRoomCall } from "../MatchMaker";
+const debugDevMode = debug("colyseus:devmode");
+let isDevMode = false;
+function setDevMode(bool) {
+  isDevMode = bool;
+}
+async function reloadFromCache() {
+  const roomHistoryList = Object.entries(await presence.hgetall(getRoomRestoreListKey()));
+  debugDevMode("rooms to restore: %i", roomHistoryList.length);
+  for (const [roomId, value] of roomHistoryList) {
+    let recreatedRoom;
+    const roomHistory = JSON.parse(value);
+    debugDevMode("restoring room %s (%s)", roomHistory.roomName, roomId);
+    const recreatedRoomListing = await handleCreateRoom(roomHistory.roomName, roomHistory.clientOptions, roomId);
+    console.debug(`\u{1F504} room '${roomId}' has been restored.`);
+    if (roomHistory.hasOwnProperty("state")) {
+      recreatedRoom = getRoomById(recreatedRoomListing.roomId);
+      recreatedRoom.state.decode(roomHistory.state);
+      recreatedRoom.setState(recreatedRoom.state.clone());
+      console.debug(`\u{1F4CB} room '${roomId}' state =>`, recreatedRoom.state.toJSON());
+    }
+    recreatedRoom.onRestoreRoom?.(roomHistory["cache"]);
+    for (const previousSessionId of roomHistory.clients) {
+      await remoteRoomCall(recreatedRoomListing.roomId, "_reserveSeat", [previousSessionId, {}, 20, false, true]);
+    }
+  }
+  if (roomHistoryList.length > 0) {
+    console.debug("\u2705", roomHistoryList.length, "room(s) have been restored.");
+  }
+}
+async function cacheRoomHistory(rooms) {
+  for (const room of Object.values(rooms)) {
+    const roomHistoryResult = await presence.hget(getRoomRestoreListKey(), room.roomId);
+    if (roomHistoryResult) {
+      try {
+        const roomHistory = JSON.parse(roomHistoryResult);
+        roomHistory["cache"] = room.onCacheRoom?.();
+        debugDevMode("caching room %s (%s)", room.roomName, room.roomId);
+        if (room.state) {
+          roomHistory["state"] = room.state.encodeAll();
+        }
+        roomHistory["clients"] = room.clients.map((client) => client.sessionId);
+        for (const sessionId in room["reservedSeats"]) {
+          roomHistory["clients"].push(sessionId);
+        }
+        await presence.hset(getRoomRestoreListKey(), room.roomId, JSON.stringify(roomHistory));
+        console.debug(`\u{1F4BE} caching room '${room.roomId}' (clients: ${room.clients.length}, state size: ${(roomHistory["state"] || []).length} bytes)`);
+      } catch (e) {
+        debugAndPrintError(`\u274C couldn't cache room '${room.roomId}', due to:
+${e.stack}`);
+      }
+    }
+  }
+}
+async function getPreviousProcessId(hostname) {
+  return await presence.hget(getProcessRestoreKey(), hostname);
+}
+function getRoomRestoreListKey() {
+  return "roomhistory";
+}
+function getProcessRestoreKey() {
+  return "processhistory";
+}
+export {
+  cacheRoomHistory,
+  debugDevMode,
+  getPreviousProcessId,
+  getProcessRestoreKey,
+  getRoomRestoreListKey,
+  isDevMode,
+  reloadFromCache,
+  setDevMode
+};

package/build/utils/DevMode.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/utils/DevMode.ts"],
+  "sourcesContent": ["import debug from \"debug\";\nimport { debugAndPrintError } from \"../Debug\";\n\nimport { getRoomById, handleCreateRoom, presence, remoteRoomCall } from \"../MatchMaker\";\nimport type { Room } from \"../Room\";\n\nexport const debugDevMode = debug('colyseus:devmode');\n\nexport let isDevMode: boolean = false;\n\nexport function setDevMode(bool: boolean) {\n  isDevMode = bool;\n}\n\nexport async function reloadFromCache() {\n  const roomHistoryList = Object.entries(await presence.hgetall(getRoomRestoreListKey()));\n  debugDevMode(\"rooms to restore: %i\", roomHistoryList.length);\n\n  for (const [roomId, value] of roomHistoryList) {\n    let recreatedRoom: Room;\n\n    const roomHistory = JSON.parse(value);\n    debugDevMode(\"restoring room %s (%s)\", roomHistory.roomName, roomId);\n\n    const recreatedRoomListing = await handleCreateRoom(roomHistory.roomName, roomHistory.clientOptions, roomId);\n    console.debug(`\uD83D\uDD04 room '${roomId}' has been restored.`);\n\n    // Set previous state\n    if (roomHistory.hasOwnProperty(\"state\")) {\n      recreatedRoom = getRoomById(recreatedRoomListing.roomId);\n      recreatedRoom.state.decode(roomHistory.state);\n\n      //\n      // WORKAROUND: @colyseus/schema is not capable of encoding a decoded\n      // state. thus, we need a fresh clone immediately after decoding\n      //\n      recreatedRoom.setState(recreatedRoom.state.clone());\n      console.debug(`\uD83D\uDCCB room '${roomId}' state =>`, recreatedRoom.state.toJSON());\n    }\n\n    // call `onRestoreRoom` with custom 'cache'd property.\n    recreatedRoom.onRestoreRoom?.(roomHistory[\"cache\"]);\n\n    // Reserve seats for clients from cached history\n    for (const previousSessionId of roomHistory.clients) {\n      await remoteRoomCall(recreatedRoomListing.roomId, '_reserveSeat',\n        [previousSessionId, {}, 20, false, true]); // reserve seat for 20 seconds\n    }\n  }\n\n  if (roomHistoryList.length > 0) {\n    console.debug(\"\u2705\", roomHistoryList.length, \"room(s) have been restored.\");\n  }\n}\n\nexport async function cacheRoomHistory(rooms: { [roomId: string]: Room }) {\n  for (const room of Object.values(rooms)) {\n    const roomHistoryResult = await presence.hget(getRoomRestoreListKey(), room.roomId);\n    if (roomHistoryResult) {\n      try {\n        const roomHistory = JSON.parse(roomHistoryResult);\n\n        // custom cache method\n        roomHistory[\"cache\"] = room.onCacheRoom?.();\n\n        // encode state\n        debugDevMode(\"caching room %s (%s)\", room.roomName, room.roomId);\n\n        if (room.state) {\n          roomHistory[\"state\"] = room.state.encodeAll();\n        }\n\n        // cache active clients and reserved seats\n        roomHistory[\"clients\"] = room.clients.map((client) => client.sessionId);\n\n        for (const sessionId in room['reservedSeats']) {\n          roomHistory[\"clients\"].push(sessionId);\n        }\n\n        await presence.hset(getRoomRestoreListKey(), room.roomId, JSON.stringify(roomHistory));\n\n        // Rewrite updated room history\n        console.debug(`\uD83D\uDCBE caching room '${room.roomId}' (clients: ${room.clients.length}, state size: ${(roomHistory[\"state\"] || []).length} bytes)`);\n\n      } catch (e) {\n        debugAndPrintError(`\u274C couldn't cache room '${room.roomId}', due to:\\n${e.stack}`);\n      }\n    }\n  }\n}\n\nexport async function getPreviousProcessId(hostname) {\n  return await presence.hget(getProcessRestoreKey(), hostname);\n}\n\nexport function getRoomRestoreListKey() {\n  return 'roomhistory';\n}\n\nexport function getProcessRestoreKey() {\n  return 'processhistory';\n}"],
+  "mappings": "AAAA;AACA;AAEA;AAGO,MAAM,eAAe,MAAM,kBAAkB;AAE7C,IAAI,YAAqB;AAEzB,oBAAoB,MAAe;AACxC,cAAY;AACd;AAEA,iCAAwC;AACtC,QAAM,kBAAkB,OAAO,QAAQ,MAAM,SAAS,QAAQ,sBAAsB,CAAC,CAAC;AACtF,eAAa,wBAAwB,gBAAgB,MAAM;AAE3D,aAAW,CAAC,QAAQ,UAAU,iBAAiB;AAC7C,QAAI;AAEJ,UAAM,cAAc,KAAK,MAAM,KAAK;AACpC,iBAAa,0BAA0B,YAAY,UAAU,MAAM;AAEnE,UAAM,uBAAuB,MAAM,iBAAiB,YAAY,UAAU,YAAY,eAAe,MAAM;AAC3G,YAAQ,MAAM,mBAAY,4BAA4B;AAGtD,QAAI,YAAY,eAAe,OAAO,GAAG;AACvC,sBAAgB,YAAY,qBAAqB,MAAM;AACvD,oBAAc,MAAM,OAAO,YAAY,KAAK;AAM5C,oBAAc,SAAS,cAAc,MAAM,MAAM,CAAC;AAClD,cAAQ,MAAM,mBAAY,oBAAoB,cAAc,MAAM,OAAO,CAAC;AAAA,IAC5E;AAGA,kBAAc,gBAAgB,YAAY,QAAQ;AAGlD,eAAW,qBAAqB,YAAY,SAAS;AACnD,YAAM,eAAe,qBAAqB,QAAQ,gBAChD,CAAC,mBAAmB,CAAC,GAAG,IAAI,OAAO,IAAI,CAAC;AAAA,IAC5C;AAAA,EACF;AAEA,MAAI,gBAAgB,SAAS,GAAG;AAC9B,YAAQ,MAAM,UAAK,gBAAgB,QAAQ,6BAA6B;AAAA,EAC1E;AACF;AAEA,gCAAuC,OAAmC;AACxE,aAAW,QAAQ,OAAO,OAAO,KAAK,GAAG;AACvC,UAAM,oBAAoB,MAAM,SAAS,KAAK,sBAAsB,GAAG,KAAK,MAAM;AAClF,QAAI,mBAAmB;AACrB,UAAI;AACF,cAAM,cAAc,KAAK,MAAM,iBAAiB;AAGhD,oBAAY,WAAW,KAAK,cAAc;AAG1C,qBAAa,wBAAwB,KAAK,UAAU,KAAK,MAAM;AAE/D,YAAI,KAAK,OAAO;AACd,sBAAY,WAAW,KAAK,MAAM,UAAU;AAAA,QAC9C;AAGA,oBAAY,aAAa,KAAK,QAAQ,IAAI,CAAC,WAAW,OAAO,SAAS;AAEtE,mBAAW,aAAa,KAAK,kBAAkB;AAC7C,sBAAY,WAAW,KAAK,SAAS;AAAA,QACvC;AAEA,cAAM,SAAS,KAAK,sBAAsB,GAAG,KAAK,QAAQ,KAAK,UAAU,WAAW,CAAC;AAGrF,gBAAQ,MAAM,2BAAoB,KAAK,qBAAqB,KAAK,QAAQ,uBAAwB,aAAY,YAAY,CAAC,GAAG,eAAe;AAAA,MAE9I,SAAS,GAAP;AACA,2BAAmB,+BAA0B,KAAK;AAAA,EAAqB,EAAE,OAAO;AAAA,MAClF;AAAA,IACF;AAAA,EACF;AACF;AAEA,oCAA2C,UAAU;AACnD,SAAO,MAAM,SAAS,KAAK,qBAAqB,GAAG,QAAQ;AAC7D;AAEO,iCAAiC;AACtC,SAAO;AACT;AAEO,gCAAgC;AACrC,SAAO;AACT;",
+  "names": []
+}

package/build/utils/Utils.d.ts

@@ -0,0 +1,49 @@
+/// <reference types="node" />
+import { EventEmitter } from "events";
+import { ServerOpts, Socket } from "net";
+export declare const REMOTE_ROOM_SHORT_TIMEOUT: number;
+export declare function generateId(length?: number): any;
+export declare function registerGracefulShutdown(callback: (err?: Error) => void): void;
+export declare function retry<T = any>(cb: Function, maxRetries?: number, errorWhiteList?: any[], retries?: number): Promise<T>;
+export declare function spliceOne(arr: any[], index: number): boolean;
+export declare class Deferred<T = any> {
+    promise: Promise<T>;
+    resolve: Function;
+    reject: Function;
+    constructor();
+    then(func: (value: T) => any): any;
+    catch(func: (value: any) => any): Promise<any>;
+}
+export declare function merge(a: any, ...objs: any[]): any;
+export declare class HybridArray<T> {
+    uniqueProperty: string;
+    hashedArray: {
+        [key: string]: T;
+    };
+    array: T[];
+    constructor(uniquePropertyName: string, items?: T[]);
+    get length(): number;
+    add(item: T): void;
+    at(index: number): T | undefined;
+    concat(items: T[]): this;
+    find<S extends T>(predicate: (this: void, value: T, index: number, obj: T[]) => value is S, thisArg?: any): S;
+    find(predicate: (value: T, index: number, obj: T[]) => unknown, thisArg?: any): T;
+    filter(predicate: (value: T, index: number, array: T[]) => unknown, thisArg?: any): T[];
+    forEach(callbackfn: (value: T, index: number, array: T[]) => void, thisArg?: any): void;
+    get(key: string): T | undefined;
+    includes(element: T): boolean;
+    indexOf(element: T): number;
+    map<U>(callback: (value: T, index: number, array: T[]) => U): U[];
+    deleteAt(index: number): T;
+    deleteByKey(key: string): T;
+    delete(obj: T): T;
+    private _badIndexWarning;
+    private spliceOne;
+}
+export declare interface DummyServer {
+    constructor(options?: ServerOpts, connectionListener?: (socket: Socket) => void): any;
+    listen(port?: number, hostname?: string, backlog?: number, listeningListener?: () => void): this;
+    close(callback?: (err?: Error) => void): this;
+}
+export declare class DummyServer extends EventEmitter {
+}