@aotter/mantle-cloudflare 0.1.0-alpha.1 → 0.1.0-alpha.3

package/dist/mount/cmsConfig.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"cmsConfig.d.ts","sourceRoot":"","sources":["../../src/mount/cmsConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,QAAQ,CAAC,GAAG;QAC/D;;yCAEiC;QACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAC7D;;;;;oBAKY;QACZ,QAAQ,CAAC,sBAAsB,CAAC,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;KAClF,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;yBAEqB;IACrB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;IACzD,sEAAsE;IACtE,QAAQ,CAAC,WAAW,CAAC,EAAE;QACrB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACrC,CAAC;CACH"}
+{"version":3,"file":"cmsConfig.d.ts","sourceRoot":"","sources":["../../src/mount/cmsConfig.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,UAAU,EACV,oBAAoB,EACpB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAClD,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,oBAAoB,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,SAAS,EAAE,SAAS,QAAQ,EAAE,CAAC;IACxC,QAAQ,CAAC,QAAQ,CAAC,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC,CAAC;IACzD,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,QAAQ,CAAC,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;IACjD,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,oBAAoB,EAAE,IAAI,GAAG,QAAQ,CAAC,GAAG;QAC/D;;yCAEiC;QACjC,QAAQ,CAAC,YAAY,CAAC,EAAE,oBAAoB,CAAC,cAAc,CAAC,CAAC;QAC7D;;;;;oBAKY;QACZ,QAAQ,CAAC,sBAAsB,CAAC,EAAE,oBAAoB,CAAC,wBAAwB,CAAC,CAAC;KAClF,CAAC;IACF,gEAAgE;IAChE,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB;;yBAEqB;IACrB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,0BAA0B,CAAC;IACzD,sEAAsE;IACtE,QAAQ,CAAC,SAAS,CAAC,EAAE;QACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAC1B,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;KACrC,CAAC;IACF,QAAQ,CAAC,cAAc,CAAC,EAAE,oBAAoB,CAAC,gBAAgB,CAAC,CAAC;CAClE"}

package/dist/mount/index.d.ts

@@ -3,6 +3,6 @@ export { runMantleUseCase } from "./runMantleUseCase.js";
 export { resolveCaller, type CallerResolution, type ConsumerCredentialResolution, type ConsumerCredentialResolver, type ResolveCallerOptions, } from "./resolveCaller.js";
 export { type CmsRuntimeRef, createCmsRef } from "./bootRuntimeOnce.js";
 export { createMcpApiHandler, type CreateMcpApiHandlerOptions, } from "./mountMcp.js";
-export { mountPublicRoutes, type CollectionRouteConfig, type MountPublicRoutesOptions, type PublicRouteContext, type SlugOverride, } from "./mountPublicRoutes.js";
+export { mountPublicRoutes, type CollectionRouteConfig, type MountPublicRoutesOptions, type PublicContentContext, type PublicRouteContext, type SlugOverride, } from "./mountPublicRoutes.js";
 export type { CmsConfig } from "./cmsConfig.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/mount/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mount/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mount/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,aAAa,EACb,KAAK,gBAAgB,EACrB,KAAK,4BAA4B,EACjC,KAAK,0BAA0B,EAC/B,KAAK,oBAAoB,GAC1B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,KAAK,aAAa,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EACL,mBAAmB,EACnB,KAAK,0BAA0B,GAChC,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,EACjB,KAAK,qBAAqB,EAC1B,KAAK,wBAAwB,EAC7B,KAAK,oBAAoB,EACzB,KAAK,kBAAkB,EACvB,KAAK,YAAY,GAClB,MAAM,wBAAwB,CAAC;AAChC,YAAY,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/mount/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mount/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,aAAa,GAKd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAsB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EACL,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,GAKlB,MAAM,wBAAwB,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/mount/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AACjE,OAAO,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,EACL,aAAa,GAKd,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAsB,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACxE,OAAO,EACL,mBAAmB,GAEpB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,iBAAiB,GAMlB,MAAM,wBAAwB,CAAC"}

package/dist/mount/mountMcp.d.ts

@@ -12,10 +12,10 @@ export interface CreateMcpApiHandlerOptions {
  * resource path. Plug into `createOAuthProvider({ apiHandlers })`
  * keyed by the resource path (e.g. `/mcp/staff` or `/mcp`).
  *
- * The OAuthProvider lib verifies the bearer token, decrypts grant
- * props, and sets `ctx.props` BEFORE calling this handler. We read
- * immutable grant props and re-read the caller's mutable staff role
- * from D1 on every invocation.
+ * The OAuthProvider lib verifies the bearer token and sets its
+ * token-specific identity and scopes on `ctx.props` BEFORE calling
+ * this handler. We re-read the caller's mutable staff role from D1
+ * on every invocation.
  *
  * Note: OAuth scope distinction (`mcp:read` vs `mcp:staff`) used to
  * differentiate surfaces here. Removed because claude.ai's MCP client

package/dist/mount/mountMcp.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mountMcp.d.ts","sourceRoot":"","sources":["../../src/mount/mountMcp.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IACrC;;6DAEyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,0BAA0B,GAClC,eAAe,CAAC,GAAG,CAAC,CAgGtB"}
+{"version":3,"file":"mountMcp.d.ts","sourceRoot":"","sources":["../../src/mount/mountMcp.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,aAAa,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,QAAQ,CAAC;IACrC;;6DAEyD;IACzD,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAC/D,OAAO,EAAE,0BAA0B,GAClC,eAAe,CAAC,GAAG,CAAC,CA8FtB"}

package/dist/mount/mountMcp.js

@@ -1,14 +1,14 @@
 import { McpJsonRpcDispatcher } from "@aotter/mantle-runtime";
-import { STAFF_ROLE_SET } from "../auth/createAuth.js";
+import { contextForVerifiedUser } from "./resolveCaller.js";
 /**
  * Build a Cloudflare Worker `ExportedHandler` that serves one MCP
  * resource path. Plug into `createOAuthProvider({ apiHandlers })`
  * keyed by the resource path (e.g. `/mcp/staff` or `/mcp`).
  *
- * The OAuthProvider lib verifies the bearer token, decrypts grant
- * props, and sets `ctx.props` BEFORE calling this handler. We read
- * immutable grant props and re-read the caller's mutable staff role
- * from D1 on every invocation.
+ * The OAuthProvider lib verifies the bearer token and sets its
+ * token-specific identity and scopes on `ctx.props` BEFORE calling
+ * this handler. We re-read the caller's mutable staff role from D1
+ * on every invocation.
  *
  * Note: OAuth scope distinction (`mcp:read` vs `mcp:staff`) used to
  * differentiate surfaces here. Removed because claude.ai's MCP client
@@ -27,15 +27,21 @@ export function createMcpApiHandler(options) {
     const dispatcherCache = new WeakMap();
     return {
         async fetch(request, env, ctx) {
-            const props = ctx.props;
-            if (!props?.userId)
+            const props = readOAuthApiProps(ctx.props);
+            if (!props)
                 return forbidden(requiredScopes);
-            const grantedScopes = props.scopes?.length ? props.scopes : ["mcp"];
+            const grantedScopes = props.scopes;
             if (requiredScopes.some((scope) => !grantedScopes.includes(scope))) {
                 return forbidden(requiredScopes);
             }
-            const role = await ref.auth.getUserRole(props.userId);
-            if (surface === "staff" && (!role || !STAFF_ROLE_SET.has(role))) {
+            const waitUntil = typeof ctx.waitUntil === "function" ? ctx.waitUntil.bind(ctx) : undefined;
+            const handlerContext = await contextForVerifiedUser(props.userId, {
+                credential: "oauth",
+                credentialId: null,
+                clientId: props.clientId,
+                scopes: grantedScopes,
+            }, ref.auth, { env, ...(waitUntil ? { waitUntil } : {}) });
+            if (surface === "staff" && !handlerContext.staff) {
                 return forbidden(requiredScopes);
             }
             const runtime = await ref.get();
@@ -86,19 +92,27 @@ export function createMcpApiHandler(options) {
                 cached = { mediaPurposesKey, dispatcher };
                 dispatcherCache.set(runtime, cached);
             }
-            const waitUntil = typeof ctx.waitUntil === "function" ? ctx.waitUntil.bind(ctx) : undefined;
-            return cached.dispatcher.dispatch(request, {
-                userId: props.userId,
-                staff: role && STAFF_ROLE_SET.has(role)
-                    ? { userId: props.userId, role: role }
-                    : null,
-                clientId: props.clientId ?? null,
-                credentialId: null,
-                scopes: grantedScopes,
-            }, { env, ...(waitUntil ? { waitUntil } : {}) });
+            return cached.dispatcher.dispatch(request, handlerContext);
         },
     };
 }
+function readOAuthApiProps(value) {
+    if (!value || typeof value !== "object")
+        return null;
+    const props = value;
+    if (typeof props["userId"] !== "string" ||
+        props["userId"].length === 0 ||
+        typeof props["clientId"] !== "string" ||
+        props["clientId"].length === 0 ||
+        !Array.isArray(props["scopes"]) ||
+        !props["scopes"].every((scope) => typeof scope === "string"))
+        return null;
+    return {
+        userId: props["userId"],
+        clientId: props["clientId"],
+        scopes: props["scopes"],
+    };
+}
 function forbidden(requiredScopes) {
     const scope = requiredScopes.join(" ");
     return new Response("forbidden", {

package/dist/mount/mountMcp.js.map

@@ -1 +1 @@
-{"version":3,"file":"mountMcp.js","sourceRoot":"","sources":["../../src/mount/mountMcp.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"mountMcp.js","sourceRoot":"","sources":["../../src/mount/mountMcp.ts"],"names":[],"mappings":"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"}

package/dist/mount/mountPublicRoutes.d.ts

@@ -1,6 +1,6 @@
 import type { Context, Hono } from "hono";
 import type { SiteConfig } from "@aotter/mantle-spec";
-import { type CmsRuntime } from "@aotter/mantle-runtime";
+import { type CmsRuntime, type SeoMeta } from "@aotter/mantle-runtime";
 import type { CmsRuntimeRef } from "./bootRuntimeOnce.js";
 /**
  * `mountPublicRoutes` — mounts the SDK-managed public surface on the
@@ -47,12 +47,15 @@ export interface CollectionRouteConfig {
      *  collection. */
     readonly homeSlug?: string;
 }
-export interface PublicRouteContext {
-    readonly c: Context;
+export interface PublicContentContext {
     readonly runtime: CmsRuntime;
     readonly site: SiteConfig;
     readonly locale: string;
 }
+export interface PublicRouteContext extends PublicContentContext {
+    readonly c: Context;
+    readonly seo: SeoMeta;
+}
 export interface SlugOverride {
     readonly collection: string;
     readonly slug: string;
@@ -64,6 +67,8 @@ export interface MountPublicRoutesOptions {
      *  recent posts across collections. Optional; without it `/` and
      *  `/{locale}` are not registered. */
     readonly homeRenderer?: (ctx: PublicRouteContext) => Promise<Response>;
+    /** Agent-readable home body for composed homes without one backing Entry. */
+    readonly homeMarkdown?: (ctx: PublicContentContext) => Promise<string | null>;
     /** Renderer for the locale 404 fallback. Required — every miss
      *  falls through here. */
     readonly notFoundRenderer: (ctx: PublicRouteContext) => Promise<Response>;

package/dist/mount/mountPublicRoutes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mountPublicRoutes.d.ts","sourceRoot":"","sources":["../../src/mount/mountPublicRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,EAIL,KAAK,UAAU,EAChB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAG1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;kDAE8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;2EACuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;6CACyC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;sBAEkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAChE;;0CAEsC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvE;8BAC0B;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1E,iFAAiF;IACjF,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrD,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAkCD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,wBAAwB,GAChC,IAAI,CAqEN"}
+{"version":3,"file":"mountPublicRoutes.d.ts","sourceRoot":"","sources":["../../src/mount/mountPublicRoutes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,MAAM,CAAC;AAC1C,OAAO,KAAK,EAAS,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAC7D,OAAO,EAML,KAAK,UAAU,EACf,KAAK,OAAO,EACb,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAI1D;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,WAAW,qBAAqB;IACpC,gDAAgD;IAChD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B;;kDAE8C;IAC9C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB;2EACuE;IACvE,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B;6CACyC;IACzC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC;;sBAEkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,kBAAmB,SAAQ,oBAAoB;IAC9D,QAAQ,CAAC,CAAC,EAAE,OAAO,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;CACjE;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,gBAAgB,EAAE,aAAa,CAAC,qBAAqB,CAAC,CAAC;IAChE;;0CAEsC;IACtC,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IACvE,6EAA6E;IAC7E,QAAQ,CAAC,YAAY,CAAC,EAAE,CAAC,GAAG,EAAE,oBAAoB,KAAK,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAC9E;8BAC0B;IAC1B,QAAQ,CAAC,gBAAgB,EAAE,CAAC,GAAG,EAAE,kBAAkB,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;IAC1E,iFAAiF;IACjF,QAAQ,CAAC,aAAa,CAAC,EAAE,aAAa,CAAC,YAAY,CAAC,CAAC;IACrD,qEAAqE;IACrE,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;CAC5B;AAsCD,wBAAgB,iBAAiB,CAC/B,GAAG,EAAE,IAAI,EACT,GAAG,EAAE,aAAa,EAClB,OAAO,EAAE,wBAAwB,GAChC,IAAI,CA4GN"}

package/dist/mount/mountPublicRoutes.js

@@ -1,5 +1,6 @@
-import { inferLocaleFromPath, serializeEntryAsMarkdown, toUrlLocale, } from "@aotter/mantle-runtime";
+import { absoluteUrl, composePageSeoMeta, inferLocaleFromPath, serializeEntryAsMarkdown, toUrlLocale, } from "@aotter/mantle-runtime";
 import { STAFF_ROLE_SET } from "../auth/createAuth.js";
+import { PUBLIC_CACHE_TAG } from "../oauth/cachePolicy.js";
 const PUBLIC_CACHE_CONTROL = "public, max-age=0, s-maxage=300";
 const PRIVATE_CACHE_CONTROL = "private, no-store";
 const HTML_NO_STORE = {
@@ -9,14 +10,17 @@ const HTML_NO_STORE = {
 const HTML_PUBLIC = {
     "content-type": "text/html; charset=utf-8",
     "cache-control": PUBLIC_CACHE_CONTROL,
+    "cache-tag": PUBLIC_CACHE_TAG,
 };
 const MD_PUBLIC = {
     "content-type": "text/markdown; charset=utf-8",
     "cache-control": PUBLIC_CACHE_CONTROL,
+    "cache-tag": PUBLIC_CACHE_TAG,
 };
 const TEXT_PUBLIC = {
     "content-type": "text/plain; charset=utf-8",
     "cache-control": PUBLIC_CACHE_CONTROL,
+    "cache-tag": PUBLIC_CACHE_TAG,
 };
 const TEXT_NO_STORE = {
     "content-type": "text/plain; charset=utf-8",
@@ -25,6 +29,7 @@ const TEXT_NO_STORE = {
 const SITEMAP_HEADERS = {
     "content-type": "application/xml; charset=utf-8",
     "cache-control": PUBLIC_CACHE_CONTROL,
+    "cache-tag": PUBLIC_CACHE_TAG,
 };
 export function mountPublicRoutes(app, ref, options) {
     const liveDev = options.liveDev === true;
@@ -34,7 +39,9 @@ export function mountPublicRoutes(app, ref, options) {
     // `:locale = "llms.txt"` if the literal route registers later.
     app.get("/llms.txt", async () => {
         const runtime = await ref.get();
-        const body = await composeRootLlmsTxt(runtime, await runtime.siteConfig.load());
+        const body = await composeRootLlmsTxt(runtime, await runtime.siteConfig.load(), options);
+        if (!body)
+            return textNotFound();
         return new Response(body, { status: 200, headers: TEXT_PUBLIC });
     });
     app.get("/sitemap.xml", async (c) => {
@@ -47,7 +54,27 @@ export function mountPublicRoutes(app, ref, options) {
         }
         const xml = await runtime.composeSitemap.execute({
             site,
-            pathFor: (e) => runtime.publicPathResolver.forEntry(e),
+            pathFor: (entry) => {
+                const resolved = runtime.publicPathResolver.forEntry(entry);
+                if (entry.locale || !resolved)
+                    return resolved;
+                const route = options.collectionRoutes.find((candidate) => candidate.collection === entry.collection);
+                if (!route)
+                    return resolved;
+                const slug = typeof entry.data["slug"] === "string" ? entry.data["slug"] : entry.id;
+                const suffix = route.homeSlug === slug
+                    ? ""
+                    : route.segment ? `${route.segment}/${slug}` : slug;
+                return site.locales.map((locale) => localizedPath(locale, suffix));
+            },
+            additionalPaths: options.homeRenderer
+                ? site.locales.flatMap((locale) => [
+                    localizedPath(locale),
+                    ...options.collectionRoutes
+                        .filter((route) => route.listRoute && route.segment)
+                        .map((route) => localizedPath(locale, route.segment)),
+                ])
+                : [],
         });
         return new Response(xml, { status: 200, headers: SITEMAP_HEADERS });
     });
@@ -58,25 +85,44 @@ export function mountPublicRoutes(app, ref, options) {
             const canonical = site.canonicalLocale ?? site.locales[0] ?? "en";
             return c.redirect(`/${toUrlLocale(canonical)}`);
         });
+        app.get("/:locale{[^/]+\\.md}", async (c) => {
+            const runtime = await ref.get();
+            const site = await runtime.siteConfig.load();
+            const raw = c.req.param("locale");
+            const locale = canonicalLocaleParam(raw.endsWith(".md") ? raw.slice(0, -3) : raw, site.locales);
+            if (locale === null)
+                return textNotFound();
+            const ctx = buildCtx(c, runtime, site, locale, homeSeo(site, locale, false));
+            const body = options.homeMarkdown
+                ? await options.homeMarkdown(ctx)
+                : await readHomeMarkdown(runtime, options.collectionRoutes, locale);
+            return body ? new Response(body, { status: 200, headers: MD_PUBLIC }) : textNotFound();
+        });
         app.get("/:locale", async (c) => {
             const runtime = await ref.get();
             const site = await runtime.siteConfig.load();
             const locale = canonicalLocaleParam(c.req.param("locale"), site.locales);
-            const ctx = buildCtx(c, runtime, site, locale ?? inferLocaleFromPath(c.req.path, site));
-            if (locale === null)
-                return options.notFoundRenderer(ctx);
-            return options.homeRenderer(ctx);
+            const fallbackLocale = locale ?? inferLocaleFromPath(c.req.path, site);
+            if (locale === null) {
+                return options.notFoundRenderer(buildCtx(c, runtime, site, fallbackLocale, homeSeo(site, fallbackLocale, false)));
+            }
+            const baseCtx = buildCtx(c, runtime, site, locale, homeSeo(site, locale, false));
+            const markdown = options.homeMarkdown
+                ? await options.homeMarkdown(baseCtx)
+                : await readHomeMarkdown(runtime, options.collectionRoutes, locale);
+            const response = await options.homeRenderer(buildCtx(c, runtime, site, locale, homeSeo(site, locale, markdown !== null)));
+            return applyPublicHeaders(response, liveDev);
         });
     }
     app.get("/:locale/llms.txt", async (c) => {
         const runtime = await ref.get();
         const locale = canonicalLocaleParam(c.req.param("locale"), await runtime.siteConfig.readLocales());
         if (locale === null)
-            return new Response("not found", { status: 404, headers: TEXT_NO_STORE });
-        const body = await runtime.composeLlmsTxt.execute({
-            site: await runtime.siteConfig.load(),
-            locale,
-        });
+            return textNotFound();
+        const site = await runtime.siteConfig.load();
+        const body = await composeLocaleLlmsTxt(runtime, site, locale, options);
+        if (!body)
+            return textNotFound();
         return new Response(body, { status: 200, headers: TEXT_PUBLIC });
     });
     for (const route of options.collectionRoutes) {
@@ -86,26 +132,61 @@ export function mountPublicRoutes(app, ref, options) {
         const runtime = await ref.get();
         const site = await runtime.siteConfig.load();
         const locale = inferLocaleFromPath(c.req.path, site);
-        return options.notFoundRenderer(buildCtx(c, runtime, site, locale));
+        return options.notFoundRenderer(buildCtx(c, runtime, site, locale, homeSeo(site, locale, false)));
     });
 }
 function mountCollection(app, ref, options, route, liveDev, overrides) {
     const segPath = route.segment ? `/${route.segment}` : "";
     if (route.listRoute) {
+        if (route.markdownMirror !== false && route.segment) {
+            app.get(`/:locale${segPath}.md`, async (c) => {
+                const runtime = await ref.get();
+                const locale = canonicalLocaleParam(c.req.param("locale") ?? "", await runtime.siteConfig.readLocales());
+                if (locale === null)
+                    return textNotFound();
+                const site = await runtime.siteConfig.load();
+                const body = await runtime.composeLlmsTxt.execute({
+                    site,
+                    locale: contentLocale(runtime, route.collection, locale),
+                    collection: route.collection,
+                    pathFor: (entry) => entryPathForLocale(runtime, options.collectionRoutes, entry, locale),
+                });
+                return body ? new Response(body, { status: 200, headers: MD_PUBLIC }) : textNotFound();
+            });
+        }
         app.get(`/:locale${segPath}`, async (c) => {
             const runtime = await ref.get();
             const locale = canonicalLocaleParam(c.req.param("locale"), await runtime.siteConfig.readLocales());
             const loadSite = lazySite(runtime);
             const notFound = async () => {
                 const site = await loadSite();
-                return options.notFoundRenderer(buildCtx(c, runtime, site, locale ?? inferLocaleFromPath(c.req.path, site)));
+                return options.notFoundRenderer(buildCtx(c, runtime, site, locale ?? inferLocaleFromPath(c.req.path, site), homeSeo(site, locale ?? inferLocaleFromPath(c.req.path, site), false)));
             };
             if (locale === null)
                 return notFound();
+            const site = await loadSite();
+            const markdown = route.markdownMirror === false ? null : await runtime.composeLlmsTxt.execute({
+                site,
+                locale: contentLocale(runtime, route.collection, locale),
+                collection: route.collection,
+                pathFor: (entry) => entryPathForLocale(runtime, options.collectionRoutes, entry, locale),
+            });
+            const publicPath = localizedPath(locale, route.segment);
+            const schemaTitle = runtime.schemasByName.get(route.collection)?.spec.title;
+            const seo = composePageSeoMeta({
+                site,
+                locale,
+                publicPath,
+                title: schemaTitle ? `${schemaTitle} · ${site.brand}` : site.title,
+                markdown: markdown !== null,
+                pathForLocale: (candidate) => localizedPath(candidate, route.segment),
+            });
             const html = await runtime.renderListLive.execute({
                 collection: route.collection,
                 locale,
-                site: await loadSite(),
+                contentLocale: contentLocale(runtime, route.collection, locale),
+                site,
+                seo,
             });
             if (html === null)
                 return notFound();
@@ -127,18 +208,21 @@ function mountCollection(app, ref, options, route, liveDev, overrides) {
             const locale = canonicalLocaleParam(c.req.param("locale"), await runtime.siteConfig.readLocales());
             const slugParam = c.req.param("slug") ?? "";
             const slug = slugParam.endsWith(".md") ? slugParam.slice(0, -3) : slugParam;
-            const notFound = () => new Response("not found", { status: 404, headers: TEXT_NO_STORE });
+            const notFound = () => textNotFound();
             if (locale === null)
                 return notFound();
             const entry = await runtime.entryReader.readBySlug({
                 collection: route.collection,
                 slug,
-                locale,
+                locale: contentLocale(runtime, route.collection, locale),
                 status: "published",
             });
             if (!entry)
                 return notFound();
-            return new Response(serializeEntryAsMarkdown(entry), {
+            const markdown = serializeEntryAsMarkdown(entry);
+            if (!markdown)
+                return notFound();
+            return new Response(markdown, {
                 status: 200,
                 headers: MD_PUBLIC,
             });
@@ -151,35 +235,41 @@ function mountCollection(app, ref, options, route, liveDev, overrides) {
         const loadSite = lazySite(runtime);
         const notFound = async () => {
             const site = await loadSite();
-            return options.notFoundRenderer(buildCtx(c, runtime, site, locale ?? inferLocaleFromPath(c.req.path, site)));
+            return options.notFoundRenderer(buildCtx(c, runtime, site, locale ?? inferLocaleFromPath(c.req.path, site), homeSeo(site, locale ?? inferLocaleFromPath(c.req.path, site), false)));
         };
         if (locale === null)
             return notFound();
         const override = overrides.get(overrideKey(route.collection, slug));
         if (override) {
             const site = await loadSite();
-            return override.render(buildCtx(c, runtime, site, locale));
+            return applyPublicHeaders(await override.render(buildCtx(c, runtime, site, locale, homeSeo(site, locale, false))), liveDev);
         }
         if (c.req.query("preview") === "1") {
             const denied = await assertStaffSession(ref, c.req.raw);
             if (denied)
                 return denied;
             const site = await loadSite();
+            const seoRoute = entrySeoRoute(site, route, locale, slug, contentLocale(runtime, route.collection, locale) === null);
             const html = await runtime.previewEntry.execute({
                 collection: route.collection,
                 slug,
                 locale,
+                contentLocale: contentLocale(runtime, route.collection, locale),
                 site,
+                ...seoRoute,
             });
             if (html === null)
                 return notFound();
             return new Response(html, { status: 200, headers: HTML_NO_STORE });
         }
+        const site = await loadSite();
         const html = await runtime.renderEntryLive.execute({
             collection: route.collection,
             slug,
             locale,
-            site: await loadSite(),
+            contentLocale: contentLocale(runtime, route.collection, locale),
+            site,
+            ...entrySeoRoute(site, route, locale, slug, contentLocale(runtime, route.collection, locale) === null),
         });
         if (html === null)
             return notFound();
@@ -227,24 +317,115 @@ async function assertStaffSession(ref, req) {
  * header in localized mode, so the sections self-separate without a
  * custom delimiter.
  */
-async function composeRootLlmsTxt(runtime, site) {
+async function composeRootLlmsTxt(runtime, site, options) {
+    const parts = [];
     if (site.locales.length === 0) {
         return runtime.composeLlmsTxt.execute({ site, locale: null });
     }
-    const parts = [];
     for (const locale of site.locales) {
-        const body = await runtime.composeLlmsTxt.execute({ site, locale });
-        if (body.trim())
+        const body = await composeLocaleLlmsTxt(runtime, site, locale, options);
+        if (body)
             parts.push(body);
     }
-    return parts.length > 0 ? parts.join("\n---\n\n") : "";
+    return parts.length > 0 ? parts.join("\n---\n\n") : null;
+}
+async function composeLocaleLlmsTxt(runtime, site, locale, options) {
+    const parts = [];
+    if (options.homeMarkdown) {
+        if (await options.homeMarkdown({ runtime, site, locale })) {
+            parts.push(`# ${site.title}\n\nLocale: ${locale}\n\n## Pages\n\n- [${site.title}](${absoluteUrl(site.origin, `${localizedPath(locale)}.md`)})\n`);
+        }
+    }
+    const entries = await runtime.composeLlmsTxt.execute({
+        site,
+        locale,
+        includeUnlocalized: true,
+        pathFor: (entry) => {
+            const route = options.collectionRoutes.find((candidate) => candidate.collection === entry.collection);
+            const slug = typeof entry.data["slug"] === "string" ? entry.data["slug"] : entry.id;
+            if (options.homeMarkdown && route?.homeSlug === slug)
+                return null;
+            return entryPathForLocale(runtime, options.collectionRoutes, entry, locale);
+        },
+    });
+    if (entries)
+        parts.push(entries);
+    return parts.length > 0 ? parts.join("\n---\n\n") : null;
 }
 function lazySite(runtime) {
     let pending;
     return () => pending ??= runtime.siteConfig.load();
 }
-function buildCtx(c, runtime, site, locale) {
-    return { c, runtime, site, locale };
+function buildCtx(c, runtime, site, locale, seo) {
+    return { c, runtime, site, locale, seo };
+}
+function homeSeo(site, locale, markdown) {
+    return composePageSeoMeta({
+        site,
+        locale,
+        publicPath: localizedPath(locale),
+        markdown,
+        pathForLocale: (candidate) => localizedPath(candidate),
+    });
+}
+function localizedPath(locale, segment) {
+    return `/${toUrlLocale(locale)}${segment ? `/${segment}` : ""}`;
+}
+function entrySeoRoute(site, route, locale, slug, sharedAcrossLocales) {
+    const suffix = route.segment ? `${route.segment}/${slug}` : slug;
+    return {
+        publicPath: localizedPath(locale, suffix),
+        publicLocale: locale,
+        ...(!sharedAcrossLocales || !site.locales.some((candidate) => candidate.toLowerCase() !== locale.toLowerCase())
+            ? {}
+            : {
+                siblings: site.locales
+                    .filter((candidate) => candidate.toLowerCase() !== locale.toLowerCase())
+                    .map((candidate) => ({ locale: candidate, publicPath: localizedPath(candidate, suffix) })),
+            }),
+    };
+}
+function contentLocale(runtime, collection, locale) {
+    return runtime.schemasByName.get(collection)?.spec.localized ? locale : null;
+}
+function entryPathForLocale(runtime, routes, entry, locale) {
+    if (entry.locale)
+        return runtime.publicPathResolver?.forEntry(entry) ?? null;
+    const route = routes.find((candidate) => candidate.collection === entry.collection);
+    if (!route)
+        return runtime.publicPathResolver?.forEntry(entry) ?? null;
+    const slug = typeof entry.data["slug"] === "string" ? entry.data["slug"] : entry.id;
+    return localizedPath(locale, route.homeSlug === slug
+        ? ""
+        : route.segment ? `${route.segment}/${slug}` : slug);
+}
+async function readHomeMarkdown(runtime, routes, locale) {
+    const route = routes.find((candidate) => candidate.homeSlug && candidate.markdownMirror !== false);
+    if (!route?.homeSlug)
+        return null;
+    const entry = await runtime.entryReader.readBySlug({
+        collection: route.collection,
+        slug: route.homeSlug,
+        locale: contentLocale(runtime, route.collection, locale),
+        status: "published",
+    });
+    return entry ? serializeEntryAsMarkdown(entry) : null;
+}
+function applyPublicHeaders(response, noStore) {
+    const headers = new Headers(response.headers);
+    headers.set("cache-control", noStore ? PRIVATE_CACHE_CONTROL : PUBLIC_CACHE_CONTROL);
+    if (noStore)
+        headers.delete("cache-tag");
+    else
+        headers.set("cache-tag", PUBLIC_CACHE_TAG);
+    return new Response(response.body, {
+        status: response.status,
+        statusText: response.statusText,
+        headers,
+    });
+}
+function textNotFound() {
+    return new Response("not found", { status: 404, headers: TEXT_NO_STORE });
 }
 function canonicalLocaleParam(locale, locales) {
     const target = locale.toLowerCase();