@redocly/framework 1.0.0-next.5 → 1.0.0-next.7

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 (307) 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/routes/source-sync-route.js +1 -1
  12. package/dist/bundler/dev/run.js +1 -1
  13. package/dist/bundler/dev/runtime-app.js +1 -1
  14. package/dist/bundler/dev/vite-chunk-url.js +1 -1
  15. package/dist/bundler/node-bundle.js +1 -0
  16. package/dist/bundler/runtime-files.js +1 -1
  17. package/dist/bundler/user-markdoc-schema.js +1 -1
  18. package/dist/bundler/vite-config.base.js +12 -12
  19. package/dist/cli/commands/build.js +1 -1
  20. package/dist/cli/commands/dev.js +1 -1
  21. package/dist/cli/commands/ingest.js +1 -1
  22. package/dist/cli/commands/translate.js +2 -2
  23. package/dist/cli/dev-console/{sweep.js → content-build.js} +1 -1
  24. package/dist/cli/dev-console/index.js +1 -1
  25. package/dist/cli/dev-console/lines.js +2 -2
  26. package/dist/cli/dev-console/plain.js +1 -1
  27. package/dist/cli/dev-console/tui.js +2 -2
  28. package/dist/cli/log-output/index.js +1 -1
  29. package/dist/cli/validate-react-pages.js +1 -1
  30. package/dist/client/ApiAccess.js +3 -0
  31. package/dist/client/NavigationProgress.js +1 -1
  32. package/dist/client/ProductsProvider.js +1 -1
  33. package/dist/client/RouteErrorBoundary.js +1 -1
  34. package/dist/client/ThemeGlobalStyle.js +1 -0
  35. package/dist/client/UnversionedVersionButton.js +1 -1
  36. package/dist/client/ai-search/use-ai-search.js +1 -1
  37. package/dist/client/analytics-page-view.js +1 -1
  38. package/dist/client/app.js +3 -3
  39. package/dist/client/client-entry.js +1 -1
  40. package/dist/client/contexts.js +1 -1
  41. package/dist/client/dev-problems/ProblemsBar.js +61 -11
  42. package/dist/client/dev-problems/ProblemsModal.js +15 -15
  43. package/dist/client/dev-problems/build-segment.js +1 -0
  44. package/dist/client/dev-problems/index.js +1 -1
  45. package/dist/client/dev-problems/use-dev-problems.js +1 -1
  46. package/dist/client/feedback.js +1 -1
  47. package/dist/client/l10n/ssr-l10n.js +1 -1
  48. package/dist/client/l10n/use-l10n-config.js +1 -1
  49. package/dist/client/l10n/use-l10n-href.js +1 -1
  50. package/dist/client/l10n/use-translate.js +1 -1
  51. package/dist/client/products.js +1 -1
  52. package/dist/client/review/ReviewBar.js +61 -61
  53. package/dist/client/review/use-review.js +1 -1
  54. package/dist/client/sidebar/PoweredByRedocly.js +2 -2
  55. package/dist/client/sidebar/SidebarDataProvider.js +1 -1
  56. package/dist/client/sidebar/drilldown.js +1 -1
  57. package/dist/client/ssr.js +1 -1
  58. package/dist/client/telemetry/config.js +1 -1
  59. package/dist/client/telemetry/report-preload-failure.js +1 -0
  60. package/dist/client/templates/dev-login.js +4 -4
  61. package/dist/client/templates/unauthorized.js +5 -5
  62. package/dist/client/theme-global-css.js +1 -0
  63. package/dist/client/theme-logo.js +1 -1
  64. package/dist/client/use-banner.js +1 -1
  65. package/dist/client/use-entity-revisions.js +1 -1
  66. package/dist/client/use-page-versions.js +1 -1
  67. package/dist/client/use-search.js +1 -1
  68. package/dist/client/webmcp/tools/shared.js +1 -1
  69. package/dist/client/webmcp/tools/site-tools.js +1 -1
  70. package/dist/client/webmcp/use-webmcp-tools.js +1 -1
  71. package/dist/content-layer/allowed-packages.js +1 -1
  72. package/dist/content-layer/config-schema.d.ts +5 -1
  73. package/dist/content-layer/config-schema.js +1 -1
  74. package/dist/content-layer/config.d.ts +8 -3
  75. package/dist/content-layer/config.js +1 -1
  76. package/dist/content-layer/database/adapters/node-sqlite-client.js +1 -1
  77. package/dist/content-layer/database/connection.js +1 -1
  78. package/dist/content-layer/database/entity-store.d.ts +9 -1
  79. package/dist/content-layer/database/entity-store.js +1 -1
  80. package/dist/content-layer/database/invalidation.js +26 -26
  81. package/dist/content-layer/database/origins.d.ts +2 -4
  82. package/dist/content-layer/database/origins.js +1 -1
  83. package/dist/content-layer/ingest/extract-all-phase.js +1 -1
  84. package/dist/content-layer/ingest/finalize-phase.js +1 -1
  85. package/dist/content-layer/ingest/git-last-modified.js +3 -3
  86. package/dist/content-layer/ingest/hook-inputs.js +1 -1
  87. package/dist/content-layer/ingest/normalize-artifacts.js +1 -1
  88. package/dist/content-layer/ingest/rbac-teams.js +1 -1
  89. package/dist/content-layer/ingest/run.js +1 -1
  90. package/dist/content-layer/ingest/scan.d.ts +1 -1
  91. package/dist/content-layer/ingest/scan.js +1 -1
  92. package/dist/content-layer/ingest/search-sync.js +1 -1
  93. package/dist/content-layer/ingest/slugger/resolve-final-slugs.js +1 -1
  94. package/dist/content-layer/ingest/sync.js +1 -1
  95. package/dist/content-layer/link-checker/load-view.js +1 -1
  96. package/dist/content-layer/link-checker/validate.js +1 -1
  97. package/dist/content-layer/loaders/context.js +1 -1
  98. package/dist/content-layer/markdown/client/OpenapiTagComponents.js +2 -2
  99. package/dist/content-layer/markdown/client/dynamic-components.js +1 -1
  100. package/dist/content-layer/markdown/client/markdoc-components.js +2 -2
  101. package/dist/content-layer/markdown/client/markdown-text.js +1 -1
  102. package/dist/content-layer/markdown/constants/builtin-tags.js +1 -1
  103. package/dist/content-layer/markdown/constants/markdown-text-tag-set.js +1 -1
  104. package/dist/content-layer/markdown/constants/tag-sets.js +1 -1
  105. package/dist/content-layer/markdown/nodes/heading.js +1 -1
  106. package/dist/content-layer/markdown/resolve/audience-tag.d.ts +1 -1
  107. package/dist/content-layer/markdown/resolve/audience-tag.js +1 -1
  108. package/dist/content-layer/markdown/resolve/markdoc-resolvers/json-schema.js +1 -1
  109. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.d.ts +1 -1
  110. package/dist/content-layer/markdown/resolve/markdoc-resolvers/operation-samples.js +1 -1
  111. package/dist/content-layer/markdown/resolve/markdoc-resolvers/partial.js +1 -1
  112. package/dist/content-layer/markdown/resolve/markdoc.js +1 -1
  113. package/dist/content-layer/markdown/resolve/references.js +1 -1
  114. package/dist/content-layer/markdown/search/to-markdown.js +1 -1
  115. package/dist/content-layer/markdown/search/to-sections.js +1 -1
  116. package/dist/content-layer/markdown/server/render.js +1 -1
  117. package/dist/content-layer/markdown/service.js +1 -1
  118. package/dist/content-layer/markdown/tags/html.d.ts +4 -1
  119. package/dist/content-layer/markdown/tags/html.js +1 -1
  120. package/dist/content-layer/markdown/tags/variant.js +1 -1
  121. package/dist/content-layer/markdown/types/service.d.ts +2 -0
  122. package/dist/content-layer/markdown/utils/parse-cache.js +1 -1
  123. package/dist/content-layer/materialization/entity.js +1 -1
  124. package/dist/content-layer/materialization/materializer.js +1 -0
  125. package/dist/content-layer/plan-gates.d.ts +3 -2
  126. package/dist/content-layer/plan-gates.js +1 -1
  127. package/dist/content-layer/plugins/index.js +1 -1
  128. package/dist/content-layer/plugins/internal/api-docs/client/template.js +4 -4
  129. package/dist/content-layer/plugins/internal/api-docs/index.js +1 -1
  130. package/dist/content-layer/plugins/internal/api-docs/server/build-definition.d.ts +2 -2
  131. package/dist/content-layer/plugins/internal/api-docs/server/build-definition.js +1 -1
  132. package/dist/content-layer/plugins/internal/api-docs/server/build-sidebar.js +1 -1
  133. package/dist/content-layer/plugins/internal/api-docs/server/markdown-docs.js +13 -13
  134. package/dist/content-layer/plugins/internal/api-docs/server/options.d.ts +4 -2
  135. package/dist/content-layer/plugins/internal/api-docs/server/options.js +1 -1
  136. package/dist/content-layer/plugins/internal/api-docs/server/search-documents.js +1 -1
  137. package/dist/content-layer/plugins/internal/api-docs/server/spec-download.js +1 -1
  138. package/dist/content-layer/plugins/internal/api-functions/index.js +1 -1
  139. package/dist/content-layer/plugins/internal/api-functions/server/access.js +1 -1
  140. package/dist/content-layer/plugins/internal/app-data/banner.js +1 -1
  141. package/dist/content-layer/plugins/internal/app-data/index.js +1 -1
  142. package/dist/content-layer/plugins/internal/app-data/products.d.ts +2 -0
  143. package/dist/content-layer/plugins/internal/app-data/products.js +1 -1
  144. package/dist/content-layer/plugins/internal/catalog-classic/client/use-catalog-classic.js +1 -1
  145. package/dist/content-layer/plugins/internal/catalog-classic/index.js +1 -1
  146. package/dist/content-layer/plugins/internal/index.js +1 -1
  147. package/dist/content-layer/plugins/internal/l10n/index.js +1 -1
  148. package/dist/content-layer/plugins/internal/markdoc/client/template.js +1 -1
  149. package/dist/content-layer/plugins/internal/markdoc/index.js +1 -1
  150. package/dist/content-layer/plugins/internal/markdoc/server/shared.d.ts +1 -1
  151. package/dist/content-layer/plugins/internal/mcp/content-tools.js +1 -1
  152. package/dist/content-layer/plugins/internal/mcp/ignored-routes.js +1 -1
  153. package/dist/content-layer/plugins/internal/mcp/index.js +1 -1
  154. package/dist/content-layer/plugins/internal/mcp/server/agent-card.js +1 -1
  155. package/dist/content-layer/plugins/internal/mcp/server/config-gate.js +1 -1
  156. package/dist/content-layer/plugins/internal/mcp/server/custom-tools.js +1 -1
  157. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials-page/site-branding.js +1 -1
  158. package/dist/content-layer/plugins/internal/mcp/server/gateway/credentials.js +1 -1
  159. package/dist/content-layer/plugins/internal/mcp/server/gateway/elicitation.js +6 -6
  160. package/dist/content-layer/plugins/internal/mcp/server/gateway/fetch/fetch-bridge.js +1 -1
  161. package/dist/content-layer/plugins/internal/mcp/server/gateway/index.js +2 -2
  162. package/dist/content-layer/plugins/internal/mcp/server/gateway/secret-store.js +1 -1
  163. package/dist/content-layer/plugins/internal/mcp/server/gateway/tools.js +3 -3
  164. package/dist/content-layer/plugins/internal/mcp/server/handler.js +1 -1
  165. package/dist/content-layer/plugins/internal/mcp/server/oauth/authorize.js +1 -1
  166. package/dist/content-layer/plugins/internal/mcp/server/server-info.js +1 -1
  167. package/dist/content-layer/plugins/internal/mcp/server/skills-resources.js +1 -1
  168. package/dist/content-layer/plugins/internal/mcp/server/tools/graphql-catalog.js +1 -1
  169. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-catalog.js +1 -1
  170. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-document.js +1 -1
  171. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi-refs.js +1 -1
  172. package/dist/content-layer/plugins/internal/mcp/server/tools/openapi.js +1 -1
  173. package/dist/content-layer/plugins/internal/mcp/server/tools/pages-navigation.js +1 -1
  174. package/dist/content-layer/plugins/internal/mcp/server/tools/search.js +2 -2
  175. package/dist/content-layer/plugins/internal/mock/server/handler.js +1 -1
  176. package/dist/content-layer/plugins/internal/react-page/index.js +1 -1
  177. package/dist/content-layer/plugins/internal/scorecard-classic/client/Grid.js +11 -11
  178. package/dist/content-layer/plugins/internal/scorecard-classic/client/ScorecardViews.js +1 -1
  179. package/dist/content-layer/plugins/internal/scorecard-classic/client/ScorecardWidgets.js +7 -7
  180. package/dist/content-layer/plugins/internal/scorecard-classic/client/template.js +2 -2
  181. package/dist/content-layer/plugins/internal/scorecard-classic/index.js +1 -1
  182. package/dist/content-layer/plugins/internal/sidebar/bundle.d.ts +1 -1
  183. package/dist/content-layer/plugins/internal/sidebar/bundle.js +1 -1
  184. package/dist/content-layer/plugins/internal/sidebar/index.d.ts +1 -1
  185. package/dist/content-layer/plugins/internal/sidebar/index.js +2 -2
  186. package/dist/content-layer/plugins/internal/skills/index.js +1 -1
  187. package/dist/content-layer/plugins/internal/skills/server/routes.js +1 -1
  188. package/dist/content-layer/plugins/project/load.js +2 -2
  189. package/dist/content-layer/plugins/registry.js +1 -1
  190. package/dist/content-layer/plugins/request-context.d.ts +5 -0
  191. package/dist/content-layer/plugins/types/api-entity.d.ts +2 -6
  192. package/dist/content-layer/plugins/types/api-entity.js +1 -1
  193. package/dist/content-layer/plugins/types/plugin.d.ts +8 -0
  194. package/dist/content-layer/plugins/types/search.d.ts +1 -1
  195. package/dist/content-layer/plugins/utils/link-access.js +1 -1
  196. package/dist/content-layer/plugins/utils/route-index.d.ts +1 -1
  197. package/dist/content-layer/plugins/utils/route-index.js +1 -1
  198. package/dist/content-layer/plugins/utils/version-path.js +1 -1
  199. package/dist/content-layer/revisions/config.js +1 -1
  200. package/dist/content-layer/server/context.js +1 -1
  201. package/dist/content-layer/server/materialize.js +1 -1
  202. package/dist/content-layer/static/audience.js +1 -1
  203. package/dist/content-layer/static/registry.js +1 -1
  204. package/dist/content-layer/versions/redirect.d.ts +11 -6
  205. package/dist/content-layer/versions/redirect.js +1 -1
  206. package/dist/content-layer/versions/resolve.js +1 -1
  207. package/dist/plugin-api.d.ts +3 -0
  208. package/dist/plugin-api.js +1 -1
  209. package/dist/server/app.js +3 -3
  210. package/dist/server/ask-ai/feature-gate.js +1 -1
  211. package/dist/server/ask-ai/route.js +1 -1
  212. package/dist/server/auth/gate.js +1 -1
  213. package/dist/server/auth/middleware.js +1 -1
  214. package/dist/server/auth/request.js +1 -1
  215. package/dist/server/auth/routes.js +1 -1
  216. package/dist/server/auth/runtime.js +1 -1
  217. package/dist/server/content-assets/access.js +1 -1
  218. package/dist/server/content.js +13 -13
  219. package/dist/server/cors-proxy/handler.js +1 -1
  220. package/dist/server/feedback/route.js +1 -1
  221. package/dist/server/lambda-entry.js +1 -1
  222. package/dist/server/manifest-assets.js +4 -4
  223. package/dist/server/metrics/request-metrics.js +1 -1
  224. package/dist/server/node-entry.js +1 -1
  225. package/dist/server/page-handlers.js +1 -1
  226. package/dist/server/plugin-context.js +1 -1
  227. package/dist/server/plugin-routes.js +1 -1
  228. package/dist/server/rbac/content-asset-access.js +1 -1
  229. package/dist/server/redirects.js +1 -1
  230. package/dist/server/replay-oauth2/route.js +1 -1
  231. package/dist/server/review/route.js +1 -1
  232. package/dist/server/runtime-config.js +1 -1
  233. package/dist/server/search/route.js +1 -1
  234. package/dist/server/seo-tags.js +2 -2
  235. package/dist/server/sitemap.js +1 -1
  236. package/dist/server/static-files/serve.js +1 -1
  237. package/dist/server/subprocess/runner.js +1 -1
  238. package/dist/server/telemetry/mock-server-events.js +1 -0
  239. package/dist/server/telemetry/redirect-event.js +1 -0
  240. package/dist/server/telemetry/route.js +1 -1
  241. package/dist/server/telemetry/sender.js +1 -1
  242. package/dist/server/template-ids.js +1 -1
  243. package/dist/shared/constants/api-spec-kinds.d.ts +6 -0
  244. package/dist/shared/constants/api-spec-kinds.js +1 -0
  245. package/dist/shared/constants/content-update.js +1 -1
  246. package/dist/shared/constants/dev-content-build.js +1 -0
  247. package/dist/shared/constants/dev-problems.js +1 -1
  248. package/dist/shared/constants/dev-source-sync.js +1 -1
  249. package/dist/shared/constants/l10n/langs/ar.js +1 -1
  250. package/dist/shared/constants/l10n/langs/de.js +1 -1
  251. package/dist/shared/constants/l10n/langs/en.js +1 -1
  252. package/dist/shared/constants/l10n/langs/es.js +1 -1
  253. package/dist/shared/constants/l10n/langs/fr.js +1 -1
  254. package/dist/shared/constants/l10n/langs/hi.js +1 -1
  255. package/dist/shared/constants/l10n/langs/it.js +1 -1
  256. package/dist/shared/constants/l10n/langs/ja.js +1 -1
  257. package/dist/shared/constants/l10n/langs/ko.js +1 -1
  258. package/dist/shared/constants/l10n/langs/pl.js +1 -1
  259. package/dist/shared/constants/l10n/langs/pt-br.js +1 -1
  260. package/dist/shared/constants/l10n/langs/pt.js +1 -1
  261. package/dist/shared/constants/l10n/langs/ru.js +1 -1
  262. package/dist/shared/constants/l10n/langs/uk.js +1 -1
  263. package/dist/shared/constants/l10n/langs/zh.js +1 -1
  264. package/dist/{server → shared}/constants/system-routes.d.ts +1 -1
  265. package/dist/shared/constants/system-routes.js +1 -0
  266. package/dist/shared/plan-gates.d.ts +6 -1
  267. package/dist/shared/plan-gates.js +1 -1
  268. package/dist/shared/products.js +1 -1
  269. package/dist/{server → shared}/project-env.d.ts +1 -1
  270. package/dist/{server → shared}/rbac/api-docs.d.ts +1 -1
  271. package/dist/{server → shared}/rbac/engine.d.ts +1 -1
  272. package/dist/shared/rbac/engine.js +0 -0
  273. package/dist/shared/rbac/filter.js +1 -0
  274. package/dist/{server → shared}/rbac/l10n-rules.d.ts +1 -1
  275. package/dist/shared/rbac/l10n-rules.js +1 -0
  276. package/dist/shared/rbac/route-scope.js +1 -0
  277. package/dist/{server → shared}/rbac/team-templates.d.ts +6 -2
  278. package/dist/shared/rbac/team-templates.js +1 -0
  279. package/dist/{server → shared}/rbac/teams.d.ts +1 -1
  280. package/dist/shared/rbac/types.js +1 -0
  281. package/dist/shared/types/config.d.ts +2 -0
  282. package/dist/shared/types/search.d.ts +7 -2
  283. package/dist/shared/utils/routes/file-path-to-route-slug.js +1 -1
  284. package/package.json +28 -8
  285. package/dist/bundler/dev/__tests__/reset-content-update-state.js +0 -1
  286. package/dist/bundler/dev/materialization-sweeper.js +0 -1
  287. package/dist/client/dev-problems/sweep-segment.js +0 -1
  288. package/dist/content-layer/plugins/internal/mcp/server/gateway/__tests__/fake-kv.js +0 -1
  289. package/dist/content-layer/server/config.js +0 -1
  290. package/dist/server/__tests__/rbac-fixture.js +0 -1
  291. package/dist/server/__tests__/test-session.js +0 -1
  292. package/dist/server/constants/system-routes.js +0 -1
  293. package/dist/server/rbac/engine.js +0 -0
  294. package/dist/server/rbac/filter.js +0 -1
  295. package/dist/server/rbac/l10n-rules.js +0 -1
  296. package/dist/server/rbac/route-scope.js +0 -1
  297. package/dist/server/rbac/team-templates.js +0 -1
  298. package/dist/server/rbac/types.js +0 -1
  299. /package/dist/{server → shared}/project-env.js +0 -0
  300. /package/dist/{server → shared}/rbac/api-docs.js +0 -0
  301. /package/dist/{server → shared}/rbac/entity-scope.js +0 -0
  302. /package/dist/{server → shared}/rbac/filter.d.ts +0 -0
  303. /package/dist/{server → shared}/rbac/route-scope.d.ts +0 -0
  304. /package/dist/{server → shared}/rbac/teams.js +0 -0
  305. /package/dist/{server → shared}/rbac/types.d.ts +0 -0
  306. /package/dist/{content-layer/markdown → shared}/utils/packed-ast.d.ts +0 -0
  307. /package/dist/{content-layer/markdown → shared}/utils/packed-ast.js +0 -0
@@ -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{isObject as e}from"../shared/utils/is-object.js";import{getPathPrefix as t,withPathPrefix as n,withPathPrefixForSrcSet as r}from"../shared/path-prefix.js";function i(a){return t()===``||!Array.isArray(a)?a:a.map(t=>{if(!e(t))return t;let a={...t};return typeof t.icon==`string`&&(a.icon=n(t.icon)),typeof t.srcSet==`string`&&(a.srcSet=r(t.srcSet)),Array.isArray(t.items)&&(a.items=i(t.items)),a})}function a(i){let{logo:a}=i;if(t()===``||!e(a))return i;let o={...a};return typeof a.image==`string`&&(o.image=n(a.image)),typeof a.favicon==`string`&&(o.favicon=n(a.favicon)),typeof a.srcSet==`string`&&(o.srcSet=r(a.srcSet)),{...i,logo:o}}export{i as prefixNavbarIconUrls,a as prefixThemeLogoUrls};
1
+ import{getPathPrefix as e,withPathPrefix as t,withPathPrefixForSrcSet as n}from"../shared/path-prefix.js";import{isObject as r}from"../shared/utils/is-object.js";function i(a){return e()===``||!Array.isArray(a)?a:a.map(e=>{if(!r(e))return e;let a={...e};return typeof e.icon==`string`&&(a.icon=t(e.icon)),typeof e.srcSet==`string`&&(a.srcSet=n(e.srcSet)),Array.isArray(e.items)&&(a.items=i(e.items)),a})}function a(i){let{logo:a}=i;if(e()===``||!r(a))return i;let o={...a};return typeof a.image==`string`&&(o.image=t(a.image)),typeof a.favicon==`string`&&(o.favicon=t(a.favicon)),typeof a.srcSet==`string`&&(o.srcSet=n(a.srcSet)),{...i,logo:o}}export{i as prefixNavbarIconUrls,a as prefixThemeLogoUrls};
@@ -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};
@@ -1 +1 @@
1
- import{REVISIONS_ROUTE_DEP_KEY as e}from"../shared/constants/revisions.js";import{LoaderDataContext as t}from"./contexts.js";import{useContext as n}from"react";const r={entityKey:null,items:[]};function i(t){let n=t[e];return!n||!Array.isArray(n.items)?r:{entityKey:typeof n.entityKey==`string`?n.entityKey:null,items:n.items}}function a(e){let{entityKey:t,items:n}=i(e);return!!t&&n.length>0}function o(e){let{items:r}=i(n(t));return{query:{data:void 0,isLoading:!1,isError:!1},items:r}}export{a as hasEntityRevisions,i as selectEntityRevisions,o as useFetchCatalogEntityRevisions};
1
+ import{LoaderDataContext as e}from"./contexts.js";import{REVISIONS_ROUTE_DEP_KEY as t}from"../shared/constants/revisions.js";import{useContext as n}from"react";const r={entityKey:null,items:[]};function i(e){let n=e[t];return!n||!Array.isArray(n.items)?r:{entityKey:typeof n.entityKey==`string`?n.entityKey:null,items:n.items}}function a(e){let{entityKey:t,items:n}=i(e);return!!t&&n.length>0}function o(t){let{items:r}=i(n(e));return{query:{data:void 0,isLoading:!1,isError:!1},items:r}}export{a as hasEntityRevisions,i as selectEntityRevisions,o as useFetchCatalogEntityRevisions};
@@ -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{PageContext as e,SidebarDataContext as t}from"./contexts.js";import{compareVersions as n,toPhysicalVersionedSlug as r,toPublicVersionedSlug as i,versionRoutePrefix as a}from"../shared/constants/versions.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(e,t){let{name:o,group:s}=l(t);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(e??[]),u.size===0)return c;let f=t?.slug??``,p=r(f,s,o),m=p===null?null:p.slice(a(s,o).length),h=(e,t)=>{if(m===null)return t.firstLink;let n=i(`${a(s,e)}${m}`,s,e,t.isDefault);return t.links.has(n)?n:t.firstLink};return[...u.entries()].sort(([e],[t])=>n(t,e)).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 n=o(t),r=o(e);return{versions:s(()=>u(n.allItems??n.items,r),[n,r])}}export{l as selectActiveVersion,u as selectPageVersions,d as usePageVersionsImpl};
@@ -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{withPathPrefix as n}from"../shared/path-prefix.js";import{APP_DATA_LOADER_KEY as r}from"../shared/constants/app-data.js";import{readAppData as i}from"../shared/utils/app-data.js";import{LoaderDataContext as a,PageContext as o}from"./contexts.js";import{useL10nConfig as s}from"./l10n/use-l10n-config.js";import{telemetry as c}from"./telemetry/telemetry.js";import{selectActiveVersion as l}from"./use-page-versions.js";import{SEARCH_FACETS_ROUTE_PATH as u,SEARCH_ROUTE_PATH as d}from"../shared/constants/search.js";import{useCallback as f,useContext as p,useEffect as m,useMemo as h,useRef as g,useState as _}from"react";import{getBaseDataAttributes as v}from"@redocly/theme/core/utils";import{SEARCH_DEBOUNCE_TIME_MS as ee}from"@redocly/theme/core/constants";import{SearchSessionContext as y}from"@redocly/theme/core/contexts";async function b(e,t,r){let i=await fetch(n(e),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(t),signal:r});if(!i.ok)throw Error(i.statusText||`Search request failed (${i.status})`);return await i.json()}function x(e,t){return b(d,e,t)}function S(e){return Object.fromEntries(e.map(e=>[e.field,e.values]))}function C(e,t){return b(u,e,t)}function w(e){return i(e).theme?.aiAssistant?.hide===!1}function T(){let e=p(a),t=p(o);return{askAi:w(e)&&t?.aiAvailable===!0}}function E(e){return e.filter(e=>e.values.length>0).map(({field:e,values:t})=>({field:e,values:[...t]}))}function D(){let e=p(o),{currentLocale:t,defaultLocale:n}=s(),r=t===n?void 0:t,{name:i,group:a}=l(e);return h(()=>({locale:r,version:a!==void 0&&i!==void 0?{group:a,version:i}:void 0}),[r,a,i])}function te(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 O=(e,t)=>e.map(e=>({...e,isCounterVisible:t}));function k(n,i){let o=i===!1,{askAi:s}=T(),l=p(a),u=p(y)?.searchSessionId,d=D(),b=h(()=>t(l[r]),[l]),[w,k]=_(``),[A,ne]=_([]),[re,j]=_({}),[M,N]=_({}),[P,F]=_({}),[I,L]=_({}),[R,z]=_(!1),[B,V]=_(null),[H,U]=_(),[W,G]=_(!1),K=g(null),q=g(null),J=g(!1),Y=h(()=>E(A),[A]),X=Y.length>0,Z=f(()=>{q.current=null,j({}),N({}),L({})},[]),Q=f((e,t,n)=>{K.current?.abort();let r=new AbortController;return K.current=r,z(!0),V(null),x(e,r.signal).then(e=>{r.signal.aborted||t(e)}).catch(e=>{r.signal.aborted||(V(e instanceof Error?e.message:`Search request failed`),n())}).finally(()=>{r.signal.aborted||z(!1)})},[]),$=f(async e=>{let t=e.trim();if(t===``&&!X){K.current?.abort(),J.current=!1,Z(),G(!1),V(null),z(!1);return}let r={query:t,...d,filter:Y,product:n};J.current=!0,await Q(r,i=>{J.current=!1,q.current=r,j(i.documents),N(i.facets??{}),L(i.groupCounts??{}),U(i.partial),G(!0),t.length>1&&c.sendSearchQueryMessage([{...v(`searchQuery`,`search`),query:e,resultCount:Object.values(i.documents).reduce((e,t)=>e+t.length,0).toString(),...u?{searchSessionId:u}:{},...n?{product:n}:{}}])},()=>{J.current=!1,Z()})},[d,Y,X,Q,Z,n,u]),ie=f(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]??[];j(e=>({...e,[t.groupKey]:[...e[t.groupKey]??[],...n]})),L(t=>({...t,...e.groupCounts}))},()=>{})},[Q]);m(()=>{if(i)return;(w.trim()!==``||X)&&z(!0);let e=setTimeout(()=>{$(w)},ee);return()=>clearTimeout(e)},[w,i,X,$]),m(()=>{if(!b.advanced||!o)return;let e=new AbortController;return C({...d,product:n},e.signal).then(e=>F(S(e))).catch(()=>{e.signal.aborted||F({})}),()=>e.abort()},[b.advanced,o,d,n]),m(()=>()=>K.current?.abort(),[]);let ae=f(async()=>{await $(w)},[w,$]),oe=h(()=>b.facets.map(e=>({...e,values:W?O(M[e.field]??[],!0):O(P[e.field]??[],!1)})),[b.facets,W,M,P]);return{advancedSearch:b.advanced,askAi:s,facets:oe,filter:A,groupCounts:I,groupField:e,isSearchLoading:R,items:re,query:w,searchError:B,setFilter:ne,setLoadMore:ie,setQuery:k,retrySearch:ae,notice:te(H)}}function A(e){let n=D(),i=p(a),o=h(()=>t(i[r]).facets.find(t=>t.field===e),[i,e]),[s,c]=_(null),[l,u]=_(null);return m(()=>{if(l===null){c(null);return}let t=new AbortController;return C({...n,field:e,query:l.query,filter:E(l.filter),facetQuery:l.facetQuery},t.signal).then(t=>{c(o?{...o,values:O(S(t)[e]??[],!0)}:null)}).catch(()=>{t.signal.aborted||c(null)}),()=>t.abort()},[e,n,l,o]),{searchFacet:s,setSearchFacet:c,setSearchFacetQuery:u}}export{x as fetchSearch,C as fetchSearchFacets,A as useFacetQuery,k as useSearch,T as useSearchFeatures,D as useSearchScope};
@@ -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{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
+ import{stripPathPrefix as e}from"../../../shared/path-prefix.js";import{normalizeRouteSlug as t}from"../../../shared/utils/routes/normalize-route-slug.js";import{markdownCopyUrl as n}from"../../../shared/utils/routes/markdown-copy-url.js";import{splitUrlSuffix as r}from"../../../shared/utils/routes/split-url-suffix.js";function i(i){let{path:a}=r(i);return n(t(e(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{isObject as e}from"../../../shared/utils/is-object.js";import{FEEDBACK_ROUTE_PATH as t}from"../../../shared/constants/feedback.js";import{SEARCH_ROUTE_PATH as n}from"../../../shared/constants/search.js";import{SKILLS_INDEX_SLUG as r}from"../../../content-layer/plugins/utils/skill-paths.js";import{clampLimit as i,fetchText as a,markdownPathForRoute as o,toSitePath as s}from"./shared.js";import{agentErrorResult as c,agentJsonResult as l,agentTextResult as u,collectOperations as d}from"@redocly/api-docs/lib/services/agent-tools/index.js";function f(e){return[...e.feedbackHidden?[]:[y(e)],{name:`get_current_page`,title:`Get current page`,description:`Report which documentation page the user is looking at right now, including the product and version in scope and whether it is an API reference page. Call this first so an answer matches what is on screen.`,inputSchema:{type:`object`,properties:{},additionalProperties:!1},annotations:{readOnlyHint:!0},execute:async()=>p(e)},{name:`search_docs`,title:`Search documentation`,description:`Search this documentation site and return matching pages with their titles and URLs. Use it to find the page that answers a question before reading it.`,inputSchema:{type:`object`,properties:{query:{type:`string`,description:`What to search for`},limit:{type:`integer`,description:`Maximum number of results, 10 by default`}},required:[`query`],additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async t=>m(e,t)},{name:`read_page`,title:`Read a page`,description:`Return the full Markdown source of a documentation page. Omit the url to read the page the user is currently on.`,inputSchema:{type:`object`,properties:{url:{type:`string`,description:`Site-relative page path, for example /guides/quickstart`}},additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async t=>h(e,t)},{name:`get_site_overview`,title:`Get site overview`,description:`Return the outline of this documentation site: its sections and the pages inside them, limited to what the current user may see. Use it to orient before searching.`,inputSchema:{type:`object`,properties:{},additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async()=>g(e)},{name:`read_skill`,title:`Read an agent skill`,description:`List the agent skills this site publishes, or read one by name. A skill explains how to carry out a task against the documented product.`,inputSchema:{type:`object`,properties:{name:{type:`string`,description:`Skill name; omit to list every skill`}},additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async t=>v(e,t)},{name:`navigate_page`,title:`Open a page`,description:`Move the browser tab to another page of this documentation site, so the user sees what an answer is based on. Accepts site-relative paths only.`,inputSchema:{type:`object`,properties:{url:{type:`string`,description:`Site-relative page path, optionally with a #section anchor`}},required:[`url`],additionalProperties:!1},annotations:{readOnlyHint:!1},execute:async t=>x(e,t)}]}async function p(e){let t=e.versions.find(e=>e.active);return l({url:e.pathname,title:e.pageTitle??document.title,locale:e.locale,product:e.product,version:t?.label??t?.version,isApiReference:!!e.apiDocs,...e.apiDocs?{apiBasePath:e.withPrefix(e.apiDocs.baseSlug),apiSpecType:e.apiDocs.store.specType,operationCount:d(e.apiDocs.items).length}:{}})}async function m(e,t){let r=typeof t.query==`string`?t.query.trim():``;if(!r)return c(`Provide a query to search for.`);let a=i(t.limit,10,50),o={query:r,...e.searchScope},s=await fetch(e.sitePathUrl(n),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(o)});if(!s.ok)return c(`Search failed with status ${s.status}.`);let{documents:d}=await s.json(),f=Object.entries(d).flatMap(([e,t])=>t.map(({document:t})=>({section:e,document:t}))).slice(0,a).map(({section:t,document:n})=>({title:n.title,url:e.withPrefix(n.url),section:t,method:n.httpMethod?.toUpperCase(),path:n.httpMethod?n.httpPath:void 0,deprecated:n.deprecated?!0:void 0,snippet:n.text.slice(0,300)}));return f.length?l({query:r,resultCount:f.length,results:f}):u(`No documentation pages matched "${r}".`)}async function h(e,t){let n=typeof t.url==`string`&&t.url.trim()?t.url.trim():e.pathname,r=s(n);if(!r)return c(`Provide a site-relative path that starts with "/".`);let i=await a(e.routeUrl(o(r)));return i?u(i):c(`${r} has no Markdown version. Either the path is wrong, or the page is built from code rather than Markdown. Use search_docs to find a documentation page.`)}async function g(e){let t=_(e.sidebarItems,e.withPrefix,0);if(t.length)return l({product:e.product,pages:t});let n=await a(e.sitePathUrl(`/llms.txt`));return n?u(n):c(`This site publishes no navigation tree.`)}function _(t,n,r){if(r>=3)return[];let i=[];for(let a of t){if(!e(a))continue;let t=typeof a.label==`string`?a.label:``,o=typeof a.link==`string`?a.link:void 0;if(!t&&!o)continue;let s=Array.isArray(a.items)?_(a.items,n,r+1):[];i.push({title:t,...o?{url:n(o)}:{},...s.length?{pages:s}:{}})}return i}async function v(t,n){let i=await fetch(t.sitePathUrl(r),{headers:{accept:`application/json`}});if(!i.ok)return c(`This site does not publish agent skills.`);let o=await i.json(),s=e(o)&&Array.isArray(o.skills)?o.skills:[],d=typeof n.name==`string`?n.name.trim():``;if(!d)return l({skills:s.map(e=>({name:e.name,description:e.description}))});let f=s.find(e=>e.name.toLowerCase()===d.toLowerCase());if(!f){let e=s.map(e=>e.name).join(`, `);return c(`No skill named "${d}". Available skills: ${e||`none`}.`)}let p=await a(t.routeUrl(f.url));return p?u(p):c(`The "${f.name}" skill could not be read.`)}function y(e){return{name:`leave_feedback`,title:`Leave feedback on a page`,description:`Report that a documentation page is wrong, outdated, confusing or incomplete. Use it only when the user agrees, and summarize the problem in their words. Reports reach the team that owns the page.`,inputSchema:{type:`object`,properties:{summary:{type:`string`,description:`One sentence naming the problem`},details:{type:`string`,description:`What is wrong and what the page should say`},url:{type:`string`,description:`Site-relative path of the page; the current page by default`}},required:[`summary`],additionalProperties:!1},annotations:{readOnlyHint:!1,consequentialHint:!0},execute:async t=>b(e,t)}}async function b(e,n){let r=typeof n.summary==`string`?n.summary.trim():``;if(!r)return c(`Describe the problem in one sentence.`);let i=typeof n.details==`string`?n.details.trim():``,a=typeof n.url==`string`&&n.url.trim()?n.url.trim():e.pathname,o=s(a);if(!o)return c(`Provide a site-relative path that starts with "/".`);let l=await fetch(e.sitePathUrl(t),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify({component:`comment`,path:e.routeUrl(o),comment:i?`${r}\n\n${i}`:r,agent:`webmcp-browser-agent`,origin:`mcp`})});return l.ok?u(`Thanks. The feedback about ${o} reached the documentation team.`):c(l.status===403||l.status===404?`Feedback cannot be left for ${o}.`:`Feedback could not be sent, status ${l.status}.`)}async function x(e,t){let n=typeof t.url==`string`?s(t.url):void 0;return n?(await e.navigate(n),u(`Opened ${n}.`)):c(`Provide a site-relative path that starts with "/". This tool cannot leave the documentation site.`)}export{f as buildSiteTools};
1
+ import{isObject as e}from"../../../shared/utils/is-object.js";import{FEEDBACK_ROUTE_PATH as t}from"../../../shared/constants/feedback.js";import{SEARCH_ROUTE_PATH as n}from"../../../shared/constants/search.js";import{clampLimit as r,fetchText as i,markdownPathForRoute as a,toSitePath as o}from"./shared.js";import{SKILLS_INDEX_SLUG as s}from"../../../content-layer/plugins/utils/skill-paths.js";import{agentErrorResult as c,agentJsonResult as l,agentTextResult as u,collectOperations as d}from"@redocly/api-docs/lib/services/agent-tools/index.js";function f(e){return[...e.feedbackHidden?[]:[y(e)],{name:`get_current_page`,title:`Get current page`,description:`Report which documentation page the user is looking at right now, including the product and version in scope and whether it is an API reference page. Call this first so an answer matches what is on screen.`,inputSchema:{type:`object`,properties:{},additionalProperties:!1},annotations:{readOnlyHint:!0},execute:async()=>p(e)},{name:`search_docs`,title:`Search documentation`,description:`Search this documentation site and return matching pages with their titles and URLs. Use it to find the page that answers a question before reading it.`,inputSchema:{type:`object`,properties:{query:{type:`string`,description:`What to search for`},limit:{type:`integer`,description:`Maximum number of results, 10 by default`}},required:[`query`],additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async t=>m(e,t)},{name:`read_page`,title:`Read a page`,description:`Return the full Markdown source of a documentation page. Omit the url to read the page the user is currently on.`,inputSchema:{type:`object`,properties:{url:{type:`string`,description:`Site-relative page path, for example /guides/quickstart`}},additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async t=>h(e,t)},{name:`get_site_overview`,title:`Get site overview`,description:`Return the outline of this documentation site: its sections and the pages inside them, limited to what the current user may see. Use it to orient before searching.`,inputSchema:{type:`object`,properties:{},additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async()=>g(e)},{name:`read_skill`,title:`Read an agent skill`,description:`List the agent skills this site publishes, or read one by name. A skill explains how to carry out a task against the documented product.`,inputSchema:{type:`object`,properties:{name:{type:`string`,description:`Skill name; omit to list every skill`}},additionalProperties:!1},annotations:{readOnlyHint:!0,untrustedContentHint:!0},execute:async t=>v(e,t)},{name:`navigate_page`,title:`Open a page`,description:`Move the browser tab to another page of this documentation site, so the user sees what an answer is based on. Accepts site-relative paths only.`,inputSchema:{type:`object`,properties:{url:{type:`string`,description:`Site-relative page path, optionally with a #section anchor`}},required:[`url`],additionalProperties:!1},annotations:{readOnlyHint:!1},execute:async t=>x(e,t)}]}async function p(e){let t=e.versions.find(e=>e.active);return l({url:e.pathname,title:e.pageTitle??document.title,locale:e.locale,product:e.product,version:t?.label??t?.version,isApiReference:!!e.apiDocs,...e.apiDocs?{apiBasePath:e.withPrefix(e.apiDocs.baseSlug),apiSpecType:e.apiDocs.store.specType,operationCount:d(e.apiDocs.items).length}:{}})}async function m(e,t){let i=typeof t.query==`string`?t.query.trim():``;if(!i)return c(`Provide a query to search for.`);let a=r(t.limit,10,50),o={query:i,...e.searchScope},s=await fetch(e.sitePathUrl(n),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify(o)});if(!s.ok)return c(`Search failed with status ${s.status}.`);let{documents:d}=await s.json(),f=Object.entries(d).flatMap(([e,t])=>t.map(({document:t})=>({section:e,document:t}))).slice(0,a).map(({section:t,document:n})=>({title:n.title,url:e.withPrefix(n.url),section:t,method:n.httpMethod?.toUpperCase(),path:n.httpMethod?n.httpPath:void 0,deprecated:n.deprecated?!0:void 0,snippet:n.text.slice(0,300)}));return f.length?l({query:i,resultCount:f.length,results:f}):u(`No documentation pages matched "${i}".`)}async function h(e,t){let n=typeof t.url==`string`&&t.url.trim()?t.url.trim():e.pathname,r=o(n);if(!r)return c(`Provide a site-relative path that starts with "/".`);let s=await i(e.routeUrl(a(r)));return s?u(s):c(`${r} has no Markdown version. Either the path is wrong, or the page is built from code rather than Markdown. Use search_docs to find a documentation page.`)}async function g(e){let t=_(e.sidebarItems,e.withPrefix,0);if(t.length)return l({product:e.product,pages:t});let n=await i(e.sitePathUrl(`/llms.txt`));return n?u(n):c(`This site publishes no navigation tree.`)}function _(t,n,r){if(r>=3)return[];let i=[];for(let a of t){if(!e(a))continue;let t=typeof a.label==`string`?a.label:``,o=typeof a.link==`string`?a.link:void 0;if(!t&&!o)continue;let s=Array.isArray(a.items)?_(a.items,n,r+1):[];i.push({title:t,...o?{url:n(o)}:{},...s.length?{pages:s}:{}})}return i}async function v(t,n){let r=await fetch(t.sitePathUrl(s),{headers:{accept:`application/json`}});if(!r.ok)return c(`This site does not publish agent skills.`);let a=await r.json(),o=e(a)&&Array.isArray(a.skills)?a.skills:[],d=typeof n.name==`string`?n.name.trim():``;if(!d)return l({skills:o.map(e=>({name:e.name,description:e.description}))});let f=o.find(e=>e.name.toLowerCase()===d.toLowerCase());if(!f){let e=o.map(e=>e.name).join(`, `);return c(`No skill named "${d}". Available skills: ${e||`none`}.`)}let p=await i(t.routeUrl(f.url));return p?u(p):c(`The "${f.name}" skill could not be read.`)}function y(e){return{name:`leave_feedback`,title:`Leave feedback on a page`,description:`Report that a documentation page is wrong, outdated, confusing or incomplete. Use it only when the user agrees, and summarize the problem in their words. Reports reach the team that owns the page.`,inputSchema:{type:`object`,properties:{summary:{type:`string`,description:`One sentence naming the problem`},details:{type:`string`,description:`What is wrong and what the page should say`},url:{type:`string`,description:`Site-relative path of the page; the current page by default`}},required:[`summary`],additionalProperties:!1},annotations:{readOnlyHint:!1,consequentialHint:!0},execute:async t=>b(e,t)}}async function b(e,n){let r=typeof n.summary==`string`?n.summary.trim():``;if(!r)return c(`Describe the problem in one sentence.`);let i=typeof n.details==`string`?n.details.trim():``,a=typeof n.url==`string`&&n.url.trim()?n.url.trim():e.pathname,s=o(a);if(!s)return c(`Provide a site-relative path that starts with "/".`);let l=await fetch(e.sitePathUrl(t),{method:`POST`,headers:{"content-type":`application/json`},body:JSON.stringify({component:`comment`,path:e.routeUrl(s),comment:i?`${r}\n\n${i}`:r,agent:`webmcp-browser-agent`,origin:`mcp`})});return l.ok?u(`Thanks. The feedback about ${s} reached the documentation team.`):c(l.status===403||l.status===404?`Feedback cannot be left for ${s}.`:`Feedback could not be sent, status ${l.status}.`)}async function x(e,t){let n=typeof t.url==`string`?o(t.url):void 0;return n?(await e.navigate(n),u(`Opened ${n}.`)):c(`Provide a site-relative path that starts with "/". This tool cannot leave the documentation site.`)}export{f as buildSiteTools};
@@ -1 +1 @@
1
- import{stripPathPrefix as e,withPathPrefix as t}from"../../shared/path-prefix.js";import{API_DOCS_RENDER_DEP_KEY as n}from"../../content-layer/plugins/internal/api-docs/server/shared.js";import{LoaderDataContext as r,PageContext as i,SidebarDataContext as a}from"../contexts.js";import{useL10nConfig as o}from"../l10n/use-l10n-config.js";import{useCurrentProduct as s}from"../ProductsProvider.js";import{telemetry as c}from"../telemetry/telemetry.js";import{usePageVersionsImpl as l}from"../use-page-versions.js";import{useSearchScope as u}from"../use-search.js";import{rebaseItemLinks as d}from"../../content-layer/plugins/internal/api-docs/client/rebase-item-links.js";import{buildApiTools as f}from"./tools/api-tools.js";import{buildSiteTools as p}from"./tools/site-tools.js";import{useContext as m,useEffect as h,useRef as g}from"react";import{useLocation as _,useNavigate as v}from"react-router";import{useThemeConfig as y}from"@redocly/theme/core/hooks";import{registerAgentTools as b}from"@redocly/api-docs/lib/services/agent-tools/index.js";import{getModelContext as x}from"@redocly/api-docs/lib/services/agent-tools/webmcp.js";function S(){let c=_(),d=v(),{currentLocale:S}=o(),w=u(),{versions:E}=l(),D=m(a).items,O=s(),k=m(i),A=m(r)[n],j=k?.slug.toLowerCase(),M=y().feedback?.hide===!0,N=k?.metadata?.seo,P={pathname:t(c.pathname),pageTitle:N?.title,locale:S,searchScope:w,product:O?.name??O?.slug,versions:E,sidebarItems:D??[],feedbackHidden:M,navigate:async t=>{let{pathname:n,search:r,hash:i}=new URL(t,window.location.origin);await d({pathname:e(n)??n,search:r,hash:i})},withPrefix:t,routeUrl:e=>new URL(e,window.location.origin).toString(),sitePathUrl:e=>new URL(t(e),window.location.origin).toString()},F=g(P);Object.assign(F.current,P),h(()=>{let e=new AbortController;return b(p(F.current),e.signal,T(`site`)),()=>e.abort()},[M]),h(()=>{if(!x())return;let e=F.current,t=C(A,j);if(e.apiDocs=t,!t)return;let n=new AbortController;return b(f(e,t),n.signal,T(`apiReference`)),()=>{n.abort(),e.apiDocs=void 0}},[A,j])}function C(e,t){if(Array.isArray(e?.items)&&t!==void 0)return{items:e.basePath===t?e.items:d(e.items,e.basePath,t),store:e.store,baseSlug:t}}const w={id:`agentTools`,object:`feature`,uri:`urn:redocly:realm:ui:feature:agentTools`};function T(e){return{registered:t=>c.sendAgentToolsRegisteredMessage([{...w,toolCount:t,scope:e}]),called:(e,t)=>c.sendAgentToolCalledMessage([{...w,toolName:e,outcome:t}])}}export{S as useWebMcpTools};
1
+ import{stripPathPrefix as e,withPathPrefix as t}from"../../shared/path-prefix.js";import{LoaderDataContext as n,PageContext as r,SidebarDataContext as i}from"../contexts.js";import{useL10nConfig as a}from"../l10n/use-l10n-config.js";import{useCurrentProduct as o}from"../ProductsProvider.js";import{telemetry as s}from"../telemetry/telemetry.js";import{API_DOCS_RENDER_DEP_KEY as c}from"../../content-layer/plugins/internal/api-docs/server/shared.js";import{usePageVersionsImpl as l}from"../use-page-versions.js";import{useSearchScope as u}from"../use-search.js";import{rebaseItemLinks as d}from"../../content-layer/plugins/internal/api-docs/client/rebase-item-links.js";import{buildApiTools as f}from"./tools/api-tools.js";import{buildSiteTools as p}from"./tools/site-tools.js";import{useContext as m,useEffect as h,useRef as g}from"react";import{useLocation as _,useNavigate as v}from"react-router";import{useThemeConfig as y}from"@redocly/theme/core/hooks";import{registerAgentTools as b}from"@redocly/api-docs/lib/services/agent-tools/index.js";import{getModelContext as x}from"@redocly/api-docs/lib/services/agent-tools/webmcp.js";function S(){let s=_(),d=v(),{currentLocale:S}=a(),w=u(),{versions:E}=l(),D=m(i).items,O=o(),k=m(r),A=m(n)[c],j=k?.slug.toLowerCase(),M=y().feedback?.hide===!0,N=k?.metadata?.seo,P={pathname:t(s.pathname),pageTitle:N?.title,locale:S,searchScope:w,product:O?.name??O?.slug,versions:E,sidebarItems:D??[],feedbackHidden:M,navigate:async t=>{let{pathname:n,search:r,hash:i}=new URL(t,window.location.origin);await d({pathname:e(n)??n,search:r,hash:i})},withPrefix:t,routeUrl:e=>new URL(e,window.location.origin).toString(),sitePathUrl:e=>new URL(t(e),window.location.origin).toString()},F=g(P);Object.assign(F.current,P),h(()=>{let e=new AbortController;return b(p(F.current),e.signal,T(`site`)),()=>e.abort()},[M]),h(()=>{if(!x())return;let e=F.current,t=C(A,j);if(e.apiDocs=t,!t)return;let n=new AbortController;return b(f(e,t),n.signal,T(`apiReference`)),()=>{n.abort(),e.apiDocs=void 0}},[A,j])}function C(e,t){if(Array.isArray(e?.items)&&t!==void 0)return{items:e.basePath===t?e.items:d(e.items,e.basePath,t),store:e.store,baseSlug:t}}const w={id:`agentTools`,object:`feature`,uri:`urn:redocly:realm:ui:feature:agentTools`};function T(e){return{registered:t=>s.sendAgentToolsRegisteredMessage([{...w,toolCount:t,scope:e}]),called:(e,t)=>s.sendAgentToolCalledMessage([{...w,toolName:e,outcome:t}])}}export{S as useWebMcpTools};
@@ -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};
@@ -26,7 +26,11 @@ export type ConfigSchema = boolean | {
26
26
  };
27
27
  not?: ConfigSchema;
28
28
  };
29
- /** 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;
30
34
  export declare const REALM_CONFIG_SCHEMA: ConfigSchema;
31
35
  /** A nested `redocly.yaml`: the product override sections, `apis`, and the API kind blocks. */
32
36
  export declare const NESTED_CONFIG_SCHEMA: ConfigSchema;
@@ -1 +1 @@
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`}},additionalProperties:!1}},additionalProperties:!1},h={...r,properties:{...i,apis:u,asyncapi:l,linkChecker:m,redirects:f,revisions:p,scripts:d},additionalProperties:!0},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}]`:/^[A-Za-z_$][\w$]*$/.test(t)?e===``?t:`${e}.${t}`:`${e}[${JSON.stringify(t)}]`}export{g as NESTED_CONFIG_SCHEMA,_ as PAGE_BANNER_SCHEMA,h as REALM_CONFIG_SCHEMA,y 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`}},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,7 +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
3
  import { type ProcessEnv } from '../shared/public-env.js';
4
4
  import type { NestedConfig, RealmConfig } from '../shared/types/config.js';
5
+ import { type ConfigSchema } from './config-schema.js';
5
6
  import type { ContentLayerContext } from './context.js';
6
7
  import type { ProblemDraft } from './problems/types.js';
7
8
  export type { RealmConfig } from '../shared/types/config.js';
@@ -37,8 +38,9 @@ type ConfigObject = Record<string, unknown>;
37
38
  * `REDOCLY_ENFORCE_LOGIN` and `REDOCLY_ENFORCE_RESIDENCY` enforce applied. `siteConfig`
38
39
  * keeps the `{{ process.env.X }}` references, judged by their values in the environment;
39
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.
40
42
  */
41
- 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>;
42
44
  /**
43
45
  * Whether the effective config differs from the one whose digest the last ingest stored;
44
46
  * `null` (no ingest yet, or a row an older ingest wrote) counts as changed. The effective config
@@ -79,12 +81,15 @@ export declare function deepMergeConfig(base: ConfigObject, override: ConfigObje
79
81
  * `access.rbac` `{folder}` rules are written per team directory,
80
82
  * `access.rbac.content` and `redirects` cover every content locale, `access.requiresLogin`
81
83
  * follows the rbac rules when `access.rbac` is set, and the `PUBLIC_*` environment is
82
- * 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.
83
87
  */
84
88
  export declare function normalizeRedoclyConfig(config: Record<string, unknown>, options?: {
85
89
  dirLocales?: readonly string[];
86
90
  teamDirs?: TeamDirs;
87
91
  env?: ProcessEnv;
92
+ pluginSchemas?: Readonly<Record<string, ConfigSchema>>;
88
93
  report?: (problem: ProblemDraft) => void;
89
94
  }): RealmConfig;
90
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{readProjectEnv as a}from"../server/project-env.js";import{listL10nDirs as o,resolveLocaleContext as s}from"../shared/utils/l10n.js";import{expandConfigRbacForL10n as c}from"../server/rbac/l10n-rules.js";import{expandConfigRbacTeamTemplates as l,listTeamDirs as u,teamTemplatePrefixes as d}from"../server/rbac/team-templates.js";import{getProcessEnv as f,getPublicEnv as p,resolveRedoclyEnvironment as m,sanitizeBranchName as h}from"../shared/public-env.js";import{resolveContentPath as g}from"../shared/utils/resolve-content-path.js";import{resolveConfigRedirects as _}from"./config-redirects.js";import{NESTED_CONFIG_SCHEMA as v,REALM_CONFIG_SCHEMA as y,sanitizeConfig as b}from"./config-schema.js";import{hashEffectiveConfig as x,resolveSiteConfig as S}from"./database/site-config.js";import{applyEnforcedAccess as C}from"./enforced-access.js";import{applyPlanGates as w}from"./plan-gates.js";import{resolve as T}from"node:path";import{interpolateEnvVariables as E}from"@redocly/config";import D from"js-yaml";const O=[`redocly.yaml`,`redocly.yml`],k=`redocly.yaml`;async function A(e,t){let r=await re(e,t),i=f();if(!r){let e=[],t=C(w($(),i,t=>e.push({code:`configuration/ignored`,message:t})),i);return{absolutePath:null,config:t,siteConfig:t,path:null,hash:null,refs:[],problems:e}}let s=await t.readBinaryFile(r.absolutePath),c=[],l=[],p=[],m=F(new TextDecoder().decode(s),r.path),h=[],g=a(i),_={contentDir:e,fs:t,env:g,refs:p,warnings:c,errors:l},v=Q(await te(await R(await I(m,{..._,deprecations:h}),``,_),_)),y={filePath:r.path},b=[],x=U(v.access)?v.access.rbac:void 0,T=K(v,{dirLocales:await o(e,t),teamDirs:await u(e,t,d(U(x)?x:{})),env:g,report:e=>b.push({...e,location:y})}),E=C(w(T,i,e=>b.push({code:`configuration/ignored`,message:e,location:y})),i),{config:D,unsetVars:O}=S(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})),...l.map(e=>({code:`configuration/invalid`,severity:`error`,message:e,location:y})),...b];return{...r,config:D,siteConfig:E,hash:await n(s),refs:p,problems:k}}function j(e,t){return x(e)!==t}async function ee(e){if(e.context.configLoaded&&e.force!==!0)return{absolutePath:e.context.configFilePath?T(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=await A(e.context.contentDir,e.context.platform.fs);return e.context.config=t.config,e.context.siteConfig=t.siteConfig,e.context.configFilePath=t.path,e.context.configHash=t.hash,e.context.configRefs=t.refs,e.context.configLoaded=!0,t}function M(e,t){let n=E(F(e,t),a(f())).value,{value:r,problems:i}=b(v,n);for(let e of i)e.location={filePath:t};return{config:r,problems:i}}function N(e){return e.endsWith(`/${k}`)}async function P(e){let t=[];for(let n of e.paths)try{let r=await e.fs.readFile(T(e.contentDir,n));t.push(...M(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=D.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,a=[...i?[`branch.${h(i)}`]:[],m(t.env.REDOCLY_ENV)],o=e=>t.deprecations.push(e),s=J(r,o);for(let e of a){let r=await L(n[e],e,t);r&&(s=H(s,J(r,o)))}return s}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(D.load(e)))}async function V(e,t,r,i,a=`warning`){let o=a===`error`?r.errors:r.warnings,s=g(e,O[0]);if(s===null)return o.push(`${t} "${e}" escapes the content root.`),null;try{let e=await r.fs.readBinaryFile(T(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 te(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=[`requiresLogin`,`rbac`,`sso`,`idps`,`logoutReturnUrl`,`residency`];function K(e,t={}){let n=t.report??(()=>{}),r=t.dirLocales??[],i=J(e,e=>n({code:`configuration/deprecated`,message:e}));U(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=b(y,i,{env:t.env});for(let e of a.problems)n(e);let{redirects:o,access:u,...d}=c(l(q(a.value,t.env),t.teamDirs??{},n),r),f={...d,publicEnv:p()};u&&(f.access=ne(u,n));let m=_(o,s(d.l10n,r));return m&&(f.redirects=m),f}function q(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 J(e,t){return Z(Y(Q(e),t))}function Y(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=X(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:X(r.rbac)}}),n}function X(e){let{reunite:t,...n}=e;return{...n,platform:e.platform??t}}function Z(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=G.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 ne(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 re(e,t){for(let n of O){let r=T(e,n);if(await t.exists(r))return{absolutePath:r,path:n}}return null}function $(){return K({})}export{k as NESTED_CONFIG_FILENAME,O as REDOCLY_CONFIG_FILENAMES,$ as createEmptyRealmConfig,H as deepMergeConfig,j as isConfigChanged,N as isNestedConfigPath,ee as loadContentLayerConfig,A as loadRedoclyConfig,K as normalizeRedoclyConfig,M as parseNestedConfig,P as readNestedConfigProblems};
1
+ import{toJsonObject as e,toJsonValue as t}from"./database/utils/json.js";import{listL10nDirs as n,resolveLocaleContext as r}from"../shared/utils/l10n.js";import{hashContentBytes as i}from"../shared/utils/content-hash.js";import{getProcessEnv as a,getPublicEnv as o,resolveRedoclyEnvironment as s,sanitizeBranchName as c}from"../shared/public-env.js";import{isClosedToAnonymous as l,parseRbacConfigData as u}from"../shared/rbac/engine.js";import{readProjectEnv as d}from"../shared/project-env.js";import{expandConfigRbacForL10n as f}from"../shared/rbac/l10n-rules.js";import{expandConfigRbacTeamTemplates as p,listTeamDirs as m,teamTemplatePrefixes as h}from"../shared/rbac/team-templates.js";import{resolveContentPath as g}from"../shared/utils/resolve-content-path.js";import{resolveConfigRedirects as _}from"./config-redirects.js";import{NESTED_CONFIG_SCHEMA as v,realmConfigSchema as y,sanitizeConfig as b}from"./config-schema.js";import{hashEffectiveConfig as x,resolveSiteConfig as S}from"./database/site-config.js";import{applyEnforcedAccess as C}from"./enforced-access.js";import{applyPlanGates as w}from"./plan-gates.js";import{resolve as T}from"node:path";import{interpolateEnvVariables as E}from"@redocly/config";import D from"js-yaml";const O=[`redocly.yaml`,`redocly.yml`],k=`redocly.yaml`;async function A(e,t,r={}){let o=await ae(e,t),s=a();if(!o){let e=[],t=C(w($(),s,t=>e.push({code:`configuration/ignored`,message:t})),s);return{absolutePath:null,config:t,siteConfig:t,path:null,hash:null,refs:[],problems:e}}let c=await t.readBinaryFile(o.absolutePath),l=[],u=[],f=[],p=F(new TextDecoder().decode(c),o.path),g=[],_=d(s),v={contentDir:e,fs:t,env:_,refs:f,warnings:l,errors:u},y=Q(await H(await R(await I(p,{...v,deprecations:g}),``,v),v)),b={filePath:o.path},x=[],T=W(y.access)?y.access.rbac:void 0,E=J(y,{dirLocales:await n(e,t),teamDirs:await m(e,t,h(W(T)?T:{})),env:_,pluginSchemas:r,report:e=>x.push({...e,location:b})}),D=C(w(E,s,e=>x.push({code:`configuration/ignored`,message:e,location:b})),s),{config:O,unsetVars:k}=S(D,_);for(let e of k)l.push(`The config references process.env.${e}, which is not set.`);let A=[...l.map(e=>({code:`configuration/ignored`,message:e,location:b})),...[...new Set(g)].map(e=>({code:`configuration/deprecated`,message:e,location:b})),...u.map(e=>({code:`configuration/invalid`,severity:`error`,message:e,location:b})),...x];return{...o,config:O,siteConfig:D,hash:await i(c),refs:f,problems:A}}function j(e,t){return x(e)!==t}async function ee(e){if(e.context.configLoaded&&e.force!==!0)return{absolutePath:e.context.configFilePath?T(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 A(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 M(e,t){let n=E(F(e,t),d(a())).value,{value:r,problems:i}=b(v,n);for(let e of i)e.location={filePath:t};return{config:r,problems:i}}function N(e){return e.endsWith(`/${k}`)}async function P(e){let t=[];for(let n of e.paths)try{let r=await e.fs.readFile(T(e.contentDir,n));t.push(...M(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=D.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(!W(n))return e;let i=t.env.PUBLIC_REDOCLY_BRANCH_NAME,a=[...i?[`branch.${c(i)}`]:[],s(t.env.REDOCLY_ENV)],o=e=>t.deprecations.push(e),l=X(r,o);for(let e of a){let r=await L(n[e],e,t);r&&(l=U(l,X(r,o)))}return l}async function L(e,t,n){if(!W(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 W(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(!W(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(W(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(D.load(e)))}async function V(e,t,n,r,a=`warning`){let o=a===`error`?n.errors:n.warnings,s=g(e,O[0]);if(s===null)return o.push(`${t} "${e}" escapes the content root.`),null;try{let e=await n.fs.readBinaryFile(T(n.contentDir,s));return n.refs.push({path:s,hash:await i(e)}),r(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 H(e,t){let{seo:n}=e;if(!W(n)||!W(n.llmstxt)||!W(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 U(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]=W(t)&&W(r)?U(t,r):r}return n}function W(e){return typeof e==`object`&&!!e&&!Array.isArray(e)}const G=[`hide`,`name`,`ignore`,`publicEndpoint`],K=`redocly.apigee`,q=[`requiresLogin`,`rbac`,`sso`,`idps`,`logoutReturnUrl`,`residency`];function J(e,t={}){let n=t.report??(()=>{}),i=t.dirLocales??[],a=X(e,e=>n({code:`configuration/deprecated`,message:e}));W(a.mcp)&&a.mcp.docs!==void 0&&n({code:`configuration/deprecated`,message:`The 'mcp.docs' property is deprecated. Use the 'mcp' properties instead.`});let s=b(y(t.pluginSchemas??{}),a,{env:t.env});for(let e of s.problems)n(e);let{redirects:c,access:l,...u}=f(p(Y(s.value,t.env),t.teamDirs??{},n),i),d={...u,publicEnv:o()};l&&(d.access=ie(l,n));let m=_(c,r(u.l10n,i));return m&&(d.redirects=m),d}function Y(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 X(e,t){return te(re(ne(Q(e),t)),t)}function te(e,t){let{developerOnboarding:n}=e;if(!W(n)||!Array.isArray(n.adapters))return e;let r=n.adapters.find(e=>W(e)&&(e.type===`APIGEE_X`||e.type===`APIGEE_EDGE`));if(!W(r)||(t(`The Apigee adapter in 'developerOnboarding' is deprecated. Add the Apigee plugin and move the adapter to 'redocly.apigee'.`),e[K]!==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,[K]:{...s,apiProducts:c}}}function ne(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 W(r)&&W(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 re(e){let{mcp:t}=e;if(!W(t))return e;let{docs:n,...r}=t;if(!W(n))return e;let i={...n};for(let e of G){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=q.map(t=>[t,e[t]]).filter(([,e])=>e!==void 0);if(t.length===0)return e;let n={...e},r=W(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 ie(e,t){let n=e.rbac?u(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:l(n)}):e}async function ae(e,t){for(let n of O){let r=T(e,n);if(await t.exists(r))return{absolutePath:r,path:n}}return null}function $(){return J({})}export{k as NESTED_CONFIG_FILENAME,O as REDOCLY_CONFIG_FILENAMES,$ as createEmptyRealmConfig,U as deepMergeConfig,j as isConfigChanged,N as isNestedConfigPath,ee as loadContentLayerConfig,A as loadRedoclyConfig,J as normalizeRedoclyConfig,M as parseNestedConfig,P as readNestedConfigProblems};
@@ -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,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};
@@ -41,7 +41,10 @@ export type EntityStoreOptions = {
41
41
  * rows never materialize. Null/absent = current rows (the hot path).
42
42
  */
43
43
  revisionAsOf?: number | null;
44
- /** Produces a missing or stale value; absent = stored values only (production runtime). */
44
+ /**
45
+ * Produces a missing or stale value and patches its row in `state`; absent = stored values
46
+ * only (production runtime).
47
+ */
45
48
  materialize?: (key: string) => Promise<JsonValue>;
46
49
  /** Called with every key `get`/`load` touched, once the read is known — the reader's entity deps. */
47
50
  onEntityRead?: (key: string) => void;
@@ -49,6 +52,11 @@ export type EntityStoreOptions = {
49
52
  record?: RouteQueryRecorder;
50
53
  };
51
54
  export declare function createEntityStore(options: EntityStoreOptions): EntityStore;
55
+ /**
56
+ * Makes the state entry of `key` match its stored row after a materialization: in place, so
57
+ * every store over this state, and a `get` after a `load`, sees the loader's metadata.
58
+ */
59
+ export declare function refreshStateEntity(database: ContentLayerDatabase, state: ContentStateView, key: string): Promise<void>;
52
60
  /** The hash a hook's `entity` read records: identity, type, metadata, and value hash, or absence. */
53
61
  export declare function hashEntityRead(state: ContentStateView, key: string): string;
54
62
  /** Re-runs a stored `entity-type` query against `state`; the hash `list` recorded. */
@@ -1 +1 @@
1
- import{hashJsonValue as e,toStableJsonString as t}from"./utils/json.js";import{compareStrings as n}from"../../shared/utils/compare-strings.js";import{entities as r}from"./schema.js";import{replaceDataRefMarkers as i}from"../materialization/data-ref.js";import{resolveDataRef as a}from"./blobs.js";import{listEntityRevisions as o}from"../revisions/list.js";import{selectEntityRowForRead as s}from"../revisions/read.js";import{and as c,eq as l,inArray as u}from"drizzle-orm";function d(e){let{database:t,state:u}=e,d=typeof e.revisionAsOf==`number`?e.revisionAsOf:null;return{get:async n=>{if(e.onEntityRead?.(n),d!==null){let e=await s(t.db,n,d);return e?x(e):null}let i=u?.entitiesByKey.get(n);if(i)return x(i);if(u)return null;let[a]=await t.db.select(b()).from(r).where(c(l(r.key,n),l(r.isCurrent,1))).limit(1);return a?x(a):null},async listRevisions(n){for(let t of n)e.onEntityRead?.(t);return o(t.db,n)},async list(i={}){let a=(u?[...u.entitiesByKey.values()].filter(e=>v(e,i)):await t.db.select(b()).from(r).where(c(l(r.isCurrent,1),i.type===void 0?void 0:l(r.type,i.type),i.pluginId===void 0?void 0:l(r.pluginId,i.pluginId)))).map(x).sort((e,t)=>n(e.key,t.key));return e.record?.({kind:`entity-type`,argument:m(i),resultHash:_(a.map(e=>e.key))}),a},async load(n){let o=u?.entitiesByKey.get(n),[m]=d===null?u&&!o?[]:await t.db.select({status:r.status,data:r.data,dataHash:r.dataHash,metadata:r.metadata,isCurrent:r.isCurrent}).from(r).where(c(l(r.key,n),l(r.isCurrent,1))).limit(1):[await s(t.db,n,d)??void 0];if(!m)throw e.onEntityRead?.(n),Error(`Entity "${n}" is not registered.`);let h;if(m.status===`ready`&&m.data!==null||m.isCurrent!==1)h=m.data,u&&m.isCurrent===1&&d===null&&p(u,n,m);else if(e.materialize)h=await e.materialize(n),u&&await f(t,u,n);else throw Error(`Missing precomputed entity data for "${n}". Rebuild the content entity data before starting the production runtime.`);return e.onEntityRead?.(n),await i(h,e=>a(t,e))}}}async function f(e,t,n){let[i]=await e.db.select({status:r.status,dataHash:r.dataHash,metadata:r.metadata}).from(r).where(c(l(r.key,n),l(r.isCurrent,1))).limit(1);i&&p(t,n,i)}function p(e,t,n){let r=e.entitiesByKey.get(t);r&&Object.assign(r,{status:n.status,dataHash:n.dataHash,metadata:n.metadata})}function m(e){return t({...e.type===void 0?{}:{type:e.type},...e.pluginId===void 0?{}:{pluginId:e.pluginId}})}function h(t,n){let r=t.entitiesByKey.get(n);return e(r?[r.id,r.kind,r.type,r.metadata,r.dataHash,r.status]:`absent`)}function g(e,t){let r=JSON.parse(t),i=[];for(let t of e.entitiesByKey.values())v(t,r)&&i.push(t.key);return _(i.sort(n))}function _(t){return e([...t])}function v(e,t){return(t.type===void 0||e.type===t.type)&&(t.pluginId===void 0||e.pluginId===t.pluginId)}async function y(e,t){return t.length===0?[]:e.db.select({key:r.key,metadata:r.metadata}).from(r).where(c(u(r.key,[...t]),l(r.isCurrent,1)))}function b(){return{id:r.id,key:r.key,kind:r.kind,type:r.type,metadata:r.metadata,pluginId:r.pluginId,loaderId:r.loaderId,loaderArgs:r.loaderArgs,status:r.status,dataHash:r.dataHash,isSystem:r.isSystem}}function x(e){return{id:e.id,key:e.key,kind:e.kind,type:e.type,metadata:e.metadata,pluginId:e.pluginId,loaderId:e.loaderId,loaderArgs:e.loaderArgs,status:e.status,dataHash:e.dataHash,isSystem:e.isSystem===!0||e.isSystem===1}}export{d as createEntityStore,g as hashEntityListMembership,h as hashEntityRead,y as loadCurrentEntityMetadata};
1
+ import{hashJsonValue as e,toStableJsonString as t}from"./utils/json.js";import{compareStrings as n}from"../../shared/utils/compare-strings.js";import{entities as r}from"./schema.js";import{replaceDataRefMarkers as i}from"../materialization/data-ref.js";import{resolveDataRef as a}from"./blobs.js";import{listEntityRevisions as o}from"../revisions/list.js";import{selectEntityRowForRead as s}from"../revisions/read.js";import{and as c,eq as l,inArray as u}from"drizzle-orm";function d(e){let{database:t,state:u}=e,d=typeof e.revisionAsOf==`number`?e.revisionAsOf:null;return{get:async n=>{if(e.onEntityRead?.(n),d!==null){let e=await s(t.db,n,d);return e?x(e):null}let i=u?.entitiesByKey.get(n);if(i)return x(i);if(u)return null;let[a]=await t.db.select(b()).from(r).where(c(l(r.key,n),l(r.isCurrent,1))).limit(1);return a?x(a):null},async listRevisions(n){for(let t of n)e.onEntityRead?.(t);return o(t.db,n)},async list(i={}){let a=(u?[...u.entitiesByKey.values()].filter(e=>v(e,i)):await t.db.select(b()).from(r).where(c(l(r.isCurrent,1),i.type===void 0?void 0:l(r.type,i.type),i.pluginId===void 0?void 0:l(r.pluginId,i.pluginId)))).map(x).sort((e,t)=>n(e.key,t.key));return e.record?.({kind:`entity-type`,argument:m(i),resultHash:_(a.map(e=>e.key))}),a},async load(n){let o=u?.entitiesByKey.get(n),[f]=d===null?u&&!o?[]:await t.db.select({status:r.status,data:r.data,dataHash:r.dataHash,type:r.type,metadata:r.metadata,isCurrent:r.isCurrent}).from(r).where(c(l(r.key,n),l(r.isCurrent,1))).limit(1):[await s(t.db,n,d)??void 0];if(!f)throw e.onEntityRead?.(n),Error(`Entity "${n}" is not registered.`);let m;if(f.status===`ready`&&f.data!==null||f.isCurrent!==1)m=f.data,u&&f.isCurrent===1&&d===null&&p(u,n,f);else if(e.materialize)m=await e.materialize(n);else throw Error(`Missing precomputed entity data for "${n}". Rebuild the content entity data before starting the production runtime.`);return e.onEntityRead?.(n),await i(m,e=>a(t,e))}}}async function f(e,t,n){let[i]=await e.db.select({status:r.status,dataHash:r.dataHash,type:r.type,metadata:r.metadata}).from(r).where(c(l(r.key,n),l(r.isCurrent,1))).limit(1);i&&p(t,n,i)}function p(e,t,n){let r=e.entitiesByKey.get(t);r&&Object.assign(r,{status:n.status,dataHash:n.dataHash,type:n.type,metadata:n.metadata})}function m(e){return t({...e.type===void 0?{}:{type:e.type},...e.pluginId===void 0?{}:{pluginId:e.pluginId}})}function h(t,n){let r=t.entitiesByKey.get(n);return e(r?[r.id,r.kind,r.type,r.metadata,r.dataHash,r.status]:`absent`)}function g(e,t){let r=JSON.parse(t),i=[];for(let t of e.entitiesByKey.values())v(t,r)&&i.push(t.key);return _(i.sort(n))}function _(t){return e([...t])}function v(e,t){return(t.type===void 0||e.type===t.type)&&(t.pluginId===void 0||e.pluginId===t.pluginId)}async function y(e,t){return t.length===0?[]:e.db.select({key:r.key,metadata:r.metadata}).from(r).where(c(u(r.key,[...t]),l(r.isCurrent,1)))}function b(){return{id:r.id,key:r.key,kind:r.kind,type:r.type,metadata:r.metadata,pluginId:r.pluginId,loaderId:r.loaderId,loaderArgs:r.loaderArgs,status:r.status,dataHash:r.dataHash,isSystem:r.isSystem}}function x(e){return{id:e.id,key:e.key,kind:e.kind,type:e.type,metadata:e.metadata,pluginId:e.pluginId,loaderId:e.loaderId,loaderArgs:e.loaderArgs,status:e.status,dataHash:e.dataHash,isSystem:e.isSystem===!0||e.isSystem===1}}export{d as createEntityStore,g as hashEntityListMembership,h as hashEntityRead,y as loadCurrentEntityMetadata,f as refreshStateEntity};
@@ -1,27 +1,27 @@
1
- import{delocalizeL10nPath as e}from"../../shared/utils/l10n.js";import{assetRefs as t,entities as n,entityDeps as r,files as i,linkRefs as a,loaderConfigDeps as o,originDeps as s,pageMarkdown as c,problems as l,searchDocuments as u,searchFragmentParents as d,searchFragmentPostings as f,searchFragmentUsages as p,searchFragments as m,searchPostings as h}from"./schema.js";import{compileGlob as g,hashGlobMatches as _,matchGlob as v}from"../plugins/utils/glob.js";import{hashContentConfigDependency as y}from"../config-deps.js";import{runWithSqliteBusyRetry as b}from"./connection.js";import{createRouteQueryEvaluator as x,isRouteQueryStale as S}from"../plugins/utils/route-index.js";import{APP_DATA_ENTITY_KEY as C}from"../../shared/constants/app-data.js";import{refreshTermDocCounts as w,selectTermIdsOfDocuments as T,selectTermIdsOfFragments as E}from"./search-vocab.js";import{RETRYABLE_PROBLEM_CODES as D}from"../problems/codes.js";import{and as O,eq as k,inArray as A,sql as j}from"drizzle-orm";async function M(e){return await e.db.select({accessType:s.accessType,originFileId:s.originFileId,originFilePath:i.path,originPluginId:s.originPluginId,hook:s.hook,path:s.path,source:s.source,valueHash:s.valueHash}).from(s).leftJoin(i,k(s.originFileId,i.id)).orderBy(i.path,s.originPluginId,s.path,s.accessType)}function N(e,t){let n=/* @__PURE__ */ new Map,r=L(t);for(let t of e){if(t.source!==`config`||t.originFileId===null||t.originFilePath===null||r(t)===t.valueHash)continue;let e=`${t.originPluginId}:${t.originFilePath}`;n.has(e)||n.set(e,t)}return R([...n.values()])}function P(e,t){let n=/* @__PURE__ */ new Map;for(let r of e){if(r.source===`config`||r.originFileId===null||r.originFilePath===null||F(r,t)===r.valueHash)continue;let e=`${r.originPluginId}:${r.originFilePath}`;n.has(e)||n.set(e,r)}return R([...n.values()])}function F(e,t){if(e.source===`glob`)return _(v(t.filesByPath.keys(),e.path));let n=t.filesByPath.get(e.path)??t.ignoredFilesByPath?.get(e.path);return e.accessType===`presence`?n?`present`:`absent`:n?.hash??null}function I(e,t,n){let r=/* @__PURE__ */ new Set,i=L(n.config);for(let a of e)a.originFileId!==null||a.hook!==t||r.has(a.originPluginId)||(a.source===`config`?i(a):F(a,n))!==a.valueHash&&r.add(a.originPluginId);return r}function L(e){let t=/* @__PURE__ */ new Map;return n=>{let r=`${n.accessType}\u0000${n.path}`,i=t.get(r);return i===void 0&&(i=y(e,n),t.set(r,i)),i}}function R(e){return e.sort((e,t)=>{let n=e.originFilePath.localeCompare(t.originFilePath);return n===0?e.originPluginId.localeCompare(t.originPluginId):n})}async function z(e,t){let r=await e.db.select({accessType:o.accessType,path:o.path,key:n.key,valueHash:o.valueHash}).from(o).innerJoin(n,k(o.entityId,n.id)).orderBy(n.key,o.path,o.accessType),i=/* @__PURE__ */ new Set;for(let e of r)y(t.config,e)!==e.valueHash&&i.add(e.key);let a=await U(e,{logger:t.logger,reason:`config dependency invalidation`,keys:[...i]});return a.invalidatedKeys.length>0&&t.logger?.debug(`Propagated config dependency invalidation`,{invalidatedKeys:a.invalidatedKeys.length}),a}async function B(e,t={}){let r=await e.db.selectDistinct({key:n.key}).from(l).innerJoin(n,k(l.entityId,n.id)).where(O(k(l.scope,`entity`),A(l.code,[...D]),k(n.isCurrent,1)));return U(e,{logger:t.logger,reason:`retryable problem invalidation`,keys:r.map(e=>e.key)})}async function V(e,t){let r=x(t.state,t.config).memoized(),i=/* @__PURE__ */ new Set;for(let e of t.rows)e.entityId===null||e.hook===`searchable`||i.has(e.entityId)||S(r,e)&&i.add(e.entityId);if(i.size===0)return{invalidatedKeys:[]};let a=await e.db.select({key:n.key}).from(n).where(A(n.id,[...i]));return U(e,{logger:t.logger,reason:`route query invalidation`,keys:a.map(e=>e.key)})}async function H(i,a){if(a.changedFilePaths.length===0)return{invalidatedKeys:[]};let o=/* @__PURE__ */ new Set,s=await i.db.select({key:n.key}).from(n).innerJoin(r,k(r.entityId,n.id)).where(j`${r.dependencyType} in ('file','origin') and ${r.dependencyRef} in ${a.changedFilePaths}`);for(let e of s)o.has(e.key)||o.add(e.key);let c=[...new Set(a.changedFilePaths.map(e).filter(e=>e!==void 0))];if(c.length>0){let e=await i.db.select({key:n.key}).from(n).innerJoin(t,k(t.entityId,n.id)).where(A(t.path,c));for(let t of e)o.add(t.key)}let l=a.membershipChangedPaths??[];if(l.length>0){let e=await i.db.select({key:n.key,pattern:r.dependencyRef}).from(n).innerJoin(r,k(r.entityId,n.id)).where(k(r.dependencyType,`glob`));for(let t of e){let e=g(t.pattern);l.some(e)&&o.add(t.key)}}let u=await U(i,{logger:a.logger,reason:`file dependency invalidation`,keys:[...o]});return u.invalidatedKeys.length>0&&a.logger?.debug(`Propagated entity invalidation`,{changedFilePaths:a.changedFilePaths.length,invalidatedKeys:u.invalidatedKeys.length}),u}async function U(e,t){let i=new Set(t.keys),a=new Set(i),o=[...i];for(;o.length>0;){let t=o;o=[];let i=await e.db.select({key:n.key}).from(n).innerJoin(r,k(r.entityId,n.id)).where(j`${r.dependencyType} = 'entity' and ${r.dependencyRef} in ${t}`);for(let e of i)a.has(e.key)||(a.add(e.key),o.push(e.key))}let s=t.markKeys===!1?[...a].filter(e=>!i.has(e)):[...a];return s.length===0?{invalidatedKeys:[]}:(await b(()=>e.db.update(n).set({status:`stale`,invalidationSeq:j`${n.invalidationSeq} + 1`}).where(O(A(n.key,s),k(n.isCurrent,1))),{logger:t.logger,operation:t.reason}),{invalidatedKeys:s})}async function W(e,t){return b(()=>e.db.transaction(e=>G(e)),{logger:t,operation:`garbage collect orphaned entities`})}async function G(e){let t=j`(${n.isSystem} = 0 or ${n.key} <> ${C}) and ${n.isCurrent} = 1 and not exists (
1
+ import{APP_DATA_ENTITY_KEY as e}from"../../shared/constants/app-data.js";import{delocalizeL10nPath as t}from"../../shared/utils/l10n.js";import{assetRefs as n,entities as r,entityDeps as i,files as a,linkRefs as o,loaderConfigDeps as s,originDeps as c,pageMarkdown as l,problems as u,searchDocuments as d,searchFragmentParents as f,searchFragmentPostings as p,searchFragmentUsages as m,searchFragments as h,searchPostings as g}from"./schema.js";import{compileGlob as _,hashGlobMatches as v,matchGlob as y}from"../plugins/utils/glob.js";import{hashContentConfigDependency as b}from"../config-deps.js";import{runWithSqliteBusyRetry as x}from"./connection.js";import{createRouteQueryEvaluator as S,isRouteQueryStale as C}from"../plugins/utils/route-index.js";import{refreshTermDocCounts as w,selectTermIdsOfDocuments as T,selectTermIdsOfFragments as E}from"./search-vocab.js";import{RETRYABLE_PROBLEM_CODES as D}from"../problems/codes.js";import{and as O,eq as k,inArray as A,sql as j}from"drizzle-orm";async function M(e){return await e.db.select({accessType:c.accessType,originFileId:c.originFileId,originFilePath:a.path,originPluginId:c.originPluginId,hook:c.hook,path:c.path,source:c.source,valueHash:c.valueHash}).from(c).leftJoin(a,k(c.originFileId,a.id)).orderBy(a.path,c.originPluginId,c.path,c.accessType)}function N(e,t){let n=/* @__PURE__ */ new Map,r=L(t);for(let t of e){if(t.source!==`config`||t.originFileId===null||t.originFilePath===null||r(t)===t.valueHash)continue;let e=`${t.originPluginId}:${t.originFilePath}`;n.has(e)||n.set(e,t)}return R([...n.values()])}function P(e,t){let n=/* @__PURE__ */ new Map;for(let r of e){if(r.source===`config`||r.originFileId===null||r.originFilePath===null||F(r,t)===r.valueHash)continue;let e=`${r.originPluginId}:${r.originFilePath}`;n.has(e)||n.set(e,r)}return R([...n.values()])}function F(e,t){if(e.source===`glob`)return v(y(t.filesByPath.keys(),e.path));let n=t.filesByPath.get(e.path)??t.ignoredFilesByPath?.get(e.path);return e.accessType===`presence`?n?`present`:`absent`:n?.hash??null}function I(e,t,n){let r=/* @__PURE__ */ new Set,i=L(n.config);for(let a of e)a.originFileId!==null||a.hook!==t||r.has(a.originPluginId)||(a.source===`config`?i(a):F(a,n))!==a.valueHash&&r.add(a.originPluginId);return r}function L(e){let t=/* @__PURE__ */ new Map;return n=>{let r=`${n.accessType}\u0000${n.path}`,i=t.get(r);return i===void 0&&(i=b(e,n),t.set(r,i)),i}}function R(e){return e.sort((e,t)=>{let n=e.originFilePath.localeCompare(t.originFilePath);return n===0?e.originPluginId.localeCompare(t.originPluginId):n})}async function z(e,t){let n=await e.db.select({accessType:s.accessType,path:s.path,key:r.key,valueHash:s.valueHash}).from(s).innerJoin(r,k(s.entityId,r.id)).orderBy(r.key,s.path,s.accessType),i=/* @__PURE__ */ new Set;for(let e of n)b(t.config,e)!==e.valueHash&&i.add(e.key);let a=await U(e,{logger:t.logger,reason:`config dependency invalidation`,keys:[...i]});return a.invalidatedKeys.length>0&&t.logger?.debug(`Propagated config dependency invalidation`,{invalidatedKeys:a.invalidatedKeys.length}),a}async function B(e,t={}){let n=await e.db.selectDistinct({key:r.key}).from(u).innerJoin(r,k(u.entityId,r.id)).where(O(k(u.scope,`entity`),A(u.code,[...D]),k(r.isCurrent,1)));return U(e,{logger:t.logger,reason:`retryable problem invalidation`,keys:n.map(e=>e.key)})}async function V(e,t){let n=S(t.state,t.config).memoized(),i=/* @__PURE__ */ new Set;for(let e of t.rows)e.entityId===null||e.hook===`searchable`||i.has(e.entityId)||C(n,e)&&i.add(e.entityId);if(i.size===0)return{invalidatedKeys:[]};let a=await e.db.select({key:r.key}).from(r).where(A(r.id,[...i]));return U(e,{logger:t.logger,reason:`route query invalidation`,keys:a.map(e=>e.key)})}async function H(e,a){if(a.changedFilePaths.length===0)return{invalidatedKeys:[]};let o=/* @__PURE__ */ new Set,s=await e.db.select({key:r.key}).from(r).innerJoin(i,k(i.entityId,r.id)).where(j`${i.dependencyType} in ('file','origin') and ${i.dependencyRef} in ${a.changedFilePaths}`);for(let e of s)o.has(e.key)||o.add(e.key);let c=[...new Set(a.changedFilePaths.map(t).filter(e=>e!==void 0))];if(c.length>0){let t=await e.db.select({key:r.key}).from(r).innerJoin(n,k(n.entityId,r.id)).where(A(n.path,c));for(let e of t)o.add(e.key)}let l=a.membershipChangedPaths??[];if(l.length>0){let t=await e.db.select({key:r.key,pattern:i.dependencyRef}).from(r).innerJoin(i,k(i.entityId,r.id)).where(k(i.dependencyType,`glob`));for(let e of t){let t=_(e.pattern);l.some(t)&&o.add(e.key)}}let u=await U(e,{logger:a.logger,reason:`file dependency invalidation`,keys:[...o]});return u.invalidatedKeys.length>0&&a.logger?.debug(`Propagated entity invalidation`,{changedFilePaths:a.changedFilePaths.length,invalidatedKeys:u.invalidatedKeys.length}),u}async function U(e,t){let n=new Set(t.keys),a=new Set(n),o=[...n];for(;o.length>0;){let t=o;o=[];let n=await e.db.select({key:r.key}).from(r).innerJoin(i,k(i.entityId,r.id)).where(j`${i.dependencyType} = 'entity' and ${i.dependencyRef} in ${t}`);for(let e of n)a.has(e.key)||(a.add(e.key),o.push(e.key))}let s=t.markKeys===!1?[...a].filter(e=>!n.has(e)):[...a];return s.length===0?{invalidatedKeys:[]}:(await x(()=>e.db.update(r).set({status:`stale`,invalidationSeq:j`${r.invalidationSeq} + 1`}).where(O(A(r.key,s),k(r.isCurrent,1))),{logger:t.logger,operation:t.reason}),{invalidatedKeys:s})}async function W(e,t){return x(()=>e.db.transaction(e=>G(e)),{logger:t,operation:`garbage collect orphaned entities`})}async function G(t){let n=j`(${r.isSystem} = 0 or ${r.key} <> ${e}) and ${r.isCurrent} = 1 and not exists (
2
2
  select 1
3
- from ${r}
4
- where ${r.entityId} = ${n.id}
5
- and ${r.dependencyType} = 'origin'
6
- )`,[i]=await e.select({id:n.id}).from(n).where(t).limit(1);return i!==void 0&&await K(e,t),await e.delete(n).where(j`${n.isCurrent} = 0 and not exists (
7
- select 1 from ${n} as live
8
- where live.key = ${n.key} and live.is_current = 1
9
- )`),{removedOrphans:i!==void 0}}async function K(e,t){await e.delete(o).where(j`${o.entityId} in (
10
- select ${n.id} from ${n} where ${t}
11
- )`);let r=j`select ${u.id} from ${u}
12
- where ${u.entityKey} in (
13
- select ${n.key} from ${n} where ${t}
14
- )`,i=j`select ${m.id} from ${m}
15
- where ${m.entityKey} in (
16
- select ${n.key} from ${n} where ${t}
17
- )`,s=[...await T(e,r),...await E(e,i)];await e.delete(h).where(j`${h.docId} in (${r})`),await e.delete(f).where(j`${f.fragmentId} in (${i})`),await e.delete(d).where(j`${d.docId} in (${r})`),await e.delete(p).where(j`${p.fragmentId} in (${i})`),await e.delete(m).where(j`${m.id} in (${i})`),await w(e,s),await e.delete(u).where(j`${u.entityKey} in (
18
- select ${n.key} from ${n} where ${t}
19
- )`),await e.delete(c).where(j`${c.entityKey} in (
20
- select ${n.key} from ${n} where ${t}
21
- )`),await e.delete(l).where(j`${l.scope} = 'entity' and ${l.entityId} in (
22
- select ${n.id} from ${n} where ${t}
23
- )`);let g=j`${a.entityId} in (
24
- select ${n.id} from ${n} where ${t}
25
- )`;await e.delete(l).where(j`${l.scope} = 'link' and ${l.linkRefId} in (
26
- select ${a.id} from ${a} where ${g}
27
- )`),await e.delete(a).where(g),await e.delete(n).where(t)}export{N as computeDirtyConfigOrigins,P as computeDirtyFileOrigins,I as computeDirtyPluginScopedOrigins,W as garbageCollectOrphanedEntities,G as garbageCollectOrphanedEntitiesInTransaction,M as loadOriginDependencyRows,z as propagateConfigDependencyInvalidation,H as propagateEntityInvalidation,U as propagateEntityInvalidationFromKeys,B as propagateRetryableProblemInvalidation,V as propagateRouteQueryInvalidation};
3
+ from ${i}
4
+ where ${i.entityId} = ${r.id}
5
+ and ${i.dependencyType} = 'origin'
6
+ )`,[a]=await t.select({id:r.id}).from(r).where(n).limit(1);return a!==void 0&&await K(t,n),await t.delete(r).where(j`${r.isCurrent} = 0 and not exists (
7
+ select 1 from ${r} as live
8
+ where live.key = ${r.key} and live.is_current = 1
9
+ )`),{removedOrphans:a!==void 0}}async function K(e,t){await e.delete(s).where(j`${s.entityId} in (
10
+ select ${r.id} from ${r} where ${t}
11
+ )`);let n=j`select ${d.id} from ${d}
12
+ where ${d.entityKey} in (
13
+ select ${r.key} from ${r} where ${t}
14
+ )`,i=j`select ${h.id} from ${h}
15
+ where ${h.entityKey} in (
16
+ select ${r.key} from ${r} where ${t}
17
+ )`,a=[...await T(e,n),...await E(e,i)];await e.delete(g).where(j`${g.docId} in (${n})`),await e.delete(p).where(j`${p.fragmentId} in (${i})`),await e.delete(f).where(j`${f.docId} in (${n})`),await e.delete(m).where(j`${m.fragmentId} in (${i})`),await e.delete(h).where(j`${h.id} in (${i})`),await w(e,a),await e.delete(d).where(j`${d.entityKey} in (
18
+ select ${r.key} from ${r} where ${t}
19
+ )`),await e.delete(l).where(j`${l.entityKey} in (
20
+ select ${r.key} from ${r} where ${t}
21
+ )`),await e.delete(u).where(j`${u.scope} = 'entity' and ${u.entityId} in (
22
+ select ${r.id} from ${r} where ${t}
23
+ )`);let c=j`${o.entityId} in (
24
+ select ${r.id} from ${r} where ${t}
25
+ )`;await e.delete(u).where(j`${u.scope} = 'link' and ${u.linkRefId} in (
26
+ select ${o.id} from ${o} where ${c}
27
+ )`),await e.delete(o).where(c),await e.delete(r).where(t)}export{N as computeDirtyConfigOrigins,P as computeDirtyFileOrigins,I as computeDirtyPluginScopedOrigins,W as garbageCollectOrphanedEntities,G as garbageCollectOrphanedEntitiesInTransaction,M as loadOriginDependencyRows,z as propagateConfigDependencyInvalidation,H as propagateEntityInvalidation,U as propagateEntityInvalidationFromKeys,B as propagateRetryableProblemInvalidation,V as propagateRouteQueryInvalidation};
@@ -60,14 +60,12 @@ export declare function bulkSyncOrigins(database: ContentLayerDatabase, items: r
60
60
  fallbackRoutes?: BulkSyncFallbackRoutes;
61
61
  }): Promise<void>;
62
62
  /**
63
- * Revision-capture options. `trackedKeys` holds the entity keys whose
64
- * files match the revisions include globs; `capture` is the run flag
65
- * (build/CLI on, dev watch off).
63
+ * The revision snapshots a capturing run cuts: `trackedKeys` holds the entity keys whose
64
+ * files match the revisions include globs. Absent when the run captures none.
66
65
  */
67
66
  export type EntityUpsertRevisionsOptions = {
68
67
  max: number;
69
68
  trackedKeys: ReadonlySet<string>;
70
- capture: boolean;
71
69
  };
72
70
  /**
73
71
  * Upserts entity descriptors (deduped by key, last-wins), generating ids for