@irtio/cli 0.5.1 → 0.6.0

package/dist/ratings-VG32WFDG.js

@@ -0,0 +1,297 @@
+import {
+  readProjectConfig
+} from "./chunk-DKWG7MGO.js";
+import {
+  HelpRequested,
+  helpFor,
+  helpRequested
+} from "./chunk-ZD4ND6X6.js";
+import {
+  createApiClient,
+  isLoginRequired
+} from "./chunk-RNAH5T4W.js";
+import {
+  resolveControlUrlForUser
+} from "./chunk-UPHQM6NZ.js";
+
+// src/ratings.ts
+import pc from "picocolors";
+var USAGE = `usage: irtio ratings <queue> [options]
+       irtio ratings list [options]
+       irtio ratings delete <queue> --player <id> --yes [options]
+
+Prints a project's skill ratings for one queue, best first. Needs your login: a rating is a
+number the matchmaker uses, not a scoreboard for players to read.
+
+There is no submit command. A rating moves only from room code (room.ratings.report), which
+is what makes it mean anything.
+
+list     every queue with ratings on the project, with its row count
+delete   remove one player's rating in one queue. Needs --player, your login and --yes;
+         without --yes it prints what would go and changes nothing.
+
+options:
+  --limit <n>        how many rows (default 20, max 100)
+  --cursor <c>       continue from a previous page's nextCursor
+  --all              page through the whole queue, following cursors
+  --player <id>      with delete: whose rating to remove
+  --yes              with delete: actually delete
+  --project <id>     project id (default: the project file)
+  -c, --config <f>   the project file to read (default irtio.json)
+  --url <control>    control plane (default: your stored login)
+  -h, --help         print this
+`;
+function parseRatingsArgs(args) {
+  if (helpRequested(args)) throw helpFor(USAGE);
+  const parsed = {};
+  if (args[0] === "list" || args[0] === "delete") parsed.action = args[0];
+  for (let i = parsed.action === void 0 ? 0 : 1; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case "--cursor": {
+        const value = args[++i];
+        if (value === void 0 || value === "") {
+          throw new Error("irtio ratings: --cursor needs a value");
+        }
+        parsed.cursor = value;
+        break;
+      }
+      case "--all":
+        parsed.all = true;
+        break;
+      case "--yes":
+        parsed.yes = true;
+        break;
+      case "--player": {
+        const value = args[++i];
+        if (value === void 0 || value === "") {
+          throw new Error("irtio ratings: --player needs a player id");
+        }
+        parsed.player = value;
+        break;
+      }
+      case "--limit": {
+        const value = Number(args[++i]);
+        if (!Number.isInteger(value) || value < 1) {
+          throw new Error("irtio ratings: --limit needs a whole number of at least 1");
+        }
+        parsed.limit = value;
+        break;
+      }
+      case "--project": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio ratings: --project needs a value");
+        parsed.project = value;
+        break;
+      }
+      case "-c":
+      case "--config": {
+        const value = args[++i];
+        if (value === void 0 || value === "") {
+          throw new Error("irtio ratings: --config needs a value");
+        }
+        parsed.config = value;
+        break;
+      }
+      case "--url": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio ratings: --url needs a value");
+        parsed.url = value;
+        break;
+      }
+      default:
+        if (arg.startsWith("-")) {
+          throw new Error(`irtio ratings: unknown option ${JSON.stringify(arg)}`);
+        }
+        if (parsed.queue !== void 0) {
+          throw new Error("irtio ratings: give exactly one queue name");
+        }
+        parsed.queue = arg;
+    }
+  }
+  return parsed;
+}
+function formatRatings(body) {
+  const out = [pc.dim(`queue ${body.queue}  \xB7  Glicko-2, higher is stronger`), ""];
+  if (body.entries.length === 0) {
+    out.push(pc.dim("no ratings in this queue yet"));
+    out.push(pc.dim("a rating appears when room code calls room.ratings.report"));
+    return out;
+  }
+  const rankWidth = Math.max(4, ...body.entries.map((e) => String(e.rank).length));
+  const idWidth = Math.max(6, ...body.entries.map((e) => e.playerId.length));
+  out.push(pc.dim(`${"RANK".padEnd(rankWidth)}  ${"PLAYER".padEnd(idWidth)}  RATING  \xB1DEV  GAMES`));
+  for (const e of body.entries) {
+    out.push(
+      `${String(e.rank).padEnd(rankWidth)}  ${e.playerId.padEnd(idWidth)}  ${e.rating.toFixed(0).padStart(6)}  ${e.deviation.toFixed(0).padStart(4)}  ${String(e.games).padStart(5)}`
+    );
+  }
+  out.push("");
+  out.push(
+    pc.dim("\xB1DEV is how sure the rating is. 350 means a new player; under 80 means settled.")
+  );
+  return out;
+}
+async function runRatings(options) {
+  const log = options.log ?? ((line) => console.log(line));
+  const controlUrl = await resolveControlUrlForUser(options.controlUrl);
+  const client = options.client ?? await createApiClient(controlUrl);
+  const base = `/v1/projects/${encodeURIComponent(options.project)}/ratings/${encodeURIComponent(
+    options.queue
+  )}`;
+  const pageUrl = (cursor) => {
+    const query = new URLSearchParams();
+    if (options.limit !== void 0) query.set("limit", String(options.limit));
+    if (cursor !== void 0) query.set("cursor", cursor);
+    const q = query.toString();
+    return `${base}${q === "" ? "" : `?${q}`}`;
+  };
+  let body = await client.get(pageUrl(options.cursor));
+  const entries = [...body.entries];
+  if (options.all === true) {
+    let next = body.nextCursor;
+    for (let page = 1; next !== void 0 && page < 100; page++) {
+      body = await client.get(pageUrl(next));
+      for (const entry of body.entries) {
+        entries.push({ ...entry, rank: entries.length + 1 });
+      }
+      next = body.nextCursor;
+    }
+    if (next !== void 0) {
+      throw new Error(
+        "irtio ratings: --all stopped after a hundred pages. Read it in pieces with --cursor"
+      );
+    }
+  }
+  const combined = { ...body, entries };
+  for (const line of formatRatings(combined)) log(line);
+  if (options.all !== true && body.nextCursor !== void 0) {
+    log("");
+    log(pc.dim(`more rows: --cursor ${body.nextCursor}`));
+  }
+  return combined;
+}
+function formatQueueList(queues) {
+  if (queues.length === 0) {
+    return [
+      pc.dim("no ratings on this project yet"),
+      pc.dim("a rating reaches a queue from room code: room.ratings.report")
+    ];
+  }
+  const nameWidth = Math.max(5, ...queues.map((q) => q.queue.length));
+  const out = [pc.dim(`${"QUEUE".padEnd(nameWidth)}  ${"ROWS".padStart(7)}  MATCHING`)];
+  for (const q of queues) {
+    const matching = q.skill ? "skill" : "fifo";
+    const note = q.configured && q.rows === 0 ? pc.dim("  (configured, no ratings yet)") : !q.configured ? pc.dim("  (ratings only; not a configured queue)") : !q.skill ? pc.dim("  (ratings recorded, but this queue fills in arrival order)") : "";
+    out.push(`${q.queue.padEnd(nameWidth)}  ${String(q.rows).padStart(7)}  ${matching}${note}`);
+  }
+  return out;
+}
+async function runQueueList(options) {
+  const log = options.log ?? ((line) => console.log(line));
+  const controlUrl = await resolveControlUrlForUser(options.controlUrl);
+  const client = options.client ?? await createApiClient(controlUrl);
+  const body = await client.get(
+    `/v1/projects/${encodeURIComponent(options.project)}/ratings`
+  );
+  for (const line of formatQueueList(body.queues)) log(line);
+  return body.queues;
+}
+async function runRatingDelete(options) {
+  const log = options.log ?? ((line) => console.log(line));
+  const controlUrl = await resolveControlUrlForUser(options.controlUrl);
+  const client = options.client ?? await createApiClient(controlUrl);
+  const path = `/v1/projects/${encodeURIComponent(options.project)}/ratings/${encodeURIComponent(
+    options.queue
+  )}/${encodeURIComponent(options.player)}`;
+  if (!options.yes) {
+    log(
+      `this would delete ${pc.bold(options.player)}'s rating in queue ${pc.bold(options.queue)} in project ${options.project}`
+    );
+    log(pc.dim("nothing was deleted. This cannot be undone once it runs"));
+    log(`to proceed: irtio ratings delete ${options.queue} --player ${options.player} --yes`);
+    return false;
+  }
+  const body = await client.del(path);
+  log(
+    body.deleted ? pc.green(`deleted ${options.player}'s rating in queue ${options.queue}`) : pc.dim(`${options.player} had no rating in queue ${options.queue}; nothing to delete`)
+  );
+  return true;
+}
+async function ratings(args, deps = {}) {
+  const log = deps.log ?? ((line) => console.log(line));
+  const errorLog = deps.errorLog ?? ((line) => console.error(line));
+  try {
+    const parsed = parseRatingsArgs(args);
+    const config = await readProjectConfig(process.cwd(), "irtio ratings", parsed.config);
+    const project = parsed.project ?? config.project;
+    if (project === void 0) {
+      throw new Error(
+        "irtio ratings: no project id. Pass --project or run this from a project with irtio.json"
+      );
+    }
+    const common = {
+      project,
+      log,
+      ...parsed.url !== void 0 ? { controlUrl: parsed.url } : {},
+      ...deps.client !== void 0 ? { client: deps.client } : {}
+    };
+    if (parsed.action === "list") {
+      if (parsed.queue !== void 0) throw new Error("irtio ratings list: takes no queue name");
+      await runQueueList(common);
+      return;
+    }
+    if (parsed.action === "delete") {
+      if (parsed.queue === void 0) {
+        throw new Error(
+          "irtio ratings delete: which queue? e.g. irtio ratings delete ranked --player irt:abc --yes"
+        );
+      }
+      if (parsed.player === void 0) {
+        throw new Error("irtio ratings delete: --player is required; there is no whole-queue wipe");
+      }
+      await runRatingDelete({
+        ...common,
+        queue: parsed.queue,
+        player: parsed.player,
+        yes: parsed.yes === true
+      });
+      return;
+    }
+    if (parsed.queue === void 0) {
+      throw new Error("irtio ratings: which queue? e.g. irtio ratings ranked");
+    }
+    if (parsed.cursor !== void 0 && parsed.all === true) {
+      throw new Error("irtio ratings: --cursor and --all are two ways to do the same thing");
+    }
+    await runRatings({
+      ...common,
+      queue: parsed.queue,
+      ...parsed.limit !== void 0 ? { limit: parsed.limit } : {},
+      ...parsed.cursor !== void 0 ? { cursor: parsed.cursor } : {},
+      ...parsed.all !== void 0 ? { all: parsed.all } : {}
+    });
+  } catch (err) {
+    if (err instanceof HelpRequested) {
+      log(err.usage);
+      return;
+    }
+    if (isLoginRequired(err)) {
+      errorLog("irtio ratings: not logged in. Run `irtio login` first");
+      process.exitCode = 1;
+      return;
+    }
+    errorLog(err instanceof Error ? err.message : String(err));
+    process.exitCode = 1;
+  }
+}
+export {
+  USAGE,
+  formatQueueList,
+  formatRatings,
+  parseRatingsArgs,
+  ratings,
+  runQueueList,
+  runRatingDelete,
+  runRatings
+};

package/dist/{rollback-CLQVYFHW.js → rollback-SO74MVZV.js}

@@ -1,17 +1,38 @@
+import {
+  readProjectConfig
+} from "./chunk-DKWG7MGO.js";
+import {
+  HelpRequested,
+  helpFor,
+  helpRequested
+} from "./chunk-ZD4ND6X6.js";
 import {
   createApiClient,
   isLoginRequired
-} from "./chunk-I37DLT7K.js";
+} from "./chunk-RNAH5T4W.js";
 import {
   resolveControlUrlForUser
-} from "./chunk-NVUKSP5U.js";
+} from "./chunk-UPHQM6NZ.js";
 
 // src/rollback.ts
-import { existsSync } from "fs";
-import { readFile } from "fs/promises";
-import * as path from "path";
+import "fs";
+import "fs/promises";
+import "path";
 import pc from "picocolors";
+var USAGE = `usage: irtio rollback <version> [options]
+
+Re-promotes deployment <version> and brings rooms that migrated past it back to their
+pre-migration state. This DISCARDS whatever those rooms wrote since their migration.
+
+options:
+  <version>          the deployment version to go back to
+  --project <id>     project id (default: the project file)
+  -c, --config <f>   the project file to read (default irtio.json)
+  --url <control>    control plane (default: your stored login)
+  -h, --help         print this
+`;
 function parseRollbackArgs(args) {
+  if (helpRequested(args)) throw helpFor(USAGE);
   const parsed = {};
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -22,6 +43,14 @@ function parseRollbackArgs(args) {
         parsed.project = value;
         break;
       }
+      case "-c":
+      case "--config": {
+        const value = args[++i];
+        if (value === void 0 || value === "")
+          throw new Error("irtio rollback: --config needs a value");
+        parsed.config = value;
+        break;
+      }
       case "--url": {
         const value = args[++i];
         if (value === void 0) throw new Error("irtio rollback: --url needs a value");
@@ -75,23 +104,13 @@ async function runRollback(options) {
   }
   return result;
 }
-async function readIrtioJsonProject(cwd) {
-  const file = path.join(cwd, "irtio.json");
-  if (!existsSync(file)) return void 0;
-  let parsed;
-  try {
-    parsed = JSON.parse(await readFile(file, "utf8"));
-  } catch {
-    throw new Error(`irtio rollback: ${file} is not valid JSON`);
-  }
-  return typeof parsed.project === "string" && parsed.project.length > 0 ? parsed.project : void 0;
-}
 async function rollback(args, deps = {}) {
   const log = deps.log ?? ((line) => console.log(line));
   const errorLog = deps.errorLog ?? ((line) => console.error(line));
   try {
     const parsed = parseRollbackArgs(args);
-    const project = parsed.project ?? await readIrtioJsonProject(process.cwd());
+    const config = await readProjectConfig(process.cwd(), "irtio rollback", parsed.config);
+    const project = parsed.project ?? config.project;
     if (project === void 0) {
       throw new Error(
         "irtio rollback: no project id \u2014 pass --project or run this from a project with irtio.json"
@@ -105,6 +124,10 @@ async function rollback(args, deps = {}) {
       ...deps.client !== void 0 ? { client: deps.client } : {}
     });
   } catch (err) {
+    if (err instanceof HelpRequested) {
+      log(err.usage);
+      return;
+    }
     if (isLoginRequired(err)) {
       errorLog(pc.red("not logged in"));
       errorLog("run: irtio login");
@@ -116,6 +139,7 @@ async function rollback(args, deps = {}) {
   }
 }
 export {
+  USAGE,
   parseRollbackArgs,
   rollback,
   runRollback

package/dist/{rooms-OJ3JLYHD.js → rooms-VI33P4RA.js}

@@ -1,21 +1,53 @@
+import {
+  readProjectConfig
+} from "./chunk-DKWG7MGO.js";
+import {
+  HelpRequested,
+  helpFor,
+  helpRequested
+} from "./chunk-ZD4ND6X6.js";
 import {
   createApiClient,
   isLoginRequired
-} from "./chunk-I37DLT7K.js";
+} from "./chunk-RNAH5T4W.js";
 import {
   resolveControlUrlForUser
-} from "./chunk-NVUKSP5U.js";
+} from "./chunk-UPHQM6NZ.js";
 
 // src/rooms.ts
-import { existsSync } from "fs";
-import { readFile } from "fs/promises";
-import * as path from "path";
+import "fs";
+import "fs/promises";
+import "path";
 import pc from "picocolors";
+var USAGE = `usage: irtio rooms [options]
+       irtio rooms saves <room> [options]
+       irtio rooms restore <room> --save <id> [options]
+       irtio rooms delete <room> [options]
+
+Lists a project's rooms, with the retention window each one's type declares. Rows not reported for
+longer than the control plane's row-pruning window (30 days by default) are pruned; that prunes the
+listing only and never a room's stored state.
+
+subcommands:
+  saves <room>              list a room's save generations, newest first
+  restore <room> --save <id>
+                            bring a room back from a save. This DISCARDS its current state, and
+                            stops the tenant if it is live
+  delete <room>             delete a room's stored state: its snapshot, its saves and its alarms.
+                            This is permanent. Refused while the room is awake
+
+options:
+  --project <id>     project id (default: the project file)
+  -c, --config <f>   the project file to read (default irtio.json)
+  --url <control>    control plane (default: your stored login)
+  -h, --help         print this
+`;
 function parseRoomsArgs(args) {
+  if (helpRequested(args)) throw helpFor(USAGE);
   const parsed = { sub: "list" };
   let rest = args;
   const first = args[0];
-  if (first === "saves" || first === "restore") {
+  if (first === "saves" || first === "restore" || first === "delete") {
     parsed.sub = first;
     const room = args[1];
     if (room === void 0 || room.startsWith("-")) {
@@ -39,6 +71,14 @@ function parseRoomsArgs(args) {
         parsed.project = value;
         break;
       }
+      case "-c":
+      case "--config": {
+        const value = args[++i];
+        if (value === void 0 || value === "")
+          throw new Error("irtio rooms: --config needs a value");
+        parsed.config = value;
+        break;
+      }
       case "--url": {
         const value = rest[++i];
         if (value === void 0) throw new Error("irtio rooms: --url needs a value");
@@ -77,10 +117,11 @@ function statusColor(status) {
 function formatTable(rows) {
   if (rows.length === 0) return [pc.dim("no rooms")];
   const idWidth = Math.max(4, ...rows.map((r) => r.roomId.length));
-  const out = [pc.dim(`${"ROOM".padEnd(idWidth)}  STATUS      LAST SEEN`)];
+  const out = [pc.dim(`${"ROOM".padEnd(idWidth)}  STATUS      RETAIN  LAST SEEN`)];
   for (const r of rows) {
+    const retention = r.retention ?? "forever";
     out.push(
-      `${r.roomId.padEnd(idWidth)}  ${statusColor(r.status).padEnd(10)}  ${pc.dim(r.lastSeen)}`
+      `${r.roomId.padEnd(idWidth)}  ${statusColor(r.status).padEnd(10)}  ${retention.padEnd(6)}  ${pc.dim(r.lastSeen)}`
     );
   }
   return out;
@@ -132,6 +173,20 @@ async function runRestore(options) {
   }
   return result;
 }
+async function runDeleteRoom(options) {
+  const log = options.log ?? ((line) => console.log(line));
+  const controlUrl = await resolveControlUrlForUser(options.controlUrl);
+  const client = options.client ?? await createApiClient(controlUrl);
+  log(
+    `${pc.yellow("deleting")} room ${pc.bold(options.room)}: its snapshot, its saves and its alarms`
+  );
+  const result = await client.del(
+    `/v1/projects/${options.project}/rooms/${encodeURIComponent(options.room)}`
+  );
+  log(pc.green(`deleted ${options.room}: ${result.objects} stored object(s) removed`));
+  log(pc.dim("player data and leaderboard scores are keyed to the player and are untouched"));
+  return result;
+}
 async function runRooms(options) {
   const log = options.log ?? ((line) => console.log(line));
   const controlUrl = await resolveControlUrlForUser(options.controlUrl);
@@ -140,23 +195,13 @@ async function runRooms(options) {
   for (const line of formatTable(rows)) log(line);
   return rows;
 }
-async function readIrtioJsonProject(cwd) {
-  const file = path.join(cwd, "irtio.json");
-  if (!existsSync(file)) return void 0;
-  let parsed;
-  try {
-    parsed = JSON.parse(await readFile(file, "utf8"));
-  } catch {
-    throw new Error(`irtio rooms: ${file} is not valid JSON`);
-  }
-  return typeof parsed.project === "string" && parsed.project.length > 0 ? parsed.project : void 0;
-}
 async function rooms(args, deps = {}) {
   const log = deps.log ?? ((line) => console.log(line));
   const errorLog = deps.errorLog ?? ((line) => console.error(line));
   try {
     const parsed = parseRoomsArgs(args);
-    const project = parsed.project ?? await readIrtioJsonProject(process.cwd());
+    const config = await readProjectConfig(process.cwd(), "irtio rooms", parsed.config);
+    const project = parsed.project ?? config.project;
     if (project === void 0) {
       throw new Error(
         "irtio rooms: no project id \u2014 pass --project or run this from a project with irtio.json"
@@ -170,6 +215,8 @@ async function rooms(args, deps = {}) {
     };
     if (parsed.sub === "saves") {
       await runSaves({ ...common, room: parsed.room });
+    } else if (parsed.sub === "delete") {
+      await runDeleteRoom({ ...common, room: parsed.room });
     } else if (parsed.sub === "restore") {
       await runRestore({
         ...common,
@@ -180,6 +227,10 @@ async function rooms(args, deps = {}) {
       await runRooms(common);
     }
   } catch (err) {
+    if (err instanceof HelpRequested) {
+      log(err.usage);
+      return;
+    }
     if (isLoginRequired(err)) {
       errorLog(pc.red("not logged in"));
       errorLog("run: irtio login");
@@ -191,8 +242,10 @@ async function rooms(args, deps = {}) {
   }
 }
 export {
+  USAGE,
   parseRoomsArgs,
   rooms,
+  runDeleteRoom,
   runRestore,
   runRooms,
   runSaves