@irtio/cli 0.5.1 → 0.6.0

package/dist/static-deploy-KOWFKWZA.js

@@ -0,0 +1,19 @@
+import {
+  USAGE,
+  parseStaticDeployArgs,
+  runStaticDeploy,
+  staticDeploy,
+  walkStaticDir
+} from "./chunk-3HQMVCYA.js";
+import "./chunk-RQSJZWQC.js";
+import "./chunk-DKWG7MGO.js";
+import "./chunk-ZD4ND6X6.js";
+import "./chunk-RNAH5T4W.js";
+import "./chunk-UPHQM6NZ.js";
+export {
+  USAGE,
+  parseStaticDeployArgs,
+  runStaticDeploy,
+  staticDeploy,
+  walkStaticDir
+};

package/dist/status-HF3ZEKB7.js

@@ -0,0 +1,219 @@
+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/status.ts
+import pc from "picocolors";
+var USAGE = `usage: irtio status [options]
+
+Shows a project's live metrics.
+
+With no --room: the latest value of every tenant-wide metric, then a per-room table of
+connections and tick health, built from a 30s-per-tenant sample rollup.
+
+With --room <id>: that one room's recent history instead, newest first.
+
+options:
+  --room <id>        show one room's recent history instead of the project-wide summary
+  --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 parseStatusArgs(args) {
+  if (helpRequested(args)) throw helpFor(USAGE);
+  const parsed = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case "--room": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio status: --room needs a value");
+        parsed.room = value;
+        break;
+      }
+      case "--project": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio status: --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 status: --config needs a value");
+        parsed.config = value;
+        break;
+      }
+      case "--url": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio status: --url needs a value");
+        parsed.url = value;
+        break;
+      }
+      default:
+        throw new Error(`irtio status: unknown option ${JSON.stringify(arg)}`);
+    }
+  }
+  return parsed;
+}
+function formatTimestamp(iso) {
+  return iso.replace("T", " ").replace(/\.\d+Z$/, "Z");
+}
+function formatSampleAge(iso, now) {
+  const ms = now - Date.parse(iso);
+  if (!Number.isFinite(ms) || ms < 0) return "-";
+  const secs = Math.floor(ms / 1e3);
+  if (secs < 60) return `${secs}s ago`;
+  const mins = Math.floor(secs / 60);
+  if (mins < 60) return `${mins}m ago`;
+  const hours = Math.floor(mins / 60);
+  if (hours < 24) return `${hours}h ago`;
+  return `${Math.floor(hours / 24)}d ago`;
+}
+function formatAggregateMetrics(rows) {
+  if (rows.length === 0) return [pc.dim("no metrics reported yet")];
+  const newest = /* @__PURE__ */ new Map();
+  for (const row of rows) if (!newest.has(row.name)) newest.set(row.name, row);
+  const names = [...newest.keys()].sort();
+  const nameWidth = Math.max(6, ...names.map((n) => n.length));
+  const out = [pc.dim(`${"METRIC".padEnd(nameWidth)}  VALUE       AT`)];
+  for (const name of names) {
+    const row = newest.get(name);
+    out.push(
+      `${name.padEnd(nameWidth)}  ${String(row.value).padEnd(10)}  ${pc.dim(formatTimestamp(row.at))}`
+    );
+  }
+  return out;
+}
+function formatRoomsSnapshot(rows, now) {
+  if (rows.length === 0) {
+    return [
+      pc.dim("no per-room samples yet"),
+      pc.dim("an old guest rootfs, or a project with no rooms, both look like this")
+    ];
+  }
+  const idWidth = Math.max(4, ...rows.map((r) => r.roomId.length));
+  const field = (metrics, name) => metrics[name] === void 0 ? "-" : String(metrics[name]);
+  const bytes = (metrics, name) => {
+    const value = metrics[name];
+    if (value === void 0) return "-";
+    if (value >= 1e6) return `${(value / 1e6).toFixed(1)}M`;
+    if (value >= 1e3) return `${(value / 1e3).toFixed(1)}k`;
+    return String(value);
+  };
+  const out = [
+    pc.dim(
+      `${"ROOM".padEnd(idWidth)}  CONN  TICKS       MAXTICKMS   OVERRUNS  ELU     IN        OUT       SAMPLE AGE`
+    )
+  ];
+  for (const r of rows) {
+    out.push(
+      `${r.roomId.padEnd(idWidth)}  ${field(r.metrics, "connections").padEnd(4)}  ${field(r.metrics, "ticks").padEnd(10)}  ${field(r.metrics, "maxTickMs").padEnd(10)}  ${field(r.metrics, "overruns").padEnd(8)}  ${field(r.metrics, "workerElu").padEnd(6)}  ${bytes(r.metrics, "ingressBytes").padEnd(8)}  ${bytes(r.metrics, "egressBytes").padEnd(8)}  ${pc.dim(formatSampleAge(r.at, now))}`
+    );
+  }
+  return out;
+}
+var ROOM_HISTORY_NAMES = ["ticks", "maxTickMs", "overruns", "connections"];
+function formatRoomHistory(rows) {
+  if (rows.length === 0) {
+    return [pc.dim("no samples for this room in the 7-day retention window")];
+  }
+  const order = [];
+  const samples = /* @__PURE__ */ new Map();
+  for (const row of rows) {
+    let sample = samples.get(row.at);
+    if (sample === void 0) {
+      sample = {};
+      samples.set(row.at, sample);
+      order.push(row.at);
+    }
+    sample[row.name] = row.value;
+  }
+  const out = [];
+  for (const at of order.slice(0, 10)) {
+    const sample = samples.get(at);
+    const parts = ROOM_HISTORY_NAMES.filter((name) => sample[name] !== void 0).map(
+      (name) => `${name}=${sample[name]}`
+    );
+    out.push(`${pc.dim(formatTimestamp(at))}  ${parts.join(" ")}`);
+  }
+  return out;
+}
+async function runStatus(options) {
+  const log = options.log ?? ((line) => console.log(line));
+  const controlUrl = await resolveControlUrlForUser(options.controlUrl);
+  const client = options.client ?? await createApiClient(controlUrl);
+  if (options.room !== void 0) {
+    const rows = await client.get(
+      `/v1/projects/${options.project}/metrics`,
+      { room: options.room }
+    );
+    for (const line of formatRoomHistory(rows)) log(line);
+    return { kind: "room", rows };
+  }
+  const [project, metrics, rooms] = await Promise.all([
+    client.get(`/v1/projects/${options.project}`),
+    client.get(`/v1/projects/${options.project}/metrics`),
+    client.get(`/v1/projects/${options.project}/metrics/rooms`)
+  ]);
+  log(`shards: ${typeof project.shards === "number" ? project.shards : 1}`);
+  log("");
+  for (const line of formatAggregateMetrics(metrics)) log(line);
+  log("");
+  for (const line of formatRoomsSnapshot(rooms, options.now ?? Date.now())) log(line);
+  return { kind: "project", metrics, rooms };
+}
+async function status(args, deps = {}) {
+  const log = deps.log ?? ((line) => console.log(line));
+  const errorLog = deps.errorLog ?? ((line) => console.error(line));
+  try {
+    const parsed = parseStatusArgs(args);
+    const config = await readProjectConfig(process.cwd(), "irtio status", parsed.config);
+    const project = parsed.project ?? config.project;
+    if (project === void 0) {
+      throw new Error(
+        "irtio status: no project id. Pass --project or run this from a project with irtio.json"
+      );
+    }
+    await runStatus({
+      project,
+      log,
+      ...parsed.room !== void 0 ? { room: parsed.room } : {},
+      ...parsed.url !== void 0 ? { controlUrl: parsed.url } : {},
+      ...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");
+      process.exitCode = 1;
+      return;
+    }
+    errorLog(pc.red(err instanceof Error ? err.message : String(err)));
+    process.exitCode = 1;
+  }
+}
+export {
+  USAGE,
+  parseStatusArgs,
+  runStatus,
+  status
+};

package/dist/usage-4G23QXCH.js

@@ -0,0 +1,213 @@
+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/usage.ts
+import pc from "picocolors";
+var USAGE = `usage: irtio usage [options]
+
+Shows what a project used this billing period, per meter.
+
+The period is the calendar month in UTC. Meters nothing has reported print "not reported"
+rather than zero, because those are different facts.
+
+On the card plan each meter shows its included allowance, the overage rate, and an estimated
+overage cost where usage is past the bundle. The free plan shows no dollar figures: it stops
+at its caps instead of billing.
+
+options:
+  --windows          also print the hourly windows behind the totals
+  --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 parseUsageArgs(args) {
+  if (helpRequested(args)) throw helpFor(USAGE);
+  const parsed = {};
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    switch (arg) {
+      case "--windows":
+        parsed.windows = true;
+        break;
+      case "--project": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio usage: --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 usage: --config needs a value");
+        parsed.config = value;
+        break;
+      }
+      case "--url": {
+        const value = args[++i];
+        if (value === void 0) throw new Error("irtio usage: --url needs a value");
+        parsed.url = value;
+        break;
+      }
+      default:
+        throw new Error(`irtio usage: unknown option ${JSON.stringify(arg)}`);
+    }
+  }
+  return parsed;
+}
+function formatBytes(bytes) {
+  const units = ["B", "KB", "MB", "GB", "TB"];
+  let value = bytes;
+  let unit = 0;
+  while (value >= 1e3 && unit < units.length - 1) {
+    value /= 1e3;
+    unit++;
+  }
+  return `${unit === 0 ? String(Math.round(value)) : value.toFixed(2)} ${units[unit]}`;
+}
+function formatMeterValue(meter) {
+  if (meter.unit === "bytes") return formatBytes(meter.used);
+  if (meter.unit === "hours") return `${meter.used.toFixed(3)} hours`;
+  return `${meter.used.toFixed(2)} ${meter.unit}`;
+}
+function formatQuantity(value, unit) {
+  if (unit === "bytes") return formatBytes(value);
+  if (unit === "hours") return `${value} hours`;
+  return `${value} ${unit}`;
+}
+function estimatedOverage(meter) {
+  const p = meter.pricing;
+  if (p === void 0 || !meter.present) return void 0;
+  const used = meter.walledUsed ?? meter.used;
+  const over = used - (p.cardIncluded ?? 0);
+  if (!Number.isFinite(over) || over <= 0) return void 0;
+  return over / p.per * p.rate;
+}
+var CARD_BASE_FEE_USD = 9;
+function formatUsage(body, showWindows) {
+  const out = [pc.dim(`period ${body.period.label}  \xB7  project ${body.project}`), ""];
+  const width = Math.max(6, ...body.meters.map((m) => m.label.length));
+  const card = body.plan === "card";
+  let overageTotal = 0;
+  for (const meter of body.meters) {
+    if (!meter.present) {
+      out.push(`${meter.label.padEnd(width)}  ${pc.dim("not reported")}`);
+      if (meter.note !== void 0) out.push(`${" ".repeat(width)}  ${pc.dim(meter.note)}`);
+      continue;
+    }
+    const gauge = meter.gauge ? pc.dim("  (high-water this period)") : "";
+    out.push(`${meter.label.padEnd(width)}  ${formatMeterValue(meter)}${gauge}`);
+    if (meter.byEngine !== void 0) {
+      const parts = Object.entries(meter.byEngine).sort(([a], [b]) => a.localeCompare(b)).map(([engine, hours]) => `${engine}=${hours.toFixed(3)}`);
+      if (parts.length > 0)
+        out.push(`${" ".repeat(width)}  ${pc.dim(`by engine: ${parts.join(" ")}`)}`);
+    }
+    if (card && meter.pricing !== void 0) {
+      const p = meter.pricing;
+      const bundle = p.cardIncluded !== void 0 ? `included ${formatQuantity(p.cardIncluded, meter.unit)}, then ${p.rateLabel}` : `no included bundle, ${p.rateLabel}`;
+      out.push(`${" ".repeat(width)}  ${pc.dim(bundle)}`);
+      const over = estimatedOverage(meter);
+      if (over !== void 0) {
+        overageTotal += over;
+        out.push(`${" ".repeat(width)}  estimated overage: $${over.toFixed(2)}`);
+      }
+    }
+  }
+  out.push("");
+  if (card) {
+    out.push(
+      overageTotal > 0 ? `estimated overage this period: $${overageTotal.toFixed(2)}, ` + pc.dim(
+        `plus the $${CARD_BASE_FEE_USD}/mo base fee. Estimates, not an invoice. This total is what counts against your monthly overage spend cap; at the cap every meter stops.`
+      ) : pc.dim(
+        `within the included bundle: no overage so far this period (the $${CARD_BASE_FEE_USD}/mo base fee still applies)`
+      )
+    );
+  } else if (body.plan === "free") {
+    out.push(
+      pc.dim("free plan: usage stops at its caps and nothing is billed; add a card for overage")
+    );
+  } else {
+    out.push(pc.dim("these are measurements, not charges"));
+  }
+  if (showWindows) {
+    out.push("");
+    if (body.windows.length === 0) {
+      out.push(pc.dim("no windows in this period"));
+    } else {
+      out.push(pc.dim("WINDOW                METER          SOURCE  ENGINE    VALUE"));
+      for (const w of body.windows) {
+        out.push(
+          `${w.windowStart.replace("T", " ").replace(/:\d\d\.\d+Z$/, "Z").padEnd(20)}  ${w.meter.padEnd(13)}  ${(w.source || "-").padEnd(6)}  ${(w.engine || "-").padEnd(8)}  ${w.value}`
+        );
+      }
+    }
+  }
+  return out;
+}
+async function runUsage(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/${options.project}/usage`);
+  for (const line of formatUsage(body, options.windows === true)) log(line);
+  return body;
+}
+async function usage(args, deps = {}) {
+  const log = deps.log ?? ((line) => console.log(line));
+  const errorLog = deps.errorLog ?? ((line) => console.error(line));
+  try {
+    const parsed = parseUsageArgs(args);
+    const config = await readProjectConfig(process.cwd(), "irtio usage", parsed.config);
+    const project = parsed.project ?? config.project;
+    if (project === void 0) {
+      throw new Error(
+        "irtio usage: no project id. Pass --project or run this from a project with irtio.json"
+      );
+    }
+    await runUsage({
+      project,
+      log,
+      ...parsed.windows === true ? { windows: true } : {},
+      ...parsed.url !== void 0 ? { controlUrl: parsed.url } : {},
+      ...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");
+      process.exitCode = 1;
+      return;
+    }
+    errorLog(pc.red(err instanceof Error ? err.message : String(err)));
+    process.exitCode = 1;
+  }
+}
+export {
+  CARD_BASE_FEE_USD,
+  USAGE,
+  estimatedOverage,
+  formatBytes,
+  formatMeterValue,
+  formatUsage,
+  parseUsageArgs,
+  runUsage,
+  usage
+};

package/dist/{whoami-S73O6KJF.js → whoami-KTMTQNHM.js}

@@ -1,14 +1,28 @@
+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/whoami.ts
 import pc from "picocolors";
+var USAGE = `usage: irtio whoami [--url <control>]
+
+Prints the identity your stored credential resolves to, and the control plane it was asked.
+
+options:
+  --url <control>    the control plane to ask (default: your stored login)
+  -h, --help         print this
+`;
 function parseWhoamiArgs(args) {
+  if (helpRequested(args)) throw helpFor(USAGE);
   const parsed = {};
   for (let i = 0; i < args.length; i++) {
     const arg = args[i];
@@ -46,6 +60,10 @@ async function whoami(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");
@@ -57,6 +75,7 @@ async function whoami(args, deps = {}) {
   }
 }
 export {
+  USAGE,
   parseWhoamiArgs,
   runWhoami,
   whoami

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@irtio/cli",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "irtio CLI: local dev server, room scaffolding, bot simulation, deploy, logs and rooms",
   "license": "MIT",
   "publishConfig": {
@@ -17,6 +17,22 @@
     "./bundle": {
       "types": "./dist/bundle.d.ts",
       "import": "./dist/bundle.js"
+    },
+    "./api": {
+      "types": "./dist/api.d.ts",
+      "import": "./dist/api.js"
+    },
+    "./credentials": {
+      "types": "./dist/credentials.d.ts",
+      "import": "./dist/credentials.js"
+    },
+    "./simulate": {
+      "types": "./dist/simulate.d.ts",
+      "import": "./dist/simulate.js"
+    },
+    "./deploy": {
+      "types": "./dist/deploy.d.ts",
+      "import": "./dist/deploy.js"
     }
   },
   "bin": {
@@ -29,14 +45,15 @@
     "esbuild": "^0.27.3",
     "picocolors": "^1.1.1",
     "ws": "^8.18.0",
-    "@irtio/client": "0.5.1",
-    "@irtio/protocol": "0.5.1",
-    "@irtio/bots": "0.5.1",
-    "@irtio/schema": "0.5.1",
-    "@irtio/runtime": "0.5.1",
-    "@irtio/server": "0.5.1"
+    "@irtio/client": "0.6.0",
+    "@irtio/bots": "0.6.0",
+    "@irtio/protocol": "0.6.0",
+    "@irtio/server": "0.6.0",
+    "@irtio/runtime": "0.6.0",
+    "@irtio/schema": "0.6.0"
   },
   "devDependencies": {
+    "@types/ws": "^8.5.13",
     "@dimforge/rapier3d-compat": "0.20.0",
     "@irtio/store": "0.0.0",
     "@irtio/supervisor": "0.0.0"