@myapihq/cli 1.0.73 → 1.0.75

package/dist/commands/domain.js

@@ -6,11 +6,21 @@ export async function check(domainArg, flags) {
     const config = requireConfig();
     const orgId = flags.org || config.default_org;
     const domain = domainArg || config.default_domain;
-    if (!orgId || !domain)
-        error("Missing required arguments.\nUsage: myapi domain check <domain> --org <id>\n(Set defaults: myapi auth config set-org <id> / myapi auth config set-domain <domain>)");
+    if (!orgId || !domain) {
+        const hint = config.default_org
+            ? `(current default org: ${config.default_org})`
+            : '(Set defaults: myapi config set-org <id> / myapi config set-domain <domain>)';
+        error(`Missing required arguments.\nUsage: myapi domain check <domain>${config.default_org ? '' : ' --org <id>'}\n${hint}`);
+    }
     const res = await sdkDomain.checkDomain(config.api_key, orgId, domain);
     if (flags.json) {
-        printJson(res);
+        const out = { domain, available: res.available };
+        if (res.available) {
+            out.price_cents = res.price_cents;
+            if (res.price_display)
+                out.price_display = res.price_display;
+        }
+        printJson(out);
         return;
     }
     if (res.available) {

package/dist/commands/funnel.d.ts

@@ -2,6 +2,6 @@ export declare function list(flags: Record<string, string | boolean>): Promise<v
 export declare function create(flags: Record<string, string | boolean>): Promise<void>;
 export declare function get(id: string, flags: Record<string, string | boolean>): Promise<void>;
 export declare function del(id: string, flags: Record<string, string | boolean>): Promise<void>;
-export declare function push(id: string, slug: string, flags: Record<string, string | boolean>): Promise<void>;
+export declare function push(slug: string, flags: Record<string, string | boolean>): Promise<void>;
 export declare function verify(id: string, flags: Record<string, string | boolean>): Promise<void>;
 export declare function run(subcommand: string | undefined, args: string[], flags: Record<string, string | boolean>): Promise<void>;

package/dist/commands/funnel.js

@@ -12,7 +12,12 @@ export async function list(flags) {
         printJson(funnels);
         return;
     }
-    const rows = funnels.map(f => ({ id: f.id, created_at: formatDate(f.created_at), updated_at: formatDate(f.updated_at) }));
+    const rows = funnels.map(f => ({
+        id: f.id,
+        preview_url: f.subdomain_url || f.domain_url || '',
+        created_at: formatDate(f.created_at),
+        updated_at: formatDate(f.updated_at),
+    }));
     if (rows.length === 0) {
         info('No funnels found. Create one with: myapi funnel create');
         return;
@@ -38,7 +43,21 @@ export async function get(id, flags) {
     if (!orgId || !id)
         error("Missing required arguments.\nUsage: myapi funnel get <id> --org <id>\n(Or set defaults via: myapi config set-org <id>)");
     const funnel = await sdkFunnel.getFunnel(config.api_key, orgId, id);
-    printJson(funnel);
+    if (flags.json) {
+        printJson(funnel);
+        return;
+    }
+    info(`ID:          ${funnel.id}`);
+    if (funnel.domain_url)
+        info(`Domain:      ${funnel.domain_url}`);
+    else if (funnel.subdomain_url)
+        info(`Preview:     ${funnel.subdomain_url}`);
+    if (funnel.created_at)
+        info(`Created:     ${formatDate(funnel.created_at)}`);
+    if (funnel.updated_at)
+        info(`Updated:     ${formatDate(funnel.updated_at)}`);
+    if (Array.isArray(funnel.pages))
+        info(`Pages:       ${funnel.pages.length}`);
 }
 export async function del(id, flags) {
     const config = requireConfig();
@@ -48,17 +67,14 @@ export async function del(id, flags) {
     await sdkFunnel.deleteFunnel(config.api_key, orgId, id);
     success(`Funnel ${id} deleted`);
 }
-export async function push(id, slug, flags) {
+export async function push(slug, flags) {
     const config = requireConfig();
     const orgId = flags.org || config.default_org;
     if (!orgId)
-        error("Missing org. Set a default with: myapi auth config set-org <id>");
-    if (slug && flags.slug && slug !== flags.slug) {
-        info(`› Note: positional slug "${slug}" takes precedence over --slug "${flags.slug}".`);
-    }
+        error("Missing org. Set a default with: myapi config set-org <id>");
     const rawSlug = slug || flags.slug || '/';
     const finalSlug = rawSlug.startsWith('/') ? rawSlug : `/${rawSlug}`;
-    let funnelId = id || config.default_funnel;
+    let funnelId = flags.funnel || config.default_funnel;
     if (!funnelId) {
         const existing = await sdkFunnel.listFunnels(config.api_key, orgId);
         if (existing.length === 0)
@@ -75,7 +91,7 @@ export async function push(id, slug, flags) {
         process.stdin.on('error', reject);
     });
     if (!html.trim())
-        error("No content provided via stdin. Usage: echo '<h1>Hello</h1>' | myapi funnel push [id] [slug]");
+        error("No content provided via stdin. Usage: echo '<h1>Hello</h1>' | myapi funnel push [slug]");
     const result = await sdkFunnel.pushFunnelPage(config.api_key, orgId, funnelId, { slug: finalSlug, html });
     success(`Pushed page to ${finalSlug}`);
     if (result?.url) {
@@ -114,7 +130,7 @@ export async function run(subcommand, args, flags) {
         else if (subcommand === 'delete')
             info('Usage: myapi funnel delete <id> --org <id>\n\nDeletes a funnel permanently.\n\nFlags:\n  --org <id>   Organization ID (or set default via myapi auth config set-org)');
         else if (subcommand === 'push')
-            info('Usage: myapi funnel push [funnel_id] [slug] < page.html\n\nPublishes an HTML page from stdin to a path within your funnel (website).\n\nArgument resolution:\n  - If the first positional argument starts with "/", it is treated as the slug\n    (funnel_id is omitted and your default funnel is used).\n  - If the first positional argument looks like a UUID, it is treated as funnel_id;\n    the second argument (if any) is the slug.\n  - Omit both to use your configured default funnel and slug "/".\n\nFlags:\n  --org <id>     Organization ID (or set default via myapi auth config set-org)\n  --slug <path>  Alternative way to specify the slug\n\nExamples:\n  echo \'<h1>Hello</h1>\' | myapi funnel push /        # push to / on default funnel\n  cat about.html | myapi funnel push /about           # push to /about\n  myapi funnel push < index.html                      # push to / on default funnel\n  cat p.html | myapi funnel push <uuid> /pricing      # explicit funnel + slug');
+            info('Usage: myapi funnel push [slug] < page.html\n\nPublishes an HTML page from stdin to a path within your funnel (website).\nThe funnel is always resolved from your default or --funnel flag.\n\nFlags:\n  --org <id>      Organization ID (or set default via myapi config set-org)\n  --funnel <id>   Funnel ID (or set default via myapi config set-funnel)\n  --slug <path>   Alternative way to specify the slug\n\nExamples:\n  echo \'<h1>Hello</h1>\' | myapi funnel push /        # push to /\n  cat about.html | myapi funnel push /about           # push to /about\n  myapi funnel push < index.html                      # push to / on default funnel\n  cat p.html | myapi funnel push /pricing --funnel <uuid>');
         else if (subcommand === 'pull')
             info('Usage: myapi funnel pull [funnel_id] [slug]\n\nFetches the HTML content of a funnel page.');
         return;
@@ -128,7 +144,7 @@ export async function run(subcommand, args, flags) {
     else if (subcommand === 'delete')
         await del(args[0], flags);
     else if (subcommand === 'push')
-        await push(args[0], args[1], flags);
+        await push(args[0], flags);
     else if (subcommand === 'verify')
         await verify(args[0], flags);
     else

package/dist/commands/org.js

@@ -51,7 +51,16 @@ export async function list(flags) {
     const config = requireConfig();
     const orgs = await hq.listOrgs(config.api_key);
     if (flags.json) {
-        printJson(orgs);
+        if (flags.verbose) {
+            printJson(orgs);
+            return;
+        }
+        printJson(orgs.map((o) => ({
+            id: o.id,
+            name: o.name,
+            preview_subdomain: o.preview_subdomain || undefined,
+            created_at: o.created_at || undefined,
+        })));
         return;
     }
     const rows = orgs.map((o) => ({
@@ -66,12 +75,13 @@ export async function get(id, flags) {
         info('Usage: myapi org get <id> [--json]\n\nFetches details of a specific organization.\n\nFlags:\n  --json   Output raw JSON');
         return;
     }
-    if (!id) {
-        error("Missing org id. Usage: myapi org get <id>");
+    const config = requireConfig();
+    const resolvedId = id || config.default_org;
+    if (!resolvedId) {
+        error("Missing org id. Usage: myapi org get <id>\n(Or set a default: myapi config set-org <id>)");
         return;
     }
-    const config = requireConfig();
-    const org = await hq.getOrg(config.api_key, id);
+    const org = await hq.getOrg(config.api_key, resolvedId);
     if (flags.json) {
         printJson(org);
         return;

package/dist/commands/update.js

@@ -1,29 +1,55 @@
 import { execSync } from 'child_process';
 import { existsSync } from 'fs';
 import { loadConfig } from '../config.js';
-import { info, success } from '../output.js';
+import { info, success, banner } from '../output.js';
 import { installSkills } from './setup.js';
 const REGISTRY_URL = 'https://registry.npmjs.org/@myapihq/cli/latest';
+const PACKUMENT_URL = 'https://registry.npmjs.org/@myapihq/cli';
+// Verify the version is listed in the full packument — the same data source
+// `npm install` consults. The /latest endpoint and the tarball URL are on
+// different CDN caches and can update before the packument does, causing
+// `npm install` to fail with ETARGET. This check eliminates that race.
+async function isVersionInstallable(version) {
+    try {
+        const res = await fetch(PACKUMENT_URL, {
+            headers: { Accept: 'application/vnd.npm.install-v1+json' },
+            signal: AbortSignal.timeout(5000),
+        });
+        if (!res.ok)
+            return false;
+        const data = await res.json();
+        return Boolean(data.versions && data.versions[version]);
+    }
+    catch {
+        return false;
+    }
+}
 // Resolve the npm binary and global prefix to use for self-update.
 // We install to the same prefix where the current myapi binary lives,
 // so the update actually replaces the running binary.
+// `--prefer-online` forces npm to revalidate its local packument cache
+// against the registry — without it, a stale local cache can also produce
+// ETARGET even when the registry itself has the version.
 function npmInstallArgs(version) {
     const npmCandidate = process.execPath.replace(/[/\\]node(\.exe)?$/, '/npm');
     const bin = existsSync(npmCandidate) ? npmCandidate : 'npm';
-    // Find where the currently-running myapi binary is, derive its npm prefix.
+    const baseArgs = ['install', '-g', '--prefer-online', `@myapihq/cli@${version}`];
     try {
-        const self = process.argv[1]; // e.g. /usr/local/bin/myapi or ~/.nvm/.../bin/myapi
-        const binDir = self.replace(/[/\\][^/\\]+$/, ''); // strip the filename
-        const prefix = binDir.replace(/[/\\]bin$/, ''); // strip /bin
-        return { bin, args: ['install', '-g', '--prefix', prefix, `@myapihq/cli@${version}`] };
+        const self = process.argv[1];
+        const binDir = self.replace(/[/\\][^/\\]+$/, '');
+        const prefix = binDir.replace(/[/\\]bin$/, '');
+        return { bin, args: ['install', '-g', '--prefer-online', '--prefix', prefix, `@myapihq/cli@${version}`] };
     }
     catch {
-        return { bin, args: ['install', '-g', `@myapihq/cli@${version}`] };
+        return { bin, args: baseArgs };
     }
 }
 // checkForUpdate runs silently in the background on every command.
 // Auto-installs if a newer version is available.
+// Suppress entirely with MYAPI_NO_UPDATE=1 or when stdout is not a TTY.
 export async function checkForUpdate(currentVersion) {
+    if (process.env.MYAPI_NO_UPDATE === '1' || !process.stdout.isTTY)
+        return;
     try {
         const res = await fetch(REGISTRY_URL, { signal: AbortSignal.timeout(3000) });
         if (!res.ok)
@@ -31,18 +57,12 @@ export async function checkForUpdate(currentVersion) {
         const data = await res.json();
         const latest = data.version;
         if (latest && isNewer(latest, currentVersion)) {
-            // Verify the tarball is actually available before attempting install —
-            // the registry metadata can report a new version before the tarball is uploaded.
-            const tarballUrl = `https://registry.npmjs.org/@myapihq/cli/-/cli-${latest}.tgz`;
-            try {
-                const check = await fetch(tarballUrl, { method: 'HEAD', signal: AbortSignal.timeout(3000) });
-                if (!check.ok)
-                    return; // Tarball not ready yet — silently skip, retry next command.
-            }
-            catch {
+            // Verify the version is actually installable before attempting install —
+            // the /latest endpoint can report a new version before the packument
+            // (which `npm install` consults) has propagated through the CDN.
+            if (!(await isVersionInstallable(latest)))
                 return;
-            }
-            info(`\n› New version available (${currentVersion} → ${latest}) — installing…`);
+            banner(`\n› New version available (${currentVersion} → ${latest}) — installing…`);
             try {
                 const { bin, args } = npmInstallArgs(latest);
                 execSync(`"${bin}" ${args.map(a => `"${a}"`).join(' ')}`, { stdio: 'pipe' });
@@ -50,12 +70,12 @@ export async function checkForUpdate(currentVersion) {
                 if (config?.skills_installed) {
                     await installSkills();
                 }
-                info(`› Updated to ${latest} — active after this command completes.\n`);
+                banner(`› Updated to ${latest} — active after this command completes.\n`);
             }
             catch (installErr) {
                 const msg = installErr?.stderr?.toString?.() || installErr?.message || String(installErr);
-                info(`› Auto-update failed: ${msg.trim()}`);
-                info(`› Run manually: npm install -g @myapihq/cli@latest`);
+                banner(`› Auto-update failed: ${msg.trim()}`);
+                banner(`› Run manually: npm install -g @myapihq/cli@latest`);
             }
         }
     }
@@ -66,7 +86,7 @@ export async function checkForUpdate(currentVersion) {
 // myapi update — explicit update, same logic as auto-update.
 export async function update(flags = {}) {
     if (flags.help) {
-        info('Usage: myapi update\n\nUpdates the MyAPI CLI and installed skills to the latest published version.\nEquivalent to: npm install -g @myapihq/cli@latest\n\nNotes:\n  - Version pinning and rollback are not supported — always installs the latest.\n  - The CLI also auto-updates silently on each command when a newer version is\n    detected. If you need a stable version in CI, pin with:\n      npm install -g @myapihq/cli@<version>\n    and set NO_COLOR=1 to suppress ANSI output in non-TTY environments.');
+        info('Usage: myapi update\n\nUpdates the MyAPI CLI and installed skills to the latest published version.\nEquivalent to: npm install -g @myapihq/cli@latest\n\nNotes:\n  - Version pinning and rollback are not supported — always installs the latest.\n  - The CLI also auto-updates silently on each command when a newer version is\n    detected (banner goes to stderr, suppressed on non-TTY stdout).\n  - To disable auto-update: set MYAPI_NO_UPDATE=1 in your environment.\n  - For a pinned version in CI: npm install -g @myapihq/cli@<version>');
         return;
     }
     info('› Checking for updates…');
@@ -91,7 +111,7 @@ export async function update(flags = {}) {
     }
     info('› Refreshing skills…');
     await installSkills();
-    success('› Up to date.');
+    success('Up to date.');
 }
 // latestVersion fetches the current published version for --version display.
 export async function latestVersion() {

package/dist/index.js

@@ -23,25 +23,32 @@ const ERROR_MESSAGES = {
     org_not_found: 'Organization not found.',
     FUNNEL_NOT_FOUND: 'Funnel not found.',
     funnel_not_found: 'Funnel not found.',
+    funnel_already_exists: 'Your org already has a funnel. Use: myapi funnel list',
+    FUNNEL_ALREADY_EXISTS: 'Your org already has a funnel. Use: myapi funnel list',
+    domain_already_registered: 'This domain is already registered under your account.',
+    DOMAIN_ALREADY_REGISTERED: 'This domain is already registered under your account.',
+    domain_not_available: 'This domain is not available for registration.',
+    DOMAIN_NOT_AVAILABLE: 'This domain is not available for registration.',
     db_error: 'Resource not found or invalid ID.',
     NOT_FOUND: 'Resource not found.',
     FORBIDDEN: 'You do not have permission to perform this action.',
     RATE_LIMITED: 'Too many requests. Please wait a moment and try again.',
+    INSUFFICIENT_BALANCE: 'Insufficient balance. Run: myapi billing topup <amount>',
 };
 function friendlyError(code) {
     return ERROR_MESSAGES[code] || code;
 }
 async function main() {
-    const updatePromise = updateCmd.checkForUpdate(pkg.version).catch(() => { });
     const { args, flags } = parseArgs(process.argv.slice(2));
     if (flags.version || flags.v || flags.V) {
-        const [latest] = await Promise.all([updateCmd.latestVersion(), updatePromise]);
+        const latest = await updateCmd.latestVersion();
         const updateNote = latest && updateCmd.isNewer(latest, pkg.version)
             ? ` (update available: ${latest})`
             : '';
         info(`myapi ${pkg.version}${updateNote}`);
         return;
     }
+    const updatePromise = updateCmd.checkForUpdate(pkg.version).catch(() => { });
     if (flags.help && args.length === 0) {
         printHelp();
         return;
@@ -54,7 +61,7 @@ async function main() {
         }
         printHelp();
         await updatePromise;
-        return;
+        process.exit(1);
     }
     const [command, subcommand, ...restArgs] = args;
     try {
@@ -177,7 +184,12 @@ async function main() {
                 success('› Skills installed.');
                 break;
             case 'help':
-                printHelp();
+                if (subcommand) {
+                    info(`Run: myapi ${subcommand} --help`);
+                }
+                else {
+                    printHelp();
+                }
                 break;
             default:
                 error(`Unknown command: ${command}. Run "myapi" for available commands.`);

package/dist/output.d.ts

@@ -1,5 +1,6 @@
 export declare function success(message: string): void;
 export declare function error(message: string): never;
 export declare function info(message: string): void;
+export declare function banner(message: string): void;
 export declare function printJson(data: unknown): void;
 export declare function printTable(rows: Record<string, unknown>[]): void;

package/dist/output.js

@@ -9,6 +9,9 @@ export function error(message) {
 export function info(message) {
     console.log(message);
 }
+export function banner(message) {
+    process.stderr.write(message + '\n');
+}
 export function printJson(data) {
     console.log(JSON.stringify(data, null, 2));
 }

package/dist/utils.js

@@ -43,5 +43,5 @@ export function formatDate(str) {
     const date = new Date(clean);
     if (isNaN(date.getTime()))
         return str;
-    return date.toISOString().replace('T', ' ').slice(0, 16);
+    return date.toISOString().replace('T', ' ').slice(0, 16) + ' UTC';
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@myapihq/cli",
-  "version": "1.0.73",
+  "version": "1.0.75",
   "description": "MyAPI command-line interface",
   "type": "module",
   "files": [