@farming-labs/docs 0.1.125 → 0.1.128

package/dist/cloud-88xTLXn3.mjs

@@ -0,0 +1,529 @@
+import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelBooleanProperty, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-CBoixmrv.mjs";
+import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
+import fs from "node:fs";
+import path from "node:path";
+import pc from "picocolors";
+import { execFileSync } from "node:child_process";
+
+//#region src/cli/cloud.ts
+const DOCS_JSON_FILE = "docs.json";
+const DOCS_CLOUD_SCHEMA_URL = "https://docs.farming-labs.dev/schema/docs.json";
+const DOCS_CLOUD_DEFAULT_API_KEY_ENV = "DOCS_CLOUD_API_KEY";
+const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://docs-app.farming-labs.dev";
+const DEFAULT_PREVIEW_TIMEOUT_MS = 300 * 1e3;
+const DEFAULT_PREVIEW_POLL_INTERVAL_MS = 2e3;
+function isRecord(value) {
+	return Boolean(value && typeof value === "object" && !Array.isArray(value));
+}
+function isJsonRecord(value) {
+	return isRecord(value);
+}
+function toJsonRecord(value) {
+	if (!isRecord(value)) return void 0;
+	return JSON.parse(JSON.stringify(value));
+}
+function readPackageName(rootDir) {
+	const packagePath = path.join(rootDir, "package.json");
+	if (!fs.existsSync(packagePath)) return void 0;
+	try {
+		const parsed = JSON.parse(fs.readFileSync(packagePath, "utf-8"));
+		return typeof parsed.name === "string" && parsed.name.trim() ? parsed.name.trim() : void 0;
+	} catch {
+		return;
+	}
+}
+function runGit(rootDir, args) {
+	try {
+		return execFileSync("git", [
+			"-C",
+			rootDir,
+			...args
+		], {
+			encoding: "utf-8",
+			stdio: [
+				"ignore",
+				"pipe",
+				"ignore"
+			]
+		}).trim();
+	} catch {
+		return;
+	}
+}
+function parseGitHubRemote(remoteUrl) {
+	const trimmed = remoteUrl.trim();
+	const match = trimmed.match(/^git@github\.com:([^/]+)\/(.+?)(?:\.git)?$/) ?? trimmed.match(/^https:\/\/github\.com\/([^/]+)\/(.+?)(?:\.git)?(?:\/)?$/);
+	if (!match?.[1] || !match[2]) return null;
+	return {
+		owner: match[1],
+		name: match[2].replace(/\.git$/i, "")
+	};
+}
+function resolveGitRepositoryMetadata(rootDir) {
+	const gitRoot = runGit(rootDir, ["rev-parse", "--show-toplevel"]);
+	const remoteUrl = runGit(rootDir, [
+		"remote",
+		"get-url",
+		"origin"
+	]);
+	if (!gitRoot || !remoteUrl) return;
+	const parsedRemote = parseGitHubRemote(remoteUrl);
+	if (!parsedRemote) return;
+	const branch = runGit(rootDir, ["branch", "--show-current"]) ?? runGit(rootDir, [
+		"rev-parse",
+		"--abbrev-ref",
+		"HEAD"
+	]);
+	const resolvedGitRoot = fs.realpathSync(gitRoot);
+	const resolvedRootDir = fs.realpathSync(rootDir);
+	const rootDirectory = path.relative(resolvedGitRoot, resolvedRootDir).split(path.sep).filter(Boolean).join("/");
+	return {
+		...parsedRemote,
+		branch: branch && branch !== "HEAD" ? branch : void 0,
+		rootDirectory: rootDirectory || ".",
+		remoteUrl
+	};
+}
+function titleFromPackageName(name) {
+	if (!name) return void 0;
+	const normalized = name.replace(/^@[^/]+\//, "").replace(/[-_]+/g, " ").trim();
+	if (!normalized) return void 0;
+	return normalized.replace(/\b\w/g, (match) => match.toUpperCase());
+}
+function tryResolveDocsConfigPath(rootDir, explicitPath) {
+	if (explicitPath) return resolveDocsConfigPath(rootDir, explicitPath);
+	try {
+		return resolveDocsConfigPath(rootDir);
+	} catch {
+		return;
+	}
+}
+async function loadDocsConfigSnapshot(rootDir, explicitPath) {
+	const configPath = tryResolveDocsConfigPath(rootDir, explicitPath);
+	if (!configPath) return {};
+	return {
+		path: configPath,
+		content: fs.readFileSync(configPath, "utf-8"),
+		config: (await loadDocsConfigModule(rootDir, configPath, { silent: true }))?.config
+	};
+}
+function readExistingDocsJson(docsJsonPath) {
+	if (!fs.existsSync(docsJsonPath)) return void 0;
+	try {
+		const parsed = JSON.parse(fs.readFileSync(docsJsonPath, "utf-8"));
+		if (!isJsonRecord(parsed)) throw new Error(`${DOCS_JSON_FILE} must contain a JSON object.`);
+		return parsed;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		throw new Error(`Could not parse ${DOCS_JSON_FILE}: ${message}`);
+	}
+}
+function normalizeApiKeyConfig(apiKey) {
+	return { env: apiKey?.env?.trim() || DOCS_CLOUD_DEFAULT_API_KEY_ENV };
+}
+function normalizePreviewConfig(preview) {
+	return { enabled: preview?.enabled ?? true };
+}
+function normalizePublishConfig(publish) {
+	return {
+		mode: publish?.mode === "direct-commit" ? "direct-commit" : "draft-pr",
+		baseBranch: publish?.baseBranch?.trim() || "main"
+	};
+}
+function normalizeFeatureConfig(feature) {
+	if (!feature) return void 0;
+	return { enabled: feature.enabled ?? true };
+}
+function normalizeAnalyticsConfig(analytics) {
+	if (typeof analytics === "undefined") return void 0;
+	if (typeof analytics === "boolean") return analytics;
+	return {
+		enabled: analytics.enabled ?? true,
+		...typeof analytics.console !== "undefined" ? { console: analytics.console } : {},
+		includeInputs: analytics.includeInputs ?? false
+	};
+}
+function normalizeCloudConfig(cloud) {
+	const normalized = {
+		apiKey: normalizeApiKeyConfig(cloud?.apiKey),
+		preview: normalizePreviewConfig(cloud?.preview),
+		publish: normalizePublishConfig(cloud?.publish)
+	};
+	if (cloud?.enabled === false) normalized.enabled = false;
+	const analytics = normalizeAnalyticsConfig(cloud?.analytics);
+	if (typeof analytics !== "undefined") normalized.analytics = analytics;
+	const ai = normalizeFeatureConfig(cloud?.ai);
+	if (ai) normalized.ai = ai;
+	const deploy = normalizeFeatureConfig(cloud?.deploy);
+	if (deploy) normalized.deploy = deploy;
+	return normalized;
+}
+function readStaticCloudConfig(content) {
+	if (!content || !extractNestedObjectLiteral(content, ["cloud"])) return void 0;
+	const cloudBlock = extractNestedObjectLiteral(content, ["cloud"]);
+	const apiKeyBlock = extractNestedObjectLiteral(content, ["cloud", "apiKey"]);
+	const previewBlock = extractNestedObjectLiteral(content, ["cloud", "preview"]);
+	const publishBlock = extractNestedObjectLiteral(content, ["cloud", "publish"]);
+	const analyticsBlock = extractNestedObjectLiteral(content, ["cloud", "analytics"]);
+	const aiBlock = extractNestedObjectLiteral(content, ["cloud", "ai"]);
+	const deployBlock = extractNestedObjectLiteral(content, ["cloud", "deploy"]);
+	const cloud = {};
+	const enabled = cloudBlock ? readTopLevelBooleanProperty(cloudBlock, "enabled") : void 0;
+	if (typeof enabled === "boolean") cloud.enabled = enabled;
+	const apiKeyEnv = apiKeyBlock ? readStringProperty(apiKeyBlock, "env") : void 0;
+	if (apiKeyEnv) cloud.apiKey = { env: apiKeyEnv };
+	const previewEnabled = previewBlock ? readTopLevelBooleanProperty(previewBlock, "enabled") : void 0;
+	if (typeof previewEnabled === "boolean") cloud.preview = { enabled: previewEnabled };
+	const publishMode = publishBlock ? readStringProperty(publishBlock, "mode") : void 0;
+	const baseBranch = publishBlock ? readStringProperty(publishBlock, "baseBranch") : void 0;
+	if (publishMode || baseBranch) cloud.publish = {
+		...publishMode === "direct-commit" || publishMode === "draft-pr" ? { mode: publishMode } : {},
+		...baseBranch ? { baseBranch } : {}
+	};
+	const analyticsEnabled = cloudBlock ? readTopLevelBooleanProperty(cloudBlock, "analytics") : void 0;
+	if (typeof analyticsEnabled === "boolean") cloud.analytics = analyticsEnabled;
+	else if (analyticsBlock) {
+		const analytics = {};
+		const enabledValue = readTopLevelBooleanProperty(analyticsBlock, "enabled");
+		const consoleBoolean = readTopLevelBooleanProperty(analyticsBlock, "console");
+		const consoleMode = readStringProperty(analyticsBlock, "console");
+		const includeInputs = readTopLevelBooleanProperty(analyticsBlock, "includeInputs");
+		if (typeof enabledValue === "boolean") analytics.enabled = enabledValue;
+		if (typeof consoleBoolean === "boolean") analytics.console = consoleBoolean;
+		else if (consoleMode === "log" || consoleMode === "info" || consoleMode === "debug") analytics.console = consoleMode;
+		if (typeof includeInputs === "boolean") analytics.includeInputs = includeInputs;
+		cloud.analytics = analytics;
+	}
+	const aiEnabled = aiBlock ? readTopLevelBooleanProperty(aiBlock, "enabled") : void 0;
+	if (typeof aiEnabled === "boolean") cloud.ai = { enabled: aiEnabled };
+	const deployEnabled = deployBlock ? readTopLevelBooleanProperty(deployBlock, "enabled") : void 0;
+	if (typeof deployEnabled === "boolean") cloud.deploy = { enabled: deployEnabled };
+	return cloud;
+}
+function resolveCloudConfig(snapshot, existing) {
+	const moduleCloud = snapshot.config?.cloud;
+	const staticCloud = readStaticCloudConfig(snapshot.content);
+	const existingCloud = existing?.cloud;
+	return normalizeCloudConfig(moduleCloud ?? staticCloud ?? existingCloud);
+}
+function resolveApiReferenceRoot(snapshot) {
+	const apiReference = snapshot.config?.apiReference;
+	if (isRecord(apiReference) && typeof apiReference.path === "string" && apiReference.path.trim()) return apiReference.path.trim();
+	const apiReferenceBlock = extractNestedObjectLiteral(snapshot.content ?? "", ["apiReference"]);
+	if (!apiReferenceBlock) return void 0;
+	return readStringProperty(apiReferenceBlock, "path");
+}
+function resolveSiteConfig(rootDir, snapshot, existing) {
+	const existingSite = toJsonRecord(existing?.site);
+	const navTitle = isRecord(snapshot.config?.nav) && typeof snapshot.config.nav.title === "string" ? snapshot.config.nav.title : readNavTitle(snapshot.content ?? "");
+	const metadata = isRecord(snapshot.config?.metadata) ? snapshot.config.metadata : void 0;
+	const metadataDescription = typeof metadata?.description === "string" && metadata.description.trim() ? metadata.description.trim() : void 0;
+	const packageTitle = titleFromPackageName(readPackageName(rootDir));
+	const name = navTitle?.trim() || existingSite?.name || packageTitle;
+	const description = metadataDescription || existingSite?.description;
+	if (!name && !description && !existingSite) return void 0;
+	return {
+		...existingSite ?? {},
+		...typeof name === "string" ? { name } : {},
+		...typeof description === "string" ? { description } : {}
+	};
+}
+function resolveDocsRoot(rootDir, snapshot, existing) {
+	const entry = snapshot.config?.entry ?? readTopLevelStringProperty(snapshot.content ?? "", "entry") ?? "docs";
+	if (snapshot.config?.contentDir) return snapshot.config.contentDir;
+	if (snapshot.content) return resolveDocsContentDir(rootDir, snapshot.content, entry);
+	if (typeof existing?.content?.docsRoot === "string") return existing.content.docsRoot;
+	return fs.existsSync(path.join(rootDir, "app", entry)) ? path.join("app", entry) : entry;
+}
+function resolveDocsBlock(rootDir, snapshot, existing) {
+	const detectedFramework = detectFramework(rootDir);
+	const existingDocs = existing?.docs;
+	const runtime = detectedFramework ?? existingDocs?.runtime ?? "nextjs";
+	if (!Boolean(snapshot.path || detectedFramework) && existingDocs) return existingDocs;
+	return {
+		mode: "framework",
+		runtime,
+		root: existingDocs?.root || "."
+	};
+}
+function materializeDocsJsonObject(params) {
+	const cloud = resolveCloudConfig(params.snapshot, params.existing);
+	const docsRoot = resolveDocsRoot(params.rootDir, params.snapshot, params.existing);
+	const apiReferenceRoot = resolveApiReferenceRoot(params.snapshot);
+	const existingContent = toJsonRecord(params.existing?.content);
+	const site = resolveSiteConfig(params.rootDir, params.snapshot, params.existing);
+	const content = {
+		...existingContent ?? {},
+		docsRoot,
+		...apiReferenceRoot ? { apiReferenceRoot } : {}
+	};
+	return {
+		...params.existing ?? {},
+		$schema: params.existing?.$schema ?? DOCS_CLOUD_SCHEMA_URL,
+		version: 1,
+		docs: resolveDocsBlock(params.rootDir, params.snapshot, params.existing),
+		content,
+		...site ? { site } : {},
+		cloud
+	};
+}
+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);
+	const config = materializeDocsJsonObject({
+		rootDir,
+		snapshot,
+		existing
+	});
+	const serialized = serializeMaterializedDocsJson(config);
+	const updated = (existing ? fs.readFileSync(docsJsonPath, "utf-8") : void 0) !== serialized;
+	if (updated) fs.writeFileSync(docsJsonPath, serialized, "utf-8");
+	return {
+		configPath: snapshot.path ?? docsJsonPath,
+		docsJsonPath,
+		config,
+		apiKeyEnv: config.cloud?.apiKey?.env ?? DOCS_CLOUD_DEFAULT_API_KEY_ENV,
+		created: !existing,
+		updated
+	};
+}
+function resolveApiBaseUrl(options) {
+	return (options.apiBaseUrl ?? process.env.DOCS_CLOUD_API_URL ?? process.env.NEXT_PUBLIC_DOCS_CLOUD_URL ?? DEFAULT_DOCS_CLOUD_API_BASE_URL).replace(/\/+$/, "");
+}
+function resolveApiKey(options, rootDir, envName) {
+	if (options.apiKey?.trim()) return options.apiKey.trim();
+	const token = {
+		...loadProjectEnv(rootDir),
+		...process.env
+	}[envName]?.trim();
+	if (token) return token;
+	throw new Error(`Missing Docs Cloud API key. Set ${envName} in your shell or .env.local, or configure cloud.apiKey.env in docs.config.ts.`);
+}
+async function readJsonResponse(response) {
+	const text = await response.text();
+	if (!text.trim()) return {};
+	try {
+		return JSON.parse(text);
+	} catch {
+		return { message: text };
+	}
+}
+function readResponseMessage(body, fallback) {
+	if (isRecord(body)) for (const key of [
+		"error",
+		"message",
+		"detail"
+	]) {
+		const value = body[key];
+		if (typeof value === "string" && value.trim()) return value.trim();
+	}
+	return fallback;
+}
+async function fetchCloudJson(params) {
+	const headers = new Headers(params.init?.headers);
+	headers.set("authorization", `Bearer ${params.apiKey}`);
+	headers.set("accept", "application/json");
+	if (params.init?.body && !headers.has("content-type")) headers.set("content-type", "application/json");
+	const response = await fetch(params.url, {
+		...params.init,
+		headers
+	});
+	const body = await readJsonResponse(response);
+	if (!response.ok) {
+		const requestPath = new URL(params.url).pathname;
+		if (response.status === 404 && requestPath === "/api/cloud/preview") throw new Error("Docs Cloud preview API is not available on this cloud host yet. The API key was validated, but the host did not expose /api/cloud/preview.");
+		const message = readResponseMessage(body, `Docs Cloud request failed with HTTP ${response.status}.`);
+		throw new Error(message);
+	}
+	return body;
+}
+function readPreviewUrl(body) {
+	if (!isRecord(body)) return void 0;
+	const direct = body.url ?? body.previewUrl;
+	if (typeof direct === "string" && direct.trim()) return direct.trim();
+	const preview = body.preview;
+	if (isRecord(preview) && typeof preview.url === "string" && preview.url.trim()) return preview.url.trim();
+}
+function readStatusUrl(body, apiBaseUrl) {
+	if (!isRecord(body)) return void 0;
+	const statusUrl = body.statusUrl ?? body.pollUrl;
+	if (typeof statusUrl !== "string" || !statusUrl.trim()) return void 0;
+	return new URL(statusUrl, apiBaseUrl).toString();
+}
+function readPreviewStatus(body) {
+	if (!isRecord(body)) return void 0;
+	const status = body.status;
+	return typeof status === "string" ? status : void 0;
+}
+async function requestPreview(params) {
+	const initial = await fetchCloudJson({
+		url: `${params.apiBaseUrl}/api/cloud/preview`,
+		apiKey: params.apiKey,
+		init: {
+			method: "POST",
+			body: JSON.stringify({
+				config: params.config,
+				configPath: path.relative(params.rootDir, params.configPath) || DOCS_JSON_FILE,
+				repository: resolveGitRepositoryMetadata(params.rootDir)
+			})
+		}
+	});
+	const initialUrl = readPreviewUrl(initial);
+	if (initialUrl) return {
+		url: initialUrl,
+		response: initial
+	};
+	const statusUrl = readStatusUrl(initial, params.apiBaseUrl);
+	if (!statusUrl) throw new Error("Docs Cloud accepted the preview request but did not return a preview URL or status URL.");
+	const startedAt = Date.now();
+	while (Date.now() - startedAt < params.timeoutMs) {
+		await new Promise((resolve) => setTimeout(resolve, params.pollIntervalMs));
+		params.spinner.update("Waiting for Docs Cloud preview deployment");
+		const statusBody = await fetchCloudJson({
+			url: statusUrl,
+			apiKey: params.apiKey
+		});
+		const url = readPreviewUrl(statusBody);
+		if (url) return {
+			url,
+			response: statusBody
+		};
+		const status = readPreviewStatus(statusBody);
+		if (status === "failed" || status === "error") throw new Error(readResponseMessage(statusBody, "Docs Cloud preview failed."));
+	}
+	throw new Error("Docs Cloud preview timed out before a URL was ready.");
+}
+function createSpinner(initialMessage, options = {}) {
+	const interactive = Boolean(process.stdout.isTTY && !options.json && process.env.NODE_ENV !== "test");
+	const frames = [
+		"-",
+		"\\",
+		"|",
+		"/"
+	];
+	let frame = 0;
+	let message = initialMessage;
+	let timer;
+	const render = () => {
+		process.stdout.write(`\r${pc.cyan(frames[frame % frames.length])} ${message}`);
+		frame += 1;
+	};
+	if (interactive) {
+		render();
+		timer = setInterval(render, 90);
+	} else if (!options.json) console.log(`${pc.dim("-")} ${initialMessage}`);
+	const clear = () => {
+		if (timer) {
+			clearInterval(timer);
+			timer = void 0;
+		}
+		if (interactive) process.stdout.write("\r\x1B[K");
+	};
+	return {
+		update(nextMessage) {
+			message = nextMessage;
+			if (!interactive && !options.json) console.log(`${pc.dim("-")} ${nextMessage}`);
+		},
+		succeed(doneMessage) {
+			clear();
+			if (!options.json) console.log(`${pc.green("ok")} ${doneMessage}`);
+		},
+		fail(doneMessage) {
+			clear();
+			if (!options.json) console.log(`${pc.red("error")} ${doneMessage}`);
+		},
+		stop() {
+			clear();
+		}
+	};
+}
+async function syncCloudConfig(options = {}) {
+	const result = await materializeCloudConfig(options);
+	if (options.json) {
+		console.log(JSON.stringify(result, null, 2));
+		return result;
+	}
+	const action = result.created ? "Created" : result.updated ? "Synced" : "Checked";
+	console.log(`${pc.green("ok")} ${action} ${pc.cyan(path.relative(process.cwd(), result.docsJsonPath) || DOCS_JSON_FILE)}`);
+	console.log(`${pc.dim("api key env")} ${result.apiKeyEnv}`);
+	return result;
+}
+async function runCloudPreview(options = {}) {
+	const rootDir = options.rootDir ?? process.cwd();
+	const spinner = createSpinner("Preparing Docs Cloud preview", options);
+	try {
+		const materialized = await materializeCloudConfig({
+			...options,
+			rootDir
+		});
+		spinner.update(`${materialized.created ? "Created" : "Synced"} ${DOCS_JSON_FILE}`);
+		if (materialized.config.cloud?.enabled === false) throw new Error("Docs Cloud is disabled in cloud.enabled. Remove that override or set cloud.enabled: true before requesting a preview.");
+		if (materialized.config.cloud?.preview?.enabled === false) throw new Error("Docs Cloud preview is disabled in cloud.preview.enabled. Set it to true before requesting a preview.");
+		const apiKey = resolveApiKey(options, rootDir, materialized.apiKeyEnv);
+		const apiBaseUrl = resolveApiBaseUrl(options);
+		spinner.update("Validating Docs Cloud API key");
+		const identity = await fetchCloudJson({
+			url: `${apiBaseUrl}/api/cloud/me`,
+			apiKey
+		});
+		spinner.update("Requesting Docs Cloud preview deployment");
+		const preview = await requestPreview({
+			apiBaseUrl,
+			apiKey,
+			config: materialized.config,
+			configPath: materialized.docsJsonPath,
+			rootDir,
+			spinner,
+			timeoutMs: options.timeoutMs ?? DEFAULT_PREVIEW_TIMEOUT_MS,
+			pollIntervalMs: options.pollIntervalMs ?? DEFAULT_PREVIEW_POLL_INTERVAL_MS
+		});
+		spinner.succeed("Docs Cloud preview is ready");
+		const result = {
+			url: preview.url,
+			docsJsonPath: materialized.docsJsonPath,
+			apiBaseUrl,
+			identity,
+			response: preview.response
+		};
+		if (options.json) console.log(JSON.stringify(result, null, 2));
+		else console.log(`${pc.bold("Preview")} ${pc.cyan(preview.url)}`);
+		return result;
+	} catch (error) {
+		const message = error instanceof Error ? error.message : String(error);
+		spinner.fail(message);
+		throw error;
+	} finally {
+		spinner.stop();
+	}
+}
+function printCloudHelp() {
+	console.log(`
+${pc.bold("@farming-labs/docs cloud")}
+
+${pc.dim("Usage:")}
+  ${pc.cyan("docs preview")}              Sync ${pc.dim("docs.config.ts")} to ${pc.dim("docs.json")} and request a cloud preview
+  ${pc.cyan("docs cloud preview")}        Same as ${pc.cyan("docs preview")}
+  ${pc.cyan("docs cloud sync")}           Only materialize cloud settings into ${pc.dim("docs.json")}
+
+${pc.dim("Options:")}
+  ${pc.cyan("--config <path>")}           Use a custom docs config path
+  ${pc.cyan("--api-base-url <url>")}      Override Docs Cloud API base URL
+  ${pc.cyan("--api-key <key>")}           Use an API key directly; prefer ${pc.dim("cloud.apiKey.env")}
+  ${pc.cyan("--json")}                    Print machine-readable output
+
+${pc.dim("Config example:")}
+  cloud: {
+    apiKey: { env: "DOCS_CLOUD_API_KEY" },
+    preview: { enabled: true },
+    publish: { mode: "draft-pr", baseBranch: "main" },
+  }
+`);
+}
+
+//#endregion
+export { printCloudHelp, runCloudPreview, syncCloudConfig };

package/dist/{codeblocks-B4QzFqNC.mjs → codeblocks-DbJrclYa.mjs}

@@ -3,7 +3,7 @@ import { E as findDocsMarkdownPage, U as renderDocsMarkdownDocument } from "./ag
 import "./index.mjs";
 import { createFilesystemDocsMcpSource } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, l as readNumberProperty, o as readBooleanProperty, p as resolveDocsContentDir, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-B8wA38OC.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, l as readNumberProperty, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, s as readEnvReferenceProperty, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-CBoixmrv.mjs";
 import matter from "gray-matter";
 import { existsSync, mkdirSync, mkdtempSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "node:fs";
 import path from "node:path";

package/dist/{config-B8wA38OC.mjs → config-CBoixmrv.mjs}

@@ -230,6 +230,14 @@ function readTopLevelStringProperty(content, key) {
 		if (match) return match[1];
 	}
 }
+function readTopLevelBooleanProperty(content, key) {
+	const source = extractTopLevelConfigObject(content) ?? content;
+	const propertyPattern = new RegExp(`^\\s*${escapeRegExp(key)}\\s*:\\s*(true|false)\\b`);
+	for (const property of splitTopLevelProperties(source)) {
+		const match = property.trim().match(propertyPattern);
+		if (match) return match[1] === "true";
+	}
+}
 function readNavTitle(content) {
 	const block = extractObjectLiteral(extractTopLevelConfigObject(content) ?? content, "nav");
 	if (!block) return void 0;
@@ -295,4 +303,4 @@ async function loadDocsConfigModule(rootDir, explicitPath, options = {}) {
 }
 
 //#endregion
-export { loadProjectEnv as a, readNavTitle as c, readTopLevelStringProperty as d, resolveDocsConfigPath as f, loadDocsConfigModule as i, readNumberProperty as l, extractObjectLiteral as n, readBooleanProperty as o, resolveDocsContentDir as p, extractTopLevelConfigObject as r, readEnvReferenceProperty as s, extractNestedObjectLiteral as t, readStringProperty as u };
+export { loadProjectEnv as a, readNavTitle as c, readTopLevelBooleanProperty as d, readTopLevelStringProperty as f, loadDocsConfigModule as i, readNumberProperty as l, resolveDocsContentDir as m, extractObjectLiteral as n, readBooleanProperty as o, resolveDocsConfigPath as p, extractTopLevelConfigObject as r, readEnvReferenceProperty as s, extractNestedObjectLiteral as t, readStringProperty as u };

package/dist/{dev-1VFeAWUi.mjs → dev-DdlhqXNU.mjs}

@@ -1,5 +1,5 @@
 import { i as detectPackageManagerFromLockfile } from "./utils-x5EtYWjC.mjs";
-import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-CGaORZOY.mjs";
+import { K as rootLayoutTemplate, W as postcssConfigTemplate, g as docsLayoutTemplate, v as globalCssTemplate, yt as tsconfigTemplate } from "./templates-DomB3eeS.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -203,6 +203,12 @@ const managedConfigSchema = z.object({
 	theme: z.object({ preset: z.string().optional() }).passthrough().optional(),
 	cloud: z.object({
 		enabled: z.boolean().optional(),
+		apiKey: z.object({ env: z.string().min(1).optional() }).passthrough().optional(),
+		preview: z.object({ enabled: z.boolean().optional() }).passthrough().optional(),
+		publish: z.object({
+			mode: z.enum(["draft-pr", "direct-commit"]).optional(),
+			baseBranch: z.string().min(1).optional()
+		}).passthrough().optional(),
 		analytics: z.union([z.boolean(), z.object({
 			enabled: z.boolean().optional(),
 			console: z.union([z.boolean(), z.enum([

package/dist/{doctor-lV9lhqGA.mjs → doctor-D_c7vJCb.mjs}

@@ -1,14 +1,14 @@
-import "./reading-time-HpTq-0VB.mjs";
+import "./reading-time-DPAazAGu.mjs";
 import "./search-BL7o2rXk.mjs";
 import { a as DEFAULT_SITEMAP_XML_ROUTE, d as resolveDocsSitemapConfig, i as DEFAULT_SITEMAP_MD_WELL_KNOWN_ROUTE, r as DEFAULT_SITEMAP_MD_ROUTE } from "./sitemap-CMNj0Pt3.mjs";
 import { T as buildDocsMcpEndpointCandidates, b as DEFAULT_SKILL_MD_ROUTE, c as DEFAULT_AGENT_SPEC_WELL_KNOWN_JSON_ROUTE, d as DEFAULT_LLMS_FULL_TXT_ROUTE, g as DEFAULT_MCP_PUBLIC_ROUTE, i as DEFAULT_AGENT_FEEDBACK_ROUTE, l as DEFAULT_AGENT_SPEC_WELL_KNOWN_ROUTE, m as DEFAULT_LLMS_TXT_ROUTE, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE, v as DEFAULT_MCP_WELL_KNOWN_ROUTE, x as DEFAULT_SKILL_MD_WELL_KNOWN_ROUTE } from "./agent-BS39vnhS.mjs";
 import { a as analyzeDocsRobotsTxt, n as DEFAULT_ROBOTS_TXT_ROUTE, u as resolveDocsRobotsConfig } from "./robots-B2BfoyVM.mjs";
-import "./sitemap-server-BZHoJHqC.mjs";
+import "./sitemap-server-idLUrmmU.mjs";
 import { createFilesystemDocsMcpSource, resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { a as loadProjectEnv, c as readNavTitle, d as readTopLevelStringProperty, f as resolveDocsConfigPath, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsContentDir, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-B8wA38OC.mjs";
+import { a as loadProjectEnv, c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, m as resolveDocsContentDir, o as readBooleanProperty, p as resolveDocsConfigPath, r as extractTopLevelConfigObject, t as extractNestedObjectLiteral } from "./config-CBoixmrv.mjs";
 import { t as detectFramework } from "./utils-x5EtYWjC.mjs";
-import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-B4QzFqNC.mjs";
+import { n as inspectAgentCompactionState, o as scanDocsPageTargets } from "./codeblocks-DbJrclYa.mjs";
 import { existsSync, lstatSync, readFileSync, readdirSync } from "node:fs";
 import path from "node:path";
 import { LATEST_PROTOCOL_VERSION } from "@modelcontextprotocol/sdk/types.js";

package/dist/{downgrade-BGANzvQb.mjs → downgrade-BayU3nlg.mjs}

@@ -1,5 +1,5 @@
 import { c as fileExists, o as exec, s as execOutput } from "./utils-x5EtYWjC.mjs";
-import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-OrjpmqoR.mjs";
+import { a as getPackagesForFramework, c as resolveDocsPackageManager, l as validateUpgradeVersion, r as buildDocsPackageInstallCommand, s as resolveDocsPackageFramework } from "./package-version-CQm0KO-H.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";