@develemail/cli 0.1.6 → 0.1.7

package/README.md

@@ -0,0 +1,43 @@
+# @develemail/cli
+
+The `devel` command-line tool for DevelEmail: manage projects, domains and API
+keys, publish DNS, and send test emails.
+
+```bash
+npm install -g @develemail/cli
+devel --version
+```
+
+## Onboarding
+
+```bash
+devel login                      # opens a browser; saves an owner session
+devel domains add example.com    # prints the domain ID
+devel domains records <id>       # DNS records to publish (--format bind)
+devel domains publish-dns <id>   # or publish them to Cloudflare for you
+devel domains verify <id> --wait # poll until DNS verifies
+devel init --project my-app --from noreply@example.com
+```
+
+`devel login` defaults to `--url https://develemail.com/api`. The session is
+saved to `~/.config/develemail/auth.json`.
+
+`publish-dns` needs a Cloudflare token connected first:
+`devel cloudflare connect --token-env CLOUDFLARE_API_TOKEN`.
+
+## Receiving mail
+
+```bash
+devel inbound add example.com privacy --if-missing   # inbox-only mailbox
+devel inbound list example.com
+devel inbound check example.com                      # does the MX reach us?
+```
+
+`devel init` creates the project and an API key and writes
+`DEVELEMAIL_BASE_URL` and `DEVELEMAIL_API_KEY` to your env files. After that,
+`devel send`, `devel logs` and `devel tail` use that API key.
+
+## Reference
+
+Every command and option is documented in the
+[CLI reference](https://docs.develemail.com/cli-reference) on the DevelEmail docs site.

package/dist/index.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 
-// src/index.ts
-import { Command as Command11 } from "commander";
+// src/program.ts
+import { Command as Command13 } from "commander";
 
 // src/commands/send.ts
 import { Command } from "commander";
@@ -210,15 +210,46 @@ function openBrowser(url, deps = {}) {
   return true;
 }
 
+// src/resolve-web-app-url.ts
+var DISCOVERY_TIMEOUT_MS = 3e3;
+function trimSlash(url) {
+  return url.replace(/\/+$/, "");
+}
+function legacyWebAppUrl(apiUrl) {
+  return trimSlash(apiUrl).replace(/\/api$/, "");
+}
+async function resolveWebAppUrl(apiUrl, fetchImpl = fetch, options = {}) {
+  if (options.appUrl?.trim()) return trimSlash(options.appUrl.trim());
+  const base = trimSlash(apiUrl);
+  try {
+    const res = await fetchImpl(`${base}/meta/public-urls`, {
+      signal: AbortSignal.timeout(options.timeoutMs ?? DISCOVERY_TIMEOUT_MS)
+    });
+    if (!res.ok) return legacyWebAppUrl(base);
+    const body = await res.json();
+    return typeof body.webAppUrl === "string" && body.webAppUrl.trim() ? trimSlash(body.webAppUrl.trim()) : legacyWebAppUrl(base);
+  } catch {
+    return legacyWebAppUrl(base);
+  }
+}
+
 // 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 API",
-  "https://develemail.com/api"
+var DEFAULT_API_URL = "https://develemail.com/api";
+var loginCommand = new Command4("login").description("Authenticate with your DevelEmail instance via browser").option("--url <url>", "Base URL of your DevelEmail API", DEFAULT_API_URL).option(
+  "--app-url <url>",
+  "Dashboard URL to open for sign-in (discovered from the API by default)"
 ).action(async (opts) => {
+  if (!isHttpUrl(opts.url) || opts.appUrl && !isHttpUrl(opts.appUrl)) {
+    console.error("--url must be an http(s) URL");
+    process.exit(1);
+    return;
+  }
   const apiUrl = opts.url.replace(/\/$/, "");
-  const baseUrl = apiUrl.replace(/\/api$/, "");
+  const webAppUrl = await resolveWebAppUrl(apiUrl, fetch, {
+    appUrl: opts.appUrl
+  });
   await new Promise((resolve2, reject) => {
+    let timeout;
     const server = createServer(
       (req, res) => {
         const url = new URL(req.url ?? "/", `http://localhost`);
@@ -240,6 +271,7 @@ var loginCommand = new Command4("login").description("Authenticate with your Dev
         );
         console.log("Authenticated successfully.");
         console.log("Session saved to ~/.config/develemail/auth.json");
+        clearTimeout(timeout);
         server.close();
         resolve2();
       }
@@ -251,13 +283,16 @@ var loginCommand = new Command4("login").description("Authenticate with your Dev
         return;
       }
       const port = addr.port;
-      const authUrl = `${baseUrl}/cli-auth?port=${port}`;
+      const authUrl = `${webAppUrl}/cli-auth?port=${port}`;
       console.log("Opening browser for authentication...");
       console.log(`If the browser doesn't open, visit: ${authUrl}`);
       openBrowser(authUrl);
     });
-    server.on("error", reject);
-    setTimeout(
+    server.on("error", (err) => {
+      clearTimeout(timeout);
+      reject(err);
+    });
+    timeout = setTimeout(
       () => {
         server.close();
         reject(new Error("Authentication timed out after 5 minutes"));
@@ -294,6 +329,21 @@ var COL_ENV = 12;
 function col2(s, w) {
   return (s ?? "").slice(0, w).padEnd(w);
 }
+function formatCooldown(minutes) {
+  if (minutes == null) return "platform default";
+  return minutes === 0 ? "disabled" : `${minutes} min`;
+}
+function parseCooldownMinutes(raw) {
+  if (raw === "default") return null;
+  const n = Number(raw);
+  if (!Number.isInteger(n) || n < 0 || n > 1440) {
+    console.error(
+      'Error: --recipient-cooldown must be 0-1440 minutes, or "default"'
+    );
+    process.exit(1);
+  }
+  return n;
+}
 var listCommand = new Command5("list").description("List all projects").action(async () => {
   const { url, token } = loadOwnerSession();
   const projects = await apiRequest(`${url}/projects`, token);
@@ -320,6 +370,9 @@ var getCommand = new Command5("get").description("Get project details").argument
   console.log(
     `Rate Limit: ${project.rateLimitPerDay ?? "Unlimited"} per day`
   );
+  console.log(
+    `Recipient Cooldown: ${formatCooldown(project.recipientCooldownMinutes)}`
+  );
   if (project.domainId) {
     console.log(`Domain ID: ${project.domainId}`);
   }
@@ -346,10 +399,33 @@ 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(getCommand).addCommand(createCommand);
+var updateCommand = new Command5("update").description("Update project settings").argument("<id>", "Project ID").option(
+  "--recipient-cooldown <minutes>",
+  'Minutes before the same subject can be re-sent to a recipient (0 disables, "default" restores the platform default)'
+).action(async (id, opts) => {
+  const body = {};
+  if (opts.recipientCooldown !== void 0) {
+    body.recipientCooldownMinutes = parseCooldownMinutes(
+      opts.recipientCooldown
+    );
+  }
+  if (Object.keys(body).length === 0) {
+    console.error("Error: nothing to update; pass --recipient-cooldown");
+    process.exit(1);
+  }
+  const { url, token } = loadOwnerSession();
+  const project = await apiRequest(`${url}/projects/${id}`, token, {
+    method: "PATCH",
+    body: JSON.stringify(body)
+  });
+  console.log(
+    `Updated project: ${project.name} (recipient cooldown: ${formatCooldown(project.recipientCooldownMinutes)})`
+  );
+});
+var projectCommand = new Command5("project").description("Manage projects").addCommand(listCommand).addCommand(getCommand).addCommand(createCommand).addCommand(updateCommand);
 
 // src/commands/domains.ts
-import { Command as Command7 } from "commander";
+import { Command as Command8 } from "commander";
 
 // src/owner-api.ts
 var OwnerApiError = class extends Error {
@@ -365,7 +441,7 @@ async function ownerRequest(path, init) {
     ...init,
     headers: {
       Cookie: `session=${token}`,
-      "Content-Type": "application/json",
+      ...init?.body != null ? { "Content-Type": "application/json" } : {},
       ...init?.headers ?? {}
     }
   });
@@ -379,6 +455,7 @@ async function ownerRequest(path, init) {
     const body = await res.json().catch(() => ({}));
     throw new OwnerApiError(body.message ?? res.statusText, res.status);
   }
+  if (res.status === 204) return void 0;
   return res.json();
 }
 function exitOnError(fn) {
@@ -481,6 +558,63 @@ var publishDnsCommand = new Command6("publish-dns").description("Publish a domai
   })
 );
 
+// src/commands/domains-warmup.ts
+import { Command as Command7 } from "commander";
+var FULLY_WARMED_STAGE = 7;
+var STAGE_LIMITS = {
+  1: "50",
+  2: "100",
+  3: "200",
+  4: "400",
+  5: "800",
+  6: "1,600",
+  7: "Unlimited"
+};
+function printWarmupStatus(d) {
+  console.log(`Domain: ${d.name}`);
+  if (d.warmupStage === null) {
+    console.log("Warmup: not started");
+    return;
+  }
+  console.log(
+    d.warmupStage >= FULLY_WARMED_STAGE ? "Stage: Fully warmed" : `Stage: ${d.warmupStage} of ${FULLY_WARMED_STAGE}`
+  );
+  console.log(`Daily limit: ${STAGE_LIMITS[d.warmupStage] ?? "Unknown"}`);
+  if (d.warmupPausedAt) {
+    console.log(`Paused since ${new Date(d.warmupPausedAt).toLocaleString()}`);
+  }
+}
+async function runWarmup(id, opts) {
+  if (opts.pause && opts.resume) {
+    throw new Error("Use either --pause or --resume, not both.");
+  }
+  const patch = (warmupPausedAt) => ownerRequest(`/domains/${id}`, {
+    method: "PATCH",
+    body: JSON.stringify({ warmupPausedAt })
+  });
+  let domain;
+  if (opts.pause) {
+    domain = await patch((/* @__PURE__ */ new Date()).toISOString());
+  } else if (opts.resume) {
+    domain = await patch(null);
+  } else {
+    domain = await ownerRequest(`/domains/${id}`);
+    if (domain.warmupStage === null) {
+      domain = await ownerRequest(
+        `/domains/${id}/warmup/enable`,
+        {
+          method: "POST"
+        }
+      );
+    } else {
+      console.log("Warmup already in progress");
+    }
+  }
+  if (opts.json) console.log(JSON.stringify(domain, null, 2));
+  else printWarmupStatus(domain);
+}
+var warmupCommand = new Command7("warmup").description("Start, pause or resume domain warmup").argument("<id>", "Domain ID").option("--pause", "Pause the warmup ramp").option("--resume", "Resume a paused warmup ramp").option("--json", "Output the domain as JSON").action(exitOnError(runWarmup));
+
 // src/commands/domains.ts
 var COL_ID3 = 40;
 var COL_NAME2 = 30;
@@ -493,7 +627,7 @@ function printStatuses(d) {
   console.log(`DKIM Status: ${d.dkimStatus ?? "\u2014"}`);
   console.log(`DMARC Status: ${d.dmarcStatus ?? "\u2014"}`);
 }
-var listCommand2 = new Command7("list").description("List all domains").action(
+var listCommand2 = new Command8("list").description("List all domains").action(
   exitOnError(async () => {
     const domains = await ownerRequest("/domains");
     if (domains.length === 0) {
@@ -511,7 +645,7 @@ var listCommand2 = new Command7("list").description("List all domains").action(
     }
   })
 );
-var getCommand2 = new Command7("get").description("Get domain details").argument("<id>", "Domain ID").action(
+var getCommand2 = new Command8("get").description("Get domain details").argument("<id>", "Domain ID").action(
   exitOnError(async (id) => {
     const domain = await ownerRequest(`/domains/${id}`);
     console.log(`ID: ${domain.id}`);
@@ -527,7 +661,7 @@ ${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(
+var addCommand = new Command8("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", {
@@ -547,7 +681,7 @@ var addCommand = new Command7("add").description("Create a domain and print its
     }
   )
 );
-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(
+var recordsCommand = new Command8("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(
@@ -559,7 +693,7 @@ var recordsCommand = new Command7("records").description("Print the DNS records
 );
 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(
+var verifyCommand = new Command8("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;
@@ -582,11 +716,209 @@ var verifyCommand = new Command7("verify").description("Trigger domain verificat
     }
   )
 );
-var domainsCommand = new Command7("domains").description("Manage domains").addCommand(listCommand2).addCommand(getCommand2).addCommand(addCommand).addCommand(recordsCommand).addCommand(publishDnsCommand).addCommand(verifyCommand);
+var domainsCommand = new Command8("domains").description("Manage domains").addCommand(listCommand2).addCommand(getCommand2).addCommand(addCommand).addCommand(recordsCommand).addCommand(publishDnsCommand).addCommand(verifyCommand).addCommand(warmupCommand);
+
+// src/commands/inbound.ts
+import { createInterface as createInterface2 } from "readline/promises";
+import { Command as Command9 } from "commander";
+
+// src/commands/inbound-check.ts
+import { resolve4, resolveMx } from "dns/promises";
+var INBOUND_HOST = "mail.develemail.com";
+async function checkMx(domain) {
+  const [mx, inbound] = await Promise.all([
+    resolveMx(domain),
+    resolve4(INBOUND_HOST)
+  ]);
+  const checks = await Promise.all(
+    mx.map(async (r) => {
+      const addresses = await resolve4(r.exchange).catch(() => []);
+      return {
+        exchange: r.exchange,
+        priority: r.priority,
+        addresses,
+        pointsAtInbound: addresses.some((a) => inbound.includes(a))
+      };
+    })
+  );
+  return checks.sort((a, b) => a.priority - b.priority);
+}
+
+// src/commands/inbound.ts
+var COL_ADDRESS = 32;
+var COL_ACTIVE = 8;
+var COL_WEBHOOK = 36;
+var COL_NOTIFY = 30;
+function col4(s, w) {
+  return s.slice(0, w).padEnd(w);
+}
+function toAddress(localPart) {
+  return localPart === "*" ? null : localPart;
+}
+function label(address) {
+  return address ?? "*";
+}
+async function resolveDomain(nameOrId) {
+  const domains = await ownerRequest("/domains");
+  const match = domains.find(
+    (d) => d.id === nameOrId || d.name === nameOrId.toLowerCase()
+  );
+  if (!match) throw new Error(`Domain not found: ${nameOrId}`);
+  return match;
+}
+async function findRoute(domain, localPart) {
+  const address = toAddress(localPart.toLowerCase());
+  const routes = await ownerRequest(
+    `/domains/${domain.id}/inbound-routes`
+  );
+  const route = routes.find((r) => r.address === address);
+  if (!route) {
+    throw new Error(`No inbound route for ${label(address)}@${domain.name}`);
+  }
+  return route;
+}
+function noneToNull(value) {
+  return value === "none" ? null : value;
+}
+async function confirm2(question) {
+  const rl = createInterface2({ input: process.stdin, output: process.stdout });
+  try {
+    return /^y(es)?$/i.test((await rl.question(question)).trim());
+  } finally {
+    rl.close();
+  }
+}
+var listCommand3 = new Command9("list").description("List inbound routes for a domain").argument("<domain>", "Domain name or ID").option("--json", "Output JSON").action(
+  exitOnError(async (domainArg, opts) => {
+    const domain = await resolveDomain(domainArg);
+    const routes = await ownerRequest(
+      `/domains/${domain.id}/inbound-routes`
+    );
+    if (opts.json) {
+      console.log(JSON.stringify(routes, null, 2));
+      return;
+    }
+    if (routes.length === 0) {
+      console.log(`No inbound routes for ${domain.name}.`);
+      return;
+    }
+    const header = `${col4("ADDRESS", COL_ADDRESS)} ${col4("ACTIVE", COL_ACTIVE)} ${col4("WEBHOOK", COL_WEBHOOK)} ${col4("NOTIFY", COL_NOTIFY)} CREATED`;
+    console.log(header);
+    console.log("-".repeat(header.length + 10));
+    for (const r of routes) {
+      console.log(
+        `${col4(`${label(r.address)}@${domain.name}`, COL_ADDRESS)} ${col4(r.active ? "yes" : "no", COL_ACTIVE)} ${col4(r.webhookUrl ?? "-", COL_WEBHOOK)} ${col4(r.notifyEmail ?? "-", COL_NOTIFY)} ${new Date(r.createdAt).toLocaleDateString()}`
+      );
+    }
+  })
+);
+var addCommand2 = new Command9("add").description("Create an inbound route (use * for a catch-all)").argument("<domain>", "Domain name or ID").argument("<local-part>", "Local part, or * for catch-all").option("--webhook <url>", "Deliver received mail to this webhook").option("--notify <email>", "Send an arrival notification to this address").option("--if-missing", "Exit 0 if the route already exists").action(
+  exitOnError(
+    async (domainArg, localPart, opts) => {
+      const domain = await resolveDomain(domainArg);
+      const address = toAddress(localPart);
+      try {
+        const route = await ownerRequest(
+          `/domains/${domain.id}/inbound-routes`,
+          {
+            method: "POST",
+            body: JSON.stringify({
+              address,
+              webhookUrl: opts.webhook ?? null,
+              notifyEmail: opts.notify ?? null
+            })
+          }
+        );
+        console.log(
+          `Created inbound route ${label(address)}@${domain.name} (${route.id})`
+        );
+      } catch (err) {
+        if (opts.ifMissing && err instanceof OwnerApiError && err.status === 409) {
+          console.log(
+            `Inbound route ${label(address)}@${domain.name} already exists`
+          );
+          return;
+        }
+        throw err;
+      }
+    }
+  )
+);
+var updateCommand2 = new Command9("update").description("Update an inbound route").argument("<domain>", "Domain name or ID").argument("<local-part>", "Local part, or * for catch-all").option("--webhook <url|none>", "Set or clear the webhook").option("--notify <email|none>", "Set or clear the notify email").option("--active", "Enable the route").option("--inactive", "Disable the route").action(
+  exitOnError(
+    async (domainArg, localPart, opts) => {
+      if (opts.active && opts.inactive) {
+        throw new Error("Pass only one of --active and --inactive");
+      }
+      const domain = await resolveDomain(domainArg);
+      const route = await findRoute(domain, localPart);
+      const body = {
+        webhookUrl: noneToNull(opts.webhook),
+        notifyEmail: noneToNull(opts.notify),
+        active: opts.active ? true : opts.inactive ? false : void 0
+      };
+      await ownerRequest(
+        `/domains/${domain.id}/inbound-routes/${route.id}`,
+        { method: "PATCH", body: JSON.stringify(body) }
+      );
+      console.log(`Updated ${label(route.address)}@${domain.name}`);
+    }
+  )
+);
+var removeCommand = new Command9("remove").description("Delete an inbound route").argument("<domain>", "Domain name or ID").argument("<local-part>", "Local part, or * for catch-all").option("--yes", "Delete without prompting").action(
+  exitOnError(
+    async (domainArg, localPart, opts) => {
+      const domain = await resolveDomain(domainArg);
+      const route = await findRoute(domain, localPart);
+      const target = `${label(route.address)}@${domain.name}`;
+      const ok = opts.yes || process.stdin.isTTY === true && await confirm2(`Delete inbound route ${target}? [y/N] `);
+      if (!ok) {
+        console.log("Nothing deleted. Re-run with --yes to delete.");
+        return;
+      }
+      await ownerRequest(
+        `/domains/${domain.id}/inbound-routes/${route.id}`,
+        { method: "DELETE" }
+      );
+      console.log(`Deleted ${target}`);
+    }
+  )
+);
+var checkCommand = new Command9("check").description("Show whether a domain MX points at the inbound server").argument("<domain>", "Domain name or ID").option("--json", "Output JSON").action(
+  exitOnError(async (domainArg, opts) => {
+    const ref = await resolveDomain(domainArg);
+    const [domain, mx] = await Promise.all([
+      ownerRequest(`/domains/${ref.id}`),
+      checkMx(ref.name)
+    ]);
+    const ok = mx.some((r) => r.pointsAtInbound);
+    if (opts.json) {
+      console.log(
+        JSON.stringify(
+          { mxStatus: domain.mxStatus ?? null, ok, mx },
+          null,
+          2
+        )
+      );
+      return;
+    }
+    console.log(`MX Status: ${domain.mxStatus ?? "\u2014"}`);
+    if (mx.length === 0) console.log("No MX records found.");
+    for (const r of mx) {
+      console.log(
+        `MX ${r.priority} ${r.exchange} -> ${r.addresses.join(", ") || "unresolved"} ${r.pointsAtInbound ? "(inbound server)" : "(not the inbound server)"}`
+      );
+    }
+    console.log(
+      ok ? `OK: mail for ${ref.name} reaches ${INBOUND_HOST}.` : `Mail for ${ref.name} does not reach ${INBOUND_HOST}; point its MX at ${INBOUND_HOST}.`
+    );
+  })
+);
+var inboundCommand = new Command9("inbound").description("Manage inbound mailboxes").addCommand(listCommand3).addCommand(addCommand2).addCommand(updateCommand2).addCommand(removeCommand).addCommand(checkCommand);
 
 // 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(
+import { Command as Command10 } from "commander";
+var connectCommand = new Command10("connect").description("Connect a Cloudflare API token to your organization").requiredOption(
   "--token-env <VAR>",
   "Environment variable holding the Cloudflare API token"
 ).action(
@@ -602,7 +934,7 @@ var connectCommand = new Command8("connect").description("Connect a Cloudflare A
     console.log("Cloudflare connected.");
   })
 );
-var statusCommand = new Command8("status").description("Show whether Cloudflare is connected").action(
+var statusCommand = new Command10("status").description("Show whether Cloudflare is connected").action(
   exitOnError(async () => {
     const { connected } = await ownerRequest(
       "/cloudflare/status"
@@ -610,7 +942,7 @@ var statusCommand = new Command8("status").description("Show whether Cloudflare
     console.log(connected ? "Connected" : "Not connected");
   })
 );
-var zonesCommand = new Command8("zones").description("List Cloudflare zones").option("--json", "Output JSON").action(
+var zonesCommand = new Command10("zones").description("List Cloudflare zones").option("--json", "Output JSON").action(
   exitOnError(async (opts) => {
     const zones = await ownerRequest("/cloudflare/zones");
     if (opts.json) {
@@ -620,10 +952,10 @@ var zonesCommand = new Command8("zones").description("List Cloudflare zones").op
     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);
+var cloudflareCommand = new Command10("cloudflare").description("Manage the Cloudflare integration").addCommand(connectCommand).addCommand(statusCommand).addCommand(zonesCommand);
 
 // src/commands/key.ts
-import { Command as Command9 } from "commander";
+import { Command as Command11 } from "commander";
 function ownerHeaders2(token) {
   return { Cookie: `session=${token}`, "Content-Type": "application/json" };
 }
@@ -639,7 +971,7 @@ async function apiRequest2(url, token, init) {
   }
   return res.json();
 }
-var listCommand3 = new Command9("list").description("List API keys for a project").requiredOption("--project <id>", "Project ID").action(async (opts) => {
+var listCommand4 = new Command11("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`,
@@ -654,7 +986,7 @@ var listCommand3 = new Command9("list").description("List API keys for a project
     console.log(`${status} ${k.keyPrefix}\u2026  ${k.name}  (${k.id})`);
   }
 });
-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(
+var createCommand2 = new Command11("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(
@@ -676,10 +1008,10 @@ var createCommand2 = new Command9("create").description("Create a new API key fo
     console.log("Store the secret now \u2014 it will not be shown again.");
   }
 );
-var keyCommand = new Command9("key").description("Manage API keys").addCommand(listCommand3).addCommand(createCommand2);
+var keyCommand = new Command11("key").description("Manage API keys").addCommand(listCommand4).addCommand(createCommand2);
 
 // src/commands/init.ts
-import { Command as Command10 } from "commander";
+import { Command as Command12 } from "commander";
 import { readFileSync as readFileSync2, writeFileSync as writeFileSync2 } from "fs";
 import { resolve } from "path";
 function ownerHeaders3(token) {
@@ -709,7 +1041,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 Command10("init").description(
+var initCommand = new Command12("init").description(
   "Provision a project + API key and write credentials to an env file"
 ).requiredOption(
   "--project <name>",
@@ -762,16 +1094,29 @@ var initCommand = new Command10("init").description(
   }
 );
 
+// src/version.ts
+import { createRequire } from "module";
+var require2 = createRequire(import.meta.url);
+function readCliVersion() {
+  return require2("../package.json").version;
+}
+
+// src/program.ts
+function buildProgram() {
+  const program = new Command13().name("devel").description("DevelEmail CLI \u2014 interact with your DevelEmail instance").version(readCliVersion());
+  program.addCommand(loginCommand);
+  program.addCommand(logoutCommand);
+  program.addCommand(projectCommand);
+  program.addCommand(domainsCommand);
+  program.addCommand(inboundCommand);
+  program.addCommand(cloudflareCommand);
+  program.addCommand(keyCommand);
+  program.addCommand(initCommand);
+  program.addCommand(sendCommand);
+  program.addCommand(logsCommand);
+  program.addCommand(tailCommand);
+  return program;
+}
+
 // src/index.ts
-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);
-program.addCommand(logsCommand);
-program.addCommand(tailCommand);
-program.parse(process.argv);
+buildProgram().parse(process.argv);

package/package.json

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