@sagl/server 0.0.0-stage → 0.1.0-next.49

package/dist/commands.js

@@ -0,0 +1,373 @@
+/** A command's usage went wrong: the message is shown to the player. */
+export class CommandError extends Error {
+}
+let lookup = { players: () => [], vehicle: () => undefined };
+/** @internal */
+export function setLookup(l) {
+    lookup = l;
+}
+const clean = (s) => s.replace(/[\t\n:|]/g, " ");
+/** Argument types for `command(...).argument(name, type)`. */
+export const arg = {
+    /** A player: by id, their name, or the start of it (one match). */
+    player() {
+        return {
+            label: "player",
+            token: "player",
+            parse(input) {
+                const all = lookup.players();
+                if (/^\d+$/.test(input)) {
+                    const p = all.find((x) => x.id === Number(input));
+                    if (p)
+                        return p;
+                }
+                const lower = input.toLowerCase();
+                const exact = all.find((x) => x.name.toLowerCase() === lower);
+                if (exact)
+                    return exact;
+                const matches = all.filter((x) => x.name.toLowerCase().startsWith(lower));
+                if (matches.length === 1)
+                    return matches[0];
+                if (matches.length > 1)
+                    throw new CommandError(`More than one player matches "${input}": ${matches.map((p) => p.name).join(", ")}`);
+                throw new CommandError(`No player "${input}"`);
+            },
+        };
+    },
+    /** A whole number, within `min`-`max`. */
+    integer(o = {}) {
+        const { min = -2147483648, max = 2147483647 } = o;
+        return {
+            label: o.min !== undefined || o.max !== undefined ? `${o.min ?? ""}-${o.max ?? ""}`.replace(/^-$/, "number") : "number",
+            token: `int:${min}:${max}`,
+            parse(input) {
+                if (!/^[-+]?\d+$/.test(input))
+                    throw new CommandError(`"${input}" isn't a whole number`);
+                const n = Number(input);
+                if (n < min || n > max)
+                    throw new CommandError(`${n} isn't within ${min}-${max}`);
+                return n;
+            },
+        };
+    },
+    /** A number (decimals too), within `min`-`max`. */
+    number(o = {}) {
+        const { min = -Infinity, max = Infinity } = o;
+        return {
+            label: "number",
+            token: `num:${Number.isFinite(min) ? min : ""}:${Number.isFinite(max) ? max : ""}`,
+            parse(input) {
+                const n = Number(input);
+                if (input === "" || !Number.isFinite(n))
+                    throw new CommandError(`"${input}" isn't a number`);
+                if (n < min || n > max)
+                    throw new CommandError(`${n} isn't within ${min}-${max}`);
+                return n;
+            },
+        };
+    },
+    /** One word. */
+    word() {
+        return { label: "word", token: "word", parse: (input) => input };
+    },
+    /** The rest of the line (it must come last). */
+    text() {
+        return { label: "text", token: "text", greedy: true, parse: (input) => input };
+    },
+    /** yes/no, true/false, on/off, 1/0. */
+    boolean() {
+        return {
+            label: "yes/no",
+            token: "choice:yes|no|on|off|true|false",
+            parse(input) {
+                const v = input.toLowerCase();
+                if (["yes", "true", "on", "1"].includes(v))
+                    return true;
+                if (["no", "false", "off", "0"].includes(v))
+                    return false;
+                throw new CommandError(`"${input}" isn't yes or no`);
+            },
+        };
+    },
+    /** One of these words. */
+    choice(choices) {
+        return {
+            label: choices.join("|"),
+            token: `choice:${choices.map(clean).join("|")}`,
+            parse(input) {
+                const c = choices.find((x) => x.toLowerCase() === input.toLowerCase());
+                if (c === undefined)
+                    throw new CommandError(`"${input}" isn't one of ${choices.join(", ")}`);
+                return c;
+            },
+        };
+    },
+    /** A vehicle, by its id. */
+    vehicle() {
+        return {
+            label: "vehicle id",
+            token: "int:0:2147483647",
+            parse(input) {
+                const v = /^\d+$/.test(input) ? lookup.vehicle(Number(input)) : undefined;
+                if (!v)
+                    throw new CommandError(`No vehicle ${input}`);
+                return v;
+            },
+        };
+    },
+    /**
+     * Your own: `parse` reads it (throw `CommandError` to refuse), `suggest`
+     * offers what the chat suggests as they type (asked of the server).
+     */
+    custom(o) {
+        return { label: o.label, token: "custom", greedy: o.greedy, parse: o.parse, suggest: o.suggest };
+    },
+};
+/**
+ * A command, built up (as Minecraft's Brigadier): its name, aliases,
+ * arguments, subcommands, who may use it, and what it does. Made with
+ * `command(name)`.
+ *
+ * ```ts
+ * server.commands.register(
+ *   command("pay").description("Give money to a player")
+ *     .argument("player", arg.player())
+ *     .argument("amount", arg.integer({ min: 1 }))
+ *     .executes((player, { player: to, amount }) => { ... }),
+ * );
+ * ```
+ */
+export class CommandBuilder {
+    /** @internal */ name;
+    /** @internal */ aliases = [];
+    /** @internal */ text = "";
+    /** @internal */ check = null;
+    /** @internal */ args = [];
+    /** @internal */ children = [];
+    /** @internal */ run = null;
+    /** @internal */
+    constructor(name) {
+        if (!/^[A-Za-z0-9_.-]{1,32}$/.test(name))
+            throw new RangeError(`not a command name: "${name}"`);
+        this.name = name.toLowerCase();
+    }
+    /** Other names for it. */
+    alias(...names) {
+        for (const n of names) {
+            if (!/^[A-Za-z0-9_.-]{1,32}$/.test(n))
+                throw new RangeError(`not a command name: "${n}"`);
+            this.aliases.push(n.toLowerCase());
+        }
+        return this;
+    }
+    /** What it does, shown with its usage in the chat's suggestions. */
+    description(text) {
+        this.text = clean(text);
+        return this;
+    }
+    /** Who may use it (and see it suggested): checked per player. */
+    requires(check) {
+        this.check = check;
+        return this;
+    }
+    /** The next argument. Optional ones come last. */
+    argument(name, type, options = {}) {
+        if (!/^[A-Za-z0-9_]{1,32}$/.test(name))
+            throw new RangeError(`not an argument name: "${name}"`);
+        const last = this.args[this.args.length - 1];
+        if (last?.type.greedy)
+            throw new TypeError(`/${this.name}: nothing can follow "${last.name}" (it takes the rest of the line)`);
+        if (last?.optional && !options.optional)
+            throw new TypeError(`/${this.name}: "${name}" can't follow an optional argument`);
+        this.args.push({ name, type, optional: options.optional ?? false });
+        return this;
+    }
+    /** A subcommand: `/faction invite ...` is `command("faction").then(command("invite")...)`. */
+    then(sub) {
+        this.children.push(sub);
+        return this;
+    }
+    /** What it does: `fn(player, args, line)`; throw `CommandError` to tell them what's wrong. */
+    executes(fn) {
+        this.run = fn;
+        return this;
+    }
+}
+/** Starts a command: see `CommandBuilder`. */
+export function command(name) {
+    return new CommandBuilder(name);
+}
+const allowed = (b, p) => {
+    try {
+        return !b.check || b.check(p);
+    }
+    catch {
+        return false;
+    }
+};
+const named = (b, word) => b.name === word || b.aliases.includes(word);
+// Every way of using it: the literals on the way, and the arguments.
+function syntaxes(b, p, prefix = []) {
+    const own = [...prefix, ...b.args.map((a) => `${a.optional ? "opt" : "arg"}:${a.name}:${a.type.token}`)];
+    const out = [];
+    if (b.run)
+        out.push({ tokens: own, text: b.text });
+    for (const c of b.children) {
+        if (allowed(c, p))
+            out.push(...syntaxes(c, p, [...own, `lit:${c.name}`]));
+    }
+    return out;
+}
+// "/pay <player> <amount>", for each way of using it.
+function usage(name, b, p) {
+    return syntaxes(b, p).map((s) => `/${name} ` + s.tokens.map((t) => {
+        const [kind, n] = t.split(":");
+        return kind === "lit" ? n : kind === "opt" ? `[${n}]` : `<${n}>`;
+    }).join(" "));
+}
+/** `server.commands`: the server's chat commands. */
+export class Commands {
+    #roots = [];
+    #send;
+    #players;
+    #error;
+    /** @internal */
+    constructor(send, players, error) {
+        this.#send = send;
+        this.#players = players;
+        this.#error = error;
+    }
+    /** Adds commands (players' chat suggests them at once). */
+    register(...commands) {
+        for (const c of commands) {
+            for (const n of [c.name, ...c.aliases]) {
+                if (this.#roots.some((r) => named(r, n)))
+                    throw new Error(`/${n} is already a command`);
+            }
+            this.#roots.push(c);
+        }
+        for (const p of this.#players())
+            this.refresh(p);
+        return this;
+    }
+    /** Removes a command, by its name. */
+    unregister(name) {
+        this.#roots = this.#roots.filter((r) => r.name !== name.toLowerCase());
+        for (const p of this.#players())
+            this.refresh(p);
+    }
+    /** Sends their chat the commands they can use now: after what `requires` checks changes (their admin level...). */
+    refresh(player) {
+        if (!player.connected)
+            return;
+        const lines = [];
+        for (const r of this.#roots) {
+            if (!allowed(r, player))
+                continue;
+            for (const n of [r.name, ...r.aliases]) {
+                for (const s of syntaxes(r, player))
+                    lines.push([n, s.text, s.tokens.join(" ")].join("\t"));
+            }
+        }
+        this.#send(player, lines.join("\n"));
+    }
+    /**
+     * @internal A /command line from `player`: true if a registered command
+     * took it (run, or its usage error shown), false if none is called that.
+     */
+    async handle(player, line) {
+        const words = line.slice(1).trim().split(/\s+/).filter(Boolean);
+        const name = (words.shift() ?? "").toLowerCase();
+        const root = this.#roots.find((r) => named(r, name));
+        if (!root || !allowed(root, player))
+            return false;
+        const rest = line.slice(1).trim().slice(line.slice(1).trim().split(/\s+/)[0].length).trim();
+        try {
+            await this.#run(root, player, rest, {}, name, line);
+        }
+        catch (err) {
+            if (err instanceof CommandError) {
+                this.#error(player, err.message);
+                for (const u of usage(name, root, player).slice(0, 4))
+                    this.#error(player, `Usage: ${u}`);
+            }
+            else {
+                console.error(`[sagl] /${name} threw:`, err);
+                this.#error(player, "That command failed.");
+            }
+        }
+        return true;
+    }
+    async #run(b, player, rest, args, name, line) {
+        let text = rest;
+        for (const a of b.args) {
+            text = text.trimStart();
+            if (!text) {
+                if (a.optional)
+                    break;
+                throw new CommandError(`Missing ${a.name}`);
+            }
+            let word;
+            if (a.type.greedy) {
+                word = text;
+                text = "";
+            }
+            else {
+                const m = /^\S+/.exec(text);
+                word = m[0];
+                text = text.slice(word.length);
+            }
+            args[a.name] = a.type.parse(word, player);
+        }
+        text = text.trim();
+        if (text) {
+            const next = text.split(/\s+/)[0].toLowerCase();
+            const sub = b.children.find((c) => named(c, next) && allowed(c, player));
+            if (sub)
+                return this.#run(sub, player, text.slice(next.length), args, name, line);
+            if (!b.children.length)
+                throw new CommandError("Too much after the command");
+            throw new CommandError(`Unknown: "${next}"`);
+        }
+        if (!b.run)
+            throw new CommandError(b.children.length ? "Which one?" : "That can't be used alone");
+        await b.run(player, args, line);
+    }
+    /**
+     * @internal Suggestions for the custom argument being typed at the end of
+     * `line`: [where its word starts, suggestions], or null.
+     */
+    async suggest(player, line) {
+        const body = line.slice(1);
+        const words = body.split(" ");
+        const root = this.#roots.find((r) => named(r, (words[0] ?? "").toLowerCase()));
+        if (!root || !allowed(root, player))
+            return null;
+        let b = root;
+        let i = 1;
+        let pos = 1 + words[0].length + 1;
+        for (;;) {
+            for (const a of b.args) {
+                const last = i === words.length - 1;
+                if (a.type.greedy || last) {
+                    const partial = a.type.greedy ? words.slice(i).join(" ") : words[i];
+                    if (!a.type.suggest)
+                        return null;
+                    const list = await a.type.suggest(player, partial ?? "");
+                    return [pos, list.slice(0, 20)];
+                }
+                pos += words[i].length + 1;
+                ++i;
+            }
+            if (i >= words.length)
+                return null;
+            const sub = b.children.find((c) => named(c, words[i].toLowerCase()) && allowed(c, player));
+            if (!sub || i === words.length - 1)
+                return null;
+            pos += words[i].length + 1;
+            ++i;
+            b = sub;
+        }
+    }
+}
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/console.d.ts

@@ -0,0 +1,21 @@
+import type { Server } from "./server.js";
+export type CommandHandler = (args: string[], line: string) => void;
+/**
+ * Operator console on stdin. Comes with built-in commands (`help` lists them);
+ * gamemodes add their own:
+ *
+ * ```ts
+ * server.console.command("heal", "heal <id>", ([id]) => { ... });
+ * ```
+ */
+export declare class Console {
+    #private;
+    constructor(server: Server);
+    command(name: string, usage: string, run: CommandHandler): this;
+    /** Runs one console line, as if typed. */
+    run(line: string): void;
+    /** @internal */
+    start(): void;
+    /** @internal */
+    stop(): void;
+}

package/dist/console.js

@@ -0,0 +1,100 @@
+import * as readline from "node:readline";
+import { native } from "./native.js";
+/**
+ * Operator console on stdin. Comes with built-in commands (`help` lists them);
+ * gamemodes add their own:
+ *
+ * ```ts
+ * server.console.command("heal", "heal <id>", ([id]) => { ... });
+ * ```
+ */
+export class Console {
+    #server;
+    #commands = new Map();
+    #rl = null;
+    constructor(server) {
+        this.#server = server;
+        this.#builtins();
+    }
+    command(name, usage, run) {
+        this.#commands.set(name, { usage, run });
+        return this;
+    }
+    /** Runs one console line, as if typed. */
+    run(line) {
+        const [name, ...args] = line.trim().split(/\s+/);
+        if (!name)
+            return;
+        const command = this.#commands.get(name);
+        if (!command) {
+            console.log(`unknown command '${name}' (try 'help')`);
+            return;
+        }
+        try {
+            command.run(args, line.trim().slice(name.length).trim());
+        }
+        catch (err) {
+            console.error(`${name}:`, err instanceof Error ? err.message : err);
+        }
+    }
+    /** @internal */
+    start() {
+        if (this.#rl || !process.stdin.readable)
+            return;
+        this.#rl = readline.createInterface({ input: process.stdin, terminal: false });
+        this.#rl.on("line", (line) => this.run(line));
+        console.log("console: type 'help'");
+    }
+    /** @internal */
+    stop() {
+        this.#rl?.close();
+        this.#rl = null;
+    }
+    #player(arg) {
+        const player = arg === undefined ? undefined : this.#server.player(Number(arg));
+        if (!player)
+            throw new Error(`no player ${arg}`);
+        return player;
+    }
+    #builtins() {
+        const server = this.#server;
+        this.command("help", "help", () => {
+            for (const { usage } of this.#commands.values())
+                console.log(`  ${usage}`);
+        });
+        this.command("players", "players", () => {
+            for (const p of server.players) {
+                const pos = p.position;
+                console.log(`  ${p.id}: ${p.name} ${p.ip} skin ${p.skin} hp ${p.health} ` +
+                    `at ${pos.x.toFixed(1)} ${pos.y.toFixed(1)} ${pos.z.toFixed(1)} ping ${p.ping} ms`);
+            }
+            console.log(`${server.players.length} player(s)`);
+        });
+        this.command("time", "time [HH:MM]", ([arg]) => {
+            if (arg) {
+                const [hour, minute] = arg.split(":").map(Number);
+                server.time = { hour, minute };
+            }
+            const t = server.time;
+            console.log(`time ${String(t.hour).padStart(2, "0")}:${String(t.minute).padStart(2, "0")}, ${t.frozen ? "frozen" : "running"}`);
+        });
+        this.command("freeze", "freeze", () => server.freezeTime());
+        this.command("unfreeze", "unfreeze", () => server.unfreezeTime());
+        this.command("skin", "skin <id> <model|random>", ([id, model]) => {
+            const skin = model === "random" ? server.randomSkin() : Number(model);
+            if (!native.isValidSkin(skin))
+                throw new Error(`not a valid ped model: ${model}`);
+            this.#player(id).skin = skin;
+        });
+        this.command("say", "say <text>", (_args, rest) => server.broadcast(rest));
+        this.command("kick", "kick <id> [reason]", ([id, ...reason]) => this.#player(id).kick(reason.join(" ")));
+        this.command("tp", "tp <id> <x> <y> <z>", ([id, x, y, z]) => this.#player(id).setPosition({ x: Number(x), y: Number(y), z: Number(z) }));
+        this.command("hp", "hp <id> <health> [armour]", ([id, health, armour]) => {
+            const p = this.#player(id);
+            p.health = Number(health);
+            if (armour !== undefined)
+                p.armour = Number(armour);
+        });
+    }
+}
+//# sourceMappingURL=console.js.map

package/dist/console.js.map

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