bsmnt 0.0.0

package/src/commands/add-integration.js

@@ -0,0 +1,325 @@
+import { execSync } from "node:child_process";
+import path from "node:path";
+import fs from "fs-extra";
+import ora from "ora";
+import pc from "picocolors";
+import prompts from "prompts";
+
+/**
+ * Validates that the current directory is a valid Next.js project
+ */
+async function validateProject(targetDir) {
+	const packageJsonPath = path.join(targetDir, "package.json");
+
+	// Check for package.json
+	if (!fs.existsSync(packageJsonPath)) {
+		return {
+			valid: false,
+			error: "No package.json found in current directory",
+		};
+	}
+
+	const pkg = await fs.readJson(packageJsonPath);
+
+	// Check for Next.js dependency
+	const hasNext = pkg.dependencies?.next || pkg.devDependencies?.next;
+	if (!hasNext) {
+		return {
+			valid: false,
+			error:
+				"This doesn't appear to be a Next.js project (next not found in dependencies)",
+		};
+	}
+
+	// Check for app directory (App Router) - supports both root and src/ structures
+	const appDir = path.join(targetDir, "app");
+	const srcAppDir = path.join(targetDir, "src/app");
+	const hasAppDir = fs.existsSync(appDir) || fs.existsSync(srcAppDir);
+
+	if (!hasAppDir) {
+		return {
+			valid: false,
+			error:
+				"No app/ or src/app/ directory found. This CLI supports Next.js App Router projects only.",
+		};
+	}
+
+	// Detect which structure is used
+	const usesSrcPrefix = fs.existsSync(srcAppDir);
+
+	return { valid: true, pkg, usesSrcPrefix };
+}
+
+/**
+ * Check if an integration is already installed
+ */
+async function checkExistingIntegration(targetDir, integration, usesSrcPrefix) {
+	const integrationPaths = {
+		sanity: "lib/integrations/sanity",
+		basehub: "lib/integrations/basehub",
+	};
+
+	const basePath = integrationPaths[integration];
+	const prefix = usesSrcPrefix ? "src/" : "";
+	const integrationPath = path.join(targetDir, prefix + basePath);
+	return fs.existsSync(integrationPath);
+}
+
+/**
+ * Add CMS depeπzckage.json
+ */
+async function addDependencies(targetDir, integration) {
+	const pkgPath = path.join(targetDir, "package.json");
+	const pkg = await fs.readJson(pkgPath);
+
+	if (integration === "sanity") {
+		pkg.dependencies = {
+			...pkg.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",
+		};
+
+		pkg.devDependencies = {
+			...pkg.devDependencies,
+			sanity: "^5.6.0",
+		};
+
+		pkg.scripts = {
+			...pkg.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",
+		};
+	} else if (integration === "basehub") {
+		pkg.dependencies = {
+			...pkg.dependencies,
+			basehub: "^3.0.0",
+		};
+	}
+
+	await fs.writeJson(pkgPath, pkg, { spaces: 2 });
+}
+
+/**
+ * Adds an integration to the current working directory project
+ */
+export async function addIntegration(options = {}) {
+	const targetDir = process.cwd();
+
+	// 1. Validate current directory is a Next.js project
+	const validationSpinner = ora("Validating project...").start();
+	const validation = await validateProject(targetDir);
+
+	if (!validation.valid) {
+		validationSpinner.fail(pc.red(validation.error));
+		console.log(
+			pc.yellow(
+				"\n💡 Make sure you're in a Next.js App Router project directory.\n",
+			),
+		);
+		return;
+	}
+	const projectStructure = validation.usesSrcPrefix ? "src/" : "root";
+	validationSpinner.succeed(
+		pc.green(
+			`Found Next.js project: ${pc.cyan(validation.pkg.name || "unnamed")} (${projectStructure} structure)`,
+		),
+	);
+
+	// 2. Select integration (or use flag)
+	let integration = options.cms;
+
+	if (!integration || integration === "none") {
+		const { selectedIntegration } = await prompts({
+			type: "select",
+			name: "selectedIntegration",
+			message: "Which integration would you like to add?",
+			choices: [
+				{
+					title: "Sanity CMS",
+					description: "Headless CMS with real-time collaboration",
+					value: "sanity",
+				},
+				{
+					title: "BaseHub",
+					description: "AI-native headless CMS",
+					value: "basehub",
+				},
+			],
+		});
+
+		if (!selectedIntegration) {
+			console.log(pc.yellow("\n⚠ Operation cancelled.\n"));
+			return;
+		}
+
+		integration = selectedIntegration;
+	}
+
+	// 3. Check if integration already exists
+	const alreadyExists = await checkExistingIntegration(
+		targetDir,
+		integration,
+		validation.usesSrcPrefix,
+	);
+	if (alreadyExists) {
+		const { overwrite } = await prompts({
+			type: "confirm",
+			name: "overwrite",
+			message: `${pc.yellow(integration)} integration already exists. Overwrite?`,
+			initial: false,
+		});
+
+		if (!overwrite) {
+			console.log(pc.yellow("⚠ Operation cancelled."));
+			return;
+		}
+	}
+
+	// 4. Inject integration files using existing merger system
+	const integrationSpinner = ora(
+		`Adding ${pc.cyan(integration)} integration...`,
+	).start();
+
+	try {
+		const { injectIntegration, formatMergeResults } = await import(
+			"../mergers/index.js"
+		);
+		const results = await injectIntegration(
+			targetDir,
+			integration,
+			integrationSpinner,
+		);
+
+		const hasErrors = results.failed.length > 0;
+		const resultLines = formatMergeResults(results);
+
+		if (hasErrors) {
+			integrationSpinner.warn(
+				pc.yellow(`${integration} integration completed with warnings:`),
+			);
+		} else {
+			integrationSpinner.succeed(pc.green(`${integration} integration added:`));
+		}
+
+		// Display detailed results
+		for (const line of resultLines) {
+			console.log(pc.dim(line));
+		}
+	} catch (e) {
+		integrationSpinner.fail(
+			pc.red(`Failed to inject ${integration} integration: ${e.message}`),
+		);
+		return;
+	}
+
+	// 5. Add dependencies to package.json
+	const depsSpinner = ora("Adding dependencies to package.json...").start();
+	try {
+		await addDependencies(targetDir, integration);
+		depsSpinner.succeed(pc.green("Dependencies added to package.json"));
+	} catch (e) {
+		depsSpinner.warn(pc.yellow(`Failed to update package.json: ${e.message}`));
+	}
+
+	// 6. Register Sanity MCP Server + Agent Toolkit
+	if (integration === "sanity") {
+		// MCP registration (Claude Code only)
+		const claudeDir = path.join(targetDir, ".claude");
+		if (fs.existsSync(claudeDir)) {
+			const mcpSpinner = ora("Registering Sanity MCP server...").start();
+			try {
+				execSync(
+					"claude mcp add Sanity -t http https://mcp.sanity.io --scope user",
+					{
+						stdio: "pipe",
+					},
+				);
+				mcpSpinner.succeed(pc.green("Sanity MCP server registered."));
+			} catch (e) {
+				const stderr = e.stderr?.toString() || "";
+				if (stderr.includes("already exists")) {
+					mcpSpinner.succeed(pc.green("Sanity MCP server already registered."));
+				} else {
+					mcpSpinner.warn(
+						pc.yellow(
+							"Could not register Sanity MCP server. Run manually: claude mcp add Sanity -t http https://mcp.sanity.io --scope user",
+						),
+					);
+				}
+			}
+		}
+
+		// Agent toolkit skills
+		const agentArg = fs.existsSync(path.join(targetDir, ".claude"))
+			? "claude-code"
+			: fs.existsSync(path.join(targetDir, ".opencode"))
+				? "opencode"
+				: null;
+
+		if (agentArg) {
+			const skillsSpinner = ora("Installing Sanity agent toolkit...").start();
+			try {
+				execSync(`bunx skills add sanity-io/agent-toolkit -a ${agentArg} -y`, {
+					cwd: targetDir,
+					stdio: "ignore",
+				});
+				skillsSpinner.succeed(pc.green("Sanity agent toolkit installed."));
+			} catch (_e) {
+				skillsSpinner.warn(
+					pc.yellow(
+						"Could not install Sanity agent toolkit. Add manually: bunx skills add sanity-io/agent-toolkit",
+					),
+				);
+			}
+		}
+	}
+
+	// 7. Automated Sanity Project Setup
+	let sanitySetupDone = false;
+	if (integration === "sanity") {
+		try {
+			const { setupSanityProject } = await import("./setup-sanity.js");
+			sanitySetupDone = await setupSanityProject(targetDir);
+		} catch (e) {
+			console.log(pc.yellow(`\n  Sanity auto-setup skipped: ${e.message}`));
+			console.log(pc.dim("  You can set up Sanity manually later.\n"));
+		}
+	}
+
+	// 8. Success message with next steps
+	console.log(
+		`\n${pc.bold(pc.green("✅ Success!"))} ${pc.cyan(integration)} integration added to your project.`,
+	);
+	console.log(`\n${pc.bold("Next steps:")}`);
+	console.log(pc.cyan(`  1. Run: bun install`));
+
+	if (integration === "sanity") {
+		if (sanitySetupDone) {
+			console.log(pc.cyan(`  2. Run: bun sanity:typegen`));
+			console.log(pc.cyan(`  3. Access Sanity Studio at: /studio`));
+		} else {
+			console.log(
+				pc.cyan(`  2. Create a Sanity project at https://sanity.io/manage`),
+			);
+			console.log(pc.cyan(`  3. Add your Sanity credentials to .env.local:`));
+			console.log(pc.dim(`     NEXT_PUBLIC_SANITY_PROJECT_ID=your-project-id`));
+			console.log(pc.dim(`     NEXT_PUBLIC_SANITY_DATASET=production`));
+			console.log(pc.dim(`     SANITY_API_READ_TOKEN=your-read-token`));
+			console.log(pc.cyan(`  4. Run: bun sanity:typegen`));
+			console.log(pc.cyan(`  5. Access Sanity Studio at: /studio`));
+		}
+	} else if (integration === "basehub") {
+		console.log(
+			pc.cyan(`  2. Create a BaseHub project at https://basehub.com`),
+		);
+		console.log(pc.cyan(`  3. Add your BaseHub token to .env.local:`));
+		console.log(pc.dim(`     BASEHUB_TOKEN=your-token`));
+	}
+
+	console.log();
+}