@maycombhq/atticus 0.0.0-stage → 2.0.0-beta.11

package/dist/chunk-WGU6NIUV.js

@@ -0,0 +1,113 @@
+import { createRequire as __atticusCreateRequire } from "node:module";
+import { fileURLToPath as __atticusFileURLToPath } from "node:url";
+var require = __atticusCreateRequire(import.meta.url);
+var __atticusUrl = (p) => new URL("./" + p, import.meta.url).href;
+var __atticusPath = (p) => __atticusFileURLToPath(__atticusUrl(p));
+import {
+  loadCatalog
+} from "./chunk-BUWSOQLU.js";
+import {
+  buildStub,
+  checkStub,
+  startStub,
+  stubFromCatalog,
+  stubHandler
+} from "./chunk-SKMHS4CL.js";
+import {
+  table
+} from "./chunk-VOGCSYOI.js";
+import "./chunk-IILZ7J3L.js";
+import "./chunk-TEBBD4XH.js";
+import "./chunk-XPWSNKF3.js";
+import "./chunk-WIMOJMAK.js";
+import "./chunk-5V5BJACL.js";
+import "./chunk-GVFUEGGM.js";
+import "./chunk-XZJE6WIT.js";
+import "./chunk-FMRMTI7W.js";
+import "./chunk-BKFGGJKA.js";
+import "./chunk-JMOLB347.js";
+import "./chunk-MMB2OHUY.js";
+import "./chunk-TV45EUGM.js";
+
+// packages/cli/dist/stub-commands.js
+import { readFile } from "node:fs/promises";
+import { resolve } from "node:path";
+var EXAMPLES = /* @__PURE__ */ new Set(["example", "examples", "schema-example", "schema-default"]);
+async function readStub(path, io) {
+  let text;
+  try {
+    text = await readFile(path, "utf8");
+  } catch {
+    io.err(`Can't read ${path}`);
+    return 2;
+  }
+  try {
+    return buildStub(text);
+  } catch (e) {
+    io.err(e.message);
+    return 1;
+  }
+}
+async function stubServe(root, specOrId, o, io, listen = startStub) {
+  const port = o.port ?? 4010;
+  if (!Number.isInteger(port) || port < 0 || port > 65535) {
+    io.err(`--port must be a whole number from 0 to 65535.`);
+    return 2;
+  }
+  let stub;
+  if (o.catalog) {
+    const { records, generated } = await loadCatalog(root, io);
+    if (generated === 0) {
+      io.err("The catalog is empty: read the repos first (atticus map <repo>, then atticus verify <repo> --write).");
+      return 1;
+    }
+    try {
+      stub = stubFromCatalog(records, specOrId);
+    } catch (e) {
+      io.err(e.message);
+      return 1;
+    }
+  } else {
+    const r = await readStub(resolve(root, specOrId), io);
+    if (typeof r === "number")
+      return r;
+    stub = r;
+  }
+  for (const w of stub.warnings)
+    io.err(`warning: ${w}`);
+  if (stub.routes.length === 0) {
+    io.err(`${stub.title} has no operations to serve.`);
+    return 1;
+  }
+  const server = await listen(stubHandler(stub), { port, host: o.host ?? "127.0.0.1" });
+  const n = stub.routes.length;
+  io.out(`Serving ${stub.title} at ${server.url} (${n} operation${n === 1 ? "" : "s"}).`);
+  for (const l of table(["METHOD", "PATH", "ANSWERS"], stub.routes.map((r) => [r.method, r.path, `${r.status} (${r.example})`])))
+    io.out(`  ${l}`);
+  if (stub.basePaths.length > 0)
+    io.out(`Paths also work under ${stub.basePaths.join(", ")}.`);
+  io.out("Ask for another documented response with X-Stub-Status: <code>. Stop with Ctrl+C.");
+  return 0;
+}
+async function stubCheck(specPath, io) {
+  const r = await readStub(resolve(specPath), io);
+  if (typeof r === "number")
+    return r;
+  for (const w of r.warnings)
+    io.err(`warning: ${w}`);
+  const rows = checkStub(r);
+  for (const l of table(["METHOD", "PATH", "STATUS", "EXAMPLE"], rows.map((x) => [x.method, x.path, String(x.status), x.example])))
+    io.out(l);
+  const generated = rows.filter((x) => x.example === "generated").length;
+  const withExamples = rows.filter((x) => EXAMPLES.has(x.example)).length;
+  if (generated === 0) {
+    io.out(`All ${rows.length} operation${rows.length === 1 ? " has" : "s have"} an example or no body (${withExamples} with examples).`);
+    return 0;
+  }
+  io.out(`${generated} of ${rows.length} operation${rows.length === 1 ? "" : "s"} ${generated === 1 ? "has" : "have"} no example: the stub builds ${generated === 1 ? "that body" : "those bodies"} from the schema. Add examples to control what it returns.`);
+  return 1;
+}
+export {
+  stubCheck,
+  stubServe
+};