@angeloashmore/prismic-cli-poc 0.0.0-pr.3.219652e → 0.0.0-pr.4.484acb8

package/src/status.ts

@@ -14,6 +14,7 @@ import {
 } from "./lib/custom-types-api";
 import { exists } from "./lib/file";
 import {
+	type Framework,
 	type FrameworkInfo,
 	detectFrameworkInfo,
 	getClientFilePath,
@@ -29,6 +30,9 @@ import { getWebhooks } from "./webhook-view";
 const HELP = `
 Show the status of the current Prismic project.
 
+Includes a "Next:" step showing the most important action to take based on
+project state.
+
 By default, this command reads the repository from prismic.config.json at the
 project root.
 
@@ -58,6 +62,135 @@ type StatusSection = {
 	items: StatusItem[];
 };
 
+type NextStep = {
+	message: string;
+};
+
+function getDocsUrl(framework: Framework | undefined): string {
+	switch (framework) {
+		case "next":
+			return "https://prismic.io/docs/nextjs/with-cli";
+		case "nuxt":
+			return "https://prismic.io/docs/nuxt/with-cli";
+		case "sveltekit":
+			return "https://prismic.io/docs/sveltekit/with-cli";
+		default:
+			return "https://prismic.io/docs";
+	}
+}
+
+function computeNextStep(
+	sections: StatusSection[],
+	frameworkInfo: FrameworkInfo,
+	typeStatuses: TypeWithStatus[],
+	sliceStatuses: TypeWithStatus[],
+	slicesWithMissingComponents: string[],
+): NextStep | undefined {
+	const docsUrl = getDocsUrl(frameworkInfo.framework);
+
+	// 1. Setup - missing dependencies
+	const setupSection = sections.find((s) => s.title === "Setup");
+	const missingDeps = setupSection?.items.filter((i) => !i.done && i.hint === "not installed");
+	if (missingDeps && missingDeps.length > 0) {
+		const depsList = missingDeps.map((d) => d.label).join(" ");
+		return { message: `Install Prismic packages with 'npm install ${depsList}'` };
+	}
+
+	// 2. Setup - missing client file
+	const missingClientFile = setupSection?.items.find((i) => !i.done && i.hint?.includes("client"));
+	if (missingClientFile) {
+		return { message: `Create a ${missingClientFile.label} file (see ${docsUrl})` };
+	}
+
+	// 3-7. Preview section (in order: local files, then remote config)
+	const previewSection = sections.find((s) => s.title === "Preview");
+	if (previewSection) {
+		// Local files first
+		const sliceSimRoute = previewSection.items.find(
+			(i) => i.label === "/slice-simulator route" && !i.done,
+		);
+		if (sliceSimRoute) {
+			return { message: `Create the /slice-simulator route (see ${docsUrl})` };
+		}
+
+		const apiPreview = previewSection.items.find(
+			(i) => i.label === "/api/preview endpoint" && !i.done,
+		);
+		if (apiPreview) {
+			return { message: `Create the /api/preview route (see ${docsUrl})` };
+		}
+
+		const exitPreview = previewSection.items.find(
+			(i) => i.label === "/api/exit-preview endpoint" && !i.done,
+		);
+		if (exitPreview) {
+			return { message: `Create the /api/exit-preview route (see ${docsUrl})` };
+		}
+
+		// Remote config
+		const simulatorUrl = previewSection.items.find(
+			(i) => i.label === "Slice simulator URL" && !i.done,
+		);
+		if (simulatorUrl) {
+			return { message: `Configure the slice simulator URL with 'prismic preview set-simulator'` };
+		}
+
+		const previewEnv = previewSection.items.find(
+			(i) => i.label === "Preview environment" && !i.done,
+		);
+		if (previewEnv) {
+			return { message: `Add a preview environment with 'prismic preview add'` };
+		}
+	}
+
+	// 8. Models to pull
+	const hasToPull =
+		typeStatuses.some((t) => t.status === "to_pull") ||
+		sliceStatuses.some((s) => s.status === "to_pull");
+	if (hasToPull) {
+		return { message: `Pull remote models with 'prismic pull'` };
+	}
+
+	// 9. Models to push
+	const hasToPush =
+		typeStatuses.some((t) => t.status === "to_push") ||
+		sliceStatuses.some((s) => s.status === "to_push");
+	if (hasToPush) {
+		return { message: `Push local models with 'prismic push'` };
+	}
+
+	// 10. Slice components to implement (first alphabetically)
+	if (slicesWithMissingComponents.length > 0) {
+		const sorted = [...slicesWithMissingComponents].sort();
+		const sliceName = sorted[0];
+		const slicesDir = getSlicesDirectory(frameworkInfo);
+		const ext = getSliceComponentExtensions(frameworkInfo.framework)[0];
+		const path = `${slicesDir}${sliceName}/index${ext}`;
+		return { message: `Implement the ${sliceName} slice component at ${path} (see ${docsUrl})` };
+	}
+
+	// 11-12. Deployment (Next.js only)
+	const deploymentSection = sections.find((s) => s.title === "Deployment");
+	if (deploymentSection) {
+		const revalidateEndpoint = deploymentSection.items.find(
+			(i) => i.label === "/api/revalidate endpoint" && !i.done,
+		);
+		if (revalidateEndpoint) {
+			return { message: `Create the /api/revalidate route for ISR (see ${docsUrl})` };
+		}
+
+		const webhook = deploymentSection.items.find(
+			(i) => i.label === "Revalidation webhook" && !i.done,
+		);
+		if (webhook) {
+			return { message: `Create a revalidation webhook with 'prismic webhook create'` };
+		}
+	}
+
+	// All complete
+	return undefined;
+}
+
 export async function status(): Promise<void> {
 	const {
 		values: { help, repo = await safeGetRepositoryFromConfig() },
@@ -118,39 +251,42 @@ export async function status(): Promise<void> {
 
 	// Print repository header
 	const repoUrl = await getRepoUrl(repo);
-	console.info(`Repository:         ${repo}`);
-	console.info(`URL:                ${repoUrl.href}`);
-
-	if (repoInfoResult.ok) {
-		const accessLevel = formatApiAccess(repoInfoResult.value.api_access);
-		console.info(`Content API Access: ${accessLevel}`);
-	}
+	console.info(`Repository: ${repo}`);
+	console.info(`URL:        ${repoUrl.href}`);
 	console.info("");
 
 	const sections: StatusSection[] = [];
 
+	// Track statuses for next step computation
+	let typeStatuses: TypeWithStatus[] = [];
+	let sliceStatuses: TypeWithStatus[] = [];
+	let slicesWithMissingComponents: string[] = [];
+
 	// Setup section
 	const setupSection = await buildSetupSection(frameworkInfo, installedDeps);
 	sections.push(setupSection);
 
 	// Types sections (Page Types and Custom Types)
 	if (localTypesResult.ok && remoteTypesResult.ok) {
-		const { pageTypes, customTypes } = buildTypeSections(
+		const { pageTypes, customTypes, allTypeStatuses } = buildTypeSections(
 			localTypesResult.value,
 			remoteTypesResult.value,
 		);
 		sections.push(pageTypes);
 		sections.push(customTypes);
+		typeStatuses = allTypeStatuses;
 	}
 
 	// Slices section
 	if (localSlicesResult.ok && remoteSlicesResult.ok) {
-		const slicesSection = await buildSlicesSection(
-			localSlicesResult.value,
-			remoteSlicesResult.value,
-			frameworkInfo,
-		);
+		const {
+			section: slicesSection,
+			statuses,
+			missingComponents,
+		} = await buildSlicesSection(localSlicesResult.value, remoteSlicesResult.value, frameworkInfo);
 		sections.push(slicesSection);
+		sliceStatuses = statuses;
+		slicesWithMissingComponents = missingComponents;
 	}
 
 	// Preview section
@@ -174,6 +310,18 @@ export async function status(): Promise<void> {
 	for (const section of sections) {
 		printSection(section);
 	}
+
+	// Print next step
+	const nextStep = computeNextStep(
+		sections,
+		frameworkInfo,
+		typeStatuses,
+		sliceStatuses,
+		slicesWithMissingComponents,
+	);
+	if (nextStep) {
+		console.info(`Next: ${nextStep.message}`);
+	}
 }
 
 function printSection(section: StatusSection): void {
@@ -208,9 +356,8 @@ function printSection(section: StatusSection): void {
 	console.info("");
 }
 
-// Repository Info
+// Repository Info (from /core/repository)
 const RepositoryInfoSchema = v.object({
-	api_access: v.optional(v.string()),
 	simulator_url: v.optional(v.string()),
 });
 type RepositoryInfo = v.InferOutput<typeof RepositoryInfoSchema>;
@@ -226,19 +373,6 @@ async function fetchRepositoryInfo(
 	return { ok: false };
 }
 
-function formatApiAccess(access: string | undefined): string {
-	switch (access) {
-		case "private":
-			return "Private";
-		case "open":
-			return "Open";
-		case "master_only":
-			return "Master only";
-		default:
-			return access || "Unknown";
-	}
-}
-
 // Previews
 const PreviewSchema = v.object({
 	id: v.string(),
@@ -371,7 +505,7 @@ function computeTypeStatus<T extends { id: string }>(local: T[], remote: T[]): T
 function buildTypeSections(
 	localTypes: CustomType[],
 	remoteTypes: CustomType[],
-): { pageTypes: StatusSection; customTypes: StatusSection } {
+): { pageTypes: StatusSection; customTypes: StatusSection; allTypeStatuses: TypeWithStatus[] } {
 	const typeStatuses = computeTypeStatus(localTypes, remoteTypes);
 
 	// Separate by format
@@ -404,6 +538,7 @@ function buildTypeSections(
 	return {
 		pageTypes: { title: "Page Types", items: pageTypeItems },
 		customTypes: { title: "Custom Types", items: customTypeItems },
+		allTypeStatuses: typeStatuses,
 	};
 }
 
@@ -423,9 +558,14 @@ async function buildSlicesSection(
 	localSlices: SharedSlice[],
 	remoteSlices: SharedSlice[],
 	info: FrameworkInfo,
-): Promise<StatusSection> {
+): Promise<{
+	section: StatusSection;
+	statuses: TypeWithStatus[];
+	missingComponents: string[];
+}> {
 	const sliceStatuses = computeTypeStatus(localSlices, remoteSlices);
 	const items: StatusItem[] = [];
+	const missingComponents: string[] = [];
 
 	const slicesDir = getSlicesDirectory(info);
 	const extensions = getSliceComponentExtensions(info.framework);
@@ -446,6 +586,7 @@ async function buildSlicesSection(
 				label: slice.label,
 				hint: "missing component",
 			});
+			missingComponents.push(slice.label);
 		} else {
 			items.push({
 				done: false,
@@ -455,7 +596,11 @@ async function buildSlicesSection(
 		}
 	}
 
-	return { title: "Slices", items };
+	return {
+		section: { title: "Slices", items },
+		statuses: sliceStatuses,
+		missingComponents,
+	};
 }
 
 async function checkSliceComponent(