@farming-labs/nuxt 0.0.37 → 0.0.43

package/dist/nuxt/src/server.js

@@ -0,0 +1,726 @@
+/**
+ * Server-side helpers for Nuxt docs routes.
+ *
+ * The simplest setup is a single file:
+ *
+ * @example
+ * ```ts
+ * // server/api/docs.ts
+ * import { defineDocsHandler } from "@farming-labs/nuxt/server";
+ * import config from "../../docs.config";
+ * export default defineDocsHandler(config);
+ * ```
+ *
+ * That one handler serves page loads, search, and AI chat.
+ */
+import fs from "node:fs";
+import path from "node:path";
+import matter from "gray-matter";
+import { resolveDocsI18n, resolveDocsLocale, resolveDocsPath } from "@farming-labs/docs";
+import { loadDocsNavTree, loadDocsContent, flattenNavTree } from "./content.js";
+import { renderMarkdown } from "./markdown.js";
+export { defineApiReferenceHandler } from "./api-reference.js";
+function resolveAIModelAndProvider(aiConfig, requestedModelId) {
+    const raw = aiConfig.model;
+    const modelList = (typeof raw === "object" && raw?.models) || [];
+    let modelId = requestedModelId;
+    if (!modelId) {
+        if (typeof raw === "string")
+            modelId = raw;
+        else if (typeof raw === "object")
+            modelId = raw.defaultModel ?? raw.models?.[0]?.id;
+        if (!modelId)
+            modelId = "gpt-4o-mini";
+    }
+    const entry = modelList.find((m) => m.id === modelId);
+    const providerKey = entry?.provider;
+    const providerConfig = providerKey && aiConfig.providers?.[providerKey];
+    const baseUrl = ((providerConfig && providerConfig.baseUrl) ||
+        aiConfig.baseUrl ||
+        "https://api.openai.com/v1").replace(/\/$/, "");
+    const apiKey = (providerConfig && providerConfig.apiKey) ||
+        aiConfig.apiKey ||
+        (typeof process !== "undefined" ? process.env?.OPENAI_API_KEY : undefined);
+    return { model: modelId, baseUrl, apiKey };
+}
+function stripMarkdownText(content) {
+    return content
+        .replace(/^(import|export)\s.*$/gm, "")
+        .replace(/<[^>]+\/>/g, "")
+        .replace(/<\/?[A-Z][^>]*>/g, "")
+        .replace(/<\/?[a-z][^>]*>/g, "")
+        .replace(/\[([^\]]+)\]\([^)]+\)/g, "$1")
+        .replace(/!\[([^\]]*)\]\([^)]+\)/g, "$1")
+        .replace(/^#{1,6}\s+/gm, "")
+        .replace(/(\*{1,3}|_{1,3})(.*?)\1/g, "$2")
+        .replace(/```[\s\S]*?```/g, "")
+        .replace(/`([^`]+)`/g, "$1")
+        .replace(/^>\s+/gm, "")
+        .replace(/^[-*_]{3,}\s*$/gm, "")
+        .replace(/\n{3,}/g, "\n\n")
+        .trim();
+}
+function normalizePathSegment(value) {
+    return value.replace(/^\/+|\/+$/g, "");
+}
+function joinPathParts(...parts) {
+    return parts
+        .map((part) => normalizePathSegment(part))
+        .filter(Boolean)
+        .join("/");
+}
+function toPosixPath(value) {
+    return value.replace(/\\\\/g, "/");
+}
+function buildDirPrefix(contentDir) {
+    const rel = path.isAbsolute(contentDir)
+        ? toPosixPath(path.relative(process.cwd(), contentDir))
+        : toPosixPath(contentDir);
+    const normalized = normalizePathSegment(rel);
+    return normalized ? `/${normalized}/` : "/";
+}
+function navTreeFromMap(contentMap, dirPrefix, entry, ordering) {
+    const dirs = [];
+    for (const key of Object.keys(contentMap)) {
+        if (!key.startsWith(dirPrefix))
+            continue;
+        const rel = key.slice(dirPrefix.length);
+        const segments = rel.split("/");
+        const fileName = segments.pop();
+        const base = fileName.replace(/\.(md|mdx|svx)$/, "");
+        if (base !== "page" && base !== "index" && base !== "+page")
+            continue;
+        const { data } = matter(contentMap[key]);
+        const dirParts = segments;
+        const slug = dirParts.join("/");
+        const url = slug ? `/${entry}/${slug}` : `/${entry}`;
+        const fallbackTitle = dirParts.length > 0
+            ? dirParts[dirParts.length - 1].replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase())
+            : "Documentation";
+        dirs.push({
+            parts: dirParts,
+            title: data.title ?? fallbackTitle,
+            url,
+            icon: data.icon,
+            order: typeof data.order === "number" ? data.order : Infinity,
+        });
+    }
+    dirs.sort((a, b) => {
+        if (a.parts.length !== b.parts.length)
+            return a.parts.length - b.parts.length;
+        return a.parts.join("/").localeCompare(b.parts.join("/"));
+    });
+    const children = [];
+    const rootInfo = dirs.find((d) => d.parts.length === 0);
+    if (rootInfo) {
+        children.push({
+            type: "page",
+            name: rootInfo.title,
+            url: rootInfo.url,
+            icon: rootInfo.icon,
+        });
+    }
+    function findSlugOrder(parentParts) {
+        if (!Array.isArray(ordering))
+            return undefined;
+        let items = ordering;
+        for (const part of parentParts) {
+            const found = items.find((i) => i.slug === part);
+            if (!found?.children)
+                return undefined;
+            items = found.children;
+        }
+        return items;
+    }
+    function buildLevel(parentParts) {
+        const depth = parentParts.length;
+        const directChildren = dirs.filter((d) => {
+            if (d.parts.length !== depth + 1)
+                return false;
+            for (let i = 0; i < depth; i++) {
+                if (d.parts[i] !== parentParts[i])
+                    return false;
+            }
+            return true;
+        });
+        const slugOrder = findSlugOrder(parentParts);
+        if (slugOrder) {
+            const slugMap = new Set(slugOrder.map((i) => i.slug));
+            const ordered = [];
+            for (const item of slugOrder) {
+                const match = directChildren.find((d) => d.parts[depth] === item.slug);
+                if (match)
+                    ordered.push(match);
+            }
+            for (const child of directChildren) {
+                if (!slugMap.has(child.parts[depth]))
+                    ordered.push(child);
+            }
+            const nodes = [];
+            for (const child of ordered) {
+                const hasGrandChildren = dirs.some((d) => {
+                    if (d.parts.length <= child.parts.length)
+                        return false;
+                    return child.parts.every((p, i) => d.parts[i] === p);
+                });
+                if (hasGrandChildren) {
+                    nodes.push({
+                        type: "folder",
+                        name: child.title,
+                        icon: child.icon,
+                        index: { type: "page", name: child.title, url: child.url, icon: child.icon },
+                        children: buildLevel(child.parts),
+                    });
+                }
+                else {
+                    nodes.push({ type: "page", name: child.title, url: child.url, icon: child.icon });
+                }
+            }
+            return nodes;
+        }
+        if (ordering === "numeric") {
+            directChildren.sort((a, b) => {
+                if (a.order === b.order)
+                    return 0;
+                return a.order - b.order;
+            });
+        }
+        const nodes = [];
+        for (const child of directChildren) {
+            const hasGrandChildren = dirs.some((d) => {
+                if (d.parts.length <= child.parts.length)
+                    return false;
+                return child.parts.every((p, i) => d.parts[i] === p);
+            });
+            if (hasGrandChildren) {
+                nodes.push({
+                    type: "folder",
+                    name: child.title,
+                    icon: child.icon,
+                    index: {
+                        type: "page",
+                        name: child.title,
+                        url: child.url,
+                        icon: child.icon,
+                    },
+                    children: buildLevel(child.parts),
+                });
+            }
+            else {
+                nodes.push({
+                    type: "page",
+                    name: child.title,
+                    url: child.url,
+                    icon: child.icon,
+                });
+            }
+        }
+        return nodes;
+    }
+    children.push(...buildLevel([]));
+    return { name: "Docs", children };
+}
+function searchIndexFromMap(contentMap, dirPrefix, entry) {
+    const pages = [];
+    for (const [key, raw] of Object.entries(contentMap)) {
+        if (!key.startsWith(dirPrefix))
+            continue;
+        const rel = key.slice(dirPrefix.length);
+        const segments = rel.split("/");
+        const fileName = segments.pop();
+        const base = fileName.replace(/\.(md|mdx|svx)$/, "");
+        const isIdx = base === "page" || base === "index" || base === "+page";
+        const slug = isIdx ? segments.join("/") : [...segments, base].join("/");
+        const url = slug ? `/${entry}/${slug}` : `/${entry}`;
+        const { data, content } = matter(raw);
+        const title = data.title ?? base.replace(/-/g, " ").replace(/\b\w/g, (c) => c.toUpperCase());
+        pages.push({
+            slug,
+            url,
+            title,
+            description: data.description,
+            icon: data.icon,
+            content: stripMarkdownText(content),
+            rawContent: content,
+        });
+    }
+    return pages;
+}
+function findPageInMap(contentMap, dirPrefix, slug) {
+    const isIndex = slug === "";
+    const candidates = isIndex
+        ? ["page.md", "page.mdx", "index.md"]
+        : [
+            `${slug}/page.md`,
+            `${slug}/page.mdx`,
+            `${slug}/index.md`,
+            `${slug}/index.svx`,
+            `${slug}.md`,
+            `${slug}.svx`,
+        ];
+    for (const candidate of candidates) {
+        const key = `${dirPrefix}${candidate}`;
+        if (key in contentMap) {
+            return { raw: contentMap[key], relPath: candidate };
+        }
+    }
+    return null;
+}
+/**
+ * Create all server-side functions needed for a Nuxt docs site.
+ *
+ * @param config - The `DocsConfig` object (from `defineDocs()` in `docs.config.ts`).
+ *
+ * Pass `_preloadedContent` (from `import.meta.glob`) to bundle markdown files
+ * at build time — required for serverless deployments (Vercel, Netlify, etc.)
+ * where the filesystem is not available at runtime.
+ */
+export function createDocsServer(config = {}) {
+    const entry = config.entry ?? "docs";
+    const contentDirBase = config.contentDir ?? entry;
+    const i18n = resolveDocsI18n(config.i18n);
+    const githubRaw = config.github;
+    const github = typeof githubRaw === "string" ? { url: githubRaw } : (githubRaw ?? null);
+    const githubRepo = github?.url;
+    const githubBranch = github?.branch ?? "main";
+    const githubContentPath = github?.directory;
+    const preloaded = config._preloadedContent;
+    const ordering = config.ordering;
+    const aiConfig = config.ai ?? {};
+    if (config.apiKey && !aiConfig.apiKey) {
+        aiConfig.apiKey = config.apiKey;
+    }
+    function resolveContentDirRel(locale) {
+        if (!locale)
+            return contentDirBase;
+        if (path.isAbsolute(contentDirBase))
+            return path.join(contentDirBase, locale);
+        return joinPathParts(contentDirBase, locale);
+    }
+    function resolveContextFromPath(pathname, locale) {
+        const match = resolveDocsPath(pathname, entry);
+        const contentDirRel = resolveContentDirRel(locale);
+        const contentDirAbs = path.isAbsolute(contentDirRel)
+            ? contentDirRel
+            : path.resolve(process.cwd(), contentDirRel);
+        return {
+            ...match,
+            locale,
+            contentDirRel,
+            contentDirAbs,
+            dirPrefix: buildDirPrefix(contentDirRel),
+        };
+    }
+    function resolveLocaleFromRequest(request) {
+        if (!i18n)
+            return undefined;
+        const url = new URL(request.url);
+        const direct = resolveDocsLocale(url.searchParams, i18n);
+        if (direct)
+            return direct;
+        const referrer = request.headers.get("referer") ?? request.headers.get("referrer");
+        if (referrer) {
+            try {
+                const refUrl = new URL(referrer);
+                const fromRef = resolveDocsLocale(refUrl.searchParams, i18n);
+                if (fromRef)
+                    return fromRef;
+            }
+            catch {
+                // ignore
+            }
+        }
+        return i18n.defaultLocale;
+    }
+    function resolveContextFromRequest(request) {
+        const locale = resolveLocaleFromRequest(request);
+        const url = new URL(request.url);
+        const pathnameParam = url.searchParams.get("pathname");
+        const referrer = request.headers.get("referer") ?? request.headers.get("referrer");
+        const refPath = referrer ? new URL(referrer).pathname : undefined;
+        const pathname = pathnameParam ?? refPath ?? `/${entry}`;
+        return resolveContextFromPath(pathname, locale);
+    }
+    // ─── Unified load (tree + page content in one call) ────────
+    async function load(pathname) {
+        let url;
+        try {
+            url = new URL(pathname);
+        }
+        catch {
+            url = new URL(pathname, "http://localhost");
+        }
+        const locale = resolveDocsLocale(url.searchParams, i18n) ?? i18n?.defaultLocale;
+        const ctx = resolveContextFromPath(url.pathname, locale);
+        const tree = preloaded
+            ? navTreeFromMap(preloaded, ctx.dirPrefix, entry, ordering)
+            : loadDocsNavTree(ctx.contentDirAbs, entry, ordering);
+        const flatPages = flattenNavTree(tree);
+        const slug = ctx.slug;
+        const isIndex = slug === "";
+        let raw;
+        let relPath;
+        let lastModified;
+        if (preloaded) {
+            const result = findPageInMap(preloaded, ctx.dirPrefix, slug);
+            if (!result) {
+                const err = new Error(`Page not found: /${entry}/${slug}`);
+                err.status = 404;
+                throw err;
+            }
+            raw = result.raw;
+            relPath = result.relPath;
+            lastModified = new Date().toLocaleDateString("en-US", {
+                year: "numeric",
+                month: "long",
+                day: "numeric",
+            });
+        }
+        else {
+            let filePath = null;
+            relPath = "";
+            if (isIndex) {
+                for (const name of ["page.md", "page.mdx", "index.md"]) {
+                    const candidate = path.join(ctx.contentDirAbs, name);
+                    if (fs.existsSync(candidate)) {
+                        filePath = candidate;
+                        relPath = name;
+                        break;
+                    }
+                }
+            }
+            else {
+                const candidates = [
+                    path.join(ctx.contentDirAbs, slug, "page.md"),
+                    path.join(ctx.contentDirAbs, slug, "page.mdx"),
+                    path.join(ctx.contentDirAbs, slug, "index.md"),
+                    path.join(ctx.contentDirAbs, slug, "index.svx"),
+                    path.join(ctx.contentDirAbs, `${slug}.md`),
+                    path.join(ctx.contentDirAbs, `${slug}.svx`),
+                ];
+                for (const candidate of candidates) {
+                    if (fs.existsSync(candidate)) {
+                        filePath = candidate;
+                        relPath = path.relative(ctx.contentDirAbs, candidate);
+                        break;
+                    }
+                }
+            }
+            if (!filePath) {
+                const err = new Error(`Page not found: /${entry}/${slug}`);
+                err.status = 404;
+                throw err;
+            }
+            raw = fs.readFileSync(filePath, "utf-8");
+            const stat = fs.statSync(filePath);
+            lastModified = stat.mtime.toLocaleDateString("en-US", {
+                year: "numeric",
+                month: "long",
+                day: "numeric",
+            });
+        }
+        const { data, content } = matter(raw);
+        const html = await renderMarkdown(content);
+        const currentUrl = isIndex ? `/${entry}` : `/${entry}/${slug}`;
+        const currentIndex = flatPages.findIndex((p) => p.url === currentUrl);
+        const previousPage = currentIndex > 0 ? flatPages[currentIndex - 1] : null;
+        const nextPage = currentIndex < flatPages.length - 1 ? flatPages[currentIndex + 1] : null;
+        let editOnGithub;
+        if (githubRepo && githubContentPath) {
+            const trimmed = githubContentPath.replace(/\/+$/, "");
+            const localePrefix = ctx.locale ? `${ctx.locale}/` : "";
+            editOnGithub = `${githubRepo}/blob/${githubBranch}/${trimmed}/${localePrefix}${relPath}`;
+        }
+        const fallbackTitle = isIndex
+            ? "Documentation"
+            : (slug.split("/").pop()?.replace(/-/g, " ") ?? "Documentation");
+        return {
+            tree,
+            flatPages,
+            title: data.title ?? fallbackTitle,
+            description: data.description,
+            html,
+            entry,
+            locale: ctx.locale,
+            ...(isIndex ? {} : { slug }),
+            previousPage,
+            nextPage,
+            editOnGithub,
+            lastModified,
+        };
+    }
+    // ─── Search index ──────────────────────────────────────────
+    const searchIndexByEntry = new Map();
+    function getSearchIndex(ctx) {
+        const key = ctx.locale ?? "__default__";
+        const cached = searchIndexByEntry.get(key);
+        if (cached)
+            return cached;
+        const index = preloaded
+            ? searchIndexFromMap(preloaded, ctx.dirPrefix, entry)
+            : loadDocsContent(ctx.contentDirAbs, entry);
+        searchIndexByEntry.set(key, index);
+        return index;
+    }
+    function searchByQuery(query, ctx) {
+        const index = getSearchIndex(ctx);
+        return index
+            .map((page) => {
+            const titleMatch = page.title.toLowerCase().includes(query) ? 10 : 0;
+            const words = query.split(/\s+/);
+            const contentMatch = words.reduce((score, word) => {
+                return score + (page.content.toLowerCase().includes(word) ? 1 : 0);
+            }, 0);
+            return { ...page, score: titleMatch + contentMatch };
+        })
+            .filter((r) => r.score > 0)
+            .sort((a, b) => b.score - a.score);
+    }
+    // ─── llms.txt content builder ────────────────────────────────
+    const llmsSiteTitle = typeof config.nav === "object" &&
+        typeof config.nav?.title === "string"
+        ? config.nav.title
+        : "Documentation";
+    const llmsTxtConfig = config.llmsTxt;
+    const llmsBaseUrl = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.baseUrl ?? "") : "";
+    const llmsTitle = typeof llmsTxtConfig === "object" ? (llmsTxtConfig.siteTitle ?? llmsSiteTitle) : llmsSiteTitle;
+    const llmsDesc = typeof llmsTxtConfig === "object" ? llmsTxtConfig.siteDescription : undefined;
+    const llmsCache = new Map();
+    function getLlmsContent(ctx) {
+        const key = ctx.locale ?? "__default__";
+        const cached = llmsCache.get(key);
+        if (cached)
+            return cached;
+        const pages = getSearchIndex(ctx);
+        let llmsTxt = `# ${llmsTitle}\n\n`;
+        let llmsFullTxt = `# ${llmsTitle}\n\n`;
+        if (llmsDesc) {
+            llmsTxt += `> ${llmsDesc}\n\n`;
+            llmsFullTxt += `> ${llmsDesc}\n\n`;
+        }
+        llmsTxt += `## Pages\n\n`;
+        for (const page of pages) {
+            llmsTxt += `- [${page.title}](${llmsBaseUrl}${page.url})`;
+            if (page.description)
+                llmsTxt += `: ${page.description}`;
+            llmsTxt += `\n`;
+            llmsFullTxt += `## ${page.title}\n\n`;
+            llmsFullTxt += `URL: ${llmsBaseUrl}${page.url}\n\n`;
+            if (page.description)
+                llmsFullTxt += `${page.description}\n\n`;
+            llmsFullTxt += `${page.content}\n\n---\n\n`;
+        }
+        const next = { llmsTxt, llmsFullTxt };
+        llmsCache.set(key, next);
+        return next;
+    }
+    // ─── GET /api/docs?query=… | ?format=llms | ?format=llms-full ──
+    function GET(context) {
+        const ctx = resolveContextFromRequest(context.request);
+        const url = new URL(context.request.url);
+        const format = url.searchParams.get("format");
+        if (format === "llms" || format === "llms-full") {
+            const llmsContent = getLlmsContent(ctx);
+            return new Response(format === "llms-full" ? llmsContent.llmsFullTxt : llmsContent.llmsTxt, {
+                headers: {
+                    "Content-Type": "text/plain; charset=utf-8",
+                    "Cache-Control": "public, max-age=3600",
+                },
+            });
+        }
+        const query = url.searchParams.get("query")?.toLowerCase().trim();
+        if (!query) {
+            return new Response(JSON.stringify([]), {
+                headers: { "Content-Type": "application/json" },
+            });
+        }
+        const results = searchByQuery(query, ctx)
+            .slice(0, 10)
+            .map(({ title, url, description }) => ({
+            content: title,
+            url,
+            description,
+        }));
+        return new Response(JSON.stringify(results), {
+            headers: { "Content-Type": "application/json" },
+        });
+    }
+    // ─── POST /api/docs — AI chat with RAG ────────────────────
+    const projectName = (typeof config.nav?.title === "string"
+        ? config.nav.title
+        : null);
+    const packageName = aiConfig.packageName;
+    const docsUrl = aiConfig.docsUrl;
+    function buildDefaultSystemPrompt() {
+        const lines = [
+            `You are a helpful documentation assistant${projectName ? ` for ${projectName}` : ""}.`,
+            "Answer questions based on the provided documentation context.",
+            "Be concise and accurate. If the answer is not in the context, say so honestly.",
+            "Use markdown formatting for code examples and links.",
+        ];
+        if (packageName) {
+            lines.push(`When showing import examples, always use "${packageName}" as the package name.`);
+        }
+        if (docsUrl) {
+            lines.push(`When linking to documentation pages, use "${docsUrl}" as the base URL (e.g. ${docsUrl}/docs/get-started).`);
+        }
+        return lines.join(" ");
+    }
+    const DEFAULT_SYSTEM_PROMPT = buildDefaultSystemPrompt();
+    async function POST(context) {
+        if (!aiConfig.enabled) {
+            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" } });
+        }
+        const resolvedKey = aiConfig.apiKey ?? (typeof process !== "undefined" ? process.env?.OPENAI_API_KEY : undefined);
+        if (!resolvedKey) {
+            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" } });
+        }
+        const ctx = resolveContextFromRequest(context.request);
+        let body;
+        try {
+            body = await context.request.json();
+        }
+        catch {
+            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) {
+            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) {
+            return new Response(JSON.stringify({ error: "At least one user message is required." }), {
+                status: 400,
+                headers: { "Content-Type": "application/json" },
+            });
+        }
+        const maxResults = aiConfig.maxResults ?? 5;
+        const scored = searchByQuery(lastUserMessage.content.toLowerCase(), ctx).slice(0, maxResults);
+        const contextParts = scored.map((doc) => `## ${doc.title}\nURL: ${doc.url}\n${doc.description ? `Description: ${doc.description}\n` : ""}\n${doc.content}`);
+        const ragContext = contextParts.join("\n\n---\n\n");
+        const systemPrompt = aiConfig.systemPrompt ?? DEFAULT_SYSTEM_PROMPT;
+        const systemMessage = {
+            role: "system",
+            content: ragContext
+                ? `${systemPrompt}\n\n---\n\nDocumentation context:\n\n${ragContext}`
+                : systemPrompt,
+        };
+        const llmMessages = [
+            systemMessage,
+            ...messages.filter((m) => m.role !== "system"),
+        ];
+        const requestedModel = typeof body.model === "string" && body.model.trim().length > 0
+            ? body.model.trim()
+            : undefined;
+        const resolved = resolveAIModelAndProvider(aiConfig, requestedModel);
+        const finalKey = resolved.apiKey ?? resolvedKey;
+        const llmResponse = await fetch(`${resolved.baseUrl}/chat/completions`, {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json",
+                Authorization: `Bearer ${finalKey}`,
+            },
+            body: JSON.stringify({ model: resolved.model, stream: true, messages: llmMessages }),
+        });
+        if (!llmResponse.ok) {
+            const errText = await llmResponse.text().catch(() => "Unknown error");
+            return new Response(JSON.stringify({ error: `LLM API error (${llmResponse.status}): ${errText}` }), { status: 502, headers: { "Content-Type": "application/json" } });
+        }
+        return new Response(llmResponse.body, {
+            headers: {
+                "Content-Type": "text/event-stream",
+                "Cache-Control": "no-cache",
+                Connection: "keep-alive",
+            },
+        });
+    }
+    return { load, GET, POST };
+}
+// ─── Nuxt event handler helper ───────────────────────────────
+/**
+ * Create a single Nuxt event handler that serves docs pages, search, and AI chat.
+ *
+ * Pass `useStorage` from the Nitro auto-import so the handler can read
+ * docs bundled via `serverAssets`.
+ *
+ * @example
+ * ```ts
+ * // server/api/docs.ts
+ * import { defineDocsHandler } from "@farming-labs/nuxt/server";
+ * import config from "../../docs.config";
+ * export default defineDocsHandler(config, useStorage);
+ * ```
+ *
+ * The handler responds to:
+ * - `GET /api/docs?pathname=/docs/page` → page load
+ * - `GET /api/docs?query=search+term`  → search
+ * - `POST /api/docs`                   → AI chat
+ */
+export function defineDocsHandler(config, storage) {
+    let _server = null;
+    let _initPromise = null;
+    async function getServer() {
+        if (_server)
+            return _server;
+        if (_initPromise)
+            return _initPromise;
+        _initPromise = (async () => {
+            const entry = config.entry ?? config.contentDir ?? "docs";
+            const contentDirRel = config.contentDir ?? entry;
+            const store = storage(`assets:${contentDirRel}`);
+            const keys = await store.getKeys();
+            const contentFiles = {};
+            for (const key of keys) {
+                if (!key.endsWith(".md") && !key.endsWith(".mdx"))
+                    continue;
+                const raw = await store.getItem(key);
+                if (typeof raw === "string") {
+                    const filePath = `/${entry}/${key.replace(/:/g, "/")}`;
+                    contentFiles[filePath] = raw;
+                }
+            }
+            _server = createDocsServer({
+                ...config,
+                ...(Object.keys(contentFiles).length > 0 ? { _preloadedContent: contentFiles } : {}),
+            });
+            return _server;
+        })();
+        return _initPromise;
+    }
+    return async (event) => {
+        const server = await getServer();
+        const method = event.method ?? event.node?.req?.method ?? "GET";
+        const headers = event.headers ?? event.node?.req?.headers ?? {};
+        if (method === "POST") {
+            const url = new URL(event.node.req.url ?? "/", "http://localhost");
+            let body;
+            try {
+                body = await new Promise((resolve, reject) => {
+                    let data = "";
+                    event.node.req.on("data", (chunk) => (data += chunk));
+                    event.node.req.on("end", () => resolve(data));
+                    event.node.req.on("error", reject);
+                });
+            }
+            catch {
+                /* empty */
+            }
+            return server.POST({
+                request: new Request(url.href, { method: "POST", headers, body }),
+            });
+        }
+        const reqUrl = new URL(event.node.req.url ?? "/", "http://localhost");
+        const pathname = reqUrl.searchParams.get("pathname");
+        if (pathname) {
+            return server.load(pathname);
+        }
+        return server.GET({
+            request: new Request(reqUrl.href, { method: "GET", headers }),
+        });
+    };
+}
+//# sourceMappingURL=server.js.map