bsmnt 0.4.1 → 0.4.2

package/src/{helpers/integrate → modules/features/cms}/sanity/files/app/layout.tsx

@@ -9,13 +9,13 @@ import { fontsVariable } from "@/lib/styles/fonts";
 import AppData from "@/package.json";
 import "@/lib/styles/css/index.css";
 import { cn } from "@/lib/styles/cn";
-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 = getBaseUrl();
+const APP_BASE_URL =
+	process.env.NEXT_PUBLIC_BASE_URL ?? "http://localhost:3000";
 
 const geist = Geist({
 	subsets: ["latin"],

package/src/{helpers/integrate → modules/features/cms}/sanity/files/app/sitemap.md/route.ts

@@ -1,11 +1,8 @@
 import { NextResponse } from "next/server";
 import { isSanityConfigured } from "@/lib/integrations/check-integration";
-import { getBaseUrl } from "@/lib/utils/url";
-
-export const dynamic = "force-dynamic";
 
 export async function GET() {
-	const baseUrl = getBaseUrl();
+	const baseUrl = process.env.NEXT_PUBLIC_BASE_URL || "http://localhost:3000";
 
 	if (!isSanityConfigured()) {
 		return new NextResponse(
@@ -17,13 +14,13 @@ export async function GET() {
 	}
 
 	try {
-		const { client } = await import("@/lib/integrations/sanity/client");
-		const {
-			SITEMAP_ARTICLES_QUERY,
-			SITEMAP_PAGES_QUERY,
-		} = await import("@/lib/integrations/sanity/queries");
+		const sanityModule = await import("@/lib/integrations/sanity/client");
+		const sanityGroq = await import("next-sanity");
+
+		const client = sanityModule?.client;
+		const groq = sanityGroq?.groq;
 
-		if (!client) {
+		if (!(client && groq)) {
 			return new NextResponse("# Sitemap\n\nUnable to connect to CMS.", {
 				status: 503,
 				headers: { "Content-Type": "text/markdown; charset=utf-8" },
@@ -31,15 +28,18 @@ export async function GET() {
 		}
 
 		type SanityDoc = {
-			title?: string;
+			title: string;
 			slug: { current: string };
 			_updatedAt: string;
 		};
 
-		const [articles, pages] = await Promise.all([
-			client.fetch<SanityDoc[]>(SITEMAP_ARTICLES_QUERY),
-			client.fetch<SanityDoc[]>(SITEMAP_PAGES_QUERY),
-		]);
+		const articles = await client.fetch<SanityDoc[]>(
+			groq`*[_type == "article" && defined(slug.current)] | order(publishedAt desc) {
+					title,
+					slug,
+					_updatedAt
+				}`,
+		);
 
 		const parts = [
 			`# ${new URL(baseUrl).hostname} - Content Sitemap`,
@@ -52,26 +52,14 @@ export async function GET() {
 		if (articles.length > 0) {
 			parts.push("## Articles", "");
 			for (const article of articles) {
-				const title = article.title || article.slug.current;
-				parts.push(
-					`- [${title}](${baseUrl}/blog/${article.slug.current}.md)`,
-				);
-			}
-			parts.push("");
-		}
-
-		if (pages.length > 0) {
-			parts.push("## Pages", "");
-			for (const page of pages) {
-				const title = page.title || page.slug.current;
 				parts.push(
-					`- [${title}](${baseUrl}/${page.slug.current}.md)`,
+					`- [${article.title}](${baseUrl}/blog/${article.slug.current}.md)`,
 				);
 			}
 			parts.push("");
 		}
 
-		if (articles.length === 0 && pages.length === 0) {
+		if (articles.length === 0) {
 			parts.push("No content published yet.", "");
 		}
 
@@ -81,6 +69,7 @@ export async function GET() {
 			headers: {
 				"Content-Type": "text/markdown; charset=utf-8",
 				"X-Content-Type-Options": "nosniff",
+				"Cache-Control": "public, s-maxage=3600, stale-while-revalidate=600",
 			},
 		});
 	} catch (error) {

package/src/modules/features/cms/sanity/files/app/sitemap.xml/route.ts

@@ -0,0 +1,51 @@
+import { getBaseUrl } from "@/lib/utils/url";
+
+const BASE_URL = getBaseUrl();
+
+export const dynamic = "force-dynamic";
+
+interface SitemapEntry {
+	loc: string;
+	lastmod: string;
+	changefreq: string;
+	priority: number;
+}
+
+function toXml(entries: SitemapEntry[]): string {
+	const urls = entries
+		.map(
+			(entry) => `
+  <url>
+    <loc>${entry.loc}</loc>
+    <lastmod>${entry.lastmod}</lastmod>
+    <changefreq>${entry.changefreq}</changefreq>
+    <priority>${entry.priority}</priority>
+  </url>`,
+		)
+		.join("");
+
+	return `<?xml version="1.0" encoding="UTF-8"?>
+<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">${urls}
+</urlset>`;
+}
+
+function getStaticEntries(): SitemapEntry[] {
+	return [
+		{
+			loc: BASE_URL,
+			lastmod: new Date().toISOString(),
+			changefreq: "daily",
+			priority: 1,
+		},
+	];
+}
+
+export async function GET() {
+	const entries: SitemapEntry[] = getStaticEntries();
+
+	return new Response(toXml(entries), {
+		headers: {
+			"Content-Type": "application/xml",
+		},
+	});
+}

package/src/{helpers/integrate → modules/features/cms}/sanity/files/lib/integrations/sanity/env.ts

@@ -1,5 +1,3 @@
-import { getBaseUrl } from "@/lib/utils/url";
-
 /**
  * Sanity Environment Configuration
  *
@@ -25,7 +23,7 @@ export const projectId =
 export const studioUrl =
 	process.env.NODE_ENV === "development"
 		? "http://localhost:3000/studio"
-		: `${getBaseUrl()}/studio`;
+		: `${process.env.NEXT_PUBLIC_BASE_URL || ""}/studio`;
 
 /**
  * Single Sanity API read token used for both browser and server live preview.
@@ -41,4 +39,4 @@ export const sanityToken =
 export const previewURL =
 	process.env.NODE_ENV === "development"
 		? "http://localhost:3000"
-		: getBaseUrl();
+		: process.env.NEXT_PUBLIC_BASE_URL || "";

package/src/{helpers/integrate → modules/features/cms}/sanity/files/lib/integrations/sanity/queries.ts

@@ -64,45 +64,3 @@ export const ARTICLE_BY_ID_QUERY = defineQuery(`
     _updatedAt
   }
 `);
-
-export const PAGE_QUERY = defineQuery(`
-  *[_type == "example" && slug.current == $slug][0] {
-    _id,
-    title,
-    slug,
-    hero,
-    ${richTextWithLinks},
-    features,
-    tags,
-    metadata,
-    publishedAt,
-    _updatedAt
-  }
-`);
-
-export const SITEMAP_ARTICLES_QUERY = defineQuery(`
-  *[_type == "article" && defined(slug.current)] {
-    title,
-    slug,
-    _updatedAt,
-    "noIndex": metadata.noIndex
-  }
-`);
-
-export const SITEMAP_PAGES_QUERY = defineQuery(`
-  *[_type == "example" && defined(slug.current)] {
-    title,
-    slug,
-    _updatedAt,
-    "noIndex": metadata.noIndex
-  }
-`);
-
-export const ALL_PAGES_QUERY = defineQuery(`
-  *[_type == "example" && defined(slug.current)] | order(publishedAt desc) {
-    slug,
-    _updatedAt,
-    "noIndex": metadata.noIndex
-  }
-`);
-

package/src/{helpers/integrate → modules/features/cms}/sanity/files/lib/integrations/sanity/schemas/index.ts

@@ -15,7 +15,7 @@ import { navigation } from "./navigation";
 import { richText } from "./richText";
 
 // Re-export all schemas for convenience
-export { link, metadata, richText, article, example, navigation };
+export { article, example, link, metadata, navigation, richText };
 
 // Schema collection for Sanity configuration
 export const schema: { types: SchemaTypeDefinition[] } = {

package/src/modules/features/cms/sanity/files/lib/scripts/copy-sanity-mcp.ts

@@ -0,0 +1,23 @@
+/**
+ * Cross-platform Sanity MCP setup helper
+ * Copies the Cursor deeplink to clipboard on macOS/Linux/Windows
+ */
+
+import { copyToClipboard } from "./utils";
+
+const link =
+	"cursor://anysphere.cursor-deeplink/mcp/install?name=Sanity&config=eyJ1cmwiOiJodHRwczovL21jcC5zYW5pdHkuaW8iLCJ0eXBlIjoiaHR0cCJ9Cg==";
+
+const copied = await copyToClipboard(link);
+
+console.log("\n🔗 Sanity MCP Setup for Cursor\n");
+
+if (copied) {
+	console.log("✅ Link copied to clipboard!");
+	console.log("   Paste it in your browser or Cursor address bar.\n");
+} else {
+	console.log("📋 Copy this link manually:\n");
+	console.log(`   ${link}\n`);
+}
+
+console.log("This will install the Sanity MCP server in Cursor.");

package/src/modules/features/cms/sanity/files/lib/scripts/generate-page.ts

@@ -0,0 +1,297 @@
+#!/usr/bin/env bun
+/**
+ * Generate Page Module
+ *
+ * Generates new pages with pre-configured templates through interactive prompts.
+ * Used by the unified generator: `bun run generate`
+ *
+ * Cross-platform compatible (Windows, macOS, Linux)
+ */
+
+import * as p from "@clack/prompts";
+import { createDir } from "./utils";
+
+interface PageOptions {
+	webgl?: boolean;
+	sanity?: boolean;
+	theme?: string;
+	css?: boolean;
+}
+
+export interface PageConfig {
+	name: string;
+	options: PageOptions;
+}
+
+/**
+ * Interactive prompts for page configuration
+ */
+export const promptPageConfig = async (): Promise<PageConfig> => {
+	const name = await p.text({
+		message: "What should the page be called?",
+		placeholder: "about, contact, products",
+		validate: (value) => {
+			if (!value) return "Page name is required";
+			if (!/^[a-zA-Z][a-zA-Z0-9-_]*$/.test(value)) {
+				return "Page name must start with a letter and contain only letters, numbers, hyphens, and underscores";
+			}
+			return undefined;
+		},
+	});
+
+	if (p.isCancel(name)) {
+		p.cancel("Page generation cancelled");
+		process.exit(0);
+	}
+
+	const theme = await p.select({
+		message: "Choose a theme for the page",
+		options: [
+			{ value: "dark", label: "Dark (default)", hint: "Standard dark theme" },
+			{ value: "light", label: "Light", hint: "Light theme" },
+			{ value: "red", label: "Red", hint: "Red accent theme" },
+		],
+		initialValue: "dark",
+	});
+
+	if (p.isCancel(theme)) {
+		p.cancel("Page generation cancelled");
+		process.exit(0);
+	}
+
+	const integrations = await p.multiselect({
+		message: "Which integrations should this page use?",
+		options: [
+			{ value: "webgl", label: "WebGL Canvas", hint: "Enable 3D graphics" },
+			{ value: "sanity", label: "Sanity CMS", hint: "Content management" },
+		],
+		required: false,
+	});
+
+	if (p.isCancel(integrations)) {
+		p.cancel("Page generation cancelled");
+		process.exit(0);
+	}
+
+	const includeCss = await p.confirm({
+		message: "Include a CSS module file?",
+		initialValue: false,
+	});
+
+	if (p.isCancel(includeCss)) {
+		p.cancel("Page generation cancelled");
+		process.exit(0);
+	}
+
+	return {
+		name,
+		options: {
+			theme,
+			webgl: integrations.includes("webgl"),
+			sanity: integrations.includes("sanity"),
+			css: includeCss,
+		},
+	};
+};
+
+/**
+ * Generate page.tsx content
+ */
+const generatePageContent = (
+	pageName: string,
+	options: PageOptions,
+): string => {
+	const { webgl, sanity, theme = "dark" } = options;
+
+	// Capitalize first letter for title
+	const title = pageName.charAt(0).toUpperCase() + pageName.slice(1);
+
+	// Build imports
+	const imports: string[] = [];
+	imports.push(`import type { Metadata } from 'next'`);
+	imports.push(`import { Wrapper } from '@/components/layout/wrapper'`);
+
+	// Integration-specific imports
+	if (sanity) {
+		imports.push(
+			`import { NotConfigured } from '@/components/ui/not-configured'`,
+		);
+	}
+
+	if (sanity) {
+		imports.push(
+			`import { isSanityConfigured } from '@/lib/integrations/check-integration'`,
+		);
+		// sanityFetch and generateSanityMetadata are available for use:
+		// import { sanityFetch } from 'next-sanity/live'
+		// import { generateSanityMetadata } from '@/lib/utils/metadata'
+	}
+
+	// Build wrapper props
+	const wrapperProps: string[] = [`theme="${theme}"`];
+	if (webgl) {
+		wrapperProps.push("webgl");
+	}
+
+	// Build component body based on integrations
+	let componentBody: string;
+
+	if (sanity) {
+		// Sanity only
+		componentBody = `  // Show setup instructions if Sanity is not configured
+  if (!isSanityConfigured()) {
+    return (
+      <Wrapper theme="${theme}">
+        <NotConfigured integration="Sanity" />
+      </Wrapper>
+    )
+  }
+
+  // TODO: Create a GROQ query for this page's content type
+  // const { data } = await sanityFetch({
+  //   query: yourQuery,
+  //   params: { slug: '${pageName}' },
+  // })
+
+  return (
+    <Wrapper ${wrapperProps.join(" ")}>
+      <section className="dr-py-100">
+        <div className="container">
+          <h1>${title}</h1>
+          {/* Your content here */}
+          {/* Fetch data from Sanity using a custom query */}
+        </div>
+      </section>
+    </Wrapper>
+  )`;
+	} else {
+		// No integrations
+		componentBody = `  return (
+    <Wrapper ${wrapperProps.join(" ")}>
+      <section className="dr-py-100">
+        <div className="container">
+          <h1>${title}</h1>
+          {/* Your content here */}
+        </div>
+      </section>
+    </Wrapper>
+  )`;
+	}
+
+	// Build metadata export
+	let metadataExport: string;
+	if (sanity) {
+		metadataExport = `
+export async function generateMetadata(): Promise<Metadata> {
+  if (!isSanityConfigured()) {
+    return {
+      title: '${title}',
+      description: '${title} page description',
+    }
+  }
+
+  // TODO: Fetch metadata from Sanity using a custom query
+  // const { data } = await sanityFetch({
+  //   query: yourQuery,
+  //   params: { slug: '${pageName}' },
+  // })
+
+  return {
+    title: '${title}',
+    description: '${title} page description',
+  }
+}`;
+	} else {
+		metadataExport = `
+export const metadata: Metadata = {
+  title: '${title}',
+  description: '${title} page description',
+}`;
+	}
+
+	// Determine if component should be async
+	const isAsync = sanity;
+
+	return `${imports.join("\n")}
+${metadataExport}
+
+export default ${isAsync ? "async " : ""}function ${title}Page() {
+${componentBody}
+}
+`;
+};
+
+/**
+ * Create page files and directories
+ */
+export const createPage = async (
+	pageName: string,
+	options: PageOptions,
+): Promise<void> => {
+	const s = p.spinner();
+
+	try {
+		// Create directory structure
+		const pageDir = `app/${pageName}`;
+		const componentsDir = `${pageDir}/_components`;
+
+		s.start(`Creating page structure for "${pageName}"`);
+
+		// Create main page directory (cross-platform)
+		await createDir(pageDir);
+
+		// Create _components subdirectory (cross-platform)
+		await createDir(componentsDir);
+
+		// Create .gitkeep in _components
+		await Bun.write(`${componentsDir}/.gitkeep`, "");
+
+		// Generate and write page.tsx
+		const pageContent = generatePageContent(pageName, options);
+		await Bun.write(`${pageDir}/page.tsx`, pageContent);
+
+		// Create CSS module if requested
+		if (options.css) {
+			const cssContent = `/* ${pageName}.module.css */
+
+.container {
+  /* Add your styles here */
+}
+`;
+			await Bun.write(`${pageDir}/${pageName}.module.css`, cssContent);
+		}
+
+		s.stop(`Page "${pageName}" generated successfully!`);
+
+		// Show what was created
+		p.log.success(`Generated files:`);
+		p.log.message(`  📄 ${pageDir}/page.tsx`);
+		p.log.message(`  📁 ${componentsDir}/`);
+		if (options.css) {
+			p.log.message(`  🎨 ${pageDir}/${pageName}.module.css`);
+		}
+
+		// Build next steps message
+		const nextSteps = [`1. Customize ${pageDir}/page.tsx`];
+
+		if (options.sanity) {
+			nextSteps.push(
+				`2. Create a "${pageName}" page in Sanity Studio at /studio`,
+			);
+		}
+
+		nextSteps.push(
+			`${nextSteps.length + 1}. Add components to ${componentsDir}/`,
+		);
+		nextSteps.push(
+			`${nextSteps.length + 1}. Visit /${pageName} to see your page`,
+		);
+
+		p.note(`Next steps:\n  ${nextSteps.join("\n  ")}`);
+	} catch (error) {
+		s.stop(`Failed to generate page "${pageName}"`);
+		throw error;
+	}
+};
+
+// Export functions for use by unified generate script

package/src/{helpers/integrate → modules/features/cms}/sanity/files/lib/utils/json-ld.tsx

@@ -9,7 +9,6 @@ import type {
 	WithContext,
 } from "schema-dts";
 
-
 const APP_BASE_URL = process.env.NEXT_PUBLIC_BASE_URL;
 
 function isAbsoluteUrl(value: string) {
@@ -26,11 +25,7 @@ function resolveUrl(value?: string) {
 
 /* -------------------------------- Component ------------------------------- */
 
-export function JsonLd<T extends Thing>({
-	data,
-}: {
-	data: WithContext<T>;
-}) {
+export function JsonLd<T extends Thing>({ data }: { data: WithContext<T> }) {
 	return (
 		<script
 			type="application/ld+json"

package/src/{helpers/integrate → modules/features/cms}/sanity/files/lib/utils/metadata.ts

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

package/src/{helpers/integrate → modules/features/cms}/sanity/files/lib/utils/url.ts

@@ -8,10 +8,12 @@
  * 4. localhost fallback
  */
 export function getBaseUrl(): string {
-	if (process.env.NEXT_PUBLIC_BASE_URL)
+	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_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";
 }

package/src/{helpers/integrate → modules/features/cms}/sanity/files/proxy.ts

@@ -1,9 +1,9 @@
-import { NextResponse } from "next/server";
 import type { NextRequest } from "next/server";
+import { NextResponse } from "next/server";
 import {
-	mdExtensionRoutes,
 	acceptHeaderRoutes,
 	ignoredPaths,
+	mdExtensionRoutes,
 } from "@/lib/integrations/sanity/markdown-proxy.config";
 
 export function proxy(request: NextRequest) {
@@ -18,10 +18,10 @@ export function proxy(request: NextRequest) {
 	//    e.g. /blog/my-post.md → /api/blog/my-post.md
 	for (const route of mdExtensionRoutes) {
 		const match = route.regex.exec(pathname);
-		if (match) {
-			const slug = match[1];
+		const slug = match?.[1];
+		if (slug) {
 			const url = request.nextUrl.clone();
-			url.pathname = route.apiPath.replace("[slug]", slug!);
+			url.pathname = route.apiPath.replace("[slug]", slug);
 			return NextResponse.rewrite(url);
 		}
 	}
@@ -30,10 +30,10 @@ export function proxy(request: NextRequest) {
 	if (acceptHeader.includes("text/markdown")) {
 		for (const route of acceptHeaderRoutes) {
 			const match = route.regex.exec(pathname);
-			if (match) {
-				const slug = match[1];
+			const slug = match?.[1];
+			if (slug) {
 				const url = request.nextUrl.clone();
-				url.pathname = route.apiPath.replace("[slug]", slug!);
+				url.pathname = route.apiPath.replace("[slug]", slug);
 				return NextResponse.rewrite(url);
 			}
 		}
@@ -44,9 +44,9 @@ export function proxy(request: NextRequest) {
 
 	for (const route of acceptHeaderRoutes) {
 		const match = route.regex.exec(pathname);
-		if (match) {
-			const slug = match[1];
-			const mdUrl = route.publicPath.replace("[slug]", slug!);
+		const slug = match?.[1];
+		if (slug) {
+			const mdUrl = route.publicPath.replace("[slug]", slug);
 			response.headers.set(
 				"Link",
 				`<${mdUrl}>; rel="alternate"; type="text/markdown"`,