@tokenoftrust/storefront-runner 2.4.23 → 2.4.25

package/apps/storefront/src/pages/blog/[slug].astro

@@ -14,6 +14,7 @@ import { readViewerSession, safeNext } from "@/lib/auth/route.js";
 import { buildAlternates } from "@/lib/seo/alternates.js";
 import { languageLabel } from "@/lib/i18n.js";
 import { breadcrumbLd, blogPostingLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 // These redirects also exist in the published artifact: the publication composition lifts this
 // file into the space's `routes.aliases`, which reach the CDN plane through the live pointer. The
@@ -24,13 +25,14 @@ import { breadcrumbLd, blogPostingLd } from "@/lib/jsonld.js";
 export const MATERIALIZED_REDIRECT_SOURCE = "content/blog/redirects.json";
 
 const { tenant, canonicalBase, basePath, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const slug = Astro.params.slug ?? "";
 const post = await getBlogPost(tenant.tenant_id, slug, content, publicationTimestamp);
 if (!post) {
   const redirect = await resolveBlogRedirect(tenant.tenant_id, slug, content);
   // 308, matching the `redirect-308` alias contract the published plane serves, so a renamed slug
   // behaves identically on both substrates.
-  if (redirect) return Astro.redirect(`${basePath}/blog/${redirect}/`, 308);
+  if (redirect) return Astro.redirect(`${basePath}${blogPaths.post(redirect)}`, 308);
   return new Response(null, { status: 404 });
 }
 
@@ -41,10 +43,10 @@ const viewer = await readViewerSession(Astro);
 const gated = (post.access ?? "public") !== "public";
 const unlock = viewerHasBlogAccess(viewer, post);
 const bodyHtml = articleBodyHtml(post.contentHtml, { gated, unlock });
-const next = safeNext(`${basePath}/blog/${post.slug}/`);
+const next = safeNext(`${basePath}${blogPaths.post(post.slug)}`);
 const loginHref = `/auth/login?next=${encodeURIComponent(next)}`;
 
-const canonical = new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString();
+const canonical = new URL(blogPaths.post(post.slug), canonicalBase + "/").toString();
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 // A post that names no author has no byline: never attribute it to anyone (the blog's title, the
 // store) its content does not name.
@@ -64,10 +66,10 @@ const authorHasArchive = authorArchiveSlug !== "" && listed.some(
 const archivedTags = new Set(listed.flatMap((p) => p.tags.map(categorySlug)));
 const tagLinks = post.tags.map((tag) => {
   const slug = categorySlug(tag);
-  return { label: tag, href: slug && archivedTags.has(slug) ? `${basePath}/blog/tag/${slug}/` : null };
+  return { label: tag, href: slug && archivedTags.has(slug) ? `${basePath}${blogPaths.tag(slug)}` : null };
 });
 const authorUrl = authorHasArchive
-  ? new URL(`/blog/author/${authorArchiveSlug}/`, canonicalBase + "/").toString()
+  ? new URL(blogPaths.author(authorArchiveSlug), canonicalBase + "/").toString()
   : undefined;
 const articleLd = blogPostingLd(post, {
   url: canonical,
@@ -77,13 +79,13 @@ const articleLd = blogPostingLd(post, {
 });
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
-  { label: post.title, href: `/blog/${post.slug}/` },
+  { label: "Blog", href: blogPaths.index },
+  { label: post.title, href: blogPaths.post(post.slug) },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
-const blogHref = `${basePath}/blog/`;
+const blogHref = `${basePath}${blogPaths.index}`;
 const authorHref = authorHasArchive
-  ? `${basePath}/blog/author/${authorArchiveSlug}/`
+  ? `${basePath}${blogPaths.author(authorArchiveSlug)}`
   : null;
 const share = shareLinks(presentation.share, {
   url: canonical,
@@ -97,7 +99,7 @@ const translations = post.translationGroupId
   ? await getTranslations(tenant.tenant_id, "blog", post.slug, { content, now: publicationTimestamp })
   : [];
 const alternates = buildAlternates(translations, (s) =>
-  new URL(`/blog/${s}/`, canonicalBase + "/").toString(),
+  new URL(blogPaths.post(s), canonicalBase + "/").toString(),
 );
 const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 ---
@@ -105,7 +107,7 @@ const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 <Layout
   title={post.seoTitle || post.title}
   description={post.description}
-  path={`/blog/${post.slug}/`}
+  path={blogPaths.post(post.slug)}
   ogType="article"
   ogImage={post.featuredImage?.src}
   noindex={post.status === "unlisted"}
@@ -145,7 +147,7 @@ const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
             return (
               <a
                 hreflang={code}
-                href={`${basePath}/blog/${variant.slug}/`}
+                href={`${basePath}${blogPaths.post(variant.slug)}`}
                 aria-current={current ? "true" : undefined}
               >{languageLabel(code)}</a>
             );

package/apps/storefront/src/pages/blog/author/[author].astro

@@ -7,11 +7,13 @@ import { resolveBlogPresentation } from "@/lib/blog/presentation.js";
 import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { authorSlug, getAuthors } from "@/lib/blog/collection.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 // Author archive for the `/blog` collection. Lists exactly the posts whose
 // bylines link here (same source as /blog/index.astro + /blog/[slug].astro),
 // so a byline never points at a page missing its post.
 const { tenant, basePath, canonicalBase, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const slug = Astro.params.author ?? "";
 
 const allPosts = await listBlogPosts(tenant.tenant_id, content, publicationTimestamp);
@@ -22,7 +24,7 @@ const authorName = posts[0]!.author;
 const bio = (await getAuthors(tenant.tenant_id, "blog", content))[slug];
 
 const href = (path: string) => `${basePath}${path}` || "/";
-const canonical = new URL(`/blog/author/${slug}/`, canonicalBase + "/").toString();
+const canonical = new URL(blogPaths.author(slug), canonicalBase + "/").toString();
 const avatarUrl = bio?.avatar ? new URL(bio.avatar, canonicalBase + "/").toString() : undefined;
 
 const personLd = {
@@ -49,14 +51,14 @@ const itemListLd = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(blogPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
-  { label: authorName, href: `/blog/author/${slug}/` },
+  { label: "Blog", href: blogPaths.index },
+  { label: authorName, href: blogPaths.author(slug) },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
 ---
@@ -64,7 +66,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
 <Layout
   title={`${authorName} — Blog`}
   description={bio?.bio ?? `Articles by ${authorName}.`}
-  path={`/blog/author/${slug}/`}
+  path={blogPaths.author(slug)}
   fullBleed
   jsonLd={[crumbs, profileLd, itemListLd]}
 >
@@ -92,7 +94,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
     <section class="post-grid" aria-label={`Posts by ${authorName}`}>
       {posts.map((post, index) => (
         <article class="post-card">
-          <a href={href(`/blog/${post.slug}/`)} aria-label={`Read ${post.title}`}>
+          <a href={href(blogPaths.post(post.slug))} aria-label={`Read ${post.title}`}>
             {post.featuredImage ? (
               <img
                 src={post.featuredImage.src}

package/apps/storefront/src/pages/blog/category/[category].astro

@@ -7,8 +7,10 @@ import { collectPostsByTerm } from "@/lib/blog/collection.js";
 import { resolveBlogPresentation } from "@/lib/blog/presentation.js";
 import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 const { tenant, basePath, canonicalBase, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const param = Astro.params.category ?? "";
 
 // Same source as the /blog index (the collection's curated list), filtered to
@@ -19,7 +21,7 @@ if (!match) return new Response(null, { status: 404 });
 const { label, posts } = match;
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 
-const path = `/blog/category/${param}/`;
+const path = blogPaths.category(param);
 const itemList = {
   "@context": "https://schema.org",
   "@type": "ItemList",
@@ -28,12 +30,12 @@ const itemList = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(blogPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
+  { label: "Blog", href: blogPaths.index },
   { label, href: path },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
@@ -56,7 +58,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
   </header>
 
   <div class="blog-shell blog-layout">
-    <PostGrid posts={posts} basePath={basePath} base="/blog" />
+    <PostGrid posts={posts} basePath={basePath} paths={blogPaths} />
   </div>
 </Layout>
 

package/apps/storefront/src/pages/blog/tag/[tag].astro

@@ -7,8 +7,10 @@ import { collectPostsByTerm } from "@/lib/blog/collection.js";
 import { resolveBlogPresentation } from "@/lib/blog/presentation.js";
 import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 const { tenant, basePath, canonicalBase, content, publicationTimestamp } = Astro.locals;
+const blogPaths = collectionPathsV1(Astro.locals, "blog");
 const param = Astro.params.tag ?? "";
 
 const all = await listBlogPosts(tenant.tenant_id, content, publicationTimestamp);
@@ -17,7 +19,7 @@ if (!match) return new Response(null, { status: 404 });
 const { label, posts } = match;
 const presentation = resolveBlogPresentation(await getBlogSettings(tenant.tenant_id, content));
 
-const path = `/blog/tag/${param}/`;
+const path = blogPaths.tag(param);
 const itemList = {
   "@context": "https://schema.org",
   "@type": "ItemList",
@@ -26,12 +28,12 @@ const itemList = {
     "@type": "ListItem",
     position: index + 1,
     name: post.title,
-    url: new URL(`/blog/${post.slug}/`, canonicalBase + "/").toString(),
+    url: new URL(blogPaths.post(post.slug), canonicalBase + "/").toString(),
   })),
 };
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "Blog", href: "/blog/" },
+  { label: "Blog", href: blogPaths.index },
   { label: `#${label}`, href: path },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
@@ -54,7 +56,7 @@ const crumbs = breadcrumbLd(trail, canonicalBase);
   </header>
 
   <div class="blog-shell blog-layout">
-    <PostGrid posts={posts} basePath={basePath} base="/blog" />
+    <PostGrid posts={posts} basePath={basePath} paths={blogPaths} />
   </div>
 </Layout>
 

package/apps/storefront/src/pages/llms.txt.ts

@@ -20,6 +20,7 @@ import {
   readMountedPublicationDiscoveryV1,
   rootOwnsDiscoveryPathV1,
 } from "@/lib/publication/mountedDiscovery.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 /** Collapse HTML/whitespace to a single trimmed line for a link description. */
 function oneLine(s: string | undefined, max = 140): string | undefined {
@@ -31,6 +32,7 @@ function oneLine(s: string | undefined, max = 140): string | undefined {
 
 export async function GET(context: APIContext): Promise<Response> {
   const { tot, tenant, canonicalBase, content, publicationTimestamp } = context.locals;
+  const blogPaths = collectionPathsV1(context.locals, "blog");
   const base = canonicalBase.replace(/\/$/, "");
 
   // Use the request-resolved ContentProvider (locals.content) so any published /
@@ -54,9 +56,9 @@ export async function GET(context: APIContext): Promise<Response> {
   const pages = index
     ? rootPages.filter((pg) => rootOwnsDiscoveryPathV1(index, `/${pg.slug}`))
     : rootPages;
-  const rootOwnsBlogIndex = !index || rootOwnsDiscoveryPathV1(index, "/blog/");
+  const rootOwnsBlogIndex = !index || rootOwnsDiscoveryPathV1(index, blogPaths.index);
   const blogPosts = index
-    ? rootBlogPosts.filter((post) => rootOwnsDiscoveryPathV1(index, `/blog/${post.slug}/`))
+    ? rootBlogPosts.filter((post) => rootOwnsDiscoveryPathV1(index, blogPaths.post(post.slug)))
     : rootBlogPosts;
   const mounted = index
     ? (await readMountedPublicationDiscoveryV1({ tenant, store: await readKv("TENANT_CACHE"), index }))
@@ -108,10 +110,10 @@ export async function GET(context: APIContext): Promise<Response> {
 
   if (blogPosts.length) {
     lines.push("## Blog");
-    if (rootOwnsBlogIndex) lines.push(`- [All articles](${base}/blog/)`);
+    if (rootOwnsBlogIndex) lines.push(`- [All articles](${base}${blogPaths.index})`);
     for (const post of blogPosts) {
       const desc = oneLine(post.description || post.excerpt);
-      lines.push(`- [${post.title}](${base}/blog/${post.slug}/)${desc ? `: ${desc}` : ""}`);
+      lines.push(`- [${post.title}](${base}${blogPaths.post(post.slug)})${desc ? `: ${desc}` : ""}`);
     }
     lines.push("");
   }

package/apps/storefront/src/pages/sitemap.xml.ts

@@ -24,6 +24,7 @@ import {
   readMountedPublicationDiscoveryV1,
   rootOwnsDiscoveryPathV1,
 } from "@/lib/publication/mountedDiscovery.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 interface SitemapUrl {
   loc: string;
@@ -43,6 +44,8 @@ function escapeXml(value: string): string {
 export async function GET(context: APIContext): Promise<Response> {
   const { tot, tenant, canonicalBase, content, features, publicationTimestamp } = context.locals;
   const base = canonicalBase.replace(/\/$/, "");
+  const blogPaths = collectionPathsV1(context.locals, "blog");
+  const buildPaths = collectionPathsV1(context.locals, "the-build");
 
   const urls: SitemapUrl[] = [{ loc: `${base}/` }];
 
@@ -85,7 +88,7 @@ export async function GET(context: APIContext): Promise<Response> {
 
   const blogPosts = await listBlogPosts(tenant.tenant_id, content, publicationTimestamp);
   if (blogPosts.length > 0) {
-    urls.push({ loc: `${base}/blog/` });
+    urls.push({ loc: `${base}${blogPaths.index}` });
     // Paginated pages (N≥2) — the static materializer discovers these new routes
     // straight off this list (withSitemapRoutes in scripts/publish/lib/routes.mjs),
     // so listing them here is what makes /blog/page/N/ exist in BOTH serving
@@ -93,9 +96,9 @@ export async function GET(context: APIContext): Promise<Response> {
     const blogSettings = await getBlogSettings(tenant.tenant_id, content);
     const { pageSize } = resolveBlogIndexCopy(blogSettings, tenant.displayName);
     const totalBlogPages = Math.max(1, Math.ceil(blogPosts.length / pageSize));
-    for (let n = 2; n <= totalBlogPages; n++) urls.push({ loc: `${base}/blog/page/${n}/` });
+    for (let n = 2; n <= totalBlogPages; n++) urls.push({ loc: `${base}${blogPaths.page(n)}` });
     for (const post of blogPosts) {
-      urls.push({ loc: `${base}/blog/${post.slug}/`, lastmod: post.modifiedAt || post.publishedAt });
+      urls.push({ loc: `${base}${blogPaths.post(post.slug)}`, lastmod: post.modifiedAt || post.publishedAt });
     }
     // Author archives (blog/author/[author].astro): one per distinct byline,
     // same source as the pages themselves so the sitemap never lists an
@@ -105,25 +108,25 @@ export async function GET(context: APIContext): Promise<Response> {
       ...new Set(blogPosts.map((post) => authorSlug(post.author)).filter(Boolean)),
     ].sort();
     for (const slug of authorSlugs) {
-      urls.push({ loc: `${base}/blog/author/${slug}/` });
+      urls.push({ loc: `${base}${blogPaths.author(slug)}` });
     }
     const categorySlugs = [...new Set(blogPosts.flatMap((post) => post.categories.map(categorySlug)).filter(Boolean))].sort();
     const tagSlugs = [...new Set(blogPosts.flatMap((post) => post.tags.map(categorySlug)).filter(Boolean))].sort();
-    for (const slug of categorySlugs) urls.push({ loc: `${base}/blog/category/${slug}/` });
-    for (const slug of tagSlugs) urls.push({ loc: `${base}/blog/tag/${slug}/` });
+    for (const slug of categorySlugs) urls.push({ loc: `${base}${blogPaths.category(slug)}` });
+    for (const slug of tagSlugs) urls.push({ loc: `${base}${blogPaths.tag(slug)}` });
   }
 
   const buildPosts = await listBuildPosts(tenant.tenant_id, { content, now: publicationTimestamp });
   if (buildPosts.length > 0) {
-    urls.push({ loc: `${base}/the-build/` });
+    urls.push({ loc: `${base}${buildPaths.index}` });
     // Paginated pages (N≥2), same reasoning as /blog/page/N/ above: the static
     // materializer discovers these new routes straight off this list.
     const buildSettings = await getTheBuildSettings(tenant.tenant_id, content);
     const { pageSize } = resolveTheBuildIndexCopy(buildSettings, tenant.displayName);
     const totalBuildPages = Math.max(1, Math.ceil(buildPosts.length / pageSize));
-    for (let n = 2; n <= totalBuildPages; n++) urls.push({ loc: `${base}/the-build/page/${n}/` });
+    for (let n = 2; n <= totalBuildPages; n++) urls.push({ loc: `${base}${buildPaths.page(n)}` });
     for (const post of buildPosts) {
-      urls.push({ loc: `${base}/the-build/${post.slug}/`, lastmod: post.modifiedAt || post.publishedAt });
+      urls.push({ loc: `${base}${buildPaths.post(post.slug)}`, lastmod: post.modifiedAt || post.publishedAt });
     }
   }
 

package/apps/storefront/src/pages/tenants/[id]/[...path].ts

@@ -17,6 +17,10 @@
  * Preview sessions also consult the image-capture rewrite overlay so rewritten
  * `public/*.css` (and similar text assets) serve `/_a/<sha>` references.
  *
+ * A tenant whose ROOT is a publication space serves these paths from that space's selected version
+ * (its public asset lane, `<namespace>/<path>`), the same URL a whole-site tenant serves them at;
+ * otherwise the legacy asset pointer below answers.
+ *
  * Version selection, in order: a candidate/revision pin (`tot_preview_version` +
  * token cookie); else, for a shared-preview viewer (preview host, or a valid token
  * for this tenant), the version the content `preview` channel serves — what the
@@ -24,11 +28,18 @@
  */
 import type { APIContext } from "astro";
 import {
+  ASSET_CACHE_CONTROL,
   assetContentType,
+  compileRouteTierIndexV1,
+  parsePublicationVersionStateV1Json,
   parseTenantAssetPath,
+  publicationVersionStateKey,
+  readPublicationRootAssetV1,
   resolveChannelVersion,
   serveTenantAsset,
+  type PublicationArtifactReadBucketV1,
   type R2BucketLike,
+  type TenantConfig,
 } from "@tot/public-runtime";
 import { readWithImagePreviewRewriteOverlay } from "@tot/public-runtime/image-preview-rewrite-overlay";
 import { readR2, readKv, readEnv } from "@/lib/env";
@@ -68,6 +79,42 @@ async function tryServePreviewRewriteOverlay(input: {
   });
 }
 
+/** The root publication space's asset, or null when the tenant's root is not a selected space. */
+async function tryServePublicationRootAsset(input: {
+  /** The tenant the request resolved to (`Astro.locals.tenant`). */
+  tenant: TenantConfig | undefined;
+  bucket: PublicationArtifactReadBucketV1;
+  kvGet: (key: string) => Promise<string | null>;
+  tenantId: string;
+  pathname: string;
+  channel: "live" | "preview";
+  ifNoneMatch: string | null;
+}): Promise<Response | null> {
+  const parsed = parseTenantAssetPath(input.pathname);
+  if (!parsed || parsed.tenantId !== input.tenantId) return null;
+  const tenant = input.tenant;
+  if (!tenant || tenant.tenant_id !== input.tenantId ||
+    !tenant.publicationSpaces?.some((space) => space.routes.canonicalMount === "/")) return null;
+  const stateJson = await input.kvGet(publicationVersionStateKey(input.tenantId));
+  if (stateJson === null) return null;
+  const state = parsePublicationVersionStateV1Json(stateJson);
+  if (!state.ok) return null;
+  const read = await readPublicationRootAssetV1({
+    index: compileRouteTierIndexV1(tenant), state: state.value, channel: input.channel,
+    bucket: input.bucket, relativePath: parsed.rel,
+  });
+  if (read.status === "legacy-root") return null;
+  if (read.status === "absent") {
+    return new Response("Not found", { status: 404, headers: { "cache-control": "no-store" } });
+  }
+  const etag = `"${read.sha256}"`;
+  const headers = { "content-type": assetContentType(parsed.rel), "cache-control": ASSET_CACHE_CONTROL, etag };
+  if (input.ifNoneMatch && input.ifNoneMatch.split(",").some((value) => value.trim().replace(/^W\//, "") === etag)) {
+    return new Response(null, { status: 304, headers });
+  }
+  return new Response(read.bytes as Uint8Array<ArrayBuffer>, { status: 200, headers });
+}
+
 export async function GET(context: APIContext): Promise<Response> {
   const [bucket, kv] = await Promise.all([
     readR2("TENANT_ASSETS"),
@@ -106,6 +153,17 @@ export async function GET(context: APIContext): Promise<Response> {
   const previewVersionId = pinnedVersionId ?? sharedPreview.versionId;
 
   const pathname = url.pathname;
+  const fromPublication = await tryServePublicationRootAsset({
+    tenant: context.locals.tenant,
+    bucket: bucket as unknown as PublicationArtifactReadBucketV1,
+    kvGet: (key) => kv.get(key),
+    tenantId: urlTenant,
+    pathname,
+    channel: sharedPreview.preview || context.locals.customizationEnv === "test" ? "preview" : "live",
+    ifNoneMatch: context.request.headers.get("if-none-match"),
+  });
+  if (fromPublication) return fromPublication;
+
   if (previewVersionId) {
     const overlay = await tryServePreviewRewriteOverlay({
       kvGet: (key) => kv.get(key),

package/apps/storefront/src/pages/the-build/[slug].astro

@@ -14,6 +14,7 @@ import { homeCrumbLabel, siteTrail } from "@/lib/breadcrumbs.js";
 import { getTranslations } from "@/lib/blog/collection.js";
 import { buildAlternates } from "@/lib/seo/alternates.js";
 import { breadcrumbLd } from "@/lib/jsonld.js";
+import { collectionPathsV1 } from "@/lib/blog/collectionPaths.js";
 
 // Same contract as blog/[slug].astro: the publication composition lifts this file into the space's
 // `routes.aliases`, so these redirects reach the CDN plane through the live pointer. The redirect
@@ -21,16 +22,17 @@ import { breadcrumbLd } from "@/lib/jsonld.js";
 export const MATERIALIZED_REDIRECT_SOURCE = "content/the-build/redirects.json";
 
 const { tenant, canonicalBase, basePath, content, publicationTimestamp } = Astro.locals;
+const buildPaths = collectionPathsV1(Astro.locals, "the-build");
 const slug = Astro.params.slug ?? "";
 const post = await getBuildPost(tenant.tenant_id, slug, { content, now: publicationTimestamp });
 if (!post) {
   const redirect = await resolveBuildRedirect(tenant.tenant_id, slug, content);
   // 308, matching the `redirect-308` alias contract the published plane serves.
-  if (redirect) return Astro.redirect(`${basePath}/the-build/${redirect}/`, 308);
+  if (redirect) return Astro.redirect(`${basePath}${buildPaths.post(redirect)}`, 308);
   return new Response(null, { status: 404 });
 }
 
-const canonical = new URL(`/the-build/${post.slug}/`, canonicalBase + "/").toString();
+const canonical = new URL(buildPaths.post(post.slug), canonicalBase + "/").toString();
 const presentation = resolveBlogPresentation(await getTheBuildSettings(tenant.tenant_id, content));
 // A post that names no author has no byline and no structured-data author.
 const author = bylineAuthor(post.author);
@@ -49,8 +51,8 @@ const articleLd = {
 };
 const trail = siteTrail(
   homeCrumbLabel(await content.getChrome()),
-  { label: "The Build", href: "/the-build/" },
-  { label: post.title, href: `/the-build/${post.slug}/` },
+  { label: "The Build", href: buildPaths.index },
+  { label: post.title, href: buildPaths.post(post.slug) },
 );
 const crumbs = breadcrumbLd(trail, canonicalBase);
 const share = shareLinks(presentation.share, {
@@ -58,7 +60,7 @@ const share = shareLinks(presentation.share, {
   title: post.title,
   image: post.featuredImage ? new URL(post.featuredImage.src, canonicalBase + "/").toString() : undefined,
 });
-const buildHref = `${basePath}/the-build/`;
+const buildHref = `${basePath}${buildPaths.index}`;
 
 // I2 — hreflang alternates + per-variant <html lang>. `getTranslations` returns
 // the live-visible variant set (self + siblings); `buildAlternates` yields [] for
@@ -69,7 +71,7 @@ const translations = await getTranslations(tenant.tenant_id, THE_BUILD.id, post.
   now: publicationTimestamp,
 });
 const alternates = buildAlternates(translations, (s) =>
-  new URL(`/the-build/${s}/`, canonicalBase + "/").toString(),
+  new URL(buildPaths.post(s), canonicalBase + "/").toString(),
 );
 const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 ---
@@ -77,7 +79,7 @@ const lang = alternates.length ? (post.inLanguage ?? "en") : undefined;
 <Layout
   title={post.seoTitle || post.title}
   description={post.description}
-  path={`/the-build/${post.slug}/`}
+  path={buildPaths.post(post.slug)}
   ogType="article"
   ogImage={post.featuredImage?.src}
   noindex={post.status === "unlisted"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tokenoftrust/storefront-runner",
-  "version": "2.4.23",
+  "version": "2.4.25",
   "license": "SEE LICENSE IN LICENSE",
   "description": "World-shareable storefront runner: multi-tenant renderer on Astro/Cloudflare. No control plane.",
   "packageManager": "pnpm@11.9.0",

package/packages/public-runtime/package.json

@@ -20,6 +20,7 @@
     "./catalog-files": "./src/catalog-files.ts",
     "./embed-catalog": "./src/embed-catalog.mjs",
     "./retention-holds": "./src/retention-holds.ts",
+    "./publication-content-redirects": "./src/publication-content-redirects.ts",
     "./tenant-embed-defaults": "./src/tenant-embed-defaults.mjs",
     "./declared-tenant-config": "./src/declared-tenant-config.mjs",
     "./compliance-coherence": "./src/compliance-coherence.mjs",

package/packages/public-runtime/schemas/publication-space/v1/manifest.schema.json

@@ -77,6 +77,27 @@
               }
             ]
           }
+        },
+        "collections": {
+          "type": "object",
+          "additionalProperties": false,
+          "properties": {
+            "blog": { "$ref": "#/$defs/collectionBase" },
+            "the-build": { "$ref": "#/$defs/collectionBase" }
+          }
+        },
+        "externalRedirects": {
+          "description": "Exact paths the ROOT space sends to another origin; a mounted space declares none.",
+          "type": "array",
+          "items": {
+            "type": "object",
+            "additionalProperties": false,
+            "required": ["from", "to"],
+            "properties": {
+              "from": { "$ref": "#/$defs/path" },
+              "to": { "type": "string", "pattern": "^https://[^/?#@\\s]+(?:/[^?#\\s]*)?$" }
+            }
+          }
         }
       }
     },
@@ -167,6 +188,10 @@
     }
   ],
   "$defs": {
+    "collectionBase": {
+      "type": "string",
+      "pattern": "^(?:[a-z0-9]+(?:-[a-z0-9]+)*(?:/[a-z0-9]+(?:-[a-z0-9]+)*)*)?$"
+    },
     "identifier": {
       "type": "string",
       "pattern": "^[a-z0-9](?:[a-z0-9._-]{0,126}[a-z0-9])?$"

package/packages/public-runtime/src/blog-visibility.d.mts

@@ -7,3 +7,23 @@ export declare function exactPublicationTimestamp(value: unknown): string | null
 export declare function publicationAggregateClockV1(spaces: unknown): string | null;
 export declare function isBlogPostVisibleOnLive(post: BlogVisibilityInput, now?: string | null): boolean;
 export declare function isBlogPostListableOnLive(post: BlogVisibilityInput, now?: string | null): boolean;
+
+export type PublicationCollectionV1 = "blog" | "the-build";
+export declare const PUBLICATION_COLLECTIONS_V1: readonly PublicationCollectionV1[];
+export declare const DEFAULT_COLLECTION_PAGE_SIZE_V1: number;
+export type PublicationCollectionRouteV1 =
+  | { kind: "index" }
+  | { kind: "page"; page: number }
+  | { kind: "post"; slug: string }
+  | { kind: "author" | "category" | "tag"; slug: string }
+  | { kind: "rss" };
+export declare function publicationCollectionBaseV1(
+  manifest: { routes?: { collections?: Partial<Record<PublicationCollectionV1, string>> } } | null | undefined,
+  collection: PublicationCollectionV1,
+): string;
+export declare function publicationCollectionPathV1(mount: string, base: string, route: PublicationCollectionRouteV1): string;
+export declare function publicationCollectionOfV1(
+  manifest: { routes?: { collections?: Partial<Record<PublicationCollectionV1, string>> } } | null | undefined,
+  contentPath: string,
+): { collection: PublicationCollectionV1; rest: string } | null;
+export declare function isPublicationCollectionBaseV1(value: unknown): value is string;