@farming-labs/docs 0.2.119 → 0.2.121

package/dist/sidebar-CFHBj29f.mjs

@@ -1,421 +0,0 @@
-import { $ as isDocsSkillRequest, K as isDocsAgentDiscoveryRequest, St as resolveDocsSkillFormat, Xt as resolveDocsContentChangesConfig, Yt as isDocsContentChangesRequest, dt as resolveDocsAgentFeedbackRequest, ft as resolveDocsAgentsFormat, mt as resolveDocsLlmsTxtRequest, q as isDocsAgentsRequest, ut as resolveDocsAgentFeedbackConfig, vt as resolveDocsMarkdownRequest } from "./agent-DkAidqtV.mjs";
-
-//#region src/telemetry.ts
-const DOCS_PACKAGE_NAME = "@farming-labs/docs";
-const DOCS_PACKAGE_VERSION = "0.2.25";
-const DEFAULT_DOCS_TELEMETRY_ENDPOINT = "https://docs.farming-labs.dev/api/telemetry/events";
-const PROJECT_TELEMETRY_CACHE_TTL_MS = 1440 * 60 * 1e3;
-const PROJECT_TELEMETRY_CACHE_MAX_KEYS = 256;
-function getRuntimeEnv() {
-	if (typeof process === "undefined" || !process.env) return;
-	return process.env;
-}
-function readRuntimeEnv(name) {
-	const value = getRuntimeEnv()?.[name]?.trim();
-	return value ? value : void 0;
-}
-function isTruthyEnv(value) {
-	return /^(1|true|yes|on)$/i.test(value ?? "");
-}
-function isFalsyEnv(value) {
-	return /^(0|false|no|off)$/i.test(value ?? "");
-}
-function isBrowserRuntime() {
-	return typeof window !== "undefined" && typeof document !== "undefined";
-}
-function isProductionTelemetryRuntime() {
-	if (isBrowserRuntime()) return false;
-	const env = getRuntimeEnv();
-	if (!env) return true;
-	if (env.NODE_ENV === "test") return false;
-	if (env.VERCEL_ENV === "production") return true;
-	if (env.CONTEXT === "production" && isTruthyEnv(env.NETLIFY)) return true;
-	if (isTruthyEnv(env.CF_PAGES)) return true;
-	if (env.RENDER_SERVICE_ID || env.FLY_APP_NAME || env.RAILWAY_ENVIRONMENT) return true;
-	return env.NODE_ENV === "production";
-}
-function resolveDocsTelemetryConfig(telemetry) {
-	const envToggle = readRuntimeEnv("DOCS_TELEMETRY");
-	const envDisabled = readRuntimeEnv("DOCS_TELEMETRY_DISABLED");
-	if (isFalsyEnv(envToggle) || isTruthyEnv(envDisabled) || telemetry === false) return { enabled: false };
-	const objectConfig = telemetry && typeof telemetry === "object" ? telemetry : void 0;
-	if (objectConfig?.enabled === false) return { enabled: false };
-	return {
-		enabled: telemetry === true || objectConfig?.enabled === true || isTruthyEnv(envToggle) || isProductionTelemetryRuntime(),
-		endpoint: objectConfig?.endpoint?.trim() || readRuntimeEnv("DOCS_TELEMETRY_ENDPOINT") || DEFAULT_DOCS_TELEMETRY_ENDPOINT
-	};
-}
-function readRequestOrigin(request) {
-	if (!request?.url) return void 0;
-	try {
-		return new URL(request.url).origin;
-	} catch {
-		return;
-	}
-}
-/** Normalize an HTTP(S) telemetry site value to its origin. */
-function normalizeDocsTelemetryOrigin(candidate) {
-	if (typeof candidate !== "string") return void 0;
-	const trimmed = candidate.trim();
-	if (!trimmed) return void 0;
-	try {
-		const hasScheme = /^[a-z][a-z\d+.-]*:(?!\d)/i.test(trimmed);
-		const url = new URL(hasScheme ? trimmed : `https://${trimmed}`);
-		if (url.protocol !== "http:" && url.protocol !== "https:") return void 0;
-		return url.origin;
-	} catch {
-		return;
-	}
-}
-/** Return whether a telemetry origin points at a local development server. */
-function isLocalDocsTelemetryOrigin(candidate) {
-	const origin = normalizeDocsTelemetryOrigin(candidate);
-	if (!origin) return false;
-	const hostname = new URL(origin).hostname.toLowerCase().replace(/^\[|\]$/g, "").replace(/\.+$/, "");
-	if ([
-		"localhost",
-		"localhost.localdomain",
-		"localhost6",
-		"localhost6.localdomain6",
-		"ip6-localhost",
-		"ip6-loopback"
-	].includes(hostname) || hostname.endsWith(".localhost")) return true;
-	if (hostname === "::" || hostname === "::1") return true;
-	const ipv4 = hostname.split(".").map((part) => Number(part));
-	if (ipv4.length === 4 && ipv4.every((part) => Number.isInteger(part) && part >= 0 && part <= 255)) return ipv4[0] === 127 || ipv4.every((part) => part === 0);
-	return /^::ffff:7f[0-9a-f]{2}:/.test(hostname) || hostname === "::ffff:0:0";
-}
-function isBlockedDocsTelemetryOrigin(candidate) {
-	if (candidate === void 0) return false;
-	return !normalizeDocsTelemetryOrigin(candidate) || isLocalDocsTelemetryOrigin(candidate);
-}
-function readDeploymentOrigin() {
-	const candidates = [
-		readRuntimeEnv("DOCS_SITE_URL"),
-		readRuntimeEnv("NEXT_PUBLIC_BASE_URL"),
-		readRuntimeEnv("NEXT_PUBLIC_SITE_URL"),
-		readRuntimeEnv("SITE_URL"),
-		readRuntimeEnv("URL"),
-		readRuntimeEnv("CF_PAGES_URL"),
-		readRuntimeEnv("VERCEL_PROJECT_PRODUCTION_URL"),
-		readRuntimeEnv("VERCEL_URL"),
-		readRuntimeEnv("DEPLOY_PRIME_URL")
-	];
-	for (const candidate of candidates) {
-		const origin = normalizeDocsTelemetryOrigin(candidate);
-		if (origin) return origin;
-	}
-}
-function detectDeployment() {
-	const env = getRuntimeEnv();
-	if (!env) return void 0;
-	if (env.VERCEL || env.VERCEL_ENV) return {
-		provider: "vercel",
-		environment: env.VERCEL_ENV,
-		id: env.VERCEL_DEPLOYMENT_ID ?? env.VERCEL_GIT_COMMIT_SHA,
-		region: env.VERCEL_REGION
-	};
-	if (env.NETLIFY) return {
-		provider: "netlify",
-		environment: env.CONTEXT,
-		id: env.DEPLOY_ID ?? env.COMMIT_REF
-	};
-	if (env.CF_PAGES) return {
-		provider: "cloudflare-pages",
-		environment: env.CF_PAGES_BRANCH,
-		id: env.CF_PAGES_COMMIT_SHA
-	};
-	if (env.RENDER_SERVICE_ID) return {
-		provider: "render",
-		environment: env.RENDER_ENV,
-		id: env.RENDER_SERVICE_ID
-	};
-	if (env.FLY_APP_NAME) return {
-		provider: "fly",
-		environment: env.FLY_APP_NAME,
-		id: env.FLY_ALLOC_ID,
-		region: env.FLY_REGION
-	};
-	if (env.RAILWAY_ENVIRONMENT) return {
-		provider: "railway",
-		environment: env.RAILWAY_ENVIRONMENT,
-		id: env.RAILWAY_DEPLOYMENT_ID
-	};
-	return env.NODE_ENV === "production" ? { environment: "production" } : void 0;
-}
-function detectRuntime() {
-	if (typeof process !== "undefined" && process.versions?.node) return {
-		name: "node",
-		version: process.versions.node
-	};
-	if (typeof navigator !== "undefined" && navigator.userAgent) return { name: "web-standard" };
-}
-function isObjectConfigEnabled(value, defaultEnabled) {
-	if (value === false) return false;
-	if (value === true) return true;
-	if (value && typeof value === "object" && !Array.isArray(value)) {
-		const enabled = value.enabled;
-		return enabled === false ? false : defaultEnabled || enabled === true;
-	}
-	return defaultEnabled;
-}
-function hasObjectConfig(value) {
-	return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-function getDocsTelemetryFeatures(config) {
-	const pageActions = config.pageActions;
-	const feedback = config.feedback;
-	return {
-		search: isObjectConfigEnabled(config.search, true),
-		contentChanges: resolveDocsContentChangesConfig(config.agent?.contentChanges, { staticExport: config.staticExport === true }).enabled,
-		ai: isObjectConfigEnabled(config.ai, false),
-		mcp: isObjectConfigEnabled(config.mcp, true),
-		llmsTxt: isObjectConfigEnabled(config.llmsTxt, true),
-		pageActions: hasObjectConfig(pageActions),
-		feedback: feedback === true || hasObjectConfig(feedback) && feedback.enabled !== false,
-		agentFeedback: feedback !== false && !(hasObjectConfig(feedback) && feedback.agent === false) && !(hasObjectConfig(feedback) && hasObjectConfig(feedback.agent) && feedback.agent.enabled === false),
-		sitemap: isObjectConfigEnabled(config.sitemap, true),
-		robots: isObjectConfigEnabled(config.robots, true),
-		apiReference: isObjectConfigEnabled(config.apiReference, false),
-		staticExport: config.staticExport === true,
-		changelog: isObjectConfigEnabled(config.changelog, false),
-		cloud: typeof config.cloud !== "undefined" && isObjectConfigEnabled(config.cloud, true),
-		review: isObjectConfigEnabled(config.review, true),
-		codeBlocksValidate: hasObjectConfig(config.codeBlocks) && Boolean(config.codeBlocks.validate)
-	};
-}
-function createDocsTelemetryEvent(config, input, context = {}) {
-	const telemetryConfig = config.telemetry && typeof config.telemetry === "object" ? config.telemetry : void 0;
-	const siteOriginCandidates = [
-		context.siteOrigin,
-		input.site?.origin,
-		telemetryConfig?.siteOrigin,
-		readRequestOrigin(context.request),
-		readDeploymentOrigin()
-	];
-	if (siteOriginCandidates.some(isBlockedDocsTelemetryOrigin)) return void 0;
-	const siteOrigin = siteOriginCandidates.map(normalizeDocsTelemetryOrigin).find((origin) => Boolean(origin));
-	const deployment = input.deployment ?? detectDeployment();
-	const properties = context.properties || input.properties ? {
-		...input.properties,
-		...context.properties
-	} : void 0;
-	return {
-		...input,
-		timestamp: input.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
-		package: {
-			name: DOCS_PACKAGE_NAME,
-			version: DOCS_PACKAGE_VERSION,
-			...input.package
-		},
-		framework: input.framework ?? context.framework,
-		runtime: input.runtime ?? detectRuntime(),
-		site: siteOrigin ? { origin: siteOrigin } : input.site,
-		deployment,
-		features: input.features ?? getDocsTelemetryFeatures(config),
-		properties
-	};
-}
-function projectEventKey(event) {
-	return [
-		event.package.name,
-		event.package.version,
-		event.framework ?? "",
-		event.site?.origin ?? "",
-		event.deployment?.provider ?? "",
-		event.deployment?.environment ?? "",
-		event.deployment?.id ?? ""
-	].join("|");
-}
-function getSentProjectKeys() {
-	const globalValue = globalThis;
-	globalValue.__farmingLabsDocsTelemetryProjectKeys__ ??= /* @__PURE__ */ new Map();
-	return globalValue.__farmingLabsDocsTelemetryProjectKeys__;
-}
-function pruneSentProjectKeys(sent, now) {
-	for (const [key, expiresAt] of sent) if (expiresAt <= now) sent.delete(key);
-	while (sent.size >= PROJECT_TELEMETRY_CACHE_MAX_KEYS) {
-		const oldestKey = sent.keys().next().value;
-		if (!oldestKey) return;
-		sent.delete(oldestKey);
-	}
-}
-async function emitDocsTelemetryEvent(telemetry, event) {
-	const resolved = resolveDocsTelemetryConfig(telemetry);
-	const eventSiteOrigin = event.site?.origin;
-	const normalizedSiteOrigin = normalizeDocsTelemetryOrigin(eventSiteOrigin);
-	if (!resolved.enabled || !resolved.endpoint || typeof fetch !== "function" || eventSiteOrigin !== void 0 && (!normalizedSiteOrigin || isLocalDocsTelemetryOrigin(eventSiteOrigin))) return;
-	const eventToSend = normalizedSiteOrigin ? {
-		...event,
-		site: { origin: normalizedSiteOrigin }
-	} : event;
-	try {
-		const ingestKey = readRuntimeEnv("DOCS_TELEMETRY_INGEST_KEY");
-		const browserRequest = isBrowserRuntime() && !ingestKey;
-		const headers = { "content-type": browserRequest ? "text/plain;charset=UTF-8" : "application/json" };
-		if (ingestKey) headers["x-docs-telemetry-key"] = ingestKey;
-		await fetch(resolved.endpoint, {
-			method: "POST",
-			headers,
-			body: JSON.stringify({ event: eventToSend }),
-			keepalive: true,
-			...browserRequest ? {
-				credentials: "omit",
-				mode: "no-cors"
-			} : {}
-		});
-	} catch {}
-}
-function emitDocsTelemetryProjectEvent(config, context = {}) {
-	const event = createDocsTelemetryEvent(config, { type: "project_detected" }, context);
-	if (!event) return;
-	const key = projectEventKey(event);
-	const sent = getSentProjectKeys();
-	const now = Date.now();
-	const expiresAt = sent.get(key);
-	if (expiresAt && expiresAt > now) return;
-	if (typeof expiresAt === "number") sent.delete(key);
-	pruneSentProjectKeys(sent, now);
-	sent.set(key, now + PROJECT_TELEMETRY_CACHE_TTL_MS);
-	emitDocsTelemetryEvent(config.telemetry, event);
-}
-/**
-* Emit a privacy-preserving browser page view for the maintainer telemetry dashboard.
-*
-* Page views include only the public site origin, pathname, locale, framework, and package
-* metadata. They never include a query string, referrer, visitor id, IP address, or user agent.
-*/
-function emitDocsTelemetryPageViewEvent(telemetry, context = {}) {
-	if (telemetry === false || telemetry && typeof telemetry === "object" && telemetry.enabled === false) return;
-	const runtimeSiteOrigin = context.siteOrigin ?? (typeof window !== "undefined" ? window.location?.origin : void 0);
-	if (isBlockedDocsTelemetryOrigin(runtimeSiteOrigin)) return;
-	const siteOrigin = (telemetry && typeof telemetry === "object" ? telemetry.siteOrigin : void 0) ?? runtimeSiteOrigin;
-	const event = createDocsTelemetryEvent({ telemetry }, {
-		type: "page_view",
-		features: {},
-		properties: {
-			trafficType: "human",
-			...context.path ? { path: context.path.slice(0, 2048) } : {},
-			...context.locale ? { locale: context.locale.slice(0, 80) } : {}
-		}
-	}, {
-		framework: context.framework,
-		siteOrigin
-	});
-	if (!event) return;
-	emitDocsTelemetryEvent(telemetry && typeof telemetry === "object" ? {
-		...telemetry,
-		enabled: true
-	} : true, event);
-}
-function emitDocsTelemetryAgentSurfaceEvent(config, context) {
-	const event = createDocsTelemetryEvent(config, {
-		type: context.surface === "mcp" ? "mcp_request" : "agent_surface_used",
-		properties: { surface: context.surface }
-	}, context);
-	if (!event) return;
-	emitDocsTelemetryEvent(config.telemetry, event);
-}
-function emitDocsTelemetryMcpToolEvent(config, context) {
-	const event = createDocsTelemetryEvent(config, {
-		type: "mcp_tool_used",
-		properties: {
-			tool: context.tool,
-			locale: context.locale,
-			resultCount: context.resultCount
-		}
-	}, context);
-	if (!event) return;
-	emitDocsTelemetryEvent(config.telemetry, event);
-}
-function inferDocsTelemetryAgentSurface(request, options) {
-	const url = new URL(request.url);
-	const method = request.method.toUpperCase();
-	const feedbackRequest = resolveDocsAgentFeedbackRequest(url, resolveDocsAgentFeedbackConfig(options.feedback));
-	if ((method === "GET" || method === "HEAD") && isDocsAgentDiscoveryRequest(url)) return "agent_spec";
-	if ((method === "GET" || method === "HEAD") && feedbackRequest?.kind === "schema") return "agent_feedback_schema";
-	if (method === "POST" && feedbackRequest?.kind === "submit") return "agent_feedback_submit";
-	if (method === "GET" || method === "HEAD") {
-		if (isDocsContentChangesRequest(url)) return "content_changes";
-		if (isDocsAgentsRequest(url) || resolveDocsAgentsFormat(url) === "agents") return "agents";
-		if (isDocsSkillRequest(url) || resolveDocsSkillFormat(url) === "skill") return "skill";
-		if (resolveDocsMarkdownRequest(options.entry, url, request)) return "markdown";
-		if (resolveDocsLlmsTxtRequest(url, options.llmsTxt, options.entry)) return "llms";
-	}
-	if (method === "POST") return "ask_ai";
-}
-
-//#endregion
-//#region src/sidebar.ts
-function resolvePageSidebarFolderIndexBehavior(sidebar) {
-	if (!sidebar || typeof sidebar !== "object") return void 0;
-	const value = sidebar.folderIndexBehavior;
-	return value === "link" || value === "toggle" || value === "hidden" ? value : void 0;
-}
-function normalizeSidebarFolderBehaviorPath(path) {
-	if (!path) return void 0;
-	let value = path.trim();
-	if (!value) return void 0;
-	if (/^[a-zA-Z][a-zA-Z\d+\-.]*:\/\//.test(value)) try {
-		value = new URL(value).pathname;
-	} catch {
-		return;
-	}
-	else value = value.split("#", 1)[0]?.split("?", 1)[0] ?? value;
-	if (!value.startsWith("/")) value = `/${value}`;
-	return value.replace(/\/$/, "") || "/";
-}
-function resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior = "link") {
-	if (sidebar === void 0 || sidebar === true || sidebar === false) return defaultBehavior;
-	if (sidebar.folderIndexBehavior === "toggle") return "toggle";
-	if (sidebar.folderIndexBehavior === "hidden") return "hidden";
-	if (sidebar.folderIndexBehavior === "link") return "link";
-	return defaultBehavior;
-}
-function resolveSidebarFolderIndexBehaviorForPath(sidebar, folderPath, defaultBehavior = "link") {
-	const fallback = resolveSidebarFolderIndexBehavior(sidebar, defaultBehavior);
-	if (!sidebar || typeof sidebar !== "object") return fallback;
-	const normalizedPath = normalizeSidebarFolderBehaviorPath(folderPath);
-	if (!normalizedPath) return fallback;
-	for (const [rawPath, override] of Object.entries(sidebar.folderIndexBehaviorOverrides ?? {})) if (normalizeSidebarFolderBehaviorPath(rawPath) === normalizedPath) return override === "link" || override === "toggle" || override === "hidden" ? override : fallback;
-	return fallback;
-}
-function applySidebarFolderIndexBehavior(tree, behaviorOrOptions) {
-	const resolveBehavior = typeof behaviorOrOptions === "string" ? () => behaviorOrOptions : (folderPath) => resolveSidebarFolderIndexBehaviorForPath(behaviorOrOptions.sidebar, folderPath, behaviorOrOptions.defaultBehavior);
-	function mapNode(node) {
-		if (!node || typeof node !== "object") return node;
-		const candidate = node;
-		if (candidate.type !== "folder" || !Array.isArray(candidate.children)) return node;
-		const children = candidate.children.map(mapNode);
-		const index = candidate.index ? mapNode(candidate.index) : void 0;
-		const folderPath = (typeof candidate.url === "string" ? candidate.url : void 0) || (candidate.index && typeof candidate.index === "object" && "url" in candidate.index && typeof candidate.index.url === "string" ? candidate.index.url ?? void 0 : void 0);
-		const behavior = (candidate.folderIndexBehavior === "link" || candidate.folderIndexBehavior === "toggle" || candidate.folderIndexBehavior === "hidden" ? candidate.folderIndexBehavior : void 0) ?? resolveBehavior(folderPath);
-		if (behavior === "link") return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index,
-			children
-		};
-		if (behavior === "hidden") return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index: void 0,
-			url: void 0,
-			children
-		};
-		return {
-			...candidate,
-			folderIndexBehavior: void 0,
-			index: void 0,
-			url: void 0,
-			children: index ? [index, ...children] : children
-		};
-	}
-	return {
-		...tree,
-		children: tree.children.map(mapNode)
-	};
-}
-
-//#endregion
-export { emitDocsTelemetryAgentSurfaceEvent as a, emitDocsTelemetryPageViewEvent as c, inferDocsTelemetryAgentSurface as d, isLocalDocsTelemetryOrigin as f, resolveSidebarFolderIndexBehaviorForPath as i, emitDocsTelemetryProjectEvent as l, resolveDocsTelemetryConfig as m, resolvePageSidebarFolderIndexBehavior as n, emitDocsTelemetryEvent as o, normalizeDocsTelemetryOrigin as p, resolveSidebarFolderIndexBehavior as r, emitDocsTelemetryMcpToolEvent as s, applySidebarFolderIndexBehavior as t, getDocsTelemetryFeatures as u };