@farming-labs/docs 0.2.41 → 0.2.43

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

@@ -1,6 +1,6 @@
-import { n as markCliErrorReported } from "./errors-Dw5gMhEZ.mjs";
-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-De5z-2LK.mjs";
-import { t as detectFramework } from "./utils-CoHZJ1i4.mjs";
+import { n as markCliErrorReported } from "./errors-CW1LnxaQ.mjs";
+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-tiQCZ46q.mjs";
+import { i as detectPackageManagerFromProject, t as detectFramework } from "./utils-D-xTRNuh.mjs";
 import fs from "node:fs";
 import path from "node:path";
 import pc from "picocolors";
@@ -31,6 +31,7 @@ const CLOUD_CHECK_TARGETS = [
 	"analytics",
 	"ask-ai"
 ];
+const FUMADOCS_CONNECT_MARKER = "@farming-labs/docs cloud connect: fumadocs";
 function isRecord(value) {
 	return Boolean(value && typeof value === "object" && !Array.isArray(value));
 }
@@ -51,6 +52,100 @@ function readPackageName(rootDir) {
 		return;
 	}
 }
+function readPackageJsonRecord(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 isRecord(parsed) ? parsed : void 0;
+	} catch {
+		return;
+	}
+}
+function readPackageDependencies(rootDir) {
+	const packageJson = readPackageJsonRecord(rootDir);
+	const names = /* @__PURE__ */ new Set();
+	for (const key of [
+		"dependencies",
+		"devDependencies",
+		"peerDependencies",
+		"optionalDependencies"
+	]) {
+		const dependencies = packageJson?.[key];
+		if (!isRecord(dependencies)) continue;
+		for (const name of Object.keys(dependencies)) names.add(name);
+	}
+	return names;
+}
+function hasFumadocsDependency(dependencies) {
+	return [...dependencies].some((name) => name === "fumadocs-core" || name === "fumadocs-ui" || name === "fumadocs-mdx" || name === "fumadocs-openapi" || name === "fumadocs-docgen");
+}
+function firstExistingFile(rootDir, candidates) {
+	return candidates.find((candidate) => fs.existsSync(path.join(rootDir, candidate)));
+}
+function hasMarkdownDescendant(rootDir, relativeDir) {
+	const absoluteDir = path.join(rootDir, relativeDir);
+	if (!fs.existsSync(absoluteDir)) return false;
+	const queue = [absoluteDir];
+	while (queue.length > 0) {
+		const current = queue.shift();
+		let entries;
+		try {
+			entries = fs.readdirSync(current, { withFileTypes: true });
+		} catch {
+			continue;
+		}
+		for (const entry of entries) {
+			const fullPath = path.join(current, entry.name);
+			if (entry.isDirectory()) {
+				queue.push(fullPath);
+				continue;
+			}
+			if (entry.isFile() && /\.(?:md|mdx)$/i.test(entry.name)) return true;
+		}
+	}
+	return false;
+}
+function detectFumadocsContentRoots(rootDir) {
+	const roots = [
+		"content/docs",
+		"src/content/docs",
+		"docs",
+		"content"
+	].filter((candidate) => hasMarkdownDescendant(rootDir, candidate));
+	return roots.filter((root) => !roots.some((other) => other !== root && other.startsWith(`${root}/`)));
+}
+function detectConnectedFumadocsProfile(rootDir) {
+	const dependencies = readPackageDependencies(rootDir);
+	const sourceConfig = firstExistingFile(rootDir, [
+		"source.config.ts",
+		"source.config.tsx",
+		"source.config.js",
+		"source.config.mjs",
+		"source.config.cjs"
+	]);
+	const sourceFile = firstExistingFile(rootDir, [
+		"lib/source.ts",
+		"lib/source.tsx",
+		"src/lib/source.ts",
+		"src/lib/source.tsx"
+	]);
+	const contentRoots = detectFumadocsContentRoots(rootDir);
+	if (!(hasFumadocsDependency(dependencies) || Boolean(sourceConfig) || Boolean(sourceFile)) || contentRoots.length === 0) return;
+	const framework = detectFramework(rootDir) ?? "nextjs";
+	const configFiles = [sourceConfig, sourceFile].filter((file) => Boolean(file));
+	const packageManager = detectPackageManagerFromProject(rootDir)?.packageManager;
+	return {
+		engine: "fumadocs",
+		runtime: framework,
+		appRoot: ".",
+		contentRoots,
+		configFiles,
+		...packageManager ? { packageManager } : {},
+		confidence: sourceConfig || sourceFile ? "high" : "medium",
+		reason: sourceConfig ? `Detected Fumadocs source config at ${sourceConfig}.` : "Detected Fumadocs dependencies and markdown content."
+	};
+}
 function runGit(rootDir, args) {
 	try {
 		return execFileSync("git", [
@@ -363,6 +458,19 @@ ${renderCloudConfigProperty("  ", apiKeyEnv)}
 });
 `;
 }
+function renderFumadocsConnectDocsConfig(apiKeyEnv, profile) {
+	const contentDir = profile.contentRoots[0] ?? "content/docs";
+	return `// ${FUMADOCS_CONNECT_MARKER}
+import { defineDocs } from "@farming-labs/docs";
+
+export default defineDocs({
+  entry: "docs",
+  contentDir: ${JSON.stringify(contentDir)},
+${renderAnalyticsConfigProperty("  ")}
+${renderCloudConfigProperty("  ", apiKeyEnv)}
+});
+`;
+}
 function normalizeEnvName(value, fallback) {
 	const normalized = value?.trim();
 	if (!normalized) return fallback;
@@ -373,7 +481,7 @@ function ensureDocsConfigCloudInit(options) {
 	const resolvedConfigPath = tryResolveDocsConfigPath(options.rootDir, options.configPath);
 	const configPath = resolvedConfigPath ?? path.join(options.rootDir, "docs.config.ts");
 	if (!resolvedConfigPath) {
-		fs.writeFileSync(configPath, renderCloudInitDocsConfig(options.apiKeyEnv), "utf-8");
+		fs.writeFileSync(configPath, options.docsInfraProfile ? renderFumadocsConnectDocsConfig(options.apiKeyEnv, options.docsInfraProfile) : renderCloudInitDocsConfig(options.apiKeyEnv), "utf-8");
 		return {
 			configPath,
 			created: true,
@@ -525,6 +633,14 @@ function resolveApiReferenceRoot(snapshot) {
 	if (!apiReferenceBlock) return void 0;
 	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;
+	const existingProfile = params.existing?.extensions?.docsInfraProfile;
+	if (isRecord(existingProfile) && existingProfile.engine === "fumadocs" && Array.isArray(existingProfile.contentRoots)) return existingProfile;
+}
 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 ?? "");
@@ -540,17 +656,18 @@ function resolveSiteConfig(rootDir, snapshot, existing) {
 		...typeof description === "string" ? { description } : {}
 	};
 }
-function resolveDocsRoot(rootDir, snapshot, existing) {
+function resolveDocsRoot(rootDir, snapshot, existing, docsInfraProfile) {
+	if (docsInfraProfile?.contentRoots[0]) return docsInfraProfile.contentRoots[0];
 	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) {
+function resolveDocsBlock(rootDir, snapshot, existing, docsInfraProfile) {
 	const detectedFramework = detectFramework(rootDir);
 	const existingDocs = existing?.docs;
-	const runtime = detectedFramework ?? existingDocs?.runtime ?? "nextjs";
+	const runtime = detectedFramework ?? docsInfraProfile?.runtime ?? existingDocs?.runtime ?? "nextjs";
 	if (!Boolean(snapshot.path || detectedFramework) && existingDocs) return existingDocs;
 	return {
 		mode: "framework",
@@ -558,12 +675,31 @@ function resolveDocsBlock(rootDir, snapshot, existing) {
 		root: existingDocs?.root || "."
 	};
 }
+function resolveExtensions(existing, docsInfraProfile) {
+	const existingExtensions = toJsonRecord(existing?.extensions);
+	if (!docsInfraProfile) {
+		if (!existingExtensions?.docsInfraProfile) return existingExtensions;
+		const { docsInfraProfile: _staleDocsInfraProfile, ...rest } = existingExtensions;
+		return Object.keys(rest).length > 0 ? rest : void 0;
+	}
+	return {
+		...existingExtensions,
+		docsInfraProfile: toJsonRecord(docsInfraProfile)
+	};
+}
 function materializeDocsJsonObject(params) {
 	const cloud = resolveCloudConfig(params.snapshot, params.existing);
-	const docsRoot = resolveDocsRoot(params.rootDir, params.snapshot, params.existing);
+	const docsInfraProfile = resolveConnectedDocsProfile({
+		rootDir: params.rootDir,
+		snapshot: params.snapshot,
+		existing: params.existing,
+		explicit: params.docsInfraProfile
+	});
+	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 content = {
 		...existingContent,
 		docsRoot,
@@ -573,10 +709,11 @@ function materializeDocsJsonObject(params) {
 		...params.existing,
 		$schema: params.existing?.$schema ?? DOCS_CLOUD_SCHEMA_URL,
 		version: 1,
-		docs: resolveDocsBlock(params.rootDir, params.snapshot, params.existing),
+		docs: resolveDocsBlock(params.rootDir, params.snapshot, params.existing, docsInfraProfile),
 		content,
 		...site ? { site } : {},
-		cloud
+		cloud,
+		...extensions ? { extensions } : {}
 	};
 }
 function serializeMaterializedDocsJson(config) {
@@ -590,7 +727,8 @@ async function materializeCloudConfig(options = {}) {
 	const config = materializeDocsJsonObject({
 		rootDir,
 		snapshot,
-		existing
+		existing,
+		docsInfraProfile: options.docsInfraProfile
 	});
 	const serialized = serializeMaterializedDocsJson(config);
 	const updated = (existing ? fs.readFileSync(docsJsonPath, "utf-8") : void 0) !== serialized;
@@ -1278,15 +1416,19 @@ async function syncCloudConfig(options = {}) {
 async function initCloudConfig(options = {}) {
 	const rootDir = options.rootDir ?? process.cwd();
 	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 configUpdate = ensureDocsConfigCloudInit({
 		rootDir,
 		configPath: options.configPath,
-		apiKeyEnv
+		apiKeyEnv,
+		docsInfraProfile
 	});
 	const materialized = await materializeCloudConfig({
 		...options,
 		rootDir,
-		configPath: path.relative(rootDir, configUpdate.configPath)
+		configPath: path.relative(rootDir, configUpdate.configPath),
+		docsInfraProfile
 	});
 	return {
 		configPath: configUpdate.configPath,
@@ -1296,7 +1438,8 @@ async function initCloudConfig(options = {}) {
 		configCreated: configUpdate.created,
 		configUpdated: configUpdate.updated,
 		docsJsonCreated: materialized.created,
-		docsJsonUpdated: materialized.updated
+		docsJsonUpdated: materialized.updated,
+		...docsInfraProfile ? { docsInfraProfile } : {}
 	};
 }
 async function runCloudInit(options = {}) {
@@ -1311,6 +1454,7 @@ async function runCloudInit(options = {}) {
 	const docsJsonAction = result.docsJsonCreated ? "created" : result.docsJsonUpdated ? "updated" : "checked";
 	console.log(`${pc.green("ok")} ${configAction} ${pc.cyan(relativeConfigPath)}`);
 	console.log(`${pc.green("ok")} ${docsJsonAction} ${pc.cyan(relativeDocsJsonPath)}`);
+	if (result.docsInfraProfile?.engine === "fumadocs") console.log(`${pc.green("ok")} Connected existing ${pc.cyan("Fumadocs")} content at ${pc.cyan(result.docsInfraProfile.contentRoots.join(", "))}`);
 	console.log();
 	console.log(pc.bold("Add these env vars"));
 	console.log(`${pc.cyan(result.apiKeyEnv)}=${pc.dim("paste_your_docs_cloud_api_key")}`);

package/dist/cloud-analytics-Dlk_byos.mjs

@@ -0,0 +1,132 @@
+//#region src/cloud-analytics.ts
+const DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT = "https://api.farming-labs.dev/v1/analytics/events";
+function normalizeRuntimeEnvValue(value) {
+	const normalized = value?.trim();
+	return normalized ? normalized : void 0;
+}
+function readRuntimeEnv(name) {
+	if (typeof process === "undefined" || !process.env) return;
+	switch (name) {
+		case "PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_PROJECT_ID);
+		case "NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID);
+		case "DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_PROJECT_ID);
+		case "PUBLIC_DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_ANALYTICS_KEY);
+		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY);
+		case "DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_ANALYTICS_KEY);
+		case "PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED);
+		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED);
+		case "DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_ANALYTICS_ENABLED);
+		case "PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeEnvValue(process.env.PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT);
+		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeEnvValue(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT);
+		case "DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeEnvValue(process.env.DOCS_CLOUD_ANALYTICS_ENDPOINT);
+		default: return;
+	}
+}
+function isFalsyEnv(value) {
+	if (!value) return false;
+	return /^(0|false|no|off)$/i.test(value);
+}
+function resolveDocsCloudAnalyticsOptions(analytics) {
+	if (analytics === false || analytics && typeof analytics === "object" && (analytics.enabled === false || analytics.cloud === false)) return null;
+	const projectId = readRuntimeEnv("PUBLIC_DOCS_CLOUD_PROJECT_ID") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID") ?? readRuntimeEnv("DOCS_CLOUD_PROJECT_ID");
+	const apiKey = readRuntimeEnv("PUBLIC_DOCS_CLOUD_ANALYTICS_KEY") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_KEY");
+	const enabled = readRuntimeEnv("PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_ENABLED");
+	const endpoint = readRuntimeEnv("PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? readRuntimeEnv("NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? readRuntimeEnv("DOCS_CLOUD_ANALYTICS_ENDPOINT") ?? DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT;
+	if (isFalsyEnv(enabled)) return null;
+	if (!projectId) return null;
+	return {
+		endpoint,
+		projectId,
+		apiKey
+	};
+}
+function asRecord(value) {
+	return value && typeof value === "object" && !Array.isArray(value) ? value : {};
+}
+function asString(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function normalizeAnalyticsLabel(value) {
+	return value?.trim().toLowerCase().replace(/[-\s]+/g, "_") ?? "";
+}
+function isProtocolAgentEvent(event) {
+	const type = normalizeAnalyticsLabel(event.type);
+	return normalizeAnalyticsLabel(event.source) === "mcp" || type.startsWith("mcp_");
+}
+function inferAgentProvider(event) {
+	const type = normalizeAnalyticsLabel(event.type);
+	if (normalizeAnalyticsLabel(event.source) === "mcp" || type.startsWith("mcp_")) return "MCP client";
+	if (type.startsWith("agent_") || type === "agents_request") return "Docs agent";
+	if ([
+		"llms_request",
+		"markdown_request",
+		"skill_request"
+	].includes(type)) return "Docs reader";
+}
+function detectAgentProviderFromUserAgent(userAgent) {
+	const value = userAgent?.toLowerCase() ?? "";
+	if (!value) return;
+	for (const [pattern, provider] of [
+		[/cursor/i, "Cursor"],
+		[/codex/i, "Codex"],
+		[/chatgpt-user|chatgpt/i, "ChatGPT"],
+		[/gptbot/i, "GPTBot"],
+		[/oai-searchbot|openai-search/i, "ChatGPT Search"],
+		[/openai/i, "ChatGPT"],
+		[/github-copilot|githubcopilot|copilot/i, "GitHub Copilot"],
+		[/claudebot|claude-user|anthropic/i, "Claude"],
+		[/perplexitybot|perplexity-user/i, "Perplexity"],
+		[/google-extended|googlebot|apis-google/i, "Google"],
+		[/bingbot|msnbot/i, "Bing"],
+		[/duckduckbot/i, "DuckDuckGo"],
+		[/applebot/i, "Apple"],
+		[/bytespider|bytedance/i, "ByteDance"],
+		[/ccbot|common crawl/i, "Common Crawl"],
+		[/ahrefsbot/i, "Ahrefs"],
+		[/semrushbot/i, "Semrush"]
+	]) if (pattern.test(value)) return provider;
+	if (/bot|crawler|spider|slurp|facebookexternalhit|ia_archiver/.test(value)) return "Other bot";
+}
+function withDocsCloudAnalyticsHints(event) {
+	const properties = asRecord(event.properties);
+	const detectedAgent = detectAgentProviderFromUserAgent(asString(properties.userAgent) ?? asString(properties.user_agent));
+	const protocolAgent = isProtocolAgentEvent(event);
+	const incomingTrafficType = asString(properties.trafficType)?.toLowerCase();
+	const explicitAgent = incomingTrafficType === "agent" || incomingTrafficType === "bot";
+	const agentProvider = asString(properties.agentName) ?? asString(properties.agent) ?? asString(properties.botProvider) ?? asString(properties.provider) ?? asString(properties.crawler) ?? asString(asRecord(properties.bot).provider) ?? detectedAgent ?? (protocolAgent || explicitAgent ? inferAgentProvider(event) : void 0);
+	if (!explicitAgent && !protocolAgent && !detectedAgent && !agentProvider) return event;
+	return {
+		...event,
+		properties: {
+			...properties,
+			trafficType: "agent",
+			...agentProvider && !asString(properties.agentName) ? { agentName: agentProvider } : {},
+			...agentProvider && !asString(properties.botProvider) ? { botProvider: agentProvider } : {}
+		}
+	};
+}
+async function sendDocsCloudAnalyticsEvent(options, event) {
+	const fetcher = options.fetch ?? (typeof fetch === "function" ? fetch : void 0);
+	if (!fetcher) return;
+	const endpoint = options.endpoint?.trim() || DEFAULT_DOCS_CLOUD_ANALYTICS_ENDPOINT;
+	const projectId = options.projectId?.trim();
+	if (!endpoint || !projectId) return;
+	try {
+		const normalizedEvent = withDocsCloudAnalyticsHints(event);
+		await fetcher(endpoint, {
+			method: "POST",
+			headers: {
+				"content-type": "application/json",
+				...options.apiKey ? { authorization: `Bearer ${options.apiKey}` } : {}
+			},
+			body: JSON.stringify({
+				projectId,
+				event: normalizedEvent
+			}),
+			keepalive: true
+		});
+	} catch {}
+}
+
+//#endregion
+export { sendDocsCloudAnalyticsEvent as n, resolveDocsCloudAnalyticsOptions as t };