libroadcast-cli 2.7.0 → 2.9.0

package/README.md

@@ -76,13 +76,21 @@ Commands:
      Options:
        --loop <intervalInSeconds>   Continuously push the PGN file at the specified interval in seconds.
 
-  pushFilterID <roundId> <PGNFromPathOrUrl> <FideIds...> [--loop <intervalInSeconds>] [--firstOngoing]
+  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.
-       --firstOngoing               Push the first ongoing games in each round.
 
+  convertNamesToID <roundId>
+     Convert Lichess Usernames source to Lichess Game IDs source for the specified broadcast round.
+     Note: This command will fetch the source PGN, extract Lichess Game IDs from the PGN headers, and update the broadcast round to use these game IDs as the source.
+
+  pushReorder <roundId> <PGNFromPathOrUrl> [--loop <intervalInSeconds>]
+     Upload a PGN file from a local path or URL to the specified broadcast round, reordering games by round number.
+     Note: The PGN file must be accessible from the provided path or URL. Games will be reordered based on the 'Round' header in the PGN.
+     Options:
+       --loop <intervalInSeconds>   Continuously push the PGN file at the specified interval in seconds.
 
 Examples:
    # Login with your Lichess token (interactive)
@@ -111,6 +119,8 @@ Examples:
      $ 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
+   # Convert Lichess Usernames source to Lichess Game IDs source for a broadcast round
+     $ convertNamesToID round456
 ```
 
 ### Test Docker Build Locally

package/dist/cmd/convertNamesToID.js

@@ -0,0 +1,50 @@
+import { exit } from "node:process";
+import { msgCommonErrorHelp, checkTokenScopes, client, handleApiResponse, } from "../utils/commandHandler.js";
+import { parsePgn } from "chessops/pgn";
+import { getBroadcastRound } from "../utils/getInfoBroadcast.js";
+import cl from "../utils/colors.js";
+const setGameIds = (roundInfo, gameIds) => handleApiResponse(client.POST("/broadcast/round/{broadcastRoundId}/edit", {
+    params: {
+        path: { broadcastRoundId: roundInfo.id },
+        query: { patch: 1 },
+    },
+    body: {
+        syncSource: "ids",
+        syncIds: gameIds,
+    },
+}), `Successfully set game IDs for round ${cl.whiteBold(roundInfo.id)}.`, `Error setting game IDs for round ${cl.whiteBold(roundInfo.id)}`);
+const getGameIdFromPgn = async (roundId) => {
+    const response = await client.GET("/api/broadcast/round/{broadcastRoundId}.pgn", {
+        params: { path: { broadcastRoundId: roundId } },
+        parseAs: "text",
+    });
+    if (!response.response.ok) {
+        console.error(cl.red("Failed to fetch PGN for the round."));
+        exit(1);
+    }
+    const pgn = parsePgn(response.data);
+    const gamesWithIds = pgn
+        .map((game) => game.headers.get("GameId") || null)
+        .filter((id) => typeof id === "string");
+    return gamesWithIds;
+};
+export const convertNamesToIDCommand = async (args) => {
+    await checkTokenScopes();
+    const [roundId] = args.slice(0, 1);
+    if (!roundId) {
+        msgCommonErrorHelp("Round ID is required.");
+        exit(1);
+    }
+    const roundInfo = await getBroadcastRound(roundId);
+    if (!roundInfo) {
+        console.error(cl.red("Round not found."));
+        exit(1);
+    }
+    const gameIds = await getGameIdFromPgn(roundId);
+    if (gameIds.length === 0) {
+        console.error(cl.red("No games with GameId found in the PGN."));
+        exit(1);
+    }
+    const IdsString = gameIds.join(" ");
+    await setGameIds(roundInfo, IdsString);
+};

package/dist/cmd/pushReorder.js

@@ -0,0 +1,61 @@
+import { exit } from "node:process";
+import { msgCommonErrorHelp, sleep, checkTokenScopes, } from "../utils/commandHandler.js";
+import { parsePgn, makePgn } from "chessops/pgn";
+import { getBroadcastRound } from "../utils/getInfoBroadcast.js";
+import cl from "../utils/colors.js";
+import { loopChecker, pushPGN, readPGNFromURL } from "../utils/pushTools.js";
+const sortPgn = (pgn) => {
+    const parsed = parsePgn(pgn);
+    let sortedGames = parsed.sort((a, b) => {
+        const roundA = parseInt(a.headers.get("Round")?.split(".")[1] || "0", 10);
+        const roundB = parseInt(b.headers.get("Round")?.split(".")[1] || "0", 10);
+        return roundA - roundB;
+    });
+    return sortedGames.map((game) => makePgn(game)).join("\n\n");
+};
+let lastPGN = "";
+const loop = async (roundInfo, pgnPath, loopTimer) => {
+    while (true) {
+        const pgnContent = await readPGNFromURL(pgnPath);
+        if (!pgnContent) {
+            console.error(cl.red(`Failed to read PGN content. Retrying in ${loopTimer} seconds...`));
+            await sleep(loopTimer * 1000);
+            continue;
+        }
+        const filteredPgn = sortPgn(pgnContent);
+        if (filteredPgn && filteredPgn !== lastPGN) {
+            await pushPGN(roundInfo, filteredPgn);
+            lastPGN = filteredPgn;
+        }
+        await sleep(loopTimer * 1000);
+    }
+};
+export const pushReorderCommand = async (args) => {
+    await checkTokenScopes();
+    const [roundId, pgnPath] = args.slice(0, 2);
+    if (!roundId || !pgnPath) {
+        msgCommonErrorHelp("Round ID and PGN path are required.");
+        exit(1);
+    }
+    const roundInfo = await getBroadcastRound(roundId);
+    if (!roundInfo) {
+        console.error(cl.red("Round not found."));
+        exit(1);
+    }
+    const loopTimer = loopChecker(args);
+    if (loopTimer) {
+        console.log(cl.green(`Starting loop to push reordered PGN every ${cl.whiteBold(loopTimer.toString())} seconds...`));
+        console.log(cl.blue("Press Ctrl+C to stop."));
+        await loop(roundInfo, pgnPath, loopTimer);
+    }
+    else {
+        const pgnContent = await readPGNFromURL(pgnPath);
+        if (!pgnContent) {
+            console.error(cl.red(`Failed to read PGN content.`));
+            exit(1);
+        }
+        const filteredPgn = sortPgn(pgnContent);
+        if (filteredPgn)
+            await pushPGN(roundInfo, filteredPgn);
+    }
+};

package/dist/utils/commandHandler.js

@@ -16,6 +16,8 @@ import { pushCommand } from "../cmd/push.js";
 import { pushFilterIDCommand } from "../cmd/pushFilterID.js";
 import { loginCommand } from "../cmd/login.js";
 import { getStoredCredentials } from "./credentials.js";
+import { convertNamesToIDCommand } from "../cmd/convertNamesToID.js";
+import { pushReorderCommand } from "../cmd/pushReorder.js";
 const getToken = () => {
     const stored = getStoredCredentials();
     const envToken = process.env.LICHESS_TOKEN;
@@ -45,6 +47,8 @@ export var Command;
     Command["Score"] = "score";
     Command["Push"] = "push";
     Command["PushFilterID"] = "pushFilterID";
+    Command["ConvertNamesToID"] = "convertNamesToID";
+    Command["PushReorder"] = "pushReorder";
 })(Command || (Command = {}));
 export const commands = new Map([
     [Command.Login, loginCommand],
@@ -58,6 +62,8 @@ export const commands = new Map([
     [Command.Score, scoreCommand],
     [Command.Push, pushCommand],
     [Command.PushFilterID, pushFilterIDCommand],
+    [Command.ConvertNamesToID, convertNamesToIDCommand],
+    [Command.PushReorder, pushReorderCommand],
 ]);
 export const client = createClient({
     baseUrl: LICHESS_DOMAIN,

package/dist/utils/help.js

@@ -82,6 +82,18 @@ const helpPushFilterID = [
     `     ${cl.bold("Options:")}`,
     `       --loop <intervalInSeconds>   ${cl.gray("Continuously push the PGN file at the specified interval in seconds.")}`,
 ].join("\n");
+const helpConvertNamesToID = [
+    `  ${cl.underItalic("convertNamesToID <roundId>")}`,
+    `     ${cl.gray("Convert Lichess Usernames source to Lichess Game IDs source for the specified broadcast round.")}`,
+    `     ${cl.bold("Note:")} ${cl.gray("This command will fetch the source PGN, extract Lichess Game IDs from the PGN headers, and update the broadcast round to use these game IDs as the source.")}`,
+].join("\n");
+const helpPushReorder = [
+    `  ${cl.underItalic("pushReorder <roundId> <PGNFromPathOrUrl> [--loop <intervalInSeconds>]")}`,
+    `     ${cl.gray("Upload a PGN file from a local path or URL to the specified broadcast round, reordering games by round number.")}`,
+    `     ${cl.bold("Note:")} ${cl.gray("The PGN file must be accessible from the provided path or URL. Games will be reordered based on the 'Round' header in the PGN.")}`,
+    `     ${cl.bold("Options:")}`,
+    `       --loop <intervalInSeconds>   ${cl.gray("Continuously push the PGN file at the specified interval in seconds.")}`,
+].join("\n");
 const msg = [
     `${cl.boldYellow("Usage:")} ${cl.underItalic("<command> [options]")}`,
     ``,
@@ -109,6 +121,9 @@ const msg = [
     ``,
     helpPushFilterID,
     ``,
+    helpConvertNamesToID,
+    ``,
+    helpPushReorder,
     ``,
     `${cl.boldYellow("Examples:")}`,
     `   ${cl.gray("# Login with your Lichess token (interactive)")}`,
@@ -137,6 +152,8 @@ const msg = [
     `     $ ${cl.underItalic("push")} ${cl.italic("round456 /path/to/localfile.pgn --loop 60")}`,
     `   ${cl.gray("# Push a PGN file from URL filtering by FIDE IDs in loop mode every 120 seconds")}`,
     `     $ ${cl.underItalic("pushFilterID")} ${cl.italic("round456 https://example.com/games.pgn 12345 67890 --loop 120")}`,
+    `   ${cl.gray("# Convert Lichess Usernames source to Lichess Game IDs source for a broadcast round")}`,
+    `     $ ${cl.underItalic("convertNamesToID")} ${cl.italic("round456")}`,
 ];
 export const showHelp = (cmd) => {
     const ranges = {
@@ -151,6 +168,8 @@ export const showHelp = (cmd) => {
         [Command.Score]: helpScore,
         [Command.Push]: helpPush,
         [Command.PushFilterID]: helpPushFilterID,
+        [Command.ConvertNamesToID]: helpConvertNamesToID,
+        [Command.PushReorder]: helpPushReorder,
     };
     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.7.0",
+  "version": "2.9.0",
   "description": "CLI to help with broadcast maintenance on Lichess",
   "main": "dist/index.js",
   "keywords": [
@@ -16,7 +16,7 @@
     "@types/node": "~24.10.4",
     "chessops": "^0.15.0",
     "ms": "3.0.0-canary.202508261828",
-    "openapi-fetch": "^0.15.0"
+    "openapi-fetch": "^0.17.0"
   },
   "devDependencies": {
     "prettier": "3.8.1",