@redocly/framework 1.0.0-next.1 → 1.0.0-next.3

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 (170) hide show
  1. package/dist/bundler/build/run.js +1 -1
  2. package/dist/bundler/build/vite-config.js +2 -2
  3. package/dist/bundler/vite-config.base.js +8 -8
  4. package/dist/cli/commands/translate.js +1 -1
  5. package/dist/cli/validate-react-pages.js +1 -1
  6. package/dist/client/RuntimeLink.js +1 -0
  7. package/dist/client/app.js +3 -3
  8. package/dist/client/experiments/runtime.js +1 -1
  9. package/dist/client/use-router-for-local-links.js +1 -1
  10. package/dist/client/utils/routes/is-router-path.js +1 -0
  11. package/dist/content-layer/config-schema.d.ts +7 -2
  12. package/dist/content-layer/config-schema.js +1 -1
  13. package/dist/content-layer/config.d.ts +22 -9
  14. package/dist/content-layer/config.js +1 -1
  15. package/dist/content-layer/context.d.ts +2 -0
  16. package/dist/content-layer/context.js +1 -1
  17. package/dist/content-layer/database/assets.js +1 -1
  18. package/dist/content-layer/database/blobs.js +1 -1
  19. package/dist/content-layer/database/entity-store.d.ts +5 -0
  20. package/dist/content-layer/database/entity-store.js +1 -1
  21. package/dist/content-layer/database/files.js +1 -1
  22. package/dist/content-layer/database/finalize.js +1 -1
  23. package/dist/content-layer/database/invalidation.d.ts +6 -0
  24. package/dist/content-layer/database/invalidation.js +26 -26
  25. package/dist/content-layer/database/link-refs.js +1 -1
  26. package/dist/content-layer/database/origins.js +1 -1
  27. package/dist/content-layer/database/problems.js +1 -1
  28. package/dist/content-layer/database/reset.js +1 -1
  29. package/dist/content-layer/database/route-query-deps.js +1 -1
  30. package/dist/content-layer/database/schema.d.ts +33 -0
  31. package/dist/content-layer/database/schema.js +1 -1
  32. package/dist/content-layer/database/search-vocab.js +2 -2
  33. package/dist/content-layer/database/site-config.d.ts +23 -0
  34. package/dist/content-layer/database/site-config.js +1 -1
  35. package/dist/content-layer/database/static-files.js +1 -1
  36. package/dist/content-layer/ingest/finalize-phase.js +1 -1
  37. package/dist/content-layer/ingest/hook-inputs.js +1 -1
  38. package/dist/content-layer/ingest/run.js +1 -1
  39. package/dist/content-layer/ingest/search-sync.js +1 -1
  40. package/dist/content-layer/ingest/sync.js +1 -1
  41. package/dist/content-layer/link-checker/delta.js +1 -1
  42. package/dist/content-layer/link-checker/run-build.js +1 -1
  43. package/dist/content-layer/loaders/context.js +1 -1
  44. package/dist/content-layer/markdown/client/markdoc-components.js +2 -2
  45. package/dist/content-layer/markdown/constants/builtin-tags.js +1 -1
  46. package/dist/content-layer/markdown/constants/tag-sets.d.ts +2 -0
  47. package/dist/content-layer/markdown/constants/tag-sets.js +1 -1
  48. package/dist/content-layer/markdown/nodes/heading.js +1 -1
  49. package/dist/content-layer/markdown/nodes/table.js +1 -1
  50. package/dist/content-layer/markdown/resolve/ast.js +1 -1
  51. package/dist/content-layer/markdown/resolve/markdoc-resolvers/code-snippet.js +5 -4
  52. package/dist/content-layer/markdown/resolve/markdoc-resolvers/code-walkthrough/filesets.js +1 -1
  53. package/dist/content-layer/markdown/resolve/markdoc-resolvers/diagram-file.js +1 -1
  54. package/dist/content-layer/markdown/resolve/markdoc-resolvers/file-reference.js +1 -1
  55. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.d.ts +2 -1
  56. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.js +1 -1
  57. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.js +1 -1
  58. package/dist/content-layer/markdown/resolve/markdoc-resolvers/partial.js +1 -1
  59. package/dist/content-layer/markdown/resolve/markdoc-resolvers/svg-content.js +1 -1
  60. package/dist/content-layer/markdown/resolve/markdoc.js +1 -1
  61. package/dist/content-layer/markdown/resolve/raw-partials.d.ts +2 -1
  62. package/dist/content-layer/markdown/resolve/raw-partials.js +1 -1
  63. package/dist/content-layer/markdown/resolve/render-diagrams.d.ts +8 -1
  64. package/dist/content-layer/markdown/resolve/render-diagrams.js +1 -1
  65. package/dist/content-layer/markdown/search/to-markdown.js +1 -1
  66. package/dist/content-layer/markdown/search/to-sections.js +1 -1
  67. package/dist/content-layer/markdown/search/to-text.d.ts +4 -1
  68. package/dist/content-layer/markdown/search/to-text.js +5 -5
  69. package/dist/content-layer/markdown/tags/markdoc-error.d.ts +8 -0
  70. package/dist/content-layer/markdown/tags/markdoc-error.js +1 -1
  71. package/dist/content-layer/markdown/tags/variant.d.ts +6 -0
  72. package/dist/content-layer/markdown/tags/variant.js +1 -0
  73. package/dist/content-layer/markdown/utils/collect-anchors.js +1 -1
  74. package/dist/content-layer/markdown/utils/collect-headings.d.ts +3 -1
  75. package/dist/content-layer/markdown/utils/collect-headings.js +1 -1
  76. package/dist/content-layer/markdown/utils/first-heading.js +1 -1
  77. package/dist/content-layer/markdown/utils/heading-slugger.d.ts +8 -0
  78. package/dist/content-layer/markdown/utils/heading-slugger.js +1 -1
  79. package/dist/content-layer/markdown/utils/node-source-range.d.ts +3 -3
  80. package/dist/content-layer/markdown/utils/node-source-range.js +1 -1
  81. package/dist/content-layer/materialization/asset-reconcile.js +1 -1
  82. package/dist/content-layer/materialization/entity.js +1 -1
  83. package/dist/content-layer/plan-gates.js +1 -1
  84. package/dist/content-layer/plugins/internal/api-docs/client/template.js +4 -4
  85. package/dist/content-layer/plugins/internal/api-docs/index.js +1 -1
  86. package/dist/content-layer/plugins/internal/api-docs/server/build-sidebar.js +1 -1
  87. package/dist/content-layer/plugins/internal/api-docs/server/search-documents.d.ts +1 -1
  88. package/dist/content-layer/plugins/internal/api-docs/server/search-documents.js +1 -1
  89. package/dist/content-layer/plugins/internal/api-functions/server/api-function-telemetry.js +1 -0
  90. package/dist/content-layer/plugins/internal/api-functions/server/dispatch.js +1 -1
  91. package/dist/content-layer/plugins/internal/catalog-classic/resolve-items.d.ts +1 -1
  92. package/dist/content-layer/plugins/internal/catalog-classic/sidebars.d.ts +1 -1
  93. package/dist/content-layer/plugins/internal/markdoc/index.js +1 -1
  94. package/dist/content-layer/plugins/internal/mcp/content-tools.d.ts +4 -1
  95. package/dist/content-layer/plugins/internal/mcp/content-tools.js +1 -1
  96. package/dist/content-layer/plugins/internal/mcp/index.js +1 -1
  97. package/dist/content-layer/plugins/internal/mcp/server/custom-tools.js +1 -1
  98. package/dist/content-layer/plugins/internal/mcp/server/mcp-telemetry.js +1 -1
  99. package/dist/content-layer/plugins/internal/react-page/index.d.ts +3 -2
  100. package/dist/content-layer/plugins/internal/react-page/index.js +1 -1
  101. package/dist/content-layer/plugins/internal/sidebar/bundle.d.ts +2 -1
  102. package/dist/content-layer/plugins/internal/sidebar/bundle.js +1 -1
  103. package/dist/content-layer/plugins/internal/sidebar/index.d.ts +2 -1
  104. package/dist/content-layer/plugins/internal/sidebar/index.js +1 -1
  105. package/dist/content-layer/plugins/types/plugin.d.ts +5 -0
  106. package/dist/content-layer/plugins/types/search.d.ts +13 -2
  107. package/dist/content-layer/plugins/utils/link-access.js +1 -1
  108. package/dist/content-layer/problems/codes.d.ts +10 -0
  109. package/dist/content-layer/problems/codes.js +1 -1
  110. package/dist/content-layer/revisions/delete.js +1 -1
  111. package/dist/content-layer/search/engine/core/search-engine.js +1 -1
  112. package/dist/content-layer/search/facet-rows.js +1 -1
  113. package/dist/content-layer/search/keywords.d.ts +18 -0
  114. package/dist/content-layer/search/keywords.js +1 -0
  115. package/dist/content-layer/search/postings/postings-store.d.ts +14 -0
  116. package/dist/content-layer/search/postings/postings-store.js +1 -1
  117. package/dist/content-layer/search/store.d.ts +14 -1
  118. package/dist/content-layer/server/database.js +1 -1
  119. package/dist/content-layer/versions/group-info.d.ts +21 -0
  120. package/dist/content-layer/versions/group-info.js +1 -0
  121. package/dist/content-layer/versions/redirect.d.ts +13 -11
  122. package/dist/content-layer/versions/redirect.js +1 -1
  123. package/dist/content-layer/versions/resolve.d.ts +1 -21
  124. package/dist/content-layer/versions/resolve.js +1 -1
  125. package/dist/content-layer/versions/version-groups.d.ts +1 -1
  126. package/dist/content-layer/versions/version-groups.js +1 -1
  127. package/dist/server/__tests__/rbac-fixture.js +1 -1
  128. package/dist/server/app.js +3 -3
  129. package/dist/server/content.js +9 -8
  130. package/dist/server/html-tags.js +2 -1
  131. package/dist/server/lambda-entry.js +1 -1
  132. package/dist/server/node-entry.js +1 -1
  133. package/dist/server/page-handlers.js +1 -1
  134. package/dist/server/plugin-context.js +1 -1
  135. package/dist/server/project-env.d.ts +12 -0
  136. package/dist/server/project-env.js +1 -0
  137. package/dist/server/redirects.js +1 -1
  138. package/dist/server/runtime-config.js +1 -1
  139. package/dist/server/search/route.js +1 -1
  140. package/dist/server/search/search-telemetry.js +1 -0
  141. package/dist/server/ssrf/ssrf-blocklist.js +1 -1
  142. package/dist/server/subprocess/runner.js +1 -1
  143. package/dist/shared/constants/dependency-pack.js +1 -1
  144. package/dist/shared/constants/l10n/langs/ar.js +1 -1
  145. package/dist/shared/constants/l10n/langs/de.js +1 -1
  146. package/dist/shared/constants/l10n/langs/en.js +1 -1
  147. package/dist/shared/constants/l10n/langs/es.js +1 -1
  148. package/dist/shared/constants/l10n/langs/fr.js +1 -1
  149. package/dist/shared/constants/l10n/langs/hi.js +1 -1
  150. package/dist/shared/constants/l10n/langs/it.js +1 -1
  151. package/dist/shared/constants/l10n/langs/ja.js +1 -1
  152. package/dist/shared/constants/l10n/langs/ko.js +1 -1
  153. package/dist/shared/constants/l10n/langs/pl.js +1 -1
  154. package/dist/shared/constants/l10n/langs/pt-br.js +1 -1
  155. package/dist/shared/constants/l10n/langs/pt.js +1 -1
  156. package/dist/shared/constants/l10n/langs/ru.js +1 -1
  157. package/dist/shared/constants/l10n/langs/uk.js +1 -1
  158. package/dist/shared/constants/l10n/langs/zh.js +1 -1
  159. package/dist/shared/experiments.js +1 -1
  160. package/dist/shared/load-dot-env.js +1 -1
  161. package/dist/shared/plan-gates.d.ts +3 -2
  162. package/dist/shared/public-env.d.ts +9 -0
  163. package/dist/shared/public-env.js +1 -1
  164. package/dist/shared/search/facets.d.ts +5 -0
  165. package/dist/shared/search/facets.js +1 -1
  166. package/dist/shared/types/search.d.ts +1 -0
  167. package/dist/shared/types/sidebar.d.ts +1 -0
  168. package/drizzle/20261103061150_site_config_effective_hash/migration.sql +1 -0
  169. package/drizzle/20261105151816_search_http_path_tokens/migration.sql +1 -0
  170. package/package.json +10 -8
@@ -4,7 +4,7 @@ export declare const API_DOCS_SEARCH_GROUP = "API Reference";
4
4
  export type ApiDocsSearchDocumentOptions = {
5
5
  /** The category of every document; `API Reference` by default. */
6
6
  groupKey?: string;
7
- /** Facet values every document carries. */
7
+ /** Facet values every document carries; an HTTP operation also carries its method and path. */
8
8
  facets?: SearchDocumentFacets;
9
9
  /** Receives the warnings of the `x-rbac` annotation; the render loader reported the same ones. */
10
10
  warn?: (message: string) => void;
@@ -1 +1 @@
1
- import{isRbacScope as e}from"../../../../../server/rbac/engine.js";import{annotateApiDocsRbac as t}from"../../../../../server/rbac/api-docs.js";import{withImpliedDiscriminatorMappings as n}from"./implied-discriminators.js";import{createHash as r}from"node:crypto";import{REDOCLY_TEAMS_RBAC as i}from"@redocly/config";import{ApiDocsSearchIndexer as a}from"@redocly/api-docs/lib/services/search/indexer/index.js";const o=`API Reference`;function s(e,r,i={}){let o=f(e.store)?e.store:{},s=t(r,e.specType,{warn:i.warn??(()=>{})}),d=n(s),p=new a(e.basePath,o.schemaStore,f(d)?d:void 0,{exampleStore:o.exampleStore}),m=e=>{for(let t of e)p.addItem(t),f(t)&&Array.isArray(t.items)&&m(t.items)};m(e.items);let h=[],g=/* @__PURE__ */ new Set,_=[];return{docs:p.getResult().map(e=>{for(let t of e.parameters??[]){let n=l(t),r=n.fragmentKey;g.has(r)||(g.add(r),h.push(n));let i={docKey:e.id,fragmentKey:r,place:t.place,anchor:u(t.deepLink)};t.path&&t.path.length>0&&(i.path=t.path),_.push(i)}return c(e,i)}),fragments:h,uses:_}}function c(t,n){let r={docKey:t.id,routeSlug:t.url,title:d(t.title),text:d(t.text),groupKey:n.groupKey??`API Reference`,facets:n.facets},a=t[i];return e(a)&&(r.rbacScope=a),t.httpMethod&&(r.httpMethod=t.httpMethod),t.httpPath&&(r.httpPath=d(t.httpPath)),t.deprecated&&(r.deprecated=!0),t.isAdditionalOperation&&(r.isAdditionalOperation=!0),t.badges&&t.badges.length>0&&(r.badges=t.badges),r}function l(e){let t={name:d(e.name),description:d(e.description)};return e.example&&(t.example=e.example),e.enum&&e.enum.length>0&&(t.enum=e.enum),{fragmentKey:r(`sha1`).update(JSON.stringify([t.name,t.description,t.example??null,t.enum??null])).digest(`hex`),...t}}function u(e){if(!e)return``;let t=e.indexOf(`#`);return t>=0?e.slice(t+1):e}function d(e){return Array.isArray(e)?e.join(` `):e}function f(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{o as API_DOCS_SEARCH_GROUP,s as buildApiDocsSearchDocuments};
1
+ import{SEARCH_HTTP_METHOD_FACET_FIELD as e,SEARCH_HTTP_PATH_FACET_FIELD as t}from"../../../../../shared/search/facets.js";import{isRbacScope as n}from"../../../../../server/rbac/engine.js";import{annotateApiDocsRbac as r}from"../../../../../server/rbac/api-docs.js";import{withImpliedDiscriminatorMappings as i}from"./implied-discriminators.js";import{createHash as a}from"node:crypto";import{REDOCLY_TEAMS_RBAC as o}from"@redocly/config";import{ApiDocsSearchIndexer as s}from"@redocly/api-docs/lib/services/search/indexer/index.js";import{isOperationName as c}from"@redocly/api-docs/lib/utils/http-methods.js";const l=`API Reference`;function u(e,t,n={}){let a=h(e.store)?e.store:{},o=r(t,e.specType,{warn:n.warn??(()=>{})}),c=i(o),l=new s(e.basePath,a.schemaStore,h(c)?c:void 0,{exampleStore:a.exampleStore}),u=e=>{for(let t of e)l.addItem(t),h(t)&&Array.isArray(t.items)&&u(t.items)};u(e.items);let m=[],g=/* @__PURE__ */ new Set,_=[];return{docs:l.getResult().map(e=>{for(let t of e.parameters??[]){let n=f(t),r=n.fragmentKey;g.has(r)||(g.add(r),m.push(n));let i={docKey:e.id,fragmentKey:r,place:t.place,anchor:p(t.deepLink)};t.path&&t.path.length>0&&(i.path=t.path),_.push(i)}return d(e,n)}),fragments:m,uses:_}}function d(r,i){let a=r.httpPath?m(r.httpPath):void 0,s={...i.facets},l=r.isAdditionalOperation?r.httpMethod:r.httpMethod&&c(r.httpMethod)?r.httpMethod.toLowerCase():void 0;l&&(s[e]=l,a&&(s[t]=a));let u={docKey:r.id,routeSlug:r.url,title:m(r.title),text:m(r.text),groupKey:i.groupKey??`API Reference`,facets:s},d=r[o];return n(d)&&(u.rbacScope=d),r.httpMethod&&(u.httpMethod=r.httpMethod),a&&(u.httpPath=a),r.deprecated&&(u.deprecated=!0),r.isAdditionalOperation&&(u.isAdditionalOperation=!0),r.badges&&r.badges.length>0&&(u.badges=r.badges),u}function f(e){let t={name:m(e.name),description:m(e.description)};return e.example&&(t.example=e.example),e.enum&&e.enum.length>0&&(t.enum=e.enum),{fragmentKey:a(`sha1`).update(JSON.stringify([t.name,t.description,t.example??null,t.enum??null])).digest(`hex`),...t}}function p(e){if(!e)return``;let t=e.indexOf(`#`);return t>=0?e.slice(t+1):e}function m(e){return Array.isArray(e)?e.join(` `):e}function h(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{l as API_DOCS_SEARCH_GROUP,u as buildApiDocsSearchDocuments};
@@ -0,0 +1 @@
1
+ import{sendServerEvent as e}from"../../../../../server/telemetry/sender.js";function t({sourcePath:t,status:n,failure:r},i){let a=r!==void 0,o={id:`apiFunctionId`,object:`apiFunction`,uri:`urn:redocly:realm:api:apiFunction:apiFunctionId`,handler:`api-functions:${t}`,status:n,message:a?r:null};return e({type:a?`com.redocly.apiFunction.error`:`com.redocly.apiFunction.called`,data:[o]},i)}export{t as sendApiFunctionEvent};
@@ -1 +1 @@
1
- import{stripPathPrefix as e}from"../../../../../shared/path-prefix.js";import{API_FUNCTION_ENTITY_TYPE as t}from"../constants.js";import{compareApiFunctionRoutes as n}from"../route-path.js";import{SUBPROCESS_DEFAULT_TIMEOUT_MS as r,isSubprocessError as i}from"../../../../../server/subprocess/runner.js";import{resolveApiFunctionAccess as a,resolveRbacMatcher as o}from"./access.js";import{BodyTooLargeError as s,MAX_REQUEST_BODY_BYTES as c,MAX_RESPONSE_BODY_BYTES as l,deserializeResponse as u,serializeRequest as d}from"./serialize.js";import{invoke as f}from"./invoke.js";import{fileURLToPath as p}from"node:url";import{getCookie as m}from"hono/cookie";import{TrieRouter as h}from"hono/router/trie-router";import{getPath as g,tryDecodeURIComponent as _}from"hono/utils/url";const v=1048576,y=p(import.meta.url);function b(e){let{method:t,honoPath:n,sourcePath:r}=e.metadata??{};return typeof t==`string`&&typeof n==`string`&&typeof r==`string`?{method:t,honoPath:n,sourcePath:r}:null}const x=/* @__PURE__ */ new WeakMap;function S(e){let t=x.get(e);if(!t){t=new h;let r=e.map(b).filter(e=>e!==null);for(let e of r.sort(n))t.add(e.method,e.honoPath,e);x.set(e,t)}return t}function C(e,t,n){let r=S(e),i=t.toUpperCase(),[[a]]=r.match(i===`HEAD`?`GET`:i,n);if(!a)return null;let[o,s]=a,c=Object.fromEntries(Object.entries(s).map(([e,t])=>{let n=_(t);return[e,o.honoPath.includes(`:${e}{.+}`)?n.split(`/`).filter(Boolean):n]}));return{sourcePath:o.sourcePath,params:c}}function w(e){let t={};for(let n of new Set(e.searchParams.keys())){let r=e.searchParams.getAll(n);t[n]=r.length===1?r[0]:r}return t}const T=1048576,E=`Request body size exceeded limit of ${c/T} MB.`,D=`Response size exceeded limit of ${l/T}MB`;function O(e,t){return Response.json({message:t},{status:e,headers:{"Cache-Control":`no-store`}})}function k(e,t){switch(e){case`timeout`:return O(504,`Timeout exceeded`);case`input-too-large`:return O(413,E);case`output-too-large`:case`response-too-large`:return O(500,D);default:return O(500,import.meta.env.DEV?t:`Internal server error`)}}async function A(n,f,p){let h=e(g(n.req.raw));if(h===null)return f();let _=new URL(p.request.url),b=C(await p.entities.list({type:t}),p.request.method,h);if(!b)return f();n.set(`realmApiFunctionResponder`,`runtime`);let x=o(p.config);if(x){let e=a(x,{sourcePath:b.sourcePath,pathname:h,teams:p.request.teams});if(!e.allow)return O(e.status,e.status===401?`Unauthorized`:`Forbidden`)}let{subprocess:S}=p;if(!S)return O(501,`API functions do not run on this host.`);let T;try{T={modulePath:S.resolveContentModule(b.sourcePath),request:await d(n.req.raw,c),params:b.params,query:w(_),cookies:m(n),user:{teams:p.request.teams,claims:{...p.request.viewer},email:p.request.viewer?.email,idpAccessToken:void 0,idpId:void 0,isAuthenticated:p.request.viewer?.isAuthenticated??!1},config:p.config,baseUrl:_.origin}}catch(e){if(e instanceof s)return k(`input-too-large`,e.message);throw e}let E;try{E=await S.run({modulePath:y,exportName:`invoke`,input:T,reuse:!import.meta.env.DEV,timeoutMs:r,maxInputBytes:Math.ceil(4/3*c)+v,maxOutputBytes:Math.ceil(4/3*l)+v})}catch(e){if(!i(e))throw e;return e.code===`output-too-large`&&n.set(`realmApiFunctionResponder`,`project`),p.logger?.error(`API function ${b.sourcePath} failed (${e.code}): ${e.message}`),k(e.code,e.message)}if(n.set(`realmApiFunctionResponder`,`project`),!E.ok)return p.logger?.error(`API function ${b.sourcePath} failed (${E.code}): ${E.stack??E.message}`),k(E.code,E.message);let D=u(E.response);return D.headers.has(`cache-control`)||D.headers.set(`Cache-Control`,`no-store`),D}export{A as dispatch,f as invoke,C as matchApiFunction};
1
+ import{stripPathPrefix as e}from"../../../../../shared/path-prefix.js";import{API_FUNCTION_ENTITY_TYPE as t}from"../constants.js";import{compareApiFunctionRoutes as n}from"../route-path.js";import{errorMessage as r}from"../../../../../shared/utils/error-message.js";import{isSubprocessError as i}from"../../../../../server/subprocess/runner.js";import{resolveApiFunctionAccess as a,resolveRbacMatcher as o}from"./access.js";import{sendApiFunctionEvent as s}from"./api-function-telemetry.js";import{BodyTooLargeError as c,MAX_REQUEST_BODY_BYTES as l,MAX_RESPONSE_BODY_BYTES as u,deserializeResponse as d,serializeRequest as f}from"./serialize.js";import{invoke as p}from"./invoke.js";import{fileURLToPath as m}from"node:url";import{getCookie as h}from"hono/cookie";import{TrieRouter as g}from"hono/router/trie-router";import{getPath as _,tryDecodeURIComponent as v}from"hono/utils/url";const y=1048576,b=m(import.meta.url);function x(e){let{method:t,honoPath:n,sourcePath:r}=e.metadata??{};return typeof t==`string`&&typeof n==`string`&&typeof r==`string`?{method:t,honoPath:n,sourcePath:r}:null}const S=/* @__PURE__ */ new WeakMap;function C(e){let t=S.get(e);if(!t){t=new g;let r=e.map(x).filter(e=>e!==null);for(let e of r.sort(n))t.add(e.method,e.honoPath,e);S.set(e,t)}return t}function w(e,t,n){let r=C(e),i=t.toUpperCase(),[[a]]=r.match(i===`HEAD`?`GET`:i,n);if(!a)return null;let[o,s]=a,c=Object.fromEntries(Object.entries(s).map(([e,t])=>{let n=v(t);return[e,o.honoPath.includes(`:${e}{.+}`)?n.split(`/`).filter(Boolean):n]}));return{sourcePath:o.sourcePath,params:c}}function T(e){let t={};for(let n of new Set(e.searchParams.keys())){let r=e.searchParams.getAll(n);t[n]=r.length===1?r[0]:r}return t}const E=1048576,D=`Request body size exceeded limit of ${l/E} MB.`,O=`Response size exceeded limit of ${u/E}MB`,k=1e4,A=`Promise timed out after ${k} ms`;function j(e,t){return Response.json({message:t},{status:e,headers:{"Cache-Control":`no-store`}})}function M(e,t){switch(e){case`timeout`:return N(504,`Timeout exceeded`,A);case`input-too-large`:return N(413,D);case`output-too-large`:case`response-too-large`:return N(500,O);default:return N(500,import.meta.env.DEV?t:`Internal server error`,t)}}function N(e,t,n=t){return{response:j(e,t),failure:n}}async function P(n,i,c){let l=e(_(n.req.raw));if(l===null)return i();let u=new URL(c.request.url),d=w(await c.entities.list({type:t}),c.request.method,l);if(!d)return i();n.set(`realmApiFunctionResponder`,`runtime`);let f=o(c.config);if(f){let e=a(f,{sourcePath:d.sourcePath,pathname:l,teams:c.request.teams});if(!e.allow)return j(e.status,e.status===401?`Unauthorized`:`Forbidden`)}let{subprocess:p}=c;if(!p)return j(501,`API functions do not run on this host.`);let m=(e,t)=>s({sourcePath:d.sourcePath,status:e,failure:t},{logger:c.logger}),h;try{h=await F(n,c,p,d,u)}catch(e){throw await m(500,r(e)),e}return await m(h.response.status,h.failure),h.response}async function F(e,t,n,r,a){let o;try{o={modulePath:n.resolveContentModule(r.sourcePath),request:await f(e.req.raw,l),params:r.params,query:T(a),cookies:h(e),user:{teams:t.request.teams,claims:{...t.request.viewer},email:t.request.viewer?.email,idpAccessToken:void 0,idpId:void 0,isAuthenticated:t.request.viewer?.isAuthenticated??!1},config:t.config,baseUrl:a.origin}}catch(e){if(e instanceof c)return M(`input-too-large`,e.message);throw e}let s;try{s=await n.run({modulePath:b,exportName:`invoke`,input:o,reuse:!import.meta.env.DEV,timeoutMs:k,maxInputBytes:Math.ceil(4/3*l)+y,maxOutputBytes:Math.ceil(4/3*u)+y})}catch(n){if(!i(n))throw n;return n.code===`output-too-large`&&e.set(`realmApiFunctionResponder`,`project`),t.logger?.error(`API function ${r.sourcePath} failed (${n.code}): ${n.message}`),M(n.code,n.message)}if(e.set(`realmApiFunctionResponder`,`project`),!s.ok)return t.logger?.error(`API function ${r.sourcePath} failed (${s.code}): ${s.stack??s.message}`),M(s.code,s.message);let p=d(s.response);return p.headers.has(`cache-control`)||p.headers.set(`Cache-Control`,`no-store`),{response:p}}export{P as dispatch,p as invoke,w as matchApiFunction};
@@ -5,7 +5,7 @@ import type { Logger } from '../../../../shared/logger.js';
5
5
  import type { RouteDetail, RouteIndex } from '../../utils/route-index.js';
6
6
  import type { PluginIO } from '../../types/io.js';
7
7
  import type { EntityInvalidationDep } from '../../types/plugin.js';
8
- import type { VersionGroupInfo } from '../../../versions/resolve.js';
8
+ import type { VersionGroupInfo } from '../../../versions/group-info.js';
9
9
  export type CatalogNavItem = CatalogConfig['items'][number];
10
10
  /** A catalog item with its server-only RBAC scope. */
11
11
  export type CatalogItemPayload = CatalogItemValue & {
@@ -1,5 +1,5 @@
1
1
  import type { SidebarContribution, SidebarBreadcrumb } from '../sidebar/contributions.js';
2
- import type { VersionGroupInfo } from '../../../versions/resolve.js';
2
+ import type { VersionGroupInfo } from '../../../versions/group-info.js';
3
3
  import type { EntityStore } from '../../../database/entity-store.js';
4
4
  import { type CatalogMember } from './resolve-items.js';
5
5
  /**
@@ -1 +1 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t}from"../../../loaders/define.js";import{runtimeFile as n}from"../../utils/runtime-file.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import{runtimeTemplate as i}from"../../templates.js";import{SEARCH_GROUP_FACET_FIELD as a}from"../../../../shared/search/facets.js";import{configuredFacetFields as o,extractFacetsFromFrontmatter as s,invalidFacetValueProblems as c,searchCategoryOf as l}from"../../../search/facet-values.js";import{isObject as u}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as d}from"../../../../shared/utils/routes/normalize-route-slug.js";import{resolveContentPath as f}from"../../../../shared/utils/resolve-content-path.js";import{PAGE_BANNER_SCHEMA as p,sanitizeConfig as m}from"../../../config-schema.js";import{notInPlanProblem as h}from"../../../plan-gates.js";import{matchPathMap as g}from"../../utils/glob.js";import{filePathToRouteSlug as _}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{isPlanFeatureGranted as v}from"../../../../shared/plan-gates.js";import{splitUrlSuffix as y}from"../../../../shared/utils/routes/split-url-suffix.js";import{packMarkdocAst as ee,unpackMarkdocAst as b}from"../../../markdown/utils/packed-ast.js";import{isRouteSlugTarget as x}from"../../../../shared/utils/routes/is-route-slug-target.js";import{loadSidebarSubtreeLabel as S}from"../../utils/sidebar-label.js";import{replaceWithMarkdocError as C}from"../../../markdown/tags/markdoc-error.js";import{CODE_WALKTHROUGH_TAG_NAMES as te,builtInMarkdocTags as ne}from"../../../markdown/constants/builtin-tags.js";import{walkMarkdocAst as w}from"../../../markdown/utils/walk-markdoc-ast.js";import{markdocNodeRange as re}from"../../../markdown/utils/node-source-range.js";import{markdocFirstHeading as ie}from"../../../markdown/search/to-text.js";import{safeDecodeURI as ae}from"../../../../shared/utils/safe-decode-uri.js";import{shiftRange as oe}from"../../../../shared/utils/shift-range.js";import{classifyLinkTarget as se}from"../../../link-checker/classify.js";import{onDiskLinkRefs as ce}from"../../../link-checker/node-ref.js";import{isPartialPath as le}from"../../../markdown/utils/partials.js";import{FRONTMATTER_BLOCK_RE as ue,computeFrontmatterLineOffset as de}from"../../../markdown/utils/frontmatter-offset.js";import{inlineRawPartials as fe}from"../../../markdown/resolve/raw-partials.js";import{resolveMarkdownAst as T}from"../../../markdown/resolve/ast.js";import{resolveBannerForAppData as E}from"../app-data/banner.js";import{MARKDOC_DOCUMENT_LOADER_KEY as D}from"../../../../shared/constants/route-deps.js";import{isMarkdocValidationEnabled as O,resolveMarkdocTagSet as k,resolveMarkdownPageValidationSet as A,userMarkdocSchemaFiles as j}from"../../../markdown/constants/tag-sets.js";import{pageLocale as M}from"../../utils/page-locale.js";import{markdocAstToMarkdownDoc as N}from"../../../markdown/search/to-markdown.js";import{collectAnchors as P}from"../../../markdown/utils/collect-anchors.js";import{frontmatterVariable as F}from"../../../markdown/utils/frontmatter-variable.js";import{markdownFirstHeading as I}from"../../../markdown/utils/first-heading.js";import{markdocAstToSearchSections as L}from"../../../markdown/search/to-sections.js";import{isInternalPagePath as R}from"../../utils/internal-page-path.js";import{parseExplicitSlugs as z}from"../../utils/explicit-slugs.js";import{isSkillContentPath as B}from"../../utils/skill-paths.js";import{SOURCE_TEMPLATE_PREFIX as V}from"../../../../shared/constants/template-ids.js";import{captureSnippet as H,splitSourceLines as pe}from"../../../../shared/utils/capture-snippet.js";import me from"js-yaml";const U=`markdoc-page`,W=r(`internal.markdoc`,`document`),G=r(`internal.markdoc`,`sidebar-item`),he=`Documentation`,K=t(W,async e=>{let t=await e.io.readFile(e.file.absolutePath),{content:n,frontmatter:r,frontmatterError:i}=Y(t),a=J(e),{ast:o,entityDeps:s,assetUsages:c,tagList:l,problems:u,linkRefs:d}=await T(n,e.file.path,{resolverContext:a,tags:(await k()).tags,variables:{get env(){return e.config.publicEnv??{}}},transform:v(e.config,`codeWalkthrough`)?void 0:t=>Ce(t,e.file.path),validation:O()?await A():void 0}),f=de(t);Oe(o);let p=await Se(r.seo,e),m=v(e.config,`banner`)?await E(ke(r,e.file.path,e.logger),a):void 0,h=await we(r,e),g=await Te(r.navigation,e),_={...h.frontmatter,navigation:g.value,seo:p.seo,banner:m?.banner},y=Ae(r,o);return{value:{ast:ee(o),frontmatter:_,tagList:l,title:y,editPage:xe(e.config,r,e.file.path),lastModified:e.file.lastModifiedAt},entityDeps:[...s,..._e(),...p.entityDeps,...m?.deps??[],...h.entityDeps,...g.entityDeps],assetUsages:[...c,...p.assetUsages,...m?.assetUsages??[],...h.assetUsages],problems:ve(t,e.file.path,f,u,i),linkRefs:[...ce(d,f),...g.linkRefs],targetInventories:[ye(o,{frontmatter:F(_,y)})]}},{usesProjectMarkdocSchema:!0,async markdown(e,t){let{tags:n}=await k(),{chunks:r,headings:i}=N(b(e.ast),{tags:n,locale:M(t),variables:{frontmatter:F(e.frontmatter,e.title),env:t.config.publicEnv??{}}});return[{chunks:r,headings:i,...e.title?{title:e.title}:{}}]},searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=t.route.slug,r=e.title??Q(t.route.originFilePath??n),{category:i,isInvalid:u}=l(t.route.metadata),{facets:d,invalidFields:f}=s(t.route.metadata,o(t.config));return{docs:L(b(e.ast),r,{frontmatter:F(e.frontmatter,e.title)}).map(e=>{let t={docKey:e.docKey,routeSlug:n,title:e.title,text:e.text,groupKey:i??`Documentation`,facets:d};return e.anchor!==void 0&&(t.anchor=e.anchor),e.path!==void 0&&(t.path=e.path),e.rbacTeams!==void 0&&(t.rbacScope=Object.fromEntries(e.rbacTeams.map(e=>[e,`read`]))),t}),problems:c([...f,...u?[a]:[]],t.route.originFilePath)}}}),q=t(G,async e=>{let{content:t,frontmatter:n}=Y(await e.io.readFile(e.file.absolutePath)),r=await fe(t,e.file.path,J(e));return{value:{label:Z(n)??I(r.source)??Q(e.args.filePath)},entityDeps:r.entityDeps}});function J(e){return{config:e.config,contentDir:e.contentDir,entities:e.entities,file:e.file,io:e.io,logger:e.logger,markdown:e.markdown,plugin:e.plugin}}const ge=e({id:`internal.markdoc`,version:`3.42.0`,content:{filter:{match:e=>e.toLowerCase().endsWith(`.md`)&&!B(e)},extractFile(e,t){if(R(e.path)||le(e.path,t.config))return{routes:[]};if(!v(t.config,`markdown`))return{routes:[],problems:[h(`Markdown pages`)]};let{banner:n,...r}=e.manifest,i=je(e,t),a=z(r.slug),o=K.withArgs({filePath:e.path}),s=q.withArgs({filePath:e.path});return{routes:a.length>0?a.map(e=>({deps:{[D]:o},metadata:r,routeId:`page`,sidebarSubtree:s,slug:e,slugHint:null,template:i})):[{deps:{[D]:o},metadata:r,routeId:`page`,sidebarSubtree:s,slug:null,slugHint:_(e.path),template:i}],entities:[o]}}},loaders:[K,q],templates:{[U]:i(n(`./client/template.tsx`,import.meta.url))}});function Y(e){let t=e.match(ue);if(!t)return{content:e,frontmatter:{}};let n=t[1]??``;try{let r=me.load(n);return{content:e.slice(t[0].length),frontmatter:u(r)?r:{}}}catch(n){let r=n instanceof Error?n.message:String(n);return{content:e.slice(t[0].length),frontmatter:{},frontmatterError:r}}}function _e(){return(j()??[]).map(e=>({kind:`file`,path:e}))}function ve(e,t,n,r,i){if(r.length===0&&i===void 0)return[];let a=pe(e),o=r.map(e=>be(e,a,n,t));if(i!==void 0){let e={start:{line:1},end:{line:n}};o.push({code:`markdown/frontmatter-parse`,message:i,location:{filePath:t,range:e,snippet:H(a,e)}})}return o}function ye(e,t){let{ids:n,exhaustive:r}=P(e,t);return{kind:`anchor`,exhaustive:r,targets:n}}function be(e,t,n,r){let i=e.location?.range;if(!i)return e;let a=oe(i,n);return{...e,location:{filePath:r,range:a,snippet:H(t,a)}}}function xe(e,t,n){let r=u(t.markdown)?t.markdown:{},i={...e.markdown?.editPage,...u(r.editPage)?r.editPage:{}};if(i.hide!==!0&&typeof i.baseUrl==`string`&&i.baseUrl!==``)return{to:`${i.baseUrl.replace(/(?<!\/)\/+$/,``)}/${n}`}}async function Se(e,t){if(!u(e)||typeof e.image!=`string`)return{seo:e,entityDeps:[],assetUsages:[]};let n=await t.markdown.resolveImageReference(e.image,t.file.path);return n.result.kind===`assetRef`?{seo:{...e,image:n.result.url},entityDeps:n.entityDeps,assetUsages:n.assetUsages}:{seo:e,entityDeps:n.entityDeps,assetUsages:[]}}function Ce(e,t){let n=[];for(let r of w(e)){if(r.type!==`tag`||r.tag===void 0||!te.includes(r.tag))continue;let e=`\`${r.tag}\` is not in this project's plan and is ignored.`;n.push({code:`configuration/ignored`,message:e,location:{filePath:t,range:re(r)??{start:{line:1},end:{line:1}}}}),C(r,e)}return n}const X=[`image`,`links`];async function we(e,t){let n=t.config.markdown?.frontMatterKeysToResolve??X,r={...e},i=[],a=[];for(let o of n){let n=e[o];if(typeof n!=`string`)continue;let s=await t.markdown.resolveLocalReference(n,t.file.path);i.push(...s.entityDeps),a.push(...s.assetUsages),s.result.kind!==`passthrough`&&(r[o]=s.result.url)}return{frontmatter:r,entityDeps:i,assetUsages:a}}async function Te(e,t){let n=[],r=[];if(!u(e))return{value:e,entityDeps:n,linkRefs:r};let i={...e};for(let a of[`nextButton`,`previousButton`]){let o=e[a];if(!u(o)||typeof o.page!=`string`)continue;let{page:s,...c}=o,l=se(ae(s),t.file.path);l!==null&&r.push({kind:`link`,raw:s,...l});let d=await De(s,t);n.push(...d.entityDeps),i[a]={...c,label:typeof c.label==`string`?c.label:d.route&&await Ee(d.route,t),link:d.link}}return{value:i,entityDeps:n,linkRefs:r}}async function Ee(e,t){let n=await S(t.entities,e);if(n!==void 0)return n;let r=t.routes.get(e.slug)?.metadata.seo;return u(r)&&typeof r.title==`string`&&r.title.trim()!==``?r.title:e.slug}async function De(e,t){let n=e.trim(),{path:r,suffix:i}=y(n);if(x(r)){let e=t.routes.bySlug(d(r));return{link:e&&`${e.slug}${i}`,route:e,entityDeps:[]}}let a=await t.markdown.resolveLocalReference(n,t.file.path);if(a.result.kind!==`pageUrl`)return{entityDeps:a.entityDeps};let o=a.result.url;return{link:o,route:t.routes.bySlug(y(o).path)??a.entityDeps.map(e=>e.kind===`file`?t.routes.byFilePath(e.path):void 0).reverse().find(e=>e!==void 0),entityDeps:a.entityDeps}}function Oe(e){let t=/* @__PURE__ */ new Map;for(let n of w(e)){if(n.type!==`tag`||n.tag===void 0||ne[n.tag]?.attributes?.__idx===void 0)continue;let e=(t.get(n.tag)??0)+1;t.set(n.tag,e),n.attributes.__idx=e}}function ke(e,t,n){if(e.banner===void 0)return;let{value:r,problems:i}=m(p,{banner:e.banner});for(let e of i)n?.warn(`${t}: ${e.message}`);return r.banner}function Ae(e,t){return Z(e)??ie(t)??void 0}function Z(e){let t=u(e.seo)?e.seo.title:void 0;return typeof t==`string`&&t.trim()!==``?t:void 0}function Q(e){let t=(e.split(`/`).pop()??e).replace(/\.[^.]+$/,``);return t===``?e:t}function je(e,t){let n=e.manifest.template;if(typeof n==`string`&&n.trim()!==``)return $(n,e.path,t.logger);let r=g(e.path,t.config.markdown?.template);return typeof r==`string`&&r.trim()!==``?$(r,`redocly.yaml`,t.logger):U}function $(e,t,n){if(!e.startsWith(`./`)&&!e.startsWith(`../`)&&!e.startsWith(`/`))return e;let r=f(e,t);return r===null?(n.warn(`Template reference "${e}" in ${t} escapes the content root; falling back to ${U}.`),U):`${V}${r}`}export{W as MARKDOC_DOCUMENT_LOADER_ID,he as MARKDOC_SEARCH_GROUP,G as MARKDOC_SIDEBAR_ITEM_LOADER_ID,U as MARKDOC_TEMPLATE_ID,ge as markdocContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t}from"../../../loaders/define.js";import{runtimeFile as n}from"../../utils/runtime-file.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import{runtimeTemplate as i}from"../../templates.js";import{SEARCH_GROUP_FACET_FIELD as a}from"../../../../shared/search/facets.js";import{configuredFacetFields as o,extractFacetsFromFrontmatter as s,invalidFacetValueProblems as c,searchCategoryOf as l}from"../../../search/facet-values.js";import{isObject as u}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as d}from"../../../../shared/utils/routes/normalize-route-slug.js";import{resolveContentPath as f}from"../../../../shared/utils/resolve-content-path.js";import{PAGE_BANNER_SCHEMA as p,sanitizeConfig as m}from"../../../config-schema.js";import{notInPlanProblem as h}from"../../../plan-gates.js";import{matchPathMap as g}from"../../utils/glob.js";import{filePathToRouteSlug as _}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{isPlanFeatureGranted as v}from"../../../../shared/plan-gates.js";import{splitUrlSuffix as y}from"../../../../shared/utils/routes/split-url-suffix.js";import{packMarkdocAst as ee,unpackMarkdocAst as b}from"../../../markdown/utils/packed-ast.js";import{isRouteSlugTarget as x}from"../../../../shared/utils/routes/is-route-slug-target.js";import{loadSidebarSubtreeLabel as S}from"../../utils/sidebar-label.js";import{markdocNodeRange as C}from"../../../markdown/utils/node-source-range.js";import{replaceWithMarkdocError as te}from"../../../markdown/tags/markdoc-error.js";import{CODE_WALKTHROUGH_TAG_NAMES as ne,builtInMarkdocTags as re}from"../../../markdown/constants/builtin-tags.js";import{walkMarkdocAst as w}from"../../../markdown/utils/walk-markdoc-ast.js";import{markdocFirstHeading as ie}from"../../../markdown/search/to-text.js";import{safeDecodeURI as ae}from"../../../../shared/utils/safe-decode-uri.js";import{shiftRange as oe}from"../../../../shared/utils/shift-range.js";import{classifyLinkTarget as se}from"../../../link-checker/classify.js";import{onDiskLinkRefs as ce}from"../../../link-checker/node-ref.js";import{isPartialPath as le}from"../../../markdown/utils/partials.js";import{FRONTMATTER_BLOCK_RE as ue,computeFrontmatterLineOffset as de}from"../../../markdown/utils/frontmatter-offset.js";import{inlineRawPartials as fe}from"../../../markdown/resolve/raw-partials.js";import{resolveMarkdownAst as T}from"../../../markdown/resolve/ast.js";import{resolveBannerForAppData as E}from"../app-data/banner.js";import{MARKDOC_DOCUMENT_LOADER_KEY as D}from"../../../../shared/constants/route-deps.js";import{isMarkdocValidationEnabled as O,resolveMarkdocTagSet as k,resolveMarkdownPageValidationSet as A,userMarkdocSchemaFiles as j,userMarkdocTagNames as M}from"../../../markdown/constants/tag-sets.js";import{pageLocale as N}from"../../utils/page-locale.js";import{markdocAstToMarkdownDoc as P}from"../../../markdown/search/to-markdown.js";import{collectAnchors as F}from"../../../markdown/utils/collect-anchors.js";import{frontmatterVariable as I}from"../../../markdown/utils/frontmatter-variable.js";import{markdownFirstHeading as L}from"../../../markdown/utils/first-heading.js";import{markdocAstToSearchSections as R}from"../../../markdown/search/to-sections.js";import{isInternalPagePath as z}from"../../utils/internal-page-path.js";import{parseExplicitSlugs as B}from"../../utils/explicit-slugs.js";import{isSkillContentPath as V}from"../../utils/skill-paths.js";import{SOURCE_TEMPLATE_PREFIX as pe}from"../../../../shared/constants/template-ids.js";import{captureSnippet as H,splitSourceLines as me}from"../../../../shared/utils/capture-snippet.js";import{curationKeywordsOf as he}from"../../../search/keywords.js";import ge from"js-yaml";const U=`markdoc-page`,W=r(`internal.markdoc`,`document`),G=r(`internal.markdoc`,`sidebar-item`),_e=`Documentation`,K=t(W,async e=>{let t=await e.io.readFile(e.file.absolutePath),{content:n,frontmatter:r,frontmatterError:i}=Y(t),a=J(e),{ast:o,entityDeps:s,assetUsages:c,tagList:l,problems:u,linkRefs:d}=await T(n,e.file.path,{resolverContext:a,tags:(await k()).tags,variables:{get env(){return e.config.publicEnv??{}}},transform:t=>Ee(t,e.file.path,Te(e.config)),validation:O()?await A():void 0}),f=de(t);je(o);let p=await we(r.seo,e),m=v(e.config,`banner`)?await E(Me(r,e.file.path,e.logger),a):void 0,h=await Oe(r,e),g=await ke(r.navigation,e),_={...h.frontmatter,navigation:g.value,seo:p.seo,banner:m?.banner},y=Ne(r,o);return{value:{ast:ee(o),frontmatter:_,tagList:l,title:y,editPage:Ce(e.config,r,e.file.path),lastModified:e.file.lastModifiedAt},entityDeps:[...s,...ye(),...p.entityDeps,...m?.deps??[],...h.entityDeps,...g.entityDeps],assetUsages:[...c,...p.assetUsages,...m?.assetUsages??[],...h.assetUsages],problems:be(t,e.file.path,f,u,i),linkRefs:[...ce(d,f),...g.linkRefs],targetInventories:[xe(o,{frontmatter:I(_,y)})]}},{usesProjectMarkdocSchema:!0,async markdown(e,t){let{tags:n}=await k(),{chunks:r,headings:i}=P(b(e.ast),{tags:n,locale:N(t),variables:{frontmatter:I(e.frontmatter,e.title),env:t.config.publicEnv??{}}});return[{chunks:r,headings:i,...e.title?{title:e.title}:{}}]},searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=t.route.slug,r=e.title??Q(t.route.originFilePath??n),{category:i,isInvalid:u}=l(t.route.metadata),{facets:d,invalidFields:f}=s(t.route.metadata,o(t.config)),p=he(e.frontmatter.keywords);return{docs:R(b(e.ast),r,{frontmatter:I(e.frontmatter,e.title)}).map((e,t)=>{let r={docKey:e.docKey,routeSlug:n,title:e.title,text:e.text,groupKey:i??`Documentation`,facets:d};e.anchor!==void 0&&(r.anchor=e.anchor),e.path!==void 0&&(r.path=e.path);let a=t===0?p:{excludes:p?.excludes};return(a?.includes||a?.excludes)&&(r.keywords=a),e.rbacTeams!==void 0&&(r.rbacScope=Object.fromEntries(e.rbacTeams.map(e=>[e,`read`]))),r}),problems:c([...f,...u?[a]:[]],t.route.originFilePath)}}}),q=t(G,async e=>{let{content:t,frontmatter:n}=Y(await e.io.readFile(e.file.absolutePath)),r=await fe(t,e.file.path,J(e));return{value:{label:Z(n)??L(r.source)??Q(e.args.filePath)},entityDeps:r.entityDeps}});function J(e){return{config:e.config,contentDir:e.contentDir,entities:e.entities,file:e.file,io:e.io,logger:e.logger,markdown:e.markdown,plugin:e.plugin}}const ve=e({id:`internal.markdoc`,version:`3.44.0`,content:{filter:{match:e=>e.toLowerCase().endsWith(`.md`)&&!V(e)},extractFile(e,t){if(z(e.path)||le(e.path,t.config))return{routes:[]};if(!v(t.config,`markdown`))return{routes:[],problems:[h(`Markdown pages`)]};let{banner:n,...r}=e.manifest,i=Pe(e,t),a=B(r.slug),o=K.withArgs({filePath:e.path}),s=q.withArgs({filePath:e.path});return{routes:a.length>0?a.map(e=>({deps:{[D]:o},metadata:r,routeId:`page`,sidebarSubtree:s,slug:e,slugHint:null,template:i})):[{deps:{[D]:o},metadata:r,routeId:`page`,sidebarSubtree:s,slug:null,slugHint:_(e.path),template:i}],entities:[o]}}},loaders:[K,q],templates:{[U]:i(n(`./client/template.tsx`,import.meta.url))}});function Y(e){let t=e.match(ue);if(!t)return{content:e,frontmatter:{}};let n=t[1]??``;try{let r=ge.load(n);return{content:e.slice(t[0].length),frontmatter:u(r)?r:{}}}catch(n){let r=n instanceof Error?n.message:String(n);return{content:e.slice(t[0].length),frontmatter:{},frontmatterError:r}}}function ye(){return(j()??[]).map(e=>({kind:`file`,path:e}))}function be(e,t,n,r,i){if(r.length===0&&i===void 0)return[];let a=me(e),o=r.map(e=>Se(e,a,n,t));if(i!==void 0){let e={start:{line:1},end:{line:n}};o.push({code:`markdown/frontmatter-parse`,message:i,location:{filePath:t,range:e,snippet:H(a,e)}})}return o}function xe(e,t){let{ids:n,exhaustive:r}=F(e,t);return{kind:`anchor`,exhaustive:r,targets:n}}function Se(e,t,n,r){let i=e.location?.range;if(!i)return e;let a=oe(i,n);return{...e,location:{filePath:r,range:a,snippet:H(t,a)}}}function Ce(e,t,n){let r=u(t.markdown)?t.markdown:{},i={...e.markdown?.editPage,...u(r.editPage)?r.editPage:{}};if(i.hide!==!0&&typeof i.baseUrl==`string`&&i.baseUrl!==``)return{to:`${i.baseUrl.replace(/(?<!\/)\/+$/,``)}/${n}`}}async function we(e,t){if(!u(e)||typeof e.image!=`string`)return{seo:e,entityDeps:[],assetUsages:[]};let n=await t.markdown.resolveImageReference(e.image,t.file.path);return n.result.kind===`assetRef`?{seo:{...e,image:n.result.url},entityDeps:n.entityDeps,assetUsages:n.assetUsages}:{seo:e,entityDeps:n.entityDeps,assetUsages:[]}}function Te(e){let t=/* @__PURE__ */ new Map;if(!v(e,`customMarkdocTags`))for(let e of M())t.set(e,`Custom Markdoc tags are not in this project's plan, so \`${e}\` is ignored.`);if(!v(e,`codeWalkthrough`))for(let e of ne)t.set(e,`\`${e}\` is not in this project's plan and is ignored.`);return t}function Ee(e,t,n){let r=[];if(n.size===0)return r;for(let i of w(e)){let e=i.type===`tag`&&i.tag!==void 0?n.get(i.tag):void 0;e!==void 0&&(r.push({code:`configuration/ignored`,message:e,location:{filePath:t,range:C(i)??{start:{line:1},end:{line:1}}}}),te(i,e))}return r}const De=[`image`,`links`];async function Oe(e,t){let n=t.config.markdown?.frontMatterKeysToResolve??De,r={...e},i=[],a=[];for(let o of n){let n=e[o];if(typeof n!=`string`)continue;let s=await t.markdown.resolveLocalReference(n,t.file.path);i.push(...s.entityDeps),a.push(...s.assetUsages),s.result.kind!==`passthrough`&&(r[o]=s.result.url)}return{frontmatter:r,entityDeps:i,assetUsages:a}}async function ke(e,t){let n=[],r=[];if(!u(e))return{value:e,entityDeps:n,linkRefs:r};let i={...e};for(let a of[`nextButton`,`previousButton`]){let o=e[a];if(!u(o)||typeof o.page!=`string`)continue;let{page:s,...c}=o,l=se(ae(s),t.file.path);l!==null&&r.push({kind:`link`,raw:s,...l});let d=await X(s,t);n.push(...d.entityDeps),i[a]={...c,label:typeof c.label==`string`?c.label:d.route&&await Ae(d.route,t),link:d.link}}return{value:i,entityDeps:n,linkRefs:r}}async function Ae(e,t){let n=await S(t.entities,e);if(n!==void 0)return n;let r=t.routes.get(e.slug)?.metadata.seo;return u(r)&&typeof r.title==`string`&&r.title.trim()!==``?r.title:e.slug}async function X(e,t){let n=e.trim(),{path:r,suffix:i}=y(n);if(x(r)){let e=t.routes.bySlug(d(r));return{link:e&&`${e.slug}${i}`,route:e,entityDeps:[]}}let a=await t.markdown.resolveLocalReference(n,t.file.path);if(a.result.kind!==`pageUrl`)return{entityDeps:a.entityDeps};let o=a.result.url;return{link:o,route:t.routes.bySlug(y(o).path)??a.entityDeps.map(e=>e.kind===`file`?t.routes.byFilePath(e.path):void 0).reverse().find(e=>e!==void 0),entityDeps:a.entityDeps}}function je(e){let t=/* @__PURE__ */ new Map;for(let n of w(e)){if(n.type!==`tag`||n.tag===void 0||re[n.tag]?.attributes?.__idx===void 0)continue;let e=(t.get(n.tag)??0)+1;t.set(n.tag,e),n.attributes.__idx=e}}function Me(e,t,n){if(e.banner===void 0)return;let{value:r,problems:i}=m(p,{banner:e.banner});for(let e of i)n?.warn(`${t}: ${e.message}`);return r.banner}function Ne(e,t){return Z(e)??ie(t)??void 0}function Z(e){let t=u(e.seo)?e.seo.title:void 0;return typeof t==`string`&&t.trim()!==``?t:void 0}function Q(e){let t=(e.split(`/`).pop()??e).replace(/\.[^.]+$/,``);return t===``?e:t}function Pe(e,t){let n=e.manifest.template;if(typeof n==`string`&&n.trim()!==``)return $(n,e.path,t.logger);let r=g(e.path,t.config.markdown?.template);return typeof r==`string`&&r.trim()!==``?$(r,`redocly.yaml`,t.logger):U}function $(e,t,n){if(!e.startsWith(`./`)&&!e.startsWith(`../`)&&!e.startsWith(`/`))return e;let r=f(e,t);return r===null?(n.warn(`Template reference "${e}" in ${t} escapes the content root; falling back to ${U}.`),U):`${pe}${r}`}export{W as MARKDOC_DOCUMENT_LOADER_ID,_e as MARKDOC_SEARCH_GROUP,G as MARKDOC_SIDEBAR_ITEM_LOADER_ID,U as MARKDOC_TEMPLATE_ID,ve as markdocContentPlugin};
@@ -12,7 +12,10 @@ export type McpToolFileFacts = {
12
12
  };
13
13
  export declare function mcpToolFileEntityKey(sourcePath: string): string;
14
14
  export declare function isMcpToolFile(path: string): boolean;
15
- /** One `mcp-tools` entity per valid `@mcp` file; an invalid, duplicate or reserved name is an error problem instead. */
15
+ /**
16
+ * One `mcp-tools` entity per valid `@mcp` file; an invalid, duplicate or reserved name is an error
17
+ * problem instead. Without custom MCP tools in the plan, each file is a warning and no entity.
18
+ */
16
19
  export declare function scanMcpToolFiles(ctx: Pick<FinalizeContext, 'config' | 'files'>): {
17
20
  entities: AnyRawEntityReference[];
18
21
  problems: ProblemDraft[];
@@ -1 +1 @@
1
- import{createInlineEntity as e}from"../../../loaders/define.js";import{MCP_TOOL_NAME_PATTERN as t}from"../../registry.js";import{CREATE_ANONYMOUS_SESSION_TOOL_NAME as n,DISCOVER_TOOL_NAME as r,EXECUTE_TOOL_NAME as i,MANAGE_API_CREDENTIALS_TOOL_NAME as a,MCP_TOOLS_ENTITY_TYPE as o,REMOVE_API_CREDENTIALS_TOOL_NAME as s,SUBMIT_FEEDBACK_TOOL_NAME as c}from"./constants.js";import{isMcpHidden as l}from"./server/config-gate.js";import{buildMcpSetupPageRoutes as u}from"./setup-page.js";const d=`@mcp`,f=`mcp/invalid-tool`,p=/\.(ts|js)$/u,m=/\.d\.ts$/u,h=/* @__PURE__ */ new Set([`search`,`list-apis`,`get-endpoints`,`get-endpoint-info`,`get-security-schemes`,`get-full-api-description`,`list-graphql-apis`,`get-graphql-type-list`,`get-graphql-type`,`get-graphql-schema`,`list-pages`,`get-page`,`grep-pages`,`whoami`,c,i,r,`describe-tools`,n,a,s]);function g(e){return`mcp-tool-file:${e}`}function _(e){if(m.test(e)||!p.test(e))return!1;let t=e.split(`/`),n=t.indexOf(d);return n!==-1&&n<t.length-1}function v(e,n,r){if(!t.test(e))return`Invalid MCP tool file "${n}": the tool name "${e}" is derived from the file name and may only contain letters, numbers, hyphens, and underscores (max 64 characters). Rename the file.`;if(r!==void 0)return`Duplicate MCP tool name "${e}": defined by both "${r}" and "${n}". Tool names are file names, so each file name must be unique across @mcp folders.`;if(h.has(e))return`Invalid MCP tool file "${n}": the tool name "${e}" is already used by a built-in MCP tool. Rename the file.`}function y(t){let n=[],r=[];if(l(t.config))return{entities:n,problems:r};let i=/* @__PURE__ */ new Map;for(let{path:a}of t.files){let t=a.slice(a.lastIndexOf(`/`)+1).replace(p,``),s=v(t,a,i.get(t));if(s!==void 0){r.push({code:f,message:s,location:{filePath:a}});continue}i.set(t,a);let c={name:t,sourcePath:a};n.push(e(c,{stableKey:g(a),type:o,metadata:c}))}return{entities:n,problems:r}}const b={filter:{match:_},extractAll(e){return{routes:u(e.config),entities:[]}}};export{d as MCP_DIR_SEGMENT,f as MCP_TOOL_PROBLEM_CODE,h as RESERVED_MCP_TOOL_NAMES,_ as isMcpToolFile,b as mcpContent,g as mcpToolFileEntityKey,y as scanMcpToolFiles};
1
+ import{createInlineEntity as e}from"../../../loaders/define.js";import{notInPlanProblem as t}from"../../../plan-gates.js";import{MCP_TOOL_NAME_PATTERN as n}from"../../registry.js";import{isPlanFeatureGranted as r}from"../../../../shared/plan-gates.js";import{CREATE_ANONYMOUS_SESSION_TOOL_NAME as i,DISCOVER_TOOL_NAME as a,EXECUTE_TOOL_NAME as o,MANAGE_API_CREDENTIALS_TOOL_NAME as s,MCP_TOOLS_ENTITY_TYPE as c,REMOVE_API_CREDENTIALS_TOOL_NAME as l,SUBMIT_FEEDBACK_TOOL_NAME as u}from"./constants.js";import{isMcpHidden as d}from"./server/config-gate.js";import{buildMcpSetupPageRoutes as f}from"./setup-page.js";const p=`@mcp`,m=`mcp/invalid-tool`,h=/\.(ts|js)$/u,g=/\.d\.ts$/u,_=/* @__PURE__ */ new Set([`search`,`list-apis`,`get-endpoints`,`get-endpoint-info`,`get-security-schemes`,`get-full-api-description`,`list-graphql-apis`,`get-graphql-type-list`,`get-graphql-type`,`get-graphql-schema`,`list-pages`,`get-page`,`grep-pages`,`whoami`,u,o,a,`describe-tools`,i,s,l]);function v(e){return`mcp-tool-file:${e}`}function y(e){if(g.test(e)||!h.test(e))return!1;let t=e.split(`/`),n=t.indexOf(p);return n!==-1&&n<t.length-1}function b(e,t,r){if(!n.test(e))return`Invalid MCP tool file "${t}": the tool name "${e}" is derived from the file name and may only contain letters, numbers, hyphens, and underscores (max 64 characters). Rename the file.`;if(r!==void 0)return`Duplicate MCP tool name "${e}": defined by both "${r}" and "${t}". Tool names are file names, so each file name must be unique across @mcp folders.`;if(_.has(e))return`Invalid MCP tool file "${t}": the tool name "${e}" is already used by a built-in MCP tool. Rename the file.`}function x(n){let i=[],a=[];if(d(n.config))return{entities:i,problems:a};if(!r(n.config,`customMcpTools`)){for(let{path:e}of n.files)a.push({...t(`Custom MCP tools`),location:{filePath:e}});return{entities:i,problems:a}}let o=/* @__PURE__ */ new Map;for(let{path:t}of n.files){let n=t.slice(t.lastIndexOf(`/`)+1).replace(h,``),r=b(n,t,o.get(n));if(r!==void 0){a.push({code:m,message:r,location:{filePath:t}});continue}o.set(n,t);let s={name:n,sourcePath:t};i.push(e(s,{stableKey:v(t),type:c,metadata:s}))}return{entities:i,problems:a}}const S={filter:{match:y},extractAll(e){return{routes:f(e.config),entities:[]}}};export{p as MCP_DIR_SEGMENT,m as MCP_TOOL_PROBLEM_CODE,_ as RESERVED_MCP_TOOL_NAMES,y as isMcpToolFile,S as mcpContent,v as mcpToolFileEntityKey,x as scanMcpToolFiles};
@@ -1 +1 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createInlineEntity as t}from"../../../loaders/define.js";import{runtimeFile as n}from"../../utils/runtime-file.js";import{runtimeTemplate as r}from"../../templates.js";import{collectVersionGroups as i,findVersionedDirectories as a}from"../../../versions/version-groups.js";import{MCP_CREDENTIALS_THEME_ENTITY_KEY as o,MCP_IGNORED_ROUTES_ENTITY_KEY as s}from"../../../../shared/constants/mcp.js";import{A2A_ROUTE as c,AGENT_CARD_ROUTE as l,MCP_AUTHORIZATION_SERVER_ROUTE as u,MCP_AUTHORIZE_ROUTE as d,MCP_CALLBACK_ROUTE as f,MCP_CREDENTIALS_ROUTE as p,MCP_PROTECTED_RESOURCE_ROUTE as m,MCP_REGISTER_ROUTE as h,MCP_ROUTE as g,MCP_SERVER_CARD_ROUTE as _,MCP_SETUP_TEMPLATE_ID as v,MCP_TOKEN_ROUTE as y,PUBLIC_MCP_ROUTE as b}from"./constants.js";import{buildMcpAppData as x}from"./app-data.js";import{readCredentialsTheme as S}from"./credentials-theme.js";import{mcpContent as C,scanMcpToolFiles as w}from"./content-tools.js";import{collectIgnoredRouteSlugs as T}from"./ignored-routes.js";import{findMcpRedirectConflict as E}from"./redirects.js";function D(e,t,n,r){return{path:e,auth:`manual`,...r?{method:r}:{},handler:{filePath:t,importer:import.meta.url,exportName:n}}}const O=[D(g,`./server/handler.ts`,`mcp`),D(b,`./server/handler.ts`,`mcpPublic`),D(_,`./server/server-card.ts`,`mcpServerCard`,`GET`),D(m,`./server/oauth/discovery.ts`,`oauthProtectedResource`,`GET`),D(u,`./server/oauth/discovery.ts`,`oauthAuthorizationServer`,`GET`),D(h,`./server/oauth/register.ts`,`mcpRegister`,`POST`),D(d,`./server/oauth/authorize.ts`,`mcpAuthorize`,`GET`),D(y,`./server/oauth/token.ts`,`mcpToken`,`POST`),D(f,`./server/oauth/callback.ts`,`mcpCallback`,`GET`),D(`${f}/*`,`./server/oauth/callback.ts`,`mcpCallback`,`GET`),D(f,`./server/oauth/callback.ts`,`mcpConsent`,`POST`),D(`${f}/*`,`./server/oauth/callback.ts`,`mcpConsent`,`POST`),D(p,`./server/gateway/credentials-handler.ts`,`mcpCredentials`,`ALL`),D(l,`./server/agent-card.ts`,`agentCard`,`GET`),D(c,`./server/agent-card.ts`,`a2a`,`POST`)],k=e({id:`internal.mcp`,version:`1.9.0`,content:C,server:{routes:O},templates:{[v]:r(n(`./client/template.tsx`,import.meta.url))},async finalize(e){let n=E(e.config.redirects);if(n)throw Error(`Redirect "${n.from}" references the reserved MCP route "${n.route}". Remove it: the MCP endpoints are served by the internal.mcp plugin and a redirect would shadow them.`);let r={mcp:x(e.config)},{entities:c,problems:l}=w(e),u=await S(e.io,e.config.palette,t=>e.logger.debug(t));c.push(t(u,{stableKey:o}));let d=e.config.mcp?.ignore??[];if(d.length===0)return{appData:r,problems:l,entities:c};let f=await i({io:e.io,routes:e.routes,versionedDirectories:a(e.routes.all())}),p=T(e.routes.all(),d,f,e.localeContext);return p.length===0?{appData:r,problems:l,entities:c}:(e.logger.debug(`mcp.ignore: hiding ${p.length} routes from the MCP tools`),c.push(t(p,{stableKey:s})),{appData:r,problems:l,entities:c})}});export{k as mcpContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{createInlineEntity as t}from"../../../loaders/define.js";import{runtimeFile as n}from"../../utils/runtime-file.js";import{runtimeTemplate as r}from"../../templates.js";import{collectVersionGroups as i,findVersionedDirectories as a}from"../../../versions/version-groups.js";import{MCP_CREDENTIALS_THEME_ENTITY_KEY as o,MCP_IGNORED_ROUTES_ENTITY_KEY as s}from"../../../../shared/constants/mcp.js";import{A2A_ROUTE as c,AGENT_CARD_ROUTE as l,MCP_AUTHORIZATION_SERVER_ROUTE as u,MCP_AUTHORIZE_ROUTE as d,MCP_CALLBACK_ROUTE as f,MCP_CREDENTIALS_ROUTE as p,MCP_PROTECTED_RESOURCE_ROUTE as m,MCP_REGISTER_ROUTE as h,MCP_ROUTE as g,MCP_SERVER_CARD_ROUTE as _,MCP_SETUP_TEMPLATE_ID as v,MCP_TOKEN_ROUTE as y,PUBLIC_MCP_ROUTE as b}from"./constants.js";import{buildMcpAppData as x}from"./app-data.js";import{readCredentialsTheme as S}from"./credentials-theme.js";import{mcpContent as C,scanMcpToolFiles as w}from"./content-tools.js";import{collectIgnoredRouteSlugs as T}from"./ignored-routes.js";import{findMcpRedirectConflict as E}from"./redirects.js";function D(e,t,n,r){return{path:e,auth:`manual`,...r?{method:r}:{},handler:{filePath:t,importer:import.meta.url,exportName:n}}}const O=[D(g,`./server/handler.ts`,`mcp`),D(b,`./server/handler.ts`,`mcpPublic`),D(_,`./server/server-card.ts`,`mcpServerCard`,`GET`),D(m,`./server/oauth/discovery.ts`,`oauthProtectedResource`,`GET`),D(u,`./server/oauth/discovery.ts`,`oauthAuthorizationServer`,`GET`),D(h,`./server/oauth/register.ts`,`mcpRegister`,`POST`),D(d,`./server/oauth/authorize.ts`,`mcpAuthorize`,`GET`),D(y,`./server/oauth/token.ts`,`mcpToken`,`POST`),D(f,`./server/oauth/callback.ts`,`mcpCallback`,`GET`),D(`${f}/*`,`./server/oauth/callback.ts`,`mcpCallback`,`GET`),D(f,`./server/oauth/callback.ts`,`mcpConsent`,`POST`),D(`${f}/*`,`./server/oauth/callback.ts`,`mcpConsent`,`POST`),D(p,`./server/gateway/credentials-handler.ts`,`mcpCredentials`,`ALL`),D(l,`./server/agent-card.ts`,`agentCard`,`GET`),D(c,`./server/agent-card.ts`,`a2a`,`POST`)],k=e({id:`internal.mcp`,version:`1.10.0`,content:C,server:{routes:O},templates:{[v]:r(n(`./client/template.tsx`,import.meta.url))},async finalize(e){let n=E(e.config.redirects);if(n)throw Error(`Redirect "${n.from}" references the reserved MCP route "${n.route}". Remove it: the MCP endpoints are served by the internal.mcp plugin and a redirect would shadow them.`);let r={mcp:x(e.config)},{entities:c,problems:l}=w(e),u=await S(e.io,e.config.palette,t=>e.logger.debug(t));c.push(t(u,{stableKey:o}));let d=e.config.mcp?.ignore??[];if(d.length===0)return{appData:r,problems:l,entities:c};let f=await i({io:e.io,routes:e.routes,versionedDirectories:a(e.routes.all())}),p=T(e.routes.all(),d,f,e.localeContext);return p.length===0?{appData:r,problems:l,entities:c}:(e.logger.debug(`mcp.ignore: hiding ${p.length} routes from the MCP tools`),c.push(t(p,{stableKey:s})),{appData:r,problems:l,entities:c})}});export{k as mcpContentPlugin};
@@ -1 +1 @@
1
- import{MCP_TOOLS_ENTITY_TYPE as e}from"../constants.js";import{publicOrigin as t}from"../../../utils/request-origin.js";import{isSubprocessError as n}from"../../../../../server/subprocess/runner.js";import{errorMessage as r}from"../../../../../shared/utils/error-message.js";import{ToolHandlerError as i}from"./tool-errors.js";import{fileURLToPath as a}from"node:url";import{parse as o}from"hono/utils/cookie";const s=a(import.meta.url);function c(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function l(e){return`MCP tool "${e}" is not registered or its module does not export a handler for "${e}". Expected \`export default { '${e}': handler }\` or a single tool definition with \`description\` and \`execute\` as the default export.`}function u(e,t){if(c(e))return typeof e.execute==`function`&&typeof e.description==`string`?e:e[t]}const d=/* @__PURE__ */ new Set([`text`,`image`,`audio`,`resource`,`resource_link`]);function f(e){return c(e)&&Array.isArray(e.content)&&e.content.every(e=>c(e)&&d.has(e.type))}function p(e,t){if(f(t))return t;if(typeof t==`string`)return{content:[{type:`text`,text:t}]};let n;try{n=JSON.stringify(t)}catch(t){throw Error(`MCP tool "${e}" returned a value that cannot be serialized to JSON: ${S(t)}`)}if(n===void 0)throw Error(`MCP tool "${e}" returned an invalid result.`);return{content:[{type:`text`,text:n}]}}const m={readFile:async()=>{throw Error(`Project files are not available in this environment.`)}};async function h(e,t){let n=u((await t.loadModule(e.handlerModulePath)).default,e.toolName),i=typeof n==`function`?n:n?.execute;if(typeof i!=`function`)return{ok:!1,code:`no-handler-export`,message:l(e.toolName)};let a={...e.context,fs:m};try{if(e.mode===`isAvailable`){let e=typeof n==`function`?void 0:n?.isAvailable;return{ok:!0,output:!e||await e(a)}}let t=await i(e.args,a,e.extra);return{ok:!0,output:p(e.toolName,t)}}catch(e){return{ok:!1,code:`handler-error`,message:r(e),stack:e instanceof Error?e.stack:void 0}}}function g(e){let n=e.request.viewer;return{user:{teams:e.request.teams,claims:e.claims??{...n},email:n?.email,idpAccessToken:void 0,idpId:void 0,isAuthenticated:n?.isAuthenticated??!1},config:e.config,baseUrl:t(e.request),params:{},query:Object.fromEntries(new URL(e.request.url).searchParams),cookies:o(e.request.headers.cookie??``),products:Object.values(e.config.products??{}).map(e=>e.name),accessToken:e.accessToken,metadata:e.metadata}}function _(e,t,n){if(!c(e)||e.type!==`object`)return null;let r=`Invalid arguments for tool "${n}":`;if(!c(t))return`${r} expected an object.`;let i=Array.isArray(e.required)?e.required:[];for(let e of i)if(typeof e==`string`&&!(e in t))return`${r} missing required field "${e}".`;let a=c(e.properties)?e.properties:{};for(let[e,n]of Object.entries(t)){let t=a[e];if(c(t)){if(typeof t.type==`string`&&!v(n,t.type))return`${r} field "${e}" must be ${t.type}.`;if(Array.isArray(t.enum)&&!t.enum.includes(n))return`${r} field "${e}" must be one of ${JSON.stringify(t.enum)}.`}}return null}function v(e,t){switch(t){case`string`:return typeof e==`string`;case`number`:return typeof e==`number`&&Number.isFinite(e);case`integer`:return typeof e==`number`&&Number.isInteger(e);case`boolean`:return typeof e==`boolean`;case`object`:return c(e);case`array`:return Array.isArray(e);case`null`:return e===null;default:return!0}}function y(e,t,n,r,i){if(!t.subprocess)throw Error(`MCP tool "${e.toolName}" cannot run on this host: no subprocess.`);return t.subprocess.run({modulePath:s,exportName:`invokeCustomTool`,input:{handlerModulePath:t.subprocess.resolveContentModule(e.handlerFilePath),toolName:e.toolName,mode:n,args:r,context:g(t),extra:{sessionId:i?.sessionId,requestId:i?.mcpReq.id??t.requestId,_meta:i?.mcpReq._meta}},timeoutMs:3e4})}function b(e,t){return{schema:e,isAvailable:t.hasAvailabilityGate?async n=>{if(!n.subprocess)return!1;let r=n.isAvailableMemo?.get(e.name);if(r)return r;let i=(async()=>{try{let e=await y(t,n,`isAvailable`);return e.ok&&e.output===!0}catch(t){return n.logger?.warn(`MCP tool "${e.name}" isAvailable failed: ${S(t)}`),!1}})();return n.isAvailableMemo?.set(e.name,i),i}:void 0,async execute(n,r,a){let o=_(t.argsSchema,n,e.name);if(o)throw Error(o);let s=await y(t,r,`execute`,n,a);if(!s.ok){let e=new i(s.message);throw e.stack=s.stack??e.stack,e}return s.output}}}function x(e){let{declaration:t}=e;return b({name:t.name,title:t.title,description:t.description,schema:t.schema,outputSchema:t.outputSchema,annotations:t.annotations},{toolName:t.name,handlerFilePath:e.handler.filePath,argsSchema:t.schema,hasAvailabilityGate:!0})}function S(e){return n(e)?`${e.code}: ${e.message}`:r(e)}function C(e,t){if(!c(t))return{ok:!1,errors:["the default export must be an object with `description` and `execute` properties. Move shared helper code outside the `@mcp` folder."]};let{description:n,inputSchema:r,outputSchema:i,annotations:a,isAvailable:o,execute:s}=t,l=[];return(typeof n!=`string`||n.trim()===``)&&l.push("`description` must be a non-empty string."),typeof s!=`function`&&l.push("`execute` must be a function."),r!==void 0&&(c(r)?r.type!==void 0&&r.type!==`object`&&l.push('`inputSchema.type` must be "object" because MCP tool arguments are named.'):l.push("`inputSchema` must be a JSON Schema object.")),i!==void 0&&!c(i)&&l.push("`outputSchema` must be a JSON Schema object."),a!==void 0&&!c(a)&&l.push("`annotations` must be an object."),o!==void 0&&typeof o!=`function`&&l.push("`isAvailable` must be a function."),l.length>0||typeof n!=`string`?{ok:!1,errors:l}:{ok:!0,schema:{name:e,description:n,schema:Object.assign({type:`object`},r??{properties:{}}),outputSchema:i,annotations:a},hasAvailabilityGate:typeof o==`function`}}async function w(t){let n=[],r=[];for(let i of await t.entities.list({type:e})){let{name:e,sourcePath:a}=i.metadata,o=e=>r.push(`Invalid MCP tool file "${a}": ${e}`);if(t.reservedNames.has(e)){o(`the tool name "${e}" is already used by a built-in MCP tool. Rename the file.`);continue}let s;try{s=(await t.loadContentModule(a)).default}catch(e){o(`the file failed to load: ${S(e)}. Tool files must not have module-level side effects.`);continue}let c=C(e,s);if(!c.ok){o(c.errors.join(` `));continue}n.push({schema:c.schema,sourcePath:a,hasAvailabilityGate:c.hasAvailabilityGate})}return{tools:n,errors:r}}function T(e){return`MCP tool "${e.schema.name}" in ${e.sourcePath} declares no \`outputSchema\`. Add one that describes the returned value.`}const E=/* @__PURE__ */ new Set;function D(e,t){e&&!E.has(t)&&(E.add(t),e.warn(t))}async function O(e){let{loadContentModule:t,logger:n}=e;if(!t)return[];let{tools:r,errors:i}=await w({entities:e.entities,loadContentModule:t,reservedNames:e.reservedNames});for(let e of i)D(n,e);for(let e of r)e.schema.outputSchema===void 0&&D(n,T(e));return r.map(e=>b(e.schema,{toolName:e.schema.name,handlerFilePath:e.sourcePath,argsSchema:e.schema.schema,hasAvailabilityGate:e.hasAvailabilityGate}))}export{O as buildMcpFileTools,x as createCustomTool,h as invokeCustomTool,w as loadMcpFileTools,T as missingOutputSchemaWarning,C as validateToolDefinition};
1
+ import{MCP_TOOLS_ENTITY_TYPE as e}from"../constants.js";import{publicOrigin as t}from"../../../utils/request-origin.js";import{errorMessage as n}from"../../../../../shared/utils/error-message.js";import{isSubprocessError as r}from"../../../../../server/subprocess/runner.js";import{ToolHandlerError as i}from"./tool-errors.js";import{fileURLToPath as a}from"node:url";import{parse as o}from"hono/utils/cookie";const s=a(import.meta.url);function c(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}function l(e){return`MCP tool "${e}" is not registered or its module does not export a handler for "${e}". Expected \`export default { '${e}': handler }\` or a single tool definition with \`description\` and \`execute\` as the default export.`}function u(e,t){if(c(e))return typeof e.execute==`function`&&typeof e.description==`string`?e:e[t]}const d=/* @__PURE__ */ new Set([`text`,`image`,`audio`,`resource`,`resource_link`]);function f(e){return c(e)&&Array.isArray(e.content)&&e.content.every(e=>c(e)&&d.has(e.type))}function p(e,t){if(f(t))return t;if(typeof t==`string`)return{content:[{type:`text`,text:t}]};let n;try{n=JSON.stringify(t)}catch(t){throw Error(`MCP tool "${e}" returned a value that cannot be serialized to JSON: ${S(t)}`)}if(n===void 0)throw Error(`MCP tool "${e}" returned an invalid result.`);return{content:[{type:`text`,text:n}]}}const m={readFile:async()=>{throw Error(`Project files are not available in this environment.`)}};async function h(e,t){let r=u((await t.loadModule(e.handlerModulePath)).default,e.toolName),i=typeof r==`function`?r:r?.execute;if(typeof i!=`function`)return{ok:!1,code:`no-handler-export`,message:l(e.toolName)};let a={...e.context,fs:m};try{if(e.mode===`isAvailable`){let e=typeof r==`function`?void 0:r?.isAvailable;return{ok:!0,output:!e||await e(a)}}let t=await i(e.args,a,e.extra);return{ok:!0,output:p(e.toolName,t)}}catch(e){return{ok:!1,code:`handler-error`,message:n(e),stack:e instanceof Error?e.stack:void 0}}}function g(e){let n=e.request.viewer;return{user:{teams:e.request.teams,claims:e.claims??{...n},email:n?.email,idpAccessToken:void 0,idpId:void 0,isAuthenticated:n?.isAuthenticated??!1},config:e.config,baseUrl:t(e.request),params:{},query:Object.fromEntries(new URL(e.request.url).searchParams),cookies:o(e.request.headers.cookie??``),products:Object.values(e.config.products??{}).map(e=>e.name),accessToken:e.accessToken,metadata:e.metadata}}function _(e,t,n){if(!c(e)||e.type!==`object`)return null;let r=`Invalid arguments for tool "${n}":`;if(!c(t))return`${r} expected an object.`;let i=Array.isArray(e.required)?e.required:[];for(let e of i)if(typeof e==`string`&&!(e in t))return`${r} missing required field "${e}".`;let a=c(e.properties)?e.properties:{};for(let[e,n]of Object.entries(t)){let t=a[e];if(c(t)){if(typeof t.type==`string`&&!v(n,t.type))return`${r} field "${e}" must be ${t.type}.`;if(Array.isArray(t.enum)&&!t.enum.includes(n))return`${r} field "${e}" must be one of ${JSON.stringify(t.enum)}.`}}return null}function v(e,t){switch(t){case`string`:return typeof e==`string`;case`number`:return typeof e==`number`&&Number.isFinite(e);case`integer`:return typeof e==`number`&&Number.isInteger(e);case`boolean`:return typeof e==`boolean`;case`object`:return c(e);case`array`:return Array.isArray(e);case`null`:return e===null;default:return!0}}function y(e,t,n,r,i){if(!t.subprocess)throw Error(`MCP tool "${e.toolName}" cannot run on this host: no subprocess.`);return t.subprocess.run({modulePath:s,exportName:`invokeCustomTool`,input:{handlerModulePath:t.subprocess.resolveContentModule(e.handlerFilePath),toolName:e.toolName,mode:n,args:r,context:g(t),extra:{sessionId:i?.sessionId,requestId:i?.mcpReq.id??t.requestId,_meta:i?.mcpReq._meta}},timeoutMs:3e4})}function b(e,t){return{schema:e,isAvailable:t.hasAvailabilityGate?async n=>{if(!n.subprocess)return!1;let r=n.isAvailableMemo?.get(e.name);if(r)return r;let i=(async()=>{try{let e=await y(t,n,`isAvailable`);return e.ok&&e.output===!0}catch(t){return n.logger?.warn(`MCP tool "${e.name}" isAvailable failed: ${S(t)}`),!1}})();return n.isAvailableMemo?.set(e.name,i),i}:void 0,async execute(n,r,a){let o=_(t.argsSchema,n,e.name);if(o)throw Error(o);let s=await y(t,r,`execute`,n,a);if(!s.ok){let e=new i(s.message);throw e.stack=s.stack??e.stack,e}return s.output}}}function x(e){let{declaration:t}=e;return b({name:t.name,title:t.title,description:t.description,schema:t.schema,outputSchema:t.outputSchema,annotations:t.annotations},{toolName:t.name,handlerFilePath:e.handler.filePath,argsSchema:t.schema,hasAvailabilityGate:!0})}function S(e){return r(e)?`${e.code}: ${e.message}`:n(e)}function C(e,t){if(!c(t))return{ok:!1,errors:["the default export must be an object with `description` and `execute` properties. Move shared helper code outside the `@mcp` folder."]};let{description:n,inputSchema:r,outputSchema:i,annotations:a,isAvailable:o,execute:s}=t,l=[];return(typeof n!=`string`||n.trim()===``)&&l.push("`description` must be a non-empty string."),typeof s!=`function`&&l.push("`execute` must be a function."),r!==void 0&&(c(r)?r.type!==void 0&&r.type!==`object`&&l.push('`inputSchema.type` must be "object" because MCP tool arguments are named.'):l.push("`inputSchema` must be a JSON Schema object.")),i!==void 0&&!c(i)&&l.push("`outputSchema` must be a JSON Schema object."),a!==void 0&&!c(a)&&l.push("`annotations` must be an object."),o!==void 0&&typeof o!=`function`&&l.push("`isAvailable` must be a function."),l.length>0||typeof n!=`string`?{ok:!1,errors:l}:{ok:!0,schema:{name:e,description:n,schema:Object.assign({type:`object`},r??{properties:{}}),outputSchema:i,annotations:a},hasAvailabilityGate:typeof o==`function`}}async function w(t){let n=[],r=[];for(let i of await t.entities.list({type:e})){let{name:e,sourcePath:a}=i.metadata,o=e=>r.push(`Invalid MCP tool file "${a}": ${e}`);if(t.reservedNames.has(e)){o(`the tool name "${e}" is already used by a built-in MCP tool. Rename the file.`);continue}let s;try{s=(await t.loadContentModule(a)).default}catch(e){o(`the file failed to load: ${S(e)}. Tool files must not have module-level side effects.`);continue}let c=C(e,s);if(!c.ok){o(c.errors.join(` `));continue}n.push({schema:c.schema,sourcePath:a,hasAvailabilityGate:c.hasAvailabilityGate})}return{tools:n,errors:r}}function T(e){return`MCP tool "${e.schema.name}" in ${e.sourcePath} declares no \`outputSchema\`. Add one that describes the returned value.`}const E=/* @__PURE__ */ new Set;function D(e,t){e&&!E.has(t)&&(E.add(t),e.warn(t))}async function O(e){let{loadContentModule:t,logger:n}=e;if(!t)return[];let{tools:r,errors:i}=await w({entities:e.entities,loadContentModule:t,reservedNames:e.reservedNames});for(let e of i)D(n,e);for(let e of r)e.schema.outputSchema===void 0&&D(n,T(e));return r.map(e=>b(e.schema,{toolName:e.schema.name,handlerFilePath:e.sourcePath,argsSchema:e.schema.schema,hasAvailabilityGate:e.hasAvailabilityGate}))}export{O as buildMcpFileTools,x as createCustomTool,h as invokeCustomTool,w as loadMcpFileTools,T as missingOutputSchemaWarning,C as validateToolDefinition};
@@ -1 +1 @@
1
- import"../constants.js";import{errorMessage as e}from"../../../../../shared/utils/error-message.js";import{innerToolErrorClass as t,thrownErrorClass as n}from"./tool-errors.js";import{isServerTelemetryEnabled as r}from"../../../../../server/telemetry/collector.js";import{sendServerEvent as i,sendServerEvents as a}from"../../../../../server/telemetry/sender.js";import{auditCode as o,auditInput as s,auditSha256 as c,auditStack as l,isCallToolResult as u,toolOutputText as d,toolResultText as f}from"./audit.js";import{SANDBOX_FAILURE as p}from"./codemode/constants.js";import{parseUserAgent as m,readListingSource as h}from"./mcp-client.js";import{randomUUID as g}from"node:crypto";import{ulid as _}from"ulid";const v={id:`docs`,object:`mcpServer`,uri:`urn:redocly:realm:mcp:server:docs`};function y(e){if(e===void 0)return;let t=c(e);return{id:t,object:`user`,uri:`urn:redocly:realm:mcp:subject:${t}`}}function b(i){let{mode:c,requestId:g,callerSubject:_,clientIp:b,logger:x}=i,S=i.env??process.env,C=r(S),w=y(_),{client:T,clientVersion:E}=m(i.userAgent),D=i.metadata.messageId,O={client:T,client_version:E,message_id:typeof D==`string`?D:void 0,listing_source:h(i.request)},j=[],M=/* @__PURE__ */ new Set,N=/* @__PURE__ */ new WeakSet,P=(e,t)=>{j.push({type:e,data:[t],requestId:g,time:/* @__PURE__ */ new Date,actor:w,clientIp:b})},F=t=>{try{t()}catch(t){x?.warn(`MCP telemetry failed: ${e(t)}`)}},I=(e,t,n)=>P(`com.redocly.mcpServer.toolCalled`,{...v,tool:e,mode:c,output_length:n,duration_ms:t,...O}),L=(e,t,n)=>{n.stack&&x?.error(`MCP tool ${e} failed (${n.error_class})`,{request_id:g,stack:n.stack}),P(`com.redocly.mcpServer.error`,{...v,tool:e,mode:c,duration_ms:t,message:s(n.message),stack:l(n.stack),error_class:n.error_class,...O})},R=async(n,r,i)=>{let a=Date.now(),o;try{o=await r()}catch(r){let o=t(r),s=o===`server_error`;throw i.set(e(r),{tool:n,reason:s?`server_error`:`inner_tool_error`}),F(()=>L(n,Date.now()-a,{message:e(r),stack:s&&r instanceof Error?r.stack??``:``,error_class:o})),r}return F(()=>I(n,Date.now()-a,d(o).length)),o};return{toolReturned(e,t,n){F(()=>{if(!u(n)||n.isError!==!0){I(e,t,d(n).length);return}N.has(n)||L(e,t,{message:f(n,` `),stack:``,error_class:e===`execute`?`sandbox_error`:`tool_error`})})},toolThrew(t,r,i){F(()=>{let a=n(i);L(t,r,{message:e(i),stack:a===`server_error`&&i instanceof Error?i.stack??``:``,error_class:a})})},trackCodeExecution(t,n){let r=Date.now(),i=o(t),a=/* @__PURE__ */ new Map,s=0;return{hostFetch:n&&(t=>(s+=1,n(t).catch(t=>{throw a.set(e(t),{reason:`runtime_error`}),t}))),innerToolCall(e,t){let n=R(e,t,a),r=n.then(()=>void 0,()=>void 0);return M.add(r),r.then(()=>M.delete(r)),n},finish(e,t,n){let o=e.failure===p.HostError&&e.error!==void 0?a.get(e.error):void 0;o?.tool&&N.add(t);let c=e.error===void 0?`ok`:`error`,l=Date.now()-r,u=k(e.failure,o,n),d=o?.tool;F(()=>P(`com.redocly.mcpServer.codeExecuted`,{...v,code_sha256:i.sha256,code_length:i.length,fetch_count:s,outcome:c,flags:i.flags,duration_ms:l,failure_reason:u,failed_tool:d,...O})),x?.info(`Gateway MCP code executed [${i.sha256.slice(0,12)}] outcome=${c} codeLength=${i.length} fetchCount=${s}`+(i.flags?` flags=${i.flags}`:``)+` durationMs=${l}`+(u?` failureReason=${u}`:``)+(d?` failedTool=${d}`:``))}}},gatewayFetchPerformed({host:e,method:t,outcome:n,durationMs:r,path:i,api:a,status:o,bytes:s,injectedScheme:c}){F(()=>P(`com.redocly.mcpServer.gatewayFetchPerformed`,{...v,host:e,method:t,outcome:n,path:i,api:a,status:o,injected_scheme:c,bytes:s,duration_ms:r})),x?.info(`Gateway MCP fetch [${t} ${e}] outcome=${n}`+(i===void 0?``:` path=${i}`)+(a===void 0?``:` api=${a}`)+(o===void 0?``:` status=${o}`)+(c===void 0?``:` injectedScheme=${c}`)+(s===void 0?``:` bytes=${s}`)+` durationMs=${r}`)},gatewayFetchRateLimited({scope:e,limit:t,retryAfterSeconds:n}){F(()=>P(`com.redocly.mcpServer.gatewayFetchRateLimited`,{...v,scope:e,retry_after_seconds:n,limit:t}))},async flush(){if(!C){j=[];return}await A(M,300);let e=j;j=[],await a(e,{env:S,fetcher:i.fetcher,logger:x})}}}function x(e,t){let{requestId:n=g(),callerSubject:r,clientIp:a}=t.caller??{};return i({...e,requestId:n,actor:y(r),clientIp:a},t)}function S(e,t,n={}){return x({type:`com.redocly.mcpServer.error`,data:[{...v,message:s(e instanceof Error?e.message:``),stack:l(e instanceof Error?e.stack??``:``),error_class:`server_error`,mode:t}]},n)}function C({scope:e,retryAfterSeconds:t,limit:n},r={}){return x({type:`com.redocly.mcpServer.rateLimited`,data:[{...v,scope:e,retry_after_seconds:t,limit:n}]},r)}function w(e){let t=e||_(),n=t.startsWith(`mcp_`)?t:`mcp_${t}`;return{id:n,object:`mcpSession`,uri:`urn:redocly:realm:mcp:session:${n}`}}function T(e,t,n={}){return x({type:`com.redocly.mcpServerAuthorization.started`,data:[{...w(e),redirect_uri:t}]},n)}function E(e,t,n={}){return x({type:`com.redocly.mcpServerAuthorization.completed`,data:[{...w(e),redirect_uri:t}]},n)}function D(e,t,n,r,i={}){return x({type:`com.redocly.mcpServerAuthorization.failed`,data:[{...w(e),error:n,error_details:r,error_class:t}]},i)}function O(e={}){return x({type:`com.redocly.mcpServerCard.served`,data:{id:`mcpServerCardId`,object:`mcpServerCard`,uri:`urn:redocly:realm:api:mcpServerCard:mcpServerCardId`},signal:`trace`},e)}function k(e,t,n){return e===p.HostError?t?.reason??p.RuntimeError:e===p.RuntimeError&&n!==void 0?`unknown_tool`:e}async function A(e,t){if(e.size===0)return;let n;await Promise.race([Promise.allSettled(e),new Promise(e=>{n=setTimeout(e,t)})]),clearTimeout(n)}export{b as createMcpTelemetry,E as sendMcpAuthorizationCompleted,D as sendMcpAuthorizationFailed,T as sendMcpAuthorizationStarted,C as sendMcpRateLimited,S as sendMcpRequestError,O as sendMcpServerCardServed};
1
+ import"../constants.js";import{errorMessage as e}from"../../../../../shared/utils/error-message.js";import{isServerTelemetryEnabled as t}from"../../../../../server/telemetry/collector.js";import{sendServerEvent as n,sendServerEvents as r}from"../../../../../server/telemetry/sender.js";import{innerToolErrorClass as i,thrownErrorClass as a}from"./tool-errors.js";import{auditCode as o,auditInput as s,auditSha256 as c,auditStack as l,isCallToolResult as u,toolOutputText as d,toolResultText as f}from"./audit.js";import{SANDBOX_FAILURE as p}from"./codemode/constants.js";import{parseUserAgent as m,readListingSource as h}from"./mcp-client.js";import{randomUUID as g}from"node:crypto";import{ulid as _}from"ulid";const v={id:`docs`,object:`mcpServer`,uri:`urn:redocly:realm:mcp:server:docs`};function y(e){if(e===void 0)return;let t=c(e);return{id:t,object:`user`,uri:`urn:redocly:realm:mcp:subject:${t}`}}function b(n){let{mode:c,requestId:g,callerSubject:_,clientIp:b,logger:x}=n,S=n.env??process.env,C=t(S),w=y(_),{client:T,clientVersion:E}=m(n.userAgent),D=n.metadata.messageId,O={client:T,client_version:E,message_id:typeof D==`string`?D:void 0,listing_source:h(n.request)},j=[],M=/* @__PURE__ */ new Set,N=/* @__PURE__ */ new WeakSet,P=(e,t)=>{j.push({type:e,data:[t],requestId:g,time:/* @__PURE__ */ new Date,actor:w,clientIp:b})},F=t=>{try{t()}catch(t){x?.warn(`MCP telemetry failed: ${e(t)}`)}},I=(e,t,n)=>P(`com.redocly.mcpServer.toolCalled`,{...v,tool:e,mode:c,output_length:n,duration_ms:t,...O}),L=(e,t,n)=>{n.stack&&x?.error(`MCP tool ${e} failed (${n.error_class})`,{request_id:g,stack:n.stack}),P(`com.redocly.mcpServer.error`,{...v,tool:e,mode:c,duration_ms:t,message:s(n.message),stack:l(n.stack),error_class:n.error_class,...O})},R=async(t,n,r)=>{let a=Date.now(),o;try{o=await n()}catch(n){let o=i(n),s=o===`server_error`;throw r.set(e(n),{tool:t,reason:s?`server_error`:`inner_tool_error`}),F(()=>L(t,Date.now()-a,{message:e(n),stack:s&&n instanceof Error?n.stack??``:``,error_class:o})),n}return F(()=>I(t,Date.now()-a,d(o).length)),o};return{toolReturned(e,t,n){F(()=>{if(!u(n)||n.isError!==!0){I(e,t,d(n).length);return}N.has(n)||L(e,t,{message:f(n,` `),stack:``,error_class:e===`execute`?`sandbox_error`:`tool_error`})})},toolThrew(t,n,r){F(()=>{let i=a(r);L(t,n,{message:e(r),stack:i===`server_error`&&r instanceof Error?r.stack??``:``,error_class:i})})},trackCodeExecution(t,n){let r=Date.now(),i=o(t),a=/* @__PURE__ */ new Map,s=0;return{hostFetch:n&&(t=>(s+=1,n(t).catch(t=>{throw a.set(e(t),{reason:`runtime_error`}),t}))),innerToolCall(e,t){let n=R(e,t,a),r=n.then(()=>void 0,()=>void 0);return M.add(r),r.then(()=>M.delete(r)),n},finish(e,t,n){let o=e.failure===p.HostError&&e.error!==void 0?a.get(e.error):void 0;o?.tool&&N.add(t);let c=e.error===void 0?`ok`:`error`,l=Date.now()-r,u=k(e.failure,o,n),d=o?.tool;F(()=>P(`com.redocly.mcpServer.codeExecuted`,{...v,code_sha256:i.sha256,code_length:i.length,fetch_count:s,outcome:c,flags:i.flags,duration_ms:l,failure_reason:u,failed_tool:d,...O})),x?.info(`Gateway MCP code executed [${i.sha256.slice(0,12)}] outcome=${c} codeLength=${i.length} fetchCount=${s}`+(i.flags?` flags=${i.flags}`:``)+` durationMs=${l}`+(u?` failureReason=${u}`:``)+(d?` failedTool=${d}`:``))}}},gatewayFetchPerformed({host:e,method:t,outcome:n,durationMs:r,path:i,api:a,status:o,bytes:s,injectedScheme:c}){F(()=>P(`com.redocly.mcpServer.gatewayFetchPerformed`,{...v,host:e,method:t,outcome:n,path:i,api:a,status:o,injected_scheme:c,bytes:s,duration_ms:r})),x?.info(`Gateway MCP fetch [${t} ${e}] outcome=${n}`+(i===void 0?``:` path=${i}`)+(a===void 0?``:` api=${a}`)+(o===void 0?``:` status=${o}`)+(c===void 0?``:` injectedScheme=${c}`)+(s===void 0?``:` bytes=${s}`)+` durationMs=${r}`)},gatewayFetchRateLimited({scope:e,limit:t,retryAfterSeconds:n}){F(()=>P(`com.redocly.mcpServer.gatewayFetchRateLimited`,{...v,scope:e,retry_after_seconds:n,limit:t}))},async flush(){if(!C){j=[];return}await A(M,300);let e=j;j=[],await r(e,{env:S,fetcher:n.fetcher,logger:x})}}}function x(e,t){let{requestId:r=g(),callerSubject:i,clientIp:a}=t.caller??{};return n({...e,requestId:r,actor:y(i),clientIp:a},t)}function S(e,t,n={}){return x({type:`com.redocly.mcpServer.error`,data:[{...v,message:s(e instanceof Error?e.message:``),stack:l(e instanceof Error?e.stack??``:``),error_class:`server_error`,mode:t}]},n)}function C({scope:e,retryAfterSeconds:t,limit:n},r={}){return x({type:`com.redocly.mcpServer.rateLimited`,data:[{...v,scope:e,retry_after_seconds:t,limit:n}]},r)}function w(e){let t=e||_(),n=t.startsWith(`mcp_`)?t:`mcp_${t}`;return{id:n,object:`mcpSession`,uri:`urn:redocly:realm:mcp:session:${n}`}}function T(e,t,n={}){return x({type:`com.redocly.mcpServerAuthorization.started`,data:[{...w(e),redirect_uri:t}]},n)}function E(e,t,n={}){return x({type:`com.redocly.mcpServerAuthorization.completed`,data:[{...w(e),redirect_uri:t}]},n)}function D(e,t,n,r,i={}){return x({type:`com.redocly.mcpServerAuthorization.failed`,data:[{...w(e),error:n,error_details:r,error_class:t}]},i)}function O(e={}){return x({type:`com.redocly.mcpServerCard.served`,data:{id:`mcpServerCardId`,object:`mcpServerCard`,uri:`urn:redocly:realm:api:mcpServerCard:mcpServerCardId`},signal:`trace`},e)}function k(e,t,n){return e===p.HostError?t?.reason??p.RuntimeError:e===p.RuntimeError&&n!==void 0?`unknown_tool`:e}async function A(e,t){if(e.size===0)return;let n;await Promise.race([Promise.allSettled(e),new Promise(e=>{n=setTimeout(e,t)})]),clearTimeout(n)}export{b as createMcpTelemetry,E as sendMcpAuthorizationCompleted,D as sendMcpAuthorizationFailed,T as sendMcpAuthorizationStarted,C as sendMcpRateLimited,S as sendMcpRequestError,O as sendMcpServerCardServed};
@@ -5,7 +5,8 @@ export declare const REACT_PAGE_SEARCH_LOADER_KEY = "search";
5
5
  /**
6
6
  * Gives each `.page.tsx` or `.page.ts` file a route whose `template` is a `source:` reference
7
7
  * to the file itself. Such a file is its own template, so it needs no template registration.
8
- * An `export const frontmatter = { ... }` literal becomes the route metadata, and its `slug`
9
- * (a string or a list) the explicit route slugs: one route for each.
8
+ * An `export const frontmatter = { ... }` literal becomes the route metadata, its `slug`
9
+ * (a string or a list) the explicit route slugs: one route for each, and its `seo.title` the
10
+ * label of a sidebar entry that names none.
10
11
  */
11
12
  export declare const reactPageContentPlugin: import("../../types/plugin.js").ContentPlugin;
@@ -1 +1 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t}from"../../../loaders/define.js";import{createPluginScopedId as n}from"../../utils/scoped-id.js";import{SEARCH_GROUP_FACET_FIELD as r}from"../../../../shared/search/facets.js";import{configuredFacetFields as i,extractFacetsFromFrontmatter as a,invalidFacetValueProblems as o,searchCategoryOf as s}from"../../../search/facet-values.js";import{isObject as c}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as l}from"../../../../shared/utils/routes/normalize-route-slug.js";import{notInPlanProblem as u}from"../../../plan-gates.js";import{filePathToRouteSlug as d}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{isPlanFeatureGranted as f}from"../../../../shared/plan-gates.js";import{isInternalPagePath as p}from"../../utils/internal-page-path.js";import{parseExplicitSlugs as m}from"../../utils/explicit-slugs.js";import{SOURCE_TEMPLATE_PREFIX as h}from"../../../../shared/constants/template-ids.js";import{readPageFrontmatter as g}from"./frontmatter.js";const _=[`.page.tsx`,`.page.ts`],v=`internal.react-page`,y=`search`,b=t(n(v,`search`),async e=>({value:e.args}),{searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let{category:n,isInvalid:c}=s(t.route.metadata),{facets:l,invalidFields:u}=a(t.route.metadata,i(t.config));return{docs:[{docKey:`page`,routeSlug:t.route.slug,title:e.title,text:e.text,groupKey:n??`Documentation`,facets:l}],problems:o([...u,...c?[r]:[]],t.route.originFilePath)}}});function x(e){if(e.excludeFromSearch===!0)return;let t=c(e.search)?e.search:{},n=c(e.seo)?e.seo:{},r=e=>typeof e==`string`?e.trim():``,i=r(t.title)||r(n.title)||r(e.title),a=r(t.description)||r(n.description)||r(e.description);if(i!==``||a!==``)return{title:i,text:[a,...Array.isArray(t.keywords)?t.keywords.filter(e=>typeof e==`string`):[]].filter(e=>e!==``).join(` `)}}const S=t(n(v,`seo`),async e=>{let{result:t,entityDeps:n,assetUsages:r}=await e.markdown.resolveImageReference(e.args.image,e.file.path);return t.kind===`assetRef`?{value:{image:t.url},entityDeps:n,assetUsages:r}:{value:{image:e.args.image},entityDeps:n}}),C=e({id:v,version:`1.11.0`,loaders:[S,b],content:{filter:{extensions:_},async extractFile(e,t){if(p(e.path))return{routes:[]};if(!f(t.config,`reactPages`))return{routes:[],problems:[u(`React pages`)]};let{frontmatter:n,error:r}=g(await t.io.readFile(e.path));r!==void 0&&t.logger.warn(`Ignoring the frontmatter export of a page component`,{path:e.path,error:r});let i=m(n?.slug),a=c(n?.seo)&&typeof n.seo.image==`string`?n.seo.image:void 0,o=n===null?void 0:x(n),s={};a!==void 0&&(s.seo=S.withArgs({filePath:e.path,image:a})),o!==void 0&&(s[y]=b.withArgs(o,{stableKey:`react-page:search:${e.path}`}));let _=Object.keys(s).length===0?void 0:s,v=`${h}${e.path}`;return{routes:i.length>0?i.map(e=>({routeId:`page`,slug:l(e),template:v,metadata:n??void 0,deps:_})):[{routeId:`page`,slugHint:d(e.path,w(e.path)),template:v,metadata:n??void 0,deps:_}]}}}});function w(e){return e.toLowerCase().endsWith(`.page.ts`)?`.page.ts`:`.page.tsx`}export{y as REACT_PAGE_SEARCH_LOADER_KEY,C as reactPageContentPlugin};
1
+ import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t,createInlineEntity as n}from"../../../loaders/define.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import{SEARCH_GROUP_FACET_FIELD as i}from"../../../../shared/search/facets.js";import{configuredFacetFields as a,extractFacetsFromFrontmatter as o,invalidFacetValueProblems as s,searchCategoryOf as c}from"../../../search/facet-values.js";import{isObject as l}from"../../../../shared/utils/is-object.js";import{normalizeRouteSlug as u}from"../../../../shared/utils/routes/normalize-route-slug.js";import{notInPlanProblem as d}from"../../../plan-gates.js";import{filePathToRouteSlug as f}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{isPlanFeatureGranted as p}from"../../../../shared/plan-gates.js";import{isInternalPagePath as m}from"../../utils/internal-page-path.js";import{parseExplicitSlugs as h}from"../../utils/explicit-slugs.js";import{SOURCE_TEMPLATE_PREFIX as g}from"../../../../shared/constants/template-ids.js";import{curationKeywordsOf as _}from"../../../search/keywords.js";import{readPageFrontmatter as v}from"./frontmatter.js";const y=[`.page.tsx`,`.page.ts`],b=`internal.react-page`,x=`search`,S=t(r(b,`search`),async e=>({value:e.args}),{searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let{category:n,isInvalid:r}=c(t.route.metadata),{facets:l,invalidFields:u}=o(t.route.metadata,a(t.config)),d={docKey:`page`,routeSlug:t.route.slug,title:e.title,text:e.text,groupKey:n??`Documentation`,facets:l};return e.keywords!==void 0&&(d.keywords=e.keywords),{docs:[d],problems:s([...u,...r?[i]:[]],t.route.originFilePath)}}});function C(e){if(e.excludeFromSearch===!0)return;let t=l(e.search)?e.search:{},n=l(e.seo)?e.seo:{},r=e=>typeof e==`string`?e.trim():``,i=r(t.title)||r(n.title)||r(e.title),a=r(t.description)||r(n.description)||r(e.description);if(i===``&&a===``)return;let o={title:i,text:[a,...Array.isArray(t.keywords)?t.keywords.filter(e=>typeof e==`string`):[]].filter(e=>e!==``).join(` `)},s=_(t.keywords);return s!==void 0&&(o.keywords=s),o}const w=t(r(b,`seo`),async e=>{let{result:t,entityDeps:n,assetUsages:r}=await e.markdown.resolveImageReference(e.args.image,e.file.path);return t.kind===`assetRef`?{value:{image:t.url},entityDeps:n,assetUsages:r}:{value:{image:e.args.image},entityDeps:n}}),T=e({id:b,version:`1.13.0`,loaders:[w,S],content:{filter:{extensions:y},async extractFile(e,t){if(m(e.path))return{routes:[]};if(!p(t.config,`reactPages`))return{routes:[],problems:[d(`React pages`)]};let{frontmatter:r,error:i}=v(await t.io.readFile(e.path));i!==void 0&&t.logger.warn(`Ignoring the frontmatter export of a page component`,{path:e.path,error:i});let a=h(r?.slug),o=l(r?.seo)&&typeof r.seo.image==`string`?r.seo.image:void 0,s=r===null?void 0:C(r),c={};o!==void 0&&(c.seo=w.withArgs({filePath:e.path,image:o})),s!==void 0&&(c[x]=S.withArgs(s,{stableKey:`react-page:search:${e.path}`}));let _=Object.keys(c).length===0?void 0:c,y=`${g}${e.path}`,b=l(r?.seo)?r.seo.title:void 0,T=typeof b==`string`&&b.trim()!==``?n({label:b}):void 0;return{routes:a.length>0?a.map(e=>({routeId:`page`,slug:u(e),template:y,metadata:r??void 0,deps:_,sidebarSubtree:T})):[{routeId:`page`,slugHint:f(e.path,E(e.path)),template:y,metadata:r??void 0,deps:_,sidebarSubtree:T}]}}}});function E(e){return e.toLowerCase().endsWith(`.page.ts`)?`.page.ts`:`.page.tsx`}export{x as REACT_PAGE_SEARCH_LOADER_KEY,T as reactPageContentPlugin};
@@ -1,6 +1,7 @@
1
1
  import type { REDOCLY_TEAMS_RBAC } from '@redocly/config';
2
2
  import type { NAV_ITEM_RBAC, RbacScope } from '../../../../server/rbac/types.js';
3
3
  import type { Logger } from '../../../../shared/logger.js';
4
+ import type { SidebarItemType } from '../../../../shared/types/sidebar.js';
4
5
  import type { ProblemDraft } from '../../../problems/types.js';
5
6
  import { type LinkRefDraft } from '../../../link-checker/classify.js';
6
7
  import type { RouteIndex } from '../../utils/route-index.js';
@@ -11,7 +12,7 @@ export type SidebarBadge = {
11
12
  position?: 'before' | 'after';
12
13
  };
13
14
  export type BundledSidebarNode = {
14
- type?: 'separator';
15
+ type?: SidebarItemType;
15
16
  label?: string;
16
17
  /** The theme shows this key's translation, `label` when it has none. */
17
18
  labelTranslationKey?: string;
@@ -1 +1 @@
1
- import{L10N_DIR as e}from"../../../../shared/constants/l10n/defaults.js";import{isObject as t}from"../../../../shared/utils/is-object.js";import"../../../../shared/utils/l10n.js";import{resolveContentPath as n}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as r}from"../assets/extensions.js";import{splitUrlSuffix as i}from"../../../../shared/utils/routes/split-url-suffix.js";import{toNavItemRbacAnnotation as a}from"../../../../server/rbac/filter.js";import{resolvePageTarget as o}from"../../../../shared/utils/routes/resolve-page-target.js";import{collectVersionGroups as s,findVersionedDirectories as c}from"../../../versions/version-groups.js";import{joinSrcSet as l,parseSrcSet as u}from"../assets/srcset.js";import{classifyLinkTarget as d}from"../../../link-checker/classify.js";import{posix as f}from"node:path";import p from"js-yaml";function m(e){return typeof e.tab==`string`}function h(e,t,n){e.report?.({code:t,message:n,location:{filePath:e.file.path}})}function g(e,r){let i=p.load(e);if(!Array.isArray(i))return[];let a=[],o=e=>{if(t(e)){if(typeof e.$ref==`string`){let t=n(e.$ref,r);t!==null&&a.push(t)}if(Array.isArray(e.items))for(let t of e.items)o(t);if(m(e)&&Array.isArray(e.menu))for(let t of e.menu)o(t)}};for(let e of i)o(e);return a}async function _(e){let t=p.load(e.source);if(!Array.isArray(t))return[];let n=[];return await v({entries:t,ownerFilePath:e.filePath,currentFilePath:e.filePath,readFile:e.readFile,visitedRefs:/* @__PURE__ */ new Set([e.filePath]),refs:n}),n}async function v(e){let{ownerFilePath:t,currentFilePath:r,readFile:i,refs:a}=e;for(let o of e.entries){let s=W(o);if(s===void 0)continue;if(typeof s.$ref==`string`){let o=n(s.$ref,r);if(o===null||i===void 0||e.visitedRefs.has(o))continue;let c;try{c=await i(o)}catch{continue}let l=p.load(c);if(!Array.isArray(l))continue;let u=new Set(e.visitedRefs);u.add(o),await v({entries:l,ownerFilePath:t,currentFilePath:o,readFile:i,visitedRefs:u,refs:a});continue}let c=typeof s.page==`string`?s.page:s.href;typeof c==`string`&&y(a,c,r,t),Array.isArray(s.items)&&await v({...e,entries:s.items}),m(s)&&Array.isArray(s.menu)&&await v({...e,entries:s.menu})}}function y(e,t,n,r){let i=d(t,n);i!==null&&e.push({kind:`link`,raw:t,...i,...n===r?{}:{filePath:n}})}async function b(e){let t=p.load(e.source);if(!Array.isArray(t))throw Error(`Sidebar "${e.file.path}" must be a YAML sequence at the top level.`);return x({...e,entries:t})}async function x(e){let n=e.entries,r=n.filter(e=>t(e)&&m(e));if(r.length>0&&r.length!==n.length)throw Error(`Sidebar "${e.file.path}": when a sidebar uses navigation tabs, every top-level entry must be a tab (found ${n.length-r.length} other entries).`);let i={file:e.file,routes:e.routes,assignedRouteSlugs:/* @__PURE__ */ new Set,versionedDirectories:/* @__PURE__ */ new Set,report:e.report,readFile:e.readFile,skipRoutes:e.skipRoutes,exists:e.exists,sidebarByDirectory:e.sidebarByDirectory??/* @__PURE__ */ new Map,visitedRefs:/* @__PURE__ */ new Set([e.file.path])},a=[];if(r.length>0){for(let[e,t]of r.entries())a.push(await M({...i,entry:t,tabIndex:e}));F({file:e.file,tabs:a,routes:e.routes})}else for(let e of n)a.push(...await S({...i,entry:e}));return{assignedRouteSlugs:[...i.assignedRouteSlugs].sort(),versionedDirectories:[...i.versionedDirectories].sort(),nodes:a}}async function S(e){let n=await C(e),r=t(e.entry)?e.entry.rbac:void 0;if(r===void 0)return n;let i=P({...e,rbac:r});for(let e of n)Object.assign(e,i);return n}async function C(e){let t=W(e.entry);if(t===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar entry ${U(e.entry)} is not a page reference or a group.`),[];if(m(t))throw Error(`Sidebar "${e.file.path}": "tab" is only allowed at the top level (found nested tab "${t.tab}").`);if(t.menu!==void 0)throw Error(`Sidebar "${e.file.path}": "menu" is only allowed directly on a tab.`);if(typeof t.$ref==`string`)return T({...e,ref:t.$ref});if(typeof t.directory==`string`&&K(t.group)!==void 0&&t.items===void 0)return C({...e,entry:{...t,directory:void 0,items:[{directory:t.directory,flatten:t.flatten}]}});if(typeof t.directory==`string`){let r=n(t.directory,e.file.path);if(r===null)return h(e,`sidebar/invalid-entry`,`Sidebar directory "${t.directory}" is outside the content root.`),[];let i=e.routes.inDirectory(r);i.length===0&&h(e,`sidebar/missing-target`,`Sidebar directory "${t.directory}" has no pages.`);let a=await L({...e,directoryPath:r,flatten:t.flatten===!0,pages:i.filter(t=>!e.skipRoutes?.has(t.slug))}),o=K(t.group)??K(t.label);return o===void 0?a:[{...J(t,e),menuStyle:Y(t),items:a.length>0?a:void 0,label:o,labelTranslationKey:w(t)}]}if(typeof t.separator==`string`)return[{type:`separator`,...J(t,e),label:t.separator,labelTranslationKey:K(t.separatorTranslationKey)}];let r=await z(t,e),i=r.route;if(i)for(let t of c([i]))e.versionedDirectories.add(t);let a;if(Array.isArray(t.items)){a=[];for(let n of t.items)a.push(...await S({...e,entry:n}))}let o=K(t.group)??K(t.label)??(i===void 0?K(t.href):void 0)??r.anchor,s=K(t.group)!==void 0;return[{...J(t,e),menuStyle:s?Y(t):void 0,external:t.external===!0||void 0,languageInsensitive:r.languageInsensitive?!0:void 0,items:a&&a.length>0?a:void 0,label:o,labelTranslationKey:w(t),link:r.link,isGroup:s?!0:void 0,version:K(t.version)??i?.version??void 0,versionGroup:i?.versionGroup??void 0}]}function w(e){return K(K(e.group)===void 0?e.labelTranslationKey:e.groupTranslationKey)}async function T(e){let{ref:t}=e,r=n(t,e.file.path);if(r===null)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is outside the content root.`),[];if(e.readFile===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is not supported here.`),[];if(e.visitedRefs.has(r))return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${r}" includes itself.`),[];let i;try{i=await e.readFile(r)}catch{return h(e,`sidebar/missing-target`,`Sidebar $ref "${r}" could not be read.`),[]}let a=p.load(i);return Array.isArray(a)?E(e,r,a):(h(e,`sidebar/invalid-entry`,`Sidebar $ref "${r}" must be a YAML sequence.`),[])}async function E(e,t,n){let r=/* @__PURE__ */ new Set([...e.visitedRefs,t]),i=[];for(let a of n)i.push(...await S({...e,entry:a,file:{path:t},visitedRefs:r}));return i}async function D(e,t){if(e.readFile===void 0)return[];let n=p.load(await e.readFile(t));return Array.isArray(n)?E({...e,assignedRouteSlugs:/* @__PURE__ */ new Set,report:void 0},t,n.map(O)):[]}function O(e){if(!t(e)||!m(e))return e;let{tab:n,menu:r,...i}=e;return{...i,group:n,items:i.items??r}}function k(e,t){return`${e}-${t.normalize(`NFKD`).replace(/[\u0300-\u036f]/g,``).toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|(?<!-)-+$/g,``)||`tab`}`}function A(e){return/* @__PURE__ */ Error(`Sidebar "${e.file.path}": tab "${e.label}" ${e.message}.`)}function j(e){let{file:t,entry:n}=e,r=n.tab,i=n.menu!==void 0;if(i&&n.items!==void 0)throw A({file:t,label:r,message:`cannot have both "menu" and "items"`});if(i&&n.page!==void 0)throw A({file:t,label:r,message:`has "menu" and cannot also have "page"`});if(!i&&n.page===void 0)throw A({file:t,label:r,message:`needs "page" or "menu"`});if(typeof n.page==`string`&&n.page.includes(`#`))throw A({file:t,label:r,message:`page must not contain a heading anchor`});if(i&&!Array.isArray(n.menu))throw A({file:t,label:r,message:`"menu" must be a list of entries`});if(i&&Array.isArray(n.menu)&&n.menu.length===0)throw A({file:t,label:r,message:`has an empty "menu"`});if(n.$ref!==void 0||n.directory!==void 0||n.group!==void 0||n.href!==void 0)throw A({file:t,label:r,message:`accepts only "page", "items", "menu" and "icon"; move "$ref"/"directory"/"group"/"href" into "items"`})}async function M(e){let{entry:t}=e,n=t.tab;j({file:e.file,entry:t});let r=k(e.tabIndex,n);if(t.menu!==void 0){let i=Array.isArray(t.menu)?t.menu:[],a=[];for(let[t,n]of i.entries()){let i=await N({...e,tabId:r,index:t,raw:n});i!==void 0&&a.push(i)}return{tab:!0,tabId:r,label:n,menu:a,...X(t.icon,e),...P({...e,rbac:t.rbac})}}let[i]=await S({...e,entry:{page:t.page,label:n,items:t.items,rbac:t.rbac}}),a=i?.items??[];return{...i,tab:!0,tabId:r,...X(t.icon,e),items:a}}async function N(e){let{file:t,entry:n,tabId:r,index:i,raw:a}=e,o=n.tab,s=W(a);if(s===void 0||typeof s.page!=`string`)throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" needs "page".`);if(s.page.includes(`#`))throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" page must not contain a heading anchor.`);let c=`${r}/${i}`,[l]=await S({...e,entry:s});return l?.link===void 0?void 0:{...l,tabId:c,items:l.items??[]}}function P(e){return a(e.rbac,()=>h(e,`sidebar/invalid-entry`,`Sidebar entry has an invalid "rbac" value, so it is hidden.`))}function F(e){let t=/* @__PURE__ */ new Map,n=(n,r)=>{for(let i of r){let r=t.get(i);if(r!==void 0&&r.tabId!==n.tabId)throw Error(`Sidebar "${e.file.path}": route "${i}" is claimed by two navigation tabs, "${r.label}" and "${n.label}". A route can belong to one tab only.`);t.set(i,n)}};for(let t of e.tabs){if(t.menu!==void 0){for(let r of t.menu)r.tabId!==void 0&&n({tabId:r.tabId,label:`${t.label} > ${r.label??r.link}`},I({routes:e.routes,link:r.link,items:r.items}));continue}t.tabId!==void 0&&n({tabId:t.tabId,label:t.label??t.link??``},I({routes:e.routes,link:t.link,items:t.items}))}}function I(e){let t=[],n=n=>{if(n.link===void 0||n.languageInsensitive===!0)return;let r=e.routes.bySlug(n.link);r!==void 0&&r.originFilePath!==null&&t.push(r.slug)};n({link:e.link});let r=e=>{if(e!==void 0)for(let t of e)n(t),r(t.items)};return r(e.items),t}async function L(t){let n=t.directoryPath===``?``:`${t.directoryPath}/`,r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Set,o=t.directoryPath.startsWith(`${e}/`),s=t.pages.filter(e=>o||e.locale===``).map(e=>({route:e,relativePath:e.originFilePath?.startsWith(n)?e.originFilePath.slice(n.length):null})).sort((e,t)=>R(e.relativePath??e.route.slug,t.relativePath??t.route.slug));for(let e of s){let n=e.relativePath?.split(`/`).slice(0,-1)??[],r=c(n);if(r!==void 0){if(!a.has(r.path)){a.add(r.path);let e=await D(t,r.path);e.length>0&&u(l(n,r.depth)).push(...e)}continue}V(e.route,t),e.route.version&&t.versionedDirectories.add(t.directoryPath),u(l(n,n.length)).push({link:e.route.slug,version:e.route.version??void 0,versionGroup:e.route.versionGroup??void 0})}return r;function c(e){for(let n=0;n<=e.length;n++){let r=f.join(t.directoryPath,...e.slice(0,n)),i=t.sidebarByDirectory.get(r);if(i!==void 0&&!t.visitedRefs.has(i))return{depth:n,path:i}}}function l(e,n){return t.flatten?[]:e.slice(0,n).filter(e=>!e.startsWith(`@`))}function u(e){let t=r,n=``;for(let r of e){n=n===``?r:`${n}/${r}`;let e=i.get(n);if(e){t=e;continue}let a=[];t.push({items:a,label:r}),i.set(n,a),t=a}return t}}function R(e,t){return e.startsWith(`index.`)?-1:t.startsWith(`index.`)?1:e.localeCompare(t,void 0,{numeric:!0})}async function z(e,t){if(typeof e.page==`string`){let{path:n,suffix:r,anchor:a}=i(e.page.trim()),o=await B(n,t);return o?(e.disconnect!==!0&&V(o,t),{link:`${o.slug}${r}`,anchor:a,route:o}):{}}if(typeof e.href==`string`){let n=e.href;if(n.startsWith(`/`)){let e=t.routes.bySlug(n);return e?{link:e.slug,route:e}:{link:n,languageInsensitive:!0}}return{link:n,languageInsensitive:!0}}return{}}async function B(e,t){let r=o(e,t.file.path,t.routes);if(r.kind===`escaped`){h(t,`sidebar/invalid-entry`,`Sidebar page "${e}" is outside the content root.`);return}if(r.kind===`missing`){let r=n(e,t.file.path);r!==null&&await t.exists?.(r)&&h(t,`sidebar/missing-target`,`Sidebar page "${e}" is a file that makes no page.`);return}return r.value}function V(e,t){t.assignedRouteSlugs.add(e.slug)}async function H(e){if(e.versionedDirectories.length===0)return;let t=await s({io:e.io,routes:e.routes,versionedDirectories:e.versionedDirectories}),n=e=>{for(let r of e){if(r.version!==void 0&&r.versionGroup!==void 0){let e=t.get(r.versionGroup),n=e?.labels.get(r.version);n&&(r.versionLabel=n),e?.defaultVersion===r.version&&(r.isDefaultVersion=!0)}r.items&&n(r.items),r.menu&&n(r.menu)}};n(e.nodes)}function U(e){let t=JSON.stringify(e)??String(e);return t.length>80?`${t.slice(0,79)}…`:t}function W(e){return typeof e==`string`?e.trim()===``?void 0:{page:e}:t(e)?e:void 0}function G(e){if(!Array.isArray(e))return;let n=[];for(let r of e){let e=t(r)?K(r.name):void 0;t(r)&&e!==void 0&&n.push({name:e,color:K(r.color),icon:K(r.icon),position:r.position===`before`||r.position===`after`?r.position:void 0})}return n.length>0?n:void 0}function K(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function q(e,t){return t.find(t=>t===e)}function J(e,t){return{badges:G(e.badges),...X(e.icon,t),expanded:e.expanded===!0?`true`:q(e.expanded,[`always`]),selectFirstItemOnExpand:e.selectFirstItemOnExpand===!0||void 0,separatorLine:e.separatorLine===!0||void 0,linePosition:q(e.linePosition,[`top`,`bottom`]),target:K(e.target),sublabel:K(e.sublabel)}}function Y(e){return q(e.menuStyle,[`drilldown`,`drilldown-header`])}function X(e,n){let r=t(e)?K(e.srcSet):void 0;if(r!==void 0){let e=u(r);if(e===null)return{srcSet:r};for(let t of e)t.src=Z(t.src,n);return{srcSet:l(e)}}let i=K(e);return i===void 0?{}:{icon:Z(i,n)}}function Z(e,t){if(!r(e))return e;let i=n(e,t.file.path);return i===null?(h(t,`sidebar/invalid-entry`,`Sidebar icon "${e}" is outside the content root.`),e):`/${i}`}export{b as bundleSidebar,x as bundleSidebarEntries,_ as collectSidebarLinkRefs,g as collectSidebarRefTargets,H as stampDefaultVersions};
1
+ import{L10N_DIR as e}from"../../../../shared/constants/l10n/defaults.js";import{isObject as t}from"../../../../shared/utils/is-object.js";import"../../../../shared/utils/l10n.js";import{resolveContentPath as n}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as r}from"../assets/extensions.js";import{splitUrlSuffix as i}from"../../../../shared/utils/routes/split-url-suffix.js";import{toNavItemRbacAnnotation as a}from"../../../../server/rbac/filter.js";import{resolvePageTarget as o}from"../../../../shared/utils/routes/resolve-page-target.js";import{collectVersionGroups as s,findVersionedDirectories as c}from"../../../versions/version-groups.js";import{joinSrcSet as l,parseSrcSet as u}from"../assets/srcset.js";import{classifyLinkTarget as d}from"../../../link-checker/classify.js";import{posix as f}from"node:path";import p from"js-yaml";function m(e){return typeof e.tab==`string`}function h(e,t,n){e.report?.({code:t,message:n,location:{filePath:e.file.path}})}function g(e,r){let i=p.load(e);if(!Array.isArray(i))return[];let a=[],o=e=>{if(t(e)){if(typeof e.$ref==`string`){let t=n(e.$ref,r);t!==null&&a.push(t)}if(Array.isArray(e.items))for(let t of e.items)o(t);if(m(e)&&Array.isArray(e.menu))for(let t of e.menu)o(t)}};for(let e of i)o(e);return a}async function _(e){let t=p.load(e.source);if(!Array.isArray(t))return[];let n=[];return await v({entries:t,ownerFilePath:e.filePath,currentFilePath:e.filePath,readFile:e.readFile,visitedRefs:/* @__PURE__ */ new Set([e.filePath]),refs:n}),n}async function v(e){let{ownerFilePath:t,currentFilePath:r,readFile:i,refs:a}=e;for(let o of e.entries){let s=K(o);if(s===void 0)continue;if(typeof s.$ref==`string`){let o=n(s.$ref,r);if(o===null||i===void 0||e.visitedRefs.has(o))continue;let c;try{c=await i(o)}catch{continue}let l=p.load(c);if(!Array.isArray(l))continue;let u=new Set(e.visitedRefs);u.add(o),await v({entries:l,ownerFilePath:t,currentFilePath:o,readFile:i,visitedRefs:u,refs:a});continue}let c=typeof s.page==`string`?s.page:s.href;typeof c==`string`&&y(a,c,r,t),Array.isArray(s.items)&&await v({...e,entries:s.items}),m(s)&&Array.isArray(s.menu)&&await v({...e,entries:s.menu})}}function y(e,t,n,r){let i=d(t,n);i!==null&&e.push({kind:`link`,raw:t,...i,...n===r?{}:{filePath:n}})}async function b(e){let t=p.load(e.source);if(!Array.isArray(t))throw Error(`Sidebar "${e.file.path}" must be a YAML sequence at the top level.`);return x({...e,entries:t})}async function x(e){let n=e.entries,r=n.filter(e=>t(e)&&m(e));if(r.length>0&&r.length!==n.length)throw Error(`Sidebar "${e.file.path}": when a sidebar uses navigation tabs, every top-level entry must be a tab (found ${n.length-r.length} other entries).`);let i={file:e.file,routes:e.routes,assignedRouteSlugs:/* @__PURE__ */ new Set,versionedDirectories:/* @__PURE__ */ new Set,report:e.report,readFile:e.readFile,skipRoutes:e.skipRoutes,exists:e.exists,sidebarByDirectory:e.sidebarByDirectory??/* @__PURE__ */ new Map,visitedRefs:/* @__PURE__ */ new Set([e.file.path])},a=[];if(r.length>0){for(let[e,t]of r.entries())a.push(await P({...i,entry:t,tabIndex:e}));L({file:e.file,tabs:a,routes:e.routes})}else for(let e of n)a.push(...await S({...i,entry:e}));return{assignedRouteSlugs:[...i.assignedRouteSlugs].sort(),versionedDirectories:[...i.versionedDirectories].sort(),nodes:a}}async function S(e){let n=await C(e),r=t(e.entry)?e.entry.rbac:void 0;if(r===void 0)return n;let i=I({...e,rbac:r});for(let e of n)Object.assign(e,i);return n}async function C(e){let t=K(e.entry);if(t===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar entry ${G(e.entry)} is not a page reference or a group.`),[];if(m(t))throw Error(`Sidebar "${e.file.path}": "tab" is only allowed at the top level (found nested tab "${t.tab}").`);if(t.menu!==void 0)throw Error(`Sidebar "${e.file.path}": "menu" is only allowed directly on a tab.`);if(typeof t.$ref==`string`)return D({...e,ref:t.$ref});if(typeof t.directory==`string`&&E(t)&&t.items===void 0)return C({...e,entry:{...t,directory:void 0,items:[{directory:t.directory,flatten:t.flatten}]}});if(typeof t.directory==`string`){let r=n(t.directory,e.file.path);if(r===null)return h(e,`sidebar/invalid-entry`,`Sidebar directory "${t.directory}" is outside the content root.`),[];let i=e.routes.inDirectory(r);i.length===0&&h(e,`sidebar/missing-target`,`Sidebar directory "${t.directory}" has no pages.`);let a=await z({...e,directoryPath:r,flatten:t.flatten===!0,pages:i.filter(t=>!e.skipRoutes?.has(t.slug))}),o=J(t.group)??J(t.label);return o===void 0?a:[{type:`group`,...X(t,e),menuStyle:Z(t),items:a.length>0?a:void 0,label:o,labelTranslationKey:T(t)}]}if(typeof t.separator==`string`)return[{type:`separator`,...X(t,e),label:t.separator,labelTranslationKey:J(t.separatorTranslationKey)}];let r=await V(t,e),i=r.route;if(i)for(let t of c([i]))e.versionedDirectories.add(t);let a;if(Array.isArray(t.items)){a=[];for(let n of t.items)a.push(...await S({...e,entry:n}))}let o=J(t.group)??J(t.label)??(i===void 0?J(t.href):void 0)??r.anchor,s=E(t);return[{type:w(t,i,r.linksConnectedHeading===!0),...X(t,e),menuStyle:s?Z(t):void 0,external:t.external===!0||void 0,languageInsensitive:r.languageInsensitive?!0:void 0,items:a&&a.length>0?a:void 0,label:o,labelTranslationKey:T(t),link:r.link,isGroup:s?!0:void 0,version:J(t.version)??i?.version??void 0,versionGroup:i?.versionGroup??void 0}]}function w(e,t,n){if(E(e)&&!n)return`group`;if(t!==void 0||e.href||e.label)return`link`}function T(e){return J(E(e)?e.groupTranslationKey:e.labelTranslationKey)}function E(e){return J(e.group)!==void 0}async function D(e){let{ref:t}=e,r=n(t,e.file.path);if(r===null)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is outside the content root.`),[];if(e.readFile===void 0)return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${t}" is not supported here.`),[];if(e.visitedRefs.has(r))return h(e,`sidebar/invalid-entry`,`Sidebar $ref "${r}" includes itself.`),[];let i;try{i=await e.readFile(r)}catch{return h(e,`sidebar/missing-target`,`Sidebar $ref "${r}" could not be read.`),[]}let a=p.load(i);return Array.isArray(a)?O(e,r,a):(h(e,`sidebar/invalid-entry`,`Sidebar $ref "${r}" must be a YAML sequence.`),[])}async function O(e,t,n){let r=/* @__PURE__ */ new Set([...e.visitedRefs,t]),i=[];for(let a of n)i.push(...await S({...e,entry:a,file:{path:t},visitedRefs:r}));return i}async function k(e,t){if(e.readFile===void 0)return[];let n=p.load(await e.readFile(t));return Array.isArray(n)?O({...e,assignedRouteSlugs:/* @__PURE__ */ new Set,report:void 0},t,n.map(A)):[]}function A(e){if(!t(e)||!m(e))return e;let{tab:n,menu:r,...i}=e;return{...i,group:n,items:i.items??r}}function j(e,t){return`${e}-${t.normalize(`NFKD`).replace(/[\u0300-\u036f]/g,``).toLowerCase().replace(/[^a-z0-9]+/g,`-`).replace(/^-+|(?<!-)-+$/g,``)||`tab`}`}function M(e){return/* @__PURE__ */ Error(`Sidebar "${e.file.path}": tab "${e.label}" ${e.message}.`)}function N(e){let{file:t,entry:n}=e,r=n.tab,i=n.menu!==void 0;if(i&&n.items!==void 0)throw M({file:t,label:r,message:`cannot have both "menu" and "items"`});if(i&&n.page!==void 0)throw M({file:t,label:r,message:`has "menu" and cannot also have "page"`});if(!i&&n.page===void 0)throw M({file:t,label:r,message:`needs "page" or "menu"`});if(typeof n.page==`string`&&n.page.includes(`#`))throw M({file:t,label:r,message:`page must not contain a heading anchor`});if(i&&!Array.isArray(n.menu))throw M({file:t,label:r,message:`"menu" must be a list of entries`});if(i&&Array.isArray(n.menu)&&n.menu.length===0)throw M({file:t,label:r,message:`has an empty "menu"`});if(n.$ref!==void 0||n.directory!==void 0||n.group!==void 0||n.href!==void 0)throw M({file:t,label:r,message:`accepts only "page", "items", "menu" and "icon"; move "$ref"/"directory"/"group"/"href" into "items"`})}async function P(e){let{entry:t}=e,n=t.tab;N({file:e.file,entry:t});let r=j(e.tabIndex,n);if(t.menu!==void 0){let i=Array.isArray(t.menu)?t.menu:[],a=[];for(let[t,n]of i.entries()){let i=await F({...e,tabId:r,index:t,raw:n});i!==void 0&&a.push(i)}return{tab:!0,tabId:r,label:n,menu:a,...Q(t.icon,e),...I({...e,rbac:t.rbac})}}let[i]=await S({...e,entry:{page:t.page,label:n,items:t.items,rbac:t.rbac}}),a=i?.items??[];return{...i,tab:!0,tabId:r,...Q(t.icon,e),items:a}}async function F(e){let{file:t,entry:n,tabId:r,index:i,raw:a}=e,o=n.tab,s=K(a);if(s===void 0||typeof s.page!=`string`)throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" needs "page".`);if(s.page.includes(`#`))throw Error(`Sidebar "${t.path}": menu entry ${i+1} of tab "${o}" page must not contain a heading anchor.`);let c=`${r}/${i}`,[l]=await S({...e,entry:s});return l?.link===void 0?void 0:{...l,tabId:c,items:l.items??[]}}function I(e){return a(e.rbac,()=>h(e,`sidebar/invalid-entry`,`Sidebar entry has an invalid "rbac" value, so it is hidden.`))}function L(e){let t=/* @__PURE__ */ new Map,n=(n,r)=>{for(let i of r){let r=t.get(i);if(r!==void 0&&r.tabId!==n.tabId)throw Error(`Sidebar "${e.file.path}": route "${i}" is claimed by two navigation tabs, "${r.label}" and "${n.label}". A route can belong to one tab only.`);t.set(i,n)}};for(let t of e.tabs){if(t.menu!==void 0){for(let r of t.menu)r.tabId!==void 0&&n({tabId:r.tabId,label:`${t.label} > ${r.label??r.link}`},R({routes:e.routes,link:r.link,items:r.items}));continue}t.tabId!==void 0&&n({tabId:t.tabId,label:t.label??t.link??``},R({routes:e.routes,link:t.link,items:t.items}))}}function R(e){let t=[],n=n=>{if(n.link===void 0||n.languageInsensitive===!0)return;let r=e.routes.bySlug(n.link);r!==void 0&&r.originFilePath!==null&&t.push(r.slug)};n({link:e.link});let r=e=>{if(e!==void 0)for(let t of e)n(t),r(t.items)};return r(e.items),t}async function z(t){let n=t.directoryPath===``?``:`${t.directoryPath}/`,r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Set,o=t.directoryPath.startsWith(`${e}/`),s=t.pages.filter(e=>o||e.locale===``).map(e=>({route:e,relativePath:e.originFilePath?.startsWith(n)?e.originFilePath.slice(n.length):null})).sort((e,t)=>B(e.relativePath??e.route.slug,t.relativePath??t.route.slug));for(let e of s){let n=e.relativePath?.split(`/`).slice(0,-1)??[],r=c(n);if(r!==void 0){if(!a.has(r.path)){a.add(r.path);let e=await k(t,r.path);e.length>0&&u(l(n,r.depth)).push(...e)}continue}U(e.route,t),e.route.version&&t.versionedDirectories.add(t.directoryPath),u(l(n,n.length)).push({type:`link`,link:e.route.slug,version:e.route.version??void 0,versionGroup:e.route.versionGroup??void 0})}return r;function c(e){for(let n=0;n<=e.length;n++){let r=f.join(t.directoryPath,...e.slice(0,n)),i=t.sidebarByDirectory.get(r);if(i!==void 0&&!t.visitedRefs.has(i))return{depth:n,path:i}}}function l(e,n){return t.flatten?[]:e.slice(0,n).filter(e=>!e.startsWith(`@`))}function u(e){let t=r,n=``;for(let r of e){n=n===``?r:`${n}/${r}`;let e=i.get(n);if(e){t=e;continue}let a=[];t.push({type:`group`,items:a,label:r}),i.set(n,a),t=a}return t}}function B(e,t){return e.startsWith(`index.`)?-1:t.startsWith(`index.`)?1:e.localeCompare(t,void 0,{numeric:!0})}async function V(e,t){if(typeof e.page==`string`){let{path:n,suffix:r,anchor:a}=i(e.page.trim()),o=await H(n,t);if(!o)return{};let s=e.disconnect!==!0;return s&&U(o,t),{link:`${o.slug}${r}`,anchor:a,linksConnectedHeading:s&&a!==void 0,route:o}}if(typeof e.href==`string`){let n=e.href;if(n.startsWith(`/`)){let e=t.routes.bySlug(n);return e?{link:e.slug,route:e}:{link:n,languageInsensitive:!0}}return{link:n,languageInsensitive:!0}}return{}}async function H(e,t){let r=o(e,t.file.path,t.routes);if(r.kind===`escaped`){h(t,`sidebar/invalid-entry`,`Sidebar page "${e}" is outside the content root.`);return}if(r.kind===`missing`){let r=n(e,t.file.path);r!==null&&await t.exists?.(r)&&h(t,`sidebar/missing-target`,`Sidebar page "${e}" is a file that makes no page.`);return}return r.value}function U(e,t){t.assignedRouteSlugs.add(e.slug)}async function W(e){if(e.versionedDirectories.length===0)return;let t=await s({io:e.io,routes:e.routes,versionedDirectories:e.versionedDirectories}),n=e=>{for(let r of e){if(r.version!==void 0&&r.versionGroup!==void 0){let e=t.get(r.versionGroup),n=e?.labels.get(r.version);n&&(r.versionLabel=n),e?.defaultVersion===r.version&&(r.isDefaultVersion=!0)}r.items&&n(r.items),r.menu&&n(r.menu)}};n(e.nodes)}function G(e){let t=JSON.stringify(e)??String(e);return t.length>80?`${t.slice(0,79)}…`:t}function K(e){return typeof e==`string`?e.trim()===``?void 0:{page:e}:t(e)?e:void 0}function q(e){if(!Array.isArray(e))return;let n=[];for(let r of e){let e=t(r)?J(r.name):void 0;t(r)&&e!==void 0&&n.push({name:e,color:J(r.color),icon:J(r.icon),position:r.position===`before`||r.position===`after`?r.position:void 0})}return n.length>0?n:void 0}function J(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function Y(e,t){return t.find(t=>t===e)}function X(e,t){return{badges:q(e.badges),...Q(e.icon,t),expanded:e.expanded===!0?`true`:Y(e.expanded,[`always`]),selectFirstItemOnExpand:e.selectFirstItemOnExpand===!0||void 0,separatorLine:e.separatorLine===!0||void 0,linePosition:Y(e.linePosition,[`top`,`bottom`]),target:J(e.target),sublabel:J(e.sublabel)}}function Z(e){return Y(e.menuStyle,[`drilldown`,`drilldown-header`])}function Q(e,n){let r=t(e)?J(e.srcSet):void 0;if(r!==void 0){let e=u(r);if(e===null)return{srcSet:r};for(let t of e)t.src=$(t.src,n);return{srcSet:l(e)}}let i=J(e);return i===void 0?{}:{icon:$(i,n)}}function $(e,t){if(!r(e))return e;let i=n(e,t.file.path);return i===null?(h(t,`sidebar/invalid-entry`,`Sidebar icon "${e}" is outside the content root.`),e):`/${i}`}export{b as bundleSidebar,x as bundleSidebarEntries,_ as collectSidebarLinkRefs,g as collectSidebarRefTargets,W as stampDefaultVersions};
@@ -2,6 +2,7 @@ import { REDOCLY_TEAMS_RBAC } from '@redocly/config';
2
2
  import { type BundledSidebarNode, type SidebarBadge } from './bundle.js';
3
3
  import { type VersionStamp } from './subtree.js';
4
4
  import { NAV_ITEM_RBAC, type RbacScope } from '../../../../server/rbac/types.js';
5
+ import type { SidebarItemType } from '../../../../shared/types/sidebar.js';
5
6
  import { SIDEBAR_ROUTE_DEP_KEY } from '../../../../shared/constants/route-deps.js';
6
7
  export declare const SIDEBAR_PLUGIN_ID = "internal.sidebar";
7
8
  export declare const SIDEBAR_AGGREGATOR_LOADER_ID: "internal.sidebar:aggregate";
@@ -10,7 +11,7 @@ export declare const SIDEBAR_FILENAME_REGEX: RegExp;
10
11
  /** A folder's own sidebar; a named `*.sidebars.yaml` is not one. */
11
12
  export declare const FOLDER_SIDEBAR_FILENAME_REGEX: RegExp;
12
13
  export type ResolvedSidebarItem = {
13
- type?: 'separator';
14
+ type?: SidebarItemType;
14
15
  label?: string;
15
16
  labelTranslationKey?: string;
16
17
  link?: string;
@@ -1,2 +1,2 @@
1
- import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t,createInlineEntity as n}from"../../../loaders/define.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import"../../../../shared/constants/l10n/defaults.js";import{NAV_ITEM_RBAC as i}from"../../../../server/rbac/types.js";import{compareStrings as a}from"../../../../shared/utils/compare-strings.js";import{isObject as o}from"../../../../shared/utils/is-object.js";import{toLocaleSlug as s}from"../../../../shared/utils/l10n.js";import{resolveContentPath as c}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as l}from"../assets/extensions.js";import{splitUrlSuffix as u}from"../../../../shared/utils/routes/split-url-suffix.js";import{resolvePageTarget as d}from"../../../../shared/utils/routes/resolve-page-target.js";import{toPublicVersionedSlug as f}from"../../../../shared/constants/versions.js";import{collectVersionGroups as p,findVersionedDirectories as ee}from"../../../versions/version-groups.js";import{publicLink as m}from"../../../versions/public-link.js";import{linkedPageAccess as h}from"../../utils/link-access.js";import{safeDecodeURI as g}from"../../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as _,parseSrcSet as v}from"../assets/srcset.js";import{bundleSidebar as y,bundleSidebarEntries as te,collectSidebarLinkRefs as b,collectSidebarRefTargets as ne,stampDefaultVersions as x}from"./bundle.js";import{SIDEBAR_CONTRIBUTIONS_ENTITY_TYPE as S,sidebarStartEntityKey as re}from"./contributions.js";import{applySubtree as C}from"./subtree.js";import{collectSlugOverrides as w}from"../../utils/slug-overrides.js";import{SIDEBAR_BACK_LINK_ROUTE_DEP_KEY as ie,SIDEBAR_BREADCRUMBS_ROUTE_DEP_KEY as T,SIDEBAR_ROUTE_DEP_KEY as E,localizedSidebarDepKey as D}from"../../../../shared/constants/route-deps.js";import{SITE_START_ENTITY_KEY as ae}from"../../../../shared/constants/site-start.js";import{posix as O}from"node:path";import{REDOCLY_TEAMS_RBAC as k}from"@redocly/config";const A=`internal.sidebar`,j=r(A,`aggregate`),M=/(^|\/)(?:[^/]*\.)?sidebars\.ya?ml$/i,N=/(^|\/)sidebars\.ya?ml$/i,P=`sidebars.yaml`,F=`redocly.yaml`;function I(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Array.isArray(e.tabs)}function L(e){if(Array.isArray(e))return e.find(e=>R(e.label)!==void 0)?.label}function R(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function z(e){let t=((e??``).split(/[?#]/)[0]?.split(`/`).filter(Boolean).pop()??``).replace(/[-_]+/g,` `).trim();return t.charAt(0).toUpperCase()+t.slice(1)}async function B(e,t){let n=[];for(let r of e){let e=r.link?t.subtreeKeyOf(r.link):void 0,a=e?await t.loadEntity(e):void 0,o=r.tabId!==void 0,s=o?{...r,isGroup:!0,label:r.label??L(a)}:r,c=a===void 0?[s]:C(s,a);for(let e of c){let a=e[`redocly::nav-item-rbac`]??r[`redocly::nav-item-rbac`],s=e[k]??(a===void 0&&e.link!==void 0?t.accessOf(e.link)??void 0:void 0);n.push({type:e.type,expanded:e.expanded,selectFirstItemOnExpand:e.selectFirstItemOnExpand,external:e.external,target:e.target,languageInsensitive:e.languageInsensitive,icon:e.icon===void 0?void 0:await t.resolveAsset(e.icon),srcSet:e.srcSet===void 0?void 0:await V(e.srcSet,t),items:e.items?await B(e.items,t):void 0,tab:e.tab,tabId:e.tabId,menu:e.menu?await B(e.menu,t):void 0,label:o?e.label??z(e.link):e.label,labelTranslationKey:e.labelTranslationKey,link:e.link!==void 0&&e.versionGroup!==void 0&&e.version!==void 0?f(e.link,e.versionGroup,e.version,e.isDefaultVersion===!0):e.link,separatorLine:e.separatorLine,linePosition:e.linePosition,variant:e.variant,menuStyle:e.menuStyle,sublabel:e.sublabel,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,httpVerb:e.httpVerb,deprecated:e.deprecated,badges:e.badges,[k]:s,[i]:a})}}return n}async function V(e,t){let n=v(e);if(n===null)return e;let r=await Promise.all(n.map(async e=>Object.assign(e,{src:await t.resolveAsset(e.src)})));return _(r)}function H(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map;return{async resolve(r){if(!l(r))return r;let i=await e.resolveImageReference(r,``),a=c(g(r),``);a!==null&&t.set(`file:${a}`,{kind:`file`,path:a});for(let e of i.entityDeps)t.set(e.kind===`file`?`file:${e.path}`:`entity:${e.key}`,e);for(let e of i.assetUsages)n.set(e.path,e);return i.result.kind===`assetRef`?i.result.url:r},collected(){return{entityDeps:[...t.values()],assetUsages:[...n.values()]}}}}function U(e){return e.tabId!==void 0}function W(e){return U(e)&&e.link!==void 0}function G(e){return{tabId:e.tabId,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,[k]:e[k],[i]:e[i]}}function K(e){return{...G(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.link,icon:e.icon,items:e.items??[]}}function q(e){return{...G(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.menu?void 0:e.link,icon:e.icon,items:e.menu?void 0:e.items??[],menu:e.menu?.filter(W).map(K)}}const J=t(j,async e=>{let t=H(e.markdown),{locale:n,slugOverrides:r={},versionedDirectories:i=[]}=e.args,a=t=>e.routes.bySlug(t)?.sidebarSubtreeEntityKey,o=i.length===0?/* @__PURE__ */ new Map:await p({io:e.io,routes:e.routes,versionedDirectories:i}),c=await B(e.args.nodes,{loadEntity:t=>e.entities.load(t),subtreeKeyOf:e=>(n===void 0?void 0:a(r[e]??s(e,n)))??a(e),accessOf:t=>h(t,e.routes,o),resolveAsset:t.resolve});return{value:e.args.nodes.some(e=>e.tab)?{tabs:c.filter(U).map(q)}:c,...t.collected()}});async function oe(e){let t=await e.loadEntity(e.subtreeKey);return B(C({link:e.routeSlug,...e.version},t),{loadEntity:e.loadEntity,subtreeKeyOf:()=>void 0,accessOf:()=>void 0,resolveAsset:async e=>e})}function se(e){let t=typeof e==`string`?e:o(e)?e.path:void 0;return typeof t==`string`&&t.trim()!==``?t.trim():null}function Y(e){return[e.originPluginId,e.originFilePath,e.routeId].join(`\0`)}async function X(e,t){let n=/* @__PURE__ */ new Map;for(let r of e.assignedRouteSlugs){let e=t.routes.bySlug(r),i=e?.originFilePath===null?e.sidebarSubtreeEntityKey:null;if(!i||await t.entities.get(i)===null)continue;let a=e=>{for(let i of e){let e=i.link===void 0?void 0:t.routes.bySlug(i.link);e!==void 0&&!n.has(e.slug)&&n.set(e.slug,r),i.items&&a(i.items)}};a(C({link:r},await t.entities.load(i)))}return n}function ce(e,t){for(let n of t)for(let[t,r]of n){let n=e.get(r);n!==void 0&&!e.has(t)&&e.set(t,n)}}async function le(e){let t=[];for(let n of await e.list({type:S}))t.push(...await e.load(n.key));return t}function ue(e,t=[]){let n=[];for(let[r,i]of e.entries()){if(t[r]?.link!==i.link)break;n.push(i)}return n}async function de(e,t,n,r,i){let a=await Promise.all(e.map(async e=>{let r=fe(e,t,n);return r===null?null:{item:e,link:r.link,label:await Z(e,r,i)}})),o=/* @__PURE__ */ new Map;for(let{item:e,link:t,label:n}of a.filter(e=>e!==null))for(let i of e.linkedSidebars??[]){let e=c(i,F),a=e===null?void 0:r.get(e);a!==void 0&&!o.has(a)&&o.set(a,{label:n,link:t})}return o}function fe(e,t,n){if(typeof e.href==`string`&&e.href.trim()!==``)return{link:e.href.trim()};if(typeof e.page!=`string`||e.page.trim()===``)return null;let{path:r,suffix:i,anchor:a}=u(e.page.trim()),o=d(r,F,t);if(o.kind!==`found`)return null;let s=o.value;return{link:`${m(s,n)}${i}`,anchor:a,route:s}}async function Z(e,t,n){let r=R(e.label)??R(e.group)??t.anchor;if(r!==void 0)return r;let i=t.route?.sidebarSubtreeEntityKey,a=i?await n(i):void 0;return(o(a)?R(a.label):void 0)??t.link}function Q(e,t){for(let n of e){if(!t(n))continue;if(n.link!==void 0&&n.languageInsensitive!==!0)return n;let e=Q([...n.items??[],...n.menu??[]],t);if(e!==null)return e}return null}function pe(e,t){return Q(e,e=>e.version===void 0||e.version===t)?.link??null}function $(e){let t=Q(e,e=>e.version===void 0||e.isDefaultVersion===!0);return t?.link===void 0?null:t.versionGroup!==void 0&&t.version!==void 0?f(t.link,t.versionGroup,t.version,!0):t.link}function me(e){let[t]=e;if(t===void 0)return null;let n=t.path.split(`/`).length;return(e.find(({path:e})=>e.split(`/`).length===n&&N.test(e))??t).link}function he(e){let t=null;for(let{slug:n,originFilePath:r,locale:i,versionGroup:o}of e)r!==null&&i===``&&o===null&&(t===null||n.length<t.length||n.length===t.length&&a(n,t)<0)&&(t=n);return t}const ge=e({id:A,version:`1.23.0`,content:{filter:{match:e=>M.test(e)},async extractFile(e,t){let n=await t.io.readFile(e.path);return{routes:[],linkRefs:await b({source:n,filePath:e.path,readFile:t.io.readFile})}}},async finalize(e){let t=[],r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,s=[],c=/* @__PURE__ */ new Map,l=/* @__PURE__ */ new Map,d=[],f=await Promise.all(e.files.map(async t=>({path:t.path,source:await e.io.readFile(t.path)}))),m=e.routes.all(),g=w(m,e.localeContext),_=ee(m),v=_.length>0?_:void 0;f.sort((e,t)=>e.path.split(`/`).length-t.path.split(`/`).length);let b=new Map(f.map(({path:e,source:t})=>[e,t])),S=/* @__PURE__ */ new Map;for(let{path:e}of f)N.test(e)&&S.set(O.dirname(e),e);let C=/* @__PURE__ */ new Set;for(let{path:e,source:t}of f)for(let n of ne(t,e))C.add(n);let A={routes:e.routes,report:e=>r.push(e),readFile:async t=>b.get(t)??e.io.readFile(t),exists:t=>e.io.exists(t),sidebarByDirectory:S},j=async(n,r)=>{if(n.nodes.length===0)return;await x({io:e.io,routes:e.routes,logger:e.logger,nodes:n.nodes,versionedDirectories:_});let i=J.withArgs({nodes:n.nodes,versionedDirectories:v},r===void 0?void 0:{metadata:{sourcePath:r}});t.push(i),l.set(i,n.nodes);let a=/* @__PURE__ */ new Map;for(let r of e.localeContext.locales){let e=J.withArgs({nodes:n.nodes,locale:r,slugOverrides:g[r]??{},versionedDirectories:v});t.push(e),a.set(r,e)}return c.set(i,a),i};for(let{path:t,source:n}of f){if(C.has(t))continue;let c=await y({...A,file:{path:t},source:n}),l=await j(c,t);if(l===void 0)continue;a.set(t,l);let u=t.startsWith(`@l10n/`)?null:$(c.nodes);u!==null&&d.push({path:t,link:u}),s.push(await X(c,e));for(let e of c.assignedRouteSlugs){let n=o.get(e);n!==void 0&&r.push({code:`sidebar/route-conflict`,message:`Page "${e}" is in sidebars ${n} and ${t}; it shows ${t}.`,location:{filePath:t}}),i.set(e,l),o.set(e,t)}}ce(i,s);let M=new Map(m.map(e=>[e.slug,e]));for(let[t,n]of Object.entries(e.routes.metadata(`sidebar`))){let e=M.get(t);if(e===void 0||e.originFilePath===null)continue;let o=se(n);if(o===null)continue;let s=O.normalize(o.startsWith(`/`)?o.slice(1):O.join(O.dirname(e.originFilePath),o)),c=a.get(s);if(c===void 0){r.push({code:`sidebar/missing-target`,message:`Front matter sidebar "${o}" is not a sidebar file of this project.`,location:{filePath:e.originFilePath}});continue}i.set(e.slug,c)}let F=await le(e.entities),I=/* @__PURE__ */ new Set,L=/* @__PURE__ */ new Map,R=/* @__PURE__ */ new Map;for(let t of F){let n=i.get(t.route);if(n===void 0){let r=await te({...A,file:{path:P},entries:t.entries});if(n=await j(r),n===void 0)continue;let a=(await X(r,e)).keys();for(let e of[...r.assignedRouteSlugs,...a])i.has(e)||(i.set(e,n),I.add(e))}let r=L.get(n);L.set(n,r===void 0?t.backLink??null:r!==null&&r.link===t.backLink?.link?r:null);let a=R.get(n);R.set(n,a===void 0?t.breadcrumbs??[]:ue(a,t.breadcrumbs))}if(f.length===0&&m.length>0){let e=await y({...A,file:{path:P},source:`- directory: .
1
+ import{defineContentPlugin as e}from"../../define.js";import{createEntityLoader as t,createInlineEntity as n}from"../../../loaders/define.js";import{createPluginScopedId as r}from"../../utils/scoped-id.js";import"../../../../shared/constants/l10n/defaults.js";import{NAV_ITEM_RBAC as i}from"../../../../server/rbac/types.js";import{compareStrings as a}from"../../../../shared/utils/compare-strings.js";import{isObject as o}from"../../../../shared/utils/is-object.js";import{toLocaleSlug as s}from"../../../../shared/utils/l10n.js";import{resolveContentPath as c}from"../../../../shared/utils/resolve-content-path.js";import{isLocalImagePath as l}from"../assets/extensions.js";import{splitUrlSuffix as u}from"../../../../shared/utils/routes/split-url-suffix.js";import{resolvePageTarget as d}from"../../../../shared/utils/routes/resolve-page-target.js";import{toPublicVersionedSlug as f}from"../../../../shared/constants/versions.js";import{collectVersionGroups as p,findVersionedDirectories as ee}from"../../../versions/version-groups.js";import{publicLink as m}from"../../../versions/public-link.js";import{linkedPageAccess as h}from"../../utils/link-access.js";import{safeDecodeURI as g}from"../../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as _,parseSrcSet as v}from"../assets/srcset.js";import{bundleSidebar as y,bundleSidebarEntries as te,collectSidebarLinkRefs as b,collectSidebarRefTargets as ne,stampDefaultVersions as x}from"./bundle.js";import{SIDEBAR_CONTRIBUTIONS_ENTITY_TYPE as S,sidebarStartEntityKey as re}from"./contributions.js";import{applySubtree as C}from"./subtree.js";import{collectSlugOverrides as w}from"../../utils/slug-overrides.js";import{SIDEBAR_BACK_LINK_ROUTE_DEP_KEY as ie,SIDEBAR_BREADCRUMBS_ROUTE_DEP_KEY as T,SIDEBAR_ROUTE_DEP_KEY as E,localizedSidebarDepKey as D}from"../../../../shared/constants/route-deps.js";import{SITE_START_ENTITY_KEY as ae}from"../../../../shared/constants/site-start.js";import{posix as O}from"node:path";import{REDOCLY_TEAMS_RBAC as k}from"@redocly/config";const A=`internal.sidebar`,j=r(A,`aggregate`),M=/(^|\/)(?:[^/]*\.)?sidebars\.ya?ml$/i,N=/(^|\/)sidebars\.ya?ml$/i,P=`sidebars.yaml`,F=`redocly.yaml`;function I(e){return typeof e==`object`&&!!e&&!Array.isArray(e)&&Array.isArray(e.tabs)}function L(e){if(Array.isArray(e))return e.find(e=>R(e.label)!==void 0)?.label}function R(e){return typeof e==`string`&&e.trim()!==``?e:void 0}function z(e){let t=((e??``).split(/[?#]/)[0]?.split(`/`).filter(Boolean).pop()??``).replace(/[-_]+/g,` `).trim();return t.charAt(0).toUpperCase()+t.slice(1)}async function B(e,t){let n=[];for(let r of e){let e=r.link?t.subtreeKeyOf(r.link):void 0,a=e?await t.loadEntity(e):void 0,o=r.tabId!==void 0,s=o?{...r,isGroup:!0,label:r.label??L(a)}:r,c=a===void 0?[s]:C(s,a);for(let e of c){let a=e[`redocly::nav-item-rbac`]??r[`redocly::nav-item-rbac`],s=e[k]??(a===void 0&&e.link!==void 0?t.accessOf(e.link)??void 0:void 0);n.push({type:e.type,expanded:e.expanded,selectFirstItemOnExpand:e.selectFirstItemOnExpand,external:e.external,target:e.target,languageInsensitive:e.languageInsensitive,icon:e.icon===void 0?void 0:await t.resolveAsset(e.icon),srcSet:e.srcSet===void 0?void 0:await V(e.srcSet,t),items:e.items?await B(e.items,t):void 0,tab:e.tab,tabId:e.tabId,menu:e.menu?await B(e.menu,t):void 0,label:o?e.label??z(e.link):e.label,labelTranslationKey:e.labelTranslationKey,link:e.link!==void 0&&e.versionGroup!==void 0&&e.version!==void 0?f(e.link,e.versionGroup,e.version,e.isDefaultVersion===!0):e.link,separatorLine:e.separatorLine,linePosition:e.linePosition,variant:e.variant,menuStyle:e.menuStyle,sublabel:e.sublabel,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,httpVerb:e.httpVerb,deprecated:e.deprecated,badges:e.badges,[k]:s,[i]:a})}}return n}async function V(e,t){let n=v(e);if(n===null)return e;let r=await Promise.all(n.map(async e=>Object.assign(e,{src:await t.resolveAsset(e.src)})));return _(r)}function H(e){let t=/* @__PURE__ */ new Map,n=/* @__PURE__ */ new Map;return{async resolve(r){if(!l(r))return r;let i=await e.resolveImageReference(r,``),a=c(g(r),``);a!==null&&t.set(`file:${a}`,{kind:`file`,path:a});for(let e of i.entityDeps)t.set(e.kind===`file`?`file:${e.path}`:`entity:${e.key}`,e);for(let e of i.assetUsages)n.set(e.path,e);return i.result.kind===`assetRef`?i.result.url:r},collected(){return{entityDeps:[...t.values()],assetUsages:[...n.values()]}}}}function U(e){return e.tabId!==void 0}function W(e){return U(e)&&e.link!==void 0}function G(e){return{tabId:e.tabId,version:e.version,versionGroup:e.versionGroup,isDefaultVersion:e.isDefaultVersion,versionLabel:e.versionLabel,[k]:e[k],[i]:e[i]}}function K(e){return{...G(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.link,icon:e.icon,items:e.items??[]}}function q(e){return{...G(e),label:e.label,labelTranslationKey:e.labelTranslationKey,link:e.menu?void 0:e.link,icon:e.icon,items:e.menu?void 0:e.items??[],menu:e.menu?.filter(W).map(K)}}const J=t(j,async e=>{let t=H(e.markdown),{locale:n,slugOverrides:r={},versionedDirectories:i=[]}=e.args,a=t=>e.routes.bySlug(t)?.sidebarSubtreeEntityKey,o=i.length===0?/* @__PURE__ */ new Map:await p({io:e.io,routes:e.routes,versionedDirectories:i}),c=await B(e.args.nodes,{loadEntity:t=>e.entities.load(t),subtreeKeyOf:e=>(n===void 0?void 0:a(r[e]??s(e,n)))??a(e),accessOf:t=>h(t,e.routes,o),resolveAsset:t.resolve});return{value:e.args.nodes.some(e=>e.tab)?{tabs:c.filter(U).map(q)}:c,...t.collected()}});async function oe(e){let t=await e.loadEntity(e.subtreeKey);return B(C({link:e.routeSlug,...e.version},t),{loadEntity:e.loadEntity,subtreeKeyOf:()=>void 0,accessOf:()=>void 0,resolveAsset:async e=>e})}function se(e){let t=typeof e==`string`?e:o(e)?e.path:void 0;return typeof t==`string`&&t.trim()!==``?t.trim():null}function Y(e){return[e.originPluginId,e.originFilePath,e.routeId].join(`\0`)}async function X(e,t){let n=/* @__PURE__ */ new Map;for(let r of e.assignedRouteSlugs){let e=t.routes.bySlug(r),i=e?.originFilePath===null?e.sidebarSubtreeEntityKey:null;if(!i||await t.entities.get(i)===null)continue;let a=e=>{for(let i of e){let e=i.link===void 0?void 0:t.routes.bySlug(i.link);e!==void 0&&!n.has(e.slug)&&n.set(e.slug,r),i.items&&a(i.items)}};a(C({link:r},await t.entities.load(i)))}return n}function ce(e,t){for(let n of t)for(let[t,r]of n){let n=e.get(r);n!==void 0&&!e.has(t)&&e.set(t,n)}}async function le(e){let t=[];for(let n of await e.list({type:S}))t.push(...await e.load(n.key));return t}function ue(e,t=[]){let n=[];for(let[r,i]of e.entries()){if(t[r]?.link!==i.link)break;n.push(i)}return n}async function de(e,t,n,r,i){let a=await Promise.all(e.map(async e=>{let r=fe(e,t,n);return r===null?null:{item:e,link:r.link,label:await Z(e,r,i)}})),o=/* @__PURE__ */ new Map;for(let{item:e,link:t,label:n}of a.filter(e=>e!==null))for(let i of e.linkedSidebars??[]){let e=c(i,F),a=e===null?void 0:r.get(e);a!==void 0&&!o.has(a)&&o.set(a,{label:n,link:t})}return o}function fe(e,t,n){if(typeof e.href==`string`&&e.href.trim()!==``)return{link:e.href.trim()};if(typeof e.page!=`string`||e.page.trim()===``)return null;let{path:r,suffix:i,anchor:a}=u(e.page.trim()),o=d(r,F,t);if(o.kind!==`found`)return null;let s=o.value;return{link:`${m(s,n)}${i}`,anchor:a,route:s}}async function Z(e,t,n){let r=R(e.label)??R(e.group)??t.anchor;if(r!==void 0)return r;let i=t.route?.sidebarSubtreeEntityKey,a=i?await n(i):void 0;return(o(a)?R(a.label):void 0)??t.link}function Q(e,t){for(let n of e){if(!t(n))continue;if(n.link!==void 0&&n.languageInsensitive!==!0)return n;let e=Q([...n.items??[],...n.menu??[]],t);if(e!==null)return e}return null}function pe(e,t){return Q(e,e=>e.version===void 0||e.version===t)?.link??null}function $(e){let t=Q(e,e=>e.version===void 0||e.isDefaultVersion===!0);return t?.link===void 0?null:t.versionGroup!==void 0&&t.version!==void 0?f(t.link,t.versionGroup,t.version,!0):t.link}function me(e){let[t]=e;if(t===void 0)return null;let n=t.path.split(`/`).length;return(e.find(({path:e})=>e.split(`/`).length===n&&N.test(e))??t).link}function he(e){let t=null;for(let{slug:n,originFilePath:r,locale:i,versionGroup:o}of e)r!==null&&i===``&&o===null&&(t===null||n.length<t.length||n.length===t.length&&a(n,t)<0)&&(t=n);return t}const ge=e({id:A,version:`1.23.1`,content:{filter:{match:e=>M.test(e)},async extractFile(e,t){let n=await t.io.readFile(e.path);return{routes:[],linkRefs:await b({source:n,filePath:e.path,readFile:t.io.readFile})}}},async finalize(e){let t=[],r=[],i=/* @__PURE__ */ new Map,a=/* @__PURE__ */ new Map,o=/* @__PURE__ */ new Map,s=[],c=/* @__PURE__ */ new Map,l=/* @__PURE__ */ new Map,d=[],f=await Promise.all(e.files.map(async t=>({path:t.path,source:await e.io.readFile(t.path)}))),m=e.routes.all(),g=w(m,e.localeContext),_=ee(m),v=_.length>0?_:void 0;f.sort((e,t)=>e.path.split(`/`).length-t.path.split(`/`).length);let b=new Map(f.map(({path:e,source:t})=>[e,t])),S=/* @__PURE__ */ new Map;for(let{path:e}of f)N.test(e)&&S.set(O.dirname(e),e);let C=/* @__PURE__ */ new Set;for(let{path:e,source:t}of f)for(let n of ne(t,e))C.add(n);let A={routes:e.routes,report:e=>r.push(e),readFile:async t=>b.get(t)??e.io.readFile(t),exists:t=>e.io.exists(t),sidebarByDirectory:S},j=async(n,r)=>{if(n.nodes.length===0)return;await x({io:e.io,routes:e.routes,logger:e.logger,nodes:n.nodes,versionedDirectories:_});let i=J.withArgs({nodes:n.nodes,versionedDirectories:v},r===void 0?void 0:{metadata:{sourcePath:r}});t.push(i),l.set(i,n.nodes);let a=/* @__PURE__ */ new Map;for(let r of e.localeContext.locales){let e=J.withArgs({nodes:n.nodes,locale:r,slugOverrides:g[r]??{},versionedDirectories:v});t.push(e),a.set(r,e)}return c.set(i,a),i};for(let{path:t,source:n}of f){if(C.has(t))continue;let c=await y({...A,file:{path:t},source:n}),l=await j(c,t);if(l===void 0)continue;a.set(t,l);let u=t.startsWith(`@l10n/`)?null:$(c.nodes);u!==null&&d.push({path:t,link:u}),s.push(await X(c,e));for(let e of c.assignedRouteSlugs){let n=o.get(e);n!==void 0&&r.push({code:`sidebar/route-conflict`,message:`Page "${e}" is in sidebars ${n} and ${t}; it shows ${t}.`,location:{filePath:t}}),i.set(e,l),o.set(e,t)}}ce(i,s);let M=new Map(m.map(e=>[e.slug,e]));for(let[t,n]of Object.entries(e.routes.metadata(`sidebar`))){let e=M.get(t);if(e===void 0||e.originFilePath===null)continue;let o=se(n);if(o===null)continue;let s=O.normalize(o.startsWith(`/`)?o.slice(1):O.join(O.dirname(e.originFilePath),o)),c=a.get(s);if(c===void 0){r.push({code:`sidebar/missing-target`,message:`Front matter sidebar "${o}" is not a sidebar file of this project.`,location:{filePath:e.originFilePath}});continue}i.set(e.slug,c)}let F=await le(e.entities),I=/* @__PURE__ */ new Set,L=/* @__PURE__ */ new Map,R=/* @__PURE__ */ new Map;for(let t of F){let n=i.get(t.route);if(n===void 0){let r=await te({...A,file:{path:P},entries:t.entries});if(n=await j(r),n===void 0)continue;let a=(await X(r,e)).keys();for(let e of[...r.assignedRouteSlugs,...a])i.has(e)||(i.set(e,n),I.add(e))}let r=L.get(n);L.set(n,r===void 0?t.backLink??null:r!==null&&r.link===t.backLink?.link?r:null);let a=R.get(n);R.set(n,a===void 0?t.breadcrumbs??[]:ue(a,t.breadcrumbs))}if(f.length===0&&m.length>0){let e=await y({...A,file:{path:P},source:`- directory: .
2
2
  `,skipRoutes:I}),t=await j(e);if(t!==void 0){for(let n of e.assignedRouteSlugs)i.has(n)||i.set(n,t);let n=$(e.nodes);n!==null&&d.push({path:P,link:n})}}let z=me(d)??he(m);if(z!==null){let{path:e}=u(z);t.push(n(e,{stableKey:ae}))}let B=/* @__PURE__ */ new Map;for(let e of m){if(e.originFilePath===null)continue;let t=Y(e);B.set(t,[...B.get(t)??[],e.slug])}for(let[e,t]of[...i]){let n=M.get(e);for(let e of(n&&B.get(Y(n)))??[])i.has(e)||i.set(e,t)}let V=/* @__PURE__ */ new Map,H=(e.config.navbar?.items??[]).filter(e=>e.linkedSidebars?.length),U=/* @__PURE__ */ new Map,W=R.size===0&&H.length===0||v===void 0?/* @__PURE__ */ new Map:await p({io:e.io,routes:e.routes,versionedDirectories:v});for(let[t,n]of await de(H,e.routes,W,a,t=>e.entities.load(t)))R.set(t,[n,...R.get(t)??[]]);let G=({label:t,link:n,icon:r})=>({label:t,link:n,icon:r,[k]:h(n,e.routes,W)??void 0});for(let[e,r]of L){if(r===null)continue;let i=n(G(r));t.push(i),V.set(e,i)}for(let[e,r]of R){if(r.length===0)continue;let i=n(r.map(G));t.push(i),U.set(e,i)}for(let r of new Set(F.map(e=>e.route))){let a=i.get(r),o=a===void 0?void 0:l.get(a),s=o===void 0?null:pe(o,e.routes.bySlug(r)?.version??null);s!==null&&t.push(n(s,{stableKey:re(r)}))}return{entities:t,attach:[...i.entries()].map(([e,t])=>{let n={[E]:t},r=V.get(t);r!==void 0&&(n[ie]=r);let i=U.get(t);if(i!==void 0&&(n[T]=i),M.get(e)?.locale===``)for(let[e,r]of c.get(t)??[])n[D(e)]=r;return{slug:e,deps:n}}),problems:r}},loaders:[J]});export{N as FOLDER_SIDEBAR_FILENAME_REGEX,j as SIDEBAR_AGGREGATOR_LOADER_ID,M as SIDEBAR_FILENAME_REGEX,A as SIDEBAR_PLUGIN_ID,E as SIDEBAR_ROUTE_DEP_KEY,I as isTabbedSidebar,oe as resolveAutoSidebar,ge as sidebarContentPlugin};
@@ -95,6 +95,11 @@ export type FinalizeContext = {
95
95
  };
96
96
  export type FinalizeResult = {
97
97
  entities?: readonly AnyRawEntityReference[];
98
+ /**
99
+ * Named dependencies for existing routes. `slug` can be a page's locale fallback
100
+ * (`localeContext.toL10nSlug(slug, locale)`): the fallback serves these in place of the
101
+ * page's dependencies of the same key.
102
+ */
98
103
  attach?: readonly {
99
104
  slug: string;
100
105
  deps: Record<string, ContentDependencyReference>;
@@ -37,12 +37,22 @@ export type SearchFragmentUse = {
37
37
  * string or a list of strings; a document matches a filter when any of its values is selected.
38
38
  */
39
39
  export type SearchDocumentFacets = Record<string, string | string[]>;
40
+ /**
41
+ * Search curation. A query that contains one of `includes` shows the document before the
42
+ * ranked hits; a query that contains one of `excludes` does not show the document. A query
43
+ * contains a keyword when it has the keyword's words next to each other, in the same order,
44
+ * in any case. `excludes` wins over `includes`. A keyword of more than 10 words is ignored.
45
+ */
46
+ export type SearchDocumentKeywords = {
47
+ includes?: string[];
48
+ excludes?: string[];
49
+ };
40
50
  /**
41
51
  * One full-text search document an entity contributes; `docKey` is unique per entity.
42
52
  * `groupKey` is the display label the search dialog groups hits under. `anchor` is the
43
53
  * fragment a hit opens at (`routeSlug#anchor`), for documents that cover one page section.
44
- * `facets` are the document's values for the facets configured in `search.filters.facets`,
45
- * picked by the producer from its source's metadata. `rbacScope` (an operation's `x-rbac`)
54
+ * `facets` are the document's values for the default facets and the facets configured in
55
+ * `search.filters.facets`, picked by the producer from its source's metadata. `rbacScope` (an operation's `x-rbac`)
46
56
  * narrows the route's audience to the viewers it also admits; it never widens it.
47
57
  */
48
58
  export type SearchDocument = {
@@ -54,6 +64,7 @@ export type SearchDocument = {
54
64
  groupKey?: string;
55
65
  facets?: SearchDocumentFacets;
56
66
  rbacScope?: RbacScope;
67
+ keywords?: SearchDocumentKeywords;
57
68
  httpMethod?: string;
58
69
  httpPath?: string;
59
70
  deprecated?: boolean;
@@ -1 +1 @@
1
- import{splitUrlSuffix as e}from"../../../shared/utils/routes/split-url-suffix.js";import{toPhysicalVersionedSlug as t}from"../../../shared/constants/versions.js";import"../../versions/resolve.js";function n(t,n,i){if(!t.startsWith(`/`))return;let{path:a}=e(t),o=n.getAccess(a);if(o!==void 0)return o;let s=r(a,i);return s===null?void 0:n.getAccess(s)}function r(e,n){let r=[...n].sort(([e],[t])=>t.length-e.length);for(let[n,i]of r){if(!i.defaultVersion)continue;let r=t(e,n,i.defaultVersion);if(r!==null&&r!==e)return r}return null}export{n as linkedPageAccess};
1
+ import{splitUrlSuffix as e}from"../../../shared/utils/routes/split-url-suffix.js";import{toPhysicalVersionedSlug as t}from"../../../shared/constants/versions.js";function n(t,n,i){if(!t.startsWith(`/`))return;let{path:a}=e(t),o=n.getAccess(a);if(o!==void 0)return o;let s=r(a,i);return s===null?void 0:n.getAccess(s)}function r(e,n){let r=[...n].sort(([e],[t])=>t.length-e.length);for(let[n,i]of r){if(!i.defaultVersion)continue;let r=t(e,n,i.defaultVersion);if(r!==null&&r!==e)return r}return null}export{n as linkedPageAccess};
@@ -0,0 +1,10 @@
1
+ import type { Problem, ProblemCategory, ProblemDraft, ProblemSeverity } from './types.js';
2
+ type ProblemCodeDefaults = {
3
+ category: ProblemCategory;
4
+ severity: ProblemSeverity;
5
+ };
6
+ /** Problems a new load of the same input can clear; ingest marks their entities stale. */
7
+ export declare const RETRYABLE_PROBLEM_CODES: readonly string[];
8
+ export declare function resolveProblemDefaults(code: string): ProblemCodeDefaults;
9
+ export declare function createProblem(draft: ProblemDraft): Problem;
10
+ export {};
@@ -1 +1 @@
1
- const e={"link/missing-target":{category:`links`,severity:`error`},"link/missing-anchor":{category:`links`,severity:`error`},"markdoc/parse-error":{category:`markdown`,severity:`error`},"markdoc/validation-error":{category:`markdown`,severity:`error`},"markdown/frontmatter-parse":{category:`markdown`,severity:`warning`},"search/facet-invalid":{category:`search`,severity:`warning`},"spec/parse-failed":{category:`spec`,severity:`error`},"routing/slug-collision":{category:`routing`,severity:`error`},"routing/reserved-slug":{category:`routing`,severity:`error`},"routing/wildcard-shadowing":{category:`routing`,severity:`warning`},"plugin/extract-failed":{category:`plugin`,severity:`error`},"plugin/extract-all-failed":{category:`plugin`,severity:`error`},"plugin/finalize-failed":{category:`plugin`,severity:`error`},"plugin/loader-failed":{category:`plugin`,severity:`error`},"plugin/searchable-failed":{category:`plugin`,severity:`error`},"plugin/static-file-invalid":{category:`plugin`,severity:`error`},"plugin/static-file-conflict":{category:`plugin`,severity:`error`},"configuration/invalid":{category:`configuration`,severity:`error`},"configuration/ignored":{category:`configuration`,severity:`warning`},"configuration/deprecated":{category:`configuration`,severity:`warning`},"configuration/l10n-invalid":{category:`configuration`,severity:`error`},"configuration/l10n-layout":{category:`configuration`,severity:`warning`},"configuration/l10n-translations-invalid":{category:`configuration`,severity:`warning`},"configuration/app-data-namespace-conflict":{category:`configuration`,severity:`error`},"configuration/attach-conflict":{category:`configuration`,severity:`error`},"configuration/package-not-allowed":{category:`configuration`,severity:`error`},"sidebar/missing-target":{category:`configuration`,severity:`warning`},"sidebar/invalid-entry":{category:`configuration`,severity:`warning`},"sidebar/route-conflict":{category:`configuration`,severity:`warning`},"scorecard/lint-failed":{category:`spec`,severity:`warning`},"react-page/render-failed":{category:`page`,severity:`error`},"system/ingest-failed":{category:`system`,severity:`error`}},t={category:`plugin`,severity:`error`};function n(n){return e[n]??t}function r(e){let t=n(e.code);return{code:e.code,category:t.category,severity:e.severity??t.severity,message:e.message,location:e.location,data:e.data}}export{r as createProblem,n as resolveProblemDefaults};
1
+ const e={"link/missing-target":{category:`links`,severity:`error`},"link/missing-anchor":{category:`links`,severity:`error`},"markdoc/parse-error":{category:`markdown`,severity:`error`},"markdoc/validation-error":{category:`markdown`,severity:`error`},"markdoc/diagram-service-failed":{category:`markdown`,severity:`warning`},"markdown/frontmatter-parse":{category:`markdown`,severity:`warning`},"search/facet-invalid":{category:`search`,severity:`warning`},"spec/parse-failed":{category:`spec`,severity:`error`},"routing/slug-collision":{category:`routing`,severity:`error`},"routing/reserved-slug":{category:`routing`,severity:`error`},"routing/wildcard-shadowing":{category:`routing`,severity:`warning`},"plugin/extract-failed":{category:`plugin`,severity:`error`},"plugin/extract-all-failed":{category:`plugin`,severity:`error`},"plugin/finalize-failed":{category:`plugin`,severity:`error`},"plugin/loader-failed":{category:`plugin`,severity:`error`},"plugin/searchable-failed":{category:`plugin`,severity:`error`},"plugin/static-file-invalid":{category:`plugin`,severity:`error`},"plugin/static-file-conflict":{category:`plugin`,severity:`error`},"configuration/invalid":{category:`configuration`,severity:`error`},"configuration/ignored":{category:`configuration`,severity:`warning`},"configuration/deprecated":{category:`configuration`,severity:`warning`},"configuration/l10n-invalid":{category:`configuration`,severity:`error`},"configuration/l10n-layout":{category:`configuration`,severity:`warning`},"configuration/l10n-translations-invalid":{category:`configuration`,severity:`warning`},"configuration/app-data-namespace-conflict":{category:`configuration`,severity:`error`},"configuration/attach-conflict":{category:`configuration`,severity:`error`},"configuration/package-not-allowed":{category:`configuration`,severity:`error`},"sidebar/missing-target":{category:`configuration`,severity:`warning`},"sidebar/invalid-entry":{category:`configuration`,severity:`warning`},"sidebar/route-conflict":{category:`configuration`,severity:`warning`},"scorecard/lint-failed":{category:`spec`,severity:`warning`},"react-page/render-failed":{category:`page`,severity:`error`},"system/ingest-failed":{category:`system`,severity:`error`}},t=[`markdoc/diagram-service-failed`],n={category:`plugin`,severity:`error`};function r(t){return e[t]??n}function i(e){let t=r(e.code);return{code:e.code,category:t.category,severity:e.severity??t.severity,message:e.message,location:e.location,data:e.data}}export{t as RETRYABLE_PROBLEM_CODES,i as createProblem,r as resolveProblemDefaults};
@@ -1 +1 @@
1
- import{runWithSqliteBusyRetry as e}from"../database/connection.js";import{entities as t}from"../database/schema.js";import{and as n,eq as r}from"drizzle-orm";async function i(i,a){let[o]=await i.db.select({id:t.id,isCurrent:t.isCurrent}).from(t).where(n(r(t.key,a.key),r(t.revisionCreatedAt,a.revisionCreatedAt))).limit(1);return o?o.isCurrent===1?`refused-current`:(await e(()=>i.db.delete(t).where(r(t.id,o.id)),{operation:`delete entity revision`}),`deleted`):`not-found`}export{i as deleteEntityRevision};
1
+ import{entities as e}from"../database/schema.js";import{runWithSqliteBusyRetry as t}from"../database/connection.js";import{and as n,eq as r}from"drizzle-orm";async function i(i,a){let[o]=await i.db.select({id:e.id,isCurrent:e.isCurrent}).from(e).where(n(r(e.key,a.key),r(e.revisionCreatedAt,a.revisionCreatedAt))).limit(1);return o?o.isCurrent===1?`refused-current`:(await t(()=>i.db.delete(e).where(r(e.id,o.id)),{operation:`delete entity revision`}),`deleted`):`not-found`}export{i as deleteEntityRevision};
@@ -1 +1 @@
1
- import{ContentParser as e}from"./content-parser.js";import{DocumentField as t}from"./field.js";import{Statistic as n}from"./radix-tree/statistic.js";var r=class{fields=[];limit;parser=new e(new n);constructor(e){this.limit=e.limit;for(let n of e.fields)this.fields.push(new t(n))}search(e,t={}){let n=a(this.parser.getQueryTokens(e));if(n.length===0)return[];let r=e=>t.terms?.get(e)??/* @__PURE__ */ new Set([e]),o=this.fields.map(e=>({field:e,matches:e.match(n,r)})),s=t.documentFrequencies===void 0?i(o.filter(({field:e})=>e.countsTowardFrequency).map(({matches:e})=>e),n):new Map(n.map(e=>[e,t.documentFrequencies?.get(e)??0])),c=/* @__PURE__ */ new Map,l=/* @__PURE__ */ new Map;for(let{field:e,matches:t}of o){let r=e.rank(t,n,s);for(let[t,{rank:n,offsets:i,tokens:a}]of Object.entries(r)){let r=Number(t),o=c.get(r);o?(o.rank+=n*e.weight,o.fields.push({name:e.name,offsets:i,tokens:a})):c.set(r,{id:r,rank:n*e.weight,fields:[{name:e.name,offsets:i,tokens:a}]});let s=l.get(r);s||l.set(r,s=/* @__PURE__ */ new Set);for(let e of a)s.add(e)}}let u=n.filter(e=>!t.optional?.has(e)),d=u.length>0?u:n;for(let e of c.values()){let t=l.get(e.id),n=d.filter(e=>t?.has(e)).length;e.rank*=n/d.length}return Array.from(c.values()).sort((e,t)=>t.rank-e.rank).slice(0,this.limit)}};function i(e,t){let n=/* @__PURE__ */ new Map;for(let r of t){let t=/* @__PURE__ */ new Set;for(let n of e)for(let[e,i]of n)i[r]?.length&&t.add(e);n.set(r,t.size)}return n}function a(e){return[...new Set([...e].reverse())].reverse()}export{r as SearchEngine};
1
+ import{ContentParser as e}from"./content-parser.js";import{Statistic as t}from"./radix-tree/statistic.js";import{DocumentField as n}from"./field.js";var r=class{fields=[];limit;parser=new e(new t);constructor(e){this.limit=e.limit;for(let t of e.fields)this.fields.push(new n(t))}search(e,t={}){let n=a(this.parser.getQueryTokens(e));if(n.length===0)return[];let r=e=>t.terms?.get(e)??/* @__PURE__ */ new Set([e]),o=this.fields.map(e=>({field:e,matches:e.match(n,r)})),s=t.documentFrequencies===void 0?i(o.filter(({field:e})=>e.countsTowardFrequency).map(({matches:e})=>e),n):new Map(n.map(e=>[e,t.documentFrequencies?.get(e)??0])),c=/* @__PURE__ */ new Map,l=/* @__PURE__ */ new Map;for(let{field:e,matches:t}of o){let r=e.rank(t,n,s);for(let[t,{rank:n,offsets:i,tokens:a}]of Object.entries(r)){let r=Number(t),o=c.get(r);o?(o.rank+=n*e.weight,o.fields.push({name:e.name,offsets:i,tokens:a})):c.set(r,{id:r,rank:n*e.weight,fields:[{name:e.name,offsets:i,tokens:a}]});let s=l.get(r);s||l.set(r,s=/* @__PURE__ */ new Set);for(let e of a)s.add(e)}}let u=n.filter(e=>!t.optional?.has(e)),d=u.length>0?u:n;for(let e of c.values()){let t=l.get(e.id),n=d.filter(e=>t?.has(e)).length;e.rank*=n/d.length}return Array.from(c.values()).sort((e,t)=>t.rank-e.rank).slice(0,this.limit)}};function i(e,t){let n=/* @__PURE__ */ new Map;for(let r of t){let t=/* @__PURE__ */ new Set;for(let n of e)for(let[e,i]of n)i[r]?.length&&t.add(e);n.set(r,t.size)}return n}function a(e){return[...new Set([...e].reverse())].reverse()}export{r as SearchEngine};