@mailkite/cli 0.1.0 → 0.3.0

package/README.md

@@ -18,11 +18,13 @@ npm i -g @mailkite/cli          # or install the `mailkite` binary globally
 
 ```bash
 mailkite signup --email you@example.com --password ••••••   # or: login
-mailkite domains add mail.yourapp.com                       # prints the DNS records
+mailkite domains check myapp.ai                          # available? + price
+mailkite domains register myapp.ai --first-name … --email … --country US  # buy + auto-DNS
+mailkite domains add mail.myapp.ai                       # or add a domain you already own
 # …add those records at your DNS provider…
 mailkite domains verify <domainId>                          # MX/SPF/DKIM/DMARC
-mailkite webhook set <domainId> https://yourapp.com/hooks/mailkite
-mailkite send --from hello@mail.yourapp.com --to you@example.com \
+mailkite webhook set <domainId> https://myapp.ai/hooks/mailkite
+mailkite send --from hello@mail.myapp.ai --to you@example.com \
   --subject "It works" --html "<p>Hi from MailKite</p>"
 mailkite messages tail                                       # watch inbound arrive
 ```
@@ -31,8 +33,8 @@ Or do the whole flow in one command:
 
 ```bash
 mailkite init --email you@example.com --password •••• \
-  --domain mail.yourapp.com --provider cloudflare \
-  --webhook https://yourapp.com/hooks/mailkite --to you@example.com --verify
+  --domain mail.myapp.ai --provider cloudflare \
+  --webhook https://myapp.ai/hooks/mailkite --to you@example.com --verify
 ```
 
 ## Built for scripts and agents
@@ -53,7 +55,7 @@ mailkite domains verify "$ID" --json | jq -e '.status=="verified"'
 | Group | Commands |
 | --- | --- |
 | Auth | `login`, `signup`, `logout`, `whoami` |
-| Send | `send` |
+| Send | `send`, `agent`, `route` |
 | Domains | `domains list\|add\|get\|verify\|rm`, `dns <id> [--provider]` |
 | Webhooks | `webhook set\|rm\|test\|show`, `secret get\|rotate`, `verify-webhook` |
 | Receiving | `messages list\|get\|tail`, `routes list\|create`, `deliveries retry` |

package/cli.mjs

@@ -217,6 +217,45 @@ commands.send = async ({ flags }) => {
   out(res, flags, (r) => console.log(green("✓ ") + `Sent — id ${bold(r.id)}, status ${r.status}`));
 };
 
+// Send a message straight to an inbox agent and print its reply. Defaults to the account's
+// default agent; --route-id / --address pick a specific one, --model overrides the model.
+commands.agent = async ({ _, flags }) => {
+  const mk = client(flags);
+  const text = await need(_[0] || flags.text, "text", "Message to the agent: ");
+  const message = { text };
+  if (flags.subject) message.subject = flags.subject;
+  if (flags.from) message.from = flags.from;
+  if (flags["route-id"]) message.routeId = flags["route-id"];
+  if (flags.address) message.address = flags.address;
+  if (flags.model) message.model = flags.model;
+  let res;
+  try { res = await mk.agent(message); }
+  catch (e) { return die(e instanceof MailKiteError ? `Agent failed (${e.status}): ${e.message}` : e.message); }
+  out(res, flags, (r) => { if (r.ok) console.log(r.text || dim("(no reply)")); else die(r.error || "agent run failed"); });
+};
+
+// Route a message to one of your registered routes (by id or address), running its action.
+commands.route = async ({ _, flags }) => {
+  const mk = client(flags);
+  const from = await need(flags.from, "from", "From: ");
+  const message = { from };
+  if (flags["route-id"]) message.routeId = flags["route-id"];
+  if (flags.address) message.address = flags.address;
+  if (!message.routeId && !message.address) {
+    const target = await need(_[0] || "", "route", "Route id (rte_…) or address it matches: ");
+    if (target.startsWith("rte_")) message.routeId = target; else message.address = target;
+  }
+  if (flags.subject) message.subject = flags.subject;
+  let text = flags.text;
+  if (flags.file) text = readFileSync(flags.file, "utf8");
+  if (text) message.text = text;
+  if (flags.html) message.html = flags.html;
+  let res;
+  try { res = await mk.route(message); }
+  catch (e) { return die(e instanceof MailKiteError ? `Route failed (${e.status}): ${e.message}` : e.message); }
+  out(res, flags, (r) => console.log(green("✓ ") + `Routed — id ${bold(r.id)}, action ${r.action}`));
+};
+
 commands.domains = async ({ _, flags }) => {
   const sub = _[0] || "list";
   const mk = client(flags);
@@ -249,6 +288,51 @@ commands.domains = async ({ _, flags }) => {
     const id = await need(_[1] || flags.id, "id", "Domain id: ");
     return out(await mk.deleteDomain(id), flags, () => console.log(green("✓ ") + "Domain removed."));
   }
+  if (sub === "check") {
+    const domain = await need(_[1] || flags.domain, "domain", "Domain to check: ");
+    const res = await mk.checkDomainAvailability(domain);
+    return out(res, flags, (r) => {
+      if (r.configured === false) return console.log(dim("Domain registration isn't enabled for this account."));
+      if (r.available) {
+        const p = r.price ? "  " + dim(`${r.price.amount} ${r.price.currency} / ${r.price.period}${r.price.periodUnit}`) : "";
+        console.log(green("✓ ") + `${bold(r.domain)} is available${p}${r.premium ? red("  (premium)") : ""}`);
+        console.log(dim(`Register it: mailkite domains register ${r.domain}`));
+      } else {
+        console.log(red("✗ ") + `${bold(r.domain)} is not available${r.reason ? dim(` (${r.reason})`) : ""}`);
+      }
+    });
+  }
+  if (sub === "register" || sub === "buy") {
+    const domain = await need(_[1] || flags.domain, "domain", "Domain to register: ");
+    // Show the price first (no charge) so the user confirms with eyes open.
+    const avail = await mk.checkDomainAvailability(domain).catch(() => null);
+    if (avail?.configured === false) die("Domain registration isn't enabled for this account.");
+    if (avail && !avail.available) die(`${domain} is not available${avail.reason ? ` (${avail.reason})` : ""}.`);
+    if (avail?.price) console.error(`Price: ${bold(`${avail.price.amount} ${avail.price.currency}`)} / ${avail.price.period}${avail.price.periodUnit}${avail.premium ? red("  (premium)") : ""}`);
+    const contact = {
+      firstName: await need(flags["first-name"], "first name", "First name: "),
+      lastName: await need(flags["last-name"], "last name", "Last name: "),
+      email: await need(flags.email, "email", "Email: "),
+      phone: await need(flags.phone, "phone", "Phone (+countrycode.number, e.g. +1.4155551234): "),
+      address: await need(flags.address, "address", "Address: "),
+      city: await need(flags.city, "city", "City: "),
+      zip: await need(flags.zip, "postal code", "Postal code: "),
+      country: await need(flags.country, "country", "Country (2-letter, e.g. US): "),
+    };
+    if (flags.state) contact.state = flags.state;
+    const org = flags.organization || flags.org;
+    if (org) { contact.organization = org; contact.type = flags.type || "company"; }
+    const years = flags.years ? Number(flags.years) : undefined;
+    // Final confirmation — this charges the registrar.
+    const ans = flags.yes || flags.force ? "y" : (await prompt(`Register ${bold(domain)} now? This charges your registrar. [y/N] `)).toLowerCase();
+    if (ans !== "y" && ans !== "yes") return console.error(dim("Cancelled."));
+    const res = await mk.registerDomain({ domain, contact, years });
+    return out(res, flags, (r) => {
+      console.log(green("✓ ") + `Registered ${bold(r.domain?.domain || domain)}${r.registration?.status ? dim(` (${r.registration.status})`) : ""}`);
+      if (r.dnsProvisioned) console.log(green("✓ ") + "Mail DNS provisioned automatically.");
+      else printDns(r.dns);
+    });
+  }
   die(`Unknown subcommand: domains ${sub}`);
 };
 
@@ -467,9 +551,16 @@ ${bold("AUTH")}
 ${bold("SEND")}
   send             Send a message  (--from --to --subject [--html|--text|--file] [--cc --bcc --reply-to --in-reply-to])
 
+${bold("AGENTS")}
+  agent <text>     Message an inbox agent and print its reply  ([--route-id|--address] [--model --subject --from])
+  route            Route a message to a registered route  (--route-id <id>|--address <addr> --from [--subject --text|--file --html])
+
 ${bold("DOMAINS & DNS")}
   domains list                 List your domains
-  domains add <domain>         Add a domain; prints the DNS records to set
+  domains add <domain>         Add a domain you own; prints the DNS records to set
+  domains check <domain>       Check if a domain is available to register (+ price)
+  domains register <domain>    Buy a domain; provisions DNS + adds it (--first-name --last-name
+                               --email --phone --address --city --zip --country [--state --org --years --yes])
   domains get <id>             Show a domain (with DNS + webhook)
   domains verify <id>          Re-check DNS (MX/SPF/DKIM/DMARC)
   domains rm <id>              Remove a domain

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailkite/cli",
-  "version": "0.1.0",
+  "version": "0.3.0",
   "description": "MailKite command-line client — sign in, add domains, set DNS + webhooks, send mail, and tail inbound messages from your terminal. Built on the MailKite Node SDK.",
   "type": "module",
   "bin": {
@@ -30,11 +30,11 @@
   "homepage": "https://mailkite.dev/docs/cli",
   "repository": {
     "type": "git",
-    "url": "https://github.com/fijiwebdesign/mailkite.git",
+    "url": "git+https://github.com/mailkite/mailkite.git",
     "directory": "sdks/cli"
   },
   "license": "MIT",
   "dependencies": {
-    "mailkite": "^0.1.0"
+    "mailkite": "^0.3.0"
   }
 }