@infrarates/cli 0.0.0-stage → 0.1.0

package/commands.mjs

@@ -0,0 +1,183 @@
+// Customer routes only. Each command declares its authentication and options.
+// The website console (src/ui/console.ts) keeps a copy; test/console.test.ts fails when they drift.
+export const commands = [
+  [
+    "prices history",
+    "GET",
+    "/v1/prices/history",
+    "key",
+    ["providers", "alias", "as-of", "limit", "cursor", "all", "format"],
+  ],
+  [
+    "prices latest",
+    "GET",
+    "/api/prices/latest",
+    "key",
+    [
+      "provider",
+      "resource",
+      "category",
+      "dimension",
+      "tier",
+      "limit",
+      "offset",
+      "sort",
+      "dir",
+      "prefer",
+      "still-listed",
+    ],
+  ],
+  [
+    "prices resource-history",
+    "GET",
+    "/api/prices/history",
+    "key",
+    [
+      "provider",
+      "resource",
+      "source",
+      "category",
+      "dimension",
+      "tier",
+      "unit",
+      "from",
+      "to",
+      "as-of",
+    ],
+  ],
+  ["terms latest", "GET", "/api/tos/latest", "key", ["provider", "doc"]],
+  ["terms history", "GET", "/api/tos/history", "key", ["provider", "doc"]],
+  ["terms diff", "GET", "/api/tos/diff", "key", ["provider", "doc", "a", "b"]],
+  [
+    "terms content <key>",
+    "GET",
+    "/api/snapshots/:key/content",
+    "key",
+    ["prefix", "name"],
+  ],
+  ["status", "GET", "/api/health", "key", []],
+  ["providers list", "GET", "/v1/providers", "key", []],
+  ["catalog", "GET", "/v1/catalog", "key", ["provider"]],
+  ["activity", "GET", "/v1/activity", "key", []],
+  ["compare resources", "GET", "/v1/comparison/resources", "key", []],
+  [
+    "compare prices",
+    "GET",
+    "/v1/comparison/prices",
+    "key",
+    ["resource", "conversion"],
+  ],
+  ["compare aliases", "GET", "/v1/comparison/aliases", "key", []],
+  [
+    "compare proposals list",
+    "GET",
+    "/v1/comparison/alias-proposals",
+    "session",
+    ["after"],
+  ],
+  [
+    "compare proposals create",
+    "POST",
+    "/v1/comparison/alias-proposals",
+    "session",
+    ["data"],
+  ],
+  ["me", "GET", "/v1/me", "session", []],
+  ["organizations get", "GET", "/v1/organization", "session", []],
+  ["organizations create", "POST", "/v1/organizations", "session", ["data"]],
+  [
+    "organizations switch",
+    "POST",
+    "/v1/session/organization",
+    "session",
+    ["data"],
+  ],
+  ["webhooks list", "GET", "/v1/webhooks", "session", []],
+  ["webhooks get <id>", "GET", "/v1/webhooks/:id", "session", []],
+  ["webhooks create", "POST", "/v1/webhooks", "session", ["data"]],
+  ["webhooks update <id>", "PUT", "/v1/webhooks/:id", "session", ["data"]],
+  ["webhooks delete <id>", "DELETE", "/v1/webhooks/:id", "session", []],
+  ["webhooks secret <id>", "GET", "/v1/webhooks/:id/secret", "session", []],
+  [
+    "webhooks rotate-secret <id>",
+    "POST",
+    "/v1/webhooks/:id/secret/rotate",
+    "session",
+    [],
+  ],
+  ["webhooks test <id>", "POST", "/v1/webhooks/:id/test", "session", []],
+  [
+    "webhooks deliveries <id>",
+    "GET",
+    "/v1/webhooks/:id/deliveries",
+    "session",
+    [],
+  ],
+  [
+    "webhooks resend <id> <eventId>",
+    "POST",
+    "/v1/webhooks/:id/deliveries/:eventId/resend",
+    "session",
+    [],
+  ],
+  ["members list", "GET", "/v1/members", "session", []],
+  ["members update <id>", "PATCH", "/v1/members/:id", "session", ["data"]],
+  ["members delete <id>", "DELETE", "/v1/members/:id", "session", []],
+  ["invitations create", "POST", "/v1/invitations", "session", ["data"]],
+  ["invitations delete <id>", "DELETE", "/v1/invitations/:id", "session", []],
+  ["api-keys list", "GET", "/v1/api-keys", "session", []],
+  ["api-keys create", "POST", "/v1/api-keys", "session", ["data"]],
+  ["api-keys delete <id>", "DELETE", "/v1/api-keys/:id", "session", []],
+  ["sources list", "GET", "/v1/sources", "session", []],
+  ["incidents list", "GET", "/v1/incidents", "session", []],
+  ["preferences get", "GET", "/v1/preferences", "session", []],
+  ["preferences update", "PUT", "/v1/preferences", "session", ["data"]],
+  [
+    "provider-requests list",
+    "GET",
+    "/v1/provider-requests",
+    "session",
+    ["after"],
+  ],
+  [
+    "provider-requests get <id>",
+    "GET",
+    "/v1/provider-requests/:id",
+    "session",
+    [],
+  ],
+  [
+    "provider-requests create",
+    "POST",
+    "/v1/provider-requests",
+    "session",
+    ["data"],
+  ],
+];
+
+export function resolveCommand(positionals) {
+  for (const [name, method, template, auth, options] of commands) {
+    const parts = name.split(" ");
+    if (
+      parts.length !== positionals.length ||
+      !parts.every((p, i) => p.startsWith("<") || p === positionals[i])
+    )
+      continue;
+    let path = template;
+    parts.forEach((p, i) => {
+      if (!p.startsWith("<")) return;
+      const value = positionals[i];
+      if (
+        !/^[a-zA-Z0-9_.-]{1,200}$/.test(value) ||
+        value === "." ||
+        value === ".."
+      )
+        throw new Error("Invalid resource ID.");
+      if (p === "<key>" && !/^tos-[a-z0-9-]+$/.test(value))
+        throw new Error("Expected a terms snapshot key: tos-<provider>-<doc>.");
+      path = path.replace(`:${p.slice(1, -1)}`, encodeURIComponent(value));
+    });
+    return { name, method, path, auth, options };
+  }
+  throw new Error("Unknown command. Use --help for available commands.");
+}

package/format-history.mjs

@@ -0,0 +1,162 @@
+const segmenter = new Intl.Segmenter("en", { granularity: "grapheme" });
+const characters = (text) =>
+  [...segmenter.segment(text)].map((part) => part.segment);
+const charWidth = (char) =>
+  /[\p{Extended_Pictographic}\u1100-\u115f\u2329\u232a\u2e80-\ua4cf\uac00-\ud7a3\uf900-\ufaff\ufe10-\ufe19\ufe30-\ufe6f\uff01-\uff60\uffe0-\uffe6]/u.test(
+    char,
+  )
+    ? 2
+    : 1;
+const width = (text) =>
+  characters(text).reduce((total, char) => total + charWidth(char), 0);
+// API values are untrusted terminal text; render controls visibly, including OSC/CSI escapes.
+const visible = (char) =>
+  `\\u${char.charCodeAt(0).toString(16).padStart(4, "0")}`;
+const text = (value) =>
+  value === null || value === undefined || value === ""
+    ? "-"
+    : String(value).replace(
+        /[\x00-\x1f\x7f-\x9f\u202a-\u202e\u2066-\u2069]/g,
+        visible,
+      );
+/** A multi-line document for a terminal: line breaks and tabs stay, other controls show escaped. */
+export const terminalText = (value) =>
+  value
+    .replace(/\r\n/g, "\n")
+    .replace(
+      /[\x00-\x08\x0b-\x1f\x7f-\x9f\u202a-\u202e\u2066-\u2069]/g,
+      visible,
+    );
+const quote = (value) => `'${text(value).replaceAll("'", "'\\''")}'`;
+function wrap(value, size) {
+  const lines = [];
+  let line = "",
+    used = 0;
+  for (const char of characters(value)) {
+    const next = charWidth(char);
+    if (used + next > size && line) {
+      lines.push(line);
+      line = "";
+      used = 0;
+    }
+    line += char;
+    used += next;
+  }
+  lines.push(line);
+  return lines;
+}
+function detailsLines(details, size) {
+  const lines = [];
+  let line = "";
+  for (const detail of details) {
+    if (line && width(`${line} | ${detail}`) > size) {
+      lines.push(line);
+      line = "";
+    }
+    if (width(detail) > size) lines.push(...wrap(detail, size));
+    else line = line ? `${line} | ${detail}` : detail;
+  }
+  if (line) lines.push(line);
+  return lines;
+}
+
+/** A display-only projection: exact prices and currencies retain their native units. */
+export function formatHistory(
+  history,
+  { columns = 100, baseUrl, limit, config } = {},
+) {
+  const available =
+    Number.isSafeInteger(columns) && columns > 0 ? columns : 100;
+  const rows = history.prices.map((row) => ({
+    cells: [
+      text(row?.provider),
+      text(row?.resource),
+      text(row?.dimension),
+      `${text(row?.price)} ${text(row?.currency)}`,
+      text(row?.unit),
+    ],
+    details: [
+      `Tier: ${text(row?.pricingTier)}`,
+      `Source: ${text(row?.source)}`,
+      `Recorded: ${text(row?.recordedAt)}`,
+      ...(row?.effectiveDate ? [`Effective: ${text(row.effectiveDate)}`] : []),
+      ...(row?.renamedTo ? [`Renamed to: ${text(row.renamedTo)}`] : []),
+    ],
+  }));
+  const headers = ["PROVIDER", "RESOURCE", "DIMENSION", "PRICE", "UNIT"];
+  const maximum = [16, 40, 24, Infinity, 28];
+  const minimum = [8, 12, 9, 5, 10];
+  const sizes = headers.map((header, index) =>
+    Math.min(
+      maximum[index],
+      rows.reduce(
+        (largest, row) => Math.max(largest, width(row.cells[index])),
+        width(header),
+      ),
+    ),
+  );
+  // Keep the full rate together; shrink descriptive columns and wrap their contents.
+  const total = () => sizes.reduce((sum, size) => sum + size, 0) + 8;
+  for (const index of [1, 4, 2, 0]) {
+    sizes[index] = Math.max(
+      Math.min(minimum[index], sizes[index]),
+      sizes[index] - Math.max(0, total() - available),
+    );
+  }
+  const output = [
+    `Price history (${rows.length} ${rows.length === 1 ? "observation" : "observations"})`,
+    `As of: ${text(history.asOf)}`,
+    `Providers: ${history.providers.map(text).join(", ")}`,
+    ...(history.alias
+      ? [
+          `Alias: ${text(history.alias.name)} (revision ${text(history.alias.revision)}, ${history.alias.members.length} members)`,
+        ]
+      : []),
+    "",
+  ];
+  if (!rows.length) output.push("No reviewed prices found for this snapshot.");
+  else if (total() > available) {
+    for (const row of rows) {
+      output.push(...wrap(`${row.cells[0]} / ${row.cells[1]}`, available));
+      output.push(...wrap(`Dimension: ${row.cells[2]}`, available));
+      output.push(`Price: ${row.cells[3]}`);
+      output.push(...wrap(`Unit: ${row.cells[4]}`, available));
+      for (const detail of row.details) output.push(...wrap(detail, available));
+      output.push("");
+    }
+  } else {
+    const line = (cells) =>
+      cells
+        .map(
+          (cell, i) => cell + " ".repeat(Math.max(0, sizes[i] - width(cell))),
+        )
+        .join("  ")
+        .trimEnd();
+    output.push(
+      line(headers),
+      sizes.map((size) => "─".repeat(size)).join("  "),
+    );
+    for (const row of rows) {
+      const cells = row.cells.map((cell, i) => wrap(cell, sizes[i]));
+      for (
+        let index = 0;
+        index < Math.max(...cells.map((cell) => cell.length));
+        index++
+      )
+        output.push(line(cells.map((cell) => cell[index] ?? "")));
+      for (const detail of detailsLines(
+        row.details,
+        Math.max(1, available - 2),
+      ))
+        output.push(`  ${detail}`);
+      output.push("");
+    }
+  }
+  if (history.nextCursor)
+    output.push(
+      "More history is available. Continue with:",
+      `oimo prices history --cursor ${quote(history.nextCursor)}${baseUrl ? ` --base-url ${quote(baseUrl)}` : ""}${limit ? ` --limit ${quote(limit)}` : ""}${config ? ` --config ${quote(config)}` : ""}`,
+      "Use --all to fetch every page.",
+    );
+  return `${output.join("\n").trimEnd()}\n`;
+}

package/oimo.d.mts

@@ -0,0 +1,15 @@
+import type { browserLogin } from "./browser-login.mjs";
+
+export function run(
+  args: string[],
+  options?: {
+    env?: Record<string, string | undefined>;
+    fetcher?: (url: URL, init: RequestInit) => Promise<Response>;
+    write?: (text: string) => void;
+    readInput?: (hidden?: boolean) => Promise<string>;
+    loginBrowser?: typeof browserLogin;
+    report?: (text: string) => void;
+    isTTY?: boolean;
+    columns?: number;
+  },
+): Promise<void>;