libroadcast-cli 2.9.0 → 2.11.0

package/README.md

@@ -48,6 +48,12 @@ Commands:
      Sets the games for the specified broadcast round using Lichess game IDs.
      Note: Maximum of 64 game IDs can be provided.
 
+  setLichessGamesMulti "<broadcastRoundIds...>" "<gameIds...>"
+     Sets the games for multiple broadcast rounds using Lichess game IDs.
+     The first argument is a space-separated list of broadcast round IDs, and the second argument is a space-separated list of game IDs.
+     The command will distribute the provided game IDs across the specified broadcast round IDs.
+     Note: Maximum of 64 game IDs can be provided. The number of game IDs should ideally be a multiple of the number of broadcast round IDs for even distribution.
+
   fixSchedule <broadcastId> <timeDiff> [--rounds <roundsToFix>]
      Fixes the schedule of rounds in the specified broadcast by applying a time difference.
      Note: The time difference should be in a format like "1h", "30m", "15s", etc.
@@ -92,6 +98,11 @@ Commands:
      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)
      $ login
@@ -107,6 +118,8 @@ Examples:
      $ setPGNMulti bcast123 https://example.com/pgns/round-{r}/game-{g}.pgn 12 --withFilter --onlyGames "1-5,7,9-12"
    # Set Lichess games for a broadcast round
      $ setLichessGames round456 gameId1 gameId2 gameId3
+   # Set Lichess games for multiple broadcast rounds
+     $ setLichessGamesMulti "roundId1 roundId2 roundId3" "gameId1 gameId2 gameId3"
    # Fix schedule of rounds 1 to 4 and all rounds after 8 by adding 15 minutes
      $ fixSchedule bcast123 15m --rounds 1-4,8+
    # Set startsAfterPrevious to true for all rounds in a broadcast
@@ -121,6 +134,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/setLichessGamesMulti.js

@@ -0,0 +1,38 @@
+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 splitIdsIntoGroups = (broadcastsIds, gameIds) => gameIds.reduce((groups, id, index) => {
+    groups[index % broadcastsIds.length].push(id);
+    return groups;
+}, broadcastsIds.map(() => []));
+export const setLichessGamesMultiCommand = async (args) => {
+    await checkTokenScopes();
+    const bIds = args.shift()?.split(" ");
+    const gamesIDs = args.shift()?.split(" ");
+    if (!bIds || !gamesIDs) {
+        msgCommonErrorHelp("Broadcast ID and games IDs are required.");
+        exit(1);
+    }
+    const groups = splitIdsIntoGroups(bIds, gamesIDs);
+    for (let [index, group] of groups.entries()) {
+        const roundId = bIds[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/utils/commandHandler.js

@@ -18,6 +18,8 @@ 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";
+import { setLichessGamesMultiCommand } from "../cmd/setLichessGamesMulti.js";
 const getToken = () => {
     const stored = getStoredCredentials();
     const envToken = process.env.LICHESS_TOKEN;
@@ -41,6 +43,7 @@ export var Command;
     Command["SetPGN"] = "setPGN";
     Command["SetPGNMulti"] = "setPGNMulti";
     Command["SetLichessGames"] = "setLichessGames";
+    Command["SetLichessGamesMulti"] = "setLichessGamesMulti";
     Command["FixSchedule"] = "fixSchedule";
     Command["StartsPrevious"] = "startsPrevious";
     Command["Period"] = "period";
@@ -49,6 +52,7 @@ export var Command;
     Command["PushFilterID"] = "pushFilterID";
     Command["ConvertNamesToID"] = "convertNamesToID";
     Command["PushReorder"] = "pushReorder";
+    Command["BulkIDsMulti"] = "bulkIDsMulti";
 })(Command || (Command = {}));
 export const commands = new Map([
     [Command.Login, loginCommand],
@@ -56,6 +60,7 @@ export const commands = new Map([
     [Command.SetPGN, setPGNCommand],
     [Command.SetPGNMulti, setPGNMultiCommand],
     [Command.SetLichessGames, setLichessGamesCommand],
+    [Command.SetLichessGamesMulti, setLichessGamesMultiCommand],
     [Command.FixSchedule, fixScheduleCommand],
     [Command.StartsPrevious, startsPreviousCommand],
     [Command.Period, periodCommand],
@@ -64,6 +69,7 @@ export const commands = new Map([
     [Command.PushFilterID, pushFilterIDCommand],
     [Command.ConvertNamesToID, convertNamesToIDCommand],
     [Command.PushReorder, pushReorderCommand],
+    [Command.BulkIDsMulti, bulkIDsMultiCommand],
 ]);
 export const client = createClient({
     baseUrl: LICHESS_DOMAIN,

package/dist/utils/help.js

@@ -42,6 +42,13 @@ const helpSetLichessGames = [
     `     ${cl.gray("Sets the games for the specified broadcast round using Lichess game IDs.")}`,
     `     ${cl.bold("Note:")} ${cl.gray("Maximum of 64 game IDs can be provided.")}`,
 ].join("\n");
+const helpSetLichessGamesMulti = [
+    `  ${cl.underItalic('setLichessGamesMulti "<broadcastRoundIds...>" "<gameIds...>"')}`,
+    `     ${cl.gray("Sets the games for multiple broadcast rounds using Lichess game IDs.")}`,
+    `     ${cl.gray("The first argument is a space-separated list of broadcast round IDs, and the second argument is a space-separated list of game IDs.")}`,
+    `     ${cl.gray("The command will distribute the provided game IDs across the specified broadcast round IDs.")}`,
+    `     ${cl.bold("Note:")} ${cl.gray("Maximum of 64 game IDs can be provided. The number of game IDs should ideally be a multiple of the number of broadcast round IDs for even distribution.")}`,
+].join("\n");
 const helpFixSchedule = [
     `  ${cl.underItalic("fixSchedule <broadcastId> <timeDiff> [--rounds <roundsToFix>]")}`,
     `     ${cl.gray("Fixes the schedule of rounds in the specified broadcast by applying a time difference.")}`,
@@ -94,6 +101,11 @@ const helpPushReorder = [
     `     ${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]")}`,
     ``,
@@ -109,6 +121,8 @@ const msg = [
     ``,
     helpSetLichessGames,
     ``,
+    helpSetLichessGamesMulti,
+    ``,
     helpFixSchedule,
     ``,
     helpStartsPrevious,
@@ -125,6 +139,9 @@ const msg = [
     ``,
     helpPushReorder,
     ``,
+    helpBulkIDsMulti,
+    ``,
+    ``,
     `${cl.boldYellow("Examples:")}`,
     `   ${cl.gray("# Login with your Lichess token (interactive)")}`,
     `     $ ${cl.underItalic("login")}`,
@@ -140,6 +157,8 @@ const msg = [
     `     $ ${cl.underItalic("setPGNMulti")} ${cl.italic('bcast123 https://example.com/pgns/round-{r}/game-{g}.pgn 12 --withFilter --onlyGames "1-5,7,9-12"')}`,
     `   ${cl.gray("# Set Lichess games for a broadcast round")}`,
     `     $ ${cl.underItalic("setLichessGames")} ${cl.italic("round456 gameId1 gameId2 gameId3")}`,
+    `   ${cl.gray("# Set Lichess games for multiple broadcast rounds")}`,
+    `     $ ${cl.underItalic("setLichessGamesMulti")} ${cl.italic('"roundId1 roundId2 roundId3" "gameId1 gameId2 gameId3"')}`,
     `   ${cl.gray("# Fix schedule of rounds 1 to 4 and all rounds after 8 by adding 15 minutes")}`,
     `     $ ${cl.underItalic("fixSchedule")} ${cl.italic("bcast123 15m --rounds 1-4,8+")}`,
     `   ${cl.gray("# Set startsAfterPrevious to true for all rounds in a broadcast")}`,
@@ -154,6 +173,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 = {
@@ -162,6 +183,7 @@ export const showHelp = (cmd) => {
         [Command.SetPGN]: helpSetPGN,
         [Command.SetPGNMulti]: helpSetPGNMulti,
         [Command.SetLichessGames]: helpSetLichessGames,
+        [Command.SetLichessGamesMulti]: helpSetLichessGamesMulti,
         [Command.FixSchedule]: helpFixSchedule,
         [Command.StartsPrevious]: helpStartsPrevious,
         [Command.Period]: helpSetPeriod,
@@ -170,6 +192,7 @@ export const showHelp = (cmd) => {
         [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.9.0",
+  "version": "2.11.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.12.0",
     "chessops": "^0.15.0",
     "ms": "3.0.0-canary.202508261828",
     "openapi-fetch": "^0.17.0"