greybull 0.1.0 → 0.2.0

package/dist/index.js

@@ -94,7 +94,7 @@ var ApiError = class extends Error {
     this.status = status;
   }
 };
-var VERSION = "0.1.0";
+var VERSION = "0.2.0";
 function buildRequest(opts) {
   const url = new URL(opts.apiUrl.replace(/\/+$/, "") + opts.path);
   if (opts.query) {
@@ -148,13 +148,21 @@ async function apiRequest(opts) {
 }
 
 // src/output.ts
-function formatTable(headers, rows) {
+function formatTable(headers, rows, opts = {}) {
   if (rows.length === 0) return "(none)";
+  const max = opts.max ?? [];
+  const clip = (s, i) => {
+    const w = max[i];
+    return w && s.length > w ? s.slice(0, w - 1) + "\u2026" : s;
+  };
+  const hdr = headers.map((h, i) => clip(h, i));
+  const cells = rows.map((r) => headers.map((_, i) => clip(String(r[i] ?? ""), i)));
+  const last = headers.length - 1;
   const widths = headers.map(
-    (h, i) => Math.max(h.length, ...rows.map((r) => (r[i] ?? "").length))
+    (_, i) => Math.max(hdr[i].length, ...cells.map((r) => r[i].length))
   );
-  const line = (cells) => cells.map((c, i) => (c ?? "").padEnd(widths[i])).join("  ").trimEnd();
-  return [line(headers), ...rows.map(line)].join("\n");
+  const line = (row) => row.map((c, i) => i === last ? c : c.padEnd(widths[i])).join("  ").trimEnd();
+  return [line(hdr), ...cells.map(line)].join("\n");
 }
 function fail(error, opts) {
   let message = error instanceof Error ? error.message : String(error);
@@ -300,6 +308,10 @@ function page(title, body) {
 }
 
 // src/commands/dns.ts
+import fs2 from "fs";
+import os3 from "os";
+import path2 from "path";
+import { spawnSync } from "child_process";
 var RECORD_TYPES = ["A", "AAAA", "CNAME", "MX", "TXT", "NS", "SRV"];
 function buildListRecords(apiUrl, zone, opts) {
   return buildRequest({
@@ -368,11 +380,11 @@ async function listCmd(ctx2, zone, opts) {
   const rows = res.data.map((r) => [
     r.name,
     r.type,
-    r.content,
     String(r.ttl),
-    r.priority !== void 0 ? String(r.priority) : ""
+    r.priority !== void 0 ? String(r.priority) : "",
+    r.content
   ]);
-  process.stdout.write(formatTable(["NAME", "TYPE", "CONTENT", "TTL", "PRIO"], rows) + "\n");
+  process.stdout.write(formatTable(["NAME", "TYPE", "TTL", "PRIO", "CONTENT"], rows, { max: [48] }) + "\n");
 }
 async function addCmd(ctx2, zone, type, name, content, opts) {
   const upperType = assertType(type, ctx2);
@@ -424,6 +436,125 @@ async function deleteCmd(ctx2, zone, type, name, content, opts) {
 function runSpec(spec, ctx2) {
   return performRequest(spec, ctx2.apiKey).catch((err) => fail(err, ctx2));
 }
+var ERR_PREFIX = "; !! ";
+function renderZoneFile(zone, records) {
+  const rows = records.map((r) => {
+    const content = r.type === "MX" && r.priority !== void 0 ? `${r.priority} ${r.content}` : r.content;
+    return { name: r.name, ttl: String(r.ttl), type: r.type, content };
+  }).sort((a, b) => a.name.localeCompare(b.name) || a.type.localeCompare(b.type));
+  const nameW = Math.max(1, ...rows.map((r) => r.name.length));
+  const ttlW = Math.max(3, ...rows.map((r) => r.ttl.length));
+  const typeW = Math.max(4, ...rows.map((r) => r.type.length));
+  const header = [
+    `; Zone: ${zone}`,
+    "; Edit records below, then save and close your editor to apply.",
+    "; Format:  NAME  TTL  TYPE  CONTENT   (use @ for the zone apex)",
+    "; TXT values keep their quotes; MX/SRV keep priority in CONTENT.",
+    "; SOA and the apex NS records are managed for you and not shown.",
+    ";"
+  ];
+  const body = rows.map(
+    (r) => `${r.name.padEnd(nameW)}  ${r.ttl.padEnd(ttlW)}  ${r.type.padEnd(typeW)}  ${r.content}`
+  );
+  return [...header, ...body].join("\n") + "\n";
+}
+function parseZoneFile(text) {
+  const recs = [];
+  const lines = text.split("\n");
+  for (let i = 0; i < lines.length; i++) {
+    const trimmed = lines[i].trim();
+    if (!trimmed || trimmed.startsWith(";")) continue;
+    const m = trimmed.match(/^(\S+)\s+(\d+)\s+(?:IN\s+)?([A-Za-z]+)\s+(.+)$/i);
+    if (!m) {
+      throw new Error(`line ${i + 1}: could not parse "${trimmed}" (expected: NAME TTL TYPE CONTENT)`);
+    }
+    const [, name, ttlStr, typeRaw, content] = m;
+    const type = typeRaw.toUpperCase();
+    if (type === "SOA") throw new Error(`line ${i + 1}: SOA is managed automatically \u2014 remove it`);
+    if (!RECORD_TYPES.includes(type)) throw new Error(`line ${i + 1}: unknown record type "${typeRaw}"`);
+    recs.push({ name, type, content: content.trim(), ttl: parseInt(ttlStr) });
+  }
+  return recs;
+}
+function normalizeBody(text) {
+  return text.split("\n").map((l) => l.trim()).filter((l) => l && !l.startsWith(";")).map((l) => l.replace(/\s+/g, " ")).sort().join("\n");
+}
+function stripErrorLines(text) {
+  return text.split("\n").filter((l) => !l.startsWith(ERR_PREFIX)).join("\n");
+}
+function openInEditor(zone, content) {
+  const file = path2.join(os3.tmpdir(), `greybull-${zone}-${process.pid}.zone`);
+  fs2.writeFileSync(file, content);
+  const editor = process.env.VISUAL || process.env.EDITOR || (process.platform === "win32" ? "notepad" : "vi");
+  const [cmd, ...args] = editor.split(" ");
+  try {
+    const r = spawnSync(cmd, [...args, file], { stdio: "inherit" });
+    if (r.error) return null;
+    return fs2.readFileSync(file, "utf8");
+  } finally {
+    try {
+      fs2.unlinkSync(file);
+    } catch {
+    }
+  }
+}
+async function editCmd(ctx2, zone) {
+  const res = await apiRequest({
+    apiUrl: ctx2.apiUrl,
+    apiKey: ctx2.apiKey,
+    method: "GET",
+    path: `/api/v1/dns/zones/${encodeURIComponent(zone)}/records`
+  }).catch((err) => fail(err, ctx2));
+  const original = renderZoneFile(zone, res.data);
+  let buffer = original;
+  let banner = "";
+  let lastTried = null;
+  for (; ; ) {
+    const edited = openInEditor(zone, banner + buffer);
+    if (edited === null) fail(new Error("Could not launch editor. Set $EDITOR or $VISUAL."), ctx2);
+    buffer = stripErrorLines(edited);
+    if (normalizeBody(buffer) === normalizeBody(original)) {
+      process.stdout.write("No changes.\n");
+      return;
+    }
+    if (lastTried !== null && normalizeBody(buffer) === normalizeBody(lastTried)) {
+      fail(new Error("Aborted \u2014 the reported problem was not fixed."), ctx2);
+    }
+    let records;
+    try {
+      records = parseZoneFile(buffer);
+    } catch (err) {
+      banner = errorBanner(err.message);
+      lastTried = buffer;
+      continue;
+    }
+    try {
+      const put = await apiRequest({
+        apiUrl: ctx2.apiUrl,
+        apiKey: ctx2.apiKey,
+        method: "PUT",
+        path: `/api/v1/dns/zones/${encodeURIComponent(zone)}`,
+        body: { records }
+      });
+      process.stdout.write(`Applied ${put.data.applied} record(s) to ${zone}.
+`);
+      return;
+    } catch (err) {
+      if (err instanceof ApiError && (err.status === 422 || err.status === 400)) {
+        banner = errorBanner(err.message);
+        lastTried = buffer;
+        continue;
+      }
+      fail(err, ctx2);
+    }
+  }
+}
+function errorBanner(message) {
+  return `${ERR_PREFIX}${message}
+${ERR_PREFIX}Fix and save again, or exit without changes to abort.
+;
+`;
+}
 
 // src/commands/domains.ts
 async function domainsListCmd(ctx2) {
@@ -464,7 +595,7 @@ async function domainsCheckCmd(ctx2, query, opts) {
 
 // src/index.ts
 var program = new Command();
-program.name("greybull").description("Manage Greybull DNS records and domains from the command line").version("0.1.0").option("--json", "output raw JSON", false).option("--api-url <url>", "portal base URL (or set GREYBULL_API_URL)");
+program.name("greybull").description("Manage Greybull DNS records and domains from the command line").version("0.2.0").option("--json", "output raw JSON", false).option("--api-url <url>", "portal base URL (or set GREYBULL_API_URL)");
 function ctx(requireAuth = true) {
   const opts = program.opts();
   const apiUrl = resolveApiUrl(opts.apiUrl);
@@ -506,6 +637,9 @@ dns.command("update <zone> <type> <name> <old-content> <new-content>").descripti
 dns.command("delete <zone> <type> <name> <content>").description("Delete one specific record (content required \u2014 sibling-safe)").option("--priority <n>", "priority (MX/SRV)").action(async (zone, type, name, content, opts) => {
   await deleteCmd(ctx(), zone, type, name, content, opts);
 });
+dns.command("edit <zone>").description("Edit the whole zone in $EDITOR (like pdnsutil edit-zone)").action(async (zone) => {
+  await editCmd(ctx(), zone);
+});
 var domains = program.command("domains").description("Manage domains");
 domains.command("list").description("List your registered domains").action(async () => {
   await domainsListCmd(ctx());

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "greybull",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Command-line tool for the Greybull portal — manage DNS records and domains",
   "type": "module",
   "bin": {