apiblaze 0.20.5 → 0.20.6

package/dist/index.js

@@ -932,7 +932,7 @@ var import_commander = require("commander");
 var import_chalk51 = __toESM(require("chalk"));
 
 // package.json
-var version = "0.20.5";
+var version = "0.20.6";
 
 // src/index.ts
 init_types();
@@ -9834,6 +9834,7 @@ var OP_COMMANDS = [
   { cmd: "op latency", blurb: "which FEATURE is slow, and what inside it", extra: "--hours N --team T --project P" },
   { cmd: "op latency slow", blurb: "slowest requests, each with a request id you can look up", extra: "--min-ms N" },
   { cmd: "op latency llm", blurb: "chat timing by provider/model, tokens, credit-reserve cost" },
+  { cmd: "op latency grades", blurb: "daily %% excellent / okay / bad / terrible, and who to blame", extra: "--days N" },
   { cmd: "op mark", blurb: 'record "I changed something significant just now"', extra: 'apiblaze op mark "cached tenant count"' },
   { cmd: "op latency compare", blurb: "latency before vs after the last mark, equal windows", extra: "--hours N" },
   { cmd: "op credits", blurb: "list credit wallets across all teams" },
@@ -10014,7 +10015,11 @@ async function runOp(sub, opts = {}, view) {
         ["route", "route"],
         ["environment", "environment"],
         ["statusClass", "status_class"],
-        ["minMs", "min_ms"]
+        ["minMs", "min_ms"],
+        ["days", "days"],
+        ["excellent", "excellent"],
+        ["okay", "okay"],
+        ["bad", "bad"]
       ];
       for (const [optKey, queryKey] of FILTERS) {
         const v = opts[optKey];
@@ -10022,6 +10027,37 @@ async function runOp(sub, opts = {}, view) {
       }
       const q = qs.toString() ? `?${qs}` : "";
       const which = view;
+      if (which === "grades") {
+        const data = await opCall({ method: "GET", path: `/operator/latency/grades${q}`, summary: "latency grades" });
+        if (opts.json) return void console.log(JSON.stringify(data, null, 2));
+        const t = data.thresholds_ms;
+        console.log(import_chalk50.default.bold("\nHow good was apiblaze itself?") + import_chalk50.default.dim("  (our overhead only \u2014 a slow customer API never counts against us)"));
+        console.log(import_chalk50.default.dim(`  excellent <${t.excellent.replace("<", "")}ms \xB7 okay ${t.okay}ms \xB7 bad ${t.bad}ms \xB7 terrible ${t.terrible.replace(">=", "")}ms+
+`));
+        console.log(import_chalk50.default.dim("  date         reqs   excellent      okay       bad  terrible"));
+        for (const d of data.days ?? []) {
+          const p = d.pct;
+          const cell = (v, colour) => v > 0 ? colour(`${String(v).padStart(5)}%`) : import_chalk50.default.dim(`${String(v).padStart(5)}%`);
+          console.log(
+            `  ${d.date}  ${String(d.total).padStart(5)}   ${cell(p.excellent, import_chalk50.default.green)}  ${cell(p.okay, import_chalk50.default.cyan)}  ${cell(p.bad, import_chalk50.default.yellow)}  ${cell(p.terrible, import_chalk50.default.red)}`
+          );
+        }
+        const cul = data.culprits ?? [];
+        if (cul.length) {
+          console.log(import_chalk50.default.bold("\n  Who caused the bad and terrible ones\n"));
+          console.log(import_chalk50.default.dim("     bad  terrible  feature \u2192 dependency"));
+          for (const r of cul.slice(0, 12)) {
+            if (!r.bad && !r.terrible) continue;
+            console.log(
+              `  ${String(r.bad).padStart(6)}  ${import_chalk50.default.red(String(r.terrible).padStart(8))}  ${import_chalk50.default.yellow(r.feature)} ${import_chalk50.default.dim("\u2192")} ${import_chalk50.default.cyan(r.dep)}`
+            );
+          }
+        }
+        if (data.caveat) console.log(import_chalk50.default.dim(`
+  \u26A0 ${data.caveat}
+`));
+        return;
+      }
       if (which === "compare") {
         const data = await opCall({ method: "GET", path: `/operator/latency/compare${q}`, summary: "latency before/after" });
         if (opts.json) return void console.log(JSON.stringify(data, null, 2));
@@ -10274,7 +10310,7 @@ apikeys.command("list").description("List control-plane API keys in your team").
 apikeys.command("mint").description("Create a control-plane API key (secret shown once)").option("--desc <text>", "Description").option("--expires-days <n>", "Expiry in days (default 90 server-side)").option("--team <id|name>", "Team (defaults to active team)").option("--json", "Output machine-readable JSON").action(action((opts, cmd) => runKeyMint({ ...cmd.parent?.opts(), ...opts })));
 apikeys.command("revoke").description("Revoke a control-plane API key").argument("<keyId>", "Key id (see `apikeys list`)").option("--team <id|name>", "Team (defaults to active team)").action(action((keyId, opts, cmd) => runKeyRevoke(keyId, { ...cmd.parent?.opts(), ...opts })));
 program.addCommand(apikeys, { hidden: true });
-var op = new import_commander.Command("op").description("Operator menu (platform operators only)").argument("[action]", "latency | mark | credits | residue | sweep (omit for the menu)").argument("[view]", "for `latency`: slow | llm | compare \xB7 for `mark`: the change name, quoted").option("-y, --yes", "Skip the sweep confirmation prompt").option("--json", "Output machine-readable JSON").option("--hours <n>", "Look-back window in hours (default 1)").option("--team <id>", "Filter to one team").option("--project <name>", "Filter to one proxy").option("--api-version <v>", "Filter to one API version").option("--tenant <name>", "Filter to one tenant").option("--route <path>", "Filter to one route").option("--environment <env>", "Filter to one environment").option("--status-class <c>", "Filter to a status class (2xx/4xx/5xx)").option("--min-ms <n>", "For `latency slow`: minimum duration (default 1000)").action(action((sub, view, opts) => runOp(sub, opts, view))).addHelpText("after", () => `
+var op = new import_commander.Command("op").description("Operator menu (platform operators only)").argument("[action]", "latency | mark | credits | residue | sweep (omit for the menu)").argument("[view]", "for `latency`: slow | llm | compare | grades \xB7 for `mark`: the change name, quoted").option("-y, --yes", "Skip the sweep confirmation prompt").option("--json", "Output machine-readable JSON").option("--hours <n>", "Look-back window in hours (default 1)").option("--team <id>", "Filter to one team").option("--project <name>", "Filter to one proxy").option("--api-version <v>", "Filter to one API version").option("--tenant <name>", "Filter to one tenant").option("--route <path>", "Filter to one route").option("--environment <env>", "Filter to one environment").option("--status-class <c>", "Filter to a status class (2xx/4xx/5xx)").option("--min-ms <n>", "For `latency slow`: minimum duration (default 1000)").option("--days <n>", "For `latency grades`: how many days back (default 7)").option("--excellent <ms>", "Grade threshold: under this is excellent (default 250)").option("--okay <ms>", "Grade threshold: under this is okay (default 500)").option("--bad <ms>", "Grade threshold: under this is bad, at/over is terrible (default 1000)").action(action((sub, view, opts) => runOp(sub, opts, view))).addHelpText("after", () => `
 ${renderOpCommands()}
 `);
 program.addCommand(op, { hidden: true });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "apiblaze",
-  "version": "0.20.5",
+  "version": "0.20.6",
   "description": "APIblaze CLI — Chat with your APIs, Manage your API keys, users and groups with the APIblaze serverless proxy",
   "keywords": [
     "apiblaze",