@farming-labs/docs 0.2.62 → 0.2.64

package/dist/client/react.mjs

@@ -0,0 +1,223 @@
+"use client";
+
+import { n as sendDocsCloudAnalyticsEvent } from "../cloud-analytics-CSyFE6SS.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 };

package/dist/cloud-analytics-CSyFE6SS.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 };