@btst/stack 3.0.0-rc.2 → 3.0.0-rc.4

package/dist/packages/stack/src/plugins/route-docs/client/plugin.cjs

@@ -3,41 +3,37 @@
 const jsxRuntime = require('react/jsx-runtime');
 const React = require('react');
 const client = require('@btst/stack/plugins/client');
+const client$1 = require('@btst/stack/client');
 const yar = require('@btst/yar');
+const reactQuery = require('@tanstack/react-query');
 const generator = require('../generator.cjs');
+const constants = require('./constants.cjs');
+const schema = require('./schema.cjs');
 
 const DocsPageComponent = React.lazy(
-  () => import('./components/pages/docs-page.cjs').then((m) => ({
-    default: m.DocsPageComponent
+  () => import('./components/pages/docs-page.cjs').then((module) => ({
+    default: module.DocsPageComponent
   }))
 );
 const DocsPageSkeleton = React.lazy(
-  () => import('./components/loading/docs-skeleton.cjs').then((m) => ({
-    default: m.DocsPageSkeleton
+  () => import('./components/loading/docs-skeleton.cjs').then((module) => ({
+    default: module.DocsPageSkeleton
   }))
 );
 const ROUTE_DOCS_QUERY_KEY = ["route-docs", "schema"];
-let moduleStoredContext = null;
-function getStoredContext() {
-  return moduleStoredContext;
-}
-function getRegisteredRoutes() {
-  if (!moduleStoredContext) return [];
+const ROUTE_DOCS_KEY_RESOLUTION = ["route-docs", "schema-key"];
+function getRegisteredRoutes(context) {
+  if (!context) return [];
   const result = [];
-  for (const [pluginKey, plugin] of Object.entries(
-    moduleStoredContext.plugins
-  )) {
-    if (pluginKey === "routeDocs" || plugin.name === "route-docs") continue;
+  for (const [pluginKey, plugin] of Object.entries(context.plugins)) {
+    const pluginId = plugin.id;
+    if (pluginId === constants.ROUTE_DOCS_PLUGIN_ID) continue;
     try {
-      const routes = plugin.routes(moduleStoredContext);
+      const routes = plugin.routes(context);
       for (const [routeKey, route] of Object.entries(routes)) {
-        const path = route?.path;
-        if (path) {
-          result.push({
-            path,
-            plugin: plugin.name || pluginKey,
-            key: routeKey
-          });
+        const path = route.path;
+        if (typeof path === "string" && path.length > 0) {
+          result.push({ path, plugin: pluginId, key: routeKey });
         }
       }
     } catch {
@@ -45,29 +41,89 @@ function getRegisteredRoutes() {
   }
   return result;
 }
-async function generateSchema() {
-  if (!moduleStoredContext) {
-    return {
-      plugins: [],
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      allSitemapEntries: []
-    };
+const resolvedSchemaKeysByContext = /* @__PURE__ */ new WeakMap();
+const contextFallbackKeysByQueryClient = /* @__PURE__ */ new WeakMap();
+function createRouteDocsBaseFingerprint(config, context) {
+  const schemaInputs = context ? generator.generateRouteDocsSchema(context, []).plugins.map(
+    ({ sitemapEntries: _sitemapEntries, ...plugin }) => plugin
+  ) : [];
+  const registrations = context ? Object.entries(context.plugins).map(([key, plugin]) => ({
+    key,
+    id: plugin.id
+  })).sort((left, right) => left.key.localeCompare(right.key)) : [];
+  return reactQuery.hashKey([
+    {
+      basePath: context?.basePath ?? null,
+      siteBaseURL: config.siteBaseURL,
+      siteBasePath: config.siteBasePath,
+      registrations,
+      schemaInputs
+    }
+  ]);
+}
+function createSchemaQueryKey(fingerprint) {
+  return [...ROUTE_DOCS_QUERY_KEY, fingerprint];
+}
+function createSchemaKeyResolutionQueryKey(baseFingerprint) {
+  return [...ROUTE_DOCS_KEY_RESOLUTION, baseFingerprint];
+}
+function getContextFallbackKey(queryClient, context) {
+  let state = contextFallbackKeysByQueryClient.get(queryClient);
+  if (!state) {
+    state = { nextKey: 0, keys: /* @__PURE__ */ new WeakMap() };
+    contextFallbackKeysByQueryClient.set(queryClient, state);
+  }
+  let key = state.keys.get(context);
+  if (key === void 0) {
+    key = state.nextKey++;
+    state.keys.set(context, key);
   }
-  try {
-    const sitemapEntries = await generator.fetchAllSitemapEntries(moduleStoredContext);
-    return generator.generateRouteDocsSchema(moduleStoredContext, sitemapEntries);
-  } catch (error) {
-    console.warn("Failed to generate route docs schema:", error);
-    return generator.generateRouteDocsSchema(moduleStoredContext, []);
+  return key;
+}
+function resolveRouteDocsQueryKey(config, context) {
+  const baseFingerprint = createRouteDocsBaseFingerprint(config, context);
+  const aliases = config.queryClient.getQueryData(
+    createSchemaKeyResolutionQueryKey(baseFingerprint)
+  );
+  const resolvedFingerprint = context ? resolvedSchemaKeysByContext.get(context) ?? (aliases?.length === 1 ? aliases[0] : void 0) : void 0;
+  if (resolvedFingerprint) return createSchemaQueryKey(resolvedFingerprint);
+  if (context) {
+    return createSchemaQueryKey(
+      reactQuery.hashKey([
+        {
+          baseFingerprint,
+          contextFallback: getContextFallbackKey(config.queryClient, context)
+        }
+      ])
+    );
   }
+  return createSchemaQueryKey(baseFingerprint);
+}
+function resolveRouteDocsClientConfig(config, runtime) {
+  return {
+    title: config.title,
+    description: config.description,
+    pageComponents: config.pageComponents,
+    queryClient: runtime.queryClient,
+    siteBaseURL: runtime.site.baseURL,
+    siteBasePath: runtime.site.basePath
+  };
 }
 function createDocsMeta(config) {
   return () => {
-    const title = config.title || "Route Documentation";
+    const title = config.title ?? "Route Documentation";
+    const description = config.description ?? "Documentation for all client routes in your application";
+    const sitePath = client$1.normalizePath(
+      [config.siteBasePath, "/route-docs"].join("/")
+    );
     return [
       { title },
       { name: "title", content: title },
-      { name: "robots", content: "noindex" }
+      { name: "description", content: description },
+      { name: "robots", content: "noindex" },
+      { property: "og:title", content: title },
+      { property: "og:description", content: description },
+      { property: "og:url", content: `${config.siteBaseURL}${sitePath}` }
     ];
   };
 }
@@ -77,58 +133,70 @@ function DocsErrorComponent() {
     /* @__PURE__ */ jsxRuntime.jsx("p", { className: "text-muted-foreground", children: "An error occurred while loading the documentation." })
   ] }) });
 }
-function createRouteDocsLoader(config) {
+function createRouteDocsLoader(config, context) {
   return async () => {
-    if (typeof window === "undefined" && moduleStoredContext) {
-      const { queryClient } = config;
-      try {
-        const sitemapEntries = await generator.fetchAllSitemapEntries(moduleStoredContext);
-        const schema = generator.generateRouteDocsSchema(
-          moduleStoredContext,
-          sitemapEntries
-        );
-        queryClient.setQueryData(ROUTE_DOCS_QUERY_KEY, schema);
-      } catch (error) {
-        console.warn("Failed to load route docs schema:", error);
-        queryClient.setQueryData(ROUTE_DOCS_QUERY_KEY, {
-          plugins: [],
-          generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-          allSitemapEntries: []
-        });
-      }
+    if (typeof window !== "undefined" || !context) return;
+    try {
+      const sitemapEntries = await generator.fetchAllSitemapEntries(context);
+      const schema = generator.generateRouteDocsSchema(context, sitemapEntries);
+      const baseFingerprint = createRouteDocsBaseFingerprint(config, context);
+      const resolvedFingerprint = reactQuery.hashKey([
+        { baseFingerprint, sitemapEntries }
+      ]);
+      const queryKey = createSchemaQueryKey(resolvedFingerprint);
+      resolvedSchemaKeysByContext.set(context, resolvedFingerprint);
+      config.queryClient.setQueryData(
+        createSchemaKeyResolutionQueryKey(baseFingerprint),
+        (previous = []) => previous.includes(resolvedFingerprint) ? previous : [...previous, resolvedFingerprint]
+      );
+      config.queryClient.setQueryData(queryKey, schema);
+    } catch (error) {
+      console.warn("Failed to load route docs schema:", error);
+      const queryKey = resolveRouteDocsQueryKey(config, context);
+      config.queryClient.setQueryData(
+        queryKey,
+        schema.createEmptySchema()
+      );
     }
   };
 }
-const routeDocsClientPlugin = (config) => {
-  return client.defineClientPlugin({
-    name: "route-docs",
+function createResolvedRouteDocsPlugin(config) {
+  return {
     routes: (context) => {
-      moduleStoredContext = context || null;
+      const resolvedContext = context ?? null;
       return {
         docs: yar.defineRoute("/route-docs", {
-          page: () => /* @__PURE__ */ jsxRuntime.jsx(
-            DocsPageComponent,
-            {
-              title: config.title,
-              description: config.description,
-              siteBasePath: config.siteBasePath || "/pages"
-            }
-          ),
+          page: () => {
+            const PageComponent = config.pageComponents?.docs ?? DocsPageComponent;
+            return /* @__PURE__ */ jsxRuntime.jsx(
+              PageComponent,
+              {
+                title: config.title,
+                description: config.description,
+                siteBaseURL: config.siteBaseURL,
+                siteBasePath: config.siteBasePath,
+                queryKey: resolveRouteDocsQueryKey(config, resolvedContext)
+              }
+            );
+          },
           loading: DocsPageSkeleton,
           error: DocsErrorComponent,
-          loader: createRouteDocsLoader(config),
+          loader: createRouteDocsLoader(config, resolvedContext),
           meta: createDocsMeta(config)
         })
       };
     },
-    sitemap: async () => {
-      return [];
-    }
-  });
-};
+    sitemap: () => []
+  };
+}
+const routeDocsClientPlugin = (config = {}) => client.defineClientPlugin({
+  id: constants.ROUTE_DOCS_PLUGIN_ID,
+  resolve: (runtime) => createResolvedRouteDocsPlugin(
+    resolveRouteDocsClientConfig(config, runtime)
+  )
+});
 
+exports.generateSchema = schema.generateSchema;
 exports.ROUTE_DOCS_QUERY_KEY = ROUTE_DOCS_QUERY_KEY;
-exports.generateSchema = generateSchema;
 exports.getRegisteredRoutes = getRegisteredRoutes;
-exports.getStoredContext = getStoredContext;
 exports.routeDocsClientPlugin = routeDocsClientPlugin;

package/dist/packages/stack/src/plugins/route-docs/client/plugin.mjs

@@ -1,41 +1,38 @@
 import { jsx, jsxs } from 'react/jsx-runtime';
 import { lazy } from 'react';
 import { defineClientPlugin } from '@btst/stack/plugins/client';
+import { normalizePath } from '@btst/stack/client';
 import { defineRoute } from '@btst/yar';
+import { hashKey } from '@tanstack/react-query';
 import { fetchAllSitemapEntries, generateRouteDocsSchema } from '../generator.mjs';
+import { ROUTE_DOCS_PLUGIN_ID } from './constants.mjs';
+import { createEmptySchema } from './schema.mjs';
+export { generateSchema } from './schema.mjs';
 
 const DocsPageComponent = lazy(
-  () => import('./components/pages/docs-page.mjs').then((m) => ({
-    default: m.DocsPageComponent
+  () => import('./components/pages/docs-page.mjs').then((module) => ({
+    default: module.DocsPageComponent
   }))
 );
 const DocsPageSkeleton = lazy(
-  () => import('./components/loading/docs-skeleton.mjs').then((m) => ({
-    default: m.DocsPageSkeleton
+  () => import('./components/loading/docs-skeleton.mjs').then((module) => ({
+    default: module.DocsPageSkeleton
   }))
 );
 const ROUTE_DOCS_QUERY_KEY = ["route-docs", "schema"];
-let moduleStoredContext = null;
-function getStoredContext() {
-  return moduleStoredContext;
-}
-function getRegisteredRoutes() {
-  if (!moduleStoredContext) return [];
+const ROUTE_DOCS_KEY_RESOLUTION = ["route-docs", "schema-key"];
+function getRegisteredRoutes(context) {
+  if (!context) return [];
   const result = [];
-  for (const [pluginKey, plugin] of Object.entries(
-    moduleStoredContext.plugins
-  )) {
-    if (pluginKey === "routeDocs" || plugin.name === "route-docs") continue;
+  for (const [pluginKey, plugin] of Object.entries(context.plugins)) {
+    const pluginId = plugin.id;
+    if (pluginId === ROUTE_DOCS_PLUGIN_ID) continue;
     try {
-      const routes = plugin.routes(moduleStoredContext);
+      const routes = plugin.routes(context);
       for (const [routeKey, route] of Object.entries(routes)) {
-        const path = route?.path;
-        if (path) {
-          result.push({
-            path,
-            plugin: plugin.name || pluginKey,
-            key: routeKey
-          });
+        const path = route.path;
+        if (typeof path === "string" && path.length > 0) {
+          result.push({ path, plugin: pluginId, key: routeKey });
         }
       }
     } catch {
@@ -43,29 +40,89 @@ function getRegisteredRoutes() {
   }
   return result;
 }
-async function generateSchema() {
-  if (!moduleStoredContext) {
-    return {
-      plugins: [],
-      generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-      allSitemapEntries: []
-    };
+const resolvedSchemaKeysByContext = /* @__PURE__ */ new WeakMap();
+const contextFallbackKeysByQueryClient = /* @__PURE__ */ new WeakMap();
+function createRouteDocsBaseFingerprint(config, context) {
+  const schemaInputs = context ? generateRouteDocsSchema(context, []).plugins.map(
+    ({ sitemapEntries: _sitemapEntries, ...plugin }) => plugin
+  ) : [];
+  const registrations = context ? Object.entries(context.plugins).map(([key, plugin]) => ({
+    key,
+    id: plugin.id
+  })).sort((left, right) => left.key.localeCompare(right.key)) : [];
+  return hashKey([
+    {
+      basePath: context?.basePath ?? null,
+      siteBaseURL: config.siteBaseURL,
+      siteBasePath: config.siteBasePath,
+      registrations,
+      schemaInputs
+    }
+  ]);
+}
+function createSchemaQueryKey(fingerprint) {
+  return [...ROUTE_DOCS_QUERY_KEY, fingerprint];
+}
+function createSchemaKeyResolutionQueryKey(baseFingerprint) {
+  return [...ROUTE_DOCS_KEY_RESOLUTION, baseFingerprint];
+}
+function getContextFallbackKey(queryClient, context) {
+  let state = contextFallbackKeysByQueryClient.get(queryClient);
+  if (!state) {
+    state = { nextKey: 0, keys: /* @__PURE__ */ new WeakMap() };
+    contextFallbackKeysByQueryClient.set(queryClient, state);
+  }
+  let key = state.keys.get(context);
+  if (key === void 0) {
+    key = state.nextKey++;
+    state.keys.set(context, key);
   }
-  try {
-    const sitemapEntries = await fetchAllSitemapEntries(moduleStoredContext);
-    return generateRouteDocsSchema(moduleStoredContext, sitemapEntries);
-  } catch (error) {
-    console.warn("Failed to generate route docs schema:", error);
-    return generateRouteDocsSchema(moduleStoredContext, []);
+  return key;
+}
+function resolveRouteDocsQueryKey(config, context) {
+  const baseFingerprint = createRouteDocsBaseFingerprint(config, context);
+  const aliases = config.queryClient.getQueryData(
+    createSchemaKeyResolutionQueryKey(baseFingerprint)
+  );
+  const resolvedFingerprint = context ? resolvedSchemaKeysByContext.get(context) ?? (aliases?.length === 1 ? aliases[0] : void 0) : void 0;
+  if (resolvedFingerprint) return createSchemaQueryKey(resolvedFingerprint);
+  if (context) {
+    return createSchemaQueryKey(
+      hashKey([
+        {
+          baseFingerprint,
+          contextFallback: getContextFallbackKey(config.queryClient, context)
+        }
+      ])
+    );
   }
+  return createSchemaQueryKey(baseFingerprint);
+}
+function resolveRouteDocsClientConfig(config, runtime) {
+  return {
+    title: config.title,
+    description: config.description,
+    pageComponents: config.pageComponents,
+    queryClient: runtime.queryClient,
+    siteBaseURL: runtime.site.baseURL,
+    siteBasePath: runtime.site.basePath
+  };
 }
 function createDocsMeta(config) {
   return () => {
-    const title = config.title || "Route Documentation";
+    const title = config.title ?? "Route Documentation";
+    const description = config.description ?? "Documentation for all client routes in your application";
+    const sitePath = normalizePath(
+      [config.siteBasePath, "/route-docs"].join("/")
+    );
     return [
       { title },
       { name: "title", content: title },
-      { name: "robots", content: "noindex" }
+      { name: "description", content: description },
+      { name: "robots", content: "noindex" },
+      { property: "og:title", content: title },
+      { property: "og:description", content: description },
+      { property: "og:url", content: `${config.siteBaseURL}${sitePath}` }
     ];
   };
 }
@@ -75,54 +132,67 @@ function DocsErrorComponent() {
     /* @__PURE__ */ jsx("p", { className: "text-muted-foreground", children: "An error occurred while loading the documentation." })
   ] }) });
 }
-function createRouteDocsLoader(config) {
+function createRouteDocsLoader(config, context) {
   return async () => {
-    if (typeof window === "undefined" && moduleStoredContext) {
-      const { queryClient } = config;
-      try {
-        const sitemapEntries = await fetchAllSitemapEntries(moduleStoredContext);
-        const schema = generateRouteDocsSchema(
-          moduleStoredContext,
-          sitemapEntries
-        );
-        queryClient.setQueryData(ROUTE_DOCS_QUERY_KEY, schema);
-      } catch (error) {
-        console.warn("Failed to load route docs schema:", error);
-        queryClient.setQueryData(ROUTE_DOCS_QUERY_KEY, {
-          plugins: [],
-          generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
-          allSitemapEntries: []
-        });
-      }
+    if (typeof window !== "undefined" || !context) return;
+    try {
+      const sitemapEntries = await fetchAllSitemapEntries(context);
+      const schema = generateRouteDocsSchema(context, sitemapEntries);
+      const baseFingerprint = createRouteDocsBaseFingerprint(config, context);
+      const resolvedFingerprint = hashKey([
+        { baseFingerprint, sitemapEntries }
+      ]);
+      const queryKey = createSchemaQueryKey(resolvedFingerprint);
+      resolvedSchemaKeysByContext.set(context, resolvedFingerprint);
+      config.queryClient.setQueryData(
+        createSchemaKeyResolutionQueryKey(baseFingerprint),
+        (previous = []) => previous.includes(resolvedFingerprint) ? previous : [...previous, resolvedFingerprint]
+      );
+      config.queryClient.setQueryData(queryKey, schema);
+    } catch (error) {
+      console.warn("Failed to load route docs schema:", error);
+      const queryKey = resolveRouteDocsQueryKey(config, context);
+      config.queryClient.setQueryData(
+        queryKey,
+        createEmptySchema()
+      );
     }
   };
 }
-const routeDocsClientPlugin = (config) => {
-  return defineClientPlugin({
-    name: "route-docs",
+function createResolvedRouteDocsPlugin(config) {
+  return {
     routes: (context) => {
-      moduleStoredContext = context || null;
+      const resolvedContext = context ?? null;
       return {
         docs: defineRoute("/route-docs", {
-          page: () => /* @__PURE__ */ jsx(
-            DocsPageComponent,
-            {
-              title: config.title,
-              description: config.description,
-              siteBasePath: config.siteBasePath || "/pages"
-            }
-          ),
+          page: () => {
+            const PageComponent = config.pageComponents?.docs ?? DocsPageComponent;
+            return /* @__PURE__ */ jsx(
+              PageComponent,
+              {
+                title: config.title,
+                description: config.description,
+                siteBaseURL: config.siteBaseURL,
+                siteBasePath: config.siteBasePath,
+                queryKey: resolveRouteDocsQueryKey(config, resolvedContext)
+              }
+            );
+          },
           loading: DocsPageSkeleton,
           error: DocsErrorComponent,
-          loader: createRouteDocsLoader(config),
+          loader: createRouteDocsLoader(config, resolvedContext),
           meta: createDocsMeta(config)
         })
       };
     },
-    sitemap: async () => {
-      return [];
-    }
-  });
-};
+    sitemap: () => []
+  };
+}
+const routeDocsClientPlugin = (config = {}) => defineClientPlugin({
+  id: ROUTE_DOCS_PLUGIN_ID,
+  resolve: (runtime) => createResolvedRouteDocsPlugin(
+    resolveRouteDocsClientConfig(config, runtime)
+  )
+});
 
-export { ROUTE_DOCS_QUERY_KEY, generateSchema, getRegisteredRoutes, getStoredContext, routeDocsClientPlugin };
+export { ROUTE_DOCS_QUERY_KEY, getRegisteredRoutes, routeDocsClientPlugin };

package/dist/packages/stack/src/plugins/route-docs/client/schema.cjs

@@ -0,0 +1,26 @@
+'use strict';
+
+const generator = require('../generator.cjs');
+
+function createEmptySchema() {
+  return {
+    plugins: [],
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    allSitemapEntries: []
+  };
+}
+async function generateSchema(context) {
+  if (!context) {
+    return createEmptySchema();
+  }
+  try {
+    const sitemapEntries = await generator.fetchAllSitemapEntries(context);
+    return generator.generateRouteDocsSchema(context, sitemapEntries);
+  } catch (error) {
+    console.warn("Failed to generate route docs schema:", error);
+    return generator.generateRouteDocsSchema(context, []);
+  }
+}
+
+exports.createEmptySchema = createEmptySchema;
+exports.generateSchema = generateSchema;

package/dist/packages/stack/src/plugins/route-docs/client/schema.mjs

@@ -0,0 +1,23 @@
+import { fetchAllSitemapEntries, generateRouteDocsSchema } from '../generator.mjs';
+
+function createEmptySchema() {
+  return {
+    plugins: [],
+    generatedAt: (/* @__PURE__ */ new Date()).toISOString(),
+    allSitemapEntries: []
+  };
+}
+async function generateSchema(context) {
+  if (!context) {
+    return createEmptySchema();
+  }
+  try {
+    const sitemapEntries = await fetchAllSitemapEntries(context);
+    return generateRouteDocsSchema(context, sitemapEntries);
+  } catch (error) {
+    console.warn("Failed to generate route docs schema:", error);
+    return generateRouteDocsSchema(context, []);
+  }
+}
+
+export { createEmptySchema, generateSchema };

package/dist/packages/stack/src/plugins/route-docs/generator.cjs

@@ -1,5 +1,6 @@
 'use strict';
 
+const constants = require('./client/constants.cjs');
 const z = require('zod');
 
 function _interopNamespaceCompat(e) {
@@ -169,7 +170,8 @@ function extractQueryParams(querySchema) {
 async function fetchAllSitemapEntries(context) {
   const allEntries = [];
   for (const [pluginKey, plugin] of Object.entries(context.plugins)) {
-    if (pluginKey === "routeDocs" || plugin.name === "route-docs") {
+    const pluginId = plugin.id;
+    if (pluginId === constants.ROUTE_DOCS_PLUGIN_ID) {
       continue;
     }
     if (plugin.sitemap) {
@@ -190,7 +192,7 @@ async function fetchAllSitemapEntries(context) {
 }
 function generateRouteDocsSchema(context, sitemapEntries = []) {
   const documentedPlugins = [];
-  const sitemapByPlugin = {};
+  const sitemapByPlugin = /* @__PURE__ */ Object.create(null);
   for (const entry of sitemapEntries) {
     if (!sitemapByPlugin[entry.pluginKey]) {
       sitemapByPlugin[entry.pluginKey] = [];
@@ -198,7 +200,8 @@ function generateRouteDocsSchema(context, sitemapEntries = []) {
     sitemapByPlugin[entry.pluginKey].push(entry);
   }
   for (const [pluginKey, plugin] of Object.entries(context.plugins)) {
-    if (pluginKey === "routeDocs" || plugin.name === "route-docs") {
+    const pluginId = plugin.id;
+    if (pluginId === constants.ROUTE_DOCS_PLUGIN_ID) {
       continue;
     }
     const pluginRoutes = plugin.routes(context);
@@ -228,7 +231,7 @@ function generateRouteDocsSchema(context, sitemapEntries = []) {
     if (documentedRoutes.length > 0) {
       documentedPlugins.push({
         key: pluginKey,
-        name: plugin.name,
+        name: pluginId,
         routes: documentedRoutes,
         sitemapEntries: sitemapByPlugin[pluginKey] || []
       });