libroadcast-cli 1.3.3 → 1.4.0

package/README.md

@@ -19,6 +19,7 @@ Usage: <command> [options]
 Commands:
   delay <broadcastId> <delayInSeconds> [--onlyDelay] [--noDelay]
      Sets the delay for all rounds in the specified broadcast.
+     The delay is specified in seconds. (max 3600 seconds = 1 hour)
      Options:
        --onlyDelay   Set only the delay without changing the start time.
        --noDelay     Remove the delay from the rounds.
@@ -29,8 +30,12 @@ Commands:
      Options:
        --withFilter    Apply round number filtering based on round number.
        --slice <sliceFilter>  Apply slice filtering using the provided filter string.
+  setLichessGames <broadcastRoundId> <gameIds...>
+     Sets the games for the specified broadcast round using Lichess game IDs.
+     Note: Maximum of 64 game IDs can be provided.
 
 Examples:
   delay bcast123 300 --onlyDelay # Set a 5-minute delay without changing start time
-  setPGN bcast123 https://example.com/pgns/round-{}/game.pgn --withFilter --slice "1-5,7,9-12"  
+  setPGN bcast123 https://example.com/pgns/round-{}/game.pgn --withFilter --slice "1-5,7,9-12"
+  setLichessGames round456 gameId1 gameId2 gameId3 # Set specific games for the round 
 ```

package/dist/cmd/delay.js

@@ -1,10 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.delayCommand = void 0;
-const utils_1 = require("../utils");
+const node_process_1 = require("node:process");
+const commandHandler_1 = require("../utils/commandHandler");
+const getInfoBroadcast_1 = require("../utils/getInfoBroadcast");
 const setDelayRounds = async (rounds, delay, onlyDelay, noDelay) => {
     for (const round of rounds) {
-        await utils_1.client
+        await commandHandler_1.client
             .POST("/broadcast/round/{broadcastRoundId}/edit", {
             params: {
                 path: { broadcastRoundId: round.id },
@@ -26,34 +28,30 @@ const setDelayRounds = async (rounds, delay, onlyDelay, noDelay) => {
             .catch((error) => {
             console.error(`Error setting delay for round ${round.id}:`, error);
         });
-        await (0, utils_1.sleep)(200);
+        await (0, commandHandler_1.sleep)(200);
     }
 };
 const delayCommand = async (args) => {
     const [broadcastId, delay] = args.slice(0, 2);
-    if (args.includes("--help") || args.includes("-h")) {
-        (0, utils_1.showHelp)(utils_1.Command.Delay);
-        process.exit(0);
-    }
     if (!broadcastId || !delay) {
-        (0, utils_1.showHelp)(utils_1.Command.Delay);
-        process.exit(1);
+        (0, commandHandler_1.msgCommonErrorHelp)("Broadcast ID and delay are required.");
+        (0, node_process_1.exit)(1);
     }
     const delayNum = parseInt(delay, 10);
     if (isNaN(delayNum) && delayNum >= 0 && delayNum <= 3600) {
-        console.error("Delay must be a number between 0 and 3600 seconds.");
-        process.exit(1);
+        (0, commandHandler_1.msgCommonErrorHelp)("Delay must be a number between 0 and 3600 seconds.");
+        (0, node_process_1.exit)(1);
     }
     const onlyDelay = args.includes("--onlyDelay");
     const noDelay = args.includes("--noDelay");
     if (onlyDelay && noDelay) {
         console.error("Cannot use --onlyDelay and --noDelay together.");
-        process.exit(1);
+        (0, node_process_1.exit)(1);
     }
-    const broadcast = await (0, utils_1.getBroadcast)(broadcastId);
+    const broadcast = await (0, getInfoBroadcast_1.getBroadcast)(broadcastId);
     if (!broadcast?.rounds || broadcast.rounds.length === 0) {
         console.error("No rounds found for the specified broadcast.");
-        process.exit(1);
+        (0, node_process_1.exit)(1);
     }
     setDelayRounds(broadcast.rounds, parseInt(delay, 10), onlyDelay, noDelay);
 };

package/dist/cmd/setLichessGames.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setLichessGamesCommand = void 0;
+const node_process_1 = require("node:process");
+const commandHandler_1 = require("../utils/commandHandler");
+const getInfoBroadcast_1 = require("../utils/getInfoBroadcast");
+const setLichessGames = (round, games) => commandHandler_1.client
+    .POST("/broadcast/round/{broadcastRoundId}/edit", {
+    params: {
+        path: { broadcastRoundId: round.id },
+        query: { patch: 1 },
+    },
+    body: {
+        syncSource: "ids",
+        syncIds: games,
+    },
+})
+    .then((response) => {
+    if (response.response.ok)
+        console.log(`Successfully set games for round ${round.id} to ${games}.`);
+    else
+        console.error(`Failed to set games for round ${round.id}: ${response.response.statusText}`);
+})
+    .catch((error) => {
+    console.error(`Error setting games for round ${round.id}:`, error);
+});
+const setLichessGamesCommand = async (args) => {
+    const bId = args.shift();
+    const games = args.slice(0, 64).join(" ");
+    if (!bId || !games) {
+        (0, commandHandler_1.msgCommonErrorHelp)("Broadcast ID and games IDs are required.");
+        (0, node_process_1.exit)(1);
+    }
+    const round = await (0, getInfoBroadcast_1.getBroadcastRound)(bId);
+    if (!round) {
+        console.error(`Broadcast round with ID ${bId} not found or has no rounds.`);
+        (0, node_process_1.exit)(1);
+    }
+    setLichessGames(round, games);
+};
+exports.setLichessGamesCommand = setLichessGamesCommand;

package/dist/cmd/setPGN.js

@@ -1,12 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.setPGNCommand = void 0;
-const utils_1 = require("../utils");
+const node_process_1 = require("node:process");
+const commandHandler_1 = require("../utils/commandHandler");
+const getInfoBroadcast_1 = require("../utils/getInfoBroadcast");
 const setPGN = async (rounds, urlRound, setRoundFilter, setSliceFilter = null) => {
     for (let rN = 1; rN <= rounds.length; rN++) {
         const round = rounds[rN - 1];
         const url = urlRound(rN);
-        await utils_1.client
+        await commandHandler_1.client
             .POST("/broadcast/round/{broadcastRoundId}/edit", {
             params: {
                 path: { broadcastRoundId: round.id },
@@ -21,30 +23,26 @@ const setPGN = async (rounds, urlRound, setRoundFilter, setSliceFilter = null) =
         })
             .then((response) => {
             if (response.response.ok)
-                console.log(`Successfully set source LCC for round ${round.id} to ${url}.`);
+                console.log(`Successfully set source for round ${round.id} to ${url}.`);
             else
-                console.error(`Failed to set source LCC for round ${round.id}: ${response.response.statusText}`);
+                console.error(`Failed to set source for round ${round.id}: ${response.response.statusText}`);
         })
             .catch((error) => {
-            console.error(`Error setting source LCC for round ${round.id}:`, error);
+            console.error(`Error setting source for round ${round.id}:`, error);
         });
-        await (0, utils_1.sleep)(200);
+        await (0, commandHandler_1.sleep)(200);
     }
 };
 const setPGNCommand = async (args) => {
     const [bId, sourcePGN] = args.slice(0, 2);
-    if (args.includes("--help") || args.includes("-h")) {
-        (0, utils_1.showHelp)(utils_1.Command.SetPGN);
-        process.exit(0);
-    }
     if (!bId || !sourcePGN) {
-        (0, utils_1.showHelp)(utils_1.Command.SetPGN);
-        process.exit(1);
+        (0, commandHandler_1.msgCommonErrorHelp)("Broadcast ID and source PGN URL are required.");
+        (0, node_process_1.exit)(1);
     }
-    const bcast = await (0, utils_1.getBroadcast)(bId);
+    const bcast = await (0, getInfoBroadcast_1.getBroadcast)(bId);
     if (!bcast?.rounds || bcast.rounds.length === 0) {
-        console.error("No rounds found for the specified broadcast.");
-        process.exit(1);
+        (0, commandHandler_1.msgCommonErrorHelp)("No rounds found for the specified broadcast.");
+        (0, node_process_1.exit)(1);
     }
     const urlRound = (roundNum) => roundNum ? sourcePGN.replaceAll("{}", roundNum.toString()) : sourcePGN;
     let isLCC = false;
@@ -57,11 +55,10 @@ const setPGNCommand = async (args) => {
             throw new Error();
     }
     catch {
-        if (isLCC)
-            console.error('Invalid URL. For livechesscloud URLs, please ensure it ends with "/{}".');
-        else
-            console.error('Invalid URL. Must be http/https with "{}" as round placeholder.');
-        process.exit(1);
+        console.error(isLCC
+            ? 'Invalid URL. For livechesscloud URLs, please ensure it ends with "/{}".'
+            : 'Invalid URL. Must be http/https with "{}" as round placeholder.');
+        (0, node_process_1.exit)(1);
     }
     const setRoundFilter = args.includes("--withFilter");
     const sliceIndex = args.indexOf("--slice");

package/dist/index.js

@@ -1,37 +1,34 @@
 #!/usr/bin/env node
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-const process_1 = require("process");
-const utils_1 = require("./utils");
-const delay_1 = require("./cmd/delay");
-const setPGN_1 = require("./cmd/setPGN");
-if (!utils_1.LICHESS_TOKEN) {
-    console.error("Error: LICHESS_TOKEN environment variable is not set.");
-    process.exit(1);
-}
-const args = process_1.argv.slice(2);
+const node_process_1 = require("node:process");
+const commandHandler_1 = require("./utils/commandHandler");
+const help_1 = require("./utils/help");
 (async () => {
-    if (args.includes("--version") || args.includes("-v")) {
+    if (commandHandler_1.args.includes("--version") || commandHandler_1.args.includes("-v")) {
         const { version } = require("../package.json");
         console.log(`libroadcast-cli v${version}`);
-        process.exit(0);
+        (0, node_process_1.exit)(0);
     }
-    if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
-        (0, utils_1.showHelp)();
-        process.exit(0);
+    if (commandHandler_1.args.length === 0 || (0, help_1.includeHelp)(commandHandler_1.args[0])) {
+        (0, help_1.showHelp)();
+        (0, node_process_1.exit)(0);
     }
-    const command = args.shift();
-    const commands = new Map([
-        [utils_1.Command.Delay, delay_1.delayCommand],
-        [utils_1.Command.SetLCC, setPGN_1.setPGNCommand],
-        [utils_1.Command.SetPGN, setPGN_1.setPGNCommand],
-    ]);
-    const handler = commands.get(command);
-    if (command === utils_1.Command.SetLCC)
+    const cmd = commandHandler_1.args.shift();
+    const handler = commandHandler_1.commands.get(cmd);
+    if (cmd === commandHandler_1.Command.SetLCC)
         console.warn("Warning: 'setLCC' command was removed. Will use 'setPGN' instead.");
+    if (commandHandler_1.args.find(help_1.includeHelp)) {
+        (0, help_1.showHelp)(cmd);
+        (0, node_process_1.exit)(0);
+    }
     if (!handler) {
-        console.error("Unknown command. Supported commands: delay, setLCC, setPGN");
-        process.exit(1);
+        console.error("Error: Command handler not found.");
+        (0, node_process_1.exit)(1);
+    }
+    if (!commandHandler_1.LICHESS_TOKEN) {
+        console.error("Error: LICHESS_TOKEN environment variable is not set.");
+        (0, node_process_1.exit)(1);
     }
-    await handler(args);
+    await handler(commandHandler_1.args);
 })();

package/dist/utils/commandHandler.js

@@ -0,0 +1,41 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.msgCommonErrorHelp = exports.sleep = exports.client = exports.commands = exports.Command = exports.args = exports.LICHESS_TOKEN = void 0;
+const node_process_1 = require("node:process");
+const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
+const delay_1 = require("../cmd/delay");
+const setPGN_1 = require("../cmd/setPGN");
+const setLichessGames_1 = require("../cmd/setLichessGames");
+exports.LICHESS_TOKEN = node_process_1.env.LICHESS_TOKEN;
+const LICHESS_DOMAIN = node_process_1.env.LICHESS_DOMAIN || "https://lichess.org/";
+exports.args = node_process_1.argv.slice(2);
+var Command;
+(function (Command) {
+    Command["Delay"] = "delay";
+    Command["SetLCC"] = "setLCC";
+    Command["SetPGN"] = "setPGN";
+    Command["SetLichessGames"] = "setLichessGames";
+})(Command || (exports.Command = Command = {}));
+exports.commands = new Map([
+    [Command.Delay, delay_1.delayCommand],
+    [Command.SetLCC, setPGN_1.setPGNCommand],
+    [Command.SetPGN, setPGN_1.setPGNCommand],
+    [Command.SetLichessGames, setLichessGames_1.setLichessGamesCommand],
+]);
+exports.client = (0, openapi_fetch_1.default)({
+    baseUrl: LICHESS_DOMAIN,
+    headers: {
+        Authorization: `Bearer ${exports.LICHESS_TOKEN}`,
+        Accept: "application/json",
+    },
+});
+const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+exports.sleep = sleep;
+const msgCommonErrorHelp = (msg) => {
+    console.error(msg);
+    console.info("Use --help to see usage.");
+};
+exports.msgCommonErrorHelp = msgCommonErrorHelp;

package/dist/utils/getInfoBroadcast.js

@@ -0,0 +1,32 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getBroadcastRound = exports.getBroadcast = void 0;
+const commandHandler_1 = require("./commandHandler");
+const getBroadcast = (broadcastId) => commandHandler_1.client
+    .GET("/api/broadcast/{broadcastTournamentId}", {
+    params: {
+        path: { broadcastTournamentId: broadcastId },
+    },
+})
+    .then((response) => response.data)
+    .catch((error) => {
+    console.error("Error fetching broadcast:", error);
+    return null;
+});
+exports.getBroadcast = getBroadcast;
+const getBroadcastRound = (roundId) => commandHandler_1.client
+    .GET("/api/broadcast/{broadcastTournamentSlug}/{broadcastRoundSlug}/{broadcastRoundId}", {
+    params: {
+        path: {
+            broadcastTournamentSlug: "-",
+            broadcastRoundSlug: "-",
+            broadcastRoundId: roundId,
+        },
+    },
+})
+    .then((response) => response.data?.round)
+    .catch((error) => {
+    console.error("Error fetching broadcast round:", error);
+    return null;
+});
+exports.getBroadcastRound = getBroadcastRound;

package/dist/utils/help.js

@@ -0,0 +1,46 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.includeHelp = exports.showHelp = void 0;
+const commandHandler_1 = require("./commandHandler");
+const msg = [
+    "Usage: <command> [options]",
+    "",
+    "Commands:",
+    "  delay <broadcastId> <delayInSeconds> [--onlyDelay] [--noDelay]",
+    "     Sets the delay for all rounds in the specified broadcast.",
+    "     The delay is specified in seconds. (max 3600 seconds = 1 hour)",
+    "     Options:",
+    "       --onlyDelay   Set only the delay without changing the start time.",
+    "       --noDelay     Remove the delay from the rounds.",
+    "  setPGN <broadcastId> <sourcePGNUrl> [--withFilter] [--slice <sliceFilter>]",
+    "     Sets the source PGN URL for all rounds in the specified broadcast.",
+    "     (optional) Use '{}' in the URL as a placeholder for the round number.",
+    '       Note: For livechesscloud URLs, please ensure it ends with "/{}".',
+    "     Options:",
+    "       --withFilter    Apply round number filtering based on round number.",
+    "       --slice <sliceFilter>  Apply slice filtering using the provided filter string.",
+    "  setLichessGames <broadcastRoundId> <gameIds...>",
+    "     Sets the games for the specified broadcast round using Lichess game IDs.",
+    "     Note: Maximum of 64 game IDs can be provided.",
+    "",
+    "Examples:",
+    "  delay bcast123 300 --onlyDelay # Set a 5-minute delay without changing start time",
+    '  setPGN bcast123 https://example.com/pgns/round-{}/game.pgn --withFilter --slice "1-5,7,9-12"',
+    "  setLichessGames round456 gameId1 gameId2 gameId3 # Set specific games for the round",
+];
+const showHelp = (cmd) => {
+    const ranges = {
+        [commandHandler_1.Command.Delay]: [3, 9],
+        [commandHandler_1.Command.SetPGN]: [9, 16],
+        [commandHandler_1.Command.SetLCC]: [9, 16],
+        [commandHandler_1.Command.SetLichessGames]: [16, 19],
+    };
+    const range = cmd ? ranges[cmd] : undefined;
+    if (cmd === commandHandler_1.Command.SetLCC) {
+        console.warn("Warning: 'setLCC' command was removed. Use 'setPGN' command instead.");
+    }
+    console.info(range ? msg.slice(...range).join("\n") : msg.join("\n"));
+};
+exports.showHelp = showHelp;
+const includeHelp = (str) => ["--help", "-h"].includes(str);
+exports.includeHelp = includeHelp;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "libroadcast-cli",
-  "version": "1.3.3",
+  "version": "1.4.0",
   "description": "CLI to help with broadcast maintenance on Lichess",
   "main": "dist/index.js",
   "keywords": [

package/dist/utils.js

@@ -1,71 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.sleep = exports.getBroadcast = exports.showHelp = exports.Command = exports.client = exports.LICHESS_TOKEN = void 0;
-const process_1 = require("process");
-const openapi_fetch_1 = __importDefault(require("openapi-fetch"));
-exports.LICHESS_TOKEN = process_1.env.LICHESS_TOKEN;
-const LICHESS_DOMAIN = process_1.env.LICHESS_DOMAIN || "https://lichess.org/";
-exports.client = (0, openapi_fetch_1.default)({
-    baseUrl: LICHESS_DOMAIN,
-    headers: {
-        Authorization: `Bearer ${exports.LICHESS_TOKEN}`,
-        Accept: "application/json",
-    },
-});
-var Command;
-(function (Command) {
-    Command["Delay"] = "delay";
-    Command["SetLCC"] = "setLCC";
-    Command["SetPGN"] = "setPGN";
-})(Command || (exports.Command = Command = {}));
-const showHelp = (cmd) => {
-    const msg = [
-        "Usage: <command> [options]",
-        "",
-        "Commands:",
-        "  delay <broadcastId> <delayInSeconds> [--onlyDelay] [--noDelay]",
-        "     Sets the delay for all rounds in the specified broadcast.",
-        "     Options:",
-        "       --onlyDelay   Set only the delay without changing the start time.",
-        "       --noDelay     Remove the delay from the rounds.",
-        "  setPGN <broadcastId> <sourcePGNUrl> [--withFilter] [--slice <sliceFilter>]",
-        "     Sets the source PGN URL for all rounds in the specified broadcast.",
-        "     (optional) Use '{}' in the URL as a placeholder for the round number.",
-        "       Note: For livechesscloud URLs, please ensure it ends with \"/{}\".",
-        "     Options:",
-        "       --withFilter    Apply round number filtering based on round number.",
-        "       --slice <sliceFilter>  Apply slice filtering using the provided filter string.",
-        "",
-        "Examples:",
-        "  delay bcast123 300 --onlyDelay # Set a 5-minute delay without changing start time",
-        "  setPGN bcast123 https://example.com/pgns/round-{}/game.pgn --withFilter --slice \"1-5,7,9-12\"",
-    ];
-    const ranges = {
-        [Command.Delay]: [3, 8],
-        [Command.SetPGN]: [8, 15],
-        [Command.SetLCC]: [8, 15],
-    };
-    const range = cmd ? ranges[cmd] : undefined;
-    if (cmd === Command.SetLCC) {
-        console.warn("Warning: 'setLCC' command was removed. Use 'setPGN' command instead.");
-    }
-    console.info(range ? msg.slice(...range).join("\n") : msg.join("\n"));
-};
-exports.showHelp = showHelp;
-const getBroadcast = (broadcastId) => exports.client
-    .GET("/api/broadcast/{broadcastTournamentId}", {
-    params: {
-        path: { broadcastTournamentId: broadcastId },
-    },
-})
-    .then((response) => response.data)
-    .catch((error) => {
-    console.error("Error fetching broadcast:", error);
-    return null;
-});
-exports.getBroadcast = getBroadcast;
-const sleep = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
-exports.sleep = sleep;