@myapihq/cli 1.2.0 → 1.2.1

package/dist/commands/domain.d.ts

@@ -5,6 +5,7 @@ export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
 export declare function check(domainArg: string, flags: Flags): Promise<void>;
 export declare function register(domainArg: string, flags: Flags): Promise<void>;
+export declare function importCmd(domainArg: string, flags: Flags): Promise<void>;
 export declare function renew(domainArg: string, flags: Flags): Promise<void>;
 export declare function list(flags: Flags): Promise<void>;
 export declare function assign(domainArg: string, flags: Flags): Promise<void>;

package/dist/commands/domain.js

@@ -23,6 +23,8 @@ export const SCHEMA = {
     security: 'string',
     'browser-check': 'string',
     'purge-cache': 'boolean',
+    // Poll `status` until the domain reaches a terminal state.
+    'watch': 'boolean',
     // WHOIS registrant — required by ICANN at register time. Resolution
     // order is JSON > per-field flags > stored config > TTY prompt > error.
     // See packages/cli/src/registrant.ts for the full flow.
@@ -78,6 +80,41 @@ export async function register(domainArg, flags) {
 }
 // Renew a registered domain for one more registration period (typically 1 year).
 // Charged against the org's billing balance — surface a confirmation unless --yes.
+// BYOD: snapshot existing DNS records, create a CF zone, hand back the NS
+// values the customer needs to set at their current registrar. No registrar
+// credentials needed — backend is registrar-agnostic now.
+export async function importCmd(domainArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi domain import <domain> [--org <id>]');
+    if (!domainArg)
+        error('Missing required arguments.\nUsage: myapi domain import <domain> [--org <id>]');
+    const res = await sdkDomain.importDomain(config.api_key, orgId, domainArg);
+    if (flags.json) {
+        printJson(res);
+        return;
+    }
+    success(`Imported ${res.domain} (status: ${res.status})`);
+    info('');
+    info(`Nameservers (set these at your current registrar):`);
+    for (const ns of res.nameservers)
+        info(`  ${ns}`);
+    info('');
+    if (res.preserved_records.length > 0) {
+        info(`Preserved DNS records (${res.preserved_count} found — verify before the NS change):`);
+        printTable(res.preserved_records.map(r => ({ type: r.type, name: r.name, content: r.content, ttl: r.ttl })), { flags });
+        info('');
+    }
+    else {
+        info(`No DNS records detected via public probe — verify directly with your registrar before the NS change.`);
+        info('');
+    }
+    info(res.probe_warning);
+    info('');
+    info(res.next_step);
+    info('');
+    info(`After changing nameservers, watch activation with:`);
+    info(`  myapi domain status ${res.domain} --watch`);
+}
 export async function renew(domainArg, flags) {
     const config = requireConfig();
     const orgId = requireOrg(flags, config, 'myapi domain renew <domain> [--yes] [--org <id>]');
@@ -124,21 +161,55 @@ export async function unassign(domainArg, flags) {
     await sdkDomain.unassignDomain(config.api_key, orgId, domainArg);
     success(`Unassigned ${domainArg} from org ${orgId}`);
 }
+// Terminal states — stop polling under --watch.
+const TERMINAL_STATUSES = new Set(['active', 'failed', 'error', 'expired']);
 export async function status(domainArg, flags) {
     const config = requireConfig();
-    const orgId = requireOrg(flags, config, 'myapi domain status <domain> [--org <id>]');
-    const domain = requireDomain(domainArg, flags, config, 'myapi domain status <domain> [--org <id>]');
-    const res = await sdkDomain.getDomainStatus(config.api_key, orgId, domain);
-    if (flags.json) {
-        printJson(res);
+    const orgId = requireOrg(flags, config, 'myapi domain status <domain> [--org <id>] [--watch]');
+    const domain = requireDomain(domainArg, flags, config, 'myapi domain status <domain> [--org <id>] [--watch]');
+    if (!flags.watch) {
+        const res = await sdkDomain.getDomainStatus(config.api_key, orgId, domain);
+        if (flags.json) {
+            printJson(res);
+            return;
+        }
+        renderStatus(res);
         return;
     }
+    // Watch mode: 10s × 30 (5 min), then 30s × 60 (30 min). Total ~35 min budget.
+    // Backend live-checks CF on each poll for `pending_ns_change` rows, so polling
+    // both reports state AND triggers the flip to `provisioning`.
+    let lastStatus = '';
+    const schedule = [
+        { count: 30, intervalMs: 10_000 },
+        { count: 60, intervalMs: 30_000 },
+    ];
+    info(`Watching ${domain} — press Ctrl-C to stop.`);
+    for (const phase of schedule) {
+        for (let i = 0; i < phase.count; i++) {
+            const res = await sdkDomain.getDomainStatus(config.api_key, orgId, domain);
+            if (res.status !== lastStatus) {
+                renderStatus(res);
+                lastStatus = res.status;
+            }
+            if (TERMINAL_STATUSES.has(res.status))
+                return;
+            await new Promise(r => setTimeout(r, phase.intervalMs));
+        }
+    }
+    info(`Watch budget exhausted (~35 min). Rerun "myapi domain status ${domain} --watch" to keep waiting.`);
+}
+function renderStatus(res) {
     info(`Domain:  ${res.domain}`);
     info(`Status:  ${res.status}`);
     if (res.expires_at)
         info(`Expires: ${formatDate(res.expires_at)}`);
-    if (res.status === 'active')
+    if (res.status === 'pending_ns_change') {
+        info('Waiting for you to change nameservers at your current registrar. Each poll re-checks Cloudflare.');
+    }
+    if (res.status === 'active') {
         info('Note: if recently activated, the SSL certificate may still be provisioning — allow a few minutes before the site is reachable over HTTPS.');
+    }
 }
 export async function settings(domainArg, flags) {
     const config = requireConfig();
@@ -203,6 +274,20 @@ Registrant (required at every register call):
 
 After registering: myapi domain assign <domain>
 DNS propagation takes a few minutes — track it with: myapi domain status <domain>`,
+    'import': `myapi domain import <domain> [--org <id>] [--json]
+
+Bring your own domain (BYOD). Snapshots existing DNS records via a best-effort
+public probe and creates a Cloudflare zone for the domain. Returns the
+nameservers you need to set at your current registrar.
+
+No registrar credentials needed — works with any registrar (Namecheap, GoDaddy,
+Cloudflare Registrar, etc.).
+
+After running:
+  1. Verify the preserved-records table covers your MX/SPF/DKIM/DMARC etc.
+  2. At your current registrar, change the nameservers to the values returned.
+  3. Wait for propagation. Use "myapi domain status <domain> --watch" to track
+     activation — the backend live-checks Cloudflare each time you poll.`,
     'renew': `myapi domain renew <domain> [--org <id>]
 
 Renews a registered domain for one more registration period (typically 1 year).
@@ -217,7 +302,12 @@ https://<domain> after DNS propagation completes.
 
 To transfer to a different org: unassign first, then assign to the new org.`,
     'unassign': 'myapi domain unassign <domain> [--org <id>]',
-    'status': 'myapi domain status <domain> [--org <id>] [--json]',
+    'status': `myapi domain status <domain> [--org <id>] [--watch] [--json]
+
+  --watch   Poll until the domain reaches a terminal state (active / failed /
+            expired). Backoff: 10s × 30 then 30s × 60 (~35 min budget). Useful
+            after "myapi domain import" — each poll also live-checks Cloudflare,
+            so polling drives the flip from pending_ns_change → provisioning.`,
     'settings': `myapi domain settings <domain> [--org <id>]
 
 Gets current edge/CDN settings (security level, browser check, cache).
@@ -239,6 +329,7 @@ Subcommands:
   list             List domains
   check            Check domain availability
   register         Register a domain
+  import           Bring your own domain (BYOD) — registrar-agnostic
   renew            Renew a registered domain for another period
   assign           Assign domain to an org
   unassign         Unassign domain from its current org
@@ -261,6 +352,7 @@ Tip: Set defaults with "myapi config set-org <id>" / "set-domain <domain>" to sk
         case 'list': return list(flags);
         case 'check': return check(args[0], flags);
         case 'register': return register(args[0], flags);
+        case 'import': return importCmd(args[0], flags);
         case 'renew': return renew(args[0], flags);
         case 'assign': return assign(args[0], flags);
         case 'unassign': return unassign(args[0], flags);

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/cli",
   "license": "Apache-2.0",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "description": "MyAPI command-line interface",
   "type": "module",
   "files": [
@@ -27,7 +27,7 @@
     "lint:changelog": "node ../../scripts/lint-changelog.js"
   },
   "dependencies": {
-    "@myapihq/sdk": "^1.2.0",
+    "@myapihq/sdk": "^1.2.1",
     "omelette": "^0.4.17"
   },
   "devDependencies": {

package/dist/commands/verify.d.ts

@@ -1,7 +0,0 @@
-import type { FlagSchema } from '../flags.js';
-import { type Flags } from '../helpers.js';
-import type { Exposes } from '../exposes.js';
-export declare const EXPOSES: Exposes;
-export declare const SCHEMA: FlagSchema;
-export declare const VERIFY_HELP = "Usage: myapi verify <email> [--org <id>] [--json]\n\nSync single-address email verification. Cheap layer only: syntax + DNS +\nMicrosoft GetCredentialType. Returns a verdict in <1s for ~50% of inputs;\nthe rest get verdict='unknown' with smtp_recommended=true.\n\nVerdicts:\n  deliverable    high-confidence \u2014 the address accepts mail\n  undeliverable  high-confidence \u2014 syntax bad, DNS missing, or Microsoft rejects\n  unknown        not enough signal; consider an SMTP probe (not in this API)\n\nUse --json for the full check breakdown (syntax / DNS / Microsoft probes).\n";
-export declare function run(arg: string | undefined, _rest: string[], flags?: Flags): Promise<void>;

package/dist/commands/verify.js

@@ -1,56 +0,0 @@
-import { email as sdkEmail } from '@myapihq/sdk';
-import { requireConfig } from '../config.js';
-import { error, info, printJson } from '../output.js';
-import { requireOrg } from '../helpers.js';
-export const EXPOSES = [
-    'POST /email/orgs/{org_id}/verify',
-];
-export const SCHEMA = {
-    org: 'string',
-};
-export const VERIFY_HELP = `Usage: myapi verify <email> [--org <id>] [--json]
-
-Sync single-address email verification. Cheap layer only: syntax + DNS +
-Microsoft GetCredentialType. Returns a verdict in <1s for ~50% of inputs;
-the rest get verdict='unknown' with smtp_recommended=true.
-
-Verdicts:
-  deliverable    high-confidence — the address accepts mail
-  undeliverable  high-confidence — syntax bad, DNS missing, or Microsoft rejects
-  unknown        not enough signal; consider an SMTP probe (not in this API)
-
-Use --json for the full check breakdown (syntax / DNS / Microsoft probes).
-`;
-export async function run(arg, _rest, flags = {}) {
-    if (flags.help) {
-        info(VERIFY_HELP);
-        return;
-    }
-    if (!arg)
-        error('Missing required argument <email>.\nUsage: myapi verify <email> [--org <id>] [--json]');
-    const config = requireConfig();
-    const orgId = requireOrg(flags, config, 'myapi verify <email> [--org <id>]');
-    const res = await sdkEmail.verifyEmail(config.api_key, orgId, arg);
-    if (flags.json) {
-        printJson(res);
-        return;
-    }
-    // Compact human render. The verdict + confidence is the headline; the
-    // checks block is verbose enough that we hide it behind --json.
-    const verdictLabel = res.verdict === 'deliverable' ? '✓ deliverable'
-        : res.verdict === 'undeliverable' ? '✗ undeliverable'
-            : '? unknown';
-    info(`Email:      ${res.email}`);
-    info(`Verdict:    ${verdictLabel}  (confidence ${res.confidence.toFixed(2)})`);
-    info(`SMTP next:  ${res.smtp_recommended ? 'yes — consider an SMTP probe' : 'no — verdict is definitive'}`);
-    info(`Took:       ${res.elapsed_ms}ms`);
-    if (res.checks.syntax.detail)
-        info(`Syntax:     ${res.checks.syntax.detail}`);
-    if (res.checks.dns && res.checks.dns.mx_records && res.checks.dns.mx_records.length > 0) {
-        const mx = res.checks.dns.mx_records.filter(Boolean);
-        if (mx.length > 0)
-            info(`MX:         ${mx.slice(0, 3).join(', ')}${mx.length > 3 ? ` (+${mx.length - 3} more)` : ''}`);
-    }
-    if (res.checks.microsoft)
-        info(`Microsoft:  ${res.checks.microsoft.verdict}`);
-}