@farming-labs/svelte 0.1.59 → 0.1.62

package/dist/server.js

@@ -30,7 +30,7 @@
 import fs from "node:fs";
 import path from "node:path";
 import matter from "gray-matter";
-import { applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsSkillDocument, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSkillFormat, } from "@farming-labs/docs";
+import { applySidebarFolderIndexBehavior, buildDocsAgentDiscoverySpec, emitDocsAnalyticsEvent, findDocsMarkdownPage, isDocsAgentDiscoveryRequest, isDocsSkillRequest, normalizeDocsRelated, performDocsSearch, renderDocsMarkdownDocument, renderDocsSkillDocument, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolvePageSidebarFolderIndexBehavior, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtFormat, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSkillFormat, } from "@farming-labs/docs";
 import { createDocsMcpHttpHandler, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
@@ -341,6 +341,7 @@ function findPageInMap(contentMap, dirPrefix, slug) {
  */
 export function createDocsServer(config = {}) {
     const entry = config.entry ?? "docs";
+    const analytics = config.analytics;
     const contentDirBase = config.contentDir ?? entry;
     const rootDir = path.resolve(config.rootDir ?? process.cwd());
     const i18n = resolveDocsI18n(config.i18n);
@@ -702,6 +703,7 @@ export function createDocsServer(config = {}) {
                 headers: { "Content-Type": "application/json" },
             });
         }
+        const searchStartedAt = Date.now();
         const results = await performDocsSearch({
             pages: getSearchIndex(ctx),
             query,
@@ -710,6 +712,20 @@ export function createDocsServer(config = {}) {
             pathname: event.url.searchParams.get("pathname") ?? undefined,
             siteTitle: llmsTitle,
         });
+        await emitDocsAnalyticsEvent(analytics, {
+            type: "api_search",
+            source: "server",
+            url: event.request.url,
+            path: event.url.pathname,
+            locale: ctx.locale,
+            input: { query },
+            properties: {
+                queryLength: query.length,
+                resultCount: results.length,
+                pathname: event.url.searchParams.get("pathname") ?? undefined,
+                durationMs: Math.max(0, Date.now() - searchStartedAt),
+            },
+        });
         return new Response(JSON.stringify(results), {
             headers: { "Content-Type": "application/json" },
         });
@@ -737,7 +753,16 @@ export function createDocsServer(config = {}) {
     }
     const DEFAULT_SYSTEM_PROMPT = buildDefaultSystemPrompt();
     async function POST(event) {
+        const requestUrl = new URL(event.request.url);
+        const requestStartedAt = Date.now();
         if (!aiConfig.enabled) {
+            await emitDocsAnalyticsEvent(analytics, {
+                type: "api_ai_error",
+                source: "server",
+                url: event.request.url,
+                path: requestUrl.pathname,
+                properties: { reason: "disabled" },
+            });
             return new Response(JSON.stringify({
                 error: "AI is not enabled. Set `ai: { enabled: true }` in your docs config to enable it.",
             }), { status: 404, headers: { "Content-Type": "application/json" } });
@@ -746,6 +771,16 @@ export function createDocsServer(config = {}) {
             (typeof import.meta !== "undefined" ? import.meta.env?.OPENAI_API_KEY : undefined) ??
             (typeof process !== "undefined" ? process.env?.OPENAI_API_KEY : undefined);
         if (!resolvedKey) {
+            await emitDocsAnalyticsEvent(analytics, {
+                type: "api_ai_error",
+                source: "server",
+                url: event.request.url,
+                path: requestUrl.pathname,
+                properties: {
+                    reason: "missing_api_key",
+                    durationMs: Math.max(0, Date.now() - requestStartedAt),
+                },
+            });
             return new Response(JSON.stringify({
                 error: "AI is enabled but no API key was found. Set `apiKey` in your docs config `ai` section or add OPENAI_API_KEY to your environment.",
             }), { status: 500, headers: { "Content-Type": "application/json" } });
@@ -756,14 +791,48 @@ export function createDocsServer(config = {}) {
             body = await event.request.json();
         }
         catch {
+            await emitDocsAnalyticsEvent(analytics, {
+                type: "api_ai_error",
+                source: "server",
+                url: event.request.url,
+                path: requestUrl.pathname,
+                locale: ctx.locale,
+                properties: {
+                    reason: "invalid_json",
+                    durationMs: Math.max(0, Date.now() - requestStartedAt),
+                },
+            });
             return new Response(JSON.stringify({ error: "Invalid JSON body. Expected { messages: [...] }" }), { status: 400, headers: { "Content-Type": "application/json" } });
         }
         const messages = body.messages;
         if (!Array.isArray(messages) || messages.length === 0) {
+            await emitDocsAnalyticsEvent(analytics, {
+                type: "api_ai_error",
+                source: "server",
+                url: event.request.url,
+                path: requestUrl.pathname,
+                locale: ctx.locale,
+                properties: {
+                    reason: "missing_messages",
+                    durationMs: Math.max(0, Date.now() - requestStartedAt),
+                },
+            });
             return new Response(JSON.stringify({ error: "messages array is required and must not be empty." }), { status: 400, headers: { "Content-Type": "application/json" } });
         }
         const lastUserMessage = [...messages].reverse().find((m) => m.role === "user");
         if (!lastUserMessage) {
+            await emitDocsAnalyticsEvent(analytics, {
+                type: "api_ai_error",
+                source: "server",
+                url: event.request.url,
+                path: requestUrl.pathname,
+                locale: ctx.locale,
+                properties: {
+                    reason: "missing_user_message",
+                    messageCount: messages.length,
+                    durationMs: Math.max(0, Date.now() - requestStartedAt),
+                },
+            });
             return new Response(JSON.stringify({ error: "At least one user message is required." }), {
                 status: 400,
                 headers: { "Content-Type": "application/json" },
@@ -789,6 +858,20 @@ export function createDocsServer(config = {}) {
             : undefined;
         const resolved = resolveAIModelAndProvider(aiConfig, requestedModel);
         const finalKey = resolved.apiKey ?? resolvedKey;
+        await emitDocsAnalyticsEvent(analytics, {
+            type: "api_ai_request",
+            source: "server",
+            url: event.request.url,
+            path: requestUrl.pathname,
+            locale: ctx.locale,
+            input: { question: lastUserMessage.content },
+            properties: {
+                messageCount: messages.length,
+                questionLength: lastUserMessage.content.length,
+                retrievedCount: scored.length,
+                model: resolved.model,
+            },
+        });
         const llmResponse = await fetch(`${resolved.baseUrl}/chat/completions`, {
             method: "POST",
             headers: {
@@ -799,8 +882,40 @@ export function createDocsServer(config = {}) {
         });
         if (!llmResponse.ok) {
             const errText = await llmResponse.text().catch(() => "Unknown error");
+            await emitDocsAnalyticsEvent(analytics, {
+                type: "api_ai_error",
+                source: "server",
+                url: event.request.url,
+                path: requestUrl.pathname,
+                locale: ctx.locale,
+                input: { question: lastUserMessage.content },
+                properties: {
+                    reason: "llm_error",
+                    status: llmResponse.status,
+                    messageCount: messages.length,
+                    questionLength: lastUserMessage.content.length,
+                    retrievedCount: scored.length,
+                    model: resolved.model,
+                    durationMs: Math.max(0, Date.now() - requestStartedAt),
+                },
+            });
             return new Response(JSON.stringify({ error: `LLM API error (${llmResponse.status}): ${errText}` }), { status: 502, headers: { "Content-Type": "application/json" } });
         }
+        await emitDocsAnalyticsEvent(analytics, {
+            type: "api_ai_response",
+            source: "server",
+            url: event.request.url,
+            path: requestUrl.pathname,
+            locale: ctx.locale,
+            input: { question: lastUserMessage.content },
+            properties: {
+                messageCount: messages.length,
+                questionLength: lastUserMessage.content.length,
+                retrievedCount: scored.length,
+                model: resolved.model,
+                durationMs: Math.max(0, Date.now() - requestStartedAt),
+            },
+        });
         return new Response(llmResponse.body, {
             headers: {
                 "Content-Type": "text/event-stream",
@@ -831,6 +946,7 @@ export function createDocsServer(config = {}) {
             },
         },
         mcp: config.mcp,
+        analytics,
         defaultName: mcpSiteTitle,
     });
     return { load, GET, POST, MCP };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.1.59",
+  "version": "0.1.62",
   "description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
   "keywords": [
     "docs",
@@ -56,7 +56,7 @@
   "devDependencies": {
     "@types/node": "^22.10.0",
     "typescript": "^5.9.3",
-    "@farming-labs/docs": "0.1.59"
+    "@farming-labs/docs": "0.1.62"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"