@mcpcloud/cli 0.8.0-next-20260701231709 → 0.9.1

package/dist/index.js

@@ -8816,6 +8816,210 @@ function registerApiKeyCommands(program2) {
   }));
 }
 
+// src/commands/domains-namespaces.ts
+var NAMESPACE_STATUS_LABELS = {
+  pending_verification: "verifying",
+  verified: "verified",
+  removed: "removed"
+};
+function printNamespaceRecords(namespace) {
+  printInfo(`Create these DNS records once for ${namespace.parentDomain} — every future subdomain is then covered:`);
+  const rows = [
+    {
+      type: "TXT",
+      name: namespace.verificationTxt.name,
+      value: namespace.verificationTxt.value
+    }
+  ];
+  if (namespace.wildcardCname) {
+    rows.push({
+      type: "CNAME",
+      name: namespace.wildcardCname.name,
+      value: namespace.wildcardCname.value
+    });
+  }
+  printList(rows, [
+    { key: "type", label: "Type", width: 6 },
+    { key: "name", label: "Name", width: 44 },
+    { key: "value", label: "Value", width: 44 }
+  ], rows);
+}
+function registerDomainNamespaceCommands(domains) {
+  const namespaces = domains.command("namespaces").description("Verify a parent domain once, then attach subdomains to any server with no further DNS work");
+  namespaces.command("list").description("List the domain namespaces in an organization").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.get("/api/v1/domains/namespaces", { organization_id: organizationId });
+    printList(data.namespaces.map((namespace) => ({
+      parent: namespace.parentDomain,
+      status: NAMESPACE_STATUS_LABELS[namespace.status],
+      wildcard: namespace.wildcardConfigured ? "configured" : "—",
+      verified: namespace.verifiedAt ? formatDate(namespace.verifiedAt) : "—"
+    })), [
+      { key: "parent", label: "Parent domain", width: 32 },
+      { key: "status", label: "Status", width: 12 },
+      { key: "wildcard", label: "Wildcard", width: 12 },
+      { key: "verified", label: "Verified", width: 22 }
+    ], data);
+  }));
+  namespaces.command("add <parentDomain>").description("Register a domain namespace and print its one-time DNS records (admin role required)").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (parentDomain, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const namespace = await api.post("/api/v1/domains/namespaces", { organizationId, parentDomain });
+    if (isJsonMode()) {
+      printJson(namespace);
+      return;
+    }
+    printSuccess(`${namespace.parentDomain} namespace added.`);
+    printNamespaceRecords(namespace);
+    printInfo("Verification runs automatically — or run `mcp domains namespaces verify <parentDomain>` to check now.");
+  }));
+  namespaces.command("verify <parentDomain>").description("Check the namespace verification records now").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (parentDomain, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.post("/api/v1/domains/namespaces/verify", {
+      organizationId,
+      parentDomain
+    });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    if (data.verified) {
+      printSuccess(`${data.namespace.parentDomain} is verified. Attach subdomains with \`mcp domains add <label>.${data.namespace.parentDomain} --server <id>\`.`);
+    } else {
+      printInfo(data.error ?? "Not verified yet — DNS may still be propagating.");
+      printNamespaceRecords(data.namespace);
+    }
+  }));
+  namespaces.command("remove <parentDomain>").description("Remove a domain namespace — existing attached hostnames keep working (admin role required)").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (parentDomain, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.delete("/api/v1/domains/namespaces", { organizationId, parentDomain });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    printSuccess(`${parentDomain} namespace removed. Hostnames already attached under it keep serving.`);
+  }));
+}
+
+// src/commands/domains.ts
+var STATUS_LABELS = {
+  pending_verification: "verifying dns",
+  pending_cert: "issuing certificate",
+  active: "active",
+  failed: "attention needed",
+  removed: "removed"
+};
+function printDnsRecords(domain, cnameTarget) {
+  printInfo(`Create these DNS records for ${domain.hostname}:`);
+  const rows = [
+    { type: "CNAME", name: domain.hostname, value: cnameTarget }
+  ];
+  if (domain.ownershipVerification) {
+    rows.push({
+      type: "TXT",
+      name: domain.ownershipVerification.name,
+      value: domain.ownershipVerification.value
+    });
+  }
+  for (const record of domain.certificateValidationRecords) {
+    rows.push({ type: "TXT", name: record.name, value: record.value });
+  }
+  printList(rows, [
+    { key: "type", label: "Type", width: 6 },
+    { key: "name", label: "Name", width: 44 },
+    { key: "value", label: "Value", width: 44 }
+  ], rows);
+}
+function printDomainStatus(domain) {
+  printKeyValue({
+    hostname: domain.hostname,
+    status: STATUS_LABELS[domain.status],
+    url: domain.status === "active" ? `https://${domain.hostname}/mcp` : "—",
+    "last checked": domain.lastSyncedAt ? formatDate(domain.lastSyncedAt) : "—",
+    ...domain.lastError ? { error: domain.lastError } : {}
+  });
+}
+function registerDomainCommands(program2) {
+  const domains = program2.command("domains").description("Serve servers from custom domains you own (Pro+)");
+  registerDomainNamespaceCommands(domains);
+  domains.command("list").description("List the custom domains in an organization").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.get("/api/v1/domains", {
+      organization_id: organizationId
+    });
+    if (!data.allowed) {
+      printInfo("Bring your own domain requires the Pro plan or higher for this organization.");
+      if (isJsonMode())
+        printJson(data);
+      return;
+    }
+    printList(data.domains.map((domain) => ({
+      hostname: domain.hostname,
+      status: STATUS_LABELS[domain.status],
+      server: domain.serverId,
+      added: formatDate(domain.createdAt)
+    })), [
+      { key: "hostname", label: "Hostname", width: 36 },
+      { key: "status", label: "Status", width: 20 },
+      { key: "server", label: "Server", width: 34 },
+      { key: "added", label: "Added", width: 22 }
+    ], data);
+    if (!isJsonMode()) {
+      printInfo(`${data.used} of ${data.limit === null ? "unlimited" : data.limit} domains used.`);
+    }
+  }));
+  domains.command("add <hostname>").description("Attach a custom domain to a server (admin role required)").requiredOption("--server <serverId>", "Server id to attach the domain to").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.post("/api/v1/domains", {
+      organizationId,
+      serverId: opts.server,
+      hostname: hostname2
+    });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    printSuccess(`${data.domain.hostname} added.`);
+    printDnsRecords(data.domain, data.cnameTarget);
+    printInfo("Verification runs automatically once the records propagate — or run `mcp domains status <hostname>` to check now.");
+  }));
+  domains.command("status <hostname>").description("Recheck a custom domain against Cloudflare and show status").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const domain = await api.post("/api/v1/domains/recheck", { organizationId, hostname: hostname2 });
+    if (isJsonMode()) {
+      printJson(domain);
+      return;
+    }
+    printDomainStatus(domain);
+    if (domain.status === "active") {
+      printSuccess("Domain is verified and serving traffic.");
+    }
+  }));
+  domains.command("remove <hostname>").description("Remove a custom domain — traffic on it stops immediately (admin role required)").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const data = await api.delete("/api/v1/domains", {
+      organizationId,
+      hostname: hostname2
+    });
+    if (isJsonMode()) {
+      printJson(data);
+      return;
+    }
+    printSuccess(`${hostname2} removed. The platform URL is unaffected.`);
+  }));
+  domains.command("transfer <hostname>").description("Move a custom domain to another server without certificate churn (admin role required)").requiredOption("--server <serverId>", "Target server id").option("--org <orgId>", "Organization id (defaults to your default org)").action(runAction(async (hostname2, opts) => {
+    const organizationId = await resolveOrgId(opts.org);
+    const domain = await api.post("/api/v1/domains/transfer", { organizationId, serverId: opts.server, hostname: hostname2 });
+    if (isJsonMode()) {
+      printJson(domain);
+      return;
+    }
+    printSuccess(`${domain.hostname} now serves server ${domain.serverId}.`);
+    if (domain.status === "active") {
+      printInfo("Routing re-pointed — no DNS or certificate changes needed.");
+    }
+  }));
+}
+
 // src/commands/config.ts
 import { homedir as homedir2 } from "node:os";
 import { join as join11 } from "node:path";
@@ -35573,6 +35777,7 @@ function createProgram() {
   registerToolCommands(program2);
   registerSkillCommands(program2);
   registerApiKeyCommands(program2);
+  registerDomainCommands(program2);
   registerDeploymentCommands(program2);
   registerOrgCommands(program2);
   registerUsageCommands(program2);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mcpcloud/cli",
-  "version": "0.8.0-next-20260701231709",
+  "version": "0.9.1",
   "description": "The official CLI for MCPCloud — manage projects, servers, skills, and API keys from the terminal",
   "type": "module",
   "bin": {