@irtio/cli 0.5.2 → 0.7.0

package/dist/ratings-XBLX2MUW.js

@@ -0,0 +1,297 @@
+import {
+  readProjectConfig
+} from "./chunk-JL235KIE.js";
+import {
+  HelpRequested,
+  helpFor,
+  helpRequested
+} from "./chunk-OCVALOGK.js";
+import {
+  createApiClient,
+  isLoginRequired
+} from "./chunk-IDF46P7R.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-GA6UY772.js → rollback-LI4TDLQA.js}

@@ -1,14 +1,18 @@
 import {
   readProjectConfig
-} from "./chunk-32QTPKVT.js";
+} from "./chunk-JL235KIE.js";
 import {
   HelpRequested,
-  createApiClient,
   helpFor,
-  helpRequested,
-  isLoginRequired,
+  helpRequested
+} from "./chunk-OCVALOGK.js";
+import {
+  createApiClient,
+  isLoginRequired
+} from "./chunk-IDF46P7R.js";
+import {
   resolveControlUrlForUser
-} from "./chunk-TV66QHFP.js";
+} from "./chunk-UPHQM6NZ.js";
 
 // src/rollback.ts
 import "fs";