@farming-labs/svelte 0.2.75 → 0.2.77

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/dist/server.js CHANGED
@@ -30,27 +30,14 @@
30
30
  import fs from "node:fs";
31
31
  import path from "node:path";
32
32
  import matter from "gray-matter";
33
- import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsDiagnostics, createDocsStandardsDiscoveryResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, performDocsSearch, performDocsSearchWithMetadata, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveDocsSearchAudience, resolveDocsSearchFilters, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsPublishedAgentSkill, resolveDocsStandardsDiscoveryRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
34
- import { buildApiReferenceOpenApiDocumentAsync, createDocsCloudAskAIResponse, createDocsMcpHttpHandler, isDocsCloudAskAIProvider, readDocsSitemapManifest, resolveApiReferenceConfig, resolveDocsMcpConfig, resolveConfiguredAgentSkills, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
33
+ import { applySidebarFolderIndexBehavior, buildDocsAskAIContext, buildDocsAgentDiscoverySpec, buildDocsConfigMap, buildDocsDiagnostics, createDocsStandardsDiscoveryResponse, createDocsMarkdownResponse, createDocsRobotsResponse, createDocsSitemapResponse, createDocsAgentTraceContext, createDocsAgentTraceId, emitDocsAgentTraceEvent, emitDocsAnalyticsEvent, emitDocsTelemetryAgentSurfaceEvent, emitDocsTelemetryProjectEvent, formatDocsAskAIPackageHints, findDocsMarkdownPage, getDocsLlmsTxtMaxCharsIssue, getDocsAgentManifestLinkHeader, getDocsDiscoveryLinkHeader, isDocsAgentDiscoveryRequest, isDocsAgentsRequest, isDocsConfigRequest, isDocsDiagnosticsRequest, isDocsSkillRequest, normalizeDocsRelated, normalizePageAgentFrontmatter, parseDocsAgentFeedbackData, performDocsSearch, performDocsSearchWithMetadata, renderDocsMarkdownDocument, renderDocsLlmsTxt, renderDocsAgentsDocument, renderDocsSkillDocument, readDocsSitemapManifestFromContentMap, stripGeneratedAgentProvenance, resolveDocsAudienceMdxContent, resolveDocsAgentFeedbackConfig, resolveDocsAgentFeedbackRequest, resolvePageSidebarFolderIndexBehavior, resolveAskAISearchRequestConfig, resolveDocsSearchAudience, resolveDocsSearchError, resolveDocsSearchRequest, resolveSearchRequestConfig, resolveDocsI18n, resolveDocsLlmsTxtRequest, resolveDocsLocale, resolveDocsMarkdownRequest, resolveDocsMetadataBaseUrl, resolveDocsRequestApiRoute, resolveDocsRetrievalLastModified, resolveDocsPublishedAgentSkill, resolveDocsStandardsDiscoveryRequest, resolveDocsPath, resolvePageReadingTime, resolveReadingTimeOptions, resolveDocsSitemapPageLastmod, resolveDocsAgentsFormat, resolveDocsSkillFormat, inferDocsTelemetryAgentSurface, renderDocsPageStructuredDataJson, selectDocsLlmsTxtContent, validateDocsAgentFeedbackPayload, } from "@farming-labs/docs";
34
+ import { buildApiReferenceOpenApiDocumentAsync, createDocsCloudAskAIResponse, createDocsMcpHttpHandler, isDocsCloudAskAIProvider, readDocsSitemapManifest, resolveApiReferenceOpenApiDiscovery, resolveDocsMcpConfig, resolveConfiguredAgentSkills, serializeDocsIconRegistry, serializeOpenDocsProviders, } from "@farming-labs/docs/server";
35
35
  import { loadDocsNavTree, loadDocsContent, flattenNavTree, normalizeDocsFrontmatterLastmod, } from "./content.js";
36
36
  import { renderMarkdown } from "./markdown.js";
37
37
  export { createSvelteApiReference } from "./api-reference.js";
38
38
  function isApiReferenceOpenApiRequest(url) {
39
39
  return url.searchParams.get("format")?.trim() === "openapi";
40
40
  }
41
- function resolveApiReferenceOpenApiDiscovery(value) {
42
- const apiReference = resolveApiReferenceConfig(value);
43
- if (!apiReference.enabled)
44
- return { enabled: false };
45
- return {
46
- enabled: true,
47
- url: "/api/docs?format=openapi",
48
- urlSource: "default",
49
- source: apiReference.specUrl ? "configured" : "generated",
50
- specUrl: apiReference.specUrl,
51
- apiReferencePath: `/${apiReference.path}`,
52
- };
53
- }
54
41
  function resolveAIModelAndProvider(aiConfig, requestedModelId) {
55
42
  const raw = aiConfig.model;
56
43
  const modelList = (typeof raw === "object" && raw?.models) || [];
@@ -993,8 +980,17 @@ export function createDocsServer(config = {}) {
993
980
  }
994
981
  const query = event.url.searchParams.get("query")?.trim();
995
982
  const audience = resolveDocsSearchAudience(event.url.searchParams.get("audience"));
996
- const filters = resolveDocsSearchFilters(event.url.searchParams);
997
- const structured = event.url.searchParams.get("response") === "structured";
983
+ let searchRequest;
984
+ try {
985
+ searchRequest = resolveDocsSearchRequest(event.url.searchParams);
986
+ }
987
+ catch (error) {
988
+ const searchError = resolveDocsSearchError(error);
989
+ if (!searchError)
990
+ throw error;
991
+ return Response.json({ error: searchError }, { status: 400 });
992
+ }
993
+ const { filters, structured, cursor, limit } = searchRequest;
998
994
  if (!query && !structured) {
999
995
  return new Response("[]", {
1000
996
  headers: { "Content-Type": "application/json" },
@@ -1011,24 +1007,34 @@ export function createDocsServer(config = {}) {
1011
1007
  siteTitle: llmsTitle,
1012
1008
  baseUrl: markdownMetadataBaseUrl || event.url.origin,
1013
1009
  syncBaseUrl: markdownMetadataBaseUrl ?? null,
1010
+ cursor,
1011
+ limit,
1014
1012
  };
1013
+ const searchStartedAt = Date.now();
1014
+ let searchResponse;
1015
+ try {
1016
+ searchResponse = structured
1017
+ ? await performDocsSearchWithMetadata(searchOptions)
1018
+ : query
1019
+ ? await performDocsSearch(searchOptions)
1020
+ : [];
1021
+ }
1022
+ catch (error) {
1023
+ const searchError = resolveDocsSearchError(error);
1024
+ if (!searchError)
1025
+ throw error;
1026
+ return Response.json({ error: searchError }, { status: 400 });
1027
+ }
1015
1028
  if (!query) {
1016
- const searchResponse = structured ? await performDocsSearchWithMetadata(searchOptions) : [];
1017
- return new Response(JSON.stringify(searchResponse), {
1018
- headers: { "Content-Type": "application/json" },
1019
- });
1029
+ return Response.json(searchResponse);
1020
1030
  }
1021
- const searchStartedAt = Date.now();
1022
- const searchResponse = structured
1023
- ? await performDocsSearchWithMetadata(searchOptions)
1024
- : await performDocsSearch(searchOptions);
1025
1031
  const resultCount = Array.isArray(searchResponse)
1026
1032
  ? searchResponse.length
1027
1033
  : searchResponse.resultCount;
1028
1034
  await emitDocsAnalyticsEvent(analytics, {
1029
1035
  type: "api_search",
1030
1036
  source: "server",
1031
- url: event.request.url,
1037
+ url: `${event.url.origin}${event.url.pathname}`,
1032
1038
  path: event.url.pathname,
1033
1039
  locale: ctx.locale,
1034
1040
  input: { query },
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@farming-labs/svelte",
3
- "version": "0.2.75",
3
+ "version": "0.2.77",
4
4
  "description": "SvelteKit adapter for @farming-labs/docs — content loading and navigation utilities",
5
5
  "keywords": [
6
6
  "docs",
@@ -57,7 +57,7 @@
57
57
  "@types/node": "^22.10.0",
58
58
  "typescript": "^5.9.3",
59
59
  "vitest": "^4.1.8",
60
- "@farming-labs/docs": "0.2.75"
60
+ "@farming-labs/docs": "0.2.77"
61
61
  },
62
62
  "peerDependencies": {
63
63
  "@farming-labs/docs": ">=0.2.73"
@@ -1,26 +0,0 @@
1
- import type { ApiReferenceConfig, DocsConfig } from "./types.js";
2
- type HttpMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "OPTIONS" | "HEAD";
3
- export type ApiReferenceFramework = "next" | "tanstack-start" | "sveltekit" | "astro" | "nuxt";
4
- export interface ApiReferenceRoute {
5
- title: string;
6
- summary: string;
7
- description?: string;
8
- routePath: string;
9
- sourceFile: string;
10
- methods: HttpMethod[];
11
- tag: string;
12
- parameters: Array<Record<string, unknown>>;
13
- }
14
- interface BuildApiReferenceOptions {
15
- framework: ApiReferenceFramework;
16
- rootDir?: string;
17
- }
18
- interface BuildApiReferenceHtmlOptions extends BuildApiReferenceOptions {
19
- title?: string;
20
- }
21
- export declare function resolveApiReferenceConfig(value: DocsConfig["apiReference"]): Required<ApiReferenceConfig>;
22
- export declare function buildApiReferencePageTitle(config: DocsConfig, title?: string): string;
23
- export declare function buildApiReferenceScalarCss(config: DocsConfig): string;
24
- export declare function buildApiReferenceOpenApiDocument(config: DocsConfig, options: BuildApiReferenceOptions): Record<string, unknown>;
25
- export declare function buildApiReferenceHtmlDocument(config: DocsConfig, options: BuildApiReferenceHtmlOptions): string;
26
- export {};