npm - @raystack/chronicle - Versions diffs - 0.5.3 → 0.6.0 - Mend

@raystack/chronicle 0.5.3 → 0.6.0

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.

Files changed (74) hide show

package/dist/cli/index.js +260 -81
package/package.json +8 -6
package/src/cli/commands/build.ts +5 -8
package/src/cli/commands/dev.ts +5 -6
package/src/cli/commands/init.test.ts +77 -0
package/src/cli/commands/init.ts +73 -40
package/src/cli/commands/serve.ts +6 -9
package/src/cli/commands/start.ts +5 -5
package/src/cli/utils/config.ts +6 -12
package/src/cli/utils/scaffold.test.ts +179 -0
package/src/cli/utils/scaffold.ts +70 -9
package/src/components/api/field-row.tsx +1 -1
package/src/components/api/field-section.tsx +2 -2
package/src/components/mdx/index.tsx +1 -1
package/src/components/mdx/mermaid.tsx +24 -21
package/src/components/ui/breadcrumbs.tsx +4 -2
package/src/components/ui/client-theme-switcher.tsx +21 -4
package/src/components/ui/search.module.css +16 -41
package/src/components/ui/search.tsx +30 -41
package/src/lib/config.test.ts +493 -0
package/src/lib/config.ts +123 -22
package/src/lib/head.tsx +23 -5
package/src/lib/llms.test.ts +94 -0
package/src/lib/llms.ts +41 -0
package/src/lib/navigation.test.ts +94 -0
package/src/lib/navigation.ts +51 -0
package/src/lib/page-context.tsx +79 -32
package/src/lib/route-resolver.test.ts +173 -0
package/src/lib/route-resolver.ts +73 -0
package/src/lib/source.ts +94 -1
package/src/lib/version-source.test.ts +163 -0
package/src/lib/version-source.ts +101 -0
package/src/pages/ApiPage.tsx +1 -1
package/src/pages/DocsLayout.tsx +24 -3
package/src/pages/DocsPage.tsx +7 -7
package/src/pages/LandingPage.module.css +56 -0
package/src/pages/LandingPage.tsx +39 -0
package/src/pages/NotFound.module.css +3 -0
package/src/pages/NotFound.tsx +9 -12
package/src/server/App.tsx +21 -23
package/src/server/api/{page/[...slug].ts → page.ts} +7 -3
package/src/server/api/search.ts +51 -24
package/src/server/api/specs.ts +17 -5
package/src/server/entry-client.tsx +42 -14
package/src/server/entry-server.tsx +35 -13
package/src/server/plugins/telemetry.ts +47 -7
package/src/server/routes/[...slug].md.ts +0 -6
package/src/server/routes/[version]/llms.txt.ts +26 -0
package/src/server/routes/llms.txt.ts +10 -13
package/src/server/routes/og.tsx +2 -2
package/src/server/routes/sitemap.xml.ts +14 -6
package/src/server/vite-config.ts +5 -5
package/src/themes/default/ContentDirButtons.tsx +66 -0
package/src/themes/default/Layout.module.css +187 -40
package/src/themes/default/Layout.tsx +166 -65
package/src/themes/default/OpenInAI.tsx +112 -0
package/src/themes/default/Page.module.css +30 -0
package/src/themes/default/Page.tsx +1 -3
package/src/themes/default/SidebarLogo.tsx +26 -0
package/src/themes/default/Toc.module.css +102 -25
package/src/themes/default/Toc.tsx +56 -10
package/src/themes/default/VersionSwitcher.tsx +59 -0
package/src/themes/paper/ContentDirDropdown.tsx +47 -0
package/src/themes/paper/Layout.module.css +7 -0
package/src/themes/paper/Layout.tsx +20 -13
package/src/themes/paper/VersionSwitcher.tsx +60 -0
package/src/types/config.ts +146 -23
package/src/types/content.ts +11 -1
package/src/types/theme.ts +1 -0
package/src/components/ui/footer.module.css +0 -27
package/src/components/ui/footer.tsx +0 -30
package/src/server/api/metrics.ts +0 -23
package/src/server/api/page/index.ts +0 -1
package/src/server/telemetry.ts +0 -49

package/src/server/App.tsx CHANGED Viewed

@@ -1,49 +1,47 @@
 import '@raystack/apsara/normalize.css';
 import '@raystack/apsara/style.css';
 import { ThemeProvider } from '@raystack/apsara';
-import { useLocation } from 'react-router';
+import { Navigate, useLocation } from 'react-router';
 import { Head } from '@/lib/head';
 import { usePageContext } from '@/lib/page-context';
+import { resolveRoute, RouteType } from '@/lib/route-resolver';
 import { ApiLayout } from '@/pages/ApiLayout';
 import { ApiPage } from '@/pages/ApiPage';
 import { DocsLayout } from '@/pages/DocsLayout';
 import { DocsPage } from '@/pages/DocsPage';
+import { LandingPage } from '@/pages/LandingPage';
 import type { ChronicleConfig } from '@/types';
 import { getThemeConfig } from '@/themes/registry';
-function resolveRoute(pathname: string) {
-  if (pathname.startsWith('/apis')) {
-    const slug = pathname
-      .replace(/^\/apis\/?/, '')
-      .split('/')
-      .filter(Boolean);
-    return { type: 'api' as const, slug };
-  }
-  const slug =
-    pathname === '/' ? [] : pathname.slice(1).split('/').filter(Boolean);
-  return { type: 'docs' as const, slug };
-}
 export function App() {
   const { pathname } = useLocation();
   const { config } = usePageContext();
-  const route = resolveRoute(pathname);
+  const route = resolveRoute(pathname, config);
   const themeConfig = getThemeConfig(config.theme?.name);
+  if (route.type === RouteType.Redirect) {
+    return <Navigate to={route.to} replace />;
+  }
+  const isApi =
+    route.type === RouteType.ApiIndex || route.type === RouteType.ApiPage;
+  const apiSlug = route.type === RouteType.ApiPage ? route.slug : [];
+  const docsSlug = route.type === RouteType.DocsPage ? route.slug : [];
+  const isLanding = route.type === RouteType.DocsIndex;
   return (
     <ThemeProvider
       enableSystem={themeConfig.enableSystem}
       forcedTheme={themeConfig.forcedTheme}
     >
       <RootHead config={config} />
-      {route.type === 'api' ? (
+      {isApi ? (
         <ApiLayout>
-          <ApiPage slug={route.slug} />
+          <ApiPage slug={apiSlug} />
         </ApiLayout>
       ) : (
         <DocsLayout>
-          <DocsPage slug={route.slug} />
+          {isLanding ? <LandingPage /> : <DocsPage slug={docsSlug} />}
         </DocsLayout>
       )}
     </ThemeProvider>
@@ -53,16 +51,16 @@ export function App() {
 function RootHead({ config }: { config: ChronicleConfig }) {
   return (
     <Head
-      title={config.title}
-      description={config.description}
+      title={config.site.title}
+      description={config.site.description}
       config={config}
       jsonLd={
         config.url
           ? {
               '@context': 'https://schema.org',
               '@type': 'WebSite',
-              name: config.title,
-              description: config.description,
+              name: config.site.title,
+              description: config.site.description,
               url: config.url
             }
           : undefined

package/src/server/api/{page/[...slug].ts → page.ts} RENAMED Viewed

@@ -1,18 +1,22 @@
 import { defineHandler, HTTPError } from 'nitro';
-import { getPage, extractFrontmatter, getRelativePath, getOriginalPath } from '@/lib/source';
+import { getPage, getPageNav, extractFrontmatter, getRelativePath, getOriginalPath } from '@/lib/source';
 export default defineHandler(async event => {
-  const slugParam = event.context.params?.slug ?? '';
-  const slug = slugParam ? slugParam.split('/') : [];
+  const slugParam = event.url.searchParams.get('slug') ?? '';
+  const slug = slugParam ? slugParam.split(',').filter(Boolean) : [];
   const page = await getPage(slug);
   if (!page) {
     throw new HTTPError({ status: 404, message: 'Page not found' });
   }
+  const nav = await getPageNav(slug);
   return {
     frontmatter: extractFrontmatter(page, slug[slug.length - 1]),
     relativePath: getRelativePath(page),
     originalPath: getOriginalPath(page),
+    prev: nav.prev,
+    next: nav.next,
   };
 });

package/src/server/api/search.ts CHANGED Viewed

@@ -1,10 +1,11 @@
 import MiniSearch from 'minisearch';
-import { defineHandler } from 'nitro';
+import { defineHandler, HTTPError } from 'nitro';
 import type { OpenAPIV3 } from 'openapi-types';
 import { getSpecSlug } from '@/lib/api-routes';
-import { loadConfig } from '@/lib/config';
+import { getApiConfigsForVersion, loadConfig } from '@/lib/config';
 import { loadApiSpecs } from '@/lib/openapi';
-import { getPages, extractFrontmatter } from '@/lib/source';
+import { extractFrontmatter, getPagesForVersion } from '@/lib/source';
+import { LATEST_CONTEXT, type VersionContext } from '@/lib/version-source';
 interface SearchDocument {
   id: string;
@@ -14,8 +15,12 @@ interface SearchDocument {
   type: 'page' | 'api';
 }
-let searchIndex: MiniSearch<SearchDocument> | null = null;
-let cachedDocs: SearchDocument[] | null = null;
+const indexCache = new Map<string, MiniSearch<SearchDocument>>();
+const docsCache = new Map<string, SearchDocument[]>();
+function keyFor(ctx: VersionContext): string {
+  return ctx.dir ?? '__latest__';
+}
 function createIndex(docs: SearchDocument[]): MiniSearch<SearchDocument> {
   const index = new MiniSearch<SearchDocument>({
@@ -31,8 +36,8 @@ function createIndex(docs: SearchDocument[]): MiniSearch<SearchDocument> {
   return index;
 }
-async function scanContent(): Promise<SearchDocument[]> {
-  const pages = await getPages();
+async function scanContent(ctx: VersionContext): Promise<SearchDocument[]> {
+  const pages = await getPagesForVersion(ctx);
   return pages.map(p => {
     const fm = extractFrontmatter(p);
     return {
@@ -45,12 +50,13 @@ async function scanContent(): Promise<SearchDocument[]> {
   });
 }
-async function buildApiDocs(): Promise<SearchDocument[]> {
+async function buildApiDocs(ctx: VersionContext): Promise<SearchDocument[]> {
   const config = loadConfig();
-  if (!config.api?.length) return [];
+  const apiConfigs = getApiConfigsForVersion(config, ctx.dir);
+  if (!apiConfigs.length) return [];
   const docs: SearchDocument[] = [];
-  const specs = await loadApiSpecs(config.api);
+  const specs = await loadApiSpecs(apiConfigs);
   for (const spec of specs) {
     const specSlug = getSpecSlug(spec);
@@ -60,7 +66,7 @@ async function buildApiDocs(): Promise<SearchDocument[]> {
       for (const method of ['get', 'post', 'put', 'delete', 'patch'] as const) {
         const op = pathItem[method] as OpenAPIV3.OperationObject | undefined;
         if (!op?.operationId) continue;
-        const url = `/apis/${specSlug}/${encodeURIComponent(op.operationId)}`;
+        const url = `${ctx.urlPrefix}/apis/${specSlug}/${encodeURIComponent(op.operationId)}`;
         docs.push({
           id: url,
           url,
@@ -75,29 +81,50 @@ async function buildApiDocs(): Promise<SearchDocument[]> {
   return docs;
 }
-async function getDocs(): Promise<SearchDocument[]> {
-  if (cachedDocs) return cachedDocs;
+async function getDocs(ctx: VersionContext): Promise<SearchDocument[]> {
+  const key = keyFor(ctx);
+  const cached = docsCache.get(key);
+  if (cached) return cached;
   const [contentDocs, apiDocs] = await Promise.all([
-    scanContent(),
-    buildApiDocs()
+    scanContent(ctx),
+    buildApiDocs(ctx)
   ]);
-  cachedDocs = [...contentDocs, ...apiDocs];
-  return cachedDocs;
+  const docs = [...contentDocs, ...apiDocs];
+  docsCache.set(key, docs);
+  return docs;
+}
+async function getIndex(ctx: VersionContext): Promise<MiniSearch<SearchDocument>> {
+  const key = keyFor(ctx);
+  const cached = indexCache.get(key);
+  if (cached) return cached;
+  const docs = await getDocs(ctx);
+  const index = createIndex(docs);
+  indexCache.set(key, index);
+  return index;
 }
-async function getIndex(): Promise<MiniSearch<SearchDocument>> {
-  if (searchIndex) return searchIndex;
-  const docs = await getDocs();
-  searchIndex = createIndex(docs);
-  return searchIndex;
+function resolveCtx(tag: string | null): VersionContext {
+  if (!tag) return LATEST_CONTEXT;
+  const config = loadConfig();
+  const version = config.versions?.find(v => v.dir === tag);
+  if (!version) {
+    throw new HTTPError({
+      status: 400,
+      message: `Unknown version tag: ${tag}`,
+    });
+  }
+  return { dir: version.dir, urlPrefix: `/${version.dir}` };
 }
 export default defineHandler(async event => {
   const query = event.url.searchParams.get('query') ?? '';
-  const index = await getIndex();
+  const tag = event.url.searchParams.get('tag');
+  const ctx = resolveCtx(tag);
+  const index = await getIndex(ctx);
   if (!query) {
-    const docs = await getDocs();
+    const docs = await getDocs(ctx);
     return docs
       .filter(d => d.type === 'page')
       .slice(0, 8)

package/src/server/api/specs.ts CHANGED Viewed

@@ -1,9 +1,21 @@
-import { defineHandler } from 'nitro';
-import { loadConfig } from '@/lib/config';
+import { defineHandler, HTTPError } from 'nitro';
+import { getApiConfigsForVersion, loadConfig } from '@/lib/config';
 import { loadApiSpecs } from '@/lib/openapi';
-export default defineHandler(async () => {
+export default defineHandler(async event => {
+  const versionParam = event.url.searchParams.get('version');
+  const versionDir = versionParam === null || versionParam === '' ? null : versionParam;
   const config = loadConfig();
-  const specs = config.api?.length ? await loadApiSpecs(config.api) : [];
-  return specs;
+  if (versionDir && !config.versions?.some(v => v.dir === versionDir)) {
+    throw new HTTPError({
+      status: 400,
+      message: `Unknown version: ${versionDir}`,
+    });
+  }
+  const apiConfigs = getApiConfigsForVersion(config, versionDir);
+  if (!apiConfigs.length) return [];
+  return loadApiSpecs(apiConfigs);
 });

package/src/server/entry-client.tsx CHANGED Viewed

@@ -4,8 +4,11 @@ import { hydrateRoot } from 'react-dom/client';
 import { BrowserRouter } from 'react-router';
 import { ReactRouterProvider } from 'fumadocs-core/framework/react-router';
 import { mdxComponents } from '@/components/mdx';
+import { getApiConfigsForVersion } from '@/lib/config';
 import { PageProvider } from '@/lib/page-context';
-import type { ChronicleConfig, Frontmatter, Root, TableOfContents } from '@/types';
+import { resolveRoute, RouteType } from '@/lib/route-resolver';
+import { resolveVersionFromUrl, type VersionContext } from '@/lib/version-source';
+import type { ChronicleConfig, Frontmatter, PageNavLink, Root, TableOfContents } from '@/types';
 import type { ApiSpec } from '@/lib/openapi';
 import type { ReactNode } from 'react';
 import { App } from './App';
@@ -14,11 +17,19 @@ interface EmbeddedData {
   config: ChronicleConfig;
   tree: Root;
   slug: string[];
-  frontmatter: Frontmatter;
-  relativePath: string;
-  originalPath?: string;
+  version: VersionContext;
+  frontmatter: Frontmatter | null;
+  relativePath: string | null;
+  originalPath: string | null;
+  prev: PageNavLink | null;
+  next: PageNavLink | null;
 }
+const defaultConfig: ChronicleConfig = {
+  site: { title: 'Documentation' },
+  content: [{ dir: 'docs', label: 'Docs' }],
+};
 const contentModules = import.meta.glob<{ default?: React.ComponentType<any>; toc?: TableOfContents }>(
   '../../.content/**/*.{mdx,md}'
 );
@@ -43,23 +54,39 @@ async function hydrate() {
       window as unknown as { __PAGE_DATA__?: EmbeddedData }
     ).__PAGE_DATA__;
-    const config: ChronicleConfig = embedded?.config ?? {
-      title: 'Documentation'
-    };
+    const config: ChronicleConfig = embedded?.config ?? defaultConfig;
     const tree: Root = embedded?.tree ?? { name: 'root', children: [] };
-    const isApiPage =
-      window.location.pathname.startsWith('/apis') && !!config.api?.length;
-    const apiSpecs: ApiSpec[] = isApiPage
-      ? await fetch('/api/specs')
+    const route = resolveRoute(window.location.pathname, config);
+    // resolveVersionFromUrl always returns a valid context — even for redirect
+    // targets (e.g. /v1 -> /v1/docs) where route.version isn't on the union.
+    const routeVersion: VersionContext = resolveVersionFromUrl(
+      window.location.pathname,
+      config,
+    );
+    const version: VersionContext = embedded?.version ?? routeVersion;
+    const isApiRoute =
+      route.type === RouteType.ApiIndex || route.type === RouteType.ApiPage;
+    const apiConfigs = isApiRoute
+      ? getApiConfigsForVersion(config, routeVersion.dir)
+      : [];
+    const specsUrl = routeVersion.dir
+      ? `/api/specs?version=${encodeURIComponent(routeVersion.dir)}`
+      : '/api/specs';
+    const apiSpecs: ApiSpec[] = apiConfigs.length
+      ? await fetch(specsUrl)
           .then(r => r.json())
           .catch(() => [])
       : [];
     const mdxPath = embedded?.originalPath || embedded?.relativePath;
-    const page = mdxPath
+    const page = embedded && mdxPath && embedded.frontmatter
       ? {
-          slug: embedded!.slug,
-          frontmatter: embedded!.frontmatter,
+          slug: embedded.slug,
+          frontmatter: embedded.frontmatter,
+          prev: embedded.prev,
+          next: embedded.next,
           ...(await loadMdxModule(mdxPath)),
         }
       : null;
@@ -73,6 +100,7 @@ async function hydrate() {
             initialTree={tree}
             initialPage={page}
             initialApiSpecs={apiSpecs}
+            initialVersion={version}
             loadMdx={loadMdxModule}
           >
             <App />

package/src/server/entry-server.tsx CHANGED Viewed

@@ -5,12 +5,13 @@ import { renderToReadableStream } from 'react-dom/server.edge';
 import { StaticRouter } from 'react-router';
 import { ReactRouterProvider } from 'fumadocs-core/framework/react-router';
 import { mdxComponents } from '@/components/mdx';
-import { loadConfig } from '@/lib/config';
+import { getApiConfigsForVersion, loadConfig } from '@/lib/config';
 import { loadApiSpecs } from '@/lib/openapi';
 import { PageProvider } from '@/lib/page-context';
-import { getPageTree, getPage, loadPageModule, extractFrontmatter, getRelativePath, getOriginalPath } from '@/lib/source';
+import { resolveRoute, RouteType } from '@/lib/route-resolver';
+import { getPageTree, getPage, getPageNav, loadPageModule, extractFrontmatter, getRelativePath, getOriginalPath } from '@/lib/source';
+import { useNitroApp } from 'nitro/app';
 import { App } from './App';
-import { recordSSRRender } from './telemetry';
 import clientAssets from './entry-client?assets=client';
 import serverAssets from './entry-server?assets=ssr';
@@ -19,17 +20,32 @@ export default {
   async fetch(req: Request) {
     const url = new URL(req.url);
     const pathname = url.pathname;
-    const slug = pathname === '/' ? [] : pathname.slice(1).split('/').filter(Boolean);
     const config = loadConfig();
-    const apiSpecs = config.api?.length
-      ? await loadApiSpecs(config.api).catch(() => [])
+    const route = resolveRoute(pathname, config);
+    if (route.type === RouteType.Redirect) {
+      // biome-ignore lint/correctness/useHookAtTopLevel: useNitroApp is a Nitro DI accessor, not a React hook
+      useNitroApp().hooks.callHook('chronicle:ssr-rendered', pathname, route.status, 0);
+      return new Response(null, {
+        status: route.status,
+        headers: { Location: route.to },
+      });
+    }
+    const isApiRoute = route.type === RouteType.ApiIndex || route.type === RouteType.ApiPage;
+    const pageSlug = route.type === RouteType.DocsPage ? route.slug : [];
+    const apiConfigs = isApiRoute
+      ? getApiConfigsForVersion(config, route.version.dir)
       : [];
+    const apiSpecs = apiConfigs.length ? await loadApiSpecs(apiConfigs) : [];
     const [tree, page] = await Promise.all([
       getPageTree(),
-      getPage(slug),
+      route.type === RouteType.DocsPage ? getPage(route.slug) : Promise.resolve(null),
     ]);
+    const nav = page ? await getPageNav(pageSlug, tree) : { prev: null, next: null };
     const relativePath = page ? getRelativePath(page) : null;
     const originalPath = page ? getOriginalPath(page) : null;
@@ -37,22 +53,27 @@ export default {
     const pageData = page
       ? {
-          slug,
-          frontmatter: extractFrontmatter(page, slug[slug.length - 1]),
+          slug: pageSlug,
+          frontmatter: extractFrontmatter(page, pageSlug[pageSlug.length - 1]),
           content: mdxModule?.default
             ? React.createElement(mdxModule.default, { components: mdxComponents })
             : null,
           toc: mdxModule?.toc ?? [],
+          prev: nav.prev,
+          next: nav.next,
         }
       : null;
     const embeddedData = {
       config,
       tree,
-      slug,
+      slug: pageSlug,
+      version: route.version,
       frontmatter: pageData?.frontmatter ?? null,
       relativePath,
       originalPath,
+      prev: pageData?.prev ?? null,
+      next: pageData?.next ?? null,
     };
     const safeJson = JSON.stringify(embeddedData).replace(/</g, '\\u003c');
@@ -82,6 +103,7 @@ export default {
                   initialTree={tree}
                   initialPage={pageData}
                   initialApiSpecs={apiSpecs}
+                  initialVersion={route.version}
                   loadMdx={async () => ({ content: null, toc: [] })}
                 >
                   <App />
@@ -95,10 +117,10 @@ export default {
     const renderDuration = performance.now() - renderStart;
-    const isApiRoute = pathname.startsWith('/apis');
-    const status = !page && !isApiRoute && slug.length > 0 ? 404 : 200;
+    const status = route.type === RouteType.DocsPage && !page ? 404 : 200;
-    recordSSRRender(pathname, status, renderDuration);
+    // biome-ignore lint/correctness/useHookAtTopLevel: useNitroApp is a Nitro DI accessor, not a React hook
+    useNitroApp().hooks.callHook('chronicle:ssr-rendered', pathname, status, renderDuration);
     return new Response(stream, {
       status,

package/src/server/plugins/telemetry.ts CHANGED Viewed

@@ -1,21 +1,61 @@
+import type { Counter, Histogram } from '@opentelemetry/api'
+import { MeterProvider } from '@opentelemetry/sdk-metrics'
+import { PrometheusExporter } from '@opentelemetry/exporter-prometheus'
+import { resourceFromAttributes } from '@opentelemetry/resources'
+import { ATTR_SERVICE_NAME } from '@opentelemetry/semantic-conventions'
+import type { H3Event } from 'h3'
 import { definePlugin } from 'nitro'
 import { loadConfig } from '@/lib/config'
-import { initTelemetry, recordRequest } from '../telemetry'
+declare module 'nitro/types' {
+  interface NitroRuntimeHooks {
+    'chronicle:ssr-rendered': (route: string, status: number, durationMs: number) => void
+  }
+}
 export default definePlugin((nitroApp) => {
   const config = loadConfig()
   if (!config.telemetry?.enabled) return
-  initTelemetry(config)
+  const resource = resourceFromAttributes({
+    [ATTR_SERVICE_NAME]: config.telemetry?.serviceName ?? 'chronicle',
+  })
+  const port = config.telemetry?.port ?? 9090
+  const exporter = new PrometheusExporter({ port })
+  const provider = new MeterProvider({ resource, readers: [exporter] })
+  const meter = provider.getMeter('chronicle')
+  const requestCounter: Counter = meter.createCounter('http_server_request_total', {
+    description: 'Total HTTP requests',
+  })
+  const requestDuration: Histogram = meter.createHistogram('http_server_request_duration_ms', {
+    description: 'HTTP request duration in ms',
+  })
+  const ssrRenderDuration: Histogram = meter.createHistogram('http_server_ssr_render_duration_ms', {
+    description: 'SSR render duration in ms',
+  })
+  nitroApp.hooks.hook('close', async () => {
+    await provider.shutdown()
+    await exporter.shutdown()
+  })
+  nitroApp.hooks.hook('chronicle:ssr-rendered', (route, status, durationMs) => {
+    ssrRenderDuration.record(durationMs, { route, status })
+  })
   nitroApp.hooks.hook('request', (event) => {
-    if (event.path === '/api/metrics') return
-    event.context._requestStart = performance.now()
+    (event as H3Event).context._requestStart = performance.now()
   })
   nitroApp.hooks.hook('response', (res, event) => {
-    if (!event.context._requestStart) return
-    const duration = performance.now() - event.context._requestStart
-    recordRequest(event.method, event.path, res.status, duration)
+    const start = (event as H3Event).context._requestStart as number | undefined
+    if (start === undefined) return
+    const duration = performance.now() - start
+    const method = event.req.method
+    const route = new URL(event.req.url).pathname
+    requestCounter.add(1, { method, route, status: res.status })
+    requestDuration.record(duration, { method, route, status: res.status })
   })
 })

package/src/server/routes/[...slug].md.ts CHANGED Viewed

@@ -1,7 +1,6 @@
 import fs from 'node:fs/promises';
 import matter from 'gray-matter';
 import { defineHandler, HTTPError } from 'nitro';
-import { loadConfig } from '@/lib/config';
 import { getPage, getOriginalPath } from '@/lib/source';
 import { safePath } from '@/server/utils/safe-path';
@@ -9,11 +8,6 @@ export default defineHandler(async event => {
   const pathname = event.path || event.req.url?.split('?')[0] || '';
   if (!pathname.endsWith('.md')) return;
-  const config = loadConfig();
-  if (!config.llms?.enabled) {
-    throw new HTTPError({ status: 404, message: 'Not Found' });
-  }
   const stripped = pathname.replace(/\.md$/, '');
   const parts = stripped === '/index' || stripped === '/'
     ? []

package/src/server/routes/[version]/llms.txt.ts ADDED Viewed

@@ -0,0 +1,26 @@
+import { getRouterParam } from 'h3';
+import { defineHandler, HTTPError } from 'nitro';
+import { loadConfig } from '@/lib/config';
+import { buildLlmsTxt } from '@/lib/llms';
+import { extractFrontmatter, getPagesForVersion } from '@/lib/source';
+export default defineHandler(async event => {
+  const config = loadConfig();
+  const versionDir = getRouterParam(event, 'version');
+  const version = config.versions?.find(v => v.dir === versionDir);
+  if (!version) {
+    throw new HTTPError({ status: 404, message: 'Not Found' });
+  }
+  const ctx = { dir: version.dir, urlPrefix: `/${version.dir}` };
+  const pages = await getPagesForVersion(ctx);
+  const body = buildLlmsTxt(
+    config,
+    pages.map(p => ({ url: p.url, title: extractFrontmatter(p).title })),
+    ctx,
+  );
+  event.res.headers.set('Content-Type', 'text/plain');
+  return body;
+});

package/src/server/routes/llms.txt.ts CHANGED Viewed

@@ -1,21 +1,18 @@
-import { defineHandler, HTTPError } from 'nitro';
+import { defineHandler } from 'nitro';
 import { loadConfig } from '@/lib/config';
-import { getPages, extractFrontmatter } from '@/lib/source';
+import { buildLlmsTxt } from '@/lib/llms';
+import { extractFrontmatter, getPagesForVersion } from '@/lib/source';
+import { LATEST_CONTEXT } from '@/lib/version-source';
 export default defineHandler(async event => {
   const config = loadConfig();
-  if (!config.llms?.enabled) {
-    throw new HTTPError({ status: 404, message: 'Not Found' });
-  }
-  const pages = await getPages();
-  const index = pages.map(p => {
-    const fm = extractFrontmatter(p);
-    const mdUrl = p.url === '/' ? '/index.md' : `${p.url}.md`;
-    return `- [${fm.title}](${mdUrl})`;
-  }).join('\n');
-  const body = `# ${config.title}\n\n${config.description ?? ''}\n\n${index}`;
+  const pages = await getPagesForVersion(LATEST_CONTEXT);
+  const body = buildLlmsTxt(
+    config,
+    pages.map(p => ({ url: p.url, title: extractFrontmatter(p).title })),
+    LATEST_CONTEXT,
+  );
   event.res.headers.set('Content-Type', 'text/plain');
   return body;

package/src/server/routes/og.tsx CHANGED Viewed

@@ -22,9 +22,9 @@ async function loadFont(): Promise<ArrayBuffer> {
 export default defineHandler(async event => {
   const config = loadConfig();
-  const title = event.url.searchParams.get('title') ?? config.title;
+  const title = event.url.searchParams.get('title') ?? config.site.title;
   const description = event.url.searchParams.get('description') ?? '';
-  const siteName = config.title;
+  const siteName = config.site.title;
   const font = await loadFont();

package/src/server/routes/sitemap.xml.ts CHANGED Viewed

@@ -1,6 +1,6 @@
 import { defineHandler } from 'nitro';
 import { buildApiRoutes } from '@/lib/api-routes';
-import { loadConfig } from '@/lib/config';
+import { getAllVersions, getApiConfigsForVersion, loadConfig } from '@/lib/config';
 import { loadApiSpecs } from '@/lib/openapi';
 import { getPages } from '@/lib/source';
@@ -23,11 +23,19 @@ export default defineHandler(async event => {
     return `<url><loc>${baseUrl}/${page.slugs.join('/')}</loc>${lastmod}</url>`;
   });
-  const apiPages = config.api?.length
-    ? buildApiRoutes(await loadApiSpecs(config.api)).map(
-        route => `<url><loc>${baseUrl}/apis/${route.slug.join('/')}</loc></url>`
-      )
-    : [];
+  const apiPages: string[] = [];
+  for (const v of getAllVersions(config)) {
+    const versionDir = v.isLatest ? null : v.dir;
+    const apiConfigs = getApiConfigsForVersion(config, versionDir);
+    if (!apiConfigs.length) continue;
+    const prefix = versionDir ? `/${versionDir}` : '';
+    const routes = buildApiRoutes(await loadApiSpecs(apiConfigs));
+    for (const route of routes) {
+      apiPages.push(
+        `<url><loc>${baseUrl}${prefix}/apis/${route.slug.join('/')}</loc></url>`,
+      );
+    }
+  }
   const xml = `<?xml version="1.0" encoding="UTF-8"?>
 <urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">