@myapihq/cli 2.16.2 → 2.16.3

package/dist/commands/domain.d.ts

@@ -30,5 +30,6 @@ export declare function retryProvisioning(domainArg: string, flags: Flags): Prom
 export declare function mailServerResync(domainArg: string, flags: Flags): Promise<void>;
 export declare function settings(domainArg: string, flags: Flags): Promise<void>;
 export declare function updateSettings(domainArg: string, flags: Flags): Promise<void>;
+export declare const NESTED_SUBCOMMAND_USAGE: Record<string, Record<string, string>>;
 export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/domain.js

@@ -549,6 +549,19 @@ Examples:
       --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=...'`;
+// `domain records` is a second level inside a flat command module, so its
+// verbs are invisible to anything reading SUBCOMMAND_USAGE alone — the command
+// manifest could confirm `domain records` and nothing under it. Declared here
+// so `domain records list` can be told apart from `domain records lst`.
+export const NESTED_SUBCOMMAND_USAGE = {
+    records: {
+        'create': 'myapi domain records create <domain> --type <T> --name <n> --content <c> [--ttl <n>] [--priority <n>] [--proxied]',
+        'delete': 'myapi domain records delete <domain> <record-id> [--yes]',
+        'get': 'myapi domain records get <domain> <record-id>',
+        'list': 'myapi domain records list <domain> [--type A|AAAA|CNAME|MX|TXT]',
+        'update': 'myapi domain records update <domain> <record-id> [--content ...] [--ttl ...] [--priority ...] [--proxied]',
+    },
+};
 async function recordsRun(sub, args, flags) {
     if (!sub || (flags.help && !sub)) {
         info(RECORDS_HELP);

package/dist/commands/email/mailbox.d.ts

@@ -1,4 +1,5 @@
 import type { Flags } from '../../helpers.js';
 import type { Exposes } from '../../exposes.js';
 export declare const EXPOSES: Exposes;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(sub: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/email/mailbox.js

@@ -93,7 +93,7 @@ async function del(address, _flags) {
     await sdkEmail.deleteMailbox(config.api_key, address);
     success(`Mailbox deleted: ${address}`);
 }
-const USAGE = {
+export const SUBCOMMAND_USAGE = {
     'create': `myapi email mailbox create <user@domain> [--display-name <name>]
        myapi email mailbox create --username <u> --domain <d> [--display-name <name>]
 
@@ -131,7 +131,7 @@ Subcommands:
         return;
     }
     if (flags.help) {
-        const usage = USAGE[sub];
+        const usage = SUBCOMMAND_USAGE[sub];
         if (usage)
             info(`Usage: ${usage}`);
         else

package/dist/commands/email/message.d.ts

@@ -1,4 +1,5 @@
 import type { Flags } from '../../helpers.js';
 import type { Exposes } from '../../exposes.js';
 export declare const EXPOSES: Exposes;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(sub: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/email/message.js

@@ -108,7 +108,7 @@ async function get(messageId, flags) {
     const res = await sdkEmail.getMessage(config.api_key, messageId, flags.address);
     printJson(res);
 }
-const USAGE = {
+export const SUBCOMMAND_USAGE = {
     'send': 'myapi email message send --from <email> --to <email> --subject <str> [--body <str> | --html <str> | --template-id <id> [--template-vars <json>]]',
     'status': 'myapi email message status <message_id>',
     'sent': 'myapi email message sent [--limit <n>] [--offset <n>]',
@@ -130,7 +130,7 @@ Subcommands:
         return;
     }
     if (flags.help) {
-        const usage = USAGE[sub];
+        const usage = SUBCOMMAND_USAGE[sub];
         if (usage)
             info(`Usage: ${usage}`);
         else

package/dist/commands/email/template.d.ts

@@ -1,4 +1,5 @@
 import { type Flags } from '../../helpers.js';
 import type { Exposes } from '../../exposes.js';
 export declare const EXPOSES: Exposes;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(sub: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/email/template.js

@@ -118,7 +118,7 @@ async function del(id, flags) {
     await sdkEmail.deleteTemplate(config.api_key, orgId, id);
     success(`Deleted template ${id}`);
 }
-const USAGE = {
+export const SUBCOMMAND_USAGE = {
     'generate': `myapi email template generate <name> --prompt <str> [--org <id>]
        myapi email template generate --name <name> --prompt <str> [--org <id>]
 
@@ -147,7 +147,7 @@ All commands accept --org <id> (or set default: myapi config set-org <id>).`);
         return;
     }
     if (flags.help) {
-        const usage = USAGE[sub];
+        const usage = SUBCOMMAND_USAGE[sub];
         if (usage)
             info(`Usage: ${usage}`);
         else

package/dist/commands/email/verify.d.ts

@@ -4,4 +4,5 @@ import type { Exposes } from '../../exposes.js';
 export declare const EXPOSES: Exposes;
 export declare const SCHEMA: FlagSchema;
 export declare const VERIFY_HELP = "Usage: myapi email verify <email> [--org <id>] [--json]\n       myapi email verify bulk [--quick] [--org <id>] < emails.txt\n       myapi email verify job <job_id> [--org <id>] [--json]\n\nSingle-address verification (sync): syntax + DNS + Microsoft probe.\nReturns a verdict in <1s for ~50% of inputs; the rest get\nverdict='unknown' with smtp_recommended=true.\n\nBulk verification (async): reads up to 500 addresses from stdin (one per\nline), starts a job, and prints a job_id. It runs the cheap verdict on\nevery address then SMTP-probes the uncertain ones. --quick skips the\ncatch-all check (faster, but catch-all domains aren't flagged). Poll with\n\"myapi email verify job <job_id>\".\n";
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(arg: string | undefined, rest: string[], flags?: Flags): Promise<void>;

package/dist/commands/email/verify.js

@@ -22,6 +22,13 @@ every address then SMTP-probes the uncertain ones. --quick skips the
 catch-all check (faster, but catch-all domains aren't flagged). Poll with
 "myapi email verify job <job_id>".
 `;
+// `email verify` takes an address directly, so these are its only two real
+// subcommands. Listed so the command manifest — and the site-copy checker
+// that reads it — can tell `verify bulk` from a typo.
+export const SUBCOMMAND_USAGE = {
+    'bulk': 'myapi email verify bulk [--quick] [--org <id>] < emails.txt',
+    'job': 'myapi email verify job <job_id> [--org <id>] [--json]',
+};
 async function readStdinLines() {
     if (process.stdin.isTTY) {
         error('No input on stdin. Pipe a newline-separated list of addresses:\n  myapi email verify bulk < emails.txt');

package/dist/commands/email/warmup.d.ts

@@ -1,4 +1,5 @@
 import type { Flags } from '../../helpers.js';
 import type { Exposes } from '../../exposes.js';
 export declare const EXPOSES: Exposes;
+export declare const SUBCOMMAND_USAGE: Record<string, string>;
 export declare function run(sub: string | undefined, args: string[], flags: Flags): Promise<void>;

package/dist/commands/email/warmup.js

@@ -8,13 +8,21 @@ export const EXPOSES = [
     'POST /email/warmup/stop',
     'GET /email/warmup/stats/{address}',
 ];
+export const SUBCOMMAND_USAGE = {
+    'start': 'myapi email warmup start --address <email>',
+    'pause': 'myapi email warmup pause --address <email>',
+    'resume': 'myapi email warmup resume --address <email>',
+    'stop': 'myapi email warmup stop --address <email>',
+    'stats': 'myapi email warmup stats --address <email>',
+};
 export async function run(sub, args, flags) {
     if (!sub || (flags.help && !sub)) {
-        info('Usage: myapi email warmup <start|pause|resume|stop|stats> --address <email>');
+        info(`Usage: myapi email warmup <${Object.keys(SUBCOMMAND_USAGE).join('|')}> --address <email>`);
         return;
     }
     if (flags.help) {
-        info(`Usage: myapi email warmup ${sub} --address <email>`);
+        const usage = SUBCOMMAND_USAGE[sub];
+        info(usage ? `Usage: ${usage}` : `Unknown warmup subcommand: ${sub}. Run "myapi email warmup --help".`);
         return;
     }
     const config = requireConfig();

package/dist/commands/manifest.js

@@ -41,10 +41,17 @@ const MODULE_ALIAS = {
 };
 // Commands implemented inline in index.ts, with no module of their own.
 const INLINE = new Set(['completion', 'help', 'install-skills', 'whoami', 'login', 'setup', 'status', 'update', 'doctor']);
-async function usageMapFor(file) {
+async function registriesFor(file) {
     const mod = await import(pathToFileURL(file).href).catch(() => null);
     const usage = mod?.SUBCOMMAND_USAGE;
-    return usage && typeof usage === 'object' ? usage : null;
+    const nested = mod?.NESTED_SUBCOMMAND_USAGE;
+    return {
+        usage: usage && typeof usage === 'object' ? usage : null,
+        // A third level inside a flat module — `domain records list`. Namespaces
+        // that get a directory of their own (email/, crm/) express this by file
+        // layout instead and need no such export.
+        nested: nested && typeof nested === 'object' ? nested : null,
+    };
 }
 // Shipped code runs from dist/ (.js); the test suite runs the sources (.ts).
 // Matching only .js made the enrichment pass find nothing under vitest and
@@ -97,7 +104,7 @@ export async function buildManifest(version) {
                 if (!isModule(f))
                     continue;
                 const group = f.replace(MODULE_RE, '');
-                const usage = await usageMapFor(path.join(HERE, ns, f));
+                const { usage } = await registriesFor(path.join(HERE, ns, f));
                 if (!usage)
                     continue;
                 if (group === 'index') {
@@ -116,8 +123,8 @@ export async function buildManifest(version) {
             continue;
         const base = entry.name.replace(MODULE_RE, '');
         const cmd = MODULE_ALIAS[base] ?? base;
-        const usage = await usageMapFor(path.join(HERE, entry.name));
-        if (!usage)
+        const { usage, nested } = await registriesFor(path.join(HERE, entry.name));
+        if (!usage && !nested)
             continue;
         if (!COMMANDS.includes(cmd)) {
             // Not fatal: `verify.js` backs `email verify`, not a top-level command.
@@ -125,8 +132,13 @@ export async function buildManifest(version) {
                 warnings.push(`module "${base}.js" publishes subcommands but "${cmd}" is not a top-level command`);
             continue;
         }
-        for (const [sub, u] of Object.entries(usage))
+        for (const [sub, u] of Object.entries(usage ?? {}))
             add(`${cmd} ${sub}`, u);
+        for (const [sub, subs] of Object.entries(nested ?? {})) {
+            add(`${cmd} ${sub}`);
+            for (const [leaf, u] of Object.entries(subs))
+                add(`${cmd} ${sub} ${leaf}`, u);
+        }
     }
     // The spine alone always yields a plausible-looking manifest, so "the
     // enrichment pass found nothing" is invisible unless it is stated. It means

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@myapihq/cli",
   "license": "Apache-2.0",
-  "version": "2.16.2",
+  "version": "2.16.3",
   "description": "MyAPI command-line interface",
   "repository": {
     "type": "git",
@@ -46,7 +46,7 @@
     "lint:skills:strict": "node scripts/copy-skills.js && node scripts/lint-skills.js --strict"
   },
   "dependencies": {
-    "@myapihq/sdk": "^2.16.2"
+    "@myapihq/sdk": "^2.16.3"
   },
   "devDependencies": {
     "@types/node": "^25.6.0",