bsmnt 0.1.3 → 0.2.4

package/packages/create-basement-app/integrations/sanity/config.js

@@ -1,46 +0,0 @@
-// packages/create-basement-app/integrations/sanity/config.js
-
-/**
- * Sanity integration configuration manifest.
- * Single source of truth for dependencies, scripts, paths, and merge rules.
- */
-export const sanityConfig = {
-	name: "sanity",
-
-	dependencies: {
-		"@sanity/asset-utils": "^2.3.0",
-		"@sanity/image-url": "^2.0.3",
-		"@sanity/visual-editing": "^5.1.1",
-		"@sanity/vision": "^5.7.0",
-		"next-sanity": "^12.0.14",
-	},
-
-	devDependencies: {
-		sanity: "^5.6.0",
-	},
-
-	scripts: {
-		"sanity:extract":
-			"cd lib/integrations/sanity && bun --env-file ../../../.env.local sanity schema extract",
-		"sanity:typegen":
-			"cd lib/integrations/sanity && bun --env-file ../../../.env.local sanity typegen generate && bun biome check --write --unsafe",
-	},
-
-	additivePaths: [
-		"lib/integrations/sanity",
-		"components/ui/sanity-image",
-		"app/api/draft-mode",
-		"app/api/revalidate",
-		"app/studio",
-		"lib/utils/metadata.ts",
-		"lib/scripts/generate-page.ts",
-		"lib/scripts/copy-sanity-mcp.ts",
-		"lib/integrations/README.md",
-	],
-
-	mergeFiles: [
-		"app/layout.tsx",
-		"app/sitemap.ts",
-		"lib/integrations/check-integration.ts",
-	],
-};

package/packages/create-basement-app/integrations/sanity/files/app/api/draft-mode/disable/route.ts

@@ -1,7 +0,0 @@
-import { draftMode } from "next/headers";
-import { type NextRequest, NextResponse } from "next/server";
-
-export async function GET(request: NextRequest) {
-	(await draftMode()).disable();
-	return NextResponse.redirect(new URL("/", request.url));
-}

package/packages/create-basement-app/integrations/sanity/files/app/api/draft-mode/enable/route.ts

@@ -1,21 +0,0 @@
-import { NextResponse } from "next/server";
-import { defineEnableDraftMode } from "next-sanity/draft-mode";
-import { isSanityConfigured } from "@/lib/integrations/check-integration";
-import { client } from "@/lib/integrations/sanity/client";
-import { privateToken } from "@/lib/integrations/sanity/env";
-
-// Only enable draft mode if Sanity is configured
-const draftModeHandler =
-	isSanityConfigured() && client
-		? defineEnableDraftMode({
-				client: client.withConfig({ token: privateToken }),
-			})
-		: {
-				GET: () =>
-					NextResponse.json(
-						{ error: "Sanity is not configured" },
-						{ status: 503 },
-					),
-			};
-
-export const { GET } = draftModeHandler;

package/packages/create-basement-app/integrations/sanity/files/app/api/revalidate/route.ts

@@ -1,37 +0,0 @@
-import { revalidateTag } from "next/cache";
-import { type NextRequest, NextResponse } from "next/server";
-import { parseBody } from "next-sanity/webhook";
-
-export async function POST(request: NextRequest) {
-	try {
-		const { body, isValidSignature } = await parseBody<{
-			_type: string;
-			slug?: { current: string };
-		}>(request, process.env.SANITY_REVALIDATE_SECRET);
-
-		if (!isValidSignature) {
-			return new Response("Invalid signature", { status: 401 });
-		}
-
-		if (!body?._type) {
-			return new Response("Bad Request", { status: 400 });
-		}
-
-		// Revalidate the specific document type
-		revalidateTag(body._type);
-
-		// If there's a slug, revalidate the specific page
-		if (body.slug?.current) {
-			revalidateTag(`${body._type}:${body.slug.current}`);
-		}
-
-		return NextResponse.json({
-			status: 200,
-			revalidated: true,
-			now: Date.now(),
-		});
-	} catch (error) {
-		console.error("Revalidation error:", error);
-		return new Response("Internal Server Error", { status: 500 });
-	}
-}

package/packages/create-basement-app/integrations/sanity/files/app/layout.tsx

@@ -1,111 +0,0 @@
-import type { Metadata, Viewport } from "next";
-import { Geist } from "next/font/google";
-import { type PropsWithChildren, Suspense } from "react";
-import { SanityStudioGuard } from "@/components/sanity/studio-guard";
-import { SanityVisualEditing } from "@/components/sanity/visual-editing";
-import { Link } from "@/components/ui/link";
-import { themes } from "@/lib/styles/colors";
-import { fontsVariable } from "@/lib/styles/fonts";
-import AppData from "@/package.json";
-import "@/lib/styles/css/index.css";
-import { cn } from "@/lib/styles/cn";
-
-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 ?? "https://localhost:3000";
-
-const geist = Geist({
-	subsets: ["latin"],
-});
-
-export const metadata: Metadata = {
-	alternates: {
-		canonical: "/",
-		languages: {
-			"en-US": "/en-US",
-		},
-	},
-	appleWebApp: {
-		capable: true,
-		statusBarStyle: "default",
-		title: APP_DEFAULT_TITLE,
-	},
-	applicationName: APP_NAME,
-	authors: [{ name: "basement.studio", url: "https://basement.studio" }],
-	description: APP_DESCRIPTION,
-	formatDetection: { telephone: false },
-	metadataBase: new URL(APP_BASE_URL),
-	openGraph: {
-		description: APP_DESCRIPTION,
-		images: [
-			{
-				alt: APP_DEFAULT_TITLE,
-				height: 630,
-				url: "/opengraph-image.jpg",
-				width: 1200,
-			},
-		],
-		locale: "en_US",
-		siteName: APP_NAME,
-		title: {
-			default: APP_DEFAULT_TITLE,
-			template: APP_TITLE_TEMPLATE,
-		},
-		type: "website",
-		url: APP_BASE_URL,
-	},
-	other: {
-		"fb:app_id": process.env.NEXT_PUBLIC_FACEBOOK_APP_ID || "",
-	},
-	title: {
-		default: APP_DEFAULT_TITLE,
-		template: APP_TITLE_TEMPLATE,
-	},
-	twitter: {
-		card: "summary_large_image",
-		description: APP_DESCRIPTION,
-		title: {
-			default: APP_DEFAULT_TITLE,
-			template: APP_TITLE_TEMPLATE,
-		},
-	},
-};
-
-export const viewport: Viewport = {
-	colorScheme: "normal",
-	themeColor: themes.dark.primary,
-};
-
-export default function Layout({ children }: PropsWithChildren) {
-	return (
-		<html
-			lang="en"
-			dir="ltr"
-			className={cn(fontsVariable, geist.className)}
-			suppressHydrationWarning
-		>
-			<body>
-				<Suspense fallback={null}>
-					<SanityStudioGuard>
-						{/* Skip link for keyboard navigation accessibility */}
-						<Suspense fallback={null}>
-							<Link
-								href="#main-content"
-								className="sr-only focus:not-sr-only focus:fixed focus:top-4 focus:left-4 focus:z-9999 focus:rounded focus:bg-black focus:px-4 focus:py-2 focus:text-white focus:outline-none focus:ring-2 focus:ring-white"
-							>
-								Skip to main content
-							</Link>
-						</Suspense>
-					</SanityStudioGuard>
-				</Suspense>
-
-				{children}
-
-				<SanityVisualEditing />
-			</body>
-		</html>
-	);
-}

package/packages/create-basement-app/integrations/sanity/files/app/sitemap.ts

@@ -1,80 +0,0 @@
-import type { MetadataRoute } from "next";
-import { isSanityConfigured } from "@/lib/integrations/check-integration";
-
-const APP_BASE_URL =
-	process.env.NEXT_PUBLIC_BASE_URL ?? "https://localhost:3000";
-
-export default async function sitemap(): Promise<MetadataRoute.Sitemap> {
-	const baseRoutes: MetadataRoute.Sitemap = [
-		{
-			url: APP_BASE_URL,
-			lastModified: new Date(),
-			changeFrequency: "daily",
-			priority: 1,
-		},
-	];
-
-	// Only fetch Sanity pages if Sanity is configured
-	if (isSanityConfigured()) {
-		try {
-			const sanityModule = await import("@/lib/integrations/sanity/client");
-			const sanityGroq = await import("next-sanity");
-
-			const client = sanityModule?.client;
-			const groq = sanityGroq?.groq;
-
-			// Skip if client is null (shouldn't happen since we check isSanityConfigured)
-			if (!(client && groq)) return baseRoutes;
-
-			type SanityDocument = {
-				slug: { current: string };
-				_updatedAt: string;
-				metadata?: { noIndex?: boolean };
-			};
-
-			// Fetch all published pages and articles
-			const pages = (await client.fetch(
-				groq`*[_type == "page" && defined(slug.current)] {
-          slug,
-          _updatedAt,
-          metadata
-        }`,
-			)) as SanityDocument[];
-
-			const articles = (await client.fetch(
-				groq`*[_type == "article" && defined(slug.current)] {
-          slug,
-          _updatedAt,
-          metadata
-        }`,
-			)) as SanityDocument[];
-
-			// Add pages to sitemap (exclude noIndex pages)
-			const pageEntries: MetadataRoute.Sitemap = pages
-				.filter((page: SanityDocument) => !page.metadata?.noIndex)
-				.map((page: SanityDocument) => ({
-					url: `${APP_BASE_URL}/${page.slug.current}`,
-					lastModified: new Date(page._updatedAt),
-					changeFrequency: "weekly" as const,
-					priority: 0.8,
-				}));
-
-			// Add articles to sitemap (exclude noIndex articles)
-			const articleEntries: MetadataRoute.Sitemap = articles
-				.filter((article: SanityDocument) => !article.metadata?.noIndex)
-				.map((article: SanityDocument) => ({
-					url: `${APP_BASE_URL}/blog/${article.slug.current}`,
-					lastModified: new Date(article._updatedAt),
-					changeFrequency: "weekly" as const,
-					priority: 0.7,
-				}));
-
-			return [...baseRoutes, ...pageEntries, ...articleEntries];
-		} catch (error) {
-			console.error("Error generating sitemap from Sanity:", error);
-			return baseRoutes;
-		}
-	}
-
-	return baseRoutes;
-}

package/packages/create-basement-app/integrations/sanity/files/app/studio/[[...tool]]/page.tsx

@@ -1,8 +0,0 @@
-"use client";
-
-import { NextStudio } from "next-sanity/studio";
-import config from "@/lib/integrations/sanity/sanity.config";
-
-export default function StudioPage() {
-	return <NextStudio config={config} />;
-}

package/packages/create-basement-app/integrations/sanity/files/app/studio/layout.tsx

@@ -1,7 +0,0 @@
-export default function StudioLayout({
-	children,
-}: {
-	children: React.ReactNode;
-}) {
-	return children;
-}

package/packages/create-basement-app/integrations/sanity/files/components/ui/sanity-image/index.tsx

@@ -1,37 +0,0 @@
-import { getImageDimensions } from "@sanity/asset-utils";
-import { Image, type ImageProps } from "@/components/ui/image";
-import { urlForImage } from "@/lib/integrations/sanity/utils/image";
-
-interface SanityImageProps extends Omit<ImageProps, "src" | "aspectRatio"> {
-	image: {
-		asset: {
-			_ref: string;
-			_type: "reference";
-		};
-		alt?: string;
-		hotspot?: object;
-		crop?: object;
-	};
-	maxWidth?: number;
-}
-
-export function SanityImage({
-	image,
-	maxWidth = 1920,
-	alt,
-	...props
-}: SanityImageProps) {
-	if (!image?.asset) return null;
-
-	const { width, height } = getImageDimensions(image.asset);
-	const aspectRatio = width / height;
-
-	return (
-		<Image
-			src={urlForImage(image).width(maxWidth).url()}
-			alt={alt || image.alt || ""}
-			aspectRatio={aspectRatio}
-			{...props}
-		/>
-	);
-}

package/packages/create-basement-app/integrations/sanity/files/lib/integrations/README.md

@@ -1,58 +0,0 @@
-# Integrations
-
-Third-party service integrations. All are optional—remove unused ones with `bun run setup:project`.
-
-## Available Integrations
-
-| Integration | Purpose | Documentation |
-|-------------|---------|---------------|
-| [Sanity](sanity/README.md) | Headless CMS | Visual editing, content management |
-| [Shopify](shopify/README.md) | E-commerce | Cart, products, checkout |
-
-## Environment Variables
-
-```env
-# Sanity CMS
-NEXT_PUBLIC_SANITY_PROJECT_ID="your-project-id"
-NEXT_PUBLIC_SANITY_DATASET="production"
-NEXT_PUBLIC_SANITY_STUDIO_URL="http://localhost:3000/studio"
-SANITY_API_WRITE_TOKEN="your-write-token"
-
-# Shopify
-SHOPIFY_STORE_DOMAIN="your-store.myshopify.com"
-SHOPIFY_STOREFRONT_ACCESS_TOKEN="your-token"
-SHOPIFY_REVALIDATION_SECRET="your-secret"
-
-# Analytics
-NEXT_PUBLIC_GOOGLE_TAG_MANAGER_ID=GTM-XXXXXX
-NEXT_PUBLIC_GOOGLE_ANALYTICS=G-XXXXXXXXXX
-```
-
-## Quick Usage
-
-```tsx
-// Sanity
-import { sanityFetch } from '@/integrations/sanity/live'
-import { RichText } from '@/integrations/sanity/components/rich-text'
-const { data } = await sanityFetch({ query: pageQuery })
-
-// Shopify
-import { Cart, AddToCart } from '@/lib/integrations/shopify/cart'
-<Cart><AddToCart product={product} /></Cart>
-
-```
-
-## Removing Integrations
-
-Run `bun run setup:project` for interactive removal, or manually:
-
-```bash
-# Sanity (~150-200KB savings)
-rm -rf lib/integrations/sanity app/studio app/(examples)/sanity
-bun remove @sanity/asset-utils @sanity/image-url next-sanity sanity
-
-# Shopify (~50-80KB)
-rm -rf lib/integrations/shopify app/(examples)/shopify
-```
-
-After removal: `bun lint:fix && bun build`

package/packages/create-basement-app/integrations/sanity/files/lib/integrations/check-integration.ts

@@ -1,62 +0,0 @@
-/**
- * Integration Configuration Checker
- *
- * Utilities to check if integrations are configured via environment variables.
- * This helps with tree-shaking unused integrations from the bundle.
- *
- * Usage:
- * ```ts
- * import { isSanityConfigured } from '@/integrations/check-integration'
- *
- * if (isSanityConfigured()) {
- *   // Only import and use Sanity code if configured
- *   const { sanityFetch } = await import('next-sanity/live')
- * }
- * ```
- */
-
-/**
- * Check if Sanity CMS is configured
- * Requires: NEXT_PUBLIC_SANITY_PROJECT_ID and NEXT_PUBLIC_SANITY_DATASET
- */
-export function isSanityConfigured(): boolean {
-	return Boolean(
-		process.env.NEXT_PUBLIC_SANITY_PROJECT_ID &&
-			process.env.NEXT_PUBLIC_SANITY_DATASET,
-	);
-}
-
-/**
- * Check if Google Analytics is configured
- * Requires: NEXT_PUBLIC_GOOGLE_ANALYTICS or NEXT_PUBLIC_GOOGLE_TAG_MANAGER_ID
- */
-export function isAnalyticsConfigured(): boolean {
-	return Boolean(
-		process.env.NEXT_PUBLIC_GOOGLE_ANALYTICS ||
-			process.env.NEXT_PUBLIC_GOOGLE_TAG_MANAGER_ID,
-	);
-}
-
-/**
- * Get a list of all configured integrations
- */
-export function getConfiguredIntegrations(): string[] {
-	const integrations: string[] = [];
-
-	if (isSanityConfigured()) integrations.push("Sanity");
-	if (isAnalyticsConfigured()) integrations.push("Analytics");
-
-	return integrations;
-}
-
-/**
- * Get a list of all unconfigured integrations
- */
-export function getUnconfiguredIntegrations(): string[] {
-	const integrations: string[] = [];
-
-	if (!isSanityConfigured()) integrations.push("Sanity");
-	if (!isAnalyticsConfigured()) integrations.push("Analytics");
-
-	return integrations;
-}

package/packages/create-basement-app/integrations/sanity/files/lib/integrations/sanity/README.md

@@ -1,144 +0,0 @@
-# Sanity CMS Integration
-
-Headless CMS with visual editing.
-
-## Environment Variables
-
-```env
-# Required
-NEXT_PUBLIC_SANITY_PROJECT_ID="your-project-id"
-NEXT_PUBLIC_SANITY_DATASET="production"
-
-# Required for Visual Editing & Live Preview
-NEXT_PUBLIC_SANITY_API_READ_TOKEN="your-viewer-token"
-SANITY_PRIVATE_TOKEN="your-editor-token"
-
-# Optional
-NEXT_PUBLIC_SANITY_STUDIO_URL="http://localhost:3000/studio"
-NEXT_PUBLIC_SANITY_API_VERSION="2024-03-15"
-```
-
-> **Note**: Create tokens in [Sanity Dashboard](https://sanity.io/manage) → Your Project → API → Tokens.
-> - **Viewer** token → `NEXT_PUBLIC_SANITY_API_READ_TOKEN`
-> - **Editor** token → `SANITY_PRIVATE_TOKEN`
-
-## Quick Start
-
-1. Access Studio at `/studio`
-2. Create content (Pages, Articles)
-3. Click "Present" for visual editing
-
-## Usage
-
-### Fetching Data
-
-```tsx
-import { sanityFetch } from 'next-sanity/live'
-import { pageQuery } from '@/lib/integrations/sanity/queries'
-
-export default async function Page({ params }) {
-  const { data } = await sanityFetch({ 
-    query: pageQuery, 
-    params: { slug: params.slug } 
-  })
-  return <YourComponent data={data} />
-}
-```
-
-### Build-time Data Fetching
-
-For `generateStaticParams` or other build-time functions, use the client directly:
-
-```tsx
-import { client } from '@/lib/integrations/sanity/client'
-import { allArticlesQuery } from '@/lib/integrations/sanity/queries'
-
-export async function generateStaticParams() {
-  if (!client) return []
-  const data = await client.fetch(allArticlesQuery)
-  return data.map((item) => ({ slug: item.slug?.current ?? '' }))
-}
-```
-
-### Visual Editing
-
-Add `data-sanity` attributes for visual editing:
-
-```tsx
-import { RichText } from '@/lib/integrations/sanity/components/rich-text'
-
-function MyComponent({ data }) {
-  return (
-    <div data-sanity={data._id}>
-      <h1 data-sanity="title">{data.title}</h1>
-      <RichText content={data.content} />
-    </div>
-  )
-}
-```
-
-### Image Handling
-
-```tsx
-import { urlForImage } from '@/lib/integrations/sanity/utils/image'
-import { SanityImage } from '@/components/ui/sanity-image'
-
-// Option 1: Using urlForImage utility
-<img src={urlForImage(image).width(800).url()} alt={image.alt} />
-
-// Option 2: Using SanityImage component
-<SanityImage image={image} maxWidth={800} />
-```
-
-### SEO Metadata
-
-```tsx
-import { generateSanityMetadata } from '@/lib/utils/metadata'
-
-export async function generateMetadata({ params }) {
-  const { data } = await sanityFetch({ query: pageQuery, params })
-  return generateSanityMetadata({ document: data, url: `/page/${params.slug}` })
-}
-```
-
-## Creating New Content Types
-
-1. **Create schema** in `schemaTypes/`:
-
-```typescript
-import { defineField, defineType } from 'sanity'
-
-export const landing = defineType({
-  name: 'landing',
-  type: 'document',
-  fields: [
-    defineField({ name: 'title', type: 'string' }),
-    defineField({ name: 'slug', type: 'slug', options: { source: 'title' } }),
-    defineField({ name: 'content', type: 'richText' }),
-  ],
-})
-```
-
-2. **Add to schema index** in `schemaTypes/index.ts`
-3. **Create query** in `queries.ts`
-4. **Create page** in `app/`
-
-## Caching
-
-- **Draft mode**: Uses `cache: 'no-store'` automatically
-- **Published content**: ISR with `revalidate: 3600`
-- All queries use `cacheSignal()` for automatic cleanup
-
-See [ARCHITECTURE.md](../../../ARCHITECTURE.md) for cache gotchas.
-
-## Troubleshooting
-
-**Visual editor not loading:**
-- Check env vars are set correctly
-- Verify draft mode routes exist (`/api/draft-mode/enable`)
-
-**Content not updating:**
-- Hard refresh browser
-- Check revalidation webhook is configured
-
-**Related**: [Sanity Docs](https://www.sanity.io/docs) · [Parent README](../README.md)

package/packages/create-basement-app/integrations/sanity/files/lib/integrations/sanity/client.ts

@@ -1,30 +0,0 @@
-import { createClient, type SanityClient } from "next-sanity";
-import { isSanityConfigured } from "@/lib/integrations/check-integration";
-import { apiVersion, dataset, privateToken, projectId, studioUrl } from "./env";
-
-/**
- * Sanity client instance
- *
- * Returns null if Sanity is not configured (missing env vars).
- * Always check with isSanityConfigured() before using.
- */
-export const client: SanityClient | null = isSanityConfigured()
-	? createClient({
-			projectId,
-			dataset,
-			apiVersion,
-			useCdn: true,
-			perspective: "published",
-			token: privateToken,
-			stega: {
-				studioUrl,
-				filter: (props) => {
-					if (props.sourcePath.at(-1) === "title") {
-						return true;
-					}
-
-					return props.filterDefault(props);
-				},
-			},
-		})
-	: null;

package/packages/create-basement-app/integrations/sanity/files/lib/integrations/sanity/components/disable-draft-mode.tsx

@@ -1,29 +0,0 @@
-"use client";
-
-import Link from "next/link";
-import { usePathname } from "next/navigation";
-import { useDraftModeEnvironment } from "next-sanity/hooks";
-
-export function DisableDraftMode() {
-	const environment = useDraftModeEnvironment();
-	const pathname = usePathname();
-
-	// Only show the disable draft mode button when outside of Presentation Tool
-	if (environment !== "live" && environment !== "unknown") {
-		return null;
-	}
-
-	if (pathname.startsWith("/studio")) {
-		return null;
-	}
-
-	return (
-		<Link
-			href="/api/draft-mode/disable"
-			scroll={false}
-			className="dr-p-4 fixed top-safe right-safe z-50 bg-red font-mono text-primary text-sm uppercase"
-		>
-			Disable Draft Mode
-		</Link>
-	);
-}