@homespunapps/core 1.6.22 → 1.6.23

package/dist/client.d.ts

@@ -360,15 +360,18 @@ 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>;
     /**
@@ -896,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`);

package/package.json

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