@colyseus/core 0.17.44 → 0.18.1

package/build/Server.mjs

@@ -8,11 +8,11 @@ import { Deferred, registerGracefulShutdown, dynamicImport } from "./utils/Utils
 import { setTransport } from "./Transport.mjs";
 import { logger, setLogger } from "./Logger.mjs";
 import { setDevMode, isDevMode } from "./utils/DevMode.mjs";
-import { bindRouterToTransport } from "./router/index.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 {
+var Server = class _Server {
   constructor(options = {}) {
     this._onTransportReady = new Deferred();
     this._originalRoomOnMessage = null;
@@ -25,6 +25,7 @@ var Server = class {
     setDevMode(options.devMode === true);
     this.options = options;
     this.greet = greet2;
+    _Server.current = this;
     this.attach(options);
     matchMaker.setup(
       options.presence,
@@ -44,10 +45,6 @@ var Server = class {
   }
   async attach(options) {
     this.transport = options.transport || await this.getDefaultTransport(options);
-    if (options.express && this.transport.getExpressApp) {
-      const expressApp = await this.transport.getExpressApp();
-      await options.express(expressApp);
-    }
     this._onTransportReady.resolve(this.transport);
   }
   /**
@@ -59,9 +56,7 @@ var Server = class {
    * @param listeningListener
    */
   async listen(port, hostname, backlog, listeningListener) {
-    if (this.options.beforeListen) {
-      await this.options.beforeListen();
-    }
+    await this._bootServices();
     if (process.env.COLYSEUS_CLOUD !== void 0) {
       if (typeof hostname === "number") {
         hostname = void 0;
@@ -123,9 +118,7 @@ var Server = class {
    * ```
    */
   async serverless() {
-    if (this.options.beforeListen) {
-      await this.options.beforeListen();
-    }
+    await this._bootServices();
     await this._onTransportReady;
     const server = this.transport.server;
     if (!server) {
@@ -219,6 +212,51 @@ var Server = class {
   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.
+  async _applyRouterDefaults() {
+    const { auth, database } = this.options;
+    const wantsAuth = auth !== void 0 && auth !== false;
+    const wantsDatabase = auth === void 0 && !!database?.applyRouterDefaults;
+    if (!wantsAuth && !wantsDatabase) {
+      return;
+    }
+    this.router ??= createRouter({});
+    if (wantsAuth) {
+      const authMod = await dynamicImport("@colyseus/auth").catch(() => void 0);
+      const endpointsFn = authMod?.auth?.endpoints ?? authMod?.default?.auth?.endpoints;
+      if (typeof endpointsFn === "function") {
+        this.router = this.router.extend(endpointsFn(auth));
+      }
+    } else {
+      const updated = await database.applyRouterDefaults(this.router);
+      if (updated) {
+        this.router = updated;
+      }
+    }
+  }
   async getDefaultTransport(options) {
     try {
       const module = await dynamicImport("@colyseus/ws-transport");

package/build/Server.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/Server.ts"],
-  "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 } 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   * 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  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    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\n    // Initialize Express if callback is provided\n    if (options.express && this.transport.getExpressApp) {\n      const expressApp = await this.transport.getExpressApp();\n      await options.express(expressApp);\n    }\n\n    // Resolve the promise when the transport is ready\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    if (this.options.beforeListen) {\n      await this.options.beforeListen();\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      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    if (this.options.beforeListen) {\n      await this.options.beforeListen();\n    }\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  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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",
+  "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"]
 }

package/build/Transport.cjs

@@ -24,6 +24,7 @@ __export(Transport_exports, {
   ClientState: () => ClientState,
   Transport: () => Transport,
   connectClientToRoom: () => connectClientToRoom,
+  enqueueClientRaw: () => enqueueClientRaw,
   getTransport: () => getTransport,
   setTransport: () => setTransport
 });
@@ -52,12 +53,72 @@ var ClientState = {
   LEAVING: 4,
   CLOSED: 5
 };
+function enqueueClientRaw(client, data, options) {
+  if (options?.afterNextPatch) {
+    let frames = client._pendingFrames;
+    if (frames === void 0) {
+      frames = client._pendingFrames = [];
+    }
+    if (frames.length === 0) {
+      client._pendingFrameClients?.push(client);
+    }
+    frames.push(data);
+    return;
+  }
+  if (client.state !== ClientState.JOINED) {
+    client._enqueuedMessages?.push(data);
+    return;
+  }
+  client.raw(data, options);
+}
 var ClientArray = class extends Array {
+  constructor() {
+    super(...arguments);
+    /**
+     * Secondary index for O(1) lookup by sessionId. Kept in sync by the
+     * mutating methods overridden below. Direct index assignment
+     * (`arr[i] = client`) and `arr.length = 0` bypass this index — use
+     * `push` / `splice` / `delete` / `pop` / `shift` / `unshift` instead.
+     */
+    this._byId = /* @__PURE__ */ new Map();
+  }
+  /** The client for `sessionId`, or `undefined` — O(1). The canonical per-session
+   *  lookup (mirrors `room.inputs.get(sessionId)`). */
+  get(sessionId) {
+    return this._byId.get(sessionId);
+  }
+  /** @deprecated Use {@link get}. */
   getById(sessionId) {
-    return this.find((client) => client.sessionId === sessionId);
+    return this._byId.get(sessionId);
   }
   delete(client) {
-    return (0, import_Utils.spliceOne)(this, this.indexOf(client));
+    const removed = (0, import_Utils.spliceOne)(this, this.indexOf(client));
+    if (removed) this._byId.delete(client.sessionId);
+    return removed;
+  }
+  push(...items) {
+    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);
+    return super.push(...items);
+  }
+  pop() {
+    const removed = super.pop();
+    if (removed !== void 0) this._byId.delete(removed.sessionId);
+    return removed;
+  }
+  shift() {
+    const removed = super.shift();
+    if (removed !== void 0) this._byId.delete(removed.sessionId);
+    return removed;
+  }
+  unshift(...items) {
+    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);
+    return super.unshift(...items);
+  }
+  splice(start, deleteCount, ...items) {
+    const removed = deleteCount === void 0 ? super.splice(start) : super.splice(start, deleteCount, ...items);
+    for (let i = 0; i < removed.length; i++) this._byId.delete(removed[i].sessionId);
+    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);
+    return removed;
   }
 };
 async function connectClientToRoom(room, client, authContext, connectionOptions) {
@@ -72,6 +133,7 @@ async function connectClientToRoom(room, client, authContext, connectionOptions)
   ClientState,
   Transport,
   connectClientToRoom,
+  enqueueClientRaw,
   getTransport,
   setTransport
 });

package/build/Transport.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/Transport.ts"],
-  "sourcesContent": ["import * as http from 'http';\nimport * as https from 'https';\n\nimport type { Router } from '@colyseus/better-call';\n\nimport { ErrorCode } from '@colyseus/shared-types';\nimport { StateView } from '@colyseus/schema';\n\nimport { EventEmitter } from 'events';\nimport { spliceOne } from './utils/Utils.ts';\nimport { ServerError } from './errors/ServerError.ts';\n\nimport type { Room } from './Room.ts';\n\nlet _transport: Transport | undefined;\nexport function setTransport(transport: Transport) { _transport = transport; }\nexport function getTransport() { return _transport; }\n\nexport abstract class Transport {\n    public protocol?: string;\n    public server?: http.Server | https.Server;\n\n    public abstract listen(port?: number | string, hostname?: string, backlog?: number, listeningListener?: Function): this;\n    public abstract shutdown(): void;\n\n    public abstract simulateLatency(milliseconds: number): void;\n\n    /**\n     * Returns an Express-compatible application for HTTP route handling.\n     * For uWebSockets transport, this uses the uwebsockets-express module.\n     * This method is called lazily only when an express callback is provided in server options.\n     */\n    public getExpressApp?(): Promise<import('express').Application> | import('express').Application | undefined;\n\n    /**\n     * Binds a router to the transport.\n     * Some transports may have a custom way to bind a router to the transport.\n     * (uWebSocketsTransport)\n     */\n    public bindRouter?(router: Router): void;\n}\n\nexport type AuthContext = {\n  token?: string,\n  headers: Headers,\n  ip: string | string[];\n  // FIXME: each transport may have its own specific properties.\n  // \"req\" only applies to WebSocketTransport.\n  req?: any;\n};\n\nexport interface ISendOptions {\n  afterNextPatch?: boolean;\n}\n\nexport const ClientState = {\n  JOINING: 0,\n  JOINED: 1,\n  RECONNECTING: 2,\n  RECONNECTED: 3,\n  LEAVING: 4,\n  CLOSED: 5\n} as const;\nexport type ClientState = (typeof ClientState)[keyof typeof ClientState];\n\n// Helper types to extract properties from the Client type parameter\ntype ExtractClientUserData<T> = T extends { userData: infer U } ? U : T;\ntype ExtractClientAuth<T> = T extends { auth: infer A } ? A : any;\ntype ExtractClientMessages<T> = T extends { messages: infer M } ? M : any;\n\n// Helper type to make message required when the message type demands it\nexport type MessageArgs<M, Options> =\n  unknown extends M ? [message?: M, options?: Options] :  // Handle 'any' type (backwards compatibility)\n  [M] extends [never] ? [message?: M, options?: Options] :\n  [M] extends [void] ? [message?: M, options?: Options] :\n  [M] extends [undefined] ? [message?: M, options?: Options] :\n  undefined extends M ? [message?: M, options?: Options] :\n  [message: M, options?: Options];\n\n/**\n * The client instance from the server-side is responsible for the transport layer between the server and the client.\n * It should not be confused with the Client from the client-side SDK, as they have completely different purposes!\n * You operate on client instances from `this.clients`, `Room#onJoin()`, `Room#onLeave()` and `Room#onMessage()`.\n *\n * - This is the raw WebSocket connection coming from the `ws` package. There are more methods available which aren't\n *  encouraged to use along with Colyseus.\n */\nexport interface Client<T extends { userData?: any, auth?: any, messages?: Record<string | number, any> } = any> {\n  '~messages': ExtractClientMessages<T>;\n\n  ref: EventEmitter;\n\n  /**\n   * @deprecated use `sessionId` instead.\n   */\n  id: string;\n\n  /**\n   * Unique id per session.\n   */\n  sessionId: string; // TODO: remove sessionId on version 1.0.0\n\n  /**\n   * Connection state\n   */\n  state: ClientState;\n\n  /**\n   * Optional: when using `@view()` decorator in your state properties, this will be the view instance for this client.\n   */\n  view?: StateView;\n\n  /**\n   * User-defined data can be attached to the Client instance through this variable.\n   * - Can be used to store custom data about the client's connection. userData is not synchronized with the client,\n   * and should be used only to keep player-specific with its connection.\n   */\n  userData?: ExtractClientUserData<T>;\n\n  /**\n   * auth data provided by your `onAuth`\n   */\n  auth?: ExtractClientAuth<T>;\n\n  /**\n   * Reconnection token used to re-join the room after onLeave + allowReconnection().\n   *\n   * IMPORTANT:\n   *    This is not the full reconnection token the client provides for the server.\n   *    The format provided by .reconnect() from the client-side must follow: \"${roomId}:${reconnectionToken}\"\n   */\n  reconnectionToken: string;\n\n  // TODO: move these to ClientPrivate\n  raw(data: Uint8Array | Buffer, options?: ISendOptions, cb?: (err?: Error) => void): void;\n  enqueueRaw(data: Uint8Array | Buffer, options?: ISendOptions): void;\n\n  /**\n   * Send a type of message to the client. Messages are encoded with MsgPack and can hold any\n   * JSON-serializable data structure.\n   *\n   * @param type String or Number identifier the client SDK will use to receive this message\n   * @param message Message payload. (automatically encoded with msgpack.)\n   * @param options\n   */\n  send<K extends keyof this['~messages']>(\n    type: K,\n    ...args: MessageArgs<this['~messages'][K], ISendOptions>\n  ): void;\n\n  /**\n   * Send raw bytes to this specific client.\n   *\n   * @param type String or Number identifier the client SDK will use to receive this message\n   * @param bytes Raw byte array payload\n   * @param options\n   */\n  sendBytes(type: string | number, bytes: Buffer | Uint8Array, options?: ISendOptions): void;\n\n  /**\n   * Disconnect this client from the room.\n   *\n   * @param code Custom close code. Default value is 1000.\n   * @param data\n   * @see [Leave room](https://docs.colyseus.io/room#leave-room)\n   */\n  leave(code?: number, data?: string): void;\n\n  /**\n   * @deprecated Use .leave() instead.\n   */\n  close(code?: number, data?: string): void;\n\n  /**\n   * Triggers `onError` with specified code to the client-side.\n   *\n   * @param code\n   * @param message\n   */\n  error(code: number, message?: string): void;\n}\n\n/**\n * Private properties of the Client instance.\n * Only accessible internally by the framework, should not be encouraged/auto-completed for the user.\n *\n * TODO: refactor this.\n * @private\n */\nexport interface ClientPrivate {\n  readyState: number; // TODO: remove readyState on version 1.0.0. Use only \"state\" instead.\n  _enqueuedMessages?: any[];\n  _afterNextPatchQueue: Array<[string | number | Client, ArrayLike<any>]>;\n  _joinedAt: number; // \"elapsedTime\" when the client joined the room.\n\n  /**\n   * Used for rate limiting via maxMessagesPerSecond.\n   */\n  _numMessagesLastSecond?: number;\n  _lastMessageTime?: number;\n}\n\nexport class ClientArray<C extends Client = Client> extends Array<C> {\n  public getById(sessionId: string): C | undefined {\n    return this.find((client) => client.sessionId === sessionId);\n  }\n\n  public delete(client: C): boolean {\n    return spliceOne(this, this.indexOf(client));\n  }\n}\n\n/**\n * Shared internal method to connect a Client into a Room.\n * Validates seat reservation and joins the client to the room.\n *\n * @remarks\n * **\u26A0\uFE0F This is an internal API and not intended for end-user use.**\n *\n * @internal\n */\nexport async function connectClientToRoom(\n  room: Room | undefined,\n  client: Client & ClientPrivate,\n  authContext: AuthContext,\n  connectionOptions: {\n    reconnectionToken?: string;\n    skipHandshake?: boolean;\n  },\n): Promise<void> {\n  if (!room || !room.hasReservedSeat(client.sessionId, connectionOptions.reconnectionToken)) {\n    throw new ServerError(ErrorCode.MATCHMAKE_EXPIRED, 'seat reservation expired.');\n  }\n\n  await room['_onJoin'](client, authContext, connectionOptions);\n}"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,WAAsB;AACtB,YAAuB;AAIvB,0BAA0B;AAC1B,oBAA0B;AAE1B,oBAA6B;AAC7B,mBAA0B;AAC1B,yBAA4B;AAI5B,IAAI;AACG,SAAS,aAAa,WAAsB;AAAE,eAAa;AAAW;AACtE,SAAS,eAAe;AAAE,SAAO;AAAY;AAE7C,IAAe,YAAf,MAAyB;AAsBhC;AAeO,IAAM,cAAc;AAAA,EACzB,SAAS;AAAA,EACT,QAAQ;AAAA,EACR,cAAc;AAAA,EACd,aAAa;AAAA,EACb,SAAS;AAAA,EACT,QAAQ;AACV;AA4IO,IAAM,cAAN,cAAqD,MAAS;AAAA,EAC5D,QAAQ,WAAkC;AAC/C,WAAO,KAAK,KAAK,CAAC,WAAW,OAAO,cAAc,SAAS;AAAA,EAC7D;AAAA,EAEO,OAAO,QAAoB;AAChC,eAAO,wBAAU,MAAM,KAAK,QAAQ,MAAM,CAAC;AAAA,EAC7C;AACF;AAWA,eAAsB,oBACpB,MACA,QACA,aACA,mBAIe;AACf,MAAI,CAAC,QAAQ,CAAC,KAAK,gBAAgB,OAAO,WAAW,kBAAkB,iBAAiB,GAAG;AACzF,UAAM,IAAI,+BAAY,8BAAU,mBAAmB,2BAA2B;AAAA,EAChF;AAEA,QAAM,KAAK,SAAS,EAAE,QAAQ,aAAa,iBAAiB;AAC9D;",
+  "sourcesContent": ["import * as http from 'http';\nimport * as https from 'https';\n\nimport type { Router } from '@colyseus/better-call';\n\nimport { ErrorCode } from '@colyseus/shared-types';\nimport { StateView } from '@colyseus/schema';\nimport type { InputDecoder } from '@colyseus/schema/input';\n\nimport { EventEmitter } from 'events';\nimport { spliceOne } from './utils/Utils.ts';\nimport { ServerError } from './errors/ServerError.ts';\n\nimport type { Room } from './Room.ts';\n\nlet _transport: Transport | undefined;\nexport function setTransport(transport: Transport) { _transport = transport; }\nexport function getTransport() { return _transport; }\n\nexport abstract class Transport {\n    public protocol?: string;\n    /** Self-signed cert SHA-256 hash (byte array), surfaced to clients in the\n     *  matchmake response so a WebTransport client can pin it via\n     *  `serverCertificateHashes`. Set by transports that generate their own cert\n     *  (h3). Undefined for transports using a CA-trusted cert. */\n    public fingerprint?: number[];\n    public server?: http.Server | https.Server;\n\n    public abstract listen(port?: number | string, hostname?: string, backlog?: number, listeningListener?: Function): this;\n    public abstract shutdown(): void;\n\n    public abstract simulateLatency(milliseconds: number): void;\n\n    /**\n     * Returns an Express-compatible application for HTTP route handling.\n     * For uWebSockets transport, this uses the uwebsockets-express module.\n     * This method is called lazily only when an express callback is provided in server options.\n     */\n    public getExpressApp?(): Promise<import('express').Application> | import('express').Application | undefined;\n\n    /**\n     * Binds a router to the transport.\n     * Some transports may have a custom way to bind a router to the transport.\n     * (uWebSocketsTransport)\n     */\n    public bindRouter?(router: Router): void;\n}\n\nexport type AuthContext = {\n  token?: string,\n  headers: Headers,\n  ip: string | string[];\n  // FIXME: each transport may have its own specific properties.\n  // \"req\" only applies to WebSocketTransport.\n  req?: any;\n};\n\nexport interface ISendOptions {\n  afterNextPatch?: boolean;\n}\n\nexport const ClientState = {\n  JOINING: 0,\n  JOINED: 1,\n  RECONNECTING: 2,\n  RECONNECTED: 3,\n  LEAVING: 4,\n  CLOSED: 5\n} as const;\nexport type ClientState = (typeof ClientState)[keyof typeof ClientState];\n\n// Helper types to extract properties from the Client type parameter\ntype ExtractClientUserData<T> = T extends { userData: infer U } ? U : T;\ntype ExtractClientAuth<T> = T extends { auth: infer A } ? A : any;\ntype ExtractClientMessages<T> = T extends { messages: infer M } ? M : any;\n\n// Helper type to make message required when the message type demands it\nexport type MessageArgs<M, Options> =\n  unknown extends M ? [message?: M, options?: Options] :  // Handle 'any' type (backwards compatibility)\n  [M] extends [never] ? [message?: M, options?: Options] :\n  [M] extends [void] ? [message?: M, options?: Options] :\n  [M] extends [undefined] ? [message?: M, options?: Options] :\n  undefined extends M ? [message?: M, options?: Options] :\n  [message: M, options?: Options];\n\n/**\n * The client instance from the server-side is responsible for the transport layer between the server and the client.\n * It should not be confused with the Client from the client-side SDK, as they have completely different purposes!\n * You operate on client instances from `this.clients`, `Room#onJoin()`, `Room#onLeave()` and `Room#onMessage()`.\n *\n * - This is the raw WebSocket connection coming from the `ws` package. There are more methods available which aren't\n *  encouraged to use along with Colyseus.\n */\nexport interface Client<T extends { userData?: any, auth?: any, messages?: Record<string | number, any> } = any> {\n  '~messages': ExtractClientMessages<T>;\n\n  ref: EventEmitter;\n\n  /**\n   * Unique id per session.\n   */\n  sessionId: string;\n\n  /**\n   * Connection state\n   */\n  state: ClientState;\n\n  /**\n   * Optional: when using `@view()` decorator in your state properties, this will be the view instance for this client.\n   */\n  view?: StateView;\n\n  /**\n   * User-defined data can be attached to the Client instance through this variable.\n   * - Can be used to store custom data about the client's connection. userData is not synchronized with the client,\n   * and should be used only to keep player-specific with its connection.\n   */\n  userData?: ExtractClientUserData<T>;\n\n  /**\n   * auth data provided by your `onAuth`\n   */\n  auth?: ExtractClientAuth<T>;\n\n  /**\n   * Reconnection token used to re-join the room after onLeave + allowReconnection().\n   *\n   * IMPORTANT:\n   *    This is not the full reconnection token the client provides for the server.\n   *    The format provided by .reconnect() from the client-side must follow: \"${roomId}:${reconnectionToken}\"\n   */\n  reconnectionToken: string;\n\n  // TODO: move these to ClientPrivate\n  raw(data: Uint8Array | Buffer, options?: ISendOptions, cb?: (err?: Error) => void): void;\n  enqueueRaw(data: Uint8Array | Buffer, options?: ISendOptions): void;\n\n  /**\n   * Send a type of message to the client. Messages are encoded with MsgPack and can hold any\n   * JSON-serializable data structure.\n   *\n   * @param type String or Number identifier the client SDK will use to receive this message\n   * @param message Message payload. (automatically encoded with msgpack.)\n   * @param options\n   */\n  send<K extends keyof this['~messages']>(\n    type: K,\n    ...args: MessageArgs<this['~messages'][K], ISendOptions>\n  ): void;\n\n  /**\n   * Send raw bytes to this specific client.\n   *\n   * @param type String or Number identifier the client SDK will use to receive this message\n   * @param bytes Raw byte array payload\n   * @param options\n   */\n  sendBytes(type: string | number, bytes: Buffer | Uint8Array, options?: ISendOptions): void;\n\n  /**\n   * Disconnect this client from the room.\n   *\n   * @param code Custom close code. Default value is 1000.\n   * @param data\n   * @see [Leave room](https://docs.colyseus.io/room#leave-room)\n   */\n  leave(code?: number, data?: string): void;\n\n  /**\n   * @deprecated Use .leave() instead.\n   */\n  close(code?: number, data?: string): void;\n\n  /**\n   * Triggers `onError` with specified code to the client-side.\n   *\n   * @param code\n   * @param message\n   */\n  error(code: number, message?: string): void;\n}\n\n/**\n * Private properties of the Client instance.\n * Only accessible internally by the framework, should not be encouraged/auto-completed for the user.\n *\n * TODO: refactor this.\n * @private\n */\nexport interface ClientPrivate {\n  readyState: number; // TODO: remove readyState on version 1.0.0. Use only \"state\" instead.\n  _enqueuedMessages?: any[];\n  _joinedAt: number; // \"elapsedTime\" when the client joined the room.\n\n  /**\n   * Used for rate limiting via maxMessagesPerSecond.\n   */\n  _numMessagesLastSecond?: number;\n  _lastMessageTime?: number;\n\n  /**\n   * Per-client input Schema instance, allocated on join when the Room\n   * declares `input`. Mutated in-place by {@link _inputDecoder} on each\n   * incoming ROOM_INPUT_* packet.\n   *\n   * Typed loosely (`any`) so duplicate `@colyseus/schema` installs don't\n   * trigger type-identity errors against user-defined input classes.\n   */\n  _input?: any;\n  _inputDecoder?: InputDecoder;\n\n  /**\n   * Per-client buffer of cloned input snapshots, allocated on join when\n   * `Room.inputOptions.bufferMaxSize > 0`. Populated on each decoded frame.\n   */\n  _inputBuffer?: import('./input/InputBuffer.ts').InputBufferImpl;\n\n  /**\n   * Cached per-client accessor returned by `room.input(sessionId)`. Built\n   * once at join (when the Room called `defineInput()`), so the public API\n   * call is a Map lookup + property read with no per-call allocation.\n   */\n  _inputAccessor?: import('./input/types.ts').InputAccessor;\n\n  /**\n   * Used for rate limiting ROOM_INPUT_* packets via maxInputsPerSecond,\n   * independent of maxMessagesPerSecond.\n   */\n  _numInputsLastSecond?: number;\n  _lastInputTime?: number;\n\n  /**\n   * `performance.now()` recorded when the most recent ROOM_INPUT_* packet\n   * from this client was received. Drives the per-recipient `lastTReceived`\n   * field of the {@link ProtocolModifier.TIMED} state prefix.\n   *\n   * `0` until the client has sent its first input.\n   */\n  _lastInputReceivedAt?: number;\n\n  /**\n   * Monotonic count of *reliable* inputs successfully received from this\n   * client. Echoed back in the TIMED prefix as `lastInputSeq` so the\n   * client can correlate to its own send-time table and compute RTT.\n   * Stays at the default `0` until the client sends its first reliable\n   * input.\n   *\n   * Only ROOM_INPUT_RELIABLE bumps this \u2014 unreliable's redundant-ring\n   * pattern would double-count.\n   */\n  _receivedInputCount?: number;\n\n  /**\n   * Running baseline for the DELTA-CODED lag-comp stamp on ROOM_INPUT_RELIABLE\n   * frames (the {@link ProtocolModifier.TIMED} prefix). Each frame carries only\n   * the signed change from the previous stamp; this accumulates them back into\n   * the absolute timeline value. Zeroed on (re)connect alongside the SDK's own\n   * baseline so the first delta after a reset is absolute. `0` until allocated.\n   */\n  _reckonBaseline?: number;\n\n  /**\n   * @internal Per-client raw frames staged to ride out right AFTER this client's\n   * next state patch \u2014 per-client `afterNextPatch` messages. Lazily allocated.\n   * Pushed by {@link enqueueClientRaw} (the `afterNextPatch` path), flushed as\n   * standalone frames after the patch by {@link Room._flushPendingClientFrames}.\n   * Room-level `broadcast` `afterNextPatch` uses the Room's own queue instead, not\n   * this buffer.\n   */\n  _pendingFrames?: Uint8Array[];\n\n  /**\n   * @internal Back-reference to the Room's \"clients with staged frames\" list,\n   * shared by reference at join. {@link enqueueClientRaw} pushes the client here\n   * on its first staged frame of a cycle, so the after-patch flush iterates just\n   * those clients rather than scanning every client.\n   */\n  _pendingFrameClients?: Array<Client & ClientPrivate>;\n}\n\n/**\n * The framework-level send path shared by every transport's `enqueueRaw` \u2014 the\n * single source of truth so each transport implements only the wire-level `raw`.\n * Routes a raw frame by where it should go:\n *\n *  - `afterNextPatch` \u2192 stage onto the per-client {@link ClientPrivate._pendingFrames}\n *    buffer, sent as a standalone frame right AFTER the next state patch; a\n *    no-allocation push into a reused array. The client announces itself to the\n *    Room's {@link ClientPrivate._pendingFrameClients} list on its first staged\n *    frame of a cycle.\n *  - before JOIN \u2192 buffer in `_enqueuedMessages` until the JOIN_ROOM handshake flushes.\n *  - otherwise \u2192 send now via the transport's `raw`.\n *\n * @internal\n */\nexport function enqueueClientRaw(\n  client: Client & ClientPrivate,\n  data: Uint8Array | Buffer,\n  options?: ISendOptions,\n): void {\n  if (options?.afterNextPatch) {\n    let frames = client._pendingFrames;\n    if (frames === undefined) { frames = client._pendingFrames = []; }\n    if (frames.length === 0) { client._pendingFrameClients?.push(client); } // first frame this cycle\n    frames.push(data);\n    return;\n  }\n  if (client.state !== ClientState.JOINED) {\n    // During `onJoin` / `onReconnect` the client can't register onMessage\n    // handlers yet \u2014 buffer until JOIN_ROOM has been sent.\n    client._enqueuedMessages?.push(data);\n    return;\n  }\n  client.raw(data, options);\n}\n\nexport class ClientArray<C extends Client = Client> extends Array<C> {\n  /**\n   * Secondary index for O(1) lookup by sessionId. Kept in sync by the\n   * mutating methods overridden below. Direct index assignment\n   * (`arr[i] = client`) and `arr.length = 0` bypass this index \u2014 use\n   * `push` / `splice` / `delete` / `pop` / `shift` / `unshift` instead.\n   */\n  private _byId: Map<string, C> = new Map();\n\n  /** The client for `sessionId`, or `undefined` \u2014 O(1). The canonical per-session\n   *  lookup (mirrors `room.inputs.get(sessionId)`). */\n  public get(sessionId: string): C | undefined {\n    return this._byId.get(sessionId);\n  }\n\n  /** @deprecated Use {@link get}. */\n  public getById(sessionId: string): C | undefined {\n    return this._byId.get(sessionId);\n  }\n\n  public delete(client: C): boolean {\n    const removed = spliceOne(this, this.indexOf(client));\n    if (removed) this._byId.delete(client.sessionId);\n    return removed;\n  }\n\n  public push(...items: C[]): number {\n    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);\n    return super.push(...items);\n  }\n\n  public pop(): C | undefined {\n    const removed = super.pop();\n    if (removed !== undefined) this._byId.delete(removed.sessionId);\n    return removed;\n  }\n\n  public shift(): C | undefined {\n    const removed = super.shift();\n    if (removed !== undefined) this._byId.delete(removed.sessionId);\n    return removed;\n  }\n\n  public unshift(...items: C[]): number {\n    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);\n    return super.unshift(...items);\n  }\n\n  public splice(start: number, deleteCount?: number, ...items: C[]): C[] {\n    const removed = (deleteCount === undefined)\n      ? super.splice(start)\n      : super.splice(start, deleteCount, ...items);\n    for (let i = 0; i < removed.length; i++) this._byId.delete(removed[i].sessionId);\n    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);\n    return removed;\n  }\n}\n\n/**\n * Shared internal method to connect a Client into a Room.\n * Validates seat reservation and joins the client to the room.\n *\n * @remarks\n * **\u26A0\uFE0F This is an internal API and not intended for end-user use.**\n *\n * @internal\n */\nexport async function connectClientToRoom(\n  room: Room | undefined,\n  client: Client & ClientPrivate,\n  authContext: AuthContext,\n  connectionOptions: {\n    reconnectionToken?: string;\n    skipHandshake?: boolean;\n  },\n): Promise<void> {\n  if (!room || !room.hasReservedSeat(client.sessionId, connectionOptions.reconnectionToken)) {\n    throw new ServerError(ErrorCode.MATCHMAKE_EXPIRED, 'seat reservation expired.');\n  }\n\n  await room['_onJoin'](client, authContext, connectionOptions);\n}"],
+  "mappings": "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",
   "names": []
 }

package/build/Transport.d.ts

@@ -2,12 +2,18 @@ import * as http from 'http';
 import * as https from 'https';
 import type { Router } from '@colyseus/better-call';
 import { StateView } from '@colyseus/schema';
+import type { InputDecoder } from '@colyseus/schema/input';
 import { EventEmitter } from 'events';
 import type { Room } from './Room.ts';
 export declare function setTransport(transport: Transport): void;
 export declare function getTransport(): Transport;
 export declare abstract class Transport {
     protocol?: string;
+    /** Self-signed cert SHA-256 hash (byte array), surfaced to clients in the
+     *  matchmake response so a WebTransport client can pin it via
+     *  `serverCertificateHashes`. Set by transports that generate their own cert
+     *  (h3). Undefined for transports using a CA-trusted cert. */
+    fingerprint?: number[];
     server?: http.Server | https.Server;
     abstract listen(port?: number | string, hostname?: string, backlog?: number, listeningListener?: Function): this;
     abstract shutdown(): void;
@@ -77,10 +83,6 @@ export interface Client<T extends {
 } = any> {
     '~messages': ExtractClientMessages<T>;
     ref: EventEmitter;
-    /**
-     * @deprecated use `sessionId` instead.
-     */
-    id: string;
     /**
      * Unique id per session.
      */
@@ -160,17 +162,118 @@ export interface Client<T extends {
 export interface ClientPrivate {
     readyState: number;
     _enqueuedMessages?: any[];
-    _afterNextPatchQueue: Array<[string | number | Client, ArrayLike<any>]>;
     _joinedAt: number;
     /**
      * Used for rate limiting via maxMessagesPerSecond.
      */
     _numMessagesLastSecond?: number;
     _lastMessageTime?: number;
+    /**
+     * Per-client input Schema instance, allocated on join when the Room
+     * declares `input`. Mutated in-place by {@link _inputDecoder} on each
+     * incoming ROOM_INPUT_* packet.
+     *
+     * Typed loosely (`any`) so duplicate `@colyseus/schema` installs don't
+     * trigger type-identity errors against user-defined input classes.
+     */
+    _input?: any;
+    _inputDecoder?: InputDecoder;
+    /**
+     * Per-client buffer of cloned input snapshots, allocated on join when
+     * `Room.inputOptions.bufferMaxSize > 0`. Populated on each decoded frame.
+     */
+    _inputBuffer?: import('./input/InputBuffer.ts').InputBufferImpl;
+    /**
+     * Cached per-client accessor returned by `room.input(sessionId)`. Built
+     * once at join (when the Room called `defineInput()`), so the public API
+     * call is a Map lookup + property read with no per-call allocation.
+     */
+    _inputAccessor?: import('./input/types.ts').InputAccessor;
+    /**
+     * Used for rate limiting ROOM_INPUT_* packets via maxInputsPerSecond,
+     * independent of maxMessagesPerSecond.
+     */
+    _numInputsLastSecond?: number;
+    _lastInputTime?: number;
+    /**
+     * `performance.now()` recorded when the most recent ROOM_INPUT_* packet
+     * from this client was received. Drives the per-recipient `lastTReceived`
+     * field of the {@link ProtocolModifier.TIMED} state prefix.
+     *
+     * `0` until the client has sent its first input.
+     */
+    _lastInputReceivedAt?: number;
+    /**
+     * Monotonic count of *reliable* inputs successfully received from this
+     * client. Echoed back in the TIMED prefix as `lastInputSeq` so the
+     * client can correlate to its own send-time table and compute RTT.
+     * Stays at the default `0` until the client sends its first reliable
+     * input.
+     *
+     * Only ROOM_INPUT_RELIABLE bumps this — unreliable's redundant-ring
+     * pattern would double-count.
+     */
+    _receivedInputCount?: number;
+    /**
+     * Running baseline for the DELTA-CODED lag-comp stamp on ROOM_INPUT_RELIABLE
+     * frames (the {@link ProtocolModifier.TIMED} prefix). Each frame carries only
+     * the signed change from the previous stamp; this accumulates them back into
+     * the absolute timeline value. Zeroed on (re)connect alongside the SDK's own
+     * baseline so the first delta after a reset is absolute. `0` until allocated.
+     */
+    _reckonBaseline?: number;
+    /**
+     * @internal Per-client raw frames staged to ride out right AFTER this client's
+     * next state patch — per-client `afterNextPatch` messages. Lazily allocated.
+     * Pushed by {@link enqueueClientRaw} (the `afterNextPatch` path), flushed as
+     * standalone frames after the patch by {@link Room._flushPendingClientFrames}.
+     * Room-level `broadcast` `afterNextPatch` uses the Room's own queue instead, not
+     * this buffer.
+     */
+    _pendingFrames?: Uint8Array[];
+    /**
+     * @internal Back-reference to the Room's "clients with staged frames" list,
+     * shared by reference at join. {@link enqueueClientRaw} pushes the client here
+     * on its first staged frame of a cycle, so the after-patch flush iterates just
+     * those clients rather than scanning every client.
+     */
+    _pendingFrameClients?: Array<Client & ClientPrivate>;
 }
+/**
+ * The framework-level send path shared by every transport's `enqueueRaw` — the
+ * single source of truth so each transport implements only the wire-level `raw`.
+ * Routes a raw frame by where it should go:
+ *
+ *  - `afterNextPatch` → stage onto the per-client {@link ClientPrivate._pendingFrames}
+ *    buffer, sent as a standalone frame right AFTER the next state patch; a
+ *    no-allocation push into a reused array. The client announces itself to the
+ *    Room's {@link ClientPrivate._pendingFrameClients} list on its first staged
+ *    frame of a cycle.
+ *  - before JOIN → buffer in `_enqueuedMessages` until the JOIN_ROOM handshake flushes.
+ *  - otherwise → send now via the transport's `raw`.
+ *
+ * @internal
+ */
+export declare function enqueueClientRaw(client: Client & ClientPrivate, data: Uint8Array | Buffer, options?: ISendOptions): void;
 export declare class ClientArray<C extends Client = Client> extends Array<C> {
+    /**
+     * Secondary index for O(1) lookup by sessionId. Kept in sync by the
+     * mutating methods overridden below. Direct index assignment
+     * (`arr[i] = client`) and `arr.length = 0` bypass this index — use
+     * `push` / `splice` / `delete` / `pop` / `shift` / `unshift` instead.
+     */
+    private _byId;
+    /** The client for `sessionId`, or `undefined` — O(1). The canonical per-session
+     *  lookup (mirrors `room.inputs.get(sessionId)`). */
+    get(sessionId: string): C | undefined;
+    /** @deprecated Use {@link get}. */
     getById(sessionId: string): C | undefined;
     delete(client: C): boolean;
+    push(...items: C[]): number;
+    pop(): C | undefined;
+    shift(): C | undefined;
+    unshift(...items: C[]): number;
+    splice(start: number, deleteCount?: number, ...items: C[]): C[];
 }
 /**
  * Shared internal method to connect a Client into a Room.

package/build/Transport.mjs

@@ -23,12 +23,72 @@ var ClientState = {
   LEAVING: 4,
   CLOSED: 5
 };
+function enqueueClientRaw(client, data, options) {
+  if (options?.afterNextPatch) {
+    let frames = client._pendingFrames;
+    if (frames === void 0) {
+      frames = client._pendingFrames = [];
+    }
+    if (frames.length === 0) {
+      client._pendingFrameClients?.push(client);
+    }
+    frames.push(data);
+    return;
+  }
+  if (client.state !== ClientState.JOINED) {
+    client._enqueuedMessages?.push(data);
+    return;
+  }
+  client.raw(data, options);
+}
 var ClientArray = class extends Array {
+  constructor() {
+    super(...arguments);
+    /**
+     * Secondary index for O(1) lookup by sessionId. Kept in sync by the
+     * mutating methods overridden below. Direct index assignment
+     * (`arr[i] = client`) and `arr.length = 0` bypass this index — use
+     * `push` / `splice` / `delete` / `pop` / `shift` / `unshift` instead.
+     */
+    this._byId = /* @__PURE__ */ new Map();
+  }
+  /** The client for `sessionId`, or `undefined` — O(1). The canonical per-session
+   *  lookup (mirrors `room.inputs.get(sessionId)`). */
+  get(sessionId) {
+    return this._byId.get(sessionId);
+  }
+  /** @deprecated Use {@link get}. */
   getById(sessionId) {
-    return this.find((client) => client.sessionId === sessionId);
+    return this._byId.get(sessionId);
   }
   delete(client) {
-    return spliceOne(this, this.indexOf(client));
+    const removed = spliceOne(this, this.indexOf(client));
+    if (removed) this._byId.delete(client.sessionId);
+    return removed;
+  }
+  push(...items) {
+    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);
+    return super.push(...items);
+  }
+  pop() {
+    const removed = super.pop();
+    if (removed !== void 0) this._byId.delete(removed.sessionId);
+    return removed;
+  }
+  shift() {
+    const removed = super.shift();
+    if (removed !== void 0) this._byId.delete(removed.sessionId);
+    return removed;
+  }
+  unshift(...items) {
+    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);
+    return super.unshift(...items);
+  }
+  splice(start, deleteCount, ...items) {
+    const removed = deleteCount === void 0 ? super.splice(start) : super.splice(start, deleteCount, ...items);
+    for (let i = 0; i < removed.length; i++) this._byId.delete(removed[i].sessionId);
+    for (let i = 0; i < items.length; i++) this._byId.set(items[i].sessionId, items[i]);
+    return removed;
   }
 };
 async function connectClientToRoom(room, client, authContext, connectionOptions) {
@@ -42,6 +102,7 @@ export {
   ClientState,
   Transport,
   connectClientToRoom,
+  enqueueClientRaw,
   getTransport,
   setTransport
 };