@colyseus/core 0.18.0 → 0.18.1

package/build/Server.cjs

@@ -43,12 +43,11 @@ var matchMaker = __toESM(require("./MatchMaker.cjs"), 1);
 var import_RegisteredHandler = require("./matchmaker/RegisteredHandler.cjs");
 var import_Room = require("./Room.cjs");
 var import_Utils = require("./utils/Utils.cjs");
-var import_LocalPresence = require("./presence/LocalPresence.cjs");
-var import_LocalDriver = require("./matchmaker/LocalDriver/LocalDriver.cjs");
 var import_Transport = require("./Transport.cjs");
 var import_Logger = require("./Logger.cjs");
 var import_DevMode = require("./utils/DevMode.cjs");
 var import_router = require("./router/index.cjs");
+var import_node = require("./router/node.cjs");
 var import_shared_types = require("@colyseus/shared-types");
 var import_default_routes = require("./router/default_routes.cjs");
 var Server = class _Server {
@@ -62,18 +61,19 @@ var Server = class _Server {
       greet: greet2 = true
     } = options;
     (0, import_DevMode.setDevMode)(options.devMode === true);
-    this.presence = options.presence || new import_LocalPresence.LocalPresence();
-    this.driver = options.driver || new import_LocalDriver.LocalDriver();
     this.options = options;
     this.greet = greet2;
     _Server.current = this;
     this.attach(options);
     matchMaker.setup(
-      this.presence,
-      this.driver,
+      options.presence,
+      options.driver,
       options.publicAddress,
       options.selectProcessIdToCreateRoom
-    );
+    ).then(() => {
+      this.presence = matchMaker.presence;
+      this.driver = matchMaker.driver;
+    });
     if (gracefullyShutdown2) {
       (0, import_Utils.registerGracefulShutdown)((err) => this.gracefullyShutdown(true, err));
     }
@@ -94,21 +94,7 @@ var Server = class _Server {
    * @param listeningListener
    */
   async listen(port, hostname, backlog, listeningListener) {
-    const { beforeListen, database, express } = this.options;
-    if (beforeListen) {
-      await beforeListen();
-    }
-    if (database) {
-      await database.boot();
-    }
-    await this._applyRouterDefaults();
-    if (express) {
-      await this._onTransportReady;
-      if (this.transport.getExpressApp) {
-        const expressApp = await this.transport.getExpressApp();
-        await express(expressApp);
-      }
-    }
+    await this._bootServices();
     if (process.env.COLYSEUS_CLOUD !== void 0) {
       if (typeof hostname === "number") {
         hostname = void 0;
@@ -129,17 +115,11 @@ var Server = class _Server {
     }
     await this._onTransportReady;
     return new Promise((resolve, reject) => {
-      (0, import_Transport.setTransport)(this.transport);
       this.transport.listen(port, hostname, backlog, (err) => {
         if (this.transport.server) {
           this.transport.server.on("error", (err2) => reject(err2));
         }
-        if (!this.router) {
-          this.router = (0, import_default_routes.getDefaultRouter)();
-        } else {
-          this.router = this.router.extend({ ...(0, import_default_routes.getDefaultRouter)().endpoints });
-        }
-        (0, import_router.bindRouterToTransport)(this.transport, this.router, this.options.express !== void 0);
+        this.bindRoutes();
         if (listeningListener) {
           listeningListener(err);
         }
@@ -151,6 +131,62 @@ var Server = class _Server {
       });
     });
   }
+  /**
+   * Prepare matchmaking and HTTP routes, then return the underlying
+   * `http.Server` *without* binding to a port.
+   *
+   * Use this on serverless platforms that consume an exported HTTP server
+   * instead of a listening one. Vercel, for example, drives the request handler
+   * of a default-exported server (its Express/Hono WebSocket examples use
+   * `export default server`), whereas calling `listen()` there selects Vercel's
+   * "captured server" path, which does not invoke Express-style app handlers.
+   *
+   * The transport must be created with an `http.Server` so it can be exported.
+   * Vercel additionally needs `package.json` `"main"` pointing at the entrypoint:
+   *
+   * ```ts
+   * import { createServer } from "node:http";
+   * const httpServer = createServer();
+   * const server = new Server({
+   *   transport: new WebSocketTransport({ server: httpServer }),
+   *   express: (app) => { app.get("/hello", (req, res) => res.json({ ok: true })); },
+   * });
+   * server.define("my_room", MyRoom);
+   * export default await server.serverless(); // no listen()
+   * ```
+   */
+  async serverless() {
+    await this._bootServices();
+    await this._onTransportReady;
+    const server = this.transport.server;
+    if (!server) {
+      throw new Error("serverless() requires a transport backed by an http.Server (pass `{ server }` to the transport).");
+    }
+    this.bindRoutes();
+    (0, import_node.prereadRequestBodies)(server);
+    await matchMaker.accept(this.options.isStandaloneMatchMaker);
+    if (this.greet) {
+      (0, import_greeting_banner.greet)();
+    }
+    return server;
+  }
+  /**
+   * Set the active transport globally and bind the matchmaking/HTTP routes.
+   * Shared by {@link listen} and {@link serverless}.
+   *
+   * `setTransport()` runs here rather than before `transport.listen()`: the
+   * global transport is only read by the matchmaking route handler, which can't
+   * run until `bindRouterToTransport()` below registers the route.
+   */
+  bindRoutes() {
+    (0, import_Transport.setTransport)(this.transport);
+    if (!this.router) {
+      this.router = (0, import_default_routes.getDefaultRouter)();
+    } else {
+      this.router = this.router.extend({ ...(0, import_default_routes.getDefaultRouter)().endpoints });
+    }
+    (0, import_router.bindRouterToTransport)(this.transport, this.router, this.options.express !== void 0);
+  }
   define(nameOrHandler, handlerOrOptions, defaultOptions) {
     const name = typeof nameOrHandler === "string" ? nameOrHandler : nameOrHandler.name;
     const roomClass = typeof nameOrHandler === "string" ? handlerOrOptions : nameOrHandler;
@@ -172,8 +208,8 @@ var Server = class _Server {
       await this.onBeforeShutdownCallback();
       await matchMaker.gracefullyShutdown();
       this.transport.shutdown();
-      this.presence.shutdown();
-      await this.driver.shutdown();
+      this.presence?.shutdown();
+      await this.driver?.shutdown();
       await this.onShutdownCallback();
     } catch (e) {
       (0, import_Debug.debugAndPrintError)(`error during shutdown: ${e}`);
@@ -214,6 +250,27 @@ var Server = class _Server {
   onBeforeShutdown(callback) {
     this.onBeforeShutdownCallback = callback;
   }
+  // Boot sequence shared by listen() and serverless(): user `beforeListen`
+  // hook, database boot, framework router defaults (auth/db endpoints), then
+  // the express app. serverless() needs this too — its exported server still
+  // serves the express callback and auth/database routes.
+  async _bootServices() {
+    const { beforeListen, database, express } = this.options;
+    if (beforeListen) {
+      await beforeListen();
+    }
+    if (database) {
+      await database.boot();
+    }
+    await this._applyRouterDefaults();
+    if (express) {
+      await this._onTransportReady;
+      if (this.transport.getExpressApp) {
+        const expressApp = await this.transport.getExpressApp();
+        await express(expressApp);
+      }
+    }
+  }
   // Extend the user's router with framework-contributed endpoints. An explicit
   // `auth` option wins over the database's `applyRouterDefaults` so a non-DB
   // setup can still auto-mount @colyseus/auth, and a DB user can opt out.

package/build/Server.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/Server.ts"],
-  "sourcesContent": ["import { greet } from \"@colyseus/greeting-banner\";\nimport type express from 'express';\n\nimport { debugAndPrintError } from './Debug.ts';\nimport * as matchMaker from './MatchMaker.ts';\nimport { RegisteredHandler } from './matchmaker/RegisteredHandler.ts';\n\nimport { type OnCreateOptions, Room } from './Room.ts';\nimport { Deferred, registerGracefulShutdown, dynamicImport, type Type } from './utils/Utils.ts';\n\nimport type { Presence } from \"./presence/Presence.ts\";\nimport { LocalPresence } from './presence/LocalPresence.ts';\nimport { LocalDriver } from './matchmaker/LocalDriver/LocalDriver.ts';\n\nimport { setTransport, Transport } from './Transport.ts';\nimport { logger, setLogger } from './Logger.ts';\nimport { setDevMode, isDevMode } from './utils/DevMode.ts';\nimport { type Router, bindRouterToTransport, createRouter } from './router/index.ts';\nimport { type SDKTypes as SharedSDKTypes } from '@colyseus/shared-types';\nimport { getDefaultRouter } from './router/default_routes.ts';\n\nexport type ServerOptions = {\n  publicAddress?: string,\n  presence?: Presence,\n  driver?: matchMaker.MatchMakerDriver,\n  transport?: Transport,\n  gracefullyShutdown?: boolean,\n  logger?: any;\n\n  /**\n   * Optional callback to execute before the server listens.\n   * This is useful for example to connect into a database or other services before the server listens.\n   */\n  beforeListen?: () => Promise<void> | void,\n\n  /**\n   * Booted before `matchMaker.accept()`. Structural so `@colyseus/core` keeps\n   * no runtime dep on `@colyseus/database` \u2014 any `{ boot(): Promise<void> }`\n   * works. The optional `applyRouterDefaults` is invoked after boot with the\n   * user's router so the database can contribute endpoints (e.g. auth routes).\n   */\n  database?: {\n    boot(): Promise<void>;\n    applyRouterDefaults?(router: Router): Router | Promise<Router>;\n  },\n\n  /**\n   * Mount `@colyseus/auth` routes into the router. Pass an options object\n   * (forwarded to `auth.endpoints(...)`) to wire it explicitly \u2014 useful when\n   * `database` is not in use. `false` disables auto-mounting even if a\n   * `database` is present and would have provided defaults.\n   */\n  auth?: false | {\n    settings?: Record<string, any>;\n    oauth?: boolean | { cookieSecret?: string };\n    prefix?: string;\n  },\n\n  /**\n   * Optional callback to configure Express routes.\n   * When provided, the transport layer will initialize an Express-compatible app\n   * and pass it to this callback for custom route configuration.\n   *\n   * For uWebSockets transport, this uses the uwebsockets-express module.\n   */\n  express?: (app: express.Application) => Promise<void> | void,\n\n  /**\n   * Custom function to determine which process should handle room creation.\n   * Default: assign new rooms the process with least amount of rooms created\n   */\n  selectProcessIdToCreateRoom?: matchMaker.SelectProcessIdCallback;\n\n  /**\n   * Whether this process is running as a standalone match-maker or not. (default: false)\n   * When enabled, this process will not spawn rooms and will only be responsible for matchmaking.\n   */\n  isStandaloneMatchMaker?: boolean; \n\n  /**\n   * If enabled, rooms are going to be restored in the server-side upon restart,\n   * clients are going to automatically re-connect when server reboots.\n   *\n   * Beware of \"schema mismatch\" issues. When updating Schema structures and\n   * reloading existing data, you may see \"schema mismatch\" errors in the\n   * client-side.\n   *\n   * (This operation is costly and should not be used in a production\n   * environment)\n   */\n  devMode?: boolean,\n\n  /**\n   * Display greeting message on server start.\n   * Default: true\n   */\n  greet?: boolean,\n};\n\n/**\n * Exposed types for the client-side SDK.\n * Re-exported from @colyseus/shared-types with specific type constraints.\n */\nexport interface SDKTypes<\n  RoomTypes extends Record<string, RegisteredHandler> = any,\n  Routes extends Router = any\n> extends SharedSDKTypes<RoomTypes, Routes> {}\n\nexport class Server<\n  RoomTypes extends Record<string, RegisteredHandler> = any,\n  Routes extends Router = any\n> implements SDKTypes<RoomTypes, Routes> {\n  '~rooms': RoomTypes;\n  '~routes': Routes;\n\n  public transport: Transport;\n  public router: Routes;\n  public options: ServerOptions;\n\n  protected presence: Presence;\n  protected driver: matchMaker.MatchMakerDriver;\n\n  protected port: number | string;\n  protected greet: boolean;\n\n  protected _onTransportReady = new Deferred<Transport>();\n\n  private _originalRoomOnMessage: typeof Room.prototype['_onMessage'] | null = null;\n\n  // Implicit default for callers that omit explicit Server reference \u2014 e.g.\n  // `playground()` reads `Server.current.router.endpoints` at request time.\n  // Last-construction wins; multi-server setups should reference instances\n  // explicitly.\n  static current: Server<any, any> | undefined;\n\n  constructor(options: ServerOptions = {}) {\n    const {\n      gracefullyShutdown = true,\n      greet = true\n    } = options;\n\n    setDevMode(options.devMode === true);\n\n    this.presence = options.presence || new LocalPresence();\n    this.driver = options.driver || new LocalDriver();\n    this.options = options;\n    this.greet = greet;\n\n    (Server as { current: Server<any, any> | undefined }).current = this as Server<any, any>;\n\n    this.attach(options);\n\n    matchMaker.setup(\n      this.presence,\n      this.driver,\n      options.publicAddress,\n      options.selectProcessIdToCreateRoom,\n    );\n\n    if (gracefullyShutdown) {\n      registerGracefulShutdown((err) => this.gracefullyShutdown(true, err));\n    }\n\n    if (options.logger) {\n      setLogger(options.logger);\n    }\n  }\n\n  public async attach(options: ServerOptions) {\n    this.transport = options.transport || await this.getDefaultTransport(options);\n    // `options.express` runs in `listen()` after `database.boot()` so user\n    // code reading `database.auth.settings` etc. finds services instantiated.\n    this._onTransportReady.resolve(this.transport);\n  }\n\n  /**\n   * Bind the server into the port specified.\n   *\n   * @param port - Port number or Unix socket path\n   * @param hostname\n   * @param backlog\n   * @param listeningListener\n   */\n  public async listen(port: number | string, hostname?: string, backlog?: number, listeningListener?: Function) {\n    const { beforeListen, database, express } = this.options;\n\n    if (beforeListen) { await beforeListen(); }\n    if (database) { await database.boot(); }\n\n    await this._applyRouterDefaults();\n\n    if (express) {\n      await this._onTransportReady;\n      if (this.transport.getExpressApp) {\n        const expressApp = await this.transport.getExpressApp();\n        await express(expressApp);\n      }\n    }\n\n    //\n    // if Colyseus Cloud is detected, use @colyseus/tools to listen\n    //\n    if (process.env.COLYSEUS_CLOUD !== undefined ) {\n      if (typeof(hostname) === \"number\") {\n        //\n        // workaround, @colyseus/tools calls server.listen() again with the port as a string\n        //\n        hostname = undefined;\n\n      } else {\n        try {\n          return (await dynamicImport(\"@colyseus/tools\")).listen(this);\n        } catch (error) {\n          const err = new Error(\"Please install @colyseus/tools to be able to host on Colyseus Cloud.\");\n          err.cause = error;\n          throw err;\n        }\n      }\n    }\n\n    //\n    // otherwise, listen on the port directly\n    //\n    this.port = port;\n\n    //\n    // Make sure matchmaker is ready before accepting connections\n    // (isDevMode: matchmaker may take extra milliseconds to restore the rooms)\n    //\n    await matchMaker.accept(this.options.isStandaloneMatchMaker);\n\n    /**\n     * Greetings!\n     */\n    if (this.greet) {\n      greet();\n    }\n\n    // Wait for the transport to be ready\n    await this._onTransportReady;\n\n    return new Promise<void>((resolve, reject) => {\n      // TODO: refactor me!\n      // set transport globally, to be used by matchmaking route\n      setTransport(this.transport);\n\n      this.transport.listen(port, hostname, backlog, (err) => {\n        if (this.transport.server) {\n          this.transport.server.on('error', (err) => reject(err));\n        }\n\n        // default router is used if no router is provided\n        if (!this.router) {\n          this.router = getDefaultRouter() as unknown as Routes;\n\n        } else {\n          // make sure default routes are included\n          // https://github.com/Bekacru/better-call/pull/67\n          this.router = this.router.extend({ ...getDefaultRouter().endpoints }) as unknown as Routes;\n        }\n\n        bindRouterToTransport(this.transport, this.router, this.options.express !== undefined);\n\n        if (listeningListener) {\n          listeningListener(err);\n        }\n\n        if (err) {\n          reject(err);\n\n        } else {\n          resolve();\n        }\n      });\n    });\n  }\n\n  /**\n   * Define a new type of room for matchmaking.\n   *\n   * @param name public room identifier for match-making.\n   * @param roomClass Room class definition\n   * @param defaultOptions default options for `onCreate`\n   */\n  public define<T extends Type<Room>>(\n    roomClass: T,\n    defaultOptions?: OnCreateOptions<T>,\n  ): RegisteredHandler\n  public define<T extends Type<Room>>(\n    name: string,\n    roomClass: T,\n    defaultOptions?: OnCreateOptions<T>,\n  ): RegisteredHandler\n  public define<T extends Type<Room>>(\n    nameOrHandler: string | T,\n    handlerOrOptions: T | OnCreateOptions<T>,\n    defaultOptions?: OnCreateOptions<T>,\n  ): RegisteredHandler {\n    const name = (typeof(nameOrHandler) === \"string\")\n      ? nameOrHandler\n      : nameOrHandler.name;\n\n    const roomClass = (typeof(nameOrHandler) === \"string\")\n      ? handlerOrOptions\n      : nameOrHandler;\n\n    const options = (typeof(nameOrHandler) === \"string\")\n      ? defaultOptions\n      : handlerOrOptions;\n\n    return matchMaker.defineRoomType(name, roomClass, options);\n  }\n\n  /**\n   * Remove a room definition from matchmaking.\n   * This method does not destroy any room. It only dissallows matchmaking\n   */\n  public removeRoomType(name: string): void {\n    matchMaker.removeRoomType(name);\n  }\n\n  public async gracefullyShutdown(exit: boolean = true, err?: Error) {\n    if (matchMaker.state === matchMaker.MatchMakerState.SHUTTING_DOWN) {\n      return;\n    }\n\n    try {\n      // custom \"before shutdown\" method\n      await this.onBeforeShutdownCallback();\n\n      // this is going to lock all rooms and wait for them to be disposed\n      await matchMaker.gracefullyShutdown();\n\n      this.transport.shutdown();\n      this.presence.shutdown();\n      await this.driver.shutdown();\n\n      // custom \"after shutdown\" method\n      await this.onShutdownCallback();\n\n    } catch (e) {\n      debugAndPrintError(`error during shutdown: ${e}`);\n\n    } finally {\n      if (exit) {\n        process.exit((err && !isDevMode) ? 1 : 0);\n      }\n    }\n  }\n\n  /**\n   * Add simulated latency between client and server.\n   * @param milliseconds round trip latency in milliseconds.\n   */\n  public simulateLatency(milliseconds: number) {\n    if (milliseconds > 0) {\n      logger.warn(`\uD83D\uDCF6\uFE0F\u2757 Colyseus latency simulation enabled \u2192 ${milliseconds}ms latency for round trip.`);\n    } else {\n      logger.warn(`\uD83D\uDCF6\uFE0F\u2757 Colyseus latency simulation disabled.`);\n    }\n\n    const halfwayMS = (milliseconds / 2);\n    this.transport.simulateLatency(halfwayMS);\n\n    if (this._originalRoomOnMessage == null) {\n      this._originalRoomOnMessage = Room.prototype['_onMessage'];\n    }\n\n    const originalOnMessage = this._originalRoomOnMessage;\n\n    Room.prototype['_onMessage'] = milliseconds <= Number.EPSILON ? originalOnMessage : function (this: Room, client, buffer) {\n      // uWebSockets.js: duplicate buffer because it is cleared at native layer before the timeout.\n      const cachedBuffer = Buffer.from(buffer);\n      setTimeout(() => originalOnMessage.call(this, client, cachedBuffer), halfwayMS);\n    };\n  }\n\n  /**\n   * Register a callback that is going to be executed before the server shuts down.\n   * @param callback\n   */\n  public onShutdown(callback: () => void | Promise<any>) {\n    this.onShutdownCallback = callback;\n  }\n\n  public onBeforeShutdown(callback: () => void | Promise<any>) {\n    this.onBeforeShutdownCallback = callback;\n  }\n\n  // Extend the user's router with framework-contributed endpoints. An explicit\n  // `auth` option wins over the database's `applyRouterDefaults` so a non-DB\n  // setup can still auto-mount @colyseus/auth, and a DB user can opt out.\n  private async _applyRouterDefaults(): Promise<void> {\n    const { auth, database } = this.options;\n    const wantsAuth = auth !== undefined && auth !== false;\n    const wantsDatabase = auth === undefined && !!database?.applyRouterDefaults;\n    if (!wantsAuth && !wantsDatabase) { return; }\n\n    // Boot an empty router if the user didn't pass `routes` \u2014 the framework's\n    // default routes get layered on later in the `transport.listen()` callback.\n    this.router ??= createRouter({}) as unknown as Routes;\n\n    if (wantsAuth) {\n      const authMod: any = await dynamicImport('@colyseus/auth').catch(() => undefined);\n      const endpointsFn = authMod?.auth?.endpoints ?? authMod?.default?.auth?.endpoints;\n      if (typeof endpointsFn === 'function') {\n        this.router = (this.router as Router).extend(endpointsFn(auth)) as Routes;\n      }\n    } else {\n      const updated = await database!.applyRouterDefaults!(this.router as Router);\n      if (updated) { this.router = updated as Routes; }\n    }\n  }\n\n  protected async getDefaultTransport(options: any): Promise<Transport> {\n    try {\n      const module = await dynamicImport('@colyseus/ws-transport');\n      const WebSocketTransport = module.WebSocketTransport;\n      return new WebSocketTransport(options);\n\n    } catch (error) {\n      this._onTransportReady.reject(error);\n      throw new Error(\"Please provide a 'transport' layer. Default transport not set.\");\n    }\n  }\n\n  protected onShutdownCallback: () => void | Promise<any> =\n    () => Promise.resolve()\n\n  protected onBeforeShutdownCallback: () => void | Promise<any> =\n    () => Promise.resolve()\n}\n\nexport type RoomDefinitions = Record<string, RegisteredHandler | Type<Room>>;\n\nfunction isRegisteredHandler(value: RegisteredHandler | Type<Room>): value is RegisteredHandler {\n  return value instanceof RegisteredHandler || (\n    typeof(value) === \"object\" &&\n    value !== null &&\n    'klass' in (value as object)\n  );\n}\n\nexport function registerRoomDefinitions<T extends RoomDefinitions>(rooms: T): string[] {\n  const roomNames: string[] = [];\n\n  for (const [name, value] of Object.entries(rooms)) {\n    if (isRegisteredHandler(value)) {\n      value.name = name;\n      matchMaker.addRoomType(value);\n\n    } else {\n      matchMaker.defineRoomType(name, value);\n    }\n\n    roomNames.push(name);\n  }\n\n  return roomNames;\n}\n\nexport function unregisterRoomDefinitions(roomNames: Iterable<string>) {\n  for (const roomName of roomNames) {\n    matchMaker.removeRoomType(roomName);\n  }\n}\n\nexport type DefineServerOptions<\n  T extends Record<string, RegisteredHandler>,\n  R extends Router\n> = ServerOptions & {\n  rooms: T,\n  routes?: R,\n};\n\nexport function defineServer<\n  T extends Record<string, RegisteredHandler>,\n  R extends Router\n>(\n  options: DefineServerOptions<T, R>,\n): Server<T, R> {\n  const { rooms, routes, ...serverOptions } = options;\n\n  if (isDevMode) {\n    // In dev mode, the Vite plugin manages Server/matchMaker lifecycle.\n    // Return a config-only object \u2014 no Server instance, no matchMaker.setup().\n    return {\n      options: serverOptions,\n      router: routes,\n      '~rooms': rooms,\n    } as unknown as Server<T, R>;\n  }\n\n  const server = new Server<T, R>(serverOptions);\n  server.router = routes;\n\n  registerRoomDefinitions(rooms);\n\n  return server;\n}\n\nexport function defineRoom<T extends Type<Room>>(\n  roomKlass: T,\n  defaultOptions?: Parameters<NonNullable<InstanceType<T>['onCreate']>>[0],\n): RegisteredHandler<InstanceType<T>> {\n  return new RegisteredHandler(roomKlass, defaultOptions) as unknown as RegisteredHandler<InstanceType<T>>;\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,6BAAsB;AAGtB,mBAAmC;AACnC,iBAA4B;AAC5B,+BAAkC;AAElC,kBAA2C;AAC3C,mBAA6E;AAG7E,2BAA8B;AAC9B,yBAA4B;AAE5B,uBAAwC;AACxC,oBAAkC;AAClC,qBAAsC;AACtC,oBAAiE;AACjE,0BAAgD;AAChD,4BAAiC;AAyF1B,IAAM,SAAN,MAAM,QAG4B;AAAA,EAwBvC,YAAY,UAAyB,CAAC,GAAG;AAVzC,SAAU,oBAAoB,IAAI,sBAAoB;AAEtD,SAAQ,yBAAqE;AA2S7E,SAAU,qBACR,MAAM,QAAQ,QAAQ;AAExB,SAAU,2BACR,MAAM,QAAQ,QAAQ;AAtStB,UAAM;AAAA,MACJ,oBAAAA,sBAAqB;AAAA,MACrB,OAAAC,SAAQ;AAAA,IACV,IAAI;AAEJ,mCAAW,QAAQ,YAAY,IAAI;AAEnC,SAAK,WAAW,QAAQ,YAAY,IAAI,mCAAc;AACtD,SAAK,SAAS,QAAQ,UAAU,IAAI,+BAAY;AAChD,SAAK,UAAU;AACf,SAAK,QAAQA;AAEb,IAAC,QAAqD,UAAU;AAEhE,SAAK,OAAO,OAAO;AAEnB,IAAW;AAAA,MACT,KAAK;AAAA,MACL,KAAK;AAAA,MACL,QAAQ;AAAA,MACR,QAAQ;AAAA,IACV;AAEA,QAAID,qBAAoB;AACtB,iDAAyB,CAAC,QAAQ,KAAK,mBAAmB,MAAM,GAAG,CAAC;AAAA,IACtE;AAEA,QAAI,QAAQ,QAAQ;AAClB,mCAAU,QAAQ,MAAM;AAAA,IAC1B;AAAA,EACF;AAAA,EAEA,MAAa,OAAO,SAAwB;AAC1C,SAAK,YAAY,QAAQ,aAAa,MAAM,KAAK,oBAAoB,OAAO;AAG5E,SAAK,kBAAkB,QAAQ,KAAK,SAAS;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAUA,MAAa,OAAO,MAAuB,UAAmB,SAAkB,mBAA8B;AAC5G,UAAM,EAAE,cAAc,UAAU,QAAQ,IAAI,KAAK;AAEjD,QAAI,cAAc;AAAE,YAAM,aAAa;AAAA,IAAG;AAC1C,QAAI,UAAU;AAAE,YAAM,SAAS,KAAK;AAAA,IAAG;AAEvC,UAAM,KAAK,qBAAqB;AAEhC,QAAI,SAAS;AACX,YAAM,KAAK;AACX,UAAI,KAAK,UAAU,eAAe;AAChC,cAAM,aAAa,MAAM,KAAK,UAAU,cAAc;AACtD,cAAM,QAAQ,UAAU;AAAA,MAC1B;AAAA,IACF;AAKA,QAAI,QAAQ,IAAI,mBAAmB,QAAY;AAC7C,UAAI,OAAO,aAAc,UAAU;AAIjC,mBAAW;AAAA,MAEb,OAAO;AACL,YAAI;AACF,kBAAQ,UAAM,4BAAc,iBAAiB,GAAG,OAAO,IAAI;AAAA,QAC7D,SAAS,OAAO;AACd,gBAAM,MAAM,IAAI,MAAM,sEAAsE;AAC5F,cAAI,QAAQ;AACZ,gBAAM;AAAA,QACR;AAAA,MACF;AAAA,IACF;AAKA,SAAK,OAAO;AAMZ,UAAiB,kBAAO,KAAK,QAAQ,sBAAsB;AAK3D,QAAI,KAAK,OAAO;AACd,wCAAM;AAAA,IACR;AAGA,UAAM,KAAK;AAEX,WAAO,IAAI,QAAc,CAAC,SAAS,WAAW;AAG5C,yCAAa,KAAK,SAAS;AAE3B,WAAK,UAAU,OAAO,MAAM,UAAU,SAAS,CAAC,QAAQ;AACtD,YAAI,KAAK,UAAU,QAAQ;AACzB,eAAK,UAAU,OAAO,GAAG,SAAS,CAACE,SAAQ,OAAOA,IAAG,CAAC;AAAA,QACxD;AAGA,YAAI,CAAC,KAAK,QAAQ;AAChB,eAAK,aAAS,wCAAiB;AAAA,QAEjC,OAAO;AAGL,eAAK,SAAS,KAAK,OAAO,OAAO,EAAE,OAAG,wCAAiB,EAAE,UAAU,CAAC;AAAA,QACtE;AAEA,iDAAsB,KAAK,WAAW,KAAK,QAAQ,KAAK,QAAQ,YAAY,MAAS;AAErF,YAAI,mBAAmB;AACrB,4BAAkB,GAAG;AAAA,QACvB;AAEA,YAAI,KAAK;AACP,iBAAO,GAAG;AAAA,QAEZ,OAAO;AACL,kBAAQ;AAAA,QACV;AAAA,MACF,CAAC;AAAA,IACH,CAAC;AAAA,EACH;AAAA,EAkBO,OACL,eACA,kBACA,gBACmB;AACnB,UAAM,OAAQ,OAAO,kBAAmB,WACpC,gBACA,cAAc;AAElB,UAAM,YAAa,OAAO,kBAAmB,WACzC,mBACA;AAEJ,UAAM,UAAW,OAAO,kBAAmB,WACvC,iBACA;AAEJ,WAAkB,0BAAe,MAAM,WAAW,OAAO;AAAA,EAC3D;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,eAAe,MAAoB;AACxC,IAAW,0BAAe,IAAI;AAAA,EAChC;AAAA,EAEA,MAAa,mBAAmB,OAAgB,MAAM,KAAa;AACjE,QAAe,qBAAqB,2BAAgB,eAAe;AACjE;AAAA,IACF;AAEA,QAAI;AAEF,YAAM,KAAK,yBAAyB;AAGpC,YAAiB,8BAAmB;AAEpC,WAAK,UAAU,SAAS;AACxB,WAAK,SAAS,SAAS;AACvB,YAAM,KAAK,OAAO,SAAS;AAG3B,YAAM,KAAK,mBAAmB;AAAA,IAEhC,SAAS,GAAG;AACV,2CAAmB,0BAA0B,CAAC,EAAE;AAAA,IAElD,UAAE;AACA,UAAI,MAAM;AACR,gBAAQ,KAAM,OAAO,CAAC,2BAAa,IAAI,CAAC;AAAA,MAC1C;AAAA,IACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,gBAAgB,cAAsB;AAC3C,QAAI,eAAe,GAAG;AACpB,2BAAO,KAAK,oEAA8C,YAAY,4BAA4B;AAAA,IACpG,OAAO;AACL,2BAAO,KAAK,6DAA4C;AAAA,IAC1D;AAEA,UAAM,YAAa,eAAe;AAClC,SAAK,UAAU,gBAAgB,SAAS;AAExC,QAAI,KAAK,0BAA0B,MAAM;AACvC,WAAK,yBAAyB,iBAAK,UAAU,YAAY;AAAA,IAC3D;AAEA,UAAM,oBAAoB,KAAK;AAE/B,qBAAK,UAAU,YAAY,IAAI,gBAAgB,OAAO,UAAU,oBAAoB,SAAsB,QAAQ,QAAQ;AAExH,YAAM,eAAe,OAAO,KAAK,MAAM;AACvC,iBAAW,MAAM,kBAAkB,KAAK,MAAM,QAAQ,YAAY,GAAG,SAAS;AAAA,IAChF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA;AAAA,EAMO,WAAW,UAAqC;AACrD,SAAK,qBAAqB;AAAA,EAC5B;AAAA,EAEO,iBAAiB,UAAqC;AAC3D,SAAK,2BAA2B;AAAA,EAClC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,uBAAsC;AAClD,UAAM,EAAE,MAAM,SAAS,IAAI,KAAK;AAChC,UAAM,YAAY,SAAS,UAAa,SAAS;AACjD,UAAM,gBAAgB,SAAS,UAAa,CAAC,CAAC,UAAU;AACxD,QAAI,CAAC,aAAa,CAAC,eAAe;AAAE;AAAA,IAAQ;AAI5C,SAAK,eAAW,4BAAa,CAAC,CAAC;AAE/B,QAAI,WAAW;AACb,YAAM,UAAe,UAAM,4BAAc,gBAAgB,EAAE,MAAM,MAAM,MAAS;AAChF,YAAM,cAAc,SAAS,MAAM,aAAa,SAAS,SAAS,MAAM;AACxE,UAAI,OAAO,gBAAgB,YAAY;AACrC,aAAK,SAAU,KAAK,OAAkB,OAAO,YAAY,IAAI,CAAC;AAAA,MAChE;AAAA,IACF,OAAO;AACL,YAAM,UAAU,MAAM,SAAU,oBAAqB,KAAK,MAAgB;AAC1E,UAAI,SAAS;AAAE,aAAK,SAAS;AAAA,MAAmB;AAAA,IAClD;AAAA,EACF;AAAA,EAEA,MAAgB,oBAAoB,SAAkC;AACpE,QAAI;AACF,YAAMC,UAAS,UAAM,4BAAc,wBAAwB;AAC3D,YAAM,qBAAqBA,QAAO;AAClC,aAAO,IAAI,mBAAmB,OAAO;AAAA,IAEvC,SAAS,OAAO;AACd,WAAK,kBAAkB,OAAO,KAAK;AACnC,YAAM,IAAI,MAAM,gEAAgE;AAAA,IAClF;AAAA,EACF;AAOF;AAIA,SAAS,oBAAoB,OAAmE;AAC9F,SAAO,iBAAiB,8CACtB,OAAO,UAAW,YAClB,UAAU,QACV,WAAY;AAEhB;AAEO,SAAS,wBAAmD,OAAoB;AACrF,QAAM,YAAsB,CAAC;AAE7B,aAAW,CAAC,MAAM,KAAK,KAAK,OAAO,QAAQ,KAAK,GAAG;AACjD,QAAI,oBAAoB,KAAK,GAAG;AAC9B,YAAM,OAAO;AACb,MAAW,uBAAY,KAAK;AAAA,IAE9B,OAAO;AACL,MAAW,0BAAe,MAAM,KAAK;AAAA,IACvC;AAEA,cAAU,KAAK,IAAI;AAAA,EACrB;AAEA,SAAO;AACT;AAEO,SAAS,0BAA0B,WAA6B;AACrE,aAAW,YAAY,WAAW;AAChC,IAAW,0BAAe,QAAQ;AAAA,EACpC;AACF;AAUO,SAAS,aAId,SACc;AACd,QAAM,EAAE,OAAO,QAAQ,GAAG,cAAc,IAAI;AAE5C,MAAI,0BAAW;AAGb,WAAO;AAAA,MACL,SAAS;AAAA,MACT,QAAQ;AAAA,MACR,UAAU;AAAA,IACZ;AAAA,EACF;AAEA,QAAM,SAAS,IAAI,OAAa,aAAa;AAC7C,SAAO,SAAS;AAEhB,0BAAwB,KAAK;AAE7B,SAAO;AACT;AAEO,SAAS,WACd,WACA,gBACoC;AACpC,SAAO,IAAI,2CAAkB,WAAW,cAAc;AACxD;",
+  "sourcesContent": ["import { greet } from \"@colyseus/greeting-banner\";\nimport type express from 'express';\nimport type { Server as HttpServer } from 'node:http';\n\nimport { debugAndPrintError } from './Debug.ts';\nimport * as matchMaker from './MatchMaker.ts';\nimport { RegisteredHandler } from './matchmaker/RegisteredHandler.ts';\n\nimport { type OnCreateOptions, Room } from './Room.ts';\nimport { Deferred, registerGracefulShutdown, dynamicImport, type Type } from './utils/Utils.ts';\n\nimport type { Presence } from \"./presence/Presence.ts\";\n\nimport { setTransport, Transport } from './Transport.ts';\nimport { logger, setLogger } from './Logger.ts';\nimport { setDevMode, isDevMode } from './utils/DevMode.ts';\nimport { type Router, bindRouterToTransport, createRouter } from './router/index.ts';\nimport { prereadRequestBodies } from './router/node.ts';\nimport { type SDKTypes as SharedSDKTypes } from '@colyseus/shared-types';\nimport { getDefaultRouter } from './router/default_routes.ts';\n\nexport type ServerOptions = {\n  publicAddress?: string,\n  presence?: Presence,\n  driver?: matchMaker.MatchMakerDriver,\n  transport?: Transport,\n  gracefullyShutdown?: boolean,\n  logger?: any;\n\n  /**\n   * Optional callback to execute before the server listens.\n   * This is useful for example to connect into a database or other services before the server listens.\n   */\n  beforeListen?: () => Promise<void> | void,\n\n  /**\n   * Booted before `matchMaker.accept()`. Structural so `@colyseus/core` keeps\n   * no runtime dep on `@colyseus/database` \u2014 any `{ boot(): Promise<void> }`\n   * works. The optional `applyRouterDefaults` is invoked after boot with the\n   * user's router so the database can contribute endpoints (e.g. auth routes).\n   */\n  database?: {\n    boot(): Promise<void>;\n    applyRouterDefaults?(router: Router): Router | Promise<Router>;\n  },\n\n  /**\n   * Mount `@colyseus/auth` routes into the router. Pass an options object\n   * (forwarded to `auth.endpoints(...)`) to wire it explicitly \u2014 useful when\n   * `database` is not in use. `false` disables auto-mounting even if a\n   * `database` is present and would have provided defaults.\n   */\n  auth?: false | {\n    settings?: Record<string, any>;\n    oauth?: boolean | { cookieSecret?: string };\n    prefix?: string;\n  },\n\n  /**\n   * Optional callback to configure Express routes.\n   * When provided, the transport layer will initialize an Express-compatible app\n   * and pass it to this callback for custom route configuration.\n   *\n   * For uWebSockets transport, this uses the uwebsockets-express module.\n   */\n  express?: (app: express.Application) => Promise<void> | void,\n\n  /**\n   * Custom function to determine which process should handle room creation.\n   * Default: assign new rooms the process with least amount of rooms created\n   */\n  selectProcessIdToCreateRoom?: matchMaker.SelectProcessIdCallback;\n\n  /**\n   * Whether this process is running as a standalone match-maker or not. (default: false)\n   * When enabled, this process will not spawn rooms and will only be responsible for matchmaking.\n   */\n  isStandaloneMatchMaker?: boolean; \n\n  /**\n   * If enabled, rooms are going to be restored in the server-side upon restart,\n   * clients are going to automatically re-connect when server reboots.\n   *\n   * Beware of \"schema mismatch\" issues. When updating Schema structures and\n   * reloading existing data, you may see \"schema mismatch\" errors in the\n   * client-side.\n   *\n   * (This operation is costly and should not be used in a production\n   * environment)\n   */\n  devMode?: boolean,\n\n  /**\n   * Display greeting message on server start.\n   * Default: true\n   */\n  greet?: boolean,\n};\n\n/**\n * Exposed types for the client-side SDK.\n * Re-exported from @colyseus/shared-types with specific type constraints.\n */\nexport interface SDKTypes<\n  RoomTypes extends Record<string, RegisteredHandler> = any,\n  Routes extends Router = any\n> extends SharedSDKTypes<RoomTypes, Routes> {}\n\nexport class Server<\n  RoomTypes extends Record<string, RegisteredHandler> = any,\n  Routes extends Router = any\n> implements SDKTypes<RoomTypes, Routes> {\n  '~rooms': RoomTypes;\n  '~routes': Routes;\n\n  public transport: Transport;\n  public router: Routes;\n  public options: ServerOptions;\n\n  protected presence: Presence;\n  protected driver: matchMaker.MatchMakerDriver;\n\n  protected port: number | string;\n  protected greet: boolean;\n\n  protected _onTransportReady = new Deferred<Transport>();\n\n  private _originalRoomOnMessage: typeof Room.prototype['_onMessage'] | null = null;\n\n  // Implicit default for callers that omit explicit Server reference \u2014 e.g.\n  // `playground()` reads `Server.current.router.endpoints` at request time.\n  // Last-construction wins; multi-server setups should reference instances\n  // explicitly.\n  static current: Server<any, any> | undefined;\n\n  constructor(options: ServerOptions = {}) {\n    const {\n      gracefullyShutdown = true,\n      greet = true\n    } = options;\n\n    setDevMode(options.devMode === true);\n\n    this.options = options;\n    this.greet = greet;\n\n    (Server as { current: Server<any, any> | undefined }).current = this as Server<any, any>;\n\n    this.attach(options);\n\n    // Pass options.presence/driver through as-is (possibly undefined).\n    // matchMaker.setup() falls back to getDefaultPresence/getDefaultDriver,\n    // which auto-select RedisPresence/RedisDriver on Colyseus Cloud.\n    matchMaker.setup(\n      options.presence,\n      options.driver,\n      options.publicAddress,\n      options.selectProcessIdToCreateRoom,\n    ).then(() => {\n      this.presence = matchMaker.presence;\n      this.driver = matchMaker.driver;\n    });\n\n    if (gracefullyShutdown) {\n      registerGracefulShutdown((err) => this.gracefullyShutdown(true, err));\n    }\n\n    if (options.logger) {\n      setLogger(options.logger);\n    }\n  }\n\n  public async attach(options: ServerOptions) {\n    this.transport = options.transport || await this.getDefaultTransport(options);\n    // `options.express` runs in `listen()` after `database.boot()` so user\n    // code reading `database.auth.settings` etc. finds services instantiated.\n    this._onTransportReady.resolve(this.transport);\n  }\n\n  /**\n   * Bind the server into the port specified.\n   *\n   * @param port - Port number or Unix socket path\n   * @param hostname\n   * @param backlog\n   * @param listeningListener\n   */\n  public async listen(port: number | string, hostname?: string, backlog?: number, listeningListener?: Function) {\n    await this._bootServices();\n\n    //\n    // if Colyseus Cloud is detected, use @colyseus/tools to listen\n    //\n    if (process.env.COLYSEUS_CLOUD !== undefined ) {\n      if (typeof(hostname) === \"number\") {\n        //\n        // workaround, @colyseus/tools calls server.listen() again with the port as a string\n        //\n        hostname = undefined;\n\n      } else {\n        try {\n          return (await dynamicImport(\"@colyseus/tools\")).listen(this);\n        } catch (error) {\n          const err = new Error(\"Please install @colyseus/tools to be able to host on Colyseus Cloud.\");\n          err.cause = error;\n          throw err;\n        }\n      }\n    }\n\n    //\n    // otherwise, listen on the port directly\n    //\n    this.port = port;\n\n    //\n    // Make sure matchmaker is ready before accepting connections\n    // (isDevMode: matchmaker may take extra milliseconds to restore the rooms)\n    //\n    await matchMaker.accept(this.options.isStandaloneMatchMaker);\n\n    /**\n     * Greetings!\n     */\n    if (this.greet) {\n      greet();\n    }\n\n    // Wait for the transport to be ready\n    await this._onTransportReady;\n\n    return new Promise<void>((resolve, reject) => {\n      this.transport.listen(port, hostname, backlog, (err) => {\n        if (this.transport.server) {\n          this.transport.server.on('error', (err) => reject(err));\n        }\n\n        this.bindRoutes();\n\n        if (listeningListener) {\n          listeningListener(err);\n        }\n\n        if (err) {\n          reject(err);\n\n        } else {\n          resolve();\n        }\n      });\n    });\n  }\n\n  /**\n   * Prepare matchmaking and HTTP routes, then return the underlying\n   * `http.Server` *without* binding to a port.\n   *\n   * Use this on serverless platforms that consume an exported HTTP server\n   * instead of a listening one. Vercel, for example, drives the request handler\n   * of a default-exported server (its Express/Hono WebSocket examples use\n   * `export default server`), whereas calling `listen()` there selects Vercel's\n   * \"captured server\" path, which does not invoke Express-style app handlers.\n   *\n   * The transport must be created with an `http.Server` so it can be exported.\n   * Vercel additionally needs `package.json` `\"main\"` pointing at the entrypoint:\n   *\n   * ```ts\n   * import { createServer } from \"node:http\";\n   * const httpServer = createServer();\n   * const server = new Server({\n   *   transport: new WebSocketTransport({ server: httpServer }),\n   *   express: (app) => { app.get(\"/hello\", (req, res) => res.json({ ok: true })); },\n   * });\n   * server.define(\"my_room\", MyRoom);\n   * export default await server.serverless(); // no listen()\n   * ```\n   */\n  public async serverless(): Promise<HttpServer> {\n    await this._bootServices();\n\n    // transport (and its HTTP server) must be ready before binding routes\n    await this._onTransportReady;\n\n    const server = this.transport.server as HttpServer | undefined;\n    if (!server) {\n      throw new Error(\"serverless() requires a transport backed by an http.Server (pass `{ server }` to the transport).\");\n    }\n\n    this.bindRoutes();\n\n    // When the server is consumed via `export default` (rather than listen()),\n    // the request body must be available synchronously \u2014 buffer it up-front so\n    // `req.body` is set before the router runs.\n    prereadRequestBodies(server);\n\n    await matchMaker.accept(this.options.isStandaloneMatchMaker);\n\n    if (this.greet) {\n      greet();\n    }\n\n    return server;\n  }\n\n  /**\n   * Set the active transport globally and bind the matchmaking/HTTP routes.\n   * Shared by {@link listen} and {@link serverless}.\n   *\n   * `setTransport()` runs here rather than before `transport.listen()`: the\n   * global transport is only read by the matchmaking route handler, which can't\n   * run until `bindRouterToTransport()` below registers the route.\n   */\n  private bindRoutes() {\n    // set transport globally, to be used by the matchmaking route\n    setTransport(this.transport);\n\n    // default router is used if no router is provided\n    if (!this.router) {\n      this.router = getDefaultRouter() as unknown as Routes;\n\n    } else {\n      // make sure default routes are included\n      // https://github.com/Bekacru/better-call/pull/67\n      this.router = this.router.extend({ ...getDefaultRouter().endpoints }) as unknown as Routes;\n    }\n\n    bindRouterToTransport(this.transport, this.router, this.options.express !== undefined);\n  }\n\n  /**\n   * Define a new type of room for matchmaking.\n   *\n   * @param name public room identifier for match-making.\n   * @param roomClass Room class definition\n   * @param defaultOptions default options for `onCreate`\n   */\n  public define<T extends Type<Room>>(\n    roomClass: T,\n    defaultOptions?: OnCreateOptions<T>,\n  ): RegisteredHandler\n  public define<T extends Type<Room>>(\n    name: string,\n    roomClass: T,\n    defaultOptions?: OnCreateOptions<T>,\n  ): RegisteredHandler\n  public define<T extends Type<Room>>(\n    nameOrHandler: string | T,\n    handlerOrOptions: T | OnCreateOptions<T>,\n    defaultOptions?: OnCreateOptions<T>,\n  ): RegisteredHandler {\n    const name = (typeof(nameOrHandler) === \"string\")\n      ? nameOrHandler\n      : nameOrHandler.name;\n\n    const roomClass = (typeof(nameOrHandler) === \"string\")\n      ? handlerOrOptions\n      : nameOrHandler;\n\n    const options = (typeof(nameOrHandler) === \"string\")\n      ? defaultOptions\n      : handlerOrOptions;\n\n    return matchMaker.defineRoomType(name, roomClass, options);\n  }\n\n  /**\n   * Remove a room definition from matchmaking.\n   * This method does not destroy any room. It only dissallows matchmaking\n   */\n  public removeRoomType(name: string): void {\n    matchMaker.removeRoomType(name);\n  }\n\n  public async gracefullyShutdown(exit: boolean = true, err?: Error) {\n    if (matchMaker.state === matchMaker.MatchMakerState.SHUTTING_DOWN) {\n      return;\n    }\n\n    try {\n      // custom \"before shutdown\" method\n      await this.onBeforeShutdownCallback();\n\n      // this is going to lock all rooms and wait for them to be disposed\n      await matchMaker.gracefullyShutdown();\n\n      this.transport.shutdown();\n      this.presence?.shutdown();\n      await this.driver?.shutdown();\n\n      // custom \"after shutdown\" method\n      await this.onShutdownCallback();\n\n    } catch (e) {\n      debugAndPrintError(`error during shutdown: ${e}`);\n\n    } finally {\n      if (exit) {\n        process.exit((err && !isDevMode) ? 1 : 0);\n      }\n    }\n  }\n\n  /**\n   * Add simulated latency between client and server.\n   * @param milliseconds round trip latency in milliseconds.\n   */\n  public simulateLatency(milliseconds: number) {\n    if (milliseconds > 0) {\n      logger.warn(`\uD83D\uDCF6\uFE0F\u2757 Colyseus latency simulation enabled \u2192 ${milliseconds}ms latency for round trip.`);\n    } else {\n      logger.warn(`\uD83D\uDCF6\uFE0F\u2757 Colyseus latency simulation disabled.`);\n    }\n\n    const halfwayMS = (milliseconds / 2);\n    this.transport.simulateLatency(halfwayMS);\n\n    if (this._originalRoomOnMessage == null) {\n      this._originalRoomOnMessage = Room.prototype['_onMessage'];\n    }\n\n    const originalOnMessage = this._originalRoomOnMessage;\n\n    Room.prototype['_onMessage'] = milliseconds <= Number.EPSILON ? originalOnMessage : function (this: Room, client, buffer) {\n      // uWebSockets.js: duplicate buffer because it is cleared at native layer before the timeout.\n      const cachedBuffer = Buffer.from(buffer);\n      setTimeout(() => originalOnMessage.call(this, client, cachedBuffer), halfwayMS);\n    };\n  }\n\n  /**\n   * Register a callback that is going to be executed before the server shuts down.\n   * @param callback\n   */\n  public onShutdown(callback: () => void | Promise<any>) {\n    this.onShutdownCallback = callback;\n  }\n\n  public onBeforeShutdown(callback: () => void | Promise<any>) {\n    this.onBeforeShutdownCallback = callback;\n  }\n\n  // Boot sequence shared by listen() and serverless(): user `beforeListen`\n  // hook, database boot, framework router defaults (auth/db endpoints), then\n  // the express app. serverless() needs this too \u2014 its exported server still\n  // serves the express callback and auth/database routes.\n  private async _bootServices(): Promise<void> {\n    const { beforeListen, database, express } = this.options;\n\n    if (beforeListen) { await beforeListen(); }\n    if (database) { await database.boot(); }\n\n    await this._applyRouterDefaults();\n\n    if (express) {\n      await this._onTransportReady;\n      if (this.transport.getExpressApp) {\n        const expressApp = await this.transport.getExpressApp();\n        await express(expressApp);\n      }\n    }\n  }\n\n  // Extend the user's router with framework-contributed endpoints. An explicit\n  // `auth` option wins over the database's `applyRouterDefaults` so a non-DB\n  // setup can still auto-mount @colyseus/auth, and a DB user can opt out.\n  private async _applyRouterDefaults(): Promise<void> {\n    const { auth, database } = this.options;\n    const wantsAuth = auth !== undefined && auth !== false;\n    const wantsDatabase = auth === undefined && !!database?.applyRouterDefaults;\n    if (!wantsAuth && !wantsDatabase) { return; }\n\n    // Boot an empty router if the user didn't pass `routes` \u2014 the framework's\n    // default routes get layered on later in the `transport.listen()` callback.\n    this.router ??= createRouter({}) as unknown as Routes;\n\n    if (wantsAuth) {\n      const authMod: any = await dynamicImport('@colyseus/auth').catch(() => undefined);\n      const endpointsFn = authMod?.auth?.endpoints ?? authMod?.default?.auth?.endpoints;\n      if (typeof endpointsFn === 'function') {\n        this.router = (this.router as Router).extend(endpointsFn(auth)) as Routes;\n      }\n    } else {\n      const updated = await database!.applyRouterDefaults!(this.router as Router);\n      if (updated) { this.router = updated as Routes; }\n    }\n  }\n\n  protected async getDefaultTransport(options: any): Promise<Transport> {\n    try {\n      const module = await dynamicImport('@colyseus/ws-transport');\n      const WebSocketTransport = module.WebSocketTransport;\n      return new WebSocketTransport(options);\n\n    } catch (error) {\n      this._onTransportReady.reject(error);\n      throw new Error(\"Please provide a 'transport' layer. Default transport not set.\");\n    }\n  }\n\n  protected onShutdownCallback: () => void | Promise<any> =\n    () => Promise.resolve()\n\n  protected onBeforeShutdownCallback: () => void | Promise<any> =\n    () => Promise.resolve()\n}\n\nexport type RoomDefinitions = Record<string, RegisteredHandler | Type<Room>>;\n\nfunction isRegisteredHandler(value: RegisteredHandler | Type<Room>): value is RegisteredHandler {\n  return value instanceof RegisteredHandler || (\n    typeof(value) === \"object\" &&\n    value !== null &&\n    'klass' in (value as object)\n  );\n}\n\nexport function registerRoomDefinitions<T extends RoomDefinitions>(rooms: T): string[] {\n  const roomNames: string[] = [];\n\n  for (const [name, value] of Object.entries(rooms)) {\n    if (isRegisteredHandler(value)) {\n      value.name = name;\n      matchMaker.addRoomType(value);\n\n    } else {\n      matchMaker.defineRoomType(name, value);\n    }\n\n    roomNames.push(name);\n  }\n\n  return roomNames;\n}\n\nexport function unregisterRoomDefinitions(roomNames: Iterable<string>) {\n  for (const roomName of roomNames) {\n    matchMaker.removeRoomType(roomName);\n  }\n}\n\nexport type DefineServerOptions<\n  T extends Record<string, RegisteredHandler>,\n  R extends Router\n> = ServerOptions & {\n  rooms: T,\n  routes?: R,\n};\n\nexport function defineServer<\n  T extends Record<string, RegisteredHandler>,\n  R extends Router\n>(\n  options: DefineServerOptions<T, R>,\n): Server<T, R> {\n  const { rooms, routes, ...serverOptions } = options;\n\n  if (isDevMode) {\n    // In dev mode, the Vite plugin manages Server/matchMaker lifecycle.\n    // Return a config-only object \u2014 no Server instance, no matchMaker.setup().\n    return {\n      options: serverOptions,\n      router: routes,\n      '~rooms': rooms,\n    } as unknown as Server<T, R>;\n  }\n\n  const server = new Server<T, R>(serverOptions);\n  server.router = routes;\n\n  registerRoomDefinitions(rooms);\n\n  return server;\n}\n\nexport function defineRoom<T extends Type<Room>>(\n  roomKlass: T,\n  defaultOptions?: Parameters<NonNullable<InstanceType<T>['onCreate']>>[0],\n): RegisteredHandler<InstanceType<T>> {\n  return new RegisteredHandler(roomKlass, defaultOptions) as unknown as RegisteredHandler<InstanceType<T>>;\n}\n"],
+  "mappings": "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",
   "names": ["gracefullyShutdown", "greet", "err", "module"]
 }

package/build/Server.d.ts

@@ -1,4 +1,5 @@
 import type express from 'express';
+import type { Server as HttpServer } from 'node:http';
 import * as matchMaker from './MatchMaker.ts';
 import { RegisteredHandler } from './matchmaker/RegisteredHandler.ts';
 import { type OnCreateOptions, Room } from './Room.ts';
@@ -108,6 +109,40 @@ export declare class Server<RoomTypes extends Record<string, RegisteredHandler>
      * @param listeningListener
      */
     listen(port: number | string, hostname?: string, backlog?: number, listeningListener?: Function): Promise<any>;
+    /**
+     * Prepare matchmaking and HTTP routes, then return the underlying
+     * `http.Server` *without* binding to a port.
+     *
+     * Use this on serverless platforms that consume an exported HTTP server
+     * instead of a listening one. Vercel, for example, drives the request handler
+     * of a default-exported server (its Express/Hono WebSocket examples use
+     * `export default server`), whereas calling `listen()` there selects Vercel's
+     * "captured server" path, which does not invoke Express-style app handlers.
+     *
+     * The transport must be created with an `http.Server` so it can be exported.
+     * Vercel additionally needs `package.json` `"main"` pointing at the entrypoint:
+     *
+     * ```ts
+     * import { createServer } from "node:http";
+     * const httpServer = createServer();
+     * const server = new Server({
+     *   transport: new WebSocketTransport({ server: httpServer }),
+     *   express: (app) => { app.get("/hello", (req, res) => res.json({ ok: true })); },
+     * });
+     * server.define("my_room", MyRoom);
+     * export default await server.serverless(); // no listen()
+     * ```
+     */
+    serverless(): Promise<HttpServer>;
+    /**
+     * Set the active transport globally and bind the matchmaking/HTTP routes.
+     * Shared by {@link listen} and {@link serverless}.
+     *
+     * `setTransport()` runs here rather than before `transport.listen()`: the
+     * global transport is only read by the matchmaking route handler, which can't
+     * run until `bindRouterToTransport()` below registers the route.
+     */
+    private bindRoutes;
     /**
      * Define a new type of room for matchmaking.
      *
@@ -134,6 +169,7 @@ export declare class Server<RoomTypes extends Record<string, RegisteredHandler>
      */
     onShutdown(callback: () => void | Promise<any>): void;
     onBeforeShutdown(callback: () => void | Promise<any>): void;
+    private _bootServices;
     private _applyRouterDefaults;
     protected getDefaultTransport(options: any): Promise<Transport>;
     protected onShutdownCallback: () => void | Promise<any>;

package/build/Server.mjs

@@ -5,12 +5,11 @@ import * as matchMaker from "./MatchMaker.mjs";
 import { RegisteredHandler } from "./matchmaker/RegisteredHandler.mjs";
 import { Room } from "./Room.mjs";
 import { Deferred, registerGracefulShutdown, dynamicImport } from "./utils/Utils.mjs";
-import { LocalPresence } from "./presence/LocalPresence.mjs";
-import { LocalDriver } from "./matchmaker/LocalDriver/LocalDriver.mjs";
 import { setTransport } from "./Transport.mjs";
 import { logger, setLogger } from "./Logger.mjs";
 import { setDevMode, isDevMode } from "./utils/DevMode.mjs";
 import { bindRouterToTransport, createRouter } from "./router/index.mjs";
+import { prereadRequestBodies } from "./router/node.mjs";
 import "@colyseus/shared-types";
 import { getDefaultRouter } from "./router/default_routes.mjs";
 var Server = class _Server {
@@ -24,18 +23,19 @@ var Server = class _Server {
       greet: greet2 = true
     } = options;
     setDevMode(options.devMode === true);
-    this.presence = options.presence || new LocalPresence();
-    this.driver = options.driver || new LocalDriver();
     this.options = options;
     this.greet = greet2;
     _Server.current = this;
     this.attach(options);
     matchMaker.setup(
-      this.presence,
-      this.driver,
+      options.presence,
+      options.driver,
       options.publicAddress,
       options.selectProcessIdToCreateRoom
-    );
+    ).then(() => {
+      this.presence = matchMaker.presence;
+      this.driver = matchMaker.driver;
+    });
     if (gracefullyShutdown2) {
       registerGracefulShutdown((err) => this.gracefullyShutdown(true, err));
     }
@@ -56,21 +56,7 @@ var Server = class _Server {
    * @param listeningListener
    */
   async listen(port, hostname, backlog, listeningListener) {
-    const { beforeListen, database, express } = this.options;
-    if (beforeListen) {
-      await beforeListen();
-    }
-    if (database) {
-      await database.boot();
-    }
-    await this._applyRouterDefaults();
-    if (express) {
-      await this._onTransportReady;
-      if (this.transport.getExpressApp) {
-        const expressApp = await this.transport.getExpressApp();
-        await express(expressApp);
-      }
-    }
+    await this._bootServices();
     if (process.env.COLYSEUS_CLOUD !== void 0) {
       if (typeof hostname === "number") {
         hostname = void 0;
@@ -91,17 +77,11 @@ var Server = class _Server {
     }
     await this._onTransportReady;
     return new Promise((resolve, reject) => {
-      setTransport(this.transport);
       this.transport.listen(port, hostname, backlog, (err) => {
         if (this.transport.server) {
           this.transport.server.on("error", (err2) => reject(err2));
         }
-        if (!this.router) {
-          this.router = getDefaultRouter();
-        } else {
-          this.router = this.router.extend({ ...getDefaultRouter().endpoints });
-        }
-        bindRouterToTransport(this.transport, this.router, this.options.express !== void 0);
+        this.bindRoutes();
         if (listeningListener) {
           listeningListener(err);
         }
@@ -113,6 +93,62 @@ var Server = class _Server {
       });
     });
   }
+  /**
+   * Prepare matchmaking and HTTP routes, then return the underlying
+   * `http.Server` *without* binding to a port.
+   *
+   * Use this on serverless platforms that consume an exported HTTP server
+   * instead of a listening one. Vercel, for example, drives the request handler
+   * of a default-exported server (its Express/Hono WebSocket examples use
+   * `export default server`), whereas calling `listen()` there selects Vercel's
+   * "captured server" path, which does not invoke Express-style app handlers.
+   *
+   * The transport must be created with an `http.Server` so it can be exported.
+   * Vercel additionally needs `package.json` `"main"` pointing at the entrypoint:
+   *
+   * ```ts
+   * import { createServer } from "node:http";
+   * const httpServer = createServer();
+   * const server = new Server({
+   *   transport: new WebSocketTransport({ server: httpServer }),
+   *   express: (app) => { app.get("/hello", (req, res) => res.json({ ok: true })); },
+   * });
+   * server.define("my_room", MyRoom);
+   * export default await server.serverless(); // no listen()
+   * ```
+   */
+  async serverless() {
+    await this._bootServices();
+    await this._onTransportReady;
+    const server = this.transport.server;
+    if (!server) {
+      throw new Error("serverless() requires a transport backed by an http.Server (pass `{ server }` to the transport).");
+    }
+    this.bindRoutes();
+    prereadRequestBodies(server);
+    await matchMaker.accept(this.options.isStandaloneMatchMaker);
+    if (this.greet) {
+      greet();
+    }
+    return server;
+  }
+  /**
+   * Set the active transport globally and bind the matchmaking/HTTP routes.
+   * Shared by {@link listen} and {@link serverless}.
+   *
+   * `setTransport()` runs here rather than before `transport.listen()`: the
+   * global transport is only read by the matchmaking route handler, which can't
+   * run until `bindRouterToTransport()` below registers the route.
+   */
+  bindRoutes() {
+    setTransport(this.transport);
+    if (!this.router) {
+      this.router = getDefaultRouter();
+    } else {
+      this.router = this.router.extend({ ...getDefaultRouter().endpoints });
+    }
+    bindRouterToTransport(this.transport, this.router, this.options.express !== void 0);
+  }
   define(nameOrHandler, handlerOrOptions, defaultOptions) {
     const name = typeof nameOrHandler === "string" ? nameOrHandler : nameOrHandler.name;
     const roomClass = typeof nameOrHandler === "string" ? handlerOrOptions : nameOrHandler;
@@ -134,8 +170,8 @@ var Server = class _Server {
       await this.onBeforeShutdownCallback();
       await matchMaker.gracefullyShutdown();
       this.transport.shutdown();
-      this.presence.shutdown();
-      await this.driver.shutdown();
+      this.presence?.shutdown();
+      await this.driver?.shutdown();
       await this.onShutdownCallback();
     } catch (e) {
       debugAndPrintError(`error during shutdown: ${e}`);
@@ -176,6 +212,27 @@ var Server = class _Server {
   onBeforeShutdown(callback) {
     this.onBeforeShutdownCallback = callback;
   }
+  // Boot sequence shared by listen() and serverless(): user `beforeListen`
+  // hook, database boot, framework router defaults (auth/db endpoints), then
+  // the express app. serverless() needs this too — its exported server still
+  // serves the express callback and auth/database routes.
+  async _bootServices() {
+    const { beforeListen, database, express } = this.options;
+    if (beforeListen) {
+      await beforeListen();
+    }
+    if (database) {
+      await database.boot();
+    }
+    await this._applyRouterDefaults();
+    if (express) {
+      await this._onTransportReady;
+      if (this.transport.getExpressApp) {
+        const expressApp = await this.transport.getExpressApp();
+        await express(expressApp);
+      }
+    }
+  }
   // Extend the user's router with framework-contributed endpoints. An explicit
   // `auth` option wins over the database's `applyRouterDefaults` so a non-DB
   // setup can still auto-mount @colyseus/auth, and a DB user can opt out.