@farming-labs/docs 0.2.41 → 0.2.43

package/dist/{agent-WcXCJ4EN.mjs → agent-DXDOMJBw.mjs}

@@ -1,9 +1,9 @@
 import "./reading-time-CPAy1SWO.mjs";
-import "./search-BuOU4idW.mjs";
-import "./agent-B6szuz_8.mjs";
-import "./robots-CVoC0w0i.mjs";
-import "./sitemap-server-PLcNxmtk.mjs";
-import "./config-De5z-2LK.mjs";
-import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-DTlvGTH4.mjs";
+import "./agent-CaOBIVFy.mjs";
+import "./search-BWuU70B0.mjs";
+import "./robots-XVPs9lVz.mjs";
+import "./sitemap-server-xEHtDUDB.mjs";
+import "./config-tiQCZ46q.mjs";
+import { a as readPageTokenBudget, i as printAgentCompactHelp, n as inspectAgentCompactionState, o as scanDocsPageTargets, r as parseAgentCompactArgs, t as compactAgentDocs } from "./codeblocks-z9iT794h.mjs";
 
 export { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp };

package/dist/{agents-BjTEkCsY.mjs → agents-DjhjZaNP.mjs}

@@ -1,10 +1,10 @@
-import "./search-BuOU4idW.mjs";
-import { $ as renderDocsAgentsDocument, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, it as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-B6szuz_8.mjs";
-import { w as resolveApiReferenceConfig } from "./sitemap-server-PLcNxmtk.mjs";
+import { $ as renderDocsAgentsDocument, C as DEFAULT_OPENAPI_SCHEMA_ROUTE, a as DEFAULT_AGENT_MD_ROUTE, it as resolveDocsAgentFeedbackConfig, n as DEFAULT_AGENTS_MD_WELL_KNOWN_ROUTE, o as DEFAULT_AGENT_MD_WELL_KNOWN_ROUTE, t as DEFAULT_AGENTS_MD_ROUTE } from "./agent-CaOBIVFy.mjs";
+import "./search-BWuU70B0.mjs";
+import { S as resolveApiReferenceConfig } from "./sitemap-server-xEHtDUDB.mjs";
 import { resolveDocsMcpConfig } from "./mcp.mjs";
 import "./server.mjs";
-import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-De5z-2LK.mjs";
-import { t as detectFramework } from "./utils-CoHZJ1i4.mjs";
+import { c as readNavTitle, f as readTopLevelStringProperty, i as loadDocsConfigModule, o as readBooleanProperty, p as resolveDocsConfigPath, t as extractNestedObjectLiteral, u as readStringProperty } from "./config-tiQCZ46q.mjs";
+import { t as detectFramework } from "./utils-D-xTRNuh.mjs";
 import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
 import path from "node:path";
 import pc from "picocolors";

package/dist/analytics-BZEwTK-8.mjs

@@ -0,0 +1,177 @@
+import { n as sendDocsCloudAnalyticsEvent, t as resolveDocsCloudAnalyticsOptions } from "./cloud-analytics-Dlk_byos.mjs";
+
+//#region src/analytics.ts
+const ANALYTICS_LOG_PREFIX = "[@farming-labs/docs:analytics]";
+const OBSERVABILITY_LOG_PREFIX = "[@farming-labs/docs:observability]";
+const DOCS_AGENT_TRACE_EVENT_TYPES = [
+	"run.start",
+	"run.end",
+	"run.error",
+	"user.input",
+	"prompt.build",
+	"retrieval.query",
+	"retrieval.result",
+	"retrieval.error",
+	"model.call",
+	"model.response",
+	"model.stream",
+	"model.error",
+	"tool.call",
+	"tool.result",
+	"tool.error",
+	"retry",
+	"timeout",
+	"error",
+	"agent.final"
+];
+function composeAnalyticsHandlers(userOnEvent, cloudOnEvent) {
+	if (typeof userOnEvent !== "function" && !cloudOnEvent) return;
+	return async (event) => {
+		let userError;
+		if (typeof userOnEvent === "function") try {
+			await userOnEvent(event);
+		} catch (error) {
+			userError = error;
+		}
+		if (cloudOnEvent) try {
+			await cloudOnEvent(event);
+		} catch {}
+		if (typeof userError !== "undefined") throw userError;
+	};
+}
+function resolveConsoleLevel(value, hasEventHandler) {
+	if (value === false) return false;
+	if (value === true) return "info";
+	if (value === "log" || value === "info" || value === "debug") return value;
+	return hasEventHandler ? false : "info";
+}
+function createDocsAgentTraceId(prefix = "trace") {
+	return `${prefix.replace(/[^a-zA-Z0-9_-]/g, "_") || "trace"}_${Date.now().toString(36)}_${Math.random().toString(36).slice(2, 10)}`;
+}
+function createDocsAgentTraceContext(name = "agent.run") {
+	return {
+		traceId: createDocsAgentTraceId("run"),
+		name,
+		startedAt: (/* @__PURE__ */ new Date()).toISOString(),
+		startedMs: Date.now()
+	};
+}
+function getDocsRequestAnalyticsProperties(request) {
+	const userAgent = request.headers.get("user-agent")?.trim();
+	return userAgent ? { userAgent } : {};
+}
+function resolveDocsAnalyticsConfig(analytics) {
+	if (analytics === false) return {
+		enabled: false,
+		console: false,
+		includeInputs: false
+	};
+	const cloudOptions = resolveDocsCloudAnalyticsOptions(analytics);
+	const cloudOnEvent = cloudOptions ? async (event) => {
+		await sendDocsCloudAnalyticsEvent(cloudOptions, event);
+	} : void 0;
+	if (!analytics) {
+		if (!cloudOnEvent) return {
+			enabled: false,
+			console: false,
+			includeInputs: false
+		};
+		return {
+			enabled: true,
+			console: false,
+			includeInputs: false,
+			onEvent: cloudOnEvent
+		};
+	}
+	if (analytics === true) return {
+		enabled: true,
+		console: "info",
+		includeInputs: false,
+		onEvent: cloudOnEvent
+	};
+	const userOnEvent = analytics.onEvent;
+	const hasEventHandler = typeof userOnEvent === "function" || Boolean(cloudOnEvent);
+	const onEvent = composeAnalyticsHandlers(userOnEvent, cloudOnEvent);
+	return {
+		enabled: analytics.enabled !== false,
+		console: resolveConsoleLevel(analytics.console, hasEventHandler),
+		includeInputs: analytics.includeInputs === true,
+		onEvent
+	};
+}
+function resolveDocsObservabilityConfig(observability) {
+	if (!observability) return {
+		enabled: false,
+		console: false,
+		includeInputs: false
+	};
+	if (observability === true) return {
+		enabled: true,
+		console: "info",
+		includeInputs: false
+	};
+	const hasEventHandler = typeof observability.onEvent === "function";
+	return {
+		enabled: observability.enabled !== false,
+		console: resolveConsoleLevel(observability.console, hasEventHandler),
+		includeInputs: observability.includeInputs === true,
+		onEvent: observability.onEvent
+	};
+}
+function normalizeAnalyticsEvent(event, config) {
+	const normalized = {
+		...event,
+		source: event.source ?? "server",
+		timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+	};
+	if (!config.includeInputs && normalized.input) delete normalized.input;
+	return normalized;
+}
+function normalizeObservabilityEvent(event, config) {
+	const normalized = {
+		...event,
+		source: event.source ?? "server",
+		timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString()
+	};
+	if (!config.includeInputs && normalized.input) delete normalized.input;
+	return normalized;
+}
+async function emitDocsAnalyticsEvent(analytics, event) {
+	const resolved = resolveDocsAnalyticsConfig(analytics);
+	if (!resolved.enabled) return;
+	const normalized = normalizeAnalyticsEvent(event, resolved);
+	if (resolved.console) (console[resolved.console] ?? console.info).call(console, ANALYTICS_LOG_PREFIX, normalized);
+	if (!resolved.onEvent) return;
+	try {
+		await resolved.onEvent(normalized);
+	} catch (error) {
+		if (resolved.console !== false) console.warn(`${ANALYTICS_LOG_PREFIX} onEvent failed`, error);
+	}
+}
+async function emitDocsObservabilityEvent(observability, event) {
+	const resolved = resolveDocsObservabilityConfig(observability);
+	if (!resolved.enabled) return;
+	const normalized = normalizeObservabilityEvent(event, resolved);
+	if (resolved.console) (console[resolved.console] ?? console.info).call(console, OBSERVABILITY_LOG_PREFIX, normalized);
+	if (!resolved.onEvent) return;
+	try {
+		await resolved.onEvent(normalized);
+	} catch (error) {
+		if (resolved.console !== false) console.warn(`${OBSERVABILITY_LOG_PREFIX} onEvent failed`, error);
+	}
+}
+async function emitDocsAgentTraceEvent(observability, event) {
+	const timestamp = event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString();
+	await emitDocsObservabilityEvent(observability, {
+		...event,
+		timestamp,
+		source: event.source ?? "server",
+		traceId: event.traceId ?? createDocsAgentTraceId("run"),
+		spanId: event.spanId ?? createDocsAgentTraceId("span"),
+		startedAt: event.startedAt ?? timestamp,
+		status: event.status ?? "success"
+	});
+}
+
+//#endregion
+export { emitDocsAnalyticsEvent as a, resolveDocsAnalyticsConfig as c, emitDocsAgentTraceEvent as i, resolveDocsObservabilityConfig as l, createDocsAgentTraceContext as n, emitDocsObservabilityEvent as o, createDocsAgentTraceId as r, getDocsRequestAnalyticsProperties as s, DOCS_AGENT_TRACE_EVENT_TYPES as t };

package/dist/cli/index.mjs

@@ -1,5 +1,5 @@
 #!/usr/bin/env node
-import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-Dw5gMhEZ.mjs";
+import { i as wasCliErrorReported, r as shouldPrintStackTrace, t as formatCliError } from "../errors-CW1LnxaQ.mjs";
 import pc from "picocolors";
 
 //#region src/cli/index.ts
@@ -105,43 +105,43 @@ async function main() {
 		]
 	};
 	if (!parsedCommand.command || parsedCommand.command === "init") {
-		const { init } = await import("../init-DkcasCws.mjs");
+		const { init } = await import("../init-Ds7QM9po.mjs");
 		await init(initOptions);
 	} else if (parsedCommand.command === "dev") {
-		const { dev } = await import("../dev-DxVevOP_.mjs");
+		const { dev } = await import("../dev-CBha7knT.mjs");
 		await dev(devOptions);
 	} else if (parsedCommand.command === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-wcDf1YC0.mjs");
+		const { runCloudDeploy } = await import("../cloud-Bk-eppay.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "preview") {
-		const { runCloudPreview } = await import("../cloud-wcDf1YC0.mjs");
+		const { runCloudPreview } = await import("../cloud-Bk-eppay.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "deploy") {
-		const { runCloudDeploy } = await import("../cloud-wcDf1YC0.mjs");
+		const { runCloudDeploy } = await import("../cloud-Bk-eppay.mjs");
 		await runCloudDeploy(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "preview") {
-		const { runCloudPreview } = await import("../cloud-wcDf1YC0.mjs");
+		const { runCloudPreview } = await import("../cloud-Bk-eppay.mjs");
 		await runCloudPreview(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "init") {
-		const { runCloudInit } = await import("../cloud-wcDf1YC0.mjs");
+		const { runCloudInit } = await import("../cloud-Bk-eppay.mjs");
 		await runCloudInit(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "sync") {
-		const { syncCloudConfig } = await import("../cloud-wcDf1YC0.mjs");
+		const { syncCloudConfig } = await import("../cloud-Bk-eppay.mjs");
 		await syncCloudConfig(cloudOptions);
 	} else if (parsedCommand.command === "cloud" && subcommand === "check") {
-		const { runCloudCheck } = await import("../cloud-wcDf1YC0.mjs");
+		const { runCloudCheck } = await import("../cloud-Bk-eppay.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-wcDf1YC0.mjs");
+		const { printCloudHelp } = await import("../cloud-Bk-eppay.mjs");
 		printCloudHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "mcp") {
-		const { runMcp } = await import("../mcp-DfJiBC0f.mjs");
+		const { runMcp } = await import("../mcp-DuCPNHS-.mjs");
 		await runMcp(mcpOptions);
 	} else if (parsedCommand.command === "agent" && subcommand === "compact") {
-		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-WcXCJ4EN.mjs");
+		const { compactAgentDocs, parseAgentCompactArgs, printAgentCompactHelp } = await import("../agent-DXDOMJBw.mjs");
 		const agentCompactOptions = parseAgentCompactArgs(args.slice(2));
 		if (agentCompactOptions.help) {
 			printAgentCompactHelp();
@@ -151,11 +151,11 @@ async function main() {
 	} else if (parsedCommand.command === "agent") {
 		console.error(pc.red(`Unknown agent subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentCompactHelp } = await import("../agent-WcXCJ4EN.mjs");
+		const { printAgentCompactHelp } = await import("../agent-DXDOMJBw.mjs");
 		printAgentCompactHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "agents" && subcommand === "generate") {
-		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-BjTEkCsY.mjs");
+		const { generateAgents, parseAgentsGenerateArgs, printAgentsGenerateHelp } = await import("../agents-DjhjZaNP.mjs");
 		const agentsOptions = parseAgentsGenerateArgs(args.slice(2));
 		if (agentsOptions.help) {
 			printAgentsGenerateHelp();
@@ -165,11 +165,11 @@ async function main() {
 	} else if (parsedCommand.command === "agents") {
 		console.error(pc.red(`Unknown agents subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printAgentsGenerateHelp } = await import("../agents-BjTEkCsY.mjs");
+		const { printAgentsGenerateHelp } = await import("../agents-DjhjZaNP.mjs");
 		printAgentsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "doctor") {
-		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-VwhpJct8.mjs");
+		const { parseDoctorArgs, printDoctorHelp, runDoctor } = await import("../doctor-O9o9kjN8.mjs");
 		const doctorOptions = parseDoctorArgs(args.slice(1));
 		if (doctorOptions.help) {
 			printDoctorHelp();
@@ -177,7 +177,7 @@ async function main() {
 		}
 		await runDoctor(doctorOptions);
 	} else if (parsedCommand.command === "review") {
-		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-Bnd4NH9y.mjs");
+		const { parseReviewArgs, printReviewHelp, runReview } = await import("../review-lm3dt7yy.mjs");
 		const reviewOptions = parseReviewArgs(args.slice(1));
 		if (reviewOptions.help) {
 			printReviewHelp();
@@ -185,7 +185,7 @@ async function main() {
 		}
 		await runReview(reviewOptions);
 	} else if ((parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") && subcommand === "validate") {
-		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-DTlvGTH4.mjs");
+		const { parseCodeBlocksValidateArgs, printCodeBlocksValidateHelp, runCodeBlocksValidate } = await import("../codeblocks-z9iT794h.mjs");
 		const codeBlocksOptions = parseCodeBlocksValidateArgs(args.slice(2));
 		if (codeBlocksOptions.help) {
 			printCodeBlocksValidateHelp();
@@ -195,11 +195,11 @@ async function main() {
 	} else if (parsedCommand.command === "codeblocks" || parsedCommand.command === "code-blocks") {
 		console.error(pc.red(`Unknown codeblocks subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printCodeBlocksValidateHelp } = await import("../codeblocks-DTlvGTH4.mjs");
+		const { printCodeBlocksValidateHelp } = await import("../codeblocks-z9iT794h.mjs");
 		printCodeBlocksValidateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "search" && subcommand === "sync") {
-		const { syncSearch } = await import("../search-CA3H4Dfv.mjs");
+		const { syncSearch } = await import("../search-B6nEkx86.mjs");
 		await syncSearch(searchSyncOptions);
 	} else if (parsedCommand.command === "search") {
 		console.error(pc.red(`Unknown search subcommand: ${subcommand ?? "(missing)"}`));
@@ -207,7 +207,7 @@ async function main() {
 		printHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "sitemap" && subcommand === "generate") {
-		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-CUtSSoGG.mjs");
+		const { generateSitemap, parseSitemapGenerateArgs, printSitemapGenerateHelp } = await import("../sitemap-BEiKy4Iy.mjs");
 		const sitemapOptions = parseSitemapGenerateArgs(args.slice(2));
 		if (sitemapOptions.help) {
 			printSitemapGenerateHelp();
@@ -217,11 +217,11 @@ async function main() {
 	} else if (parsedCommand.command === "sitemap") {
 		console.error(pc.red(`Unknown sitemap subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printSitemapGenerateHelp } = await import("../sitemap-CUtSSoGG.mjs");
+		const { printSitemapGenerateHelp } = await import("../sitemap-BEiKy4Iy.mjs");
 		printSitemapGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "robots" && subcommand === "generate") {
-		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-BrBGgn1w.mjs");
+		const { generateRobots, parseRobotsGenerateArgs, printRobotsGenerateHelp } = await import("../robots-DV7u4Ire.mjs");
 		const robotsOptions = parseRobotsGenerateArgs(args.slice(2));
 		if (robotsOptions.help) {
 			printRobotsGenerateHelp();
@@ -231,11 +231,11 @@ async function main() {
 	} else if (parsedCommand.command === "robots") {
 		console.error(pc.red(`Unknown robots subcommand: ${subcommand ?? "(missing)"}`));
 		console.error();
-		const { printRobotsGenerateHelp } = await import("../robots-BrBGgn1w.mjs");
+		const { printRobotsGenerateHelp } = await import("../robots-DV7u4Ire.mjs");
 		printRobotsGenerateHelp();
 		process.exit(1);
 	} else if (parsedCommand.command === "downgrade") {
-		const { downgrade } = await import("../downgrade-ghVFFHKi.mjs");
+		const { downgrade } = await import("../downgrade-7PGER59g.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		await downgrade({
@@ -244,7 +244,7 @@ async function main() {
 			dryRun: flags["dry-run"] === true
 		});
 	} else if (parsedCommand.command === "upgrade") {
-		const { upgrade } = await import("../upgrade-aexO-zom.mjs");
+		const { upgrade } = await import("../upgrade-CkdKWRlk.mjs");
 		const framework = (typeof flags.framework === "string" ? flags.framework : void 0) ?? (args[1] && !args[1].startsWith("--") ? args[1] : void 0);
 		const hasVersionFlag = args.includes("--version") || args.some((arg) => arg.startsWith("--version="));
 		const version = typeof flags.version === "string" ? flags.version : hasVersionFlag ? "" : void 0;

package/dist/client/react.d.mts

@@ -0,0 +1,45 @@
+import { v as DocsAnalyticsConfig } from "../types-XqGLsmOD.mjs";
+import { ReactNode } from "react";
+
+//#region src/docs-cloud-client.d.ts
+type DocsCloudClientRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);
+type DocsCloudClientRuntimeEnv = Record<string, string | undefined> | (() => Record<string, string | undefined>);
+interface DocsCloudClientOptions {
+  projectId?: DocsCloudClientRuntimeValue;
+  endpoint?: DocsCloudClientRuntimeValue;
+  analyticsEndpoint?: DocsCloudClientRuntimeValue;
+  apiBaseUrl?: DocsCloudClientRuntimeValue;
+  analyticsKey?: DocsCloudClientRuntimeValue;
+  enabled?: DocsCloudClientRuntimeValue<boolean | string>;
+  includeInputs?: DocsCloudClientRuntimeValue<boolean>;
+  env?: DocsCloudClientRuntimeEnv;
+  fetch?: typeof fetch;
+  metadata?: Record<string, unknown>;
+  properties?: Record<string, unknown>;
+}
+//#endregion
+//#region src/client/react.d.ts
+interface DocsCloudAnalyticsProps extends DocsCloudClientOptions {
+  analytics?: boolean | DocsAnalyticsConfig;
+  children?: ReactNode;
+}
+type DocsCloudAnalyticsOptions = Omit<DocsCloudAnalyticsProps, "children">;
+type DocsCloudAnalyticsProjectId = DocsCloudClientRuntimeValue;
+declare function DocsCloudAnalytics({
+  analytics,
+  children,
+  projectId,
+  endpoint,
+  analyticsEndpoint,
+  apiBaseUrl,
+  analyticsKey,
+  enabled,
+  includeInputs,
+  env,
+  fetch,
+  metadata,
+  properties
+}: DocsCloudAnalyticsProps): ReactNode;
+declare const DocsCloudAnalyticsProvider: typeof DocsCloudAnalytics;
+//#endregion
+export { DocsCloudAnalytics, DocsCloudAnalyticsOptions, DocsCloudAnalyticsProjectId, DocsCloudAnalyticsProps, DocsCloudAnalyticsProvider };

package/dist/client/react.mjs

@@ -0,0 +1,223 @@
+"use client";
+
+import { n as sendDocsCloudAnalyticsEvent } from "../cloud-analytics-Dlk_byos.mjs";
+import { useEffect } from "react";
+
+//#region src/docs-cloud-client.ts
+const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";
+const DOCS_CLOUD_PROJECT_ID_ENVS = [
+	"NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID",
+	"PUBLIC_DOCS_CLOUD_PROJECT_ID",
+	"DOCS_CLOUD_PROJECT_ID"
+];
+const DOCS_CLOUD_API_BASE_URL_ENVS = [
+	"NEXT_PUBLIC_DOCS_CLOUD_URL",
+	"PUBLIC_DOCS_CLOUD_URL",
+	"DOCS_CLOUD_API_BASE_URL",
+	"DOCS_CLOUD_API_URL"
+];
+const DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS = [
+	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT",
+	"PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT",
+	"DOCS_CLOUD_ANALYTICS_ENDPOINT"
+];
+const DOCS_CLOUD_ANALYTICS_ENABLED_ENVS = [
+	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED",
+	"PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED",
+	"DOCS_CLOUD_ANALYTICS_ENABLED"
+];
+const DOCS_CLOUD_ANALYTICS_KEY_ENVS = [
+	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY",
+	"PUBLIC_DOCS_CLOUD_ANALYTICS_KEY",
+	"DOCS_CLOUD_ANALYTICS_KEY"
+];
+function normalizeRuntimeString(value) {
+	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
+}
+function resolveRuntimeValue(value) {
+	return (typeof value === "function" ? value() : value) ?? void 0;
+}
+function resolveRuntimeString(value) {
+	return normalizeRuntimeString(resolveRuntimeValue(value));
+}
+function resolveRuntimeEnv(env) {
+	return typeof env === "function" ? env() : env ?? {};
+}
+function readProcessEnv(name) {
+	if (typeof process === "undefined") return void 0;
+	if (!process.env) return void 0;
+	switch (name) {
+		case "NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID);
+		case "NEXT_PUBLIC_DOCS_CLOUD_URL": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_URL);
+		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT);
+		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENABLED);
+		case "NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY": return normalizeRuntimeString(process.env.NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY);
+		default: return;
+	}
+}
+function readEnv(name, env) {
+	return normalizeRuntimeString(env[name]) ?? readProcessEnv(name);
+}
+function readFirstEnv(names, env) {
+	for (const name of names) {
+		const value = readEnv(name, env);
+		if (value) return value;
+	}
+}
+function isFalsy(value) {
+	if (value === false) return true;
+	if (typeof value !== "string") return false;
+	return /^(0|false|no|off)$/i.test(value.trim());
+}
+function stripTrailingSlash(value) {
+	return value.replace(/\/+$/, "");
+}
+function mergeRecords(...records) {
+	const merged = {};
+	for (const record of records) {
+		if (!record) continue;
+		Object.assign(merged, record);
+	}
+	return Object.keys(merged).length > 0 ? merged : void 0;
+}
+function getBrowserLocation() {
+	return typeof window !== "undefined" ? window.location : void 0;
+}
+function getBrowserReferrer() {
+	if (typeof document === "undefined") return void 0;
+	return document.referrer || void 0;
+}
+function createDocsCloudClient(options = {}) {
+	function env() {
+		return resolveRuntimeEnv(options.env);
+	}
+	function projectId() {
+		const runtimeEnv = env();
+		return resolveRuntimeString(options.projectId) ?? readFirstEnv(DOCS_CLOUD_PROJECT_ID_ENVS, runtimeEnv);
+	}
+	function apiBaseUrl() {
+		const runtimeEnv = env();
+		return stripTrailingSlash(resolveRuntimeString(options.apiBaseUrl) ?? readFirstEnv(DOCS_CLOUD_API_BASE_URL_ENVS, runtimeEnv) ?? DEFAULT_DOCS_CLOUD_API_BASE_URL);
+	}
+	function endpoint() {
+		const runtimeEnv = env();
+		return resolveRuntimeString(options.endpoint) ?? resolveRuntimeString(options.analyticsEndpoint) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS, runtimeEnv) ?? `${apiBaseUrl()}/v1/analytics/events`;
+	}
+	function analyticsKey() {
+		const runtimeEnv = env();
+		return resolveRuntimeString(options.analyticsKey) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_KEY_ENVS, runtimeEnv);
+	}
+	function enabled() {
+		const runtimeEnv = env();
+		return !isFalsy(resolveRuntimeValue(options.enabled) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_ENABLED_ENVS, runtimeEnv));
+	}
+	function includeInputs() {
+		return resolveRuntimeValue(options.includeInputs) === true;
+	}
+	function getConfig() {
+		const id = projectId();
+		return {
+			enabled: enabled(),
+			configured: Boolean(id),
+			...id ? { projectId: id } : {},
+			endpoint: endpoint()
+		};
+	}
+	async function trackEvent(event, trackOptions = {}) {
+		const config = getConfig();
+		if (!config.enabled || !config.projectId) return false;
+		const location = getBrowserLocation();
+		const normalized = {
+			...event,
+			source: event.source ?? "client",
+			timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
+			url: event.url ?? location?.href,
+			path: event.path ?? location?.pathname,
+			referrer: event.referrer ?? getBrowserReferrer(),
+			locale: event.locale ?? trackOptions.locale,
+			metadata: mergeRecords(options.metadata, trackOptions.metadata, event.metadata),
+			properties: mergeRecords(options.properties, trackOptions.properties, event.properties)
+		};
+		if (!includeInputs()) delete normalized.input;
+		await sendDocsCloudAnalyticsEvent({
+			endpoint: config.endpoint,
+			projectId: config.projectId,
+			apiKey: analyticsKey(),
+			fetch: options.fetch
+		}, normalized);
+		return true;
+	}
+	return {
+		analytics: { track: trackEvent },
+		trackEvent,
+		getConfig,
+		isConfigured() {
+			const config = getConfig();
+			return config.enabled && config.configured;
+		}
+	};
+}
+
+//#endregion
+//#region src/client/react.ts
+function isDocsCloudAnalyticsDisabled(analytics, enabled) {
+	return Boolean(enabled === false || analytics === false || analytics && typeof analytics === "object" && (analytics.enabled === false || analytics.cloud === false));
+}
+function callAnalyticsHandler(handler, event) {
+	if (!handler) return;
+	try {
+		Promise.resolve(handler(event)).catch(() => {});
+	} catch {}
+}
+function DocsCloudAnalytics({ analytics, children, projectId, endpoint, analyticsEndpoint, apiBaseUrl, analyticsKey, enabled, includeInputs, env, fetch, metadata, properties }) {
+	useEffect(() => {
+		if (typeof window === "undefined") return;
+		if (isDocsCloudAnalyticsDisabled(analytics, enabled)) return;
+		const client = createDocsCloudClient({
+			projectId,
+			endpoint,
+			analyticsEndpoint,
+			apiBaseUrl,
+			analyticsKey,
+			enabled,
+			includeInputs: includeInputs ?? (typeof analytics === "object" && analytics.includeInputs === true),
+			env,
+			fetch,
+			metadata,
+			properties
+		});
+		if (!client.isConfigured()) return;
+		const target = window;
+		const previous = target.__fdAnalytics__;
+		const handler = (event) => {
+			callAnalyticsHandler(previous, event);
+			client.trackEvent(event).catch(() => {});
+		};
+		target.__fdAnalytics__ = handler;
+		const queued = target.__fdAnalyticsQueue__ ?? [];
+		delete target.__fdAnalyticsQueue__;
+		for (const event of queued) handler(event);
+		return () => {
+			if (target.__fdAnalytics__ === handler) if (typeof previous === "function") target.__fdAnalytics__ = previous;
+			else delete target.__fdAnalytics__;
+		};
+	}, [
+		analytics,
+		analyticsEndpoint,
+		analyticsKey,
+		apiBaseUrl,
+		enabled,
+		endpoint,
+		env,
+		fetch,
+		includeInputs,
+		metadata,
+		projectId,
+		properties
+	]);
+	return children ?? null;
+}
+const DocsCloudAnalyticsProvider = DocsCloudAnalytics;
+
+//#endregion
+export { DocsCloudAnalytics, DocsCloudAnalyticsProvider };