@bazimazi/partyframe-server 0.1.0

package/README.md

@@ -0,0 +1,9 @@
+# @bazimazi/partyframe-server
+
+Server package: Colyseus session room, `defineGame`, and `listen()`.
+
+```ts
+import { defineGame, listen } from "@bazimazi/partyframe-server";
+
+await listen({ defaultGameId: "tap", games: [tapAdapter] });
+```

package/dist/PartySessionRoom.d.ts

@@ -0,0 +1,143 @@
+/**
+ * The one room type the platform needs.
+ *
+ * A `PartySessionRoom` owns a `GameSession`: its public code, its lobby, its
+ * players (human and bot), its lifecycle and its authoritative clock. The game
+ * being played is a plugin resolved at creation time, so this file contains no
+ * Bomb Party logic whatsoever - swapping in a different game changes only which
+ * adapter is looked up.
+ *
+ * Authority model, in one sentence: clients send *intentions*, this room decides
+ * what actually happened, and the resulting state is what everyone renders.
+ */
+import { Room, type Client } from "@colyseus/core";
+import { type ClientRole, type SessionStatus } from "@partyframe/protocol";
+import { SessionSchema } from "./sessionSchema.js";
+/** Options the matchmaker passes when a shared screen creates a session. */
+export interface RoomCreateOptions {
+    gameId?: string;
+    /** Fixed seed, used only by tests to make a whole match reproducible. */
+    seed?: number;
+}
+/** Metadata published to the matchmaker, used by the `/api/rooms/:code` lookup. */
+export interface RoomMetadata {
+    publicCode: string;
+    gameId: string;
+    status: SessionStatus;
+    playerCount: number;
+    maxPlayers: number;
+}
+interface ClientData {
+    role: ClientRole;
+    joinedAt: number;
+}
+export declare class PartySessionRoom extends Room<SessionSchema, RoomMetadata> {
+    maxClients: number;
+    private adapter;
+    private gameState;
+    private gameOptions;
+    private rng;
+    private registry;
+    /** Presentation cues queued by the game during the current tick. */
+    private eventQueue;
+    /** Status the game asked for during the current tick, applied once at the end. */
+    private requestedStatus;
+    /** Bot strategies, one per difficulty, shared by every bot at that level. */
+    private botStrategies;
+    /** A bot's chosen action and the time it should be submitted. */
+    private botPending;
+    private readonly gameLimiter;
+    private readonly sessionLimiter;
+    private readonly clockLimiter;
+    private createdAt;
+    private lastConnectedAt;
+    private lastBeaconAt;
+    private nextSeat;
+    private controllerRevision;
+    /** Last envelope sent to each controller, so unchanged state is not resent. */
+    private lastControllerJson;
+    private logger;
+    onCreate(options: RoomCreateOptions): Promise<void>;
+    onAuth(_client: Client, rawOptions: unknown): ClientData;
+    onJoin(client: Client, _options: unknown, auth: ClientData): void;
+    onLeave(client: Client, consented: boolean): Promise<void>;
+    onDispose(): void;
+    /** Creates or revives the row for a controller's seat. */
+    private ensurePlayerRow;
+    private pickFreeColor;
+    private pickFreeAvatar;
+    private removePlayer;
+    /** The longest-seated joined human becomes host when the previous one leaves. */
+    private electHostPlayer;
+    /** Players the game rules operate on: everyone who has completed joining. */
+    private gamePlayers;
+    private createRegistry;
+    /** Adds or removes bots so the roster matches `settings.botCount`. */
+    private reconcileBots;
+    private botStrategy;
+    /**
+     * Drives every bot through the human action path.
+     *
+     * A bot never mutates game state directly: it produces the same payload a
+     * phone would send, and that payload goes through the same validation and the
+     * same `handleAction` call.
+     */
+    private tickBots;
+    private registerMessageHandlers;
+    /**
+     * Rejects payloads that are too large before any parsing work happens.
+     *
+     * Colyseus has already decoded the message by this point, so this is a guard
+     * against a client wasting the rules engine's time, not a transport-level
+     * defence - the transport's own frame limit handles that.
+     */
+    private checkPayload;
+    private handleSessionAction;
+    private applySettings;
+    private startGame;
+    private returnToLobby;
+    private setStatus;
+    /**
+     * Applies a status the game asked for, filtered by what the platform allows.
+     *
+     * The game may move between playing states, but it may not put the session
+     * back into the lobby or close it - those are platform decisions.
+     */
+    private applyRequestedStatus;
+    private buildContext;
+    /** Runs one validated action through the rules and settles the resulting tick. */
+    private applyGameAction;
+    private notifyGameOfPlayer;
+    /** Broadcasts queued events, applies status requests and republishes state. */
+    private finishTick;
+    private projectGameState;
+    private flushEvents;
+    private emitPlatformEvent;
+    private controllerMode;
+    private buildEnvelope;
+    /** Sends a controller its projection, skipping sends that would change nothing. */
+    private pushControllerState;
+    private pushAllControllerStates;
+    private sendWelcome;
+    private sendError;
+    private tick;
+    /**
+     * Reclaims sessions nobody is using.
+     *
+     * Two independent limits: an idle timeout that starts when the last client
+     * leaves, and an absolute age cap so a forgotten room on a TV in an empty
+     * office cannot live forever.
+     */
+    private checkExpiry;
+    private publishMetadata;
+    /**
+     * Developer-mode shortcuts.
+     *
+     * Reachable only when `ENABLE_DEV_TOOLS` is on *and* the build is not
+     * production, checked again at the call site. Platform commands are handled
+     * here; anything else is delegated to the game plugin.
+     */
+    private runDevCommand;
+}
+export {};
+//# sourceMappingURL=PartySessionRoom.d.ts.map

package/dist/PartySessionRoom.d.ts.map

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