@zaisma/cli 0.8.0 → 0.10.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zaisma/cli",
-  "version": "0.8.0",
+  "version": "0.10.0",
   "description": "Upload and publish browser games on Zaisma from the command line.",
   "license": "MIT",
   "homepage": "https://zaisma.com",

package/zaisma.mjs

@@ -49,6 +49,7 @@ const COMMAND_ERROR_CODES = {
   file_exists: "database export won't write over a file that's already there.",
   needs_newer_node: "Reading or writing a .sqlite file needs Node 22.13 or newer.",
   not_a_database: "The .sqlite file to import isn't a SQLite database.",
+  unknown_link: "links remove: the game has no link by that name.",
   server_unreachable: "Zaisma couldn't be reached: no connection, or a wrong ZAISMA_API.",
   unexpected_answer: "Zaisma answered without JSON, like a page from a network in between.",
 };
@@ -87,6 +88,13 @@ const COMMANDS = {
     arguments: [{ name: "slug" }, { name: "hosts", isRest: true, isOptional: true }],
     flags: { none: { hasValue: false, about: "Set the list to none: the game server calls no other servers" } },
   },
+  links: { about: "A game's registered links, which it opens with Zaisma.links.open: each name, address and who it opens for", arguments: [{ name: "slug" }], flags: {} },
+  "links set": {
+    about: "Add a link, or change the one with the same name",
+    arguments: [{ name: "slug" }, { name: "link_name" }, { name: "destination_url" }],
+    flags: { "on-game-page": { hasValue: false, about: "Show it on the game page too" } },
+  },
+  "links remove": { about: "Remove a link: the game can't open it any more", arguments: [{ name: "slug" }, { name: "link_name" }], flags: {} },
   secrets: { about: "A game's secrets, which its game server reads as server.secrets and room.secrets: their names and when each was set, never the values", arguments: [{ name: "slug" }], flags: {} },
   "secrets set": { about: "Set a secret for a game's server, replacing one of the same name: the value piped in, or typed without showing; it's never shown again", arguments: [{ name: "slug" }, { name: "secret_name" }], flags: {} },
   "secrets delete": { about: "Delete one of a game's secrets", arguments: [{ name: "slug" }, { name: "secret_name" }], flags: {} },
@@ -167,7 +175,7 @@ const COMMANDS = {
   help: { about: "This help; with --json, every command, flag, exit code and error code", arguments: [], flags: {} },
 };
 /** Commands with a second word, like zaisma forum post. */
-const SUBCOMMANDS = { forum: ["post", "message", "reply"], database: ["query", "batch", "export", "import"], saves: ["get", "change", "replace", "reset", "copies", "copy", "restore"], secrets: ["set", "delete"] };
+const SUBCOMMANDS = { links: ["set", "remove"], forum: ["post", "message", "reply"], database: ["query", "batch", "export", "import"], saves: ["get", "change", "replace", "reset", "copies", "copy", "restore"], secrets: ["set", "delete"] };
 /** Flags every command takes. */
 const GLOBAL_FLAGS = {
   json: { hasValue: false, about: "Print the API's answer as JSON, as-is (on failure its { error }), and nothing else" },
@@ -857,6 +865,35 @@ async function allowedHosts(values, flags) {
   if (given.length || flags.none) console.log("It works within a minute.");
 }
 
+/** Who a link opens for, in words (who_can_open). */
+const LINK_AUDIENCE_WORDS = { everyone: "opens for everyone", signed_in_adults: "opens for signed-in adults", nobody: "opens for nobody" };
+
+/**
+ * A game's registered links (links on the game), as the MCP's get_game and update_game: the API takes
+ * the whole list, so set and remove change it and send it back.
+ */
+async function links(command, values, flags) {
+  let answer = await api("GET", `/games/${values.slug}`);
+  if (command !== "links") {
+    const kept = answer.game.links.map((link) => ({ link_name: link.link_name, destination_url: link.destination_url, is_on_game_page: link.is_on_game_page }));
+    const others = kept.filter((link) => link.link_name !== values.link_name);
+    if (command === "links remove" && others.length === kept.length) {
+      refuse("unknown_link", { message: `${values.slug} has no link named ${values.link_name}.`, field: "link_name", fix: `zaisma links ${values.slug} lists its links.` }, EXIT_CODES.failed);
+    }
+    const changed = command === "links set" ? kept.map((link) => (link.link_name === values.link_name ? { ...link, destination_url: values.destination_url, is_on_game_page: Boolean(flags["on-game-page"]) } : link)) : others;
+    if (command === "links set" && !kept.some((link) => link.link_name === values.link_name)) changed.push({ link_name: values.link_name, destination_url: values.destination_url, is_on_game_page: Boolean(flags["on-game-page"]) });
+    answer = await api("PATCH", `/games/${values.slug}`, { links: changed });
+  }
+  if (isJson) return printJson(answer);
+  const gameLinks = answer.game.links;
+  if (!gameLinks.length) return console.log(`${values.slug} has no links. Add one with: zaisma links set ${values.slug} store https://kit.itch.io/${values.slug}`);
+  for (const link of gameLinks) {
+    console.log(`${link.link_name.padEnd(20)} ${link.destination_url}  (${LINK_AUDIENCE_WORDS[link.who_can_open]}${link.is_on_game_page ? ", on the game page" : ""})`);
+    if (link.review_reason) console.log(`${"".padEnd(20)} ${link.review_reason.message} ${link.review_reason.fix}`);
+  }
+  if (command === "links set") console.log(`The game opens it with Zaisma.links.open("${values.link_name}").`);
+}
+
 /** A game's secrets (…/games/<slug>/secrets…), as the MCP's list_secrets, set_secret and delete_secret. */
 async function secrets(command, values) {
   if (command === "secrets") {
@@ -1062,6 +1099,7 @@ async function run({ command, values, flags, globalFlags, rest }) {
     return EXIT_CODES.done;
   }
   if (command === "allowed-hosts") await allowedHosts(values, flags);
+  else if (command === "links" || command.startsWith("links ")) await links(command, values, flags);
   else if (command === "secrets" || command.startsWith("secrets ")) await secrets(command, values);
   else if (command === "database" || command.startsWith("database ")) await database(command, values, flags);
   else if (command === "saves" || command.startsWith("saves ")) await saves(command, values, flags);