@irtio/cli 0.5.2 → 0.6.0

package/dist/leaderboard-SYPSBPS3.js

@@ -0,0 +1,352 @@
+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/leaderboard.ts
+import pc from "picocolors";
+var USAGE = `usage: irtio leaderboard <board> [options]
+       irtio leaderboard list [options]
+       irtio leaderboard delete <board> [--player <id>] --yes [options]
+
+Prints a project's leaderboard. Reads are public: no login is needed, and this works against
+any project's board, exactly as that project's own website would read it.
+
+There is no submit command. Scores reach a board only from room code
+(room.leaderboard.submit), which is what makes them server-authoritative.
+
+list     every board on the project, with its row count and direction. Needs your login,
+         because it is a view of a project rather than of one public ranking.
+delete   remove a whole board, or one player's row with --player. Needs your login and
+         --yes; without --yes it prints what would go and changes nothing.
+
+options:
+  --limit <n>        how many rows (default 10, max 100)
+  --cursor <c>       continue from a previous page's nextCursor
+  --all              page through the whole board, following cursors
+  --around <player>  show the rows around one player instead of the top, with their rank
+  --player <id>      with delete: remove one player's row instead of the whole board
+  --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 parseLeaderboardArgs(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 leaderboard: --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 leaderboard: --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 leaderboard: --limit needs a whole number of at least 1");
+        }
+        parsed.limit = value;
+        break;
+      }
+      case "--around": {
+        const value = args[++i];
+        if (value === void 0 || value === "") {
+          throw new Error("irtio leaderboard: --around needs a player id");
+        }
+        parsed.around = value;
+        break;
+      }
+      case "--project": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio leaderboard: --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 leaderboard: --config needs a value");
+        }
+        parsed.config = value;
+        break;
+      }
+      case "--url": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio leaderboard: --url needs a value");
+        parsed.url = value;
+        break;
+      }
+      default:
+        if (arg.startsWith("-")) {
+          throw new Error(`irtio leaderboard: unknown option ${JSON.stringify(arg)}`);
+        }
+        if (parsed.board !== void 0) {
+          throw new Error("irtio leaderboard: give exactly one board name");
+        }
+        parsed.board = arg;
+    }
+  }
+  return parsed;
+}
+function formatLeaderboard(body, around) {
+  const direction = body.direction === "lower" ? "lower is better" : "higher is better";
+  const out = [pc.dim(`board ${body.board}  \xB7  ${direction}`), ""];
+  if (body.entries.length === 0) {
+    out.push(
+      pc.dim(
+        around !== void 0 ? `${around} has no score on this board` : "no scores on this board yet"
+      )
+    );
+    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)}  SCORE`));
+  for (const entry of body.entries) {
+    const line = `${String(entry.rank).padEnd(rankWidth)}  ${entry.playerId.padEnd(idWidth)}  ${entry.score}`;
+    out.push(entry.playerId === around ? pc.bold(line) : line);
+  }
+  return out;
+}
+async function runLeaderboard(options) {
+  const log = options.log ?? ((line) => console.log(line));
+  const controlUrl = (await resolveControlUrlForUser(options.controlUrl)).replace(/\/+$/, "");
+  const fetchImpl = options.fetch ?? fetch;
+  const base = `${controlUrl}/v1/leaderboard/${encodeURIComponent(
+    options.project
+  )}/${encodeURIComponent(options.board)}`;
+  if (options.around !== void 0) {
+    const body2 = await readPublicJson(
+      fetchImpl,
+      `${base}/around/${encodeURIComponent(options.around)}`
+    );
+    for (const line of formatLeaderboard(body2, options.around)) log(line);
+    return body2;
+  }
+  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}/top${q === "" ? "" : `?${q}`}`;
+  };
+  let body = await readPublicJson(fetchImpl, 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 readPublicJson(fetchImpl, pageUrl(next));
+      entries.push(...body.entries);
+      next = body.nextCursor;
+    }
+    if (next !== void 0) {
+      throw new Error(
+        "irtio leaderboard: --all stopped after a hundred pages. Read it in pieces with --cursor"
+      );
+    }
+  }
+  const combined = { ...body, entries };
+  for (const line of formatLeaderboard(combined)) log(line);
+  if (options.all !== true && body.nextCursor !== void 0) {
+    log("");
+    log(pc.dim(`more rows: --cursor ${body.nextCursor}`));
+  }
+  return combined;
+}
+async function readPublicJson(fetchImpl, url) {
+  const res = await fetchImpl(url);
+  const text = await res.text().catch(() => "");
+  if (!res.ok) {
+    let message = `leaderboard read failed with status ${res.status}`;
+    try {
+      const parsed = JSON.parse(text);
+      if (typeof parsed.message === "string") message = parsed.message;
+    } catch {
+    }
+    throw new Error(message);
+  }
+  return JSON.parse(text);
+}
+function formatBoardList(boards) {
+  if (boards.length === 0) {
+    return [
+      pc.dim("no boards on this project yet"),
+      pc.dim("scores reach a board from room code: room.leaderboard.submit")
+    ];
+  }
+  const nameWidth = Math.max(5, ...boards.map((b) => b.board.length));
+  const out = [pc.dim(`${"BOARD".padEnd(nameWidth)}  ${"ROWS".padStart(7)}  DIRECTION`)];
+  for (const b of boards) {
+    const note = b.configured && b.rows === 0 ? pc.dim("  (configured, no rows yet)") : "";
+    out.push(`${b.board.padEnd(nameWidth)}  ${String(b.rows).padStart(7)}  ${b.direction}${note}`);
+  }
+  return out;
+}
+async function runBoardList(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)}/leaderboards`
+  );
+  for (const line of formatBoardList(body.boards)) log(line);
+  return body.boards;
+}
+async function runBoardDelete(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)}/leaderboard/${encodeURIComponent(
+    options.board
+  )}`;
+  if (!options.yes) {
+    if (options.player !== void 0) {
+      log(
+        `this would delete ${pc.bold(options.player)} from board ${pc.bold(options.board)} in project ${options.project}`
+      );
+    } else {
+      const { boards } = await client.get(
+        `/v1/projects/${encodeURIComponent(options.project)}/leaderboards`
+      );
+      const rows = boards.find((b) => b.board === options.board)?.rows ?? 0;
+      log(
+        `this would delete every row on board ${pc.bold(options.board)} in project ${options.project}: ${pc.bold(String(rows))} row(s)`
+      );
+    }
+    log(pc.dim("nothing was deleted. This cannot be undone once it runs"));
+    log(
+      `to proceed: irtio leaderboard delete ${options.board}${options.player !== void 0 ? ` --player ${options.player}` : ""} --yes`
+    );
+    return false;
+  }
+  if (options.player !== void 0) {
+    const body2 = await client.del(
+      `${path}/${encodeURIComponent(options.player)}`
+    );
+    log(
+      body2.deleted ? pc.green(`deleted ${options.player} from board ${options.board}`) : pc.dim(`${options.player} had no row on board ${options.board}; nothing to delete`)
+    );
+    return true;
+  }
+  const body = await client.del(path);
+  log(pc.green(`deleted ${body.deleted} row(s) from board ${options.board}`));
+  return true;
+}
+async function leaderboard(args, deps = {}) {
+  const log = deps.log ?? ((line) => console.log(line));
+  const errorLog = deps.errorLog ?? ((line) => console.error(line));
+  try {
+    const parsed = parseLeaderboardArgs(args);
+    const config = await readProjectConfig(process.cwd(), "irtio leaderboard", parsed.config);
+    const project = parsed.project ?? config.project;
+    if (project === void 0) {
+      throw new Error(
+        "irtio leaderboard: 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.board !== void 0) {
+        throw new Error("irtio leaderboard list: takes no board name");
+      }
+      await runBoardList(common);
+      return;
+    }
+    if (parsed.action === "delete") {
+      if (parsed.board === void 0) {
+        throw new Error(
+          "irtio leaderboard delete: which board? e.g. irtio leaderboard delete scores --yes"
+        );
+      }
+      await runBoardDelete({
+        ...common,
+        board: parsed.board,
+        yes: parsed.yes === true,
+        ...parsed.player !== void 0 ? { player: parsed.player } : {}
+      });
+      return;
+    }
+    if (parsed.board === void 0) {
+      throw new Error("irtio leaderboard: which board? e.g. irtio leaderboard scores");
+    }
+    if (parsed.cursor !== void 0 && parsed.all === true) {
+      throw new Error("irtio leaderboard: --cursor and --all are two ways to do the same thing");
+    }
+    if (parsed.around !== void 0 && (parsed.cursor !== void 0 || parsed.all === true)) {
+      throw new Error("irtio leaderboard: --around does not page; it is already a window");
+    }
+    await runLeaderboard({
+      project,
+      board: parsed.board,
+      log,
+      ...parsed.limit !== void 0 ? { limit: parsed.limit } : {},
+      ...parsed.around !== void 0 ? { around: parsed.around } : {},
+      ...parsed.cursor !== void 0 ? { cursor: parsed.cursor } : {},
+      ...parsed.all === true ? { all: true } : {},
+      ...parsed.url !== void 0 ? { controlUrl: parsed.url } : {}
+    });
+  } catch (err) {
+    if (err instanceof HelpRequested) {
+      log(err.usage);
+      return;
+    }
+    if (isLoginRequired(err)) {
+      errorLog(pc.red("not logged in"));
+      errorLog("run: irtio login");
+      process.exitCode = 1;
+      return;
+    }
+    errorLog(pc.red(err instanceof Error ? err.message : String(err)));
+    process.exitCode = 1;
+  }
+}
+export {
+  USAGE,
+  formatBoardList,
+  formatLeaderboard,
+  leaderboard,
+  parseLeaderboardArgs,
+  runBoardDelete,
+  runBoardList,
+  runLeaderboard
+};

package/dist/{login-3EXB4CGX.js → login-2M73HBZT.js}

@@ -1,11 +1,14 @@
 import {
   HelpRequested,
-  credentialsPath,
   helpFor,
-  helpRequested,
+  helpRequested
+} from "./chunk-ZD4ND6X6.js";
+import "./chunk-RNAH5T4W.js";
+import {
+  credentialsPath,
   resolveControlUrl,
   writeCredential
-} from "./chunk-TV66QHFP.js";
+} from "./chunk-UPHQM6NZ.js";
 
 // src/login.ts
 import { spawn } from "child_process";
@@ -18,8 +21,12 @@ var USAGE = `usage: irtio login [--url <control>]
 Signs in to a control plane through your browser and stores the credential it hands back.
 
 options:
-  --url <control>    the control plane to sign in to (default: the last one you used)
-  -h, --help         print this
+  --url <control>       the control plane to sign in to (default: the last one you used)
+  --token-file <file>   store the credential in this file instead of the default location
+                        (a global flag: pass it to later commands too, or set
+                        IRT_CREDENTIALS_FILE). For agents and sandboxes that cannot
+                        reach the home directory
+  -h, --help            print this
 `;
 function parseLoginArgs(args) {
   if (helpRequested(args)) throw helpFor(USAGE);

package/dist/{logs-2EOXLNWF.js → logs-2W7CPZO5.js}

@@ -1,14 +1,18 @@
 import {
   readProjectConfig
-} from "./chunk-32QTPKVT.js";
+} from "./chunk-DKWG7MGO.js";
 import {
   HelpRequested,
-  createApiClient,
   helpFor,
-  helpRequested,
-  isLoginRequired,
+  helpRequested
+} from "./chunk-ZD4ND6X6.js";
+import {
+  createApiClient,
+  isLoginRequired
+} from "./chunk-RNAH5T4W.js";
+import {
   resolveControlUrlForUser
-} from "./chunk-TV66QHFP.js";
+} from "./chunk-UPHQM6NZ.js";
 
 // src/logs.ts
 import "fs";

package/dist/{migrate-WUO2GBMX.js → migrate-T3DZJREY.js}

@@ -1,17 +1,21 @@
-import {
-  bundleRoom
-} from "./chunk-KRQUAEN2.js";
 import {
   readProjectConfig
-} from "./chunk-32QTPKVT.js";
+} from "./chunk-DKWG7MGO.js";
+import {
+  bundleRoom
+} from "./chunk-OTSFRVJN.js";
 import {
   HelpRequested,
-  createApiClient,
   helpFor,
-  helpRequested,
-  isLoginRequired,
+  helpRequested
+} from "./chunk-ZD4ND6X6.js";
+import {
+  createApiClient,
+  isLoginRequired
+} from "./chunk-RNAH5T4W.js";
+import {
   resolveControlUrlForUser
-} from "./chunk-TV66QHFP.js";
+} from "./chunk-UPHQM6NZ.js";
 
 // src/migrate.ts
 import { existsSync } from "fs";