astroidjs 0.7.1 → 0.7.2

package/dist/config.d.ts

@@ -268,6 +268,26 @@ export interface TenancyConfig {
      * built from `Astro.url` stay public and correct.
      */
     rewritePrefix?: string;
+    /**
+     * First-party apps on their own labels, mapped to the internal path prefix
+     * each serves from — `{ studio: "/studio" }` serves
+     * `studio.example.com/<path>` from `src/pages/studio/<path>`.
+     *
+     * This is the missing half of {@link PwaConfig.emitDir}'s subdomain story:
+     * an app label is not a tenant (there is no lookup — the studio exists
+     * whether or not any tenant does) and not merely reserved (a reserved label
+     * renders the ordinary site, which turns the admin host into a second copy
+     * of the marketing homepage). It is a static rewrite, decided at config time.
+     *
+     * An app label is implicitly reserved: `tenantLabel` never offers it to
+     * `resolveTenant`, and listing it in `reserved` too is refused — one list
+     * per fact, or the two drift.
+     *
+     * Same internal-rewrite semantics as tenants: the visitor's URL never
+     * changes, and the path form stays reachable on the apex — which is what
+     * makes local dev work, since `wrangler dev` cannot serve subdomains.
+     */
+    apps?: Record<string, string>;
 }
 export interface AstroidCron {
     /** Standard 5-field cron, UTC — e.g. `"*&#47;15 * * * *"`. */

package/dist/config.js

@@ -141,6 +141,24 @@ function assertTenancy(config) {
             "A wildcard route does not match its own apex, so the apex would 404. " +
             `Add "${apex}" to \`hosts\`.`);
     }
+    // App labels: each failure below otherwise surfaces as a rewrite to a path
+    // that renders the wrong page, with nothing pointing back at the config.
+    for (const [label, prefix] of Object.entries(tenancy.apps ?? {})) {
+        if (!label || label.includes(".")) {
+            throw new AstroidConfigError(`\`tenancy.apps\` label "${label}" must be a single subdomain label — ` +
+                "Cloudflare's wildcard matches one level.");
+        }
+        if ((tenancy.reserved ?? []).includes(label)) {
+            throw new AstroidConfigError(`"${label}" is in both \`tenancy.apps\` and \`tenancy.reserved\`. ` +
+                "An app label is implicitly reserved — keep it in `apps` only, or the " +
+                "two lists drift and `reserved` silently wins.");
+        }
+        if (!prefix.startsWith("/") || prefix === "/" || prefix.endsWith("/")) {
+            throw new AstroidConfigError(`\`tenancy.apps.${label}\` must be an internal path prefix like "/studio" ` +
+                `(leading slash, no trailing slash, not "/") — got "${prefix}". ` +
+                'The rewrite is `prefix + pathname`, so "/" or a trailing slash produces "//…".');
+        }
+    }
 }
 export function defineAstroid(config) {
     if (!config.key || config.key.trim().length === 0) {

package/dist/tenancy/index.d.ts

@@ -15,14 +15,26 @@ export declare function tenancyZone(tenancy: TenancyConfig): string;
  * The subdomain label for a host under the wildcard, or `null` when the host is
  * not a tenant candidate at all.
  *
- * `null` covers three distinct cases that all mean "render the ordinary site":
- * the apex itself (a wildcard does not match its own apex), a host outside the
- * pattern (a preview domain, `localhost`), and a reserved label.
+ * `null` covers four distinct cases that all mean "not a tenant": the apex
+ * itself (a wildcard does not match its own apex), a host outside the pattern
+ * (a preview domain, `localhost`), a reserved label, and an app label — which
+ * has its own static rewrite via {@link appPrefix} instead of a lookup.
  *
  * Exported and pure so a site can unit-test its own reserved list without
  * standing up a request.
  */
 export declare function tenantLabel(host: string, tenancy: TenancyConfig): string | null;
+/**
+ * The internal path prefix an app host rewrites to, or `null` when the host is
+ * not an app host — `appPrefix("studio.example.com", …)` → `"/studio"` under
+ * `apps: { studio: "/studio" }`.
+ *
+ * Static by design: an app exists whether or not any tenant does, so there is
+ * no per-request lookup and nothing to cache. Same host handling as
+ * {@link tenantLabel} (port and case ignored, one label only), so `wrangler
+ * dev` behaves like production.
+ */
+export declare function appPrefix(host: string, tenancy: TenancyConfig): string | null;
 /**
  * The scaffold-once `src/tenancy.ts` — the seam holding every decision Astroid
  * refuses to make for a site.

package/dist/tenancy/index.js

@@ -23,30 +23,61 @@ export function tenancyZone(tenancy) {
     return tenancy.zone ?? tenancy.hostPattern.replace(/^\*\./, "");
 }
 /**
- * The subdomain label for a host under the wildcard, or `null` when the host is
- * not a tenant candidate at all.
- *
- * `null` covers three distinct cases that all mean "render the ordinary site":
- * the apex itself (a wildcard does not match its own apex), a host outside the
- * pattern (a preview domain, `localhost`), and a reserved label.
- *
- * Exported and pure so a site can unit-test its own reserved list without
- * standing up a request.
+ * The single subdomain label under the wildcard, before any policy — or `null`
+ * for the apex, an off-pattern host, or a dotted label. Shared by
+ * {@link tenantLabel} and {@link appPrefix} so their host handling (port,
+ * case, one-level-only) cannot drift.
  */
-export function tenantLabel(host, tenancy) {
+function hostLabel(host, tenancy) {
     const suffix = tenancy.hostPattern.replace(/^\*\./, "");
     // Strip a port: `acme.example.com:8788` under `wrangler dev`.
     const hostname = host.split(":")[0]?.toLowerCase() ?? "";
     if (!hostname.endsWith(`.${suffix}`))
         return null;
     const label = hostname.slice(0, -(suffix.length + 1));
-    // Only a single label is a tenant. `a.b.example.com` under `*.example.com` is
+    // Only a single label counts. `a.b.example.com` under `*.example.com` is
     // not `a.b` — Cloudflare's wildcard matches one level, and treating a dotted
     // string as a slug would put a `/` in a rewrite path.
     if (!label || label.includes("."))
         return null;
-    const reserved = tenancy.reserved ?? [];
-    return reserved.includes(label) ? null : label;
+    return label;
+}
+/**
+ * The subdomain label for a host under the wildcard, or `null` when the host is
+ * not a tenant candidate at all.
+ *
+ * `null` covers four distinct cases that all mean "not a tenant": the apex
+ * itself (a wildcard does not match its own apex), a host outside the pattern
+ * (a preview domain, `localhost`), a reserved label, and an app label — which
+ * has its own static rewrite via {@link appPrefix} instead of a lookup.
+ *
+ * Exported and pure so a site can unit-test its own reserved list without
+ * standing up a request.
+ */
+export function tenantLabel(host, tenancy) {
+    const label = hostLabel(host, tenancy);
+    if (!label)
+        return null;
+    if ((tenancy.reserved ?? []).includes(label))
+        return null;
+    return tenancy.apps && label in tenancy.apps ? null : label;
+}
+/**
+ * The internal path prefix an app host rewrites to, or `null` when the host is
+ * not an app host — `appPrefix("studio.example.com", …)` → `"/studio"` under
+ * `apps: { studio: "/studio" }`.
+ *
+ * Static by design: an app exists whether or not any tenant does, so there is
+ * no per-request lookup and nothing to cache. Same host handling as
+ * {@link tenantLabel} (port and case ignored, one label only), so `wrangler
+ * dev` behaves like production.
+ */
+export function appPrefix(host, tenancy) {
+    const apps = tenancy.apps;
+    if (!apps)
+        return null;
+    const label = hostLabel(host, tenancy);
+    return label ? (apps[label] ?? null) : null;
 }
 /**
  * The scaffold-once `src/tenancy.ts` — the seam holding every decision Astroid

package/dist/worker/generate.js

@@ -478,7 +478,9 @@ export function generateAstroidMiddleware(config) {
             ...(portal ? ["astroidPortalGuardConfig"] : []),
             "astroidRateRules",
             ...(portal ? ["guardResponse", "portalGuard", "resolvePortalSession"] : []),
-            ...(tenancy ? ["tenantLabel"] : []),
+            ...(tenancy
+                ? [...(Object.keys(tenancy.apps ?? {}).length ? ["appPrefix"] : []), "tenantLabel"]
+                : []),
         ].join(", ")} } from "astroidjs";`,
         'import astroidConfig from "../astroid.config.js";',
         ...(tenancy
@@ -574,6 +576,15 @@ export function generateAstroidMiddleware(config) {
                 "  // falls through to the ordinary site below. Return a 404 from `guard`",
                 "  // instead if a stranger's subdomain should not render your homepage.",
                 "  rewrite: (context) => {",
+                ...(Object.keys(tenancy.apps ?? {}).length
+                    ? [
+                        "    // First-party app hosts (config `tenancy.apps`): a static label→prefix",
+                        "    // map, checked before the tenant — an app exists whether or not any",
+                        "    // tenant does, and needs no lookup.",
+                        "    const app = appPrefix(context.url.hostname, TENANCY);",
+                        "    if (app) return `${app}${context.url.pathname}`;",
+                    ]
+                    : []),
                 "    const tenant = context.locals.tenant;",
                 `    return tenant ? \`${rewritePrefix}/\${tenant.slug}\${context.url.pathname}\` : undefined;`,
                 "  },",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "astroidjs",
-  "version": "0.7.1",
+  "version": "0.7.2",
   "description": "Astroid — an opinionated meta-framework over Louise Toolkit and Astro for building editable, multi-editor sites on Cloudflare Workers.",
   "keywords": [
     "astro",
@@ -60,7 +60,7 @@
     "access": "public"
   },
   "dependencies": {
-    "louise-toolkit": "0.24.0"
+    "louise-toolkit": "0.25.0"
   },
   "devDependencies": {
     "@types/node": "^24.13.3",