@colyseus/core 0.18.24 → 0.18.26

package/build/RoomMessages.cjs

@@ -32,7 +32,9 @@ var import_nanoevents = require("./utils/nanoevents.cjs");
 var import_StandardSchema = require("./utils/StandardSchema.cjs");
 var import_DevMode = require("./utils/DevMode.cjs");
 var import_Debug = require("./Debug.cjs");
+var import_Logger = require("./Logger.cjs");
 var import_RoomExceptions = require("./errors/RoomExceptions.cjs");
+var import_Transport = require("./Transport.cjs");
 function toResponseError(e) {
   if (e instanceof Error) {
     const code = e.code;
@@ -203,6 +205,9 @@ var RoomMessages = class {
     }
     const handler = this.events.events[messageType]?.[0];
     if (handler === void 0) {
+      if (this.room.onUnhandledMessage !== void 0) {
+        this.#reportUnhandled(client, messageType, message);
+      }
       this.#replyToRequest(client, requestId, import_shared_types.ResponseStatus.ERROR, {
         name: "no_handler",
         message: `room "${this.room.roomName}" has no onMessage("${messageType}") handler to answer this request.`
@@ -270,15 +275,39 @@ var RoomMessages = class {
     client.enqueueRaw(import_Protocol.getMessageBytes[import_shared_types.Protocol.ROOM_RESPONSE](requestId, status, payload));
   }
   /** No handler for the type: error the client in dev, drop it in production. */
-  #noHandler(client, messageType, _message) {
+  #noHandler(client, messageType, message) {
     const errorMessage = `room onMessage for "${messageType}" not registered.`;
-    (0, import_Debug.debugMessage)(`${errorMessage} (roomId: ${this.room.roomId})`);
+    if (this.room.onUnhandledMessage !== void 0) {
+      this.#reportUnhandled(client, messageType, message);
+    } else {
+      import_Logger.logger.warn(`room "${this.room.roomName}" (roomId: ${this.room.roomId}): client '${client.sessionId}' sent "${messageType}", which has no onMessage() handler. ${import_DevMode.isDevMode ? "Replied with an INVALID_PAYLOAD error (outside devMode, the client is disconnected)." : "Disconnecting the client."}`);
+    }
     if (import_DevMode.isDevMode) {
       client.error(import_shared_types.ErrorCode.INVALID_PAYLOAD, errorMessage);
     } else {
+      client.state = import_Transport.ClientState.LEAVING;
       client.leave(import_shared_types.CloseCode.WITH_ERROR, errorMessage);
     }
   }
+  /** Call `room.onUnhandledMessage`. A throw or rejection goes to
+   *  `onUncaughtException` when set, or is logged; it never stops the default. */
+  #reportUnhandled(client, messageType, message) {
+    const report = (e) => {
+      if (this.room.onUncaughtException !== void 0) {
+        this.room.onUncaughtException(new import_RoomExceptions.OnMessageException(e, e?.message, client, message, messageType), "onMessage");
+      } else {
+        (0, import_Debug.debugAndPrintError)(e);
+      }
+    };
+    try {
+      const result = this.room.onUnhandledMessage(client, messageType, message);
+      if (typeof result?.catch === "function") {
+        result.catch(report);
+      }
+    } catch (e) {
+      report(e);
+    }
+  }
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {

package/build/RoomMessages.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/RoomMessages.ts"],
-  "sourcesContent": ["import { decode, type Iterator } from '@colyseus/schema';\nimport { unpack } from 'msgpackr';\n\nimport { CloseCode, ErrorCode, Protocol, ResponseStatus, type MessageContext } from '@colyseus/shared-types';\nimport { getMessageBytes } from './Protocol.ts';\nimport { createNanoEvents } from './utils/nanoevents.ts';\nimport { standardValidate, type StandardSchemaV1 } from './utils/StandardSchema.ts';\nimport { isDevMode } from './utils/DevMode.ts';\nimport { debugMessage, debugAndPrintError } from './Debug.ts';\nimport { OnMessageException } from './errors/RoomExceptions.ts';\nimport type { Client, ClientPrivate } from './Transport.ts';\nimport type { Room } from './Room.ts';\n\n/** Normalize a thrown value into the `{ name, message, code? }` shape echoed in a\n *  ROOM_RESPONSE error reply. */\nfunction toResponseError(e: any): { name: string; message: string; code?: any } {\n  if (e instanceof Error) {\n    const code = (e as any).code;\n    return (code !== undefined)\n      ? { name: e.name, message: e.message, code }\n      : { name: e.name, message: e.message };\n  }\n  return { name: \"Error\", message: String(e) };\n}\n\n// The handler's terminal action \u2014 NOT the wire ResponseStatus: `none` and\n// `resolved` both reply OK (plain return value vs `ctx.resolve(value)`), a\n// distinction a single OK can't carry; ERROR is never a handler decision\n// (thrown/no-handler). Projected onto ResponseStatus once, in onRequest's reply.\nconst OUTCOME_NONE = 0, OUTCOME_REJECTED = 1, OUTCOME_RESOLVED = 2;\n\n/**\n * Runtime {@link MessageContext} for a {@link Protocol.ROOM_REQUEST} dispatch.\n * `reject`/`resolve` record the decision on the ctx; `onRequest` reads it after the\n * handler returns, so a bare side-effecting call works as well as `return\n * ctx.reject(r)` (the branded return is compile-time only \u2014 the runtime return is\n * unused).\n */\nclass DispatchContext implements MessageContext {\n  readonly id: number | undefined;\n  _outcome = OUTCOME_NONE;\n  _reason: any = undefined;\n  _value: any = undefined;\n\n  constructor(id: number | undefined) {\n    this.id = id;\n  }\n\n  reject(reason?: any): any {\n    this._outcome = OUTCOME_REJECTED;\n    this._reason = reason;\n    return undefined;\n  }\n\n  resolve(value?: any): any {\n    this._outcome = OUTCOME_RESOLVED;\n    this._value = value;\n    return undefined;\n  }\n}\n\n/** Shared no-op context for fire-and-forget `ROOM_DATA` (no reply channel, so\n *  `reject`/`resolve` go nowhere). `id` is `undefined`; zero per-message allocation. */\nconst SEND_CONTEXT: MessageContext = Object.freeze({\n  id: undefined,\n  reject: () => undefined as any,\n  resolve: () => undefined as any,\n});\n\n/**\n * Per-room message-routing layer, owned by {@link Room}. Owns the user-message\n * handler registry (`onMessage`/`onMessageBytes` + per-type validators) and\n * decodes/dispatches the user-message wire frames (ROOM_DATA / ROOM_REQUEST /\n * ROOM_DATA_BYTES). Room's `_onMessage` keeps the protocol/lifecycle frames\n * (JOIN/PING/LEAVE/input) and calls one of these per frame, preserving the\n * original dispatch order. Reads back into its Room only for `onUncaughtException`\n * (handler wrapping) and `roomId`/`roomName` (logging).\n *\n * @internal\n */\nexport class RoomMessages {\n  private room: Room<any>;\n\n  /** Handler registry (nanoevents). Public so Room can re-expose it as\n   *  `onMessageEvents` for @colyseus/playground introspection and\n   *  @colyseus/testing handler-swapping. */\n  events = createNanoEvents();\n\n  /** Per-type StandardSchema validators. Public for the same reason as\n   *  {@link events} (`onMessageValidators`). */\n  // null-prototype: keyed by client-supplied message type (colyseus/colyseus#951)\n  validators: { [type: string]: StandardSchemaV1 } = Object.create(null);\n\n  constructor(room: Room<any>) {\n    this.room = room;\n  }\n\n  /**\n   * Register a handler (body of {@link Room.onMessage}). Wraps the callback via\n   * the room's `onUncaughtException` when set, stores the validator, and returns\n   * the unbind closure.\n   */\n  on(\n    _messageType: '*' | string | number,\n    _validationSchema: StandardSchemaV1 | ((...args: any[]) => void),\n    _callback?: (...args: any[]) => void,\n  ): () => void {\n    const messageType = _messageType.toString();\n\n    const validationSchema = (typeof _callback === 'function')\n      ? _validationSchema as StandardSchemaV1\n      : undefined;\n\n    const callback = (validationSchema === undefined)\n      ? _validationSchema as (...args: any[]) => void\n      : _callback;\n\n    const removeListener = this.events.on(messageType, (this.room.onUncaughtException !== undefined)\n      ? this.#wrapMessageHandler(callback, _messageType)\n      : callback);\n\n    if (validationSchema !== undefined) {\n      this.validators[messageType] = validationSchema;\n    }\n\n    // returns a method to unbind the callback\n    return () => {\n      removeListener();\n      if (this.events.events[messageType].length === 0) {\n        delete this.validators[messageType];\n      }\n    };\n  }\n\n  /**\n   * Wrap a user message handler so a sync throw or async rejection is reported to\n   * `room.onUncaughtException` as an {@link OnMessageException} carrying the correct\n   * `client` / `payload` / `type`. The handler is invoked with a different argument\n   * shape per dispatch path, so those fields are normalized here rather than relying\n   * on positional forwarding (which silently mis-mapped `type` once a context arg was\n   * added \u2014 see ROOM_DATA/ROOM_REQUEST passing `SEND_CONTEXT`/`ctx`):\n   *\n   *   - typed handler (DATA / REQUEST / BYTES): `(client, payload, ctx?)` \u2192 `type` is\n   *     the registered `_messageType`.\n   *   - wildcard `'*'` handler:                 `(client, type, payload)` \u2192 `type` is\n   *     the received message type.\n   *\n   * The error is swallowed (never rethrown) so a faulty handler can't break dispatch;\n   * the handler's return value (or promise) is passed through for the REQUEST path.\n   */\n  #wrapMessageHandler(callback: (...args: any[]) => any, registeredType: '*' | string | number) {\n    const onError = this.room.onUncaughtException!.bind(this.room);\n    const isWildcard = (registeredType === '*');\n\n    return (...args: any[]): any => {\n      const report = (e: Error) => onError(\n        new OnMessageException(\n          e, e.message,\n          args[0],                                  // client\n          isWildcard ? args[2] : args[1],           // payload\n          isWildcard ? args[1] : registeredType,    // type\n        ),\n        'onMessage',\n      );\n\n      try {\n        const result = callback(...args);\n        return (typeof result?.catch === 'function') ? result.catch(report) : result;\n      } catch (e: any) {\n        report(e);\n      }\n    };\n  }\n\n  /** Dispatch a `ROOM_DATA` frame: decode type + msgpack payload, validate, emit. */\n  onData(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n      // custom message validation\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[messageType]) {\n      this.#dispatch(this.events.events[messageType], client, message, SEND_CONTEXT);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /**\n   * Call the handlers of a fire-and-forget frame. With no reply to carry an error\n   * and nothing above this to catch one, a throw would reach the socket's event\n   * listener and shut the process down, along with every other room in it. So\n   * errors are logged, and the remaining handlers still run. Handlers wrapped for\n   * `onUncaughtException` report their own errors and never throw here.\n   */\n  #dispatch(handlers: Array<(...args: any[]) => any>, ...args: any[]): void {\n    for (let i = 0, length = handlers.length; i < length; i++) {\n      try {\n        const result = handlers[i](...args);\n        if (typeof result?.catch === 'function') {\n          result.catch(debugAndPrintError);\n        }\n      } catch (e: any) {\n        debugAndPrintError(e);\n      }\n    }\n  }\n\n  /** Dispatch a `ROOM_REQUEST` frame: same handlers as ROOM_DATA, but the client\n   *  opted into a reply, so echo the `requestId` with the outcome. The handler's\n   *  reply is decided by what it returns / does to `ctx`: `ctx.reject(reason)` \u2192\n   *  `REJECTED(reason)`, `ctx.resolve(value)` \u2192 `OK(value)`, a thrown error or\n   *  missing handler \u2192 `ERROR`, else `OK(return)`. */\n  onRequest(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const requestId = decode.number(buffer, it);\n\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"request #%d: '%s' -> %j (roomId: %s)\", requestId, messageType, message, this.room.roomId);\n\n      // custom message validation (shared with the ROOM_DATA path)\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      // Reply with an error so the caller's pending request resolves instead of timing out.\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    // Answered by the FIRST handler registered for the type (emit would discard\n    // returns); wildcard handlers have no response contract, so they're ineligible.\n    const handler = this.events.events[messageType as string]?.[0];\n\n    if (handler === undefined) {\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, {\n        name: \"no_handler\",\n        message: `room \"${this.room.roomName}\" has no onMessage(\"${messageType}\") handler to answer this request.`,\n      });\n      return;\n    }\n\n    const ctx = new DispatchContext(requestId);\n\n    // Sync handlers reply in this tick with no promise machinery; only a thenable\n    // return defers to the microtask queue. A sync throw (unwrapped handler) and an\n    // async rejection both fall to the ERROR reply. With onUncaughtException set the\n    // handler is wrapped (swallows its own errors), so it never throws / its promise\n    // resolves undefined, and the error reports there.\n    let response: any;\n    try {\n      response = handler(client, message, ctx);\n      if (response !== null && typeof response === 'object' && typeof response.then === 'function') {\n        response.then(\n          (resolved: any) => this.#finalizeRequest(client, requestId, ctx, resolved),\n          (e: any) => {\n            debugAndPrintError(e);\n            this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n          },\n        );\n        return;\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    this.#finalizeRequest(client, requestId, ctx, response);\n  }\n\n  /** Finalize a request: project the handler's outcome onto a ROOM_RESPONSE reply \u2014\n   *  `ctx.reject` \u2192 REJECTED(reason), `ctx.resolve(value)` \u2192 OK(value), else OK(return). */\n  #finalizeRequest(client: Client, requestId: number, ctx: DispatchContext, response: any): void {\n    if (ctx._outcome === OUTCOME_REJECTED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.REJECTED, ctx._reason);\n    } else if (ctx._outcome === OUTCOME_RESOLVED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, ctx._value);\n    } else {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, response);\n    }\n  }\n\n  /** Dispatch a `ROOM_DATA_BYTES` frame: raw bytes routed to `_$b`-prefixed handlers. */\n  onDataBytes(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message: any = buffer.subarray(it.offset, buffer.byteLength);\n    debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n    const bytesMessageType = `_$b${messageType}`;\n\n    // custom message validation\n    try {\n      if (this.validators[bytesMessageType] !== undefined) {\n        message = standardValidate(this.validators[bytesMessageType], message);\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[bytesMessageType]) {\n      this.#dispatch(this.events.events[bytesMessageType], client, message);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /** Emit a ROOM_RESPONSE reply immediately. */\n  #replyToRequest(client: Client, requestId: number, status: ResponseStatus, payload?: any): void {\n    debugMessage(\"response #%d: status=%d -> %j (roomId: %s)\", requestId, status, payload, this.room.roomId);\n    client.enqueueRaw(getMessageBytes[Protocol.ROOM_RESPONSE](requestId, status, payload));\n  }\n\n  /** No handler for the type: error the client in dev, drop it in production. */\n  #noHandler(client: Client, messageType: string | number, _message: unknown): void {\n    const errorMessage = `room onMessage for \"${messageType}\" not registered.`;\n    debugMessage(`${errorMessage} (roomId: ${this.room.roomId})`);\n    if (isDevMode) {\n      client.error(ErrorCode.INVALID_PAYLOAD, errorMessage);\n    } else {\n      client.leave(CloseCode.WITH_ERROR, errorMessage);\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { decode, type Iterator } from '@colyseus/schema';\nimport { unpack } from 'msgpackr';\n\nimport { CloseCode, ErrorCode, Protocol, ResponseStatus, type MessageContext } from '@colyseus/shared-types';\nimport { getMessageBytes } from './Protocol.ts';\nimport { createNanoEvents } from './utils/nanoevents.ts';\nimport { standardValidate, type StandardSchemaV1 } from './utils/StandardSchema.ts';\nimport { isDevMode } from './utils/DevMode.ts';\nimport { debugMessage, debugAndPrintError } from './Debug.ts';\nimport { logger } from './Logger.ts';\nimport { OnMessageException } from './errors/RoomExceptions.ts';\nimport { ClientState, type Client, type ClientPrivate } from './Transport.ts';\nimport type { Room } from './Room.ts';\n\n/** Normalize a thrown value into the `{ name, message, code? }` shape echoed in a\n *  ROOM_RESPONSE error reply. */\nfunction toResponseError(e: any): { name: string; message: string; code?: any } {\n  if (e instanceof Error) {\n    const code = (e as any).code;\n    return (code !== undefined)\n      ? { name: e.name, message: e.message, code }\n      : { name: e.name, message: e.message };\n  }\n  return { name: \"Error\", message: String(e) };\n}\n\n// The handler's terminal action \u2014 NOT the wire ResponseStatus: `none` and\n// `resolved` both reply OK (plain return value vs `ctx.resolve(value)`), a\n// distinction a single OK can't carry; ERROR is never a handler decision\n// (thrown/no-handler). Projected onto ResponseStatus once, in onRequest's reply.\nconst OUTCOME_NONE = 0, OUTCOME_REJECTED = 1, OUTCOME_RESOLVED = 2;\n\n/**\n * Runtime {@link MessageContext} for a {@link Protocol.ROOM_REQUEST} dispatch.\n * `reject`/`resolve` record the decision on the ctx; `onRequest` reads it after the\n * handler returns, so a bare side-effecting call works as well as `return\n * ctx.reject(r)` (the branded return is compile-time only \u2014 the runtime return is\n * unused).\n */\nclass DispatchContext implements MessageContext {\n  readonly id: number | undefined;\n  _outcome = OUTCOME_NONE;\n  _reason: any = undefined;\n  _value: any = undefined;\n\n  constructor(id: number | undefined) {\n    this.id = id;\n  }\n\n  reject(reason?: any): any {\n    this._outcome = OUTCOME_REJECTED;\n    this._reason = reason;\n    return undefined;\n  }\n\n  resolve(value?: any): any {\n    this._outcome = OUTCOME_RESOLVED;\n    this._value = value;\n    return undefined;\n  }\n}\n\n/** Shared no-op context for fire-and-forget `ROOM_DATA` (no reply channel, so\n *  `reject`/`resolve` go nowhere). `id` is `undefined`; zero per-message allocation. */\nconst SEND_CONTEXT: MessageContext = Object.freeze({\n  id: undefined,\n  reject: () => undefined as any,\n  resolve: () => undefined as any,\n});\n\n/**\n * Per-room message-routing layer, owned by {@link Room}. Owns the user-message\n * handler registry (`onMessage`/`onMessageBytes` + per-type validators) and\n * decodes/dispatches the user-message wire frames (ROOM_DATA / ROOM_REQUEST /\n * ROOM_DATA_BYTES). Room's `_onMessage` keeps the protocol/lifecycle frames\n * (JOIN/PING/LEAVE/input) and calls one of these per frame, preserving the\n * original dispatch order. Reads back into its Room only for `onUncaughtException`\n * (handler wrapping), `onUnhandledMessage` and `roomId`/`roomName` (logging).\n *\n * @internal\n */\nexport class RoomMessages {\n  private room: Room<any>;\n\n  /** Handler registry (nanoevents). Public so Room can re-expose it as\n   *  `onMessageEvents` for @colyseus/playground introspection and\n   *  @colyseus/testing handler-swapping. */\n  events = createNanoEvents();\n\n  /** Per-type StandardSchema validators. Public for the same reason as\n   *  {@link events} (`onMessageValidators`). */\n  // null-prototype: keyed by client-supplied message type (colyseus/colyseus#951)\n  validators: { [type: string]: StandardSchemaV1 } = Object.create(null);\n\n  constructor(room: Room<any>) {\n    this.room = room;\n  }\n\n  /**\n   * Register a handler (body of {@link Room.onMessage}). Wraps the callback via\n   * the room's `onUncaughtException` when set, stores the validator, and returns\n   * the unbind closure.\n   */\n  on(\n    _messageType: '*' | string | number,\n    _validationSchema: StandardSchemaV1 | ((...args: any[]) => void),\n    _callback?: (...args: any[]) => void,\n  ): () => void {\n    const messageType = _messageType.toString();\n\n    const validationSchema = (typeof _callback === 'function')\n      ? _validationSchema as StandardSchemaV1\n      : undefined;\n\n    const callback = (validationSchema === undefined)\n      ? _validationSchema as (...args: any[]) => void\n      : _callback;\n\n    const removeListener = this.events.on(messageType, (this.room.onUncaughtException !== undefined)\n      ? this.#wrapMessageHandler(callback, _messageType)\n      : callback);\n\n    if (validationSchema !== undefined) {\n      this.validators[messageType] = validationSchema;\n    }\n\n    // returns a method to unbind the callback\n    return () => {\n      removeListener();\n      if (this.events.events[messageType].length === 0) {\n        delete this.validators[messageType];\n      }\n    };\n  }\n\n  /**\n   * Wrap a user message handler so a sync throw or async rejection is reported to\n   * `room.onUncaughtException` as an {@link OnMessageException} carrying the correct\n   * `client` / `payload` / `type`. The handler is invoked with a different argument\n   * shape per dispatch path, so those fields are normalized here rather than relying\n   * on positional forwarding (which silently mis-mapped `type` once a context arg was\n   * added \u2014 see ROOM_DATA/ROOM_REQUEST passing `SEND_CONTEXT`/`ctx`):\n   *\n   *   - typed handler (DATA / REQUEST / BYTES): `(client, payload, ctx?)` \u2192 `type` is\n   *     the registered `_messageType`.\n   *   - wildcard `'*'` handler:                 `(client, type, payload)` \u2192 `type` is\n   *     the received message type.\n   *\n   * The error is swallowed (never rethrown) so a faulty handler can't break dispatch;\n   * the handler's return value (or promise) is passed through for the REQUEST path.\n   */\n  #wrapMessageHandler(callback: (...args: any[]) => any, registeredType: '*' | string | number) {\n    const onError = this.room.onUncaughtException!.bind(this.room);\n    const isWildcard = (registeredType === '*');\n\n    return (...args: any[]): any => {\n      const report = (e: Error) => onError(\n        new OnMessageException(\n          e, e.message,\n          args[0],                                  // client\n          isWildcard ? args[2] : args[1],           // payload\n          isWildcard ? args[1] : registeredType,    // type\n        ),\n        'onMessage',\n      );\n\n      try {\n        const result = callback(...args);\n        return (typeof result?.catch === 'function') ? result.catch(report) : result;\n      } catch (e: any) {\n        report(e);\n      }\n    };\n  }\n\n  /** Dispatch a `ROOM_DATA` frame: decode type + msgpack payload, validate, emit. */\n  onData(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n      // custom message validation\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[messageType]) {\n      this.#dispatch(this.events.events[messageType], client, message, SEND_CONTEXT);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /**\n   * Call the handlers of a fire-and-forget frame. With no reply to carry an error\n   * and nothing above this to catch one, a throw would reach the socket's event\n   * listener and shut the process down, along with every other room in it. So\n   * errors are logged, and the remaining handlers still run. Handlers wrapped for\n   * `onUncaughtException` report their own errors and never throw here.\n   */\n  #dispatch(handlers: Array<(...args: any[]) => any>, ...args: any[]): void {\n    for (let i = 0, length = handlers.length; i < length; i++) {\n      try {\n        const result = handlers[i](...args);\n        if (typeof result?.catch === 'function') {\n          result.catch(debugAndPrintError);\n        }\n      } catch (e: any) {\n        debugAndPrintError(e);\n      }\n    }\n  }\n\n  /** Dispatch a `ROOM_REQUEST` frame: same handlers as ROOM_DATA, but the client\n   *  opted into a reply, so echo the `requestId` with the outcome. The handler's\n   *  reply is decided by what it returns / does to `ctx`: `ctx.reject(reason)` \u2192\n   *  `REJECTED(reason)`, `ctx.resolve(value)` \u2192 `OK(value)`, a thrown error or\n   *  missing handler \u2192 `ERROR`, else `OK(return)`. */\n  onRequest(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const requestId = decode.number(buffer, it);\n\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"request #%d: '%s' -> %j (roomId: %s)\", requestId, messageType, message, this.room.roomId);\n\n      // custom message validation (shared with the ROOM_DATA path)\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      // Reply with an error so the caller's pending request resolves instead of timing out.\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    // Answered by the FIRST handler registered for the type (emit would discard\n    // returns); wildcard handlers have no response contract, so they're ineligible.\n    const handler = this.events.events[messageType as string]?.[0];\n\n    if (handler === undefined) {\n      // no warning without the hook: the client already gets an explicit error\n      if (this.room.onUnhandledMessage !== undefined) {\n        this.#reportUnhandled(client, messageType, message);\n      }\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, {\n        name: \"no_handler\",\n        message: `room \"${this.room.roomName}\" has no onMessage(\"${messageType}\") handler to answer this request.`,\n      });\n      return;\n    }\n\n    const ctx = new DispatchContext(requestId);\n\n    // Sync handlers reply in this tick with no promise machinery; only a thenable\n    // return defers to the microtask queue. A sync throw (unwrapped handler) and an\n    // async rejection both fall to the ERROR reply. With onUncaughtException set the\n    // handler is wrapped (swallows its own errors), so it never throws / its promise\n    // resolves undefined, and the error reports there.\n    let response: any;\n    try {\n      response = handler(client, message, ctx);\n      if (response !== null && typeof response === 'object' && typeof response.then === 'function') {\n        response.then(\n          (resolved: any) => this.#finalizeRequest(client, requestId, ctx, resolved),\n          (e: any) => {\n            debugAndPrintError(e);\n            this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n          },\n        );\n        return;\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    this.#finalizeRequest(client, requestId, ctx, response);\n  }\n\n  /** Finalize a request: project the handler's outcome onto a ROOM_RESPONSE reply \u2014\n   *  `ctx.reject` \u2192 REJECTED(reason), `ctx.resolve(value)` \u2192 OK(value), else OK(return). */\n  #finalizeRequest(client: Client, requestId: number, ctx: DispatchContext, response: any): void {\n    if (ctx._outcome === OUTCOME_REJECTED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.REJECTED, ctx._reason);\n    } else if (ctx._outcome === OUTCOME_RESOLVED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, ctx._value);\n    } else {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, response);\n    }\n  }\n\n  /** Dispatch a `ROOM_DATA_BYTES` frame: raw bytes routed to `_$b`-prefixed handlers. */\n  onDataBytes(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message: any = buffer.subarray(it.offset, buffer.byteLength);\n    debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n    const bytesMessageType = `_$b${messageType}`;\n\n    // custom message validation\n    try {\n      if (this.validators[bytesMessageType] !== undefined) {\n        message = standardValidate(this.validators[bytesMessageType], message);\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[bytesMessageType]) {\n      this.#dispatch(this.events.events[bytesMessageType], client, message);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /** Emit a ROOM_RESPONSE reply immediately. */\n  #replyToRequest(client: Client, requestId: number, status: ResponseStatus, payload?: any): void {\n    debugMessage(\"response #%d: status=%d -> %j (roomId: %s)\", requestId, status, payload, this.room.roomId);\n    client.enqueueRaw(getMessageBytes[Protocol.ROOM_RESPONSE](requestId, status, payload));\n  }\n\n  /** No handler for the type: error the client in dev, drop it in production. */\n  #noHandler(client: Client, messageType: string | number, message: unknown): void {\n    const errorMessage = `room onMessage for \"${messageType}\" not registered.`;\n\n    if (this.room.onUnhandledMessage !== undefined) {\n      this.#reportUnhandled(client, messageType, message);\n\n    } else {\n      logger.warn(`room \"${this.room.roomName}\" (roomId: ${this.room.roomId}): client '${client.sessionId}' sent \"${messageType}\", which has no onMessage() handler. ${(isDevMode)\n        ? \"Replied with an INVALID_PAYLOAD error (outside devMode, the client is disconnected).\"\n        : \"Disconnecting the client.\"}`);\n    }\n\n    if (isDevMode) {\n      client.error(ErrorCode.INVALID_PAYLOAD, errorMessage);\n    } else {\n      // frames already received still arrive after leave(); Room#_onMessage skips them\n      client.state = ClientState.LEAVING;\n      client.leave(CloseCode.WITH_ERROR, errorMessage);\n    }\n  }\n\n  /** Call `room.onUnhandledMessage`. A throw or rejection goes to\n   *  `onUncaughtException` when set, or is logged; it never stops the default. */\n  #reportUnhandled(client: Client, messageType: string | number, message: unknown): void {\n    const report = (e: any) => {\n      if (this.room.onUncaughtException !== undefined) {\n        this.room.onUncaughtException(new OnMessageException<Room<any>, any>(e, e?.message, client, message, messageType), 'onMessage');\n      } else {\n        debugAndPrintError(e);\n      }\n    };\n\n    try {\n      const result = this.room.onUnhandledMessage!(client, messageType, message) as any;\n      if (typeof result?.catch === 'function') {\n        result.catch(report);\n      }\n    } catch (e: any) {\n      report(e);\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/RoomMessages.d.ts

@@ -1,6 +1,6 @@
 import { type Iterator } from '@colyseus/schema';
 import { type StandardSchemaV1 } from './utils/StandardSchema.ts';
-import type { Client, ClientPrivate } from './Transport.ts';
+import { type Client, type ClientPrivate } from './Transport.ts';
 import type { Room } from './Room.ts';
 /**
  * Per-room message-routing layer, owned by {@link Room}. Owns the user-message
@@ -9,7 +9,7 @@ import type { Room } from './Room.ts';
  * ROOM_DATA_BYTES). Room's `_onMessage` keeps the protocol/lifecycle frames
  * (JOIN/PING/LEAVE/input) and calls one of these per frame, preserving the
  * original dispatch order. Reads back into its Room only for `onUncaughtException`
- * (handler wrapping) and `roomId`/`roomName` (logging).
+ * (handler wrapping), `onUnhandledMessage` and `roomId`/`roomName` (logging).
  *
  * @internal
  */

package/build/RoomMessages.mjs

@@ -7,7 +7,9 @@ import { createNanoEvents } from "./utils/nanoevents.mjs";
 import { standardValidate } from "./utils/StandardSchema.mjs";
 import { isDevMode } from "./utils/DevMode.mjs";
 import { debugMessage, debugAndPrintError } from "./Debug.mjs";
+import { logger } from "./Logger.mjs";
 import { OnMessageException } from "./errors/RoomExceptions.mjs";
+import { ClientState } from "./Transport.mjs";
 function toResponseError(e) {
   if (e instanceof Error) {
     const code = e.code;
@@ -178,6 +180,9 @@ var RoomMessages = class {
     }
     const handler = this.events.events[messageType]?.[0];
     if (handler === void 0) {
+      if (this.room.onUnhandledMessage !== void 0) {
+        this.#reportUnhandled(client, messageType, message);
+      }
       this.#replyToRequest(client, requestId, ResponseStatus.ERROR, {
         name: "no_handler",
         message: `room "${this.room.roomName}" has no onMessage("${messageType}") handler to answer this request.`
@@ -245,15 +250,39 @@ var RoomMessages = class {
     client.enqueueRaw(getMessageBytes[Protocol.ROOM_RESPONSE](requestId, status, payload));
   }
   /** No handler for the type: error the client in dev, drop it in production. */
-  #noHandler(client, messageType, _message) {
+  #noHandler(client, messageType, message) {
     const errorMessage = `room onMessage for "${messageType}" not registered.`;
-    debugMessage(`${errorMessage} (roomId: ${this.room.roomId})`);
+    if (this.room.onUnhandledMessage !== void 0) {
+      this.#reportUnhandled(client, messageType, message);
+    } else {
+      logger.warn(`room "${this.room.roomName}" (roomId: ${this.room.roomId}): client '${client.sessionId}' sent "${messageType}", which has no onMessage() handler. ${isDevMode ? "Replied with an INVALID_PAYLOAD error (outside devMode, the client is disconnected)." : "Disconnecting the client."}`);
+    }
     if (isDevMode) {
       client.error(ErrorCode.INVALID_PAYLOAD, errorMessage);
     } else {
+      client.state = ClientState.LEAVING;
       client.leave(CloseCode.WITH_ERROR, errorMessage);
     }
   }
+  /** Call `room.onUnhandledMessage`. A throw or rejection goes to
+   *  `onUncaughtException` when set, or is logged; it never stops the default. */
+  #reportUnhandled(client, messageType, message) {
+    const report = (e) => {
+      if (this.room.onUncaughtException !== void 0) {
+        this.room.onUncaughtException(new OnMessageException(e, e?.message, client, message, messageType), "onMessage");
+      } else {
+        debugAndPrintError(e);
+      }
+    };
+    try {
+      const result = this.room.onUnhandledMessage(client, messageType, message);
+      if (typeof result?.catch === "function") {
+        result.catch(report);
+      }
+    } catch (e) {
+      report(e);
+    }
+  }
 };
 export {
   RoomMessages

package/build/RoomMessages.mjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../src/RoomMessages.ts"],
-  "sourcesContent": ["import { decode, type Iterator } from '@colyseus/schema';\nimport { unpack } from 'msgpackr';\n\nimport { CloseCode, ErrorCode, Protocol, ResponseStatus, type MessageContext } from '@colyseus/shared-types';\nimport { getMessageBytes } from './Protocol.ts';\nimport { createNanoEvents } from './utils/nanoevents.ts';\nimport { standardValidate, type StandardSchemaV1 } from './utils/StandardSchema.ts';\nimport { isDevMode } from './utils/DevMode.ts';\nimport { debugMessage, debugAndPrintError } from './Debug.ts';\nimport { OnMessageException } from './errors/RoomExceptions.ts';\nimport type { Client, ClientPrivate } from './Transport.ts';\nimport type { Room } from './Room.ts';\n\n/** Normalize a thrown value into the `{ name, message, code? }` shape echoed in a\n *  ROOM_RESPONSE error reply. */\nfunction toResponseError(e: any): { name: string; message: string; code?: any } {\n  if (e instanceof Error) {\n    const code = (e as any).code;\n    return (code !== undefined)\n      ? { name: e.name, message: e.message, code }\n      : { name: e.name, message: e.message };\n  }\n  return { name: \"Error\", message: String(e) };\n}\n\n// The handler's terminal action \u2014 NOT the wire ResponseStatus: `none` and\n// `resolved` both reply OK (plain return value vs `ctx.resolve(value)`), a\n// distinction a single OK can't carry; ERROR is never a handler decision\n// (thrown/no-handler). Projected onto ResponseStatus once, in onRequest's reply.\nconst OUTCOME_NONE = 0, OUTCOME_REJECTED = 1, OUTCOME_RESOLVED = 2;\n\n/**\n * Runtime {@link MessageContext} for a {@link Protocol.ROOM_REQUEST} dispatch.\n * `reject`/`resolve` record the decision on the ctx; `onRequest` reads it after the\n * handler returns, so a bare side-effecting call works as well as `return\n * ctx.reject(r)` (the branded return is compile-time only \u2014 the runtime return is\n * unused).\n */\nclass DispatchContext implements MessageContext {\n  readonly id: number | undefined;\n  _outcome = OUTCOME_NONE;\n  _reason: any = undefined;\n  _value: any = undefined;\n\n  constructor(id: number | undefined) {\n    this.id = id;\n  }\n\n  reject(reason?: any): any {\n    this._outcome = OUTCOME_REJECTED;\n    this._reason = reason;\n    return undefined;\n  }\n\n  resolve(value?: any): any {\n    this._outcome = OUTCOME_RESOLVED;\n    this._value = value;\n    return undefined;\n  }\n}\n\n/** Shared no-op context for fire-and-forget `ROOM_DATA` (no reply channel, so\n *  `reject`/`resolve` go nowhere). `id` is `undefined`; zero per-message allocation. */\nconst SEND_CONTEXT: MessageContext = Object.freeze({\n  id: undefined,\n  reject: () => undefined as any,\n  resolve: () => undefined as any,\n});\n\n/**\n * Per-room message-routing layer, owned by {@link Room}. Owns the user-message\n * handler registry (`onMessage`/`onMessageBytes` + per-type validators) and\n * decodes/dispatches the user-message wire frames (ROOM_DATA / ROOM_REQUEST /\n * ROOM_DATA_BYTES). Room's `_onMessage` keeps the protocol/lifecycle frames\n * (JOIN/PING/LEAVE/input) and calls one of these per frame, preserving the\n * original dispatch order. Reads back into its Room only for `onUncaughtException`\n * (handler wrapping) and `roomId`/`roomName` (logging).\n *\n * @internal\n */\nexport class RoomMessages {\n  private room: Room<any>;\n\n  /** Handler registry (nanoevents). Public so Room can re-expose it as\n   *  `onMessageEvents` for @colyseus/playground introspection and\n   *  @colyseus/testing handler-swapping. */\n  events = createNanoEvents();\n\n  /** Per-type StandardSchema validators. Public for the same reason as\n   *  {@link events} (`onMessageValidators`). */\n  // null-prototype: keyed by client-supplied message type (colyseus/colyseus#951)\n  validators: { [type: string]: StandardSchemaV1 } = Object.create(null);\n\n  constructor(room: Room<any>) {\n    this.room = room;\n  }\n\n  /**\n   * Register a handler (body of {@link Room.onMessage}). Wraps the callback via\n   * the room's `onUncaughtException` when set, stores the validator, and returns\n   * the unbind closure.\n   */\n  on(\n    _messageType: '*' | string | number,\n    _validationSchema: StandardSchemaV1 | ((...args: any[]) => void),\n    _callback?: (...args: any[]) => void,\n  ): () => void {\n    const messageType = _messageType.toString();\n\n    const validationSchema = (typeof _callback === 'function')\n      ? _validationSchema as StandardSchemaV1\n      : undefined;\n\n    const callback = (validationSchema === undefined)\n      ? _validationSchema as (...args: any[]) => void\n      : _callback;\n\n    const removeListener = this.events.on(messageType, (this.room.onUncaughtException !== undefined)\n      ? this.#wrapMessageHandler(callback, _messageType)\n      : callback);\n\n    if (validationSchema !== undefined) {\n      this.validators[messageType] = validationSchema;\n    }\n\n    // returns a method to unbind the callback\n    return () => {\n      removeListener();\n      if (this.events.events[messageType].length === 0) {\n        delete this.validators[messageType];\n      }\n    };\n  }\n\n  /**\n   * Wrap a user message handler so a sync throw or async rejection is reported to\n   * `room.onUncaughtException` as an {@link OnMessageException} carrying the correct\n   * `client` / `payload` / `type`. The handler is invoked with a different argument\n   * shape per dispatch path, so those fields are normalized here rather than relying\n   * on positional forwarding (which silently mis-mapped `type` once a context arg was\n   * added \u2014 see ROOM_DATA/ROOM_REQUEST passing `SEND_CONTEXT`/`ctx`):\n   *\n   *   - typed handler (DATA / REQUEST / BYTES): `(client, payload, ctx?)` \u2192 `type` is\n   *     the registered `_messageType`.\n   *   - wildcard `'*'` handler:                 `(client, type, payload)` \u2192 `type` is\n   *     the received message type.\n   *\n   * The error is swallowed (never rethrown) so a faulty handler can't break dispatch;\n   * the handler's return value (or promise) is passed through for the REQUEST path.\n   */\n  #wrapMessageHandler(callback: (...args: any[]) => any, registeredType: '*' | string | number) {\n    const onError = this.room.onUncaughtException!.bind(this.room);\n    const isWildcard = (registeredType === '*');\n\n    return (...args: any[]): any => {\n      const report = (e: Error) => onError(\n        new OnMessageException(\n          e, e.message,\n          args[0],                                  // client\n          isWildcard ? args[2] : args[1],           // payload\n          isWildcard ? args[1] : registeredType,    // type\n        ),\n        'onMessage',\n      );\n\n      try {\n        const result = callback(...args);\n        return (typeof result?.catch === 'function') ? result.catch(report) : result;\n      } catch (e: any) {\n        report(e);\n      }\n    };\n  }\n\n  /** Dispatch a `ROOM_DATA` frame: decode type + msgpack payload, validate, emit. */\n  onData(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n      // custom message validation\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[messageType]) {\n      this.#dispatch(this.events.events[messageType], client, message, SEND_CONTEXT);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /**\n   * Call the handlers of a fire-and-forget frame. With no reply to carry an error\n   * and nothing above this to catch one, a throw would reach the socket's event\n   * listener and shut the process down, along with every other room in it. So\n   * errors are logged, and the remaining handlers still run. Handlers wrapped for\n   * `onUncaughtException` report their own errors and never throw here.\n   */\n  #dispatch(handlers: Array<(...args: any[]) => any>, ...args: any[]): void {\n    for (let i = 0, length = handlers.length; i < length; i++) {\n      try {\n        const result = handlers[i](...args);\n        if (typeof result?.catch === 'function') {\n          result.catch(debugAndPrintError);\n        }\n      } catch (e: any) {\n        debugAndPrintError(e);\n      }\n    }\n  }\n\n  /** Dispatch a `ROOM_REQUEST` frame: same handlers as ROOM_DATA, but the client\n   *  opted into a reply, so echo the `requestId` with the outcome. The handler's\n   *  reply is decided by what it returns / does to `ctx`: `ctx.reject(reason)` \u2192\n   *  `REJECTED(reason)`, `ctx.resolve(value)` \u2192 `OK(value)`, a thrown error or\n   *  missing handler \u2192 `ERROR`, else `OK(return)`. */\n  onRequest(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const requestId = decode.number(buffer, it);\n\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"request #%d: '%s' -> %j (roomId: %s)\", requestId, messageType, message, this.room.roomId);\n\n      // custom message validation (shared with the ROOM_DATA path)\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      // Reply with an error so the caller's pending request resolves instead of timing out.\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    // Answered by the FIRST handler registered for the type (emit would discard\n    // returns); wildcard handlers have no response contract, so they're ineligible.\n    const handler = this.events.events[messageType as string]?.[0];\n\n    if (handler === undefined) {\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, {\n        name: \"no_handler\",\n        message: `room \"${this.room.roomName}\" has no onMessage(\"${messageType}\") handler to answer this request.`,\n      });\n      return;\n    }\n\n    const ctx = new DispatchContext(requestId);\n\n    // Sync handlers reply in this tick with no promise machinery; only a thenable\n    // return defers to the microtask queue. A sync throw (unwrapped handler) and an\n    // async rejection both fall to the ERROR reply. With onUncaughtException set the\n    // handler is wrapped (swallows its own errors), so it never throws / its promise\n    // resolves undefined, and the error reports there.\n    let response: any;\n    try {\n      response = handler(client, message, ctx);\n      if (response !== null && typeof response === 'object' && typeof response.then === 'function') {\n        response.then(\n          (resolved: any) => this.#finalizeRequest(client, requestId, ctx, resolved),\n          (e: any) => {\n            debugAndPrintError(e);\n            this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n          },\n        );\n        return;\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    this.#finalizeRequest(client, requestId, ctx, response);\n  }\n\n  /** Finalize a request: project the handler's outcome onto a ROOM_RESPONSE reply \u2014\n   *  `ctx.reject` \u2192 REJECTED(reason), `ctx.resolve(value)` \u2192 OK(value), else OK(return). */\n  #finalizeRequest(client: Client, requestId: number, ctx: DispatchContext, response: any): void {\n    if (ctx._outcome === OUTCOME_REJECTED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.REJECTED, ctx._reason);\n    } else if (ctx._outcome === OUTCOME_RESOLVED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, ctx._value);\n    } else {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, response);\n    }\n  }\n\n  /** Dispatch a `ROOM_DATA_BYTES` frame: raw bytes routed to `_$b`-prefixed handlers. */\n  onDataBytes(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message: any = buffer.subarray(it.offset, buffer.byteLength);\n    debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n    const bytesMessageType = `_$b${messageType}`;\n\n    // custom message validation\n    try {\n      if (this.validators[bytesMessageType] !== undefined) {\n        message = standardValidate(this.validators[bytesMessageType], message);\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[bytesMessageType]) {\n      this.#dispatch(this.events.events[bytesMessageType], client, message);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /** Emit a ROOM_RESPONSE reply immediately. */\n  #replyToRequest(client: Client, requestId: number, status: ResponseStatus, payload?: any): void {\n    debugMessage(\"response #%d: status=%d -> %j (roomId: %s)\", requestId, status, payload, this.room.roomId);\n    client.enqueueRaw(getMessageBytes[Protocol.ROOM_RESPONSE](requestId, status, payload));\n  }\n\n  /** No handler for the type: error the client in dev, drop it in production. */\n  #noHandler(client: Client, messageType: string | number, _message: unknown): void {\n    const errorMessage = `room onMessage for \"${messageType}\" not registered.`;\n    debugMessage(`${errorMessage} (roomId: ${this.room.roomId})`);\n    if (isDevMode) {\n      client.error(ErrorCode.INVALID_PAYLOAD, errorMessage);\n    } else {\n      client.leave(CloseCode.WITH_ERROR, errorMessage);\n    }\n  }\n}\n"],
-  "mappings": "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",
+  "sourcesContent": ["import { decode, type Iterator } from '@colyseus/schema';\nimport { unpack } from 'msgpackr';\n\nimport { CloseCode, ErrorCode, Protocol, ResponseStatus, type MessageContext } from '@colyseus/shared-types';\nimport { getMessageBytes } from './Protocol.ts';\nimport { createNanoEvents } from './utils/nanoevents.ts';\nimport { standardValidate, type StandardSchemaV1 } from './utils/StandardSchema.ts';\nimport { isDevMode } from './utils/DevMode.ts';\nimport { debugMessage, debugAndPrintError } from './Debug.ts';\nimport { logger } from './Logger.ts';\nimport { OnMessageException } from './errors/RoomExceptions.ts';\nimport { ClientState, type Client, type ClientPrivate } from './Transport.ts';\nimport type { Room } from './Room.ts';\n\n/** Normalize a thrown value into the `{ name, message, code? }` shape echoed in a\n *  ROOM_RESPONSE error reply. */\nfunction toResponseError(e: any): { name: string; message: string; code?: any } {\n  if (e instanceof Error) {\n    const code = (e as any).code;\n    return (code !== undefined)\n      ? { name: e.name, message: e.message, code }\n      : { name: e.name, message: e.message };\n  }\n  return { name: \"Error\", message: String(e) };\n}\n\n// The handler's terminal action \u2014 NOT the wire ResponseStatus: `none` and\n// `resolved` both reply OK (plain return value vs `ctx.resolve(value)`), a\n// distinction a single OK can't carry; ERROR is never a handler decision\n// (thrown/no-handler). Projected onto ResponseStatus once, in onRequest's reply.\nconst OUTCOME_NONE = 0, OUTCOME_REJECTED = 1, OUTCOME_RESOLVED = 2;\n\n/**\n * Runtime {@link MessageContext} for a {@link Protocol.ROOM_REQUEST} dispatch.\n * `reject`/`resolve` record the decision on the ctx; `onRequest` reads it after the\n * handler returns, so a bare side-effecting call works as well as `return\n * ctx.reject(r)` (the branded return is compile-time only \u2014 the runtime return is\n * unused).\n */\nclass DispatchContext implements MessageContext {\n  readonly id: number | undefined;\n  _outcome = OUTCOME_NONE;\n  _reason: any = undefined;\n  _value: any = undefined;\n\n  constructor(id: number | undefined) {\n    this.id = id;\n  }\n\n  reject(reason?: any): any {\n    this._outcome = OUTCOME_REJECTED;\n    this._reason = reason;\n    return undefined;\n  }\n\n  resolve(value?: any): any {\n    this._outcome = OUTCOME_RESOLVED;\n    this._value = value;\n    return undefined;\n  }\n}\n\n/** Shared no-op context for fire-and-forget `ROOM_DATA` (no reply channel, so\n *  `reject`/`resolve` go nowhere). `id` is `undefined`; zero per-message allocation. */\nconst SEND_CONTEXT: MessageContext = Object.freeze({\n  id: undefined,\n  reject: () => undefined as any,\n  resolve: () => undefined as any,\n});\n\n/**\n * Per-room message-routing layer, owned by {@link Room}. Owns the user-message\n * handler registry (`onMessage`/`onMessageBytes` + per-type validators) and\n * decodes/dispatches the user-message wire frames (ROOM_DATA / ROOM_REQUEST /\n * ROOM_DATA_BYTES). Room's `_onMessage` keeps the protocol/lifecycle frames\n * (JOIN/PING/LEAVE/input) and calls one of these per frame, preserving the\n * original dispatch order. Reads back into its Room only for `onUncaughtException`\n * (handler wrapping), `onUnhandledMessage` and `roomId`/`roomName` (logging).\n *\n * @internal\n */\nexport class RoomMessages {\n  private room: Room<any>;\n\n  /** Handler registry (nanoevents). Public so Room can re-expose it as\n   *  `onMessageEvents` for @colyseus/playground introspection and\n   *  @colyseus/testing handler-swapping. */\n  events = createNanoEvents();\n\n  /** Per-type StandardSchema validators. Public for the same reason as\n   *  {@link events} (`onMessageValidators`). */\n  // null-prototype: keyed by client-supplied message type (colyseus/colyseus#951)\n  validators: { [type: string]: StandardSchemaV1 } = Object.create(null);\n\n  constructor(room: Room<any>) {\n    this.room = room;\n  }\n\n  /**\n   * Register a handler (body of {@link Room.onMessage}). Wraps the callback via\n   * the room's `onUncaughtException` when set, stores the validator, and returns\n   * the unbind closure.\n   */\n  on(\n    _messageType: '*' | string | number,\n    _validationSchema: StandardSchemaV1 | ((...args: any[]) => void),\n    _callback?: (...args: any[]) => void,\n  ): () => void {\n    const messageType = _messageType.toString();\n\n    const validationSchema = (typeof _callback === 'function')\n      ? _validationSchema as StandardSchemaV1\n      : undefined;\n\n    const callback = (validationSchema === undefined)\n      ? _validationSchema as (...args: any[]) => void\n      : _callback;\n\n    const removeListener = this.events.on(messageType, (this.room.onUncaughtException !== undefined)\n      ? this.#wrapMessageHandler(callback, _messageType)\n      : callback);\n\n    if (validationSchema !== undefined) {\n      this.validators[messageType] = validationSchema;\n    }\n\n    // returns a method to unbind the callback\n    return () => {\n      removeListener();\n      if (this.events.events[messageType].length === 0) {\n        delete this.validators[messageType];\n      }\n    };\n  }\n\n  /**\n   * Wrap a user message handler so a sync throw or async rejection is reported to\n   * `room.onUncaughtException` as an {@link OnMessageException} carrying the correct\n   * `client` / `payload` / `type`. The handler is invoked with a different argument\n   * shape per dispatch path, so those fields are normalized here rather than relying\n   * on positional forwarding (which silently mis-mapped `type` once a context arg was\n   * added \u2014 see ROOM_DATA/ROOM_REQUEST passing `SEND_CONTEXT`/`ctx`):\n   *\n   *   - typed handler (DATA / REQUEST / BYTES): `(client, payload, ctx?)` \u2192 `type` is\n   *     the registered `_messageType`.\n   *   - wildcard `'*'` handler:                 `(client, type, payload)` \u2192 `type` is\n   *     the received message type.\n   *\n   * The error is swallowed (never rethrown) so a faulty handler can't break dispatch;\n   * the handler's return value (or promise) is passed through for the REQUEST path.\n   */\n  #wrapMessageHandler(callback: (...args: any[]) => any, registeredType: '*' | string | number) {\n    const onError = this.room.onUncaughtException!.bind(this.room);\n    const isWildcard = (registeredType === '*');\n\n    return (...args: any[]): any => {\n      const report = (e: Error) => onError(\n        new OnMessageException(\n          e, e.message,\n          args[0],                                  // client\n          isWildcard ? args[2] : args[1],           // payload\n          isWildcard ? args[1] : registeredType,    // type\n        ),\n        'onMessage',\n      );\n\n      try {\n        const result = callback(...args);\n        return (typeof result?.catch === 'function') ? result.catch(report) : result;\n      } catch (e: any) {\n        report(e);\n      }\n    };\n  }\n\n  /** Dispatch a `ROOM_DATA` frame: decode type + msgpack payload, validate, emit. */\n  onData(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n      // custom message validation\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[messageType]) {\n      this.#dispatch(this.events.events[messageType], client, message, SEND_CONTEXT);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /**\n   * Call the handlers of a fire-and-forget frame. With no reply to carry an error\n   * and nothing above this to catch one, a throw would reach the socket's event\n   * listener and shut the process down, along with every other room in it. So\n   * errors are logged, and the remaining handlers still run. Handlers wrapped for\n   * `onUncaughtException` report their own errors and never throw here.\n   */\n  #dispatch(handlers: Array<(...args: any[]) => any>, ...args: any[]): void {\n    for (let i = 0, length = handlers.length; i < length; i++) {\n      try {\n        const result = handlers[i](...args);\n        if (typeof result?.catch === 'function') {\n          result.catch(debugAndPrintError);\n        }\n      } catch (e: any) {\n        debugAndPrintError(e);\n      }\n    }\n  }\n\n  /** Dispatch a `ROOM_REQUEST` frame: same handlers as ROOM_DATA, but the client\n   *  opted into a reply, so echo the `requestId` with the outcome. The handler's\n   *  reply is decided by what it returns / does to `ctx`: `ctx.reject(reason)` \u2192\n   *  `REJECTED(reason)`, `ctx.resolve(value)` \u2192 `OK(value)`, a thrown error or\n   *  missing handler \u2192 `ERROR`, else `OK(return)`. */\n  onRequest(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const requestId = decode.number(buffer, it);\n\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message;\n    try {\n      message = (buffer.byteLength > it.offset)\n        ? unpack(buffer.subarray(it.offset, buffer.byteLength))\n        : undefined;\n      debugMessage(\"request #%d: '%s' -> %j (roomId: %s)\", requestId, messageType, message, this.room.roomId);\n\n      // custom message validation (shared with the ROOM_DATA path)\n      if (this.validators[messageType] !== undefined) {\n        message = standardValidate(this.validators[messageType], message);\n      }\n\n    } catch (e: any) {\n      // Reply with an error so the caller's pending request resolves instead of timing out.\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    // Answered by the FIRST handler registered for the type (emit would discard\n    // returns); wildcard handlers have no response contract, so they're ineligible.\n    const handler = this.events.events[messageType as string]?.[0];\n\n    if (handler === undefined) {\n      // no warning without the hook: the client already gets an explicit error\n      if (this.room.onUnhandledMessage !== undefined) {\n        this.#reportUnhandled(client, messageType, message);\n      }\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, {\n        name: \"no_handler\",\n        message: `room \"${this.room.roomName}\" has no onMessage(\"${messageType}\") handler to answer this request.`,\n      });\n      return;\n    }\n\n    const ctx = new DispatchContext(requestId);\n\n    // Sync handlers reply in this tick with no promise machinery; only a thenable\n    // return defers to the microtask queue. A sync throw (unwrapped handler) and an\n    // async rejection both fall to the ERROR reply. With onUncaughtException set the\n    // handler is wrapped (swallows its own errors), so it never throws / its promise\n    // resolves undefined, and the error reports there.\n    let response: any;\n    try {\n      response = handler(client, message, ctx);\n      if (response !== null && typeof response === 'object' && typeof response.then === 'function') {\n        response.then(\n          (resolved: any) => this.#finalizeRequest(client, requestId, ctx, resolved),\n          (e: any) => {\n            debugAndPrintError(e);\n            this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n          },\n        );\n        return;\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      this.#replyToRequest(client, requestId, ResponseStatus.ERROR, toResponseError(e));\n      return;\n    }\n\n    this.#finalizeRequest(client, requestId, ctx, response);\n  }\n\n  /** Finalize a request: project the handler's outcome onto a ROOM_RESPONSE reply \u2014\n   *  `ctx.reject` \u2192 REJECTED(reason), `ctx.resolve(value)` \u2192 OK(value), else OK(return). */\n  #finalizeRequest(client: Client, requestId: number, ctx: DispatchContext, response: any): void {\n    if (ctx._outcome === OUTCOME_REJECTED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.REJECTED, ctx._reason);\n    } else if (ctx._outcome === OUTCOME_RESOLVED) {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, ctx._value);\n    } else {\n      this.#replyToRequest(client, requestId, ResponseStatus.OK, response);\n    }\n  }\n\n  /** Dispatch a `ROOM_DATA_BYTES` frame: raw bytes routed to `_$b`-prefixed handlers. */\n  onDataBytes(client: Client & ClientPrivate, buffer: Buffer, it: Iterator): void {\n    const messageType = (decode.stringCheck(buffer, it))\n      ? decode.string(buffer, it)\n      : decode.number(buffer, it);\n\n    let message: any = buffer.subarray(it.offset, buffer.byteLength);\n    debugMessage(\"received: '%s' -> %j (roomId: %s)\", messageType, message, this.room.roomId);\n\n    const bytesMessageType = `_$b${messageType}`;\n\n    // custom message validation\n    try {\n      if (this.validators[bytesMessageType] !== undefined) {\n        message = standardValidate(this.validators[bytesMessageType], message);\n      }\n    } catch (e: any) {\n      debugAndPrintError(e);\n      client.leave(CloseCode.WITH_ERROR);\n      return;\n    }\n\n    if (this.events.events[bytesMessageType]) {\n      this.#dispatch(this.events.events[bytesMessageType], client, message);\n\n    } else if (this.events.events['*']) {\n      this.#dispatch(this.events.events['*'], client, messageType, message);\n\n    } else {\n      this.#noHandler(client, messageType, message);\n    }\n  }\n\n  /** Emit a ROOM_RESPONSE reply immediately. */\n  #replyToRequest(client: Client, requestId: number, status: ResponseStatus, payload?: any): void {\n    debugMessage(\"response #%d: status=%d -> %j (roomId: %s)\", requestId, status, payload, this.room.roomId);\n    client.enqueueRaw(getMessageBytes[Protocol.ROOM_RESPONSE](requestId, status, payload));\n  }\n\n  /** No handler for the type: error the client in dev, drop it in production. */\n  #noHandler(client: Client, messageType: string | number, message: unknown): void {\n    const errorMessage = `room onMessage for \"${messageType}\" not registered.`;\n\n    if (this.room.onUnhandledMessage !== undefined) {\n      this.#reportUnhandled(client, messageType, message);\n\n    } else {\n      logger.warn(`room \"${this.room.roomName}\" (roomId: ${this.room.roomId}): client '${client.sessionId}' sent \"${messageType}\", which has no onMessage() handler. ${(isDevMode)\n        ? \"Replied with an INVALID_PAYLOAD error (outside devMode, the client is disconnected).\"\n        : \"Disconnecting the client.\"}`);\n    }\n\n    if (isDevMode) {\n      client.error(ErrorCode.INVALID_PAYLOAD, errorMessage);\n    } else {\n      // frames already received still arrive after leave(); Room#_onMessage skips them\n      client.state = ClientState.LEAVING;\n      client.leave(CloseCode.WITH_ERROR, errorMessage);\n    }\n  }\n\n  /** Call `room.onUnhandledMessage`. A throw or rejection goes to\n   *  `onUncaughtException` when set, or is logged; it never stops the default. */\n  #reportUnhandled(client: Client, messageType: string | number, message: unknown): void {\n    const report = (e: any) => {\n      if (this.room.onUncaughtException !== undefined) {\n        this.room.onUncaughtException(new OnMessageException<Room<any>, any>(e, e?.message, client, message, messageType), 'onMessage');\n      } else {\n        debugAndPrintError(e);\n      }\n    };\n\n    try {\n      const result = this.room.onUnhandledMessage!(client, messageType, message) as any;\n      if (typeof result?.catch === 'function') {\n        result.catch(report);\n      }\n    } catch (e: any) {\n      report(e);\n    }\n  }\n}\n"],
+  "mappings": "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",
   "names": []
 }

package/build/index.cjs

@@ -70,6 +70,7 @@ __export(index_exports, {
   attachToTestRoom: () => import_RoomPlugin.attachToTestRoom,
   basicAuth: () => import_router.basicAuth,
   compileSanitizer: () => import_InputBuffer.compileSanitizer,
+  compileSnapshot: () => import_InputBuffer.compileSnapshot,
   connectClientToRoom: () => import_Transport.connectClientToRoom,
   createAuthContext: () => import_Transport.createAuthContext,
   createEndpoint: () => import_router.createEndpoint,
@@ -183,6 +184,7 @@ var import_Logger = require("./Logger.cjs");
   attachToTestRoom,
   basicAuth,
   compileSanitizer,
+  compileSnapshot,
   connectClientToRoom,
   createAuthContext,
   createEndpoint,

package/build/index.cjs.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  ProtocolModifier,\n  ErrorCode,\n  CloseCode,\n  ResponseStatus,\n  type InferState,\n  type ExtractRoomMessages,\n  type ExtractRoomClientMessages,\n  type MessageContext,\n  type Rejection,\n  type Resolution,\n  type ExtractRejectReason,\n  type ExtractResponseType,\n} from '@colyseus/shared-types';\n\n// Core classes\nexport { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, applySimulatedLatency, parseLatencyEnv, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';\nexport { Room, RoomInternalState, validate, type RoomOptions, type DefineInputOptions, type SimulationCallback, type FixedTimestepCallback, type StepContext, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';\nexport { InputBufferImpl, compileSanitizer } from './input/InputBuffer.ts';\nexport { type InputAccessor, type InputAPI, type NormalizedInputOptions, type ConsumeOptions, type IdleInput, type IdleContext, type SanitizeInput, type NumericFieldsOf } from './input/types.ts';\nexport { Rewind, RewindView, type RewindOptions, type RewindMode } from './Rewind.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  TimestepException,\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, type BeforeUpgradeHandler, runBeforeUpgrade, createAuthContext, connectClientToRoom, enqueueClientRaw } 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;AAAA;AAAA;AAAA;AAAA,4BAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA6C;AAG7C,0BAcO;AAGP,oBAAsM;AACtM,kBAA2R;AAC3R,yBAAkD;AAClD,mBAAgL;AAChL,oBAAwE;AACxE,wBAGO;AACP,sBAAgC;AAChC,+BAAkC;AAClC,yBAA4B;AAE5B,4BAYO;AAGP,iBAA4B;AAE5B,mBAA4C;AAC5C,kBAAgD;AAGhD,0BAAc,qDAtDd;AAuDA,oBAAoC;AAGpC,uBAAiO;AAGjO,sBAA8B;AAC9B,2BAA8B;AAG9B,wBAAgC;AAChC,8BAAiC;AAIjC,mBAA+E;AAC/E,qBAAsC;AAGtC,iBAA6C;AAG7C,mBASO;AAGP,uBAA0B;AAC1B,uBAA0B;AAC1B,uBAA8G;AAG9G,oBAmBO;AAGP,oBAAuB;",
+  "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  ProtocolModifier,\n  ErrorCode,\n  CloseCode,\n  ResponseStatus,\n  type InferState,\n  type ExtractRoomMessages,\n  type ExtractRoomClientMessages,\n  type MessageContext,\n  type Rejection,\n  type Resolution,\n  type ExtractRejectReason,\n  type ExtractResponseType,\n} from '@colyseus/shared-types';\n\n// Core classes\nexport { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, applySimulatedLatency, parseLatencyEnv, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';\nexport { Room, RoomInternalState, validate, type RoomOptions, type DefineInputOptions, type SimulationCallback, type FixedTimestepCallback, type StepContext, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';\nexport { InputBufferImpl, compileSanitizer, compileSnapshot } from './input/InputBuffer.ts';\nexport { type InputAccessor, type InputAPI, type NormalizedInputOptions, type ConsumeOptions, type IdleInput, type IdleContext, type SanitizeInput, type NumericFieldsOf } from './input/types.ts';\nexport { Rewind, RewindView, type RewindOptions, type RewindMode } from './Rewind.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  TimestepException,\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, type BeforeUpgradeHandler, runBeforeUpgrade, createAuthContext, connectClientToRoom, enqueueClientRaw } 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;AAAA;AAAA;AAAA;AAAA,4BAAAA;AAAA,EAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,mBAA6C;AAG7C,0BAcO;AAGP,oBAAsM;AACtM,kBAA2R;AAC3R,yBAAmE;AACnE,mBAAgL;AAChL,oBAAwE;AACxE,wBAGO;AACP,sBAAgC;AAChC,+BAAkC;AAClC,yBAA4B;AAE5B,4BAYO;AAGP,iBAA4B;AAE5B,mBAA4C;AAC5C,kBAAgD;AAGhD,0BAAc,qDAtDd;AAuDA,oBAAoC;AAGpC,uBAAiO;AAGjO,sBAA8B;AAC9B,2BAA8B;AAG9B,wBAAgC;AAChC,8BAAiC;AAIjC,mBAA+E;AAC/E,qBAAsC;AAGtC,iBAA6C;AAG7C,mBASO;AAGP,uBAA0B;AAC1B,uBAA0B;AAC1B,uBAA8G;AAG9G,oBAmBO;AAGP,oBAAuB;",
   "names": ["Clock"]
 }

package/build/index.d.ts

@@ -2,7 +2,7 @@ import { ClockTimer as Clock, Delayed } from '@colyseus/timer';
 export { Protocol, ProtocolModifier, ErrorCode, CloseCode, ResponseStatus, type InferState, type ExtractRoomMessages, type ExtractRoomClientMessages, type MessageContext, type Rejection, type Resolution, type ExtractRejectReason, type ExtractResponseType, } from '@colyseus/shared-types';
 export { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, applySimulatedLatency, parseLatencyEnv, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';
 export { Room, RoomInternalState, validate, type RoomOptions, type DefineInputOptions, type SimulationCallback, type FixedTimestepCallback, type StepContext, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';
-export { InputBufferImpl, compileSanitizer } from './input/InputBuffer.ts';
+export { InputBufferImpl, compileSanitizer, compileSnapshot } from './input/InputBuffer.ts';
 export { type InputAccessor, type InputAPI, type NormalizedInputOptions, type ConsumeOptions, type IdleInput, type IdleContext, type SanitizeInput, type NumericFieldsOf } from './input/types.ts';
 export { Rewind, RewindView, type RewindOptions, type RewindMode } from './Rewind.ts';
 export { RoomPlugin, definePlugins, attachToTestRoom, type RoomPluginOrder, type PluginDependencies, type RoomPluginClass, } from './RoomPlugin.ts';

package/build/index.mjs

@@ -9,7 +9,7 @@ import {
 } from "@colyseus/shared-types";
 import { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, applySimulatedLatency, parseLatencyEnv } from "./Server.mjs";
 import { Room, RoomInternalState, validate } from "./Room.mjs";
-import { InputBufferImpl, compileSanitizer } from "./input/InputBuffer.mjs";
+import { InputBufferImpl, compileSanitizer, compileSnapshot } from "./input/InputBuffer.mjs";
 import {} from "./input/types.mjs";
 import { Rewind, RewindView } from "./Rewind.mjs";
 import {
@@ -106,6 +106,7 @@ export {
   attachToTestRoom,
   basicAuth,
   compileSanitizer,
+  compileSnapshot,
   connectClientToRoom,
   createAuthContext,
   createEndpoint,

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  ProtocolModifier,\n  ErrorCode,\n  CloseCode,\n  ResponseStatus,\n  type InferState,\n  type ExtractRoomMessages,\n  type ExtractRoomClientMessages,\n  type MessageContext,\n  type Rejection,\n  type Resolution,\n  type ExtractRejectReason,\n  type ExtractResponseType,\n} from '@colyseus/shared-types';\n\n// Core classes\nexport { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, applySimulatedLatency, parseLatencyEnv, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';\nexport { Room, RoomInternalState, validate, type RoomOptions, type DefineInputOptions, type SimulationCallback, type FixedTimestepCallback, type StepContext, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';\nexport { InputBufferImpl, compileSanitizer } from './input/InputBuffer.ts';\nexport { type InputAccessor, type InputAPI, type NormalizedInputOptions, type ConsumeOptions, type IdleInput, type IdleContext, type SanitizeInput, type NumericFieldsOf } from './input/types.ts';\nexport { Rewind, RewindView, type RewindOptions, type RewindMode } from './Rewind.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  TimestepException,\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, type BeforeUpgradeHandler, runBeforeUpgrade, createAuthContext, connectClientToRoom, enqueueClientRaw } 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,EACA;AAAA,EACA;AAAA,OASK;AAGP,SAAS,QAAQ,YAAY,cAAc,yBAAyB,2BAA2B,uBAAuB,uBAAgF;AACtM,SAAS,MAAM,mBAAmB,gBAAyP;AAC3R,SAAS,iBAAiB,wBAAwB;AAClD,eAAgL;AAChL,SAAS,QAAQ,kBAAuD;AACxE;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,EACA;AAAA,OACK;AAGP,YAAY,gBAAgB;AAE5B,SAAS,aAAa,sBAAsB;AAC5C,SAAS,uCAAuC;AAGhD,cAAc;AACd,SAAS,2BAA2B;AAGpC,SAA4D,aAAa,aAAa,WAAyD,kBAAkB,mBAAmB,qBAAqB,wBAAwB;AAGjO,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;",
+  "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  ProtocolModifier,\n  ErrorCode,\n  CloseCode,\n  ResponseStatus,\n  type InferState,\n  type ExtractRoomMessages,\n  type ExtractRoomClientMessages,\n  type MessageContext,\n  type Rejection,\n  type Resolution,\n  type ExtractRejectReason,\n  type ExtractResponseType,\n} from '@colyseus/shared-types';\n\n// Core classes\nexport { Server, defineRoom, defineServer, registerRoomDefinitions, unregisterRoomDefinitions, applySimulatedLatency, parseLatencyEnv, type RoomDefinitions, type ServerOptions, type SDKTypes } from './Server.ts';\nexport { Room, RoomInternalState, validate, type RoomOptions, type DefineInputOptions, type SimulationCallback, type FixedTimestepCallback, type StepContext, type MessageHandlerWithFormat, type Messages, type ExtractRoomState, type ExtractRoomMetadata, type ExtractRoomClient } from './Room.ts';\nexport { InputBufferImpl, compileSanitizer, compileSnapshot } from './input/InputBuffer.ts';\nexport { type InputAccessor, type InputAPI, type NormalizedInputOptions, type ConsumeOptions, type IdleInput, type IdleContext, type SanitizeInput, type NumericFieldsOf } from './input/types.ts';\nexport { Rewind, RewindView, type RewindOptions, type RewindMode } from './Rewind.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  TimestepException,\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, type BeforeUpgradeHandler, runBeforeUpgrade, createAuthContext, connectClientToRoom, enqueueClientRaw } 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,EACA;AAAA,EACA;AAAA,OASK;AAGP,SAAS,QAAQ,YAAY,cAAc,yBAAyB,2BAA2B,uBAAuB,uBAAgF;AACtM,SAAS,MAAM,mBAAmB,gBAAyP;AAC3R,SAAS,iBAAiB,kBAAkB,uBAAuB;AACnE,eAAgL;AAChL,SAAS,QAAQ,kBAAuD;AACxE;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,EACA;AAAA,OACK;AAGP,YAAY,gBAAgB;AAE5B,SAAS,aAAa,sBAAsB;AAC5C,SAAS,uCAAuC;AAGhD,cAAc;AACd,SAAS,2BAA2B;AAGpC,SAA4D,aAAa,aAAa,WAAyD,kBAAkB,mBAAmB,qBAAqB,wBAAwB;AAGjO,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

@@ -25,10 +25,12 @@ __export(InputBuffer_exports, {
   InputBufferImpl: () => InputBufferImpl,
   NO_OP_INPUT_ACCESSOR: () => NO_OP_INPUT_ACCESSOR,
   compileSanitizer: () => compileSanitizer,
+  compileSnapshot: () => compileSnapshot,
   seedInputZeroValues: () => seedInputZeroValues,
   validateSubSteps: () => validateSubSteps
 });
 module.exports = __toCommonJS(InputBuffer_exports);
+var import_schema = require("@colyseus/schema");
 var import_Utils = require("../utils/Utils.cjs");
 function validateSubSteps(subSteps, source) {
   if (subSteps === void 0) {
@@ -58,7 +60,10 @@ function compileSanitizer(spec) {
       if (v === void 0) {
         continue;
       }
-      inst[names[i]] = v >= mins[i] ? v <= maxs[i] ? v : maxs[i] : mins[i];
+      const clamped = v >= mins[i] ? v <= maxs[i] ? v : maxs[i] : mins[i];
+      if (clamped !== v) {
+        inst[names[i]] = clamped;
+      }
     }
   };
 }
@@ -74,6 +79,51 @@ function fieldNamesOf(ctor) {
   }
   return names;
 }
+var _snapshots = /* @__PURE__ */ new WeakMap();
+function compileSnapshot(ctor) {
+  let snapshot = _snapshots.get(ctor);
+  if (snapshot !== void 0) {
+    return snapshot;
+  }
+  const md = ctor[import_Utils.$METADATA];
+  const names = fieldNamesOf(ctor);
+  const plain = md !== void 0 && names.every((_, i) => {
+    const type = md[i].type;
+    return typeof type === "string" || type !== null && typeof type === "object" && "quantized" in type;
+  });
+  if (plain) {
+    let Frame2 = function(values) {
+      this[import_schema.$values] = values;
+    };
+    var Frame = Frame2;
+    const fields = {};
+    names.forEach((name, i) => {
+      fields[name] = {
+        get() {
+          return this[import_schema.$values][i];
+        },
+        set(value) {
+          this[import_schema.$values][i] = value;
+        },
+        enumerable: true,
+        configurable: true
+      };
+    });
+    Frame2.prototype = Object.create(ctor.prototype, fields);
+    const count = names.length;
+    snapshot = (input) => {
+      const values = new Array(count);
+      for (let i = 0; i < count; i++) {
+        values[i] = input[names[i]];
+      }
+      return new Frame2(values);
+    };
+  } else {
+    snapshot = (input) => input.clone();
+  }
+  _snapshots.set(ctor, snapshot);
+  return snapshot;
+}
 function seedInputZeroValues(instance, ctor) {
   const md = ctor[import_Utils.$METADATA];
   if (!md) {
@@ -558,6 +608,7 @@ var NO_OP_INPUT_ACCESSOR = Object.freeze({
   InputBufferImpl,
   NO_OP_INPUT_ACCESSOR,
   compileSanitizer,
+  compileSnapshot,
   seedInputZeroValues,
   validateSubSteps
 });