@myapihq/cli 1.2.1 → 1.2.2

package/dist/commands/domain.js

@@ -38,6 +38,14 @@ export const SCHEMA = {
     'registrant-postal-code': 'string',
     'registrant-country': 'string',
     'registrant-organization': 'string',
+    // DNS records sub-surface
+    type: 'string',
+    name: 'string',
+    content: 'string',
+    ttl: 'number',
+    priority: 'number',
+    proxied: 'boolean',
+    yes: 'boolean',
 };
 export async function check(domainArg, flags) {
     const config = requireConfig();
@@ -235,6 +243,157 @@ export async function updateSettings(domainArg, flags) {
     const res = await sdkDomain.updateDomainSettings(config.api_key, orgId, domain, payload);
     success(`Updated settings for ${domain}!\n${JSON.stringify(res, null, 2)}`);
 }
+// ── DNS records sub-surface (`myapi domain records ...`) ────────────────────
+const ALLOWED_RECORD_TYPES = new Set(['A', 'AAAA', 'CNAME', 'MX', 'TXT']);
+function parseRecordType(raw, where) {
+    if (typeof raw !== 'string' || !ALLOWED_RECORD_TYPES.has(raw.toUpperCase())) {
+        error(`${where}: --type must be one of A, AAAA, CNAME, MX, TXT (got: ${raw ?? '(missing)'}).`);
+    }
+    return raw.toUpperCase();
+}
+function recordRow(r) {
+    return {
+        id: r.id,
+        type: r.type,
+        name: r.name,
+        content: r.content,
+        ttl: r.ttl === 1 ? 'auto' : String(r.ttl),
+        priority: r.priority ?? '—',
+        proxied: r.proxied === null ? '—' : (r.proxied ? 'yes' : 'no'),
+    };
+}
+async function recordsList(domainArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi domain records list <domain> [--type <T>] [--org <id>]');
+    const domain = requireDomain(domainArg, flags, config, 'myapi domain records list <domain> [--type <T>] [--org <id>]');
+    const type = flags.type ? parseRecordType(flags.type, 'records list') : undefined;
+    const records = await sdkDomain.listDnsRecords(config.api_key, orgId, domain, type);
+    if (flags.json) {
+        printJson(records);
+        return;
+    }
+    printTable(records.map(recordRow), { flags, empty: 'No records in this zone.' });
+}
+async function recordsGet(domainArg, recordId, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi domain records get <domain> <record-id> [--org <id>]');
+    const domain = requireDomain(domainArg, flags, config, 'myapi domain records get <domain> <record-id> [--org <id>]');
+    if (!recordId)
+        error('Missing record id.\nUsage: myapi domain records get <domain> <record-id>');
+    const r = await sdkDomain.getDnsRecord(config.api_key, orgId, domain, recordId);
+    if (flags.json) {
+        printJson(r);
+        return;
+    }
+    printJson(r);
+}
+async function recordsCreate(domainArg, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi domain records create <domain> --type <T> --name <n> --content <c> [...]');
+    const domain = requireDomain(domainArg, flags, config, 'myapi domain records create <domain> --type <T> --name <n> --content <c> [...]');
+    const type = parseRecordType(flags.type, 'records create');
+    const name = typeof flags.name === 'string' ? flags.name : '';
+    const content = typeof flags.content === 'string' ? flags.content : '';
+    if (!name)
+        error('Missing --name. For apex, pass --name=@ or --name=<domain>.');
+    if (!content)
+        error('Missing --content.');
+    const input = { type, name, content };
+    if (typeof flags.ttl === 'number')
+        input.ttl = flags.ttl;
+    if (typeof flags.priority === 'number')
+        input.priority = flags.priority;
+    if (typeof flags.proxied === 'boolean')
+        input.proxied = flags.proxied;
+    if (type === 'MX' && input.priority === undefined)
+        error('Missing --priority. Required for MX records (typical value: 10).');
+    const r = await sdkDomain.createDnsRecord(config.api_key, orgId, domain, input);
+    success(`Created ${r.type} record ${r.id}`);
+    printJson(r);
+}
+async function recordsUpdate(domainArg, recordId, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi domain records update <domain> <record-id> [--content ...] [...]');
+    const domain = requireDomain(domainArg, flags, config, 'myapi domain records update <domain> <record-id> [--content ...] [...]');
+    if (!recordId)
+        error('Missing record id.\nUsage: myapi domain records update <domain> <record-id> [flags]');
+    const patch = {};
+    if (typeof flags.name === 'string')
+        patch.name = flags.name;
+    if (typeof flags.content === 'string')
+        patch.content = flags.content;
+    if (typeof flags.ttl === 'number')
+        patch.ttl = flags.ttl;
+    if (typeof flags.priority === 'number')
+        patch.priority = flags.priority;
+    if (typeof flags.proxied === 'boolean')
+        patch.proxied = flags.proxied;
+    if (Object.keys(patch).length === 0)
+        error('Nothing to update. Pass at least one of --name, --content, --ttl, --priority, --proxied.');
+    const r = await sdkDomain.updateDnsRecord(config.api_key, orgId, domain, recordId, patch);
+    success(`Updated record ${r.id}`);
+    printJson(r);
+}
+async function recordsDelete(domainArg, recordId, flags) {
+    const config = requireConfig();
+    const orgId = requireOrg(flags, config, 'myapi domain records delete <domain> <record-id> [--yes] [--org <id>]');
+    const domain = requireDomain(domainArg, flags, config, 'myapi domain records delete <domain> <record-id> [--yes] [--org <id>]');
+    if (!recordId)
+        error('Missing record id.\nUsage: myapi domain records delete <domain> <record-id> [--yes]');
+    if (!flags.yes) {
+        info(`About to delete record ${recordId} from ${domain}. Re-run with --yes to confirm.`);
+        return;
+    }
+    await sdkDomain.deleteDnsRecord(config.api_key, orgId, domain, recordId);
+    success(`Deleted record ${recordId}`);
+}
+const RECORDS_HELP = `Usage: myapi domain records <subcommand> <domain> [...]
+
+Subcommands:
+  list <domain> [--type A|AAAA|CNAME|MX|TXT]
+  get <domain> <record-id>
+  create <domain> --type <T> --name <n> --content <c> [--ttl <n>]
+                                                       [--priority <n>] [--proxied]
+  update <domain> <record-id> [--content ...] [--ttl ...] [--priority ...] [--proxied]
+  delete <domain> <record-id> [--yes]
+
+Name normalization:
+  --name=@                       Apex (e.g. example.com)
+  --name=mail                    Host-only — backend appends the zone
+  --name=mail.example.com        FQDN
+  --name=""                      Apex (empty == @)
+
+Notes:
+  --ttl defaults to 1 (Cloudflare "automatic"). Explicit range: [60, 86400].
+  --priority is required for MX (typical: 10).
+  --proxied (CF "orange-cloud") applies to A/AAAA/CNAME only.
+
+Examples:
+  Fix the broken SPF on x80security.com:
+    myapi domain records list x80security.com --type TXT
+    myapi domain records delete x80security.com <bad-record-id> --yes
+    myapi domain records create x80security.com --type TXT --name @ \\
+      --content 'v=spf1 include:_spf.mailersend.net include:_spf.google.com ~all'
+    myapi domain records create x80security.com --type TXT --name @ \\
+      --content 'google-site-verification=...'`;
+async function recordsRun(sub, args, flags) {
+    if (!sub || (flags.help && !sub)) {
+        info(RECORDS_HELP);
+        return;
+    }
+    if (flags.help) {
+        info(RECORDS_HELP);
+        return;
+    }
+    switch (sub) {
+        case 'list': return recordsList(args[0], flags);
+        case 'get': return recordsGet(args[0], args[1], flags);
+        case 'create': return recordsCreate(args[0], flags);
+        case 'update': return recordsUpdate(args[0], args[1], flags);
+        case 'delete': return recordsDelete(args[0], args[1], flags);
+        default: error(`Unknown records subcommand: ${sub}. Run "myapi domain records --help".`);
+    }
+}
 // ── Dispatcher ───────────────────────────────────────────────────────────────
 const SUBCOMMAND_USAGE = {
     'list': `myapi domain list [--filter=all|unassigned|org] [--org <id>] [--json]
@@ -312,6 +471,7 @@ To transfer to a different org: unassign first, then assign to the new org.`,
 
 Gets current edge/CDN settings (security level, browser check, cache).
 Use "myapi domain update-settings" to change them.`,
+    'records': RECORDS_HELP,
     'update-settings': `myapi domain update-settings <domain> [--security=<level>] [--browser-check=on|off] [--purge-cache] [--org <id>]
 
   --security=<level>       essentially_off | low | medium | high | under_attack  (default: medium)
@@ -336,6 +496,7 @@ Subcommands:
   status           Get domain status
   settings         Get edge/CDN settings
   update-settings  Update edge/CDN settings
+  records          Manage DNS records in the zone (list / get / create / update / delete)
 
 Tip: Set defaults with "myapi config set-org <id>" / "set-domain <domain>" to skip flags on every command.`);
         return;
@@ -359,6 +520,7 @@ Tip: Set defaults with "myapi config set-org <id>" / "set-domain <domain>" to sk
         case 'status': return status(args[0], flags);
         case 'settings': return settings(args[0], flags);
         case 'update-settings': return updateSettings(args[0], flags);
+        case 'records': return recordsRun(args[0], args.slice(1), flags);
         default: error(`Unknown subcommand: ${subcommand}. Run "myapi domain --help" for a list of valid subcommands.`);
     }
 }

package/dist/index.js

@@ -82,6 +82,13 @@ const ERROR_MESSAGES = {
     INSUFFICIENT_BALANCE: 'Insufficient balance. Run: myapi billing topup <amount>',
     INVALID_AMOUNT: 'Amount out of range. Maximum single top-up is $100. Run: myapi billing topup <amount>',
     SERVICE_NOT_LAUNCHED: 'This service is disabled pre-launch. Track availability via: myapi status',
+    RECORD_NOT_FOUND: 'DNS record not found in this zone.',
+    INVALID_RECORD_TYPE: 'Unsupported record type. Allowed: A, AAAA, CNAME, MX, TXT.',
+    MX_PRIORITY_REQUIRED: 'MX records require --priority (typical value: 10).',
+    INVALID_TTL: 'Invalid TTL. Use the auto sentinel (1) or a value between 60 and 86400 seconds.',
+    INVALID_RECORD_CONTENT: 'Invalid record content for this type.',
+    RECORD_LIMIT_EXCEEDED: 'Cloudflare per-zone record limit reached.',
+    CF_API_ERROR: 'Cloudflare API error. The backend will surface a `cf_message` field with the underlying detail.',
     // invalid_json_response intentionally absent — the SDK's MyApiError now
     // builds a useful detailed message for that case (status + URL + body
     // snippet), and friendlyError(err.code) would override it.

package/dist/skills/my-domain-api/SKILL.md

@@ -50,9 +50,15 @@ Resolution at register time (highest wins): `--registrant-json` → per-field fl
 | `myapi domain list [--filter all\|unassigned\|org]` | List domains in your account |
 | `myapi domain assign <domain>` | Assign domain to your default (or `--org`) org |
 | `myapi domain unassign <domain>` | Remove domain from its org |
-| `myapi domain status <domain>` | Registration + DNS propagation status |
+| `myapi domain import <domain>` | Bring-your-own-domain. Snapshots current DNS, returns nameservers to set at your existing registrar — no registrar credentials needed |
+| `myapi domain status <domain> [--watch]` | Registration + DNS propagation status. `--watch` polls until terminal (10s × 30 → 30s × 60) |
 | `myapi domain settings <domain>` | View edge/CDN settings |
 | `myapi domain update-settings <domain>` | Change security level, browser check, purge cache |
+| `myapi domain records list <domain> [--type T]` | List DNS records in the zone |
+| `myapi domain records get <domain> <id>` | Fetch one record |
+| `myapi domain records create <domain> --type T --name n --content c` | Create a record (priority required for MX) |
+| `myapi domain records update <domain> <id> [--content c] [...]` | Update a record (type cannot change) |
+| `myapi domain records delete <domain> <id> --yes` | Delete a record |
 <!-- generated:end -->
 
 ## Examples
@@ -73,6 +79,18 @@ myapi domain renew example.com
 # Tune the edge for AI bot traffic
 myapi domain update-settings example.com \
   --security=essentially_off --browser-check=off --purge-cache
+
+# Bring an existing domain — works with any registrar (Namecheap, GoDaddy, CF Registrar, etc.)
+myapi domain import example.com
+# → Returns nameservers; set them at your current registrar.
+myapi domain status example.com --watch
+# → Polls until active. Backend live-checks Cloudflare each poll.
+
+# Fix a record after import (e.g. clean up SPF)
+myapi domain records list example.com --type TXT
+myapi domain records delete example.com <bad-id> --yes
+myapi domain records create example.com --type TXT --name @ \
+  --content 'v=spf1 include:_spf.google.com ~all'
 ```
 
 Security levels: `essentially_off` · `low` · `medium` · `high` · `under_attack`.

package/package.json

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