@colyseus/core 0.17.43 → 0.18.0

package/build/index.mjs

@@ -7,6 +7,11 @@ import {
 } from "@colyseus/shared-types";
 import { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions } from "./Server.mjs";
 import { Room, room, RoomInternalState, validate } from "./Room.mjs";
+import {
+  RoomPlugin,
+  definePlugins,
+  attachToTestRoom
+} from "./RoomPlugin.mjs";
 import { getMessageBytes } from "./Protocol.mjs";
 import { RegisteredHandler } from "./matchmaker/RegisteredHandler.mjs";
 import { ServerError } from "./errors/ServerError.mjs";
@@ -51,8 +56,9 @@ import {
   createInternalContext,
   createMiddleware,
   createRouter,
+  basicAuth,
   toNodeHandler,
-  __globalEndpoints
+  dualModeEndpoints
 } from "./router/index.mjs";
 import { logger } from "./Logger.mjs";
 export {
@@ -77,13 +83,15 @@ export {
   RelayRoom,
   Room,
   RoomInternalState,
+  RoomPlugin,
   SchemaSerializer,
   Server,
   ServerError,
   SimulationIntervalException,
   TimedEventException,
   Transport,
-  __globalEndpoints,
+  attachToTestRoom,
+  basicAuth,
   connectClientToRoom,
   createEndpoint,
   createInternalContext,
@@ -98,8 +106,10 @@ export {
   debugMessage,
   debugPatch,
   debugPresence,
+  definePlugins,
   defineRoom,
   defineServer,
+  dualModeEndpoints,
   dynamicImport,
   generateId,
   getBearerToken,

package/build/index.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/index.ts"],
-  "sourcesContent": ["import { ClockTimer as Clock, Delayed } from '@colyseus/timer';\n\n// Shared types - re-export from @colyseus/shared-types for convenience\nexport {\n  Protocol,\n  ErrorCode,\n  CloseCode,\n  type InferState,\n  type ExtractRoomMessages,\n  type ExtractRoomClientMessages,\n} from '@colyseus/shared-types';\n\n// Core classes\nexport { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';\nexport { Room, room, RoomInternalState, validate, type RoomOptions, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';\nexport { getMessageBytes } from './Protocol.ts';\nexport { RegisteredHandler } from './matchmaker/RegisteredHandler.ts';\nexport { ServerError } from './errors/ServerError.ts';\n\nexport {\n  type RoomException,\n  type RoomMethodName,\n  OnCreateException,\n  OnAuthException,\n  OnJoinException,\n  OnLeaveException,\n  OnDisposeException,\n  OnMessageException,\n  SimulationIntervalException,\n  TimedEventException,\n} from './errors/RoomExceptions.ts';\n\n// MatchMaker\nimport * as matchMaker from './MatchMaker.ts';\nexport { matchMaker };\nexport { updateLobby, subscribeLobby } from './matchmaker/Lobby.ts';\nexport { createNodeMatchmakingMiddleware } from './router/node.ts';\n\n// Driver\nexport * from './matchmaker/LocalDriver/LocalDriver.ts';\nexport { initializeRoomCache } from './matchmaker/driver.ts';\n\n// Transport\nexport { type Client, type ClientPrivate, type AuthContext, ClientState, ClientArray, Transport, type ISendOptions, connectClientToRoom } from './Transport.ts';\n\n// Presence\nexport { type Presence } from './presence/Presence.ts';\nexport { LocalPresence } from './presence/LocalPresence.ts';\n\n// Serializers\nexport { type Serializer } from './serializer/Serializer.ts';\nexport { SchemaSerializer } from './serializer/SchemaSerializer.ts';\n\n// Utilities\nexport { Clock, Delayed };\nexport { generateId, Deferred, spliceOne, getBearerToken, dynamicImport } from './utils/Utils.ts';\nexport { isDevMode, setDevMode } from './utils/DevMode.ts';\n\n// IPC\nexport { subscribeIPC, requestFromIPC } from './IPC.ts';\n\n// Debug\nexport {\n  debugMatchMaking,\n  debugMessage,\n  debugPatch,\n  debugError,\n  debugConnection,\n  debugDriver,\n  debugPresence,\n  debugAndPrintError,\n} from './Debug.ts';\n\n// Default rooms\nexport { LobbyRoom } from './rooms/LobbyRoom.ts';\nexport { RelayRoom } from './rooms/RelayRoom.ts';\nexport { QueueRoom, type QueueOptions, type QueueMatchGroup, type QueueMatchTeam, type QueueClientData } from './rooms/QueueRoom.ts';\n\n// Router / Endpoints\nexport {\n  createEndpoint,\n  createInternalContext,\n  createMiddleware,\n  createRouter,\n  toNodeHandler,\n  __globalEndpoints,\n  type Router,\n  type RouterConfig,\n  type Endpoint,\n  type EndpointHandler,\n  type EndpointOptions,\n  type EndpointContext,\n  type StrictEndpoint,\n} from './router/index.ts';\n\n// Abstract logging support\nexport { logger } from './Logger.ts';\n"],
-  "mappings": ";AAAA,SAAS,cAAc,OAAO,eAAe;AAG7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAGP,SAAS,QAAQ,YAAY,cAAc,yBAAyB,iCAA0F;AAC9J,SAAS,MAAM,MAAM,mBAAmB,gBAAyJ;AACjM,SAAS,uBAAuB;AAChC,SAAS,yBAAyB;AAClC,SAAS,mBAAmB;AAE5B;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,YAAY,gBAAgB;AAE5B,SAAS,aAAa,sBAAsB;AAC5C,SAAS,uCAAuC;AAGhD,cAAc;AACd,SAAS,2BAA2B;AAGpC,SAA4D,aAAa,aAAa,WAA8B,2BAA2B;AAG/I,eAA8B;AAC9B,SAAS,qBAAqB;AAG9B,eAAgC;AAChC,SAAS,wBAAwB;AAIjC,SAAS,YAAY,UAAU,WAAW,gBAAgB,qBAAqB;AAC/E,SAAS,WAAW,kBAAkB;AAGtC,SAAS,cAAc,sBAAsB;AAG7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,iBAAqG;AAG9G;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OAQK;AAGP,SAAS,cAAc;",
+  "sourcesContent": ["import { ClockTimer as Clock, Delayed } from '@colyseus/timer';\n\n// Shared types - re-export from @colyseus/shared-types for convenience\nexport {\n  Protocol,\n  ErrorCode,\n  CloseCode,\n  type InferState,\n  type ExtractRoomMessages,\n  type ExtractRoomClientMessages,\n} from '@colyseus/shared-types';\n\n// Core classes\nexport { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';\nexport { Room, room, RoomInternalState, validate, type RoomOptions, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';\nexport {\n  RoomPlugin, definePlugins, attachToTestRoom,\n  type RoomPluginOrder, type PluginDependencies, type RoomPluginClass,\n} from './RoomPlugin.ts';\nexport { getMessageBytes } from './Protocol.ts';\nexport { RegisteredHandler } from './matchmaker/RegisteredHandler.ts';\nexport { ServerError } from './errors/ServerError.ts';\n\nexport {\n  type RoomException,\n  type RoomMethodName,\n  OnCreateException,\n  OnAuthException,\n  OnJoinException,\n  OnLeaveException,\n  OnDisposeException,\n  OnMessageException,\n  SimulationIntervalException,\n  TimedEventException,\n} from './errors/RoomExceptions.ts';\n\n// MatchMaker\nimport * as matchMaker from './MatchMaker.ts';\nexport { matchMaker };\nexport { updateLobby, subscribeLobby } from './matchmaker/Lobby.ts';\nexport { createNodeMatchmakingMiddleware } from './router/node.ts';\n\n// Driver\nexport * from './matchmaker/LocalDriver/LocalDriver.ts';\nexport { initializeRoomCache } from './matchmaker/driver.ts';\n\n// Transport\nexport { type Client, type ClientPrivate, type AuthContext, ClientState, ClientArray, Transport, type ISendOptions, connectClientToRoom } from './Transport.ts';\n\n// Presence\nexport { type Presence } from './presence/Presence.ts';\nexport { LocalPresence } from './presence/LocalPresence.ts';\n\n// Serializers\nexport { type Serializer } from './serializer/Serializer.ts';\nexport { SchemaSerializer } from './serializer/SchemaSerializer.ts';\n\n// Utilities\nexport { Clock, Delayed };\nexport { generateId, Deferred, spliceOne, getBearerToken, dynamicImport } from './utils/Utils.ts';\nexport { isDevMode, setDevMode } from './utils/DevMode.ts';\n\n// IPC\nexport { subscribeIPC, requestFromIPC } from './IPC.ts';\n\n// Debug\nexport {\n  debugMatchMaking,\n  debugMessage,\n  debugPatch,\n  debugError,\n  debugConnection,\n  debugDriver,\n  debugPresence,\n  debugAndPrintError,\n} from './Debug.ts';\n\n// Default rooms\nexport { LobbyRoom } from './rooms/LobbyRoom.ts';\nexport { RelayRoom } from './rooms/RelayRoom.ts';\nexport { QueueRoom, type QueueOptions, type QueueMatchGroup, type QueueMatchTeam, type QueueClientData } from './rooms/QueueRoom.ts';\n\n// Router / Endpoints\nexport {\n  createEndpoint,\n  createInternalContext,\n  createMiddleware,\n  createRouter,\n  basicAuth,\n  type BasicAuthOptions,\n  toNodeHandler,\n  dualModeEndpoints,\n  type Router,\n  type RouterConfig,\n  type Endpoint,\n  type EndpointHandler,\n  type EndpointOptions,\n  type EndpointContext,\n  type StrictEndpoint,\n  type ExpressMiddleware,\n  type NodeHandler,\n  type DualModeHelpers,\n} from './router/index.ts';\n\n// Abstract logging support\nexport { logger } from './Logger.ts';\n"],
+  "mappings": ";AAAA,SAAS,cAAc,OAAO,eAAe;AAG7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,OAIK;AAGP,SAAS,QAAQ,YAAY,cAAc,yBAAyB,iCAA0F;AAC9J,SAAS,MAAM,MAAM,mBAAmB,gBAAyJ;AACjM;AAAA,EACE;AAAA,EAAY;AAAA,EAAe;AAAA,OAEtB;AACP,SAAS,uBAAuB;AAChC,SAAS,yBAAyB;AAClC,SAAS,mBAAmB;AAE5B;AAAA,EAGE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,YAAY,gBAAgB;AAE5B,SAAS,aAAa,sBAAsB;AAC5C,SAAS,uCAAuC;AAGhD,cAAc;AACd,SAAS,2BAA2B;AAGpC,SAA4D,aAAa,aAAa,WAA8B,2BAA2B;AAG/I,eAA8B;AAC9B,SAAS,qBAAqB;AAG9B,eAAgC;AAChC,SAAS,wBAAwB;AAIjC,SAAS,YAAY,UAAU,WAAW,gBAAgB,qBAAqB;AAC/E,SAAS,WAAW,kBAAkB;AAGtC,SAAS,cAAc,sBAAsB;AAG7C;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,OACK;AAGP,SAAS,iBAAiB;AAC1B,SAAS,iBAAiB;AAC1B,SAAS,iBAAqG;AAG9G;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EAEA;AAAA,EACA;AAAA,OAWK;AAGP,SAAS,cAAc;",
   "names": []
 }

package/build/input/InputBuffer.cjs

@@ -0,0 +1,113 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/core/src/input/InputBuffer.ts
+var InputBuffer_exports = {};
+__export(InputBuffer_exports, {
+  InputAccessorImpl: () => InputAccessorImpl,
+  InputBufferImpl: () => InputBufferImpl,
+  NO_OP_INPUT_ACCESSOR: () => NO_OP_INPUT_ACCESSOR
+});
+module.exports = __toCommonJS(InputBuffer_exports);
+var InputBufferImpl = class {
+  constructor(maxSize, seqField) {
+    this._items = [];
+    this._lastSeq = -Infinity;
+    this._maxSize = maxSize;
+    this._seqField = seqField;
+  }
+  push(snapshot) {
+    this._items.push(snapshot);
+    if (this._items.length > this._maxSize) {
+      this._items.shift();
+    }
+  }
+  /** Returns true if `value` hasn't been seen, and updates the last-seen marker. */
+  accept(value) {
+    if (value <= this._lastSeq) {
+      return false;
+    }
+    this._lastSeq = value;
+    return true;
+  }
+  drain() {
+    const out = this._items;
+    this._items = [];
+    return out;
+  }
+  peek() {
+    return this._items.slice();
+  }
+  at(value) {
+    if (this._seqField === void 0) {
+      return void 0;
+    }
+    for (let i = 0; i < this._items.length; i++) {
+      if (this._items[i][this._seqField] === value) {
+        return this._items[i];
+      }
+    }
+    return void 0;
+  }
+  get size() {
+    return this._items.length;
+  }
+  clear() {
+    this._items.length = 0;
+    this._lastSeq = -Infinity;
+  }
+};
+var InputAccessorImpl = class {
+  constructor(client) {
+    this._client = client;
+  }
+  get latest() {
+    return this._client._input;
+  }
+  at(value) {
+    return this._client._inputBuffer?.at(value);
+  }
+  drain() {
+    return this._client._inputBuffer?.drain() ?? [];
+  }
+  peek() {
+    return this._client._inputBuffer?.peek() ?? [];
+  }
+  get size() {
+    return this._client._inputBuffer?.size ?? 0;
+  }
+  clear() {
+    this._client._inputBuffer?.clear();
+  }
+};
+var NO_OP_INPUT_ACCESSOR = Object.freeze({
+  latest: void 0,
+  at: () => void 0,
+  drain: () => [],
+  peek: () => [],
+  size: 0,
+  clear: () => {
+  }
+});
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  InputAccessorImpl,
+  InputBufferImpl,
+  NO_OP_INPUT_ACCESSOR
+});

package/build/input/InputBuffer.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/input/InputBuffer.ts"],
+  "sourcesContent": ["import type { ClientPrivate } from '../Transport.ts';\n\n/**\n * Names of fields on `I` whose values are `number` \u2014 used by\n * `Room.defineInput()` to constrain `seqField` to actually-numeric fields\n * on the input schema. Filters out booleans, strings, methods, etc.\n */\nexport type NumericFieldsOf<I> = {\n  [K in keyof I]: I[K] extends number ? (K extends string ? K : never) : never;\n}[keyof I];\n\n/**\n * Internal: input configuration captured by `Room.defineInput()`. The schema\n * constructor is stored here so the runtime doesn't need to know it through\n * the public `room.input` (which is now a callable accessor).\n *\n * @internal\n */\nexport interface InputOptions {\n  /**\n   * Schema constructor used to allocate per-client input instances on join.\n   * Captured by `defineInput()` from its `type` argument.\n   *\n   * Typed loosely (`new () => any`) to sidestep type-identity issues across\n   * duplicate `@colyseus/schema` installs; the runtime calls\n   * `instance.clone()` and friends, which match by shape.\n   */\n  ctor: new () => any;\n\n  /**\n   * Name of a monotonically-increasing numeric field on the input schema used\n   * to order and dedupe incoming frames. When set, the framework:\n   * - Drops redundant frames (`input[seqField]` \u2264 the last-seen value are\n   *   discarded before they enter the buffer). Matches the unreliable-mode\n   *   ring-redundancy pattern out of the box.\n   * - Powers `room.input(sessionId).at(value)` lookups.\n   *\n   * Despite the name, \"seq\" here is broader than an integer counter \u2014 any\n   * monotonic numeric field works:\n   * - **Sequence counter** (`\"seq\"`, `\"tick\"`, `\"frame\"`) \u2014 typical for\n   *   lockstep / rollback netcode (Photon Quantum, GGPO).\n   * - **Timestamp** (`\"timestamp\"`, milliseconds or seconds) \u2014 useful for\n   *   variable-rate clients, lag compensation, hit registration (Unreal CMC\n   *   uses float-seconds timestamps via `FSavedMove_Character.TimeStamp`).\n   *\n   * Whichever you use, the field must increase monotonically across frames\n   * for dedupe to work.\n   */\n  seqField?: string;\n\n  /**\n   * > 0 enables per-client buffering of cloned snapshots \u2014 required for\n   * `room.input(sessionId).drain() / .peek() / .at()` to return populated\n   * data. Oldest drops on overflow. Set to `0` to disable (`.latest` still\n   * works).\n   */\n  bufferMaxSize: number;\n}\n\n/**\n * Per-client input accessor returned by `room.input(sessionId)`. Combines the\n * latest decoded instance with the (optional) snapshot ring buffer.\n *\n * - {@link latest} \u2014 the bound Schema instance, mutated in place by the\n *   decoder. Cheapest read; use when only the most recent state matters.\n * - {@link drain} / {@link peek} / {@link at} \u2014 populated when\n *   `defineInput()` was called with `bufferMaxSize > 0` (default 32).\n *   Use for rollback netcode / lockstep where every frame matters.\n *\n * Returned for unknown sessionIds and rooms without `defineInput()` is a\n * frozen no-op accessor (latest=undefined, drain/peek=[], at=undefined,\n * size=0, clear=no-op).\n */\nexport interface InputAccessor<I = any> {\n  /** Latest decoded input. `undefined` when unknown sessionId or no input declared. */\n  readonly latest: I | undefined;\n\n  /**\n   * Find the buffered snapshot whose `[seqField]` equals `value`. The field\n   * name is the Room's `defineInput()` `seqField`. Linear scan \u2014 cheap for\n   * typical buffer sizes; not intended for very large rings. Returns\n   * `undefined` when no match is buffered (or `seqField` isn't configured).\n   *\n   * Useful for tick-aligned retrieval (lockstep, rollback).\n   */\n  at(value: number): I | undefined;\n\n  /** Take everything buffered (oldest \u2192 newest) and clear. Snapshots are safe to retain. */\n  drain(): I[];\n\n  /** Read everything buffered without consuming. */\n  peek(): I[];\n\n  /** Number of snapshots currently buffered. */\n  readonly size: number;\n\n  /** Drop all buffered snapshots (also resets the dedupe tracker). */\n  clear(): void;\n}\n\n/**\n * Callable returned by `Room.defineInput()`. Assign it to `this.input` and\n * call `room.input(sessionId)` per tick to read each client's latest input\n * and/or buffered snapshots.\n */\nexport type InputAPI<I = any> = (sessionId: string) => InputAccessor<I>;\n\n/** @internal */\nexport class InputBufferImpl<I = any> {\n  private _items: I[] = [];\n  private _lastSeq: number = -Infinity;\n  private readonly _maxSize: number;\n  private readonly _seqField: string | undefined;\n\n  constructor(maxSize: number, seqField: string | undefined) {\n    this._maxSize = maxSize;\n    this._seqField = seqField;\n  }\n\n  push(snapshot: I): void {\n    this._items.push(snapshot);\n    if (this._items.length > this._maxSize) { this._items.shift(); }\n  }\n\n  /** Returns true if `value` hasn't been seen, and updates the last-seen marker. */\n  accept(value: number): boolean {\n    if (value <= this._lastSeq) { return false; }\n    this._lastSeq = value;\n    return true;\n  }\n\n  drain(): I[] {\n    const out = this._items;\n    this._items = [];\n    return out;\n  }\n\n  peek(): I[] {\n    return this._items.slice();\n  }\n\n  at(value: number): I | undefined {\n    if (this._seqField === undefined) { return undefined; }\n    for (let i = 0; i < this._items.length; i++) {\n      if ((this._items[i] as any)[this._seqField] === value) { return this._items[i]; }\n    }\n    return undefined;\n  }\n\n  get size(): number {\n    return this._items.length;\n  }\n\n  clear(): void {\n    this._items.length = 0;\n    this._lastSeq = -Infinity;\n  }\n}\n\n/**\n * Default per-client accessor. Reads `_input` and `_inputBuffer` off the\n * client at access time \u2014 both are nullable until the room declares input\n * via `defineInput()`. Cached as `client._inputAccessor` at join, so\n * `room.input(sessionId)` is a Map lookup + property read.\n *\n * @internal\n */\nexport class InputAccessorImpl<I = any> implements InputAccessor<I> {\n  private _client: ClientPrivate;\n  constructor(client: ClientPrivate) { this._client = client; }\n  get latest(): I | undefined { return this._client._input as I | undefined; }\n  at(value: number): I | undefined { return this._client._inputBuffer?.at(value) as I | undefined; }\n  drain(): I[] { return (this._client._inputBuffer?.drain() ?? []) as I[]; }\n  peek(): I[] { return (this._client._inputBuffer?.peek() ?? []) as I[]; }\n  get size(): number { return this._client._inputBuffer?.size ?? 0; }\n  clear(): void { this._client._inputBuffer?.clear(); }\n}\n\n/**\n * Returned by `room.input(sessionId)` for unknown sessions and for rooms\n * that didn't call `defineInput()`.\n *\n * @internal\n */\nexport const NO_OP_INPUT_ACCESSOR: InputAccessor<any> = Object.freeze({\n  latest: undefined,\n  at: () => undefined,\n  drain: () => [],\n  peek: () => [],\n  size: 0,\n  clear: () => {},\n});\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AA4GO,IAAM,kBAAN,MAA+B;AAAA,EAMpC,YAAY,SAAiB,UAA8B;AAL3D,SAAQ,SAAc,CAAC;AACvB,SAAQ,WAAmB;AAKzB,SAAK,WAAW;AAChB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,KAAK,UAAmB;AACtB,SAAK,OAAO,KAAK,QAAQ;AACzB,QAAI,KAAK,OAAO,SAAS,KAAK,UAAU;AAAE,WAAK,OAAO,MAAM;AAAA,IAAG;AAAA,EACjE;AAAA;AAAA,EAGA,OAAO,OAAwB;AAC7B,QAAI,SAAS,KAAK,UAAU;AAAE,aAAO;AAAA,IAAO;AAC5C,SAAK,WAAW;AAChB,WAAO;AAAA,EACT;AAAA,EAEA,QAAa;AACX,UAAM,MAAM,KAAK;AACjB,SAAK,SAAS,CAAC;AACf,WAAO;AAAA,EACT;AAAA,EAEA,OAAY;AACV,WAAO,KAAK,OAAO,MAAM;AAAA,EAC3B;AAAA,EAEA,GAAG,OAA8B;AAC/B,QAAI,KAAK,cAAc,QAAW;AAAE,aAAO;AAAA,IAAW;AACtD,aAAS,IAAI,GAAG,IAAI,KAAK,OAAO,QAAQ,KAAK;AAC3C,UAAK,KAAK,OAAO,CAAC,EAAU,KAAK,SAAS,MAAM,OAAO;AAAE,eAAO,KAAK,OAAO,CAAC;AAAA,MAAG;AAAA,IAClF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,OAAe;AACjB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,QAAc;AACZ,SAAK,OAAO,SAAS;AACrB,SAAK,WAAW;AAAA,EAClB;AACF;AAUO,IAAM,oBAAN,MAA6D;AAAA,EAElE,YAAY,QAAuB;AAAE,SAAK,UAAU;AAAA,EAAQ;AAAA,EAC5D,IAAI,SAAwB;AAAE,WAAO,KAAK,QAAQ;AAAA,EAAyB;AAAA,EAC3E,GAAG,OAA8B;AAAE,WAAO,KAAK,QAAQ,cAAc,GAAG,KAAK;AAAA,EAAoB;AAAA,EACjG,QAAa;AAAE,WAAQ,KAAK,QAAQ,cAAc,MAAM,KAAK,CAAC;AAAA,EAAW;AAAA,EACzE,OAAY;AAAE,WAAQ,KAAK,QAAQ,cAAc,KAAK,KAAK,CAAC;AAAA,EAAW;AAAA,EACvE,IAAI,OAAe;AAAE,WAAO,KAAK,QAAQ,cAAc,QAAQ;AAAA,EAAG;AAAA,EAClE,QAAc;AAAE,SAAK,QAAQ,cAAc,MAAM;AAAA,EAAG;AACtD;AAQO,IAAM,uBAA2C,OAAO,OAAO;AAAA,EACpE,QAAQ;AAAA,EACR,IAAI,MAAM;AAAA,EACV,OAAO,MAAM,CAAC;AAAA,EACd,MAAM,MAAM,CAAC;AAAA,EACb,MAAM;AAAA,EACN,OAAO,MAAM;AAAA,EAAC;AAChB,CAAC;",
+  "names": []
+}

package/build/input/InputBuffer.d.ts

@@ -0,0 +1,136 @@
+import type { ClientPrivate } from '../Transport.ts';
+/**
+ * Names of fields on `I` whose values are `number` — used by
+ * `Room.defineInput()` to constrain `seqField` to actually-numeric fields
+ * on the input schema. Filters out booleans, strings, methods, etc.
+ */
+export type NumericFieldsOf<I> = {
+    [K in keyof I]: I[K] extends number ? (K extends string ? K : never) : never;
+}[keyof I];
+/**
+ * Internal: input configuration captured by `Room.defineInput()`. The schema
+ * constructor is stored here so the runtime doesn't need to know it through
+ * the public `room.input` (which is now a callable accessor).
+ *
+ * @internal
+ */
+export interface InputOptions {
+    /**
+     * Schema constructor used to allocate per-client input instances on join.
+     * Captured by `defineInput()` from its `type` argument.
+     *
+     * Typed loosely (`new () => any`) to sidestep type-identity issues across
+     * duplicate `@colyseus/schema` installs; the runtime calls
+     * `instance.clone()` and friends, which match by shape.
+     */
+    ctor: new () => any;
+    /**
+     * Name of a monotonically-increasing numeric field on the input schema used
+     * to order and dedupe incoming frames. When set, the framework:
+     * - Drops redundant frames (`input[seqField]` ≤ the last-seen value are
+     *   discarded before they enter the buffer). Matches the unreliable-mode
+     *   ring-redundancy pattern out of the box.
+     * - Powers `room.input(sessionId).at(value)` lookups.
+     *
+     * Despite the name, "seq" here is broader than an integer counter — any
+     * monotonic numeric field works:
+     * - **Sequence counter** (`"seq"`, `"tick"`, `"frame"`) — typical for
+     *   lockstep / rollback netcode (Photon Quantum, GGPO).
+     * - **Timestamp** (`"timestamp"`, milliseconds or seconds) — useful for
+     *   variable-rate clients, lag compensation, hit registration (Unreal CMC
+     *   uses float-seconds timestamps via `FSavedMove_Character.TimeStamp`).
+     *
+     * Whichever you use, the field must increase monotonically across frames
+     * for dedupe to work.
+     */
+    seqField?: string;
+    /**
+     * > 0 enables per-client buffering of cloned snapshots — required for
+     * `room.input(sessionId).drain() / .peek() / .at()` to return populated
+     * data. Oldest drops on overflow. Set to `0` to disable (`.latest` still
+     * works).
+     */
+    bufferMaxSize: number;
+}
+/**
+ * Per-client input accessor returned by `room.input(sessionId)`. Combines the
+ * latest decoded instance with the (optional) snapshot ring buffer.
+ *
+ * - {@link latest} — the bound Schema instance, mutated in place by the
+ *   decoder. Cheapest read; use when only the most recent state matters.
+ * - {@link drain} / {@link peek} / {@link at} — populated when
+ *   `defineInput()` was called with `bufferMaxSize > 0` (default 32).
+ *   Use for rollback netcode / lockstep where every frame matters.
+ *
+ * Returned for unknown sessionIds and rooms without `defineInput()` is a
+ * frozen no-op accessor (latest=undefined, drain/peek=[], at=undefined,
+ * size=0, clear=no-op).
+ */
+export interface InputAccessor<I = any> {
+    /** Latest decoded input. `undefined` when unknown sessionId or no input declared. */
+    readonly latest: I | undefined;
+    /**
+     * Find the buffered snapshot whose `[seqField]` equals `value`. The field
+     * name is the Room's `defineInput()` `seqField`. Linear scan — cheap for
+     * typical buffer sizes; not intended for very large rings. Returns
+     * `undefined` when no match is buffered (or `seqField` isn't configured).
+     *
+     * Useful for tick-aligned retrieval (lockstep, rollback).
+     */
+    at(value: number): I | undefined;
+    /** Take everything buffered (oldest → newest) and clear. Snapshots are safe to retain. */
+    drain(): I[];
+    /** Read everything buffered without consuming. */
+    peek(): I[];
+    /** Number of snapshots currently buffered. */
+    readonly size: number;
+    /** Drop all buffered snapshots (also resets the dedupe tracker). */
+    clear(): void;
+}
+/**
+ * Callable returned by `Room.defineInput()`. Assign it to `this.input` and
+ * call `room.input(sessionId)` per tick to read each client's latest input
+ * and/or buffered snapshots.
+ */
+export type InputAPI<I = any> = (sessionId: string) => InputAccessor<I>;
+/** @internal */
+export declare class InputBufferImpl<I = any> {
+    private _items;
+    private _lastSeq;
+    private readonly _maxSize;
+    private readonly _seqField;
+    constructor(maxSize: number, seqField: string | undefined);
+    push(snapshot: I): void;
+    /** Returns true if `value` hasn't been seen, and updates the last-seen marker. */
+    accept(value: number): boolean;
+    drain(): I[];
+    peek(): I[];
+    at(value: number): I | undefined;
+    get size(): number;
+    clear(): void;
+}
+/**
+ * Default per-client accessor. Reads `_input` and `_inputBuffer` off the
+ * client at access time — both are nullable until the room declares input
+ * via `defineInput()`. Cached as `client._inputAccessor` at join, so
+ * `room.input(sessionId)` is a Map lookup + property read.
+ *
+ * @internal
+ */
+export declare class InputAccessorImpl<I = any> implements InputAccessor<I> {
+    private _client;
+    constructor(client: ClientPrivate);
+    get latest(): I | undefined;
+    at(value: number): I | undefined;
+    drain(): I[];
+    peek(): I[];
+    get size(): number;
+    clear(): void;
+}
+/**
+ * Returned by `room.input(sessionId)` for unknown sessions and for rooms
+ * that didn't call `defineInput()`.
+ *
+ * @internal
+ */
+export declare const NO_OP_INPUT_ACCESSOR: InputAccessor<any>;

package/build/input/InputBuffer.mjs

@@ -0,0 +1,86 @@
+// packages/core/src/input/InputBuffer.ts
+var InputBufferImpl = class {
+  constructor(maxSize, seqField) {
+    this._items = [];
+    this._lastSeq = -Infinity;
+    this._maxSize = maxSize;
+    this._seqField = seqField;
+  }
+  push(snapshot) {
+    this._items.push(snapshot);
+    if (this._items.length > this._maxSize) {
+      this._items.shift();
+    }
+  }
+  /** Returns true if `value` hasn't been seen, and updates the last-seen marker. */
+  accept(value) {
+    if (value <= this._lastSeq) {
+      return false;
+    }
+    this._lastSeq = value;
+    return true;
+  }
+  drain() {
+    const out = this._items;
+    this._items = [];
+    return out;
+  }
+  peek() {
+    return this._items.slice();
+  }
+  at(value) {
+    if (this._seqField === void 0) {
+      return void 0;
+    }
+    for (let i = 0; i < this._items.length; i++) {
+      if (this._items[i][this._seqField] === value) {
+        return this._items[i];
+      }
+    }
+    return void 0;
+  }
+  get size() {
+    return this._items.length;
+  }
+  clear() {
+    this._items.length = 0;
+    this._lastSeq = -Infinity;
+  }
+};
+var InputAccessorImpl = class {
+  constructor(client) {
+    this._client = client;
+  }
+  get latest() {
+    return this._client._input;
+  }
+  at(value) {
+    return this._client._inputBuffer?.at(value);
+  }
+  drain() {
+    return this._client._inputBuffer?.drain() ?? [];
+  }
+  peek() {
+    return this._client._inputBuffer?.peek() ?? [];
+  }
+  get size() {
+    return this._client._inputBuffer?.size ?? 0;
+  }
+  clear() {
+    this._client._inputBuffer?.clear();
+  }
+};
+var NO_OP_INPUT_ACCESSOR = Object.freeze({
+  latest: void 0,
+  at: () => void 0,
+  drain: () => [],
+  peek: () => [],
+  size: 0,
+  clear: () => {
+  }
+});
+export {
+  InputAccessorImpl,
+  InputBufferImpl,
+  NO_OP_INPUT_ACCESSOR
+};

package/build/input/InputBuffer.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../../src/input/InputBuffer.ts"],
+  "sourcesContent": ["import type { ClientPrivate } from '../Transport.ts';\n\n/**\n * Names of fields on `I` whose values are `number` \u2014 used by\n * `Room.defineInput()` to constrain `seqField` to actually-numeric fields\n * on the input schema. Filters out booleans, strings, methods, etc.\n */\nexport type NumericFieldsOf<I> = {\n  [K in keyof I]: I[K] extends number ? (K extends string ? K : never) : never;\n}[keyof I];\n\n/**\n * Internal: input configuration captured by `Room.defineInput()`. The schema\n * constructor is stored here so the runtime doesn't need to know it through\n * the public `room.input` (which is now a callable accessor).\n *\n * @internal\n */\nexport interface InputOptions {\n  /**\n   * Schema constructor used to allocate per-client input instances on join.\n   * Captured by `defineInput()` from its `type` argument.\n   *\n   * Typed loosely (`new () => any`) to sidestep type-identity issues across\n   * duplicate `@colyseus/schema` installs; the runtime calls\n   * `instance.clone()` and friends, which match by shape.\n   */\n  ctor: new () => any;\n\n  /**\n   * Name of a monotonically-increasing numeric field on the input schema used\n   * to order and dedupe incoming frames. When set, the framework:\n   * - Drops redundant frames (`input[seqField]` \u2264 the last-seen value are\n   *   discarded before they enter the buffer). Matches the unreliable-mode\n   *   ring-redundancy pattern out of the box.\n   * - Powers `room.input(sessionId).at(value)` lookups.\n   *\n   * Despite the name, \"seq\" here is broader than an integer counter \u2014 any\n   * monotonic numeric field works:\n   * - **Sequence counter** (`\"seq\"`, `\"tick\"`, `\"frame\"`) \u2014 typical for\n   *   lockstep / rollback netcode (Photon Quantum, GGPO).\n   * - **Timestamp** (`\"timestamp\"`, milliseconds or seconds) \u2014 useful for\n   *   variable-rate clients, lag compensation, hit registration (Unreal CMC\n   *   uses float-seconds timestamps via `FSavedMove_Character.TimeStamp`).\n   *\n   * Whichever you use, the field must increase monotonically across frames\n   * for dedupe to work.\n   */\n  seqField?: string;\n\n  /**\n   * > 0 enables per-client buffering of cloned snapshots \u2014 required for\n   * `room.input(sessionId).drain() / .peek() / .at()` to return populated\n   * data. Oldest drops on overflow. Set to `0` to disable (`.latest` still\n   * works).\n   */\n  bufferMaxSize: number;\n}\n\n/**\n * Per-client input accessor returned by `room.input(sessionId)`. Combines the\n * latest decoded instance with the (optional) snapshot ring buffer.\n *\n * - {@link latest} \u2014 the bound Schema instance, mutated in place by the\n *   decoder. Cheapest read; use when only the most recent state matters.\n * - {@link drain} / {@link peek} / {@link at} \u2014 populated when\n *   `defineInput()` was called with `bufferMaxSize > 0` (default 32).\n *   Use for rollback netcode / lockstep where every frame matters.\n *\n * Returned for unknown sessionIds and rooms without `defineInput()` is a\n * frozen no-op accessor (latest=undefined, drain/peek=[], at=undefined,\n * size=0, clear=no-op).\n */\nexport interface InputAccessor<I = any> {\n  /** Latest decoded input. `undefined` when unknown sessionId or no input declared. */\n  readonly latest: I | undefined;\n\n  /**\n   * Find the buffered snapshot whose `[seqField]` equals `value`. The field\n   * name is the Room's `defineInput()` `seqField`. Linear scan \u2014 cheap for\n   * typical buffer sizes; not intended for very large rings. Returns\n   * `undefined` when no match is buffered (or `seqField` isn't configured).\n   *\n   * Useful for tick-aligned retrieval (lockstep, rollback).\n   */\n  at(value: number): I | undefined;\n\n  /** Take everything buffered (oldest \u2192 newest) and clear. Snapshots are safe to retain. */\n  drain(): I[];\n\n  /** Read everything buffered without consuming. */\n  peek(): I[];\n\n  /** Number of snapshots currently buffered. */\n  readonly size: number;\n\n  /** Drop all buffered snapshots (also resets the dedupe tracker). */\n  clear(): void;\n}\n\n/**\n * Callable returned by `Room.defineInput()`. Assign it to `this.input` and\n * call `room.input(sessionId)` per tick to read each client's latest input\n * and/or buffered snapshots.\n */\nexport type InputAPI<I = any> = (sessionId: string) => InputAccessor<I>;\n\n/** @internal */\nexport class InputBufferImpl<I = any> {\n  private _items: I[] = [];\n  private _lastSeq: number = -Infinity;\n  private readonly _maxSize: number;\n  private readonly _seqField: string | undefined;\n\n  constructor(maxSize: number, seqField: string | undefined) {\n    this._maxSize = maxSize;\n    this._seqField = seqField;\n  }\n\n  push(snapshot: I): void {\n    this._items.push(snapshot);\n    if (this._items.length > this._maxSize) { this._items.shift(); }\n  }\n\n  /** Returns true if `value` hasn't been seen, and updates the last-seen marker. */\n  accept(value: number): boolean {\n    if (value <= this._lastSeq) { return false; }\n    this._lastSeq = value;\n    return true;\n  }\n\n  drain(): I[] {\n    const out = this._items;\n    this._items = [];\n    return out;\n  }\n\n  peek(): I[] {\n    return this._items.slice();\n  }\n\n  at(value: number): I | undefined {\n    if (this._seqField === undefined) { return undefined; }\n    for (let i = 0; i < this._items.length; i++) {\n      if ((this._items[i] as any)[this._seqField] === value) { return this._items[i]; }\n    }\n    return undefined;\n  }\n\n  get size(): number {\n    return this._items.length;\n  }\n\n  clear(): void {\n    this._items.length = 0;\n    this._lastSeq = -Infinity;\n  }\n}\n\n/**\n * Default per-client accessor. Reads `_input` and `_inputBuffer` off the\n * client at access time \u2014 both are nullable until the room declares input\n * via `defineInput()`. Cached as `client._inputAccessor` at join, so\n * `room.input(sessionId)` is a Map lookup + property read.\n *\n * @internal\n */\nexport class InputAccessorImpl<I = any> implements InputAccessor<I> {\n  private _client: ClientPrivate;\n  constructor(client: ClientPrivate) { this._client = client; }\n  get latest(): I | undefined { return this._client._input as I | undefined; }\n  at(value: number): I | undefined { return this._client._inputBuffer?.at(value) as I | undefined; }\n  drain(): I[] { return (this._client._inputBuffer?.drain() ?? []) as I[]; }\n  peek(): I[] { return (this._client._inputBuffer?.peek() ?? []) as I[]; }\n  get size(): number { return this._client._inputBuffer?.size ?? 0; }\n  clear(): void { this._client._inputBuffer?.clear(); }\n}\n\n/**\n * Returned by `room.input(sessionId)` for unknown sessions and for rooms\n * that didn't call `defineInput()`.\n *\n * @internal\n */\nexport const NO_OP_INPUT_ACCESSOR: InputAccessor<any> = Object.freeze({\n  latest: undefined,\n  at: () => undefined,\n  drain: () => [],\n  peek: () => [],\n  size: 0,\n  clear: () => {},\n});\n"],
+  "mappings": ";AA4GO,IAAM,kBAAN,MAA+B;AAAA,EAMpC,YAAY,SAAiB,UAA8B;AAL3D,SAAQ,SAAc,CAAC;AACvB,SAAQ,WAAmB;AAKzB,SAAK,WAAW;AAChB,SAAK,YAAY;AAAA,EACnB;AAAA,EAEA,KAAK,UAAmB;AACtB,SAAK,OAAO,KAAK,QAAQ;AACzB,QAAI,KAAK,OAAO,SAAS,KAAK,UAAU;AAAE,WAAK,OAAO,MAAM;AAAA,IAAG;AAAA,EACjE;AAAA;AAAA,EAGA,OAAO,OAAwB;AAC7B,QAAI,SAAS,KAAK,UAAU;AAAE,aAAO;AAAA,IAAO;AAC5C,SAAK,WAAW;AAChB,WAAO;AAAA,EACT;AAAA,EAEA,QAAa;AACX,UAAM,MAAM,KAAK;AACjB,SAAK,SAAS,CAAC;AACf,WAAO;AAAA,EACT;AAAA,EAEA,OAAY;AACV,WAAO,KAAK,OAAO,MAAM;AAAA,EAC3B;AAAA,EAEA,GAAG,OAA8B;AAC/B,QAAI,KAAK,cAAc,QAAW;AAAE,aAAO;AAAA,IAAW;AACtD,aAAS,IAAI,GAAG,IAAI,KAAK,OAAO,QAAQ,KAAK;AAC3C,UAAK,KAAK,OAAO,CAAC,EAAU,KAAK,SAAS,MAAM,OAAO;AAAE,eAAO,KAAK,OAAO,CAAC;AAAA,MAAG;AAAA,IAClF;AACA,WAAO;AAAA,EACT;AAAA,EAEA,IAAI,OAAe;AACjB,WAAO,KAAK,OAAO;AAAA,EACrB;AAAA,EAEA,QAAc;AACZ,SAAK,OAAO,SAAS;AACrB,SAAK,WAAW;AAAA,EAClB;AACF;AAUO,IAAM,oBAAN,MAA6D;AAAA,EAElE,YAAY,QAAuB;AAAE,SAAK,UAAU;AAAA,EAAQ;AAAA,EAC5D,IAAI,SAAwB;AAAE,WAAO,KAAK,QAAQ;AAAA,EAAyB;AAAA,EAC3E,GAAG,OAA8B;AAAE,WAAO,KAAK,QAAQ,cAAc,GAAG,KAAK;AAAA,EAAoB;AAAA,EACjG,QAAa;AAAE,WAAQ,KAAK,QAAQ,cAAc,MAAM,KAAK,CAAC;AAAA,EAAW;AAAA,EACzE,OAAY;AAAE,WAAQ,KAAK,QAAQ,cAAc,KAAK,KAAK,CAAC;AAAA,EAAW;AAAA,EACvE,IAAI,OAAe;AAAE,WAAO,KAAK,QAAQ,cAAc,QAAQ;AAAA,EAAG;AAAA,EAClE,QAAc;AAAE,SAAK,QAAQ,cAAc,MAAM;AAAA,EAAG;AACtD;AAQO,IAAM,uBAA2C,OAAO,OAAO;AAAA,EACpE,QAAQ;AAAA,EACR,IAAI,MAAM;AAAA,EACV,OAAO,MAAM,CAAC;AAAA,EACd,MAAM,MAAM,CAAC;AAAA,EACb,MAAM;AAAA,EACN,OAAO,MAAM;AAAA,EAAC;AAChB,CAAC;",
+  "names": []
+}

package/build/internal.cjs

@@ -0,0 +1,61 @@
+"use strict";
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(
+  // If the importer is in node compatibility mode or this is not an ESM
+  // file that has been converted to a CommonJS file using a Babel-
+  // compatible transform (i.e. "__esModule" has not been set), then set
+  // "default" to the CommonJS "module.exports" for node compatibility.
+  isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", { value: mod, enumerable: true }) : target,
+  mod
+));
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// packages/core/src/internal.ts
+var internal_exports = {};
+__export(internal_exports, {
+  USER_ROOMS_KEY_PREFIX: () => import_UserSessionIndex2.USER_ROOMS_KEY_PREFIX,
+  listUserSessions: () => import_UserSessionIndex2.listUserSessions,
+  listUserSessionsLive: () => listUserSessionsLive,
+  releaseRoomLeave: () => import_UserSessionIndex2.releaseRoomLeave,
+  releaseUserSession: () => import_UserSessionIndex2.releaseUserSession,
+  sweepRoomDispose: () => import_UserSessionIndex2.sweepRoomDispose,
+  trackRoomJoin: () => import_UserSessionIndex2.trackRoomJoin,
+  trackUserSession: () => import_UserSessionIndex2.trackUserSession,
+  userRoomsKey: () => import_UserSessionIndex2.userRoomsKey
+});
+module.exports = __toCommonJS(internal_exports);
+var matchMaker = __toESM(require("./MatchMaker.cjs"), 1);
+var import_UserSessionIndex = require("./utils/UserSessionIndex.cjs");
+var import_UserSessionIndex2 = require("./utils/UserSessionIndex.cjs");
+function listUserSessionsLive(userId, options) {
+  return (0, import_UserSessionIndex.listUserSessions)(matchMaker.presence, matchMaker.findRoomsByIds, userId, options);
+}
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  USER_ROOMS_KEY_PREFIX,
+  listUserSessions,
+  listUserSessionsLive,
+  releaseRoomLeave,
+  releaseUserSession,
+  sweepRoomDispose,
+  trackRoomJoin,
+  trackUserSession,
+  userRoomsKey
+});

package/build/internal.cjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/internal.ts"],
+  "sourcesContent": ["/**\n * Framework-internal entry \u2014 symbols used by the bundled `colyseus`\n * plugins (track-user-sessions, unique-session) and the admin\n * backend, but NOT part of `@colyseus/core`'s public surface.\n *\n * Third parties should reach for `TrackUserSessionsPlugin` and its\n * `listUserSessions` static instead \u2014 the raw helpers below are\n * implementation details and can change between minor versions.\n *\n * Resolved via the `./*` wildcard in `packages/core/package.json`.\n *\n * @internal\n */\nimport * as matchMaker from './MatchMaker.ts';\nimport {\n  listUserSessions,\n  type ListUserSessionsOptions,\n  type UserSessionInfo,\n} from './utils/UserSessionIndex.ts';\n\nexport {\n  userRoomsKey,\n  USER_ROOMS_KEY_PREFIX,\n  trackUserSession,\n  releaseUserSession,\n  trackRoomJoin,\n  releaseRoomLeave,\n  sweepRoomDispose,\n  listUserSessions,\n  type UserRoomEntry,\n  type UserSessionInfo,\n  type ListUserSessionsOptions,\n} from './utils/UserSessionIndex.ts';\n\n/**\n * `listUserSessions` wired to the live `matchMaker` \u2014 what\n * `TrackUserSessionsPlugin.listUserSessions` and the admin backend\n * actually call. The pure `listUserSessions` is kept exported above\n * so unit tests can drive it with fake presence + findRooms.\n */\nexport function listUserSessionsLive(\n  userId: string,\n  options?: ListUserSessionsOptions,\n): Promise<UserSessionInfo[]> {\n  return listUserSessions(matchMaker.presence, matchMaker.findRoomsByIds, userId, options);\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAaA,iBAA4B;AAC5B,8BAIO;AAEP,IAAAA,2BAYO;AAQA,SAAS,qBACd,QACA,SAC4B;AAC5B,aAAO,0CAA4B,qBAAqB,2BAAgB,QAAQ,OAAO;AACzF;",
+  "names": ["import_UserSessionIndex"]
+}

package/build/internal.d.ts

@@ -0,0 +1,9 @@
+import { type ListUserSessionsOptions, type UserSessionInfo } from './utils/UserSessionIndex.ts';
+export { userRoomsKey, USER_ROOMS_KEY_PREFIX, trackUserSession, releaseUserSession, trackRoomJoin, releaseRoomLeave, sweepRoomDispose, listUserSessions, type UserRoomEntry, type UserSessionInfo, type ListUserSessionsOptions, } from './utils/UserSessionIndex.ts';
+/**
+ * `listUserSessions` wired to the live `matchMaker` — what
+ * `TrackUserSessionsPlugin.listUserSessions` and the admin backend
+ * actually call. The pure `listUserSessions` is kept exported above
+ * so unit tests can drive it with fake presence + findRooms.
+ */
+export declare function listUserSessionsLive(userId: string, options?: ListUserSessionsOptions): Promise<UserSessionInfo[]>;

package/build/internal.mjs

@@ -0,0 +1,29 @@
+// packages/core/src/internal.ts
+import * as matchMaker from "./MatchMaker.mjs";
+import {
+  listUserSessions
+} from "./utils/UserSessionIndex.mjs";
+import {
+  userRoomsKey,
+  USER_ROOMS_KEY_PREFIX,
+  trackUserSession,
+  releaseUserSession,
+  trackRoomJoin,
+  releaseRoomLeave,
+  sweepRoomDispose,
+  listUserSessions as listUserSessions2
+} from "./utils/UserSessionIndex.mjs";
+function listUserSessionsLive(userId, options) {
+  return listUserSessions(matchMaker.presence, matchMaker.findRoomsByIds, userId, options);
+}
+export {
+  USER_ROOMS_KEY_PREFIX,
+  listUserSessions2 as listUserSessions,
+  listUserSessionsLive,
+  releaseRoomLeave,
+  releaseUserSession,
+  sweepRoomDispose,
+  trackRoomJoin,
+  trackUserSession,
+  userRoomsKey
+};

package/build/internal.mjs.map

@@ -0,0 +1,7 @@
+{
+  "version": 3,
+  "sources": ["../src/internal.ts"],
+  "sourcesContent": ["/**\n * Framework-internal entry \u2014 symbols used by the bundled `colyseus`\n * plugins (track-user-sessions, unique-session) and the admin\n * backend, but NOT part of `@colyseus/core`'s public surface.\n *\n * Third parties should reach for `TrackUserSessionsPlugin` and its\n * `listUserSessions` static instead \u2014 the raw helpers below are\n * implementation details and can change between minor versions.\n *\n * Resolved via the `./*` wildcard in `packages/core/package.json`.\n *\n * @internal\n */\nimport * as matchMaker from './MatchMaker.ts';\nimport {\n  listUserSessions,\n  type ListUserSessionsOptions,\n  type UserSessionInfo,\n} from './utils/UserSessionIndex.ts';\n\nexport {\n  userRoomsKey,\n  USER_ROOMS_KEY_PREFIX,\n  trackUserSession,\n  releaseUserSession,\n  trackRoomJoin,\n  releaseRoomLeave,\n  sweepRoomDispose,\n  listUserSessions,\n  type UserRoomEntry,\n  type UserSessionInfo,\n  type ListUserSessionsOptions,\n} from './utils/UserSessionIndex.ts';\n\n/**\n * `listUserSessions` wired to the live `matchMaker` \u2014 what\n * `TrackUserSessionsPlugin.listUserSessions` and the admin backend\n * actually call. The pure `listUserSessions` is kept exported above\n * so unit tests can drive it with fake presence + findRooms.\n */\nexport function listUserSessionsLive(\n  userId: string,\n  options?: ListUserSessionsOptions,\n): Promise<UserSessionInfo[]> {\n  return listUserSessions(matchMaker.presence, matchMaker.findRoomsByIds, userId, options);\n}\n"],
+  "mappings": ";AAaA,YAAY,gBAAgB;AAC5B;AAAA,EACE;AAAA,OAGK;AAEP;AAAA,EACE;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA;AAAA,EACA,oBAAAA;AAAA,OAIK;AAQA,SAAS,qBACd,QACA,SAC4B;AAC5B,SAAO,iBAA4B,qBAAqB,2BAAgB,QAAQ,OAAO;AACzF;",
+  "names": ["listUserSessions"]
+}

package/build/matchmaker/LocalDriver/LocalDriver.cjs

@@ -52,6 +52,19 @@ var LocalDriver = class {
     }
     return query;
   }
+  async findByIds(roomIds) {
+    const result = /* @__PURE__ */ new Map();
+    if (roomIds.length === 0) {
+      return result;
+    }
+    const wanted = new Set(roomIds);
+    for (const room of this.rooms) {
+      if (wanted.has(room.roomId)) {
+        result.set(room.roomId, room);
+      }
+    }
+    return result;
+  }
   update(room, operations) {
     if (operations.$set) {
       for (const field in operations.$set) {

package/build/matchmaker/LocalDriver/LocalDriver.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../src/matchmaker/LocalDriver/LocalDriver.ts"],
-  "sourcesContent": ["import { debugMatchMaking } from '../../Debug.ts';\nimport type { IRoomCache, SortOptions, MatchMakerDriver } from '../driver.ts';\nimport { Query } from './Query.ts';\n\n// re-export\nexport type { IRoomCache, SortOptions, MatchMakerDriver };\n\nexport class LocalDriver implements MatchMakerDriver {\n  public rooms: IRoomCache[] = [];\n\n  public has(roomId: string) {\n    return this.rooms.some((room) => room.roomId === roomId);\n  }\n\n  public query(conditions: Partial<IRoomCache>, sortOptions?: SortOptions) {\n    const query = new Query<IRoomCache>(this.rooms, conditions);\n\n    if (sortOptions) {\n      query.sort(sortOptions);\n    }\n\n    return query.filter(conditions);\n  }\n\n  public cleanup(processId: string) {\n    const cachedRooms = this.query({ processId });\n    debugMatchMaking(\"removing stale rooms by processId %s (%s rooms found)\", processId, cachedRooms.length);\n\n    cachedRooms.forEach((room) => this.remove(room.roomId));\n    return Promise.resolve();\n  }\n\n  public findOne(conditions: Partial<IRoomCache>, sortOptions?: SortOptions) {\n    const query = new Query<IRoomCache>(this.rooms, conditions);\n\n    if (sortOptions) {\n      query.sort(sortOptions);\n    }\n\n    return query as unknown as Promise<IRoomCache>;\n  }\n\n  public update(room: IRoomCache, operations: Partial<{ $set: Partial<IRoomCache>, $inc: Partial<IRoomCache> }>) {\n    if (operations.$set) {\n      for (const field in operations.$set) {\n        if (operations.$set.hasOwnProperty(field)) {\n          room[field] = operations.$set[field];\n        }\n      }\n    }\n\n    if (operations.$inc) {\n      for (const field in operations.$inc) {\n        if (operations.$inc.hasOwnProperty(field)) {\n          room[field] += operations.$inc[field];\n        }\n      }\n    }\n\n    return true;\n  }\n\n  public persist(room: IRoomCache, create: boolean = false) {\n    // if (this.rooms.indexOf(room) !== -1) {\n    //   // already in the list\n    //   return true;\n    // }\n\n    if (!create) { return false; }\n\n    // add to the list\n    this.rooms.push(room);\n\n    return true;\n  }\n\n  public remove(roomId: string) {\n    const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);\n    if (roomIndex !== -1) {\n      this.rooms.splice(roomIndex, 1);\n      return true;\n    }\n    return false;\n  }\n\n  public clear() {\n    this.rooms = [];\n  }\n\n  public shutdown() {\n  }\n}\n"],
-  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAiC;AAEjC,mBAAsB;AAKf,IAAM,cAAN,MAA8C;AAAA,EAA9C;AACL,SAAO,QAAsB,CAAC;AAAA;AAAA,EAEvB,IAAI,QAAgB;AACzB,WAAO,KAAK,MAAM,KAAK,CAAC,SAAS,KAAK,WAAW,MAAM;AAAA,EACzD;AAAA,EAEO,MAAM,YAAiC,aAA2B;AACvE,UAAM,QAAQ,IAAI,mBAAkB,KAAK,OAAO,UAAU;AAE1D,QAAI,aAAa;AACf,YAAM,KAAK,WAAW;AAAA,IACxB;AAEA,WAAO,MAAM,OAAO,UAAU;AAAA,EAChC;AAAA,EAEO,QAAQ,WAAmB;AAChC,UAAM,cAAc,KAAK,MAAM,EAAE,UAAU,CAAC;AAC5C,uCAAiB,yDAAyD,WAAW,YAAY,MAAM;AAEvG,gBAAY,QAAQ,CAAC,SAAS,KAAK,OAAO,KAAK,MAAM,CAAC;AACtD,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEO,QAAQ,YAAiC,aAA2B;AACzE,UAAM,QAAQ,IAAI,mBAAkB,KAAK,OAAO,UAAU;AAE1D,QAAI,aAAa;AACf,YAAM,KAAK,WAAW;AAAA,IACxB;AAEA,WAAO;AAAA,EACT;AAAA,EAEO,OAAO,MAAkB,YAA+E;AAC7G,QAAI,WAAW,MAAM;AACnB,iBAAW,SAAS,WAAW,MAAM;AACnC,YAAI,WAAW,KAAK,eAAe,KAAK,GAAG;AACzC,eAAK,KAAK,IAAI,WAAW,KAAK,KAAK;AAAA,QACrC;AAAA,MACF;AAAA,IACF;AAEA,QAAI,WAAW,MAAM;AACnB,iBAAW,SAAS,WAAW,MAAM;AACnC,YAAI,WAAW,KAAK,eAAe,KAAK,GAAG;AACzC,eAAK,KAAK,KAAK,WAAW,KAAK,KAAK;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEO,QAAQ,MAAkB,SAAkB,OAAO;AAMxD,QAAI,CAAC,QAAQ;AAAE,aAAO;AAAA,IAAO;AAG7B,SAAK,MAAM,KAAK,IAAI;AAEpB,WAAO;AAAA,EACT;AAAA,EAEO,OAAO,QAAgB;AAC5B,UAAM,YAAY,KAAK,MAAM,UAAU,CAAC,SAAS,KAAK,WAAW,MAAM;AACvE,QAAI,cAAc,IAAI;AACpB,WAAK,MAAM,OAAO,WAAW,CAAC;AAC9B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA,EAEO,QAAQ;AACb,SAAK,QAAQ,CAAC;AAAA,EAChB;AAAA,EAEO,WAAW;AAAA,EAClB;AACF;",
+  "sourcesContent": ["import { debugMatchMaking } from '../../Debug.ts';\nimport type { IRoomCache, SortOptions, MatchMakerDriver } from '../driver.ts';\nimport { Query } from './Query.ts';\n\n// re-export\nexport type { IRoomCache, SortOptions, MatchMakerDriver };\n\nexport class LocalDriver implements MatchMakerDriver {\n  public rooms: IRoomCache[] = [];\n\n  public has(roomId: string) {\n    return this.rooms.some((room) => room.roomId === roomId);\n  }\n\n  public query(conditions: Partial<IRoomCache>, sortOptions?: SortOptions) {\n    const query = new Query<IRoomCache>(this.rooms, conditions);\n\n    if (sortOptions) {\n      query.sort(sortOptions);\n    }\n\n    return query.filter(conditions);\n  }\n\n  public cleanup(processId: string) {\n    const cachedRooms = this.query({ processId });\n    debugMatchMaking(\"removing stale rooms by processId %s (%s rooms found)\", processId, cachedRooms.length);\n\n    cachedRooms.forEach((room) => this.remove(room.roomId));\n    return Promise.resolve();\n  }\n\n  public findOne(conditions: Partial<IRoomCache>, sortOptions?: SortOptions) {\n    const query = new Query<IRoomCache>(this.rooms, conditions);\n\n    if (sortOptions) {\n      query.sort(sortOptions);\n    }\n\n    return query as unknown as Promise<IRoomCache>;\n  }\n\n  public async findByIds(roomIds: string[]): Promise<Map<string, IRoomCache>> {\n    const result = new Map<string, IRoomCache>();\n    if (roomIds.length === 0) { return result; }\n    const wanted = new Set(roomIds);\n    for (const room of this.rooms) {\n      if (wanted.has(room.roomId)) { result.set(room.roomId, room); }\n    }\n    return result;\n  }\n\n  public update(room: IRoomCache, operations: Partial<{ $set: Partial<IRoomCache>, $inc: Partial<IRoomCache> }>) {\n    if (operations.$set) {\n      for (const field in operations.$set) {\n        if (operations.$set.hasOwnProperty(field)) {\n          room[field] = operations.$set[field];\n        }\n      }\n    }\n\n    if (operations.$inc) {\n      for (const field in operations.$inc) {\n        if (operations.$inc.hasOwnProperty(field)) {\n          room[field] += operations.$inc[field];\n        }\n      }\n    }\n\n    return true;\n  }\n\n  public persist(room: IRoomCache, create: boolean = false) {\n    // if (this.rooms.indexOf(room) !== -1) {\n    //   // already in the list\n    //   return true;\n    // }\n\n    if (!create) { return false; }\n\n    // add to the list\n    this.rooms.push(room);\n\n    return true;\n  }\n\n  public remove(roomId: string) {\n    const roomIndex = this.rooms.findIndex((room) => room.roomId === roomId);\n    if (roomIndex !== -1) {\n      this.rooms.splice(roomIndex, 1);\n      return true;\n    }\n    return false;\n  }\n\n  public clear() {\n    this.rooms = [];\n  }\n\n  public shutdown() {\n  }\n}\n"],
+  "mappings": ";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAAiC;AAEjC,mBAAsB;AAKf,IAAM,cAAN,MAA8C;AAAA,EAA9C;AACL,SAAO,QAAsB,CAAC;AAAA;AAAA,EAEvB,IAAI,QAAgB;AACzB,WAAO,KAAK,MAAM,KAAK,CAAC,SAAS,KAAK,WAAW,MAAM;AAAA,EACzD;AAAA,EAEO,MAAM,YAAiC,aAA2B;AACvE,UAAM,QAAQ,IAAI,mBAAkB,KAAK,OAAO,UAAU;AAE1D,QAAI,aAAa;AACf,YAAM,KAAK,WAAW;AAAA,IACxB;AAEA,WAAO,MAAM,OAAO,UAAU;AAAA,EAChC;AAAA,EAEO,QAAQ,WAAmB;AAChC,UAAM,cAAc,KAAK,MAAM,EAAE,UAAU,CAAC;AAC5C,uCAAiB,yDAAyD,WAAW,YAAY,MAAM;AAEvG,gBAAY,QAAQ,CAAC,SAAS,KAAK,OAAO,KAAK,MAAM,CAAC;AACtD,WAAO,QAAQ,QAAQ;AAAA,EACzB;AAAA,EAEO,QAAQ,YAAiC,aAA2B;AACzE,UAAM,QAAQ,IAAI,mBAAkB,KAAK,OAAO,UAAU;AAE1D,QAAI,aAAa;AACf,YAAM,KAAK,WAAW;AAAA,IACxB;AAEA,WAAO;AAAA,EACT;AAAA,EAEA,MAAa,UAAU,SAAqD;AAC1E,UAAM,SAAS,oBAAI,IAAwB;AAC3C,QAAI,QAAQ,WAAW,GAAG;AAAE,aAAO;AAAA,IAAQ;AAC3C,UAAM,SAAS,IAAI,IAAI,OAAO;AAC9B,eAAW,QAAQ,KAAK,OAAO;AAC7B,UAAI,OAAO,IAAI,KAAK,MAAM,GAAG;AAAE,eAAO,IAAI,KAAK,QAAQ,IAAI;AAAA,MAAG;AAAA,IAChE;AACA,WAAO;AAAA,EACT;AAAA,EAEO,OAAO,MAAkB,YAA+E;AAC7G,QAAI,WAAW,MAAM;AACnB,iBAAW,SAAS,WAAW,MAAM;AACnC,YAAI,WAAW,KAAK,eAAe,KAAK,GAAG;AACzC,eAAK,KAAK,IAAI,WAAW,KAAK,KAAK;AAAA,QACrC;AAAA,MACF;AAAA,IACF;AAEA,QAAI,WAAW,MAAM;AACnB,iBAAW,SAAS,WAAW,MAAM;AACnC,YAAI,WAAW,KAAK,eAAe,KAAK,GAAG;AACzC,eAAK,KAAK,KAAK,WAAW,KAAK,KAAK;AAAA,QACtC;AAAA,MACF;AAAA,IACF;AAEA,WAAO;AAAA,EACT;AAAA,EAEO,QAAQ,MAAkB,SAAkB,OAAO;AAMxD,QAAI,CAAC,QAAQ;AAAE,aAAO;AAAA,IAAO;AAG7B,SAAK,MAAM,KAAK,IAAI;AAEpB,WAAO;AAAA,EACT;AAAA,EAEO,OAAO,QAAgB;AAC5B,UAAM,YAAY,KAAK,MAAM,UAAU,CAAC,SAAS,KAAK,WAAW,MAAM;AACvE,QAAI,cAAc,IAAI;AACpB,WAAK,MAAM,OAAO,WAAW,CAAC;AAC9B,aAAO;AAAA,IACT;AACA,WAAO;AAAA,EACT;AAAA,EAEO,QAAQ;AACb,SAAK,QAAQ,CAAC;AAAA,EAChB;AAAA,EAEO,WAAW;AAAA,EAClB;AACF;",
   "names": []
 }

package/build/matchmaker/LocalDriver/LocalDriver.d.ts

@@ -6,6 +6,7 @@ export declare class LocalDriver implements MatchMakerDriver {
     query(conditions: Partial<IRoomCache>, sortOptions?: SortOptions): IRoomCache<any>[];
     cleanup(processId: string): Promise<void>;
     findOne(conditions: Partial<IRoomCache>, sortOptions?: SortOptions): Promise<IRoomCache>;
+    findByIds(roomIds: string[]): Promise<Map<string, IRoomCache>>;
     update(room: IRoomCache, operations: Partial<{
         $set: Partial<IRoomCache>;
         $inc: Partial<IRoomCache>;