rollback-netcode 0.0.4

package/dist/session/message-builders.d.ts

@@ -0,0 +1,86 @@
+/**
+ * Factory functions for creating protocol messages.
+ *
+ * Centralizes message construction to reduce duplication in Session.ts.
+ */
+import type { Message } from "../protocol/messages.js";
+import type { PauseReason, PlayerId, PlayerRole, PlayerTimeline, Tick } from "../types.js";
+/**
+ * Create a JoinRequest message.
+ */
+export declare function createJoinRequest(playerId: PlayerId, role: PlayerRole): Message;
+/**
+ * Create a PlayerLeft message.
+ */
+export declare function createPlayerLeft(playerId: PlayerId, leaveTick: Tick): Message;
+/**
+ * Create a Sync message for state synchronization.
+ */
+export declare function createSync(tick: Tick, state: Uint8Array, hash: number, playerTimeline: PlayerTimeline): Message;
+/**
+ * Create a Pause message.
+ */
+export declare function createPause(playerId: PlayerId, pauseTick: Tick, reason: PauseReason): Message;
+/**
+ * Create a Resume message.
+ */
+export declare function createResume(playerId: PlayerId, resumeTick: Tick): Message;
+/**
+ * Create a ResumeCountdown message.
+ */
+export declare function createResumeCountdown(secondsRemaining: number): Message;
+/**
+ * Create a SyncRequest message.
+ */
+export declare function createSyncRequest(playerId: PlayerId, desyncTick: Tick, localHash: number): Message;
+/**
+ * Create a DisconnectReport message.
+ */
+export declare function createDisconnectReport(disconnectedPeerId: PlayerId): Message;
+/**
+ * Create a LagReport message.
+ */
+export declare function createLagReport(laggyPlayerId: PlayerId, ticksBehind: number): Message;
+/**
+ * Create a JoinReject message.
+ */
+export declare function createJoinReject(playerId: PlayerId, reason: string): Message;
+/**
+ * Create a JoinAccept message.
+ */
+export declare function createJoinAccept(playerId: PlayerId, roomId: string, config: {
+    tickRate: number;
+    maxPlayers: number;
+}, players: PlayerId[]): Message;
+/**
+ * Create a PlayerJoined message.
+ */
+export declare function createPlayerJoined(playerId: PlayerId, role: PlayerRole, joinTick: Tick): Message;
+/**
+ * Create a Ping message.
+ */
+export declare function createPing(timestamp: number): Message;
+/**
+ * Create a Pong message.
+ */
+export declare function createPong(timestamp: number): Message;
+/**
+ * Create an Input message.
+ */
+export declare function createInput(playerId: PlayerId, inputs: Array<{
+    tick: Tick;
+    input: Uint8Array;
+}>): Message;
+/**
+ * Create a Hash message.
+ */
+export declare function createHash(playerId: PlayerId, tick: Tick, hash: number): Message;
+/**
+ * Create a StateSync message for late-joining players.
+ */
+export declare function createStateSync(tick: Tick, state: Uint8Array, hash: number, playerTimeline: PlayerTimeline): Message;
+/**
+ * Create a DropPlayer message.
+ */
+export declare function createDropPlayer(playerId: PlayerId, metadata?: Uint8Array): Message;
+//# sourceMappingURL=message-builders.d.ts.map

package/dist/session/message-builders.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builders.d.ts","sourceRoot":"","sources":["../../src/session/message-builders.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,yBAAyB,CAAC;AAEvD,OAAO,KAAK,EACX,WAAW,EACX,QAAQ,EACR,UAAU,EACV,cAAc,EACd,IAAI,EACJ,MAAM,aAAa,CAAC;AAErB;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,UAAU,GACd,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,IAAI,GAAG,OAAO,CAM7E;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,GAC5B,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,QAAQ,EAClB,SAAS,EAAE,IAAI,EACf,MAAM,EAAE,WAAW,GACjB,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,QAAQ,EAAE,UAAU,EAAE,IAAI,GAAG,OAAO,CAM1E;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAKvE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAChC,QAAQ,EAAE,QAAQ,EAClB,UAAU,EAAE,IAAI,EAChB,SAAS,EAAE,MAAM,GACf,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,kBAAkB,EAAE,QAAQ,GAAG,OAAO,CAK5E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,aAAa,EAAE,QAAQ,EACvB,WAAW,EAAE,MAAM,GACjB,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAM5E;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,EAChD,OAAO,EAAE,QAAQ,EAAE,GACjB,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,UAAU,EAChB,QAAQ,EAAE,IAAI,GACZ,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKrD;AAED;;GAEG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAKrD;AAED;;GAEG;AACH,wBAAgB,WAAW,CAC1B,QAAQ,EAAE,QAAQ,EAClB,MAAM,EAAE,KAAK,CAAC;IAAE,IAAI,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,UAAU,CAAA;CAAE,CAAC,GAC9C,OAAO,CAMT;AAED;;GAEG;AACH,wBAAgB,UAAU,CACzB,QAAQ,EAAE,QAAQ,EAClB,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,GACV,OAAO,CAOT;AAED;;GAEG;AACH,wBAAgB,eAAe,CAC9B,IAAI,EAAE,IAAI,EACV,KAAK,EAAE,UAAU,EACjB,IAAI,EAAE,MAAM,EACZ,cAAc,EAAE,cAAc,GAC5B,OAAO,CAQT;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC/B,QAAQ,EAAE,QAAQ,EAClB,QAAQ,CAAC,EAAE,UAAU,GACnB,OAAO,CAYT"}

package/dist/session/message-builders.js

@@ -0,0 +1,199 @@
+/**
+ * Factory functions for creating protocol messages.
+ *
+ * Centralizes message construction to reduce duplication in Session.ts.
+ */
+import { MessageType } from "../protocol/messages.js";
+/**
+ * Create a JoinRequest message.
+ */
+export function createJoinRequest(playerId, role) {
+    return {
+        type: MessageType.JoinRequest,
+        playerId,
+        role,
+    };
+}
+/**
+ * Create a PlayerLeft message.
+ */
+export function createPlayerLeft(playerId, leaveTick) {
+    return {
+        type: MessageType.PlayerLeft,
+        playerId,
+        leaveTick,
+    };
+}
+/**
+ * Create a Sync message for state synchronization.
+ */
+export function createSync(tick, state, hash, playerTimeline) {
+    return {
+        type: MessageType.Sync,
+        tick,
+        state,
+        hash,
+        playerTimeline,
+    };
+}
+/**
+ * Create a Pause message.
+ */
+export function createPause(playerId, pauseTick, reason) {
+    return {
+        type: MessageType.Pause,
+        playerId,
+        pauseTick,
+        reason,
+    };
+}
+/**
+ * Create a Resume message.
+ */
+export function createResume(playerId, resumeTick) {
+    return {
+        type: MessageType.Resume,
+        playerId,
+        resumeTick,
+    };
+}
+/**
+ * Create a ResumeCountdown message.
+ */
+export function createResumeCountdown(secondsRemaining) {
+    return {
+        type: MessageType.ResumeCountdown,
+        secondsRemaining,
+    };
+}
+/**
+ * Create a SyncRequest message.
+ */
+export function createSyncRequest(playerId, desyncTick, localHash) {
+    return {
+        type: MessageType.SyncRequest,
+        playerId,
+        desyncTick,
+        localHash,
+    };
+}
+/**
+ * Create a DisconnectReport message.
+ */
+export function createDisconnectReport(disconnectedPeerId) {
+    return {
+        type: MessageType.DisconnectReport,
+        disconnectedPeerId,
+    };
+}
+/**
+ * Create a LagReport message.
+ */
+export function createLagReport(laggyPlayerId, ticksBehind) {
+    return {
+        type: MessageType.LagReport,
+        laggyPlayerId,
+        ticksBehind,
+    };
+}
+/**
+ * Create a JoinReject message.
+ */
+export function createJoinReject(playerId, reason) {
+    return {
+        type: MessageType.JoinReject,
+        playerId,
+        reason,
+    };
+}
+/**
+ * Create a JoinAccept message.
+ */
+export function createJoinAccept(playerId, roomId, config, players) {
+    return {
+        type: MessageType.JoinAccept,
+        playerId,
+        roomId,
+        config,
+        players,
+    };
+}
+/**
+ * Create a PlayerJoined message.
+ */
+export function createPlayerJoined(playerId, role, joinTick) {
+    return {
+        type: MessageType.PlayerJoined,
+        playerId,
+        role,
+        joinTick,
+    };
+}
+/**
+ * Create a Ping message.
+ */
+export function createPing(timestamp) {
+    return {
+        type: MessageType.Ping,
+        timestamp,
+    };
+}
+/**
+ * Create a Pong message.
+ */
+export function createPong(timestamp) {
+    return {
+        type: MessageType.Pong,
+        timestamp,
+    };
+}
+/**
+ * Create an Input message.
+ */
+export function createInput(playerId, inputs) {
+    return {
+        type: MessageType.Input,
+        playerId,
+        inputs,
+    };
+}
+/**
+ * Create a Hash message.
+ */
+export function createHash(playerId, tick, hash) {
+    return {
+        type: MessageType.Hash,
+        playerId,
+        tick,
+        hash,
+    };
+}
+/**
+ * Create a StateSync message for late-joining players.
+ */
+export function createStateSync(tick, state, hash, playerTimeline) {
+    return {
+        type: MessageType.StateSync,
+        tick,
+        state,
+        hash,
+        playerTimeline,
+    };
+}
+/**
+ * Create a DropPlayer message.
+ */
+export function createDropPlayer(playerId, metadata) {
+    if (metadata !== undefined) {
+        return {
+            type: MessageType.DropPlayer,
+            playerId,
+            metadata,
+        };
+    }
+    return {
+        type: MessageType.DropPlayer,
+        playerId,
+    };
+}
+//# sourceMappingURL=message-builders.js.map

package/dist/session/message-builders.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-builders.js","sourceRoot":"","sources":["../../src/session/message-builders.ts"],"names":[],"mappings":"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"}

package/dist/session/message-router.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Message routing for session communication.
+ *
+ * Decodes incoming messages and routes them to the appropriate handlers.
+ */
+import { type DisconnectReportMessage, type DropPlayerMessage, type HashMessage, type InputMessage, type JoinAcceptMessage, type JoinRejectMessage, type JoinRequestMessage, type LagReportMessage, type Message, type PauseMessage, type PingMessage, type PlayerJoinedMessage, type PlayerLeftMessage, type PongMessage, type ResumeCountdownMessage, type ResumeMessage, type StateSyncMessage, type SyncMessage, type SyncRequestMessage } from "../protocol/messages.js";
+/**
+ * Handler callbacks for each message type.
+ *
+ * Each handler receives the decoded message and the peer ID of the sender.
+ */
+export interface MessageHandlers {
+    onInput?: (msg: InputMessage, peerId: string) => void;
+    onHash?: (msg: HashMessage, peerId: string) => void;
+    onSync?: (msg: SyncMessage | StateSyncMessage, peerId: string) => void;
+    onSyncRequest?: (msg: SyncRequestMessage, peerId: string) => void;
+    onJoinRequest?: (msg: JoinRequestMessage, peerId: string) => void;
+    onJoinAccept?: (msg: JoinAcceptMessage, peerId: string) => void;
+    onJoinReject?: (msg: JoinRejectMessage, peerId: string) => void;
+    onPlayerJoined?: (msg: PlayerJoinedMessage, peerId: string) => void;
+    onPlayerLeft?: (msg: PlayerLeftMessage, peerId: string) => void;
+    onPause?: (msg: PauseMessage, peerId: string) => void;
+    onResume?: (msg: ResumeMessage, peerId: string) => void;
+    onPing?: (msg: PingMessage, peerId: string) => void;
+    onPong?: (msg: PongMessage, peerId: string) => void;
+    onDisconnectReport?: (msg: DisconnectReportMessage, peerId: string) => void;
+    onLagReport?: (msg: LagReportMessage, peerId: string) => void;
+    onResumeCountdown?: (msg: ResumeCountdownMessage, peerId: string) => void;
+    onDropPlayer?: (msg: DropPlayerMessage, peerId: string) => void;
+}
+/**
+ * Error handler callback.
+ */
+export type DecodeErrorHandler = (error: Error, peerId: string, dataLength: number) => void;
+/**
+ * Routes decoded messages to their appropriate handlers.
+ *
+ * Centralizes message dispatch logic and error handling for decode failures.
+ */
+export declare class MessageRouter {
+    private readonly handlers;
+    private readonly onDecodeError;
+    constructor(handlers: MessageHandlers, onDecodeError: DecodeErrorHandler);
+    /**
+     * Route a raw message from a peer.
+     *
+     * Decodes the message and dispatches to the appropriate handler.
+     *
+     * @param peerId - The peer ID of the sender
+     * @param data - The raw message bytes
+     */
+    route(peerId: string, data: Uint8Array): void;
+    /**
+     * Dispatch a decoded message to the appropriate handler.
+     *
+     * @param message - The decoded message
+     * @param peerId - The peer ID of the sender
+     */
+    dispatch(message: Message, peerId: string): void;
+}
+//# sourceMappingURL=message-router.d.ts.map

package/dist/session/message-router.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.d.ts","sourceRoot":"","sources":["../../src/session/message-router.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EACN,KAAK,uBAAuB,EAC5B,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,YAAY,EACjB,KAAK,iBAAiB,EACtB,KAAK,iBAAiB,EACtB,KAAK,kBAAkB,EACvB,KAAK,gBAAgB,EACrB,KAAK,OAAO,EAEZ,KAAK,YAAY,EACjB,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACxB,KAAK,iBAAiB,EACtB,KAAK,WAAW,EAChB,KAAK,sBAAsB,EAC3B,KAAK,aAAa,EAClB,KAAK,gBAAgB,EACrB,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACvB,MAAM,yBAAyB,CAAC;AAEjC;;;;GAIG;AACH,MAAM,WAAW,eAAe;IAC/B,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,GAAG,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACvE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAClE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,cAAc,CAAC,EAAE,CAAC,GAAG,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpE,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAChE,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,YAAY,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACtD,QAAQ,CAAC,EAAE,CAAC,GAAG,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACxD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,MAAM,CAAC,EAAE,CAAC,GAAG,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IACpD,kBAAkB,CAAC,EAAE,CAAC,GAAG,EAAE,uBAAuB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC5E,WAAW,CAAC,EAAE,CAAC,GAAG,EAAE,gBAAgB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC9D,iBAAiB,CAAC,EAAE,CAAC,GAAG,EAAE,sBAAsB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC1E,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,iBAAiB,EAAE,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CAChE;AAED;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAAG,CAChC,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,MAAM,EACd,UAAU,EAAE,MAAM,KACd,IAAI,CAAC;AAEV;;;;GAIG;AACH,qBAAa,aAAa;IACzB,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkB;IAC3C,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAqB;gBAEvC,QAAQ,EAAE,eAAe,EAAE,aAAa,EAAE,kBAAkB;IAKxE;;;;;;;OAOG;IACH,KAAK,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IAgB7C;;;;;OAKG;IACH,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,GAAG,IAAI;CA4EhD"}

package/dist/session/message-router.js

@@ -0,0 +1,105 @@
+/**
+ * Message routing for session communication.
+ *
+ * Decodes incoming messages and routes them to the appropriate handlers.
+ */
+import { decodeMessage } from "../protocol/encoding.js";
+import { MessageType, } from "../protocol/messages.js";
+/**
+ * Routes decoded messages to their appropriate handlers.
+ *
+ * Centralizes message dispatch logic and error handling for decode failures.
+ */
+export class MessageRouter {
+    handlers;
+    onDecodeError;
+    constructor(handlers, onDecodeError) {
+        this.handlers = handlers;
+        this.onDecodeError = onDecodeError;
+    }
+    /**
+     * Route a raw message from a peer.
+     *
+     * Decodes the message and dispatches to the appropriate handler.
+     *
+     * @param peerId - The peer ID of the sender
+     * @param data - The raw message bytes
+     */
+    route(peerId, data) {
+        let message;
+        try {
+            message = decodeMessage(data);
+        }
+        catch (error) {
+            this.onDecodeError(error instanceof Error ? error : new Error(String(error)), peerId, data.length);
+            return;
+        }
+        this.dispatch(message, peerId);
+    }
+    /**
+     * Dispatch a decoded message to the appropriate handler.
+     *
+     * @param message - The decoded message
+     * @param peerId - The peer ID of the sender
+     */
+    dispatch(message, peerId) {
+        switch (message.type) {
+            case MessageType.Input:
+                this.handlers.onInput?.(message, peerId);
+                break;
+            case MessageType.Hash:
+                this.handlers.onHash?.(message, peerId);
+                break;
+            case MessageType.Sync:
+            case MessageType.StateSync:
+                this.handlers.onSync?.(message, peerId);
+                break;
+            case MessageType.SyncRequest:
+                this.handlers.onSyncRequest?.(message, peerId);
+                break;
+            case MessageType.JoinRequest:
+                this.handlers.onJoinRequest?.(message, peerId);
+                break;
+            case MessageType.JoinAccept:
+                this.handlers.onJoinAccept?.(message, peerId);
+                break;
+            case MessageType.JoinReject:
+                this.handlers.onJoinReject?.(message, peerId);
+                break;
+            case MessageType.PlayerJoined:
+                this.handlers.onPlayerJoined?.(message, peerId);
+                break;
+            case MessageType.PlayerLeft:
+                this.handlers.onPlayerLeft?.(message, peerId);
+                break;
+            case MessageType.Pause:
+                this.handlers.onPause?.(message, peerId);
+                break;
+            case MessageType.Resume:
+                this.handlers.onResume?.(message, peerId);
+                break;
+            case MessageType.Ping:
+                this.handlers.onPing?.(message, peerId);
+                break;
+            case MessageType.Pong:
+                this.handlers.onPong?.(message, peerId);
+                break;
+            case MessageType.DisconnectReport:
+                this.handlers.onDisconnectReport?.(message, peerId);
+                break;
+            case MessageType.LagReport:
+                this.handlers.onLagReport?.(message, peerId);
+                break;
+            case MessageType.ResumeCountdown:
+                this.handlers.onResumeCountdown?.(message, peerId);
+                break;
+            case MessageType.DropPlayer:
+                this.handlers.onDropPlayer?.(message, peerId);
+                break;
+            // InputAck is not currently handled by Session
+            case MessageType.InputAck:
+                break;
+        }
+    }
+}
+//# sourceMappingURL=message-router.js.map

package/dist/session/message-router.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-router.js","sourceRoot":"","sources":["../../src/session/message-router.ts"],"names":[],"mappings":"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"}

package/dist/session/player-manager.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Player state management for sessions.
+ */
+import { type PlayerId, type PlayerInfo, type Tick } from "../types.js";
+/**
+ * Manages player state within a session.
+ *
+ * Centralizes player tracking, connection state, and lifecycle operations.
+ */
+export declare class PlayerManager implements Iterable<PlayerInfo> {
+    private readonly players;
+    /**
+     * Add a new player to the session.
+     *
+     * @param info - The player info to add
+     */
+    addPlayer(info: PlayerInfo): void;
+    /**
+     * Remove a player from the session.
+     *
+     * @param playerId - The player ID to remove
+     * @returns The removed player info, or undefined if not found
+     */
+    removePlayer(playerId: PlayerId): PlayerInfo | undefined;
+    /**
+     * Get a player by ID.
+     *
+     * @param playerId - The player ID to look up
+     * @returns The player info, or undefined if not found
+     */
+    getPlayer(playerId: PlayerId): PlayerInfo | undefined;
+    /**
+     * Check if a player exists.
+     *
+     * @param playerId - The player ID to check
+     */
+    hasPlayer(playerId: PlayerId): boolean;
+    /**
+     * Mark a player as disconnected.
+     *
+     * @param playerId - The player ID to mark
+     * @param leaveTick - The tick when they disconnected (optional)
+     * @returns The updated player info, or undefined if not found
+     */
+    markDisconnected(playerId: PlayerId, leaveTick?: Tick): PlayerInfo | undefined;
+    /**
+     * Mark a player as connected.
+     *
+     * @param playerId - The player ID to mark
+     * @returns The updated player info, or undefined if not found
+     */
+    markConnected(playerId: PlayerId): PlayerInfo | undefined;
+    /**
+     * Get all players that are currently active (connected and role is Player).
+     *
+     * @returns Array of active player infos
+     */
+    getActivePlayers(): PlayerInfo[];
+    /**
+     * Get all connected players (any role).
+     *
+     * @returns Array of connected player infos
+     */
+    getConnectedPlayers(): PlayerInfo[];
+    /**
+     * Get the count of active players.
+     */
+    getActivePlayerCount(): number;
+    /**
+     * Find the host player.
+     *
+     * @returns The host player info, or undefined if no host
+     */
+    findHost(): PlayerInfo | undefined;
+    /**
+     * Get all player IDs.
+     */
+    getPlayerIds(): PlayerId[];
+    /**
+     * Get all player infos as an array.
+     */
+    getAllPlayers(): PlayerInfo[];
+    /**
+     * Clear all players.
+     */
+    clear(): void;
+    /**
+     * Number of players in the session.
+     */
+    get size(): number;
+    /**
+     * Iterate over all players.
+     */
+    [Symbol.iterator](): Iterator<PlayerInfo>;
+    /**
+     * Get players as a readonly map (for compatibility with existing code).
+     */
+    asReadonlyMap(): ReadonlyMap<PlayerId, PlayerInfo>;
+}
+//# sourceMappingURL=player-manager.d.ts.map

package/dist/session/player-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"player-manager.d.ts","sourceRoot":"","sources":["../../src/session/player-manager.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAEN,KAAK,QAAQ,EACb,KAAK,UAAU,EAEf,KAAK,IAAI,EACT,MAAM,aAAa,CAAC;AAErB;;;;GAIG;AACH,qBAAa,aAAc,YAAW,QAAQ,CAAC,UAAU,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAwC;IAEhE;;;;OAIG;IACH,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIjC;;;;;OAKG;IACH,YAAY,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;IAQxD;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;IAIrD;;;;OAIG;IACH,SAAS,CAAC,QAAQ,EAAE,QAAQ,GAAG,OAAO;IAItC;;;;;;OAMG;IACH,gBAAgB,CACf,QAAQ,EAAE,QAAQ,EAClB,SAAS,CAAC,EAAE,IAAI,GACd,UAAU,GAAG,SAAS;IAWzB;;;;;OAKG;IACH,aAAa,CAAC,QAAQ,EAAE,QAAQ,GAAG,UAAU,GAAG,SAAS;IAQzD;;;;OAIG;IACH,gBAAgB,IAAI,UAAU,EAAE;IAQhC;;;;OAIG;IACH,mBAAmB,IAAI,UAAU,EAAE;IAMnC;;OAEG;IACH,oBAAoB,IAAI,MAAM;IAa9B;;;;OAIG;IACH,QAAQ,IAAI,UAAU,GAAG,SAAS;IASlC;;OAEG;IACH,YAAY,IAAI,QAAQ,EAAE;IAI1B;;OAEG;IACH,aAAa,IAAI,UAAU,EAAE;IAI7B;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb;;OAEG;IACH,IAAI,IAAI,IAAI,MAAM,CAEjB;IAED;;OAEG;IACH,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,UAAU,CAAC;IAIzC;;OAEG;IACH,aAAa,IAAI,WAAW,CAAC,QAAQ,EAAE,UAAU,CAAC;CAGlD"}