@myapihq/cli 1.0.82 → 1.1.0-wip.0

package/dist/commands/org.js

@@ -3,17 +3,22 @@ import { hq, funnel as sdkFunnel } from '@myapihq/sdk';
 import { requireConfig, saveConfig } from '../config.js';
 import { success, error, printTable, printJson, info } from '../output.js';
 import { sleep, formatDate } from '../utils.js';
-export async function create(flags) {
-    if (flags.help) {
-        info('Usage: myapi org create --name <name> [options]\n\nCreates a new organization. A funnel (website) is automatically created alongside it.\n\nOptions:\n  --name              Organization name (required). Use quotes for names with spaces.\n  --tagline           Short tagline\n  --description       Detailed description\n  --business-sector   Sector (e.g. Technology)\n  --logo-url          URL to logo image\n  --yes               Skip the "set as default?" prompt (useful in CI / agent workflows)\n\nExamples:\n  myapi org create --name "Acme Inc"\n  myapi org create --name "Acme Inc" --yes');
-        return;
-    }
-    if (!flags.name) {
-        error("Missing --name flag. Run 'myapi org create --help' for details.");
-        return;
-    }
+import { requireOrg } from '../helpers.js';
+export const SCHEMA = {
+    name: 'string',
+    tagline: 'string',
+    description: 'string',
+    'business-sector': 'string',
+    'logo-url': 'string',
+    org: 'string',
+};
+const SYNC_BRAND_TIMEOUT_MS = 5 * 60 * 1000;
+export async function create(restArgs, flags) {
+    const name = flags.name || restArgs[0];
+    if (!name)
+        error('Missing org name. Usage: myapi org create "My Company" [--yes]');
     const config = requireConfig();
-    const payload = { name: flags.name };
+    const payload = { name };
     if (flags.tagline)
         payload.tagline = flags.tagline;
     if (flags.description)
@@ -23,31 +28,41 @@ export async function create(flags) {
     if (flags['logo-url'])
         payload.logo_url = flags['logo-url'];
     const org = await hq.createOrg(config.api_key, payload);
-    success(`Org created! ID: ${org.id}, Name: ${org.name}`);
-    if (org.preview_subdomain) {
-        info(`Preview domain: https://${org.preview_subdomain}.makeautonomous.com`);
+    if (!flags.json) {
+        success(`Org created! ID: ${org.id}, Name: ${org.name}`);
+        if (org.preview_subdomain) {
+            info(`Preview domain: https://${org.preview_subdomain}.makeautonomous.com`);
+        }
     }
     const setDefault = flags.yes || await new Promise(resolve => {
         const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-        rl.question(`› Set as default org and funnel? (Y/n) `, ans => {
+        rl.question('› Set as default org and funnel? (Y/n) ', ans => {
             rl.close();
             resolve(ans.trim().toLowerCase() !== 'n');
         });
     });
+    let funnelId;
     if (setDefault) {
         config.default_org = org.id;
         const funnels = await sdkFunnel.listFunnels(config.api_key, org.id);
-        if (funnels.length > 0)
+        if (funnels.length > 0) {
             config.default_funnel = funnels[0].id;
+            funnelId = funnels[0].id;
+        }
         saveConfig(config);
-        success(`Default org${funnels.length > 0 ? ' and funnel' : ''} updated.`);
+        if (!flags.json)
+            success(`Default org${funnelId ? ' and funnel' : ''} updated.`);
+    }
+    if (flags.json) {
+        const result = { id: org.id, name: org.name };
+        if (org.preview_subdomain)
+            result.preview_url = `https://${org.preview_subdomain}.makeautonomous.com`;
+        if (funnelId)
+            result.funnel_id = funnelId;
+        printJson(result);
     }
 }
 export async function list(flags) {
-    if (flags.help) {
-        info('Usage: myapi org list [--json]\n\nLists all organizations in your account.\n\nFlags:\n  --json   Output raw JSON');
-        return;
-    }
     const config = requireConfig();
     const orgs = await hq.listOrgs(config.api_key);
     if (flags.json) {
@@ -68,19 +83,16 @@ export async function list(flags) {
         name: o.id === config.default_org ? `${o.name} *` : o.name,
         created_at: o.created_at ? formatDate(o.created_at) : '',
     }));
-    printTable(rows);
+    printTable(rows, {
+        flags,
+        empty: 'No organizations found. Create one with: myapi org create "My Company"',
+    });
 }
 export async function get(id, flags) {
-    if (flags.help) {
-        info('Usage: myapi org get <id> [--json]\n\nFetches details of a specific organization.\n\nFlags:\n  --json   Output raw JSON');
-        return;
-    }
     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;
-    }
+    if (!resolvedId)
+        error('Missing org id. Usage: myapi org get <id>\n(Or set a default: myapi config set-org <id>)');
     const org = await hq.getOrg(config.api_key, resolvedId);
     if (flags.json) {
         printJson(org);
@@ -95,49 +107,105 @@ export async function get(id, flags) {
     if (org.preview_subdomain)
         info(`Preview: https://${org.preview_subdomain}.makeautonomous.com`);
 }
-export async function del(id, flags) {
-    if (flags.help) {
-        info('Usage: myapi org delete <id>\n\nPermanently deletes an organization and its associated funnels.\nNote: any registered domains assigned to this org must be unassigned first.\n\nNo confirmation prompt is shown — this action is immediate.');
-        return;
-    }
-    if (!id) {
-        error("Missing org id. Usage: myapi org delete <id>");
-        return;
-    }
+export async function del(id, _flags) {
+    if (!id)
+        error('Missing org id. Usage: myapi org delete <id>');
     const config = requireConfig();
     await hq.deleteOrg(config.api_key, id);
     success(`Org ${id} deleted`);
 }
 export async function importOrg(args, flags) {
-    if (flags.help) {
-        info('Usage: myapi org sync-brand <domain> --org <id>\n\nFetches an existing website and extracts brand signals (name, logo, description,\nbusiness sector) to enrich your organization profile automatically.\n\nThis does NOT register or transfer the domain — it only reads from the site.\nThe org must already exist before running this command.\n\nPrerequisite:\n  myapi org create --name "My Brand" --yes\n\nExample:\n  myapi org sync-brand example.com --org <id>');
-        return;
-    }
     const config = requireConfig();
     const domain = args[0] || config.default_domain;
-    const orgId = flags.org || config.default_org;
-    if (!domain || !orgId) {
-        error("Missing required arguments.\nUsage: myapi org import <domain> --org <id>\n(Or set defaults via: myapi config set-org <id> / set-domain <domain>)");
-        return;
-    }
+    const orgId = requireOrg(flags, config, 'myapi org sync-brand <domain> [--org <id>]');
+    if (!domain)
+        error('Missing required arguments.\nUsage: myapi org sync-brand <domain> [--org <id>]\n(Or set default: myapi config set-domain <domain>)');
     const result = await hq.importOrg(config.api_key, orgId, domain);
     const importId = result.job_id;
-    process.stdout.write("Importing ");
+    process.stdout.write('Importing ');
     const chars = ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'];
     let i = 0;
-    while (true) {
+    let elapsed = 0;
+    while (elapsed < SYNC_BRAND_TIMEOUT_MS) {
         const status = await hq.getOrgImportStatus(config.api_key, importId);
         if (status.status === 'awaiting_confirm') {
             process.stdout.write('\r\x1b[K');
-            break;
+            const org = await hq.confirmOrgImport(config.api_key, importId);
+            success(`Import complete! Org ID: ${org.id}`);
+            return;
         }
         if (status.status === 'failed') {
             process.stdout.write('\r\x1b[K');
-            error("Import failed");
+            error('Import failed');
         }
         process.stdout.write(`\rImporting ${chars[i++ % chars.length]}`);
         await sleep(3000);
+        elapsed += 3000;
+    }
+    process.stdout.write('\r\x1b[K');
+    error(`Import timed out after ${SYNC_BRAND_TIMEOUT_MS / 1000}s. The job may still complete in the background — re-run "myapi org sync-brand" to retry.`);
+}
+// ── Dispatcher ───────────────────────────────────────────────────────────────
+const SUBCOMMAND_USAGE = {
+    'list': 'myapi org list [--json]',
+    'create': `myapi org create <name> [--tagline <str>] [--description <str>] [--business-sector <str>] [--logo-url <url>] [--yes] [--json]
+       myapi org create --name <name> [...]
+
+Creates a new organization. A funnel (website) is automatically created alongside it.
+Pass --yes to skip the "set as default?" prompt (useful in CI / agent workflows).
+
+Examples:
+  myapi org create "Acme Inc"
+  myapi org create "Acme Inc" --yes
+  myapi org create --name "Acme Inc" --yes`,
+    'get': 'myapi org get <id> [--json]',
+    'delete': `myapi org delete <id>
+
+Permanently deletes an organization and its associated funnels.
+Any registered domains assigned to this org must be unassigned first.
+No confirmation prompt — the action is immediate.`,
+    'sync-brand': `myapi org sync-brand <domain> [--org <id>]
+
+Fetches an existing website and extracts brand signals (name, logo, description,
+business sector) to enrich your organization profile.
+
+Does NOT register or transfer the domain — it only reads from the site.
+The org must already exist. Polls for up to 5 minutes.
+
+Example:
+  myapi org create --name "My Brand" --yes
+  myapi org sync-brand example.com --org <id>`,
+};
+export async function run(subcommand, args, flags) {
+    if (!subcommand || (flags.help && !subcommand)) {
+        info(`Usage: myapi org <subcommand>
+
+Subcommands:
+  list        List organizations
+  create      Create an organization (e.g. myapi org create "Name" --yes)
+  get         Get details of an organization
+  delete      Delete an organization
+  sync-brand  Sync brand info (name, logo, description) from an existing website`);
+        return;
+    }
+    if (flags.help) {
+        const lookup = subcommand === 'import' ? 'sync-brand' : subcommand;
+        const usage = SUBCOMMAND_USAGE[lookup];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi org --help" for the list.`);
+        return;
+    }
+    switch (subcommand) {
+        case 'list': return list(flags);
+        case 'create': return create(args, flags);
+        case 'get': return get(args[0], flags);
+        case 'delete': return del(args[0], flags);
+        case 'sync-brand': return importOrg(args, flags);
+        case 'import':
+            process.stderr.write('› Note: "org import" is deprecated — use "org sync-brand" instead.\n');
+            return importOrg(args, flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi org --help" for available subcommands.`);
     }
-    const org = await hq.confirmOrgImport(config.api_key, importId);
-    success(`Import complete! Org ID: ${org.id}`);
 }

package/dist/commands/pixel.js

@@ -43,22 +43,34 @@ export async function identity(pixelId, flags) {
     const res = await sdkPixel.getIdentity(config.api_key, orgId, pixelId);
     printJson(res);
 }
+// ── Dispatcher ───────────────────────────────────────────────────────────────
+const SUBCOMMAND_USAGE = {
+    'interactions': 'myapi pixel interactions [--website <domain>] [--campaign-id <id>] [--domain <domain>] [--from <iso8601>] [--to <iso8601>] [--limit <num>] [--offset <num>] [--org <id>] [--json]',
+    'identity': 'myapi pixel identity <pixel_id> [--org <id>]',
+};
 export async function run(subcommand, args, flags) {
     if (!subcommand || (flags.help && !subcommand)) {
-        info('Usage: myapi pixel <subcommand>\n\nSubcommands:\n  interactions   Get a unified timeline of visits and events\n  identity       Resolve the identity graph for a pixel ID\n\nNote: All pixel commands require the --org <id> flag.');
+        info(`Usage: myapi pixel <subcommand>
+
+Subcommands:
+  interactions   Get a unified timeline of visits and events
+                 (requires at least one filter: --website, --campaign-id, or --domain)
+  identity       Resolve the identity graph (emails, IPs, profiles) for a pixel ID
+
+All commands accept --org <id> (or set default: myapi config set-org <id>).`);
         return;
     }
     if (flags.help) {
-        if (subcommand === 'interactions')
-            info('Usage: myapi pixel interactions --org <id> [--website <domain>] [--campaign-id <id>] [--domain <domain>] [--from <iso8601>] [--to <iso8601>] [--limit <num>] [--offset <num>] [--json]\n\nRetrieves a merged timeline of web visits and email events. Requires at least one filter (--website, --campaign-id, or --domain).');
-        else if (subcommand === 'identity')
-            info('Usage: myapi pixel identity <pixel_id> --org <id>\n\nResolves the full identity graph (emails, IPs, profiles) for a specific pixel tracker ID.');
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi pixel --help" for the list.`);
         return;
     }
-    if (subcommand === 'interactions')
-        await interactions(flags);
-    else if (subcommand === 'identity')
-        await identity(args[0], flags);
-    else
-        error(`Unknown subcommand: ${subcommand}. Run "myapi pixel --help" for a list of valid subcommands.`);
+    switch (subcommand) {
+        case 'interactions': return interactions(flags);
+        case 'identity': return identity(args[0], flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi pixel --help" for a list of valid subcommands.`);
+    }
 }

package/dist/commands/setup.d.ts

@@ -1,3 +1,4 @@
+import type { Flags } from '../helpers.js';
 export declare function installSkills(): Promise<void>;
-export declare function importKey(apiKey: string, flags: Record<string, string | boolean>): Promise<void>;
-export declare function setup(flags?: Record<string, string | boolean>): Promise<void>;
+export declare function importKey(apiKey: string, flags: Flags): Promise<void>;
+export declare function setup(flags?: Flags): Promise<void>;

package/dist/commands/setup.js

@@ -4,7 +4,7 @@ import * as path from 'path';
 import * as readline from 'readline';
 import { loadConfig, saveConfig, addAccount, loadFullConfig } from '../config.js';
 import { info, success } from '../output.js';
-const API_BASE = process.env.MYAPI_API_BASE ?? 'https://api.myapihq.com';
+import { hq, funnel as sdkFunnel } from '@myapihq/sdk';
 function ask(rl, q) {
     return new Promise(resolve => rl.question(q, resolve));
 }
@@ -14,17 +14,6 @@ function yn(answer, defaultYes = true) {
         return defaultYes;
     return t === 'y' || t === 'yes';
 }
-async function post(path, body) {
-    const res = await fetch(`${API_BASE}${path}`, {
-        method: 'POST',
-        headers: { 'Content-Type': 'application/json' },
-        body: JSON.stringify(body),
-    });
-    const json = await res.json();
-    if (!res.ok)
-        throw new Error(json.error ?? `HTTP ${res.status}`);
-    return json.data ?? json;
-}
 // ---------------------------------------------------------------------------
 // Skills installation
 // ---------------------------------------------------------------------------
@@ -55,7 +44,9 @@ export async function installSkills() {
         fs.mkdirSync(skillDir, { recursive: true });
         fs.copyFileSync(path.join(BUNDLED_SKILLS_DIR, skill, 'SKILL.md'), path.join(skillDir, 'SKILL.md'));
     }
-    // Symlink each skill into agent config directories
+    // Symlink each skill into agent config directories. Surface failures so
+    // users can fix permission issues — skills that didn't install will not
+    // be available to the agent and "skills installed" would otherwise lie.
     for (const [agent, dir] of Object.entries(AGENT_DIRS)) {
         try {
             fs.mkdirSync(dir, { recursive: true });
@@ -70,8 +61,15 @@ export async function installSkills() {
             }
             info(`  ✓ ${agent}`);
         }
-        catch {
-            // Silently skip agents whose directory can't be created.
+        catch (err) {
+            // Skip agents not installed on this machine (ENOENT on parent dir is OK).
+            // Surface anything else so the user knows skills aren't fully installed.
+            const code = err?.code;
+            if (code === 'ENOENT' || code === 'ENOTDIR') {
+                // Agent likely not installed — quietly skip.
+                continue;
+            }
+            info(`  ✗ ${agent}: ${err.message || code} (${dir})`);
         }
     }
 }
@@ -80,18 +78,14 @@ export async function installSkills() {
 // ---------------------------------------------------------------------------
 async function registeredFlow(rl) {
     const email = (await ask(rl, '› Email? ')).trim();
-    await post('/hq/account/send-code', { email });
+    await hq.sendCode(email);
     info(`› Sent a code to ${email} · paste it below`);
     const code = (await ask(rl, '› Code? ')).trim();
-    const data = await post('/hq/account/verify-code', { email, code });
+    const data = await hq.verifyCode(email, code);
     return { ...data, email };
 }
-// ---------------------------------------------------------------------------
-// Anonymous flow
-// ---------------------------------------------------------------------------
 async function anonymousFlow() {
-    const data = await post('/hq/account/anonymous', {});
-    return data;
+    return hq.createAnonymousAccount();
 }
 // ---------------------------------------------------------------------------
 // Main setup command
@@ -102,37 +96,25 @@ export async function importKey(apiKey, flags) {
         info('Usage: myapi auth import-key <api_key> [--install-skills] [--no-skills]\n\nImports an existing API key non-interactively. Use this in CI, Docker, or any\nenvironment where the interactive "myapi auth setup" flow is not practical.\n\nThe key is validated against the API before being saved. Your default org and\nfunnel are auto-detected from the account and written to the local config.\n\nFlags:\n  --install-skills   Also install the MyAPI skills pack for AI agents after importing\n  --no-skills        Skip skills installation even if previously installed\n\nExamples:\n  myapi auth import-key hq_live_xxxxxxxxxxxxxxxxxxxx\n  myapi auth import-key hq_live_xxxxxxxxxxxxxxxxxxxx --install-skills');
         return;
     }
-    const auth = { Authorization: `Bearer ${apiKey}` };
     let accountId = '';
     let email;
     let defaultOrg = '';
     let defaultFunnel = '';
     try {
-        const meRes = await fetch(`${API_BASE}/hq/account/me`, { headers: auth });
-        const meJson = await meRes.json();
-        if (!meRes.ok)
-            throw new Error(meJson.error ?? `HTTP ${meRes.status}`);
-        const me = meJson.data ?? meJson;
+        const me = await hq.getAccount(apiKey);
         accountId = me.account_id ?? '';
         email = me.email || undefined;
     }
     catch (e) {
         throw new Error(`Could not verify API key: ${e.message}`);
     }
-    // Fetch org/funnel defaults.
     try {
-        const orgRes = await fetch(`${API_BASE}/hq/orgs`, { headers: auth });
-        if (orgRes.ok) {
-            const orgs = ((await orgRes.json())?.data ?? []);
-            if (orgs.length > 0) {
-                defaultOrg = orgs[orgs.length - 1].id;
-                const fRes = await fetch(`${API_BASE}/funnel/orgs/${defaultOrg}/funnels`, { headers: auth });
-                if (fRes.ok) {
-                    const funnels = ((await fRes.json())?.data ?? []);
-                    if (funnels.length > 0)
-                        defaultFunnel = funnels[funnels.length - 1].id;
-                }
-            }
+        const orgs = await hq.listOrgs(apiKey);
+        if (orgs.length > 0) {
+            defaultOrg = orgs[orgs.length - 1].id;
+            const funnels = await sdkFunnel.listFunnels(apiKey, defaultOrg);
+            if (funnels.length > 0)
+                defaultFunnel = funnels[funnels.length - 1].id;
         }
     }
     catch { /* non-fatal */ }
@@ -224,42 +206,27 @@ export async function setup(flags = {}) {
         }
         // Validate key and ensure org/funnel defaults are correct.
         try {
-            const auth = { Authorization: `Bearer ${apiKey}` };
-            const meRes = await fetch(`${API_BASE}/hq/account/me`, { headers: auth });
-            if (!meRes.ok) {
-                info('› Warning: could not verify API key — check your connection.');
-            }
-            else {
-                // Verify default org exists; if not, fetch the most recent one.
-                let resolvedOrg = defaultOrg;
-                let resolvedFunnel = defaultFunnel;
-                const orgRes = await fetch(`${API_BASE}/hq/orgs`, { headers: auth });
-                if (orgRes.ok) {
-                    const orgs = (await orgRes.json())?.data ?? [];
-                    if (orgs.length > 0) {
-                        const latest = orgs[orgs.length - 1];
-                        if (!resolvedOrg || !orgs.find((o) => o.id === resolvedOrg)) {
-                            resolvedOrg = latest.id;
-                            info(`› Auto-selected org: ${latest.name} (${resolvedOrg})`);
-                        }
-                        // Verify default funnel exists within the org.
-                        const fRes = await fetch(`${API_BASE}/funnel/orgs/${resolvedOrg}/funnels`, { headers: auth });
-                        if (fRes.ok) {
-                            const funnels = (await fRes.json())?.data ?? [];
-                            if (funnels.length > 0 && (!resolvedFunnel || !funnels.find((f) => f.id === resolvedFunnel))) {
-                                resolvedFunnel = funnels[funnels.length - 1].id;
-                                info(`› Auto-selected funnel: ${resolvedFunnel}`);
-                            }
-                        }
-                        if (resolvedOrg !== defaultOrg || resolvedFunnel !== defaultFunnel) {
-                            const full = loadFullConfig();
-                            const idx = full.active;
-                            full.accounts[idx].default_org = resolvedOrg;
-                            full.accounts[idx].default_funnel = resolvedFunnel;
-                            fs.writeFileSync(path.join(os.homedir(), '.myapi', 'config.json'), JSON.stringify(full, null, 2), { mode: 0o600 });
-                            defaultOrg = resolvedOrg;
-                            defaultFunnel = resolvedFunnel;
-                        }
+            await hq.getAccount(apiKey);
+            let resolvedOrg = defaultOrg;
+            let resolvedFunnel = defaultFunnel;
+            const orgs = await hq.listOrgs(apiKey);
+            if (orgs.length > 0) {
+                const latest = orgs[orgs.length - 1];
+                if (!resolvedOrg || !orgs.find(o => o.id === resolvedOrg)) {
+                    resolvedOrg = latest.id;
+                    info(`› Auto-selected org: ${latest.name} (${resolvedOrg})`);
+                }
+                const funnels = await sdkFunnel.listFunnels(apiKey, resolvedOrg);
+                if (funnels.length > 0 && (!resolvedFunnel || !funnels.find((f) => f.id === resolvedFunnel))) {
+                    resolvedFunnel = funnels[funnels.length - 1].id;
+                    info(`› Auto-selected funnel: ${resolvedFunnel}`);
+                }
+                if (resolvedOrg !== defaultOrg || resolvedFunnel !== defaultFunnel) {
+                    const current = loadConfig();
+                    if (current) {
+                        saveConfig({ ...current, default_org: resolvedOrg, default_funnel: resolvedFunnel });
+                        defaultOrg = resolvedOrg;
+                        defaultFunnel = resolvedFunnel;
                     }
                 }
             }

package/dist/commands/storage.js

@@ -30,26 +30,36 @@ export async function del(id, flags) {
     await sdkStorage.deleteAsset(config.api_key, orgId, id);
     success(`Asset ${id} deleted`);
 }
+// ── Dispatcher ───────────────────────────────────────────────────────────────
+const SUBCOMMAND_USAGE = {
+    'list': 'myapi storage list [--org <id>] [--json]',
+    'ingest': 'myapi storage ingest <url> [--name <name>] [--org <id>]',
+    'delete': 'myapi storage delete <asset_id> [--org <id>]',
+};
 export async function run(subcommand, args, flags) {
     if (!subcommand || (flags.help && !subcommand)) {
-        info('Usage: myapi storage <subcommand>\n\nSubcommands:\n  list       List all your uploaded assets\n  ingest     Ingest a public image URL into your edge storage\n  delete     Delete a stored asset\n\nNote: All storage commands require the --org <id> flag.');
+        info(`Usage: myapi storage <subcommand>
+
+Subcommands:
+  list       List all your uploaded assets
+  ingest     Ingest a public image URL into your edge storage
+  delete     Delete a stored asset
+
+All commands accept --org <id> (or set default: myapi config set-org <id>).`);
         return;
     }
     if (flags.help) {
-        if (subcommand === 'list')
-            info('Usage: myapi storage list --org <id> [--json]');
-        else if (subcommand === 'ingest')
-            info('Usage: myapi storage ingest <url> [--name <name>] --org <id>\n\nDownloads a public image (JPEG/PNG) and permanently hosts it on your MyAPI storage. Returns the new URL.');
-        else if (subcommand === 'delete')
-            info('Usage: myapi storage delete <asset_id> --org <id>');
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi storage --help" for the list.`);
         return;
     }
-    if (subcommand === 'list')
-        await list(flags);
-    else if (subcommand === 'ingest')
-        await ingest(args[0], flags);
-    else if (subcommand === 'delete')
-        await del(args[0], flags);
-    else
-        error(`Unknown subcommand: ${subcommand}. Run "myapi storage --help" for a list of valid subcommands.`);
+    switch (subcommand) {
+        case 'list': return list(flags);
+        case 'ingest': return ingest(args[0], flags);
+        case 'delete': return del(args[0], flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi storage --help" for a list of valid subcommands.`);
+    }
 }

package/dist/commands/update.d.ts

@@ -1,4 +1,5 @@
+import type { Flags } from '../helpers.js';
 export declare function checkForUpdate(currentVersion: string): Promise<void>;
-export declare function update(flags?: Record<string, string | boolean>): Promise<void>;
+export declare function update(flags?: Flags): Promise<void>;
 export declare function latestVersion(): Promise<string | null>;
 export declare function isNewer(latest: string, current: string): boolean;

package/dist/commands/url.js

@@ -12,18 +12,30 @@ export async function shorten(targetUrl, flags) {
     else
         success(`Shortened URL: ${res.short_url}\nCode: ${res.short_code}`);
 }
+// ── Dispatcher ───────────────────────────────────────────────────────────────
+const SUBCOMMAND_USAGE = {
+    'shorten': 'myapi url shorten <url> [--org <id>] [--json]',
+};
 export async function run(subcommand, args, flags) {
     if (!subcommand || (flags.help && !subcommand)) {
-        info('Usage: myapi url <subcommand>\n\nSubcommands:\n  shorten    Shorten a long URL\n\nNote: All url commands require the --org <id> flag.');
+        info(`Usage: myapi url <subcommand>
+
+Subcommands:
+  shorten    Shorten a long URL (returns a myurlto.com link)
+
+All commands accept --org <id> (or set default: myapi config set-org <id>).`);
         return;
     }
     if (flags.help) {
-        if (subcommand === 'shorten')
-            info('Usage: myapi url shorten <url> --org <id> [--json]\n\nShortens a long URL and returns the compact myurlto.com link.');
+        const usage = SUBCOMMAND_USAGE[subcommand];
+        if (usage)
+            info(`Usage: ${usage}`);
+        else
+            info(`Unknown subcommand: ${subcommand}. Run "myapi url --help" for the list.`);
         return;
     }
-    if (subcommand === 'shorten')
-        await shorten(args[0], flags);
-    else
-        error(`Unknown subcommand: ${subcommand}. Run "myapi url --help" for a list of valid subcommands.`);
+    switch (subcommand) {
+        case 'shorten': return shorten(args[0], flags);
+        default: error(`Unknown subcommand: ${subcommand}. Run "myapi url --help" for a list of valid subcommands.`);
+    }
 }

package/dist/commands/webhook.d.ts

@@ -1,5 +1,8 @@
-export declare function list(flags: Record<string, string | boolean>): Promise<void>;
-export declare function create(flags: Record<string, string | boolean>): Promise<void>;
-export declare function del(id: string, flags: Record<string, string | boolean>): Promise<void>;
-export declare function delivery(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>;
+import type { FlagSchema } from '../flags.js';
+import { type Flags } from '../helpers.js';
+export declare const SCHEMA: FlagSchema;
+export declare function list(flags: Flags): Promise<void>;
+export declare function create(flags: Flags): Promise<void>;
+export declare function del(id: string, flags: Flags): Promise<void>;
+export declare function delivery(id: string, flags: Flags): Promise<void>;
+export declare function run(subcommand: string | undefined, args: string[], flags: Flags): Promise<void>;