@farming-labs/svelte 0.2.24 → 0.2.25

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, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsSkillRequest, normalizeDocsRelated, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, resolveDocsMarkdownRecovery, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
+import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsMarkdownCanonicalLinkHeader, getDocsMarkdownVaryHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsSkillRequest, normalizeDocsRelated, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, resolveDocsMarkdownRecovery, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
 import { buildApiReferenceOpenApiDocumentAsync, createDocsMcpHttpHandler, readDocsSitemapManifest, resolveApiReferenceConfig, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
 import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
 import { renderMarkdown } from "./markdown.js";
@@ -641,6 +641,24 @@ export function createDocsServer(config = {}) {
         schemaRoute: "/api/docs?feedback=agent&schema=1",
     };
     const llmsCache = new Map();
+    function trackTelemetryRequest(request) {
+        emitDocsTelemetryProjectEvent(config, {
+            framework: "sveltekit",
+            request,
+        });
+        const surface = inferDocsTelemetryAgentSurface(request, {
+            entry,
+            llmsTxt: config.llmsTxt,
+            feedback: config.feedback,
+        });
+        if (!surface)
+            return;
+        emitDocsTelemetryAgentSurfaceEvent(config, {
+            framework: "sveltekit",
+            request,
+            surface,
+        });
+    }
     function getLlmsContent(ctx) {
         const key = ctx.locale ?? "__default__";
         const cached = llmsCache.get(key);
@@ -670,6 +688,7 @@ export function createDocsServer(config = {}) {
     }
     // ─── GET /api/docs?query=… | ?format=llms | ?format=llms-full ──
     async function GET(event) {
+        trackTelemetryRequest(event.request);
         const ctx = resolveContextFromRequest(event.request);
         if (isDocsAgentDiscoveryRequest(event.url)) {
             return new Response(JSON.stringify(buildDocsAgentDiscoverySpec({
@@ -977,6 +996,7 @@ export function createDocsServer(config = {}) {
     }
     const DEFAULT_SYSTEM_PROMPT = buildDefaultSystemPrompt();
     async function POST(event) {
+        trackTelemetryRequest(event.request);
         const requestUrl = new URL(event.request.url);
         const agentFeedbackRequest = resolveDocsAgentFeedbackRequest(requestUrl, agentFeedbackConfig);
         if (agentFeedbackRequest) {
@@ -1487,6 +1507,8 @@ export function createDocsServer(config = {}) {
         },
         mcp: config.mcp,
         analytics,
+        telemetry: config.telemetry,
+        telemetryFramework: "sveltekit",
         observability,
         defaultName: mcpSiteTitle,
     });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@farming-labs/svelte",
-  "version": "0.2.24",
+  "version": "0.2.25",
   "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.2.24"
+    "@farming-labs/docs": "0.2.25"
   },
   "peerDependencies": {
     "@farming-labs/docs": "*"