@redocly/framework 1.0.0-next.8 → 1.0.0-next.9

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 (122) hide show
  1. package/dist/bundler/build/output-metadata.js +1 -1
  2. package/dist/bundler/build/run.js +1 -1
  3. package/dist/bundler/dev/run.js +1 -1
  4. package/dist/bundler/dev/runtime-app.js +1 -1
  5. package/dist/bundler/dev/vite-config.js +1 -1
  6. package/dist/bundler/user-markdoc-schema.js +1 -1
  7. package/dist/bundler/vite-config.base.js +8 -8
  8. package/dist/cli/args.js +1 -1
  9. package/dist/cli/commands/translate.js +1 -1
  10. package/dist/cli/dev-console/index.js +1 -1
  11. package/dist/cli/dev-console/tui.js +1 -1
  12. package/dist/cli/output.js +12 -12
  13. package/dist/cli/validate-react-pages.js +1 -1
  14. package/dist/client/app.js +1 -1
  15. package/dist/client/history-mount.js +1 -0
  16. package/dist/client/revisions-history.js +1 -1
  17. package/dist/content-layer/database/files.js +1 -1
  18. package/dist/content-layer/database/finalize.js +1 -1
  19. package/dist/content-layer/database/origins.js +1 -1
  20. package/dist/content-layer/ingest/finalize-phase.js +1 -1
  21. package/dist/content-layer/ingest/l10n-warnings.js +1 -1
  22. package/dist/content-layer/ingest/markdoc-schema-problem.js +1 -0
  23. package/dist/content-layer/ingest/run.js +1 -1
  24. package/dist/content-layer/ingest/search-sync.js +1 -1
  25. package/dist/content-layer/ingest/sync.js +1 -1
  26. package/dist/content-layer/link-checker/delta.js +1 -1
  27. package/dist/content-layer/link-checker/run-build.js +1 -1
  28. package/dist/content-layer/loaders/context.js +1 -1
  29. package/dist/content-layer/markdown/constants/markdown-text-tag-set.js +1 -1
  30. package/dist/content-layer/markdown/constants/tag-sets.d.ts +11 -2
  31. package/dist/content-layer/markdown/constants/tag-sets.js +1 -1
  32. package/dist/content-layer/markdown/resolve/markdoc-resolvers/file-reference.js +1 -1
  33. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.js +1 -1
  34. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.js +1 -1
  35. package/dist/content-layer/markdown/resolve/markdoc-resolvers/partial.js +1 -1
  36. package/dist/content-layer/markdown/resolve/markdoc-resolvers/svg-content.js +1 -1
  37. package/dist/content-layer/markdown/resolve/markdoc.js +1 -1
  38. package/dist/content-layer/markdown/resolve/references.d.ts +3 -1
  39. package/dist/content-layer/markdown/resolve/references.js +1 -1
  40. package/dist/content-layer/markdown/search/to-sections.d.ts +7 -2
  41. package/dist/content-layer/markdown/search/to-sections.js +1 -1
  42. package/dist/content-layer/markdown/search/to-text.js +5 -5
  43. package/dist/content-layer/markdown/server/render.js +1 -1
  44. package/dist/content-layer/markdown/service.js +1 -1
  45. package/dist/content-layer/markdown/types/service.d.ts +2 -0
  46. package/dist/content-layer/markdown/utils/first-heading.js +1 -1
  47. package/dist/content-layer/markdown/utils/parse-cache.js +1 -1
  48. package/dist/content-layer/materialization/entity.js +1 -1
  49. package/dist/content-layer/materialization/static-files.js +1 -1
  50. package/dist/content-layer/plugins/internal/api-docs/index.js +1 -1
  51. package/dist/content-layer/plugins/internal/api-docs/server/build-definition.js +1 -1
  52. package/dist/content-layer/plugins/internal/api-docs/server/markdown-docs.js +11 -11
  53. package/dist/content-layer/plugins/internal/api-docs/server/options.js +1 -1
  54. package/dist/content-layer/plugins/internal/api-docs/server/search-documents.js +1 -1
  55. package/dist/content-layer/plugins/internal/api-functions/server/dispatch.js +1 -1
  56. package/dist/content-layer/plugins/internal/app-data/banner.js +1 -1
  57. package/dist/content-layer/plugins/internal/app-data/index.d.ts +1 -1
  58. package/dist/content-layer/plugins/internal/app-data/index.js +1 -1
  59. package/dist/content-layer/plugins/internal/catalog-classic/index.js +1 -1
  60. package/dist/content-layer/plugins/internal/catalog-classic/resolve-items.js +1 -1
  61. package/dist/content-layer/plugins/internal/l10n/translations-loader.js +1 -1
  62. package/dist/content-layer/plugins/internal/markdoc/index.js +1 -1
  63. package/dist/content-layer/plugins/internal/mcp/server/agent-card.js +1 -1
  64. package/dist/content-layer/plugins/internal/mcp/server/auth.js +1 -1
  65. package/dist/content-layer/plugins/internal/mcp/server/custom-tools.js +1 -1
  66. package/dist/content-layer/plugins/internal/mcp/server/handler.js +1 -1
  67. package/dist/content-layer/plugins/internal/mcp/server/mcp-telemetry.js +1 -1
  68. package/dist/content-layer/plugins/internal/mcp/server/oauth/authorize.js +1 -1
  69. package/dist/content-layer/plugins/internal/mcp/server/oauth/callback.js +1 -1
  70. package/dist/content-layer/plugins/internal/mcp/server/oauth/discovery.js +1 -1
  71. package/dist/content-layer/plugins/internal/mcp/server/oauth/token.js +1 -1
  72. package/dist/content-layer/plugins/internal/mcp/server/oauth/tokens.js +1 -1
  73. package/dist/content-layer/plugins/internal/mcp/server/server-card.js +1 -1
  74. package/dist/content-layer/plugins/internal/mcp/server/skills-resources.js +1 -1
  75. package/dist/content-layer/plugins/internal/sidebar/bundle.d.ts +15 -15
  76. package/dist/content-layer/plugins/internal/sidebar/bundle.js +1 -1
  77. package/dist/content-layer/plugins/internal/sidebar/index.d.ts +1 -1
  78. package/dist/content-layer/plugins/internal/sidebar/index.js +2 -2
  79. package/dist/content-layer/plugins/internal/skills/server/routes.js +1 -1
  80. package/dist/content-layer/plugins/internal/versions/index.js +1 -1
  81. package/dist/content-layer/plugins/project/load.js +2 -2
  82. package/dist/content-layer/plugins/utils/link-access.d.ts +2 -0
  83. package/dist/content-layer/plugins/utils/link-access.js +1 -1
  84. package/dist/content-layer/problems/codes.js +1 -1
  85. package/dist/content-layer/search/postings/postings-store.js +1 -1
  86. package/dist/content-layer/server/database.js +1 -1
  87. package/dist/content-layer/static/registry.js +1 -1
  88. package/dist/server/app.js +2 -2
  89. package/dist/server/ask-ai/route.js +1 -1
  90. package/dist/server/auth/middleware.js +1 -1
  91. package/dist/server/auth/routes.js +1 -1
  92. package/dist/server/content.js +9 -9
  93. package/dist/server/lambda-entry.js +1 -1
  94. package/dist/server/node-entry.js +1 -1
  95. package/dist/server/page-handlers.js +2 -2
  96. package/dist/server/search/route.js +1 -1
  97. package/dist/server/seo-tags.js +2 -2
  98. package/dist/server/static-files/serve.js +1 -1
  99. package/dist/server/subprocess/child-entry.js +1 -1
  100. package/dist/server/subprocess/host.js +1 -1
  101. package/dist/shared/constants/l10n/langs/ar.js +1 -1
  102. package/dist/shared/constants/l10n/langs/de.js +1 -1
  103. package/dist/shared/constants/l10n/langs/en.js +1 -1
  104. package/dist/shared/constants/l10n/langs/es.js +1 -1
  105. package/dist/shared/constants/l10n/langs/fr.js +1 -1
  106. package/dist/shared/constants/l10n/langs/hi.js +1 -1
  107. package/dist/shared/constants/l10n/langs/it.js +1 -1
  108. package/dist/shared/constants/l10n/langs/ja.js +1 -1
  109. package/dist/shared/constants/l10n/langs/ko.js +1 -1
  110. package/dist/shared/constants/l10n/langs/pl.js +1 -1
  111. package/dist/shared/constants/l10n/langs/pt-br.js +1 -1
  112. package/dist/shared/constants/l10n/langs/pt.js +1 -1
  113. package/dist/shared/constants/l10n/langs/ru.js +1 -1
  114. package/dist/shared/constants/l10n/langs/uk.js +1 -1
  115. package/dist/shared/constants/l10n/langs/zh.js +1 -1
  116. package/dist/shared/constants/versions.d.ts +2 -0
  117. package/dist/shared/constants/versions.js +1 -1
  118. package/dist/shared/rbac/api-docs.js +1 -1
  119. package/dist/shared/rbac/l10n-rules.js +1 -1
  120. package/dist/shared/rbac/team-templates.js +1 -1
  121. package/dist/shared/utils/l10n.js +1 -1
  122. package/package.json +8 -8
@@ -1 +1 @@
1
- import{L10N_DIR as e}from"../../../../shared/constants/l10n/defaults.js";import{delocalizeL10nPath as t,l10nDirOf as n}from"../../../../shared/utils/l10n.js";import{markdocErrorResult as r,replaceWithMarkdocError as i}from"../../tags/markdoc-error.js";import{PARTIAL_L10N_ATTRIBUTE as a}from"../../tags/partial.js";import{shiftRange as o}from"../../../../shared/utils/shift-range.js";import{inlinedLinkRefs as s}from"../../../link-checker/node-ref.js";import{resolveResolverTarget as c}from"./context-paths.js";import{getPartialsFolders as l,isPartialPath as u}from"../../utils/partials.js";import{FRONTMATTER_BLOCK_RE as d,computeFrontmatterLineOffset as f}from"../../utils/frontmatter-offset.js";import{substituteStaticVariables as p}from"../../utils/substitute-variables.js";import{resolveMarkdocBuildTimeAttributes as m}from"../markdoc.js";import{join as h}from"node:path";async function g(o){let{node:s,attributeName:d}=o,f=s.attributes[d];if(typeof f!=`string`||f===``||o.io===void 0)return null;let p=c(o,f);if(p===null)return null;if(!u(p.contentPath,o.config)){let e=`Partial ${p.contentPath} must live in a partials folder (markdown.partialsFolders: ${l(o.config).join(`, `)})`;return r(s,e,o.sourceFilePath)}let m=n(o.sourceFilePath),g=[],v=m!==void 0&&n(p.contentPath)===void 0?`${e}/${m}/${p.contentPath}`:p.contentPath;if(!await o.io.exists(h(o.contentDir,v))){g.push({kind:`file`,path:v});let e=t(v);if(e!==void 0&&g.push({kind:`file`,path:e}),e===void 0||!await o.io.exists(h(o.contentDir,e))){let e=`Partial file ${p.contentPath} does not exist`;return r(s,e,o.sourceFilePath,g)}v=e}let y=o.partialChain??[o.sourceFilePath];if(y.includes(v))return i(s,`Circular partial inclusion: ${[...y,v].join(` -> `)}`),{entityDeps:[{kind:`file`,path:v}]};let b=await o.io.readFile(h(o.contentDir,v)),x=await _(o,v,b,y);s.children=x.ast.children;let S=[{entityDeps:g},x.result];if(m===void 0&&n(p.contentPath)===void 0){let t={},r=n(o.file.path);for(let n of o.markdown.contentLocales){let i=`${e}/${n}/${o.file.path}`;if(r===void 0&&S.push({entityDeps:[{kind:`file`,path:i}]}),r===void 0?o.markdown.hasPageRoute(i):n!==r)continue;let a=`${e}/${n}/${p.contentPath}`,s=h(o.contentDir,a);if(!await o.io.exists(s)){S.push({entityDeps:[{kind:`file`,path:a}]});continue}let c=await _(o,a,await o.io.readFile(s),y);t[n]=c.ast,S.push(c.result)}Object.keys(t).length>0&&(s.attributes[a]=t)}return{entityDeps:S.flatMap(e=>e.entityDeps??[]),assetUsages:S.flatMap(e=>e.assetUsages??[]),linkRefs:S.flatMap(e=>e.linkRefs??[]),problems:S.flatMap(e=>e.problems??[])}}async function _(e,t,n,r){let i=n.replace(d,``),a=structuredClone(e.markdown.parseCached(i)),o=await m(a,{tags:e.tags,sourceFilePath:t,resolverContext:{config:e.config,contentDir:e.contentDir,entities:e.entities,file:e.file,io:e.io,logger:e.logger,markdown:e.markdown,plugin:e.plugin},partialChain:[...r,t],source:i}),c=e.node.attributes.variables;typeof c==`object`&&c&&!Array.isArray(c)&&p(a,c);let l=f(n);return{ast:a,result:{entityDeps:[{kind:`file`,path:t},...o.entityDeps],assetUsages:o.assetUsages,linkRefs:s(o.linkRefs,t,l),problems:o.problems.map(e=>v(e,l))}}}function v(e,t){if(t===0||e.location?.range===void 0)return e;let n={...e.location,range:o(e.location.range,t)};return{...e,location:n}}export{g as resolvePartialFileAttribute};
1
+ import{markdocErrorResult as e,replaceWithMarkdocError as t}from"../../tags/markdoc-error.js";import{PARTIAL_L10N_ATTRIBUTE as n}from"../../tags/partial.js";import{L10N_DIR as r}from"../../../../shared/constants/l10n/defaults.js";import{delocalizeL10nPath as i,l10nDirOf as a}from"../../../../shared/utils/l10n.js";import{shiftRange as o}from"../../../../shared/utils/shift-range.js";import{inlinedLinkRefs as s}from"../../../link-checker/node-ref.js";import{resolveResolverTarget as c}from"./context-paths.js";import{getPartialsFolders as l,isPartialPath as u}from"../../utils/partials.js";import{FRONTMATTER_BLOCK_RE as d,computeFrontmatterLineOffset as f}from"../../utils/frontmatter-offset.js";import{substituteStaticVariables as p}from"../../utils/substitute-variables.js";import{resolveMarkdocBuildTimeAttributes as m}from"../markdoc.js";import{join as h}from"node:path";async function g(o){let{node:s,attributeName:d}=o,f=s.attributes[d];if(typeof f!=`string`||f===``||o.io===void 0)return null;let p=c(o,f);if(p===null)return null;if(!u(p.contentPath,o.config)){let t=`Partial ${p.contentPath} must live in a partials folder (markdown.partialsFolders: ${l(o.config).join(`, `)})`;return e(s,t,o.sourceFilePath)}let m=a(o.sourceFilePath),g=[],v=m!==void 0&&a(p.contentPath)===void 0?`${r}/${m}/${p.contentPath}`:p.contentPath;if(!await o.io.exists(h(o.contentDir,v))){g.push({kind:`file`,path:v});let t=i(v);if(t!==void 0&&g.push({kind:`file`,path:t}),t===void 0||!await o.io.exists(h(o.contentDir,t))){let t=`Partial file ${p.contentPath} does not exist`;return e(s,t,o.sourceFilePath,g)}v=t}let y=o.partialChain??[o.sourceFilePath];if(y.includes(v))return t(s,`Circular partial inclusion: ${[...y,v].join(` -> `)}`),{entityDeps:[{kind:`file`,path:v}]};let b=await o.io.readFile(h(o.contentDir,v)),x=await _(o,v,b,y);s.children=x.ast.children;let S=[{entityDeps:g},x.result];if(m===void 0&&a(p.contentPath)===void 0){let e={},t=a(o.file.path);for(let n of o.markdown.contentLocales){let i=`${r}/${n}/${o.file.path}`;if(t===void 0&&S.push({entityDeps:[{kind:`file`,path:i}]}),t===void 0?o.markdown.hasPageRoute(i):n!==t)continue;let a=`${r}/${n}/${p.contentPath}`,s=h(o.contentDir,a);if(!await o.io.exists(s)){S.push({entityDeps:[{kind:`file`,path:a}]});continue}let c=await _(o,a,await o.io.readFile(s),y);e[n]=c.ast,S.push(c.result)}Object.keys(e).length>0&&(s.attributes[n]=e)}return{entityDeps:S.flatMap(e=>e.entityDeps??[]),assetUsages:S.flatMap(e=>e.assetUsages??[]),linkRefs:S.flatMap(e=>e.linkRefs??[]),problems:S.flatMap(e=>e.problems??[])}}async function _(e,t,n,r){let i=n.replace(d,``),a=structuredClone(e.markdown.parseCached(i)),o=await m(a,{tags:e.tags,sourceFilePath:t,resolverContext:{config:e.config,contentDir:e.contentDir,entities:e.entities,file:e.file,io:e.io,logger:e.logger,markdown:e.markdown,plugin:e.plugin},partialChain:[...r,t],source:i}),c=e.node.attributes.variables;typeof c==`object`&&c&&!Array.isArray(c)&&p(a,c);let l=f(n);return{ast:a,result:{entityDeps:[{kind:`file`,path:t},...o.entityDeps],assetUsages:o.assetUsages,linkRefs:s(o.linkRefs,t,l),problems:o.problems.map(e=>v(e,l))}}}function v(e,t){if(t===0||e.location?.range===void 0)return e;let n={...e.location,range:o(e.location.range,t)};return{...e,location:n}}export{g as resolvePartialFileAttribute};
@@ -1 +1 @@
1
- import{delocalizeL10nPath as e}from"../../../../shared/utils/l10n.js";import{markdocErrorResult as t}from"../../tags/markdoc-error.js";import{resolveResolverTarget as n}from"./context-paths.js";import{prefixSvgIds as r}from"../../utils/prefix-svg-ids.js";async function i(i,a={}){let{node:o,attributeName:s}=i,c=o.attributes[s];if(typeof c!=`string`||c===``||i.io===void 0)return null;let l=n(i,c);if(l===null)return null;let u=[{kind:`file`,path:l.contentPath}],d=l;if(!await i.io.exists(l.absolutePath)){let r=e(i.sourceFilePath);if(d=r===void 0?null:n({...i,sourceFilePath:r},c),d===null||!await i.io.exists(d.absolutePath)){if(a.optional)return null;let e=`SVG file ${l.contentPath} does not exist`;return t(o,e,i.sourceFilePath,u)}u.push({kind:`file`,path:d.contentPath})}let f=await i.io.readFile(d.absolutePath),p=d.contentPath.replace(/[^a-zA-Z0-9_-]/g,`-`);return o.attributes[`${s}RawContent`]=r(f,p),{entityDeps:u}}export{i as resolveSvgContentAttribute};
1
+ import{markdocErrorResult as e}from"../../tags/markdoc-error.js";import{delocalizeL10nPath as t}from"../../../../shared/utils/l10n.js";import{resolveResolverTarget as n}from"./context-paths.js";import{prefixSvgIds as r}from"../../utils/prefix-svg-ids.js";async function i(i,a={}){let{node:o,attributeName:s}=i,c=o.attributes[s];if(typeof c!=`string`||c===``||i.io===void 0)return null;let l=n(i,c);if(l===null)return null;let u=[{kind:`file`,path:l.contentPath}],d=l;if(!await i.io.exists(l.absolutePath)){let r=t(i.sourceFilePath);if(d=r===void 0?null:n({...i,sourceFilePath:r},c),d===null||!await i.io.exists(d.absolutePath)){if(a.optional)return null;let t=`SVG file ${l.contentPath} does not exist`;return e(o,t,i.sourceFilePath,u)}u.push({kind:`file`,path:d.contentPath})}let f=await i.io.readFile(d.absolutePath),p=d.contentPath.replace(/[^a-zA-Z0-9_-]/g,`-`);return o.attributes[`${s}RawContent`]=r(f,p),{entityDeps:u}}export{i as resolveSvgContentAttribute};
@@ -1 +1 @@
1
- import{markdocErrorResult as e,replaceWithMarkdocError as t}from"../tags/markdoc-error.js";import{walkMarkdocAst as n}from"../utils/walk-markdoc-ast.js";import{getExampleContent as r,walkWithExampleContent as i}from"../utils/reparse-example-fences.js";import{isLocalReference as a}from"./references.js";import{resolveLinkAttribute as o}from"./markdoc-resolvers/link.js";import{resolveIconAttribute as s,resolveImageAttribute as c,resolveImageSrcSetAttribute as l}from"./markdoc-resolvers/image.js";import{resolveCodeSnippetFileAttribute as u}from"./markdoc-resolvers/code-snippet.js";import{resolveSvgContentAttribute as d}from"./markdoc-resolvers/svg-content.js";import{resolveTagRawContentAttribute as f}from"./markdoc-resolvers/tag-raw-content.js";import{resolveHtmlAttrsAttribute as p}from"./markdoc-resolvers/html-attrs.js";import{resolveImageGalleryAttribute as m}from"./markdoc-resolvers/image-gallery.js";import{resolveCodeWalkthroughFilesetsAttribute as h}from"./markdoc-resolvers/code-walkthrough/filesets.js";import{resolvePartialFileAttribute as g}from"./markdoc-resolvers/partial.js";import{resolveDiagramFileAttribute as _}from"./markdoc-resolvers/diagram-file.js";import{resolveParsedYamlAttribute as v,resolveRawContentAttribute as y,resolveRelativePathAttribute as b}from"./markdoc-resolvers/file-reference.js";import{resolveJsonExampleRefAttribute as x,resolveJsonSchemaRefAttribute as S,resolveSampleFromJsonSchemaAttribute as C}from"./markdoc-resolvers/json-schema.js";import{resolveOpenapiCodeSamplePanelAttribute as w,resolveOpenapiCodeSamplesAttribute as T,resolveOpenapiExampleAttribute as E,resolveOpenapiReplayAttribute as D,resolveOpenapiResponsePanelAttribute as O,resolveOpenapiResponseSamplesAttribute as k}from"./markdoc-resolvers/operation-samples.js";import{getAttributeBuildTimeResolver as A}from"./attribute-resolver-key.js";import{PROMPT_TAG as j}from"@redocly/theme/core/constants";import{convertGithubAlertToAdmonition as M}from"@redocly/theme/markdoc/tags/admonition";async function N(e,a){let o=a.tags??{},s=F,c={entityDeps:[],assetUsages:[],linkRefs:[],problems:[]},l=a.resolverContext?.markdown?.disabledTags,u=R(a.source),d=[...n(e,{skipChildren:z})],f=d.flatMap(e=>{let t=r(e);return t?[...i(t,z)]:[]});for(let e of[...d,...f])M(e);let p=f.filter(e=>e.type===`tag`);for(let e of[...d,...p])if(e.type===`link`)await L(s.nativeMdLink,e,`href`,a,c,u);else if(e.type===`image`)await L(s.imageSrc,e,`src`,a,c,u);else if(e.type===`tag`){if(typeof e.tag==`string`&&l?.has(e.tag)){t(e,`The "${e.tag}" tag is not available here.`);continue}let n=typeof e.tag==`string`?o[e.tag]:void 0;for(let[t,r]of Object.entries(n?.attributes??{})){let n=A(r);if(!n)continue;let i=s[n];i&&await L(i,e,t,a,c,u)}}return c}const P=({attributeName:e,markdown:t,node:n,partialChain:r,sourceFilePath:i})=>o(n,e,i,t,r?.[0]),F={imageSrc({attributeName:e,markdown:t,node:n,sourceFilePath:r}){return c(n,e,r,t)},imageSrcSet({attributeName:e,markdown:t,node:n,sourceFilePath:r}){return l(n,e,r,t)},link:P,nativeMdLink:P,async relativeOrCdnIcon(e){let{attributeName:t,markdown:n,node:r,sourceFilePath:i}=e,a=r.attributes[t];return typeof a==`string`&&B(a)&&await d(e,{optional:!0}),s(r,t,i,n)},codeSnippetFile:u,diagramFile:_,svgContent:d,tagRawContent:f,htmlAttrs:p,imageGallery:m,codeWalkthroughFilesets:h,partialFile:g,jsonSchemaRef:S,sampleFromJsonSchema:C,jsonExampleRef:x,openapiCodeSamples:T,openapiCodeSamplePanel:w,openapiReplay:D,openapiResponseSamples:k,openapiResponsePanel:O,openapiExample:E,rawContent:y,parsedYaml:v,relativePath:b};function I(e){let t=/* @__PURE__ */ new Set;for(let n of i(e))n.type===`tag`&&typeof n.tag==`string`&&t.add(n.tag);return[...t].sort()}async function L(t,n,r,i,a,o){let s;try{s=await t({...i.resolverContext,attributeName:r,node:n,sourceFilePath:i.sourceFilePath,tags:i.tags,partialChain:i.partialChain,readSourceLines:o})}catch(t){let r=t instanceof Error?t.message:String(t);s=e(n,r,i.sourceFilePath)}s&&(s.entityDeps&&a.entityDeps.push(...s.entityDeps),s.assetUsages&&a.assetUsages.push(...s.assetUsages),s.linkRefs&&a.linkRefs.push(...s.linkRefs),s.problems&&a.problems.push(...s.problems))}function R(e){let t;return()=>(t??=e.split(/\r?\n/),t)}function z(e){return e.type===`tag`&&e.tag===j}function B(e){let t=(e.split(`#`,1)[0]??e).split(`?`,1)[0]??e;return/\.svg$/i.test(t)&&a(e)}export{F as builtInMarkdocAttributeResolvers,I as collectMarkdocTagNames,z as isPromptTag,N as resolveMarkdocBuildTimeAttributes};
1
+ import{markdocErrorResult as e,replaceWithMarkdocError as t}from"../tags/markdoc-error.js";import{walkMarkdocAst as n}from"../utils/walk-markdoc-ast.js";import{getExampleContent as r,walkWithExampleContent as i}from"../utils/reparse-example-fences.js";import{isLocalReference as a}from"./references.js";import{resolveLinkAttribute as o}from"./markdoc-resolvers/link.js";import{resolveIconAttribute as s,resolveImageAttribute as c,resolveImageSrcSetAttribute as l}from"./markdoc-resolvers/image.js";import{resolveCodeSnippetFileAttribute as u}from"./markdoc-resolvers/code-snippet.js";import{resolveSvgContentAttribute as d}from"./markdoc-resolvers/svg-content.js";import{resolveTagRawContentAttribute as f}from"./markdoc-resolvers/tag-raw-content.js";import{resolveHtmlAttrsAttribute as p}from"./markdoc-resolvers/html-attrs.js";import{resolveImageGalleryAttribute as m}from"./markdoc-resolvers/image-gallery.js";import{resolveCodeWalkthroughFilesetsAttribute as h}from"./markdoc-resolvers/code-walkthrough/filesets.js";import{resolvePartialFileAttribute as g}from"./markdoc-resolvers/partial.js";import{resolveDiagramFileAttribute as _}from"./markdoc-resolvers/diagram-file.js";import{resolveParsedYamlAttribute as v,resolveRawContentAttribute as y,resolveRelativePathAttribute as b}from"./markdoc-resolvers/file-reference.js";import{resolveJsonExampleRefAttribute as x,resolveJsonSchemaRefAttribute as S,resolveSampleFromJsonSchemaAttribute as C}from"./markdoc-resolvers/json-schema.js";import{resolveOpenapiCodeSamplePanelAttribute as w,resolveOpenapiCodeSamplesAttribute as T,resolveOpenapiExampleAttribute as E,resolveOpenapiReplayAttribute as D,resolveOpenapiResponsePanelAttribute as O,resolveOpenapiResponseSamplesAttribute as k}from"./markdoc-resolvers/operation-samples.js";import{getAttributeBuildTimeResolver as A}from"./attribute-resolver-key.js";import{convertGithubAlertToAdmonition as j}from"@redocly/theme/markdoc/tags/admonition";import{PROMPT_TAG as M}from"@redocly/theme/core/constants";async function N(e,a){let o=a.tags??{},s=F,c={entityDeps:[],assetUsages:[],linkRefs:[],problems:[]},l=a.resolverContext?.markdown?.disabledTags,u=R(a.source),d=[...n(e,{skipChildren:z})],f=d.flatMap(e=>{let t=r(e);return t?[...i(t,z)]:[]});for(let e of[...d,...f])j(e);let p=f.filter(e=>e.type===`tag`);for(let e of[...d,...p])if(e.type===`link`)await L(s.nativeMdLink,e,`href`,a,c,u);else if(e.type===`image`)await L(s.imageSrc,e,`src`,a,c,u);else if(e.type===`tag`){if(typeof e.tag==`string`&&l?.has(e.tag)){t(e,`The "${e.tag}" tag is not available here.`);continue}let n=typeof e.tag==`string`?o[e.tag]:void 0;for(let[t,r]of Object.entries(n?.attributes??{})){let n=A(r);if(!n)continue;let i=s[n];i&&await L(i,e,t,a,c,u)}}return c}const P=({attributeName:e,markdown:t,node:n,partialChain:r,sourceFilePath:i})=>o(n,e,i,t,r?.[0]),F={imageSrc({attributeName:e,markdown:t,node:n,sourceFilePath:r}){return c(n,e,r,t)},imageSrcSet({attributeName:e,markdown:t,node:n,sourceFilePath:r}){return l(n,e,r,t)},link:P,nativeMdLink:P,async relativeOrCdnIcon(e){let{attributeName:t,markdown:n,node:r,sourceFilePath:i}=e,a=r.attributes[t];return typeof a==`string`&&B(a)&&await d(e,{optional:!0}),s(r,t,i,n)},codeSnippetFile:u,diagramFile:_,svgContent:d,tagRawContent:f,htmlAttrs:p,imageGallery:m,codeWalkthroughFilesets:h,partialFile:g,jsonSchemaRef:S,sampleFromJsonSchema:C,jsonExampleRef:x,openapiCodeSamples:T,openapiCodeSamplePanel:w,openapiReplay:D,openapiResponseSamples:k,openapiResponsePanel:O,openapiExample:E,rawContent:y,parsedYaml:v,relativePath:b};function I(e){let t=/* @__PURE__ */ new Set;for(let n of i(e))n.type===`tag`&&typeof n.tag==`string`&&t.add(n.tag);return[...t].sort()}async function L(t,n,r,i,a,o){let s;try{s=await t({...i.resolverContext,attributeName:r,node:n,sourceFilePath:i.sourceFilePath,tags:i.tags,partialChain:i.partialChain,readSourceLines:o})}catch(t){let r=t instanceof Error?t.message:String(t);s=e(n,r,i.sourceFilePath)}s&&(s.entityDeps&&a.entityDeps.push(...s.entityDeps),s.assetUsages&&a.assetUsages.push(...s.assetUsages),s.linkRefs&&a.linkRefs.push(...s.linkRefs),s.problems&&a.problems.push(...s.problems))}function R(e){let t;return()=>(t??=e.split(/\r?\n/),t)}function z(e){return e.type===`tag`&&e.tag===M}function B(e){let t=(e.split(`#`,1)[0]??e).split(`?`,1)[0]??e;return/\.svg$/i.test(t)&&a(e)}export{F as builtInMarkdocAttributeResolvers,I as collectMarkdocTagNames,z as isPromptTag,N as resolveMarkdocBuildTimeAttributes};
@@ -1,4 +1,4 @@
1
- import type { ContentStateView } from '../../database/types/content-state.js';
1
+ import type { ContentStateRouteInfo, ContentStateView } from '../../database/types/content-state.js';
2
2
  import type { EntityInvalidationDep } from '../../plugins/types/plugin.js';
3
3
  import type { AssetUsage } from '../types/asset-usage.js';
4
4
  import type { AudienceTagResolver } from './audience-tag.js';
@@ -36,6 +36,8 @@ export type ResolveImageSrcSetResult = {
36
36
  entityDeps: EntityInvalidationDep[];
37
37
  assetUsages: AssetUsage[];
38
38
  };
39
+ /** The route that serves `slug`: its own, else the nearest wildcard route above it. */
40
+ export declare function findServingRoute(state: ContentStateView, slug: string): ContentStateRouteInfo | undefined;
39
41
  export declare function resolveLocalReference(rawHref: string, sourceFilePath: string, state: ContentStateView, resolveAudienceTag?: AudienceTagResolver, contentLocales?: readonly string[], includingPagePath?: string): Promise<ReferenceResolution>;
40
42
  export declare function resolveImageReference(rawSrc: string, sourceFilePath: string, state: ContentStateView, resolveAudienceTag?: AudienceTagResolver, contentLocales?: readonly string[]): Promise<ReferenceResolution>;
41
43
  export declare function resolveImageSrcSet(rawSrcSet: string, sourceFilePath: string, state: ContentStateView, resolveAudienceTag?: AudienceTagResolver, contentLocales?: readonly string[]): Promise<ResolveImageSrcSetResult>;
@@ -1 +1 @@
1
- import{buildContentAssetUrl as e}from"../../plugins/internal/assets/url.js";import{L10N_DIR as t}from"../../../shared/constants/l10n/defaults.js";import{delocalizeL10nPath as n,l10nDirOf as r,toLocaleSlug as i}from"../../../shared/utils/l10n.js";import{resolveContentPath as a}from"../../../shared/utils/resolve-content-path.js";import{computePathPrefixes as o}from"../../../shared/utils/routes/compute-path-prefixes.js";import{IMAGE_EXTENSIONS as s}from"../../plugins/internal/assets/extensions.js";import{isRouteSlugTarget as c}from"../../../shared/utils/routes/is-route-slug-target.js";import{safeDecodeURI as l}from"../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as u,parseSrcSet as d}from"../../plugins/internal/assets/srcset.js";import{isIndexPagePath as f,resolveRelativeSlug as p}from"../../../shared/utils/routes/resolve-relative-slug.js";import{posix as m}from"node:path";const h=/[[\]()*_`#!|<>~]|\{%|\n[ \t\r]*\n|^\s{0,3}([-+*]\s|\d+\.\s|>|-{3,}|={2,})/m;function g(e){return h.test(e)}function _(e){return e.startsWith(`#`)||e.startsWith(`//`)||/^[a-z][a-z0-9+.-]*:/i.test(e)?!1:!e.startsWith(`/`)||!c(y(e).path)}function v(e){let t=e.indexOf(`?`);return t===-1?[e,``]:[e.slice(0,t),e.slice(t)]}function y(e){let t=e.indexOf(`#`);return t===-1?{path:e,hash:``}:{path:e.slice(0,t),hash:e.slice(t)}}async function b(e,t){let r=await t(e);if(r)return r;let i=n(e);if(i!==void 0){let n=await t(i);if(n){let t=e.slice(0,e.length-i.length),r=n.entityDeps.filter(e=>e.kind===`file`).map(e=>({kind:`file`,path:`${t}${e.path}`}));return{...n,entityDeps:[...r,...n.entityDeps]}}}return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]}}async function x(e,t){let i=n(e),a=r(e);if(i===void 0||a===void 0)return null;let o=await t(i,a);return o===null?null:{...o,entityDeps:[{kind:`file`,path:e},...o.entityDeps]}}async function S(n,r,i,a,o){let[s]=n.assetUsages;if(!s||!a?.length||n.result.kind!==`assetRef`||r.startsWith(`@l10n/`))return n;let c=e(s.path,s.hash,s.tag),l=[];for(let e of a){let n=`${t}/${e}/${s.path}`,r=i.filesByPath.get(n);if(!r)continue;let a=await o?.(n)??null;l.push({path:n,hash:r.hash,kind:s.kind,tag:a,l10n:{locale:e,canonicalUrl:c}})}return l.length===0?n:{...n,assetUsages:[s,...l]}}function C(e,t){let n=e.routeBySlug.get(t);return n===void 0?o(t).reverse().map(t=>e.routeBySlug.get(t)).find(e=>e?.wildcardPrefix===!0):n}async function w(t,n,r,o,c,u){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:d,hash:h}=y(t),g=async(t,n)=>{let a=r.primaryRouteByFilePath.get(t);if(a!==void 0)return{result:{kind:`pageUrl`,url:`${n===void 0?a:i(a,n)}${h}`},entityDeps:[{kind:`file`,path:t}],assetUsages:[]};let c=r.filesByPath.get(t);if(c){let n=m.extname(t).toLowerCase(),r=s.has(n)?`image`:`file`,i=await o?.(t)??null;return{result:{kind:`assetRef`,url:`${e(t,c.hash,i)}${h}`,path:t,hash:c.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:c.hash,kind:r,tag:i}]}}return null};return S(await b(n,async e=>{let t=a(l(d),e);if(t===null)return null;let n=await g(t)??await x(t,g);if(n!==null)return n;let[i=``,o=``]=v(d);if(!d.startsWith(`/`)&&m.extname(i)===``){let t=u??e,n=r.primaryRouteByFilePath.get(t),a=n===void 0?m.extname(t).toLowerCase()===`.md`?void 0:p(i,`/${t}`,!1):p(i,n,f(t)),s=a===void 0?void 0:C(r,a);if(a!==void 0&&s!==void 0)return{result:{kind:`pageUrl`,url:`${a}${o}${h}`},entityDeps:s.originFilePath===null?[]:[{kind:`file`,path:s.originFilePath}],assetUsages:[]}}return null}),n,r,c,o)}async function T(t,n,r,i,o){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:s}=y(t),c=async t=>{let n=r.filesByPath.get(t);if(!n)return null;let a=await i?.(t)??null;return{result:{kind:`assetRef`,url:e(t,n.hash,a),path:t,hash:n.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:n.hash,kind:`image`,tag:a}]}};return S(await b(n,async e=>{let t=a(l(s),e);return t===null?null:await c(t)??await x(t,c)}),n,r,o,i)}async function E(e,t,n,r,i){let a=[],o=[],s=d(e);if(!s||s.length===0)return{value:e,entityDeps:a,assetUsages:o};let c=await Promise.all(s.map(async e=>{let s=await T(e.src,t,n,r,i);return s.result.kind===`assetRef`&&(a.push(...s.entityDeps),o.push(...s.assetUsages),e.src=s.result.url),e}));return{value:u(c),entityDeps:a,assetUsages:o}}export{_ as isLocalReference,g as looksLikeMarkdown,T as resolveImageReference,E as resolveImageSrcSet,w as resolveLocalReference,y as splitHash};
1
+ import{buildContentAssetUrl as e}from"../../plugins/internal/assets/url.js";import{L10N_DIR as t}from"../../../shared/constants/l10n/defaults.js";import{delocalizeL10nPath as n,l10nDirOf as r,toLocaleSlug as i}from"../../../shared/utils/l10n.js";import{resolveContentPath as a}from"../../../shared/utils/resolve-content-path.js";import{computePathPrefixes as o}from"../../../shared/utils/routes/compute-path-prefixes.js";import{IMAGE_EXTENSIONS as s}from"../../plugins/internal/assets/extensions.js";import{isRouteSlugTarget as c}from"../../../shared/utils/routes/is-route-slug-target.js";import{safeDecodeURI as l}from"../../../shared/utils/safe-decode-uri.js";import{joinSrcSet as u,parseSrcSet as d}from"../../plugins/internal/assets/srcset.js";import{isIndexPagePath as f,resolveRelativeSlug as p}from"../../../shared/utils/routes/resolve-relative-slug.js";import{posix as m}from"node:path";const h=/[[\]()*_`#!|<>~]|\{%|\n[ \t\r]*\n|^\s{0,3}([-+*]\s|\d+\.\s|>|-{3,}|={2,})/m;function g(e){return h.test(e)}function _(e){return e.startsWith(`#`)||e.startsWith(`//`)||/^[a-z][a-z0-9+.-]*:/i.test(e)?!1:!e.startsWith(`/`)||!c(y(e).path)}function v(e){let t=e.indexOf(`?`);return t===-1?[e,``]:[e.slice(0,t),e.slice(t)]}function y(e){let t=e.indexOf(`#`);return t===-1?{path:e,hash:``}:{path:e.slice(0,t),hash:e.slice(t)}}async function b(e,t){let r=await t(e);if(r)return r;let i=n(e);if(i!==void 0){let n=await t(i);if(n){let t=e.slice(0,e.length-i.length),r=n.entityDeps.filter(e=>e.kind===`file`).map(e=>({kind:`file`,path:`${t}${e.path}`}));return{...n,entityDeps:[...r,...n.entityDeps]}}}return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]}}async function x(e,t){let i=n(e),a=r(e);if(i===void 0||a===void 0)return null;let o=await t(i,a);return o===null?null:{...o,entityDeps:[{kind:`file`,path:e},...o.entityDeps]}}async function S(n,r,i,a,o){let[s]=n.assetUsages;if(!s||!a?.length||n.result.kind!==`assetRef`||r.startsWith(`@l10n/`))return n;let c=e(s.path,s.hash,s.tag),l=[];for(let e of a){let n=`${t}/${e}/${s.path}`,r=i.filesByPath.get(n);if(!r)continue;let a=await o?.(n)??null;l.push({path:n,hash:r.hash,kind:s.kind,tag:a,l10n:{locale:e,canonicalUrl:c}})}return l.length===0?n:{...n,assetUsages:[s,...l]}}function C(e,t){let n=e.routeBySlug.get(t);return n===void 0?o(t).reverse().map(t=>e.routeBySlug.get(t)).find(e=>e?.wildcardPrefix===!0):n}async function w(t,n,r,o,c,u){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:d,hash:h}=y(t),g=async(t,n)=>{let a=r.primaryRouteByFilePath.get(t);if(a!==void 0)return{result:{kind:`pageUrl`,url:`${n===void 0?a:i(a,n)}${h}`},entityDeps:[{kind:`file`,path:t}],assetUsages:[]};let c=r.filesByPath.get(t);if(c){let n=m.extname(t).toLowerCase(),r=s.has(n)?`image`:`file`,i=await o?.(t)??null;return{result:{kind:`assetRef`,url:`${e(t,c.hash,i)}${h}`,path:t,hash:c.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:c.hash,kind:r,tag:i}]}}return null};return S(await b(n,async e=>{let t=a(l(d),e);if(t===null)return null;let n=await g(t)??await x(t,g);if(n!==null)return n;let[i=``,o=``]=v(d);if(!d.startsWith(`/`)&&m.extname(i)===``){let t=u??e,n=r.primaryRouteByFilePath.get(t),a=n===void 0?m.extname(t).toLowerCase()===`.md`?void 0:p(i,`/${t}`,!1):p(i,n,f(t)),s=a===void 0?void 0:C(r,a);if(a!==void 0&&s!==void 0)return{result:{kind:`pageUrl`,url:`${a}${o}${h}`},entityDeps:s.originFilePath===null?[]:[{kind:`file`,path:s.originFilePath}],assetUsages:[]}}return null}),n,r,c,o)}async function T(t,n,r,i,o){if(!_(t))return{result:{kind:`passthrough`},entityDeps:[],assetUsages:[]};let{path:s}=y(t),c=async t=>{let n=r.filesByPath.get(t);if(!n)return null;let a=await i?.(t)??null;return{result:{kind:`assetRef`,url:e(t,n.hash,a),path:t,hash:n.hash},entityDeps:[{kind:`file`,path:t}],assetUsages:[{path:t,hash:n.hash,kind:`image`,tag:a}]}};return S(await b(n,async e=>{let t=a(l(s),e);return t===null?null:await c(t)??await x(t,c)}),n,r,o,i)}async function E(e,t,n,r,i){let a=[],o=[],s=d(e);if(!s||s.length===0)return{value:e,entityDeps:a,assetUsages:o};let c=await Promise.all(s.map(async e=>{let s=await T(e.src,t,n,r,i);return s.result.kind===`assetRef`&&(a.push(...s.entityDeps),o.push(...s.assetUsages),e.src=s.result.url),e}));return{value:u(c),entityDeps:a,assetUsages:o}}export{C as findServingRoute,_ as isLocalReference,g as looksLikeMarkdown,T as resolveImageReference,E as resolveImageSrcSet,w as resolveLocalReference,y as splitHash};
@@ -12,8 +12,13 @@ export type MarkdocSearchSection = {
12
12
  */
13
13
  rbacTeams?: string[];
14
14
  };
15
- /** The `docKey` of the section a team-block document belongs to; any other key as is. */
16
- export declare function teamBlockSectionKey(docKey: string): string;
15
+ /**
16
+ * A team block's `docKey` is its section's key, this marker and the block's number. The
17
+ * section's own document is always among the page's documents.
18
+ */
19
+ export declare const TEAM_BLOCK_KEY_MARKER = "-team-";
20
+ /** Whether `docKey` is the key of a team-block document. */
21
+ export declare function isTeamBlockKey(docKey: string): boolean;
17
22
  /**
18
23
  * Splits a stored page AST (plain JSON) into one search section per top-level heading, plus
19
24
  * the page-level section that comes first and carries the text outside any section. A
@@ -1 +1 @@
1
- import{HeadingSlugger as e}from"../utils/heading-slugger.js";import{hidesBodyFromSearch as t,markdocAstToText as n}from"./to-text.js";import{renderedHeadingText as r}from"../utils/heading-text.js";import{isNonControlVariant as i}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as a}from"@redocly/theme/markdoc/tags/visibility";const o=/^(page|section-\d+)-team-\d+$/;function s(e){return o.exec(e)?.[1]??e}function c(t,i,a={}){let o=v(t)&&Array.isArray(t.children)?t.children:[],s=new e,c={title:i,body:[]},u=[],d=c,f=!1,p=[],g=e=>{let t=e.attributes?.id;return typeof t==`string`?t:s.slug(r(e,a))};for(let e of h(o)){if(!v(e)||e.type!==`heading`){d.body.push(e);for(let t of _(e))g(t);continue}let t=r(e,a),n=g(e),o=m(e);if(o===1){!f&&t!==``&&(c.title=t,f=!0),d=c,p.length=0;continue}let s=t||i,l=p.slice(0,o).filter(e=>e!==void 0);p.length=o,p[o]=s;let h={anchor:n,title:s,ancestors:l,body:[]};u.push(h),d=h}let y=e=>n({type:`document`,children:e}),b=(e,t)=>[e,...l(t).map(({teams:t,children:n},r)=>({...e,docKey:`${e.docKey}-team-${r+1}`,text:y(n),rbacTeams:t})).filter(e=>e.text!==``)];return[...b({docKey:`page`,title:c.title,text:y(c.body)},c.body),...u.flatMap((e,t)=>b({docKey:`section-${t+1}`,anchor:e.anchor,title:e.title,text:y(e.body),path:[c.title,...e.ancestors,e.title]},e.body))]}function l(e){let n=[],r=(e,i)=>{if(v(e)&&!t(e)){if(e.type===`tag`&&e.tag===`if`){let t=u(e.attributes?.primary);if(t===void 0)return;let a=i===void 0?t:t.filter(e=>i.includes(e));if(a.length===0)return;let o=e.children??[],s=o.findIndex(e=>v(e)&&e.type===`tag`&&e.tag===`else`),c=s===-1?o:o.slice(0,s);n.push({teams:a,children:c});for(let e of c)r(e,a);return}for(let t of Object.values(e.slots??{}))r(t,i);for(let t of e.children??[])r(t,i)}};for(let t of e)r(t,void 0);return n}function u(e){if(!f(e))return;let t=Object.values(e.parameters??{});if(e.name===`includes`){let e=d(t);return e===void 0?void 0:[e]}if(e.name!==`or`)return;let n=t.map(e=>f(e)&&e.name===`includes`?d(Object.values(e.parameters??{})):void 0).filter(e=>e!==void 0);return n.length===0?void 0:n}function d([e,t]){let n=p(e,`Variable`)?e.path:void 0;return Array.isArray(n)&&n.length===2&&n[0]===`rbac`&&n[1]===`teams`&&typeof t==`string`&&t!==`*`?t:void 0}function f(e){return p(e,`Function`)}function p(e,t){return typeof e==`object`&&!!e&&e.$$mdtype===t}function m(e){let t=e.attributes?.level;return typeof t==`number`?t:2}function*h(e){for(let t of e)v(t)&&t.type===`tag`&&t.tag===`html`&&g(t)?yield*h(t.children??[]):yield t}function g(e){return!_(e).next().done}function*_(e){if(!(!v(e)||a(e)||i(e))){for(let t of e.children??[])v(t)&&t.type===`heading`&&(yield t),yield*_(t);for(let t of Object.values(e.slots??{}))yield*_(t)}}function v(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{c as markdocAstToSearchSections,s as teamBlockSectionKey};
1
+ import{HeadingSlugger as e}from"../utils/heading-slugger.js";import{hidesBodyFromSearch as t,markdocAstToText as n}from"./to-text.js";import{renderedHeadingText as r}from"../utils/heading-text.js";import{isNonControlVariant as i}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as a}from"@redocly/theme/markdoc/tags/visibility";const o=`-team-`,s=RegExp(`^(page|section-\\d+)${o}\\d+$`);function c(e){return s.test(e)}function l(t,i,a={}){let s=y(t)&&Array.isArray(t.children)?t.children:[],c=new e,l={title:i,body:[]},d=[],f=l,p=!1,m=[],_=e=>{let t=e.attributes?.id;return typeof t==`string`?t:c.slug(r(e,a))};for(let e of g(s)){if(!y(e)||e.type!==`heading`){f.body.push(e);for(let t of v(e))_(t);continue}let t=r(e,a),n=_(e),o=h(e);if(o===1){!p&&t!==``&&(l.title=t,p=!0),f=l,m.length=0;continue}let s=t||i,c=m.slice(0,o).filter(e=>e!==void 0);m.length=o,m[o]=s;let u={anchor:n,title:s,ancestors:c,body:[]};d.push(u),f=u}let b=e=>n({type:`document`,children:e}),x=(e,t)=>[e,...u(t).map(({teams:t,children:n},r)=>({...e,docKey:`${e.docKey}${o}${r+1}`,text:b(n),rbacTeams:t})).filter(e=>e.text!==``)];return[...x({docKey:`page`,title:l.title,text:b(l.body)},l.body),...d.flatMap((e,t)=>x({docKey:`section-${t+1}`,anchor:e.anchor,title:e.title,text:b(e.body),path:[l.title,...e.ancestors,e.title]},e.body))]}function u(e){let n=[],r=(e,i)=>{if(y(e)&&!t(e)){if(e.type===`tag`&&e.tag===`if`){let t=d(e.attributes?.primary);if(t===void 0)return;let a=i===void 0?t:t.filter(e=>i.includes(e));if(a.length===0)return;let o=e.children??[],s=o.findIndex(e=>y(e)&&e.type===`tag`&&e.tag===`else`),c=s===-1?o:o.slice(0,s);n.push({teams:a,children:c});for(let e of c)r(e,a);return}for(let t of Object.values(e.slots??{}))r(t,i);for(let t of e.children??[])r(t,i)}};for(let t of e)r(t,void 0);return n}function d(e){if(!p(e))return;let t=Object.values(e.parameters??{});if(e.name===`includes`){let e=f(t);return e===void 0?void 0:[e]}if(e.name!==`or`)return;let n=t.map(e=>p(e)&&e.name===`includes`?f(Object.values(e.parameters??{})):void 0).filter(e=>e!==void 0);return n.length===0?void 0:n}function f([e,t]){let n=m(e,`Variable`)?e.path:void 0;return Array.isArray(n)&&n.length===2&&n[0]===`rbac`&&n[1]===`teams`&&typeof t==`string`&&t!==`*`?t:void 0}function p(e){return m(e,`Function`)}function m(e,t){return typeof e==`object`&&!!e&&e.$$mdtype===t}function h(e){let t=e.attributes?.level;return typeof t==`number`?t:2}function*g(e){for(let t of e)y(t)&&t.type===`tag`&&t.tag===`html`&&_(t)?yield*g(t.children??[]):yield t}function _(e){return!v(e).next().done}function*v(e){if(!(!y(e)||a(e)||i(e))){for(let t of e.children??[])y(t)&&t.type===`heading`&&(yield t),yield*v(t);for(let t of Object.values(e.slots??{}))yield*v(t)}}function y(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{o as TEAM_BLOCK_KEY_MARKER,c as isTeamBlockKey,l as markdocAstToSearchSections};
@@ -1,5 +1,5 @@
1
- import{PROMPT_TAG as e}from"@redocly/theme/core/constants";import{VARIANT_TAG as t,isNonControlVariant as n}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as r}from"@redocly/theme/markdoc/tags/visibility";const i=/* @__PURE__ */ new Set([`document`,`paragraph`,`heading`,`blockquote`,`fence`,`list`,`item`,`table`,`thead`,`tbody`,`tr`,`hr`,`tag`]),a=/* @__PURE__ */ new Set([`if`,`else`]),o=[`title`,`name`,`label`];function s(e){let t=[];return u(e,t),t.join(``).replace(/[ \t]+/g,` `).replace(/(?<!\s)\s*\n\s*/g,`
2
- `).trim()}function c(e){let t=[e];for(;t.length>0;){let e=t.pop();if(f(e)&&!l(e)){if(e.type===`heading`){let t=s({type:`paragraph`,children:e.children??[]});return t===``?null:t}t.push(...[...e.children??[]].reverse())}}return null}function l(t){return r(t)||n(t)||t.type===`tag`&&t.tag===e}function u(n,r){if(!f(n)||n.type===`tag`&&n.tag!==void 0&&a.has(n.tag))return;if(l(n)){n.tag===e&&d(n,r);return}let s=n.attributes?.content;if(n.type===`text`||n.type===`code`||n.type===`fence`){typeof s==`string`&&r.push(s),n.type===`fence`&&r.push(`
3
- `);return}if(n.type===`softbreak`||n.type===`hardbreak`){r.push(`
4
- `);return}if(n.type===`image`){let e=n.attributes?.alt;typeof e==`string`&&r.push(e);return}if(n.type===`tag`&&n.tag!==`html`&&n.tag!==t){let e=o.find(e=>typeof n.attributes?.[e]==`string`);e!==void 0&&r.push(`${n.attributes?.[e]}\n`)}for(let e of Object.values(n.slots??{}))u(e,r);for(let e of n.children??[])u(e,r);n.type!==void 0&&i.has(n.type)?r.push(`
5
- `):(n.type===`td`||n.type===`th`)&&r.push(` `)}function d(e,t){let n=e.attributes?.title;typeof n==`string`&&n!==``&&t.push(`${n}\n`)}function f(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{l as hidesBodyFromSearch,s as markdocAstToText,c as markdocFirstHeading};
1
+ import{VARIANT_TAG as e,isNonControlVariant as t}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as n}from"@redocly/theme/markdoc/tags/visibility";import{PROMPT_TAG as r}from"@redocly/theme/core/constants";const i=/* @__PURE__ */ new Set([`document`,`paragraph`,`heading`,`blockquote`,`fence`,`list`,`item`,`table`,`thead`,`tbody`,`tr`,`hr`,`tag`]),a=/* @__PURE__ */ new Set([`if`,`else`]),o=[`title`,`name`,`label`],s=[...o,`text`];function c(e){return l(e,s)}function l(e,t){let n=[];return f(e,n,t),n.join(``).replace(/[ \t]+/g,` `).replace(/(?<!\s)\s*\n\s*/g,`
2
+ `).trim()}function u(e){let t=[e];for(;t.length>0;){let e=t.pop();if(m(e)&&!d(e)){if(e.type===`heading`){let t=l({type:`paragraph`,children:e.children??[]},o);return t===``?null:t}t.push(...[...e.children??[]].reverse())}}return null}function d(e){return n(e)||t(e)||e.type===`tag`&&e.tag===r}function f(t,n,o){if(!m(t)||t.type===`tag`&&t.tag!==void 0&&a.has(t.tag))return;if(d(t)){t.tag===r&&p(t,n);return}let s=t.attributes?.content;if(t.type===`text`||t.type===`code`||t.type===`fence`){typeof s==`string`&&n.push(s),t.type===`fence`&&n.push(`
3
+ `);return}if(t.type===`softbreak`||t.type===`hardbreak`){n.push(`
4
+ `);return}if(t.type===`image`){let e=t.attributes?.alt;typeof e==`string`&&n.push(e);return}if(t.type===`tag`&&t.tag!==`html`&&t.tag!==e){let e=o.find(e=>typeof t.attributes?.[e]==`string`);e!==void 0&&n.push(`${t.attributes?.[e]}\n`)}for(let e of Object.values(t.slots??{}))f(e,n,o);for(let e of t.children??[])f(e,n,o);t.type!==void 0&&i.has(t.type)?n.push(`
5
+ `):(t.type===`td`||t.type===`th`)&&n.push(` `)}function p(e,t){let n=e.attributes?.title;typeof n==`string`&&n!==``&&t.push(`${n}\n`)}function m(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{d as hidesBodyFromSearch,c as markdocAstToText,u as markdocFirstHeading};
@@ -1 +1 @@
1
- import"../../../shared/constants/content-assets.js";import{getPublicEnv as e}from"../../../shared/public-env.js";import{isObject as t}from"../../../shared/utils/is-object.js";import{isPackedMarkdocAst as n,unpackMarkdocAst as r}from"../../../shared/utils/packed-ast.js";import{headingSlugger as i}from"../utils/heading-slugger.js";import{joinSrcSet as a,parseSrcSet as o}from"../../plugins/internal/assets/srcset.js";import{builtInMarkdocFunctions as s,rbacTeamList as c}from"../constants/builtin-functions.js";import{resolveMarkdocTagSet as l}from"../constants/tag-sets.js";import{frontmatterVariable as u}from"../utils/frontmatter-variable.js";import{stampHeadingIndexes as d}from"../utils/collect-headings.js";import f from"@redocly/markdoc";function p(e){let t=e.viewer,n=t?.isAuthenticated===!0;return{userAgent:n?e.userAgent:null,userIp:n?e.ip:null,remoteAddr:{ipAddress:n?e.ip:null},rbac:{teams:c(e.teams)},user:t?.isAuthenticated?{isAuthenticated:!0,name:t.name??null,email:t.email??null,teams:t.teams}:{isAuthenticated:!1,name:null,email:null,teams:[]}}}function m(e){let t=e=>{Array.isArray(e)?e.forEach(t):f.Tag.isTag(e)&&(e.children=e.children.map(e=>typeof e==`object`&&e&&!f.Tag.isTag(e)?JSON.stringify(e,null,2):(t(e),e)))};return t(e),e}function h(e){return!!e&&typeof e==`object`&&e.$$mdtype===`Node`}function g(e){return f.Ast.fromJSON(e)}function _(e){return e.includes(`"$$mdtype":"Node"`)||e.includes(`"$$mdpack":`)?{}:null}async function v(n,r,i,a){let{tags:o,nodes:c,functions:u}=await l(r.tagSet),f=x(n,{functions:u??s,tags:o,nodes:c,variables:{...p(i),env:e(),frontmatter:b(n),lang:a}});t(f)&&f.ast&&d(f.ast);let m=r.l10nAssets?.[a];return m?y(f,m):f}function y(e,t){let n=e=>{if(!e.includes(`/content-assets`))return e;let n=o(e);if(!n||n.length===0)return e;let r=!1,i=n.map(e=>{let n=e.src.search(/[?#]/),i=t[n===-1?e.src:e.src.slice(0,n)];return i===void 0?e:(r=!0,e.src=n===-1?i:`${i}${e.src.slice(n)}`,e)});return r?a(i):e},r=e=>{if(typeof e==`string`)return n(e);if(Array.isArray(e)){let t=!1,n=e.map(e=>{let n=r(e);return t||=n!==e,n});return t?n:e}if(e&&typeof e==`object`){let t=!1,n=Object.entries(e).map(([e,n])=>{let i=r(n);return t||=i!==n,[e,i]});return t?Object.fromEntries(n):e}return e},i=e=>{f.Tag.isTag(e)?(e.attributes=r(e.attributes),e.children.forEach(i)):Array.isArray(e)?e.forEach(i):e&&typeof e==`object`&&Object.values(e).forEach(i)};return i(e),e}function b(e){return t(e)?u(t(e.frontmatter)?e.frontmatter:{},e.title):{}}function x(e,t){i.reset();let a=e=>e instanceof f.Ast.Node,o=e=>{if(a(e))return m(f.transform(e,t));if(n(e)){let n=r(e);return m(f.transform(n,t))}if(h(e))return m(f.transform(f.Ast.fromJSON(JSON.stringify(e)),t));if(Array.isArray(e))return e.length>0&&e.every(a)?m(f.transform(e,t)):e.length>0&&e.every(h)?m(f.transform(f.Ast.fromJSON(JSON.stringify(e)),t)):e.map(o);if(e&&typeof e==`object`){let t={};for(let[n,r]of Object.entries(e))t[n]=o(r);return t}return e};return o(e)}export{p as buildMarkdownRuntimeVariables,_ as detectMarkdocPayloadFlag,h as isMarkdocAstNode,y as localizeMarkdocAssetUrls,g as parseMarkdocPayloadDeep,x as transformMarkdocDeep,v as transformMarkdocPayload};
1
+ import"../../../shared/constants/content-assets.js";import{getPublicEnv as e}from"../../../shared/public-env.js";import{builtInMarkdocFunctions as t,rbacTeamList as n}from"../constants/builtin-functions.js";import{isObject as r}from"../../../shared/utils/is-object.js";import{headingSlugger as i}from"../utils/heading-slugger.js";import{resolveMarkdocTagSet as a}from"../constants/tag-sets.js";import{isPackedMarkdocAst as o,unpackMarkdocAst as s}from"../../../shared/utils/packed-ast.js";import{joinSrcSet as c,parseSrcSet as l}from"../../plugins/internal/assets/srcset.js";import{frontmatterVariable as u}from"../utils/frontmatter-variable.js";import{stampHeadingIndexes as d}from"../utils/collect-headings.js";import f from"@redocly/markdoc";function p(e){let t=e.viewer,r=t?.isAuthenticated===!0;return{userAgent:r?e.userAgent:null,userIp:r?e.ip:null,remoteAddr:{ipAddress:r?e.ip:null},rbac:{teams:n(e.teams)},user:t?.isAuthenticated?{isAuthenticated:!0,name:t.name??null,email:t.email??null,teams:t.teams}:{isAuthenticated:!1,name:null,email:null,teams:[]}}}function m(e){let t=e=>{Array.isArray(e)?e.forEach(t):f.Tag.isTag(e)&&(e.children=e.children.map(e=>typeof e==`object`&&e&&!f.Tag.isTag(e)?JSON.stringify(e,null,2):(t(e),e)))};return t(e),e}function h(e){return!!e&&typeof e==`object`&&e.$$mdtype===`Node`}function g(e){return f.Ast.fromJSON(e)}function _(e){return e.includes(`"$$mdtype":"Node"`)||e.includes(`"$$mdpack":`)?{}:null}async function v(n,i,o,s){let{tags:c,nodes:l,functions:u}=await a(i.tagSet),f=x(n,{functions:u??t,tags:c,nodes:l,variables:{...p(o),env:e(),frontmatter:b(n),lang:s}});r(f)&&f.ast&&d(f.ast);let m=i.l10nAssets?.[s];return m?y(f,m):f}function y(e,t){let n=e=>{if(!e.includes(`/content-assets`))return e;let n=l(e);if(!n||n.length===0)return e;let r=!1,i=n.map(e=>{let n=e.src.search(/[?#]/),i=t[n===-1?e.src:e.src.slice(0,n)];return i===void 0?e:(r=!0,e.src=n===-1?i:`${i}${e.src.slice(n)}`,e)});return r?c(i):e},r=e=>{if(typeof e==`string`)return n(e);if(Array.isArray(e)){let t=!1,n=e.map(e=>{let n=r(e);return t||=n!==e,n});return t?n:e}if(e&&typeof e==`object`){let t=!1,n=Object.entries(e).map(([e,n])=>{let i=r(n);return t||=i!==n,[e,i]});return t?Object.fromEntries(n):e}return e},i=e=>{f.Tag.isTag(e)?(e.attributes=r(e.attributes),e.children.forEach(i)):Array.isArray(e)?e.forEach(i):e&&typeof e==`object`&&Object.values(e).forEach(i)};return i(e),e}function b(e){return r(e)?u(r(e.frontmatter)?e.frontmatter:{},e.title):{}}function x(e,t){i.reset();let n=e=>e instanceof f.Ast.Node,r=e=>{if(n(e))return m(f.transform(e,t));if(o(e)){let n=s(e);return m(f.transform(n,t))}if(h(e))return m(f.transform(f.Ast.fromJSON(JSON.stringify(e)),t));if(Array.isArray(e))return e.length>0&&e.every(n)?m(f.transform(e,t)):e.length>0&&e.every(h)?m(f.transform(f.Ast.fromJSON(JSON.stringify(e)),t)):e.map(r);if(e&&typeof e==`object`){let t={};for(let[n,i]of Object.entries(e))t[n]=r(i);return t}return e};return r(e)}export{p as buildMarkdownRuntimeVariables,_ as detectMarkdocPayloadFlag,h as isMarkdocAstNode,y as localizeMarkdocAssetUrls,g as parseMarkdocPayloadDeep,x as transformMarkdocDeep,v as transformMarkdocPayload};
@@ -1 +1 @@
1
- import{parseMarkdownCached as e}from"./utils/parse-cache.js";import{looksLikeMarkdown as t,resolveImageReference as n,resolveImageSrcSet as r,resolveLocalReference as i}from"./resolve/references.js";function a(a){return{disabledTags:a.disabledTags??/* @__PURE__ */ new Set,contentLocales:a.contentLocales??[],hasPageRoute:e=>a.state.primaryRouteByFilePath.has(e),looksLikeMarkdown:t,parseCached:e,resolveLocalReference:(e,t,n)=>i(e,t,a.state,a.resolveAudienceTag,a.contentLocales,n),resolveImageReference:(e,t)=>n(e,t,a.state,a.resolveAudienceTag,a.contentLocales),resolveImageSrcSet:(e,t)=>r(e,t,a.state,a.resolveAudienceTag,a.contentLocales)}}export{a as createMarkdownService};
1
+ import{splitUrlSuffix as e}from"../../shared/utils/routes/split-url-suffix.js";import{parseMarkdownCached as t}from"./utils/parse-cache.js";import{findServingRoute as n,looksLikeMarkdown as r,resolveImageReference as i,resolveImageSrcSet as a,resolveLocalReference as o}from"./resolve/references.js";import{toVersionlessSlug as s}from"../versions/redirect.js";function c(e){return{disabledTags:e.disabledTags??/* @__PURE__ */ new Set,contentLocales:e.contentLocales??[],hasPageRoute:t=>e.state.primaryRouteByFilePath.has(t),pageRouteSlug:t=>e.state.primaryRouteByFilePath.get(t),looksLikeMarkdown:r,parseCached:t,resolveLocalReference:async(t,n,r)=>l(await o(t,n,e.state,e.resolveAudienceTag,e.contentLocales,r),e.state,e.defaultVersion),resolveImageReference:(t,n)=>i(t,n,e.state,e.resolveAudienceTag,e.contentLocales),resolveImageSrcSet:(t,n)=>a(t,n,e.state,e.resolveAudienceTag,e.contentLocales)}}async function l(t,r,i){if(t.result.kind!==`pageUrl`||i===void 0)return t;let{path:a,suffix:o}=e(t.result.url),c=n(r,a);if(!c?.versionGroup||!c.version)return t;let{versionGroup:l,version:u,locale:d}=c;if(await i(l)!==u)return t;let f=s(a,l,u,d);return f===a||r.routeBySlug.has(f)?t:{...t,result:{kind:`pageUrl`,url:`${f}${o}`}}}export{c as createMarkdownService};
@@ -7,6 +7,8 @@ export type MarkdownService = {
7
7
  contentLocales: readonly string[];
8
8
  /** Whether the content file at `path` has a page route. */
9
9
  hasPageRoute(path: string): boolean;
10
+ /** The stored slug of the page route of the content file at `path`, from the current route state. */
11
+ pageRouteSlug(path: string): string | undefined;
10
12
  looksLikeMarkdown(value: string): boolean;
11
13
  parseCached(rawSource: string): ParsedMarkdown;
12
14
  /** `includingPagePath`: the page a partial source is inlined into. */
@@ -1 +1 @@
1
- import{parseMarkdownFirstHeading as e}from"./parse-cache.js";import{markdocFirstHeading as t}from"../search/to-text.js";import{PROMPT_TAG as n}from"@redocly/theme/core/constants";import{isNonControlVariant as r}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as i}from"@redocly/theme/markdoc/tags/visibility";function a(a){return t(e(a,e=>e.tag===n||i(e)||r(e)))}export{a as markdownFirstHeading};
1
+ import{parseMarkdownFirstHeading as e}from"./parse-cache.js";import{markdocFirstHeading as t}from"../search/to-text.js";import{isNonControlVariant as n}from"@redocly/theme/markdoc/tags/variant";import{isForAgentsOnly as r}from"@redocly/theme/markdoc/tags/visibility";import{PROMPT_TAG as i}from"@redocly/theme/core/constants";function a(a){return t(e(a,e=>e.tag===i||r(e)||n(e)))}export{a as markdownFirstHeading};
@@ -1 +1 @@
1
- import{hashBlobContent as e}from"../../materialization/data-ref.js";import{MARKDOC_ERROR_TAG as t}from"../tags/markdoc-error.js";import{createLruCache as n}from"../../../shared/utils/lru-cache.js";import{reparseExampleFences as r}from"./reparse-example-fences.js";import i from"@redocly/markdoc";import{htmlTags as a}from"@redocly/markdoc/html";const o={html:a({errorTag:t}),allowIndentation:!0,allowComments:!0,slots:!0};function s(e){return i.parse(e,o)}function c(e){let t=s(e);return r(t,e,s),t}function l(t){let r=n(t);return t=>{let n=e(t),i=r.get(n);if(i!==void 0)return i;let a=c(t);return r.set(n,a),a}}function u(e,t){return i.parseFirstHeading(e,{...o,skip:t})}const d=l({budget:100});export{l as createCachedMarkdownParser,s as parseMarkdown,d as parseMarkdownCached,c as parseMarkdownDocument,u as parseMarkdownFirstHeading};
1
+ import{MARKDOC_ERROR_TAG as e}from"../tags/markdoc-error.js";import{hashBlobContent as t}from"../../materialization/data-ref.js";import{createLruCache as n}from"../../../shared/utils/lru-cache.js";import{reparseExampleFences as r}from"./reparse-example-fences.js";import i from"@redocly/markdoc";import{htmlTags as a}from"@redocly/markdoc/html";const o={html:a({errorTag:e,headings:!0}),allowIndentation:!0,allowComments:!0,slots:!0};function s(e){return i.parse(e,o)}function c(e){let t=s(e);return r(t,e,s),t}function l(e){let r=n(e);return e=>{let n=t(e),i=r.get(n);if(i!==void 0)return i;let a=c(e);return r.set(n,a),a}}function u(e,t){return i.parseFirstHeading(e,{...o,skip:t})}const d=l({budget:100});export{l as createCachedMarkdownParser,s as parseMarkdown,d as parseMarkdownCached,c as parseMarkdownDocument,u as parseMarkdownFirstHeading};
@@ -1 +1 @@
1
- import{hashJsonValue as e}from"../database/utils/json.js";import{entities as t,entityDeps as n,files as r,loaderConfigDeps as i}from"../database/schema.js";import{collectDataRefMarkers as a}from"./data-ref.js";import{replaceBlobRefsForEntityTx as o}from"../database/blobs.js";import{dedupeRouteQueryDependencies as s}from"../plugins/utils/route-index.js";import{MaterializationError as c,ProblemError as l}from"../problems/problem-error.js";import{problemRow as u,replaceEntityProblemsExceptCodesTx as d}from"../database/problems.js";import{replaceAssetRefsForEntityTx as f,upsertAssetsTx as p}from"../database/assets.js";import{createProblem as m}from"../problems/codes.js";import{replaceLinkRefsForEntityTx as h,upsertTargetInventoryTx as g}from"../database/link-refs.js";import{buildL10nAssetMap as _,dedupeAssetUsages as v,reconcileAsset as y,removeReplacedAssetFiles as b}from"./asset-reconcile.js";import{cutEntityRevisionTx as x}from"../revisions/cut.js";import{detectMarkdocPayloadFlag as S}from"../markdown/server/render.js";import{replaceRouteQueryDepsTx as C}from"../database/route-query-deps.js";import{replaceEntityRuntimeDeps as w}from"../database/origins.js";import{SEARCH_PROBLEM_CODES as T}from"../problems/producers.js";import{and as E,eq as D}from"drizzle-orm";const O=/* @__PURE__ */ new WeakMap;async function k(e){let t=await A(e.database,e.key);if(!t)throw Error(`Entity "${e.key}" is not registered.`);if(t.kind===`inline`){if(t.data===null)throw Error(`Inline entity "${e.key}" is missing its stored data.`);return t.data}if(t.status===`ready`&&t.data!==null)return t.data;let n=O.get(e.database);n===void 0&&(n=/* @__PURE__ */ new Map,O.set(e.database,n));let r=n.get(e.key);if(r!==void 0)return r;let i=j(e,t);n.set(e.key,i);try{return await i}finally{n.delete(e.key)}}async function A(e,n){let[r]=await e.db.select({id:t.id,key:t.key,kind:t.kind,pluginId:t.pluginId,loaderId:t.loaderId,loaderArgs:t.loaderArgs,type:t.type,metadata:t.metadata,status:t.status,data:t.data,markdoc:t.markdoc,dataHash:t.dataHash,version:t.version,revisionCreatedAt:t.revisionCreatedAt,isSystem:t.isSystem,invalidationSeq:t.invalidationSeq}).from(t).where(E(D(t.key,n),D(t.isCurrent,1))).limit(1);return r}async function j(i,l){if(!l.loaderId)throw Error(`Entity "${i.key}" is missing its loader id.`);let O=i.loaderRegistry.getEntityLoaderById(l.loaderId);if(!O)throw Error(`Entity loader "${l.loaderId}" is not registered.`);let[k]=await i.database.db.select({path:r.path,fileId:r.id}).from(n).leftJoin(r,D(n.originFileId,r.id)).where(D(n.entityId,l.id)).limit(1);if(!k&&!l.isSystem)throw Error(`Entity "${i.key}" has no origin dependency.`);let A=i.loaderContextFactory(O,l.loaderArgs,k?.path??``),j;try{j=await O.definition.handler(A)}catch(e){throw await M(i,l.id,e),new c(`Entity "${i.key}" failed to load.`,{cause:e})}let P=JSON.stringify(j.value??null),F=JSON.parse(P),I=j.markdoc??S(P),L=I?_(j.assetUsages??[]):void 0,R=L?{...I,l10nAssets:L}:I,z=a(F),B=Array.from(new Set(z.map(e=>e.blobKey))),V=v(j.assetUsages??[]),{contentDir:H}=i,U=H?(await Promise.all(V.map(e=>y(A.io,{contentDir:H,usage:e})))).filter(e=>e!==null):[],W=[];return await i.database.db.transaction(async n=>{let r=Date.now(),a=e(F),c=(l.dataHash??null)!==a,_=l.revisionCreatedAt;if(c&&(_=Math.max(r,l.revisionCreatedAt+1)),(await n.update(t).set({status:`ready`,data:F,markdoc:R,type:j.type??l.type,metadata:j.metadata??l.metadata,dataHash:a,revisionCreatedAt:_}).where(E(D(t.id,l.id),D(t.invalidationSeq,l.invalidationSeq))).returning({id:t.id})).length===0)return;c&&l.data!==null&&i.revisions?.isTracked(k?.path??``)&&await x(n,{current:l,max:i.revisions.max});let v=A._trackedConfig;await N(n,l.id,v?.collectDependencies()??[]);let y=A._loadedEntityKeys,b=A._globPatterns;if((j.entityDeps!==void 0||y.length>0||b.length>0)&&await w(n,{entityId:l.id,originPluginId:O.pluginId,isSystem:!!l.isSystem,deps:[...j.entityDeps??[],...y.map(e=>({kind:`entity`,key:e})),...b.map(e=>({kind:`glob`,pattern:e}))]}),await C(n,{originPluginId:O.pluginId,hook:`loader`,entityId:l.id,dependencies:s(A._routeQueries)}),await d(n,l.id,T,(j.problems??[]).map(e=>u(m(e),{scope:`entity`,entityId:l.id}))),await o(n,{entityId:l.id,blobKeys:B}),W=await p(n,U),await f(n,{entityId:l.id,refs:V.map(({path:e,hash:t})=>({path:e,hash:t}))}),(j.linkRefs!==void 0||j.targetInventories!==void 0)&&k?.path&&(await h(n,{entityId:l.id,originFileId:k.fileId,originPluginId:O.pluginId,filePath:k.path,drafts:j.linkRefs??[]}),k.fileId!==null))for(let e of j.targetInventories??[])await g(n,{fileId:k.fileId,originPluginId:O.pluginId,draft:e})}),H&&W.length>0&&await b(A.io,{contentDir:H,filenames:W,logger:i.logger}),F}async function M(e,t,n){let r=n instanceof l?n.draft:{code:`plugin/loader-failed`,message:`Loader failed for entity "${e.key}": ${n instanceof Error?n.message:String(n)}`,data:{entityKey:e.key}};try{let n=u(m(r),{scope:`entity`,entityId:t});await e.database.db.transaction(async e=>{await d(e,t,T,[n])})}catch{}}async function N(e,t,n){await e.delete(i).where(D(i.entityId,t)),n.length!==0&&await e.insert(i).values(n.map(e=>({...e,entityId:t})))}export{k as materializeEntityByKey};
1
+ import{hashJsonValue as e}from"../database/utils/json.js";import{entities as t,entityDeps as n,files as r,loaderConfigDeps as i}from"../database/schema.js";import{collectDataRefMarkers as a}from"./data-ref.js";import{replaceBlobRefsForEntityTx as o}from"../database/blobs.js";import{dedupeRouteQueryDependencies as s}from"../plugins/utils/route-index.js";import{MaterializationError as c,ProblemError as l}from"../problems/problem-error.js";import{replaceAssetRefsForEntityTx as u,upsertAssetsTx as d}from"../database/assets.js";import{createProblem as f}from"../problems/codes.js";import{problemRow as p,replaceEntityProblemsExceptCodesTx as m}from"../database/problems.js";import{replaceLinkRefsForEntityTx as h,upsertTargetInventoryTx as g}from"../database/link-refs.js";import{detectMarkdocPayloadFlag as _}from"../markdown/server/render.js";import{buildL10nAssetMap as v,dedupeAssetUsages as y,reconcileAsset as b,removeReplacedAssetFiles as x}from"./asset-reconcile.js";import{cutEntityRevisionTx as S}from"../revisions/cut.js";import{replaceRouteQueryDepsTx as C}from"../database/route-query-deps.js";import{replaceEntityRuntimeDeps as w}from"../database/origins.js";import{SEARCH_PROBLEM_CODES as T}from"../problems/producers.js";import{and as E,eq as D}from"drizzle-orm";const O=/* @__PURE__ */ new WeakMap;async function k(e){let t=await A(e.database,e.key);if(!t)throw Error(`Entity "${e.key}" is not registered.`);if(t.kind===`inline`){if(t.data===null)throw Error(`Inline entity "${e.key}" is missing its stored data.`);return t.data}if(t.status===`ready`&&t.data!==null)return t.data;let n=O.get(e.database);n===void 0&&(n=/* @__PURE__ */ new Map,O.set(e.database,n));let r=n.get(e.key);if(r!==void 0)return r;let i=j(e,t);n.set(e.key,i);try{return await i}finally{n.delete(e.key)}}async function A(e,n){let[r]=await e.db.select({id:t.id,key:t.key,kind:t.kind,pluginId:t.pluginId,loaderId:t.loaderId,loaderArgs:t.loaderArgs,type:t.type,metadata:t.metadata,status:t.status,data:t.data,markdoc:t.markdoc,dataHash:t.dataHash,version:t.version,revisionCreatedAt:t.revisionCreatedAt,isSystem:t.isSystem,invalidationSeq:t.invalidationSeq}).from(t).where(E(D(t.key,n),D(t.isCurrent,1))).limit(1);return r}async function j(i,l){if(!l.loaderId)throw Error(`Entity "${i.key}" is missing its loader id.`);let O=i.loaderRegistry.getEntityLoaderById(l.loaderId);if(!O)throw Error(`Entity loader "${l.loaderId}" is not registered.`);let[k]=await i.database.db.select({path:r.path,fileId:r.id}).from(n).leftJoin(r,D(n.originFileId,r.id)).where(D(n.entityId,l.id)).limit(1);if(!k&&!l.isSystem)throw Error(`Entity "${i.key}" has no origin dependency.`);let A=i.loaderContextFactory(O,l.loaderArgs,k?.path??``),j;try{j=await O.definition.handler(A)}catch(e){throw await M(i,l.id,e),new c(`Entity "${i.key}" failed to load.`,{cause:e})}let P=JSON.stringify(j.value??null),F=JSON.parse(P),I=j.markdoc??_(P),L=I?v(j.assetUsages??[]):void 0,R=L?{...I,l10nAssets:L}:I,z=a(F),B=Array.from(new Set(z.map(e=>e.blobKey))),V=y(j.assetUsages??[]),{contentDir:H}=i,U=H?(await Promise.all(V.map(e=>b(A.io,{contentDir:H,usage:e})))).filter(e=>e!==null):[],W=[];return await i.database.db.transaction(async n=>{let r=Date.now(),a=e(F),c=(l.dataHash??null)!==a,_=l.revisionCreatedAt;if(c&&(_=Math.max(r,l.revisionCreatedAt+1)),(await n.update(t).set({status:`ready`,data:F,markdoc:R,type:j.type??l.type,metadata:j.metadata??l.metadata,dataHash:a,revisionCreatedAt:_}).where(E(D(t.id,l.id),D(t.invalidationSeq,l.invalidationSeq))).returning({id:t.id})).length===0)return;c&&l.data!==null&&i.revisions?.isTracked(k?.path??``)&&await S(n,{current:l,max:i.revisions.max});let v=A._trackedConfig;await N(n,l.id,v?.collectDependencies()??[]);let y=A._loadedEntityKeys,b=A._globPatterns;if((j.entityDeps!==void 0||y.length>0||b.length>0)&&await w(n,{entityId:l.id,originPluginId:O.pluginId,isSystem:!!l.isSystem,deps:[...j.entityDeps??[],...y.map(e=>({kind:`entity`,key:e})),...b.map(e=>({kind:`glob`,pattern:e}))]}),await C(n,{originPluginId:O.pluginId,hook:`loader`,entityId:l.id,dependencies:s(A._routeQueries)}),await m(n,l.id,T,(j.problems??[]).map(e=>p(f(e),{scope:`entity`,entityId:l.id}))),await o(n,{entityId:l.id,blobKeys:B}),W=await d(n,U),await u(n,{entityId:l.id,refs:V.map(({path:e,hash:t})=>({path:e,hash:t}))}),(j.linkRefs!==void 0||j.targetInventories!==void 0)&&k?.path&&(await h(n,{entityId:l.id,originFileId:k.fileId,originPluginId:O.pluginId,filePath:k.path,drafts:j.linkRefs??[]}),k.fileId!==null))for(let e of j.targetInventories??[])await g(n,{fileId:k.fileId,originPluginId:O.pluginId,draft:e})}),H&&W.length>0&&await x(A.io,{contentDir:H,filenames:W,logger:i.logger}),F}async function M(e,t,n){let r=n instanceof l?n.draft:{code:`plugin/loader-failed`,message:`Loader failed for entity "${e.key}": ${n instanceof Error?n.message:String(n)}`,data:{entityKey:e.key}};try{let n=p(f(r),{scope:`entity`,entityId:t});await e.database.db.transaction(async e=>{await m(e,t,T,[n])})}catch{}}async function N(e,t,n){await e.delete(i).where(D(i.entityId,t)),n.length!==0&&await e.insert(i).values(n.map(e=>({...e,entityId:t})))}export{k as materializeEntityByKey};
@@ -1 +1 @@
1
- import{compareStrings as e}from"../../shared/utils/compare-strings.js";import{getStaticFilesOutputDir as t,getStaticManifestPath as n}from"../../shared/constants/runtime-layout.js";import{isObject as r}from"../../shared/utils/is-object.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,t,n,o,c){let l=n.entityKey?await s(t,n.entityKey):null;if(!l||l.status!==`ready`&&!c)throw Error(`Static file "${n.path}": producer entity "${n.entityKey}" is not ready.`);let f=l.data;if(!r(f)||!i(f.body)){if(c)return null;throw Error(`Static file "${n.path}": producer "${n.entityKey}" must return { body: BlobReference }.`)}let p=f.body;return{path:n.path,hash:p.blobKey,contentType:u(f,n),audience:o,write:async n=>e.writeFile(n,d(await a(t,p)))}}async function _(r,i){let a=t(i.contentDir),o=n(i.contentDir),s=new Map((await v(r,o))?.files.map(e=>[e.path,e])??[]),c=new Set(await y(r,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 t=f(a,...e.path.split(`/`)),n=s.get(e.path),i=n?.hash===e.hash&&c.has(e.path)?n.size:null;i===null&&(await l(r,t,e.write),i=(await r.stat(t))?.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=>r.unlink(f(a,...e.split(`/`))))),d.sort((t,n)=>e(t.path,n.path));let h={formatVersion:1,files:d};return await r.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{getStaticFilesOutputDir as t,getStaticManifestPath as n}from"../../shared/constants/runtime-layout.js";import{isObject as r}from"../../shared/utils/is-object.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,t,n,o,c){let d=n.entityKey?await s(t,n.entityKey):null;if(!d||d.status!==`ready`&&!c)throw Error(`Static file "${n.path}": producer entity "${n.entityKey}" is not ready.`);let f=d.data;if(!r(f)||!i(f.body)){if(c)return null;throw Error(`Static file "${n.path}": producer "${n.entityKey}" must return { body: BlobReference }.`)}let p=f.body;return{path:n.path,hash:p.blobKey,contentType:l(f,n),audience:o,write:async n=>e.writeFile(n,u(await a(t,p)))}}async function _(r,i){let a=t(i.contentDir),o=n(i.contentDir),s=new Map((await v(r,o))?.files.map(e=>[e.path,e])??[]),c=new Set(await y(r,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 t=f(a,...e.path.split(`/`)),n=s.get(e.path),i=n?.hash===e.hash&&c.has(e.path)?n.size:null;i===null&&(await d(r,t,e.write),i=(await r.stat(t))?.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=>r.unlink(f(a,...e.split(`/`))))),u.sort((t,n)=>e(t.path,n.path));let h={formatVersion:1,files:u};return await r.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 +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{isPlanFeatureGranted as d}from"../../../../shared/plan-gates.js";import{toPosixPath as f}from"../../../../shared/utils/to-posix-path.js";import{TRANSLATIONS_FILE_PATTERN as p}from"../../../../shared/constants/l10n/defaults.js";import{isObject as m}from"../../../../shared/utils/is-object.js";import{notInPlanProblem as h}from"../../../plan-gates.js";import{filePathToRouteSlug as g}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{SPEC_KIND_ARAZZO as _,SPEC_KIND_ASYNCAPI as v,SPEC_KIND_GRAPHQL as y,SPEC_KIND_OPENAPI as b}from"../../../../shared/constants/api-spec-kinds.js";import{packMarkdocAstsDeep as x,unpackMarkdocAstsDeep as S}from"../../../../shared/utils/packed-ast.js";import{findVersionFolder as ee}from"../../utils/version-path.js";import{toPublicVersionedSlug as C}from"../../../../shared/constants/versions.js";import{readVersionsYaml as te,versionsYamlPath as ne}from"../../../versions/version-groups.js";import{parseMarkdownCached as w}from"../../../markdown/utils/parse-cache.js";import{createApiEntityKey as T}from"../../utils/api-entity-key.js";import{API_DOCS_API_LOADER_ID as E,API_DOCS_PLUGIN_ID as D,API_DOCS_RENDER_DEP_KEY as re,API_DOCS_RENDER_LOADER_ID as ie,API_DOCS_SIDEBAR_LOADER_ID as ae,API_DOCS_TEMPLATE_ID as O,SPEC_DOWNLOAD_ROUTE_PATHS as k,SPEC_PATH_PARAM as oe}from"./server/shared.js";import{resolveApiBundleConfig as se,resolveApiOptions as ce,resolveNestedFeedback as le,schemaCatalogLink as ue,withDownloadUrls as de,withFeedbackOption as fe,withMockServerOption as pe}from"./server/options.js";import{annotateApiDocsRbac as A}from"../../../../shared/rbac/api-docs.js";import{SERVER_ONLY_VALUE_KEY as j}from"../../../loaders/server-only-value.js";import{getLoadedProjectPlugins as M}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as N}from"../../../api-outputs.js";import{API_DOCS_MARKDOC_TAG_SET as P,resolveMarkdocTagSet as F}from"../../../markdown/constants/tag-sets.js";import{pageLocale as I}from"../../utils/page-locale.js";import{buildBundledApiDefinition as L,resolveLlmsDescriptions as R}from"./server/build-definition.js";import{collectSidebarSubpathTargets as z,toSidebarSubtree as B,toSubpathTarget as me}from"./server/build-sidebar.js";import{buildApiDocsMarkdownDocs as he}from"./server/markdown-docs.js";import{join as ge,relative as _e,resolve as V}from"node:path";import ve from"@redocly/markdoc";async function ye(e,t){let n=t.originFilePath===null?null:ee(t.originFilePath);if(n===null||t.version===null||t.versionGroup===null)return{slug:t.slug,entityDeps:[]};let r=(await te({io:{exists:t=>e.io.exists(V(e.contentDir,t)),readFile:t=>e.io.readFile(V(e.contentDir,t))},directory:n.parent}))?.default===t.version;return{slug:C(t.slug,t.versionGroup,t.version,r),entityDeps:[{kind:`file`,path:ne(n.parent)}]}}const be=[`.yaml`,`.yml`,`.json`,`.gql`,`.graphql`],xe={[b]:`OpenAPI`,[v]:`AsyncAPI`,[y]:`GraphQL`,[_]:`Arazzo`},H=t(ie,async e=>{let{buildItems:t,descriptionOptions:n}=await import(`@redocly/api-docs/server`),r=G(e),i=await e.io.readFile(r.absolutePath),a=e.routes.byFilePath(e.file.path),o=a?.slug,s=a&&e.args.kind===`openapi`?await ye(e,a):{slug:void 0,entityDeps:[]},c=de(e.args.options,e.file.path,e.args.kind),l=e.args.kind===`openapi`?pe(c,e.config,s.slug):c,u={entityDeps:[],assetUsages:[],linkRefs:[],problems:[],pending:[]},d=W(e.contentDir),f={markdown:e.markdown,loader:{config:e.config,entities:e.entities,file:e.file,io:e.io,logger:e.logger,plugin:e.plugin},sink:u},p=await L({kind:e.args.kind,source:i,relativePath:r.relativePath,contentDir:e.contentDir,pagePath:e.file.path,options:l,bundle:K(e.args,d),metadata:X(e.args.options),markdownResolution:f,rbac:{warn:t=>e.logger?.warn(t)}}),h={...m(p.document)&&m(p.document.info)?{infoDescription:p.document.info.description}:{},...await R(p.document,f,{contentDir:e.contentDir,specPath:r.relativePath,pagePath:e.file.path})};e.args.kind===`openapi`&&l.showSchemaCatalogLinks&&m(p.document)&&(p.document[`x-schema-catalog-link`]=ue(e.file.path)),p.options={...fe(p.options,p.document,e.args.feedback??e.config.feedback),...n(e.args.kind,p.document,X(e.args.options))};let g=o?.toLowerCase()??`/`,{items:_,store:v,specType:y}=await t({...p,basePath:g,markdownParser:e=>ve.compact(w(e))}),b=JSON.stringify({items:x(_),store:x(v),options:p.options,specType:y,basePath:g,title:Ee(p.document,e.args.kind,_),metadata:Te(p.document),[j]:{llms:h}});return{value:await e.createBlobRef(b,{format:`json`}),entityDeps:[...J(e.file.path,[...p.fileDependencies,...d.paths]),...u.entityDeps,...s.entityDeps],assetUsages:u.assetUsages,markdoc:{tagSet:P},linkRefs:u.linkRefs,problems:u.problems}},{async searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=S(e),r=await Me(t.entities,t.route.originFilePath),d={...t.route.metadata,...m(n.metadata)?n.metadata:{}},{category:f,isInvalid:p}=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,...p?[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(T(r)).catch(()=>void 0):void 0,{tags:a}=await F(P);return he(n,A(Y(i,n[j]?.llms),n.specType,{warn:e=>t.logger?.warn(e)}),r,{tags:a,locale:I(t)})},usesProjectMarkdocSchema:!0}),U=t(E,async e=>{let t=G(e),n=await e.io.readFile(t.absolutePath),r=W(e.contentDir),i=await L({kind:e.args.kind,source:n,relativePath:t.relativePath,contentDir:e.contentDir,bundle:K(e.args,r),metadata:X(e.args.options)}),a=e.args.kind===y,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),...Ce(i.document,e.routes.byFilePath(e.file.path)?.slug)},entityDeps:J(e.file.path,[...i.fileDependencies,...r.paths]),problems:i.problems}});function W(e){let t=M(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>f(_e(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function G(e){let t=e.args.source?.path??e.file.path;return{relativePath:t,absolutePath:ge(e.contentDir,t)}}function Se(e){let t=e[N];return m(t)&&typeof t.root==`string`?t.root:void 0}function K(e,t){let{config:n,configDir:r}=e.bundleConfig??{config:{},configDir:``};return{config:n,configDir:r,plugins:t.plugins}}function Ce(e,t){let n=m(e)&&m(e.info)?e.info:{},r=m(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 q=t(ae,async e=>{let{buildNavItems:t,collectPreviousRouteSlugs:n}=await import(`@redocly/api-docs/server`),r=await e.entities.load(T(e.file.path)),i=e.args.kind===`graphql`?(await import(`graphql`)).parse(r):r,a=A(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:w}),s=B(o),c=n(o).map(({from:e})=>me(e));return{value:s,targetInventories:[{kind:`subpath`,exhaustive:!0,targets:[...z(s),...c]}]}});function J(e,t){return[{kind:`file`,path:e},...t.map(e=>({kind:`file`,path:e}))]}const we={arazzo:`Arazzo Docs`,asyncapi:`AsyncAPI Docs`,graphql:`GraphQL Docs`,openapi:`OpenAPI Docs`};function Y(e,t){if(t===void 0||!m(e))return e;let n=m(e.info)?e.info:{},r=m(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 Te(e){let t=m(e)&&m(e.info)?e.info:{};return m(t[`x-metadata`])?t[`x-metadata`]:{}}function Ee(e,t,n){let r=m(e)&&m(e.info)?e.info:{};if(typeof r.title==`string`&&r.title!==``)return r.title;let i=m(n[0])?n[0].label:void 0;return typeof i==`string`&&i!==``?i:we[t]}const De=[`rbac`,`sidebar`,`excludeFromSearch`,`template`];function Oe(e,t){let n=m(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),m(n[`x-metadata`])&&Object.assign(r,n[`x-metadata`]),m(t.metadata)&&Object.assign(r,t.metadata);for(let e of De)delete r[e];return r}function X(e){return m(e.metadata)?e.metadata:void 0}function ke(e){let t=X(e)?.title;return typeof t==`string`&&t.length>0?t:void 0}function Z(e,t,n,r){let i=ke(n);return{specType:t,sourcePath:e,...i===void 0?{}:{title:i},...r===void 0?{}:{rbac:r},...Object.keys(n).length>0?{options:n}:{},...m(n.mockServer)?{mockServer:n.mockServer}:{}}}function Q(e){return typeof e==`string`||typeof e==`number`}function Ae(e){if(e.ext===`.gql`||e.ext===`.graphql`)return y;let{openapi:t,swagger:n,asyncapi:r,arazzo:i}=e.manifest;return Q(t)||Q(n)?b:Q(r)?v:Q(i)?_:null}const je=e({id:D,version:`0.48.0`,content:{filter:{extensions:be},async extractFile(e,t){if(p.test(e.path))return null;let n=Ae(e);if(n===null)return null;if(n!==`arazzo`&&!d(t.config,n))return{routes:[],problems:[h(`${xe[n]} documents`)]};let r=e.path,i=Se(e.manifest),a=i??r,{rbac:o,...s}=await ce(t.io,t.config,r,n,a),c={filePath:r,kind:n,options:s,...o===void 0||!d(t.config,`rbac`)?{}:{rbac:o}};i!==void 0&&(c.source={path:i});let l=await le(t.io,t.config,a);if(l!==void 0&&(c.feedback=l),n!==`graphql`){let e=await se(t.io,t.config,r,a);Object.keys(e.config).length>0&&(c.bundleConfig=e)}let u=U.withArgs(c,{stableKey:T(r),type:`api`,metadata:Z(r,n,s,c.rbac)});if(n===`arazzo`)return{routes:[],entities:[u]};let f=Oe(e,s);s.excludeFromSearch===!0&&(f.excludeFromSearch=!0),f.type=n,c.rbac!==void 0&&(f.rbac=c.rbac);let m=H.withArgs(c,{stableKey:`api-docs:render:${r}`}),_=q.withArgs(c,{stableKey:`api-docs:sidebar:${r}`}),v=g(r);return{routes:[{deps:{[re]:m},metadata:f,routeId:`page`,sidebarSubtree:_,slug:null,slugHint:v,template:O,wildcardPrefix:!0}],entities:[u,m,_]}}},loaders:[U,H,q],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+oe,handler:{filePath:`./server/spec-download.ts`,importer:import.meta.url,exportName:t}}}async function Me(e,t){if(t)try{return await e.load(T(t))}catch{return}}export{je 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{isPlanFeatureGranted as d}from"../../../../shared/plan-gates.js";import{toPosixPath as f}from"../../../../shared/utils/to-posix-path.js";import{isObject as p}from"../../../../shared/utils/is-object.js";import{API_DOCS_MARKDOC_TAG_SET as m,resolveMarkdocTagSet as h}from"../../../markdown/constants/tag-sets.js";import{TRANSLATIONS_FILE_PATTERN as g}from"../../../../shared/constants/l10n/defaults.js";import{notInPlanProblem as _}from"../../../plan-gates.js";import{filePathToRouteSlug as v}from"../../../../shared/utils/routes/file-path-to-route-slug.js";import{SPEC_KIND_ARAZZO as y,SPEC_KIND_ASYNCAPI as b,SPEC_KIND_GRAPHQL as x,SPEC_KIND_OPENAPI as S}from"../../../../shared/constants/api-spec-kinds.js";import{packMarkdocAstsDeep as C,unpackMarkdocAstsDeep as w}from"../../../../shared/utils/packed-ast.js";import{findVersionFolder as T}from"../../utils/version-path.js";import{toPublicVersionedSlug as E}from"../../../../shared/constants/versions.js";import{readVersionsYaml as ee,versionsYamlPath as te}from"../../../versions/version-groups.js";import{parseMarkdownCached as D}from"../../../markdown/utils/parse-cache.js";import{createApiEntityKey as O}from"../../utils/api-entity-key.js";import{API_DOCS_API_LOADER_ID as k,API_DOCS_PLUGIN_ID as ne,API_DOCS_RENDER_DEP_KEY as re,API_DOCS_RENDER_LOADER_ID as ie,API_DOCS_SIDEBAR_LOADER_ID as ae,API_DOCS_TEMPLATE_ID as A,SPEC_DOWNLOAD_ROUTE_PATHS as j,SPEC_PATH_PARAM as oe}from"./server/shared.js";import{resolveApiBundleConfig as se,resolveApiOptions as ce,resolveNestedFeedback as le,schemaCatalogLink as ue,withDownloadUrls as de,withFeedbackOption as fe,withMockServerOption as pe}from"./server/options.js";import{annotateApiDocsRbac as M}from"../../../../shared/rbac/api-docs.js";import{SERVER_ONLY_VALUE_KEY as N}from"../../../loaders/server-only-value.js";import{getLoadedProjectPlugins as P}from"../../project/loaded-set.js";import{API_OUTPUT_MANIFEST_KEY as F}from"../../../api-outputs.js";import{pageLocale as I}from"../../utils/page-locale.js";import{buildBundledApiDefinition as L,resolveLlmsDescriptions as R}from"./server/build-definition.js";import{collectSidebarSubpathTargets as z,toSidebarSubtree as B,toSubpathTarget as me}from"./server/build-sidebar.js";import{buildApiDocsMarkdownDocs as he}from"./server/markdown-docs.js";import{join as ge,relative as _e,resolve as V}from"node:path";import ve from"@redocly/markdoc";async function ye(e,t){let n=t.originFilePath===null?null:T(t.originFilePath);if(n===null||t.version===null||t.versionGroup===null)return{slug:t.slug,entityDeps:[]};let r=(await ee({io:{exists:t=>e.io.exists(V(e.contentDir,t)),readFile:t=>e.io.readFile(V(e.contentDir,t))},directory:n.parent}))?.default===t.version;return{slug:E(t.slug,t.versionGroup,t.version,r),entityDeps:[{kind:`file`,path:te(n.parent)}]}}const be=[`.yaml`,`.yml`,`.json`,`.gql`,`.graphql`],xe={[S]:`OpenAPI`,[b]:`AsyncAPI`,[x]:`GraphQL`,[y]:`Arazzo`},H=t(ie,async e=>{let{buildItems:t,descriptionOptions:n}=await import(`@redocly/api-docs/server`),r=G(e),i=await e.io.readFile(r.absolutePath),a=e.routes.byFilePath(e.file.path),o=a?.slug,s=a&&e.args.kind===`openapi`?await ye(e,a):{slug:void 0,entityDeps:[]},c=de(e.args.options,e.file.path,e.args.kind),l=e.args.kind===`openapi`?pe(c,e.config,s.slug):c,u={entityDeps:[],assetUsages:[],linkRefs:[],problems:[],pending:[]},d=W(e.contentDir),f={markdown:e.markdown,loader:{config:e.config,entities:e.entities,file:e.file,io:e.io,logger:e.logger,plugin:e.plugin},sink:u},h=await L({kind:e.args.kind,source:i,relativePath:r.relativePath,contentDir:e.contentDir,pagePath:e.file.path,options:l,bundle:K(e.args,d),metadata:X(e.args.options),markdownResolution:f,rbac:{warn:t=>e.logger?.warn(t)}}),g={...p(h.document)&&p(h.document.info)?{infoDescription:h.document.info.description}:{},...await R(h.document,f,{contentDir:e.contentDir,specPath:r.relativePath,pagePath:e.file.path})};e.args.kind===`openapi`&&l.showSchemaCatalogLinks&&p(h.document)&&(h.document[`x-schema-catalog-link`]=ue(e.file.path)),h.options={...fe(h.options,h.document,e.args.feedback??e.config.feedback),...n(e.args.kind,h.document,X(e.args.options))};let _=o?.toLowerCase()??`/`,{items:v,store:y,specType:b}=await t({...h,basePath:_,markdownParser:e=>ve.compact(D(e))}),x=JSON.stringify({items:C(v),store:C(y),options:h.options,specType:b,basePath:_,title:Ee(h.document,e.args.kind,v),metadata:Te(h.document),[N]:{llms:g}});return{value:await e.createBlobRef(x,{format:`json`}),entityDeps:[...J(e.file.path,[...h.fileDependencies,...d.paths]),...u.entityDeps,...s.entityDeps],assetUsages:u.assetUsages,markdoc:{tagSet:m},linkRefs:u.linkRefs,problems:u.problems}},{async searchable(e,t){if(t.route===void 0||t.route.metadata.excludeFromSearch===!0)return{docs:[]};let n=w(e),r=await Me(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=w(e),r=t.route.originFilePath??void 0,i=r?await t.entities.load(O(r)).catch(()=>void 0):void 0,{tags:a}=await h(m);return he(n,M(Y(i,n[N]?.llms),n.specType,{warn:e=>t.logger?.warn(e)}),r,{tags:a,locale:I(t)})},usesProjectMarkdocSchema:!0}),U=t(k,async e=>{let t=G(e),n=await e.io.readFile(t.absolutePath),r=W(e.contentDir),i=await L({kind:e.args.kind,source:n,relativePath:t.relativePath,contentDir:e.contentDir,bundle:K(e.args,r),metadata:X(e.args.options)}),a=e.args.kind===x,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),...Ce(i.document,e.routes.byFilePath(e.file.path)?.slug)},entityDeps:J(e.file.path,[...i.fileDependencies,...r.paths]),problems:i.problems}});function W(e){let t=P(e)?.lintPlugins??[];return{plugins:t,paths:t.map(t=>f(_e(e,t.path))).filter(e=>e!==``&&!e.startsWith(`../`))}}function G(e){let t=e.args.source?.path??e.file.path;return{relativePath:t,absolutePath:ge(e.contentDir,t)}}function Se(e){let t=e[F];return p(t)&&typeof t.root==`string`?t.root:void 0}function K(e,t){let{config:n,configDir:r}=e.bundleConfig??{config:{},configDir:``};return{config:n,configDir:r,plugins:t.plugins}}function Ce(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 q=t(ae,async e=>{let{buildNavItems:t,collectPreviousRouteSlugs:n}=await import(`@redocly/api-docs/server`),r=await e.entities.load(O(e.file.path)),i=e.args.kind===`graphql`?(await import(`graphql`)).parse(r):r,a=M(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:D}),s=B(o),c=n(o).map(({from:e})=>me(e));return{value:s,targetInventories:[{kind:`subpath`,exhaustive:!0,targets:[...z(s),...c]}]}});function J(e,t){return[{kind:`file`,path:e},...t.map(e=>({kind:`file`,path:e}))]}const we={arazzo:`Arazzo Docs`,asyncapi:`AsyncAPI Docs`,graphql:`GraphQL Docs`,openapi:`OpenAPI Docs`};function Y(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 Te(e){let t=p(e)&&p(e.info)?e.info:{};return p(t[`x-metadata`])?t[`x-metadata`]:{}}function Ee(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:we[t]}const De=[`rbac`,`sidebar`,`excludeFromSearch`,`template`];function Oe(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 De)delete r[e];return r}function X(e){return p(e.metadata)?e.metadata:void 0}function ke(e){let t=X(e)?.title;return typeof t==`string`&&t.length>0?t:void 0}function Z(e,t,n,r){let i=ke(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 Ae(e){if(e.ext===`.gql`||e.ext===`.graphql`)return x;let{openapi:t,swagger:n,asyncapi:r,arazzo:i}=e.manifest;return Q(t)||Q(n)?S:Q(r)?b:Q(i)?y:null}const je=e({id:ne,version:`0.50.0`,content:{filter:{extensions:be},async extractFile(e,t){if(g.test(e.path))return null;let n=Ae(e);if(n===null)return null;if(n!==`arazzo`&&!d(t.config,n))return{routes:[],problems:[_(`${xe[n]} documents`)]};let r=e.path,i=Se(e.manifest),a=i??r,{rbac:o,...s}=await ce(t.io,t.config,r,n,a),c={filePath:r,kind:n,options:s,...o===void 0||!d(t.config,`rbac`)?{}:{rbac:o}};i!==void 0&&(c.source={path:i});let l=await le(t.io,t.config,a);if(l!==void 0&&(c.feedback=l),n!==`graphql`){let e=await se(t.io,t.config,r,a);Object.keys(e.config).length>0&&(c.bundleConfig=e)}let u=U.withArgs(c,{stableKey:O(r),type:`api`,metadata:Z(r,n,s,c.rbac)});if(n===`arazzo`)return{routes:[],entities:[u]};let f=Oe(e,s);s.excludeFromSearch===!0&&(f.excludeFromSearch=!0),f.type=n,c.rbac!==void 0&&(f.rbac=c.rbac);let p=H.withArgs(c,{stableKey:`api-docs:render:${r}`}),m=q.withArgs(c,{stableKey:`api-docs:sidebar:${r}`}),h=v(r);return{routes:[{deps:{[re]:p},metadata:f,routeId:`page`,sidebarSubtree:m,slug:null,slugHint:h,template:A,wildcardPrefix:!0}],entities:[u,p,m]}}},loaders:[U,H,q],templates:{[A]:r(n(`./client/template.tsx`,import.meta.url))},server:{routes:[$(j.bundle,`bundle`),$(j.deprecatedBundle,`bundle`),$(j.graphql,`graphql`)]}});function $(e,t){return{method:`GET`,path:e+oe,handler:{filePath:`./server/spec-download.ts`,importer:import.meta.url,exportName:t}}}async function Me(e,t){if(t)try{return await e.load(O(t))}catch{return}}export{je as apiDocsContentPlugin};
@@ -1 +1 @@
1
- import{isObject as e}from"../../../../../shared/utils/is-object.js";import{toContainedContentPath as t}from"../../../../ingest/scan.js";import{SPEC_KIND_ARAZZO as n}from"../../../../../shared/constants/api-spec-kinds.js";import{annotateApiDocsRbac as r}from"../../../../../shared/rbac/api-docs.js";import{resolveMarkdownAst as i}from"../../../../markdown/resolve/ast.js";import{PLAIN_DESCRIPTION_SOURCE as a,REALM_MARKDOWN_DECORATOR_KEY as o,REALM_MARKDOWN_DECORATOR_NAME as s,createMarkdownDecoratorPlugin as c}from"./markdown-decorator.js";import{ProblemError as l}from"../../../../problems/problem-error.js";import{captureSnippet as u,splitSourceLines as d}from"../../../../../shared/utils/capture-snippet.js";import{existsSync as f}from"node:fs";import{join as p}from"node:path";async function m(e){if(e.kind===`graphql`){let{parse:t}=await import(`graphql`),n;try{n=t(e.source)}catch(t){throw b(e.relativePath,t)}return{type:`graphql`,document:n,relativePath:e.relativePath,options:e.options??{},fileDependencies:[],problems:[]}}let{BaseResolver:t,bundleFromString:i,createConfig:a,getLineColLocation:o}=await import(`@redocly/openapi-core`),s=await x(a,{bundle:e.bundle??{config:{},configDir:``,plugins:[]},specRelativePath:e.relativePath,rootDir:e.contentDir,resolution:e.markdownResolution}),c=v(t,s.resolve,e.contentDir),l;try{l=await i({source:e.source,absoluteRef:p(e.contentDir,e.relativePath),config:s,externalRefResolver:c,dereference:e.kind===n})}catch(t){throw b(e.relativePath,t)}let u=l.bundle.parsed,d=T([...l.fileDependencies,...c.catalogLinkPaths],e.contentDir),f=y(l.problems,o,{contentDir:e.contentDir,specRelativePath:e.relativePath});e.markdownResolution&&await C(e.markdownResolution,e.markdownResolution.sink.pending,e.contentDir,e.pagePath??e.relativePath);let m;try{m=await h(e.kind,u)}catch(t){throw b(e.relativePath,t)}let _=g(m,e.metadata);return{type:e.kind,document:e.rbac?r(_,e.kind,e.rbac):_,relativePath:e.relativePath,options:e.options??{},fileDependencies:d,problems:f}}async function h(e,t){if(typeof t!=`object`||!t||Array.isArray(t))return t;let n=t;if(e===`openapi`&&n.swagger!==void 0){let{convertSwaggerToOpenApi:e}=await import(`@redocly/api-docs/server`);return e(n)}if(e===`asyncapi`){let{normalizeAsyncApiDefinition:e}=await import(`@redocly/api-docs/server`);return e(n)}return t}function g(t,n){if(n===void 0||!e(t))return t;let r=e(t.info)?t.info:{},i=e(r[`x-metadata`])?r[`x-metadata`]:{};return{...t,info:{...r,"x-metadata":{...i,...n}}}}const _=/^https?:\/\/.*\/_bundle\/(.*\.(?:ya?ml|json))$/u;function v(e,n,r){class i extends e{catalogLinkPaths=/* @__PURE__ */ new Set;resolveExternalRef(e,n){let i=super.resolveExternalRef(e,n),a=_.exec(i)?.[1];if(a===void 0)return i;let o=p(r,a);return t(r,o)===null?i:(this.catalogLinkPaths.add(o),f(o)?o:i)}}return new i(n)}function y(e,n,r){return e.filter(e=>e.severity===`error`&&e.ignored!==!0).map(e=>{let i=e.message.replaceAll(`${r.contentDir}/`,``),a=e.location[0],o=a?.source?t(r.contentDir,a.source.absoluteRef):null;if(a===void 0||o===null)return{code:`spec/bundle-error`,message:i,location:{filePath:r.specRelativePath}};let{start:s,end:c}=n(a),l={start:{line:s.line,character:s.col},...c?{end:{line:c.line,character:c.col}}:{}};return{code:`spec/bundle-error`,message:i,location:{filePath:o,range:l,snippet:u(d(a.source.body),l)}}})}function b(e,t){let n=t instanceof Error?t.message:String(t);return new l({code:`spec/parse-failed`,message:n,location:{filePath:e}})}function x(e,n){let{bundle:r,resolution:i}=n,a={configPath:p(n.rootDir,r.configDir,`redocly.yaml`)},l=r.plugins.map(({plugin:e,path:t})=>({...e,absolutePath:t}));if(i===void 0)return e({...r.config,plugins:l},a);let{sink:u}=i,d=c({specSourcePath:n.specRelativePath,sink:u,toContentRelative:e=>t(n.rootDir,e)});return e({...r.config,plugins:[...l,d],decorators:{...r.config.decorators,[o]:`on`,[s]:`on`}},a)}async function S(t,n,r){if(!e(t))return{};let i=[],o=(t,n)=>{if(!e(t)||!e(n))return;let o=n[a];i.push({read:()=>t.description,sourceFilePath:typeof o==`string`?o:r.specPath,writeBack:e=>{t.description=e}})},s={},c=t.servers;if(Array.isArray(c)||e(c)){s.servers=structuredClone(c);for(let[e,t]of Object.entries(c))o(s.servers[e],t)}let l=e(t.components)?t.components:void 0;if(e(l?.securitySchemes)){let e=l.securitySchemes;s.securitySchemes=structuredClone(e);for(let[t,n]of Object.entries(e))o(s.securitySchemes[t],n)}return await C(n,i,r.contentDir,r.pagePath),s}async function C(e,t,n,r){let{markdown:a,sink:o}=e,s={...e.loader,contentDir:n,markdown:a};await Promise.all(t.map(async e=>{let t=e.read();if(typeof t!=`string`||!a.looksLikeMarkdown(t))return;let{ast:n,entityDeps:c,assetUsages:l,linkRefs:u,problems:d}=await i(t,e.sourceFilePath,{resolverContext:s});o.entityDeps.push(...c),o.assetUsages.push(...l);for(let t of u)t.raw.trim().startsWith(`#`)?o.linkRefs.push(w({...t,target:r})):e.sourceFilePath===r||t.filePath!==void 0?o.linkRefs.push(w(t)):o.linkRefs.push({...w(t),filePath:e.sourceFilePath});for(let e of d)o.problems.push({...e,location:{filePath:r}});e.writeBack(n)}))}function w(e){if(e.range===void 0)return e;let t={...e};return delete t.range,t}function T(e,n){let r=/* @__PURE__ */ new Set;for(let i of e){let e=t(n,i);e!==null&&r.add(e)}return[...r].sort()}export{m as buildBundledApiDefinition,x as createBundleConfig,S as resolveLlmsDescriptions,C as resolvePendingMarkdown};
1
+ import{isObject as e}from"../../../../../shared/utils/is-object.js";import{toContainedContentPath as t}from"../../../../ingest/scan.js";import{SPEC_KIND_ARAZZO as n}from"../../../../../shared/constants/api-spec-kinds.js";import{annotateApiDocsRbac as r}from"../../../../../shared/rbac/api-docs.js";import{resolveMarkdownAst as i}from"../../../../markdown/resolve/ast.js";import{PLAIN_DESCRIPTION_SOURCE as a,REALM_MARKDOWN_DECORATOR_KEY as o,REALM_MARKDOWN_DECORATOR_NAME as s,createMarkdownDecoratorPlugin as c}from"./markdown-decorator.js";import{ProblemError as l}from"../../../../problems/problem-error.js";import{captureSnippet as u,splitSourceLines as d}from"../../../../../shared/utils/capture-snippet.js";import{existsSync as f}from"node:fs";import{join as p}from"node:path";async function m(e){if(e.kind===`graphql`){let{parse:t}=await import(`graphql`),n;try{n=t(e.source)}catch(t){throw b(e.relativePath,t)}return{type:`graphql`,document:n,relativePath:e.relativePath,options:e.options??{},fileDependencies:[],problems:[]}}let{BaseResolver:t,bundleFromString:i,createConfig:a,getLineColLocation:o}=await import(`@redocly/openapi-core`),s=await x(a,{bundle:e.bundle??{config:{},configDir:``,plugins:[]},specRelativePath:e.relativePath,rootDir:e.contentDir,resolution:e.markdownResolution}),c=v(t,s.resolve,e.contentDir),l;try{l=await i({source:e.source,absoluteRef:p(e.contentDir,e.relativePath),config:s,externalRefResolver:c,dereference:e.kind===n})}catch(t){throw b(e.relativePath,t)}let u=l.bundle.parsed,d=T([...l.fileDependencies,...c.catalogLinkPaths],e.contentDir),f=y(l.problems,o,{contentDir:e.contentDir,specRelativePath:e.relativePath});e.markdownResolution&&await C(e.markdownResolution,e.markdownResolution.sink.pending,e.contentDir,e.pagePath??e.relativePath);let m;try{m=await h(e.kind,u)}catch(t){throw b(e.relativePath,t)}let _=g(m,e.metadata);return{type:e.kind,document:e.rbac?r(_,e.kind,e.rbac):_,relativePath:e.relativePath,options:e.options??{},fileDependencies:d,problems:f}}async function h(e,t){if(typeof t!=`object`||!t||Array.isArray(t))return t;let n=t;if(e===`openapi`&&n.swagger!==void 0){let{convertSwaggerToOpenApi:e}=await import(`@redocly/api-docs/server`);return e(n)}if(e===`asyncapi`){let{normalizeAsyncApiDefinition:e}=await import(`@redocly/api-docs/server`);return e(n)}return t}function g(t,n){if(n===void 0||!e(t))return t;let r=e(t.info)?t.info:{},i=e(r[`x-metadata`])?r[`x-metadata`]:{};return{...t,info:{...r,"x-metadata":{...i,...n}}}}const _=/^https?:\/\/.*\/_bundle\/(.*\.(?:ya?ml|json))$/u;function v(e,n,r){class i extends e{catalogLinkPaths=/* @__PURE__ */ new Set;resolveExternalRef(e,n){let i=super.resolveExternalRef(e,n),a=_.exec(i)?.[1];if(a===void 0)return i;let o=p(r,a);return t(r,o)===null?i:(this.catalogLinkPaths.add(o),f(o)?o:i)}}return new i(n)}function y(e,n,r){return e.filter(e=>e.severity===`error`&&e.ignored!==!0).map(e=>{let i=e.message.replaceAll(`${r.contentDir}/`,``),a=e.location[0],o=a?.source?t(r.contentDir,a.source.absoluteRef):null;if(a===void 0||o===null)return{code:`spec/bundle-error`,message:i,location:{filePath:r.specRelativePath}};let{start:s,end:c}=n(a),l={start:{line:s.line,character:s.col},...c?{end:{line:c.line,character:c.col}}:{}};return{code:`spec/bundle-error`,message:i,location:{filePath:o,range:l,snippet:u(d(a.source.body),l)}}})}function b(e,t){let n=t instanceof Error?t.message:String(t);return new l({code:`spec/parse-failed`,message:n,location:{filePath:e}})}function x(e,n){let{bundle:r,resolution:i}=n,a=p(n.rootDir,r.configDir,`redocly.yaml`),l={configPath:p(a,`redocly.yaml`)},u=async(t,n)=>{let r=await e(t,n);return r.configPath=a,r},d=r.plugins.map(({plugin:e,path:t})=>({...e,absolutePath:t}));if(i===void 0)return u({...r.config,plugins:d},l);let{sink:f}=i,m=c({specSourcePath:n.specRelativePath,sink:f,toContentRelative:e=>t(n.rootDir,e)});return u({...r.config,plugins:[...d,m],decorators:{...r.config.decorators,[o]:`on`,[s]:`on`}},l)}async function S(t,n,r){if(!e(t))return{};let i=[],o=(t,n)=>{if(!e(t)||!e(n))return;let o=n[a];i.push({read:()=>t.description,sourceFilePath:typeof o==`string`?o:r.specPath,writeBack:e=>{t.description=e}})},s={},c=t.servers;if(Array.isArray(c)||e(c)){s.servers=structuredClone(c);for(let[e,t]of Object.entries(c))o(s.servers[e],t)}let l=e(t.components)?t.components:void 0;if(e(l?.securitySchemes)){let e=l.securitySchemes;s.securitySchemes=structuredClone(e);for(let[t,n]of Object.entries(e))o(s.securitySchemes[t],n)}return await C(n,i,r.contentDir,r.pagePath),s}async function C(e,t,n,r){let{markdown:a,sink:o}=e,s={...e.loader,contentDir:n,markdown:a};await Promise.all(t.map(async e=>{let t=e.read();if(typeof t!=`string`||!a.looksLikeMarkdown(t))return;let{ast:n,entityDeps:c,assetUsages:l,linkRefs:u,problems:d}=await i(t,e.sourceFilePath,{resolverContext:s});o.entityDeps.push(...c),o.assetUsages.push(...l);for(let t of u)t.raw.trim().startsWith(`#`)?o.linkRefs.push(w({...t,target:r})):e.sourceFilePath===r||t.filePath!==void 0?o.linkRefs.push(w(t)):o.linkRefs.push({...w(t),filePath:e.sourceFilePath});for(let e of d)o.problems.push({...e,location:{filePath:r}});e.writeBack(n)}))}function w(e){if(e.range===void 0)return e;let t={...e};return delete t.range,t}function T(e,n){let r=/* @__PURE__ */ new Set;for(let i of e){let e=t(n,i);e!==null&&r.add(e)}return[...r].sort()}export{m as buildBundledApiDefinition,x as createBundleConfig,S as resolveLlmsDescriptions,C as resolvePendingMarkdown};
@@ -1,26 +1,26 @@
1
- import"../../../../../shared/rbac/types.js";import{canView as e,isRbacScope as t,resolveRole as n}from"../../../../../shared/rbac/engine.js";import{isObject as r}from"../../../../../shared/utils/is-object.js";import{headingSlugger as i}from"../../../../markdown/utils/heading-slugger.js";import{parseMarkdown as a}from"../../../../markdown/utils/parse-cache.js";import{SPEC_DOWNLOAD_ROUTE_PATHS as o}from"./shared.js";import{markdocAstToMarkdownChunks as s}from"../../../../markdown/search/to-markdown.js";import{REDOCLY_TEAMS_RBAC as c}from"@redocly/config";const l=t=>{let r=f(t);return r===void 0||e(n(r,[`anonymous`]))},u=e=>!l(e);function d(e,t,n,i={}){let o=/* @__PURE__ */ new Map,c=e=>{let t=b(e)?e:{type:`document`,children:Array.isArray(e)?e:[e]};return s(t,i)},u=e=>{if(typeof e!=`string`)return c(e);if(!e.includes(`{%`)){let t=e.trim();return t===``?[]:[t]}let t=o.get(e);return t===void 0&&(t=c(a(e)),o.set(e,t)),t},d=[],h=/* @__PURE__ */ new Set,g=e.items,_=r(e.store)?e.store.schemaStore:{},S=r(t)?t:void 0,C=S?.security,w=r(S?.info)?S.info:{},T=(e,t,n,r,i)=>{d.push({routeSlug:t,chunks:n,headings:p(n),...typeof r==`string`&&r!==``?{title:r}:{},...i?{description:i}:{},...e===void 0?{}:{rbacScope:e}})},E=r(w[`x-metadata`])?w[`x-metadata`]:{},D=u((typeof E.description==`string`?E.description:void 0)??w.description).join(`
1
+ import{isObject as e}from"../../../../../shared/utils/is-object.js";import{headingSlugger as t}from"../../../../markdown/utils/heading-slugger.js";import"../../../../../shared/rbac/types.js";import{canView as n,isRbacScope as r,resolveRole as i}from"../../../../../shared/rbac/engine.js";import{parseMarkdown as a}from"../../../../markdown/utils/parse-cache.js";import{SPEC_DOWNLOAD_ROUTE_PATHS as o}from"./shared.js";import{markdocAstToMarkdownChunks as s}from"../../../../markdown/search/to-markdown.js";import{REDOCLY_TEAMS_RBAC as c}from"@redocly/config";const l=e=>{let t=f(e);return t===void 0||n(i(t,[`anonymous`]))},u=e=>!l(e);function d(t,n,r,i={}){let o=/* @__PURE__ */ new Map,c=e=>{let t=b(e)?e:{type:`document`,children:Array.isArray(e)?e:[e]};return s(t,i)},u=e=>{if(typeof e!=`string`)return c(e);if(!e.includes(`{%`)){let t=e.trim();return t===``?[]:[t]}let t=o.get(e);return t===void 0&&(t=c(a(e)),o.set(e,t)),t},d=[],h=/* @__PURE__ */ new Set,g=t.items,_=e(t.store)?t.store.schemaStore:{},S=e(n)?n:void 0,C=S?.security,w=e(S?.info)?S.info:{},T=(e,t,n,r,i)=>{d.push({routeSlug:t,chunks:n,headings:p(n),...typeof r==`string`&&r!==``?{title:r}:{},...i?{description:i}:{},...e===void 0?{}:{rbacScope:e}})},E=e(w[`x-metadata`])?w[`x-metadata`]:{},D=u((typeof E.description==`string`?E.description:void 0)??w.description).join(`
2
2
 
3
- `),O=/* @__PURE__ */ new Map,k=e=>{typeof e.link==`string`&&!O.has(e.link)&&l(e)&&O.set(e.link,f(e));for(let t of e.items??[])k(t)};for(let e of g)k(e);let A=t=>{let r=t.content,i=r?.contentType??(t.items?.length&&t.link?`group`:void 0);if(typeof t.link==`string`&&i!==void 0){let a=i===`overview`,o=t.link,s=O.has(o)?O.get(o):f(t);if(!h.has(o)){if(a&&r)h.add(o),T(s,o,m({doc:S,info:w,description:D,specType:e.specType,items:g,originFilePath:n,renderMarkdown:u}),w.title,D);else if(i===`item`&&r)h.add(o),T(s,o,y(t,{info:w,schemaStore:_,document:S,globalSecurity:C,specType:e.specType,renderMarkdown:u}),t.label);else if(i===`group`){h.add(o);let e=t.deprecated===!0||r?.meta?.deprecated===!0,n=v(t.items??[],u);T(s,o,[`# ${t.label??``}${e?` (deprecated)`:``}`.trim(),...x(r?.children??[],u),...n?[n]:[]].filter(e=>e!==``),t.label)}}}for(let e of t.items??[])A(e)};for(let e of g)A(e);return d}function f(e){let n=e[c];if(n!==void 0)return t(n)?n:{}}function p(e){return i.reset(),e.map(e=>{let t=/^#{1,6} +(?! )(.+)$/.exec(e.split(`
4
- `,1)[0]??``);if(!t)return null;let n=t[1].trim();return{heading:n,anchor:i.slug(n)}})}function m(e){let{doc:t,info:n}=e,i=[],a=[];typeof n.title==`string`&&n.title&&a.push(`# ${n.title}`),e.description&&a.push(e.description),typeof n.summary==`string`&&n.summary&&a.push(n.summary);let o=[];n.version!==void 0&&n.version!==``&&o.push(`Version: ${String(n.version)}`);let s=r(n.license)?n.license:void 0;typeof s?.name==`string`&&o.push(`License: ${s.name}`);let c=r(n[`x-metadata`])?n[`x-metadata`]:void 0;if(c){let e=Object.entries(c).filter(([,e])=>typeof e==`string`||typeof e==`number`).filter(([e,t])=>e!==`description`||typeof t!=`string`).map(([e,t])=>`- ${e}: ${String(t)}`);e.length>0&&o.push(`Metadata:\n${e.join(`
3
+ `),O=/* @__PURE__ */ new Map,k=e=>{typeof e.link==`string`&&!O.has(e.link)&&l(e)&&O.set(e.link,f(e));for(let t of e.items??[])k(t)};for(let e of g)k(e);let A=e=>{let n=e.content,i=n?.contentType??(e.items?.length&&e.link?`group`:void 0);if(typeof e.link==`string`&&i!==void 0){let a=i===`overview`,o=e.link,s=O.has(o)?O.get(o):f(e);if(!h.has(o)){if(a&&n)h.add(o),T(s,o,m({doc:S,info:w,description:D,specType:t.specType,items:g,originFilePath:r,renderMarkdown:u}),w.title,D);else if(i===`item`&&n)h.add(o),T(s,o,y(e,{info:w,schemaStore:_,document:S,globalSecurity:C,specType:t.specType,renderMarkdown:u}),e.label);else if(i===`group`){h.add(o);let t=e.deprecated===!0||n?.meta?.deprecated===!0,r=v(e.items??[],u);T(s,o,[`# ${e.label??``}${t?` (deprecated)`:``}`.trim(),...x(n?.children??[],u),...r?[r]:[]].filter(e=>e!==``),e.label)}}}for(let t of e.items??[])A(t)};for(let e of g)A(e);return d}function f(e){let t=e[c];if(t!==void 0)return r(t)?t:{}}function p(e){return t.reset(),e.map(e=>{let n=/^#{1,6} +(?! )(.+)$/.exec(e.split(`
4
+ `,1)[0]??``);if(!n)return null;let r=n[1].trim();return{heading:r,anchor:t.slug(r)}})}function m(t){let{doc:n,info:r}=t,i=[],a=[];typeof r.title==`string`&&r.title&&a.push(`# ${r.title}`),t.description&&a.push(t.description),typeof r.summary==`string`&&r.summary&&a.push(r.summary);let o=[];r.version!==void 0&&r.version!==``&&o.push(`Version: ${String(r.version)}`);let s=e(r.license)?r.license:void 0;typeof s?.name==`string`&&o.push(`License: ${s.name}`);let c=e(r[`x-metadata`])?r[`x-metadata`]:void 0;if(c){let e=Object.entries(c).filter(([,e])=>typeof e==`string`||typeof e==`number`).filter(([e,t])=>e!==`description`||typeof t!=`string`).map(([e,t])=>`- ${e}: ${String(t)}`);e.length>0&&o.push(`Metadata:\n${e.join(`
5
5
  `)}`)}o.length>0&&a.push(o.join(`
6
6
  `)),a.length>0&&i.push(a.join(`
7
7
 
8
- `));let l=h(t,e.renderMarkdown);l&&i.push(l);let u=g(t,e.renderMarkdown);u&&i.push(u);let d=_(e.specType,n,e.originFilePath);d&&i.push(d);let f=v(e.items,e.renderMarkdown);return f&&i.push(f),i}function h(e,t){let n=e?.servers;if(!Array.isArray(n)||n.length===0)return;let i=`## Servers
8
+ `));let l=h(n,t.renderMarkdown);l&&i.push(l);let u=g(n,t.renderMarkdown);u&&i.push(u);let d=_(t.specType,r,t.originFilePath);d&&i.push(d);let f=v(t.items,t.renderMarkdown);return f&&i.push(f),i}function h(t,n){let r=t?.servers;if(!Array.isArray(r)||r.length===0)return;let i=`## Servers
9
9
 
10
- `;for(let e of n){if(!r(e))continue;let n=t(e.description).join(`
10
+ `;for(let t of r){if(!e(t))continue;let r=n(t.description).join(`
11
11
 
12
- `);if(n&&(i+=`${n}\n`),i+=`\`\`\`\n${String(e.url??``)}\n\`\`\`\n\n`,r(e.variables)){i+=`Variables:
13
- `;for(let[n,a]of Object.entries(e.variables)){if(!r(a))continue;let e=t(a.description).join(` `).replace(/\s+/g,` `);i+=`- \`${n}\`${e?`: ${e}`:``}\n`,a.default!==void 0&&(i+=` Default: ${JSON.stringify(a.default)}\n`),Array.isArray(a.enum)&&(i+=` Enum: ${a.enum.map(e=>JSON.stringify(e)).join(`, `)}\n`)}i+=`
14
- `}}return i.trim()}function g(e,t){let n=r(e?.components)?e.components:void 0,i=r(n?.securitySchemes)?n.securitySchemes:void 0;if(!i)return;let a=`## Security
12
+ `);if(r&&(i+=`${r}\n`),i+=`\`\`\`\n${String(t.url??``)}\n\`\`\`\n\n`,e(t.variables)){i+=`Variables:
13
+ `;for(let[r,a]of Object.entries(t.variables)){if(!e(a))continue;let t=n(a.description).join(` `).replace(/\s+/g,` `);i+=`- \`${r}\`${t?`: ${t}`:``}\n`,a.default!==void 0&&(i+=` Default: ${JSON.stringify(a.default)}\n`),Array.isArray(a.enum)&&(i+=` Enum: ${a.enum.map(e=>JSON.stringify(e)).join(`, `)}\n`)}i+=`
14
+ `}}return i.trim()}function g(t,n){let r=e(t?.components)?t.components:void 0,i=e(r?.securitySchemes)?r.securitySchemes:void 0;if(!i)return;let a=`## Security
15
15
 
16
- `;for(let[e,n]of Object.entries(i)){if(!r(n)||`$ref`in n)continue;a+=`### ${e}\n\n`;let i=t(n.description).join(`
16
+ `;for(let[t,r]of Object.entries(i)){if(!e(r)||`$ref`in r)continue;a+=`### ${t}\n\n`;let i=n(r.description).join(`
17
17
 
18
- `);i&&(a+=`${i}\n\n`);for(let[e,t]of[[`Type`,`type`],[`In`,`in`],[`Name`,`name`],[`Scheme`,`scheme`],[`Bearer Format`,`bearerFormat`],[`OpenID Connect URL`,`openIdConnectUrl`]])typeof n[t]==`string`&&n[t]&&(a+=`${e}: ${n[t]}\n`);let o=r(n.flows)?n.flows:void 0,s=[o?.implicit,o?.password,o?.clientCredentials,o?.authorizationCode].find(r);if(s&&(typeof s.authorizationUrl==`string`&&(a+=`Authorization URL: ${s.authorizationUrl}\n`),typeof s.tokenUrl==`string`&&(a+=`Token URL: ${s.tokenUrl}\n`),r(s.scopes))){a+=`Scopes:
18
+ `);i&&(a+=`${i}\n\n`);for(let[e,t]of[[`Type`,`type`],[`In`,`in`],[`Name`,`name`],[`Scheme`,`scheme`],[`Bearer Format`,`bearerFormat`],[`OpenID Connect URL`,`openIdConnectUrl`]])typeof r[t]==`string`&&r[t]&&(a+=`${e}: ${r[t]}\n`);let o=e(r.flows)?r.flows:void 0,s=[o?.implicit,o?.password,o?.clientCredentials,o?.authorizationCode].find(e);if(s&&(typeof s.authorizationUrl==`string`&&(a+=`Authorization URL: ${s.authorizationUrl}\n`),typeof s.tokenUrl==`string`&&(a+=`Token URL: ${s.tokenUrl}\n`),e(s.scopes))){a+=`Scopes:
19
19
  `;for(let[e,t]of Object.entries(s.scopes))a+=`- \`${e}\`: ${String(t)}\n`}a+=`
20
20
  `}return a.trim()}function _(e,t,n){if(!n)return;let r=typeof t.title==`string`&&t.title?t.title:void 0;if(e===`openapi`||e===`asyncapi`){let t=e===`openapi`?`OpenAPI`:`AsyncAPI`;return`## Download ${t} description\n\n[${r??`${t} definition`}](${o.bundle}/${n})`}if(e===`graphql`)return`## Download GraphQL schema\n\n[${r??`GraphQL schema`}](${o.graphql}/${n})`}function v(e,t){let n=``,r=(e,i)=>{for(let a of e)if(l(a)&&typeof a.link==`string`){if(a.content?.contentType===`group`)n+=`${i} ${a.label??``}\n\n`,a.items?.length&&r(a.items,`${i}#`);else if(a.content?.contentType===`item`){let e=a.httpVerb&&a.httpPath?`${a.httpVerb.toUpperCase()} ${a.httpPath}`:a.label??``,r=S(a.content.children??[],t),i=r?`: ${r.slice(0,200)}`:``;n+=`- [${e}](${a.link}.md)${i}\n`}}};return r(e,`##`),n.trim()===``?void 0:n.trim()}function y(e,t){let n=e.content,r=n?.children??[],i=e.deprecated===!0||n?.meta?.deprecated===!0,a=[`# ${e.label??``}${i?` (deprecated)`:``}`.trim()];a.push(...x(r,t.renderMarkdown));let o=[];if(t.specType===`openapi`||t.specType===`asyncapi`){e.httpVerb&&e.httpPath?o.push(`Endpoint: ${e.httpVerb.toUpperCase()} ${e.httpPath}`):e.httpVerb&&o.push(`Method: ${e.httpVerb.toUpperCase()}`),t.info.version!==void 0&&t.info.version!==``&&o.push(`Version: ${String(t.info.version)}`);let n=C(r,t.globalSecurity);n&&o.push(`Security: ${n}`)}if(o.length>0&&a.push(o.join(`
21
21
  `)),t.specType!==`graphql`){let e=w(r,{schemaStore:t.schemaStore,document:t.document,renderMarkdown:t.renderMarkdown});e.length>0&&a.push(F(e))}return a.filter(e=>e!==``)}function b(e){return typeof e==`object`&&!!e&&e.type===`document`}function x(e,t){let n=[],r=e=>{if(!u(e)){if(e.nodeType===`markdoc`){n.push(...t(e.content));return}if(e.nodeType===`container`||e.nodeType===`overview-section-wrapper`)for(let t of e.children??[])r(t)}};for(let t of e)r(t);return n}function S(e,t){return x(e,t).join(` `).replace(/\s+/g,` `).trim()}function C(e,t){let n=[],r=e=>{for(let t of e)if(t.nodeType===`security`){let e=t.requirements;for(let t of e??[])for(let e of t.schemes??[])u(e)||e.name&&!n.includes(e.name)&&n.push(e.name)}else(t.nodeType===`container`||t.nodeType===`overview-section-wrapper`)&&r(t.children??[])};if(r(e),n.length>0)return n.join(`, `);if(t?.length){let e=[...new Set(t.flatMap(e=>Object.keys(e)))];if(e.length>0)return e.join(`, `)}}function w(e,t){let n=/* @__PURE__ */ new Map,r=/* @__PURE__ */ new Set,i=e=>{for(let a of e)if(a.nodeType===`item-content`){if(u(a))continue;for(let e of a.parameters??[])!u(e)&&e.name&&T(n,{name:e.name,path:[],place:D(a.variant),type:k(e.schemaId,t),required:e.required??!1,description:E(e.description,t.renderMarkdown)});O(a,n,r,t)}else if(a.nodeType===`container`||a.nodeType===`overview-section-wrapper`){if(u(a))continue;i(a.children??[])}};return i(e),[...n.values()]}function T(e,t){e.set([...t.path,t.name].join(`.`)+t.description+t.place,t)}function E(e,t){return e==null?``:t(e).join(`
22
22
 
23
- `)}function D(e){switch(e){case`query`:return`query parameters`;case`path`:return`path parameters`;case`headers`:return`header parameters`;case`cookies`:return`cookie parameters`;case`parameters`:return`channel parameters`;case`body`:return`request fields`;case`responses`:return`response fields`;default:return e?`${e} parameters`:`parameters`}}function O(e,t,n,r){let i=D(e.variant),a=i.startsWith(`response`);if(e.mediaTypeSchemas){let o=Object.values(e.mediaTypeSchemas).find(e=>!u(e));o?.schemaId&&A(o.schemaId,i,a,t,n,r)}else e.schemaId&&A(e.schemaId,i,a,t,n,r);for(let n of e.responses??[]){if(u(n))continue;let e=`response ${n.code??``} fields`.replace(` `,` `),i=/* @__PURE__ */ new Set,a=(n.mediaTypeContent?Object.values(n.mediaTypeContent).find(e=>!u(e)):void 0)?.schemaId??n.schemaId;a&&A(a,e,!0,t,i,r)}for(let n of e.messages??[])!u(n)&&n.name&&T(t,{name:n.name,path:[],place:`message`,type:`unknown`,required:!1,description:`${E(n.description,r.renderMarkdown)} ${n.summary??``}`.trim()})}function k(e,t){if(!e)return`unknown`;let n=t.schemaStore[e];return!r(n)||n.kind!==`json-schema`?`unknown`:N(M(n.data,t))}function A(e,t,n,i,a,o){let s=o.schemaStore[e];r(s)&&s.kind===`json-schema`&&!u(s)&&P(s.data,t,n,i,[],a,0,o)}function j(e,t){if(!e.startsWith(`#/`)||!t.document)return;let n=t.document;for(let t of e.slice(2).split(`/`)){if(typeof n!=`object`||!n)return;n=n[t]}return r(n)?n:void 0}function M(e,t){if(e.allOf){let n={};for(let r of e.allOf){let e=r.$ref?j(r.$ref,t):r;if(e&&!u(e)){let t=n.properties,r=n.required;Object.assign(n,e),(t||e.properties)&&(n.properties={...t??{},...e.properties??{}}),(r||e.required)&&(n.required=[...r??[],...e.required??[]])}}return delete n.allOf,e.description&&(n.description=e.description),n}if(e.$ref){let n=j(e.$ref,t);if(n){let t={...n};return e.description&&(t.description=e.description),t}}return e}function N(e){return Array.isArray(e.type)?e.type.join(` | `):e.type?e.type:e.properties||e.additionalProperties?`object`:e.items?`array`:e.enum?`string`:`any`}function P(e,t,n,i,a,o,s,c){if(!(s>10||u(e))){if(e.$ref){if(o.has(e.$ref))return;o.add(e.$ref);let r=j(e.$ref,c);r&&P(r,t,n,i,a,o,s,c);return}if(e.allOf){P(M(e,c),t,n,i,a,o,s,c);return}if(e.discriminator&&e.properties&&e.oneOf){P({...e,oneOf:void 0,discriminator:void 0},t,n,i,a,o,s,c);return}if(e.oneOf||e.anyOf){for(let r of e.oneOf??e.anyOf??[]){if(r.$ref){if(o.has(r.$ref))continue;o.add(r.$ref)}let e=r.$ref?j(r.$ref,c):r;e&&P(e,t,n,i,a,o,s+1,c)}return}if(e.properties){let r=e.required??[];for(let[l,d]of Object.entries(e.properties)){if(u(d))continue;if(d.$ref){if(o.has(d.$ref))continue;o.add(d.$ref)}let e=d.$ref?j(d.$ref,c):d;if(!e)continue;let f=M(e,c);if(u(e)||u(f)||f.readOnly&&!n||f.writeOnly&&n||e.additionalProperties!==void 0&&!e.properties)continue;let p=e.example??f.example;T(i,{name:l,path:a,place:t,type:N(f),required:r.includes(l),description:E(e.description??f.description,c.renderMarkdown),enumValues:Array.isArray(f.enum)&&f.enum.length>0?f.enum:void 0,example:p===void 0?void 0:(typeof p==`string`?p:JSON.stringify(p)).slice(0,200)}),(f.properties||f.items)&&P(f,t,n,i,[...a,l],o,s+1,c)}}if(e.items&&r(e.items)&&!Array.isArray(e.items)){let r=e.items;if(r.$ref){if(o.has(r.$ref))return;o.add(r.$ref)}let l=r.$ref?j(r.$ref,c):r;l&&P(l,t,n,i,a,o,s+1,c)}}}function F(e){let t=/* @__PURE__ */ new Map;for(let n of e){let e=t.get(n.place);e?e.push(n):t.set(n.place,[n])}let n=[];for(let[e,r]of t){let t=r.map(e=>{let t=`- \`${[...e.path,e.name].join(`.`)}\` (${e.type}${e.required?`, required`:``})`,n=e.description.replace(/\s+/g,` `).trim();return n&&(t+=`\n ${n}`),e.enumValues?t+=`\n Enum: ${e.enumValues.map(e=>JSON.stringify(e)).join(`, `)}`:e.example&&(t+=`\n Example: ${e.example}`),t});n.push(`## ${e.charAt(0).toUpperCase()}${e.slice(1)}\n\n${t.join(`
23
+ `)}function D(e){switch(e){case`query`:return`query parameters`;case`path`:return`path parameters`;case`headers`:return`header parameters`;case`cookies`:return`cookie parameters`;case`parameters`:return`channel parameters`;case`body`:return`request fields`;case`responses`:return`response fields`;default:return e?`${e} parameters`:`parameters`}}function O(e,t,n,r){let i=D(e.variant),a=i.startsWith(`response`);if(e.mediaTypeSchemas){let o=Object.values(e.mediaTypeSchemas).find(e=>!u(e));o?.schemaId&&A(o.schemaId,i,a,t,n,r)}else e.schemaId&&A(e.schemaId,i,a,t,n,r);for(let n of e.responses??[]){if(u(n))continue;let e=`response ${n.code??``} fields`.replace(` `,` `),i=/* @__PURE__ */ new Set,a=(n.mediaTypeContent?Object.values(n.mediaTypeContent).find(e=>!u(e)):void 0)?.schemaId??n.schemaId;a&&A(a,e,!0,t,i,r)}for(let n of e.messages??[])!u(n)&&n.name&&T(t,{name:n.name,path:[],place:`message`,type:`unknown`,required:!1,description:`${E(n.description,r.renderMarkdown)} ${n.summary??``}`.trim()})}function k(t,n){if(!t)return`unknown`;let r=n.schemaStore[t];return!e(r)||r.kind!==`json-schema`?`unknown`:N(M(r.data,n))}function A(t,n,r,i,a,o){let s=o.schemaStore[t];e(s)&&s.kind===`json-schema`&&!u(s)&&P(s.data,n,r,i,[],a,0,o)}function j(t,n){if(!t.startsWith(`#/`)||!n.document)return;let r=n.document;for(let e of t.slice(2).split(`/`)){if(typeof r!=`object`||!r)return;r=r[e]}return e(r)?r:void 0}function M(e,t){if(e.allOf){let n={};for(let r of e.allOf){let e=r.$ref?j(r.$ref,t):r;if(e&&!u(e)){let t=n.properties,r=n.required;Object.assign(n,e),(t||e.properties)&&(n.properties={...t??{},...e.properties??{}}),(r||e.required)&&(n.required=[...r??[],...e.required??[]])}}return delete n.allOf,e.description&&(n.description=e.description),n}if(e.$ref){let n=j(e.$ref,t);if(n){let t={...n};return e.description&&(t.description=e.description),t}}return e}function N(e){return Array.isArray(e.type)?e.type.join(` | `):e.type?e.type:e.properties||e.additionalProperties?`object`:e.items?`array`:e.enum?`string`:`any`}function P(t,n,r,i,a,o,s,c){if(!(s>10||u(t))){if(t.$ref){if(o.has(t.$ref))return;o.add(t.$ref);let e=j(t.$ref,c);e&&P(e,n,r,i,a,o,s,c);return}if(t.allOf){P(M(t,c),n,r,i,a,o,s,c);return}if(t.discriminator&&t.properties&&t.oneOf){P({...t,oneOf:void 0,discriminator:void 0},n,r,i,a,o,s,c);return}if(t.oneOf||t.anyOf){for(let e of t.oneOf??t.anyOf??[]){if(e.$ref){if(o.has(e.$ref))continue;o.add(e.$ref)}let t=e.$ref?j(e.$ref,c):e;t&&P(t,n,r,i,a,o,s+1,c)}return}if(t.properties){let e=t.required??[];for(let[l,d]of Object.entries(t.properties)){if(u(d))continue;if(d.$ref){if(o.has(d.$ref))continue;o.add(d.$ref)}let t=d.$ref?j(d.$ref,c):d;if(!t)continue;let f=M(t,c);if(u(t)||u(f)||f.readOnly&&!r||f.writeOnly&&r||t.additionalProperties!==void 0&&!t.properties)continue;let p=t.example??f.example;T(i,{name:l,path:a,place:n,type:N(f),required:e.includes(l),description:E(t.description??f.description,c.renderMarkdown),enumValues:Array.isArray(f.enum)&&f.enum.length>0?f.enum:void 0,example:p===void 0?void 0:(typeof p==`string`?p:JSON.stringify(p)).slice(0,200)}),(f.properties||f.items)&&P(f,n,r,i,[...a,l],o,s+1,c)}}if(t.items&&e(t.items)&&!Array.isArray(t.items)){let e=t.items;if(e.$ref){if(o.has(e.$ref))return;o.add(e.$ref)}let l=e.$ref?j(e.$ref,c):e;l&&P(l,n,r,i,a,o,s+1,c)}}}function F(e){let t=/* @__PURE__ */ new Map;for(let n of e){let e=t.get(n.place);e?e.push(n):t.set(n.place,[n])}let n=[];for(let[e,r]of t){let t=r.map(e=>{let t=`- \`${[...e.path,e.name].join(`.`)}\` (${e.type}${e.required?`, required`:``})`,n=e.description.replace(/\s+/g,` `).trim();return n&&(t+=`\n ${n}`),e.enumValues?t+=`\n Enum: ${e.enumValues.map(e=>JSON.stringify(e)).join(`, `)}`:e.example&&(t+=`\n Example: ${e.example}`),t});n.push(`## ${e.charAt(0).toUpperCase()}${e.slice(1)}\n\n${t.join(`
24
24
  `)}`)}return n.join(`
25
25
 
26
26
  `)}export{d as buildApiDocsMarkdownDocs};
@@ -1 +1 @@
1
- import{isPlanFeatureGranted as e}from"../../../../../shared/plan-gates.js";import{toPosixPath as t}from"../../../../../shared/utils/to-posix-path.js";import{isMissingError as n}from"../../../../../shared/utils/is-missing-error.js";import{isObject as r}from"../../../../../shared/utils/is-object.js";import{NESTED_CONFIG_FILENAME as i,deepMergeConfig as a,parseNestedConfig as o}from"../../../../config.js";import{contentIgnoreMatcherOf as s}from"../../../../ingest/scan.js";import{SPEC_KIND_GRAPHQL as c}from"../../../../../shared/constants/api-spec-kinds.js";import{MOCK_SERVER_ROUTE_PREFIX as l,mockPathPrefix as u}from"../../../types/api-entity.js";import{withPathPrefix as d}from"../../../../../shared/path-prefix.js";import{SPEC_DOWNLOAD_ROUTE_PATHS as f}from"./shared.js";import{posix as p}from"node:path";import{decoratorTypes as m,preprocessorTypes as h}from"@redocly/config";import{FEEDBACK_TYPES as g}from"@redocly/theme/core/constants";const _=[`openapi`,`asyncapi`,`graphql`];function v(e,t,n){let r=O(t),i=Object.values(e.apis??{}),a=e=>O(p.join(n,e))===r;return i.find(e=>e.output!==void 0&&a(e.output))??i.find(e=>e.output===void 0&&a(e.root))}function y(e,t,n=``){let r=v(e,t,n);if(!r)return{};let i={};r.metadata&&(i.metadata=r.metadata);for(let e of _)r[e]&&typeof r[e]==`object`&&Object.assign(i,r[e]);return r.rbac!==void 0&&(i.rbac=r.rbac),i}async function b(e,t,n,r,i=n){let o=T(t,r),c=await w(e,i,s(t));return c===null?a(o,y(t,n)):a(a(o,E(c.config,r)),y(c.config,n,c.dir))}const x=[...m,...h];async function S(e,t,n,i=n){let o=await w(e,i,s(t)),c=o===null?[t,v(t,n,``)]:[t,o.config,v(o.config,n,o.dir)],l={};for(let e of c){if(!r(e))continue;let t={};for(let n of x)r(e[n])&&(t[n]=e[n]);l=a(l,t)}return{config:l,configDir:o?.dir??``}}async function C(e,t,n){return(await w(e,n,s(t)))?.config.feedback}async function w(e,t,n){for(let r=p.dirname(t);r!==`.`&&r!==`/`;r=p.dirname(r)){let t=p.join(r,i);if(n(t))continue;let a=await D(e,t);if(a!==null)return{config:a,dir:r}}return null}function T(e,t){return t===`arazzo`?{}:e[t]??{}}function E(e,t){let n={...T(e,t)};return e.mockServer&&(n.mockServer=e.mockServer),n}async function D(e,t){let r;try{r=await e.readFile(t)}catch(e){if(n(e))return null;throw e}return o(r,t).config}function O(e){return p.normalize(t(e)).replace(/^\.\/+/,``).replace(/^\/+/,``)}function k(t,n,i){let a=r(t.mockServer)?t.mockServer:{},o={...n.mockServer,...a};if(i===void 0||o.off===!0||!e(n,`mockServer`))return t;let s=d(l+u(i));return{...t,mockServer:{url:s,position:`first`,description:`Mock server`,...o}}}function A(e,t,n){let r=e=>e.split(`/`).map(encodeURIComponent).join(`/`),i=n===c,a=i?f.graphql:f.bundle,o=(i?[t]:[`.json`,`.yaml`].map(e=>t.replace(/\.[^./]+$/u,e))).map(e=>({url:d(`${a}/${r(e)}?download`),title:p.basename(e)}));return{...e,downloadUrls:Array.isArray(e.downloadUrls)?e.downloadUrls:o,replayDefinitionUrl:o[0]?.url}}function j(e){return d(`${f.bundle}/${e}`)}const M={[g.RATING]:`Rate this section`,[g.SENTIMENT]:`Was this section helpful?`,[g.MOOD]:`Was this section helpful?`,[g.COMMENT]:`Share your feedback about this section`,[g.SCALE]:`How would you rate this section?`};function N(e,t,n){let i=[r(t)?t[`x-feedback`]:void 0,e.feedback,n].find(r);if(i===void 0)return e;let a=r(i.settings)?i.settings:{},o=typeof i.type==`string`?M[i.type]:void 0,s=a.label||o||``;return{...e,feedback:{...i,settings:{...a,label:s}}}}export{y as readApiOptionsFromConfig,S as resolveApiBundleConfig,b as resolveApiOptions,C as resolveNestedFeedback,j as schemaCatalogLink,A as withDownloadUrls,N as withFeedbackOption,k as withMockServerOption};
1
+ import{isPlanFeatureGranted as e}from"../../../../../shared/plan-gates.js";import{toPosixPath as t}from"../../../../../shared/utils/to-posix-path.js";import{isObject as n}from"../../../../../shared/utils/is-object.js";import{isMissingError as r}from"../../../../../shared/utils/is-missing-error.js";import{NESTED_CONFIG_FILENAME as i,deepMergeConfig as a,parseNestedConfig as o}from"../../../../config.js";import{contentIgnoreMatcherOf as s}from"../../../../ingest/scan.js";import{SPEC_KIND_GRAPHQL as c}from"../../../../../shared/constants/api-spec-kinds.js";import{MOCK_SERVER_ROUTE_PREFIX as l,mockPathPrefix as u}from"../../../types/api-entity.js";import{withPathPrefix as d}from"../../../../../shared/path-prefix.js";import{SPEC_DOWNLOAD_ROUTE_PATHS as f}from"./shared.js";import{posix as p}from"node:path";import{FEEDBACK_TYPES as m}from"@redocly/theme/core/constants";import{decoratorTypes as h,preprocessorTypes as g}from"@redocly/config";const _=[`openapi`,`asyncapi`,`graphql`];function v(e,t,n){let r=O(t),i=Object.values(e.apis??{}),a=e=>O(p.join(n,e))===r;return i.find(e=>e.output!==void 0&&a(e.output))??i.find(e=>e.output===void 0&&a(e.root))}function y(e,t,n=``){let r=v(e,t,n);if(!r)return{};let i={};r.metadata&&(i.metadata=r.metadata);for(let e of _)r[e]&&typeof r[e]==`object`&&Object.assign(i,r[e]);return r.rbac!==void 0&&(i.rbac=r.rbac),i}async function b(e,t,n,r,i=n){let o=T(t,r),c=await w(e,i,s(t));return c===null?a(o,y(t,n)):a(a(o,E(c.config,r)),y(c.config,n,c.dir))}const x=[...h,...g];async function S(e,t,r,i=r){let o=await w(e,i,s(t)),c=o===null?[t,v(t,r,``)]:[t,o.config,v(o.config,r,o.dir)],l={};for(let e of c){if(!n(e))continue;let t={};for(let r of x)n(e[r])&&(t[r]=e[r]);l=a(l,t)}return{config:l,configDir:o?.dir??``}}async function C(e,t,n){return(await w(e,n,s(t)))?.config.feedback}async function w(e,t,n){for(let r=p.dirname(t);r!==`.`&&r!==`/`;r=p.dirname(r)){let t=p.join(r,i);if(n(t))continue;let a=await D(e,t);if(a!==null)return{config:a,dir:r}}return null}function T(e,t){return t===`arazzo`?{}:e[t]??{}}function E(e,t){let n={...T(e,t)};return e.mockServer&&(n.mockServer=e.mockServer),n}async function D(e,t){let n;try{n=await e.readFile(t)}catch(e){if(r(e))return null;throw e}return o(n,t).config}function O(e){return p.normalize(t(e)).replace(/^\.\/+/,``).replace(/^\/+/,``)}function k(t,r,i){let a=n(t.mockServer)?t.mockServer:{},o={...r.mockServer,...a};if(i===void 0||o.off===!0||!e(r,`mockServer`))return t;let s=d(l+u(i));return{...t,mockServer:{url:s,position:`first`,description:`Mock server`,...o}}}function A(e,t,n){let r=e=>e.split(`/`).map(encodeURIComponent).join(`/`),i=n===c,a=i?f.graphql:f.bundle,o=(i?[t]:[`.json`,`.yaml`].map(e=>t.replace(/\.[^./]+$/u,e))).map(e=>({url:d(`${a}/${r(e)}?download`),title:p.basename(e)}));return{...e,downloadUrls:Array.isArray(e.downloadUrls)?e.downloadUrls:o,replayDefinitionUrl:o[0]?.url}}function j(e){return d(`${f.bundle}/${e}`)}const M={[m.RATING]:`Rate this section`,[m.SENTIMENT]:`Was this section helpful?`,[m.MOOD]:`Was this section helpful?`,[m.COMMENT]:`Share your feedback about this section`,[m.SCALE]:`How would you rate this section?`};function N(e,t,r){let i=[n(t)?t[`x-feedback`]:void 0,e.feedback,r].find(n);if(i===void 0)return e;let a=n(i.settings)?i.settings:{},o=typeof i.type==`string`?M[i.type]:void 0,s=a.label||o||``;return{...e,feedback:{...i,settings:{...a,label:s}}}}export{y as readApiOptionsFromConfig,S as resolveApiBundleConfig,b as resolveApiOptions,C as resolveNestedFeedback,j as schemaCatalogLink,A as withDownloadUrls,N as withFeedbackOption,k as withMockServerOption};
@@ -1 +1 @@
1
- import{SEARCH_HTTP_METHOD_FACET_FIELD as e,SEARCH_HTTP_PATH_FACET_FIELD as t}from"../../../../../shared/search/facets.js";import{isRbacScope as n}from"../../../../../shared/rbac/engine.js";import{annotateApiDocsRbac as r}from"../../../../../shared/rbac/api-docs.js";import{withImpliedDiscriminatorMappings as i}from"./implied-discriminators.js";import{createHash as a}from"node:crypto";import{REDOCLY_TEAMS_RBAC as o}from"@redocly/config";import{ApiDocsSearchIndexer as s,isOperationName as c}from"@redocly/api-docs/server";const l=`API Reference`;function u(e,t,n={}){let a=h(e.store)?e.store:{},o=r(t,e.specType,{warn:n.warn??(()=>{})}),c=i(o),l=new s(e.basePath,a.schemaStore,h(c)?c:void 0,{exampleStore:a.exampleStore}),u=e=>{for(let t of e)l.addItem(t),h(t)&&Array.isArray(t.items)&&u(t.items)};u(e.items);let m=[],g=/* @__PURE__ */ new Set,_=[];return{docs:l.getResult().map(e=>{for(let t of e.parameters??[]){let n=f(t),r=n.fragmentKey;g.has(r)||(g.add(r),m.push(n));let i={docKey:e.id,fragmentKey:r,place:t.place,anchor:p(t.deepLink)};t.path&&t.path.length>0&&(i.path=t.path),_.push(i)}return d(e,n)}),fragments:m,uses:_}}function d(r,i){let a=r.httpPath?m(r.httpPath):void 0,s={...i.facets},l=r.isAdditionalOperation?r.httpMethod:r.httpMethod&&c(r.httpMethod)?r.httpMethod.toLowerCase():void 0;l&&(s[e]=l,a&&(s[t]=a));let u={docKey:r.id,routeSlug:r.url,title:m(r.title),text:m(r.text),groupKey:i.groupKey??`API Reference`,facets:s},d=r[o];return n(d)&&(u.rbacScope=d),r.httpMethod&&(u.httpMethod=r.httpMethod),a&&(u.httpPath=a),r.deprecated&&(u.deprecated=!0),r.isAdditionalOperation&&(u.isAdditionalOperation=!0),r.badges&&r.badges.length>0&&(u.badges=r.badges),u}function f(e){let t={name:m(e.name),description:m(e.description)};return e.example&&(t.example=e.example),e.enum&&e.enum.length>0&&(t.enum=e.enum),{fragmentKey:a(`sha1`).update(JSON.stringify([t.name,t.description,t.example??null,t.enum??null])).digest(`hex`),...t}}function p(e){if(!e)return``;let t=e.indexOf(`#`);return t>=0?e.slice(t+1):e}function m(e){return Array.isArray(e)?e.join(` `):e}function h(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{l as API_DOCS_SEARCH_GROUP,u as buildApiDocsSearchDocuments};
1
+ import{SEARCH_HTTP_METHOD_FACET_FIELD as e,SEARCH_HTTP_PATH_FACET_FIELD as t}from"../../../../../shared/search/facets.js";import{isRbacScope as n}from"../../../../../shared/rbac/engine.js";import{parseMarkdownCached as r}from"../../../../markdown/utils/parse-cache.js";import{markdocAstToText as i}from"../../../../markdown/search/to-text.js";import{annotateApiDocsRbac as a}from"../../../../../shared/rbac/api-docs.js";import{withImpliedDiscriminatorMappings as o}from"./implied-discriminators.js";import{createHash as s}from"node:crypto";import{REDOCLY_TEAMS_RBAC as c}from"@redocly/config";import{ApiDocsSearchIndexer as l,extractFullText as u,isOperationName as d}from"@redocly/api-docs/server";const f=`API Reference`;function p(e,t,n={}){let r=b(e.store)?e.store:{},i=a(t,e.specType,{warn:n.warn??(()=>{})}),s=o(i),c=new l(e.basePath,r.schemaStore,b(s)?s:void 0,{exampleStore:r.exampleStore,graphqlMeta:r.graphqlMeta,formatDescription:m}),u=e=>{for(let t of e)c.addItem(t),b(t)&&Array.isArray(t.items)&&u(t.items)};u(e.items);let d=[],f=/* @__PURE__ */ new Set,p=[],y=h(t),x=/* @__PURE__ */ new Map;return{docs:c.getResult().map(t=>{let r=(x.get(t.id)??0)+1;x.set(t.id,r);let i=r===1?t.id:`${t.id}#${r}`;for(let e of t.parameters??[]){let t=_(e),n=t.fragmentKey;f.has(n)||(f.add(n),d.push(t));let r={docKey:i,fragmentKey:n,place:e.place,anchor:v(e.deepLink)};e.path&&e.path.length>0&&(r.path=e.path),p.push(r)}let a=g(t,i,n);return y&&t.url===e.basePath&&(a.title=y),a}),fragments:d,uses:p}}const m=e=>typeof e==`string`&&e.includes(`{%`)?i(r(e)).replace(/\s+/g,` `):u(e);function h(e){let t=b(e)&&b(e.info)?e.info:{};if(typeof t.title!=`string`||t.title===``)return;let n=t.version;return typeof n==`string`&&n!==``||typeof n==`number`?`${t.title} (${n})`:t.title}function g(r,i,a){let o=r.httpPath?y(r.httpPath):void 0,s={...a.facets},l=r.isAdditionalOperation?r.httpMethod:r.httpMethod&&d(r.httpMethod)?r.httpMethod.toLowerCase():void 0;l&&(s[e]=l,o&&(s[t]=o));let u={docKey:i,routeSlug:r.url,title:y(r.title),text:y(r.text),groupKey:a.groupKey??`API Reference`,facets:s},f=r[c];return n(f)&&(u.rbacScope=f),r.httpMethod&&(u.httpMethod=r.httpMethod),o&&(u.httpPath=o),r.deprecated&&(u.deprecated=!0),r.isAdditionalOperation&&(u.isAdditionalOperation=!0),r.badges&&r.badges.length>0&&(u.badges=r.badges),u}function _(e){let t={name:y(e.name),description:y(e.description)};return e.example&&(t.example=e.example),e.enum&&e.enum.length>0&&(t.enum=e.enum),{fragmentKey:s(`sha1`).update(JSON.stringify([t.name,t.description,t.example??null,t.enum??null])).digest(`hex`),...t}}function v(e){if(!e)return``;let t=e.indexOf(`#`);return t>=0?e.slice(t+1):e}function y(e){return Array.isArray(e)?e.join(` `):e}function b(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}export{f as API_DOCS_SEARCH_GROUP,p as buildApiDocsSearchDocuments};
@@ -1 +1 @@
1
- import{API_FUNCTION_ENTITY_TYPE as e}from"../constants.js";import{stripPathPrefix as t}from"../../../../../shared/path-prefix.js";import{compareApiFunctionRoutes as n}from"../route-path.js";import{isSubprocessError as r}from"../../../../../server/subprocess/runner.js";import{errorMessage as i}from"../../../../../shared/utils/error-message.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,r,c){let l=t(_(n.req.raw));if(l===null)return r();let u=new URL(c.request.url),d=w(await c.entities.list({type:e}),c.request.method,l);if(!d)return r();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,i(e)),e}return await m(h.response.status,h.failure),h.response}async function F(e,t,n,i,a){let o;try{o={modulePath:n.resolveContentModule(i.sourcePath),request:await f(e.req.raw,l),params:i.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(!r(n))throw n;return n.code===`output-too-large`&&e.set(`realmApiFunctionResponder`,`project`),t.logger?.error(`API function ${i.sourcePath} failed (${n.code}): ${n.message}`),M(n.code,n.message)}if(e.set(`realmApiFunctionResponder`,`project`),!s.ok)return t.logger?.error(`API function ${i.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
+ import{API_FUNCTION_ENTITY_TYPE as e}from"../constants.js";import{stripPathPrefix as t}from"../../../../../shared/path-prefix.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=t(_(n.req.raw));if(l===null)return i();let u=new URL(c.request.url),d=w(await c.entities.list({type:e}),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{toJsonValue as e}from"../../../database/utils/json.js";import{isRbacScope as t}from"../../../../shared/rbac/engine.js";import{hashBlobContent as n}from"../../../materialization/data-ref.js";import{builtInMarkdocTags as r}from"../../../markdown/constants/builtin-tags.js";import{resolveMarkdownAst as i}from"../../../markdown/resolve/ast.js";import{REDOCLY_TEAMS_RBAC as a}from"@redocly/config";async function o(o,s){if(!o||o.length===0)return null;let c=[],l=[],u=[];for(let[d,f]of o.entries()){if(!f.content){s.logger?.warn(`${s.file.path}: banner[${d}] has no content — the item is not shown`);continue}let{content:o,rbac:p,...m}=f,{ast:h,entityDeps:g,assetUsages:_}=await i(f.content,s.file.path,{resolverContext:s,tags:r}),v=p===void 0?{}:{[a]:t(p)?p:(s.logger?.warn(`${s.file.path}: banner[${d}] has an invalid "rbac" value — the item is hidden from everyone`),{})};c.push(e({...m,...v,ast:h,hash:n(f.content)})),l.push(...g),u.push(..._)}return c.length>0?{banner:c,deps:l,assetUsages:u}:null}export{o as resolveBannerForAppData};
1
+ import{toJsonValue as e}from"../../../database/utils/json.js";import{builtInMarkdocTags as t}from"../../../markdown/constants/builtin-tags.js";import{isRbacScope as n}from"../../../../shared/rbac/engine.js";import{hashBlobContent as r}from"../../../materialization/data-ref.js";import{resolveMarkdownAst as i}from"../../../markdown/resolve/ast.js";import{REDOCLY_TEAMS_RBAC as a}from"@redocly/config";async function o(o,s){if(!o||o.length===0)return null;let c=[],l=[],u=[];for(let[d,f]of o.entries()){if(!f.content){s.logger?.warn(`${s.file.path}: banner[${d}] has no content — the item is not shown`);continue}let{content:o,rbac:p,...m}=f,{ast:h,entityDeps:g,assetUsages:_}=await i(f.content,s.file.path,{resolverContext:s,tags:t}),v=p===void 0?{}:{[a]:n(p)?p:(s.logger?.warn(`${s.file.path}: banner[${d}] has an invalid "rbac" value — the item is hidden from everyone`),{})};c.push(e({...m,...v,ast:h,hash:r(f.content)})),l.push(...g),u.push(..._)}return c.length>0?{banner:c,deps:l,assetUsages:u}:null}export{o as resolveBannerForAppData};
@@ -5,7 +5,7 @@ import type { SystemEntityDescriptor } from '../../../database/finalize';
5
5
  import type { RouteAccess } from '../../utils/route-index.js';
6
6
  export { APP_DATA_STATIC_DATA_SLUG } from '../../../../shared/constants/app-data';
7
7
  export declare const APP_DATA_PLUGIN_ID = "internal.app-data";
8
- export declare const APP_DATA_PLUGIN_VERSION = "1.33.0";
8
+ export declare const APP_DATA_PLUGIN_VERSION = "1.34.0";
9
9
  export declare const APP_DATA_STATIC_DATA_LOADER_ID: "internal.app-data:app-data";
10
10
  export type AppDataFragment = {
11
11
  owner: string;