@farming-labs/docs 0.2.43 → 0.2.44

package/dist/cli/index.mjs

@@ -105,36 +105,36 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-Ds7QM9po.mjs");
+		const { init } = await import("../init-Drt3Q3Y7.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
 		const { dev } = await import("../dev-CBha7knT.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-Bk-eppay.mjs");
+		const { runCloudDeploy } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-Bk-eppay.mjs");
+		const { runCloudPreview } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-Bk-eppay.mjs");
+		const { runCloudDeploy } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-Bk-eppay.mjs");
+		const { runCloudPreview } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-Bk-eppay.mjs");
+		const { runCloudInit } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-Bk-eppay.mjs");
+		const { syncCloudConfig } = await import("../cloud-C_Ok9rC5.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-Bk-eppay.mjs");
+		const { runCloudCheck } = await import("../cloud-C_Ok9rC5.mjs");
 		await runCloudCheck(cloudOptions);
 	} else if (parsedCommand.command === "cloud") {
 		console.error(pc.red(`Unknown cloud subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCloudHelp } = await import("../cloud-Bk-eppay.mjs");
+		const { printCloudHelp } = await import("../cloud-C_Ok9rC5.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {

package/dist/{cloud-Bk-eppay.mjs → cloud-C_Ok9rC5.mjs}

@@ -634,7 +634,6 @@ function resolveApiReferenceRoot(snapshot) {
 	return readStringProperty(apiReferenceBlock, "path");
 }
 function resolveConnectedDocsProfile(params) {
-	if (params.explicit) return params.explicit;
 	if (!(params.snapshot.content?.includes(FUMADOCS_CONNECT_MARKER) || !params.snapshot.path)) return void 0;
 	const detectedProfile = detectConnectedFumadocsProfile(params.rootDir);
 	if (detectedProfile) return detectedProfile;
@@ -665,8 +664,9 @@ function resolveDocsRoot(rootDir, snapshot, existing, docsInfraProfile) {
 	return fs.existsSync(path.join(rootDir, "app", entry)) ? path.join("app", entry) : entry;
 }
 function resolveDocsBlock(rootDir, snapshot, existing, docsInfraProfile) {
-	const detectedFramework = detectFramework(rootDir);
 	const existingDocs = existing?.docs;
+	if (!snapshot.path && existingDocs) return existingDocs;
+	const detectedFramework = detectFramework(rootDir);
 	const runtime = detectedFramework ?? docsInfraProfile?.runtime ?? existingDocs?.runtime ?? "nextjs";
 	if (!Boolean(snapshot.path || detectedFramework) && existingDocs) return existingDocs;
 	return {
@@ -675,10 +675,10 @@ function resolveDocsBlock(rootDir, snapshot, existing, docsInfraProfile) {
 		root: existingDocs?.root || "."
 	};
 }
-function resolveExtensions(existing, docsInfraProfile) {
+function resolveExtensions(existing, docsInfraProfile, options = {}) {
 	const existingExtensions = toJsonRecord(existing?.extensions);
 	if (!docsInfraProfile) {
-		if (!existingExtensions?.docsInfraProfile) return existingExtensions;
+		if (!existingExtensions?.docsInfraProfile || options.dropStaleDocsInfraProfile === false) return existingExtensions;
 		const { docsInfraProfile: _staleDocsInfraProfile, ...rest } = existingExtensions;
 		return Object.keys(rest).length > 0 ? rest : void 0;
 	}
@@ -689,17 +689,16 @@ function resolveExtensions(existing, docsInfraProfile) {
 }
 function materializeDocsJsonObject(params) {
 	const cloud = resolveCloudConfig(params.snapshot, params.existing);
-	const docsInfraProfile = resolveConnectedDocsProfile({
+	const docsInfraProfile = params.docsInfraProfile ?? (params.detectConnectedDocsProfile === false ? void 0 : resolveConnectedDocsProfile({
 		rootDir: params.rootDir,
 		snapshot: params.snapshot,
-		existing: params.existing,
-		explicit: params.docsInfraProfile
-	});
+		existing: params.existing
+	}));
 	const docsRoot = resolveDocsRoot(params.rootDir, params.snapshot, params.existing, docsInfraProfile);
 	const apiReferenceRoot = resolveApiReferenceRoot(params.snapshot);
 	const existingContent = toJsonRecord(params.existing?.content);
 	const site = resolveSiteConfig(params.rootDir, params.snapshot, params.existing);
-	const extensions = resolveExtensions(params.existing, docsInfraProfile);
+	const extensions = resolveExtensions(params.existing, docsInfraProfile, { dropStaleDocsInfraProfile: params.dropStaleDocsInfraProfile });
 	const content = {
 		...existingContent,
 		docsRoot,
@@ -719,29 +718,55 @@ function materializeDocsJsonObject(params) {
 function serializeMaterializedDocsJson(config) {
 	return `${JSON.stringify(config, null, 2)}\n`;
 }
-async function materializeCloudConfig(options = {}) {
-	const rootDir = options.rootDir ?? process.cwd();
-	const docsJsonPath = path.join(rootDir, DOCS_JSON_FILE);
-	const existing = readExistingDocsJson(docsJsonPath);
-	const snapshot = await loadDocsConfigSnapshot(rootDir, options.configPath);
+function withCloudInitDefaults(cloud, existingCloud, apiKeyEnv) {
+	const normalized = normalizeCloudConfig(cloud);
+	if (!existingCloud?.apiKey?.env) normalized.apiKey = { env: apiKeyEnv };
+	if (!normalized.deploy) normalized.deploy = { enabled: true };
+	if (typeof normalized.analytics === "undefined") normalized.analytics = {
+		enabled: true,
+		console: false,
+		includeInputs: false
+	};
+	return normalizeCloudConfig(normalized);
+}
+function writeMaterializedCloudConfig(params) {
 	const config = materializeDocsJsonObject({
-		rootDir,
-		snapshot,
-		existing,
-		docsInfraProfile: options.docsInfraProfile
+		rootDir: params.rootDir,
+		snapshot: params.snapshot,
+		existing: params.existing,
+		docsInfraProfile: params.docsInfraProfile,
+		detectConnectedDocsProfile: params.detectConnectedDocsProfile,
+		dropStaleDocsInfraProfile: params.dropStaleDocsInfraProfile
 	});
+	if (params.cloudInitApiKeyEnv) config.cloud = withCloudInitDefaults(config.cloud, params.existing?.cloud, params.cloudInitApiKeyEnv);
 	const serialized = serializeMaterializedDocsJson(config);
-	const updated = (existing ? fs.readFileSync(docsJsonPath, "utf-8") : void 0) !== serialized;
-	if (updated) fs.writeFileSync(docsJsonPath, serialized, "utf-8");
+	const updated = (params.existing ? fs.readFileSync(params.docsJsonPath, "utf-8") : void 0) !== serialized;
+	if (updated) fs.writeFileSync(params.docsJsonPath, serialized, "utf-8");
 	return {
-		configPath: snapshot.path ?? docsJsonPath,
-		docsJsonPath,
+		configPath: params.snapshot.path ?? params.docsJsonPath,
+		docsJsonPath: params.docsJsonPath,
 		config,
 		apiKeyEnv: config.cloud?.apiKey?.env ?? DOCS_CLOUD_DEFAULT_API_KEY_ENV,
-		created: !existing,
+		created: !params.existing,
 		updated
 	};
 }
+async function materializeCloudConfig(options = {}) {
+	const rootDir = options.rootDir ?? process.cwd();
+	const docsJsonPath = path.join(rootDir, DOCS_JSON_FILE);
+	const existing = readExistingDocsJson(docsJsonPath);
+	const snapshot = await loadDocsConfigSnapshot(rootDir, options.configPath);
+	const useDocsJsonAsSource = Boolean(existing && !snapshot.path);
+	return writeMaterializedCloudConfig({
+		rootDir,
+		docsJsonPath,
+		existing,
+		snapshot,
+		docsInfraProfile: options.docsInfraProfile,
+		detectConnectedDocsProfile: !useDocsJsonAsSource,
+		dropStaleDocsInfraProfile: !useDocsJsonAsSource
+	});
+}
 function readCombinedEnv(rootDir) {
 	const env = { ...loadProjectEnv(rootDir) };
 	for (const [key, value] of Object.entries(process.env)) if (typeof value === "string") env[key] = value;
@@ -1415,9 +1440,35 @@ async function syncCloudConfig(options = {}) {
 }
 async function initCloudConfig(options = {}) {
 	const rootDir = options.rootDir ?? process.cwd();
+	const docsJsonPath = path.join(rootDir, DOCS_JSON_FILE);
+	const existingDocsJson = readExistingDocsJson(docsJsonPath);
 	const apiKeyEnv = normalizeEnvName(options.apiKeyEnv, DOCS_CLOUD_DEFAULT_API_KEY_ENV);
 	const existingConfigPath = tryResolveDocsConfigPath(rootDir, options.configPath);
-	const docsInfraProfile = options.docsInfraProfile ?? (existingConfigPath ? void 0 : detectConnectedFumadocsProfile(rootDir));
+	const useDocsJsonAsSource = Boolean(existingDocsJson && !existingConfigPath);
+	const docsInfraProfile = options.docsInfraProfile ?? (existingConfigPath || existingDocsJson ? void 0 : detectConnectedFumadocsProfile(rootDir));
+	if (useDocsJsonAsSource) {
+		const materialized = writeMaterializedCloudConfig({
+			rootDir,
+			docsJsonPath,
+			existing: existingDocsJson,
+			snapshot: {},
+			docsInfraProfile,
+			cloudInitApiKeyEnv: apiKeyEnv,
+			detectConnectedDocsProfile: false,
+			dropStaleDocsInfraProfile: false
+		});
+		return {
+			configPath: materialized.configPath,
+			docsJsonPath: materialized.docsJsonPath,
+			apiKeyEnv: materialized.apiKeyEnv,
+			analyticsProjectIdEnv: DOCS_CLOUD_DEFAULT_ANALYTICS_PROJECT_ID_ENV,
+			configCreated: false,
+			configUpdated: false,
+			docsJsonCreated: false,
+			docsJsonUpdated: materialized.updated,
+			...docsInfraProfile ? { docsInfraProfile } : {}
+		};
+	}
 	const configUpdate = ensureDocsConfigCloudInit({
 		rootDir,
 		configPath: options.configPath,

package/dist/{init-Ds7QM9po.mjs → init-Drt3Q3Y7.mjs}

@@ -188,7 +188,7 @@ async function configureDocsCloudOnboarding(options) {
 		enabled = cloudAnswer;
 	}
 	if (!enabled) return;
-	const { initCloudConfig } = await import("./cloud-Bk-eppay.mjs");
+	const { initCloudConfig } = await import("./cloud-C_Ok9rC5.mjs");
 	printDocsCloudOnboardingInstructions(await initCloudConfig({
 		rootDir: options.rootDir,
 		configPath: getDocsCloudConfigPathForFramework(options.framework)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/docs",
-  "version": "0.2.43",
+  "version": "0.2.44",
   "description": "Modern, flexible MDX-based docs framework — core types, config, and CLI",
   "keywords": [
     "docs",