@colyseus/core 0.15.45 → 0.16.0-alpha.23

package/README.md

@@ -7,19 +7,19 @@
   <a href="https://npmjs.com/package/colyseus">
     <img src="https://img.shields.io/npm/dm/colyseus.svg?style=for-the-badge&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QAAKqNIzIAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAHdElNRQfjAgETESWYxR33AAAAtElEQVQoz4WQMQrCQBRE38Z0QoTcwF4Qg1h4BO0sxGOk80iCtViksrIQRRBTewWxMI1mbELYjYu+4rPMDPtn12ChMT3gavb4US5Jym0tcBIta3oDHv4Gwmr7nC4QAxBrCdzM2q6XqUnm9m9r59h7Rc0n2pFv24k4ttGMUXW+sGELTJjSr7QDKuqLS6UKFChVWWuFkZw9Z2AAvAirKT+JTlppIRnd6XgaP4goefI2Shj++OnjB3tBmHYK8z9zAAAAJXRFWHRkYXRlOmNyZWF0ZQAyMDE5LTAyLTAxVDE4OjE3OjM3KzAxOjAwGQQixQAAACV0RVh0ZGF0ZTptb2RpZnkAMjAxOS0wMi0wMVQxODoxNzozNyswMTowMGhZmnkAAAAZdEVYdFNvZnR3YXJlAHd3dy5pbmtzY2FwZS5vcmeb7jwaAAAAAElFTkSuQmCC">
   </a>
-  <a href="https://github.com/colyseus/colyseus/discussions" title="Discuss on Forum">
-    <img src="https://img.shields.io/badge/discuss-on%20forum-brightgreen.svg?style=for-the-badge&colorB=0069b8&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QAAKqNIzIAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAHdElNRQfjAgETDROxCNUzAAABB0lEQVQoz4WRvyvEARjGP193CnWRH+dHQmGwKZtFGcSmxHAL400GN95ktIpV2dzlLzDJgsGgGNRdDAzoQueS/PgY3HXHyT3T+/Y87/s89UANBKXBdoZo5J6L4K1K5ZxHfnjnlQUf3bKvkgy57a0r9hS3cXfMO1kWJMza++tj3Ac7/LY343x1NA9cNmYMwnSS/SP8JVFuSJmr44iFqvtmpjhmhBCrOOazCesq6H4P3bPBjFoIBydOk2bUA17I080Es+wSZ51B4DIA2zgjSpYcEe44Js01G0XjRcCU+y4ZMrDeLmfc9EnVd5M/o0VMeu6nJZxWJivLmhyw1WHTvrr2b4+2OFqra+ALwouTMDcqmjMAAAAldEVYdGRhdGU6Y3JlYXRlADIwMTktMDItMDFUMTg6MTM6MTkrMDE6MDAC9f6fAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDE5LTAyLTAxVDE4OjEzOjE5KzAxOjAwc6hGIwAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAAASUVORK5CYII=" alt="Discussion forum" />
-  </a>
   <a href="http://chat.colyseus.io">
     <img src="https://img.shields.io/discord/525739117951320081.svg?style=for-the-badge&colorB=7581dc&logo=discord&logoColor=white">
   </a>
+  <a href="https://github.com/colyseus/colyseus/discussions" title="Discuss on Forum">
+    <img src="https://img.shields.io/badge/discuss-on%20forum-brightgreen.svg?style=for-the-badge&colorB=0069b8&logo=data:image/png;base64,iVBORw0KGgoAAAANSUhEUgAAABAAAAAQCAQAAAC1+jfqAAAABGdBTUEAALGPC/xhBQAAACBjSFJNAAB6JgAAgIQAAPoAAACA6AAAdTAAAOpgAAA6mAAAF3CculE8AAAAAmJLR0QAAKqNIzIAAAAJcEhZcwAADsQAAA7EAZUrDhsAAAAHdElNRQfjAgETDROxCNUzAAABB0lEQVQoz4WRvyvEARjGP193CnWRH+dHQmGwKZtFGcSmxHAL400GN95ktIpV2dzlLzDJgsGgGNRdDAzoQueS/PgY3HXHyT3T+/Y87/s89UANBKXBdoZo5J6L4K1K5ZxHfnjnlQUf3bKvkgy57a0r9hS3cXfMO1kWJMza++tj3Ac7/LY343x1NA9cNmYMwnSS/SP8JVFuSJmr44iFqvtmpjhmhBCrOOazCesq6H4P3bPBjFoIBydOk2bUA17I080Es+wSZ51B4DIA2zgjSpYcEe44Js01G0XjRcCU+y4ZMrDeLmfc9EnVd5M/o0VMeu6nJZxWJivLmhyw1WHTvrr2b4+2OFqra+ALwouTMDcqmjMAAAAldEVYdGRhdGU6Y3JlYXRlADIwMTktMDItMDFUMTg6MTM6MTkrMDE6MDAC9f6fAAAAJXRFWHRkYXRlOm1vZGlmeQAyMDE5LTAyLTAxVDE4OjEzOjE5KzAxOjAwc6hGIwAAABl0RVh0U29mdHdhcmUAd3d3Lmlua3NjYXBlLm9yZ5vuPBoAAAAASUVORK5CYII=" alt="Discussion forum" />
+  </a>
   <h3>
     Multiplayer Framework for Node.js. <br /><a href="https://docs.colyseus.io/">View documentation</a>
   </h3>
 </div>
 
-Colyseus is an Authoritative Multiplayer Framework for Node.js, with clients
-available for the Web, Unity3d, Defold, Haxe, and Cocos. ([See official clients](#%EF%B8%8F-official-client-integration))
+Colyseus is an Authoritative Multiplayer Framework for Node.js, with SDKs
+available for the Web, Unity, Defold, Haxe, Cocos and Construct3. ([See official SDKs](https://docs.colyseus.io/client/))
 
 The project focuses on providing synchronizable data structures for realtime and
 turn-based games, matchmaking, and ease of usage both on the server-side and

package/build/IPC.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/IPC.ts"],
-  "sourcesContent": ["import { debugAndPrintError } from './Debug';\nimport { Presence } from './presence/Presence';\nimport { IpcProtocol } from './Protocol';\nimport { generateId, REMOTE_ROOM_SHORT_TIMEOUT } from './utils/Utils';\n\nexport async function requestFromIPC<T>(\n  presence: Presence,\n  publishToChannel: string,\n  method: string,\n  args: any[],\n  rejectionTimeout: number = REMOTE_ROOM_SHORT_TIMEOUT,\n): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let unsubscribeTimeout: NodeJS.Timer;\n\n    const requestId = generateId();\n    const channel = `ipc:${requestId}`;\n\n    const unsubscribe = () => {\n      presence.unsubscribe(channel);\n      clearTimeout(unsubscribeTimeout);\n    };\n\n    presence.subscribe(channel, (message) => {\n      const [code, data] = message;\n      if (code === IpcProtocol.SUCCESS) {\n        resolve(data);\n\n      } else if (code === IpcProtocol.ERROR) {\n        let error: any = data;\n\n        // parse error message + code\n        try { error = JSON.parse(data) } catch (e) {}\n\n        // turn string message into Error instance\n        if (typeof(error) === \"string\") {\n          error = new Error(error);\n        }\n\n        reject(error);\n      }\n      unsubscribe();\n    });\n\n    presence.publish(publishToChannel, [method, requestId, args]);\n\n    unsubscribeTimeout = setTimeout(() => {\n      unsubscribe();\n      reject(new Error(\"ipc_timeout\"));\n    }, rejectionTimeout);\n  });\n}\n\nexport async function subscribeIPC(\n  presence: Presence,\n  processId: string,\n  channel: string,\n  replyCallback: (method: string, args: any[]) => any,\n) {\n  await presence.subscribe(channel, (message) => {\n    const [method, requestId, args] = message;\n\n    const reply = (code, data) => {\n      presence.publish(`ipc:${requestId}`, [code, data]);\n    };\n\n    // reply with method result\n    let response: any;\n    try {\n      response = replyCallback(method, args);\n\n    } catch (e) {\n      debugAndPrintError(e);\n      const error = (typeof(e.code) !== \"undefined\")\n        ? { code: e.code, message: e.message }\n        : e.message;\n      return reply(IpcProtocol.ERROR, JSON.stringify(error));\n    }\n\n    if (!(response instanceof Promise)) {\n      return reply(IpcProtocol.SUCCESS, response);\n    }\n\n    response.\n      then((result) => reply(IpcProtocol.SUCCESS, result)).\n      catch((e) => {\n        // user might have called `reject()` without arguments.\n        const err = e && e.message || e;\n        reply(IpcProtocol.ERROR, err);\n      });\n  });\n}\n"],
+  "sourcesContent": ["import { debugAndPrintError } from './Debug';\nimport { Presence } from './presence/Presence';\nimport { IpcProtocol } from './Protocol';\nimport { generateId, REMOTE_ROOM_SHORT_TIMEOUT } from './utils/Utils';\n\nexport async function requestFromIPC<T>(\n  presence: Presence,\n  publishToChannel: string,\n  method: string,\n  args: any[],\n  rejectionTimeout: number = REMOTE_ROOM_SHORT_TIMEOUT,\n): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let unsubscribeTimeout: NodeJS.Timeout;\n\n    const requestId = generateId();\n    const channel = `ipc:${requestId}`;\n\n    const unsubscribe = () => {\n      presence.unsubscribe(channel);\n      clearTimeout(unsubscribeTimeout);\n    };\n\n    presence.subscribe(channel, (message) => {\n      const [code, data] = message;\n      if (code === IpcProtocol.SUCCESS) {\n        resolve(data);\n\n      } else if (code === IpcProtocol.ERROR) {\n        let error: any = data;\n\n        // parse error message + code\n        try { error = JSON.parse(data) } catch (e) {}\n\n        // turn string message into Error instance\n        if (typeof(error) === \"string\") {\n          error = new Error(error);\n        }\n\n        reject(error);\n      }\n      unsubscribe();\n    });\n\n    presence.publish(publishToChannel, [method, requestId, args]);\n\n    unsubscribeTimeout = setTimeout(() => {\n      unsubscribe();\n      reject(new Error(\"ipc_timeout\"));\n    }, rejectionTimeout);\n  });\n}\n\nexport async function subscribeIPC(\n  presence: Presence,\n  processId: string,\n  channel: string,\n  replyCallback: (method: string, args: any[]) => any,\n) {\n  await presence.subscribe(channel, (message) => {\n    const [method, requestId, args] = message;\n\n    const reply = (code, data) => {\n      presence.publish(`ipc:${requestId}`, [code, data]);\n    };\n\n    // reply with method result\n    let response: any;\n    try {\n      response = replyCallback(method, args);\n\n    } catch (e) {\n      debugAndPrintError(e);\n      const error = (typeof(e.code) !== \"undefined\")\n        ? { code: e.code, message: e.message }\n        : e.message;\n      return reply(IpcProtocol.ERROR, JSON.stringify(error));\n    }\n\n    if (!(response instanceof Promise)) {\n      return reply(IpcProtocol.SUCCESS, response);\n    }\n\n    response.\n      then((result) => reply(IpcProtocol.SUCCESS, result)).\n      catch((e) => {\n        // user might have called `reject()` without arguments.\n        const err = e && e.message || e;\n        reply(IpcProtocol.ERROR, err);\n      });\n  });\n}\n"],
   "mappings": ";;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAmC;AAEnC,sBAA4B;AAC5B,mBAAsD;AAEtD,eAAsB,eACpB,UACA,kBACA,QACA,MACA,mBAA2B,wCACf;AACZ,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACzC,QAAI;AAEJ,UAAM,gBAAY,yBAAW;AAC7B,UAAM,UAAU,OAAO;AAEvB,UAAM,cAAc,MAAM;AACxB,eAAS,YAAY,OAAO;AAC5B,mBAAa,kBAAkB;AAAA,IACjC;AAEA,aAAS,UAAU,SAAS,CAAC,YAAY;AACvC,YAAM,CAAC,MAAM,IAAI,IAAI;AACrB,UAAI,SAAS,4BAAY,SAAS;AAChC,gBAAQ,IAAI;AAAA,MAEd,WAAW,SAAS,4BAAY,OAAO;AACrC,YAAI,QAAa;AAGjB,YAAI;AAAE,kBAAQ,KAAK,MAAM,IAAI;AAAA,QAAE,SAAS,GAAP;AAAA,QAAW;AAG5C,YAAI,OAAO,UAAW,UAAU;AAC9B,kBAAQ,IAAI,MAAM,KAAK;AAAA,QACzB;AAEA,eAAO,KAAK;AAAA,MACd;AACA,kBAAY;AAAA,IACd,CAAC;AAED,aAAS,QAAQ,kBAAkB,CAAC,QAAQ,WAAW,IAAI,CAAC;AAE5D,yBAAqB,WAAW,MAAM;AACpC,kBAAY;AACZ,aAAO,IAAI,MAAM,aAAa,CAAC;AAAA,IACjC,GAAG,gBAAgB;AAAA,EACrB,CAAC;AACH;AAEA,eAAsB,aACpB,UACA,WACA,SACA,eACA;AACA,QAAM,SAAS,UAAU,SAAS,CAAC,YAAY;AAC7C,UAAM,CAAC,QAAQ,WAAW,IAAI,IAAI;AAElC,UAAM,QAAQ,CAAC,MAAM,SAAS;AAC5B,eAAS,QAAQ,OAAO,aAAa,CAAC,MAAM,IAAI,CAAC;AAAA,IACnD;AAGA,QAAI;AACJ,QAAI;AACF,iBAAW,cAAc,QAAQ,IAAI;AAAA,IAEvC,SAAS,GAAP;AACA,2CAAmB,CAAC;AACpB,YAAM,QAAS,OAAO,EAAE,SAAU,cAC9B,EAAE,MAAM,EAAE,MAAM,SAAS,EAAE,QAAQ,IACnC,EAAE;AACN,aAAO,MAAM,4BAAY,OAAO,KAAK,UAAU,KAAK,CAAC;AAAA,IACvD;AAEA,QAAI,EAAE,oBAAoB,UAAU;AAClC,aAAO,MAAM,4BAAY,SAAS,QAAQ;AAAA,IAC5C;AAEA,aACE,KAAK,CAAC,WAAW,MAAM,4BAAY,SAAS,MAAM,CAAC,EACnD,MAAM,CAAC,MAAM;AAEX,YAAM,MAAM,KAAK,EAAE,WAAW;AAC9B,YAAM,4BAAY,OAAO,GAAG;AAAA,IAC9B,CAAC;AAAA,EACL,CAAC;AACH;",
   "names": []
 }

package/build/IPC.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/IPC.ts"],
-  "sourcesContent": ["import { debugAndPrintError } from './Debug';\nimport { Presence } from './presence/Presence';\nimport { IpcProtocol } from './Protocol';\nimport { generateId, REMOTE_ROOM_SHORT_TIMEOUT } from './utils/Utils';\n\nexport async function requestFromIPC<T>(\n  presence: Presence,\n  publishToChannel: string,\n  method: string,\n  args: any[],\n  rejectionTimeout: number = REMOTE_ROOM_SHORT_TIMEOUT,\n): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let unsubscribeTimeout: NodeJS.Timer;\n\n    const requestId = generateId();\n    const channel = `ipc:${requestId}`;\n\n    const unsubscribe = () => {\n      presence.unsubscribe(channel);\n      clearTimeout(unsubscribeTimeout);\n    };\n\n    presence.subscribe(channel, (message) => {\n      const [code, data] = message;\n      if (code === IpcProtocol.SUCCESS) {\n        resolve(data);\n\n      } else if (code === IpcProtocol.ERROR) {\n        let error: any = data;\n\n        // parse error message + code\n        try { error = JSON.parse(data) } catch (e) {}\n\n        // turn string message into Error instance\n        if (typeof(error) === \"string\") {\n          error = new Error(error);\n        }\n\n        reject(error);\n      }\n      unsubscribe();\n    });\n\n    presence.publish(publishToChannel, [method, requestId, args]);\n\n    unsubscribeTimeout = setTimeout(() => {\n      unsubscribe();\n      reject(new Error(\"ipc_timeout\"));\n    }, rejectionTimeout);\n  });\n}\n\nexport async function subscribeIPC(\n  presence: Presence,\n  processId: string,\n  channel: string,\n  replyCallback: (method: string, args: any[]) => any,\n) {\n  await presence.subscribe(channel, (message) => {\n    const [method, requestId, args] = message;\n\n    const reply = (code, data) => {\n      presence.publish(`ipc:${requestId}`, [code, data]);\n    };\n\n    // reply with method result\n    let response: any;\n    try {\n      response = replyCallback(method, args);\n\n    } catch (e) {\n      debugAndPrintError(e);\n      const error = (typeof(e.code) !== \"undefined\")\n        ? { code: e.code, message: e.message }\n        : e.message;\n      return reply(IpcProtocol.ERROR, JSON.stringify(error));\n    }\n\n    if (!(response instanceof Promise)) {\n      return reply(IpcProtocol.SUCCESS, response);\n    }\n\n    response.\n      then((result) => reply(IpcProtocol.SUCCESS, result)).\n      catch((e) => {\n        // user might have called `reject()` without arguments.\n        const err = e && e.message || e;\n        reply(IpcProtocol.ERROR, err);\n      });\n  });\n}\n"],
+  "sourcesContent": ["import { debugAndPrintError } from './Debug';\nimport { Presence } from './presence/Presence';\nimport { IpcProtocol } from './Protocol';\nimport { generateId, REMOTE_ROOM_SHORT_TIMEOUT } from './utils/Utils';\n\nexport async function requestFromIPC<T>(\n  presence: Presence,\n  publishToChannel: string,\n  method: string,\n  args: any[],\n  rejectionTimeout: number = REMOTE_ROOM_SHORT_TIMEOUT,\n): Promise<T> {\n  return new Promise<T>((resolve, reject) => {\n    let unsubscribeTimeout: NodeJS.Timeout;\n\n    const requestId = generateId();\n    const channel = `ipc:${requestId}`;\n\n    const unsubscribe = () => {\n      presence.unsubscribe(channel);\n      clearTimeout(unsubscribeTimeout);\n    };\n\n    presence.subscribe(channel, (message) => {\n      const [code, data] = message;\n      if (code === IpcProtocol.SUCCESS) {\n        resolve(data);\n\n      } else if (code === IpcProtocol.ERROR) {\n        let error: any = data;\n\n        // parse error message + code\n        try { error = JSON.parse(data) } catch (e) {}\n\n        // turn string message into Error instance\n        if (typeof(error) === \"string\") {\n          error = new Error(error);\n        }\n\n        reject(error);\n      }\n      unsubscribe();\n    });\n\n    presence.publish(publishToChannel, [method, requestId, args]);\n\n    unsubscribeTimeout = setTimeout(() => {\n      unsubscribe();\n      reject(new Error(\"ipc_timeout\"));\n    }, rejectionTimeout);\n  });\n}\n\nexport async function subscribeIPC(\n  presence: Presence,\n  processId: string,\n  channel: string,\n  replyCallback: (method: string, args: any[]) => any,\n) {\n  await presence.subscribe(channel, (message) => {\n    const [method, requestId, args] = message;\n\n    const reply = (code, data) => {\n      presence.publish(`ipc:${requestId}`, [code, data]);\n    };\n\n    // reply with method result\n    let response: any;\n    try {\n      response = replyCallback(method, args);\n\n    } catch (e) {\n      debugAndPrintError(e);\n      const error = (typeof(e.code) !== \"undefined\")\n        ? { code: e.code, message: e.message }\n        : e.message;\n      return reply(IpcProtocol.ERROR, JSON.stringify(error));\n    }\n\n    if (!(response instanceof Promise)) {\n      return reply(IpcProtocol.SUCCESS, response);\n    }\n\n    response.\n      then((result) => reply(IpcProtocol.SUCCESS, result)).\n      catch((e) => {\n        // user might have called `reject()` without arguments.\n        const err = e && e.message || e;\n        reply(IpcProtocol.ERROR, err);\n      });\n  });\n}\n"],
   "mappings": "AAAA,SAAS,0BAA0B;AAEnC,SAAS,mBAAmB;AAC5B,SAAS,YAAY,iCAAiC;AAEtD,eAAsB,eACpB,UACA,kBACA,QACA,MACA,mBAA2B,2BACf;AACZ,SAAO,IAAI,QAAW,CAAC,SAAS,WAAW;AACzC,QAAI;AAEJ,UAAM,YAAY,WAAW;AAC7B,UAAM,UAAU,OAAO;AAEvB,UAAM,cAAc,MAAM;AACxB,eAAS,YAAY,OAAO;AAC5B,mBAAa,kBAAkB;AAAA,IACjC;AAEA,aAAS,UAAU,SAAS,CAAC,YAAY;AACvC,YAAM,CAAC,MAAM,IAAI,IAAI;AACrB,UAAI,SAAS,YAAY,SAAS;AAChC,gBAAQ,IAAI;AAAA,MAEd,WAAW,SAAS,YAAY,OAAO;AACrC,YAAI,QAAa;AAGjB,YAAI;AAAE,kBAAQ,KAAK,MAAM,IAAI;AAAA,QAAE,SAAS,GAAP;AAAA,QAAW;AAG5C,YAAI,OAAO,UAAW,UAAU;AAC9B,kBAAQ,IAAI,MAAM,KAAK;AAAA,QACzB;AAEA,eAAO,KAAK;AAAA,MACd;AACA,kBAAY;AAAA,IACd,CAAC;AAED,aAAS,QAAQ,kBAAkB,CAAC,QAAQ,WAAW,IAAI,CAAC;AAE5D,yBAAqB,WAAW,MAAM;AACpC,kBAAY;AACZ,aAAO,IAAI,MAAM,aAAa,CAAC;AAAA,IACjC,GAAG,gBAAgB;AAAA,EACrB,CAAC;AACH;AAEA,eAAsB,aACpB,UACA,WACA,SACA,eACA;AACA,QAAM,SAAS,UAAU,SAAS,CAAC,YAAY;AAC7C,UAAM,CAAC,QAAQ,WAAW,IAAI,IAAI;AAElC,UAAM,QAAQ,CAAC,MAAM,SAAS;AAC5B,eAAS,QAAQ,OAAO,aAAa,CAAC,MAAM,IAAI,CAAC;AAAA,IACnD;AAGA,QAAI;AACJ,QAAI;AACF,iBAAW,cAAc,QAAQ,IAAI;AAAA,IAEvC,SAAS,GAAP;AACA,yBAAmB,CAAC;AACpB,YAAM,QAAS,OAAO,EAAE,SAAU,cAC9B,EAAE,MAAM,EAAE,MAAM,SAAS,EAAE,QAAQ,IACnC,EAAE;AACN,aAAO,MAAM,YAAY,OAAO,KAAK,UAAU,KAAK,CAAC;AAAA,IACvD;AAEA,QAAI,EAAE,oBAAoB,UAAU;AAClC,aAAO,MAAM,YAAY,SAAS,QAAQ;AAAA,IAC5C;AAEA,aACE,KAAK,CAAC,WAAW,MAAM,YAAY,SAAS,MAAM,CAAC,EACnD,MAAM,CAAC,MAAM;AAEX,YAAM,MAAM,KAAK,EAAE,WAAW;AAC9B,YAAM,YAAY,OAAO,GAAG;AAAA,IAC9B,CAAC;AAAA,EACL,CAAC;AACH;",
   "names": []
 }

package/build/MatchMaker.d.ts

@@ -2,7 +2,7 @@ import { Deferred } from './utils/Utils';
 import { RegisteredHandler } from './matchmaker/RegisteredHandler';
 import { Room } from './Room';
 import { Presence } from './presence/Presence';
-import { IRoomListingData, RoomListingData, MatchMakerDriver } from './matchmaker/driver';
+import { IRoomCache, MatchMakerDriver, SortOptions } from './matchmaker/driver/local/LocalDriver';
 import controller from './matchmaker/controller';
 import * as stats from "./Stats";
 import { Type } from './utils/types';
@@ -15,7 +15,7 @@ export type AuthOptions = {
 export type SelectProcessIdCallback = (roomName: string, clientOptions: ClientOptions) => Promise<string>;
 export interface SeatReservation {
     sessionId: string;
-    room: RoomListingData;
+    room: IRoomCache;
     devMode?: boolean;
 }
 export declare let publicAddress: string;
@@ -23,8 +23,6 @@ export declare let processId: string;
 export declare let presence: Presence;
 export declare let driver: MatchMakerDriver;
 export declare let selectProcessIdToCreateRoom: SelectProcessIdCallback;
-export declare function setHealthChecksEnabled(value: boolean): void;
-export declare let isGracefullyShuttingDown: boolean;
 export declare let onReady: Deferred;
 export declare enum MatchMakerState {
     INITIALIZING = 0,
@@ -61,7 +59,7 @@ export declare function join(roomName: string, clientOptions?: ClientOptions, au
  * Join a room by id and return seat reservation
  */
 export declare function reconnect(roomId: string, clientOptions?: ClientOptions): Promise<{
-    room: RoomListingData<any>;
+    room: import("./matchmaker/driver/api").RoomCache<any>;
     sessionId: any;
 }>;
 /**
@@ -71,22 +69,23 @@ export declare function reconnect(roomId: string, clientOptions?: ClientOptions)
  * @param clientOptions - Options for the client seat reservation (for `onJoin`/`onAuth`)
  * @param authOptions - Optional authentication token
  *
- * @returns Promise<SeatReservation> - A promise which contains `sessionId` and `RoomListingData`.
+ * @returns Promise<SeatReservation> - A promise which contains `sessionId` and `IRoomCache`.
  */
 export declare function joinById(roomId: string, clientOptions?: ClientOptions, authOptions?: AuthOptions): Promise<SeatReservation>;
 /**
  * Perform a query for all cached rooms
  */
-export declare function query(conditions?: Partial<IRoomListingData>): Promise<RoomListingData<any>[]>;
+export declare function query(conditions?: Partial<IRoomCache>, sortOptions?: SortOptions): Promise<IRoomCache[]>;
 /**
  * Find for a public and unlocked room available.
  *
  * @param roomName - The Id of the specific room.
- * @param clientOptions - Options for the client seat reservation (for `onJoin`/`onAuth`).
+ * @param filterOptions - Filter options.
+ * @param sortOptions - Sorting options.
  *
- * @returns Promise<RoomListingData> - A promise contaning an object which includes room metadata and configurations.
+ * @returns Promise<IRoomCache> - A promise contaning an object which includes room metadata and configurations.
  */
-export declare function findOneRoomAvailable(roomName: string, clientOptions: ClientOptions): Promise<RoomListingData>;
+export declare function findOneRoomAvailable(roomName: string, filterOptions: ClientOptions, additionalSortOptions?: SortOptions): Promise<import("./matchmaker/driver/api").RoomCache<any>>;
 /**
  * Call a method or return a property on a remote room.
  *
@@ -108,11 +107,19 @@ export declare function getRoomClass(roomName: string): Type<Room>;
  * @param roomName - The identifier you defined on `gameServer.define()`
  * @param clientOptions - Options for `onCreate`
  *
- * @returns Promise<RoomListingData> - A promise contaning an object which includes room metadata and configurations.
+ * @returns Promise<IRoomCache> - A promise contaning an object which includes room metadata and configurations.
  */
-export declare function createRoom(roomName: string, clientOptions: ClientOptions): Promise<RoomListingData>;
-export declare function handleCreateRoom(roomName: string, clientOptions: ClientOptions, restoringRoomId?: string): Promise<RoomListingData>;
-export declare function getRoomById(roomId: string): Room<any, any>;
+export declare function createRoom(roomName: string, clientOptions: ClientOptions): Promise<IRoomCache>;
+export declare function handleCreateRoom(roomName: string, clientOptions: ClientOptions, restoringRoomId?: string): Promise<IRoomCache>;
+/**
+ * Get room data by roomId.
+ * This method does not return the actual room instance, use `getLocalRoomById` for that.
+ */
+export declare function getRoomById(roomId: string): Promise<import("./matchmaker/driver/api").RoomCache<any>>;
+/**
+ * Get local room instance by roomId. (Can return "undefined" if the room is not available on this process)
+ */
+export declare function getLocalRoomById(roomId: string): Room<any, any, any, any>;
 /**
  * Disconnects every client on every room in the current process.
  */
@@ -121,8 +128,7 @@ export declare function gracefullyShutdown(): Promise<any>;
 /**
  * Reserve a seat for a client in a room
  */
-export declare function reserveSeatFor(room: RoomListingData, options: ClientOptions, authData?: any): Promise<SeatReservation>;
-export declare function cleanupStaleRooms(roomName: string): Promise<void>;
+export declare function reserveSeatFor(room: IRoomCache, options: ClientOptions, authData?: any): Promise<SeatReservation>;
 /**
  * Perform health check on all processes
  */

package/build/MatchMaker.js

@@ -25,7 +25,6 @@ var MatchMaker_exports = {};
 __export(MatchMaker_exports, {
   MatchMakerState: () => MatchMakerState,
   accept: () => accept,
-  cleanupStaleRooms: () => cleanupStaleRooms,
   controller: () => import_controller.default,
   create: () => create,
   createRoom: () => createRoom,
@@ -34,6 +33,7 @@ __export(MatchMaker_exports, {
   driver: () => driver,
   findOneRoomAvailable: () => findOneRoomAvailable,
   getHandler: () => getHandler,
+  getLocalRoomById: () => getLocalRoomById,
   getRoomById: () => getRoomById,
   getRoomClass: () => getRoomClass,
   gracefullyShutdown: () => gracefullyShutdown,
@@ -41,7 +41,6 @@ __export(MatchMaker_exports, {
   hasHandler: () => hasHandler,
   healthCheckAllProcesses: () => healthCheckAllProcesses,
   healthCheckProcessId: () => healthCheckProcessId,
-  isGracefullyShuttingDown: () => isGracefullyShuttingDown,
   join: () => join,
   joinById: () => joinById,
   joinOrCreate: () => joinOrCreate,
@@ -55,7 +54,6 @@ __export(MatchMaker_exports, {
   removeRoomType: () => removeRoomType,
   reserveSeatFor: () => reserveSeatFor,
   selectProcessIdToCreateRoom: () => selectProcessIdToCreateRoom,
-  setHealthChecksEnabled: () => setHealthChecksEnabled,
   setup: () => setup,
   state: () => state,
   stats: () => stats
@@ -71,11 +69,12 @@ var import_LocalPresence = require("./presence/LocalPresence");
 var import_Debug = require("./Debug");
 var import_SeatReservationError = require("./errors/SeatReservationError");
 var import_ServerError = require("./errors/ServerError");
-var import_driver = require("./matchmaker/driver");
+var import_LocalDriver = require("./matchmaker/driver/local/LocalDriver");
 var import_controller = __toESM(require("./matchmaker/controller"));
 var stats = __toESM(require("./Stats"));
 var import_Logger = require("./Logger");
 var import_discovery = require("./discovery");
+var import_api = require("./matchmaker/driver/api");
 const handlers = {};
 const rooms = {};
 let publicAddress;
@@ -83,11 +82,6 @@ let processId;
 let presence;
 let driver;
 let selectProcessIdToCreateRoom;
-let enableHealthChecks = true;
-function setHealthChecksEnabled(value) {
-  enableHealthChecks = value;
-}
-let isGracefullyShuttingDown;
 let onReady = new import_Utils.Deferred();
 var MatchMakerState = /* @__PURE__ */ ((MatchMakerState2) => {
   MatchMakerState2[MatchMakerState2["INITIALIZING"] = 0] = "INITIALIZING";
@@ -100,10 +94,9 @@ async function setup(_presence, _driver, _publicAddress, _selectProcessIdToCreat
   if (onReady === void 0) {
     onReady = new import_Utils.Deferred();
   }
-  isGracefullyShuttingDown = false;
   state = 0 /* INITIALIZING */;
   presence = _presence || new import_LocalPresence.LocalPresence();
-  driver = _driver || new import_driver.LocalDriver();
+  driver = _driver || new import_LocalDriver.LocalDriver();
   publicAddress = _publicAddress;
   stats.reset(false);
   if (import_DevMode.isDevMode) {
@@ -126,9 +119,7 @@ async function accept() {
       return handleCreateRoom.apply(void 0, args);
     }
   });
-  if (enableHealthChecks) {
-    await healthCheckAllProcesses();
-  }
+  await healthCheckAllProcesses();
   state = 1 /* READY */;
   await stats.persist();
   if (import_DevMode.isDevMode) {
@@ -140,7 +131,19 @@ async function joinOrCreate(roomName, clientOptions = {}, authOptions) {
     const authData = await callOnAuth(roomName, authOptions);
     let room = await findOneRoomAvailable(roomName, clientOptions);
     if (!room) {
-      room = await createRoom(roomName, clientOptions);
+      const handler = getHandler(roomName);
+      const filterOptions = handler.getFilterOptions(clientOptions);
+      const concurrencyKey = (0, import_api.getLockId)(filterOptions);
+      await concurrentJoinOrCreateRoomLock(handler, concurrencyKey, async (roomId) => {
+        if (roomId) {
+          room = await driver.findOne({ roomId });
+        }
+        if (!room) {
+          room = await createRoom(roomName, clientOptions);
+          presence.lpush(`l:${handler.name}:${concurrencyKey}`, room.roomId);
+        }
+        return room;
+      });
     }
     return await reserveSeatFor(room, clientOptions, authData);
   }, 5, [import_SeatReservationError.SeatReservationError]);
@@ -194,23 +197,21 @@ async function joinById(roomId, clientOptions = {}, authOptions) {
   const authData = await callOnAuth(room.name, authOptions);
   return reserveSeatFor(room, clientOptions, authData);
 }
-async function query(conditions = {}) {
-  return await driver.find(conditions);
-}
-async function findOneRoomAvailable(roomName, clientOptions) {
-  return await awaitRoomAvailable(roomName, async () => {
-    const handler = getHandler(roomName);
-    const roomQuery = driver.findOne({
-      locked: false,
-      name: roomName,
-      private: false,
-      ...handler.getFilterOptions(clientOptions)
-    });
-    if (handler.sortOptions) {
-      roomQuery.sort(handler.sortOptions);
-    }
-    return await roomQuery;
-  });
+async function query(conditions = {}, sortOptions) {
+  return await driver.query(conditions, sortOptions);
+}
+async function findOneRoomAvailable(roomName, filterOptions, additionalSortOptions) {
+  const handler = getHandler(roomName);
+  const sortOptions = Object.assign({}, handler.sortOptions ?? {});
+  if (additionalSortOptions) {
+    Object.assign(sortOptions, additionalSortOptions);
+  }
+  return await driver.findOne({
+    locked: false,
+    name: roomName,
+    private: false,
+    ...handler.getFilterOptions(filterOptions)
+  }, sortOptions);
 }
 async function remoteRoomCall(roomId, method, args, rejectionTimeout = import_Utils.REMOTE_ROOM_SHORT_TIMEOUT) {
   const room = rooms[roomId];
@@ -232,23 +233,17 @@ async function remoteRoomCall(roomId, method, args, rejectionTimeout = import_Ut
   }
 }
 function defineRoomType(roomName, klass, defaultOptions) {
-  const registeredHandler = new import_RegisteredHandler.RegisteredHandler(klass, defaultOptions);
+  const registeredHandler = new import_RegisteredHandler.RegisteredHandler(roomName, klass, defaultOptions);
   handlers[roomName] = registeredHandler;
   if (klass.prototype["onAuth"] !== import_Room.Room.prototype["onAuth"]) {
     if (klass["onAuth"] !== import_Room.Room["onAuth"]) {
       import_Logger.logger.info(`\u274C "${roomName}"'s onAuth() defined at the instance level will be ignored.`);
     }
   }
-  if (!import_DevMode.isDevMode) {
-    cleanupStaleRooms(roomName);
-  }
   return registeredHandler;
 }
 function removeRoomType(roomName) {
   delete handlers[roomName];
-  if (!import_DevMode.isDevMode) {
-    cleanupStaleRooms(roomName);
-  }
 }
 function hasHandler(roomName) {
   import_Logger.logger.warn("hasHandler() is deprecated. Use getHandler() instead.");
@@ -283,9 +278,7 @@ async function createRoom(roomName, clientOptions) {
     } catch (e) {
       if (e.message === "ipc_timeout") {
         (0, import_Debug.debugAndPrintError)(`${e.message}: create room request timed out for ${roomName} on processId ${selectedProcessId}.`);
-        if (enableHealthChecks) {
-          await stats.excludeProcess(selectedProcessId);
-        }
+        await stats.excludeProcess(selectedProcessId);
         room = await handleCreateRoom(roomName, clientOptions);
       } else {
         throw e;
@@ -309,6 +302,9 @@ async function handleCreateRoom(roomName, clientOptions, restoringRoomId) {
   } else {
     room.roomId = (0, import_Utils.generateId)();
   }
+  if (room.state) {
+    room.setState(room.state);
+  }
   room.roomName = roomName;
   room.presence = presence;
   const additionalListingData = handler.getFilterOptions(clientOptions);
@@ -355,6 +351,9 @@ async function handleCreateRoom(roomName, clientOptions, restoringRoomId) {
   return room.listing;
 }
 function getRoomById(roomId) {
+  return driver.findOne({ roomId });
+}
+function getLocalRoomById(roomId) {
   return rooms[roomId];
 }
 function disconnectAll(closeCode) {
@@ -370,10 +369,9 @@ function disconnectAll(closeCode) {
   return promises;
 }
 async function gracefullyShutdown() {
-  if (isGracefullyShuttingDown) {
+  if (state === 2 /* SHUTTING_DOWN */) {
     return Promise.reject("already_shutting_down");
   }
-  isGracefullyShuttingDown = true;
   state = 2 /* SHUTTING_DOWN */;
   onReady = void 0;
   (0, import_Debug.debugMatchMaking)(`${processId} is shutting down!`);
@@ -405,7 +403,7 @@ async function reserveSeatFor(room, options, authData) {
     );
   } catch (e) {
     (0, import_Debug.debugMatchMaking)(e);
-    if (e.message === "ipc_timeout" && !(enableHealthChecks && await healthCheckProcessId(room.processId))) {
+    if (e.message === "ipc_timeout" && !await healthCheckProcessId(room.processId)) {
       throw new import_SeatReservationError.SeatReservationError(`process ${room.processId} is not available.`);
     } else {
       successfulSeatReservation = false;
@@ -424,9 +422,6 @@ function callOnAuth(roomName, authOptions) {
   const roomClass = getRoomClass(roomName);
   return roomClass && roomClass["onAuth"] && roomClass["onAuth"] !== import_Room.Room["onAuth"] ? roomClass["onAuth"](authOptions.token, authOptions.request) : void 0;
 }
-async function cleanupStaleRooms(roomName) {
-  await presence.del(getHandlerConcurrencyKey(roomName));
-}
 async function healthCheckAllProcesses() {
   const allStats = await stats.fetchAll();
   if (allStats.length > 0) {
@@ -467,13 +462,7 @@ function healthCheckProcessId(processId2) {
   return _healthCheckByProcessId[processId2];
 }
 async function removeRoomsByProcessId(processId2) {
-  if (typeof driver.cleanup === "function") {
-    await driver.cleanup(processId2);
-  } else {
-    const cachedRooms = await driver.find({ processId: processId2 }, { _id: 1 });
-    import_Logger.logger.debug("> Removing stale rooms by processId:", processId2, `(${cachedRooms.length} rooms found)`);
-    cachedRooms.forEach((room) => room.remove());
-  }
+  await driver.cleanup(processId2);
 }
 async function createRoomReferences(room, init = false) {
   rooms[room.roomId] = room;
@@ -489,29 +478,34 @@ async function createRoomReferences(room, init = false) {
   }
   return true;
 }
-async function awaitRoomAvailable(roomToJoin, callback) {
+async function concurrentJoinOrCreateRoomLock(handler, concurrencyKey, callback) {
   return new Promise(async (resolve, reject) => {
-    const concurrencyKey = getHandlerConcurrencyKey(roomToJoin);
-    const concurrency = await presence.incr(concurrencyKey) - 1;
-    const concurrencyTimeout = Math.min(concurrency * 100, 500);
-    if (concurrency > 0) {
-      (0, import_Debug.debugMatchMaking)(
-        "receiving %d concurrent requests for joining '%s' (waiting %d ms)",
-        concurrency,
-        roomToJoin,
-        concurrencyTimeout
-      );
-    }
-    setTimeout(async () => {
+    const hkey = getConcurrencyHashKey(handler.name);
+    const concurrency = await presence.hincrby(hkey, concurrencyKey, 1) - 1;
+    const fulfill = async (roomId) => {
       try {
-        const result = await callback();
-        resolve(result);
+        resolve(await callback(roomId));
       } catch (e) {
         reject(e);
       } finally {
-        await presence.decr(concurrencyKey);
+        await presence.hincrby(hkey, concurrencyKey, -1);
       }
-    }, concurrencyTimeout);
+    };
+    if (concurrency > 0) {
+      (0, import_Debug.debugMatchMaking)(
+        "receiving %d concurrent requests for creating '%s' (%s)",
+        concurrency,
+        handler.name,
+        concurrencyKey
+      );
+      const result = await presence.brpop(
+        `l:${handler.name}:${concurrencyKey}`,
+        import_Utils.MAX_CONCURRENT_CREATE_ROOM_WAIT_TIME
+      );
+      return await fulfill(result && result[1]);
+    } else {
+      return await fulfill();
+    }
   });
 }
 function onClientJoinRoom(room, client) {
@@ -536,9 +530,8 @@ function onVisibilityChange(room, isInvisible) {
   handlers[room.roomName].emit("visibility-change", room, isInvisible);
 }
 async function disposeRoom(roomName, room) {
-  (0, import_Debug.debugMatchMaking)("disposing '%s' (%s) on processId '%s' (graceful shutdown: %s)", roomName, room.roomId, processId, isGracefullyShuttingDown);
-  room.listing.remove();
-  if (!isGracefullyShuttingDown) {
+  (0, import_Debug.debugMatchMaking)("disposing '%s' (%s) on processId '%s' (graceful shutdown: %s)", roomName, room.roomId, processId, state === 2 /* SHUTTING_DOWN */);
+  if (state !== 2 /* SHUTTING_DOWN */) {
     stats.local.roomCount--;
     stats.persist();
     if (import_DevMode.isDevMode) {
@@ -546,15 +539,14 @@ async function disposeRoom(roomName, room) {
     }
   }
   handlers[roomName].emit("dispose", room);
-  presence.del(getHandlerConcurrencyKey(roomName));
   presence.unsubscribe(getRoomChannel(room.roomId));
   delete rooms[room.roomId];
 }
 function getRoomChannel(roomId) {
   return `$${roomId}`;
 }
-function getHandlerConcurrencyKey(name) {
-  return `c:${name}`;
+function getConcurrencyHashKey(roomName) {
+  return `ch:${roomName}`;
 }
 function getProcessChannel(id = processId) {
   return `p:${id}`;
@@ -563,7 +555,6 @@ function getProcessChannel(id = processId) {
 0 && (module.exports = {
   MatchMakerState,
   accept,
-  cleanupStaleRooms,
   controller,
   create,
   createRoom,
@@ -572,6 +563,7 @@ function getProcessChannel(id = processId) {
   driver,
   findOneRoomAvailable,
   getHandler,
+  getLocalRoomById,
   getRoomById,
   getRoomClass,
   gracefullyShutdown,
@@ -579,7 +571,6 @@ function getProcessChannel(id = processId) {
   hasHandler,
   healthCheckAllProcesses,
   healthCheckProcessId,
-  isGracefullyShuttingDown,
   join,
   joinById,
   joinOrCreate,
@@ -593,7 +584,6 @@ function getProcessChannel(id = processId) {
   removeRoomType,
   reserveSeatFor,
   selectProcessIdToCreateRoom,
-  setHealthChecksEnabled,
   setup,
   state,
   stats