@farming-labs/svelte 0.1.98 → 0.1.100

package/dist/server.js

@@ -31,10 +31,25 @@ 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, isDocsSkillRequest, normalizeDocsRelated, parseDocsAgentFeedbackData, performDocsSearch, renderDocsMarkdownDocument, renderDocsMarkdownNotFound, renderDocsLlmsTxt, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAgentMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsSkillFormat, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
-import { createDocsMcpHttpHandler, readDocsSitemapManifest, resolveDocsMcpConfig, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
+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";
 export { createSvelteApiReference } from "./api-reference.js";
+function isApiReferenceOpenApiRequest(url) {
+    return url.searchParams.get("format")?.trim() === "openapi";
+}
+function resolveApiReferenceOpenApiDiscovery(value) {
+    const apiReference = resolveApiReferenceConfig(value);
+    if (!apiReference.enabled)
+        return { enabled: false };
+    return {
+        enabled: true,
+        url: "/api/docs?format=openapi",
+        source: apiReference.specUrl ? "configured" : "generated",
+        specUrl: apiReference.specUrl,
+        apiReferencePath: `/${apiReference.path}`,
+    };
+}
 function resolveAIModelAndProvider(aiConfig, requestedModelId) {
     const raw = aiConfig.model;
     const modelList = (typeof raw === "object" && raw?.models) || [];
@@ -579,6 +594,7 @@ export function createDocsServer(config = {}) {
     const llmsDesc = typeof llmsTxtConfig === "object" ? llmsTxtConfig.siteDescription : undefined;
     const llmsEnabled = llmsTxtConfig !== false &&
         !(llmsTxtConfig && typeof llmsTxtConfig === "object" && llmsTxtConfig.enabled === false);
+    const openapiDiscovery = resolveApiReferenceOpenApiDiscovery(config.apiReference);
     const mcpConfig = resolveDocsMcpConfig(config.mcp, {
         defaultName: llmsTitle,
     });
@@ -600,6 +616,7 @@ export function createDocsServer(config = {}) {
             baseUrl: llmsBaseUrl,
             maxChars: typeof llmsTxtConfig === "object" ? llmsTxtConfig.maxChars : undefined,
             sections: typeof llmsTxtConfig === "object" ? llmsTxtConfig.sections : undefined,
+            openapi: openapiDiscovery,
         });
         llmsCache.set(key, next);
         return next;
@@ -636,6 +653,7 @@ export function createDocsServer(config = {}) {
                 },
                 sitemap: config.sitemap,
                 robots: config.robots,
+                openapi: openapiDiscovery,
                 markdown: {
                     acceptHeader: false,
                 },
@@ -647,6 +665,29 @@ export function createDocsServer(config = {}) {
                 },
             });
         }
+        if (isApiReferenceOpenApiRequest(event.url)) {
+            if (!openapiDiscovery.enabled) {
+                return new Response("Not Found", {
+                    status: 404,
+                    headers: {
+                        "Content-Type": "text/plain; charset=utf-8",
+                        "X-Robots-Tag": "noindex",
+                    },
+                });
+            }
+            const document = await buildApiReferenceOpenApiDocumentAsync(config, {
+                framework: "sveltekit",
+                rootDir,
+                baseUrl: event.url.origin,
+            });
+            return new Response(JSON.stringify(document, null, 2), {
+                headers: {
+                    "Content-Type": "application/json; charset=utf-8",
+                    "Cache-Control": "public, max-age=0, s-maxage=3600",
+                    "X-Robots-Tag": "noindex",
+                },
+            });
+        }
         const agentFeedbackRequest = resolveDocsAgentFeedbackRequest(event.url, agentFeedbackConfig);
         if (agentFeedbackRequest) {
             if (agentFeedbackRequest.kind === "submit") {
@@ -684,6 +725,7 @@ export function createDocsServer(config = {}) {
                     },
                     sitemap: config.sitemap,
                     robots: config.robots,
+                    openapi: openapiDiscovery,
                     markdown: {
                         acceptHeader: false,
                     },

package/package.json

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