@mailkite/cli 0.1.0 → 0.2.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

package/cli.mjs

@@ -249,6 +249,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}`);
 };
 
@@ -469,7 +514,10 @@ ${bold("SEND")}
 
 ${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.2.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/fijiwebdesign/mailkite.git",
     "directory": "sdks/cli"
   },
   "license": "MIT",
   "dependencies": {
-    "mailkite": "^0.1.0"
+    "mailkite": "^0.2.0"
   }
 }