libroadcast-cli 2.3.0 → 2.4.0

package/README.md

@@ -82,6 +82,12 @@ Commands:
      Options:
        --loop <intervalInSeconds>   Continuously push the PGN file at the specified interval in seconds.
 
+  pushFilterID <roundId> <PGNFromPathOrUrl> <FideIds...> [--loop <intervalInSeconds>]
+     Upload a PGN file from a local path or URL to the specified broadcast round, filtering games by FIDE ID.
+     Note: The PGN file must be accessible from the provided path or URL.
+     Options:
+       --loop <intervalInSeconds>   Continuously push the PGN file at the specified interval in seconds.
+
 
 Examples:
    # Login with your Lichess token (interactive)
@@ -108,4 +114,6 @@ Examples:
      $ score bcast123 1.0 0.5 1.0 0.5
    # Push a PGN file in loop mode every 60 seconds
      $ push round456 /path/to/localfile.pgn --loop 60
+   # Push a PGN file from URL filtering by FIDE IDs in loop mode every 120 seconds
+     $ pushFilterID round456 https://example.com/games.pgn 12345 67890 --loop 120
 ```

package/dist/cmd/pushFilterID.js

@@ -0,0 +1,141 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.pushFilterIDCommand = void 0;
+const node_process_1 = require("node:process");
+const promises_1 = require("node:fs/promises");
+const node_path_1 = __importDefault(require("node:path"));
+const commandHandler_1 = require("../utils/commandHandler");
+const pgn_1 = require("chessops/pgn");
+const getInfoBroadcast_1 = require("../utils/getInfoBroadcast");
+const colors_1 = __importDefault(require("../utils/colors"));
+const pushPGN = async (round, pgn) => {
+    try {
+        const res = await commandHandler_1.client
+            .POST("/api/broadcast/round/{broadcastRoundId}/push", {
+            params: {
+                path: { broadcastRoundId: round.id },
+            },
+            body: pgn,
+            bodySerializer: (body) => body,
+        })
+            .then((response) => response.data);
+        console.log(colors_1.default.green(`✓ Successfully pushed PGN for round ${colors_1.default.whiteBold(round.id)}.`));
+        console.table(res?.games.map((game, i) => {
+            return {
+                "Game #": i + 1,
+                "White Player": game.tags["White"] || "Unknown",
+                "Black Player": game.tags["Black"] || "Unknown",
+                Result: game.tags["Result"] || "Unknown",
+                "Ply Count": game.moves || "Unknown",
+                Error: game.error || "None",
+            };
+        }));
+    }
+    catch (error) {
+        console.error(colors_1.default.red(`Error pushing PGN for round ${colors_1.default.whiteBold(round.id)}:`), error);
+    }
+};
+const filterPgnByIds = (pgn, filterIds) => {
+    const parsed = (0, pgn_1.parsePgn)(pgn);
+    const filteredGames = parsed.filter((game) => {
+        const whiteFideId = game.headers.get("WhiteFideId");
+        const blackFideId = game.headers.get("BlackFideId");
+        if (filterIds.length > 1) {
+            for (let i = 0; i < filterIds.length; i += 2) {
+                const whiteId = filterIds[i];
+                const blackId = filterIds[i + 1];
+                if ((whiteFideId === String(whiteId) &&
+                    blackFideId === String(blackId)) ||
+                    (whiteFideId === String(blackId) && blackFideId === String(whiteId))) {
+                    return true;
+                }
+            }
+            return false;
+        }
+        else {
+            return (filterIds.includes(parseInt(whiteFideId || "", 10)) ||
+                filterIds.includes(parseInt(blackFideId || "", 10)));
+        }
+    });
+    return filteredGames.map((game) => (0, pgn_1.makePgn)(game)).join("\n\n");
+};
+const readPGNFromURL = async (pgnURL, filterIds) => {
+    if (pgnURL.startsWith("http://") || pgnURL.startsWith("https://")) {
+        const response = await fetch(pgnURL, {
+            method: "GET",
+            headers: {
+                "User-Agent": commandHandler_1.packageJson.name + "/" + commandHandler_1.packageJson.version,
+            },
+        });
+        if (!response.ok) {
+            console.error(colors_1.default.red(`Failed to fetch PGN from URL: ${response.statusText}`));
+            return undefined;
+        }
+        const pgnText = await response.text();
+        const filteredPgn = filterPgnByIds(pgnText, filterIds);
+        if (!filteredPgn) {
+            console.error(colors_1.default.red(`No games found matching the provided filter IDs.`));
+            return undefined;
+        }
+        return filteredPgn;
+    }
+    else {
+        const resolvedPath = node_path_1.default.resolve(pgnURL);
+        const stats = await (0, promises_1.readFile)(resolvedPath, { encoding: "utf-8" }).catch((err) => {
+            console.error(colors_1.default.red(`Failed to read PGN file: ${err.message}`));
+            return undefined;
+        });
+        if (!stats)
+            return undefined;
+        return stats.toString();
+    }
+};
+const loop = async (roundInfo, pgnPath, loopTimer, filterIds) => {
+    while (true) {
+        const pgnContent = await readPGNFromURL(pgnPath, filterIds);
+        if (pgnContent)
+            await pushPGN(roundInfo, pgnContent);
+        await (0, commandHandler_1.sleep)(loopTimer * 1000);
+    }
+};
+const pushFilterIDCommand = async (args) => {
+    await (0, commandHandler_1.checkTokenScopes)();
+    const [roundId, pgnPath] = args.slice(0, 2);
+    const filterIds = args
+        .slice(2)
+        .filter((arg) => !arg.startsWith("--") && Number.isInteger(parseInt(arg)))
+        .map((arg) => parseInt(arg, 10));
+    if (!roundId || !pgnPath || filterIds.length === 0) {
+        (0, commandHandler_1.msgCommonErrorHelp)("Round ID, PGN, and at least one filter ID are required.");
+        (0, node_process_1.exit)(1);
+    }
+    const roundInfo = await (0, getInfoBroadcast_1.getBroadcastRound)(roundId);
+    if (!roundInfo) {
+        console.error(colors_1.default.red("Round not found."));
+        (0, node_process_1.exit)(1);
+    }
+    const loopArgIndex = args.findIndex((arg) => arg === "--loop");
+    let loopTimer = undefined;
+    if (loopArgIndex !== -1 && loopArgIndex + 1 < args.length) {
+        const loopTimerStr = args[loopArgIndex + 1];
+        loopTimer = parseInt(loopTimerStr, 10);
+        if (isNaN(loopTimer) || loopTimer <= 0) {
+            console.error(colors_1.default.red("Loop timer must be a positive integer."));
+            (0, node_process_1.exit)(1);
+        }
+    }
+    if (loopTimer) {
+        console.log(colors_1.default.green(`Starting loop to push PGN every ${colors_1.default.whiteBold(loopTimer.toString())} seconds...`));
+        console.log(colors_1.default.blue("Press Ctrl+C to stop."));
+        await loop(roundInfo, pgnPath, loopTimer, filterIds);
+    }
+    else {
+        const pgnContent = await readPGNFromURL(pgnPath, filterIds);
+        if (pgnContent)
+            await pushPGN(roundInfo, pgnContent);
+    }
+};
+exports.pushFilterIDCommand = pushFilterIDCommand;

package/dist/utils/commandHandler.js

@@ -18,6 +18,7 @@ const startsPrevious_1 = require("../cmd/startsPrevious");
 const period_1 = require("../cmd/period");
 const score_1 = require("../cmd/score");
 const push_1 = require("../cmd/push");
+const pushFilterID_1 = require("../cmd/pushFilterID");
 const login_1 = require("../cmd/login");
 const credentials_1 = require("./credentials");
 const getToken = () => {
@@ -47,6 +48,7 @@ var Command;
     Command["Period"] = "period";
     Command["Score"] = "score";
     Command["Push"] = "push";
+    Command["PushFilterID"] = "pushFilterID";
 })(Command || (exports.Command = Command = {}));
 exports.commands = new Map([
     [Command.Login, login_1.loginCommand],
@@ -59,6 +61,7 @@ exports.commands = new Map([
     [Command.Period, period_1.periodCommand],
     [Command.Score, score_1.scoreCommand],
     [Command.Push, push_1.pushCommand],
+    [Command.PushFilterID, pushFilterID_1.pushFilterIDCommand],
 ]);
 exports.client = (0, openapi_fetch_1.default)({
     baseUrl: LICHESS_DOMAIN,

package/dist/utils/help.js

@@ -81,6 +81,13 @@ const helpPush = [
     `     ${colors_1.default.bold("Options:")}`,
     `       --loop <intervalInSeconds>   ${colors_1.default.gray("Continuously push the PGN file at the specified interval in seconds.")}`,
 ].join("\n");
+const helpPushFilterID = [
+    `  ${colors_1.default.underItalic("pushFilterID <roundId> <PGNFromPathOrUrl> <FideIds...> [--loop <intervalInSeconds>]")}`,
+    `     ${colors_1.default.gray("Upload a PGN file from a local path or URL to the specified broadcast round, filtering games by FIDE ID.")}`,
+    `     ${colors_1.default.bold("Note:")} ${colors_1.default.gray("The PGN file must be accessible from the provided path or URL.")}`,
+    `     ${colors_1.default.bold("Options:")}`,
+    `       --loop <intervalInSeconds>   ${colors_1.default.gray("Continuously push the PGN file at the specified interval in seconds.")}`,
+].join("\n");
 const msg = [
     `${colors_1.default.boldYellow("Usage:")} ${colors_1.default.underItalic("<command> [options]")}`,
     ``,
@@ -106,6 +113,8 @@ const msg = [
     ``,
     helpPush,
     ``,
+    helpPushFilterID,
+    ``,
     ``,
     `${colors_1.default.boldYellow("Examples:")}`,
     `   ${colors_1.default.gray("# Login with your Lichess token (interactive)")}`,
@@ -132,6 +141,8 @@ const msg = [
     `     $ ${colors_1.default.underItalic("score")} ${colors_1.default.italic("bcast123 1.0 0.5 1.0 0.5")}`,
     `   ${colors_1.default.gray("# Push a PGN file in loop mode every 60 seconds")}`,
     `     $ ${colors_1.default.underItalic("push")} ${colors_1.default.italic("round456 /path/to/localfile.pgn --loop 60")}`,
+    `   ${colors_1.default.gray("# Push a PGN file from URL filtering by FIDE IDs in loop mode every 120 seconds")}`,
+    `     $ ${colors_1.default.underItalic("pushFilterID")} ${colors_1.default.italic("round456 https://example.com/games.pgn 12345 67890 --loop 120")}`,
 ];
 const showHelp = (cmd) => {
     const ranges = {
@@ -145,6 +156,7 @@ const showHelp = (cmd) => {
         [commandHandler_1.Command.Period]: helpSetPeriod,
         [commandHandler_1.Command.Score]: helpScore,
         [commandHandler_1.Command.Push]: helpPush,
+        [commandHandler_1.Command.PushFilterID]: helpPushFilterID,
     };
     const range = cmd ? ranges[cmd] : undefined;
     console.info(range ? range : msg.join("\n"));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libroadcast-cli",
-  "version": "2.3.0",
+  "version": "2.4.0",
   "description": "CLI to help with broadcast maintenance on Lichess",
   "main": "dist/index.js",
   "keywords": [
@@ -14,11 +14,12 @@
   "dependencies": {
     "@lichess-org/types": "^2.0.109",
     "@types/node": "~24.10.4",
+    "chessops": "^0.15.0",
     "ms": "3.0.0-canary.202508261828",
     "openapi-fetch": "^0.15.0"
   },
   "devDependencies": {
-    "prettier": "3.7.4",
+    "prettier": "3.8.1",
     "typescript": "^5.9.3"
   },
   "engines": {