@develemail/cli 0.1.4 → 0.1.6

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
 // src/index.ts
-import { Command as Command8 } from "commander";
+import { Command as Command11 } from "commander";
 
 // src/commands/send.ts
 import { Command } from "commander";
@@ -91,7 +91,10 @@ var COL_STATUS = 10;
 function col(s, w) {
   return s.slice(0, w).padEnd(w);
 }
-var logsCommand = new Command2("logs").description("List recent emails").option("--limit <n>", "Number of emails to show", "20").option("--status <status>", "Filter by status (sent, queued, failed, \u2026)").action(async (opts) => {
+var logsCommand = new Command2("logs").description("List recent emails").option("--limit <n>", "Number of emails to show", "20").option(
+  "--status <status>",
+  "Filter by status (sent, delivered, queued, deferred, bounced, failed, \u2026)"
+).action(async (opts) => {
   const cfg = loadConfig();
   const params = new URLSearchParams({ limit: opts.limit });
   if (opts.status) params.set("status", opts.status);
@@ -139,6 +142,12 @@ var tailCommand = new Command3("tail").description("Poll and print new email eve
   const cfg = loadConfig();
   const seen = /* @__PURE__ */ new Set();
   const startedAt = opts.since ? new Date(opts.since) : /* @__PURE__ */ new Date();
+  if (opts.since && isNaN(startedAt.getTime())) {
+    console.error(
+      `Error: invalid --since value "${opts.since}" \u2014 use ISO 8601 (e.g. 2026-07-20) or other valid date format`
+    );
+    process.exit(1);
+  }
   console.log("Tailing email events\u2026 (Ctrl-C to stop)");
   const poll = async () => {
     try {
@@ -173,15 +182,39 @@ import { Command as Command4 } from "commander";
 import {
   createServer
 } from "http";
-import { exec } from "child_process";
+
+// src/open-browser.ts
+import { execFile } from "child_process";
 import { platform } from "os";
-function openBrowser(url) {
-  const cmd = platform() === "darwin" ? "open" : platform() === "win32" ? "start" : "xdg-open";
-  exec(`${cmd} "${url}"`);
+function isHttpUrl(url) {
+  try {
+    const { protocol } = new URL(url);
+    return protocol === "http:" || protocol === "https:";
+  } catch {
+    return false;
+  }
+}
+function commandFor(os, url) {
+  if (os === "darwin") return ["open", [url]];
+  if (os === "win32") return ["rundll32", ["url.dll,FileProtocolHandler", url]];
+  return ["xdg-open", [url]];
+}
+function openBrowser(url, deps = {}) {
+  if (!isHttpUrl(url)) return false;
+  const spawn = deps.spawn ?? ((file2, args2) => {
+    execFile(file2, args2, () => {
+    });
+  });
+  const [file, args] = commandFor(deps.platform ?? platform(), url);
+  spawn(file, args);
+  return true;
 }
-var loginCommand = new Command4("login").description("Authenticate with your DevelEmail instance via browser").requiredOption(
+
+// src/commands/login.ts
+var loginCommand = new Command4("login").description("Authenticate with your DevelEmail instance via browser").option(
   "--url <url>",
-  "Base URL of your DevelEmail instance (e.g. https://develemail.com/api)"
+  "Base URL of your DevelEmail API",
+  "https://develemail.com/api"
 ).action(async (opts) => {
   const apiUrl = opts.url.replace(/\/$/, "");
   const baseUrl = apiUrl.replace(/\/api$/, "");
@@ -277,7 +310,22 @@ var listCommand = new Command5("list").description("List all projects").action(a
     );
   }
 });
-var createCommand = new Command5("create").description("Create a new project").requiredOption("--name <name>", "Project name (slug, e.g. my-app)").option(
+var getCommand = new Command5("get").description("Get project details").argument("<id>", "Project ID").action(async (id) => {
+  const { url, token } = loadOwnerSession();
+  const project = await apiRequest(`${url}/projects/${id}`, token);
+  console.log(`ID: ${project.id}`);
+  console.log(`Name: ${project.name}`);
+  console.log(`Environment: ${project.environment}`);
+  console.log(`From Address: ${project.defaultFromAddress ?? "\u2014"}`);
+  console.log(
+    `Rate Limit: ${project.rateLimitPerDay ?? "Unlimited"} per day`
+  );
+  if (project.domainId) {
+    console.log(`Domain ID: ${project.domainId}`);
+  }
+  console.log(`Created At: ${new Date(project.createdAt).toISOString()}`);
+});
+var createCommand = new Command5("create").description("Create a new project").requiredOption("--name <name>", "Project name (slug, e.g. my-app)").option("--domain <domainId>", "Domain ID for this project").option(
   "--env <env>",
   "Environment: development | staging | production",
   "production"
@@ -288,6 +336,7 @@ var createCommand = new Command5("create").description("Create a new project").r
       method: "POST",
       body: JSON.stringify({
         name: opts.name,
+        domainId: opts.domain,
         environment: opts.env,
         defaultFromAddress: opts.from,
         rateLimitPerDay: opts.rateLimit ? Number(opts.rateLimit) : void 0,
@@ -297,10 +346,284 @@ var createCommand = new Command5("create").description("Create a new project").r
     console.log(`Created project: ${project.name} (${project.id})`);
   }
 );
-var projectCommand = new Command5("project").description("Manage projects").addCommand(listCommand).addCommand(createCommand);
+var projectCommand = new Command5("project").description("Manage projects").addCommand(listCommand).addCommand(getCommand).addCommand(createCommand);
 
-// src/commands/key.ts
+// src/commands/domains.ts
+import { Command as Command7 } from "commander";
+
+// src/owner-api.ts
+var OwnerApiError = class extends Error {
+  constructor(message, status) {
+    super(message);
+    this.status = status;
+  }
+  status;
+};
+async function ownerRequest(path, init) {
+  const { url, token } = loadOwnerSession();
+  const res = await fetch(`${url}${path}`, {
+    ...init,
+    headers: {
+      Cookie: `session=${token}`,
+      "Content-Type": "application/json",
+      ...init?.headers ?? {}
+    }
+  });
+  if (res.status === 401) {
+    throw new OwnerApiError(
+      "Session expired or missing. Run `devel login` first.",
+      401
+    );
+  }
+  if (!res.ok) {
+    const body = await res.json().catch(() => ({}));
+    throw new OwnerApiError(body.message ?? res.statusText, res.status);
+  }
+  return res.json();
+}
+function exitOnError(fn) {
+  return async (...args) => {
+    try {
+      await fn(...args);
+    } catch (err) {
+      console.error(`Error: ${err instanceof Error ? err.message : err}`);
+      process.exit(1);
+    }
+  };
+}
+
+// src/commands/dns-records.ts
+var BIND_TTL = 3600;
+function formatBind(records) {
+  return records.map((r) => {
+    const value = r.type === "TXT" ? `"${r.value.replace(/"/g, '\\"')}"` : r.value;
+    return `${r.host}. ${BIND_TTL} IN ${r.type} ${value}`;
+  }).join("\n");
+}
+function formatTable(records) {
+  return records.map(
+    (r) => `${r.priority.padEnd(11)} ${r.type.padEnd(5)} ${r.host}
+  ${r.value}
+  (${r.purpose})`
+  ).join("\n");
+}
+function printRecords(records, format, json) {
+  if (json) console.log(JSON.stringify(records, null, 2));
+  else if (format === "bind") console.log(formatBind(records));
+  else console.log(formatTable(records));
+}
+
+// src/commands/publish-dns.ts
 import { Command as Command6 } from "commander";
+import { createInterface } from "readline/promises";
+function pickZone(domainName, zones) {
+  const matches = zones.filter(
+    (z) => domainName === z.name || domainName.endsWith(`.${z.name}`)
+  );
+  if (matches.length === 0) {
+    throw new Error(`No Cloudflare zone matches ${domainName}.`);
+  }
+  const longest = Math.max(...matches.map((z) => z.name.length));
+  const best = matches.filter((z) => z.name.length === longest);
+  if (best.length > 1) {
+    throw new Error(
+      `Several zones match ${domainName}: ${best.map((z) => z.id).join(", ")}. Pass --zone.`
+    );
+  }
+  return best[0];
+}
+function printPlan(plan) {
+  for (const w of plan.warnings) console.log(`warning: ${w}`);
+  for (const c of plan.changes) {
+    const from = c.existingContent ? ` (was: ${c.existingContent})` : "";
+    console.log(
+      `${c.action.padEnd(6)} ${c.type} ${c.name} -> ${c.content}${from}`
+    );
+    for (const w of c.warnings) console.log(`       warning: ${w}`);
+  }
+}
+async function confirm() {
+  const rl = createInterface({ input: process.stdin, output: process.stdout });
+  try {
+    const answer = await rl.question("Apply these changes? [y/N] ");
+    return /^y(es)?$/i.test(answer.trim());
+  } finally {
+    rl.close();
+  }
+}
+var publishDnsCommand = new Command6("publish-dns").description("Publish a domain\u2019s DNS records to Cloudflare").argument("<id>", "Domain ID").option("--zone <zoneId>", "Cloudflare zone ID (default: auto-pick)").option("--yes", "Apply without prompting").option("--json", "Output JSON").action(
+  exitOnError(async (id, opts) => {
+    let zoneId = opts.zone;
+    if (!zoneId) {
+      const domain = await ownerRequest(`/domains/${id}`);
+      const zones = await ownerRequest("/cloudflare/zones");
+      zoneId = pickZone(domain.name, zones).id;
+    }
+    const plan = await ownerRequest(`/cloudflare/domains/${id}/plan`, {
+      method: "POST",
+      body: JSON.stringify({ zoneId })
+    });
+    if (!opts.json) printPlan(plan);
+    const apply = opts.yes || process.stdin.isTTY === true && await confirm();
+    if (!apply) {
+      if (opts.json) console.log(JSON.stringify({ plan, applied: false }));
+      else
+        console.log("Dry run: nothing applied. Re-run with --yes to apply.");
+      return;
+    }
+    const result = await ownerRequest("/cloudflare/apply", {
+      method: "POST",
+      body: JSON.stringify(plan)
+    });
+    if (opts.json)
+      console.log(JSON.stringify({ plan, applied: true, result }));
+    else console.log("Applied.");
+  })
+);
+
+// src/commands/domains.ts
+var COL_ID3 = 40;
+var COL_NAME2 = 30;
+var COL_STATUS2 = 15;
+function col3(s, w) {
+  return (s ?? "").slice(0, w).padEnd(w);
+}
+function printStatuses(d) {
+  console.log(`SPF Status: ${d.spfStatus ?? "\u2014"}`);
+  console.log(`DKIM Status: ${d.dkimStatus ?? "\u2014"}`);
+  console.log(`DMARC Status: ${d.dmarcStatus ?? "\u2014"}`);
+}
+var listCommand2 = new Command7("list").description("List all domains").action(
+  exitOnError(async () => {
+    const domains = await ownerRequest("/domains");
+    if (domains.length === 0) {
+      console.log("No domains found.");
+      return;
+    }
+    const header = `${col3("ID", COL_ID3)} ${col3("NAME", COL_NAME2)} ${col3("STATUS", COL_STATUS2)} CREATED`;
+    console.log(header);
+    console.log("-".repeat(header.length + 20));
+    for (const d of domains) {
+      const createdAt = new Date(d.createdAt).toLocaleDateString();
+      console.log(
+        `${col3(d.id, COL_ID3)} ${col3(d.name, COL_NAME2)} ${col3(d.verificationStatus, COL_STATUS2)} ${createdAt}`
+      );
+    }
+  })
+);
+var getCommand2 = new Command7("get").description("Get domain details").argument("<id>", "Domain ID").action(
+  exitOnError(async (id) => {
+    const domain = await ownerRequest(`/domains/${id}`);
+    console.log(`ID: ${domain.id}`);
+    console.log(`Name: ${domain.name}`);
+    console.log(`Verification Status: ${domain.verificationStatus}`);
+    printStatuses(domain);
+    console.log(`MX Status: ${domain.mxStatus ?? "\u2014"}`);
+    console.log(`Return Path Status: ${domain.returnPathStatus ?? "\u2014"}`);
+    console.log(`PTR Status: ${domain.ptrStatus ?? "\u2014"}`);
+    console.log(`DKIM Selector: ${domain.dkimSelector}`);
+    console.log(`DKIM Public Key:
+${domain.dkimPublicKey}`);
+    console.log(`Created At: ${new Date(domain.createdAt).toISOString()}`);
+  })
+);
+var addCommand = new Command7("add").description("Create a domain and print its required DNS records").argument("<name>", "Domain name, e.g. example.com").option("--dkim-selector <selector>", "DKIM selector").option("--json", "Output JSON").action(
+  exitOnError(
+    async (name, opts) => {
+      const domain = await ownerRequest("/domains", {
+        method: "POST",
+        body: JSON.stringify({ name, dkimSelector: opts.dkimSelector })
+      });
+      const records = await ownerRequest(
+        `/domains/${domain.id}/dns-records`
+      );
+      if (opts.json) {
+        console.log(JSON.stringify({ domain, records }, null, 2));
+        return;
+      }
+      console.log(`Created domain: ${domain.name} (${domain.id})`);
+      console.log("\nRequired DNS records:");
+      printRecords(records, "table", false);
+    }
+  )
+);
+var recordsCommand = new Command7("records").description("Print the DNS records a domain requires").argument("<id>", "Domain ID").option("--json", "Output JSON").option("--format <format>", "table | bind", "table").action(
+  exitOnError(
+    async (id, opts) => {
+      const records = await ownerRequest(
+        `/domains/${id}/dns-records`
+      );
+      printRecords(records, opts.format, opts.json === true);
+    }
+  )
+);
+var POLL_INTERVAL_MS2 = 1e4;
+var sleep = (ms) => new Promise((r) => setTimeout(r, ms));
+var verifyCommand = new Command7("verify").description("Trigger domain verification").argument("<id>", "Domain ID").option("--wait", "Poll until verified or timed out").option("--timeout <seconds>", "Max seconds to wait with --wait", "600").action(
+  exitOnError(
+    async (id, opts) => {
+      const deadline = Date.now() + Number(opts.timeout) * 1e3;
+      for (; ; ) {
+        const domain = await ownerRequest(
+          `/domains/${id}/verify`,
+          { method: "POST" }
+        );
+        console.log(`Domain verification: ${domain.name}`);
+        console.log(`Current status: ${domain.verificationStatus}`);
+        printStatuses(domain);
+        if (!opts.wait || domain.verificationStatus === "verified") return;
+        if (Date.now() + POLL_INTERVAL_MS2 > deadline) {
+          throw new Error(
+            `Timed out after ${opts.timeout}s; not yet verified.`
+          );
+        }
+        await sleep(POLL_INTERVAL_MS2);
+      }
+    }
+  )
+);
+var domainsCommand = new Command7("domains").description("Manage domains").addCommand(listCommand2).addCommand(getCommand2).addCommand(addCommand).addCommand(recordsCommand).addCommand(publishDnsCommand).addCommand(verifyCommand);
+
+// src/commands/cloudflare.ts
+import { Command as Command8 } from "commander";
+var connectCommand = new Command8("connect").description("Connect a Cloudflare API token to your organization").requiredOption(
+  "--token-env <VAR>",
+  "Environment variable holding the Cloudflare API token"
+).action(
+  exitOnError(async (opts) => {
+    const apiToken = process.env[opts.tokenEnv];
+    if (!apiToken) {
+      throw new Error(`Environment variable ${opts.tokenEnv} is not set.`);
+    }
+    await ownerRequest("/cloudflare/connect", {
+      method: "POST",
+      body: JSON.stringify({ apiToken })
+    });
+    console.log("Cloudflare connected.");
+  })
+);
+var statusCommand = new Command8("status").description("Show whether Cloudflare is connected").action(
+  exitOnError(async () => {
+    const { connected } = await ownerRequest(
+      "/cloudflare/status"
+    );
+    console.log(connected ? "Connected" : "Not connected");
+  })
+);
+var zonesCommand = new Command8("zones").description("List Cloudflare zones").option("--json", "Output JSON").action(
+  exitOnError(async (opts) => {
+    const zones = await ownerRequest("/cloudflare/zones");
+    if (opts.json) {
+      console.log(JSON.stringify(zones, null, 2));
+      return;
+    }
+    for (const z of zones) console.log(`${z.id}  ${z.name}  ${z.status}`);
+  })
+);
+var cloudflareCommand = new Command8("cloudflare").description("Manage the Cloudflare integration").addCommand(connectCommand).addCommand(statusCommand).addCommand(zonesCommand);
+
+// src/commands/key.ts
+import { Command as Command9 } from "commander";
 function ownerHeaders2(token) {
   return { Cookie: `session=${token}`, "Content-Type": "application/json" };
 }
@@ -316,7 +639,7 @@ async function apiRequest2(url, token, init) {
   }
   return res.json();
 }
-var listCommand2 = new Command6("list").description("List API keys for a project").requiredOption("--project <id>", "Project ID").action(async (opts) => {
+var listCommand3 = new Command9("list").description("List API keys for a project").requiredOption("--project <id>", "Project ID").action(async (opts) => {
   const { url, token } = loadOwnerSession();
   const keys = await apiRequest2(
     `${url}/projects/${opts.project}/api-keys`,
@@ -331,7 +654,7 @@ var listCommand2 = new Command6("list").description("List API keys for a project
     console.log(`${status} ${k.keyPrefix}\u2026  ${k.name}  (${k.id})`);
   }
 });
-var createCommand2 = new Command6("create").description("Create a new API key for a project").requiredOption("--project <id>", "Project ID").requiredOption("--name <name>", "Key name (e.g. production, ci)").option("--expires <date>", "Expiry date (ISO-8601, e.g. 2027-01-01)").option("--rate-limit <n>", "Max requests per minute").action(
+var createCommand2 = new Command9("create").description("Create a new API key for a project").requiredOption("--project <id>", "Project ID").requiredOption("--name <name>", "Key name (e.g. production, ci)").option("--expires <date>", "Expiry date (ISO-8601, e.g. 2027-01-01)").option("--rate-limit <n>", "Max requests per minute").action(
   async (opts) => {
     const { url, token } = loadOwnerSession();
     const result = await apiRequest2(
@@ -353,10 +676,10 @@ var createCommand2 = new Command6("create").description("Create a new API key fo
     console.log("Store the secret now \u2014 it will not be shown again.");
   }
 );
-var keyCommand = new Command6("key").description("Manage API keys").addCommand(listCommand2).addCommand(createCommand2);
+var keyCommand = new Command9("key").description("Manage API keys").addCommand(listCommand3).addCommand(createCommand2);
 
 // src/commands/init.ts
-import { Command as Command7 } from "commander";
+import { Command as Command10 } from "commander";
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
 function ownerHeaders3(token) {
@@ -386,7 +709,7 @@ function upsertEnvFile(filePath, vars) {
   const content = lines.join("\n").trimEnd() + (lines.some((l) => l.trim()) ? "\n" : "") + appended + "\n";
   writeFileSync2(filePath, content, "utf-8");
 }
-var initCommand = new Command7("init").description(
+var initCommand = new Command10("init").description(
   "Provision a project + API key and write credentials to an env file"
 ).requiredOption(
   "--project <name>",
@@ -440,10 +763,12 @@ var initCommand = new Command7("init").description(
 );
 
 // src/index.ts
-var program = new Command8().name("devel").description("DevelEmail CLI \u2014 interact with your DevelEmail instance").version("0.1.0");
+var program = new Command11().name("devel").description("DevelEmail CLI \u2014 interact with your DevelEmail instance").version("0.1.0");
 program.addCommand(loginCommand);
 program.addCommand(logoutCommand);
 program.addCommand(projectCommand);
+program.addCommand(domainsCommand);
+program.addCommand(cloudflareCommand);
 program.addCommand(keyCommand);
 program.addCommand(initCommand);
 program.addCommand(sendCommand);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@develemail/cli",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "type": "module",
   "bin": {
     "devel": "dist/index.js"
@@ -16,7 +16,7 @@
   "dependencies": {
     "commander": "^12.1.0",
     "dotenv": "^16.4.5",
-    "@develemail/sdk": "0.1.1"
+    "@develemail/sdk": "0.4.0"
   },
   "devDependencies": {
     "tsup": "^8.3.5",