libroadcast-cli 2.8.0 → 2.10.0

package/README.md

@@ -86,6 +86,16 @@ Commands:
      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.
+
+  bulkIDsMulti <bulkID> <broadcastRoundIds...>
+     Sets Lichess Game IDs for multiple broadcast rounds using a Bulk Pairing ID.
+     The command will fetch game IDs from the specified Bulk Pairing and distribute them across the provided broadcast round IDs.
+
 
 Examples:
    # Login with your Lichess token (interactive)
@@ -116,6 +126,8 @@ Examples:
      $ 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
+   # Set Lichess Game IDs from Bulk Parings for multiple rounds (roundId1, roundId2, roundId3) in a broadcast
+     $ bulkIDsMulti bulk123 roundId1 roundId2 roundId3
 ```
 
 ### Test Docker Build Locally

package/dist/cmd/bulkIDsMulti.js

@@ -0,0 +1,58 @@
+import { exit } from "node:process";
+import { client, msgCommonErrorHelp, handleApiResponse, checkTokenScopes, sleep, } from "../utils/commandHandler.js";
+import { getBroadcastRound } from "../utils/getInfoBroadcast.js";
+import cl from "../utils/colors.js";
+const setLichessGames = (round, games) => handleApiResponse(client.POST("/broadcast/round/{broadcastRoundId}/edit", {
+    params: {
+        path: { broadcastRoundId: round.id },
+        query: { patch: 1 },
+    },
+    body: {
+        syncSource: "ids",
+        syncIds: games,
+    },
+}), `Successfully set games for round ${cl.whiteBold(round.id)} to ${cl.whiteBold(games)}.`, `Error setting games for round ${cl.whiteBold(round.id)}`);
+const getBulkIds = (bulkID) => client
+    .GET("/api/bulk-pairing/{id}", {
+    params: { path: { id: bulkID } },
+})
+    .then((response) => {
+    const data = response.data;
+    let ids = data?.games
+        .map((game) => game.id)
+        .filter((id) => typeof id === "string") || [];
+    return ids;
+})
+    .catch((error) => {
+    console.error(cl.red(`Error fetching bulk pairing data: ${error.message}`));
+    return [];
+});
+const splitIdsIntoGroups = (broadcastsIds, gameIds) => gameIds.reduce((groups, id, index) => {
+    groups[index % broadcastsIds.length].push(id);
+    return groups;
+}, broadcastsIds.map(() => []));
+export const bulkIDsMultiCommand = async (args) => {
+    await checkTokenScopes();
+    const bulkID = args.shift();
+    const broadcastsIds = args;
+    if (!bulkID || !broadcastsIds) {
+        msgCommonErrorHelp("Broadcast ID and rounds IDs are required.");
+        exit(1);
+    }
+    const gameIds = await getBulkIds(bulkID);
+    if (gameIds.length === 0) {
+        console.error(cl.red(`No game IDs found for bulk ID ${cl.whiteBold(bulkID)}.`));
+        exit(1);
+    }
+    const groupedIds = splitIdsIntoGroups(broadcastsIds, gameIds);
+    for (let [index, group] of groupedIds.entries()) {
+        const roundId = broadcastsIds[index];
+        const round = await getBroadcastRound(roundId);
+        if (!round) {
+            console.error(cl.red(`Broadcast round with ID ${cl.whiteBold(roundId)} not found or has no rounds.`));
+            continue;
+        }
+        await setLichessGames(round, group.join(" "));
+        await sleep(500);
+    }
+};

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

@@ -17,6 +17,8 @@ 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";
+import { bulkIDsMultiCommand } from "../cmd/bulkIDsMulti.js";
 const getToken = () => {
     const stored = getStoredCredentials();
     const envToken = process.env.LICHESS_TOKEN;
@@ -47,6 +49,8 @@ export var Command;
     Command["Push"] = "push";
     Command["PushFilterID"] = "pushFilterID";
     Command["ConvertNamesToID"] = "convertNamesToID";
+    Command["PushReorder"] = "pushReorder";
+    Command["BulkIDsMulti"] = "bulkIDsMulti";
 })(Command || (Command = {}));
 export const commands = new Map([
     [Command.Login, loginCommand],
@@ -61,6 +65,8 @@ export const commands = new Map([
     [Command.Push, pushCommand],
     [Command.PushFilterID, pushFilterIDCommand],
     [Command.ConvertNamesToID, convertNamesToIDCommand],
+    [Command.PushReorder, pushReorderCommand],
+    [Command.BulkIDsMulti, bulkIDsMultiCommand],
 ]);
 export const client = createClient({
     baseUrl: LICHESS_DOMAIN,

package/dist/utils/help.js

@@ -87,6 +87,18 @@ const helpConvertNamesToID = [
     `     ${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 helpBulkIDsMulti = [
+    `  ${cl.underItalic("bulkIDsMulti <bulkID> <broadcastRoundIds...>")}`,
+    `     ${cl.gray("Sets Lichess Game IDs for multiple broadcast rounds using a Bulk Pairing ID.")}`,
+    `     ${cl.gray("The command will fetch game IDs from the specified Bulk Pairing and distribute them across the provided broadcast round IDs.")}`,
+].join("\n");
 const msg = [
     `${cl.boldYellow("Usage:")} ${cl.underItalic("<command> [options]")}`,
     ``,
@@ -116,6 +128,10 @@ const msg = [
     ``,
     helpConvertNamesToID,
     ``,
+    helpPushReorder,
+    ``,
+    helpBulkIDsMulti,
+    ``,
     ``,
     `${cl.boldYellow("Examples:")}`,
     `   ${cl.gray("# Login with your Lichess token (interactive)")}`,
@@ -146,6 +162,8 @@ const msg = [
     `     $ ${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")}`,
+    `   ${cl.gray("# Set Lichess Game IDs from Bulk Parings for multiple rounds (roundId1, roundId2, roundId3) in a broadcast")}`,
+    `     $ ${cl.underItalic("bulkIDsMulti")} ${cl.italic("bulk123 roundId1 roundId2 roundId3")}`,
 ];
 export const showHelp = (cmd) => {
     const ranges = {
@@ -161,6 +179,8 @@ export const showHelp = (cmd) => {
         [Command.Push]: helpPush,
         [Command.PushFilterID]: helpPushFilterID,
         [Command.ConvertNamesToID]: helpConvertNamesToID,
+        [Command.PushReorder]: helpPushReorder,
+        [Command.BulkIDsMulti]: helpBulkIDsMulti,
     };
     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.8.0",
+  "version": "2.10.0",
   "description": "CLI to help with broadcast maintenance on Lichess",
   "main": "dist/index.js",
   "keywords": [
@@ -13,7 +13,7 @@
   "type": "module",
   "dependencies": {
     "@lichess-org/types": "^2.0.109",
-    "@types/node": "~24.10.4",
+    "@types/node": "~24.11.0",
     "chessops": "^0.15.0",
     "ms": "3.0.0-canary.202508261828",
     "openapi-fetch": "^0.17.0"