@v12-engine/engine 0.1.1 → 0.4.0

package/dist/server/rooms.d.ts

@@ -24,7 +24,11 @@ export interface RoomKind {
      */
     room: RoomOptions | ((settings: Record<string, string>) => RoomOptions);
 }
-/** @beta */
+/**
+ * What `GameRooms` is started with: the shared port, the rooms, the kinds players may make and matchmaking
+ *
+ * @beta
+ */
 export interface GameRoomsOptions {
     /** The port they share: 8787 when left out, 0 for any free one */
     port?: number;
@@ -51,8 +55,11 @@ export interface GameRoomsOptions {
     matchmaking?: boolean | {
         path?: string;
     };
+    /** Whether to compress what goes over connections whose other end can take it; as `SocketServerOptions.compress` */
     compress?: boolean;
+    /** Seconds a connection may be silent before it is closed; as `SocketServerOptions.idleTimeout` */
     idleTimeout?: number;
+    /** Bytes that may wait unsent on a connection before it is closed; as `SocketServerOptions.maxBuffered` */
     maxBuffered?: number;
     /**
      * Connections open at once to all the rooms and the queue, at most (`SocketServerOptions.maxConnections`). 1024 when
@@ -82,7 +89,7 @@ export interface GameRoomsOptions {
  * and closed. Rooms are added in code (`add`), or made by players of the kinds it offers (`kinds`, `POST /games`) and
  * closed once empty
  *
- * @beta
+ * @public
  */
 export declare class GameRooms {
     private readonly socket;

package/dist/server/rooms.js

@@ -0,0 +1,442 @@
+import { serverLogger } from "./log.js";
+import { answerOps } from "./ops.js";
+import { startSocketServer } from "./websocket.js";
+import { GameServer } from "./gameServer.js";
+//#region src/server/rooms.ts
+/** What a room is reached at: the first part of the address a connection asked for */
+var roomOf = (url) => new URL(url, "ws://server").pathname.split("/")[1] ?? "";
+/** A name for a room: letters, digits, `-` and `_` */
+var isRoomName = (name) => /^[\w-]+$/.test(name);
+/** What an address that asked for games too often is told */
+var TOO_OFTEN = "too many games asked for: wait a minute";
+/** The most a body of a request to make a room may be: a kind and a few settings */
+var MAX_BODY = 4096;
+/**
+* Where a room's game server gets its connections (`ConnectionSource`): those the shared port hands it for the room's
+* name. Its server is told of a connection closing after the room has let go of it, and its `close` closes those in
+* the room, never the port
+*/
+var RoomConnections = class {
+	port;
+	handler = () => {};
+	open = /* @__PURE__ */ new Set();
+	constructor(port) {
+		this.port = port;
+	}
+	onConnection(handler) {
+		this.handler = handler;
+	}
+	/** A connection to the room, handed to its server */
+	hand(connection) {
+		let closed = () => {};
+		const theirs = {
+			get url() {
+				return connection.url;
+			},
+			get address() {
+				return connection.address;
+			},
+			get bytesSent() {
+				return connection.bytesSent;
+			},
+			get compressed() {
+				return connection.compressed;
+			},
+			send: (message) => connection.send(message),
+			onMessage: (next) => connection.onMessage(next),
+			onClose: (next) => void (closed = next),
+			close: () => connection.close()
+		};
+		this.open.add(theirs);
+		connection.onClose(() => {
+			this.open.delete(theirs);
+			closed();
+		});
+		this.handler(theirs);
+	}
+	async close() {
+		for (const connection of [...this.open]) connection.close();
+	}
+};
+/**
+* Many games in a process (S58): game servers that share a port, each a room reached at its name, as a server of its
+* own would be at its port. One process, one thread: each room's games step in turn, so the rooms of a process are as
+* many as its ticks have time for (`/metrics` says how long they take). A connection to a room there is not is told so
+* and closed. Rooms are added in code (`add`), or made by players of the kinds it offers (`kinds`, `POST /games`) and
+* closed once empty
+*
+* @public
+*/
+var GameRooms = class GameRooms {
+	socket;
+	options;
+	logger;
+	servers = /* @__PURE__ */ new Map();
+	/** Where each room's connections come from, by its name */
+	doors = /* @__PURE__ */ new Map();
+	/** The rooms players made, and since when each has been empty (nobody connected): what closes them */
+	made = /* @__PURE__ */ new Map();
+	/** When each address last asked for rooms (`POST /games`): a few a minute each */
+	askedBy = /* @__PURE__ */ new Map();
+	sweeper;
+	nextMade = 1;
+	/** Who waits to be matched, by kind, in the order they came */
+	queues = /* @__PURE__ */ new Map();
+	constructor(socket, options, logger) {
+		this.socket = socket;
+		this.options = options;
+		this.logger = logger;
+	}
+	/** The rooms there are now, by name */
+	get rooms() {
+		return this.servers;
+	}
+	/** Starts the rooms, and resolves once they listen */
+	static async start(options) {
+		for (const name of Object.keys(options.rooms)) if (!isRoomName(name)) throw new Error(`GameRooms: "${name}" is no name for a room: letters, digits, - and _`);
+		const logger = serverLogger(options.log);
+		let rooms;
+		const socket = await startSocketServer({
+			port: options.port ?? 8787,
+			compress: options.compress,
+			idleTimeout: options.idleTimeout,
+			maxBuffered: options.maxBuffered,
+			maxConnections: options.maxConnections,
+			log: logger,
+			onRequest: (request, response) => {
+				if (!rooms) return;
+				if (rooms.answerMake(request, response)) return;
+				if (answerOps(request, response, options.http, () => ({
+					draining: rooms.draining,
+					rooms: rooms.metrics()
+				}), () => ({
+					games: rooms.listing(),
+					kinds: rooms.kinds()
+				}), {
+					ratings: options.ratings,
+					modes: rooms.modes()
+				})) return;
+				response.writeHead(426, { "content-type": "text/plain" });
+				response.end(`Game rooms: connect with a WebSocket to one of ${[...rooms.servers.keys()].join(", ")}\n`);
+			}
+		});
+		rooms = new GameRooms(socket, options, logger);
+		socket.onConnection((connection) => rooms.connect(connection));
+		try {
+			for (const [name, room] of Object.entries(options.rooms)) await rooms.add(name, room);
+		} catch (error) {
+			await rooms.close();
+			throw error;
+		}
+		if (options.kinds && Object.keys(options.kinds).length) rooms.sweeper = setInterval(() => void rooms.sweep(), 1e3);
+		return rooms;
+	}
+	/** A kind it offers, by id: its own, never what every object has (`constructor`), whatever a page sends */
+	kind(id) {
+		const { kinds } = this.options;
+		return kinds && Object.hasOwn(kinds, id) ? kinds[id] : void 0;
+	}
+	/** The address of the queue, or none where there is no matchmaking */
+	get queuePath() {
+		const { matchmaking, kinds } = this.options;
+		if (matchmaking === false || !kinds || !Object.keys(kinds).length) return void 0;
+		return typeof matchmaking === "object" && matchmaking.path || "queue";
+	}
+	/** A connection to a room: handed to its game server, or told there is no such room. The queue's, to the queue */
+	connect(connection) {
+		const name = roomOf(connection.url);
+		if (name === this.queuePath) return this.waitInQueue(connection);
+		const door = this.doors.get(name);
+		if (!door) {
+			connection.send(JSON.stringify({
+				type: "refused",
+				reason: `there is no room "${name}"`
+			}));
+			return connection.close();
+		}
+		door.hand(connection);
+	}
+	/** Opens a room at a name, as `rooms` does: in code, while the rooms run */
+	async add(name, room) {
+		if (!isRoomName(name)) throw new Error(`GameRooms: "${name}" is no name for a room: letters, digits, - and _`);
+		if (this.servers.has(name)) throw new Error(`GameRooms: there is a room "${name}" already`);
+		const door = new RoomConnections(this.socket.port);
+		this.doors.set(name, door);
+		const server = await GameServer.attach(door, {
+			...room,
+			ratings: room.ratings ?? this.options.ratings,
+			log: this.logger.child({ context: () => ({ fields: { room: name } }) })
+		});
+		this.servers.set(name, server);
+		return server;
+	}
+	/** Closes a room and lets go of its name: those in it are let go */
+	async remove(name) {
+		const server = this.servers.get(name);
+		if (!server) return;
+		this.servers.delete(name);
+		this.made.delete(name);
+		await server.close();
+		this.doors.delete(name);
+	}
+	/**
+	* Makes a room of a kind it offers (`kinds`), with the settings asked for: what `POST /games` does. Its name is the
+	* kind's and a number. Refused (with why) for a kind it does not offer, too many made, or while it stops
+	*/
+	async make(kind, settings = {}, seat) {
+		const offered = this.kind(kind);
+		if (!offered) return { refused: `there is no kind of game "${kind}"` };
+		if (this.draining) return { refused: "the server is stopping: it takes no new games" };
+		if (this.made.size >= (this.options.maxMade ?? 16)) return { refused: "there are as many games as there may be: join one" };
+		let name = `${kind}-${this.nextMade++}`;
+		while (this.servers.has(name)) name = `${kind}-${this.nextMade++}`;
+		this.made.set(name, {
+			kind,
+			emptySince: Date.now(),
+			joined: false,
+			matched: !!seat
+		});
+		try {
+			const room = typeof offered.room === "function" ? offered.room(settings) : offered.room;
+			await this.add(name, {
+				...room,
+				settings: {
+					...room.settings,
+					...settings
+				},
+				...seat && { seat }
+			});
+		} catch (error) {
+			this.made.delete(name);
+			throw error;
+		}
+		this.logger.info("server", `made the room ${name} (${offered.name})`);
+		return { room: name };
+	}
+	/** A room a kind makes, as its listing and matchmaking read it: the one it makes, or one it made once (a kind of a function) */
+	samples = /* @__PURE__ */ new Map();
+	sampleOf(kind) {
+		const { room } = this.kind(kind);
+		if (typeof room !== "function") return room;
+		let sample = this.samples.get(kind);
+		if (!sample) this.samples.set(kind, sample = room({}));
+		return sample;
+	}
+	/** How many of a kind's seats are for players: those the computer does not play */
+	seatsFor(kind) {
+		const room = this.sampleOf(kind);
+		return room.mode.seats.filter((seat) => !room.ai?.includes(seat.player)).length;
+	}
+	/** A connection to the queue: it says the kind it waits for, is told how many wait, and its ticket once matched */
+	waitInQueue(connection) {
+		let waitingFor;
+		const leave = () => {
+			if (!waitingFor) return;
+			const queue = this.queues.get(waitingFor) ?? [];
+			const at = queue.findIndex((each) => each.connection === connection);
+			if (at >= 0) queue.splice(at, 1);
+			this.tellQueue(waitingFor);
+			waitingFor = void 0;
+		};
+		const within = this.options.joinWithin ?? 10;
+		const deadline = Number.isFinite(within) ? setTimeout(() => !waitingFor && connection.close(), Math.max(0, within) * 1e3) : void 0;
+		deadline?.unref?.();
+		connection.onClose(() => {
+			clearTimeout(deadline);
+			leave();
+		});
+		connection.onMessage((text) => {
+			let message;
+			try {
+				message = JSON.parse(text);
+			} catch {
+				return;
+			}
+			if (message.type === "leave") return leave();
+			if (message.type !== "queue") return;
+			const kind = String(message.kind ?? "");
+			if (!this.kind(kind)) return connection.send(JSON.stringify({
+				type: "refused",
+				reason: `there is no kind of game "${kind}"`
+			}));
+			if (this.askedTooOften(connection.address)) return connection.send(JSON.stringify({
+				type: "refused",
+				reason: TOO_OFTEN
+			}));
+			clearTimeout(deadline);
+			leave();
+			waitingFor = kind;
+			const queue = this.queues.get(kind) ?? [];
+			this.queues.set(kind, queue);
+			queue.push({
+				connection,
+				...typeof message.name === "string" && { name: message.name.slice(0, 24) }
+			});
+			this.match(kind).catch((error) => this.logger.error("server", "matchmaking failed", { error: String(error) }));
+		});
+	}
+	/**
+	* Whether an address has asked for games too often to ask again now: a few a minute each, made (`POST /games`) or
+	* waited for in the queue, so that nobody fills every place there is by asking over and over. Counted when it has not
+	*/
+	askedTooOften(address) {
+		const now = Date.now();
+		const recent = (this.askedBy.get(address) ?? []).filter((at) => now - at < 6e4);
+		if (recent.length >= 3) return true;
+		recent.push(now);
+		this.askedBy.set(address, recent);
+		if (this.askedBy.size > 1024) {
+			for (const [each, times] of this.askedBy) if (times.every((at) => now - at >= 6e4)) this.askedBy.delete(each);
+		}
+		return false;
+	}
+	/** Tells everyone waiting for a kind how many wait, of how many it takes */
+	tellQueue(kind) {
+		const queue = this.queues.get(kind) ?? [];
+		const needed = this.seatsFor(kind);
+		for (const each of queue) each.connection.send(JSON.stringify({
+			type: "queued",
+			kind,
+			waiting: queue.length,
+			needed
+		}));
+	}
+	/** As many wait for a kind as its seats: a room of it for them, which lets in only them, and a ticket each */
+	async match(kind) {
+		const queue = this.queues.get(kind);
+		const needed = this.seatsFor(kind);
+		if (queue.length < needed) return this.tellQueue(kind);
+		const players = queue.splice(0, needed);
+		const room = this.sampleOf(kind);
+		const seats = room.mode.seats.filter((seat) => !room.ai?.includes(seat.player));
+		const tickets = new Map(players.map((player, i) => [crypto.randomUUID(), {
+			player: seats[i].player,
+			name: player.name
+		}]));
+		const made = await this.make(kind, {}, (request) => {
+			const ticket = request.ticket ? tickets.get(request.ticket) : void 0;
+			return ticket ? {
+				player: ticket.player,
+				name: ticket.name,
+				id: request.ticket
+			} : { refuse: "this game is for the players matched to it" };
+		}).catch((error) => ({ refused: error instanceof Error ? error.message : String(error) }));
+		const given = [...tickets.keys()];
+		players.forEach(({ connection }, i) => connection.send(JSON.stringify("room" in made ? {
+			type: "matched",
+			kind,
+			room: made.room,
+			ticket: given[i]
+		} : {
+			type: "refused",
+			reason: made.refused
+		})));
+		this.tellQueue(kind);
+	}
+	/** Closes the rooms players made that have been empty long enough */
+	async sweep() {
+		const now = Date.now();
+		const emptyFor = (this.options.emptyFor ?? 60) * 1e3;
+		for (const [name, made] of [...this.made]) {
+			const server = this.servers.get(name);
+			if (!server) continue;
+			if (server.connections > 0) {
+				made.emptySince = now;
+				made.joined = true;
+				continue;
+			}
+			const wait = !made.joined ? Math.min(emptyFor, 2e4) : server.phase === "game" ? Math.max(emptyFor, (server.options.abandonAfter ?? 60) * 1e3) : emptyFor;
+			if (now - made.emptySince >= wait) await this.remove(name);
+		}
+	}
+	/** `POST /games`: a room made of a kind it offers, `{ kind, settings }`, answered with its name. And what a page asks first */
+	answerMake(request, response) {
+		const list = this.options.http?.games ?? "/games";
+		const { pathname } = new URL(request.url ?? "/", "http://server");
+		if (!list || pathname !== list || request.method !== "POST" && request.method !== "OPTIONS") return false;
+		const cors = {
+			"access-control-allow-origin": "*",
+			"access-control-allow-methods": "GET, POST",
+			"access-control-allow-headers": "content-type"
+		};
+		if (request.method === "OPTIONS") {
+			response.writeHead(204, cors);
+			response.end();
+			return true;
+		}
+		const answer = (status, body) => {
+			response.writeHead(status, {
+				"content-type": "application/json",
+				"cache-control": "no-store",
+				...cors
+			});
+			response.end(JSON.stringify(body));
+		};
+		if (this.askedTooOften(request.socket.remoteAddress ?? "")) {
+			answer(429, { refused: TOO_OFTEN });
+			return true;
+		}
+		let body = "";
+		request.on("data", (chunk) => {
+			body += chunk.toString();
+			if (body.length > MAX_BODY) request.destroy();
+		});
+		request.on("end", () => {
+			let asked;
+			try {
+				asked = JSON.parse(body || "{}");
+			} catch {
+				return answer(400, { refused: "what was asked is not JSON" });
+			}
+			const settings = asked.settings && typeof asked.settings === "object" ? Object.fromEntries(Object.entries(asked.settings).filter(([, value]) => typeof value === "string")) : {};
+			this.make(String(asked.kind ?? ""), settings).then((made) => answer("room" in made ? 201 : 409, made), (error) => answer(500, { refused: error instanceof Error ? error.message : String(error) }));
+		});
+		return true;
+	}
+	/** The port they share */
+	get port() {
+		return this.socket.port;
+	}
+	/** Whether they take no new games: stopping */
+	get draining() {
+		return [...this.servers.values()].some((room) => room.draining);
+	}
+	/** The modes the rooms play, each once, in their order: what the ratings are kept by (`/ratings`) */
+	modes() {
+		return [...new Set([...this.servers.values()].map((room) => room.options.mode.id))];
+	}
+	/** Every room's game, as a list of games says it (`GET /games`) */
+	listing() {
+		return [...this.servers].map(([name, room]) => room.listing(name));
+	}
+	/** The kinds of game players may make a room of (`kinds`), by id, with their names and the settings they offer */
+	kinds() {
+		const queue = this.queuePath;
+		return Object.entries(this.options.kinds ?? {}).map(([id, kind]) => ({
+			id,
+			name: kind.name,
+			settings: { ...this.sampleOf(id).mode.rules.server?.settings },
+			...queue && {
+				queue,
+				waiting: this.queues.get(id)?.length ?? 0,
+				needed: this.seatsFor(id)
+			}
+		}));
+	}
+	/** The numbers of each room, by its name */
+	metrics() {
+		return new Map([...this.servers].map(([name, room]) => [name, room.metrics()]));
+	}
+	/** Stops every room (see `GameServer.close`: with `drain`, each waits for its game, all at once), then the port */
+	async close(options = {}) {
+		if (this.sweeper) clearInterval(this.sweeper);
+		for (const queue of this.queues.values()) for (const { connection } of queue) connection.close();
+		this.queues.clear();
+		await Promise.all([...this.servers.values()].map((room) => room.close(options)));
+		await this.socket.close();
+	}
+};
+//#endregion
+export { GameRooms };
+
+//# sourceMappingURL=rooms.js.map

package/dist/server/rooms.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rooms.js","names":[],"sources":["../../src/server/rooms.ts"],"sourcesContent":["import type { GameKindListing, GameListing } from '#engine/session/protocol'\nimport { GameServer, type GameServerOptions } from './gameServer'\nimport type { Logger } from '#engine/log'\nimport { type ServerLog, serverLogger } from './log'\nimport { answerOps, type ServerHttpOptions, type ServerMetrics } from './ops'\nimport { type Connection, type ConnectionSource, type SocketServer, startSocketServer } from './websocket'\n\n/**\n * A room's game server: all of `GameServerOptions` but what the port they share says once for all\n *\n * @beta\n */\nexport type RoomOptions = Omit<GameServerOptions, 'port' | 'compress' | 'idleTimeout' | 'maxBuffered' | 'maxConnections' | 'http' | 'log'>\n\n/**\n * A kind of game a player may make a room of (features-plan H2): what a \"New game\" makes (`POST /games`), with the\n * settings asked for (the map) where the game offers them\n *\n * @beta\n */\nexport interface RoomKind {\n\t/** What a list calls it */\n\tname: string\n\t/**\n\t * The room it makes: the same options for each, or a function that makes a room's options each time one is made,\n\t * with the settings asked for (a random map for each: `generatedMode`). A kind of a function is listed and matched\n\t * by a room it makes once, at first\n\t */\n\troom: RoomOptions | ((settings: Record<string, string>) => RoomOptions)\n}\n\n/**\n * What `GameRooms` is started with: the shared port, the rooms, the kinds players may make and matchmaking\n *\n * @beta\n */\nexport interface GameRoomsOptions {\n\t/** The port they share: 8787 when left out, 0 for any free one */\n\tport?: number\n\t/**\n\t * The rooms, by name: each a game server of its own (a lobby and its games), reached at its name\n\t * (`ws://host:8787/arena`). A name is letters, digits, `-` and `_`. They are there for as long as the process is\n\t */\n\trooms: Record<string, RoomOptions>\n\t/**\n\t * What players may make rooms of, by id (`POST /games` with `{ kind, settings }`, a \"New game\"): each room made is\n\t * named after its kind and closed once nobody has been in it for `emptyFor`. None when left out\n\t */\n\tkinds?: Record<string, RoomKind>\n\t/** How many rooms players may have made at once, those matchmaking made with them: 16 when left out */\n\tmaxMade?: number\n\t/** Seconds a made room may stay empty before it is closed: 60 when left out. A room nobody came to counts from when it was made */\n\temptyFor?: number\n\t/**\n\t * Matchmaking (features-plan H3): players wait in a queue for a kind (`kinds`), at the address `queue`\n\t * (`ws://host:8787/queue`, `{ type: 'queue', kind, name }`); once as many wait as its seats for players, it makes a\n\t * room of the kind, which lets in only them, and hands each a ticket to it (`{ type: 'matched', room, ticket }`). On\n\t * where there are kinds, unless `false`; `path` for another address\n\t */\n\tmatchmaking?: boolean | { path?: string }\n\t/** Whether to compress what goes over connections whose other end can take it; as `SocketServerOptions.compress` */\n\tcompress?: boolean\n\t/** Seconds a connection may be silent before it is closed; as `SocketServerOptions.idleTimeout` */\n\tidleTimeout?: number\n\t/** Bytes that may wait unsent on a connection before it is closed; as `SocketServerOptions.maxBuffered` */\n\tmaxBuffered?: number\n\t/**\n\t * Connections open at once to all the rooms and the queue, at most (`SocketServerOptions.maxConnections`). 1024 when\n\t * left out\n\t *\n\t * @beta\n\t */\n\tmaxConnections?: number\n\t/**\n\t * Seconds a connection to the queue has to say what it waits for (`queue`) before it is closed. 10 when left out;\n\t * a room's own connections have their room's (`GameServerOptions.joinWithin`)\n\t *\n\t * @beta\n\t */\n\tjoinWithin?: number\n\t/** Where they all say what they do, each line with its room */\n\tlog?: ServerLog\n\t/** The health and numbers addresses, for all of them: the numbers of each by its room */\n\thttp?: ServerHttpOptions\n\t/** Where ratings are kept, for every room's players (`GameServerOptions.ratings`), where a room says none of its own */\n\tratings?: GameServerOptions['ratings']\n}\n\n/** What a room is reached at: the first part of the address a connection asked for */\nconst roomOf = (url: string) => new URL(url, 'ws://server').pathname.split('/')[1] ?? ''\n\n/** A name for a room: letters, digits, `-` and `_` */\nconst isRoomName = (name: string) => /^[\\w-]+$/.test(name)\n\n/** What an address that asked for games too often is told */\nconst TOO_OFTEN = 'too many games asked for: wait a minute'\n\n/** The most a body of a request to make a room may be: a kind and a few settings */\nconst MAX_BODY = 4096\n\n/**\n * Where a room's game server gets its connections (`ConnectionSource`): those the shared port hands it for the room's\n * name. Its server is told of a connection closing after the room has let go of it, and its `close` closes those in\n * the room, never the port\n */\nclass RoomConnections implements ConnectionSource {\n\tprivate handler: (connection: Connection) => void = () => {}\n\tprivate readonly open = new Set<Connection>()\n\n\tconstructor(readonly port: number) {}\n\n\tonConnection(handler: (connection: Connection) => void): void {\n\t\tthis.handler = handler\n\t}\n\n\t/** A connection to the room, handed to its server */\n\thand(connection: Connection): void {\n\t\t// what the room's server is told of its closing, after the room has let go of it\n\t\tlet closed = () => {}\n\t\tconst theirs: Connection = {\n\t\t\tget url() {\n\t\t\t\treturn connection.url\n\t\t\t},\n\t\t\tget address() {\n\t\t\t\treturn connection.address\n\t\t\t},\n\t\t\tget bytesSent() {\n\t\t\t\treturn connection.bytesSent\n\t\t\t},\n\t\t\tget compressed() {\n\t\t\t\treturn connection.compressed\n\t\t\t},\n\t\t\tsend: (message) => connection.send(message),\n\t\t\tonMessage: (next) => connection.onMessage(next),\n\t\t\tonClose: (next) => void (closed = next),\n\t\t\tclose: () => connection.close()\n\t\t}\n\t\tthis.open.add(theirs)\n\t\tconnection.onClose(() => {\n\t\t\tthis.open.delete(theirs)\n\t\t\tclosed()\n\t\t})\n\t\tthis.handler(theirs)\n\t}\n\n\tasync close(): Promise<void> {\n\t\tfor (const connection of [...this.open]) connection.close()\n\t}\n}\n\n/**\n * Many games in a process (S58): game servers that share a port, each a room reached at its name, as a server of its\n * own would be at its port. One process, one thread: each room's games step in turn, so the rooms of a process are as\n * many as its ticks have time for (`/metrics` says how long they take). A connection to a room there is not is told so\n * and closed. Rooms are added in code (`add`), or made by players of the kinds it offers (`kinds`, `POST /games`) and\n * closed once empty\n *\n * @public\n */\nexport class GameRooms {\n\tprivate readonly servers = new Map<string, GameServer>()\n\t/** Where each room's connections come from, by its name */\n\tprivate readonly doors = new Map<string, RoomConnections>()\n\t/** The rooms players made, and since when each has been empty (nobody connected): what closes them */\n\tprivate readonly made = new Map<string, { kind: string; emptySince: number; joined: boolean; matched: boolean }>()\n\t/** When each address last asked for rooms (`POST /games`): a few a minute each */\n\tprivate readonly askedBy = new Map<string, number[]>()\n\tprivate sweeper?: ReturnType<typeof setInterval>\n\tprivate nextMade = 1\n\t/** Who waits to be matched, by kind, in the order they came */\n\tprivate readonly queues = new Map<string, { connection: Connection; name?: string }[]>()\n\n\tprivate constructor(\n\t\tprivate readonly socket: SocketServer,\n\t\tprivate readonly options: GameRoomsOptions,\n\t\tprivate readonly logger: Logger\n\t) {}\n\n\t/** The rooms there are now, by name */\n\tget rooms(): ReadonlyMap<string, GameServer> {\n\t\treturn this.servers\n\t}\n\n\t/** Starts the rooms, and resolves once they listen */\n\tstatic async start(options: GameRoomsOptions): Promise<GameRooms> {\n\t\tfor (const name of Object.keys(options.rooms)) {\n\t\t\tif (!isRoomName(name)) throw new Error(`GameRooms: \"${name}\" is no name for a room: letters, digits, - and _`)\n\t\t}\n\t\tconst logger = serverLogger(options.log)\n\t\tlet rooms: GameRooms | undefined\n\t\tconst socket = await startSocketServer({\n\t\t\tport: options.port ?? 8787,\n\t\t\tcompress: options.compress,\n\t\t\tidleTimeout: options.idleTimeout,\n\t\t\tmaxBuffered: options.maxBuffered,\n\t\t\tmaxConnections: options.maxConnections,\n\t\t\tlog: logger,\n\t\t\tonRequest: (request, response) => {\n\t\t\t\tif (!rooms) return\n\t\t\t\tif (rooms.answerMake(request, response)) return\n\t\t\t\tconst answered = answerOps(\n\t\t\t\t\trequest,\n\t\t\t\t\tresponse,\n\t\t\t\t\toptions.http,\n\t\t\t\t\t() => ({ draining: rooms!.draining, rooms: rooms!.metrics() }),\n\t\t\t\t\t() => ({ games: rooms!.listing(), kinds: rooms!.kinds() }),\n\t\t\t\t\t{ ratings: options.ratings, modes: rooms.modes() }\n\t\t\t\t)\n\t\t\t\tif (answered) return\n\t\t\t\tresponse.writeHead(426, { 'content-type': 'text/plain' })\n\t\t\t\tresponse.end(`Game rooms: connect with a WebSocket to one of ${[...rooms.servers.keys()].join(', ')}\\n`)\n\t\t\t}\n\t\t})\n\t\trooms = new GameRooms(socket, options, logger)\n\t\tsocket.onConnection((connection) => rooms!.connect(connection))\n\t\ttry {\n\t\t\tfor (const [name, room] of Object.entries(options.rooms)) await rooms.add(name, room)\n\t\t} catch (error) {\n\t\t\tawait rooms.close()\n\t\t\tthrow error\n\t\t}\n\t\t// the rooms players made, closed once empty a while\n\t\tif (options.kinds && Object.keys(options.kinds).length) rooms.sweeper = setInterval(() => void rooms!.sweep(), 1000)\n\t\treturn rooms\n\t}\n\n\t/** A kind it offers, by id: its own, never what every object has (`constructor`), whatever a page sends */\n\tprivate kind(id: string): RoomKind | undefined {\n\t\tconst { kinds } = this.options\n\t\treturn kinds && Object.hasOwn(kinds, id) ? kinds[id] : undefined\n\t}\n\n\t/** The address of the queue, or none where there is no matchmaking */\n\tprivate get queuePath(): string | undefined {\n\t\tconst { matchmaking, kinds } = this.options\n\t\tif (matchmaking === false || !kinds || !Object.keys(kinds).length) return undefined\n\t\treturn (typeof matchmaking === 'object' && matchmaking.path) || 'queue'\n\t}\n\n\t/** A connection to a room: handed to its game server, or told there is no such room. The queue's, to the queue */\n\tprivate connect(connection: Connection): void {\n\t\tconst name = roomOf(connection.url)\n\t\tif (name === this.queuePath) return this.waitInQueue(connection)\n\t\tconst door = this.doors.get(name)\n\t\tif (!door) {\n\t\t\tconnection.send(JSON.stringify({ type: 'refused', reason: `there is no room \"${name}\"` }))\n\t\t\treturn connection.close()\n\t\t}\n\t\tdoor.hand(connection)\n\t}\n\n\t/** Opens a room at a name, as `rooms` does: in code, while the rooms run */\n\tasync add(name: string, room: RoomOptions): Promise<GameServer> {\n\t\tif (!isRoomName(name)) throw new Error(`GameRooms: \"${name}\" is no name for a room: letters, digits, - and _`)\n\t\tif (this.servers.has(name)) throw new Error(`GameRooms: there is a room \"${name}\" already`)\n\t\t// what comes to its name\n\t\tconst door = new RoomConnections(this.socket.port)\n\t\tthis.doors.set(name, door)\n\t\tconst server = await GameServer.attach(door, {\n\t\t\t...room,\n\t\t\tratings: room.ratings ?? this.options.ratings,\n\t\t\tlog: this.logger.child({ context: () => ({ fields: { room: name } }) })\n\t\t})\n\t\tthis.servers.set(name, server)\n\t\treturn server\n\t}\n\n\t/** Closes a room and lets go of its name: those in it are let go */\n\tasync remove(name: string): Promise<void> {\n\t\tconst server = this.servers.get(name)\n\t\tif (!server) return\n\t\tthis.servers.delete(name)\n\t\tthis.made.delete(name)\n\t\tawait server.close()\n\t\tthis.doors.delete(name)\n\t}\n\n\t/**\n\t * Makes a room of a kind it offers (`kinds`), with the settings asked for: what `POST /games` does. Its name is the\n\t * kind's and a number. Refused (with why) for a kind it does not offer, too many made, or while it stops\n\t */\n\tasync make(kind: string, settings: Record<string, string> = {}, seat?: RoomOptions['seat']): Promise<{ room: string } | { refused: string }> {\n\t\tconst offered = this.kind(kind)\n\t\tif (!offered) return { refused: `there is no kind of game \"${kind}\"` }\n\t\tif (this.draining) return { refused: 'the server is stopping: it takes no new games' }\n\t\t// what matchmaking makes counts as well: waiting in the queue is no way past how many there may be (RV38)\n\t\tif (this.made.size >= (this.options.maxMade ?? 16)) return { refused: 'there are as many games as there may be: join one' }\n\t\tlet name = `${kind}-${this.nextMade++}`\n\t\twhile (this.servers.has(name)) name = `${kind}-${this.nextMade++}`\n\t\tthis.made.set(name, { kind, emptySince: Date.now(), joined: false, matched: !!seat })\n\t\ttry {\n\t\t\tconst room = typeof offered.room === 'function' ? offered.room(settings) : offered.room\n\t\t\tawait this.add(name, { ...room, settings: { ...room.settings, ...settings }, ...(seat && { seat }) })\n\t\t} catch (error) {\n\t\t\tthis.made.delete(name)\n\t\t\tthrow error\n\t\t}\n\t\tthis.logger.info('server', `made the room ${name} (${offered.name})`)\n\t\treturn { room: name }\n\t}\n\n\t/** A room a kind makes, as its listing and matchmaking read it: the one it makes, or one it made once (a kind of a function) */\n\tprivate readonly samples = new Map<string, RoomOptions>()\n\tprivate sampleOf(kind: string): RoomOptions {\n\t\tconst { room } = this.kind(kind)!\n\t\tif (typeof room !== 'function') return room\n\t\tlet sample = this.samples.get(kind)\n\t\tif (!sample) this.samples.set(kind, (sample = room({})))\n\t\treturn sample\n\t}\n\n\t/** How many of a kind's seats are for players: those the computer does not play */\n\tprivate seatsFor(kind: string): number {\n\t\tconst room = this.sampleOf(kind)\n\t\treturn room.mode.seats.filter((seat) => !room.ai?.includes(seat.player)).length\n\t}\n\n\t/** A connection to the queue: it says the kind it waits for, is told how many wait, and its ticket once matched */\n\tprivate waitInQueue(connection: Connection): void {\n\t\tlet waitingFor: string | undefined\n\t\tconst leave = () => {\n\t\t\tif (!waitingFor) return\n\t\t\tconst queue = this.queues.get(waitingFor) ?? []\n\t\t\tconst at = queue.findIndex((each) => each.connection === connection)\n\t\t\tif (at >= 0) queue.splice(at, 1)\n\t\t\tthis.tellQueue(waitingFor)\n\t\t\twaitingFor = undefined\n\t\t}\n\t\t// one that never says what it waits for is let go (RV38)\n\t\tconst within = this.options.joinWithin ?? 10\n\t\tconst deadline = Number.isFinite(within) ? setTimeout(() => !waitingFor && connection.close(), Math.max(0, within) * 1000) : undefined\n\t\tdeadline?.unref?.()\n\t\tconnection.onClose(() => {\n\t\t\tclearTimeout(deadline)\n\t\t\tleave()\n\t\t})\n\t\tconnection.onMessage((text) => {\n\t\t\tlet message: { type?: unknown; kind?: unknown; name?: unknown }\n\t\t\ttry {\n\t\t\t\tmessage = JSON.parse(text)\n\t\t\t} catch {\n\t\t\t\treturn\n\t\t\t}\n\t\t\tif (message.type === 'leave') return leave()\n\t\t\tif (message.type !== 'queue') return\n\t\t\tconst kind = String(message.kind ?? '')\n\t\t\tif (!this.kind(kind)) return connection.send(JSON.stringify({ type: 'refused', reason: `there is no kind of game \"${kind}\"` }))\n\t\t\t// waiting to be matched asks for a game as making one does, from the same few an address has (RV38)\n\t\t\tif (this.askedTooOften(connection.address)) return connection.send(JSON.stringify({ type: 'refused', reason: TOO_OFTEN }))\n\t\t\tclearTimeout(deadline)\n\t\t\tleave()\n\t\t\twaitingFor = kind\n\t\t\tconst queue = this.queues.get(kind) ?? []\n\t\t\tthis.queues.set(kind, queue)\n\t\t\tqueue.push({ connection, ...(typeof message.name === 'string' && { name: message.name.slice(0, 24) }) })\n\t\t\t// whatever goes wrong making the room is told to who waits, and never stops the process\n\t\t\tthis.match(kind).catch((error: unknown) => this.logger.error('server', 'matchmaking failed', { error: String(error) }))\n\t\t})\n\t}\n\n\t/**\n\t * Whether an address has asked for games too often to ask again now: a few a minute each, made (`POST /games`) or\n\t * waited for in the queue, so that nobody fills every place there is by asking over and over. Counted when it has not\n\t */\n\tprivate askedTooOften(address: string): boolean {\n\t\tconst now = Date.now()\n\t\tconst recent = (this.askedBy.get(address) ?? []).filter((at) => now - at < 60_000)\n\t\tif (recent.length >= 3) return true\n\t\trecent.push(now)\n\t\tthis.askedBy.set(address, recent)\n\t\tif (this.askedBy.size > 1024) for (const [each, times] of this.askedBy) if (times.every((at) => now - at >= 60_000)) this.askedBy.delete(each)\n\t\treturn false\n\t}\n\n\t/** Tells everyone waiting for a kind how many wait, of how many it takes */\n\tprivate tellQueue(kind: string): void {\n\t\tconst queue = this.queues.get(kind) ?? []\n\t\tconst needed = this.seatsFor(kind)\n\t\tfor (const each of queue) each.connection.send(JSON.stringify({ type: 'queued', kind, waiting: queue.length, needed }))\n\t}\n\n\t/** As many wait for a kind as its seats: a room of it for them, which lets in only them, and a ticket each */\n\tprivate async match(kind: string): Promise<void> {\n\t\tconst queue = this.queues.get(kind)!\n\t\tconst needed = this.seatsFor(kind)\n\t\tif (queue.length < needed) return this.tellQueue(kind)\n\t\tconst players = queue.splice(0, needed)\n\t\tconst room = this.sampleOf(kind)\n\t\tconst seats = room.mode.seats.filter((seat) => !room.ai?.includes(seat.player))\n\t\t// a ticket each, for the seat it is to: nobody else gets in\n\t\tconst tickets = new Map<string, { player: number; name?: string }>(\n\t\t\tplayers.map((player, i) => [crypto.randomUUID(), { player: seats[i].player, name: player.name }])\n\t\t)\n\t\tconst made = await this.make(kind, {}, (request) => {\n\t\t\tconst ticket = request.ticket ? tickets.get(request.ticket) : undefined\n\t\t\treturn ticket ? { player: ticket.player, name: ticket.name, id: request.ticket } : { refuse: 'this game is for the players matched to it' }\n\t\t}).catch((error: unknown) => ({ refused: error instanceof Error ? error.message : String(error) }))\n\t\tconst given = [...tickets.keys()]\n\t\tplayers.forEach(({ connection }, i) =>\n\t\t\tconnection.send(\n\t\t\t\tJSON.stringify('room' in made ? { type: 'matched', kind, room: made.room, ticket: given[i] } : { type: 'refused', reason: made.refused })\n\t\t\t)\n\t\t)\n\t\tthis.tellQueue(kind)\n\t}\n\n\t/** Closes the rooms players made that have been empty long enough */\n\tprivate async sweep(): Promise<void> {\n\t\tconst now = Date.now()\n\t\tconst emptyFor = (this.options.emptyFor ?? 60) * 1000\n\t\tfor (const [name, made] of [...this.made]) {\n\t\t\tconst server = this.servers.get(name)\n\t\t\tif (!server) continue\n\t\t\tif (server.connections > 0) {\n\t\t\t\tmade.emptySince = now\n\t\t\t\tmade.joined = true\n\t\t\t\tcontinue\n\t\t\t}\n\t\t\t// nobody ever came: sooner. A game on: not before those who dropped out may come back to it\n\t\t\tconst wait = !made.joined\n\t\t\t\t? Math.min(emptyFor, 20_000)\n\t\t\t\t: server.phase === 'game'\n\t\t\t\t\t? Math.max(emptyFor, (server.options.abandonAfter ?? 60) * 1000)\n\t\t\t\t\t: emptyFor\n\t\t\tif (now - made.emptySince >= wait) await this.remove(name)\n\t\t}\n\t}\n\n\t/** `POST /games`: a room made of a kind it offers, `{ kind, settings }`, answered with its name. And what a page asks first */\n\tprivate answerMake(request: import('node:http').IncomingMessage, response: import('node:http').ServerResponse): boolean {\n\t\tconst list = this.options.http?.games ?? '/games'\n\t\tconst { pathname } = new URL(request.url ?? '/', 'http://server')\n\t\tif (!list || pathname !== list || (request.method !== 'POST' && request.method !== 'OPTIONS')) return false\n\t\tconst cors = { 'access-control-allow-origin': '*', 'access-control-allow-methods': 'GET, POST', 'access-control-allow-headers': 'content-type' }\n\t\tif (request.method === 'OPTIONS') {\n\t\t\tresponse.writeHead(204, cors)\n\t\t\tresponse.end()\n\t\t\treturn true\n\t\t}\n\t\tconst answer = (status: number, body: unknown) => {\n\t\t\tresponse.writeHead(status, { 'content-type': 'application/json', 'cache-control': 'no-store', ...cors })\n\t\t\tresponse.end(JSON.stringify(body))\n\t\t}\n\t\tif (this.askedTooOften(request.socket.remoteAddress ?? '')) {\n\t\t\tanswer(429, { refused: TOO_OFTEN })\n\t\t\treturn true\n\t\t}\n\t\tlet body = ''\n\t\trequest.on('data', (chunk: Buffer) => {\n\t\t\tbody += chunk.toString()\n\t\t\tif (body.length > MAX_BODY) request.destroy()\n\t\t})\n\t\trequest.on('end', () => {\n\t\t\tlet asked: { kind?: unknown; settings?: unknown }\n\t\t\ttry {\n\t\t\t\tasked = JSON.parse(body || '{}')\n\t\t\t} catch {\n\t\t\t\treturn answer(400, { refused: 'what was asked is not JSON' })\n\t\t\t}\n\t\t\tconst settings =\n\t\t\t\tasked.settings && typeof asked.settings === 'object'\n\t\t\t\t\t? Object.fromEntries(Object.entries(asked.settings as Record<string, unknown>).filter(([, value]) => typeof value === 'string'))\n\t\t\t\t\t: {}\n\t\t\tvoid this.make(String(asked.kind ?? ''), settings as Record<string, string>).then(\n\t\t\t\t(made) => answer('room' in made ? 201 : 409, made),\n\t\t\t\t(error: unknown) => answer(500, { refused: error instanceof Error ? error.message : String(error) })\n\t\t\t)\n\t\t})\n\t\treturn true\n\t}\n\n\t/** The port they share */\n\tget port(): number {\n\t\treturn this.socket.port\n\t}\n\n\t/** Whether they take no new games: stopping */\n\tget draining(): boolean {\n\t\treturn [...this.servers.values()].some((room) => room.draining)\n\t}\n\n\t/** The modes the rooms play, each once, in their order: what the ratings are kept by (`/ratings`) */\n\tmodes(): string[] {\n\t\treturn [...new Set([...this.servers.values()].map((room) => room.options.mode.id))]\n\t}\n\n\t/** Every room's game, as a list of games says it (`GET /games`) */\n\tlisting(): GameListing[] {\n\t\treturn [...this.servers].map(([name, room]) => room.listing(name))\n\t}\n\n\t/** The kinds of game players may make a room of (`kinds`), by id, with their names and the settings they offer */\n\tkinds(): GameKindListing[] {\n\t\tconst queue = this.queuePath\n\t\treturn Object.entries(this.options.kinds ?? {}).map(([id, kind]) => ({\n\t\t\tid,\n\t\t\tname: kind.name,\n\t\t\tsettings: { ...this.sampleOf(id).mode.rules.server?.settings },\n\t\t\t...(queue && { queue, waiting: this.queues.get(id)?.length ?? 0, needed: this.seatsFor(id) })\n\t\t}))\n\t}\n\n\t/** The numbers of each room, by its name */\n\tmetrics(): Map<string, ServerMetrics> {\n\t\treturn new Map([...this.servers].map(([name, room]) => [name, room.metrics()]))\n\t}\n\n\t/** Stops every room (see `GameServer.close`: with `drain`, each waits for its game, all at once), then the port */\n\tasync close(options: { drain?: number } = {}): Promise<void> {\n\t\tif (this.sweeper) clearInterval(this.sweeper)\n\t\tfor (const queue of this.queues.values()) for (const { connection } of queue) connection.close()\n\t\tthis.queues.clear()\n\t\tawait Promise.all([...this.servers.values()].map((room) => room.close(options)))\n\t\tawait this.socket.close()\n\t}\n}\n"],"mappings":"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"}

package/dist/server/seat.js

@@ -0,0 +1,116 @@
+//#region src/server/seat.ts
+/** A token to come back to a seat with: what only who has it knows */
+function randomToken() {
+	const bytes = /* @__PURE__ */ new Uint8Array(16);
+	crypto.getRandomValues(bytes);
+	return [...bytes].map((byte) => byte.toString(16).padStart(2, "0")).join("");
+}
+/**
+* A seat of a server's game and who holds it
+*
+* @internal
+*/
+var Seat = class {
+	mode;
+	computer;
+	/** The world's player this seat plays */
+	player;
+	/** The name shown for the seat: the mode's, or the one its player gave */
+	name;
+	/** A computer plays it */
+	ai;
+	/** Someone is in it now */
+	connected = false;
+	/** Whether the player has said they are ready to start, in the lobby */
+	ready = false;
+	/** The seat's chosen settings by name, such as its race, team and colour */
+	settings;
+	/** Who it is rated as (`ratedId`), where the server rates */
+	rated;
+	/** Its player's rating in the mode (`Rating.rating`), where the server rates */
+	rating;
+	/** What lets who held it back in: theirs while they hold it, in the lobby and in the game */
+	token;
+	/** Who holds it, as the `seat` hook said (`SeatAnswer.id`) */
+	id;
+	/** When what an honest client never sends came from it, in this game: the last `cheating.seconds`' worth, and how many in all */
+	cheats = {
+		at: [],
+		total: 0
+	};
+	/** The connection of who is in it */
+	connection;
+	constructor(mode, computer, settings) {
+		this.mode = mode;
+		this.computer = computer;
+		this.player = mode.player;
+		this.name = mode.name;
+		this.ai = computer;
+		this.settings = settings;
+	}
+	/** Nobody in it, nor holding it in a game to come back to, nor a computer */
+	get isFree() {
+		return !this.ai && !this.connected && this.token === void 0;
+	}
+	/**
+	* Taken by a connection: whoever was in it before is closed out (a player back from another page), and its token is
+	* kept, or made. A name it is given is taken. Gives the token
+	*/
+	take(connection, name) {
+		if (this.connection && this.connection !== connection) this.connection.close();
+		this.connected = true;
+		this.connection = connection;
+		this.token ??= randomToken();
+		if (name) this.name = name.slice(0, 24);
+		return this.token;
+	}
+	/** Whoever holds another seat moves here, in the lobby: their connection, token, who they are and their name; not ready */
+	takeFrom(other) {
+		this.connected = true;
+		this.connection = other.connection;
+		this.token = other.token;
+		this.id = other.id;
+		this.rated = other.rated;
+		this.name = other.name;
+		this.ready = false;
+		other.free();
+	}
+	/** Its connection gone, held for who had it to come back to (a game on): their token, who they are and their name stay */
+	drop() {
+		this.connected = false;
+		this.connection = void 0;
+	}
+	/** Given up: free for anyone, with the mode's name, nobody's token, not ready */
+	free() {
+		this.drop();
+		this.token = void 0;
+		this.id = void 0;
+		this.rated = void 0;
+		this.ready = false;
+		this.name = this.mode.name;
+	}
+	/** Held no more by who it was: their token and who they are no good (a kick). Their connection is closed by the caller */
+	revoke() {
+		this.token = void 0;
+		this.id = void 0;
+		this.rated = void 0;
+	}
+	/** What a new game starts it with: nobody's cheats, not ready, the computer's where the server says */
+	newGame() {
+		this.cheats = {
+			at: [],
+			total: 0
+		};
+		this.ready = false;
+		this.ai = this.computer;
+	}
+	/** New, for a new game with nobody: free, and as a new game starts it */
+	reset() {
+		this.free();
+		this.newGame();
+	}
+};
+//#endregion
+export { Seat, randomToken };
+
+//# sourceMappingURL=seat.js.map