@homespunapps/cli 1.6.22 → 1.6.24

package/dist/commands/apps.js

@@ -25,7 +25,7 @@ export async function runApps(args) {
         return;
     }
     if (verb === undefined) {
-        fail("missing verb: homespun apps <list|show|update|share-link|delete|wake|watch>", "invalid_args");
+        fail("missing verb: homespun apps <list|show|update|share-link|delete|wake|watch|domain>", "invalid_args");
     }
     const sub = {
         positionals: args.positionals.slice(1),
@@ -50,8 +50,10 @@ export async function runApps(args) {
             return runWake(sub);
         case "watch":
             return runWatch(sub);
+        case "domain":
+            return runDomain(sub);
         default:
-            fail(`unknown verb '${verb}': homespun apps <list|show|update|share-link|delete|wake|watch>`, "invalid_args");
+            fail(`unknown verb '${verb}': homespun apps <list|show|update|share-link|delete|wake|watch|domain>`, "invalid_args");
     }
 }
 // ---------------------------------------------------------------------------
@@ -383,3 +385,46 @@ async function runWatch(args) {
         /* never resolves — SIGINT or a terminal condition exits */
     });
 }
+// ---------------------------------------------------------------------------
+// `homespun apps domain <show|add|remove> <app> [domain]`
+//
+// Binding a domain is a two-party job: this side creates the certificate and
+// the routing, and the DOMAIN OWNER publishes the DNS records that prove they
+// hold it. `add` therefore prints those records as its whole point, and
+// `show` reprints them for as long as the domain has not gone active.
+// ---------------------------------------------------------------------------
+const DOMAIN_USAGE = "usage: homespun apps domain <show|add|remove> <app> [domain]";
+async function runDomain(args) {
+    const action = args.positionals[0];
+    if (action !== "show" && action !== "add" && action !== "remove") {
+        fail(DOMAIN_USAGE, "invalid_args");
+    }
+    assertKnownFlags(args, ...specFor("apps", "domain"));
+    const appArg = args.positionals[1];
+    if (!appArg)
+        fail(DOMAIN_USAGE, "invalid_args");
+    const domain = args.positionals[2];
+    if (action === "add" && !domain) {
+        fail("usage: homespun apps domain add <app> <domain>", "invalid_args");
+    }
+    const client = makeClient(args);
+    const id = await resolveAppId(client, appArg);
+    try {
+        if (action === "show") {
+            printJson(await client.getAppDomain(id));
+            return;
+        }
+        if (action === "add") {
+            printJson(await client.setAppDomain(id, domain));
+            return;
+        }
+        // remove: a bare `remove` unbinds every domain the app holds, which is
+        // what "remove the custom domain" means to someone who never asked for
+        // aliases. Naming one removes just that binding.
+        await client.deleteAppDomain(id, domain);
+        printJson({ app_id: id, removed: domain ?? "all" });
+    }
+    catch (e) {
+        failFromError(e);
+    }
+}

package/dist/help-catalog.js

@@ -31,7 +31,7 @@ const APPS = {
     noun: "apps",
     tagline: "app lifecycle management",
     group: "app",
-    rootSummary: "App lifecycle: list, show, update, delete, wake, watch (stream the app's change feed as JSON-lines).",
+    rootSummary: "App lifecycle: list, show, update, delete, wake, domain (custom domains), watch (stream the app's change feed as JSON-lines).",
     verbs: [
         {
             verb: "list",
@@ -89,6 +89,11 @@ const APPS = {
             positionals: "<app>",
             summary: "Wakes a dormant app.",
         },
+        {
+            verb: "domain",
+            positionals: "<show|add|remove> <app> [domain]",
+            summary: "Manages the app's custom domains. The first domain added serves the app; later ones redirect to it. `add` prints the DNS records the domain owner must publish. `remove` with no domain unbinds them all.",
+        },
         {
             verb: "watch",
             positionals: "<app>",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homespunapps/cli",
-  "version": "1.6.22",
+  "version": "1.6.24",
   "description": "Command-line client for the Homespun relay: deploy a real multi-user web app from your agent, then keep reading and writing its data.",
   "license": "MIT",
   "type": "module",
@@ -36,7 +36,7 @@
     "test:unit": "vitest run"
   },
   "dependencies": {
-    "@homespunapps/core": "^1.6.22",
+    "@homespunapps/core": "^1.6.24",
     "qrcode-terminal": "^0.12.0"
   },
   "devDependencies": {