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

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 (484) 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/build/theme-global-style-compiler.js +1 -0
  4. package/dist/bundler/build/theme-global-stylesheets.js +1 -0
  5. package/dist/bundler/build/vite-config.js +2 -2
  6. package/dist/bundler/dev/dev-content-build.js +1 -0
  7. package/dist/bundler/dev/dev-problems.js +1 -1
  8. package/dist/bundler/dev/dev-reporter.js +1 -1
  9. package/dist/bundler/dev/routes/dev-content-build-route.js +1 -0
  10. package/dist/bundler/dev/routes/dev-problems-route.js +1 -1
  11. package/dist/bundler/dev/run.js +1 -1
  12. package/dist/bundler/dev/runtime-app.js +1 -1
  13. package/dist/bundler/dev/vite-config.js +1 -1
  14. package/dist/bundler/node-bundle.js +1 -0
  15. package/dist/bundler/runtime-files.js +1 -1
  16. package/dist/bundler/user-markdoc-schema.js +1 -1
  17. package/dist/bundler/vite-config.base.js +12 -12
  18. package/dist/cli/api-docs-build-event.js +1 -0
  19. package/dist/cli/commands/build.js +1 -1
  20. package/dist/cli/commands/ingest.js +1 -1
  21. package/dist/cli/commands/translate.js +1 -1
  22. package/dist/cli/dev-console/{sweep.js → content-build.js} +1 -1
  23. package/dist/cli/dev-console/index.js +1 -1
  24. package/dist/cli/dev-console/lines.js +2 -2
  25. package/dist/cli/dev-console/plain.js +1 -1
  26. package/dist/cli/dev-console/tui.js +2 -2
  27. package/dist/cli/output.js +12 -12
  28. package/dist/cli/validate-react-pages.js +1 -1
  29. package/dist/client/ApiAccess.js +3 -0
  30. package/dist/client/NavigationProgress.js +1 -1
  31. package/dist/client/ProductsProvider.js +1 -1
  32. package/dist/client/RouteErrorBoundary.js +1 -1
  33. package/dist/client/RuntimeLink.js +1 -0
  34. package/dist/client/ThemeGlobalStyle.js +1 -0
  35. package/dist/client/UnversionedVersionButton.js +1 -1
  36. package/dist/client/app.js +2 -7
  37. package/dist/client/client-entry.js +1 -1
  38. package/dist/client/dev-problems/ProblemsBar.js +75 -15
  39. package/dist/client/dev-problems/ProblemsModal.js +15 -15
  40. package/dist/client/dev-problems/build-segment.js +1 -0
  41. package/dist/client/dev-problems/index.js +1 -1
  42. package/dist/client/dev-problems/use-dev-problems.js +1 -1
  43. package/dist/client/experiments/runtime.js +1 -1
  44. package/dist/client/history-mount.js +1 -0
  45. package/dist/client/l10n/use-l10n-config.js +1 -1
  46. package/dist/client/l10n/use-l10n-href.js +1 -1
  47. package/dist/client/l10n/use-translate.js +1 -1
  48. package/dist/client/products.js +1 -1
  49. package/dist/client/review/ReviewBar.js +163 -69
  50. package/dist/client/review/login-url.js +1 -0
  51. package/dist/client/revisions-history.js +1 -1
  52. package/dist/client/sidebar/PoweredByRedocly.js +2 -2
  53. package/dist/client/ssr.js +1 -1
  54. package/dist/client/telemetry/report-preload-failure.js +1 -0
  55. package/dist/client/templates/dev-login.js +4 -4
  56. package/dist/client/templates/unauthorized.js +5 -5
  57. package/dist/client/theme-global-css.js +1 -0
  58. package/dist/client/use-banner.js +1 -1
  59. package/dist/client/use-bar-position.js +1 -0
  60. package/dist/client/use-page-versions.js +1 -1
  61. package/dist/client/use-router-for-local-links.js +1 -1
  62. package/dist/client/use-search.js +1 -1
  63. package/dist/client/utils/routes/is-router-path.js +1 -0
  64. package/dist/client/webmcp/tools/shared.js +1 -1
  65. package/dist/content-layer/allowed-packages.js +1 -1
  66. package/dist/content-layer/api-outputs.js +1 -1
  67. package/dist/content-layer/config-schema.d.ts +12 -3
  68. package/dist/content-layer/config-schema.js +1 -1
  69. package/dist/content-layer/config.d.ts +30 -12
  70. package/dist/content-layer/config.js +1 -1
  71. package/dist/content-layer/context.d.ts +2 -0
  72. package/dist/content-layer/context.js +1 -1
  73. package/dist/content-layer/database/adapters/node-sqlite-client.js +1 -1
  74. package/dist/content-layer/database/assets.js +1 -1
  75. package/dist/content-layer/database/blobs.js +1 -1
  76. package/dist/content-layer/database/connection.js +1 -1
  77. package/dist/content-layer/database/entity-store.d.ts +24 -3
  78. package/dist/content-layer/database/entity-store.js +1 -1
  79. package/dist/content-layer/database/files.js +1 -1
  80. package/dist/content-layer/database/finalize.js +1 -1
  81. package/dist/content-layer/database/invalidation.d.ts +6 -0
  82. package/dist/content-layer/database/invalidation.js +26 -26
  83. package/dist/content-layer/database/link-refs.js +1 -1
  84. package/dist/content-layer/database/origins.d.ts +2 -4
  85. package/dist/content-layer/database/origins.js +1 -1
  86. package/dist/content-layer/database/problems.d.ts +2 -0
  87. package/dist/content-layer/database/problems.js +1 -1
  88. package/dist/content-layer/database/reset.js +1 -1
  89. package/dist/content-layer/database/route-query-deps.js +1 -1
  90. package/dist/content-layer/database/schema.d.ts +50 -0
  91. package/dist/content-layer/database/schema.js +1 -1
  92. package/dist/content-layer/database/search-vocab.js +2 -2
  93. package/dist/content-layer/database/site-config.d.ts +23 -0
  94. package/dist/content-layer/database/site-config.js +1 -1
  95. package/dist/content-layer/database/static-files.js +1 -1
  96. package/dist/content-layer/ingest/extract-all-phase.js +1 -1
  97. package/dist/content-layer/ingest/finalize-phase.js +1 -1
  98. package/dist/content-layer/ingest/git-last-modified.js +3 -3
  99. package/dist/content-layer/ingest/hash.js +1 -1
  100. package/dist/content-layer/ingest/hook-inputs.js +1 -1
  101. package/dist/content-layer/ingest/l10n-warnings.js +1 -1
  102. package/dist/content-layer/ingest/markdoc-schema-problem.js +1 -0
  103. package/dist/content-layer/ingest/rbac-teams.js +1 -1
  104. package/dist/content-layer/ingest/run.js +1 -1
  105. package/dist/content-layer/ingest/scan.d.ts +1 -1
  106. package/dist/content-layer/ingest/scan.js +1 -1
  107. package/dist/content-layer/ingest/search-sync.js +1 -1
  108. package/dist/content-layer/ingest/slugger/resolve-final-slugs.js +1 -1
  109. package/dist/content-layer/ingest/sync.js +1 -1
  110. package/dist/content-layer/link-checker/delta.js +1 -1
  111. package/dist/content-layer/link-checker/fingerprint.js +1 -1
  112. package/dist/content-layer/link-checker/load-view.js +1 -1
  113. package/dist/content-layer/link-checker/run-build.js +1 -1
  114. package/dist/content-layer/link-checker/validate.js +1 -1
  115. package/dist/content-layer/link-checker/view.js +1 -1
  116. package/dist/content-layer/loaders/context.js +1 -1
  117. package/dist/content-layer/loaders/define.d.ts +3 -0
  118. package/dist/content-layer/markdown/client/JsonSchemaTag.js +1 -1
  119. package/dist/content-layer/markdown/client/OpenapiTagComponents.js +2 -2
  120. package/dist/content-layer/markdown/client/code-highlight-notation.js +3 -3
  121. package/dist/content-layer/markdown/client/dynamic-components.js +1 -1
  122. package/dist/content-layer/markdown/client/markdoc-components.js +2 -2
  123. package/dist/content-layer/markdown/constants/builtin-tags.js +1 -1
  124. package/dist/content-layer/markdown/constants/markdown-text-tag-set.js +1 -1
  125. package/dist/content-layer/markdown/constants/tag-sets.d.ts +20 -5
  126. package/dist/content-layer/markdown/constants/tag-sets.js +1 -1
  127. package/dist/content-layer/markdown/nodes/fence.js +1 -1
  128. package/dist/content-layer/markdown/nodes/heading.js +1 -1
  129. package/dist/content-layer/markdown/nodes/table.js +1 -1
  130. package/dist/content-layer/markdown/resolve/ast.js +1 -1
  131. package/dist/content-layer/markdown/resolve/attribute-resolver-key.d.ts +8 -1
  132. package/dist/content-layer/markdown/resolve/attribute-resolver-key.js +1 -1
  133. package/dist/content-layer/markdown/resolve/audience-tag.d.ts +2 -6
  134. package/dist/content-layer/markdown/resolve/audience-tag.js +1 -1
  135. package/dist/content-layer/markdown/resolve/markdoc-resolvers/code-snippet.js +5 -4
  136. package/dist/content-layer/markdown/resolve/markdoc-resolvers/code-walkthrough/filesets.js +1 -1
  137. package/dist/content-layer/markdown/resolve/markdoc-resolvers/diagram-file.js +1 -1
  138. package/dist/content-layer/markdown/resolve/markdoc-resolvers/file-reference.js +1 -1
  139. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.d.ts +2 -1
  140. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.js +1 -1
  141. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.d.ts +1 -1
  142. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.js +1 -1
  143. package/dist/content-layer/markdown/resolve/markdoc-resolvers/partial.js +1 -1
  144. package/dist/content-layer/markdown/resolve/markdoc-resolvers/svg-content.js +1 -1
  145. package/dist/content-layer/markdown/resolve/markdoc.d.ts +2 -1
  146. package/dist/content-layer/markdown/resolve/markdoc.js +1 -1
  147. package/dist/content-layer/markdown/resolve/raw-partials.d.ts +2 -1
  148. package/dist/content-layer/markdown/resolve/raw-partials.js +1 -1
  149. package/dist/content-layer/markdown/resolve/references.d.ts +3 -1
  150. package/dist/content-layer/markdown/resolve/references.js +1 -1
  151. package/dist/content-layer/markdown/resolve/render-diagrams.d.ts +8 -1
  152. package/dist/content-layer/markdown/resolve/render-diagrams.js +1 -1
  153. package/dist/content-layer/markdown/search/to-markdown.js +2 -2
  154. package/dist/content-layer/markdown/search/to-sections.d.ts +8 -3
  155. package/dist/content-layer/markdown/search/to-sections.js +1 -1
  156. package/dist/content-layer/markdown/search/to-text.d.ts +4 -1
  157. package/dist/content-layer/markdown/search/to-text.js +5 -5
  158. package/dist/content-layer/markdown/server/render.d.ts +4 -2
  159. package/dist/content-layer/markdown/server/render.js +1 -1
  160. package/dist/content-layer/markdown/service.js +1 -1
  161. package/dist/content-layer/markdown/tags/html.d.ts +5 -2
  162. package/dist/content-layer/markdown/tags/html.js +1 -1
  163. package/dist/content-layer/markdown/tags/markdoc-error.d.ts +8 -0
  164. package/dist/content-layer/markdown/tags/markdoc-error.js +1 -1
  165. package/dist/content-layer/markdown/tags/openapi.d.ts +1 -1
  166. package/dist/content-layer/markdown/tags/openapi.js +1 -1
  167. package/dist/content-layer/markdown/tags/partial.d.ts +9 -3
  168. package/dist/content-layer/markdown/tags/partial.js +1 -1
  169. package/dist/content-layer/markdown/tags/variant.d.ts +6 -0
  170. package/dist/content-layer/markdown/tags/variant.js +1 -0
  171. package/dist/content-layer/markdown/types/service.d.ts +6 -0
  172. package/dist/content-layer/markdown/utils/collect-anchors.js +1 -1
  173. package/dist/content-layer/markdown/utils/collect-headings.d.ts +3 -1
  174. package/dist/content-layer/markdown/utils/collect-headings.js +1 -1
  175. package/dist/content-layer/markdown/utils/first-heading.js +1 -1
  176. package/dist/content-layer/markdown/utils/heading-slugger.d.ts +8 -0
  177. package/dist/content-layer/markdown/utils/heading-slugger.js +1 -1
  178. package/dist/content-layer/markdown/utils/node-source-range.d.ts +3 -3
  179. package/dist/content-layer/markdown/utils/node-source-range.js +1 -1
  180. package/dist/content-layer/markdown/utils/parse-cache.js +1 -1
  181. package/dist/content-layer/markdown/utils/reparse-example-fences.d.ts +4 -1
  182. package/dist/content-layer/markdown/utils/reparse-example-fences.js +1 -1
  183. package/dist/content-layer/markdown/utils/substitute-variables.js +1 -1
  184. package/dist/content-layer/markdown/utils/walk-markdoc-ast.d.ts +2 -2
  185. package/dist/content-layer/markdown/utils/walk-markdoc-ast.js +1 -1
  186. package/dist/content-layer/materialization/asset-reconcile.js +1 -1
  187. package/dist/content-layer/materialization/entity.js +1 -1
  188. package/dist/content-layer/materialization/materializer.js +1 -0
  189. package/dist/content-layer/materialization/static-files.js +1 -1
  190. package/dist/content-layer/plan-gates.d.ts +3 -2
  191. package/dist/content-layer/plan-gates.js +1 -1
  192. package/dist/content-layer/plugins/execute.js +1 -1
  193. package/dist/content-layer/plugins/index.js +1 -1
  194. package/dist/content-layer/plugins/internal/api-docs/client/event-handlers.js +1 -1
  195. package/dist/content-layer/plugins/internal/api-docs/client/rebase-item-links.js +1 -1
  196. package/dist/content-layer/plugins/internal/api-docs/client/template.js +12 -4
  197. package/dist/content-layer/plugins/internal/api-docs/index.js +1 -1
  198. package/dist/content-layer/plugins/internal/api-docs/server/build-definition.d.ts +28 -13
  199. package/dist/content-layer/plugins/internal/api-docs/server/build-definition.js +1 -1
  200. package/dist/content-layer/plugins/internal/api-docs/server/build-sidebar.js +1 -1
  201. package/dist/content-layer/plugins/internal/api-docs/server/declares-proto-service.d.ts +2 -0
  202. package/dist/content-layer/plugins/internal/api-docs/server/declares-proto-service.js +3 -0
  203. package/dist/content-layer/plugins/internal/api-docs/server/markdown-copy.d.ts +14 -0
  204. package/dist/content-layer/plugins/internal/api-docs/server/markdown-copy.js +23 -0
  205. package/dist/content-layer/plugins/internal/api-docs/server/markdown-decorator.d.ts +1 -4
  206. package/dist/content-layer/plugins/internal/api-docs/server/markdown-decorator.js +1 -1
  207. package/dist/content-layer/plugins/internal/api-docs/server/options.d.ts +4 -2
  208. package/dist/content-layer/plugins/internal/api-docs/server/options.js +1 -1
  209. package/dist/content-layer/plugins/internal/api-docs/server/search-documents.d.ts +1 -1
  210. package/dist/content-layer/plugins/internal/api-docs/server/search-documents.js +1 -1
  211. package/dist/content-layer/plugins/internal/api-docs/server/spec-download.js +1 -1
  212. package/dist/content-layer/plugins/internal/api-functions/index.js +1 -1
  213. package/dist/content-layer/plugins/internal/api-functions/server/access.js +1 -1
  214. package/dist/content-layer/plugins/internal/api-functions/server/api-function-telemetry.js +1 -0
  215. package/dist/content-layer/plugins/internal/api-functions/server/dispatch.js +1 -1
  216. package/dist/content-layer/plugins/internal/app-data/banner.js +1 -1
  217. package/dist/content-layer/plugins/internal/app-data/index.d.ts +1 -1
  218. package/dist/content-layer/plugins/internal/app-data/index.js +1 -1
  219. package/dist/content-layer/plugins/internal/app-data/products.d.ts +2 -0
  220. package/dist/content-layer/plugins/internal/app-data/products.js +1 -1
  221. package/dist/content-layer/plugins/internal/catalog-classic/client/catalog-filtering.js +1 -1
  222. package/dist/content-layer/plugins/internal/catalog-classic/index.js +1 -1
  223. package/dist/content-layer/plugins/internal/catalog-classic/resolve-items.d.ts +1 -1
  224. package/dist/content-layer/plugins/internal/catalog-classic/resolve-items.js +1 -1
  225. package/dist/content-layer/plugins/internal/catalog-classic/sidebars.d.ts +1 -1
  226. package/dist/content-layer/plugins/internal/index.js +1 -1
  227. package/dist/content-layer/plugins/internal/l10n/index.js +1 -1
  228. package/dist/content-layer/plugins/internal/l10n/translations-loader.js +1 -1
  229. package/dist/content-layer/plugins/internal/markdoc/client/template.js +1 -1
  230. package/dist/content-layer/plugins/internal/markdoc/index.js +1 -1
  231. package/dist/content-layer/plugins/internal/markdoc/server/shared.d.ts +1 -1
  232. package/dist/content-layer/plugins/internal/mcp/constants.d.ts +20 -0
  233. package/dist/content-layer/plugins/internal/mcp/constants.js +1 -1
  234. package/dist/content-layer/plugins/internal/mcp/content-tools.d.ts +4 -1
  235. package/dist/content-layer/plugins/internal/mcp/content-tools.js +1 -1
  236. package/dist/content-layer/plugins/internal/mcp/index.js +1 -1
  237. package/dist/content-layer/plugins/internal/mcp/server/agent-card.js +1 -1
  238. package/dist/content-layer/plugins/internal/mcp/server/audit.js +1 -1
  239. package/dist/content-layer/plugins/internal/mcp/server/auth.js +1 -1
  240. package/dist/content-layer/plugins/internal/mcp/server/code-credentials.js +2 -2
  241. package/dist/content-layer/plugins/internal/mcp/server/codemode/capabilities.js +6 -6
  242. package/dist/content-layer/plugins/internal/mcp/server/codemode/constants.js +1 -1
  243. package/dist/content-layer/plugins/internal/mcp/server/codemode/discover.js +1 -1
  244. package/dist/content-layer/plugins/internal/mcp/server/codemode/execute-schema.js +1 -1
  245. package/dist/content-layer/plugins/internal/mcp/server/codemode/index.js +1 -1
  246. package/dist/content-layer/plugins/internal/mcp/server/codemode/prompts.js +8 -8
  247. package/dist/content-layer/plugins/internal/mcp/server/config-gate.js +1 -1
  248. package/dist/content-layer/plugins/internal/mcp/server/custom-tools.js +1 -1
  249. package/dist/content-layer/plugins/internal/mcp/server/gateway/allowed-http-methods.js +1 -1
  250. package/dist/content-layer/plugins/internal/mcp/server/gateway/api-call-operations.js +1 -1
  251. package/dist/content-layer/plugins/internal/mcp/server/gateway/call-api.js +2 -0
  252. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials-page/form-page.js +10 -10
  253. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials-page/outcome-pages.js +1 -1
  254. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials.js +1 -1
  255. package/dist/content-layer/plugins/internal/mcp/server/gateway/elicitation.js +7 -6
  256. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/allowed-hosts.js +1 -1
  257. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/fetch-bridge.js +1 -1
  258. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/fetch-errors.js +1 -1
  259. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/ssrf-guard.js +1 -1
  260. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/upstream-detail.js +1 -1
  261. package/dist/content-layer/plugins/internal/mcp/server/gateway/index.js +3 -3
  262. package/dist/content-layer/plugins/internal/mcp/server/gateway/secret-store.js +1 -1
  263. package/dist/content-layer/plugins/internal/mcp/server/gateway/tool-list.js +1 -0
  264. package/dist/content-layer/plugins/internal/mcp/server/gateway/tools.js +4 -4
  265. package/dist/content-layer/plugins/internal/mcp/server/gateway/upstream-auth-scheme.js +2 -2
  266. package/dist/content-layer/plugins/internal/mcp/server/handler.js +1 -1
  267. package/dist/content-layer/plugins/internal/mcp/server/mcp-server.js +1 -1
  268. package/dist/content-layer/plugins/internal/mcp/server/mcp-telemetry.js +1 -1
  269. package/dist/content-layer/plugins/internal/mcp/server/oauth/authorize.js +1 -1
  270. package/dist/content-layer/plugins/internal/mcp/server/oauth/discovery.js +1 -1
  271. package/dist/content-layer/plugins/internal/mcp/server/rate-limit.js +1 -1
  272. package/dist/content-layer/plugins/internal/mcp/server/server-card.js +1 -1
  273. package/dist/content-layer/plugins/internal/mcp/server/skills-resources.js +1 -1
  274. package/dist/content-layer/plugins/internal/mcp/server/tools/graphql-catalog.js +1 -1
  275. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-catalog.js +1 -1
  276. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-document.js +1 -1
  277. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-refs.js +1 -1
  278. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi.js +1 -1
  279. package/dist/content-layer/plugins/internal/mcp/server/tools/pages-navigation.js +1 -1
  280. package/dist/content-layer/plugins/internal/mcp/server/tools/pages.js +2 -2
  281. package/dist/content-layer/plugins/internal/mcp/server/tools/schemas.js +1 -1
  282. package/dist/content-layer/plugins/internal/mcp/server/workflows/catalog.js +1 -0
  283. package/dist/content-layer/plugins/internal/mcp/server/workflows/document-resolver.js +1 -0
  284. package/dist/content-layer/plugins/internal/mcp/server/workflows/operations-subset.js +1 -0
  285. package/dist/content-layer/plugins/internal/mcp/server/workflows/resolve-workflows.js +1 -0
  286. package/dist/content-layer/plugins/internal/mcp/server/workflows/run-workflow.js +1 -0
  287. package/dist/content-layer/plugins/internal/mcp/server/workflows/schemas.js +1 -0
  288. package/dist/content-layer/plugins/internal/mcp/server/workflows/tools.js +1 -0
  289. package/dist/content-layer/plugins/internal/mcp/server/workflows/types.js +1 -0
  290. package/dist/content-layer/plugins/internal/mcp/server/workflows/workflow-references.js +1 -0
  291. package/dist/content-layer/plugins/internal/mock/server/handler.js +1 -1
  292. package/dist/content-layer/plugins/internal/react-page/index.d.ts +3 -2
  293. package/dist/content-layer/plugins/internal/react-page/index.js +1 -1
  294. package/dist/content-layer/plugins/internal/scorecard-classic/client/Grid.js +11 -11
  295. package/dist/content-layer/plugins/internal/scorecard-classic/client/ScorecardViews.js +1 -1
  296. package/dist/content-layer/plugins/internal/scorecard-classic/client/ScorecardWidgets.js +7 -7
  297. package/dist/content-layer/plugins/internal/scorecard-classic/client/template.js +2 -2
  298. package/dist/content-layer/plugins/internal/sidebar/bundle.d.ts +18 -17
  299. package/dist/content-layer/plugins/internal/sidebar/bundle.js +1 -1
  300. package/dist/content-layer/plugins/internal/sidebar/index.d.ts +5 -3
  301. package/dist/content-layer/plugins/internal/sidebar/index.js +2 -2
  302. package/dist/content-layer/plugins/internal/sidebar/subtree.js +1 -1
  303. package/dist/content-layer/plugins/internal/skills/index.js +1 -1
  304. package/dist/content-layer/plugins/internal/skills/server/routes.js +1 -1
  305. package/dist/content-layer/plugins/internal/versions/index.js +1 -1
  306. package/dist/content-layer/plugins/project/load.js +2 -2
  307. package/dist/content-layer/plugins/registry.js +1 -1
  308. package/dist/content-layer/plugins/request-context.d.ts +5 -0
  309. package/dist/content-layer/plugins/types/api-entity.d.ts +2 -6
  310. package/dist/content-layer/plugins/types/api-entity.js +1 -1
  311. package/dist/content-layer/plugins/types/markdoc.d.ts +2 -0
  312. package/dist/content-layer/plugins/types/plugin.d.ts +13 -0
  313. package/dist/content-layer/plugins/types/search.d.ts +14 -3
  314. package/dist/content-layer/plugins/utils/link-access.d.ts +2 -0
  315. package/dist/content-layer/plugins/utils/link-access.js +1 -1
  316. package/dist/content-layer/plugins/utils/route-index.d.ts +1 -1
  317. package/dist/content-layer/plugins/utils/route-index.js +1 -1
  318. package/dist/content-layer/plugins/utils/sidebar-label.d.ts +4 -1
  319. package/dist/content-layer/plugins/utils/sidebar-label.js +1 -1
  320. package/dist/content-layer/plugins/utils/version-path.js +1 -1
  321. package/dist/content-layer/plugins/work-time.js +1 -0
  322. package/dist/content-layer/problems/codes.d.ts +10 -0
  323. package/dist/content-layer/problems/codes.js +1 -1
  324. package/dist/content-layer/revisions/config.js +1 -1
  325. package/dist/content-layer/revisions/delete.js +1 -1
  326. package/dist/content-layer/search/engine/core/content-parser.js +1 -1
  327. package/dist/content-layer/search/engine/core/search-engine.js +1 -1
  328. package/dist/content-layer/search/facet-rows.js +1 -1
  329. package/dist/content-layer/search/keywords.d.ts +18 -0
  330. package/dist/content-layer/search/keywords.js +1 -0
  331. package/dist/content-layer/search/postings/fragment-field.d.ts +2 -0
  332. package/dist/content-layer/search/postings/fragment-field.js +1 -1
  333. package/dist/content-layer/search/postings/postings-store.d.ts +14 -0
  334. package/dist/content-layer/search/postings/postings-store.js +1 -1
  335. package/dist/content-layer/search/store.d.ts +14 -1
  336. package/dist/content-layer/server/context.js +1 -1
  337. package/dist/content-layer/server/database.js +1 -1
  338. package/dist/content-layer/server/materialize.js +1 -1
  339. package/dist/content-layer/static/audience.js +1 -1
  340. package/dist/content-layer/static/registry.js +1 -1
  341. package/dist/content-layer/templates/template-set.js +1 -1
  342. package/dist/content-layer/versions/group-info.d.ts +21 -0
  343. package/dist/content-layer/versions/group-info.js +1 -0
  344. package/dist/content-layer/versions/redirect.d.ts +24 -17
  345. package/dist/content-layer/versions/redirect.js +1 -1
  346. package/dist/content-layer/versions/resolve.d.ts +1 -21
  347. package/dist/content-layer/versions/resolve.js +1 -1
  348. package/dist/content-layer/versions/version-groups.d.ts +5 -1
  349. package/dist/content-layer/versions/version-groups.js +1 -1
  350. package/dist/plugin-api.d.ts +3 -0
  351. package/dist/plugin-api.js +1 -1
  352. package/dist/server/analytics-tags.js +1 -1
  353. package/dist/server/app.js +3 -3
  354. package/dist/server/ask-ai/feature-gate.js +1 -1
  355. package/dist/server/ask-ai/route.js +1 -1
  356. package/dist/server/auth/access-config.js +1 -1
  357. package/dist/server/auth/gate.js +1 -1
  358. package/dist/server/auth/middleware.js +1 -1
  359. package/dist/server/auth/oidc.js +1 -1
  360. package/dist/server/auth/request.js +1 -1
  361. package/dist/server/auth/routes.js +1 -1
  362. package/dist/server/auth/runtime.js +1 -1
  363. package/dist/server/content-assets/access.js +1 -1
  364. package/dist/server/content.js +14 -13
  365. package/dist/server/feedback/route.js +1 -1
  366. package/dist/server/html-tags.js +2 -1
  367. package/dist/server/lambda-entry.js +1 -1
  368. package/dist/server/llms-txt.js +1 -1
  369. package/dist/server/manifest-assets.js +2 -2
  370. package/dist/server/metrics/request-metrics.js +1 -1
  371. package/dist/server/node-entry.js +1 -1
  372. package/dist/server/page-handlers.js +1 -1
  373. package/dist/server/plugin-context.js +1 -1
  374. package/dist/server/plugin-routes.js +1 -1
  375. package/dist/server/public-url.js +1 -0
  376. package/dist/server/rbac/content-asset-access.js +1 -1
  377. package/dist/server/redirects.js +1 -1
  378. package/dist/server/replay-oauth2/route.js +1 -1
  379. package/dist/server/review/route.js +1 -1
  380. package/dist/server/runtime-config.js +1 -1
  381. package/dist/server/search/cache.js +1 -0
  382. package/dist/server/search/route.js +1 -1
  383. package/dist/server/search/search-telemetry.js +1 -0
  384. package/dist/server/seo-tags.js +2 -2
  385. package/dist/server/ssrf/ssrf-blocklist.js +1 -1
  386. package/dist/server/static-files/serve.js +1 -1
  387. package/dist/server/subprocess/runner.js +1 -1
  388. package/dist/server/telemetry/mock-server-events.js +1 -0
  389. package/dist/server/telemetry/redirect-event.js +1 -0
  390. package/dist/server/telemetry/route.js +1 -1
  391. package/dist/server/telemetry/sender.js +1 -1
  392. package/dist/server/telemetry/server-events.js +1 -1
  393. package/dist/server/template-ids.js +1 -1
  394. package/dist/shared/constants/api-spec-kinds.d.ts +7 -0
  395. package/dist/shared/constants/api-spec-kinds.js +1 -0
  396. package/dist/shared/constants/content-update.js +1 -1
  397. package/dist/shared/constants/dependency-pack.js +1 -1
  398. package/dist/shared/constants/dev-content-build.js +1 -0
  399. package/dist/shared/constants/dev-problems.js +1 -1
  400. package/dist/shared/constants/dev-source-sync.js +1 -1
  401. package/dist/shared/constants/l10n/langs/ar.js +1 -1
  402. package/dist/shared/constants/l10n/langs/de.js +1 -1
  403. package/dist/shared/constants/l10n/langs/en.js +1 -1
  404. package/dist/shared/constants/l10n/langs/es.js +1 -1
  405. package/dist/shared/constants/l10n/langs/fr.js +1 -1
  406. package/dist/shared/constants/l10n/langs/hi.js +1 -1
  407. package/dist/shared/constants/l10n/langs/it.js +1 -1
  408. package/dist/shared/constants/l10n/langs/ja.js +1 -1
  409. package/dist/shared/constants/l10n/langs/ko.js +1 -1
  410. package/dist/shared/constants/l10n/langs/pl.js +1 -1
  411. package/dist/shared/constants/l10n/langs/pt-br.js +1 -1
  412. package/dist/shared/constants/l10n/langs/pt.js +1 -1
  413. package/dist/shared/constants/l10n/langs/ru.js +1 -1
  414. package/dist/shared/constants/l10n/langs/uk.js +1 -1
  415. package/dist/shared/constants/l10n/langs/zh.js +1 -1
  416. package/dist/shared/constants/manifest-version.d.ts +3 -1
  417. package/dist/shared/constants/openapi-operation-methods.d.ts +2 -0
  418. package/dist/shared/constants/openapi-operation-methods.js +1 -0
  419. package/dist/shared/constants/review.d.ts +5 -0
  420. package/dist/shared/constants/review.js +1 -1
  421. package/dist/{server → shared}/constants/system-routes.d.ts +1 -1
  422. package/dist/shared/constants/system-routes.js +1 -0
  423. package/dist/shared/constants/versions.d.ts +2 -0
  424. package/dist/shared/constants/versions.js +1 -1
  425. package/dist/shared/experiments.js +1 -1
  426. package/dist/shared/load-dot-env.js +1 -1
  427. package/dist/shared/plan-gates.d.ts +9 -3
  428. package/dist/shared/plan-gates.js +1 -1
  429. package/dist/shared/products.js +1 -1
  430. package/dist/shared/project-env.d.ts +12 -0
  431. package/dist/shared/project-env.js +1 -0
  432. package/dist/shared/public-env.d.ts +9 -0
  433. package/dist/shared/public-env.js +1 -1
  434. package/dist/{server → shared}/rbac/api-docs.d.ts +3 -2
  435. package/dist/shared/rbac/api-docs.js +1 -0
  436. package/dist/{server → shared}/rbac/engine.d.ts +13 -10
  437. package/dist/shared/rbac/engine.js +0 -0
  438. package/dist/{server → shared}/rbac/filter.d.ts +2 -0
  439. package/dist/shared/rbac/filter.js +1 -0
  440. package/dist/{server → shared}/rbac/l10n-rules.d.ts +1 -1
  441. package/dist/shared/rbac/l10n-rules.js +1 -0
  442. package/dist/{server → shared}/rbac/route-scope.d.ts +1 -1
  443. package/dist/shared/rbac/route-scope.js +1 -0
  444. package/dist/{server → shared}/rbac/team-templates.d.ts +6 -2
  445. package/dist/shared/rbac/team-templates.js +1 -0
  446. package/dist/{server → shared}/rbac/teams.d.ts +1 -1
  447. package/dist/shared/rbac/types.js +1 -0
  448. package/dist/shared/search/facets.d.ts +5 -0
  449. package/dist/shared/search/facets.js +1 -1
  450. package/dist/shared/types/auth.d.ts +1 -0
  451. package/dist/shared/types/config.d.ts +5 -0
  452. package/dist/shared/types/search.d.ts +8 -2
  453. package/dist/shared/types/sidebar.d.ts +1 -0
  454. package/dist/shared/utils/l10n.js +1 -1
  455. package/dist/shared/utils/redirect-match.js +1 -0
  456. package/dist/shared/utils/routes/markdown-copy-url.js +1 -0
  457. package/drizzle/20261103061150_site_config_effective_hash/migration.sql +1 -0
  458. package/drizzle/20261105151816_search_http_path_tokens/migration.sql +1 -0
  459. package/drizzle/20261111152552_page_markdown_rbac_scope/migration.sql +1 -0
  460. package/package.json +37 -13
  461. package/dist/bundler/dev/__tests__/reset-content-update-state.js +0 -1
  462. package/dist/bundler/dev/materialization-sweeper.js +0 -1
  463. package/dist/client/dev-problems/sweep-segment.js +0 -1
  464. package/dist/client/review/use-bar-position.js +0 -1
  465. package/dist/content-layer/plugins/internal/api-docs/server/markdown-docs.d.ts +0 -5
  466. package/dist/content-layer/plugins/internal/api-docs/server/markdown-docs.js +0 -26
  467. package/dist/content-layer/plugins/internal/mcp/server/gateway/__tests__/fake-kv.js +0 -1
  468. package/dist/content-layer/server/config.js +0 -1
  469. package/dist/server/__tests__/rbac-fixture.js +0 -1
  470. package/dist/server/__tests__/test-session.js +0 -1
  471. package/dist/server/constants/system-routes.js +0 -1
  472. package/dist/server/rbac/api-docs.js +0 -1
  473. package/dist/server/rbac/engine.js +0 -0
  474. package/dist/server/rbac/filter.js +0 -1
  475. package/dist/server/rbac/l10n-rules.js +0 -1
  476. package/dist/server/rbac/route-scope.js +0 -1
  477. package/dist/server/rbac/team-templates.js +0 -1
  478. package/dist/server/rbac/types.js +0 -1
  479. package/dist/shared/utils/routes/markdown-path.js +0 -1
  480. /package/dist/{server → shared}/rbac/entity-scope.js +0 -0
  481. /package/dist/{server → shared}/rbac/teams.js +0 -0
  482. /package/dist/{server → shared}/rbac/types.d.ts +0 -0
  483. /package/dist/{content-layer/markdown → shared}/utils/packed-ast.d.ts +0 -0
  484. /package/dist/{content-layer/markdown → shared}/utils/packed-ast.js +0 -0
@@ -1,4 +1,4 @@
1
- import"react";import{jsx as e,jsxs as t}from"react/jsx-runtime";import n from"styled-components";const r=n.span`
1
+ import"react";import e from"styled-components";import{jsx as t,jsxs as n}from"react/jsx-runtime";const r=e.span`
2
2
  display: flex;
3
3
  width: 100%;
4
4
  align-items: center;
@@ -8,7 +8,7 @@ import"react";import{jsx as e,jsxs as t}from"react/jsx-runtime";import n from"st
8
8
  & > a:first-child {
9
9
  margin-right: auto;
10
10
  }
11
- `;function i(){return/* @__PURE__ */ t(a,{"data-component-name":`Sidebar/PoweredByRedocly`,href:`https://redocly.com`,target:`_blank`,rel:`noopener noreferrer`,"aria-label":`Powered by Redocly`,children:[/* @__PURE__ */ e(`span`,{children:`Powered by`}),/* @__PURE__ */ t(`svg`,{viewBox:`0 0 120 28`,fill:`currentColor`,xmlns:`http://www.w3.org/2000/svg`,"aria-hidden":`true`,children:[/* @__PURE__ */ e(`path`,{d:`M17.5814 8.14659C17.5814 11.8328 14.5932 14.821 10.907 14.821H0V14.1698C3.32655 14.1698 6.02326 11.4731 6.02326 8.14659C6.02326 4.82003 3.32655 2.12333 0 2.12333V1.47217H10.907C14.5932 1.47217 17.5814 4.46041 17.5814 8.14659Z`}),/* @__PURE__ */ e(`path`,{d:`M17.5814 23.9373C17.5814 20.2511 14.5932 17.2629 10.907 17.2629H0V17.914C3.32655 17.914 6.02326 20.6107 6.02326 23.9373H17.5814Z`}),/* @__PURE__ */ e(`path`,{d:`M24.2558 22.6082V5.05356H32.8325C34.0196 5.05356 35.0645 5.28763 35.9673 5.75575C36.8868 6.20716 37.5974 6.84247 38.0989 7.66169C38.6172 8.4809 38.8763 9.42551 38.8763 10.4955C38.8763 11.6157 38.5671 12.6021 37.9485 13.4547C37.3299 14.3074 36.5023 14.9427 35.4657 15.3607L39.3528 22.6082H35.2902L31.8545 15.8873H27.8921V22.6082H24.2558ZM27.8921 12.903H32.5065C33.3257 12.903 33.9778 12.6857 34.4626 12.251C34.9642 11.8163 35.2149 11.2479 35.2149 10.5457C35.2149 9.84348 34.9642 9.27504 34.4626 8.84036C33.9778 8.40567 33.3257 8.18833 32.5065 8.18833H27.8921V12.903Z`}),/* @__PURE__ */ e(`path`,{d:`M46.6866 22.859C45.3826 22.859 44.1955 22.5581 43.1255 21.9562C42.0722 21.3543 41.2363 20.5435 40.6177 19.5236C39.9991 18.5038 39.6898 17.3586 39.6898 16.0879C39.6898 14.8173 39.9824 13.6721 40.5676 12.6522C41.1694 11.6324 41.9803 10.8215 43.0001 10.2197C44.02 9.61778 45.1568 9.31684 46.4108 9.31684C47.6647 9.31684 48.7765 9.62614 49.7461 10.2447C50.7158 10.8633 51.4765 11.6993 52.0282 12.7525C52.5967 13.8058 52.8809 15.0012 52.8809 16.3387V17.2415H43.2008C43.3512 17.7598 43.5936 18.2279 43.928 18.6459C44.2791 19.0639 44.7054 19.3899 45.207 19.6239C45.7253 19.858 46.277 19.975 46.8622 19.975C47.4473 19.975 47.9823 19.8831 48.4672 19.6992C48.9687 19.5153 49.395 19.2561 49.7461 18.9218L52.0032 20.9782C51.2007 21.6302 50.3731 22.1067 49.5204 22.4076C48.6845 22.7085 47.7399 22.859 46.6866 22.859ZM43.1506 14.7839H49.4954C49.3783 14.2656 49.161 13.8142 48.8433 13.4296C48.5424 13.0284 48.1746 12.7191 47.7399 12.5018C47.3219 12.2677 46.8538 12.1507 46.3355 12.1507C45.8005 12.1507 45.3157 12.2593 44.881 12.4767C44.4463 12.694 44.0785 13.0033 43.7776 13.4046C43.4933 13.7891 43.2843 14.2489 43.1506 14.7839Z`}),/* @__PURE__ */ e(`path`,{d:`M61.1277 22.7838C59.8905 22.7838 58.7703 22.4828 57.7672 21.881C56.7641 21.2791 55.9616 20.4766 55.3597 19.4735C54.7746 18.4536 54.482 17.3168 54.482 16.0629C54.482 14.8089 54.7746 13.6804 55.3597 12.6773C55.9616 11.6575 56.7725 10.855 57.7923 10.2698C58.8121 9.66793 59.9574 9.367 61.228 9.367C61.88 9.367 62.507 9.45895 63.1088 9.64286C63.7107 9.81004 64.2708 10.0608 64.7891 10.3952V5.05356H68.2248V22.6082H64.8392V21.5299C63.7692 22.3658 62.5321 22.7838 61.1277 22.7838ZM61.6794 19.8496C62.3147 19.8496 62.8915 19.7493 63.4098 19.5487C63.9448 19.3314 64.4046 19.0137 64.7891 18.5957V13.5049C64.4046 13.1204 63.9448 12.8194 63.4098 12.6021C62.8748 12.3847 62.298 12.2761 61.6794 12.2761C60.9605 12.2761 60.3085 12.4432 59.7233 12.7776C59.1549 13.0953 58.7035 13.5467 58.3691 14.1318C58.0347 14.7003 57.8675 15.3439 57.8675 16.0629C57.8675 16.7818 58.0347 17.4254 58.3691 17.9939C58.7035 18.5623 59.1549 19.0137 59.7233 19.3481C60.3085 19.6825 60.9605 19.8496 61.6794 19.8496Z`}),/* @__PURE__ */ e(`path`,{d:`M77.2745 22.859C75.9704 22.859 74.7917 22.5581 73.7384 21.9562C72.6852 21.3543 71.8492 20.5435 71.2306 19.5236C70.612 18.5038 70.3027 17.3586 70.3027 16.0879C70.3027 14.8173 70.6037 13.6721 71.2056 12.6522C71.8241 11.6157 72.6601 10.7964 73.7134 10.1946C74.7834 9.5927 75.9704 9.29176 77.2745 9.29176C78.5785 9.29176 79.7572 9.5927 80.8105 10.1946C81.8805 10.7964 82.7164 11.6157 83.3183 12.6522C83.9369 13.6721 84.2462 14.8173 84.2462 16.0879C84.2462 17.3586 83.9369 18.5038 83.3183 19.5236C82.7164 20.5435 81.8888 21.3543 80.8355 21.9562C79.7823 22.5581 78.5952 22.859 77.2745 22.859ZM77.2745 19.8747C77.9599 19.8747 78.5702 19.7075 79.1052 19.3732C79.6569 19.0388 80.0916 18.5874 80.4092 18.0189C80.7436 17.4338 80.9108 16.7901 80.9108 16.0879C80.9108 15.369 80.7436 14.7254 80.4092 14.1569C80.0916 13.5885 79.6569 13.1371 79.1052 12.8027C78.5702 12.4516 77.9599 12.2761 77.2745 12.2761C76.6057 12.2761 75.9955 12.4516 75.4438 12.8027C74.892 13.1371 74.4573 13.5885 74.1397 14.1569C73.822 14.7254 73.6632 15.369 73.6632 16.0879C73.6632 16.7901 73.822 17.4338 74.1397 18.0189C74.4573 18.5874 74.892 19.0388 75.4438 19.3732C75.9955 19.7075 76.6057 19.8747 77.2745 19.8747Z`}),/* @__PURE__ */ e(`path`,{d:`M92.6025 22.859C91.3151 22.859 90.1532 22.5664 89.1166 21.9813C88.08 21.3794 87.2608 20.5685 86.659 19.5487C86.0571 18.5121 85.7561 17.3586 85.7561 16.0879C85.7561 14.8006 86.0571 13.647 86.659 12.6271C87.2608 11.6073 88.08 10.7964 89.1166 10.1946C90.1532 9.5927 91.3151 9.29176 92.6025 9.29176C93.639 9.29176 94.6254 9.49239 95.5617 9.89364C96.5146 10.2949 97.3339 10.8717 98.0193 11.624L95.9128 13.856C95.4279 13.321 94.918 12.9281 94.383 12.6773C93.8647 12.4098 93.2963 12.2761 92.6777 12.2761C92.009 12.2761 91.4071 12.4432 90.8721 12.7776C90.3538 13.112 89.9358 13.5634 89.6182 14.1318C89.3172 14.7003 89.1668 15.3523 89.1668 16.0879C89.1668 16.7901 89.3172 17.4338 89.6182 18.0189C89.9358 18.5874 90.3705 19.0388 90.9222 19.3732C91.474 19.6908 92.0842 19.8496 92.7529 19.8496C93.3381 19.8496 93.8814 19.7326 94.383 19.4986C94.9013 19.2478 95.3945 18.88 95.8626 18.3951L97.919 20.5518C97.2503 21.2707 96.4478 21.8392 95.5115 22.2571C94.5753 22.6584 93.6056 22.859 92.6025 22.859Z`}),/* @__PURE__ */ e(`path`,{d:`M99.7052 22.6082V5.05356L103.141 5.05356V22.6082H99.7052Z`}),/* @__PURE__ */ e(`path`,{d:`M107.107 28C106.806 28 106.513 27.9833 106.229 27.9499C105.962 27.9331 105.736 27.9081 105.552 27.8746V24.9154C105.886 24.9823 106.288 25.0157 106.756 25.0157C108.01 25.0157 108.879 24.4222 109.364 23.2352L109.564 22.7336L104.474 9.54254H108.26L111.521 18.4453L115.207 9.54254H118.919L112.9 23.6615C112.448 24.7148 111.955 25.5591 111.42 26.1944C110.885 26.8297 110.267 27.2895 109.564 27.5737C108.879 27.8579 108.06 28 107.107 28Z`})]})]})}const a=n.a`
11
+ `;function i(){return/* @__PURE__ */ n(a,{"data-component-name":`Sidebar/PoweredByRedocly`,href:`https://redocly.com`,target:`_blank`,rel:`noopener noreferrer`,"aria-label":`Powered by Redocly`,children:[/* @__PURE__ */ t(`span`,{children:`Powered by`}),/* @__PURE__ */ n(`svg`,{viewBox:`0 0 120 28`,fill:`currentColor`,xmlns:`http://www.w3.org/2000/svg`,"aria-hidden":`true`,children:[/* @__PURE__ */ t(`path`,{d:`M17.5814 8.14659C17.5814 11.8328 14.5932 14.821 10.907 14.821H0V14.1698C3.32655 14.1698 6.02326 11.4731 6.02326 8.14659C6.02326 4.82003 3.32655 2.12333 0 2.12333V1.47217H10.907C14.5932 1.47217 17.5814 4.46041 17.5814 8.14659Z`}),/* @__PURE__ */ t(`path`,{d:`M17.5814 23.9373C17.5814 20.2511 14.5932 17.2629 10.907 17.2629H0V17.914C3.32655 17.914 6.02326 20.6107 6.02326 23.9373H17.5814Z`}),/* @__PURE__ */ t(`path`,{d:`M24.2558 22.6082V5.05356H32.8325C34.0196 5.05356 35.0645 5.28763 35.9673 5.75575C36.8868 6.20716 37.5974 6.84247 38.0989 7.66169C38.6172 8.4809 38.8763 9.42551 38.8763 10.4955C38.8763 11.6157 38.5671 12.6021 37.9485 13.4547C37.3299 14.3074 36.5023 14.9427 35.4657 15.3607L39.3528 22.6082H35.2902L31.8545 15.8873H27.8921V22.6082H24.2558ZM27.8921 12.903H32.5065C33.3257 12.903 33.9778 12.6857 34.4626 12.251C34.9642 11.8163 35.2149 11.2479 35.2149 10.5457C35.2149 9.84348 34.9642 9.27504 34.4626 8.84036C33.9778 8.40567 33.3257 8.18833 32.5065 8.18833H27.8921V12.903Z`}),/* @__PURE__ */ t(`path`,{d:`M46.6866 22.859C45.3826 22.859 44.1955 22.5581 43.1255 21.9562C42.0722 21.3543 41.2363 20.5435 40.6177 19.5236C39.9991 18.5038 39.6898 17.3586 39.6898 16.0879C39.6898 14.8173 39.9824 13.6721 40.5676 12.6522C41.1694 11.6324 41.9803 10.8215 43.0001 10.2197C44.02 9.61778 45.1568 9.31684 46.4108 9.31684C47.6647 9.31684 48.7765 9.62614 49.7461 10.2447C50.7158 10.8633 51.4765 11.6993 52.0282 12.7525C52.5967 13.8058 52.8809 15.0012 52.8809 16.3387V17.2415H43.2008C43.3512 17.7598 43.5936 18.2279 43.928 18.6459C44.2791 19.0639 44.7054 19.3899 45.207 19.6239C45.7253 19.858 46.277 19.975 46.8622 19.975C47.4473 19.975 47.9823 19.8831 48.4672 19.6992C48.9687 19.5153 49.395 19.2561 49.7461 18.9218L52.0032 20.9782C51.2007 21.6302 50.3731 22.1067 49.5204 22.4076C48.6845 22.7085 47.7399 22.859 46.6866 22.859ZM43.1506 14.7839H49.4954C49.3783 14.2656 49.161 13.8142 48.8433 13.4296C48.5424 13.0284 48.1746 12.7191 47.7399 12.5018C47.3219 12.2677 46.8538 12.1507 46.3355 12.1507C45.8005 12.1507 45.3157 12.2593 44.881 12.4767C44.4463 12.694 44.0785 13.0033 43.7776 13.4046C43.4933 13.7891 43.2843 14.2489 43.1506 14.7839Z`}),/* @__PURE__ */ t(`path`,{d:`M61.1277 22.7838C59.8905 22.7838 58.7703 22.4828 57.7672 21.881C56.7641 21.2791 55.9616 20.4766 55.3597 19.4735C54.7746 18.4536 54.482 17.3168 54.482 16.0629C54.482 14.8089 54.7746 13.6804 55.3597 12.6773C55.9616 11.6575 56.7725 10.855 57.7923 10.2698C58.8121 9.66793 59.9574 9.367 61.228 9.367C61.88 9.367 62.507 9.45895 63.1088 9.64286C63.7107 9.81004 64.2708 10.0608 64.7891 10.3952V5.05356H68.2248V22.6082H64.8392V21.5299C63.7692 22.3658 62.5321 22.7838 61.1277 22.7838ZM61.6794 19.8496C62.3147 19.8496 62.8915 19.7493 63.4098 19.5487C63.9448 19.3314 64.4046 19.0137 64.7891 18.5957V13.5049C64.4046 13.1204 63.9448 12.8194 63.4098 12.6021C62.8748 12.3847 62.298 12.2761 61.6794 12.2761C60.9605 12.2761 60.3085 12.4432 59.7233 12.7776C59.1549 13.0953 58.7035 13.5467 58.3691 14.1318C58.0347 14.7003 57.8675 15.3439 57.8675 16.0629C57.8675 16.7818 58.0347 17.4254 58.3691 17.9939C58.7035 18.5623 59.1549 19.0137 59.7233 19.3481C60.3085 19.6825 60.9605 19.8496 61.6794 19.8496Z`}),/* @__PURE__ */ t(`path`,{d:`M77.2745 22.859C75.9704 22.859 74.7917 22.5581 73.7384 21.9562C72.6852 21.3543 71.8492 20.5435 71.2306 19.5236C70.612 18.5038 70.3027 17.3586 70.3027 16.0879C70.3027 14.8173 70.6037 13.6721 71.2056 12.6522C71.8241 11.6157 72.6601 10.7964 73.7134 10.1946C74.7834 9.5927 75.9704 9.29176 77.2745 9.29176C78.5785 9.29176 79.7572 9.5927 80.8105 10.1946C81.8805 10.7964 82.7164 11.6157 83.3183 12.6522C83.9369 13.6721 84.2462 14.8173 84.2462 16.0879C84.2462 17.3586 83.9369 18.5038 83.3183 19.5236C82.7164 20.5435 81.8888 21.3543 80.8355 21.9562C79.7823 22.5581 78.5952 22.859 77.2745 22.859ZM77.2745 19.8747C77.9599 19.8747 78.5702 19.7075 79.1052 19.3732C79.6569 19.0388 80.0916 18.5874 80.4092 18.0189C80.7436 17.4338 80.9108 16.7901 80.9108 16.0879C80.9108 15.369 80.7436 14.7254 80.4092 14.1569C80.0916 13.5885 79.6569 13.1371 79.1052 12.8027C78.5702 12.4516 77.9599 12.2761 77.2745 12.2761C76.6057 12.2761 75.9955 12.4516 75.4438 12.8027C74.892 13.1371 74.4573 13.5885 74.1397 14.1569C73.822 14.7254 73.6632 15.369 73.6632 16.0879C73.6632 16.7901 73.822 17.4338 74.1397 18.0189C74.4573 18.5874 74.892 19.0388 75.4438 19.3732C75.9955 19.7075 76.6057 19.8747 77.2745 19.8747Z`}),/* @__PURE__ */ t(`path`,{d:`M92.6025 22.859C91.3151 22.859 90.1532 22.5664 89.1166 21.9813C88.08 21.3794 87.2608 20.5685 86.659 19.5487C86.0571 18.5121 85.7561 17.3586 85.7561 16.0879C85.7561 14.8006 86.0571 13.647 86.659 12.6271C87.2608 11.6073 88.08 10.7964 89.1166 10.1946C90.1532 9.5927 91.3151 9.29176 92.6025 9.29176C93.639 9.29176 94.6254 9.49239 95.5617 9.89364C96.5146 10.2949 97.3339 10.8717 98.0193 11.624L95.9128 13.856C95.4279 13.321 94.918 12.9281 94.383 12.6773C93.8647 12.4098 93.2963 12.2761 92.6777 12.2761C92.009 12.2761 91.4071 12.4432 90.8721 12.7776C90.3538 13.112 89.9358 13.5634 89.6182 14.1318C89.3172 14.7003 89.1668 15.3523 89.1668 16.0879C89.1668 16.7901 89.3172 17.4338 89.6182 18.0189C89.9358 18.5874 90.3705 19.0388 90.9222 19.3732C91.474 19.6908 92.0842 19.8496 92.7529 19.8496C93.3381 19.8496 93.8814 19.7326 94.383 19.4986C94.9013 19.2478 95.3945 18.88 95.8626 18.3951L97.919 20.5518C97.2503 21.2707 96.4478 21.8392 95.5115 22.2571C94.5753 22.6584 93.6056 22.859 92.6025 22.859Z`}),/* @__PURE__ */ t(`path`,{d:`M99.7052 22.6082V5.05356L103.141 5.05356V22.6082H99.7052Z`}),/* @__PURE__ */ t(`path`,{d:`M107.107 28C106.806 28 106.513 27.9833 106.229 27.9499C105.962 27.9331 105.736 27.9081 105.552 27.8746V24.9154C105.886 24.9823 106.288 25.0157 106.756 25.0157C108.01 25.0157 108.879 24.4222 109.364 23.2352L109.564 22.7336L104.474 9.54254H108.26L111.521 18.4453L115.207 9.54254H118.919L112.9 23.6615C112.448 24.7148 111.955 25.5591 111.42 26.1944C110.885 26.8297 110.267 27.2895 109.564 27.5737C108.879 27.8579 108.06 28 107.107 28Z`})]})]})}const a=e.a`
12
12
  display: inline-flex;
13
13
  align-items: center;
14
14
  justify-content: center;
@@ -1 +1 @@
1
- import{DEFAULT_LOCALE_PLACEHOLDER as e}from"../shared/constants/l10n/defaults.js";import"../shared/utils/l10n.js";import{stripPathPrefix as t}from"../shared/path-prefix.js";import{productClassName as n}from"../shared/products.js";import{routableLocales as r}from"../shared/utils/l10n/routable-locales.js";import{getL10nAppData as i}from"./l10n/use-l10n-config.js";import{findPageProduct as a}from"./products.js";import{L10nContext as o}from"./l10n/l10n-context.js";import{translationPackChunk as s}from"../shared/constants/l10n/default-translations.js";import{translationPackCode as c}from"../shared/utils/l10n/build-i18n-config.js";import{htmlLang as l}from"./l10n/html-lang.js";import{createServerApp as u,loadPageDependencies as d}from"./app.js";import{streamPage as f}from"./ssr-stream.js";import{createSsrL10nContext as p}from"./l10n/ssr-l10n.js";import{jsx as m}from"react/jsx-runtime";import{getLocaleFromPathname as h}from"@redocly/theme/core/utils";import"virtual:realm-markdoc-schema";import"virtual:realm-server-fns";import{serverRoutes as g}from"virtual:realm-server-routes";import{serverModules as _}from"virtual:realm-server-modules";import{mcpTools as v}from"virtual:realm-mcp-tools";async function y(g,_,v,y){let{Template:b,loaderData:x}=await d(g,{resolvedLoaderData:_,ssr:!0}),S=i(x),C=new URL(v,`http://localhost`).pathname,w=S?.defaultLocale||e,T=h(C,w,r(S)),E=a(x,t(C)??C),D=E?n(E.name):void 0,O=null;try{O=await p(S,T)}catch(e){console.error(`Realm: translations failed to load; rendering untranslated chrome.`,e)}let k=l(T),A=c(S,T),j=A===void 0?void 0:s(A);return{...await f(async e=>{let t=await u({page:g,loaderData:x,Template:e,url:v});return globalThis.SSR_HOSTNAME=y??``,/* @__PURE__ */ m(o.Provider,{value:O,children:t})},b),lang:k,translationPack:j,htmlClass:D}}export{v as mcpTools,y as render,_ as serverModules,g as serverRoutes};
1
+ import{DEFAULT_LOCALE_PLACEHOLDER as e}from"../shared/constants/l10n/defaults.js";import"../shared/utils/l10n.js";import{stripPathPrefix as t}from"../shared/path-prefix.js";import{L10nContext as n}from"./l10n/l10n-context.js";import{routableLocales as r}from"../shared/utils/l10n/routable-locales.js";import{getL10nAppData as i}from"./l10n/use-l10n-config.js";import{productClassName as a}from"../shared/products.js";import{findPageProduct as o}from"./products.js";import{ThemeGlobalStylesheetCollector as s,themeGlobalStyleTag as c}from"./ThemeGlobalStyle.js";import{translationPackChunk as l}from"../shared/constants/l10n/default-translations.js";import{translationPackCode as u}from"../shared/utils/l10n/build-i18n-config.js";import{htmlLang as d}from"./l10n/html-lang.js";import{createServerApp as f,loadPageDependencies as p}from"./app.js";import{streamPage as m}from"./ssr-stream.js";import{createSsrL10nContext as h}from"./l10n/ssr-l10n.js";import{getLocaleFromPathname as g}from"@redocly/theme/core/utils";import{jsx as _}from"react/jsx-runtime";import"virtual:realm-markdoc-schema";import"virtual:realm-server-fns";import{serverRoutes as v}from"virtual:realm-server-routes";import{serverModules as y}from"virtual:realm-server-modules";import{mcpTools as b}from"virtual:realm-mcp-tools";async function x(v,y,b,x){let{Template:S,loaderData:C}=await p(v,{resolvedLoaderData:y,ssr:!0}),w=i(C),T=new URL(b,`http://localhost`).pathname,E=w?.defaultLocale||e,D=g(T,E,r(w)),O=o(C,t(T)??T),k=O?a(O.name):void 0,A=null;try{A=await h(w,D)}catch(e){console.error(`Realm: translations failed to load; rendering untranslated chrome.`,e)}let j=d(D),M=u(w,D),N=M===void 0?void 0:l(M),P,F=await m(async e=>{let t=await f({page:v,loaderData:C,Template:e,url:b});return globalThis.SSR_HOSTNAME=x??``,/* @__PURE__ */ _(s.Provider,{value:e=>P=e,children:/* @__PURE__ */ _(n.Provider,{value:A,children:t})})},S);return{...F,styleTags:c(P)+F.styleTags,lang:j,translationPack:N,htmlClass:k}}export{b as mcpTools,x as render,y as serverModules,v as serverRoutes};
@@ -0,0 +1 @@
1
+ import{withPathPrefix as e}from"../../shared/path-prefix.js";import{telemetry as t}from"./telemetry.js";import{isChunkLoadError as n,sendChunkLoadFailed as r}from"@redocly/theme/core/utils";function i(i,a){if(!n(i))return;let o=typeof window>`u`?void 0:new URL(e(a),window.location.origin).href;r(t,i,`preload`,o)}export{i as reportPreloadFailure};
@@ -1,4 +1,4 @@
1
- import{withPathPrefix as e}from"../../shared/path-prefix.js";import{telemetry as t}from"../telemetry/telemetry.js";import{readRedirectToParam as n}from"../../shared/utils/redirect-path.js";import{useEffect as r,useState as i}from"react";import{Fragment as a,jsx as o,jsxs as s}from"react/jsx-runtime";import{getBaseDataAttributes as c}from"@redocly/theme/core/utils";import l from"styled-components";import{Button as u}from"@redocly/theme/components/Button/Button";import{useLoaderData as d}from"virtual:realm-runtime";import{Admonition as f}from"@redocly/theme/components/Admonition/Admonition";import{H3 as p}from"@redocly/theme/components/Typography/H3";import{H4 as m}from"@redocly/theme/components/Typography/H4";function h(e){return/^[a-z0-9._%'+-]+@[a-z0-9.-]+[.][a-z]+$/i.test(e)}function g(){try{return window.parent===window?void 0:window.parent.__REALM_DEV_LOGIN_USER__}catch{return}}const _=l.div`
1
+ import{withPathPrefix as e}from"../../shared/path-prefix.js";import{telemetry as t}from"../telemetry/telemetry.js";import{readRedirectToParam as n}from"../../shared/utils/redirect-path.js";import{useEffect as r,useState as i}from"react";import a from"styled-components";import{Button as o}from"@redocly/theme/components/Button/Button";import{getBaseDataAttributes as s}from"@redocly/theme/core/utils";import{Fragment as c,jsx as l,jsxs as u}from"react/jsx-runtime";import{useLoaderData as d}from"virtual:realm-runtime";import{Admonition as f}from"@redocly/theme/components/Admonition/Admonition";import{H3 as p}from"@redocly/theme/components/Typography/H3";import{H4 as m}from"@redocly/theme/components/Typography/H4";function h(e){return/^[a-z0-9._%'+-]+@[a-z0-9.-]+[.][a-z]+$/i.test(e)}function g(){try{return window.parent===window?void 0:window.parent.__REALM_DEV_LOGIN_USER__}catch{return}}const _=a.div`
2
2
  font-family: var(--font-family-base);
3
3
  display: flex;
4
4
  justify-content: center;
@@ -81,12 +81,12 @@ import{withPathPrefix as e}from"../../shared/path-prefix.js";import{telemetry as
81
81
  text-align: center;
82
82
  max-width: 500px;
83
83
  }
84
- `,v=l.div``,y=l.div`
84
+ `,v=a.div``,y=a.div`
85
85
  display: flex;
86
86
  flex-wrap: wrap;
87
87
  gap: 10px;
88
88
  margin-bottom: 32px;
89
- `,b=l.div`
89
+ `,b=a.div`
90
90
  display: flex;
91
91
  overflow: hidden;
92
92
 
@@ -98,4 +98,4 @@ import{withPathPrefix as e}from"../../shared/path-prefix.js";import{telemetry as
98
98
  text-overflow: ellipsis;
99
99
  overflow: hidden;
100
100
  }
101
- `;function x(){let l=d(`page`),[x,S]=i(`dev@example.com`),[C,w]=i(``),[T,E]=i([]),[D,O]=i([]),[k,A]=i(null),[j,M]=i(null),[N,P]=i(!1),[F,I]=i(`/`);r(()=>{I(n(window.location.search))},[]),r(()=>{let e=g();e&&(S(e.email),E(e.teams),O(e.teams))},[]);let L=l?.teams??[],R=[...new Set(L.concat(D))],z=e=>E(t=>t.includes(e)?t.filter(t=>t!==e):[...t,e]),B=()=>{let e=window.prompt(`Enter custom team name`)?.trim();e&&!R.includes(e)&&O(t=>[...t,e])},V=async t=>{if(t.preventDefault(),!h(x)){A(`Please enter a correct email`);return}A(null),M(null),P(!0);try{let t=await fetch(e(`/_auth/authorize`),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify({email:x,name:C||void 0,teams:T})});if(!t.ok){M(`Login failed (${t.status})`),P(!1);return}window.location.assign(e(F))}catch{M(`Login failed. Check your connection and try again.`),P(!1)}},H=e(`/_auth/idp-login?redirectTo=${encodeURIComponent(F)}`);return/* @__PURE__ */ s(_,{children:[/* @__PURE__ */ s(v,{children:[/* @__PURE__ */ o(p,{children:`Dev-mode login`}),/* @__PURE__ */ o(f,{type:`warning`,name:`This is a development-only login simulator`,children:`Any email works and no password is checked. Sessions minted here are real sessions.`})]}),/* @__PURE__ */ o(`form`,{onSubmit:V,children:/* @__PURE__ */ s(`div`,{className:`email-screen`,children:[/* @__PURE__ */ o(`span`,{className:`label`,children:`Email`}),/* @__PURE__ */ o(`input`,{type:`email`,required:!0,autoFocus:!0,value:x,onChange:e=>S(e.target.value),className:k?`error`:``}),k?/* @__PURE__ */ o(`span`,{className:`email-error-block`,children:k}):null,/* @__PURE__ */ o(`span`,{className:`label`,children:`Name (optional)`}),/* @__PURE__ */ o(`input`,{value:C,onChange:e=>w(e.target.value)}),/* @__PURE__ */ o(`span`,{className:`label`,children:`Select teams`}),/* @__PURE__ */ s(y,{children:[R.map(e=>/* @__PURE__ */ s(b,{children:[/* @__PURE__ */ o(`input`,{type:`checkbox`,name:e,id:e,checked:T.includes(e),onChange:()=>z(e)}),/* @__PURE__ */ o(`label`,{htmlFor:e,children:e})]},e)),/* @__PURE__ */ o(u,{type:`button`,size:`small`,fullWidth:!0,onClick:B,children:`+ Add custom team`})]}),j?/* @__PURE__ */ o(f,{type:`danger`,children:j}):null,/* @__PURE__ */ o(u,{type:`submit`,variant:`primary`,size:`large`,fullWidth:!0,disabled:N,children:`Log in`})]})}),l?.idpTitle?/* @__PURE__ */ s(a,{children:[/* @__PURE__ */ o(m,{children:`Or continue with SSO`}),/* @__PURE__ */ s(u,{type:`button`,variant:`outlined`,size:`large`,fullWidth:!0,onClick:()=>{t.sendLoginProviderClickedMessage([{...c(`loginProvider`,`button`),provider:`OIDC`}]),window.location.assign(H)},children:[`Continue with `,l.idpTitle]})]}):null]})}export{x as default};
101
+ `;function x(){let a=d(`page`),[x,S]=i(`dev@example.com`),[C,w]=i(``),[T,E]=i([]),[D,O]=i([]),[k,A]=i(null),[j,M]=i(null),[N,P]=i(!1),[F,I]=i(`/`);r(()=>{I(n(window.location.search))},[]),r(()=>{let e=g();e&&(S(e.email),E(e.teams),O(e.teams))},[]);let L=a?.teams??[],R=[...new Set(L.concat(D))],z=e=>E(t=>t.includes(e)?t.filter(t=>t!==e):[...t,e]),B=()=>{let e=window.prompt(`Enter custom team name`)?.trim();e&&!R.includes(e)&&O(t=>[...t,e])},V=async t=>{if(t.preventDefault(),!h(x)){A(`Please enter a correct email`);return}A(null),M(null),P(!0);try{let t=await fetch(e(`/_auth/authorize`),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify({email:x,name:C||void 0,teams:T})});if(!t.ok){M(`Login failed (${t.status})`),P(!1);return}window.location.assign(e(F))}catch{M(`Login failed. Check your connection and try again.`),P(!1)}},H=e(`/_auth/idp-login?redirectTo=${encodeURIComponent(F)}`);return/* @__PURE__ */ u(_,{children:[/* @__PURE__ */ u(v,{children:[/* @__PURE__ */ l(p,{children:`Dev-mode login`}),/* @__PURE__ */ l(f,{type:`warning`,name:`This is a development-only login simulator`,children:`Any email works and no password is checked. Sessions minted here are real sessions.`})]}),/* @__PURE__ */ l(`form`,{onSubmit:V,children:/* @__PURE__ */ u(`div`,{className:`email-screen`,children:[/* @__PURE__ */ l(`span`,{className:`label`,children:`Email`}),/* @__PURE__ */ l(`input`,{type:`email`,required:!0,autoFocus:!0,value:x,onChange:e=>S(e.target.value),className:k?`error`:``}),k?/* @__PURE__ */ l(`span`,{className:`email-error-block`,children:k}):null,/* @__PURE__ */ l(`span`,{className:`label`,children:`Name (optional)`}),/* @__PURE__ */ l(`input`,{value:C,onChange:e=>w(e.target.value)}),/* @__PURE__ */ l(`span`,{className:`label`,children:`Select teams`}),/* @__PURE__ */ u(y,{children:[R.map(e=>/* @__PURE__ */ u(b,{children:[/* @__PURE__ */ l(`input`,{type:`checkbox`,name:e,id:e,checked:T.includes(e),onChange:()=>z(e)}),/* @__PURE__ */ l(`label`,{htmlFor:e,children:e})]},e)),/* @__PURE__ */ l(o,{type:`button`,size:`small`,fullWidth:!0,onClick:B,children:`+ Add custom team`})]}),j?/* @__PURE__ */ l(f,{type:`danger`,children:j}):null,/* @__PURE__ */ l(o,{type:`submit`,variant:`primary`,size:`large`,fullWidth:!0,disabled:N,children:`Log in`})]})}),a?.idpTitle?/* @__PURE__ */ u(c,{children:[/* @__PURE__ */ l(m,{children:`Or continue with SSO`}),/* @__PURE__ */ u(o,{type:`button`,variant:`outlined`,size:`large`,fullWidth:!0,onClick:()=>{t.sendLoginProviderClickedMessage([{...s(`loginProvider`,`button`),provider:`OIDC`}]),window.location.assign(H)},children:[`Continue with `,a.idpTitle]})]}):null]})}export{x as default};
@@ -1,4 +1,4 @@
1
- import{jsx as e,jsxs as t}from"react/jsx-runtime";import n from"styled-components";import{useThemeHooks as r}from"@redocly/theme/core/hooks";import{useLoaderData as i}from"virtual:realm-runtime";function a(){let n=i(`page`),{useTranslate:a}=r(),{translate:d}=a();return/* @__PURE__ */ t(o,{"data-component-name":`templates/Unauthorized`,children:[/* @__PURE__ */ e(s,{children:`401`}),/* @__PURE__ */ e(c,{children:`Sign in required`}),/* @__PURE__ */ e(l,{children:n?.message??`Sign in to view this page.`}),n?.loginUrl?/* @__PURE__ */ e(u,{href:n.loginUrl,"data-translation-key":`userMenu.login`,children:d(`userMenu.login`,`Login`)}):null]})}const o=n.div`
1
+ import e from"styled-components";import{jsx as t,jsxs as n}from"react/jsx-runtime";import{useThemeHooks as r}from"@redocly/theme/core/hooks";import{useLoaderData as i}from"virtual:realm-runtime";function a(){let e=i(`page`),{useTranslate:a}=r(),{translate:d}=a();return/* @__PURE__ */ n(o,{"data-component-name":`templates/Unauthorized`,children:[/* @__PURE__ */ t(s,{children:`401`}),/* @__PURE__ */ t(c,{children:`Sign in required`}),/* @__PURE__ */ t(l,{children:e?.message??`Sign in to view this page.`}),e?.loginUrl?/* @__PURE__ */ t(u,{href:e.loginUrl,"data-translation-key":`userMenu.login`,children:d(`userMenu.login`,`Login`)}):null]})}const o=e.div`
2
2
  height: 100%;
3
3
  max-width: var(--page-403-max-width);
4
4
  display: flex;
@@ -7,22 +7,22 @@ import{jsx as e,jsxs as t}from"react/jsx-runtime";import n from"styled-component
7
7
  margin: var(--page-403-margin-vertical) var(--page-403-margin-horizontal);
8
8
  font-family: var(--page-403-font-family);
9
9
  gap: var(--page-403-gap);
10
- `,s=n.div`
10
+ `,s=e.div`
11
11
  color: var(--page-403-status-text-color);
12
12
  font-size: var(--page-403-status-font-size);
13
13
  line-height: var(--page-403-status-line-height);
14
14
  font-weight: var(--page-403-status-font-weight);
15
- `,c=n.div`
15
+ `,c=e.div`
16
16
  color: var(--page-403-title-text-color);
17
17
  font-size: var(--page-403-title-font-size);
18
18
  line-height: var(--page-403-title-line-height);
19
19
  font-weight: var(--page-403-title-font-weight);
20
- `,l=n.div`
20
+ `,l=e.div`
21
21
  color: var(--page-403-description-text-color);
22
22
  font-size: var(--page-403-description-font-size);
23
23
  line-height: var(--page-403-description-line-height);
24
24
  font-weight: var(--page-403-description-font-weight);
25
- `,u=n.a`
25
+ `,u=e.a`
26
26
  align-self: flex-start;
27
27
  color: var(--link-color-primary);
28
28
 
@@ -0,0 +1 @@
1
+ const e={};export{e as themeGlobalCss};
@@ -1 +1 @@
1
- import{LoaderDataContext as e}from"./contexts.js";import{readAppData as t}from"../shared/utils/app-data.js";import{readMarkdocDocument as n}from"../shared/utils/markdoc-document.js";import{getNextBannerTransitionDelay as r,persistDismissedBannerHash as i,readDismissedBannerHashes as a,selectActiveBanner as o}from"./banner.js";import s,{useContext as c,useEffect as l}from"react";import{useLocation as u}from"react-router";const d=[],f=/* @__PURE__ */ new Set;function p(e){return t(e).theme?.banner??d}function m(e){let t=n(e)?.frontmatter.banner;return Array.isArray(t)?t:d}function h(){let t=c(e),{pathname:n}=u(),[d,h]=s.useState(()=>typeof window>`u`?f:a()),[g,_]=s.useReducer(e=>e+1,0),v=p(t),y=m(t),b=s.useMemo(()=>o(y,v,{pathname:n,dismissedHashes:d,now:Date.now()}),[y,v,n,d,g]);return l(()=>{let e=r([...y,...v],Date.now());if(e===null)return;let t=setTimeout(_,Math.min(e+500,36e5));return()=>clearTimeout(t)},[y,v,g]),{banner:b,dismissBanner:s.useCallback(e=>{i(e),h(t=>new Set(t).add(e))},[])}}export{h as useBanner};
1
+ import{readAppData as e}from"../shared/utils/app-data.js";import{LoaderDataContext as t}from"./contexts.js";import{readMarkdocDocument as n}from"../shared/utils/markdoc-document.js";import{getNextBannerTransitionDelay as r,persistDismissedBannerHash as i,readDismissedBannerHashes as a,selectActiveBanner as o}from"./banner.js";import s,{useContext as c,useEffect as l}from"react";import{useLocation as u}from"react-router";const d=[],f=/* @__PURE__ */ new Set;function p(t){return e(t).theme?.banner??d}function m(e){let t=n(e)?.frontmatter.banner;return Array.isArray(t)?t:d}function h(){let e=c(t),{pathname:n}=u(),[d,h]=s.useState(()=>typeof window>`u`?f:a()),[g,_]=s.useReducer(e=>e+1,0),v=p(e),y=m(e),b=s.useMemo(()=>o(y,v,{pathname:n,dismissedHashes:d,now:Date.now()}),[y,v,n,d,g]);return l(()=>{let e=r([...y,...v],Date.now());if(e===null)return;let t=setTimeout(_,Math.min(e+500,36e5));return()=>clearTimeout(t)},[y,v,g]),{banner:b,dismissBanner:s.useCallback(e=>{i(e),h(t=>new Set(t).add(e))},[])}}export{h as useBanner};
@@ -0,0 +1 @@
1
+ import{useCallback as e,useEffect as t,useLayoutEffect as n,useRef as r,useState as i}from"react";const a=[`left`,`middle`,`right`];function o(e,t){try{let n=localStorage.getItem(e);return a.includes(n)?n:t}catch{return t}}function s(e,t,n){let r=32+t/2,i=window.innerWidth-n-t/2;return e===`left`?r:e===`right`?i:Math.max(r,Math.min(window.innerWidth/2,i))}function c({storageKey:c,defaultSlot:l,frozen:u=!1}){let d=r(null),[f,p]=i(()=>o(c,l)),[m,h]=i(!1),[g,_]=i(null),[v,y]=i(32),[b,x]=i(null),S=r(0),C=r(null),w=e(()=>d.current?.getBoundingClientRect().width??0,[]);n(()=>{if(u)return;let e=d.current,t=document.querySelector(`[data-component-name="Buttons/AIAssistantButton"]`),n=()=>{let e=t?.getBoundingClientRect(),n=e&&e.width>0?window.innerWidth-e.left+8:32,r=w()<=window.innerWidth-32-n?n:32;y(r),x(s(`middle`,w(),r))};n();let r=new ResizeObserver(n);return e&&r.observe(e),t&&r.observe(t),window.addEventListener(`resize`,n),()=>{r.disconnect(),window.removeEventListener(`resize`,n)}},[w,u]),t(()=>{if(!m)return;let e=e=>{let t=w(),n=Math.min(Math.max(e.clientX-S.current,s(`left`,t,v)),s(`right`,t,v));C.current=n,_(n)},t=()=>{let e=C.current??0,t=w(),n=[...a].sort((n,r)=>Math.abs(s(n,t,v)-e)-Math.abs(s(r,t,v)-e))[0];p(n);try{localStorage.setItem(c,n)}catch{}C.current=null,_(null),h(!1)};return window.addEventListener(`pointermove`,e),window.addEventListener(`pointerup`,t),window.addEventListener(`pointercancel`,t),()=>{window.removeEventListener(`pointermove`,e),window.removeEventListener(`pointerup`,t),window.removeEventListener(`pointercancel`,t)}},[m,w,c,v]);let T=e(e=>{let t=d.current?.getBoundingClientRect();if(e.button!==0||!t)return;let n=t.left+t.width/2;S.current=e.clientX-n,C.current=n,_(n),h(!0),e.preventDefault()},[]);return{barRef:d,slot:f,dragging:m,style:g===null?f===`left`?{left:`32px`}:f===`right`?{right:`${v}px`,"--bar-right-inset":`${v-32}px`}:{left:b===null?`50%`:`${b}px`,transform:`translateX(-50%)`}:{left:`${g}px`,transform:`translateX(-50%)`},onDragStart:T}}export{c as useBarPosition};
@@ -1 +1 @@
1
- import{compareVersions as e,toPhysicalVersionedSlug as t,toPublicVersionedSlug as n,versionRoutePrefix as r}from"../shared/constants/versions.js";import{PageContext as i,SidebarDataContext as a}from"./contexts.js";import{useContext as o,useMemo as s}from"react";const c=[];function l(e){return{name:typeof e?.version==`string`?e.version:void 0,group:typeof e?.versionGroup==`string`?e.versionGroup:void 0}}function u(i,a){let{name:o,group:s}=l(a);if(s===void 0||o===void 0)return c;let u=/* @__PURE__ */ new Map,d=e=>{for(let t of e){if(typeof t!=`object`||!t)continue;let e=t;if(e.versionGroup===s&&typeof e.version==`string`&&typeof e.link==`string`){let t=u.get(e.version);t||(t={firstLink:e.link,isDefault:!1,links:/* @__PURE__ */ new Set},u.set(e.version,t)),t.links.add(e.link),e.isDefaultVersion===!0&&(t.isDefault=!0),t.label===void 0&&typeof e.versionLabel==`string`&&(t.label=e.versionLabel)}Array.isArray(e.items)&&d(e.items)}};if(d(i??[]),u.size===0)return c;let f=a?.slug??``,p=t(f,s,o),m=p===null?null:p.slice(r(s,o).length),h=(e,t)=>{if(m===null)return t.firstLink;let i=n(`${r(s,e)}${m}`,s,e,t.isDefault);return t.links.has(i)?i:t.firstLink};return[...u.entries()].sort(([t],[n])=>e(n,t)).map(([e,t])=>({version:e,label:t.label??e,link:e===o?f:h(e,t),default:t.isDefault,active:e===o,folderId:e}))}function d(){let e=o(a),t=o(i);return{versions:s(()=>u(e.allItems??e.items,t),[e,t])}}export{l as selectActiveVersion,u as selectPageVersions,d as usePageVersionsImpl};
1
+ import{compareVersions as e,toPhysicalVersionedSlug as t,toPublicVersionedSlug as n,versionRoutePrefix as r}from"../shared/constants/versions.js";import{PageContext as i,SidebarDataContext as a}from"./contexts.js";import{selectEntityRevisions as o}from"./use-entity-revisions.js";import{useContext as s,useMemo as c}from"react";const l=[];function u(e){return{name:typeof e?.version==`string`?e.version:void 0,group:typeof e?.versionGroup==`string`?e.versionGroup:void 0}}function d(i,a){let{name:o,group:s}=u(a);if(s===void 0||o===void 0)return l;let c=/* @__PURE__ */ new Map,d=e=>{for(let t of e){if(typeof t!=`object`||!t)continue;let e=t;if(e.versionGroup===s&&typeof e.version==`string`&&typeof e.link==`string`){let t=c.get(e.version);t||(t={firstLink:e.link,isDefault:!1,links:/* @__PURE__ */ new Set},c.set(e.version,t)),t.links.add(e.link),e.isDefaultVersion===!0&&(t.isDefault=!0),t.label===void 0&&typeof e.versionLabel==`string`&&(t.label=e.versionLabel)}Array.isArray(e.items)&&d(e.items)}};if(d(i??[]),c.size===0)return l;let f=a?.slug??``,p=t(f,s,o),m=p===null?null:p.slice(r(s,o).length),h=(e,t)=>{if(m===null)return t.firstLink;let i=n(`${r(s,e)}${m}`,s,e,t.isDefault);return t.links.has(i)?i:t.firstLink};return[...c.entries()].sort(([t],[n])=>e(n,t)).map(([e,t])=>({version:e,label:t.label??e,link:e===o?f:h(e,t),default:t.isDefault,active:e===o,folderId:e}))}function f(e,t){let{name:n,group:i}=u(t);return i===void 0||n===void 0?[]:o(e).items.flatMap(({version:e})=>typeof e==`string`&&e!==n?[r(i,e)]:[])}function p(){let e=s(a),t=s(i);return{versions:c(()=>d(e.allItems??e.items,t),[e,t])}}export{u as selectActiveVersion,f as selectOtherVersionRoutes,d as selectPageVersions,p as usePageVersionsImpl};
@@ -1 +1 @@
1
- import{CONTENT_ASSETS_URL_PREFIX as e}from"../shared/constants/content-assets.js";import{stripPathPrefix as t}from"../shared/path-prefix.js";import{useEffect as n}from"react";import{useNavigate as r}from"react-router";const i=[`${e}/`,`/_auth/`],a=[`/login`,`/logout`,`/post-logout`],o=/\.[a-z][a-z0-9]*$/i,s=[`mouseover`,`pointerdown`,`focusin`],c=e=>e;function l(e,t=c){let i=r();n(()=>{let n=e=>{if(e.defaultPrevented||e.button!==0||e.ctrlKey||e.metaKey||e.shiftKey||e.altKey)return;let n=d(u(e.target));n!==null&&(e.preventDefault(),i(t(n)))},r=null,a=n=>{let i=d(u(n.target));i!==null&&i!==r&&(r=i,e(t(i)))};document.addEventListener(`click`,n);for(let e of s)document.addEventListener(e,a);return()=>{document.removeEventListener(`click`,n);for(let e of s)document.removeEventListener(e,a)}},[i,e,t])}function u(e){let t=e instanceof Element?e.closest(`a`):null;return t instanceof HTMLAnchorElement?t:null}function d(e){if(!e||e.hasAttribute(`download`)||e.target!==``&&e.target!==`_self`||e.origin!==location.origin||e.protocol!==location.protocol||e.pathname===location.pathname&&e.search===location.search&&e.href.includes(`#`))return null;let n=t(e.pathname);return n===null||o.test(n)||a.includes(n)||i.some(e=>n.startsWith(e))?null:`${n}${e.search}${e.hash}`}export{l as useRouterForLocalLinks};
1
+ import{stripPathPrefix as e}from"../shared/path-prefix.js";import{isRouterPath as t}from"./utils/routes/is-router-path.js";import{useEffect as n}from"react";import{useNavigate as r}from"react-router";const i=[`mouseover`,`pointerdown`,`focusin`],a=e=>e;function o(e,t=a){let o=r();n(()=>{let n=e=>{if(e.defaultPrevented||e.button!==0||e.ctrlKey||e.metaKey||e.shiftKey||e.altKey)return;let n=c(s(e.target));n!==null&&(e.preventDefault(),o(t(n)))},r=null,a=n=>{let i=c(s(n.target));i!==null&&i!==r&&(r=i,e(t(i)))};document.addEventListener(`click`,n);for(let e of i)document.addEventListener(e,a);return()=>{document.removeEventListener(`click`,n);for(let e of i)document.removeEventListener(e,a)}},[o,e,t])}function s(e){let t=e instanceof Element?e.closest(`a`):null;return t instanceof HTMLAnchorElement?t:null}function c(n){if(!n||n.hasAttribute(`download`)||n.target!==``&&n.target!==`_self`||n.origin!==location.origin||n.protocol!==location.protocol||n.pathname===location.pathname&&n.search===location.search&&n.href.includes(`#`))return null;let r=e(n.pathname);return r===null||!t(r)?null:`${r}${n.search}${n.hash}`}export{o as useRouterForLocalLinks};
@@ -1 +1 @@
1
- import{SEARCH_GROUP_FACET_FIELD as e,readSearchAppData as t}from"../shared/search/facets.js";import{SEARCH_FACETS_ROUTE_PATH as n,SEARCH_ROUTE_PATH as r}from"../shared/constants/search.js";import{APP_DATA_LOADER_KEY as i}from"../shared/constants/app-data.js";import{withPathPrefix as a}from"../shared/path-prefix.js";import{LoaderDataContext as o,PageContext as s}from"./contexts.js";import{readAppData as c}from"../shared/utils/app-data.js";import{useL10nConfig as l}from"./l10n/use-l10n-config.js";import{telemetry as u}from"./telemetry/telemetry.js";import{selectActiveVersion as d}from"./use-page-versions.js";import{SEARCH_DEBOUNCE_TIME_MS as f}from"@redocly/theme/core/constants";import{useCallback as p,useContext as m,useEffect as h,useMemo as g,useRef as _,useState as v}from"react";import{getBaseDataAttributes as y}from"@redocly/theme/core/utils";import{SearchSessionContext as b}from"@redocly/theme/core/contexts";async function x(e,t,n){let r=await fetch(a(e),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(t),signal:n});if(!r.ok)throw Error(r.statusText||`Search request failed (${r.status})`);return await r.json()}function S(e,t){return x(r,e,t)}function C(e){return Object.fromEntries(e.map(e=>[e.field,e.values]))}function w(e,t){return x(n,e,t)}function T(e){return c(e).theme?.aiAssistant?.hide===!1}function E(){let e=m(o),t=m(s);return{askAi:T(e)&&t?.aiAvailable===!0}}function D(e){return e.filter(e=>e.values.length>0).map(({field:e,values:t})=>({field:e,values:[...t]}))}function O(){let e=m(s),{currentLocale:t,defaultLocale:n}=l(),r=t===n?void 0:t,{name:i,group:a}=d(e);return g(()=>({locale:r,version:a!==void 0&&i!==void 0?{group:a,version:i}:void 0}),[r,a,i])}const k=(e,t)=>e.map(e=>({...e,isCounterVisible:t}));function A(n,r){let a=r===!1,{askAi:s}=E(),c=m(o),l=m(b)?.searchSessionId,d=O(),x=g(()=>t(c[i]),[c]),[T,A]=v(``),[j,M]=v([]),[ee,N]=v({}),[P,F]=v({}),[I,L]=v({}),[R,z]=v({}),[B,V]=v(!1),[H,U]=v(null),[W,G]=v(!1),K=_(null),q=_(null),J=_(!1),Y=g(()=>D(j),[j]),X=Y.length>0,Z=p(()=>{q.current=null,N({}),F({}),z({})},[]),Q=p((e,t,n)=>{K.current?.abort();let r=new AbortController;return K.current=r,V(!0),U(null),S(e,r.signal).then(e=>{r.signal.aborted||t(e)}).catch(e=>{r.signal.aborted||(U(e instanceof Error?e.message:`Search request failed`),n())}).finally(()=>{r.signal.aborted||V(!1)})},[]),$=p(async e=>{let t=e.trim();if(t===``&&!X){K.current?.abort(),J.current=!1,Z(),G(!1),U(null),V(!1);return}let r={query:t,...d,filter:Y,product:n};J.current=!0,await Q(r,i=>{J.current=!1,q.current=r,N(i.documents),F(i.facets??{}),z(i.groupCounts??{}),G(!0),t.length>1&&u.sendSearchQueryMessage([{...y(`searchQuery`,`search`),query:e,resultCount:Object.values(i.documents).reduce((e,t)=>e+t.length,0).toString(),...l?{searchSessionId:l}:{},...n?{product:n}:{}}])},()=>{J.current=!1,Z()})},[d,Y,X,Q,Z,n,l]),te=p(e=>{let t=typeof e==`function`?e(void 0):e,n=q.current;t&&n&&!J.current&&Q({...n,loadMore:t},e=>{let n=e.documents[t.groupKey]??[];N(e=>({...e,[t.groupKey]:[...e[t.groupKey]??[],...n]})),z(t=>({...t,...e.groupCounts}))},()=>{})},[Q]);h(()=>{if(r)return;(T.trim()!==``||X)&&V(!0);let e=setTimeout(()=>{$(T)},f);return()=>clearTimeout(e)},[T,r,X,$]),h(()=>{if(!x.advanced||!a)return;let e=new AbortController;return w({...d,product:n},e.signal).then(e=>L(C(e))).catch(()=>{e.signal.aborted||L({})}),()=>e.abort()},[x.advanced,a,d,n]),h(()=>()=>K.current?.abort(),[]);let ne=p(async()=>{await $(T)},[T,$]),re=g(()=>x.facets.map(e=>({...e,values:W?k(P[e.field]??[],!0):k(I[e.field]??[],!1)})),[x.facets,W,P,I]);return{advancedSearch:x.advanced,askAi:s,facets:re,filter:j,groupCounts:R,groupField:e,isSearchLoading:B,items:ee,query:T,searchError:H,setFilter:M,setLoadMore:te,setQuery:A,retrySearch:ne}}function j(e){let n=O(),r=m(o),a=g(()=>t(r[i]).facets.find(t=>t.field===e),[r,e]),[s,c]=v(null),[l,u]=v(null);return h(()=>{if(l===null){c(null);return}let t=new AbortController;return w({...n,field:e,query:l.query,filter:D(l.filter),facetQuery:l.facetQuery},t.signal).then(t=>{c(a?{...a,values:k(C(t)[e]??[],!0)}:null)}).catch(()=>{t.signal.aborted||c(null)}),()=>t.abort()},[e,n,l,a]),{searchFacet:s,setSearchFacet:c,setSearchFacetQuery:u}}export{S as fetchSearch,w as fetchSearchFacets,j as useFacetQuery,A as useSearch,E as useSearchFeatures,O as useSearchScope};
1
+ import{SEARCH_GROUP_FACET_FIELD as e,readSearchAppData as t}from"../shared/search/facets.js";import{SEARCH_FACETS_ROUTE_PATH as n,SEARCH_ROUTE_PATH as r}from"../shared/constants/search.js";import{APP_DATA_LOADER_KEY as i}from"../shared/constants/app-data.js";import{withPathPrefix as a}from"../shared/path-prefix.js";import{readAppData as o}from"../shared/utils/app-data.js";import{LoaderDataContext as s,PageContext as c}from"./contexts.js";import{useL10nConfig as l}from"./l10n/use-l10n-config.js";import{telemetry as u}from"./telemetry/telemetry.js";import{selectActiveVersion as d}from"./use-page-versions.js";import{SEARCH_DEBOUNCE_TIME_MS as f}from"@redocly/theme/core/constants";import{useCallback as p,useContext as m,useEffect as h,useMemo as g,useRef as _,useState as v}from"react";import{getBaseDataAttributes as y}from"@redocly/theme/core/utils";import{SearchSessionContext as b}from"@redocly/theme/core/contexts";async function x(e,t,n){let r=await fetch(a(e),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(t),signal:n});if(!r.ok)throw Error(r.statusText||`Search request failed (${r.status})`);return await r.json()}function S(e,t){return x(r,e,t)}function C(e){return Object.fromEntries(e.map(e=>[e.field,e.values]))}function w(e,t){return x(n,e,t)}function T(e){return o(e).theme?.aiAssistant?.hide===!1}function E(){let e=m(s),t=m(c);return{askAi:T(e)&&t?.aiAvailable===!0}}function D(e){return e.filter(e=>e.values.length>0).map(({field:e,values:t})=>({field:e,values:[...t]}))}function O(){let e=m(c),{currentLocale:t,defaultLocale:n}=l(),r=t===n?void 0:t,{name:i,group:a}=d(e);return g(()=>({locale:r,version:a!==void 0&&i!==void 0?{group:a,version:i}:void 0}),[r,a,i])}function k(e){if(!(!e||e.indexed>=e.total))return`Dev mode: ${e.indexed} of ${e.total} pages indexed. A page is indexed once it is opened or built.`}const A=(e,t)=>e.map(e=>({...e,isCounterVisible:t}));function j(n,r){let a=r===!1,{askAi:o}=E(),c=m(s),l=m(b)?.searchSessionId,d=O(),x=g(()=>t(c[i]),[c]),[T,j]=v(``),[M,N]=v([]),[ee,P]=v({}),[F,I]=v({}),[L,R]=v({}),[z,B]=v({}),[V,H]=v(!1),[te,U]=v(null),[ne,re]=v(),[W,G]=v(!1),K=_(null),q=_(null),J=_(!1),Y=g(()=>D(M),[M]),X=Y.length>0,Z=p(()=>{q.current=null,P({}),I({}),B({})},[]),Q=p((e,t,n)=>{K.current?.abort();let r=new AbortController;return K.current=r,H(!0),U(null),S(e,r.signal).then(e=>{r.signal.aborted||t(e)}).catch(e=>{r.signal.aborted||(U(e instanceof Error?e.message:`Search request failed`),n())}).finally(()=>{r.signal.aborted||H(!1)})},[]),$=p(async e=>{let t=e.trim();if(t===``&&!X){K.current?.abort(),J.current=!1,Z(),G(!1),U(null),H(!1);return}let r={query:t,...d,filter:Y,product:n};J.current=!0,await Q(r,i=>{J.current=!1,q.current=r,P(i.documents),I(i.facets??{}),B(i.groupCounts??{}),re(i.partial),G(!0),t.length>1&&u.sendSearchQueryMessage([{...y(`searchQuery`,`search`),query:e,resultCount:Object.values(i.documents).reduce((e,t)=>e+t.length,0).toString(),...l?{searchSessionId:l}:{},...n?{product:n}:{}}])},()=>{J.current=!1,Z()})},[d,Y,X,Q,Z,n,l]),ie=p(e=>{let t=typeof e==`function`?e(void 0):e,n=q.current;t&&n&&!J.current&&Q({...n,loadMore:t},e=>{let n=e.documents[t.groupKey]??[];P(e=>({...e,[t.groupKey]:[...e[t.groupKey]??[],...n]})),B(t=>({...t,...e.groupCounts}))},()=>{})},[Q]);h(()=>{if(r)return;(T.trim()!==``||X)&&H(!0);let e=setTimeout(()=>{$(T)},f);return()=>clearTimeout(e)},[T,r,X,$]),h(()=>{if(!x.advanced||!a)return;let e=new AbortController;return w({...d,product:n},e.signal).then(e=>R(C(e))).catch(()=>{e.signal.aborted||R({})}),()=>e.abort()},[x.advanced,a,d,n]),h(()=>()=>K.current?.abort(),[]);let ae=p(async()=>{await $(T)},[T,$]),oe=g(()=>x.facets.map(e=>({...e,values:W?A(F[e.field]??[],!0):A(L[e.field]??[],!1)})),[x.facets,W,F,L]);return{advancedSearch:x.advanced,askAi:o,facets:oe,filter:M,groupCounts:z,groupField:e,isSearchLoading:V,items:ee,query:T,searchError:te,setFilter:N,setLoadMore:ie,setQuery:j,retrySearch:ae,notice:k(ne)}}function M(e){let n=O(),r=m(s),a=g(()=>t(r[i]).facets.find(t=>t.field===e),[r,e]),[o,c]=v(null),[l,u]=v(null);return h(()=>{if(l===null){c(null);return}let t=new AbortController;return w({...n,field:e,query:l.query,filter:D(l.filter),facetQuery:l.facetQuery},t.signal).then(t=>{c(a?{...a,values:A(C(t)[e]??[],!0)}:null)}).catch(()=>{t.signal.aborted||c(null)}),()=>t.abort()},[e,n,l,a]),{searchFacet:o,setSearchFacet:c,setSearchFacetQuery:u}}export{S as fetchSearch,w as fetchSearchFacets,M as useFacetQuery,j as useSearch,E as useSearchFeatures,O as useSearchScope};
@@ -0,0 +1 @@
1
+ import{CONTENT_ASSETS_URL_PREFIX as e}from"../../../shared/constants/content-assets.js";const t=[`${e}/`,`/_assets/`,`/_auth/`],n=[`/login`,`/logout`,`/post-logout`],r=/\.(?:avif|csv|docx?|gif|gz|ico|jpe?g|json|md|mp[34]|pdf|png|pptx?|svg|tar|tgz|ttf|txt|webm|webp|woff2?|xlsx?|xml|ya?ml|zip)$/i;function i(e){let i=e.split(/[?#]/)[0];return!r.test(i)&&!n.includes(i)&&!t.some(e=>i.startsWith(e))}export{i as isRouterPath};
@@ -1 +1 @@
1
- import{normalizeRouteSlug as e}from"../../../shared/utils/routes/normalize-route-slug.js";import{splitUrlSuffix as t}from"../../../shared/utils/routes/split-url-suffix.js";import{stripPathPrefix as n}from"../../../shared/path-prefix.js";import{markdownPathForSlug as r}from"../../../shared/utils/routes/markdown-path.js";function i(i){let{path:a}=t(i);return r(e(n(a)??a))}const a=`https://site.invalid`;function o(e){let t=e.trim();if(!t.startsWith(`/`))return;let n=URL.parse(t,a);if(n?.origin===a)return`${n.pathname}${n.search}${n.hash}`}async function s(e){let t=await fetch(e,{headers:{accept:`text/plain`}});if(t.ok&&!t.headers.get(`content-type`)?.startsWith(`text/html`))return await t.text()}function c(e,t,n){let r=typeof e==`number`?e:Number(e);return!Number.isFinite(r)||r<=0?t:Math.min(Math.floor(r),n)}export{c as clampLimit,s as fetchText,i as markdownPathForRoute,o as toSitePath};
1
+ import{normalizeRouteSlug as e}from"../../../shared/utils/routes/normalize-route-slug.js";import{splitUrlSuffix as t}from"../../../shared/utils/routes/split-url-suffix.js";import{stripPathPrefix as n}from"../../../shared/path-prefix.js";import{markdownCopyUrl as r}from"../../../shared/utils/routes/markdown-copy-url.js";function i(i){let{path:a}=t(i);return r(e(n(a)??a))}const a=`https://site.invalid`;function o(e){let t=e.trim();if(!t.startsWith(`/`))return;let n=URL.parse(t,a);if(n?.origin===a)return`${n.pathname}${n.search}${n.hash}`}async function s(e){let t=await fetch(e,{headers:{accept:`text/plain`}});if(t.ok&&!t.headers.get(`content-type`)?.startsWith(`text/html`))return await t.text()}function c(e,t,n){let r=typeof e==`number`?e:Number(e);return!Number.isFinite(r)||r<=0?t:Math.min(Math.floor(r),n)}export{c as clampLimit,s as fetchText,i as markdownPathForRoute,o as toSitePath};
@@ -1 +1 @@
1
- import{toPosixPath as e}from"../shared/utils/to-posix-path.js";import{isPlanFeatureGranted as t}from"../shared/plan-gates.js";import{describePackageViolation as n,findDisallowedPackages as r}from"./find-disallowed-packages.js";import{posix as i}from"node:path";async function a(e,i,a){if(t(e,`customPackages`))return[];let s=await o(i,a);if(!s)return[];let l;try{l=c(await a.readFile(s.absolutePath))}catch(e){return[{code:`configuration/invalid`,message:`This plan allows only approved npm packages, but package.json cannot be checked: ${e.message}`,location:{filePath:s.path}}]}return r(l,e.allowedPackages??[]).map(e=>({code:`configuration/package-not-allowed`,message:n(e),location:{filePath:s.path}}))}async function o(t,n){for(let r=e(t),a=0;;r=i.dirname(r),a++){let e=i.join(r,`package.json`);if(await n.exists(e))return{absolutePath:e,path:`${`../`.repeat(a)}package.json`};if(s(r))return null}}function s(e){let t=i.dirname(e);return t===e||t===`.`}function c(e){return JSON.parse(e.replace(/^\uFEFF/,``))}export{a as checkAllowedPackages};
1
+ import{isPlanFeatureGranted as e}from"../shared/plan-gates.js";import{toPosixPath as t}from"../shared/utils/to-posix-path.js";import{describePackageViolation as n,findDisallowedPackages as r}from"./find-disallowed-packages.js";import{posix as i}from"node:path";async function a(t,i,a){if(e(t,`customPackages`))return[];let s=await o(i,a);if(!s)return[];let l;try{l=c(await a.readFile(s.absolutePath))}catch(e){return[{code:`configuration/invalid`,message:`This plan allows only approved npm packages, but package.json cannot be checked: ${e.message}`,location:{filePath:s.path}}]}return r(l,t.allowedPackages??[]).map(e=>({code:`configuration/package-not-allowed`,message:n(e),location:{filePath:s.path}}))}async function o(e,n){for(let r=t(e),a=0;;r=i.dirname(r),a++){let e=i.join(r,`package.json`);if(await n.exists(e))return{absolutePath:e,path:`${`../`.repeat(a)}package.json`};if(s(r))return null}}function s(e){let t=i.dirname(e);return t===e||t===`.`}function c(e){return JSON.parse(e.replace(/^\uFEFF/,``))}export{a as checkAllowedPackages};
@@ -1 +1 @@
1
- import{toPosixPath as e}from"../shared/utils/to-posix-path.js";import{hashContentBytes as t}from"../shared/utils/content-hash.js";import{parseNestedConfig as n}from"./config.js";import{toLowerExt as r}from"../shared/utils/file-ext.js";import{extractManifest as i}from"../shared/utils/file-manifest.js";import{posix as a,resolve as o}from"node:path";const s=`apiOutput`;function c(e){let t=new Set([...e.nestedConfigs.keys()].map(e=>a.dirname(e))),n=/* @__PURE__ */ new Map,r=(r,i)=>{for(let a of Object.values(i??{})){if(typeof a.output!=`string`)continue;let i=p(r,a.root),o=p(r,a.output);i!==null&&o!==null&&i!==o&&f(i,t)===r&&(e.isIgnored(o)||n.has(o)||n.set(o,i))}};r(``,e.config.apis);for(let[t,n]of e.nestedConfigs)r(a.dirname(t),n.apis);return n}async function l(e){let t=/* @__PURE__ */ new Map;for(let r of e.nestedConfigPaths)try{let i=await e.fs.readFile(o(e.contentDir,r));t.set(r,n(i,r).config)}catch{}return c({config:e.config,nestedConfigs:t,isIgnored:e.isIgnored})}function u(e,t){let n=new Set(e),r=t=>e.some(e=>e===``||t===e||t.startsWith(`${e}/`));for(let[e,i]of t)r(i)&&n.add(e),r(e)&&n.add(i);return[...n]}async function d(e){let n=new Map(e.files.map(e=>[e.path,e])),a=[];for(let[c,l]of e.outputs){let u=n.get(l);if(u===void 0)continue;let d=await t(new TextEncoder().encode(`${u.hash}\n${l}`)),f={path:c,absolutePath:o(e.contentDir,c),hash:d,manifestVersion:5};e.previous?.get(c)!==d&&(f.manifest={...u.manifest??i(await e.fs.readBinaryFile(u.absolutePath),r(l)),[s]:{root:l}}),a.push(f)}return a}function f(e,t){for(let n=a.dirname(e);n!==`.`&&n!==`/`;n=a.dirname(n))if(t.has(n))return n;return``}function p(t,n){let r=a.normalize(a.join(t||`.`,e(n.trim())));return r===`.`||r===``||r.startsWith(`../`)||a.isAbsolute(r)?null:r}export{s as API_OUTPUT_MANIFEST_KEY,d as apiOutputFiles,c as collectApiOutputs,l as readApiOutputs,u as withApiOutputHints};
1
+ import{toPosixPath as e}from"../shared/utils/to-posix-path.js";import{hashContentBytes as t}from"../shared/utils/content-hash.js";import{parseNestedConfig as n}from"./config.js";import{toLowerExt as r}from"../shared/utils/file-ext.js";import{extractManifest as i}from"../shared/utils/file-manifest.js";import{posix as a,resolve as o}from"node:path";const s=`apiOutput`;function c(e){let t=new Set([...e.nestedConfigs.keys()].map(e=>a.dirname(e))),n=/* @__PURE__ */ new Map,r=(r,i)=>{for(let a of Object.values(i??{})){if(typeof a.output!=`string`)continue;let i=p(r,a.root),o=p(r,a.output);i!==null&&o!==null&&i!==o&&f(i,t)===r&&(e.isIgnored(o)||n.has(o)||n.set(o,i))}};r(``,e.config.apis);for(let[t,n]of e.nestedConfigs)r(a.dirname(t),n.apis);return n}async function l(e){let t=/* @__PURE__ */ new Map;for(let r of e.nestedConfigPaths)try{let i=await e.fs.readFile(o(e.contentDir,r));t.set(r,n(i,r).config)}catch{}return c({config:e.config,nestedConfigs:t,isIgnored:e.isIgnored})}function u(e,t){let n=new Set(e),r=t=>e.some(e=>e===``||t===e||t.startsWith(`${e}/`));for(let[e,i]of t)r(i)&&n.add(e),r(e)&&n.add(i);return[...n]}async function d(e){let n=new Map(e.files.map(e=>[e.path,e])),a=[];for(let[c,l]of e.outputs){let u=n.get(l);if(u===void 0)continue;let d=await t(new TextEncoder().encode(`${u.hash}\n${l}`)),f={path:c,absolutePath:o(e.contentDir,c),hash:d,manifestVersion:6};e.previous?.get(c)!==d&&(f.manifest={...u.manifest??i(await e.fs.readBinaryFile(u.absolutePath),r(l)),[s]:{root:l}}),a.push(f)}return a}function f(e,t){for(let n=a.dirname(e);n!==`.`&&n!==`/`;n=a.dirname(n))if(t.has(n))return n;return``}function p(t,n){let r=a.normalize(a.join(t||`.`,e(n.trim())));return r===`.`||r===``||r.startsWith(`../`)||a.isAbsolute(r)?null:r}export{s as API_OUTPUT_MANIFEST_KEY,d as apiOutputFiles,c as collectApiOutputs,l as readApiOutputs,u as withApiOutputHints};
@@ -1,3 +1,4 @@
1
+ import { type EnvLookup } from '@redocly/config';
1
2
  import type { ProblemDraft } from './problems/types.js';
2
3
  /**
3
4
  * The JSON Schema keywords the config schemas use; `sanitizeConfig` implements these and
@@ -25,7 +26,11 @@ export type ConfigSchema = boolean | {
25
26
  };
26
27
  not?: ConfigSchema;
27
28
  };
28
- /** The root `redocly.yaml`. Unknown top-level keys stay: project plugins read their own. */
29
+ /**
30
+ * The root `redocly.yaml`, with each plugin's schema for the root key named by its plugin id; a
31
+ * built-in key wins over a plugin id. Unknown top-level keys stay: project plugins read their own.
32
+ */
33
+ export declare function realmConfigSchema(pluginSchemas: Readonly<Record<string, ConfigSchema>>): ConfigSchema;
29
34
  export declare const REALM_CONFIG_SCHEMA: ConfigSchema;
30
35
  /** A nested `redocly.yaml`: the product override sections, `apis`, and the API kind blocks. */
31
36
  export declare const NESTED_CONFIG_SCHEMA: ConfigSchema;
@@ -39,6 +44,10 @@ export type SanitizedConfig = {
39
44
  * `value` without the settings `schema` rejects; each removed setting is one
40
45
  * `configuration/invalid` error. An unknown key inside a known section stays and is one
41
46
  * `configuration/ignored` warning; a conflict the schema forbids stays and is an error.
42
- * Apart from those kept keys, the result validates against the schema.
47
+ * Apart from those kept keys, the result validates against the schema. A string with a
48
+ * `{{ process.env.X }}` reference is judged by its value in `env` and kept as written, so
49
+ * the result resolves again against another environment.
43
50
  */
44
- export declare function sanitizeConfig(schema: ConfigSchema, value: Record<string, unknown>): SanitizedConfig;
51
+ export declare function sanitizeConfig(schema: ConfigSchema, value: Record<string, unknown>, options?: {
52
+ env?: EnvLookup;
53
+ }): SanitizedConfig;
@@ -1 +1 @@
1
- import{isObject as e}from"../shared/utils/is-object.js";import{productConfigOverrideSchema as t,rootRedoclyConfigSchema as n}from"@redocly/config";const r=n.properties,i={type:`string`,pattern:`\\S`},a={...r.apis.additionalProperties,required:[`root`]},o={...r.scripts.properties.head.items,required:[`src`]},s=r.redirects.additionalProperties,c=r.theme.properties.asyncapi,l={type:`object`,additionalProperties:a},u={...r.scripts,properties:{head:{type:`array`,items:o},body:{type:`array`,items:o}}},d={...r.redirects,propertyNames:i,additionalProperties:{...s,properties:{...s.properties,to:i},required:[`to`]}},f={type:`object`,properties:{include:{type:`array`,items:{type:`string`,minLength:1}},max:{type:`integer`,minimum:1}},additionalProperties:!1},p={type:`object`,properties:{anchors:{type:`object`,properties:{hide:{type:`boolean`}},additionalProperties:!1}},additionalProperties:!1},m={...n,properties:{...r,apis:l,asyncapi:c,linkChecker:p,redirects:d,revisions:f,scripts:u},additionalProperties:!0},h={...t,properties:{...t.properties,apis:l,asyncapi:c,graphql:r.graphql}},g={type:`object`,properties:{banner:r.banner}},_=Symbol(`drop`);function v(t,n){let r=[],i=y(t,structuredClone(n),``,r);return{value:e(i)?i:{},problems:r}}function y(t,n,r,i){if(t===!0)return n;if(t===!1)return k(i,r,`is not allowed`);let a=b(t,n);if(a!==void 0)return k(i,r,a);let o=n;return e(n)?o=x(t,n,r,i):Array.isArray(n)&&(o=C(t,n,r,i)),o!==_&&t.oneOf&&(o=w(t.oneOf,t.discriminator,n,o,r,i)),o!==_&&t.not!==void 0&&T(t.not,o)&&i.push({code:`configuration/invalid`,message:`${A(r)} ${O(t.not)}.`}),o}function b(e,t){if(e.type!==void 0&&!E(t,e.type))return`must be ${e.type}`;if(e.enum&&!e.enum.some(e=>D(e,t)))return`must be one of: ${e.enum.join(`, `)}`;if(e.const!==void 0&&!D(e.const,t))return`must be ${JSON.stringify(e.const)}`;if(typeof t==`string`){if(e.minLength!==void 0&&t.length<e.minLength)return e.minLength===1?`must not be empty`:`must have at least ${e.minLength} characters`;if(e.pattern!==void 0&&!new RegExp(e.pattern,`u`).test(t))return e.pattern===`\\S`?`must not be empty`:`must match the pattern ${e.pattern}`}if(typeof t==`number`&&e.minimum!==void 0&&t<e.minimum)return`must be at least ${e.minimum}`}function x(e,t,n,r){let i=[];for(let[a,o]of Object.entries(t)){let t=j(n,a);if(e.propertyNames!==void 0&&!T(e.propertyNames,a)){k(r,t,`has an invalid name`);continue}let s=S(e,a);if(s===void 0){r.push({code:`configuration/ignored`,message:`\`${t}\` is not a known option and is ignored.`}),i.push([a,o]);continue}let c=y(s,o,t,r);c!==_&&i.push([a,c])}let a=Object.fromEntries(i),o=e.required??[],s=o.find(e=>!Object.hasOwn(t,e));if(s!==void 0)return k(r,n,`must have required property '${s}'`);if(e.minProperties!==void 0){if(Object.keys(t).length<e.minProperties)return k(r,n,e.minProperties===1?`must not be empty`:`must have at least ${e.minProperties} properties`);if(Object.keys(a).length<e.minProperties)return _}return o.every(e=>Object.hasOwn(a,e))?a:_}function S(e,t){if(e.properties&&Object.hasOwn(e.properties,t))return e.properties[t];for(let[n,r]of Object.entries(e.patternProperties??{}))if(new RegExp(n,`u`).test(t))return r;return e.additionalProperties===!1?void 0:e.additionalProperties??!0}function C(e,t,n,r){let{items:i}=e,a=i===void 0?t:t.flatMap((e,t)=>{let a=y(i,e,j(n,t),r);return a===_?[]:[a]});if(e.minItems!==void 0){if(t.length<e.minItems)return k(r,n,e.minItems===1?`must not be empty`:`must have at least ${e.minItems} items`);if(a.length<e.minItems)return _}return e.uniqueItems&&new Set(t.map(e=>JSON.stringify(e))).size<t.length?k(r,n,`must not have duplicate items`):a}function w(t,n,r,i,a,o){if(n){let r=n.propertyName,s=e(i)?i[r]:void 0,c=t.find(e=>{let t=typeof e==`object`?e.properties?.[r]:void 0;return s!==void 0&&typeof t==`object`&&t.const===s});return c===void 0?k(o,a,`has an invalid value`):y(c,i,a,o)}let s=e=>t.filter(t=>T(t,e)).length;return s(r)===1?s(i)===1?i:_:k(o,a,`has an invalid value`)}function T(e,t){let n=[];return y(e,t,``,n),n.length===0}function E(t,n){switch(n){case`object`:return e(t);case`array`:return Array.isArray(t);case`integer`:return Number.isInteger(t);case`number`:return typeof t==`number`&&Number.isFinite(t);default:return typeof t===n}}function D(e,t){return JSON.stringify(e)===JSON.stringify(t)}function O(e){let t=typeof e==`object`?e.required:void 0;return t?`must not set both ${t.map(e=>`\`${e}\``).join(` and `)}`:`has a value that is not allowed`}function k(e,t,n){return e.push({code:`configuration/invalid`,message:`${A(t)} ${n} and is ignored.`}),_}function A(e){return e===``?`The config`:`\`${e}\``}function j(e,t){return typeof t==`number`?`${e}[${t}]`:/^[A-Za-z_$][\w$]*$/.test(t)?e===``?t:`${e}.${t}`:`${e}[${JSON.stringify(t)}]`}export{h as NESTED_CONFIG_SCHEMA,g as PAGE_BANNER_SCHEMA,m as REALM_CONFIG_SCHEMA,v as sanitizeConfig};
1
+ import{isObject as e}from"../shared/utils/is-object.js";import{interpolateEnvVariables as t,productConfigOverrideSchema as n,rootRedoclyConfigSchema as r}from"@redocly/config";const i=r.properties,a={type:`string`,pattern:`\\S`},o={...i.apis.additionalProperties,required:[`root`]},s={...i.scripts.properties.head.items,required:[`src`]},c=i.redirects.additionalProperties,l=i.theme.properties.asyncapi,u={type:`object`,additionalProperties:o},d={...i.scripts,properties:{head:{type:`array`,items:s},body:{type:`array`,items:s}}},f={...i.redirects,propertyNames:a,additionalProperties:{...c,properties:{...c.properties,to:a},required:[`to`]}},p={type:`object`,properties:{include:{type:`array`,items:{type:`string`,minLength:1}},max:{type:`integer`,minimum:1}},additionalProperties:!1},m={type:`object`,properties:{anchors:{type:`object`,properties:{hide:{type:`boolean`},severity:{type:`string`,enum:[`error`,`warning`]}},additionalProperties:!1}},additionalProperties:!1};function h(e){return{...r,properties:{...e,...i,apis:u,asyncapi:l,linkChecker:m,redirects:f,revisions:p,scripts:d},additionalProperties:!0}}h({});const g={...n,properties:{...n.properties,apis:u,asyncapi:l,graphql:i.graphql}},_={type:`object`,properties:{banner:i.banner}},v=Symbol(`drop`);function y(n,r,i={}){let{env:a}=i,o={problems:[],resolve:a?e=>t(e,a).value:e=>e},s=b(n,structuredClone(r),``,o);return{value:e(s)?s:{},problems:o.problems}}function b(t,n,r,i){if(t===!0)return n;if(t===!1)return j(i,r,`is not allowed`);let a=S(t,x(n,i));if(a!==void 0)return j(i,r,a);let o=n;return e(n)?o=C(t,n,r,i):Array.isArray(n)&&(o=T(t,n,r,i)),o!==v&&t.oneOf&&(o=E(t.oneOf,t.discriminator,n,o,r,i)),o!==v&&t.not!==void 0&&D(t.not,o,i)&&i.problems.push({code:`configuration/invalid`,message:`${M(r)} ${A(t.not)}.`}),o}function x(e,t){return typeof e==`string`?t.resolve(e):e}function S(e,t){if(e.type!==void 0&&!O(t,e.type))return`must be ${e.type}`;if(e.enum&&!e.enum.some(e=>k(e,t)))return`must be one of: ${e.enum.join(`, `)}`;if(e.const!==void 0&&!k(e.const,t))return`must be ${JSON.stringify(e.const)}`;if(typeof t==`string`){if(e.minLength!==void 0&&t.length<e.minLength)return e.minLength===1?`must not be empty`:`must have at least ${e.minLength} characters`;if(e.pattern!==void 0&&!new RegExp(e.pattern,`u`).test(t))return e.pattern===`\\S`?`must not be empty`:`must match the pattern ${e.pattern}`}if(typeof t==`number`&&e.minimum!==void 0&&t<e.minimum)return`must be at least ${e.minimum}`}function C(e,t,n,r){let i=[];for(let[a,o]of Object.entries(t)){let t=N(n,a);if(e.propertyNames!==void 0&&!D(e.propertyNames,a,r)){j(r,t,`has an invalid name`);continue}let s=w(e,a);if(s===void 0){r.problems.push({code:`configuration/ignored`,message:`\`${t}\` is not a known option and is ignored.`}),i.push([a,o]);continue}let c=b(s,o,t,r);c!==v&&i.push([a,c])}let a=Object.fromEntries(i),o=e.required??[],s=o.find(e=>!Object.hasOwn(t,e));if(s!==void 0)return j(r,n,`must have required property '${s}'`);if(e.minProperties!==void 0){if(Object.keys(t).length<e.minProperties)return j(r,n,e.minProperties===1?`must not be empty`:`must have at least ${e.minProperties} properties`);if(Object.keys(a).length<e.minProperties)return v}return o.every(e=>Object.hasOwn(a,e))?a:v}function w(e,t){if(e.properties&&Object.hasOwn(e.properties,t))return e.properties[t];for(let[n,r]of Object.entries(e.patternProperties??{}))if(new RegExp(n,`u`).test(t))return r;return e.additionalProperties===!1?void 0:e.additionalProperties??!0}function T(e,t,n,r){let{items:i}=e,a=i===void 0?t:t.flatMap((e,t)=>{let a=b(i,e,N(n,t),r);return a===v?[]:[a]});if(e.minItems!==void 0){if(t.length<e.minItems)return j(r,n,e.minItems===1?`must not be empty`:`must have at least ${e.minItems} items`);if(a.length<e.minItems)return v}return e.uniqueItems&&new Set(t.map(e=>JSON.stringify(e))).size<t.length?j(r,n,`must not have duplicate items`):a}function E(t,n,r,i,a,o){if(n){let r=n.propertyName,s=e(i)?x(i[r],o):void 0,c=t.find(e=>{let t=typeof e==`object`?e.properties?.[r]:void 0;return s!==void 0&&typeof t==`object`&&t.const===s});return c===void 0?j(o,a,`has an invalid value`):b(c,i,a,o)}let s=e=>t.filter(t=>D(t,e,o)).length;return s(r)===1?s(i)===1?i:v:j(o,a,`has an invalid value`)}function D(e,t,n){let r={problems:[],resolve:n.resolve};return b(e,t,``,r),r.problems.length===0}function O(t,n){switch(n){case`object`:return e(t);case`array`:return Array.isArray(t);case`integer`:return Number.isInteger(t);case`number`:return typeof t==`number`&&Number.isFinite(t);default:return typeof t===n}}function k(e,t){return JSON.stringify(e)===JSON.stringify(t)}function A(e){let t=typeof e==`object`?e.required:void 0;return t?`must not set both ${t.map(e=>`\`${e}\``).join(` and `)}`:`has a value that is not allowed`}function j(e,t,n){return e.problems.push({code:`configuration/invalid`,message:`${M(t)} ${n} and is ignored.`}),v}function M(e){return e===``?`The config`:`\`${e}\``}function N(e,t){return typeof t==`number`?`${e}[${t}]`:e===``?t:/^[A-Za-z_$][\w$]*$/.test(t)?`${e}.${t}`:`${e}[${JSON.stringify(t)}]`}export{g as NESTED_CONFIG_SCHEMA,_ as PAGE_BANNER_SCHEMA,h as realmConfigSchema,y as sanitizeConfig};
@@ -1,6 +1,8 @@
1
1
  import type { PlatformFs } from '../platform/types/fs.js';
2
- import { type TeamDirs } from '../server/rbac/team-templates.js';
2
+ import { type TeamDirs } from '../shared/rbac/team-templates.js';
3
+ import { type ProcessEnv } from '../shared/public-env.js';
3
4
  import type { NestedConfig, RealmConfig } from '../shared/types/config.js';
5
+ import { type ConfigSchema } from './config-schema.js';
4
6
  import type { ContentLayerContext } from './context.js';
5
7
  import type { ProblemDraft } from './problems/types.js';
6
8
  export type { RealmConfig } from '../shared/types/config.js';
@@ -14,7 +16,14 @@ export type ConfigFileRef = {
14
16
  };
15
17
  export type LoadedRedoclyConfig = {
16
18
  absolutePath: string | null;
19
+ /** The effective config: `siteConfig` with its references resolved against the build environment. */
17
20
  config: RealmConfig;
21
+ /**
22
+ * The normalized config with its `{{ process.env.X }}` references kept, except in `access`,
23
+ * `l10n` and `redirects`: what ingest stores, so a host resolves them against its own
24
+ * environment.
25
+ */
26
+ siteConfig: RealmConfig;
18
27
  path: string | null;
19
28
  hash: string | null;
20
29
  /** The files the config read (`$ref` targets, `env` overrides, `details.path`); a change to one is a config change. */
@@ -24,18 +33,21 @@ export type LoadedRedoclyConfig = {
24
33
  };
25
34
  type ConfigObject = Record<string, unknown>;
26
35
  /**
27
- * The effective config: the file's `env` overrides for the current branch and
28
- * environment merged in, then `{{ process.env.X }}` references replaced, then the
29
- * features that the `PLAN_GATES` plan lacks turned off, then the access that
30
- * `REDOCLY_ENFORCE_LOGIN` and `REDOCLY_ENFORCE_RESIDENCY` enforce applied.
36
+ * The config: the file's `env` overrides for the current branch and environment merged
37
+ * in, the features that the `PLAN_GATES` plan lacks turned off, and the access that
38
+ * `REDOCLY_ENFORCE_LOGIN` and `REDOCLY_ENFORCE_RESIDENCY` enforce applied. `siteConfig`
39
+ * keeps the `{{ process.env.X }}` references, judged by their values in the environment;
40
+ * `config` has them replaced. A reference reads the view a host gives it (`readProjectEnv`).
41
+ * `pluginSchemas` checks the root key of each plugin id it names.
31
42
  */
32
- export declare function loadRedoclyConfig(contentDir: string, fs: PlatformFs): Promise<LoadedRedoclyConfig>;
43
+ export declare function loadRedoclyConfig(contentDir: string, fs: PlatformFs, pluginSchemas?: Readonly<Record<string, ConfigSchema>>): Promise<LoadedRedoclyConfig>;
33
44
  /**
34
- * Whether the effective config differs from `stored`, the one the last ingest kept; `null`
35
- * (no ingest yet) counts as changed. The effective config also reads the environment and
36
- * the `@l10n/` and `{folder}` directories, so a change there counts like a file edit.
45
+ * Whether the effective config differs from the one whose digest the last ingest stored;
46
+ * `null` (no ingest yet, or a row an older ingest wrote) counts as changed. The effective config
47
+ * also reads the environment and the `@l10n/` and `{folder}` directories, so a change there
48
+ * counts like a file edit.
37
49
  */
38
- export declare function isConfigChanged(config: RealmConfig, stored: RealmConfig | null): boolean;
50
+ export declare function isConfigChanged(config: RealmConfig, storedHash: string | null): boolean;
39
51
  export declare function loadContentLayerConfig(options: {
40
52
  context: ContentLayerContext;
41
53
  force?: boolean;
@@ -64,14 +76,20 @@ export declare function deepMergeConfig(base: ConfigObject, override: ConfigObje
64
76
  * The config every consumer reads: the deprecated root access keys move into `access.*`
65
77
  * (an `access.*` value wins), `reunite` and `access.rbac.reunite` move to `platform` (a
66
78
  * `platform` value wins), the `mcp.docs` options move into `mcp`, settings the config
67
- * schema rejects are removed, `access.rbac` `{folder}` rules are written per team directory,
79
+ * schema rejects are removed (a `{{ process.env.X }}` string is judged by its value in `env`
80
+ * and kept as written, except in `access`, `l10n` and `redirects`, which are resolved),
81
+ * `access.rbac` `{folder}` rules are written per team directory,
68
82
  * `access.rbac.content` and `redirects` cover every content locale, `access.requiresLogin`
69
83
  * follows the rbac rules when `access.rbac` is set, and the `PUBLIC_*` environment is
70
- * attached. `report` receives one problem per removed, ignored, or deprecated setting.
84
+ * attached, and the first Apigee adapter of `developerOnboarding` moves to `redocly.apigee` (a
85
+ * `redocly.apigee` value wins). `report` receives one problem per removed, ignored, or deprecated setting.
86
+ * `pluginSchemas` checks the root key of each plugin id it names.
71
87
  */
72
88
  export declare function normalizeRedoclyConfig(config: Record<string, unknown>, options?: {
73
89
  dirLocales?: readonly string[];
74
90
  teamDirs?: TeamDirs;
91
+ env?: ProcessEnv;
92
+ pluginSchemas?: Readonly<Record<string, ConfigSchema>>;
75
93
  report?: (problem: ProblemDraft) => void;
76
94
  }): RealmConfig;
77
95
  export declare function createEmptyRealmConfig(): RealmConfig;
@@ -1 +1 @@
1
- import{toJsonObject as e,toJsonValue as t}from"./database/utils/json.js";import{hashContentBytes as n}from"../shared/utils/content-hash.js";import{isClosedToAnonymous as r,parseRbacConfigData as i}from"../server/rbac/engine.js";import{listL10nDirs as a,resolveLocaleContext as o}from"../shared/utils/l10n.js";import{expandConfigRbacForL10n as s}from"../server/rbac/l10n-rules.js";import{expandConfigRbacTeamTemplates as c,listTeamDirs as l,teamTemplatePrefixes as u}from"../server/rbac/team-templates.js";import{getProcessEnv as d,getPublicEnv as f,resolveRedoclyEnvironment as p,sanitizeBranchName as m}from"../shared/public-env.js";import{resolveContentPath as h}from"../shared/utils/resolve-content-path.js";import{resolveConfigRedirects as g}from"./config-redirects.js";import{NESTED_CONFIG_SCHEMA as _,REALM_CONFIG_SCHEMA as v,sanitizeConfig as y}from"./config-schema.js";import{applyEnforcedAccess as b}from"./enforced-access.js";import{applyPlanGates as x}from"./plan-gates.js";import{resolve as S}from"node:path";import{interpolateEnvVariables as C}from"@redocly/config";import w from"js-yaml";const T=[`redocly.yaml`,`redocly.yml`],E=`redocly.yaml`;async function D(e,t){let r=await Q(e,t),i=d();if(!r){let e=[];return{absolutePath:null,config:b(x($(),i,t=>e.push({code:`configuration/ignored`,message:t})),i),path:null,hash:null,refs:[],problems:e}}let o=await t.readBinaryFile(r.absolutePath),s=[],c=[],f=[],p=N(new TextDecoder().decode(o),r.path),m=[],h={contentDir:e,fs:t,refs:f,warnings:s,errors:c},g=await I(await P(p,{...h,env:i,deprecations:m}),``,h),{value:_,unsetVars:v}=C(g,i);for(let e of v)s.push(`The config references process.env.${e}, which is not set.`);let y=X(await B(_,h)),S={filePath:r.path},w=[...s.map(e=>({code:`configuration/ignored`,message:e,location:S})),...[...new Set(m)].map(e=>({code:`configuration/deprecated`,message:e,location:S})),...c.map(e=>({code:`configuration/invalid`,severity:`error`,message:e,location:S}))],T=H(y.access)?y.access.rbac:void 0,E=G(y,{dirLocales:await a(e,t),teamDirs:await l(e,t,u(H(T)?T:{})),report:e=>w.push({...e,location:S})});return{...r,config:b(x(E,i,e=>w.push({code:`configuration/ignored`,message:e,location:S})),i),hash:await n(o),refs:f,problems:w}}function O(e,t){return t===null||JSON.stringify(e)!==JSON.stringify(t)}async function k(e){if(e.context.configLoaded&&e.force!==!0)return{absolutePath:e.context.configFilePath?S(e.context.contentDir,e.context.configFilePath):null,config:e.context.config,path:e.context.configFilePath,hash:e.context.configHash,refs:e.context.configRefs,problems:[]};let t=await D(e.context.contentDir,e.context.platform.fs);return e.context.config=t.config,e.context.configFilePath=t.path,e.context.configHash=t.hash,e.context.configRefs=t.refs,e.context.configLoaded=!0,t}function A(e,t){let n=C(N(e,t),d()).value,{value:r,problems:i}=y(_,n);for(let e of i)e.location={filePath:t};return{config:r,problems:i}}function j(e){return e.endsWith(`/${E}`)}async function M(e){let t=[];for(let n of e.paths)try{let r=await e.fs.readFile(S(e.contentDir,n));t.push(...A(r,n).problems)}catch(e){let r=e instanceof Error?e.message:String(e);t.push({code:`configuration/invalid`,message:`The config cannot be read: ${r}`,location:{filePath:n}})}return t}function N(t,n){let r=w.load(t);if(r==null)return{};try{return e(r)}catch(e){throw Error(`Expected ${n} to contain a YAML object.`,{cause:e})}}async function P(e,t){let{env:n,...r}=e;if(!H(n))return e;let i=t.env.PUBLIC_REDOCLY_BRANCH_NAME,a=[...i?[`branch.${m(i)}`]:[],p(t.env.REDOCLY_ENV)],o=e=>t.deprecations.push(e),s=K(r,o);for(let e of a){let r=await F(n[e],e,t);r&&(s=V(s,K(r,o)))}return s}async function F(e,t,n){if(!H(e))return null;if(typeof e.$ref!=`string`)return e;let{$ref:r,...i}=e,a=`env.${t}`,o=L(await R(r,a,n),i,a,n);return H(o)?o:null}async function I(e,t,n){if(Array.isArray(e))return Promise.all(e.map((e,r)=>I(e,`${t}[${r}]`,n)));if(!H(e))return e;if(typeof e.$ref==`string`){let{$ref:r,...i}=e;return L(await R(r,t,n),await I(i,t,n),t,n)}let r={};for(let[i,a]of Object.entries(e))r[i]=await I(a,t===``?i:`${t}.${i}`,n);return r}function L(e,t,n,r){if(Object.keys(t).length===0)return e;if(H(e))return{...e,...t};if(e==null)return t;let i=Array.isArray(e)?`list`:`scalar`;return r.warnings.push(`${n===``?`The config`:n} has keys next to a $ref to a ${i}; only the referenced file applies.`),e}function R(e,n,r){return z(e,`${n} $ref`,r,e=>t(w.load(e)))}async function z(e,t,r,i,a=`warning`){let o=a===`error`?r.errors:r.warnings,s=h(e,T[0]);if(s===null)return o.push(`${t} "${e}" escapes the content root.`),null;try{let e=await r.fs.readBinaryFile(S(r.contentDir,s));return r.refs.push({path:s,hash:await n(e)}),i(new TextDecoder().decode(e))}catch(n){let r=n instanceof Error?n.message:String(n);return o.push(`Cannot read ${t} "${e}": ${r}`),null}}async function B(e,t){let{seo:n}=e;if(!H(n)||!H(n.llmstxt)||!H(n.llmstxt.details))return e;let{path:r,...i}=n.llmstxt.details;if(typeof r!=`string`)return e;let a=null;i.content===void 0?a=await z(r,`seo.llmstxt.details.path`,t,e=>e,`error`):t.errors.push(`seo.llmstxt.details.path and seo.llmstxt.details.content are mutually exclusive; the path is ignored.`);let o={...n.llmstxt,details:a===null?i:{...i,content:a}};return{...e,seo:{...n,llmstxt:o}}}function V(e,t){let n={...e};for(let[e,r]of Object.entries(t)){if(e===`__proto__`||e===`constructor`||e===`prototype`)continue;let t=n[e];n[e]=H(t)&&H(r)?V(t,r):r}return n}function H(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const U=[`hide`,`name`,`ignore`,`publicEndpoint`],W=[`requiresLogin`,`rbac`,`sso`,`idps`,`logoutReturnUrl`,`residency`];function G(e,t={}){let n=t.report??(()=>{}),r=t.dirLocales??[],i=K(e,e=>n({code:`configuration/deprecated`,message:e}));H(i.mcp)&&i.mcp.docs!==void 0&&n({code:`configuration/deprecated`,message:`The 'mcp.docs' property is deprecated. Use the 'mcp' properties instead.`});let a=y(v,i);for(let e of a.problems)n(e);let{redirects:l,access:u,...d}=s(c(a.value,t.teamDirs??{},n),r),p={...d,publicEnv:f()};u&&(p.access=Z(u,n));let m=g(l,o(d.l10n,r));return m&&(p.redirects=m),p}function K(e,t){return Y(q(X(e),t))}function q(e,t){let n=e;e.reunite!==void 0&&(t(`The 'reunite' property is deprecated. Use 'platform' instead.`),e.platform!==void 0&&e.platform!==null&&t(`Both 'platform' and 'reunite' are set. 'reunite' is ignored, so remove it.`),n=J(e));let{access:r}=n;return H(r)&&H(r.rbac)&&r.rbac.reunite!==void 0&&(t(`The 'access.rbac.reunite' property is deprecated. Use 'access.rbac.platform' instead.`),n={...n,access:{...r,rbac:J(r.rbac)}}),n}function J(e){let{reunite:t,...n}=e;return{...n,platform:e.platform??t}}function Y(e){let{mcp:t}=e;if(!H(t))return e;let{docs:n,...r}=t;if(!H(n))return e;let i={...n};for(let e of U){let t=n[e];delete i[e],t!==void 0&&(r[e]===void 0||r[e]===null||e===`hide`&&t===!0)&&(r[e]=t)}return{...e,mcp:{...r,docs:i}}}function X(e){let t=W.map(t=>[t,e[t]]).filter(([,e])=>e!==void 0);if(t.length===0)return e;let n={...e},r=H(e.access)?{...e.access}:{};for(let[e,i]of t)delete n[e],(r[e]===void 0||r[e]===null)&&(r[e]=i);return{...n,access:r}}function Z(e,t){let n=e.rbac?i(e.rbac,e=>t({code:`configuration/invalid`,message:e})):null;return n?(e.requiresLogin===!0&&t({code:`configuration/ignored`,message:`access.requiresLogin is ignored because access.rbac is also configured — the two are mutually exclusive. Remove one.`}),{...e,requiresLogin:r(n)}):e}async function Q(e,t){for(let n of T){let r=S(e,n);if(await t.exists(r))return{absolutePath:r,path:n}}return null}function $(){return G({})}export{E as NESTED_CONFIG_FILENAME,T as REDOCLY_CONFIG_FILENAMES,$ as createEmptyRealmConfig,V as deepMergeConfig,O as isConfigChanged,j as isNestedConfigPath,k as loadContentLayerConfig,D as loadRedoclyConfig,G as normalizeRedoclyConfig,A as parseNestedConfig,M as readNestedConfigProblems};
1
+ import{toJsonObject as e,toJsonValue as t}from"./database/utils/json.js";import{hashContentBytes as n}from"../shared/utils/content-hash.js";import{getProcessEnv as r,getPublicEnv as i,resolveRedoclyEnvironment as a,sanitizeBranchName as o}from"../shared/public-env.js";import{isClosedToAnonymous as s,parseRbacConfigData as c}from"../shared/rbac/engine.js";import{readProjectEnv as l}from"../shared/project-env.js";import{listL10nDirs as u,resolveLocaleContext as d}from"../shared/utils/l10n.js";import{expandConfigRbacForL10n as f}from"../shared/rbac/l10n-rules.js";import{expandConfigRbacTeamTemplates as p,listTeamDirs as m,teamTemplatePrefixes as ee}from"../shared/rbac/team-templates.js";import{resolveContentPath as h}from"../shared/utils/resolve-content-path.js";import{resolveConfigRedirects as g}from"./config-redirects.js";import{NESTED_CONFIG_SCHEMA as _,realmConfigSchema as v,sanitizeConfig as y}from"./config-schema.js";import{hashEffectiveConfig as b,resolveSiteConfig as x}from"./database/site-config.js";import{applyEnforcedAccess as S}from"./enforced-access.js";import{applyPlanGates as C}from"./plan-gates.js";import{resolve as w}from"node:path";import T from"js-yaml";import{interpolateEnvVariables as E}from"@redocly/config";const D=[`redocly.yaml`,`redocly.yml`],O=`redocly.yaml`;async function k(e,t,i={}){let a=await oe(e,t),o=r();if(!a){let e=[],t=A(S(C($(),o,t=>e.push({code:`configuration/ignored`,message:t})),o),o);return{absolutePath:null,config:t,siteConfig:t,path:null,hash:null,refs:[],problems:e}}let s=await t.readBinaryFile(a.absolutePath),c=[],d=[],f=[],p=F(new TextDecoder().decode(s),a.path),h=[],g=l(o),_={contentDir:e,fs:t,env:g,refs:f,warnings:c,errors:d},v=Q(await ne(await R(await I(p,{..._,deprecations:h}),``,_),_)),y={filePath:a.path},b=[],w=U(v.access)?v.access.rbac:void 0,T=q(v,{dirLocales:await u(e,t),teamDirs:await m(e,t,ee(U(w)?w:{})),env:g,pluginSchemas:i,report:e=>b.push({...e,location:y})}),E=A(S(C(T,o,e=>b.push({code:`configuration/ignored`,message:e,location:y})),o),o),{config:D,unsetVars:O}=x(E,g);for(let e of O)c.push(`The config references process.env.${e}, which is not set.`);let k=[...c.map(e=>({code:`configuration/ignored`,message:e,location:y})),...[...new Set(h)].map(e=>({code:`configuration/deprecated`,message:e,location:y})),...d.map(e=>({code:`configuration/invalid`,severity:`error`,message:e,location:y})),...b];return{...a,config:D,siteConfig:E,hash:await n(s),refs:f,problems:k}}function A(e,t){let{grpcDocsEnabled:n,...r}=e;return t.REDOCLY_EXP_GRPC_DOCS_ENABLED===`true`?{...r,grpcDocsEnabled:!0}:r}function j(e,t){return b(e)!==t}async function M(e){if(e.context.configLoaded&&e.force!==!0)return{absolutePath:e.context.configFilePath?w(e.context.contentDir,e.context.configFilePath):null,config:e.context.config,siteConfig:e.context.siteConfig,path:e.context.configFilePath,hash:e.context.configHash,refs:e.context.configRefs,problems:[]};let t=Object.fromEntries(e.context.pluginRegistry.list().flatMap(e=>e.configSchema?[[e.id,e.configSchema]]:[])),n=await k(e.context.contentDir,e.context.platform.fs,t);return e.context.config=n.config,e.context.siteConfig=n.siteConfig,e.context.configFilePath=n.path,e.context.configHash=n.hash,e.context.configRefs=n.refs,e.context.configLoaded=!0,n}function N(e,t){let n=E(F(e,t),l(r())).value,{value:i,problems:a}=y(_,n);for(let e of a)e.location={filePath:t};return{config:i,problems:a}}function P(e){return e.endsWith(`/${O}`)}async function te(e){let t=[];for(let n of e.paths)try{let r=await e.fs.readFile(w(e.contentDir,n));t.push(...N(r,n).problems)}catch(e){let r=e instanceof Error?e.message:String(e);t.push({code:`configuration/invalid`,message:`The config cannot be read: ${r}`,location:{filePath:n}})}return t}function F(t,n){let r=T.load(t);if(r==null)return{};try{return e(r)}catch(e){throw Error(`Expected ${n} to contain a YAML object.`,{cause:e})}}async function I(e,t){let{env:n,...r}=e;if(!U(n))return e;let i=t.env.PUBLIC_REDOCLY_BRANCH_NAME,s=[...i?[`branch.${o(i)}`]:[],a(t.env.REDOCLY_ENV)],c=e=>t.deprecations.push(e),l=Y(r,c);for(let e of s){let r=await L(n[e],e,t);r&&(l=H(l,Y(r,c)))}return l}async function L(e,t,n){if(!U(e))return null;if(typeof e.$ref!=`string`)return e;let{$ref:r,...i}=e,a=`env.${t}`,o=z(await B(r,a,n),i,a,n);return U(o)?o:null}async function R(e,t,n){if(Array.isArray(e))return Promise.all(e.map((e,r)=>R(e,`${t}[${r}]`,n)));if(!U(e))return e;if(typeof e.$ref==`string`){let{$ref:r,...i}=e;return z(await B(r,t,n),await R(i,t,n),t,n)}let r={};for(let[i,a]of Object.entries(e))r[i]=await R(a,t===``?i:`${t}.${i}`,n);return r}function z(e,t,n,r){if(Object.keys(t).length===0)return e;if(U(e))return{...e,...t};if(e==null)return t;let i=Array.isArray(e)?`list`:`scalar`;return r.warnings.push(`${n===``?`The config`:n} has keys next to a $ref to a ${i}; only the referenced file applies.`),e}function B(e,n,r){return V(e,`${n} $ref`,r,e=>t(T.load(e)))}async function V(e,t,r,i,a=`warning`){let o=a===`error`?r.errors:r.warnings,s=h(e,D[0]);if(s===null)return o.push(`${t} "${e}" escapes the content root.`),null;try{let e=await r.fs.readBinaryFile(w(r.contentDir,s));return r.refs.push({path:s,hash:await n(e)}),i(new TextDecoder().decode(e))}catch(n){let r=n instanceof Error?n.message:String(n);return o.push(`Cannot read ${t} "${e}": ${r}`),null}}async function ne(e,t){let{seo:n}=e;if(!U(n)||!U(n.llmstxt)||!U(n.llmstxt.details))return e;let{path:r,...i}=n.llmstxt.details;if(typeof r!=`string`)return e;let a=null;i.content===void 0?a=await V(E(r,t.env).value,`seo.llmstxt.details.path`,t,e=>e,`error`):t.errors.push(`seo.llmstxt.details.path and seo.llmstxt.details.content are mutually exclusive; the path is ignored.`);let o={...n.llmstxt,details:a===null?i:{...i,path:r,content:a}};return{...e,seo:{...n,llmstxt:o}}}function H(e,t){let n={...e};for(let[e,r]of Object.entries(t)){if(e===`__proto__`||e===`constructor`||e===`prototype`)continue;let t=n[e];n[e]=U(t)&&U(r)?H(t,r):r}return n}function U(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const W=[`hide`,`name`,`ignore`,`publicEndpoint`],G=`redocly.apigee`,K=[`requiresLogin`,`rbac`,`sso`,`idps`,`logoutReturnUrl`,`residency`];function q(e,t={}){let n=t.report??(()=>{}),r=t.dirLocales??[],a=Y(e,e=>n({code:`configuration/deprecated`,message:e}));U(a.mcp)&&a.mcp.docs!==void 0&&n({code:`configuration/deprecated`,message:`The 'mcp.docs' property is deprecated. Use the 'mcp' properties instead.`});let o=y(v(t.pluginSchemas??{}),a,{env:t.env});for(let e of o.problems)n(e);let{redirects:s,access:c,...l}=f(p(J(o.value,t.env),t.teamDirs??{},n),r),u={...l,publicEnv:i()};c&&(u.access=ae(c,n));let m=g(s,d(l.l10n,r));return m&&(u.redirects=m),u}function J(e,t){if(!t)return e;let n={...e};for(let r of[`access`,`l10n`,`redirects`])r in e&&(n[r]=E(e[r],t).value);return n}function Y(e,t){return X(ie(re(Q(e),t)),t)}function X(e,t){let{developerOnboarding:n}=e;if(!U(n)||!Array.isArray(n.adapters))return e;let r=n.adapters.find(e=>U(e)&&(e.type===`APIGEE_X`||e.type===`APIGEE_EDGE`));if(!U(r)||(t(`The Apigee adapter in 'developerOnboarding' is deprecated. Add the Apigee plugin and move the adapter to 'redocly.apigee'.`),e[G]!==void 0))return e;let{type:i,ignoreApiProducts:a,allowApiProductsOutsideCatalog:o,...s}=r,c={};return a!==void 0&&(c.exclude=a),o!==void 0&&(c.allowOutsideCatalog=o),{...e,[G]:{...s,apiProducts:c}}}function re(e,t){let n=e;e.reunite!==void 0&&(t(`The 'reunite' property is deprecated. Use 'platform' instead.`),e.platform!==void 0&&e.platform!==null&&t(`Both 'platform' and 'reunite' are set. 'reunite' is ignored, so remove it.`),n=Z(e));let{access:r}=n;return U(r)&&U(r.rbac)&&r.rbac.reunite!==void 0&&(t(`The 'access.rbac.reunite' property is deprecated. Use 'access.rbac.platform' instead.`),n={...n,access:{...r,rbac:Z(r.rbac)}}),n}function Z(e){let{reunite:t,...n}=e;return{...n,platform:e.platform??t}}function ie(e){let{mcp:t}=e;if(!U(t))return e;let{docs:n,...r}=t;if(!U(n))return e;let i={...n};for(let e of W){let t=n[e];delete i[e],t!==void 0&&(r[e]===void 0||r[e]===null||e===`hide`&&t===!0)&&(r[e]=t)}return{...e,mcp:{...r,docs:i}}}function Q(e){let t=K.map(t=>[t,e[t]]).filter(([,e])=>e!==void 0);if(t.length===0)return e;let n={...e},r=U(e.access)?{...e.access}:{};for(let[e,i]of t)delete n[e],(r[e]===void 0||r[e]===null)&&(r[e]=i);return{...n,access:r}}function ae(e,t){let n=e.rbac?c(e.rbac,e=>t({code:`configuration/invalid`,message:e})):null;return n?(e.requiresLogin===!0&&t({code:`configuration/ignored`,message:`access.requiresLogin is ignored because access.rbac is also configured — the two are mutually exclusive. Remove one.`}),{...e,requiresLogin:s(n)}):e}async function oe(e,t){for(let n of D){let r=w(e,n);if(await t.exists(r))return{absolutePath:r,path:n}}return null}function $(){return q({})}export{O as NESTED_CONFIG_FILENAME,D as REDOCLY_CONFIG_FILENAMES,$ as createEmptyRealmConfig,H as deepMergeConfig,j as isConfigChanged,P as isNestedConfigPath,M as loadContentLayerConfig,k as loadRedoclyConfig,q as normalizeRedoclyConfig,N as parseNestedConfig,te as readNestedConfigProblems};
@@ -8,6 +8,8 @@ import type { ContentPlugin } from './plugins/types/plugin.js';
8
8
  import type { ContentLayerState } from './context-state.js';
9
9
  export type ContentLayerContext = {
10
10
  config: RealmConfig;
11
+ /** `config` as ingest stores it: `LoadedRedoclyConfig.siteConfig`. */
12
+ siteConfig: RealmConfig;
11
13
  configFilePath: string | null;
12
14
  configHash: string | null;
13
15
  configRefs: readonly ConfigFileRef[];
@@ -1 +1 @@
1
- import{createNodePlatform as e}from"../platform/node/create.js";import{createLogger as t}from"../shared/logger.js";import{createEmptyRealmConfig as n}from"./config.js";import{createContentPluginIO as r}from"./plugins/io.js";import{createContentPluginRegistry as i}from"./plugins/registry.js";import{resolve as a}from"node:path";function o(o){let s=a(o.contentDir),c=o.platform??e(),l=o.pluginRegistry??i(o.plugins??[],o.logger);return{config:o.config??n(),configFilePath:o.configFilePath??null,configHash:null,configRefs:[],configLoaded:o.configLoaded??o.config!==void 0,contentDir:s,currentFileIndex:o.currentFileIndex,logger:o.logger??t(),platform:c,pluginIO:o.pluginIO??r(c.fs),pluginRegistry:l,state:o.state}}function s(e){return e.context?(e.currentFileIndex!==void 0&&(e.context.currentFileIndex=e.currentFileIndex),e.context):o({contentDir:e.contentDir,currentFileIndex:e.currentFileIndex,logger:e.logger,plugins:e.plugins})}export{o as createContentLayerContext,s as resolveContentLayerContext};
1
+ import{createNodePlatform as e}from"../platform/node/create.js";import{createLogger as t}from"../shared/logger.js";import{createEmptyRealmConfig as n}from"./config.js";import{createContentPluginIO as r}from"./plugins/io.js";import{createContentPluginRegistry as i}from"./plugins/registry.js";import{resolve as a}from"node:path";function o(o){let s=a(o.contentDir),c=o.platform??e(),l=o.pluginRegistry??i(o.plugins??[],o.logger),u=o.config??n();return{config:u,siteConfig:u,configFilePath:o.configFilePath??null,configHash:null,configRefs:[],configLoaded:o.configLoaded??o.config!==void 0,contentDir:s,currentFileIndex:o.currentFileIndex,logger:o.logger??t(),platform:c,pluginIO:o.pluginIO??r(c.fs),pluginRegistry:l,state:o.state}}function s(e){return e.context?(e.currentFileIndex!==void 0&&(e.context.currentFileIndex=e.currentFileIndex),e.context):o({contentDir:e.contentDir,currentFileIndex:e.currentFileIndex,logger:e.logger,plugins:e.plugins})}export{o as createContentLayerContext,s as resolveContentLayerContext};
@@ -1 +1 @@
1
- import{RealmDbError as e,makeRow as t}from"@redocly/realm-db-client";import{DatabaseSync as n}from"node:sqlite";function r(r){let a=new n(r,{timeout:5e3}),o=/* @__PURE__ */ new Map,s=!1,c=Promise.resolve();function l(){let e,t=new Promise(t=>{e=t}),n=c.then(()=>e);return c=c.then(()=>t),n}function u(e){let t=o.get(e);if(t)return o.delete(e),o.set(e,t),t;let n=a.prepare(e);return n.setReturnArrays(!0),n.setReadBigInts(!0),o.size>=256&&o.delete(o.keys().next().value),o.set(e,n),n}function d(e){if(e===void 0)return[];if(Array.isArray(e))return e.map(f);let t={};for(let[n,r]of Object.entries(e))t[n]=f(r);return[t]}function f(e){return typeof e==`boolean`?+!!e:e}function p(e){return typeof e==`bigint`&&e>=BigInt(-(2**53-1))&&e<=BigInt(2**53-1)?Number(e):e}function m(e,n){let r=typeof e==`string`?{sql:e,args:n}:e,i=u(r.sql),a=d(r.args??n);if(i.columns().length===0){let e=i.run(...a);return h([],[],[],Number(e.changes),BigInt(e.lastInsertRowid))}let o=i.all(...a),s=i.columns(),c=s.map(e=>e.name);return h(c,s.map(e=>(e.type??``).toUpperCase()),o.map(e=>t(c,e.map(p))),0,void 0)}function h(e,t,n,r,i){return{columns:e,columnTypes:t,rows:n,rowsAffected:r,lastInsertRowid:i,toJSON:()=>({columns:e,columnTypes:t,rows:n.map(e=>Array.prototype.slice.call(e)),rowsAffected:r,lastInsertRowid:i?.toString()})}}function g(t){try{return t()}catch(t){throw new e(t instanceof Error?t.message:String(t),{code:t.code??`SQLITE_ERROR`,cause:t})}}async function _(e,t){let n=await l();try{return g(()=>m(e,t))}finally{n()}}function v(e){return e===`write`?`BEGIN IMMEDIATE`:`BEGIN DEFERRED`}async function y(e,t){let n=await l();try{return g(()=>{a.exec(v(t));try{let t=e.map(e=>m(e));return a.exec(`COMMIT`),t}catch(e){throw i(a),e}})}finally{n()}}async function b(t){let n=await l(),r=!1,o=t=>{if(r)throw new e(`transaction is closed`,{code:`TRANSACTION_CLOSED`});try{g(()=>a.exec(t))}catch(e){throw i(a),e}finally{r=!0,n()}};try{g(()=>a.exec(v(t)))}catch(e){throw n(),e}let s=()=>{if(r)throw new e(`transaction is closed`,{code:`TRANSACTION_CLOSED`})};return{async execute(e,t){return s(),g(()=>m(e,t))},async batch(e){return s(),g(()=>e.map(e=>m(e)))},async executeMultiple(e){s(),g(()=>a.exec(e))},async commit(){o(`COMMIT`)},async rollback(){r||o(`ROLLBACK`)},close(){r||(r=!0,i(a),n())},get closed(){return r}}}return{execute:_,batch:y,migrate:e=>y(e,`deferred`),transaction:b,async executeMultiple(e){let t=await l();try{g(()=>a.exec(e))}finally{t()}},close(){s=!0,o.clear(),a.close()},get closed(){return s}}}function i(e){try{e.exec(`ROLLBACK`)}catch{}}export{r as createNodeSqliteClient};
1
+ import{createSqliteDatabaseClient as e}from"@redocly/realm-db-client";import{DatabaseSync as t}from"node:sqlite";function n(n){let i=new t(n,{timeout:5e3}),o=/* @__PURE__ */ new Map;function s(e){let t=o.get(e);if(t)return o.delete(e),o.set(e,t),t;let n=i.prepare(e);return n.setReturnArrays(!0),n.setReadBigInts(!0),o.size>=256&&o.delete(o.keys().next().value),o.set(e,n),n}return e({exec:e=>i.exec(e),run({sql:e,args:t}){let n=s(e),i=r(t);if(n.columns().length===0){let e=n.run(...i);return{columns:[],rows:[],rowsAffected:Number(e.changes),lastInsertRowid:BigInt(e.lastInsertRowid)}}let o=n.all(...i),c=n.columns();return{columns:c.map(e=>e.name),columnTypes:c.map(e=>(e.type??``).toUpperCase()),rows:o.map(e=>e.map(a))}},close(){o.clear(),i.close()}})}function r(e){if(e===void 0)return[];if(Array.isArray(e))return e.map(i);let t={};for(let[n,r]of Object.entries(e))t[n]=i(r);return[t]}function i(e){return typeof e==`boolean`?+!!e:e}function a(e){return typeof e==`bigint`&&e>=BigInt(-(2**53-1))&&e<=BigInt(2**53-1)?Number(e):e}export{n as createNodeSqliteClient};
@@ -1 +1 @@
1
- import{runWithSqliteBusyRetry as e}from"./connection.js";import{assetRefs as t,assets as n}from"./schema.js";import{and as r,eq as i,inArray as a,sql as o}from"drizzle-orm";async function s(e,t){if(t.length!==0){await e.insert(n).values([...t]).onConflictDoNothing();for(let a of t)await e.update(n).set({filename:a.filename}).where(r(i(n.path,a.path),i(n.hash,a.hash)))}}async function c(e,n){await e.delete(t).where(i(t.entityId,n.entityId)),n.refs.length!==0&&await e.insert(t).values(n.refs.map(e=>({...e,entityId:n.entityId})))}async function l(e){return(await e.db.selectDistinct({path:n.path}).from(n)).map(e=>e.path)}async function u(e){return e.db.select({path:n.path,hash:n.hash,kind:n.kind,filename:n.filename}).from(n)}async function d(t,r){return e(async()=>{let e=await t.db.delete(n).where(o`(${n.path}, ${n.hash}) NOT IN (SELECT DISTINCT path, hash FROM asset_refs)`).returning(),r=new Set(e.map(e=>e.filename));if(r.size>0){let e=await t.db.select({filename:n.filename}).from(n).where(a(n.filename,[...r]));for(let t of e)r.delete(t.filename)}return{removed:e,orphanedFilenames:[...r]}},{logger:r?.logger,operation:`gc orphan assets`})}export{d as garbageCollectOrphanAssets,l as listAssetSourcePaths,u as listRegisteredAssets,c as replaceAssetRefsForEntityTx,s as upsertAssetsTx};
1
+ import{assetRefs as e,assets as t}from"./schema.js";import{runWithSqliteBusyRetry as n}from"./connection.js";import{and as r,eq as i,inArray as a,sql as o}from"drizzle-orm";async function s(e,n){if(n.length===0)return[];let o=/* @__PURE__ */ new Set;for(let a of n){let n=await e.select({filename:t.filename}).from(t).where(r(i(t.path,a.path),i(t.hash,a.hash)));for(let e of n)e.filename!==a.filename&&o.add(e.filename)}await e.insert(t).values([...n]).onConflictDoNothing();for(let a of n)await e.update(t).set({filename:a.filename}).where(r(i(t.path,a.path),i(t.hash,a.hash)));if(o.size===0)return[];let s=await e.select({filename:t.filename}).from(t).where(a(t.filename,[...o]));for(let e of s)o.delete(e.filename);return[...o]}async function c(t,n){await t.delete(e).where(i(e.entityId,n.entityId)),n.refs.length!==0&&await t.insert(e).values(n.refs.map(e=>({...e,entityId:n.entityId})))}async function l(e){return(await e.db.selectDistinct({path:t.path}).from(t)).map(e=>e.path)}async function u(e){return e.db.select({path:t.path,hash:t.hash,kind:t.kind,filename:t.filename}).from(t)}async function d(e,r){return n(async()=>{let n=await e.db.delete(t).where(o`(${t.path}, ${t.hash}) NOT IN (SELECT DISTINCT path, hash FROM asset_refs)`).returning(),r=new Set(n.map(e=>e.filename));if(r.size>0){let n=await e.db.select({filename:t.filename}).from(t).where(a(t.filename,[...r]));for(let e of n)r.delete(e.filename)}return{removed:n,orphanedFilenames:[...r]}},{logger:r?.logger,operation:`gc orphan assets`})}export{d as garbageCollectOrphanAssets,l as listAssetSourcePaths,u as listRegisteredAssets,c as replaceAssetRefsForEntityTx,s as upsertAssetsTx};
@@ -1 +1 @@
1
- import{runWithSqliteBusyRetry as e}from"./connection.js";import{blobRefs as t,blobs as n}from"./schema.js";import{eq as r,sql as i}from"drizzle-orm";async function a(t,r,i){await e(()=>t.db.insert(n).values({...r,createdAt:Date.now()}).onConflictDoNothing(),{logger:i?.logger,operation:`upsert blob`})}async function o(e,t){let[i]=await e.db.select().from(n).where(r(n.key,t)).limit(1);return i??null}async function s(e,t){let n=await o(e,t.blobKey);if(!n)throw Error(`Blob not found: ${t.blobKey}`);return t.format===`json`?JSON.parse(n.content):t.format===`text`?n.content:Buffer.from(n.content,`base64`)}async function c(e,n){await e.delete(t).where(r(t.entityId,n.entityId)),n.blobKeys.length!==0&&await e.insert(t).values(n.blobKeys.map(e=>({blobKey:e,entityId:n.entityId})))}async function l(t,n){return{removed:(await e(()=>t.db.run(i`DELETE FROM blobs WHERE key NOT IN (SELECT DISTINCT blob_key FROM blob_refs)`),{logger:n?.logger,operation:`gc orphan blobs`})).rowsAffected??0}}export{l as garbageCollectOrphanBlobs,o as getBlob,c as replaceBlobRefsForEntityTx,s as resolveDataRef,a as upsertBlob};
1
+ import{blobRefs as e,blobs as t}from"./schema.js";import{runWithSqliteBusyRetry as n}from"./connection.js";import{eq as r,sql as i}from"drizzle-orm";async function a(e,r,i){await n(()=>e.db.insert(t).values({...r,createdAt:Date.now()}).onConflictDoNothing(),{logger:i?.logger,operation:`upsert blob`})}async function o(e,n){let[i]=await e.db.select().from(t).where(r(t.key,n)).limit(1);return i??null}async function s(e,t){let n=await o(e,t.blobKey);if(!n)throw Error(`Blob not found: ${t.blobKey}`);return t.format===`json`?JSON.parse(n.content):t.format===`text`?n.content:Buffer.from(n.content,`base64`)}async function c(t,n){await t.delete(e).where(r(e.entityId,n.entityId)),n.blobKeys.length!==0&&await t.insert(e).values(n.blobKeys.map(e=>({blobKey:e,entityId:n.entityId})))}async function l(e,t){return{removed:(await n(()=>e.db.run(i`DELETE FROM blobs WHERE key NOT IN (SELECT DISTINCT blob_key FROM blob_refs)`),{logger:t?.logger,operation:`gc orphan blobs`})).rowsAffected??0}}export{l as garbageCollectOrphanBlobs,o as getBlob,c as replaceBlobRefsForEntityTx,s as resolveDataRef,a as upsertBlob};
@@ -1,3 +1,3 @@
1
- import{createNodePlatformFs as e}from"../../platform/node/fs.js";import{getRealmDir as t}from"../../shared/constants/runtime-layout.js";import{createCloudDatabaseConnection as n}from"./adapters/cloud.js";import{createLocalDatabaseConnection as r}from"./adapters/local.js";import{isRemoteDatabaseUrl as i}from"./utils/is-remote-database-url.js";import{fileURLToPath as a,pathToFileURL as o}from"node:url";import{dirname as s,join as c}from"node:path";import{sql as l}from"drizzle-orm";const u=`content-layer.db`,d=5e3,f=/* @__PURE__ */ new Map,p=/* @__PURE__ */ new Map;function m(e){let t=/^[a-z][a-z0-9+.-]*:/i.exec(e);return t?p.get(t[0].toLowerCase()):void 0}const h=a(new URL(`../../../drizzle`,import.meta.url));async function g(t){let a=t.migrationsDir??h,o=t.databaseUrl??_(t),c=t.logger,l=t.platform?.fs??e(),u,d=m(o);if(d)u=await d(o);else if(i(o))u=await n({url:o,authToken:t.authToken,instrumentation:t.instrumentation});else{let e=v(o);await l.exists(s(e))||await l.mkdir(s(e),{recursive:!0}),u=await r({path:e}),await E(u.db,c)}return t.runMigrations!==!1&&await x(u.db,{databaseUrl:o,migrationsDir:a,logger:c,operation:`run content-layer migrations`}),{db:u.db,url:o,close:async()=>{u.close()}}}function _(e){if(!e.contentDir)throw Error(`contentDir is required when databaseUrl is not provided.`);return o(c(t(e.contentDir),u)).href}function v(e){if(e.startsWith(`file:///`))return a(e);if(e.startsWith(`file:`))return e.slice(5);if(!y(e))return e;throw Error(`Unsupported content-layer database URL "${e}". Expected a file path, a file: URL, an http(s) URL, or a scheme registered with registerDatabaseUrlSchemeAdapter.`)}function y(e){return/^[a-z][a-z0-9+.-]*:/i.test(e)}async function b(e,t){let{migrate:n}=await import(`drizzle-orm/libsql/migrator`);await S(e,t),await n(e,{migrationsFolder:t})}async function x(e,t){await T({databaseUrl:t.databaseUrl,migrationsDir:t.migrationsDir,run:()=>D(()=>b(e,t.migrationsDir),{logger:t.logger,operation:t.operation})})}async function S(e,t){let{readMigrationFiles:n}=await import(`drizzle-orm/migrator`);if((await e.all(l`select 1 from sqlite_master where name = '__drizzle_migrations'`)).length===0)return;let r=new Map(n({migrationsFolder:t}).map(e=>[e.name,e.hash]));if(!(await e.all(l`select name, hash from __drizzle_migrations`)).some(e=>!r.has(e.name)||r.get(e.name)!==e.hash))return;let i=await e.all(l`select name from sqlite_master where type = 'table'
1
+ import{getRealmDir as e}from"../../shared/constants/runtime-layout.js";import{createNodePlatformFs as t}from"../../platform/node/fs.js";import{createCloudDatabaseConnection as n}from"./adapters/cloud.js";import{createLocalDatabaseConnection as r}from"./adapters/local.js";import{isRemoteDatabaseUrl as i}from"./utils/is-remote-database-url.js";import{fileURLToPath as a,pathToFileURL as o}from"node:url";import{dirname as s,join as c}from"node:path";import{sql as l}from"drizzle-orm";const u=`content-layer.db`,d=5e3,f=/* @__PURE__ */ new Map,p=/* @__PURE__ */ new Map;function m(e){let t=/^[a-z][a-z0-9+.-]*:/i.exec(e);return t?p.get(t[0].toLowerCase()):void 0}const h=a(new URL(`../../../drizzle`,import.meta.url));async function g(e){let a=e.migrationsDir??h,o=e.databaseUrl??_(e),c=e.logger,l=e.platform?.fs??t(),u,d=m(o);if(d)u=await d(o);else if(i(o))u=await n({url:o,authToken:e.authToken,instrumentation:e.instrumentation});else{let e=v(o);await l.exists(s(e))||await l.mkdir(s(e),{recursive:!0}),u=await r({path:e}),await E(u.db,c)}return e.runMigrations!==!1&&await x(u.db,{databaseUrl:o,migrationsDir:a,logger:c,operation:`run content-layer migrations`}),{db:u.db,url:o,close:async()=>{u.close()}}}function _(t){if(!t.contentDir)throw Error(`contentDir is required when databaseUrl is not provided.`);return o(c(e(t.contentDir),u)).href}function v(e){if(e.startsWith(`file:///`))return a(e);if(e.startsWith(`file:`))return e.slice(5);if(!y(e))return e;throw Error(`Unsupported content-layer database URL "${e}". Expected a file path, a file: URL, an http(s) URL, or a scheme registered with registerDatabaseUrlSchemeAdapter.`)}function y(e){return/^[a-z][a-z0-9+.-]*:/i.test(e)}async function b(e,t){let{migrate:n}=await import(`drizzle-orm/libsql/migrator`);await S(e,t),await n(e,{migrationsFolder:t})}async function x(e,t){await T({databaseUrl:t.databaseUrl,migrationsDir:t.migrationsDir,run:()=>D(()=>b(e,t.migrationsDir),{logger:t.logger,operation:t.operation})})}async function S(e,t){let{readMigrationFiles:n}=await import(`drizzle-orm/migrator`);if((await e.all(l`select 1 from sqlite_master where name = '__drizzle_migrations'`)).length===0)return;let r=new Map(n({migrationsFolder:t}).map(e=>[e.name,e.hash]));if(!(await e.all(l`select name, hash from __drizzle_migrations`)).some(e=>!r.has(e.name)||r.get(e.name)!==e.hash))return;let i=await e.all(l`select name from sqlite_master where type = 'table'
2
2
  and name not like 'sqlite\\_%' escape '\\'
3
3
  and name not like '\\_\\_realm\\_db\\_%' escape '\\'`);await e.run(l.raw(`PRAGMA foreign_keys = OFF`));for(let t of i)await e.run(l`drop table ${l.identifier(t.name)}`);await e.run(l.raw(`PRAGMA foreign_keys = ON`))}function C(e){if(e===void 0)return 500;if(!Number.isInteger(e)||e<=0)throw Error(`Invalid batch size: ${e}`);return e}function*w(e,t){for(let n=0;n<e.length;n+=t)yield e.slice(n,n+t)}async function T(e){let t=`${e.databaseUrl}::${e.migrationsDir}`,n=f.get(t);if(n){await n;return}let r=e.run().finally(()=>{f.delete(t)});f.set(t,r),await r}async function E(e,t){await e.run(l.raw(`PRAGMA busy_timeout = ${d}`)),await D(async()=>{await e.run(l.raw(`PRAGMA foreign_keys = ON`)),await e.run(l.raw(`PRAGMA journal_mode = WAL`)),await e.run(l.raw(`PRAGMA synchronous = NORMAL`))},{logger:t,operation:`configure local SQLite pragmas`})}async function D(e,t){let n=t.maxAttempts??4,r=t.retryDelayMs??50;for(let i=1;i<=n;i+=1)try{return await e()}catch(e){if(!O(e)||i===n)throw e;let a=r*i;t.logger?.warn(`SQLite database is busy; retrying ${t.operation} (attempt ${i}/${n}, ${a}ms backoff)`),await k(a)}throw Error(`Failed to ${t.operation}.`)}function O(e){return e instanceof Error?`code`in e&&e.code===`SQLITE_BUSY`||`errcode`in e&&e.errcode===5||e.message.includes(`SQLITE_BUSY`)||e.message.includes(`database is locked`)?!0:`cause`in e&&O(e.cause):!1}function k(e){return new Promise(t=>{setTimeout(t,e)})}export{u as CONTENT_LAYER_DB_FILENAME,d as DEFAULT_SQLITE_BUSY_TIMEOUT_MS,w as batchValues,C as normalizeBatchSize,g as openContentLayerDatabase,v as resolveLocalDatabasePath,D as runWithSqliteBusyRetry};
@@ -28,6 +28,11 @@ export type EntityStore = {
28
28
  list(filter?: EntityListFilter): Promise<readonly EntityRecordView[]>;
29
29
  /** The logical value, blob refs resolved. Treat it as read-only. */
30
30
  load<TValue = JsonValue>(key: string): Promise<TValue>;
31
+ /**
32
+ * `load`, except when the entity's loader fails: the value of its last successful load, and
33
+ * undefined when it never loaded. The entity reports the failure as its own problem.
34
+ */
35
+ tryLoad<TValue = JsonValue>(key: string): Promise<TValue | undefined>;
31
36
  /** Every stored revision of these entities, newest first; one item per version and revision time. */
32
37
  listRevisions(keys: readonly string[]): Promise<EntityRevisionListItem[]>;
33
38
  };
@@ -41,15 +46,31 @@ export type EntityStoreOptions = {
41
46
  * rows never materialize. Null/absent = current rows (the hot path).
42
47
  */
43
48
  revisionAsOf?: number | null;
44
- /** Produces a missing or stale value; absent = stored values only (production runtime). */
49
+ /**
50
+ * Produces a missing or stale value and patches its row in `state`; absent = stored values
51
+ * only (production runtime).
52
+ */
45
53
  materialize?: (key: string) => Promise<JsonValue>;
46
- /** Called with every key `get`/`load` touched, once the read is known — the reader's entity deps. */
47
- onEntityRead?: (key: string) => void;
54
+ /**
55
+ * Called with every key `get`/`load` touched, once the read is known — the reader's entity
56
+ * deps. `failed` marks a read whose materialization failed.
57
+ */
58
+ onEntityRead?: (key: string, failed?: true) => void;
48
59
  /** Receives one `entity-type` membership row per `list` call. */
49
60
  record?: RouteQueryRecorder;
50
61
  };
51
62
  export declare function createEntityStore(options: EntityStoreOptions): EntityStore;
63
+ /**
64
+ * Makes the state entry of `key` match its stored row after a materialization: in place, so
65
+ * every store over this state, and a `get` after a `load`, sees the loader's metadata.
66
+ */
67
+ export declare function refreshStateEntity(database: ContentLayerDatabase, state: ContentStateView, key: string): Promise<void>;
52
68
  /** The hash a hook's `entity` read records: identity, type, metadata, and value hash, or absence. */
53
69
  export declare function hashEntityRead(state: ContentStateView, key: string): string;
54
70
  /** Re-runs a stored `entity-type` query against `state`; the hash `list` recorded. */
55
71
  export declare function hashEntityListMembership(state: ContentStateView, argument: string): string;
72
+ /** The current metadata of `keys` in one read; a key with no current entity is absent. */
73
+ export declare function loadCurrentEntityMetadata(database: ContentLayerDatabase, keys: readonly string[]): Promise<{
74
+ key: string;
75
+ metadata: JsonObject | null;
76
+ }[]>;