@redocly/framework 1.0.0-next.2 → 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 (78) hide show
  1. package/dist/bundler/build/output-metadata.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/args.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/database/files.js +1 -1
  12. package/dist/content-layer/database/finalize.js +1 -1
  13. package/dist/content-layer/database/origins.js +1 -1
  14. package/dist/content-layer/ingest/finalize-phase.js +1 -1
  15. package/dist/content-layer/ingest/run.js +1 -1
  16. package/dist/content-layer/ingest/search-sync.js +1 -1
  17. package/dist/content-layer/ingest/sync.js +1 -1
  18. package/dist/content-layer/link-checker/delta.js +1 -1
  19. package/dist/content-layer/link-checker/run-build.js +1 -1
  20. package/dist/content-layer/loaders/context.js +1 -1
  21. package/dist/content-layer/markdown/client/markdoc-components.js +2 -2
  22. package/dist/content-layer/markdown/constants/builtin-tags.js +1 -1
  23. package/dist/content-layer/markdown/nodes/heading.js +1 -1
  24. package/dist/content-layer/markdown/resolve/raw-partials.d.ts +2 -1
  25. package/dist/content-layer/markdown/resolve/raw-partials.js +1 -1
  26. package/dist/content-layer/markdown/search/to-markdown.js +1 -1
  27. package/dist/content-layer/markdown/search/to-sections.js +1 -1
  28. package/dist/content-layer/markdown/search/to-text.d.ts +4 -1
  29. package/dist/content-layer/markdown/search/to-text.js +5 -5
  30. package/dist/content-layer/markdown/tags/variant.d.ts +6 -0
  31. package/dist/content-layer/markdown/tags/variant.js +1 -0
  32. package/dist/content-layer/markdown/utils/collect-anchors.js +1 -1
  33. package/dist/content-layer/markdown/utils/collect-headings.d.ts +3 -1
  34. package/dist/content-layer/markdown/utils/collect-headings.js +1 -1
  35. package/dist/content-layer/markdown/utils/first-heading.js +1 -1
  36. package/dist/content-layer/markdown/utils/heading-slugger.d.ts +8 -0
  37. package/dist/content-layer/markdown/utils/heading-slugger.js +1 -1
  38. package/dist/content-layer/materialization/entity.js +1 -1
  39. package/dist/content-layer/materialization/static-files.js +1 -1
  40. package/dist/content-layer/plugins/internal/api-docs/client/template.js +1 -1
  41. package/dist/content-layer/plugins/internal/api-docs/index.js +1 -1
  42. package/dist/content-layer/plugins/internal/api-functions/server/api-function-telemetry.js +1 -0
  43. package/dist/content-layer/plugins/internal/api-functions/server/dispatch.js +1 -1
  44. package/dist/content-layer/plugins/internal/markdoc/index.js +1 -1
  45. package/dist/content-layer/plugins/internal/mcp/server/agent-card.js +1 -1
  46. package/dist/content-layer/plugins/internal/mcp/server/auth.js +1 -1
  47. package/dist/content-layer/plugins/internal/mcp/server/custom-tools.js +1 -1
  48. package/dist/content-layer/plugins/internal/mcp/server/handler.js +1 -1
  49. package/dist/content-layer/plugins/internal/mcp/server/mcp-telemetry.js +1 -1
  50. package/dist/content-layer/plugins/internal/mcp/server/oauth/discovery.js +1 -1
  51. package/dist/content-layer/plugins/internal/mcp/server/server-card.js +1 -1
  52. package/dist/content-layer/plugins/internal/mcp/server/skills-resources.js +1 -1
  53. package/dist/content-layer/plugins/internal/react-page/index.d.ts +3 -2
  54. package/dist/content-layer/plugins/internal/react-page/index.js +1 -1
  55. package/dist/content-layer/plugins/internal/skills/server/routes.js +1 -1
  56. package/dist/content-layer/plugins/types/plugin.d.ts +5 -0
  57. package/dist/content-layer/search/postings/postings-store.js +1 -1
  58. package/dist/content-layer/search/store.d.ts +11 -0
  59. package/dist/content-layer/server/database.js +1 -1
  60. package/dist/content-layer/static/registry.js +1 -1
  61. package/dist/server/__tests__/rbac-fixture.js +1 -1
  62. package/dist/server/app.js +2 -2
  63. package/dist/server/content.js +11 -10
  64. package/dist/server/html-tags.js +2 -1
  65. package/dist/server/lambda-entry.js +1 -1
  66. package/dist/server/node-entry.js +1 -1
  67. package/dist/server/page-handlers.js +2 -2
  68. package/dist/server/search/route.js +1 -1
  69. package/dist/server/search/search-telemetry.js +1 -0
  70. package/dist/server/ssrf/ssrf-blocklist.js +1 -1
  71. package/dist/server/static-files/serve.js +1 -1
  72. package/dist/server/subprocess/child-entry.js +1 -1
  73. package/dist/server/subprocess/host.js +1 -1
  74. package/dist/shared/experiments.js +1 -1
  75. package/dist/shared/load-dot-env.js +1 -1
  76. package/dist/shared/public-env.d.ts +9 -0
  77. package/dist/shared/public-env.js +1 -1
  78. package/package.json +5 -4
@@ -1 +1 @@
1
- import{compareStrings as e}from"../../shared/utils/compare-strings.js";import{isObject as t}from"../../shared/utils/is-object.js";import{getStaticFilesOutputDir as n,getStaticManifestPath as r}from"../../shared/constants/runtime-layout.js";import{isDataRefMarker as i}from"./data-ref.js";import{resolveDataRef as a}from"../database/blobs.js";import{MaterializationError as o}from"../problems/problem-error.js";import{loadEntityRecordByKey as s}from"../database/entities.js";import{updateStaticFileBodies as c}from"../database/static-files.js";import{writeFileAtomically as l}from"./asset-reconcile.js";import{producerContentType as u,toStaticBodyBytes as d}from"../static/producer-value.js";import{join as f}from"node:path";function p(e){return new Set(e.flatMap(e=>e.kind===`producer`&&e.entityKey?[e.entityKey]:[]))}async function m(e){let t=/* @__PURE__ */ new Set;for(let n of e.staleProducers)try{await e.materializeEntity(n)}catch(r){if(!(r instanceof o))throw r;t.add(n.key),e.logger.debug(`Could not materialize the static producer ${n.key}; recorded the problem and moved on`)}let n=[];for(let r of e.rows){let i=e.resolveAudience(r);if(r.kind===`copy`){n.push(h(e.io,e.contentDir,r,i));continue}let a=await g(e.io,e.database,r,i,r.entityKey!==null&&t.has(r.entityKey));a&&n.push(a)}let r=await _(e.io,{contentDir:e.contentDir,entries:n}),i=new Map(e.rows.map(e=>[e.path,e]));return await c(e.database,r.manifest.files.filter(e=>{let t=i.get(e.path);return t?.hash!==e.hash||t.size!==e.size}).map(e=>({path:e.path,hash:e.hash,size:e.size}))),e.logger.info(`Static files: ${r.manifest.files.length} registered, ${r.written.length} written, ${r.removed.length} removed`),r.manifest}function h(e,t,n,r){if(!n.sourcePath||!n.hash)throw Error(`Static file "${n.path}" has no copy source.`);let i=f(t,n.sourcePath);return{path:n.path,hash:n.hash,contentType:n.contentType,audience:r,write:t=>e.copyFile(i,t)}}async function g(e,n,r,o,c){let l=r.entityKey?await s(n,r.entityKey):null;if(!l||l.status!==`ready`&&!c)throw Error(`Static file "${r.path}": producer entity "${r.entityKey}" is not ready.`);let f=l.data;if(!t(f)||!i(f.body)){if(c)return null;throw Error(`Static file "${r.path}": producer "${r.entityKey}" must return { body: BlobReference }.`)}let p=f.body;return{path:r.path,hash:p.blobKey,contentType:u(f,r),audience:o,write:async t=>e.writeFile(t,d(await a(n,p)))}}async function _(t,i){let a=n(i.contentDir),o=r(i.contentDir),s=new Map((await v(t,o))?.files.map(e=>[e.path,e])??[]),c=new Set(await y(t,a)),u=[],d=[];for(let e=0;e<i.entries.length;e+=16)await Promise.all(i.entries.slice(e,e+16).map(async e=>{let n=f(a,...e.path.split(`/`)),r=s.get(e.path),i=r?.hash===e.hash&&c.has(e.path)?r.size:null;i===null&&(await l(t,n,e.write),i=(await t.stat(n))?.size??0,u.push(e.path)),d.push({path:e.path,hash:e.hash,contentType:e.contentType,size:i,audience:e.audience})}));let p=new Set(i.entries.map(e=>e.path)),m=[...c].filter(e=>!p.has(e));await Promise.all(m.map(e=>t.unlink(f(a,...e.split(`/`))))),d.sort((t,n)=>e(t.path,n.path));let h={formatVersion:1,files:d};return await t.writeFile(o,JSON.stringify(h,null,2),{recursive:!0}),{manifest:h,written:u,removed:m}}async function v(e,t){try{let n=JSON.parse(await e.readFile(t));return Array.isArray(n.files)?n:null}catch{return null}}async function y(e,t,n=``){let r=[],i;try{i=await e.readdir(t)}catch{return r}for(let a of i){let i=`${n}${a.name}`;a.type===`directory`?r.push(...await y(e,f(t,a.name),`${i}/`)):a.type===`file`&&r.push(i)}return r}export{p as collectStaticProducerKeys,m as materializeStaticProducers,_ as reconcileStaticFiles};
1
+ import{compareStrings as e}from"../../shared/utils/compare-strings.js";import{isObject as t}from"../../shared/utils/is-object.js";import{getStaticFilesOutputDir as n,getStaticManifestPath as r}from"../../shared/constants/runtime-layout.js";import{isDataRefMarker as i}from"./data-ref.js";import{resolveDataRef as a}from"../database/blobs.js";import{MaterializationError as o}from"../problems/problem-error.js";import{loadEntityRecordByKey as s}from"../database/entities.js";import{updateStaticFileBodies as c}from"../database/static-files.js";import{producerContentType as l,toStaticBodyBytes as u}from"../static/producer-value.js";import{writeFileAtomically as d}from"./asset-reconcile.js";import{join as f}from"node:path";function p(e){return new Set(e.flatMap(e=>e.kind===`producer`&&e.entityKey?[e.entityKey]:[]))}async function m(e){let t=/* @__PURE__ */ new Set;for(let n of e.staleProducers)try{await e.materializeEntity(n)}catch(r){if(!(r instanceof o))throw r;t.add(n.key),e.logger.debug(`Could not materialize the static producer ${n.key}; recorded the problem and moved on`)}let n=[];for(let r of e.rows){let i=e.resolveAudience(r);if(r.kind===`copy`){n.push(h(e.io,e.contentDir,r,i));continue}let a=await g(e.io,e.database,r,i,r.entityKey!==null&&t.has(r.entityKey));a&&n.push(a)}let r=await _(e.io,{contentDir:e.contentDir,entries:n}),i=new Map(e.rows.map(e=>[e.path,e]));return await c(e.database,r.manifest.files.filter(e=>{let t=i.get(e.path);return t?.hash!==e.hash||t.size!==e.size}).map(e=>({path:e.path,hash:e.hash,size:e.size}))),e.logger.info(`Static files: ${r.manifest.files.length} registered, ${r.written.length} written, ${r.removed.length} removed`),r.manifest}function h(e,t,n,r){if(!n.sourcePath||!n.hash)throw Error(`Static file "${n.path}" has no copy source.`);let i=f(t,n.sourcePath);return{path:n.path,hash:n.hash,contentType:n.contentType,audience:r,write:t=>e.copyFile(i,t)}}async function g(e,n,r,o,c){let d=r.entityKey?await s(n,r.entityKey):null;if(!d||d.status!==`ready`&&!c)throw Error(`Static file "${r.path}": producer entity "${r.entityKey}" is not ready.`);let f=d.data;if(!t(f)||!i(f.body)){if(c)return null;throw Error(`Static file "${r.path}": producer "${r.entityKey}" must return { body: BlobReference }.`)}let p=f.body;return{path:r.path,hash:p.blobKey,contentType:l(f,r),audience:o,write:async t=>e.writeFile(t,u(await a(n,p)))}}async function _(t,i){let a=n(i.contentDir),o=r(i.contentDir),s=new Map((await v(t,o))?.files.map(e=>[e.path,e])??[]),c=new Set(await y(t,a)),l=[],u=[];for(let e=0;e<i.entries.length;e+=16)await Promise.all(i.entries.slice(e,e+16).map(async e=>{let n=f(a,...e.path.split(`/`)),r=s.get(e.path),i=r?.hash===e.hash&&c.has(e.path)?r.size:null;i===null&&(await d(t,n,e.write),i=(await t.stat(n))?.size??0,l.push(e.path)),u.push({path:e.path,hash:e.hash,contentType:e.contentType,size:i,audience:e.audience})}));let p=new Set(i.entries.map(e=>e.path)),m=[...c].filter(e=>!p.has(e));await Promise.all(m.map(e=>t.unlink(f(a,...e.split(`/`))))),u.sort((t,n)=>e(t.path,n.path));let h={formatVersion:1,files:u};return await t.writeFile(o,JSON.stringify(h,null,2),{recursive:!0}),{manifest:h,written:l,removed:m}}async function v(e,t){try{let n=JSON.parse(await e.readFile(t));return Array.isArray(n.files)?n:null}catch{return null}}async function y(e,t,n=``){let r=[],i;try{i=await e.readdir(t)}catch{return r}for(let a of i){let i=`${n}${a.name}`;a.type===`directory`?r.push(...await y(e,f(t,a.name),`${i}/`)):a.type===`file`&&r.push(i)}return r}export{p as collectStaticProducerKeys,m as materializeStaticProducers,_ as reconcileStaticFiles};
@@ -1,4 +1,4 @@
1
- import{REPLAY_OAUTH2_ROUTE_PATH as e}from"../../../../../shared/constants/replay.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{API_DOCS_INFO_BLOCK_DEP_KEY as n,API_DOCS_RENDER_DEP_KEY as r,apiPageTitle as i}from"../server/shared.js";import{ApiDocsLayoutContext as a,PageContext as o}from"../../../../../client/contexts.js";import{MarkdocRenderer as s,markdocComponents as c}from"../../../../markdown/client/markdoc-components.js";import{rebaseItemLinks as l}from"./rebase-item-links.js";import{apiDocsTelemetryConfig as u}from"../../../../../client/telemetry/config.js";import{withReplayOptions as d}from"../../../../../client/replay-options.js";import{JsonSchemaTag as f}from"../../../../markdown/client/JsonSchemaTag.js";import{JsonExample as p}from"../../../../markdown/client/OpenapiTagComponents.js";import{withEventHandlers as m}from"./event-handlers.js";import{useContext as h,useEffect as g,useMemo as _}from"react";import{useLocation as v}from"react-router";import{Fragment as y,jsx as b,jsxs as x}from"react/jsx-runtime";import S from"styled-components";import{useThemeConfig as C}from"@redocly/theme/core/hooks";import{LayoutVariant as w}from"@redocly/theme/components/SidebarActions/SidebarActions";import{useLoaderData as T}from"virtual:realm-runtime";import{userMarkdocComponents as E}from"virtual:realm-markdoc-components";import{RedoclyApiDocs as D,apiDocsMarkdocComponents as O}from"@redocly/api-docs";import{Breadcrumbs as k}from"@redocly/theme/components/Breadcrumbs/Breadcrumbs";import{CatalogClassicInfoBlock as A}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{MissingTranslationNotice as j}from"@redocly/theme/components/MissingTranslationNotice/MissingTranslationNotice";import{ThreePanelLayout as M}from"@redocly/theme/layouts/ThreePanelLayout";const N={...c,JsonSchema:f,JsonExample:p,...E,...O},P={parse:e=>e,render:e=>/* @__PURE__ */ b(s,{ast:e,components:N})},F={MiddlePanelHeader:I};function I(){return/* @__PURE__ */ x(y,{children:[/* @__PURE__ */ b(k,{}),/* @__PURE__ */ b(V,{})]})}function L(e){return(e.length>1&&e.endsWith(`/`)?e.slice(0,-1):e).toLowerCase()}function R({page:e}){let t=T(r),i=T(n),{layout:o}=h(a),s=z(),c=_(()=>t&&{...m(d(t.options)),oAuth2RedirectURI:B(),userClaims:s,unstable_hooks:F},[t,s]),f=e.slug.toLowerCase(),p=_(()=>t&&t.basePath!==f?l(t.items,t.basePath,f):t?.items,[t,f]);if(U(e.metadata,p,t?.title),!t)return null;let g=u();return/* @__PURE__ */ x(y,{children:[i&&/* @__PURE__ */ b(H,{layout:o,children:/* @__PURE__ */ b(A,{metadata:i})}),/* @__PURE__ */ b(D,{items:p,store:t.store,options:c,basePath:f,layout:o,markdownAdapter:P,telemetryConfig:g})]})}function z(){let e=h(o)?.auth?.userInfo,t=e?.isAuthenticated?e.email:void 0,n=e?.isAuthenticated?e.name:void 0;return _(()=>({email:t,name:n}),[t,n])}function B(){if(typeof window<`u`)return new URL(t(e),window.location.origin).toString()}const V=S(j)`
1
+ import{REPLAY_OAUTH2_ROUTE_PATH as e}from"../../../../../shared/constants/replay.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{API_DOCS_INFO_BLOCK_DEP_KEY as n,API_DOCS_RENDER_DEP_KEY as r,apiPageTitle as i}from"../server/shared.js";import{ApiDocsLayoutContext as a,PageContext as o}from"../../../../../client/contexts.js";import{MarkdocRenderer as s,markdocComponents as c}from"../../../../markdown/client/markdoc-components.js";import{rebaseItemLinks as l}from"./rebase-item-links.js";import{apiDocsTelemetryConfig as u}from"../../../../../client/telemetry/config.js";import{withReplayOptions as d}from"../../../../../client/replay-options.js";import{JsonSchemaTag as f}from"../../../../markdown/client/JsonSchemaTag.js";import{JsonExample as p}from"../../../../markdown/client/OpenapiTagComponents.js";import{withEventHandlers as m}from"./event-handlers.js";import{useContext as h,useEffect as g,useMemo as _}from"react";import{useLocation as v}from"react-router";import{Fragment as y,jsx as b,jsxs as x}from"react/jsx-runtime";import S from"styled-components";import{useThemeConfig as C}from"@redocly/theme/core/hooks";import{LayoutVariant as w}from"@redocly/theme/components/SidebarActions/SidebarActions";import{useLoaderData as T}from"virtual:realm-runtime";import{userMarkdocComponents as E}from"virtual:realm-markdoc-components";import{RedoclyApiDocs as D,apiDocsMarkdocComponents as O}from"@redocly/api-docs";import{Breadcrumbs as k}from"@redocly/theme/components/Breadcrumbs/Breadcrumbs";import{CatalogClassicInfoBlock as A}from"@redocly/theme/components/CatalogClassic/CatalogClassicInfoBlock";import{MissingTranslationNotice as j}from"@redocly/theme/components/MissingTranslationNotice/MissingTranslationNotice";import{ThreePanelLayout as M}from"@redocly/theme/layouts/ThreePanelLayout";const N={...c,JsonSchema:E.JsonSchema??f,JsonExample:E.JsonExample??p,...O},P={parse:e=>e,render:e=>/* @__PURE__ */ b(s,{ast:e,components:N})},F={MiddlePanelHeader:I};function I(){return/* @__PURE__ */ x(y,{children:[/* @__PURE__ */ b(k,{}),/* @__PURE__ */ b(V,{})]})}function L(e){return(e.length>1&&e.endsWith(`/`)?e.slice(0,-1):e).toLowerCase()}function R({page:e}){let t=T(r),i=T(n),{layout:o}=h(a),s=z(),c=_(()=>t&&{...m(d(t.options)),oAuth2RedirectURI:B(),userClaims:s,unstable_hooks:F},[t,s]),f=e.slug.toLowerCase(),p=_(()=>t&&t.basePath!==f?l(t.items,t.basePath,f):t?.items,[t,f]);if(U(e.metadata,p,t?.title),!t)return null;let g=u();return/* @__PURE__ */ x(y,{children:[i&&/* @__PURE__ */ b(H,{layout:o,children:/* @__PURE__ */ b(A,{metadata:i})}),/* @__PURE__ */ b(D,{items:p,store:t.store,options:c,basePath:f,layout:o,markdownAdapter:P,telemetryConfig:g})]})}function z(){let e=h(o)?.auth?.userInfo,t=e?.isAuthenticated?e.email:void 0,n=e?.isAuthenticated?e.name:void 0;return _(()=>({email:t,name:n}),[t,n])}function B(){if(typeof window<`u`)return new URL(t(e),window.location.origin).toString()}const V=S(j)`
2
2
  width: 100%;
3
3
  `,H=S(M)`
4
4
  && {
@@ -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{runtimeTemplate as r}from"../../templates.js";import{SEARCH_API_TITLE_FACET_FIELD as i,SEARCH_API_VERSION_FACET_FIELD as a,SEARCH_GROUP_FACET_FIELD as o}from"../../../../shared/search/facets.js";import{configuredFacetFields as s,extractFacetsFromFrontmatter as c,invalidFacetValueProblems as l,searchCategoryOf as u}from"../../../search/facet-values.js";import{toPosixPath as d}from"../../../../shared/utils/to-posix-path.js";import{TRANSLATIONS_FILE_PATTERN as f}from"../../../../shared/constants/l10n/defaults.js";import{isObject as p}from"../../../../shared/utils/is-object.js";import{notInPlanProblem as m}from"../../../plan-gates.js";import{filePathToRouteSlug as h}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{SPEC_KIND_ARAZZO as g,SPEC_KIND_ASYNCAPI as _,SPEC_KIND_GRAPHQL as v,SPEC_KIND_OPENAPI as y}from"../../types/api-entity.js";import{isPlanFeatureGranted as b}from"../../../../shared/plan-gates.js";import{packMarkdocAstsDeep as x,unpackMarkdocAstsDeep as S}from"../../../markdown/utils/packed-ast.js";import{parseMarkdownCached as C}from"../../../markdown/utils/parse-cache.js";import{createApiEntityKey as w}from"../../utils/api-entity-key.js";import{API_DOCS_API_LOADER_ID as T,API_DOCS_PLUGIN_ID as ee,API_DOCS_RENDER_DEP_KEY as E,API_DOCS_RENDER_LOADER_ID as D,API_DOCS_SIDEBAR_LOADER_ID as te,API_DOCS_TEMPLATE_ID as O,SPEC_DOWNLOAD_ROUTE_PATHS as k,SPEC_PATH_PARAM as ne}from"./server/shared.js";import{resolveApiBundleConfig as re,resolveApiOptions as ie,resolveNestedFeedback as ae,schemaCatalogLink as oe,withDownloadUrls as se,withFeedbackOption as ce,withMockServerOption as le}from"./server/options.js";import{annotateApiDocsRbac as ue}from"../../../../server/rbac/api-docs.js";import{SERVER_ONLY_VALUE_KEY as A}from"../../../loaders/server-only-value.js";import{getLoadedProjectPlugins as de}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as j}from"../../../api-outputs.js";import{API_DOCS_MARKDOC_TAG_SET as M,resolveMarkdocTagSet as N}from"../../../markdown/constants/tag-sets.js";import{pageLocale as P}from"../../utils/page-locale.js";import{buildBundledApiDefinition as F,resolveLlmsDescriptions as I}from"./server/build-definition.js";import{collectSidebarSubpathTargets as L,toSidebarSubtree as R,toSubpathTarget as z}from"./server/build-sidebar.js";import{buildApiDocsMarkdownDocs as B}from"./server/markdown-docs.js";import{join as V,relative as H}from"node:path";import fe from"@redocly/markdoc";const pe=[`.yaml`,`.yml`,`.json`,`.gql`,`.graphql`],me={[y]:`OpenAPI`,[_]:`AsyncAPI`,[v]:`GraphQL`,[g]:`Arazzo`},U=t(D,async e=>{let{buildItems:t}=await import(`@redocly/api-docs`),n=K(e),r=await e.io.readFile(n.absolutePath),i=e.routes.byFilePath(e.file.path)?.slug,a=se(e.args.options,e.file.path,e.args.kind),o=e.args.kind===`openapi`?le(a,e.config,i):a,s={entityDeps:[],assetUsages:[],linkRefs:[],problems:[],pending:[]},c=G(e.contentDir),l={markdown:e.markdown,loader:{config:e.config,entities:e.entities,file:e.file,io:e.io,logger:e.logger,plugin:e.plugin},sink:s},u=await F({kind:e.args.kind,source:r,relativePath:n.relativePath,contentDir:e.contentDir,pagePath:e.file.path,options:o,bundle:q(e.args,c),metadata:X(e.args.options),markdownResolution:l,rbac:{warn:t=>e.logger?.warn(t)}}),d={...p(u.document)&&p(u.document.info)?{infoDescription:u.document.info.description}:{},...await I(u.document,l,{contentDir:e.contentDir,specPath:n.relativePath,pagePath:e.file.path})};e.args.kind===`openapi`&&o.showSchemaCatalogLinks&&p(u.document)&&(u.document[`x-schema-catalog-link`]=oe(e.file.path)),u.options=ce(u.options,u.document,e.args.feedback??e.config.feedback);let f=i?.toLowerCase()??`/`,{items:m,store:h,specType:g}=await t({...u,basePath:f,markdownParser:e=>fe.compact(C(e))}),_=JSON.stringify({items:x(m),store:x(h),options:u.options,specType:g,basePath:f,title:be(u.document,e.args.kind,m),metadata:ye(u.document),[A]:{llms:d}});return{value:await e.createBlobRef(_,{format:`json`}),entityDeps:[...Y(e.file.path,[...u.fileDependencies,...c.paths]),...s.entityDeps],assetUsages:s.assetUsages,markdoc:{tagSet:M},linkRefs:s.linkRefs,problems:s.problems}},{async searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=S(e),r=await Ee(t.entities,t.route.originFilePath),d={...t.route.metadata,...p(n.metadata)?n.metadata:{}},{category:f,isInvalid:m}=u(d),{facets:h,invalidFields:g}=c({[i]:t.route.metadata.title,[a]:t.route.metadata.version,...d},s(t.config)),{buildApiDocsSearchDocuments:_}=await import(`./server/search-documents.js`);return{..._(n,r,{groupKey:f,facets:h,warn:e=>t.logger?.warn(e)}),problems:l([...g,...m?[o]:[]],t.route.originFilePath)}},async markdown(e,t){if(t.route===void 0)return null;let n=S(e),r=t.route.originFilePath??void 0,i=r?await t.entities.load(w(r)).catch(()=>void 0):void 0,{tags:a}=await N(M);return B(n,ve(i,n[A]?.llms),r,{tags:a,locale:P(t)})},usesProjectMarkdocSchema:!0}),W=t(T,async e=>{let t=K(e),n=await e.io.readFile(t.absolutePath),r=G(e.contentDir),i=await F({kind:e.args.kind,source:n,relativePath:t.relativePath,contentDir:e.contentDir,bundle:q(e.args,r),metadata:X(e.args.options)}),a=e.args.kind===v,o=a?n:JSON.stringify(i.document);return{value:o.length>65536?await e.createBlobRef(o,{format:a?`text`:`json`}):a?n:i.document,metadata:{...Z(e.file.path,e.args.kind,e.args.options,e.args.rbac),...ge(i.document,e.routes.byFilePath(e.file.path)?.slug)},entityDeps:Y(e.file.path,[...i.fileDependencies,...r.paths])}});function G(e){let t=de(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>d(H(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function K(e){let t=e.args.source?.path??e.file.path;return{relativePath:t,absolutePath:V(e.contentDir,t)}}function he(e){let t=e[j];return p(t)&&typeof t.root==`string`?t.root:void 0}function q(e,t){let{config:n,configDir:r}=e.bundleConfig??{config:{},configDir:``};return{config:n,configDir:r,plugins:t.plugins}}function ge(e,t){let n=p(e)&&p(e.info)?e.info:{},r=p(n[`x-metadata`])?n[`x-metadata`]:{},i=typeof n.description==`string`?n.description.trim():``;return{...t===void 0?{}:{routeSlug:t},...Q(n.version)?{version:String(n.version)}:{},...typeof r.apiId==`string`?{apiId:r.apiId}:{},description:i||void 0}}const J=t(te,async e=>{let{buildNavItems:t,collectPreviousRouteSlugs:n}=await import(`@redocly/api-docs`),r=await e.entities.load(w(e.file.path)),i=e.args.kind===`graphql`?(await import(`graphql`)).parse(r):r,a=ue(i,e.args.kind,{warn:t=>e.logger?.warn(t)}),{items:o}=await t({type:e.args.kind,document:a,options:e.args.options,basePath:`/`,markdownParser:C}),s=R(o),c=n(o).map(({from:e})=>z(e));return{value:s,targetInventories:[{kind:`subpath`,exhaustive:!0,targets:[...L(s),...c]}]}});function Y(e,t){return[{kind:`file`,path:e},...t.map(e=>({kind:`file`,path:e}))]}const _e={arazzo:`Arazzo Docs`,asyncapi:`AsyncAPI Docs`,graphql:`GraphQL Docs`,openapi:`OpenAPI Docs`};function ve(e,t){if(t===void 0||!p(e))return e;let n=p(e.info)?e.info:{},r=p(e.components)?e.components:{};return{...e,...t.infoDescription===void 0?{}:{info:{...n,description:t.infoDescription}},...t.servers===void 0?{}:{servers:t.servers},...t.securitySchemes===void 0?{}:{components:{...r,securitySchemes:t.securitySchemes}}}}function ye(e){let t=p(e)&&p(e.info)?e.info:{};return p(t[`x-metadata`])?t[`x-metadata`]:{}}function be(e,t,n){let r=p(e)&&p(e.info)?e.info:{};if(typeof r.title==`string`&&r.title!==``)return r.title;let i=p(n[0])?n[0].label:void 0;return typeof i==`string`&&i!==``?i:_e[t]}const xe=[`rbac`,`sidebar`,`excludeFromSearch`,`template`];function Se(e,t){let n=p(e.manifest.info)?e.manifest.info:{},r={};typeof n.title==`string`&&(r.title=n.title),Q(n.version)&&(r.version=String(n.version)),typeof n.summary==`string`&&(r.summary=n.summary),p(n[`x-metadata`])&&Object.assign(r,n[`x-metadata`]),p(t.metadata)&&Object.assign(r,t.metadata);for(let e of xe)delete r[e];return r}function X(e){return p(e.metadata)?e.metadata:void 0}function Ce(e){let t=X(e)?.title;return typeof t==`string`&&t.length>0?t:void 0}function Z(e,t,n,r){let i=Ce(n);return{specType:t,sourcePath:e,...i===void 0?{}:{title:i},...r===void 0?{}:{rbac:r},...Object.keys(n).length>0?{options:n}:{},...p(n.mockServer)?{mockServer:n.mockServer}:{}}}function Q(e){return typeof e==`string`||typeof e==`number`}function we(e){if(e.ext===`.gql`||e.ext===`.graphql`)return v;let{openapi:t,swagger:n,asyncapi:r,arazzo:i}=e.manifest;return Q(t)||Q(n)?y:Q(r)?_:Q(i)?g:null}const Te=e({id:ee,version:`0.42.0`,content:{filter:{extensions:pe},async extractFile(e,t){if(f.test(e.path))return null;let n=we(e);if(n===null)return null;if(n!==`arazzo`&&!b(t.config,n))return{routes:[],problems:[m(`${me[n]} documents`)]};let r=e.path,i=he(e.manifest),a=i??r,{rbac:o,...s}=await ie(t.io,t.config,r,n,a),c={filePath:r,kind:n,options:s,...o===void 0||!b(t.config,`rbac`)?{}:{rbac:o}};i!==void 0&&(c.source={path:i});let l=await ae(t.io,t.config,a);if(l!==void 0&&(c.feedback=l),n!==`graphql`){let e=await re(t.io,t.config,r,a);Object.keys(e.config).length>0&&(c.bundleConfig=e)}let u=W.withArgs(c,{stableKey:w(r),type:`api`,metadata:Z(r,n,s,c.rbac)});if(n===`arazzo`)return{routes:[],entities:[u]};let d=Se(e,s);s.excludeFromSearch===!0&&(d.excludeFromSearch=!0),d.type=n,c.rbac!==void 0&&(d.rbac=c.rbac);let p=U.withArgs(c,{stableKey:`api-docs:render:${r}`}),g=J.withArgs(c,{stableKey:`api-docs:sidebar:${r}`}),_=h(r);return{routes:[{deps:{[E]:p},metadata:d,routeId:`page`,sidebarSubtree:g,slug:null,slugHint:_,template:O,wildcardPrefix:!0}],entities:[u,p,g]}}},loaders:[W,U,J],templates:{[O]:r(n(`./client/template.tsx`,import.meta.url))},server:{routes:[$(k.bundle,`bundle`),$(k.deprecatedBundle,`bundle`),$(k.graphql,`graphql`)]}});function $(e,t){return{method:`GET`,path:e+ne,handler:{filePath:`./server/spec-download.ts`,importer:import.meta.url,exportName:t}}}async function Ee(e,t){if(t)try{return await e.load(w(t))}catch{return}}export{Te as apiDocsContentPlugin};
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{runtimeTemplate as r}from"../../templates.js";import{SEARCH_API_TITLE_FACET_FIELD as i,SEARCH_API_VERSION_FACET_FIELD as a,SEARCH_GROUP_FACET_FIELD as o}from"../../../../shared/search/facets.js";import{configuredFacetFields as s,extractFacetsFromFrontmatter as c,invalidFacetValueProblems as l,searchCategoryOf as u}from"../../../search/facet-values.js";import{toPosixPath as d}from"../../../../shared/utils/to-posix-path.js";import{TRANSLATIONS_FILE_PATTERN as f}from"../../../../shared/constants/l10n/defaults.js";import{isObject as p}from"../../../../shared/utils/is-object.js";import{notInPlanProblem as m}from"../../../plan-gates.js";import{filePathToRouteSlug as h}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{SPEC_KIND_ARAZZO as g,SPEC_KIND_ASYNCAPI as _,SPEC_KIND_GRAPHQL as v,SPEC_KIND_OPENAPI as y}from"../../types/api-entity.js";import{isPlanFeatureGranted as b}from"../../../../shared/plan-gates.js";import{packMarkdocAstsDeep as x,unpackMarkdocAstsDeep as S}from"../../../markdown/utils/packed-ast.js";import{parseMarkdownCached as C}from"../../../markdown/utils/parse-cache.js";import{createApiEntityKey as w}from"../../utils/api-entity-key.js";import{API_DOCS_API_LOADER_ID as T,API_DOCS_PLUGIN_ID as ee,API_DOCS_RENDER_DEP_KEY as E,API_DOCS_RENDER_LOADER_ID as D,API_DOCS_SIDEBAR_LOADER_ID as te,API_DOCS_TEMPLATE_ID as O,SPEC_DOWNLOAD_ROUTE_PATHS as k,SPEC_PATH_PARAM as ne}from"./server/shared.js";import{resolveApiBundleConfig as re,resolveApiOptions as ie,resolveNestedFeedback as ae,schemaCatalogLink as oe,withDownloadUrls as se,withFeedbackOption as ce,withMockServerOption as le}from"./server/options.js";import{annotateApiDocsRbac as ue}from"../../../../server/rbac/api-docs.js";import{SERVER_ONLY_VALUE_KEY as A}from"../../../loaders/server-only-value.js";import{getLoadedProjectPlugins as de}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as j}from"../../../api-outputs.js";import{API_DOCS_MARKDOC_TAG_SET as M,resolveMarkdocTagSet as N}from"../../../markdown/constants/tag-sets.js";import{pageLocale as P}from"../../utils/page-locale.js";import{buildBundledApiDefinition as F,resolveLlmsDescriptions as I}from"./server/build-definition.js";import{collectSidebarSubpathTargets as L,toSidebarSubtree as R,toSubpathTarget as z}from"./server/build-sidebar.js";import{buildApiDocsMarkdownDocs as B}from"./server/markdown-docs.js";import{join as V,relative as H}from"node:path";import fe from"@redocly/markdoc";const pe=[`.yaml`,`.yml`,`.json`,`.gql`,`.graphql`],me={[y]:`OpenAPI`,[_]:`AsyncAPI`,[v]:`GraphQL`,[g]:`Arazzo`},U=t(D,async e=>{let{buildItems:t}=await import(`@redocly/api-docs`),n=K(e),r=await e.io.readFile(n.absolutePath),i=e.routes.byFilePath(e.file.path)?.slug,a=se(e.args.options,e.file.path,e.args.kind),o=e.args.kind===`openapi`?le(a,e.config,i):a,s={entityDeps:[],assetUsages:[],linkRefs:[],problems:[],pending:[]},c=G(e.contentDir),l={markdown:e.markdown,loader:{config:e.config,entities:e.entities,file:e.file,io:e.io,logger:e.logger,plugin:e.plugin},sink:s},u=await F({kind:e.args.kind,source:r,relativePath:n.relativePath,contentDir:e.contentDir,pagePath:e.file.path,options:o,bundle:q(e.args,c),metadata:X(e.args.options),markdownResolution:l,rbac:{warn:t=>e.logger?.warn(t)}}),d={...p(u.document)&&p(u.document.info)?{infoDescription:u.document.info.description}:{},...await I(u.document,l,{contentDir:e.contentDir,specPath:n.relativePath,pagePath:e.file.path})};e.args.kind===`openapi`&&o.showSchemaCatalogLinks&&p(u.document)&&(u.document[`x-schema-catalog-link`]=oe(e.file.path)),u.options=ce(u.options,u.document,e.args.feedback??e.config.feedback);let f=i?.toLowerCase()??`/`,{items:m,store:h,specType:g}=await t({...u,basePath:f,markdownParser:e=>fe.compact(C(e))}),_=JSON.stringify({items:x(m),store:x(h),options:u.options,specType:g,basePath:f,title:be(u.document,e.args.kind,m),metadata:ye(u.document),[A]:{llms:d}});return{value:await e.createBlobRef(_,{format:`json`}),entityDeps:[...Y(e.file.path,[...u.fileDependencies,...c.paths]),...s.entityDeps],assetUsages:s.assetUsages,markdoc:{tagSet:M},linkRefs:s.linkRefs,problems:s.problems}},{async searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=S(e),r=await Ee(t.entities,t.route.originFilePath),d={...t.route.metadata,...p(n.metadata)?n.metadata:{}},{category:f,isInvalid:m}=u(d),{facets:h,invalidFields:g}=c({[i]:t.route.metadata.title,[a]:t.route.metadata.version,...d},s(t.config)),{buildApiDocsSearchDocuments:_}=await import(`./server/search-documents.js`);return{..._(n,r,{groupKey:f,facets:h,warn:e=>t.logger?.warn(e)}),problems:l([...g,...m?[o]:[]],t.route.originFilePath)}},async markdown(e,t){if(t.route===void 0)return null;let n=S(e),r=t.route.originFilePath??void 0,i=r?await t.entities.load(w(r)).catch(()=>void 0):void 0,{tags:a}=await N(M);return B(n,ve(i,n[A]?.llms),r,{tags:a,locale:P(t)})},usesProjectMarkdocSchema:!0}),W=t(T,async e=>{let t=K(e),n=await e.io.readFile(t.absolutePath),r=G(e.contentDir),i=await F({kind:e.args.kind,source:n,relativePath:t.relativePath,contentDir:e.contentDir,bundle:q(e.args,r),metadata:X(e.args.options)}),a=e.args.kind===v,o=a?n:JSON.stringify(i.document);return{value:o.length>65536?await e.createBlobRef(o,{format:a?`text`:`json`}):a?n:i.document,metadata:{...Z(e.file.path,e.args.kind,e.args.options,e.args.rbac),...ge(i.document,e.routes.byFilePath(e.file.path)?.slug)},entityDeps:Y(e.file.path,[...i.fileDependencies,...r.paths])}});function G(e){let t=de(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>d(H(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function K(e){let t=e.args.source?.path??e.file.path;return{relativePath:t,absolutePath:V(e.contentDir,t)}}function he(e){let t=e[j];return p(t)&&typeof t.root==`string`?t.root:void 0}function q(e,t){let{config:n,configDir:r}=e.bundleConfig??{config:{},configDir:``};return{config:n,configDir:r,plugins:t.plugins}}function ge(e,t){let n=p(e)&&p(e.info)?e.info:{},r=p(n[`x-metadata`])?n[`x-metadata`]:{},i=typeof n.description==`string`?n.description.trim():``;return{...t===void 0?{}:{routeSlug:t},...Q(n.version)?{version:String(n.version)}:{},...typeof r.apiId==`string`?{apiId:r.apiId}:{},description:i||void 0}}const J=t(te,async e=>{let{buildNavItems:t,collectPreviousRouteSlugs:n}=await import(`@redocly/api-docs`),r=await e.entities.load(w(e.file.path)),i=e.args.kind===`graphql`?(await import(`graphql`)).parse(r):r,a=ue(i,e.args.kind,{warn:t=>e.logger?.warn(t)}),{items:o}=await t({type:e.args.kind,document:a,options:e.args.options,basePath:`/`,markdownParser:C}),s=R(o),c=n(o).map(({from:e})=>z(e));return{value:s,targetInventories:[{kind:`subpath`,exhaustive:!0,targets:[...L(s),...c]}]}});function Y(e,t){return[{kind:`file`,path:e},...t.map(e=>({kind:`file`,path:e}))]}const _e={arazzo:`Arazzo Docs`,asyncapi:`AsyncAPI Docs`,graphql:`GraphQL Docs`,openapi:`OpenAPI Docs`};function ve(e,t){if(t===void 0||!p(e))return e;let n=p(e.info)?e.info:{},r=p(e.components)?e.components:{};return{...e,...t.infoDescription===void 0?{}:{info:{...n,description:t.infoDescription}},...t.servers===void 0?{}:{servers:t.servers},...t.securitySchemes===void 0?{}:{components:{...r,securitySchemes:t.securitySchemes}}}}function ye(e){let t=p(e)&&p(e.info)?e.info:{};return p(t[`x-metadata`])?t[`x-metadata`]:{}}function be(e,t,n){let r=p(e)&&p(e.info)?e.info:{};if(typeof r.title==`string`&&r.title!==``)return r.title;let i=p(n[0])?n[0].label:void 0;return typeof i==`string`&&i!==``?i:_e[t]}const xe=[`rbac`,`sidebar`,`excludeFromSearch`,`template`];function Se(e,t){let n=p(e.manifest.info)?e.manifest.info:{},r={};typeof n.title==`string`&&(r.title=n.title),Q(n.version)&&(r.version=String(n.version)),typeof n.summary==`string`&&(r.summary=n.summary),p(n[`x-metadata`])&&Object.assign(r,n[`x-metadata`]),p(t.metadata)&&Object.assign(r,t.metadata);for(let e of xe)delete r[e];return r}function X(e){return p(e.metadata)?e.metadata:void 0}function Ce(e){let t=X(e)?.title;return typeof t==`string`&&t.length>0?t:void 0}function Z(e,t,n,r){let i=Ce(n);return{specType:t,sourcePath:e,...i===void 0?{}:{title:i},...r===void 0?{}:{rbac:r},...Object.keys(n).length>0?{options:n}:{},...p(n.mockServer)?{mockServer:n.mockServer}:{}}}function Q(e){return typeof e==`string`||typeof e==`number`}function we(e){if(e.ext===`.gql`||e.ext===`.graphql`)return v;let{openapi:t,swagger:n,asyncapi:r,arazzo:i}=e.manifest;return Q(t)||Q(n)?y:Q(r)?_:Q(i)?g:null}const Te=e({id:ee,version:`0.43.0`,content:{filter:{extensions:pe},async extractFile(e,t){if(f.test(e.path))return null;let n=we(e);if(n===null)return null;if(n!==`arazzo`&&!b(t.config,n))return{routes:[],problems:[m(`${me[n]} documents`)]};let r=e.path,i=he(e.manifest),a=i??r,{rbac:o,...s}=await ie(t.io,t.config,r,n,a),c={filePath:r,kind:n,options:s,...o===void 0||!b(t.config,`rbac`)?{}:{rbac:o}};i!==void 0&&(c.source={path:i});let l=await ae(t.io,t.config,a);if(l!==void 0&&(c.feedback=l),n!==`graphql`){let e=await re(t.io,t.config,r,a);Object.keys(e.config).length>0&&(c.bundleConfig=e)}let u=W.withArgs(c,{stableKey:w(r),type:`api`,metadata:Z(r,n,s,c.rbac)});if(n===`arazzo`)return{routes:[],entities:[u]};let d=Se(e,s);s.excludeFromSearch===!0&&(d.excludeFromSearch=!0),d.type=n,c.rbac!==void 0&&(d.rbac=c.rbac);let p=U.withArgs(c,{stableKey:`api-docs:render:${r}`}),g=J.withArgs(c,{stableKey:`api-docs:sidebar:${r}`}),_=h(r);return{routes:[{deps:{[E]:p},metadata:d,routeId:`page`,sidebarSubtree:g,slug:null,slugHint:_,template:O,wildcardPrefix:!0}],entities:[u,p,g]}}},loaders:[W,U,J],templates:{[O]:r(n(`./client/template.tsx`,import.meta.url))},server:{routes:[$(k.bundle,`bundle`),$(k.deprecatedBundle,`bundle`),$(k.graphql,`graphql`)]}});function $(e,t){return{method:`GET`,path:e+ne,handler:{filePath:`./server/spec-download.ts`,importer:import.meta.url,exportName:t}}}async function Ee(e,t){if(t)try{return await e.load(w(t))}catch{return}}export{Te as apiDocsContentPlugin};
@@ -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};
@@ -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{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.43.1`,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};
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};
@@ -1 +1 @@
1
- import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{SKILLS_INDEX_SLUG as t,skillMarkdownPath as n}from"../../../utils/skill-paths.js";import{A2A_ROUTE as r,MCP_ROUTE as i,MCP_SERVER_CARD_ROUTE as a}from"../constants.js";import{isMcpContentProtected as o,isMcpHidden as s,resolveMcpAccess as c}from"./config-gate.js";import{SKILL_ENTITY_TYPE as l}from"../../../types/skill-entity.js";import{publicBaseUrl as u}from"../../../utils/request-origin.js";import{isEntityScopeVisible as d}from"../../../../../server/rbac/entity-scope.js";import{notFoundResponse as f}from"../../../../../server/plugin-context.js";import{CORS_ANY_ORIGIN as p,MCP_AUTH_SCHEMES as m}from"./oauth/constants.js";import"./auth.js";const h=[`text/plain`],g=[`text/plain`],_={streaming:!1,pushNotifications:!1},v={"Cache-Control":`no-store`};async function y(t,r){let i=!!t.request.viewer?.isAuthenticated;return o(c(t.config))&&!i?[]:(await t.entities.list({type:l})).flatMap(i=>{let{slug:a,title:o,description:s}=i.metadata??{};return typeof a!=`string`||!d(i,t.request.teams,e=>t.logger?.warn(e))?[]:[{id:a,name:o??a,description:s??``,tags:[],url:`${r}${e(n(a))}`}]})}async function b(t,n){if(s(n.config)||n.config.skills?.hide===!0)return f();t.set(`realmCacheControlOwned`,!0);let a=u(n.config,n.request),l=o(c(n.config)),d=n.config.seo;return t.json({name:d?.title||d?.projectTitle||`Developer Documentation`,description:d?.description||`Documentation agent card announcing this site's agent skills and MCP server.`,url:`${a}${e(r)}`,documentationUrl:`${a}${e(`/`)}`,version:`0.0.1`,protocolVersion:`0.3.0`,preferredTransport:`HTTP+JSON`,capabilities:{..._,extensions:[{uri:`https://modelcontextprotocol.io`,description:`Model Context Protocol server exposing the documentation tools and skills.`,params:{url:`${a}${e(i)}`,...l?{authentication:{required:!0,schemes:[...m]}}:{}}}]},defaultInputModes:h,defaultOutputModes:g,skills:await y(n,a)},200,{...v,...p})}function x(n,r){if(s(r.config))return f();let i=[`<${e(a)}>; rel="mcp-server-card"`];return r.config.skills?.hide!==!0&&i.push(`<${e(t)}>; rel="agent-skills"`),n.json({error:{code:`405`,message:`Method not allowed`}},405,{Link:i.join(`, `),...p,"Access-Control-Expose-Headers":`Link`})}export{x as a2a,b as agentCard};
1
+ import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{SKILLS_INDEX_SLUG as t,skillMarkdownPath as n}from"../../../utils/skill-paths.js";import{A2A_ROUTE as r,MCP_ROUTE as i,MCP_SERVER_CARD_ROUTE as a}from"../constants.js";import{isMcpContentProtected as o,isMcpHidden as s,resolveMcpAccess as c}from"./config-gate.js";import{SKILL_ENTITY_TYPE as l}from"../../../types/skill-entity.js";import{isEntityScopeVisible as u}from"../../../../../server/rbac/entity-scope.js";import{notFoundResponse as d}from"../../../../../server/plugin-context.js";import{publicBaseUrl as f}from"../../../utils/request-origin.js";import{CORS_ANY_ORIGIN as p,MCP_AUTH_SCHEMES as m}from"./oauth/constants.js";import"./auth.js";const h=[`text/plain`],g=[`text/plain`],_={streaming:!1,pushNotifications:!1},v={"Cache-Control":`no-store`};async function y(t,r){let i=!!t.request.viewer?.isAuthenticated;return o(c(t.config))&&!i?[]:(await t.entities.list({type:l})).flatMap(i=>{let{slug:a,title:o,description:s}=i.metadata??{};return typeof a!=`string`||!u(i,t.request.teams,e=>t.logger?.warn(e))?[]:[{id:a,name:o??a,description:s??``,tags:[],url:`${r}${e(n(a))}`}]})}async function b(t,n){if(s(n.config)||n.config.skills?.hide===!0)return d();t.set(`realmCacheControlOwned`,!0);let a=f(n.config,n.request),l=o(c(n.config)),u=n.config.seo;return t.json({name:u?.title||u?.projectTitle||`Developer Documentation`,description:u?.description||`Documentation agent card announcing this site's agent skills and MCP server.`,url:`${a}${e(r)}`,documentationUrl:`${a}${e(`/`)}`,version:`0.0.1`,protocolVersion:`0.3.0`,preferredTransport:`HTTP+JSON`,capabilities:{..._,extensions:[{uri:`https://modelcontextprotocol.io`,description:`Model Context Protocol server exposing the documentation tools and skills.`,params:{url:`${a}${e(i)}`,...l?{authentication:{required:!0,schemes:[...m]}}:{}}}]},defaultInputModes:h,defaultOutputModes:g,skills:await y(n,a)},200,{...v,...p})}function x(n,r){if(s(r.config))return d();let i=[`<${e(a)}>; rel="mcp-server-card"`];return r.config.skills?.hide!==!0&&i.push(`<${e(t)}>; rel="agent-skills"`),n.json({error:{code:`405`,message:`Method not allowed`}},405,{Link:i.join(`, `),...p,"Access-Control-Expose-Headers":`Link`})}export{x as a2a,b as agentCard};
@@ -1 +1 @@
1
- import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{MCP_AUTHORIZATION_SERVER_ROUTE as t,MCP_PROTECTED_RESOURCE_ROUTE as n,PUBLIC_MCP_ROUTE as r}from"../constants.js";import{ANONYMOUS_VIEWER as i}from"../../../../../shared/types/auth.js";import{canAccessMcpFeature as a,isMcpContentProtected as o,isPublicEndpointServed as s,resolveMcpAccess as c}from"./config-gate.js";import{publicOrigin as l}from"../../../utils/request-origin.js";import{getBearerVerifier as u,getSessionIssuer as d}from"../../../../../server/auth/middleware.js";import{isAssistantAnonymousToken as f}from"../../../../../server/ask-ai/assistant-anonymous-token.js";import{CORS_ANY_ORIGIN as p,CORS_EXPOSE_CHALLENGE as m,SUPPORTED_MCP_SCOPES as h}from"./oauth/constants.js";function g(e){let t=/^Bearer\s+(\S+)$/i.exec((e??``).trim());return t?t[1]:null}function _(r,i){let a=i?[`error="${i.code}"`,`error_description="${i.description}"`]:[];return a.push(`resource_metadata="${r}${e(n)}"`,`scope="${h.join(` `)}"`,`authorization_uri="${r}${e(t)}"`),`Bearer ${a.join(`, `)}`}function v(e,t){return t?`${e}. A public endpoint that serves anonymous-accessible content is available at ${t}.`:e}function y(e,t,n){return new Response(JSON.stringify(t),{status:e,headers:{"Content-Type":`application/json`,"Cache-Control":`no-store`,...n}})}function b(e,t){return y(401,{error:`unauthorized`,message:v(`Authentication required`,t)},{"WWW-Authenticate":_(e),...m})}function x(e,t){return y(401,{error:`invalid_token`,message:v(`Invalid or expired token`,t)},{"WWW-Authenticate":_(e,{code:`invalid_token`,description:`Invalid or expired token`}),...m})}function S(){return y(403,{error:`forbidden`,message:`You do not have access to this MCP server`},{...p})}async function C(t){let{c:n,ctx:p}=t,m=e=>p.logger?.warn(e),h=c(p.config),_=o(h);if(t.forceAnonymous){let e=await p.withViewer(i);return a(h,e.request.teams,!1,m)?{kind:`allow`,ctx:e,isProtected:_}:{kind:`deny`,response:S()}}let v=t=>{let n=l(p.request);return{kind:`deny`,response:t(n,s(p.config,h)?`${n}${e(r)}`:void 0)}},y=p.request.viewer??i,C,w,T=p,E=g(n.req.header(`authorization`)),D=d(n)?.artifactSecret,O=E!==null&&D!==void 0&&await f(E,D);if(!_)w=O||E===null?void 0:E;else if(O)y=i,T=await p.withViewer(i);else if(E!==null){let e=await u(n)?.(E);if(!e)return v(x);y=e.viewer,C=e.claims,w=E,T=await p.withViewer(y)}else if(!y.isAuthenticated)return v(b);return a(h,T.request.teams,y.isAuthenticated,m)?{kind:`allow`,ctx:T,isProtected:_,accessToken:w,claims:C}:{kind:`deny`,response:S()}}export{C as authorizeMcpRequest,o as isMcpContentProtected,s as isPublicEndpointServed,g as readBearerToken,c as resolveMcpAccess};
1
+ import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{MCP_AUTHORIZATION_SERVER_ROUTE as t,MCP_PROTECTED_RESOURCE_ROUTE as n,PUBLIC_MCP_ROUTE as r}from"../constants.js";import{ANONYMOUS_VIEWER as i}from"../../../../../shared/types/auth.js";import{canAccessMcpFeature as a,isMcpContentProtected as o,isPublicEndpointServed as s,resolveMcpAccess as c}from"./config-gate.js";import{getBearerVerifier as l,getSessionIssuer as u}from"../../../../../server/auth/middleware.js";import{publicOrigin as d}from"../../../utils/request-origin.js";import{isAssistantAnonymousToken as f}from"../../../../../server/ask-ai/assistant-anonymous-token.js";import{CORS_ANY_ORIGIN as p,CORS_EXPOSE_CHALLENGE as m,SUPPORTED_MCP_SCOPES as h}from"./oauth/constants.js";function g(e){let t=/^Bearer\s+(\S+)$/i.exec((e??``).trim());return t?t[1]:null}function _(r,i){let a=i?[`error="${i.code}"`,`error_description="${i.description}"`]:[];return a.push(`resource_metadata="${r}${e(n)}"`,`scope="${h.join(` `)}"`,`authorization_uri="${r}${e(t)}"`),`Bearer ${a.join(`, `)}`}function v(e,t){return t?`${e}. A public endpoint that serves anonymous-accessible content is available at ${t}.`:e}function y(e,t,n){return new Response(JSON.stringify(t),{status:e,headers:{"Content-Type":`application/json`,"Cache-Control":`no-store`,...n}})}function b(e,t){return y(401,{error:`unauthorized`,message:v(`Authentication required`,t)},{"WWW-Authenticate":_(e),...m})}function x(e,t){return y(401,{error:`invalid_token`,message:v(`Invalid or expired token`,t)},{"WWW-Authenticate":_(e,{code:`invalid_token`,description:`Invalid or expired token`}),...m})}function S(){return y(403,{error:`forbidden`,message:`You do not have access to this MCP server`},{...p})}async function C(t){let{c:n,ctx:p}=t,m=e=>p.logger?.warn(e),h=c(p.config),_=o(h);if(t.forceAnonymous){let e=await p.withViewer(i);return a(h,e.request.teams,!1,m)?{kind:`allow`,ctx:e,isProtected:_}:{kind:`deny`,response:S()}}let v=t=>{let n=d(p.request);return{kind:`deny`,response:t(n,s(p.config,h)?`${n}${e(r)}`:void 0)}},y=p.request.viewer??i,C,w,T=p,E=g(n.req.header(`authorization`)),D=u(n)?.artifactSecret,O=E!==null&&D!==void 0&&await f(E,D);if(!_)w=O||E===null?void 0:E;else if(O)y=i,T=await p.withViewer(i);else if(E!==null){let e=await l(n)?.(E);if(!e)return v(x);y=e.viewer,C=e.claims,w=E,T=await p.withViewer(y)}else if(!y.isAuthenticated)return v(b);return a(h,T.request.teams,y.isAuthenticated,m)?{kind:`allow`,ctx:T,isProtected:_,accessToken:w,claims:C}:{kind:`deny`,response:S()}}export{C as authorizeMcpRequest,o as isMcpContentProtected,s as isPublicEndpointServed,g as readBearerToken,c as resolveMcpAccess};
@@ -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{AI_METADATA_HEADER as e}from"../constants.js";import{isMcpHidden as t,isPublicEndpointServed as n,resolveMcpAccess as r}from"./config-gate.js";import{publicOrigin as i}from"../../../utils/request-origin.js";import{formatError as a,jsonRpcErrorResponse as o}from"./tool-errors.js";import{buildMcpFileTools as s,createCustomTool as c,invokeCustomTool as l}from"./custom-tools.js";import{notFoundResponse as u}from"../../../../../server/plugin-context.js";import{authorizeMcpRequest as d}from"./auth.js";import{EXECUTE_DEADLINE_MS as f}from"./codemode/constants.js";import{resolveMcpMode as p,resolveRequestInstructionsStyle as m,resolveRequestMcpMode as h}from"./mode.js";import{narrowMcpConfigForCaller as g}from"./gateway/caller-api-calls.js";import{isGatewayEnabled as _}from"./gateway/env.js";import{userSubject as v}from"./gateway/subject.js";import{parseUserAgent as y}from"./mcp-client.js";import{createMcpTelemetry as b}from"./mcp-telemetry.js";import{applyMcpRateLimit as x}from"./rate-limit.js";import{createToolRegistry as S}from"./tool-registry.js";import{mcpToolRegistry as C}from"./registry-instance.js";const w=`POST`;function T(e){return(e??``).split(`,`).some(e=>{let[t,...n]=e.split(`;`).map(e=>e.trim().toLowerCase());if(t!==`text/html`)return!1;let r=n.find(e=>e.startsWith(`q=`));return r===void 0||Number(r.slice(2))>0})}function E(){return o(405,`Method not allowed`,{Allow:w})}function D(e){let t={error:`Method Not Allowed`,message:`In order to use this MCP server, you need to register it in your MCP client (VS Code, Cursor, Claude Code, etc.) using this URL: ${e}`};return new Response(JSON.stringify(t),{status:405,headers:{"Content-Type":`application/json`,"Cache-Control":`no-store`,Allow:w}})}function O(){return o(501,`MCP transport is not available in this environment`)}function k(e){if(!e)return{};try{let t=JSON.parse(e);return typeof t==`object`&&t&&!Array.isArray(t)?t:{}}catch{return{}}}function A(t,n,r,i){let a=k(t.headers.get(e)),{userAgent:o}=n.request,{client:s,clientVersion:c}=y(o),l=h(t.url,p()),u=crypto.randomUUID(),d=v(n.request.viewer),f=n.request.ip??void 0;return{config:{...n.config,mcp:g(n.config.mcp,a)},entities:n.entities,hasRoute:e=>n.hasRoute(e),isSlugVisible:(e,t)=>n.isSlugVisible(e,t),kv:n.kv,logger:n.logger,pageMarkdown:n.pageMarkdown,search:n.search,request:n.request,metadata:a,mcpMode:l,instructionsStyle:m(t.url),requestId:u,executeDeadline:i,messageId:typeof a.messageId==`string`?a.messageId:void 0,callerSubject:d,client:s,clientVersion:c,accessToken:r.accessToken,isProtected:r.isProtected??!1,isAvailableMemo:/* @__PURE__ */ new Map,subprocess:n.subprocess,claims:r.claims,telemetry:b({userAgent:o,request:t,metadata:a,mode:l,requestId:u,callerSubject:d,clientIp:f,logger:n.logger})}}async function j(e){let t=_(e.config)?(await import(`./gateway/index.js`)).gatewayTools():[],n=e.subprocess?e.mcpToolEntries??[]:[],r=C.list(),i=/* @__PURE__ */ new Set([...r.map(e=>e.schema.name),...t.map(e=>e.schema.name),...n.map(e=>e.declaration.name)]),a=e.subprocess?await s({entities:e.entities,loadContentModule:e.loadContentModule,reservedNames:i,logger:e.logger}):[];if(t.length===0&&n.length===0&&a.length===0)return C;let o=S();for(let e of r)o.register(e);for(let e of t)o.register(e);for(let e of n)o.register(c(e));for(let e of a)o.register(e);return o}async function M(e,t,n,r={}){let i=await j(e),o;try{o=await import(`./mcp-server.js`)}catch(t){return e.logger?.error(`MCP transport failed to load: ${a(t)}`),async()=>O()}let s;return o.createMcpRequestHandler({registry:i,logger:e.logger,buildToolContext:r=>s??=A(r,e,t,n),onError:r.onError})}function N(e={}){return async(a,o,s)=>{let c=Date.now()+f;if(t(s.config)||e.publicEndpoint&&!n(s.config,r(s.config)))return u();if(a.req.method===`GET`&&T(a.req.header(`accept`)))return o();let l=await x({kv:s.kv,ip:s.request.ip,bucket:`mcp`,logger:s.logger});if(l)return l;let p=await d({c:a,ctx:s,forceAnonymous:e.forceAnonymous});return p.kind===`deny`?p.response:a.req.method===`GET`?D(`${i(s.request)}${new URL(s.request.url).pathname}`):a.req.method===`POST`?(await M(p.ctx,{isProtected:p.isProtected,accessToken:p.accessToken,claims:p.claims},c))(a.req.raw):E()}}const P=N(),F=N({forceAnonymous:!0,publicEndpoint:!0});export{A as buildToolContext,N as createMcpHandler,M as createServedMcpRequestHandler,l as invokeCustomTool,P as mcp,F as mcpPublic};
1
+ import{AI_METADATA_HEADER as e}from"../constants.js";import{isMcpHidden as t,isPublicEndpointServed as n,resolveMcpAccess as r}from"./config-gate.js";import{notFoundResponse as i}from"../../../../../server/plugin-context.js";import{publicOrigin as a}from"../../../utils/request-origin.js";import{formatError as o,jsonRpcErrorResponse as s}from"./tool-errors.js";import{buildMcpFileTools as c,createCustomTool as l,invokeCustomTool as u}from"./custom-tools.js";import{authorizeMcpRequest as d}from"./auth.js";import{EXECUTE_DEADLINE_MS as f}from"./codemode/constants.js";import{resolveMcpMode as p,resolveRequestInstructionsStyle as m,resolveRequestMcpMode as h}from"./mode.js";import{narrowMcpConfigForCaller as g}from"./gateway/caller-api-calls.js";import{isGatewayEnabled as _}from"./gateway/env.js";import{userSubject as v}from"./gateway/subject.js";import{parseUserAgent as y}from"./mcp-client.js";import{createMcpTelemetry as b}from"./mcp-telemetry.js";import{applyMcpRateLimit as x}from"./rate-limit.js";import{createToolRegistry as S}from"./tool-registry.js";import{mcpToolRegistry as C}from"./registry-instance.js";const w=`POST`;function T(e){return(e??``).split(`,`).some(e=>{let[t,...n]=e.split(`;`).map(e=>e.trim().toLowerCase());if(t!==`text/html`)return!1;let r=n.find(e=>e.startsWith(`q=`));return r===void 0||Number(r.slice(2))>0})}function E(){return s(405,`Method not allowed`,{Allow:w})}function D(e){let t={error:`Method Not Allowed`,message:`In order to use this MCP server, you need to register it in your MCP client (VS Code, Cursor, Claude Code, etc.) using this URL: ${e}`};return new Response(JSON.stringify(t),{status:405,headers:{"Content-Type":`application/json`,"Cache-Control":`no-store`,Allow:w}})}function O(){return s(501,`MCP transport is not available in this environment`)}function k(e){if(!e)return{};try{let t=JSON.parse(e);return typeof t==`object`&&t&&!Array.isArray(t)?t:{}}catch{return{}}}function A(t,n,r,i){let a=k(t.headers.get(e)),{userAgent:o}=n.request,{client:s,clientVersion:c}=y(o),l=h(t.url,p()),u=crypto.randomUUID(),d=v(n.request.viewer),f=n.request.ip??void 0;return{config:{...n.config,mcp:g(n.config.mcp,a)},entities:n.entities,hasRoute:e=>n.hasRoute(e),isSlugVisible:(e,t)=>n.isSlugVisible(e,t),kv:n.kv,logger:n.logger,pageMarkdown:n.pageMarkdown,search:n.search,request:n.request,metadata:a,mcpMode:l,instructionsStyle:m(t.url),requestId:u,executeDeadline:i,messageId:typeof a.messageId==`string`?a.messageId:void 0,callerSubject:d,client:s,clientVersion:c,accessToken:r.accessToken,isProtected:r.isProtected??!1,isAvailableMemo:/* @__PURE__ */ new Map,subprocess:n.subprocess,claims:r.claims,telemetry:b({userAgent:o,request:t,metadata:a,mode:l,requestId:u,callerSubject:d,clientIp:f,logger:n.logger})}}async function j(e){let t=_(e.config)?(await import(`./gateway/index.js`)).gatewayTools():[],n=e.subprocess?e.mcpToolEntries??[]:[],r=C.list(),i=/* @__PURE__ */ new Set([...r.map(e=>e.schema.name),...t.map(e=>e.schema.name),...n.map(e=>e.declaration.name)]),a=e.subprocess?await c({entities:e.entities,loadContentModule:e.loadContentModule,reservedNames:i,logger:e.logger}):[];if(t.length===0&&n.length===0&&a.length===0)return C;let o=S();for(let e of r)o.register(e);for(let e of t)o.register(e);for(let e of n)o.register(l(e));for(let e of a)o.register(e);return o}async function M(e,t,n,r={}){let i=await j(e),a;try{a=await import(`./mcp-server.js`)}catch(t){return e.logger?.error(`MCP transport failed to load: ${o(t)}`),async()=>O()}let s;return a.createMcpRequestHandler({registry:i,logger:e.logger,buildToolContext:r=>s??=A(r,e,t,n),onError:r.onError})}function N(e={}){return async(o,s,c)=>{let l=Date.now()+f;if(t(c.config)||e.publicEndpoint&&!n(c.config,r(c.config)))return i();if(o.req.method===`GET`&&T(o.req.header(`accept`)))return s();let u=await x({kv:c.kv,ip:c.request.ip,bucket:`mcp`,logger:c.logger});if(u)return u;let p=await d({c:o,ctx:c,forceAnonymous:e.forceAnonymous});return p.kind===`deny`?p.response:o.req.method===`GET`?D(`${a(c.request)}${new URL(c.request.url).pathname}`):o.req.method===`POST`?(await M(p.ctx,{isProtected:p.isProtected,accessToken:p.accessToken,claims:p.claims},l))(o.req.raw):E()}}const P=N(),F=N({forceAnonymous:!0,publicEndpoint:!0});export{A as buildToolContext,N as createMcpHandler,M as createServedMcpRequestHandler,u as invokeCustomTool,P as mcp,F as mcpPublic};
@@ -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};
@@ -1 +1 @@
1
- import{withPathPrefix as e}from"../../../../../../shared/path-prefix.js";import{MCP_AUTHORIZATION_SERVER_ROUTE as t,MCP_AUTHORIZE_ROUTE as n,MCP_REGISTER_ROUTE as r,MCP_ROUTE as i,MCP_TOKEN_ROUTE as a}from"../../constants.js";import{isMcpContentProtected as o,isMcpHidden as s,resolveMcpAccess as c}from"../config-gate.js";import{publicOrigin as l}from"../../../../utils/request-origin.js";import{notFoundResponse as u}from"../../../../../../server/plugin-context.js";import{CORS_ANY_ORIGIN as d,SUPPORTED_MCP_GRANT_TYPES as f,SUPPORTED_MCP_SCOPES as p}from"./constants.js";import"../auth.js";function m(e){return!s(e.config)&&o(c(e.config))}function h(n,r){if(!m(r))return u();let a=l(r.request);return n.json({resource:`${a}${e(i)}`,authorization_servers:[a],bearer_methods_supported:[`header`],resource_documentation:`${a}${e(t)}`,scopes_supported:[...p],bearer_token_types_supported:[`Bearer`]},200,{...d})}function g(t,i){if(!m(i))return u();let o=l(i.request);return t.json({issuer:o,authorization_endpoint:`${o}${e(n)}`,token_endpoint:`${o}${e(a)}`,scopes_supported:[...p],registration_endpoint:`${o}${e(r)}`,response_types_supported:[`code`],grant_types_supported:[...f],subject_types_supported:[`public`],id_token_signing_alg_values_supported:[`RS256`],code_challenge_methods_supported:[`S256`],token_endpoint_auth_methods_supported:[`none`],client_id_metadata_document_supported:!0},200,{...d})}export{g as oauthAuthorizationServer,h as oauthProtectedResource};
1
+ import{withPathPrefix as e}from"../../../../../../shared/path-prefix.js";import{MCP_AUTHORIZATION_SERVER_ROUTE as t,MCP_AUTHORIZE_ROUTE as n,MCP_REGISTER_ROUTE as r,MCP_ROUTE as i,MCP_TOKEN_ROUTE as a}from"../../constants.js";import{isMcpContentProtected as o,isMcpHidden as s,resolveMcpAccess as c}from"../config-gate.js";import{notFoundResponse as l}from"../../../../../../server/plugin-context.js";import{publicOrigin as u}from"../../../../utils/request-origin.js";import{CORS_ANY_ORIGIN as d,SUPPORTED_MCP_GRANT_TYPES as f,SUPPORTED_MCP_SCOPES as p}from"./constants.js";import"../auth.js";function m(e){return!s(e.config)&&o(c(e.config))}function h(n,r){if(!m(r))return l();let a=u(r.request);return n.json({resource:`${a}${e(i)}`,authorization_servers:[a],bearer_methods_supported:[`header`],resource_documentation:`${a}${e(t)}`,scopes_supported:[...p],bearer_token_types_supported:[`Bearer`]},200,{...d})}function g(t,i){if(!m(i))return l();let o=u(i.request);return t.json({issuer:o,authorization_endpoint:`${o}${e(n)}`,token_endpoint:`${o}${e(a)}`,scopes_supported:[...p],registration_endpoint:`${o}${e(r)}`,response_types_supported:[`code`],grant_types_supported:[...f],subject_types_supported:[`public`],id_token_signing_alg_values_supported:[`RS256`],code_challenge_methods_supported:[`S256`],token_endpoint_auth_methods_supported:[`none`],client_id_metadata_document_supported:!0},200,{...d})}export{g as oauthAuthorizationServer,h as oauthProtectedResource};
@@ -1 +1 @@
1
- import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{MCP_ROUTE as t}from"../constants.js";import{ANONYMOUS_VIEWER as n}from"../../../../../shared/types/auth.js";import{isMcpContentProtected as r,isMcpHidden as i,resolveMcpAccess as a}from"./config-gate.js";import{publicBaseUrl as o,publicOrigin as s}from"../../../utils/request-origin.js";import{formatError as c}from"./tool-errors.js";import{notFoundResponse as l}from"../../../../../server/plugin-context.js";import{CORS_ANY_ORIGIN as u,MCP_AUTH_SCHEMES as d}from"./oauth/constants.js";import"./auth.js";import{EXECUTE_DEADLINE_MS as f}from"./codemode/constants.js";import{sendMcpServerCardServed as p}from"./mcp-telemetry.js";import{applyMcpRateLimit as m}from"./rate-limit.js";import{createServedMcpRequestHandler as h}from"./handler.js";import{docsServerInfo as g}from"./server-info.js";import{CLIENT_CAPABILITIES_META_KEY as _,CLIENT_INFO_META_KEY as v,LATEST_PROTOCOL_VERSION as y,PROTOCOL_VERSION_META_KEY as b}from"@modelcontextprotocol/server";const x=`2026-07-28`,S=[`dynamic`],C={capabilities:{},tools:S};async function w(e,t,n){let r=await e(new Request(t,{method:`POST`,headers:{"content-type":`application/json`,accept:`application/json, text/event-stream`,"mcp-protocol-version":x,"mcp-method":n},body:JSON.stringify({jsonrpc:`2.0`,id:1,method:n,params:{_meta:{[b]:x,[v]:{name:`server-card`,version:`1.0`},[_]:{}}}})}));if(r.ok)return(await r.json()).result}function T(e,t){e.logger?.warn(`MCP server card lists dynamic tools: ${c(t)}`)}async function E(r,i){let a=await r.withViewer(n),o=await h(a,{isProtected:i},Date.now()+f,{onError:e=>T(r,e)}),c=new URL(e(t),s(r.request)).href,[l,u]=await Promise.all([w(o,c,`server/discover`),i?void 0:w(o,c,`tools/list`)]);if(!l)return;if(i)return{capabilities:l.capabilities,tools:S};if(!u)return;let d=u.tools.map(({name:e,title:t,description:n,inputSchema:r,annotations:i})=>({name:e,title:t,description:n,inputSchema:r,annotations:i}));return{capabilities:l.capabilities,instructions:l.instructions,tools:d.length>0?d:S}}async function D(n,s){if(i(s.config))return l();n.set(`realmCacheControlOwned`,!0);let c=await m({kv:s.kv,ip:s.request.ip,bucket:`card`,headers:u,logger:s.logger});if(c)return c;let f=g(s.config,s.request),h=r(a(s.config)),_=await E(s,h).catch(e=>{T(s,e)}),{capabilities:v,instructions:b,tools:x}=_??C;return await p({logger:s.logger}),n.json({$schema:`https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json`,version:`1.0`,protocolVersion:y,serverInfo:{...f,title:f.name},description:f.description,documentationUrl:o(s.config,s.request),transport:{type:`streamable-http`,endpoint:e(t)},capabilities:v,authentication:h?{required:!0,schemes:[...d]}:void 0,instructions:b,tools:x},200,{...u,"Cache-Control":_?`public, max-age=3600`:`no-store`})}export{D as mcpServerCard};
1
+ import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{MCP_ROUTE as t}from"../constants.js";import{ANONYMOUS_VIEWER as n}from"../../../../../shared/types/auth.js";import{isMcpContentProtected as r,isMcpHidden as i,resolveMcpAccess as a}from"./config-gate.js";import{notFoundResponse as o}from"../../../../../server/plugin-context.js";import{publicBaseUrl as s,publicOrigin as c}from"../../../utils/request-origin.js";import{formatError as l}from"./tool-errors.js";import{CORS_ANY_ORIGIN as u,MCP_AUTH_SCHEMES as d}from"./oauth/constants.js";import"./auth.js";import{EXECUTE_DEADLINE_MS as f}from"./codemode/constants.js";import{sendMcpServerCardServed as p}from"./mcp-telemetry.js";import{applyMcpRateLimit as m}from"./rate-limit.js";import{createServedMcpRequestHandler as h}from"./handler.js";import{docsServerInfo as g}from"./server-info.js";import{CLIENT_CAPABILITIES_META_KEY as _,CLIENT_INFO_META_KEY as v,LATEST_PROTOCOL_VERSION as y,PROTOCOL_VERSION_META_KEY as b}from"@modelcontextprotocol/server";const x=`2026-07-28`,S=[`dynamic`],C={capabilities:{},tools:S};async function w(e,t,n){let r=await e(new Request(t,{method:`POST`,headers:{"content-type":`application/json`,accept:`application/json, text/event-stream`,"mcp-protocol-version":x,"mcp-method":n},body:JSON.stringify({jsonrpc:`2.0`,id:1,method:n,params:{_meta:{[b]:x,[v]:{name:`server-card`,version:`1.0`},[_]:{}}}})}));if(r.ok)return(await r.json()).result}function T(e,t){e.logger?.warn(`MCP server card lists dynamic tools: ${l(t)}`)}async function E(r,i){let a=await r.withViewer(n),o=await h(a,{isProtected:i},Date.now()+f,{onError:e=>T(r,e)}),s=new URL(e(t),c(r.request)).href,[l,u]=await Promise.all([w(o,s,`server/discover`),i?void 0:w(o,s,`tools/list`)]);if(!l)return;if(i)return{capabilities:l.capabilities,tools:S};if(!u)return;let d=u.tools.map(({name:e,title:t,description:n,inputSchema:r,annotations:i})=>({name:e,title:t,description:n,inputSchema:r,annotations:i}));return{capabilities:l.capabilities,instructions:l.instructions,tools:d.length>0?d:S}}async function D(n,c){if(i(c.config))return o();n.set(`realmCacheControlOwned`,!0);let l=await m({kv:c.kv,ip:c.request.ip,bucket:`card`,headers:u,logger:c.logger});if(l)return l;let f=g(c.config,c.request),h=r(a(c.config)),_=await E(c,h).catch(e=>{T(c,e)}),{capabilities:v,instructions:b,tools:x}=_??C;return await p({logger:c.logger}),n.json({$schema:`https://static.modelcontextprotocol.io/schemas/mcp-server-card/v1.json`,version:`1.0`,protocolVersion:y,serverInfo:{...f,title:f.name},description:f.description,documentationUrl:s(c.config,c.request),transport:{type:`streamable-http`,endpoint:e(t)},capabilities:v,authentication:h?{required:!0,schemes:[...d]}:void 0,instructions:b,tools:x},200,{...u,"Cache-Control":_?`public, max-age=3600`:`no-store`})}export{D as mcpServerCard};
@@ -1 +1 @@
1
- import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{skillMarkdownPath as t}from"../../../utils/skill-paths.js";import{SKILL_ENTITY_TYPE as n}from"../../../types/skill-entity.js";import{publicOrigin as r}from"../../../utils/request-origin.js";import{isEntityScopeVisible as i}from"../../../../../server/rbac/entity-scope.js";async function a(a){if(a.config.skills?.hide===!0)return[];let o=await a.entities.list({type:n}),s=r(a.request),c=e=>i(e,a.request.teams,e=>a.logger?.warn(e));return o.flatMap(n=>{let{slug:r,title:i,description:o}=n.metadata??{};return typeof r!=`string`||!c(n)?[]:[{slug:r,title:i??r,description:o??``,uri:`${s}${e(t(r))}`,read:async()=>(await a.entities.load(n.key)).content}]})}export{a as loadSkillResources};
1
+ import{withPathPrefix as e}from"../../../../../shared/path-prefix.js";import{skillMarkdownPath as t}from"../../../utils/skill-paths.js";import{SKILL_ENTITY_TYPE as n}from"../../../types/skill-entity.js";import{isEntityScopeVisible as r}from"../../../../../server/rbac/entity-scope.js";import{publicOrigin as i}from"../../../utils/request-origin.js";async function a(a){if(a.config.skills?.hide===!0)return[];let o=await a.entities.list({type:n}),s=i(a.request),c=e=>r(e,a.request.teams,e=>a.logger?.warn(e));return o.flatMap(n=>{let{slug:r,title:i,description:o}=n.metadata??{};return typeof r!=`string`||!c(n)?[]:[{slug:r,title:i??r,description:o??``,uri:`${s}${e(t(r))}`,read:async()=>(await a.entities.load(n.key)).content}]})}export{a as loadSkillResources};
@@ -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{curationKeywordsOf as g}from"../../../search/keywords.js";import{readPageFrontmatter as _}from"./frontmatter.js";const v=[`.page.tsx`,`.page.ts`],y=`internal.react-page`,b=`search`,x=t(n(y,`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)),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:o([...u,...c?[r]:[]],t.route.originFilePath)}}});function S(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;let o={title:i,text:[a,...Array.isArray(t.keywords)?t.keywords.filter(e=>typeof e==`string`):[]].filter(e=>e!==``).join(` `)},s=g(t.keywords);return s!==void 0&&(o.keywords=s),o}const C=t(n(y,`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}}),w=e({id:y,version:`1.12.0`,loaders:[C,x],content:{filter:{extensions:v},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}=_(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:S(n),s={};a!==void 0&&(s.seo=C.withArgs({filePath:e.path,image:a})),o!==void 0&&(s[b]=x.withArgs(o,{stableKey:`react-page:search:${e.path}`}));let g=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:g})):[{routeId:`page`,slugHint:d(e.path,T(e.path)),template:v,metadata:n??void 0,deps:g}]}}}});function T(e){return e.toLowerCase().endsWith(`.page.ts`)?`.page.ts`:`.page.tsx`}export{b as REACT_PAGE_SEARCH_LOADER_KEY,w 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 +1 @@
1
- import{hashString as e}from"../../../../database/utils/json.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{SKILLS_INDEX_SCHEMA_URL as n,skillMarkdownPath as r}from"../../../utils/skill-paths.js";import{SKILL_ENTITY_TYPE as i,skillEntityKey as a}from"../../../types/skill-entity.js";import{publicOrigin as o}from"../../../utils/request-origin.js";import{isEntityScopeVisible as s}from"../../../../../server/rbac/entity-scope.js";import{notFoundResponse as c}from"../../../../../server/plugin-context.js";const l={"Cache-Control":`no-store`,"Access-Control-Allow-Origin":`*`};function u(e){return e.config.skills?.hide===!0}async function d(a,d){if(u(d))return c();let f=o(d.request),p=await d.entities.list({type:i}),m=await Promise.all(p.map(async n=>{let{slug:i,title:a,description:o}=n.metadata??{};if(typeof i!=`string`||!s(n,d.request.teams,e=>d.logger?.warn(e)))return[];let{content:c}=await d.entities.load(n.key);return[{name:a??i,type:`skill-md`,description:o??``,url:`${f}${t(r(i))}`,digest:`sha256:${e(c)}`}]}));return a.json({$schema:n,skills:m.flat()},200,l)}async function f(e,t){if(u(t))return c();let n=e.req.param(`slug`)??``,r=a(n),i=await t.entities.get(r);if(!i||!s(i,t.request.teams,e=>t.logger?.warn(e)))return c();let{content:o}=await t.entities.load(r);return e.body(o,200,{"Content-Type":`text/markdown; charset=utf-8`,...l})}export{f as skillMarkdown,d as skillsIndex};
1
+ import{hashString as e}from"../../../../database/utils/json.js";import{withPathPrefix as t}from"../../../../../shared/path-prefix.js";import{SKILLS_INDEX_SCHEMA_URL as n,skillMarkdownPath as r}from"../../../utils/skill-paths.js";import{SKILL_ENTITY_TYPE as i,skillEntityKey as a}from"../../../types/skill-entity.js";import{isEntityScopeVisible as o}from"../../../../../server/rbac/entity-scope.js";import{notFoundResponse as s}from"../../../../../server/plugin-context.js";import{publicOrigin as c}from"../../../utils/request-origin.js";const l={"Cache-Control":`no-store`,"Access-Control-Allow-Origin":`*`};function u(e){return e.config.skills?.hide===!0}async function d(a,d){if(u(d))return s();let f=c(d.request),p=await d.entities.list({type:i}),m=await Promise.all(p.map(async n=>{let{slug:i,title:a,description:s}=n.metadata??{};if(typeof i!=`string`||!o(n,d.request.teams,e=>d.logger?.warn(e)))return[];let{content:c}=await d.entities.load(n.key);return[{name:a??i,type:`skill-md`,description:s??``,url:`${f}${t(r(i))}`,digest:`sha256:${e(c)}`}]}));return a.json({$schema:n,skills:m.flat()},200,l)}async function f(e,t){if(u(t))return s();let n=e.req.param(`slug`)??``,r=a(n),i=await t.entities.get(r);if(!i||!o(i,t.request.teams,e=>t.logger?.warn(e)))return s();let{content:c}=await t.entities.load(r);return e.body(c,200,{"Content-Type":`text/markdown; charset=utf-8`,...l})}export{f as skillMarkdown,d as skillsIndex};
@@ -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>;
@@ -1 +1 @@
1
- import{SEARCH_GROUP_FACET_FIELD as e,SEARCH_TEAMS_FACET_FIELD as t,SEARCH_VERSION_FACET_FIELD as n}from"../../../shared/search/facets.js";import{searchDocuments as r,searchFacets as i,searchFragmentParents as a,searchFragmentPostings as o,searchFragmentUsages as s,searchFragments as c,searchPostings as l,searchVocab as u}from"../../database/schema.js";import{batchValues as d,normalizeBatchSize as f}from"../../database/connection.js";import{teamBlockSectionKey as p}from"../../markdown/search/to-sections.js";import{tokenizeSearchContent as m,tokenizeSearchQuery as h}from"../tokenize.js";import{SEARCH_HIDE_FACET_FIELD as g,SEARCH_PIN_FACET_FIELD as _}from"../keywords.js";import{refreshTermDocCounts as v,selectTermIdsOfDocuments as y,selectTermIdsOfFragments as b}from"../../database/search-vocab.js";import{SearchEngine as ee}from"../engine/core/search-engine.js";import{PATH_SEGMENT_SEPARATOR as x,indexedPathSegments as S,indexedPathText as C,splitIndexedPath as w}from"./path-field.js";import{descriptionOffsetGroups as T,highlightFragment as te,indexedFragmentText as E,splitAnchor as D}from"./fragment-field.js";import{createPostingsTermLookup as O,wordOffsets as k}from"./term-lookup.js";import{optionalTokens as A}from"../stopwords.js";import{maxEditsForToken as j,pickCorrection as ne}from"./typo-correction.js";import"../store.js";import{and as M,asc as N,between as re,desc as P,eq as F,exists as I,gte as L,inArray as R,lt as ie,lte as z,ne as B,notExists as ae,notInArray as V,or as H,sql as U}from"drizzle-orm";import{alias as oe,unionAll as W}from"drizzle-orm/sqlite-core";const G=/* @__PURE__ */ new Set([e]),K=[{name:`title`,weight:2},{name:`text`,weight:1},{name:`path`,weight:1},{name:`httpPath`,weight:1}],se={name:`parameters`,weight:1},q=Object.fromEntries(K.map(e=>[e.name,e.weight])),ce=/* @__PURE__ */ new Set([`get`,`put`,`post`,`delete`,`options`,`head`,`patch`,`trace`,`query`]),J=/[_.:']/g;function le(e,t){if(!e)return m(``);let n=t?.toLowerCase(),r=n&&ce.has(n)?`${x}${n}`:``,i=m(`${e}${r}`),a=m(`${e.replace(J,` `)}${r}`),o=/* @__PURE__ */ new Map;for(let e of[...i.tokens,...a.tokens]){let t=o.get(e.value)??/* @__PURE__ */ new Set;for(let n of e.offsets)t.add(n);o.set(e.value,t)}return{tokens:[...o].map(([e,t])=>({documentId:0,value:e,offsets:[...t].sort((e,t)=>e-t)})),length:a.length}}function ue(e,t,n,r){let i=m(t.title),a=m(t.text),o=m(C(t.path,t.title)),s=le(t.httpPath,t.httpMethod),c=t.path||t.badges||t.product||t.version||t.isAdditionalOperation?{path:t.path,badges:t.badges,product:t.product,version:t.version,isAdditionalOperation:t.isAdditionalOperation}:null;return{fields:{title:i,text:a,path:o,httpPath:s},facets:t.facets??{},row:{entityKey:e,docKey:t.docKey,routeSlug:t.routeSlug,locale:t.locale??``,anchor:t.anchor??null,title:t.title,text:t.text,titleTokens:i.length,textTokens:a.length,pathTokens:o.length,httpPathTokens:s.length,sourceHash:n,pluginVersion:r,groupKey:t.groupKey||null,httpMethod:t.httpMethod??null,httpPath:t.httpPath??null,deprecated:+!!t.deprecated,extra:c}}}function de(e){let t=new Map(e.docs.map(e=>[e.docKey,e.locale??``])),n=(e.uses??[]).filter(e=>t.has(e.docKey)),r=/* @__PURE__ */ new Map;for(let e of n)r.has(e.fragmentKey)||r.set(e.fragmentKey,t.get(e.docKey)??``);let i=[],a=/* @__PURE__ */ new Set;for(let t of e.fragments??[]){let e=r.get(t.fragmentKey);e===void 0||a.has(t.fragmentKey)||(a.add(t.fragmentKey),i.push({fragment:t,locale:e,tokens:m(E(t))}))}let o=/* @__PURE__ */ new Map;for(let e of n){if(!a.has(e.fragmentKey))continue;let t=JSON.stringify([e.docKey,e.fragmentKey]);o.has(t)||o.set(t,e)}let s=/* @__PURE__ */ new Map;for(let e of o.values()){let t=e.path??[],{prefix:n,tail:r}=D(e.anchor),i=JSON.stringify([e.docKey,e.place,t,n]),a=s.get(i);a||(a={docKey:e.docKey,place:e.place,path:t,anchorPrefix:n,uses:[]},s.set(i,a)),a.uses.push({fragmentKey:e.fragmentKey,anchorTail:r})}return{entityKey:e.entityKey,docs:e.docs.map(t=>ue(e.entityKey,t,e.sourceHash,e.pluginVersion)),fragments:i,parents:[...s.values()]}}function fe(e){let t={fragmentKey:e.fragmentKey,name:e.name,description:e.description};return e.example&&(t.example=e.example),e.enumValues&&e.enumValues.length>0&&(t.enum=e.enumValues),t}const Y=(e,t)=>JSON.stringify([e,t]),pe=(e,t)=>JSON.stringify([e,t]),me=[8,16],he=e=>me[e.length-1]??50;async function ge(e,t){let n=e.select({id:r.id}).from(r).where(R(r.entityKey,[...t])),u=e.select({id:c.id}).from(c).where(R(c.entityKey,[...t])),d=[...await y(e,n.getSQL()),...await b(e,u.getSQL())];return await e.delete(l).where(R(l.docId,n)),await e.delete(i).where(R(i.docId,n)),await e.delete(o).where(R(o.fragmentId,u)),await e.delete(a).where(R(a.docId,n)),await e.delete(s).where(R(s.fragmentId,u)),await e.delete(c).where(R(c.entityKey,[...t])),d}function _e(e,t){if(e.length<=t)return e;let n=e.lastIndexOf(` `,t);return`${e.slice(0,n>0?n:t)}…`}function X(e){let t=[];return e.forEach(([e,...n],r)=>{for(let i of n)t.push({start:i,end:i+(e??0),word:r})}),t.sort((e,t)=>e.start-t.start||t.end-e.end)}function Z(e,t,n,r){let i=``,a=n;for(let{start:n,end:o}of t)n<a||o>r||(i+=`${e.slice(a,n)}<mark>${e.slice(n,o)}</mark>`,a=o);return i+e.slice(a,r)}function ve(e,t){if(t?.length)return Z(e,X(t),0,e.length)}function ye(e,t,n,r){if(e===void 0||e.length<2)return;let i=S(e,t),a=i.length<e.length,o=ve(i.join(x),n),s=a?r:void 0;if(o===void 0&&s===void 0)return;let c=o===void 0?[...i]:w(o);return a?[...c,s??t]:c}function be(e,t,n=200){if(!t?.length)return;let r=X(t);if(r.length===0||e.length<=n)return Z(e,r,0,e.length);let i={first:0,last:0,words:0,matches:0};for(let e=0;e<r.length;e++){let t=r[e].start+n,a=/* @__PURE__ */ new Set,o=e;for(let n=e;n<r.length&&r[n].end<=t;n++)a.add(r[n].word),o=n;let s=o-e+1;(a.size>i.words||a.size===i.words&&s>i.matches)&&(i={first:e,last:o,words:a.size,matches:s})}let a=r[i.first].start,o=r[i.last].end,s=Math.max(0,Math.min(a-Math.floor((n-(o-a))/2),e.length-n)),c=Math.min(e.length,s+n);if(s>0){let t=e.lastIndexOf(` `,s);s=t===-1?0:Math.min(t+1,a)}if(c<e.length){let t=e.indexOf(` `,c);c=t===-1?e.length:Math.max(t,o)}let l=Z(e,r,s,c);return`${s>0?`…`:``}${l}${c<e.length?`…`:``}`}async function xe(e,t,n){let[r]=await e.select({max:U`max(${n})`}).from(t);return Number(r?.max??0)}function Se(e,t){if(t.length===0)return[...e];let n=new Set(t),r=e.filter(e=>n.has(e.id)),i=new Set(r.map(e=>e.id)),a=t.filter(e=>!i.has(e)).sort((e,t)=>e-t).map(e=>({id:e,rank:0,fields:[]})),o=e[0]?.rank??0,s=[...r,...a];return[...s.map((e,t)=>Object.assign(e,{rank:o+s.length-t})),...e.filter(e=>!n.has(e.id))]}function Q(m){let y=f(void 0);async function b(e,t){let n=t.map(e=>e.entityKey),f=[];for(let t of d(n,y)){for(let n of await ge(e,t))f.push(n);await e.delete(r).where(R(r.entityKey,t))}let p=t.flatMap(e=>e.docs);if(p.length===0){await v(e,f);return}for(let t of d(p,y))await e.insert(r).values(t.map(e=>e.row));let m=/* @__PURE__ */ new Map;for(let t of d(n,y)){let n=await e.select({id:r.id,entityKey:r.entityKey,docKey:r.docKey}).from(r).where(R(r.entityKey,t));for(let e of n)m.set(Y(e.entityKey,e.docKey),e.id)}let h=/* @__PURE__ */ new Map,g=(e,t)=>JSON.stringify([e,t]),_=await xe(e,c,c.id)+1,b=[];for(let e of t)for(let{fragment:t,locale:n}of e.fragments){let r=_++;h.set(g(e.entityKey,t.fragmentKey),r),b.push({id:r,entityKey:e.entityKey,fragmentKey:t.fragmentKey,locale:n,name:t.name,description:t.description??``,example:t.example??null,enumValues:t.enum??null})}let ee=await xe(e,a,a.id)+1,x=[],S=[];for(let e of t)for(let t of e.parents){let n=m.get(Y(e.entityKey,t.docKey));if(n===void 0)continue;let r=ee++;x.push({id:r,docId:n,place:t.place,path:t.path,anchorPrefix:t.anchorPrefix});for(let i of t.uses){let t=h.get(g(e.entityKey,i.fragmentKey));t!==void 0&&S.push({fragmentId:t,docId:n,parentId:r,anchorTail:i.anchorTail})}}for(let t of d(b,y))await e.insert(c).values(t);for(let t of d(x,y))await e.insert(a).values(t);for(let t of d(S,y))await e.insert(s).values(t);let C=/* @__PURE__ */ new Map,w=e=>{let t=C.get(e);return t||(t=/* @__PURE__ */ new Set,C.set(e,t)),t};for(let e of p){let t=w(e.row.locale??``);for(let n of K)for(let r of e.fields[n.name].tokens)t.add(r.value)}for(let e of t)for(let{locale:t,tokens:n}of e.fragments){let e=w(t);for(let t of n.tokens)e.add(t.value)}let T=/* @__PURE__ */ new Map;for(let[t,n]of C)for(let r of d([...n],y)){await e.insert(u).values(r.map(e=>({term:e,locale:t}))).onConflictDoNothing();let n=await e.select({id:u.id,term:u.term}).from(u).where(M(F(u.locale,t),R(u.term,r)));for(let e of n)T.set(pe(t,e.term),e.id)}let te=[];for(let e of p){let t=m.get(Y(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let n of K)for(let r of e.fields[n.name].tokens){let i=T.get(pe(e.row.locale??``,r.value));i!==void 0&&te.push({termId:i,field:n.name,docId:t,offsets:JSON.stringify(r.offsets)})}}for(let t of d(te,y))await e.insert(l).values(t);let E=[];for(let e of t)for(let{fragment:t,locale:n,tokens:r}of e.fragments){let i=h.get(g(e.entityKey,t.fragmentKey));if(i!==void 0)for(let e of r.tokens){let t=T.get(pe(n,e.value));t!==void 0&&E.push({termId:t,fragmentId:i,offsets:JSON.stringify(e.offsets)})}}for(let t of d(E,y))await e.insert(o).values(t);let D=[];for(let e of p){let t=m.get(Y(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let[n,r]of Object.entries(e.facets))for(let e of r)D.push({docId:t,field:n,value:e})}for(let t of d(D,y))await e.insert(i).values(t);await v(e,[...f,...T.values()])}let x=e=>e===void 0?void 0:R(u.locale,[...e]);function S(e,t,n=50){return m.db.select({id:u.id,term:u.term}).from(u).where(M(e,x(t))).orderBy(P(u.docCount),N(u.term)).limit(n)}let C=(e,t)=>S(M(L(u.term,e),z(u.term,`${e}\uffff`)),t,he(e));async function w(e,t){let n=j(e),r=e.codePointAt(0);if(n===0||r===void 0||r>=1114111)return[];let i=[...e].length,a=await m.db.select({id:u.id,term:u.term,docCount:u.docCount}).from(u).where(M(x(t),L(u.term,String.fromCodePoint(r)),ie(u.term,String.fromCodePoint(r+1)),re(U`length(${u.term})`,i-n,i+n))).orderBy(P(u.docCount),N(u.term)).limit(2e3),o=/* @__PURE__ */ new Map;for(let{id:e,term:t,docCount:n}of a){let r=o.get(t);r?(r.docCount+=n,r.ids.push(e)):o.set(t,{term:t,docCount:n,ids:[e]})}let s=ne(e,[...o.values()]);return s===null?[]:(o.get(s)?.ids??[]).map(e=>({id:e,term:s}))}async function E(e,t,n){let r=e.length-1,i=(e,n)=>t.has(e)&&n!==r,a=(e,t)=>t===r||t>r-3&&e.length>=3,[o,s]=await Promise.all([m.db.select({id:u.id,term:u.term}).from(u).where(M(R(u.term,e),x(n))),Promise.all(e.map(async(e,t)=>!i(e,t)&&a(e,t)?C(e,n):[]))]);return Promise.all(e.map(async(e,t)=>{let c=o.filter(t=>t.term===e);if(i(e,t))return D(e,c,!0);let l=[...c,...s[t]??[]];if(l.length>0)return D(e,l);let d=await w(e,n),f=d[0]?.term;if(f!==void 0){let e=a(f,t)?await C(f,n):[];return D(f,[...d,...e])}let p=t===r&&e.length>=3?await S(U`instr(${u.term}, ${e}) > 0`,n):[];return D(e,p)}))}let D=(e,t,n=!1)=>({word:e,ids:[...new Set(t.map(e=>e.id))],terms:new Set(t.map(e=>e.term)),optional:n});function ce(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of[...e].reverse())t.has(r.word)||(t.add(r.word),n.push(r));return n.reverse()}let J=()=>({hits:[],facetCounts:{}});function le(e,t){let n=Math.max(0,Math.trunc(e.offset??0));return{offset:n,end:Math.min(n+t,500)}}function ue(e){let t=e?.trim().toLowerCase();if(t)return e=>e.toLowerCase().startsWith(t)}let me=e=>(e.filter??[]).filter(e=>e.values.length>0),X=oe(i,`carried`),Z=(e,t)=>t.length===0?U`0`:I(m.db.select({one:U`1`}).from(X).where(M(F(X.docId,r.id),F(X.field,e),R(X.value,[...t]))));function Q(e,i){let a=[];e.locales!==void 0&&a.push(R(r.locale,[...e.locales]));let{candidates:o}=e;if(o!==void 0&&(i===void 0||o.lifted!==i)&&a.push(R(r.id,o.ids)),e.hidden!==void 0&&a.push(V(r.id,e.hidden)),e.teams!==void 0&&a.push(Z(t,[...new Set(e.teams.map(e=>e.toLowerCase()))])),e.versions!==void 0){let t=ae(m.db.select({one:U`1`}).from(X).where(M(F(X.docId,r.id),F(X.field,n)))),i=[...new Set(e.versions)];a.push(i.length===0?t:H(t,Z(n,i)))}for(let t of e.selections)t.field!==i&&a.push(Z(t.field,t.values));return a}async function Ce(e,t){let n=await m.db.select({id:r.id,titleTokens:r.titleTokens,textTokens:r.textTokens,pathTokens:r.pathTokens,httpPathTokens:r.httpPathTokens,groupKey:r.groupKey,entityKey:r.entityKey,docKey:r.docKey,pinned:(t===void 0?U`0`:U`${R(r.id,t)}`).as(`pinned`)}).from(r).where(M(...Q(e)));return new Map(n.map(({id:e,pinned:t,...n})=>[e,{...n,pinned:Number(t)===1}]))}async function we(e,t,n){return m.db.select({field:i.field,value:i.value,count:U`count(*)`}).from(r).crossJoin(i).where(M(F(i.docId,r.id),R(i.field,[...t]),...Q(e,n))).groupBy(i.field,i.value)}let $=(e,t)=>m.db.select({docId:i.docId}).from(i).where(M(F(i.field,e),R(i.value,[...t])));function Te(e,a){let o=i.docId,s=[];if(e.locales!==void 0&&s.push(R(o,m.db.select({id:r.id}).from(r).where(R(r.locale,[...e.locales])))),e.teams!==void 0){let n=[...new Set(e.teams.map(e=>e.toLowerCase()))];s.push(n.length===0?U`0`:R(o,$(t,n)))}if(e.versions!==void 0){let t=V(o,m.db.select({docId:i.docId}).from(i).where(F(i.field,n))),r=[...new Set(e.versions)];s.push(r.length===0?t:H(t,R(o,$(n,r))))}for(let t of e.selections)t.field!==a&&s.push(R(o,$(t.field,t.values)));return s}async function Ee(e,t,n){return m.db.select({field:i.field,value:i.value,count:U`count(*)`}).from(i).where(M(R(i.field,[...t]),...Te(e,n))).groupBy(i.field,i.value)}async function De(e,t,n){let r=[...new Set(t)],i=r.filter(t=>e.candidates!==void 0&&e.candidates.lifted!==t),a=r.filter(e=>!i.includes(e)),o=new Set(e.selections.map(e=>e.field)),s=e=>{let t=e.filter(e=>!o.has(e));return[...t.length>0?[{fields:t,lift:void 0}]:[],...e.filter(e=>o.has(e)).map(e=>({fields:[e],lift:e}))]},c=(await Promise.all([...s(i).map(t=>we(e,t.fields,t.lift)),...s(a).map(t=>Ee(e,t.fields,t.lift))])).flat(),l=ue(n),u={};for(let e of r)u[e]=c.filter(t=>t.field===e&&(l===void 0||l(t.value))).map(e=>({value:e.value,count:Number(e.count)})).sort((e,t)=>t.count-e.count||(e.value<t.value?-1:1)).slice(0,G.has(e)?void 0:25);return u}async function Oe(e){let t=/* @__PURE__ */ new Map;for(let n of d(e,y)){let e=await m.db.select().from(r).where(R(r.id,n));for(let n of e)t.set(n.id,n)}return t}async function ke(e,t){let n=[];for(let r of d(e,y)){let e=await m.db.select({field:l.field,term:u.term,docId:l.docId,offsets:l.offsets}).from(l).innerJoin(u,F(u.id,l.termId)).where(M(R(l.termId,r),t===void 0?void 0:R(l.docId,t)));for(let t of e)n.push(t)}return n}function Ae(e,t){let n=m.db.select({docId:l.docId,termId:l.termId}).from(l).where(M(R(l.termId,e),B(l.field,`path`))),r=m.db.select({docId:s.docId,termId:o.termId}).from(o).innerJoin(s,F(s.fragmentId,o.fragmentId)).where(R(o.termId,e)),i=W(n,r).as(`occurrences`),a=m.db.select({docId:i.docId}).from(i);if(t===void 0)return a;let c=U.join(t.map(e=>U`max(case when ${R(i.termId,[...e])} then 1 else 0 end)`),U` + `);return a.groupBy(i.docId).having(U`${c} = ${t.length}`)}async function je(e){let t=(e,t)=>{let n=m.db.select({docId:l.docId}).from(l).where(M(R(l.termId,[...t]),B(l.field,`path`))),r=m.db.select({docId:s.docId}).from(o).innerJoin(s,F(s.fragmentId,o.fragmentId)).where(R(o.termId,[...t])),i=W(n,r).as(`reached`);return m.db.select({word:U`${e}`.as(`word`),count:U`count(distinct ${i.docId})`.as(`count`)}).from(i)},n=e.flatMap((e,n)=>e.length===0?[]:[t(n,e)]),r=e.map(()=>0);if(n.length===0)return r;let i=n.length===1?await n[0]:await W(...n);for(let e of i)r[Number(e.word)]=Number(e.count);return r}async function Me(e,t){let n=[];for(let r of d(e,y)){let e=await m.db.select({term:u.term,fragmentId:o.fragmentId,offsets:o.offsets,docId:s.docId}).from(o).innerJoin(u,F(u.id,o.termId)).innerJoin(s,F(s.fragmentId,o.fragmentId)).where(M(R(o.termId,r),t===void 0?void 0:R(U`+${s.docId}`,t)));for(let t of e)n.push(t)}return n}function Ne(e){let t=/* @__PURE__ */ new Map;return e.map(e=>{let n=`${e.docId}\u0000${e.fragmentId}`,r=t.get(n);r===void 0&&t.set(n,r=t.size);let i=r*1e6,a=JSON.parse(e.offsets).map(e=>i+e);return{term:e.term,docId:e.docId,offsets:JSON.stringify(a)}})}function Pe(e,t){let n=/* @__PURE__ */ new Map;for(let r of e){let e=n.get(r.docId);e||n.set(r.docId,e=/* @__PURE__ */ new Map);let i=e.get(r.fragmentId);i||(i={fragmentId:r.fragmentId,score:0,offsetGroups:[]},e.set(r.fragmentId,i));let a=JSON.parse(r.offsets);i.score+=a.length;for(let{word:e,terms:n}of t)n.has(r.term)&&i.offsetGroups.push([e.length,...k(e,r.term,a)])}let r=/* @__PURE__ */ new Map;for(let[e,t]of n){let n;for(let e of t.values())(n===void 0||e.score>n.score)&&(n=e);n&&r.set(e,{fragmentId:n.fragmentId,offsetGroups:n.offsetGroups})}return r}async function Fe(e){let t=/* @__PURE__ */ new Map;for(let n of d([...new Set(e)],y)){let e=await m.db.select().from(c).where(R(c.id,n));for(let n of e)t.set(n.id,fe(n))}return t}async function Ie(e){let t=/* @__PURE__ */ new Map;if(e.size===0)return t;let n=await m.db.select({docId:s.docId,fragmentId:s.fragmentId,anchorTail:s.anchorTail,place:a.place,path:a.path,anchorPrefix:a.anchorPrefix}).from(s).innerJoin(a,F(a.id,s.parentId)).where(M(R(s.docId,[...e.keys()]),R(s.fragmentId,[...new Set([...e.values()].map(e=>e.fragmentId))])));for(let r of n)e.get(r.docId)?.fragmentId===r.fragmentId&&t.set(r.docId,{place:r.place,path:r.path,anchor:r.anchorPrefix+r.anchorTail});return t}async function Le(e){let[t]=await m.db.select({total:U`count(*)`,averageTitle:U`avg(${r.titleTokens})`,averageText:U`avg(${r.textTokens})`,averagePath:U`avg(nullif(${r.pathTokens}, 0))`,averageHttpPath:U`avg(nullif(${r.httpPathTokens}, 0))`}).from(r).where(e===void 0?void 0:R(r.locale,[...e]));return t}async function Re(e){let t=/* @__PURE__ */ new Set;for(let n=0;n<e.length;n++){let r=Math.min(e.length,n+10);for(let i=n+1;i<=r;i++)t.add(e.slice(n,i).join(` `))}let n=[...t],r=await m.db.selectDistinct({field:i.field}).from(i).where(M(R(i.field,[_,g]),R(i.value,n))),a=e=>r.some(t=>t.field===e),o=a(`redocly_hide`)?$(g,n):void 0;if(!a(`redocly_pin`))return o?{hidden:o}:{};let s=m.db.select({docId:i.docId}).from(i).where(M(F(i.field,_),R(i.value,n)));return o?{pinned:s,hidden:o}:{pinned:s}}async function ze(e){return(await m.db.select({id:r.id}).from(r).where(M(...Q(e))).limit(1)).length>0}async function Be(t,n,r,i){let{locales:a}=r,o=ce(t),s=o.filter(e=>!e.optional).map(e=>e.ids).filter(e=>e.length>0),c=[...new Set(s.flat())];if(c.length===0&&n.pinned===void 0)return J();let l=o.filter(e=>e.optional).flatMap(e=>e.ids),u=[.../* @__PURE__ */ new Set([...c,...l])],d=o.map(e=>e.word),f=new Set(o.filter(e=>e.optional).map(e=>e.word)),{pinned:m}=n,h=e=>m===void 0?e:U`(select doc_id from ${e} union select doc_id from ${m})`,g=e=>({locales:a,candidates:{ids:e},hidden:n.hidden,teams:r.teams,versions:r.versions,selections:me(r)}),_=Ae(c,s.length>0?s:void 0),v=Ae(c),y=e=>De(e,r.countFields??[],r.countValuePrefix),b=m!==void 0&&s.length>1?ze(g(_)):void 0;if(r.countOnly){let[e,t]=await Promise.all([y(g(h(_))),b]),n=Object.values(e).every(e=>e.length===0);return c.length===0&&n?J():{hits:[],facetCounts:s.length>1&&!(t??!n)?await y(g(h(v))):e}}let x=Promise.all([Le(a),je(o.map(e=>e.ids))]),S=(e,t)=>{let n=h(e);return Promise.all([y(g(n)),Ce(g(n),m),ke(u,t?n:void 0),Me(c,t?n:void 0)])},[C,w]=await Promise.all([S(_,!0),b]),[E,D,k,A]=C;!(w??D.size>0)&&s.length>1&&([E,D,k,A]=await S(v,l.length>0));let[j,ne]=await x,M=[...D].filter(([,e])=>e.pinned).map(([e])=>e);if(M.length===0&&(D.size===0||k.length===0&&A.length===0))return c.length===0?J():{hits:[],facetCounts:E};let N=new Map(o.map((e,t)=>[e.word,ne[t]??0])),re=new Set([...k,...A].map(e=>e.docId)),P=le(r,i),F=(e,t)=>({totalDocuments:j?.total??0,averageDocumentLength:t??0,getDocumentLength:t=>D.get(t)?.[e]??0}),I=/* @__PURE__ */ new Map;for(let e of k){let t=I.get(e.field);t?t.push(e):I.set(e.field,[e])}let L=e=>I.get(e)??[],R=new ee({limit:re.size,fields:[{name:`title`,weight:q.title,lookup:O(L(`title`)),corpusStats:F(`titleTokens`,j?.averageTitle??null)},{name:`text`,weight:q.text,lookup:O(L(`text`)),corpusStats:F(`textTokens`,j?.averageText??null)},{name:`path`,weight:q.path,lookup:O(L(`path`)),corpusStats:F(`pathTokens`,j?.averagePath??null),countsTowardFrequency:!1},{name:`httpPath`,weight:q.httpPath,lookup:O(L(`httpPath`)),corpusStats:F(`httpPathTokens`,j?.averageHttpPath??null)},{name:se.name,weight:se.weight,lookup:O(Ne(A)),corpusStats:{totalDocuments:j?.total??0,averageDocumentLength:1,getDocumentLength:()=>1}}]}),ie=/* @__PURE__ */ new Set,z=/* @__PURE__ */ new Map,B=Se(R.search(d.join(` `),{optional:f,documentFrequencies:N,terms:new Map(o.map(e=>[e.word,e.terms]))}),M).filter(e=>{let t=D.get(e.id);if(t===void 0)return!1;let n=Y(t.entityKey,p(t.docKey));return ie.has(n)?(t.groupKey!==null&&z.set(t.groupKey,(z.get(t.groupKey)??0)+1),!1):(ie.add(n),!0)}),ae=E[e];ae!==void 0&&z.size>0&&(E[e]=ae.map(({value:e,count:t})=>({value:e,count:t-(z.get(e)??0)})).filter(({count:e})=>e>0));let V=r.perGroup,H=/* @__PURE__ */ new Map,oe=V===void 0?B.slice(P.offset,P.end):B.filter(e=>{let t=D.get(e.id)?.groupKey??null,n=H.get(t)??0;return H.set(t,n+1),n<V}),W=new Set(oe.map(e=>e.id)),G=Pe(A.filter(e=>W.has(e.docId)),o),[K,ue,de]=await Promise.all([Oe([...W]),Fe([...G.values()].map(e=>e.fragmentId)),Ie(G)]);return{hits:oe.flatMap(e=>{let t=K.get(e.id);if(!t)return[];let n=t=>e.fields.find(e=>e.name===t),r=e=>n(e)?.offsets,i={},a=ve(t.title,r(`title`)),o=be(t.text,r(`text`)),s=ye(t.extra?.path,t.title,r(`path`),a);a!==void 0&&(i.title=a),o!==void 0&&(i.text=o),s!==void 0&&(i.path=s);let c=ve(t.httpPath??``,r(`httpPath`));c?.includes(`<mark>`)&&(i.httpPath=c);let l=G.get(e.id),u=l?ue.get(l.fragmentId):void 0,d=de.get(e.id),p={...t,rank:e.rank,highlight:i};if(l===void 0||u===void 0||d===void 0)return[p];let m=te(u,d,l.offsetGroups),h=u.description??``;return m.description=be(h,T(u,l.offsetGroups))??_e(h,200),i.parameters=[m],[n(`title`)?.tokens.some(e=>!f.has(e))?p:{...p,parameterAnchor:d.anchor}]}),facetCounts:E}}async function Ve(e,t){let n=me(e),[a]=n,o={locales:e.locales,candidates:a&&{ids:m.db.select({docId:i.docId}).from(i).where(M(F(i.field,a.field),R(i.value,[...a.values]))),lifted:a.field},teams:e.teams,versions:e.versions,selections:n},s=await De(o,e.countFields??[],e.countValuePrefix),c=le(e,t);return e.countOnly||o.selections.length===0||c.end<=c.offset?{hits:[],facetCounts:s}:{hits:(await m.db.select().from(r).where(M(...Q(o))).orderBy(N(r.routeSlug),N(r.docKey)).limit(c.end-c.offset).offset(c.offset)).map(e=>Object.assign(e,{rank:0,highlight:{}})),facetCounts:s}}return{async replaceSourceDocuments(e,t){if(e.length===0)return;let n=e.map(de);t?await b(t,n):await m.db.transaction(e=>b(e,n))},async removeSource(e){await m.db.transaction(async t=>{let n=await ge(t,[e]);await t.delete(r).where(F(r.entityKey,e)),await v(t,n)})},async query(e){let t=Math.min(Math.max(1,Math.trunc(e.limit)),500),n=h(e.q);if(n.length===0)return Ve(e,t);let r=A(n,e.stopwords),[i,a]=await Promise.all([E(n,r,e.locales),Re(n)]);return Be(i,a,e,t)},async readDocuments(e={}){let t=[e.routeSlug===void 0?void 0:F(r.routeSlug,e.routeSlug),e.entityKey===void 0?void 0:F(r.entityKey,e.entityKey)].filter(e=>e!==void 0);return m.db.select().from(r).where(t.length>0?M(...t):void 0).orderBy(N(r.entityKey),N(r.docKey))}}}export{Q as createPostingsSearchStore,ve as highlightOffsets,ye as highlightPath,be as highlightSnippet,Se as pinFirst};
1
+ import{SEARCH_GROUP_FACET_FIELD as e,SEARCH_TEAMS_FACET_FIELD as t,SEARCH_VERSION_FACET_FIELD as n}from"../../../shared/search/facets.js";import{routes as r,searchDocuments as i,searchFacets as a,searchFragmentParents as o,searchFragmentPostings as s,searchFragmentUsages as c,searchFragments as l,searchPostings as u,searchVocab as d}from"../../database/schema.js";import{batchValues as f,normalizeBatchSize as p}from"../../database/connection.js";import{teamBlockSectionKey as m}from"../../markdown/search/to-sections.js";import{tokenizeSearchContent as h,tokenizeSearchQuery as g}from"../tokenize.js";import{SEARCH_HIDE_FACET_FIELD as _,SEARCH_PIN_FACET_FIELD as v}from"../keywords.js";import{refreshTermDocCounts as y,selectTermIdsOfDocuments as b,selectTermIdsOfFragments as x}from"../../database/search-vocab.js";import{SearchEngine as ee}from"../engine/core/search-engine.js";import{PATH_SEGMENT_SEPARATOR as S,indexedPathSegments as C,indexedPathText as w,splitIndexedPath as T}from"./path-field.js";import{descriptionOffsetGroups as te,highlightFragment as ne,indexedFragmentText as E,splitAnchor as D}from"./fragment-field.js";import{createPostingsTermLookup as O,wordOffsets as k}from"./term-lookup.js";import{optionalTokens as A}from"../stopwords.js";import{maxEditsForToken as re,pickCorrection as ie}from"./typo-correction.js";import"../store.js";import{and as j,asc as M,between as N,desc as P,eq as F,exists as I,gte as ae,inArray as L,lt as R,lte as oe,ne as z,notExists as B,notInArray as V,or as H,sql as U}from"drizzle-orm";import{alias as se,unionAll as W}from"drizzle-orm/sqlite-core";const ce=/* @__PURE__ */ new Set([e]),G=[{name:`title`,weight:2},{name:`text`,weight:1},{name:`path`,weight:1},{name:`httpPath`,weight:1}],le={name:`parameters`,weight:1},K=Object.fromEntries(G.map(e=>[e.name,e.weight])),ue=/* @__PURE__ */ new Set([`get`,`put`,`post`,`delete`,`options`,`head`,`patch`,`trace`,`query`]),q=/[_.:']/g;function de(e,t){if(!e)return h(``);let n=t?.toLowerCase(),r=n&&ue.has(n)?`${S}${n}`:``,i=h(`${e}${r}`),a=h(`${e.replace(q,` `)}${r}`),o=/* @__PURE__ */ new Map;for(let e of[...i.tokens,...a.tokens]){let t=o.get(e.value)??/* @__PURE__ */ new Set;for(let n of e.offsets)t.add(n);o.set(e.value,t)}return{tokens:[...o].map(([e,t])=>({documentId:0,value:e,offsets:[...t].sort((e,t)=>e-t)})),length:a.length}}function fe(e,t,n,r){let i=h(t.title),a=h(t.text),o=h(w(t.path,t.title)),s=de(t.httpPath,t.httpMethod),c=t.path||t.badges||t.product||t.version||t.isAdditionalOperation?{path:t.path,badges:t.badges,product:t.product,version:t.version,isAdditionalOperation:t.isAdditionalOperation}:null;return{fields:{title:i,text:a,path:o,httpPath:s},facets:t.facets??{},row:{entityKey:e,docKey:t.docKey,routeSlug:t.routeSlug,locale:t.locale??``,anchor:t.anchor??null,title:t.title,text:t.text,titleTokens:i.length,textTokens:a.length,pathTokens:o.length,httpPathTokens:s.length,sourceHash:n,pluginVersion:r,groupKey:t.groupKey||null,httpMethod:t.httpMethod??null,httpPath:t.httpPath??null,deprecated:+!!t.deprecated,extra:c}}}function pe(e){let t=new Map(e.docs.map(e=>[e.docKey,e.locale??``])),n=(e.uses??[]).filter(e=>t.has(e.docKey)),r=/* @__PURE__ */ new Map;for(let e of n)r.has(e.fragmentKey)||r.set(e.fragmentKey,t.get(e.docKey)??``);let i=[],a=/* @__PURE__ */ new Set;for(let t of e.fragments??[]){let e=r.get(t.fragmentKey);e===void 0||a.has(t.fragmentKey)||(a.add(t.fragmentKey),i.push({fragment:t,locale:e,tokens:h(E(t))}))}let o=/* @__PURE__ */ new Map;for(let e of n){if(!a.has(e.fragmentKey))continue;let t=JSON.stringify([e.docKey,e.fragmentKey]);o.has(t)||o.set(t,e)}let s=/* @__PURE__ */ new Map;for(let e of o.values()){let t=e.path??[],{prefix:n,tail:r}=D(e.anchor),i=JSON.stringify([e.docKey,e.place,t,n]),a=s.get(i);a||(a={docKey:e.docKey,place:e.place,path:t,anchorPrefix:n,uses:[]},s.set(i,a)),a.uses.push({fragmentKey:e.fragmentKey,anchorTail:r})}return{entityKey:e.entityKey,docs:e.docs.map(t=>fe(e.entityKey,t,e.sourceHash,e.pluginVersion)),fragments:i,parents:[...s.values()]}}function me(e){let t={fragmentKey:e.fragmentKey,name:e.name,description:e.description};return e.example&&(t.example=e.example),e.enumValues&&e.enumValues.length>0&&(t.enum=e.enumValues),t}const J=(e,t)=>JSON.stringify([e,t]),he=(e,t)=>JSON.stringify([e,t]),ge=[8,16],_e=e=>ge[e.length-1]??50;async function ve(e,t){let n=e.select({id:i.id}).from(i).where(L(i.entityKey,[...t])),r=e.select({id:l.id}).from(l).where(L(l.entityKey,[...t])),d=[...await b(e,n.getSQL()),...await x(e,r.getSQL())];return await e.delete(u).where(L(u.docId,n)),await e.delete(a).where(L(a.docId,n)),await e.delete(s).where(L(s.fragmentId,r)),await e.delete(o).where(L(o.docId,n)),await e.delete(c).where(L(c.fragmentId,r)),await e.delete(l).where(L(l.entityKey,[...t])),d}function ye(e,t){if(e.length<=t)return e;let n=e.lastIndexOf(` `,t);return`${e.slice(0,n>0?n:t)}…`}function Y(e){let t=[];return e.forEach(([e,...n],r)=>{for(let i of n)t.push({start:i,end:i+(e??0),word:r})}),t.sort((e,t)=>e.start-t.start||t.end-e.end)}function X(e,t,n,r){let i=``,a=n;for(let{start:n,end:o}of t)n<a||o>r||(i+=`${e.slice(a,n)}<mark>${e.slice(n,o)}</mark>`,a=o);return i+e.slice(a,r)}function Z(e,t){if(t?.length)return X(e,Y(t),0,e.length)}function be(e,t,n,r){if(e===void 0||e.length<2)return;let i=C(e,t),a=i.length<e.length,o=Z(i.join(S),n),s=a?r:void 0;if(o===void 0&&s===void 0)return;let c=o===void 0?[...i]:T(o);return a?[...c,s??t]:c}function xe(e,t,n=200){if(!t?.length)return;let r=Y(t);if(r.length===0||e.length<=n)return X(e,r,0,e.length);let i={first:0,last:0,words:0,matches:0};for(let e=0;e<r.length;e++){let t=r[e].start+n,a=/* @__PURE__ */ new Set,o=e;for(let n=e;n<r.length&&r[n].end<=t;n++)a.add(r[n].word),o=n;let s=o-e+1;(a.size>i.words||a.size===i.words&&s>i.matches)&&(i={first:e,last:o,words:a.size,matches:s})}let a=r[i.first].start,o=r[i.last].end,s=Math.max(0,Math.min(a-Math.floor((n-(o-a))/2),e.length-n)),c=Math.min(e.length,s+n);if(s>0){let t=e.lastIndexOf(` `,s);s=t===-1?0:Math.min(t+1,a)}if(c<e.length){let t=e.indexOf(` `,c);c=t===-1?e.length:Math.max(t,o)}let l=X(e,r,s,c);return`${s>0?`…`:``}${l}${c<e.length?`…`:``}`}async function Se(e,t,n){let[r]=await e.select({max:U`max(${n})`}).from(t);return Number(r?.max??0)}function Ce(e,t){if(t.length===0)return[...e];let n=new Set(t),r=e.filter(e=>n.has(e.id)),i=new Set(r.map(e=>e.id)),a=t.filter(e=>!i.has(e)).sort((e,t)=>e-t).map(e=>({id:e,rank:0,fields:[]})),o=e[0]?.rank??0,s=[...r,...a];return[...s.map((e,t)=>Object.assign(e,{rank:o+s.length-t})),...e.filter(e=>!n.has(e.id))]}function we(h){let b=p(void 0);async function x(e,t){let n=t.map(e=>e.entityKey),r=[];for(let t of f(n,b)){for(let n of await ve(e,t))r.push(n);await e.delete(i).where(L(i.entityKey,t))}let p=t.flatMap(e=>e.docs);if(p.length===0){await y(e,r);return}for(let t of f(p,b))await e.insert(i).values(t.map(e=>e.row));let m=/* @__PURE__ */ new Map;for(let t of f(n,b)){let n=await e.select({id:i.id,entityKey:i.entityKey,docKey:i.docKey}).from(i).where(L(i.entityKey,t));for(let e of n)m.set(J(e.entityKey,e.docKey),e.id)}let h=/* @__PURE__ */ new Map,g=(e,t)=>JSON.stringify([e,t]),_=await Se(e,l,l.id)+1,v=[];for(let e of t)for(let{fragment:t,locale:n}of e.fragments){let r=_++;h.set(g(e.entityKey,t.fragmentKey),r),v.push({id:r,entityKey:e.entityKey,fragmentKey:t.fragmentKey,locale:n,name:t.name,description:t.description??``,example:t.example??null,enumValues:t.enum??null})}let x=await Se(e,o,o.id)+1,ee=[],S=[];for(let e of t)for(let t of e.parents){let n=m.get(J(e.entityKey,t.docKey));if(n===void 0)continue;let r=x++;ee.push({id:r,docId:n,place:t.place,path:t.path,anchorPrefix:t.anchorPrefix});for(let i of t.uses){let t=h.get(g(e.entityKey,i.fragmentKey));t!==void 0&&S.push({fragmentId:t,docId:n,parentId:r,anchorTail:i.anchorTail})}}for(let t of f(v,b))await e.insert(l).values(t);for(let t of f(ee,b))await e.insert(o).values(t);for(let t of f(S,b))await e.insert(c).values(t);let C=/* @__PURE__ */ new Map,w=e=>{let t=C.get(e);return t||(t=/* @__PURE__ */ new Set,C.set(e,t)),t};for(let e of p){let t=w(e.row.locale??``);for(let n of G)for(let r of e.fields[n.name].tokens)t.add(r.value)}for(let e of t)for(let{locale:t,tokens:n}of e.fragments){let e=w(t);for(let t of n.tokens)e.add(t.value)}let T=/* @__PURE__ */ new Map;for(let[t,n]of C)for(let r of f([...n],b)){await e.insert(d).values(r.map(e=>({term:e,locale:t}))).onConflictDoNothing();let n=await e.select({id:d.id,term:d.term}).from(d).where(j(F(d.locale,t),L(d.term,r)));for(let e of n)T.set(he(t,e.term),e.id)}let te=[];for(let e of p){let t=m.get(J(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let n of G)for(let r of e.fields[n.name].tokens){let i=T.get(he(e.row.locale??``,r.value));i!==void 0&&te.push({termId:i,field:n.name,docId:t,offsets:JSON.stringify(r.offsets)})}}for(let t of f(te,b))await e.insert(u).values(t);let ne=[];for(let e of t)for(let{fragment:t,locale:n,tokens:r}of e.fragments){let i=h.get(g(e.entityKey,t.fragmentKey));if(i!==void 0)for(let e of r.tokens){let t=T.get(he(n,e.value));t!==void 0&&ne.push({termId:t,fragmentId:i,offsets:JSON.stringify(e.offsets)})}}for(let t of f(ne,b))await e.insert(s).values(t);let E=[];for(let e of p){let t=m.get(J(e.row.entityKey,e.row.docKey));if(t!==void 0)for(let[n,r]of Object.entries(e.facets))for(let e of r)E.push({docId:t,field:n,value:e})}for(let t of f(E,b))await e.insert(a).values(t);await y(e,[...r,...T.values()])}let S=e=>e===void 0?void 0:L(d.locale,[...e]);function C(e,t,n=50){return h.db.select({id:d.id,term:d.term}).from(d).where(j(e,S(t))).orderBy(P(d.docCount),M(d.term)).limit(n)}let w=(e,t)=>C(j(ae(d.term,e),oe(d.term,`${e}\uffff`)),t,_e(e));async function T(e,t){let n=re(e),r=e.codePointAt(0);if(n===0||r===void 0||r>=1114111)return[];let i=[...e].length,a=await h.db.select({id:d.id,term:d.term,docCount:d.docCount}).from(d).where(j(S(t),ae(d.term,String.fromCodePoint(r)),R(d.term,String.fromCodePoint(r+1)),N(U`length(${d.term})`,i-n,i+n))).orderBy(P(d.docCount),M(d.term)).limit(2e3),o=/* @__PURE__ */ new Map;for(let{id:e,term:t,docCount:n}of a){let r=o.get(t);r?(r.docCount+=n,r.ids.push(e)):o.set(t,{term:t,docCount:n,ids:[e]})}let s=ie(e,[...o.values()]);return s===null?[]:(o.get(s)?.ids??[]).map(e=>({id:e,term:s}))}async function E(e,t,n){let r=e.length-1,i=(e,n)=>t.has(e)&&n!==r,a=(e,t)=>t===r||t>r-3&&e.length>=3,[o,s]=await Promise.all([h.db.select({id:d.id,term:d.term}).from(d).where(j(L(d.term,e),S(n))),Promise.all(e.map(async(e,t)=>!i(e,t)&&a(e,t)?w(e,n):[]))]);return Promise.all(e.map(async(e,t)=>{let c=o.filter(t=>t.term===e);if(i(e,t))return D(e,c,!0);let l=[...c,...s[t]??[]];if(l.length>0)return D(e,l);let u=await T(e,n),f=u[0]?.term;if(f!==void 0){let e=a(f,t)?await w(f,n):[];return D(f,[...u,...e])}let p=t===r&&e.length>=3?await C(U`instr(${d.term}, ${e}) > 0`,n):[];return D(e,p)}))}let D=(e,t,n=!1)=>({word:e,ids:[...new Set(t.map(e=>e.id))],terms:new Set(t.map(e=>e.term)),optional:n});function ue(e){let t=/* @__PURE__ */ new Set,n=[];for(let r of[...e].reverse())t.has(r.word)||(t.add(r.word),n.push(r));return n.reverse()}let q=()=>({hits:[],facetCounts:{}});function de(e,t){let n=Math.max(0,Math.trunc(e.offset??0));return{offset:n,end:Math.min(n+t,500)}}function fe(e){let t=e?.trim().toLowerCase();if(t)return e=>e.toLowerCase().startsWith(t)}let ge=e=>(e.filter??[]).filter(e=>e.values.length>0),Y=se(a,`carried`),X=(e,t)=>t.length===0?U`0`:I(h.db.select({one:U`1`}).from(Y).where(j(F(Y.docId,i.id),F(Y.field,e),L(Y.value,[...t]))));function we(e){if(e.locales===void 0)return;let t=L(i.locale,[...e.locales]),n=e.canonicalFallback;if(n===void 0)return t;let a=B(h.db.select({one:U`1`}).from(r).where(j(F(r.locale,n.locale),F(r.isFallback,!1),F(r.canonicalSlug,i.routeSlug)))),o=n.translatedPrefixes.length===0?void 0:H(I(h.db.select({one:U`1`}).from(r).where(F(r.slug,i.routeSlug))),j(...n.translatedPrefixes.map(e=>U`substr(${i.routeSlug}, 1, ${e.length+1}) <> ${`${e}/`}`)));return j(t,H(z(i.locale,``),j(a,o)))}function Q(e,r){let a=[we(e)],{candidates:o}=e;if(o!==void 0&&(r===void 0||o.lifted!==r)&&a.push(L(i.id,o.ids)),e.hidden!==void 0&&a.push(V(i.id,e.hidden)),e.teams!==void 0&&a.push(X(t,[...new Set(e.teams.map(e=>e.toLowerCase()))])),e.versions!==void 0){let t=B(h.db.select({one:U`1`}).from(Y).where(j(F(Y.docId,i.id),F(Y.field,n)))),r=[...new Set(e.versions)];a.push(r.length===0?t:H(t,X(n,r)))}for(let t of e.selections)t.field!==r&&a.push(X(t.field,t.values));return a}async function Te(e,t){let n=await h.db.select({id:i.id,titleTokens:i.titleTokens,textTokens:i.textTokens,pathTokens:i.pathTokens,httpPathTokens:i.httpPathTokens,groupKey:i.groupKey,entityKey:i.entityKey,docKey:i.docKey,pinned:(t===void 0?U`0`:U`${L(i.id,t)}`).as(`pinned`)}).from(i).where(j(...Q(e)));return new Map(n.map(({id:e,pinned:t,...n})=>[e,{...n,pinned:Number(t)===1}]))}async function Ee(e,t,n){return h.db.select({field:a.field,value:a.value,count:U`count(*)`}).from(i).crossJoin(a).where(j(F(a.docId,i.id),L(a.field,[...t]),...Q(e,n))).groupBy(a.field,a.value)}let $=(e,t)=>h.db.select({docId:a.docId}).from(a).where(j(F(a.field,e),L(a.value,[...t])));function De(e,r){let o=a.docId,s=[];if(e.locales!==void 0&&s.push(L(o,h.db.select({id:i.id}).from(i).where(we(e)))),e.teams!==void 0){let n=[...new Set(e.teams.map(e=>e.toLowerCase()))];s.push(n.length===0?U`0`:L(o,$(t,n)))}if(e.versions!==void 0){let t=V(o,h.db.select({docId:a.docId}).from(a).where(F(a.field,n))),r=[...new Set(e.versions)];s.push(r.length===0?t:H(t,L(o,$(n,r))))}for(let t of e.selections)t.field!==r&&s.push(L(o,$(t.field,t.values)));return s}async function Oe(e,t,n){return h.db.select({field:a.field,value:a.value,count:U`count(*)`}).from(a).where(j(L(a.field,[...t]),...De(e,n))).groupBy(a.field,a.value)}async function ke(e,t,n){let r=[...new Set(t)],i=r.filter(t=>e.candidates!==void 0&&e.candidates.lifted!==t),a=r.filter(e=>!i.includes(e)),o=new Set(e.selections.map(e=>e.field)),s=e=>{let t=e.filter(e=>!o.has(e));return[...t.length>0?[{fields:t,lift:void 0}]:[],...e.filter(e=>o.has(e)).map(e=>({fields:[e],lift:e}))]},c=(await Promise.all([...s(i).map(t=>Ee(e,t.fields,t.lift)),...s(a).map(t=>Oe(e,t.fields,t.lift))])).flat(),l=fe(n),u={};for(let e of r)u[e]=c.filter(t=>t.field===e&&(l===void 0||l(t.value))).map(e=>({value:e.value,count:Number(e.count)})).sort((e,t)=>t.count-e.count||(e.value<t.value?-1:1)).slice(0,ce.has(e)?void 0:25);return u}async function Ae(e){let t=/* @__PURE__ */ new Map;for(let n of f(e,b)){let e=await h.db.select().from(i).where(L(i.id,n));for(let n of e)t.set(n.id,n)}return t}async function je(e,t){let n=[];for(let r of f(e,b)){let e=await h.db.select({field:u.field,term:d.term,docId:u.docId,offsets:u.offsets}).from(u).innerJoin(d,F(d.id,u.termId)).where(j(L(u.termId,r),t===void 0?void 0:L(u.docId,t)));for(let t of e)n.push(t)}return n}function Me(e,t){let n=h.db.select({docId:u.docId,termId:u.termId}).from(u).where(j(L(u.termId,e),z(u.field,`path`))),r=h.db.select({docId:c.docId,termId:s.termId}).from(s).innerJoin(c,F(c.fragmentId,s.fragmentId)).where(L(s.termId,e)),i=W(n,r).as(`occurrences`),a=h.db.select({docId:i.docId}).from(i);if(t===void 0)return a;let o=U.join(t.map(e=>U`max(case when ${L(i.termId,[...e])} then 1 else 0 end)`),U` + `);return a.groupBy(i.docId).having(U`${o} = ${t.length}`)}async function Ne(e){let t=(e,t)=>{let n=h.db.select({docId:u.docId}).from(u).where(j(L(u.termId,[...t]),z(u.field,`path`))),r=h.db.select({docId:c.docId}).from(s).innerJoin(c,F(c.fragmentId,s.fragmentId)).where(L(s.termId,[...t])),i=W(n,r).as(`reached`);return h.db.select({word:U`${e}`.as(`word`),count:U`count(distinct ${i.docId})`.as(`count`)}).from(i)},n=e.flatMap((e,n)=>e.length===0?[]:[t(n,e)]),r=e.map(()=>0);if(n.length===0)return r;let i=n.length===1?await n[0]:await W(...n);for(let e of i)r[Number(e.word)]=Number(e.count);return r}async function Pe(e,t){let n=[];for(let r of f(e,b)){let e=await h.db.select({term:d.term,fragmentId:s.fragmentId,offsets:s.offsets,docId:c.docId}).from(s).innerJoin(d,F(d.id,s.termId)).innerJoin(c,F(c.fragmentId,s.fragmentId)).where(j(L(s.termId,r),t===void 0?void 0:L(U`+${c.docId}`,t)));for(let t of e)n.push(t)}return n}function Fe(e){let t=/* @__PURE__ */ new Map;return e.map(e=>{let n=`${e.docId}\u0000${e.fragmentId}`,r=t.get(n);r===void 0&&t.set(n,r=t.size);let i=r*1e6,a=JSON.parse(e.offsets).map(e=>i+e);return{term:e.term,docId:e.docId,offsets:JSON.stringify(a)}})}function Ie(e,t){let n=/* @__PURE__ */ new Map;for(let r of e){let e=n.get(r.docId);e||n.set(r.docId,e=/* @__PURE__ */ new Map);let i=e.get(r.fragmentId);i||(i={fragmentId:r.fragmentId,score:0,offsetGroups:[]},e.set(r.fragmentId,i));let a=JSON.parse(r.offsets);i.score+=a.length;for(let{word:e,terms:n}of t)n.has(r.term)&&i.offsetGroups.push([e.length,...k(e,r.term,a)])}let r=/* @__PURE__ */ new Map;for(let[e,t]of n){let n;for(let e of t.values())(n===void 0||e.score>n.score)&&(n=e);n&&r.set(e,{fragmentId:n.fragmentId,offsetGroups:n.offsetGroups})}return r}async function Le(e){let t=/* @__PURE__ */ new Map;for(let n of f([...new Set(e)],b)){let e=await h.db.select().from(l).where(L(l.id,n));for(let n of e)t.set(n.id,me(n))}return t}async function Re(e){let t=/* @__PURE__ */ new Map;if(e.size===0)return t;let n=await h.db.select({docId:c.docId,fragmentId:c.fragmentId,anchorTail:c.anchorTail,place:o.place,path:o.path,anchorPrefix:o.anchorPrefix}).from(c).innerJoin(o,F(o.id,c.parentId)).where(j(L(c.docId,[...e.keys()]),L(c.fragmentId,[...new Set([...e.values()].map(e=>e.fragmentId))])));for(let r of n)e.get(r.docId)?.fragmentId===r.fragmentId&&t.set(r.docId,{place:r.place,path:r.path,anchor:r.anchorPrefix+r.anchorTail});return t}async function ze(e){let[t]=await h.db.select({total:U`count(*)`,averageTitle:U`avg(${i.titleTokens})`,averageText:U`avg(${i.textTokens})`,averagePath:U`avg(nullif(${i.pathTokens}, 0))`,averageHttpPath:U`avg(nullif(${i.httpPathTokens}, 0))`}).from(i).where(e===void 0?void 0:L(i.locale,[...e]));return t}async function Be(e){let t=/* @__PURE__ */ new Set;for(let n=0;n<e.length;n++){let r=Math.min(e.length,n+10);for(let i=n+1;i<=r;i++)t.add(e.slice(n,i).join(` `))}let n=[...t],r=await h.db.selectDistinct({field:a.field}).from(a).where(j(L(a.field,[v,_]),L(a.value,n))),i=e=>r.some(t=>t.field===e),o=i(`redocly_hide`)?$(_,n):void 0;if(!i(`redocly_pin`))return o?{hidden:o}:{};let s=h.db.select({docId:a.docId}).from(a).where(j(F(a.field,v),L(a.value,n)));return o?{pinned:s,hidden:o}:{pinned:s}}async function Ve(e){return(await h.db.select({id:i.id}).from(i).where(j(...Q(e))).limit(1)).length>0}async function He(t,n,r,i){let{locales:a}=r,o=ue(t),s=o.filter(e=>!e.optional).map(e=>e.ids).filter(e=>e.length>0),c=[...new Set(s.flat())];if(c.length===0&&n.pinned===void 0)return q();let l=o.filter(e=>e.optional).flatMap(e=>e.ids),u=[.../* @__PURE__ */ new Set([...c,...l])],d=o.map(e=>e.word),f=new Set(o.filter(e=>e.optional).map(e=>e.word)),{pinned:p}=n,h=e=>p===void 0?e:U`(select doc_id from ${e} union select doc_id from ${p})`,g=e=>({locales:a,canonicalFallback:r.canonicalFallback,candidates:{ids:e},hidden:n.hidden,teams:r.teams,versions:r.versions,selections:ge(r)}),_=Me(c,s.length>0?s:void 0),v=Me(c),y=e=>ke(e,r.countFields??[],r.countValuePrefix),b=p!==void 0&&s.length>1?Ve(g(_)):void 0;if(r.countOnly){let[e,t]=await Promise.all([y(g(h(_))),b]),n=Object.values(e).every(e=>e.length===0);return c.length===0&&n?q():{hits:[],facetCounts:s.length>1&&!(t??!n)?await y(g(h(v))):e}}let x=Promise.all([ze(a),Ne(o.map(e=>e.ids))]),S=(e,t)=>{let n=h(e);return Promise.all([y(g(n)),Te(g(n),p),je(u,t?n:void 0),Pe(c,t?n:void 0)])},[C,w]=await Promise.all([S(_,!0),b]),[T,E,D,k]=C;!(w??E.size>0)&&s.length>1&&([T,E,D,k]=await S(v,l.length>0));let[A,re]=await x,ie=[...E].filter(([,e])=>e.pinned).map(([e])=>e);if(ie.length===0&&(E.size===0||D.length===0&&k.length===0))return c.length===0?q():{hits:[],facetCounts:T};let j=new Map(o.map((e,t)=>[e.word,re[t]??0])),M=new Set([...D,...k].map(e=>e.docId)),N=de(r,i),P=(e,t)=>({totalDocuments:A?.total??0,averageDocumentLength:t??0,getDocumentLength:t=>E.get(t)?.[e]??0}),F=/* @__PURE__ */ new Map;for(let e of D){let t=F.get(e.field);t?t.push(e):F.set(e.field,[e])}let I=e=>F.get(e)??[],ae=new ee({limit:M.size,fields:[{name:`title`,weight:K.title,lookup:O(I(`title`)),corpusStats:P(`titleTokens`,A?.averageTitle??null)},{name:`text`,weight:K.text,lookup:O(I(`text`)),corpusStats:P(`textTokens`,A?.averageText??null)},{name:`path`,weight:K.path,lookup:O(I(`path`)),corpusStats:P(`pathTokens`,A?.averagePath??null),countsTowardFrequency:!1},{name:`httpPath`,weight:K.httpPath,lookup:O(I(`httpPath`)),corpusStats:P(`httpPathTokens`,A?.averageHttpPath??null)},{name:le.name,weight:le.weight,lookup:O(Fe(k)),corpusStats:{totalDocuments:A?.total??0,averageDocumentLength:1,getDocumentLength:()=>1}}]}),L=/* @__PURE__ */ new Set,R=/* @__PURE__ */ new Map,oe=Ce(ae.search(d.join(` `),{optional:f,documentFrequencies:j,terms:new Map(o.map(e=>[e.word,e.terms]))}),ie).filter(e=>{let t=E.get(e.id);if(t===void 0)return!1;let n=J(t.entityKey,m(t.docKey));return L.has(n)?(t.groupKey!==null&&R.set(t.groupKey,(R.get(t.groupKey)??0)+1),!1):(L.add(n),!0)}),z=T[e];z!==void 0&&R.size>0&&(T[e]=z.map(({value:e,count:t})=>({value:e,count:t-(R.get(e)??0)})).filter(({count:e})=>e>0));let B=r.perGroup,V=/* @__PURE__ */ new Map,H=B===void 0?oe.slice(N.offset,N.end):oe.filter(e=>{let t=E.get(e.id)?.groupKey??null,n=V.get(t)??0;return V.set(t,n+1),n<B}),se=new Set(H.map(e=>e.id)),W=Ie(k.filter(e=>se.has(e.docId)),o),[ce,G,fe]=await Promise.all([Ae([...se]),Le([...W.values()].map(e=>e.fragmentId)),Re(W)]);return{hits:H.flatMap(e=>{let t=ce.get(e.id);if(!t)return[];let n=t=>e.fields.find(e=>e.name===t),r=e=>n(e)?.offsets,i={},a=Z(t.title,r(`title`)),o=xe(t.text,r(`text`)),s=be(t.extra?.path,t.title,r(`path`),a);a!==void 0&&(i.title=a),o!==void 0&&(i.text=o),s!==void 0&&(i.path=s);let c=Z(t.httpPath??``,r(`httpPath`));c?.includes(`<mark>`)&&(i.httpPath=c);let l=W.get(e.id),u=l?G.get(l.fragmentId):void 0,d=fe.get(e.id),p={...t,rank:e.rank,highlight:i};if(l===void 0||u===void 0||d===void 0)return[p];let m=ne(u,d,l.offsetGroups),h=u.description??``;return m.description=xe(h,te(u,l.offsetGroups))??ye(h,200),i.parameters=[m],[n(`title`)?.tokens.some(e=>!f.has(e))?p:{...p,parameterAnchor:d.anchor}]}),facetCounts:T}}async function Ue(e,t){let n=ge(e),[r]=n,o={locales:e.locales,canonicalFallback:e.canonicalFallback,candidates:r&&{ids:h.db.select({docId:a.docId}).from(a).where(j(F(a.field,r.field),L(a.value,[...r.values]))),lifted:r.field},teams:e.teams,versions:e.versions,selections:n},s=await ke(o,e.countFields??[],e.countValuePrefix),c=de(e,t);return e.countOnly||o.selections.length===0||c.end<=c.offset?{hits:[],facetCounts:s}:{hits:(await h.db.select().from(i).where(j(...Q(o))).orderBy(M(i.routeSlug),M(i.docKey)).limit(c.end-c.offset).offset(c.offset)).map(e=>Object.assign(e,{rank:0,highlight:{}})),facetCounts:s}}return{async replaceSourceDocuments(e,t){if(e.length===0)return;let n=e.map(pe);t?await x(t,n):await h.db.transaction(e=>x(e,n))},async removeSource(e){await h.db.transaction(async t=>{let n=await ve(t,[e]);await t.delete(i).where(F(i.entityKey,e)),await y(t,n)})},async query(e){let t=Math.min(Math.max(1,Math.trunc(e.limit)),500),n=g(e.q);if(n.length===0)return Ue(e,t);let r=A(n,e.stopwords),[i,a]=await Promise.all([E(n,r,e.locales),Be(n)]);return He(i,a,e,t)},async readDocuments(e={}){let t=[e.routeSlug===void 0?void 0:F(i.routeSlug,e.routeSlug),e.entityKey===void 0?void 0:F(i.entityKey,e.entityKey)].filter(e=>e!==void 0);return h.db.select().from(i).where(t.length>0?j(...t):void 0).orderBy(M(i.entityKey),M(i.docKey))}}}export{we as createPostingsSearchStore,Z as highlightOffsets,be as highlightPath,xe as highlightSnippet,Ce as pinFirst};
@@ -57,6 +57,17 @@ export type SearchQuery = {
57
57
  * absent. Each locale is its own partition: its words, completions and corrections.
58
58
  */
59
59
  locales?: readonly string[];
60
+ /**
61
+ * For a search of `locale` that also covers the canonical (`''`) documents: a canonical
62
+ * document counts only when `locale` has no translation of its page, which the site then
63
+ * serves under the locale's prefix. A translated route's slug drops the canonical document
64
+ * of the same slug; a slug in `translatedPrefixes` (a translated route that serves its
65
+ * sub-paths, such as an API description) also drops those under it that have no route.
66
+ */
67
+ canonicalFallback?: {
68
+ locale: string;
69
+ translatedPrefixes: readonly string[];
70
+ };
60
71
  /**
61
72
  * Words dropped from the query before it is resolved — not required, not loaded, not
62
73
  * highlighted — unless the query is made of them alone. None when absent.