// server/http/config.js — where the server's settings come from. startServer() options win over the environment: // // * PORT (default 3000), HOST (default 0.0.0.0); // * TRUST_PROXY ('auto' default: honour CF-Connecting-IP / X-Real-IP / X-Forwarded-For only from loopback/private // peers such as a local cloudflared; '1' always; '0' never) → net.js trustProxy; // * DEBUG → the console logger's debug level; // * the served directories (public/, data/, shared/ of this repository unless the options name others), and which // startServer() options are handed on to net.js Network and lobby.js Lobby. import path from 'node:path'; import { fileURLToPath } from 'node:url'; /** Repository root. */ export const ROOT = path.resolve(path.dirname(fileURLToPath(import.meta.url)), '..', '..'); export const noopLog = { info() {}, warn() {}, error() {}, debug() {} }; /** startServer() options handed on to net.js Network / lobby.js Lobby (an absent one keeps that module's default). */ const NET_OPTION_KEYS = ['reconnectWindowMs', 'heartbeatMs', 'helloTimeoutMs', 'ratePerSec', 'rateBurst', 'maxConnections', 'abuseDropsPerSec', 'maxConnectionsPerAddr', 'heavyPerSec', 'heavyBurst', 'trustProxy']; const LOBBY_OPTION_KEYS = ['lobbyGraceMs', 'maxRooms', 'maxRoomsPerAddr', 'maxMatchesPerAddr', 'resyncMinGapMs', 'soloReconnectWindowMs']; /** * Where to listen: the `port` / `host` options, else PORT / HOST, else port 3000 on 0.0.0.0. * @param {{ port?: number, host?: string }} opts * @returns {{ port: number, host: string }} * @throws {RangeError} when the port is not an integer in 0…65535 */ export function listenAddress(opts) { const port = opts.port ?? (process.env.PORT != null && process.env.PORT !== '' ? Number(process.env.PORT) : 3000); const host = opts.host ?? process.env.HOST ?? '0.0.0.0'; if (!Number.isInteger(port) || port < 0 || port > 65535) throw new RangeError(`invalid PORT ${port}`); return { port, host }; } /** * The directories the static server reads. * @param {{ publicDir?: string, dataDir?: string, sharedDir?: string }} opts */ export function serveDirs(opts) { return { publicDir: opts.publicDir || path.join(ROOT, 'public'), dataDir: opts.dataDir || path.join(ROOT, 'data'), sharedDir: opts.sharedDir || path.join(ROOT, 'shared'), }; } /** net.js Network options out of the startServer() options; `trustProxy` falls back to TRUST_PROXY. */ export function netOptionsFrom(opts) { const netOptions = {}; for (const k of NET_OPTION_KEYS) { if (opts[k] != null) netOptions[k] = opts[k]; } if (netOptions.trustProxy == null) netOptions.trustProxy = parseTrustProxy(process.env.TRUST_PROXY); return netOptions; } /** lobby.js Lobby options out of the startServer() options. */ export function lobbyOptionsFrom(opts) { const lobbyOptions = {}; for (const k of LOBBY_OPTION_KEYS) { if (opts[k] != null) lobbyOptions[k] = opts[k]; } return lobbyOptions; } /** TRUST_PROXY env → net.js trustProxy ('auto' unless explicitly on/off). @param {string | undefined} v */ export function parseTrustProxy(v) { const s = String(v ?? '').trim().toLowerCase(); if (['1', 'true', 'yes', 'on', 'always'].includes(s)) return true; if (['0', 'false', 'no', 'off', 'never'].includes(s)) return false; return 'auto'; } /** The console logger (`quiet` → silent; debug lines only with DEBUG set). */ export function makeLogger(quiet) { if (quiet) return noopLog; return { info: (...a) => console.log(...a), warn: (...a) => console.warn(...a), error: (...a) => console.error(...a), debug: process.env.DEBUG ? (...a) => console.debug(...a) : () => {}, }; }