@colyseus/core 0.18.24 → 0.18.25

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
 });

package/build/input/InputBuffer.cjs.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../src/input/InputBuffer.ts"],
-  "sourcesContent": ["import type { ClientPrivate } from '../Transport.ts';\nimport { $METADATA } from '../utils/Utils.ts';\n\nimport type {\n  ConsumeOptions, IdleContext, IdleInput, InputAccessor, SanitizeInput,\n} from './types.ts';\n\n/**\n * @internal Validate a `subSteps` count. Throws on a fractional/non-positive\n * value: both sides loop `subSteps` times at `dt/subSteps`, so anything but a\n * whole number is a determinism bug, not a tunable. Shared by `defineInput`\n * and `setFixedTimestep`.\n */\nexport function validateSubSteps(subSteps: number | undefined, source: string): number | undefined {\n  if (subSteps === undefined) { return undefined; }\n  if (!Number.isInteger(subSteps) || subSteps < 1) {\n    throw new Error(`[${source}] subSteps must be an integer >= 1 (got ${subSteps}).`);\n  }\n  return subSteps;\n}\n\n/**\n * @internal Compile a {@link SanitizeInput} spec into the per-frame function the\n * decode path applies. The map form precompiles to dense min/max arrays walked\n * with the NaN-safe branch clamp; the callback form passes through.\n */\nexport function compileSanitizer<I>(spec: SanitizeInput<I>): (input: I) => void {\n  if (typeof spec === 'function') { return spec; }\n  const names = Object.keys(spec);\n  const mins = new Float64Array(names.length);\n  const maxs = new Float64Array(names.length);\n  for (let i = 0; i < names.length; i++) {\n    const range = (spec as Record<string, readonly [number, number]>)[names[i]]!;\n    mins[i] = range[0];\n    maxs[i] = range[1];\n  }\n  return (input: I) => {\n    const inst = input as Record<string, number>;\n    for (let i = 0; i < names.length; i++) {\n      const v = inst[names[i]];\n      // Never-received field: no input to sanitize \u2014 clamping would INVENT\n      // one (delta-encoding clients legitimately never transmit fields they\n      // never assigned; the range floor turned \"no input\" into \"held stick\").\n      if (v === undefined) { continue; }\n      // NaN-safe: NaN fails both comparisons \u2192 clamp floor.\n      inst[names[i]] = v >= mins[i] ? (v <= maxs[i] ? v : maxs[i]) : mins[i];\n    }\n  };\n}\n\n/** Field names of an input schema ctor, in declaration order (indices are dense\n *  from 0 in the metadata). Resolved ONCE per buffer (cold path). */\nfunction fieldNamesOf(ctor: new () => any): string[] {\n  const md = (ctor as any)[$METADATA] as Record<number, { name?: string }> | undefined;\n  const names: string[] = [];\n  if (md) {\n    for (let i = 0; ; i++) {\n      const f = md[i];\n      if (!f || typeof f.name !== \"string\") break;\n      names.push(f.name);\n    }\n  }\n  return names;\n}\n\n/**\n * @internal Seed every declared field that has no construction default with\n * its wire-neutral zero value (0 / false / \"\"; quantized: 0 clamped into the\n * descriptor's range). The input contract is \"the server holds the last\n * received value\" \u2014 before anything is received, that value is the ZERO of\n * the field's type, never `undefined`: a sim would NaN-propagate it and a\n * range sanitizer would clamp it into a phantom input. Clients only transmit\n * fields they assign, so an untouched field stays absent on the wire forever.\n */\nexport function seedInputZeroValues(instance: any, ctor: new () => any): void {\n  const md = (ctor as any)[$METADATA] as\n    Record<number, { name?: string, type?: unknown }> | undefined;\n  if (!md) { return; }\n  for (let i = 0; ; i++) {\n    const f = md[i];\n    if (!f || typeof f.name !== \"string\") break;\n    if (instance[f.name] !== undefined) { continue; }   // .default() wins\n    const type = f.type;\n    if (typeof type === \"string\") {\n      instance[f.name] = type === \"string\" ? \"\" : type === \"boolean\" ? false : 0;\n    } else if (type !== null && typeof type === \"object\" && \"quantized\" in (type as object)) {\n      const q = (type as { quantized: { min: number, max: number } }).quantized;\n      instance[f.name] = q.min > 0 ? q.min : q.max < 0 ? q.max : 0;\n    }\n  }\n}\n\n/** Reclaim the consumed prefix once the read cursor passes this many items \u2014\n *  bounds the parallel arrays' slack to O(THRESHOLD) between compactions while\n *  keeping per-consume work O(1) (no `shift()` re-index on every input). */\nconst COMPACT_THRESHOLD = 32;\n\n/** Shared zero-state \"already done\" iterator \u2014 returned by `consume()` on an\n *  empty buffer with no idle policy, and by the no-op accessor. Frozen + a frozen\n *  result, so it's allocation-free and safe to share across all callers. */\nconst DONE_RESULT: IteratorResult<any> = Object.freeze({ value: undefined, done: true });\nconst DONE_ITERATOR: IterableIterator<any> = Object.freeze({\n  [Symbol.iterator]() { return this; },\n  next() { return DONE_RESULT; },\n});\n\n/** @internal */\nexport class InputBufferImpl<I = any> {\n  /** Pending snapshots, indexed `[_head, _items.length)`. Consumed inputs are\n   *  NOT spliced off per-read \u2014 `_head` advances and the prefix is reclaimed in\n   *  bulk by {@link compact} (a `shift()` per read is O(n), so a burst would be\n   *  O(n\u00B2)). `_renderTimes`/`_reckonTimes` stay parallel to `_items`. */\n  private _items: I[] = [];\n  /** Read cursor: index of the oldest UNCONSUMED input (== `_items.length` when empty). */\n  private _head = 0;\n  private _lastSeq: number = -Infinity;\n  private readonly _maxSize: number;\n  private readonly _seqField: string | undefined;\n\n  /**\n   * Cumulative count of inputs CONSUMED from this buffer (via any consume\n   * primitive \u2014 {@link next}/{@link take}/{@link drain}/{@link consume} \u2014 plus\n   * {@link clear} and overflow). Consumed = \"removed from the pending set\",\n   * whether applied to state or discarded. The server echoes this in the TIMED\n   * prefix as the reconciliation ack: how many of the client's inputs are\n   * reflected in (or finished influencing) the authoritative state, which lags\n   * the receive counter by inputs still buffered. Distinct from\n   * `_receivedInputCount` (receive-time, for RTT), which leads the state.\n   */\n  consumedCount = 0;\n\n  /** Render times parallel to `_items` (server-clock ms; `0` when unset). */\n  private _renderTimes: number[] = [];\n  /** Render time of the most recently drained input (see {@link renderTime}). */\n  private _lastRenderTime = 0;\n  /** Reckon-display stamps parallel to `_items` \u2014 the client's serverNow\n   *  estimate at input-sample time, i.e. the instant its forward-reckoned\n   *  entities were displayed at (server-clock ms; `0` when unset). */\n  private _reckonTimes: number[] = [];\n  /** Reckon stamp of the most recently consumed input (see {@link reckonTime}). */\n  private _lastReckonTime = 0;\n  /** Framework wire seq per buffered input (parallel to `_items`) \u2014 UNRELIABLE\n   *  ONLY, lazily created on the first seq-carrying push. Reliable inputs are\n   *  contiguous, so their consumed-seq-value is always exactly {@link consumedCount}\n   *  and needs no parallel array; `undefined` here marks that (the common, default\n   *  path pays nothing). A buffer is single-mode, so this is either never created\n   *  (reliable) or created once and kept parallel (unreliable). */\n  private _seqs?: number[];\n  /** Seq VALUE of the last consumed input \u2014 the reconciliation ack echoed to the\n   *  client (see {@link ackSeq}). Only meaningful when {@link _seqs} is tracked\n   *  (unreliable); reliable's ack falls back to {@link consumedCount}. */\n  private _lastConsumedSeq = 0;\n  /** Whether the most recently produced frame was a synthesized idle (see {@link wasIdle}). */\n  private _lastWasIdle = false;\n\n  /** Reused {@link consume} iterator (lazily minted) + its per-call state, so a\n   *  per-tick loop allocates no generator frame. `_iterRemaining` snapshots the\n   *  COUNT to walk \u2014 a count, not an index: mid-pass mutations (`next()`/`take()`/\n   *  `clear()`/compaction) shift indices but can only shorten a count-based pass,\n   *  never point it past the tail. `_iterIdle` is an optional trailing synthesized\n   *  frame; `_iterActive` guards against a nested consume() clobbering the shared\n   *  `_iterRes`. */\n  private _iter?: IterableIterator<I>;\n  private _iterRemaining = 0;\n  private _iterActive = false;\n  private _iterIdle?: I;\n  private readonly _iterRes: { value: I | undefined; done: boolean } = { value: undefined, done: false };\n\n  /** Input schema ctor \u2014 mints the reused idle frame; idle is off without it. */\n  private readonly _ctor?: new () => I;\n  /** Client slice this buffer belongs to (the live object is `Client & ClientPrivate`)\n   *  \u2014 feeds the idle callback's ctx (latest + sessionId). */\n  private readonly _client?: Pick<ClientPrivate, '_input'> & { sessionId: string };\n  /** Room-level idle policy (`defineInput({ idle })`) \u2014 the bare-call default. */\n  private readonly _roomIdle?: IdleInput<I>;\n  /** Reused synthesized idle frame + the schema's field names/defaults (lazy). */\n  private _idle?: I;\n  private _fieldNames?: string[];\n  private _defaults?: unknown[];\n  /** Reused ctx for the idle callback form (see {@link IdleContext}). */\n  private readonly _idleCtx: IdleContext<I> = { latest: undefined, sessionId: \"\" };\n\n  constructor(maxSize: number, seqField: string | undefined, ctor?: new () => I, client?: Pick<ClientPrivate, '_input'> & { sessionId: string }, idle?: IdleInput<I>) {\n    this._maxSize = maxSize;\n    this._seqField = seqField;\n    this._ctor = ctor;\n    this._client = client;\n    this._roomIdle = idle;\n  }\n\n  /** The effective idle policy for one consume call: per-call `false` suppresses,\n   *  per-call value overrides, else the room-level default (or none). */\n  private effectiveIdle(opts?: ConsumeOptions<I>): IdleInput<I> | undefined {\n    return opts?.idle === false ? undefined : (opts?.idle ?? this._roomIdle);\n  }\n\n  /** Resolve an {@link IdleInput} to overrides \u2014 invokes the callback form\n   *  LAZILY, here at synthesis time (the buffer is known to be empty). */\n  private resolveIdle(idle: IdleInput<I>): true | Partial<I> {\n    if (typeof idle !== \"function\") return idle;\n    this._idleCtx.latest = this._client?._input as I | undefined;\n    this._idleCtx.sessionId = this._client?.sessionId ?? \"\";\n    return idle(this._idleCtx) ?? true;\n  }\n\n  /**\n   * The synthesized \"no input this tick\" frame: schema defaults overlaid with\n   * `overrides` (`true` = none). Copies BY FIELD NAME from the schema metadata \u2014\n   * schema fields are prototype accessors (no own props), so `Object.assign`\n   * can't source from a schema instance; the name walk reads getters, letting\n   * `overrides` be a plain partial OR a schema instance (e.g. `latest`).\n   * ONE reused instance \u2014 refilled per call, never advances the ack.\n   */\n  private idleFrame(overrides: true | Partial<I>): I {\n    if (this._idle === undefined) {\n      // Lazy mint (cold): the fresh instance doubles as the defaults source.\n      this._idle = new this._ctor!();\n      seedInputZeroValues(this._idle, this._ctor!);\n      this._fieldNames = fieldNamesOf(this._ctor!);\n      const fresh = this._idle as Record<string, unknown>;\n      this._defaults = this._fieldNames.map((n) => fresh[n]);\n    }\n    const idle = this._idle as Record<string, unknown>;\n    const names = this._fieldNames!;\n    const defaults = this._defaults!;\n    const ov = overrides === true ? undefined : (overrides as Record<string, unknown>);\n    for (let i = 0; i < names.length; i++) {\n      const v = ov?.[names[i]];\n      idle[names[i]] = v !== undefined ? v : defaults[i];\n    }\n    return this._idle;\n  }\n\n  /** The idle frame to synthesize on an empty tick (room policy or per-call\n   *  `opts.idle`), or `undefined` when no policy is in effect. Reuses the single\n   *  idle instance; never advances the ack. Callers set {@link wasIdle}. */\n  private idleFrameOnEmpty(opts?: ConsumeOptions<I>): I | undefined {\n    const idle = this._ctor !== undefined ? this.effectiveIdle(opts) : undefined;\n    return idle === undefined ? undefined : this.idleFrame(this.resolveIdle(idle));\n  }\n\n  /** Consume the input at the cursor: advance cursor + ack, stamp THIS input's\n   *  render/reckon times, clear {@link wasIdle}. The shared per-input step behind\n   *  {@link next}, {@link consume}'s iterator, and the re-entrant fallback. */\n  private stepHead(): I {\n    const i = this._head;\n    this._lastWasIdle = false;\n    this._lastRenderTime = this._renderTimes[i];\n    this._lastReckonTime = this._reckonTimes[i];\n    if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[i]; }\n    this._head = i + 1;\n    this.consumedCount++;\n    return this._items[i];\n  }\n\n  /** Drop ALL slots, reusing the backing arrays' capacity \u2014 the zero-GC reset for\n   *  the consume/next path ({@link compact}/{@link clear}). `drain()` deliberately\n   *  does NOT use this (it returns an array, so fresh `[]` is faster there). */\n  private truncate(): void {\n    this._items.length = 0;\n    this._renderTimes.length = 0;\n    this._reckonTimes.length = 0;\n    if (this._seqs !== undefined) { this._seqs.length = 0; }\n    this._head = 0;\n  }\n\n  /**\n   * Append a decoded input snapshot. `seq` is the framework wire seq (unreliable);\n   * omit it for reliable inputs, which get an implicit monotonic receive count so\n   * {@link ackSeq} stays well-defined in both modes.\n   */\n  push(snapshot: I, renderTime: number = 0, reckonTime: number = 0, seq?: number): void {\n    this._items.push(snapshot);\n    this._renderTimes.push(renderTime);\n    this._reckonTimes.push(reckonTime);\n    // Track the wire seq only for unreliable (seq provided); reliable derives its\n    // ack from consumedCount, so it never allocates/maintains this array.\n    if (seq !== undefined) { (this._seqs ??= []).push(seq); }\n    // Overflow drops the oldest unconsumed input; count it consumed so the ack\n    // still advances past it. Advance the cursor (don't shift) \u2014 keeps it O(1).\n    if (this.size > this._maxSize) {\n      if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[this._head]; } // dropped oldest counts as acked\n      this._head++;\n      this.consumedCount++;\n      this.compact();\n    }\n  }\n\n  /** Reclaim the consumed prefix `[0, _head)`. Free when fully drained (reuse the\n   *  arrays); otherwise splice only once the cursor passes {@link COMPACT_THRESHOLD},\n   *  so the amortized per-input cost stays O(1). */\n  private compact(): void {\n    if (this._head === 0) { return; }\n    if (this._head >= this._items.length) {\n      this.truncate();\n    } else if (this._head >= COMPACT_THRESHOLD) {\n      this._items.splice(0, this._head);\n      this._renderTimes.splice(0, this._head);\n      this._reckonTimes.splice(0, this._head);\n      if (this._seqs !== undefined) { this._seqs.splice(0, this._head); }\n      this._head = 0;\n    }\n  }\n\n  /** Returns true if `value` hasn't been seen, and updates the last-seen marker. */\n  accept(value: number): boolean {\n    if (value <= this._lastSeq) { return false; }\n    this._lastSeq = value;\n    return true;\n  }\n\n  drain(opts?: ConsumeOptions<I>): I[] {\n    // Empty: synthesize one idle frame (NOT consumed \u2014 no ack bump, stamps\n    // untouched) when a policy is in effect, else [].\n    if (this.size === 0) {\n      const idle = this.idleFrameOnEmpty(opts);\n      this._lastWasIdle = idle !== undefined;\n      return idle !== undefined ? [idle] : [];\n    }\n    this._lastWasIdle = false;\n    const last = this._items.length - 1;\n    this._lastRenderTime = this._renderTimes[last]; // drain reports the NEWEST stamps\n    this._lastReckonTime = this._reckonTimes[last];\n    if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[last]; }\n    // Hand off the backing array untouched when nothing was partially consumed\n    // (O(1) \u2014 the caller may retain it); else copy out the unconsumed tail. Fresh\n    // arrays here, NOT truncate(): drain already allocates the returned array, and\n    // V8 makes `= []` + refill cheaper than `length = 0` reuse (~1.8\u00D7 at small N),\n    // so the speed wins and the 3 tiny empties are negligible next to the return.\n    const out = this._head === 0 ? this._items : this._items.slice(this._head);\n    this.consumedCount += out.length;\n    this._items = [];\n    this._renderTimes = [];\n    this._reckonTimes = [];\n    if (this._seqs !== undefined) { this._seqs = []; }\n    this._head = 0;\n    return out;\n  }\n\n  /** Consume the single oldest input (ack advances by one); `undefined` if\n   *  empty \u2014 or the synthesized idle frame when an idle policy is in effect. */\n  next(opts?: ConsumeOptions<I>): I | undefined {\n    if (this.size === 0) {\n      const idle = this.idleFrameOnEmpty(opts);\n      this._lastWasIdle = idle !== undefined;\n      return idle;\n    }\n    const item = this.stepHead();\n    this.compact();\n    return item;\n  }\n\n  /** Consume up to `n` oldest inputs (ack advances by the count actually taken). */\n  take(n: number): I[] {\n    this._lastWasIdle = false; // take never synthesizes idle\n    const avail = this.size;\n    if (n <= 0 || avail === 0) { return []; }\n    const count = Math.min(n, avail);\n    const start = this._head;\n    const out = this._items.slice(start, start + count);\n    this._lastRenderTime = this._renderTimes[start + count - 1]; // newest taken input's stamps\n    this._lastReckonTime = this._reckonTimes[start + count - 1];\n    if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[start + count - 1]; }\n    this._head += count;\n    this.consumedCount += count;\n    this.compact();\n    return out;\n  }\n\n  /**\n   * Iterate pending inputs one at a time (per-yield ack + stamp updates), or\n   * exactly one synthesized idle frame on an empty buffer with a policy in\n   * effect. See {@link InputAccessor.consume}.\n   *\n   * Returns a POOLED iterator (reused across calls \u2014 no generator frame, no\n   * per-call allocation) that consumes at most the pending count snapshotted at\n   * the call \u2014 never past the live tail \u2014 plus one optional trailing idle frame.\n   * The cursor advances per `next()`, so `break` (which calls `return()`)\n   * leaves the rest buffered and compacts. A nested\n   * `consume()` of the SAME buffer while one is live falls back to a fresh\n   * generator so the pooled `_iterRes` isn't clobbered (nesting is meaningless \u2014\n   * both share the cursor \u2014 but it must not corrupt).\n   */\n  consume(opts?: ConsumeOptions<I>): IterableIterator<I> {\n    const empty = this.size === 0;\n    const idle = empty ? this.idleFrameOnEmpty(opts) : undefined;\n    if (empty && idle === undefined) { this._lastWasIdle = false; return DONE_ITERATOR as IterableIterator<I>; }\n    // A nested consume() of this same buffer would clobber the pooled iterator's\n    // shared state \u2192 hand the rare case a fresh generator instead.\n    if (this._iterActive) { return this.consumeGen(idle); }\n    this._iterActive = true;\n    this._iterIdle = idle;                 // one trailing idle frame, or undefined\n    this._iterRemaining = this.size;       // count snapshot \u2014 a (hypothetical) mid-loop push isn't consumed this pass\n    return this.ensureIter();\n  }\n\n  [Symbol.iterator](): IterableIterator<I> {\n    return this.consume();\n  }\n\n  /** Lazily mint the reused iterator. Closures over `this` so it reads the\n   *  private cursor directly; one `_iterRes` is reused \u2014 read each result before\n   *  the next `next()`, as `for..of` / spread / `Array.from` all do. */\n  private ensureIter(): IterableIterator<I> {\n    if (this._iter !== undefined) { return this._iter; }\n    const self = this;\n    const res = this._iterRes;\n    const finish = (): IteratorResult<I> => {\n      self.compact();\n      self._iterActive = false;\n      self._iterRemaining = 0;\n      self._iterIdle = undefined;\n      res.value = undefined;\n      res.done = true;\n      return res as IteratorResult<I>;\n    };\n    this._iter = {\n      [Symbol.iterator]() { return this; },\n      next(): IteratorResult<I> {\n        // `size > 0` re-checks the live tail: a mid-loop next()/take()/clear()\n        // can only shorten the pass, never make it read past the end.\n        if (self._iterRemaining > 0 && self.size > 0) {  // a buffered input\n          self._iterRemaining--;\n          res.value = self.stepHead();\n          res.done = false;\n          return res as IteratorResult<I>;\n        }\n        if (self._iterIdle !== undefined) {              // one trailing idle frame\n          self._lastWasIdle = true;\n          res.value = self._iterIdle;\n          self._iterIdle = undefined;\n          res.done = false;\n          return res as IteratorResult<I>;\n        }\n        return finish();\n      },\n      return(): IteratorResult<I> { return finish(); },  // `break` \u2192 compact + release\n    };\n    return this._iter;\n  }\n\n  /** Re-entrant fallback: a fresh generator for a nested `consume()` of this same\n   *  buffer (the pooled iterator is single-active). Same accounting + compaction. */\n  private *consumeGen(idleFrame: I | undefined): IterableIterator<I> {\n    let remaining = this.size;   // count-based walk, same reason as the pooled pass\n    try {\n      while (remaining-- > 0 && this.size > 0) { yield this.stepHead(); }\n      if (idleFrame !== undefined) { this._lastWasIdle = true; yield idleFrame; }\n    } finally {\n      this.compact();\n    }\n  }\n\n  peek(): I[] {\n    return this._items.slice(this._head);\n  }\n\n  at(value: number): I | undefined {\n    if (this._seqField === undefined) { return undefined; }\n    for (let i = this._head; i < this._items.length; i++) {\n      if ((this._items[i] as any)[this._seqField] === value) { return this._items[i]; }\n    }\n    return undefined;\n  }\n\n  get size(): number {\n    return this._items.length - this._head;\n  }\n\n  /** Render time (server-clock ms) of the most recently drained input; `0`\n   *  until the first render-time-stamped input is drained. */\n  get renderTime(): number {\n    return this._lastRenderTime;\n  }\n\n  /** Reckon-display stamp of the most recently consumed input \u2014 the client's\n   *  serverNow estimate when it sampled that input, i.e. the EXACT instant its\n   *  forward-reckoned entities were displayed at. Same consume semantics as\n   *  {@link renderTime}. RAW: stays `0` until stamped \u2014 the resolved,\n   *  always-usable value is the accessor's `reckonTime`\n   *  (`room.inputs.get(sid)`); `rewind.lastSeenBy()`'s midpoint-reconstruction\n   *  fallback depends on this raw `0`. */\n  get reckonTime(): number {\n    return this._lastReckonTime;\n  }\n\n  /** Seq VALUE of the last consumed input \u2014 the reconciliation ack sent to the\n   *  client. Reliable (no wire seq tracked): falls back to {@link consumedCount}\n   *  for free. Unreliable: the framework wire seq, so a fully-dropped input doesn't\n   *  make the ack lag the client's sent seq by the lost count. `0` before the first\n   *  consume. */\n  get ackSeq(): number {\n    return this._seqs !== undefined ? this._lastConsumedSeq : this.consumedCount;\n  }\n\n  /** Whether the most recently produced frame was a synthesized idle (see {@link wasIdle}). */\n  get wasIdle(): boolean {\n    return this._lastWasIdle;\n  }\n\n  clear(): void {\n    // Cleared inputs count as consumed: advance both the count and the seq-value ack\n    // past them so the client's pending set drains (capture the newest seq before truncate).\n    if (this._seqs !== undefined && this._items.length > 0) { this._lastConsumedSeq = this._seqs[this._items.length - 1]; }\n    this.consumedCount += this.size;\n    this.truncate();\n    this._lastSeq = -Infinity;\n    this._iterActive = false; // recovery hatch if a consume() iterator was abandoned unclosed\n    this._iterRemaining = 0;  // an abandoned iterator must not consume post-clear pushes\n    this._iterIdle = undefined;\n  }\n}\n\n/**\n * Default per-client accessor. Reads `_input` and `_inputBuffer` off the\n * client at access time \u2014 both are nullable until the room declares input\n * via `defineInput()`. Cached as `client._inputAccessor` at join, so\n * `room.inputs.get(sessionId)` is a Map lookup + property read.\n *\n * @internal\n */\nexport class InputAccessorImpl<I = any> implements InputAccessor<I> {\n  private _client: ClientPrivate;\n  /** Current room time (`clock.elapsedTime`) \u2014 resolves the {@link reckonTime}\n   *  fallback. Threaded by `RoomInput.allocate()`; optional so bare\n   *  constructions (tests) keep the raw 0. */\n  private _nowOf?: () => number;\n  constructor(client: ClientPrivate, nowOf?: () => number) {\n    this._client = client;\n    this._nowOf = nowOf;\n  }\n  get latest(): I | undefined { return this._client._input as I | undefined; }\n  at(value: number): I | undefined { return this._client._inputBuffer?.at(value) as I | undefined; }\n  consume(opts?: ConsumeOptions<I>): IterableIterator<I> {\n    return (this._client._inputBuffer?.consume(opts) ?? DONE_ITERATOR) as IterableIterator<I>;\n  }\n  [Symbol.iterator](): IterableIterator<I> { return this.consume(); }\n  drain(opts?: ConsumeOptions<I>): I[] { return (this._client._inputBuffer?.drain(opts) ?? []) as I[]; }\n  next(): I | undefined;\n  next(opts: { idle: IdleInput<I> }): I;\n  next(opts?: ConsumeOptions<I>): I | undefined { return this._client._inputBuffer?.next(opts) as I | undefined; }\n  take(n: number): I[] { return (this._client._inputBuffer?.take(n) ?? []) as I[]; }\n  peek(): I[] { return (this._client._inputBuffer?.peek() ?? []) as I[]; }\n  get size(): number { return this._client._inputBuffer?.size ?? 0; }\n  get consumedCount(): number { return this._client._inputBuffer?.consumedCount ?? 0; }\n  get wasIdle(): boolean { return this._client._inputBuffer?.wasIdle ?? false; }\n  clear(): void { this._client._inputBuffer?.clear(); }\n  get renderTime(): number { return this._client._inputBuffer?.renderTime ?? 0; }\n  /** @internal RAW reckon stamp (0 until stamped). The rewind binding reads\n   *  THIS, not the resolved getter below: `Rewind._aim`'s midpoint fallback\n   *  must still see 0 for unstamped clients (a resolved value would silently\n   *  take the direct-stamp clamp path). */\n  get rawReckonTime(): number { return this._client._inputBuffer?.reckonTime ?? 0; }\n  get reckonTime(): number {\n    const raw = this._client._inputBuffer?.reckonTime ?? 0;\n    return raw > 0 ? raw : this._nowOf !== undefined ? this._nowOf() : 0;\n  }\n}\n\n/**\n * Returned by `room.inputs.get(sessionId)` for unknown sessions and for rooms\n * that didn't call `defineInput()`.\n *\n * @internal\n */\nexport const NO_OP_INPUT_ACCESSOR: InputAccessor<any> = Object.freeze({\n  latest: undefined,\n  at: () => undefined,\n  consume: () => DONE_ITERATOR,\n  [Symbol.iterator]: () => DONE_ITERATOR,\n  drain: () => [],\n  next: () => undefined,\n  take: () => [],\n  peek: () => [],\n  size: 0,\n  consumedCount: 0,\n  wasIdle: false,\n  clear: () => {},\n  renderTime: 0,\n  reckonTime: 0, // stays 0 \u2014 an unknown session / input-less room has no clock to resolve against\n});\n"],
-  "mappings": "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",
-  "names": []
+  "sourcesContent": ["import { $values } from '@colyseus/schema';\n\nimport type { ClientPrivate } from '../Transport.ts';\nimport { $METADATA } from '../utils/Utils.ts';\n\nimport type {\n  ConsumeOptions, IdleContext, IdleInput, InputAccessor, SanitizeInput,\n} from './types.ts';\n\n/**\n * @internal Validate a `subSteps` count. Throws on a fractional/non-positive\n * value: both sides loop `subSteps` times at `dt/subSteps`, so anything but a\n * whole number is a determinism bug, not a tunable. Shared by `defineInput`\n * and `setFixedTimestep`.\n */\nexport function validateSubSteps(subSteps: number | undefined, source: string): number | undefined {\n  if (subSteps === undefined) { return undefined; }\n  if (!Number.isInteger(subSteps) || subSteps < 1) {\n    throw new Error(`[${source}] subSteps must be an integer >= 1 (got ${subSteps}).`);\n  }\n  return subSteps;\n}\n\n/**\n * @internal Compile a {@link SanitizeInput} spec into the per-frame function the\n * decode path applies. The map form precompiles to dense min/max arrays walked\n * with the NaN-safe branch clamp; the callback form passes through.\n */\nexport function compileSanitizer<I>(spec: SanitizeInput<I>): (input: I) => void {\n  if (typeof spec === 'function') { return spec; }\n  const names = Object.keys(spec);\n  const mins = new Float64Array(names.length);\n  const maxs = new Float64Array(names.length);\n  for (let i = 0; i < names.length; i++) {\n    const range = (spec as Record<string, readonly [number, number]>)[names[i]]!;\n    mins[i] = range[0];\n    maxs[i] = range[1];\n  }\n  return (input: I) => {\n    const inst = input as Record<string, number>;\n    for (let i = 0; i < names.length; i++) {\n      const v = inst[names[i]];\n      // Never-received field: no input to sanitize \u2014 clamping would INVENT\n      // one (delta-encoding clients legitimately never transmit fields they\n      // never assigned; the range floor turned \"no input\" into \"held stick\").\n      if (v === undefined) { continue; }\n      // NaN-safe: NaN fails both comparisons \u2192 clamp floor.\n      const clamped = v >= mins[i] ? (v <= maxs[i] ? v : maxs[i]) : mins[i];\n      // Honest frames clamp nothing: a keyed write through the setter costs more than the walk.\n      if (clamped !== v) { inst[names[i]] = clamped; }\n    }\n  };\n}\n\n/** Field names of an input schema ctor, in declaration order (indices are dense\n *  from 0 in the metadata). Resolved ONCE per buffer (cold path). */\nfunction fieldNamesOf(ctor: new () => any): string[] {\n  const md = (ctor as any)[$METADATA] as Record<number, { name?: string }> | undefined;\n  const names: string[] = [];\n  if (md) {\n    for (let i = 0; ; i++) {\n      const f = md[i];\n      if (!f || typeof f.name !== \"string\") break;\n      names.push(f.name);\n    }\n  }\n  return names;\n}\n\n/** One per input schema, so every room's frames share a hidden class. */\nconst _snapshots = new WeakMap<new () => any, (input: any) => any>();\n\n/**\n * @internal Compile how a decoded input is copied into the buffer. `clone()`\n * builds a Schema and its ChangeTree per input, for a frame that's never\n * encoded, so a schema of plain values gets a lighter frame: its own array of\n * values behind the ctor's prototype. Methods, getters, `instanceof`, `clone()`\n * and `toJSON()` all hold, and a field write lands on the copy, untracked. A\n * nested schema or collection keeps `clone()`, whose copy is deep.\n *\n * Fields are read by name, as `clone()` reads them, never by copying `$values`:\n * native class fields (`useDefineForClassFields`) shadow the schema's accessors,\n * so the decoder's values sit on the instance and `$values` stays empty.\n */\nexport function compileSnapshot<I>(ctor: new () => I): (input: I) => I {\n  let snapshot = _snapshots.get(ctor);\n  if (snapshot !== undefined) { return snapshot; }\n\n  const md = (ctor as any)[$METADATA] as Record<number, { type?: unknown }> | undefined;\n  const names = fieldNamesOf(ctor);\n  const plain = md !== undefined && names.every((_, i) => {\n    const type = md[i].type;\n    return typeof type === \"string\" || (type !== null && typeof type === \"object\" && \"quantized\" in type);\n  });\n\n  if (plain) {\n    const fields: PropertyDescriptorMap = {};\n    names.forEach((name, i) => {\n      fields[name] = {\n        get(this: any) { return this[$values][i]; },\n        set(this: any, value: unknown) { this[$values][i] = value; },\n        enumerable: true,\n        configurable: true,\n      };\n    });\n    // A function, not a class: `constructor` must stay the schema's (clone/toJSON read its metadata).\n    function Frame(this: any, values: unknown[]) { this[$values] = values; }\n    Frame.prototype = Object.create(ctor.prototype, fields);\n    const count = names.length;\n    snapshot = (input) => {\n      const values = new Array(count);\n      for (let i = 0; i < count; i++) { values[i] = input[names[i]]; }\n      return new (Frame as any)(values);\n    };\n  } else {\n    snapshot = (input) => input.clone();\n  }\n\n  _snapshots.set(ctor, snapshot!);\n  return snapshot!;\n}\n\n/**\n * @internal Seed every declared field that has no construction default with\n * its wire-neutral zero value (0 / false / \"\"; quantized: 0 clamped into the\n * descriptor's range). The input contract is \"the server holds the last\n * received value\" \u2014 before anything is received, that value is the ZERO of\n * the field's type, never `undefined`: a sim would NaN-propagate it and a\n * range sanitizer would clamp it into a phantom input. Clients only transmit\n * fields they assign, so an untouched field stays absent on the wire forever.\n */\nexport function seedInputZeroValues(instance: any, ctor: new () => any): void {\n  const md = (ctor as any)[$METADATA] as\n    Record<number, { name?: string, type?: unknown }> | undefined;\n  if (!md) { return; }\n  for (let i = 0; ; i++) {\n    const f = md[i];\n    if (!f || typeof f.name !== \"string\") break;\n    if (instance[f.name] !== undefined) { continue; }   // .default() wins\n    const type = f.type;\n    if (typeof type === \"string\") {\n      instance[f.name] = type === \"string\" ? \"\" : type === \"boolean\" ? false : 0;\n    } else if (type !== null && typeof type === \"object\" && \"quantized\" in (type as object)) {\n      const q = (type as { quantized: { min: number, max: number } }).quantized;\n      instance[f.name] = q.min > 0 ? q.min : q.max < 0 ? q.max : 0;\n    }\n  }\n}\n\n/** Reclaim the consumed prefix once the read cursor passes this many items \u2014\n *  bounds the parallel arrays' slack to O(THRESHOLD) between compactions while\n *  keeping per-consume work O(1) (no `shift()` re-index on every input). */\nconst COMPACT_THRESHOLD = 32;\n\n/** Shared zero-state \"already done\" iterator \u2014 returned by `consume()` on an\n *  empty buffer with no idle policy, and by the no-op accessor. Frozen + a frozen\n *  result, so it's allocation-free and safe to share across all callers. */\nconst DONE_RESULT: IteratorResult<any> = Object.freeze({ value: undefined, done: true });\nconst DONE_ITERATOR: IterableIterator<any> = Object.freeze({\n  [Symbol.iterator]() { return this; },\n  next() { return DONE_RESULT; },\n});\n\n/** @internal */\nexport class InputBufferImpl<I = any> {\n  /** Pending snapshots, indexed `[_head, _items.length)`. Consumed inputs are\n   *  NOT spliced off per-read \u2014 `_head` advances and the prefix is reclaimed in\n   *  bulk by {@link compact} (a `shift()` per read is O(n), so a burst would be\n   *  O(n\u00B2)). `_renderTimes`/`_reckonTimes` stay parallel to `_items`. */\n  private _items: I[] = [];\n  /** Read cursor: index of the oldest UNCONSUMED input (== `_items.length` when empty). */\n  private _head = 0;\n  private _lastSeq: number = -Infinity;\n  private readonly _maxSize: number;\n  private readonly _seqField: string | undefined;\n\n  /**\n   * Cumulative count of inputs CONSUMED from this buffer (via any consume\n   * primitive \u2014 {@link next}/{@link take}/{@link drain}/{@link consume} \u2014 plus\n   * {@link clear} and overflow). Consumed = \"removed from the pending set\",\n   * whether applied to state or discarded. The server echoes this in the TIMED\n   * prefix as the reconciliation ack: how many of the client's inputs are\n   * reflected in (or finished influencing) the authoritative state, which lags\n   * the receive counter by inputs still buffered. Distinct from\n   * `_receivedInputCount` (receive-time, for RTT), which leads the state.\n   */\n  consumedCount = 0;\n\n  /** Render times parallel to `_items` (server-clock ms; `0` when unset). */\n  private _renderTimes: number[] = [];\n  /** Render time of the most recently drained input (see {@link renderTime}). */\n  private _lastRenderTime = 0;\n  /** Reckon-display stamps parallel to `_items` \u2014 the client's serverNow\n   *  estimate at input-sample time, i.e. the instant its forward-reckoned\n   *  entities were displayed at (server-clock ms; `0` when unset). */\n  private _reckonTimes: number[] = [];\n  /** Reckon stamp of the most recently consumed input (see {@link reckonTime}). */\n  private _lastReckonTime = 0;\n  /** Framework wire seq per buffered input (parallel to `_items`) \u2014 UNRELIABLE\n   *  ONLY, lazily created on the first seq-carrying push. Reliable inputs are\n   *  contiguous, so their consumed-seq-value is always exactly {@link consumedCount}\n   *  and needs no parallel array; `undefined` here marks that (the common, default\n   *  path pays nothing). A buffer is single-mode, so this is either never created\n   *  (reliable) or created once and kept parallel (unreliable). */\n  private _seqs?: number[];\n  /** Seq VALUE of the last consumed input \u2014 the reconciliation ack echoed to the\n   *  client (see {@link ackSeq}). Only meaningful when {@link _seqs} is tracked\n   *  (unreliable); reliable's ack falls back to {@link consumedCount}. */\n  private _lastConsumedSeq = 0;\n  /** Whether the most recently produced frame was a synthesized idle (see {@link wasIdle}). */\n  private _lastWasIdle = false;\n\n  /** Reused {@link consume} iterator (lazily minted) + its per-call state, so a\n   *  per-tick loop allocates no generator frame. `_iterRemaining` snapshots the\n   *  COUNT to walk \u2014 a count, not an index: mid-pass mutations (`next()`/`take()`/\n   *  `clear()`/compaction) shift indices but can only shorten a count-based pass,\n   *  never point it past the tail. `_iterIdle` is an optional trailing synthesized\n   *  frame; `_iterActive` guards against a nested consume() clobbering the shared\n   *  `_iterRes`. */\n  private _iter?: IterableIterator<I>;\n  private _iterRemaining = 0;\n  private _iterActive = false;\n  private _iterIdle?: I;\n  private readonly _iterRes: { value: I | undefined; done: boolean } = { value: undefined, done: false };\n\n  /** Input schema ctor \u2014 mints the reused idle frame; idle is off without it. */\n  private readonly _ctor?: new () => I;\n  /** Client slice this buffer belongs to (the live object is `Client & ClientPrivate`)\n   *  \u2014 feeds the idle callback's ctx (latest + sessionId). */\n  private readonly _client?: Pick<ClientPrivate, '_input'> & { sessionId: string };\n  /** Room-level idle policy (`defineInput({ idle })`) \u2014 the bare-call default. */\n  private readonly _roomIdle?: IdleInput<I>;\n  /** Reused synthesized idle frame + the schema's field names/defaults (lazy). */\n  private _idle?: I;\n  private _fieldNames?: string[];\n  private _defaults?: unknown[];\n  /** Reused ctx for the idle callback form (see {@link IdleContext}). */\n  private readonly _idleCtx: IdleContext<I> = { latest: undefined, sessionId: \"\" };\n\n  constructor(maxSize: number, seqField: string | undefined, ctor?: new () => I, client?: Pick<ClientPrivate, '_input'> & { sessionId: string }, idle?: IdleInput<I>) {\n    this._maxSize = maxSize;\n    this._seqField = seqField;\n    this._ctor = ctor;\n    this._client = client;\n    this._roomIdle = idle;\n  }\n\n  /** The effective idle policy for one consume call: per-call `false` suppresses,\n   *  per-call value overrides, else the room-level default (or none). */\n  private effectiveIdle(opts?: ConsumeOptions<I>): IdleInput<I> | undefined {\n    return opts?.idle === false ? undefined : (opts?.idle ?? this._roomIdle);\n  }\n\n  /** Resolve an {@link IdleInput} to overrides \u2014 invokes the callback form\n   *  LAZILY, here at synthesis time (the buffer is known to be empty). */\n  private resolveIdle(idle: IdleInput<I>): true | Partial<I> {\n    if (typeof idle !== \"function\") return idle;\n    this._idleCtx.latest = this._client?._input as I | undefined;\n    this._idleCtx.sessionId = this._client?.sessionId ?? \"\";\n    return idle(this._idleCtx) ?? true;\n  }\n\n  /**\n   * The synthesized \"no input this tick\" frame: schema defaults overlaid with\n   * `overrides` (`true` = none). Copies BY FIELD NAME from the schema metadata \u2014\n   * schema fields are prototype accessors (no own props), so `Object.assign`\n   * can't source from a schema instance; the name walk reads getters, letting\n   * `overrides` be a plain partial OR a schema instance (e.g. `latest`).\n   * ONE reused instance \u2014 refilled per call, never advances the ack.\n   */\n  private idleFrame(overrides: true | Partial<I>): I {\n    if (this._idle === undefined) {\n      // Lazy mint (cold): the fresh instance doubles as the defaults source.\n      this._idle = new this._ctor!();\n      seedInputZeroValues(this._idle, this._ctor!);\n      this._fieldNames = fieldNamesOf(this._ctor!);\n      const fresh = this._idle as Record<string, unknown>;\n      this._defaults = this._fieldNames.map((n) => fresh[n]);\n    }\n    const idle = this._idle as Record<string, unknown>;\n    const names = this._fieldNames!;\n    const defaults = this._defaults!;\n    const ov = overrides === true ? undefined : (overrides as Record<string, unknown>);\n    for (let i = 0; i < names.length; i++) {\n      const v = ov?.[names[i]];\n      idle[names[i]] = v !== undefined ? v : defaults[i];\n    }\n    return this._idle;\n  }\n\n  /** The idle frame to synthesize on an empty tick (room policy or per-call\n   *  `opts.idle`), or `undefined` when no policy is in effect. Reuses the single\n   *  idle instance; never advances the ack. Callers set {@link wasIdle}. */\n  private idleFrameOnEmpty(opts?: ConsumeOptions<I>): I | undefined {\n    const idle = this._ctor !== undefined ? this.effectiveIdle(opts) : undefined;\n    return idle === undefined ? undefined : this.idleFrame(this.resolveIdle(idle));\n  }\n\n  /** Consume the input at the cursor: advance cursor + ack, stamp THIS input's\n   *  render/reckon times, clear {@link wasIdle}. The shared per-input step behind\n   *  {@link next}, {@link consume}'s iterator, and the re-entrant fallback. */\n  private stepHead(): I {\n    const i = this._head;\n    this._lastWasIdle = false;\n    this._lastRenderTime = this._renderTimes[i];\n    this._lastReckonTime = this._reckonTimes[i];\n    if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[i]; }\n    this._head = i + 1;\n    this.consumedCount++;\n    return this._items[i];\n  }\n\n  /** Drop ALL slots, reusing the backing arrays' capacity \u2014 the zero-GC reset for\n   *  the consume/next path ({@link compact}/{@link clear}). `drain()` deliberately\n   *  does NOT use this (it returns an array, so fresh `[]` is faster there). */\n  private truncate(): void {\n    this._items.length = 0;\n    this._renderTimes.length = 0;\n    this._reckonTimes.length = 0;\n    if (this._seqs !== undefined) { this._seqs.length = 0; }\n    this._head = 0;\n  }\n\n  /**\n   * Append a decoded input snapshot. `seq` is the framework wire seq (unreliable);\n   * omit it for reliable inputs, which get an implicit monotonic receive count so\n   * {@link ackSeq} stays well-defined in both modes.\n   */\n  push(snapshot: I, renderTime: number = 0, reckonTime: number = 0, seq?: number): void {\n    this._items.push(snapshot);\n    this._renderTimes.push(renderTime);\n    this._reckonTimes.push(reckonTime);\n    // Track the wire seq only for unreliable (seq provided); reliable derives its\n    // ack from consumedCount, so it never allocates/maintains this array.\n    if (seq !== undefined) { (this._seqs ??= []).push(seq); }\n    // Overflow drops the oldest unconsumed input; count it consumed so the ack\n    // still advances past it. Advance the cursor (don't shift) \u2014 keeps it O(1).\n    if (this.size > this._maxSize) {\n      if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[this._head]; } // dropped oldest counts as acked\n      this._head++;\n      this.consumedCount++;\n      this.compact();\n    }\n  }\n\n  /** Reclaim the consumed prefix `[0, _head)`. Free when fully drained (reuse the\n   *  arrays); otherwise splice only once the cursor passes {@link COMPACT_THRESHOLD},\n   *  so the amortized per-input cost stays O(1). */\n  private compact(): void {\n    if (this._head === 0) { return; }\n    if (this._head >= this._items.length) {\n      this.truncate();\n    } else if (this._head >= COMPACT_THRESHOLD) {\n      this._items.splice(0, this._head);\n      this._renderTimes.splice(0, this._head);\n      this._reckonTimes.splice(0, this._head);\n      if (this._seqs !== undefined) { this._seqs.splice(0, this._head); }\n      this._head = 0;\n    }\n  }\n\n  /** Returns true if `value` hasn't been seen, and updates the last-seen marker. */\n  accept(value: number): boolean {\n    if (value <= this._lastSeq) { return false; }\n    this._lastSeq = value;\n    return true;\n  }\n\n  drain(opts?: ConsumeOptions<I>): I[] {\n    // Empty: synthesize one idle frame (NOT consumed \u2014 no ack bump, stamps\n    // untouched) when a policy is in effect, else [].\n    if (this.size === 0) {\n      const idle = this.idleFrameOnEmpty(opts);\n      this._lastWasIdle = idle !== undefined;\n      return idle !== undefined ? [idle] : [];\n    }\n    this._lastWasIdle = false;\n    const last = this._items.length - 1;\n    this._lastRenderTime = this._renderTimes[last]; // drain reports the NEWEST stamps\n    this._lastReckonTime = this._reckonTimes[last];\n    if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[last]; }\n    // Hand off the backing array untouched when nothing was partially consumed\n    // (O(1) \u2014 the caller may retain it); else copy out the unconsumed tail. Fresh\n    // arrays here, NOT truncate(): drain already allocates the returned array, and\n    // V8 makes `= []` + refill cheaper than `length = 0` reuse (~1.8\u00D7 at small N),\n    // so the speed wins and the 3 tiny empties are negligible next to the return.\n    const out = this._head === 0 ? this._items : this._items.slice(this._head);\n    this.consumedCount += out.length;\n    this._items = [];\n    this._renderTimes = [];\n    this._reckonTimes = [];\n    if (this._seqs !== undefined) { this._seqs = []; }\n    this._head = 0;\n    return out;\n  }\n\n  /** Consume the single oldest input (ack advances by one); `undefined` if\n   *  empty \u2014 or the synthesized idle frame when an idle policy is in effect. */\n  next(opts?: ConsumeOptions<I>): I | undefined {\n    if (this.size === 0) {\n      const idle = this.idleFrameOnEmpty(opts);\n      this._lastWasIdle = idle !== undefined;\n      return idle;\n    }\n    const item = this.stepHead();\n    this.compact();\n    return item;\n  }\n\n  /** Consume up to `n` oldest inputs (ack advances by the count actually taken). */\n  take(n: number): I[] {\n    this._lastWasIdle = false; // take never synthesizes idle\n    const avail = this.size;\n    if (n <= 0 || avail === 0) { return []; }\n    const count = Math.min(n, avail);\n    const start = this._head;\n    const out = this._items.slice(start, start + count);\n    this._lastRenderTime = this._renderTimes[start + count - 1]; // newest taken input's stamps\n    this._lastReckonTime = this._reckonTimes[start + count - 1];\n    if (this._seqs !== undefined) { this._lastConsumedSeq = this._seqs[start + count - 1]; }\n    this._head += count;\n    this.consumedCount += count;\n    this.compact();\n    return out;\n  }\n\n  /**\n   * Iterate pending inputs one at a time (per-yield ack + stamp updates), or\n   * exactly one synthesized idle frame on an empty buffer with a policy in\n   * effect. See {@link InputAccessor.consume}.\n   *\n   * Returns a POOLED iterator (reused across calls \u2014 no generator frame, no\n   * per-call allocation) that consumes at most the pending count snapshotted at\n   * the call \u2014 never past the live tail \u2014 plus one optional trailing idle frame.\n   * The cursor advances per `next()`, so `break` (which calls `return()`)\n   * leaves the rest buffered and compacts. A nested\n   * `consume()` of the SAME buffer while one is live falls back to a fresh\n   * generator so the pooled `_iterRes` isn't clobbered (nesting is meaningless \u2014\n   * both share the cursor \u2014 but it must not corrupt).\n   */\n  consume(opts?: ConsumeOptions<I>): IterableIterator<I> {\n    const empty = this.size === 0;\n    const idle = empty ? this.idleFrameOnEmpty(opts) : undefined;\n    if (empty && idle === undefined) { this._lastWasIdle = false; return DONE_ITERATOR as IterableIterator<I>; }\n    // A nested consume() of this same buffer would clobber the pooled iterator's\n    // shared state \u2192 hand the rare case a fresh generator instead.\n    if (this._iterActive) { return this.consumeGen(idle); }\n    this._iterActive = true;\n    this._iterIdle = idle;                 // one trailing idle frame, or undefined\n    this._iterRemaining = this.size;       // count snapshot \u2014 a (hypothetical) mid-loop push isn't consumed this pass\n    return this.ensureIter();\n  }\n\n  [Symbol.iterator](): IterableIterator<I> {\n    return this.consume();\n  }\n\n  /** Lazily mint the reused iterator. Closures over `this` so it reads the\n   *  private cursor directly; one `_iterRes` is reused \u2014 read each result before\n   *  the next `next()`, as `for..of` / spread / `Array.from` all do. */\n  private ensureIter(): IterableIterator<I> {\n    if (this._iter !== undefined) { return this._iter; }\n    const self = this;\n    const res = this._iterRes;\n    const finish = (): IteratorResult<I> => {\n      self.compact();\n      self._iterActive = false;\n      self._iterRemaining = 0;\n      self._iterIdle = undefined;\n      res.value = undefined;\n      res.done = true;\n      return res as IteratorResult<I>;\n    };\n    this._iter = {\n      [Symbol.iterator]() { return this; },\n      next(): IteratorResult<I> {\n        // `size > 0` re-checks the live tail: a mid-loop next()/take()/clear()\n        // can only shorten the pass, never make it read past the end.\n        if (self._iterRemaining > 0 && self.size > 0) {  // a buffered input\n          self._iterRemaining--;\n          res.value = self.stepHead();\n          res.done = false;\n          return res as IteratorResult<I>;\n        }\n        if (self._iterIdle !== undefined) {              // one trailing idle frame\n          self._lastWasIdle = true;\n          res.value = self._iterIdle;\n          self._iterIdle = undefined;\n          res.done = false;\n          return res as IteratorResult<I>;\n        }\n        return finish();\n      },\n      return(): IteratorResult<I> { return finish(); },  // `break` \u2192 compact + release\n    };\n    return this._iter;\n  }\n\n  /** Re-entrant fallback: a fresh generator for a nested `consume()` of this same\n   *  buffer (the pooled iterator is single-active). Same accounting + compaction. */\n  private *consumeGen(idleFrame: I | undefined): IterableIterator<I> {\n    let remaining = this.size;   // count-based walk, same reason as the pooled pass\n    try {\n      while (remaining-- > 0 && this.size > 0) { yield this.stepHead(); }\n      if (idleFrame !== undefined) { this._lastWasIdle = true; yield idleFrame; }\n    } finally {\n      this.compact();\n    }\n  }\n\n  peek(): I[] {\n    return this._items.slice(this._head);\n  }\n\n  at(value: number): I | undefined {\n    if (this._seqField === undefined) { return undefined; }\n    for (let i = this._head; i < this._items.length; i++) {\n      if ((this._items[i] as any)[this._seqField] === value) { return this._items[i]; }\n    }\n    return undefined;\n  }\n\n  get size(): number {\n    return this._items.length - this._head;\n  }\n\n  /** Render time (server-clock ms) of the most recently drained input; `0`\n   *  until the first render-time-stamped input is drained. */\n  get renderTime(): number {\n    return this._lastRenderTime;\n  }\n\n  /** Reckon-display stamp of the most recently consumed input \u2014 the client's\n   *  serverNow estimate when it sampled that input, i.e. the EXACT instant its\n   *  forward-reckoned entities were displayed at. Same consume semantics as\n   *  {@link renderTime}. RAW: stays `0` until stamped \u2014 the resolved,\n   *  always-usable value is the accessor's `reckonTime`\n   *  (`room.inputs.get(sid)`); `rewind.lastSeenBy()`'s midpoint-reconstruction\n   *  fallback depends on this raw `0`. */\n  get reckonTime(): number {\n    return this._lastReckonTime;\n  }\n\n  /** Seq VALUE of the last consumed input \u2014 the reconciliation ack sent to the\n   *  client. Reliable (no wire seq tracked): falls back to {@link consumedCount}\n   *  for free. Unreliable: the framework wire seq, so a fully-dropped input doesn't\n   *  make the ack lag the client's sent seq by the lost count. `0` before the first\n   *  consume. */\n  get ackSeq(): number {\n    return this._seqs !== undefined ? this._lastConsumedSeq : this.consumedCount;\n  }\n\n  /** Whether the most recently produced frame was a synthesized idle (see {@link wasIdle}). */\n  get wasIdle(): boolean {\n    return this._lastWasIdle;\n  }\n\n  clear(): void {\n    // Cleared inputs count as consumed: advance both the count and the seq-value ack\n    // past them so the client's pending set drains (capture the newest seq before truncate).\n    if (this._seqs !== undefined && this._items.length > 0) { this._lastConsumedSeq = this._seqs[this._items.length - 1]; }\n    this.consumedCount += this.size;\n    this.truncate();\n    this._lastSeq = -Infinity;\n    this._iterActive = false; // recovery hatch if a consume() iterator was abandoned unclosed\n    this._iterRemaining = 0;  // an abandoned iterator must not consume post-clear pushes\n    this._iterIdle = undefined;\n  }\n}\n\n/**\n * Default per-client accessor. Reads `_input` and `_inputBuffer` off the\n * client at access time \u2014 both are nullable until the room declares input\n * via `defineInput()`. Cached as `client._inputAccessor` at join, so\n * `room.inputs.get(sessionId)` is a Map lookup + property read.\n *\n * @internal\n */\nexport class InputAccessorImpl<I = any> implements InputAccessor<I> {\n  private _client: ClientPrivate;\n  /** Current room time (`clock.elapsedTime`) \u2014 resolves the {@link reckonTime}\n   *  fallback. Threaded by `RoomInput.allocate()`; optional so bare\n   *  constructions (tests) keep the raw 0. */\n  private _nowOf?: () => number;\n  constructor(client: ClientPrivate, nowOf?: () => number) {\n    this._client = client;\n    this._nowOf = nowOf;\n  }\n  get latest(): I | undefined { return this._client._input as I | undefined; }\n  at(value: number): I | undefined { return this._client._inputBuffer?.at(value) as I | undefined; }\n  consume(opts?: ConsumeOptions<I>): IterableIterator<I> {\n    return (this._client._inputBuffer?.consume(opts) ?? DONE_ITERATOR) as IterableIterator<I>;\n  }\n  [Symbol.iterator](): IterableIterator<I> { return this.consume(); }\n  drain(opts?: ConsumeOptions<I>): I[] { return (this._client._inputBuffer?.drain(opts) ?? []) as I[]; }\n  next(): I | undefined;\n  next(opts: { idle: IdleInput<I> }): I;\n  next(opts?: ConsumeOptions<I>): I | undefined { return this._client._inputBuffer?.next(opts) as I | undefined; }\n  take(n: number): I[] { return (this._client._inputBuffer?.take(n) ?? []) as I[]; }\n  peek(): I[] { return (this._client._inputBuffer?.peek() ?? []) as I[]; }\n  get size(): number { return this._client._inputBuffer?.size ?? 0; }\n  get consumedCount(): number { return this._client._inputBuffer?.consumedCount ?? 0; }\n  get wasIdle(): boolean { return this._client._inputBuffer?.wasIdle ?? false; }\n  clear(): void { this._client._inputBuffer?.clear(); }\n  get renderTime(): number { return this._client._inputBuffer?.renderTime ?? 0; }\n  /** @internal RAW reckon stamp (0 until stamped). The rewind binding reads\n   *  THIS, not the resolved getter below: `Rewind._aim`'s midpoint fallback\n   *  must still see 0 for unstamped clients (a resolved value would silently\n   *  take the direct-stamp clamp path). */\n  get rawReckonTime(): number { return this._client._inputBuffer?.reckonTime ?? 0; }\n  get reckonTime(): number {\n    const raw = this._client._inputBuffer?.reckonTime ?? 0;\n    return raw > 0 ? raw : this._nowOf !== undefined ? this._nowOf() : 0;\n  }\n}\n\n/**\n * Returned by `room.inputs.get(sessionId)` for unknown sessions and for rooms\n * that didn't call `defineInput()`.\n *\n * @internal\n */\nexport const NO_OP_INPUT_ACCESSOR: InputAccessor<any> = Object.freeze({\n  latest: undefined,\n  at: () => undefined,\n  consume: () => DONE_ITERATOR,\n  [Symbol.iterator]: () => DONE_ITERATOR,\n  drain: () => [],\n  next: () => undefined,\n  take: () => [],\n  peek: () => [],\n  size: 0,\n  consumedCount: 0,\n  wasIdle: false,\n  clear: () => {},\n  renderTime: 0,\n  reckonTime: 0, // stays 0 \u2014 an unknown session / input-less room has no clock to resolve against\n});\n"],
+  "mappings": "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",
+  "names": ["Frame"]
 }

package/build/input/InputBuffer.d.ts

@@ -13,6 +13,19 @@ export declare function validateSubSteps(subSteps: number | undefined, source: s
  * with the NaN-safe branch clamp; the callback form passes through.
  */
 export declare function compileSanitizer<I>(spec: SanitizeInput<I>): (input: I) => void;
+/**
+ * @internal Compile how a decoded input is copied into the buffer. `clone()`
+ * builds a Schema and its ChangeTree per input, for a frame that's never
+ * encoded, so a schema of plain values gets a lighter frame: its own array of
+ * values behind the ctor's prototype. Methods, getters, `instanceof`, `clone()`
+ * and `toJSON()` all hold, and a field write lands on the copy, untracked. A
+ * nested schema or collection keeps `clone()`, whose copy is deep.
+ *
+ * Fields are read by name, as `clone()` reads them, never by copying `$values`:
+ * native class fields (`useDefineForClassFields`) shadow the schema's accessors,
+ * so the decoder's values sit on the instance and `$values` stays empty.
+ */
+export declare function compileSnapshot<I>(ctor: new () => I): (input: I) => I;
 /**
  * @internal Seed every declared field that has no construction default with
  * its wire-neutral zero value (0 / false / ""; quantized: 0 clamped into the

package/build/input/InputBuffer.mjs

@@ -1,4 +1,5 @@
 // packages/core/src/input/InputBuffer.ts
+import { $values } from "@colyseus/schema";
 import { $METADATA } from "../utils/Utils.mjs";
 function validateSubSteps(subSteps, source) {
   if (subSteps === void 0) {
@@ -28,7 +29,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;
+      }
     }
   };
 }
@@ -44,6 +48,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[$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[$values] = values;
+    };
+    var Frame = Frame2;
+    const fields = {};
+    names.forEach((name, i) => {
+      fields[name] = {
+        get() {
+          return this[$values][i];
+        },
+        set(value) {
+          this[$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[$METADATA];
   if (!md) {
@@ -527,6 +576,7 @@ export {
   InputBufferImpl,
   NO_OP_INPUT_ACCESSOR,
   compileSanitizer,
+  compileSnapshot,
   seedInputZeroValues,
   validateSubSteps
 };