@homespunapps/core 1.6.21 → 1.6.23

package/dist/client.d.ts

@@ -360,22 +360,31 @@ export declare class HomespunClient {
         status: string;
     }>;
     /**
-     * POST /v1/apps/:id/domain - bind a custom domain to the app. Returns the
-     * record including `dns_records`: the DNS entries the domain owner must
-     * publish (the routing CNAME plus any Cloudflare validation records).
+     * POST /v1/apps/:id/domain - bind a custom domain to the app. The FIRST
+     * domain bound serves the app; every one after it becomes an alias that
+     * redirects there (`redirect_to`). Returns the record including
+     * `dns_records`: the DNS entries the domain owner must publish (the routing
+     * CNAME plus any Cloudflare validation records).
      */
     setAppDomain(appId: string, domain: string): Promise<AppDomain>;
     /**
-     * GET /v1/apps/:id/domain - the app's domain record, live-refreshed against
-     * Cloudflare when the feature is enabled (status/last_error/last_checked_at
-     * update as a side effect).
+     * GET /v1/apps/:id/domain - the app's SERVING domain at the top level with
+     * its `aliases` beside it, live-refreshed against Cloudflare when the
+     * feature is enabled (status/last_error/last_checked_at update as a side
+     * effect).
      */
     getAppDomain(appId: string): Promise<AppDomain>;
     /**
      * DELETE /v1/apps/:id/domain - remove the domain binding (Cloudflare
      * hostname best-effort + record + quota release). Idempotent.
      */
-    deleteAppDomain(appId: string): Promise<void>;
+    /**
+     * Unbind the app's custom domains. With no `domain` every binding goes;
+     * with one, only that binding, except that removing the primary takes its
+     * aliases with it (an alias pointing at a domain the app no longer holds
+     * would redirect visitors into nothing).
+     */
+    deleteAppDomain(appId: string, domain?: string): Promise<void>;
     /**
      * POST /v1/apps/:id/members — add or invite a member by email. If a Human
      * already exists for the email, the member row is created immediately
@@ -890,10 +899,18 @@ export interface AppDomain {
     status: "pending" | "active" | "error" | "removed";
     dns_records: AppDomainDnsRecord[];
     cf_hostname_id: string | null;
+    cf_worker_route_id?: string | null;
+    /** Null on the serving domain; on an alias, the domain it redirects to. */
+    redirect_to?: string | null;
     last_error: string | null;
     last_checked_at: string | null;
     created_at: string;
     updated_at: string;
+    /**
+     * Present on the GET response only: the app's other domains, each of which
+     * redirects to the one carried at the top level.
+     */
+    aliases?: AppDomain[];
 }
 /**
  * One member row — the shape `listAppMembers` returns and the `member` half

package/dist/client.js

@@ -673,14 +673,18 @@ export class HomespunClient {
         return this.asObject(r);
     }
     // -------------------------------------------------------------------------
-    // Custom domains (Cloudflare for SaaS). One primary domain per app. The
-    // relay rejects setAppDomain with `custom_domains_not_enabled` (501) when
-    // the deployment has no Cloudflare configuration.
+    // Custom domains (Cloudflare for SaaS). An app holds one domain that SERVES
+    // plus any number of aliases that redirect to it; the first domain bound
+    // becomes the serving one. The relay rejects setAppDomain with
+    // `custom_domains_not_enabled` (501) when the deployment has no Cloudflare
+    // configuration.
     // -------------------------------------------------------------------------
     /**
-     * POST /v1/apps/:id/domain - bind a custom domain to the app. Returns the
-     * record including `dns_records`: the DNS entries the domain owner must
-     * publish (the routing CNAME plus any Cloudflare validation records).
+     * POST /v1/apps/:id/domain - bind a custom domain to the app. The FIRST
+     * domain bound serves the app; every one after it becomes an alias that
+     * redirects there (`redirect_to`). Returns the record including
+     * `dns_records`: the DNS entries the domain owner must publish (the routing
+     * CNAME plus any Cloudflare validation records).
      */
     async setAppDomain(appId, domain) {
         const r = await this.call("POST", `/v1/apps/${encodeURIComponent(appId)}/domain`, { domain });
@@ -689,9 +693,10 @@ export class HomespunClient {
         return this.asObject(r);
     }
     /**
-     * GET /v1/apps/:id/domain - the app's domain record, live-refreshed against
-     * Cloudflare when the feature is enabled (status/last_error/last_checked_at
-     * update as a side effect).
+     * GET /v1/apps/:id/domain - the app's SERVING domain at the top level with
+     * its `aliases` beside it, live-refreshed against Cloudflare when the
+     * feature is enabled (status/last_error/last_checked_at update as a side
+     * effect).
      */
     async getAppDomain(appId) {
         const r = await this.call("GET", `/v1/apps/${encodeURIComponent(appId)}/domain`);
@@ -703,8 +708,15 @@ export class HomespunClient {
      * DELETE /v1/apps/:id/domain - remove the domain binding (Cloudflare
      * hostname best-effort + record + quota release). Idempotent.
      */
-    async deleteAppDomain(appId) {
-        const r = await this.call("DELETE", `/v1/apps/${encodeURIComponent(appId)}/domain`);
+    /**
+     * Unbind the app's custom domains. With no `domain` every binding goes;
+     * with one, only that binding, except that removing the primary takes its
+     * aliases with it (an alias pointing at a domain the app no longer holds
+     * would redirect visitors into nothing).
+     */
+    async deleteAppDomain(appId, domain) {
+        const query = domain ? `?domain=${encodeURIComponent(domain)}` : "";
+        const r = await this.call("DELETE", `/v1/apps/${encodeURIComponent(appId)}/domain${query}`);
         if (!r.ok)
             this.fail(r);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@homespunapps/core",
-  "version": "1.6.21",
+  "version": "1.6.23",
   "description": "Homespun relay client: typed HTTP + WebSocket operations against a Homespun relay. Framework-free.",
   "license": "MIT",
   "type": "module",