@myapihq/cli 1.0.61 → 1.0.65

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

@@ -0,0 +1,83 @@
+---
+name: my-domain-api
+description: >
+  Register new domains, check availability and pricing, import existing domains, and manage edge settings. Use this before creating mailboxes or funnels — both require an owned domain.
+---
+
+# MyDomainAPI Skill
+
+## Quick Start
+1. `GET /domain/orgs/{org_id}/list?filter=all` — lists domains owned by your account. `filter` can be `all`, `unassigned`, or `org` (default).
+2. `GET /domain/orgs/{org_id}/check/available/{domain}` — confirm availability and price.
+3. `POST /domain/orgs/{org_id}/register` with `domain` and optional `years`.
+4. Proceed to `my-email-api` for mailboxes or `my-funnel-api` for a website.
+
+DNS is fully managed by the platform — enabling seamless email deliverability, tracking pixel, and edge delivery integration. Manual DNS record management is not exposed.
+
+## Dependencies & Backlinks
+- **Auth & Billing:** 401/402 → fall back to `my-api-hq`.
+- **Next Steps:** After registration → `my-email-api` for mailboxes or `my-funnel-api` for a website.
+
+## Authentication
+`Authorization: Bearer <api_key>` (from `my-api-hq`).
+
+## Endpoints
+
+### Check Availability
+```
+GET /domain/orgs/{org_id}/check/available/{domain}
+→ { "available": true, "price_cents": 1200 }
+```
+Errors: `400` INVALID_DOMAIN, TLD_NOT_SUPPORTED.
+
+### Register Domain
+```
+POST /domain/orgs/{org_id}/register
+{ "domain": "example.com", "years": 1 }
+→ { "domain": "...", "status": "provisioning", "domain_id": "..." }
+```
+Errors: `400` invalid request, INVALID_DOMAIN, TLD_NOT_SUPPORTED · `409` DOMAIN_ALREADY_OWNED, DOMAIN_UNAVAILABLE · `402` INSUFFICIENT_BALANCE (includes `required_cents`) or UPGRADE_REQUIRED (free account) · `403` `already_owned` flag is not permitted.
+
+### Import Existing Domain
+```
+POST /domain/orgs/{org_id}/import
+{ "domain": "example.com", "namecheap_api_user": "optional", "namecheap_api_key": "optional" }
+```
+Sets up DNS and email infrastructure automatically. Optionally updates Namecheap NS if credentials are provided.
+Errors: `402` insufficient balance.
+
+To use Namecheap automation: go to **Profile > Tools > Namecheap API Access**, generate an API Key, and whitelist the MyAPI-HQ server IP — otherwise the API calls will be rejected.
+
+### List & Status
+```
+GET /domain/orgs/{org_id}/list
+GET /domain/orgs/{org_id}/{domain}/status
+```
+Errors (status): `404` DOMAIN_NOT_FOUND.
+
+### Assign / Unassign Domain
+```
+POST /domain/orgs/{org_id}/{domain}/assign
+{ "org_id": "<target_org_id>" } // Pass null to unassign
+```
+Associates a domain already in the account with a specific organization, or removes it from its current organization if `org_id` is null.
+Errors: `404` DOMAIN_NOT_FOUND · `422` ORG_NOT_FOUND.
+
+### Edge Settings
+
+**Update:**
+```
+POST /domain/orgs/{org_id}/{domain}/settings
+{
+  "security_level": "essentially_off",  // essentially_off | medium | high | under_attack
+  "browser_check": "off",               // on | off
+  "purge_cache": true
+}
+```
+*To allow AI training bots and crawlers: set `security_level: "essentially_off"` and `browser_check: "off"`.*
+
+**Get:**
+```
+GET /domain/orgs/{org_id}/{domain}/settings
+→ { "domain": "...", "security_level": "...", "browser_check": "...", "ai_bots_protection": "disabled", "is_robots_txt_managed": false }
+```

package/dist/skills/my-domain-api/claude/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "my-domain-api",
+  "description": "Domain registration and check with automated DNS and email infrastructure.",
+  "version": "1.0.0",
+  "published": true
+}

package/dist/skills/my-funnel-api/README.md

@@ -0,0 +1,39 @@
+# my-funnel-api
+
+Host multi-page sites and funnels by pushing raw HTML or using AI to plan, build, and edit complete funnels. Handles routing, edge delivery, webhook wiring, link/workflow verification, and lead management.
+
+## What it does
+
+- Create and host multi-page funnels from raw HTML
+- AI-assisted funnel generation and editing
+- Edge delivery on your domain
+- Lead capture and management
+- Webhook and workflow integration
+
+## Quickstart
+
+```bash
+# Create a funnel page
+curl -sS -X POST https://myfunnelapi.com/funnel/page \
+  -H "Authorization: Bearer $MYAPI_KEY" \
+  -H "Content-Type: application/json" \
+  -d '{
+    "org_id": "<org_id>",
+    "domain": "yourdomain.com",
+    "slug": "/",
+    "html": "<html>...</html>"
+  }'
+```
+
+## Authentication
+
+```
+Authorization: Bearer <api_key>
+```
+
+Requires `org_id` and an owned domain from `my-domain-api`.
+
+## Links
+
+- [Full skill documentation (SKILL.md)](./SKILL.md)
+- [MyFunnelAPI](https://myfunnelapi.com)

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

@@ -0,0 +1,35 @@
+---
+name: my-funnel-api:funnel
+description: >
+  A lean CRUD and CDN Publishing API. Manage funnel configurations, push raw HTML pages, and deploy static assets to the edge KV.
+---
+
+# MyFunnelAPI Skill
+
+## 1. Funnel Management (Authenticated)
+These endpoints manage the database records and structural configuration of funnels.
+
+- `GET /funnel/orgs/{org_id}/funnels`
+  Lists all funnels for the specified organization.
+- `POST /funnel/orgs/{org_id}/funnels`
+  Creates a new funnel entry. Expects basic configuration metadata (name, domain, etc.). Body: `{ "domain": "example.com" }`
+- `GET /funnel/orgs/{org_id}/funnels/{id}`
+  Retrieves the metadata and configuration details of a specific funnel.
+- `DELETE /funnel/orgs/{org_id}/funnels/{id}`
+  Deletes a funnel from the database and automatically purges all of its preview and published pages from the edge KV cache.
+
+## 2. Publishing & Edge Deployment (Authenticated)
+These endpoints interact with the edge KV cache to push HTML/JS content to the edge domains. As soon as you push a page, it is live.
+
+- `POST /funnel/orgs/{org_id}/funnels/{id}/push-page`
+  Deploys raw HTML to a specific slug on the live funnel (e.g., pushing custom HTML to /contact). Body: `{"slug": "/route", "html": "..."}`.
+- `POST /funnel/orgs/{org_id}/funnels/{id}/verify`
+  Pre-publish verification. Validates syntax and structure of raw HTML or an existing page slug.
+
+## 3. Public Proxies (Unauthenticated)
+These endpoints are called directly by the end-users' browsers (via the deployed static HTML). They do not require API keys. They are stateless and act as routing proxies to the Webhook API.
+
+- `POST /funnel/funnels/{id}/submit/{slug...}`
+  The endpoint for HTML form submissions. Validates the JSON payload, returns a 200 OK to the browser, and asynchronously POSTs the data to the organization's matching webhook (or fallback webhook).
+- `POST /funnel/funnels/{id}/event`
+  The endpoint for analytics and tracking scripts. Proxies click events, pageviews, and pixel tracking data to the configured webhook endpoints. Includes built-in rate limiting (max 60 req/min per funnel).

package/dist/skills/my-funnel-api/claude/.claude-plugin/plugin.json

@@ -0,0 +1,6 @@
+{
+  "name": "my-funnel-api",
+  "description": "Build multi-page sites and funnels with headless HTML upload.",
+  "version": "1.0.0",
+  "published": true
+}

package/package.json

@@ -1,8 +1,11 @@
 {
   "name": "@myapihq/cli",
-  "version": "1.0.61",
+  "version": "1.0.65",
   "description": "MyAPI command-line interface",
   "type": "module",
+  "files": [
+    "dist"
+  ],
   "main": "dist/index.js",
   "bin": {
     "myapi": "dist/index.js"

package/scripts/copy-skills.js

@@ -1,13 +0,0 @@
-#!/usr/bin/env node
-// Skills are not bundled in the CLI package for now.
-import { existsSync, rmSync, mkdirSync } from 'fs';
-import { join, dirname } from 'path';
-import { fileURLToPath } from 'url';
-
-const __dirname = dirname(fileURLToPath(import.meta.url));
-const dest = join(__dirname, '..', 'src', 'skills');
-
-if (existsSync(dest)) rmSync(dest, { recursive: true, force: true });
-mkdirSync(dest, { recursive: true });
-
-console.log('copy-skills: no skills bundled.');

package/src/commands/auth.ts

@@ -1,190 +0,0 @@
-import * as readline from 'readline';
-
-import { loadConfig, saveConfig, addAccount, switchAccount, listAccounts } from '../config.js';
-import { info, success, error, printJson } from '../output.js';
-import { installSkills } from './setup.js';
-import { hq } from '@myapihq/sdk';
-
-const API_BASE = process.env.MYAPI_API_BASE ?? 'https://api.myapihq.com';
-
-function ask(rl: readline.Interface, q: string): Promise<string> {
-  return new Promise(resolve => rl.question(q, resolve));
-}
-
-function yn(answer: string, defaultYes = true): boolean {
-  const t = answer.trim().toLowerCase();
-  if (t === '') return defaultYes;
-  return t === 'y' || t === 'yes';
-}
-
-async function post(path: string, body: unknown, apiKey?: string): Promise<unknown> {
-  const headers: Record<string, string> = { 'Content-Type': 'application/json' };
-  if (apiKey) headers['Authorization'] = `Bearer ${apiKey}`;
-  const res = await fetch(`${API_BASE}${path}`, {
-    method: 'POST',
-    headers,
-    body: JSON.stringify(body),
-  });
-  const json = await res.json() as { data?: unknown; error?: string };
-  if (!res.ok) throw new Error(json.error ?? `HTTP ${res.status}`);
-  return json.data ?? json;
-}
-
-async function patch(path: string, body: unknown, apiKey: string): Promise<unknown> {
-  const res = await fetch(`${API_BASE}${path}`, {
-    method: 'PATCH',
-    headers: { 'Content-Type': 'application/json', Authorization: `Bearer ${apiKey}` },
-    body: JSON.stringify(body),
-  });
-  const json = await res.json() as { data?: unknown; error?: string };
-  if (!res.ok) throw new Error(json.error ?? `HTTP ${res.status}`);
-  return json.data ?? json;
-}
-
-// myapi auth link — upgrade anonymous session to registered account.
-export async function link(flags: Record<string, string | boolean> = {}, emailArg?: string) {
-  if (flags.help) {
-    info('Usage: myapi auth link [email]\n\nAttaches a verified email to your current anonymous account, converting it into\na registered account. A one-time code will be sent to the email to confirm.\n\nIf that email already belongs to an existing MyAPI account, you will be signed\ninto that account instead — it is added as a second active session alongside\nyour current one.\n\nTo create a brand-new account from scratch, use: myapi auth setup');
-    return;
-  }
-  const config = loadConfig();
-  if (!config?.api_key) error('Not configured. Run: myapi auth setup');
-  if (!config!.is_anonymous) error('Already registered. Use your existing account.');
-
-  const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-  try {
-    const email = emailArg || (await ask(rl, '› Email? ')).trim();
-    if (!/^[^\s@]+@[^\s@]+\.[^\s@]+$/.test(email)) error(`Invalid email address: "${email}".`);
-
-    let upgradeOk = true;
-    try {
-      await patch('/hq/account/upgrade', { email }, config!.api_key);
-    } catch (err: any) {
-      if (err.message !== 'EMAIL_TAKEN') throw err;
-      upgradeOk = false;
-      info(`› That email already has an account — accounts cannot be merged.`);
-      info(`› Your anonymous account will be kept and you can switch back to it anytime.`);
-      const ans = (await ask(rl, '› Sign in and add it as a second account? (Y/n) ')).trim();
-      if (!yn(ans)) return;
-      await post('/hq/account/send-code', { 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 }) as {
-      api_key: string;
-      account_id: string;
-      default_org: string;
-      default_funnel: string;
-    };
-
-    const skillsFromFlag = flags['install-skills'] ? true : flags['no-skills'] ? false : null;
-    const wantsSkills = skillsFromFlag !== null ? skillsFromFlag : yn((await ask(rl, '› Install the MyAPI skills pack? (Y/n) ')).trim());
-
-    if (upgradeOk) {
-      saveConfig({
-        ...config!,
-        api_key: data.api_key,
-        account_id: data.account_id,
-        email,
-        default_org: data.default_org || config!.default_org,
-        default_funnel: data.default_funnel || config!.default_funnel,
-        is_anonymous: false,
-        skills_installed: wantsSkills,
-      });
-      success(`› Welcome! Account upgraded · ${email}`);
-    } else {
-      const idx = addAccount({
-        api_key: data.api_key,
-        account_id: data.account_id,
-        email,
-        default_org: data.default_org,
-        default_funnel: data.default_funnel,
-        is_anonymous: false,
-        skills_installed: wantsSkills,
-      });
-      success(`› Signed in · ${email} (account #${idx + 1})`);
-      info(`› Use "myapi auth switch" to toggle between accounts.`);
-    }
-
-    if (wantsSkills) await installSkills();
-  } finally {
-    rl.close();
-  }
-}
-
-// myapi auth whoami — show current session info.
-export async function whoami(flags: Record<string, string | boolean> = {}) {
-  if (flags.help) {
-    info('Usage: myapi auth whoami [--json]\n\nDisplays the active account details: email, account ID, default org, default funnel, account type, and current balance.\n\nFlags:\n  --json   Output raw JSON');
-    return;
-  }
-  const config = loadConfig();
-  if (!config?.api_key) error('Not configured. Run: myapi auth setup');
-
-  let balance: { balance_display: string; credits_display: string } | null = null;
-  try {
-    balance = await hq.getBalance(config!.api_key);
-  } catch {}
-
-  if (flags.json) {
-    printJson({
-      email: config!.email ?? null,
-      account_id: config!.account_id,
-      default_org: config!.default_org ?? null,
-      default_funnel: config!.default_funnel ?? null,
-      is_anonymous: config!.is_anonymous ?? false,
-      balance: balance?.balance_display ?? null,
-      credits: balance?.credits_display ?? null,
-    });
-    return;
-  }
-
-  if (config!.email) info(`Email:    ${config!.email}`);
-  info(`Account:  ${config!.account_id}`);
-  info(`Org:      ${config!.default_org ?? '(none)'}`);
-  info(`Funnel:   ${config!.default_funnel ?? '(none)'}`);
-  info(`Type:     ${config!.is_anonymous ? 'anonymous' : 'registered'}`);
-  info(`Balance:  ${balance ? `${balance.balance_display}  |  Credits: ${balance.credits_display} (not usable for domains)` : '(unavailable)'}`);
-}
-
-// myapi auth switch [index] — switch between saved accounts.
-export async function switchCmd(flags: Record<string, string | boolean> = {}, indexArg?: string) {
-  if (flags.help) {
-    info('Usage: myapi auth switch [index]\n\nSwitches the active account. Pass an account index to skip the prompt.\n\nExample:\n  myapi auth switch 2');
-    return;
-  }
-  const accounts = listAccounts();
-  if (accounts.length === 0) error('No accounts configured. Run: myapi auth setup');
-  if (accounts.length === 1) {
-    info(`Only one account configured: ${accounts[0].email ?? accounts[0].account_id}`);
-    info('To add another account, run: myapi auth setup');
-    return;
-  }
-
-  info('Accounts:');
-  for (const a of accounts) {
-    const label = a.email ?? (a.is_anonymous ? `anonymous · ${a.account_id.slice(0, 8)}` : a.account_id.slice(0, 8));
-    const marker = a.active ? ' ◀ active' : '';
-    info(`  ${a.index + 1}. ${label}${marker}`);
-  }
-
-  let idxStr = indexArg ?? '';
-  if (!idxStr) {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    try {
-      idxStr = (await ask(rl, `› Switch to account (1-${accounts.length})? `)).trim();
-    } finally {
-      rl.close();
-    }
-  }
-  const idx = parseInt(idxStr, 10) - 1;
-  if (isNaN(idx) || idx < 0 || idx >= accounts.length) {
-    error('Invalid selection.');
-  }
-  if (switchAccount(idx)) {
-    const a = accounts[idx];
-    success(`› Switched to ${a.email ?? a.account_id}`);
-  }
-}

package/src/commands/billing.ts

@@ -1,92 +0,0 @@
-import * as readline from 'readline';
-import { hq } from '@myapihq/sdk';
-import { requireConfig } from '../config.js';
-import { success, error, printTable, info, printJson } from '../output.js';
-import { formatDate } from '../utils.js';
-
-export async function balance(flags: Record<string, string | boolean>) {
-  if (flags.help) {
-    info('Usage: myapi billing balance [--json]\n\nShows your current account balance, credits, and payment method status.\n\nFlags:\n  --json   Output raw JSON');
-    return;
-  }
-  const config = requireConfig();
-  const result = await hq.getBalance(config.api_key);
-
-  if (flags.json) {
-    printJson({
-      balance: result.balance_display,
-      credits: result.credits_display,
-      has_payment_method: result.has_payment_method,
-    });
-    return;
-  }
-
-  const pm = result.has_payment_method ? 'yes' : 'no';
-  const accountType = config.is_anonymous ? 'anonymous' : `registered (${config.email ?? ''})`;
-  info(`Account: ${accountType}`);
-  info(`Balance: ${result.balance_display}  |  Credits: ${result.credits_display} (not usable for domains)  |  Payment method: ${pm}`);
-}
-
-export async function history(flags: Record<string, string | boolean>) {
-  if (flags.help) {
-    info('Usage: myapi billing history [--json]\n\nShows your recent billing transactions and top-ups.\n\nFlags:\n  --json   Output raw JSON');
-    return;
-  }
-  const config = requireConfig();
-  const items = await hq.getBillingHistory(config.api_key);
-
-  if (flags.json) {
-    printJson(items);
-    return;
-  }
-
-  if (items.length === 0) {
-    info('No transactions yet.');
-    return;
-  }
-
-  const formattedItems = items.map(item => ({
-    Type: item.type || 'unknown',
-    Amount: item.amount_display,
-    Status: item.status ? item.status.charAt(0).toUpperCase() + item.status.slice(1) : '',
-    Date: formatDate(item.created_at),
-  }));
-
-  printTable(formattedItems as unknown as Record<string, unknown>[]);
-}
-
-export async function topup(amountStr: string, flags: Record<string, string | boolean>) {
-  if (flags.help) {
-    info('Usage: myapi billing topup <amount>\n\nAmount is in whole dollars (e.g. "10" charges $10).\nConfirmation is required for amounts of $50 or more. Use --yes to skip it.\nExample: myapi billing topup 10\n\nFlags:\n  --yes   Skip confirmation prompt for large amounts');
-    return;
-  }
-  const amount = Math.round(parseFloat(amountStr));
-  if (!amountStr || isNaN(amount) || amount <= 0) {
-    error("Amount must be a positive whole number of dollars (e.g. myapi billing topup 10)");
-    return;
-  }
-
-  if (!flags.yes && !flags.y && amount >= 50) {
-    const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
-    const ans = await new Promise<string>(resolve => rl.question(`› Charge $${amount} to your saved payment method? (y/N) `, resolve));
-    rl.close();
-    if (ans.trim().toLowerCase() !== 'y' && ans.trim().toLowerCase() !== 'yes') {
-      info('Cancelled.');
-      return;
-    }
-  }
-
-  const config = requireConfig();
-  const result = await hq.topUp(config.api_key, amount);
-  success(`Top up successful! New balance: ${result.new_balance_display}`);
-}
-
-export async function setup(flags: Record<string, string | boolean>) {
-  if (flags.help) {
-    info('Usage: myapi billing setup\n\nGenerates a secure checkout link to add or update your payment method.');
-    return;
-  }
-  const config = requireConfig();
-  const result = await hq.setupPayment(config.api_key);
-  success(`Open this URL in your browser to set up payment:\n${result.url}`);
-}

package/src/commands/config.ts

@@ -1,71 +0,0 @@
-import { hq, funnel as sdkFunnel } from '@myapihq/sdk';
-import { requireConfig, saveConfig } from '../config.js';
-import { success, error, info } from '../output.js';
-
-const UUID_RE = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
-
-export async function setOrg(id: string, flags: Record<string, string | boolean>) {
-  if (!id || flags.help) {
-    info("Usage: myapi config set-org <id>\n\nSets a default organization ID for subsequent commands.");
-    return;
-  }
-  if (!UUID_RE.test(id)) error(`Invalid organization ID: "${id}". Expected a UUID (e.g. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).`);
-  const config = requireConfig();
-  info('› Validating…');
-  const org = await hq.getOrg(config.api_key, id);
-  config.default_org = org.id;
-  saveConfig(config);
-  success(`Default organization set to: ${org.name || org.id}`);
-}
-
-export async function setFunnel(id: string, flags: Record<string, string | boolean>) {
-  if (!id || flags.help) {
-    info("Usage: myapi config set-funnel <id>\n\nSets a default funnel ID for subsequent commands.");
-    return;
-  }
-  if (!UUID_RE.test(id)) error(`Invalid funnel ID: "${id}". Expected a UUID (e.g. xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx).`);
-  const config = requireConfig();
-  const orgId = config.default_org;
-  if (!orgId) error('No default organization set. Run: myapi auth config set-org <id>');
-  info('› Validating…');
-  const funnel = await sdkFunnel.getFunnel(config.api_key, orgId, id);
-  config.default_funnel = funnel.id;
-  saveConfig(config);
-  success(`Default funnel set to: ${funnel.id}`);
-}
-
-export async function setDomain(domain: string, flags: Record<string, string | boolean>) {
-  if (!domain || flags.help) {
-    info("Usage: myapi config set-domain <domain>\n\nSets a default domain for subsequent commands.");
-    return;
-  }
-  const config = requireConfig();
-  config.default_domain = domain;
-  saveConfig(config);
-  success(`Default domain set to: ${domain}`);
-}
-
-export async function view(flags: Record<string, string | boolean>) {
-  if (flags.help) {
-     info("Usage: myapi config view\n\nViews current config settings.");
-     return;
-  }
-  const config = requireConfig();
-  info(`Default Org:    ${config.default_org || 'Not set'}`);
-  info(`Default Funnel: ${config.default_funnel || 'Not set'}`);
-  info(`Default Domain: ${config.default_domain || 'Not set'}`);
-}
-
-export async function run(subcommand: string | undefined, args: string[], flags: Record<string, string | boolean>) {
-  const via = (flags._via as string) || 'auth config';
-  if (!subcommand || (flags.help && !subcommand)) {
-    info(`Usage: myapi ${via} <subcommand>\n\nSubcommands:\n  view         View current config\n  set-org      Set default organization\n  set-funnel   Set default funnel\n  set-domain   Set default domain`);
-    return;
-  }
-  
-  if (subcommand === 'view') await view(flags);
-  else if (subcommand === 'set-org') await setOrg(args[0], flags);
-  else if (subcommand === 'set-funnel') await setFunnel(args[0], flags);
-  else if (subcommand === 'set-domain') await setDomain(args[0], flags);
-  else error(`Unknown subcommand: ${subcommand}. Run "myapi config --help" for a list of valid subcommands.`);
-}