@neta-art/cohub-cli 10.11.1 → 10.12.0

package/README.md

@@ -496,6 +496,15 @@ cohub apps versions <appId> --json
 cohub apps rm <appId> --yes
 ```
 
+Bind a custom domain to a published public App. The binding costs a one-time $5, charged when the domain goes live; `add` prints the CNAME and TXT records to create at the DNS provider:
+
+```bash
+cohub apps domains add <app> app.example.com --yes
+cohub apps domains ls <app>
+cohub apps domains check <app> app.example.com
+cohub apps domains rm <app> app.example.com --yes
+```
+
 Resolve a published App by public identity:
 
 ```bash

package/dist/commands/app-domains.d.ts

@@ -0,0 +1,2 @@
+import type { Command } from "commander";
+export declare function registerAppDomains(appsCmd: Command): void;

package/dist/commands/app-domains.js

@@ -0,0 +1,133 @@
+import { normalizeAppDomainHostname } from "@neta-art/cohub";
+import { createClient } from "../client.js";
+import { getAppByRef } from "../app-ref.js";
+import { error, handleHttp, json as outJson, jsonRequested, ok, table } from "../output.js";
+async function confirm(question, opts, hint) {
+    if (opts.yes)
+        return;
+    if (!process.stdin.isTTY || !process.stdout.isTTY)
+        return error("Confirmation required", hint);
+    process.stdout.write(`${question} [y/N] `);
+    const chunks = [];
+    for await (const chunk of process.stdin) {
+        chunks.push(chunk);
+        break;
+    }
+    const answer = Buffer.concat(chunks).toString().trim().toLowerCase();
+    if (answer !== "y" && answer !== "yes")
+        return error("Cancelled");
+}
+async function findDomain(client, appId, ref) {
+    const { domains } = await client.apps.listDomains(appId);
+    const target = normalizeAppDomainHostname(ref) ?? ref.trim().toLowerCase();
+    const domain = domains.find((item) => item.id === ref || item.hostname === target);
+    return domain ?? error(`Domain not found: ${ref}`, "Run `cohub apps domains ls <app>` to see the App's domains.");
+}
+const info = (message) => console.log(message);
+function printDomain(domain) {
+    table([{
+            hostname: domain.hostname,
+            status: domain.status,
+            certificate: domain.certificateStatus ?? "-",
+            error: domain.error?.message ?? "",
+        }], [
+        { key: "hostname", label: "Hostname" },
+        { key: "status", label: "Status" },
+        { key: "certificate", label: "Certificate" },
+        { key: "error", label: "Error" },
+    ]);
+    if (domain.status === "active")
+        return;
+    info("Add these DNS records at your DNS provider:");
+    table(domain.dnsRecords.map((record) => ({
+        ...record,
+        state: record.satisfied === true ? "ok" : record.satisfied === false ? "missing" : "-",
+    })), [
+        { key: "type", label: "Type" },
+        { key: "name", label: "Name" },
+        { key: "value", label: "Value" },
+        { key: "state", label: "State" },
+    ]);
+}
+export function registerAppDomains(appsCmd) {
+    const domainsCmd = appsCmd.command("domains").description("Custom domains for published Apps");
+    domainsCmd
+        .command("list <app>")
+        .alias("ls")
+        .description("List the App's custom domains")
+        .option("--json", "Output as JSON")
+        .action(async (appRef, opts) => {
+        const client = createClient();
+        try {
+            const detail = await getAppByRef(client, appRef);
+            const result = await client.apps.listDomains(detail.app.id);
+            if (jsonRequested(opts))
+                return outJson(result);
+            if (!result.enabled && result.domains.length === 0)
+                return info("Custom domains are not enabled on this deployment.");
+            if (result.domains.length === 0)
+                return info(`No custom domain. Add one with \`cohub apps domains add ${appRef} <hostname>\` ($${result.priceUsd}, one-time).`);
+            result.domains.forEach(printDomain);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    domainsCmd
+        .command("add <app> <hostname>")
+        .description("Bind a custom domain; charged once when it goes live")
+        .option("-y, --yes", "Confirm the one-time charge")
+        .option("--json", "Output as JSON")
+        .action(async (appRef, hostname, opts) => {
+        const client = createClient();
+        try {
+            const detail = await getAppByRef(client, appRef);
+            const { priceUsd } = await client.apps.listDomains(detail.app.id);
+            await confirm(`Binding ${hostname} costs $${priceUsd}, charged once when the domain goes live. Continue?`, opts, `Pass --yes to accept the one-time $${priceUsd} charge.`);
+            const { domain } = await client.apps.addDomain(detail.app.id, hostname);
+            if (jsonRequested(opts))
+                return outJson(domain);
+            ok(`Domain added: ${domain.hostname}`);
+            printDomain(domain);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    domainsCmd
+        .command("check <app> <domain>")
+        .description("Check DNS and certificate status now")
+        .option("--json", "Output as JSON")
+        .action(async (appRef, domainRef, opts) => {
+        const client = createClient();
+        try {
+            const detail = await getAppByRef(client, appRef);
+            const target = await findDomain(client, detail.app.id, domainRef);
+            const { domain } = await client.apps.checkDomain(detail.app.id, target.id);
+            if (jsonRequested(opts))
+                return outJson(domain);
+            printDomain(domain);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+    domainsCmd
+        .command("rm <app> <domain>")
+        .alias("remove")
+        .description("Remove a custom domain")
+        .option("-y, --yes", "Confirm removal")
+        .action(async (appRef, domainRef, opts) => {
+        const client = createClient();
+        try {
+            const detail = await getAppByRef(client, appRef);
+            const target = await findDomain(client, detail.app.id, domainRef);
+            await confirm(`Remove ${target.hostname}? The one-time charge is not refunded.`, opts, "Pass --yes to remove the domain.");
+            const result = await client.apps.removeDomain(detail.app.id, target.id);
+            ok(result.domain ? `Removing ${target.hostname}; its certificate is being released` : `Domain removed: ${target.hostname}`);
+        }
+        catch (e) {
+            handleHttp(e);
+        }
+    });
+}

package/dist/commands/apps.js

@@ -9,6 +9,7 @@ import { getAppByRef, parseAppRef } from "../app-ref.js";
 import { checkAppTarget } from "../app-target.js";
 import { putBytes, putLocalFile } from "../http-put.js";
 import { registerAppCommerce } from "./app-commerce.js";
+import { registerAppDomains } from "./app-domains.js";
 import { collectPublicUpload } from "./public.js";
 const APP_STATUSES = ["published", "disabled"];
 const APP_VISIBILITIES = ["public", "space"];
@@ -722,6 +723,7 @@ export function registerApps(program) {
         }
     });
     registerAppCommerce(appsCmd);
+    registerAppDomains(appsCmd);
     // ── Viewer grants ─────────────────────────────────────────────────────────
     appsCmd
         .command("authorize <app>")

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@neta-art/cohub-cli",
-  "version": "10.11.1",
+  "version": "10.12.0",
   "description": "CLI for Cohub — spaces, sessions, and agent collaboration.",
   "type": "module",
   "engines": {
@@ -18,7 +18,7 @@
     "NOTICE"
   ],
   "dependencies": {
-    "@neta-art/cohub": "12.4.0",
+    "@neta-art/cohub": "12.5.0",
     "@neta-art/generation": "^0.1.40",
     "commander": "^15.0.0",
     "sharp": "^0.35.4",