@farming-labs/docs 0.2.60 → 0.2.62

package/dist/docs-cloud-server.d.mts

@@ -1,70 +0,0 @@
-import { F as DocsAnalyticsConfig, I as DocsAnalyticsEvent, L as DocsAnalyticsEventInput } from "./types-XHABMh_f.mjs";
-import { n as DocsCloudAskAIResponseOptions, t as DocsCloudAskAIConfig } from "./cloud-ask-ai-B2WnG4fF.mjs";
-
-//#region src/docs-cloud-server.d.ts
-type DocsCloudRuntimeValue<T = string> = T | undefined | null | (() => T | undefined | null);
-type DocsCloudRuntimeEnv = Record<string, string | undefined> | (() => Record<string, string | undefined>);
-interface DocsCloudServerOptions {
-  projectId?: DocsCloudRuntimeValue;
-  apiKey?: DocsCloudRuntimeValue;
-  apiKeyEnv?: DocsCloudRuntimeValue;
-  analyticsKey?: DocsCloudRuntimeValue;
-  apiBaseUrl?: DocsCloudRuntimeValue;
-  analyticsEndpoint?: DocsCloudRuntimeValue;
-  publicBaseUrl?: DocsCloudRuntimeValue;
-  env?: DocsCloudRuntimeEnv;
-  fetch?: typeof fetch;
-  config?: DocsCloudAskAIConfig;
-  analytics?: boolean | DocsAnalyticsConfig;
-  metadata?: Record<string, unknown>;
-}
-interface DocsCloudTrackEventOptions {
-  request?: Request;
-  locale?: string;
-  source?: DocsAnalyticsEvent["source"];
-  input?: DocsAnalyticsEventInput["input"];
-  metadata?: Record<string, unknown>;
-  properties?: Record<string, unknown>;
-}
-interface DocsCloudAskAIOptions extends Omit<DocsCloudAskAIResponseOptions, "config" | "env" | "fetch" | "publicBaseUrl"> {
-  config?: DocsCloudAskAIConfig;
-  env?: Record<string, string | undefined>;
-  fetch?: typeof fetch;
-  publicBaseUrl?: string;
-}
-interface DocsCloudRouteHandlerOptions {
-  locale?: string | ((request: Request) => string | undefined | Promise<string | undefined>);
-  publicBaseUrl?: string | ((request: Request) => string | undefined | Promise<string | undefined>);
-}
-interface DocsCloudPublicConfig {
-  ok: true;
-  configured: {
-    projectId: boolean;
-    apiKey: boolean;
-  };
-  projectId?: string;
-  apiBaseUrl: string;
-  features: {
-    analytics: boolean;
-    askAI: boolean;
-  };
-  metadata?: Record<string, unknown>;
-}
-interface DocsCloudAnalyticsServer {
-  track(event: DocsAnalyticsEventInput, options?: DocsCloudTrackEventOptions): Promise<boolean>;
-}
-interface DocsCloudServer {
-  analytics: DocsCloudAnalyticsServer;
-  trackEvent(event: DocsAnalyticsEventInput, options?: DocsCloudTrackEventOptions): Promise<boolean>;
-  askAI(request: Request, options?: DocsCloudAskAIOptions): Promise<Response>;
-  handleRequest(request: Request, options?: DocsCloudRouteHandlerOptions): Promise<Response>;
-  getPublicConfig(): DocsCloudPublicConfig;
-}
-interface DocsCloudRouteHandlers {
-  GET(request: Request): Promise<Response>;
-  POST(request: Request): Promise<Response>;
-}
-declare function createDocsCloudServer(options?: DocsCloudServerOptions): DocsCloudServer;
-declare function createDocsCloudRouteHandler(docsCloud: DocsCloudServer, options?: DocsCloudRouteHandlerOptions): DocsCloudRouteHandlers;
-//#endregion
-export { DocsCloudAnalyticsServer, DocsCloudAskAIOptions, DocsCloudPublicConfig, DocsCloudRouteHandlerOptions, DocsCloudRouteHandlers, DocsCloudRuntimeEnv, DocsCloudRuntimeValue, DocsCloudServer, DocsCloudServerOptions, DocsCloudTrackEventOptions, createDocsCloudRouteHandler, createDocsCloudServer };

package/dist/docs-cloud-server.mjs

@@ -1,310 +0,0 @@
-import { n as sendDocsCloudAnalyticsEvent } from "./cloud-analytics-CSyFE6SS.mjs";
-import { t as createDocsCloudAskAIResponse } from "./cloud-ask-ai-hnJfj8-X.mjs";
-
-//#region src/docs-cloud-server.ts
-const DEFAULT_DOCS_CLOUD_API_BASE_URL = "https://api.farming-labs.dev";
-const DEFAULT_DOCS_CLOUD_API_KEY_ENV = "DOCS_CLOUD_API_KEY";
-const DOCS_CLOUD_PROJECT_ID_ENVS = [
-	"DOCS_CLOUD_PROJECT_ID",
-	"PUBLIC_DOCS_CLOUD_PROJECT_ID",
-	"NEXT_PUBLIC_DOCS_CLOUD_PROJECT_ID"
-];
-const DOCS_CLOUD_API_BASE_URL_ENVS = [
-	"DOCS_CLOUD_API_BASE_URL",
-	"DOCS_CLOUD_API_URL",
-	"PUBLIC_DOCS_CLOUD_URL",
-	"NEXT_PUBLIC_DOCS_CLOUD_URL"
-];
-const DOCS_CLOUD_ANALYTICS_KEY_ENVS = [
-	"DOCS_CLOUD_ANALYTICS_KEY",
-	"PUBLIC_DOCS_CLOUD_ANALYTICS_KEY",
-	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_KEY"
-];
-const DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS = [
-	"DOCS_CLOUD_ANALYTICS_ENDPOINT",
-	"PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT",
-	"NEXT_PUBLIC_DOCS_CLOUD_ANALYTICS_ENDPOINT"
-];
-function isPlainObject(value) {
-	return typeof value === "object" && value !== null && !Array.isArray(value);
-}
-function asString(value) {
-	return typeof value === "string" && value.trim().length > 0 ? value.trim() : void 0;
-}
-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 readProcessEnv(name) {
-	if (typeof process === "undefined") return void 0;
-	return normalizeRuntimeString(process.env?.[name]);
-}
-function resolveRuntimeEnv(env) {
-	return typeof env === "function" ? env() : env ?? {};
-}
-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 stripTrailingSlash(value) {
-	return value.replace(/\/+$/, "");
-}
-function jsonResponse(data, init) {
-	const headers = new Headers(init?.headers);
-	headers.set("Cache-Control", "no-store");
-	headers.set("Content-Type", "application/json");
-	return Response.json(data, {
-		...init,
-		headers
-	});
-}
-function requestProperties(request) {
-	const userAgent = request?.headers.get("user-agent")?.trim();
-	return userAgent ? { userAgent } : {};
-}
-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 omitAction(record) {
-	const { action: _action, ...rest } = record;
-	return rest;
-}
-function isAskAIBody(body) {
-	if (!isPlainObject(body)) return false;
-	return Array.isArray(body.messages) || typeof body.question === "string";
-}
-function resolveRouteAction(request, body) {
-	const queryAction = asString(new URL(request.url).searchParams.get("action"));
-	const bodyAction = isPlainObject(body) ? asString(body.action) : void 0;
-	const action = (queryAction ?? bodyAction)?.toLowerCase().replace(/_/g, "-");
-	if (action === "ask-ai" || action === "ai" || action === "chat") return "ask-ai";
-	if (isAskAIBody(body)) return "ask-ai";
-	return "analytics";
-}
-function resolveAnalyticsEvent(body) {
-	if (!isPlainObject(body)) return void 0;
-	const eventCandidate = isPlainObject(body.event) ? body.event : isPlainObject(body.payload) ? body.payload : body;
-	const eventRecord = eventCandidate === body && typeof body.action === "string" ? omitAction(body) : eventCandidate;
-	return typeof eventRecord.type === "string" ? eventRecord : void 0;
-}
-function askAIPayload(body) {
-	if (!isPlainObject(body)) return body;
-	return isPlainObject(body.payload) ? body.payload : omitAction(body);
-}
-function createJsonRequest(request, body) {
-	const headers = new Headers(request.headers);
-	headers.set("Content-Type", "application/json");
-	return new Request(request.url, {
-		method: request.method,
-		headers,
-		body: JSON.stringify(body),
-		signal: request.signal
-	});
-}
-async function readJson(request) {
-	try {
-		return await request.clone().json();
-	} catch {
-		return;
-	}
-}
-async function resolveRouteValue(value, request) {
-	if (typeof value === "function") return normalizeRuntimeString(await value(request));
-	return normalizeRuntimeString(value);
-}
-function createDocsCloudServer(options = {}) {
-	function env() {
-		return resolveRuntimeEnv(options.env);
-	}
-	function apiKeyEnv() {
-		return resolveRuntimeString(options.apiKeyEnv) ?? options.config?.cloud?.apiKey?.env?.trim() ?? DEFAULT_DOCS_CLOUD_API_KEY_ENV;
-	}
-	function projectId() {
-		const runtimeEnv = env();
-		return resolveRuntimeString(options.projectId) ?? readFirstEnv(DOCS_CLOUD_PROJECT_ID_ENVS, runtimeEnv);
-	}
-	function apiKey() {
-		const runtimeEnv = env();
-		const keyEnv = apiKeyEnv();
-		return resolveRuntimeString(options.apiKey) ?? readEnv(keyEnv, runtimeEnv);
-	}
-	function analyticsKey() {
-		const runtimeEnv = env();
-		return resolveRuntimeString(options.analyticsKey) ?? apiKey() ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_KEY_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 analyticsEndpoint() {
-		const runtimeEnv = env();
-		return resolveRuntimeString(options.analyticsEndpoint) ?? readFirstEnv(DOCS_CLOUD_ANALYTICS_ENDPOINT_ENVS, runtimeEnv) ?? `${apiBaseUrl()}/v1/analytics/events`;
-	}
-	function publicBaseUrl() {
-		return resolveRuntimeString(options.publicBaseUrl);
-	}
-	function askAIEnv(overrides) {
-		const key = apiKey();
-		const keyEnv = apiKeyEnv();
-		const id = projectId();
-		return {
-			...env(),
-			...overrides,
-			DOCS_CLOUD_API_BASE_URL: apiBaseUrl(),
-			...id ? {
-				DOCS_CLOUD_PROJECT_ID: id,
-				PUBLIC_DOCS_CLOUD_PROJECT_ID: id
-			} : {},
-			...key ? {
-				[keyEnv]: key,
-				DOCS_CLOUD_API_KEY: key
-			} : {}
-		};
-	}
-	async function trackEvent(event, trackOptions = {}) {
-		const id = projectId();
-		if (!id) return false;
-		const requestUrl = trackOptions.request ? new URL(trackOptions.request.url) : void 0;
-		const normalized = {
-			...event,
-			timestamp: event.timestamp ?? (/* @__PURE__ */ new Date()).toISOString(),
-			source: event.source ?? trackOptions.source ?? "server",
-			url: event.url ?? trackOptions.request?.url,
-			path: event.path ?? requestUrl?.pathname,
-			locale: event.locale ?? trackOptions.locale,
-			input: event.input ?? trackOptions.input,
-			metadata: mergeRecords(options.metadata, trackOptions.metadata, event.metadata),
-			properties: mergeRecords(requestProperties(trackOptions.request), trackOptions.properties, event.properties)
-		};
-		await sendDocsCloudAnalyticsEvent({
-			endpoint: analyticsEndpoint(),
-			projectId: id,
-			apiKey: analyticsKey(),
-			fetch: options.fetch
-		}, normalized);
-		return true;
-	}
-	function analyticsConfig(analytics) {
-		const selectedAnalytics = analytics ?? options.analytics;
-		if (selectedAnalytics === false) return false;
-		const userConfig = typeof selectedAnalytics === "object" ? selectedAnalytics : {};
-		const userOnEvent = userConfig.onEvent;
-		return {
-			...userConfig,
-			cloud: false,
-			console: userConfig.console ?? false,
-			onEvent: async (event) => {
-				let userError;
-				if (userOnEvent) try {
-					await userOnEvent(event);
-				} catch (error) {
-					userError = error;
-				}
-				await trackEvent(event);
-				if (typeof userError !== "undefined") throw userError;
-			}
-		};
-	}
-	async function askAI(request, askOptions = {}) {
-		const config = {
-			...options.config,
-			...askOptions.config,
-			ai: {
-				enabled: true,
-				provider: "docs-cloud",
-				...options.config?.ai,
-				...askOptions.config?.ai
-			},
-			cloud: {
-				...options.config?.cloud,
-				...askOptions.config?.cloud,
-				apiKey: {
-					...options.config?.cloud?.apiKey,
-					...askOptions.config?.cloud?.apiKey,
-					env: apiKeyEnv()
-				}
-			},
-			analytics: analyticsConfig(askOptions.config?.analytics ?? options.config?.analytics)
-		};
-		return createDocsCloudAskAIResponse(request, {
-			...askOptions,
-			config,
-			env: askAIEnv(askOptions.env),
-			fetch: askOptions.fetch ?? options.fetch,
-			publicBaseUrl: askOptions.publicBaseUrl ?? publicBaseUrl()
-		});
-	}
-	function getPublicConfig() {
-		const id = projectId();
-		const key = apiKey();
-		return {
-			ok: true,
-			configured: {
-				projectId: Boolean(id),
-				apiKey: Boolean(key)
-			},
-			...id ? { projectId: id } : {},
-			apiBaseUrl: apiBaseUrl(),
-			features: {
-				analytics: options.analytics !== false,
-				askAI: options.config?.ai?.enabled !== false
-			},
-			...options.metadata ? { metadata: options.metadata } : {}
-		};
-	}
-	async function handleRequest(request, routeOptions = {}) {
-		if (request.method === "GET") return jsonResponse(getPublicConfig());
-		if (request.method !== "POST") return jsonResponse({ error: "Method not allowed." }, { status: 405 });
-		const body = await readJson(request);
-		if (resolveRouteAction(request, body) === "ask-ai") {
-			const locale = await resolveRouteValue(routeOptions.locale, request);
-			const routePublicBaseUrl = await resolveRouteValue(routeOptions.publicBaseUrl, request);
-			return askAI(isPlainObject(body) && typeof body.action === "string" ? createJsonRequest(request, askAIPayload(body)) : request, {
-				locale,
-				publicBaseUrl: routePublicBaseUrl
-			});
-		}
-		const event = resolveAnalyticsEvent(body);
-		if (!event) return jsonResponse({ error: "Invalid analytics event. Expected an object with a string type." }, { status: 400 });
-		if (!await trackEvent(event, { request })) return jsonResponse({ error: "Docs Cloud project id is not configured." }, { status: 500 });
-		return jsonResponse({
-			ok: true,
-			type: "analytics"
-		});
-	}
-	return {
-		analytics: { track: trackEvent },
-		trackEvent,
-		askAI,
-		handleRequest,
-		getPublicConfig
-	};
-}
-function createDocsCloudRouteHandler(docsCloud, options = {}) {
-	return {
-		GET(request) {
-			return docsCloud.handleRequest(request, options);
-		},
-		POST(request) {
-			return docsCloud.handleRequest(request, options);
-		}
-	};
-}
-
-//#endregion
-export { createDocsCloudRouteHandler, createDocsCloudServer };