bsmnt 0.13.1 → 0.15.0

package/src/templates/next-pagebuilder-cache/lib/utils/base-url.ts

@@ -3,15 +3,30 @@
  *
  * Priority:
  * 1. NEXT_PUBLIC_BASE_URL (explicit production URL)
- * 2. VERCEL_PROJECT_PRODUCTION_URL (Vercel production domain)
- * 3. VERCEL_URL (Vercel preview/deployment URL)
+ * 2. VERCEL_PROJECT_PRODUCTION_URL, on production deployments only
+ * 3. VERCEL_URL (the deployment's own URL, so previews never emit production URLs)
  * 4. http://localhost:3000 (local development)
  */
 export const getBaseUrl = () =>
   process.env.NEXT_PUBLIC_BASE_URL ||
-  (process.env.VERCEL_PROJECT_PRODUCTION_URL
+  (process.env.VERCEL_ENV === "production" &&
+  process.env.VERCEL_PROJECT_PRODUCTION_URL
     ? `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`
     : undefined) ||
   (process.env.VERCEL_URL
     ? `https://${process.env.VERCEL_URL}`
     : "http://localhost:3000")
+
+// The production build also answers on *.vercel.app; only the launch domain is indexed.
+export const getIndexableHost = () => {
+  const baseUrl = process.env.NEXT_PUBLIC_BASE_URL
+  // Off Vercel VERCEL_ENV is unset, and the configured host is the launch domain.
+  const vercelEnv = process.env.VERCEL_ENV
+  if (!baseUrl || (vercelEnv && vercelEnv !== "production")) return null
+  return URL.canParse(baseUrl) ? new URL(baseUrl).host : null
+}
+
+export const isIndexableHost = (host: string | null | undefined) => {
+  const indexable = getIndexableHost()
+  return indexable !== null && host?.toLowerCase() === indexable
+}

package/src/templates/next-pagebuilder-cache/lib/utils/breadcrumbs.ts

@@ -0,0 +1,70 @@
+import type { BREADCRUMB_PAGES_QUERY_RESULT } from "@/lib/integrations/sanity/sanity.types"
+
+type BreadcrumbPage = BREADCRUMB_PAGES_QUERY_RESULT[number]
+
+type Breadcrumb = {
+  name: string
+  url: string
+}
+
+const HOME_NAME = "Home"
+
+const trimSlashes = (path: string) => path.replace(/^\/+|\/+$/g, "")
+
+const firstNonEmpty = (...values: (string | null | undefined)[]) =>
+  values.find((value) => value?.trim())?.trim()
+
+const urlFor = (path: string) => (path ? `/${path}` : "/")
+
+const labelFor = (page: BreadcrumbPage | undefined) =>
+  page && firstNonEmpty(page.shortTitle, page.folderTitle, page.title)
+
+// Every parent path, not the path itself: "a/b/c" → ["a", "a/b"].
+const ancestorPaths = (path: string) => {
+  const segments = path.split("/").filter(Boolean)
+  return segments
+    .slice(0, -1)
+    .map((_, index) => segments.slice(0, index + 1).join("/"))
+}
+
+// The paths a page's crumbs are named from, besides the homepage: its
+// ancestors and itself.
+export const breadcrumbPaths = (path: string | null) => {
+  const current = trimSlashes(path ?? "")
+  return current ? [...ancestorPaths(current), current] : []
+}
+
+// Crumbs are named from the pages at each level, the current one included:
+// Short Title, then the folder name for a folder's index page, then Title. A
+// level with no page is skipped, so a crumb never links to a 404.
+export const buildBreadcrumbs = ({
+  path,
+  name,
+  pages,
+}: {
+  path: string | null
+  name: string
+  pages: readonly BreadcrumbPage[]
+}): Breadcrumb[] => {
+  const pageAt = (target: string) =>
+    pages.find((page) => trimSlashes(page.path ?? "") === target)
+
+  const home = pageAt("")
+  const crumbs: Breadcrumb[] = [
+    {
+      name: firstNonEmpty(home?.shortTitle, home?.title) ?? HOME_NAME,
+      url: "/",
+    },
+  ]
+
+  const current = trimSlashes(path ?? "")
+  if (!current) return crumbs
+
+  for (const ancestor of ancestorPaths(current)) {
+    const ancestorName = labelFor(pageAt(ancestor))
+    if (ancestorName) crumbs.push({ name: ancestorName, url: urlFor(ancestor) })
+  }
+
+  crumbs.push({ name: labelFor(pageAt(current)) ?? name, url: urlFor(current) })
+  return crumbs
+}

package/src/templates/next-pagebuilder-cache/next.config.ts

@@ -1,6 +1,10 @@
 import withBundleAnalyzer from "@next/bundle-analyzer"
 import type { NextConfig } from "next"
 import { sanity } from "next-sanity/live/cache-life"
+import { getIndexableHost } from "./lib/utils/base-url"
+
+// Only the launch domain is indexed; every other host is sent noindex.
+const indexableHost = getIndexableHost()
 
 const nextConfig: NextConfig = {
   cacheComponents: true,
@@ -97,6 +101,18 @@ const nextConfig: NextConfig = {
     imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
   },
   headers: async () => [
+    {
+      source: "/:path*",
+      ...(indexableHost && {
+        missing: [
+          {
+            type: "host" as const,
+            value: indexableHost.replaceAll(".", "\\."),
+          },
+        ],
+      }),
+      headers: [{ key: "X-Robots-Tag", value: "noindex" }],
+    },
     {
       // Excludes /studio* — must stay mutually exclusive with the rule below.
       source: "/((?!studio(?:/|$)).*)",

package/src/templates/next-pagebuilder-cache/package.json

@@ -17,7 +17,7 @@
     "knip": "knip",
     "knip:fix": "knip --fix",
     "lighthouse": "bunx @unlighthouse/cli --site http://localhost:3000",
-    "lint": "biome lint --max-diagnostics=200",
+    "lint": "biome ci --error-on-warnings --max-diagnostics=200 .",
     "lint:fix": "biome check --write --unsafe --max-diagnostics=200",
     "prepare": "lefthook install",
     "start": "next start",

package/src/templates/next-webgl/.env.example

@@ -33,7 +33,9 @@
 # Development: http://localhost:3000
 # Production: https://your-domain.com
 # Inlined at build time — scope this to the Production environment only in
-# Vercel so Preview deployments fall through to VERCEL_PROJECT_PRODUCTION_URL.
+# Vercel so Preview deployments fall through to their own VERCEL_URL. On a
+# production deployment it is also the only host that gets indexed: every other
+# host is sent `X-Robots-Tag: noindex` and a disallow-all robots.txt.
 NEXT_PUBLIC_BASE_URL=""
 
 # Draft mode secret for preview functionality

package/src/templates/next-webgl/app/layout.tsx

@@ -11,12 +11,13 @@ import {
   generateWebSiteJsonLd,
   JsonLd,
 } from "@/lib/utils/json-ld"
+import { getBaseUrl } from "@/lib/utils/url"
 
 const APP_NAME = AppData.name
 const APP_DEFAULT_TITLE = "Basement Starter"
 const APP_TITLE_TEMPLATE = "%s - Basement Starter"
 const APP_DESCRIPTION = AppData.description
-const APP_BASE_URL = process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000"
+const APP_BASE_URL = getBaseUrl()
 
 const geist = Geist({
   subsets: ["latin"],

package/src/templates/next-webgl/app/robots.ts

@@ -1,12 +1,18 @@
 import type { MetadataRoute } from "next"
-import { getBaseUrl } from "@/lib/utils/url"
+import { headers } from "next/headers"
+import { getBaseUrl, isIndexableHost } from "@/lib/utils/url"
+
+export default async function robots(): Promise<MetadataRoute.Robots> {
+  const host = (await headers()).get("host")
+  if (!isIndexableHost(host)) {
+    return { rules: { userAgent: "*", disallow: "/" } }
+  }
 
-export default function robots(): MetadataRoute.Robots {
   return {
     rules: {
       userAgent: "*",
       allow: "/",
-      disallow: [],
+      disallow: ["/api/", "/studio"],
     },
     sitemap: `${getBaseUrl()}/sitemap.xml`,
   }

package/src/templates/next-webgl/lib/utils/metadata.ts

@@ -1,4 +1,5 @@
 import type { Metadata } from "next"
+import { getBaseUrl } from "@/lib/utils/url"
 
 /**
  * Metadata Generation Utilities
@@ -26,7 +27,7 @@ interface GenerateMetadataOptions {
   authors?: string[]
 }
 
-const APP_BASE_URL = process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000"
+const APP_BASE_URL = getBaseUrl()
 
 /**
  * Generate complete metadata object for pages

package/src/templates/next-webgl/lib/utils/url.ts

@@ -3,17 +3,34 @@
  *
  * Priority:
  * 1. NEXT_PUBLIC_BASE_URL  - explicit override (custom domains)
- * 2. VERCEL_PROJECT_PRODUCTION_URL - auto-set by Vercel (production domain)
- * 3. VERCEL_URL - auto-set by Vercel (preview/branch deploys)
+ * 2. VERCEL_PROJECT_PRODUCTION_URL - auto-set by Vercel, on production deployments only
+ * 3. VERCEL_URL - the deployment's own URL, so previews never emit production URLs
  * 4. localhost fallback
  */
 export function getBaseUrl(): string {
   if (process.env.NEXT_PUBLIC_BASE_URL) {
     return process.env.NEXT_PUBLIC_BASE_URL
   }
-  if (process.env.VERCEL_PROJECT_PRODUCTION_URL) {
+  if (
+    process.env.VERCEL_ENV === "production" &&
+    process.env.VERCEL_PROJECT_PRODUCTION_URL
+  ) {
     return `https://${process.env.VERCEL_PROJECT_PRODUCTION_URL}`
   }
   if (process.env.VERCEL_URL) return `https://${process.env.VERCEL_URL}`
   return "http://localhost:3000"
 }
+
+// The production build also answers on *.vercel.app; only the launch domain is indexed.
+export function getIndexableHost(): string | null {
+  const baseUrl = process.env.NEXT_PUBLIC_BASE_URL
+  // Off Vercel VERCEL_ENV is unset, and the configured host is the launch domain.
+  const vercelEnv = process.env.VERCEL_ENV
+  if (!baseUrl || (vercelEnv && vercelEnv !== "production")) return null
+  return URL.canParse(baseUrl) ? new URL(baseUrl).host : null
+}
+
+export function isIndexableHost(host: string | null | undefined): boolean {
+  const indexable = getIndexableHost()
+  return indexable !== null && host?.toLowerCase() === indexable
+}

package/src/templates/next-webgl/next.config.ts

@@ -1,5 +1,9 @@
 import withBundleAnalyzer from "@next/bundle-analyzer"
 import type { NextConfig } from "next"
+import { getIndexableHost } from "./lib/utils/url"
+
+// Only the launch domain is indexed; every other host is sent noindex.
+const indexableHost = getIndexableHost()
 
 const nextConfig: NextConfig = {
   reactStrictMode: true,
@@ -92,6 +96,18 @@ const nextConfig: NextConfig = {
     imageSizes: [16, 32, 48, 64, 96, 128, 256, 384],
   },
   headers: async () => [
+    {
+      source: "/:path*",
+      ...(indexableHost && {
+        missing: [
+          {
+            type: "host" as const,
+            value: indexableHost.replaceAll(".", "\\."),
+          },
+        ],
+      }),
+      headers: [{ key: "X-Robots-Tag", value: "noindex" }],
+    },
     {
       // Excludes /studio* — must stay mutually exclusive with the rule below.
       source: "/((?!studio(?:/|$)).*)",

package/src/modules/features/cms/sanity-pagebuilder/files/lib/integrations/sanity/components/use-studio-preview-urls.ts

@@ -1,62 +0,0 @@
-import { useEffect, useState } from "react";
-import { useClient } from "sanity";
-import { apiVersion } from "@/lib/integrations/sanity/env";
-
-const PREVIEW_ASSETS_QUERY = `*[
-  _type == "studioPreview" &&
-  key in $keys &&
-  defined(preview.asset._ref)
-] | order(_updatedAt desc) {
-  key,
-  "url": preview.asset->url
-}`;
-
-type PreviewDocument = {
-	key: string | null;
-	url: string | null;
-};
-
-export type StudioPreviewUrls = Record<string, string>;
-
-const SEPARATOR = " ";
-
-/** `undefined` while in flight, so callers can tell loading from "no preview". */
-export function useStudioPreviewUrls(keys: readonly string[]) {
-	const client = useClient({ apiVersion });
-	const [urls, setUrls] = useState<StudioPreviewUrls>();
-	// Keys off contents, not array identity — callers pass a freshly mapped array.
-	const keyList = keys.join(SEPARATOR);
-
-	useEffect(() => {
-		if (!keyList) {
-			setUrls({});
-			return;
-		}
-
-		let cancelled = false;
-
-		client
-			.fetch<PreviewDocument[]>(PREVIEW_ASSETS_QUERY, {
-				keys: keyList.split(SEPARATOR),
-			})
-			.then((documents) => {
-				if (cancelled) return;
-				const next: StudioPreviewUrls = {};
-				for (const document of documents) {
-					if (document.key && document.url && !next[document.key]) {
-						next[document.key] = document.url;
-					}
-				}
-				setUrls(next);
-			})
-			.catch(() => {
-				if (!cancelled) setUrls({});
-			});
-
-		return () => {
-			cancelled = true;
-		};
-	}, [client, keyList]);
-
-	return urls;
-}

package/src/modules/features/cms/sanity-pagebuilder/files/lib/integrations/sanity/schemas/components/studio-preview.ts

@@ -1,37 +0,0 @@
-import { defineField, defineType } from "sanity";
-import { pageBuilderCardIcon } from "@/lib/integrations/sanity/icons";
-import { pageBuilderBlockPreviewOptions } from "@/lib/integrations/sanity/page-builder-config";
-
-export const studioPreview = defineType({
-	name: "studioPreview",
-	title: "Component Preview",
-	type: "document",
-	icon: pageBuilderCardIcon,
-	fields: [
-		defineField({
-			name: "key",
-			title: "Component",
-			type: "string",
-			options: { list: pageBuilderBlockPreviewOptions },
-			validation: (Rule) => Rule.required(),
-		}),
-		defineField({
-			name: "preview",
-			title: "Preview image",
-			type: "image",
-			options: { hotspot: true },
-			validation: (Rule) => Rule.required(),
-		}),
-	],
-	preview: {
-		select: { key: "key", media: "preview" },
-		prepare({ key, media }) {
-			return {
-				title:
-					pageBuilderBlockPreviewOptions.find((option) => option.value === key)
-						?.title ?? "Component Preview",
-				media,
-			};
-		},
-	},
-});

package/src/modules/features/cms/sanity-pagebuilder-cache/files/lib/integrations/sanity/components/use-studio-preview-urls.ts

@@ -1,62 +0,0 @@
-import { useEffect, useState } from "react";
-import { useClient } from "sanity";
-import { apiVersion } from "@/lib/integrations/sanity/env";
-
-const PREVIEW_ASSETS_QUERY = `*[
-  _type == "studioPreview" &&
-  key in $keys &&
-  defined(preview.asset._ref)
-] | order(_updatedAt desc) {
-  key,
-  "url": preview.asset->url
-}`;
-
-type PreviewDocument = {
-	key: string | null;
-	url: string | null;
-};
-
-export type StudioPreviewUrls = Record<string, string>;
-
-const SEPARATOR = " ";
-
-/** `undefined` while in flight, so callers can tell loading from "no preview". */
-export function useStudioPreviewUrls(keys: readonly string[]) {
-	const client = useClient({ apiVersion });
-	const [urls, setUrls] = useState<StudioPreviewUrls>();
-	// Keys off contents, not array identity — callers pass a freshly mapped array.
-	const keyList = keys.join(SEPARATOR);
-
-	useEffect(() => {
-		if (!keyList) {
-			setUrls({});
-			return;
-		}
-
-		let cancelled = false;
-
-		client
-			.fetch<PreviewDocument[]>(PREVIEW_ASSETS_QUERY, {
-				keys: keyList.split(SEPARATOR),
-			})
-			.then((documents) => {
-				if (cancelled) return;
-				const next: StudioPreviewUrls = {};
-				for (const document of documents) {
-					if (document.key && document.url && !next[document.key]) {
-						next[document.key] = document.url;
-					}
-				}
-				setUrls(next);
-			})
-			.catch(() => {
-				if (!cancelled) setUrls({});
-			});
-
-		return () => {
-			cancelled = true;
-		};
-	}, [client, keyList]);
-
-	return urls;
-}

package/src/modules/features/cms/sanity-pagebuilder-cache/files/lib/integrations/sanity/schemas/components/studio-preview.ts

@@ -1,37 +0,0 @@
-import { defineField, defineType } from "sanity";
-import { pageBuilderCardIcon } from "@/lib/integrations/sanity/icons";
-import { pageBuilderBlockPreviewOptions } from "@/lib/integrations/sanity/page-builder-config";
-
-export const studioPreview = defineType({
-	name: "studioPreview",
-	title: "Component Preview",
-	type: "document",
-	icon: pageBuilderCardIcon,
-	fields: [
-		defineField({
-			name: "key",
-			title: "Component",
-			type: "string",
-			options: { list: pageBuilderBlockPreviewOptions },
-			validation: (Rule) => Rule.required(),
-		}),
-		defineField({
-			name: "preview",
-			title: "Preview image",
-			type: "image",
-			options: { hotspot: true },
-			validation: (Rule) => Rule.required(),
-		}),
-	],
-	preview: {
-		select: { key: "key", media: "preview" },
-		prepare({ key, media }) {
-			return {
-				title:
-					pageBuilderBlockPreviewOptions.find((option) => option.value === key)
-						?.title ?? "Component Preview",
-				media,
-			};
-		},
-	},
-});