@antelopejs/dms-api 0.1.6 → 0.2.0

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 (347) hide show
  1. package/README.md +99 -8
  2. package/dist/automation/get-api-health.js +4 -3
  3. package/dist/automation/get-api-health.js.map +1 -1
  4. package/dist/automation/route-unhealthy.js +2 -2
  5. package/dist/automation/route-unhealthy.js.map +1 -1
  6. package/dist/automation/scope.d.ts +0 -1
  7. package/dist/automation/scope.js +0 -7
  8. package/dist/automation/scope.js.map +1 -1
  9. package/dist/config.d.ts +4 -0
  10. package/dist/config.js +15 -9
  11. package/dist/config.js.map +1 -1
  12. package/dist/db/models/request_log.model.d.ts +37 -2
  13. package/dist/db/models/request_log.model.js +130 -35
  14. package/dist/db/models/request_log.model.js.map +1 -1
  15. package/dist/db/models/request_log.search.d.ts +5 -0
  16. package/dist/db/models/request_log.search.js +35 -0
  17. package/dist/db/models/request_log.search.js.map +1 -0
  18. package/dist/db/models/request_log.status.d.ts +5 -0
  19. package/dist/db/models/request_log.status.js +9 -0
  20. package/dist/db/models/request_log.status.js.map +1 -0
  21. package/dist/db/models/routes.model.d.ts +1 -0
  22. package/dist/db/models/routes.model.js +5 -1
  23. package/dist/db/models/routes.model.js.map +1 -1
  24. package/dist/db/models/routes_statistics.model.js +1 -1
  25. package/dist/db/models/routes_statistics.model.js.map +1 -1
  26. package/dist/db/tables/api_settings.table.d.ts +1 -0
  27. package/dist/db/tables/api_settings.table.js +4 -0
  28. package/dist/db/tables/api_settings.table.js.map +1 -1
  29. package/dist/db/tables/request_log.table.d.ts +18 -3
  30. package/dist/db/tables/request_log.table.js +34 -1
  31. package/dist/db/tables/request_log.table.js.map +1 -1
  32. package/dist/db/tables/routes.table.d.ts +1 -2
  33. package/dist/db/tables/routes.table.js.map +1 -1
  34. package/dist/db/tables/routes_statistics.table.d.ts +4 -3
  35. package/dist/db/tables/routes_statistics.table.js +5 -1
  36. package/dist/db/tables/routes_statistics.table.js.map +1 -1
  37. package/dist/index.d.ts +1 -1
  38. package/dist/index.js +9 -1
  39. package/dist/index.js.map +1 -1
  40. package/dist/memo.d.ts +5 -0
  41. package/dist/memo.js +36 -0
  42. package/dist/memo.js.map +1 -0
  43. package/dist/pages/blocks.d.ts +3 -0
  44. package/dist/pages/blocks.js +31 -0
  45. package/dist/pages/blocks.js.map +1 -0
  46. package/dist/pages/displays.d.ts +7 -0
  47. package/dist/pages/displays.js +23 -0
  48. package/dist/pages/displays.js.map +1 -0
  49. package/dist/pages/index.d.ts +5 -2
  50. package/dist/pages/index.js +5 -2
  51. package/dist/pages/index.js.map +1 -1
  52. package/dist/pages/logs.d.ts +18 -0
  53. package/dist/pages/logs.js +112 -0
  54. package/dist/pages/logs.js.map +1 -0
  55. package/dist/pages/module.d.ts +3 -0
  56. package/dist/pages/module.js +102 -6
  57. package/dist/pages/module.js.map +1 -1
  58. package/dist/pages/overview.d.ts +14 -0
  59. package/dist/pages/overview.js +215 -0
  60. package/dist/pages/overview.js.map +1 -0
  61. package/dist/pages/period.d.ts +9 -0
  62. package/dist/pages/period.js +24 -0
  63. package/dist/pages/period.js.map +1 -0
  64. package/dist/pages/request-table.d.ts +11 -0
  65. package/dist/pages/request-table.js +187 -0
  66. package/dist/pages/request-table.js.map +1 -0
  67. package/dist/pages/routes.d.ts +15 -0
  68. package/dist/pages/routes.js +269 -0
  69. package/dist/pages/routes.js.map +1 -0
  70. package/dist/pages/scope-chip.d.ts +9 -0
  71. package/dist/pages/scope-chip.js +28 -0
  72. package/dist/pages/scope-chip.js.map +1 -0
  73. package/dist/pages/{logs/page.d.ts → settings.d.ts} +3 -3
  74. package/dist/pages/settings.js +218 -0
  75. package/dist/pages/settings.js.map +1 -0
  76. package/dist/pages/toolbar.d.ts +9 -0
  77. package/dist/pages/toolbar.js +33 -0
  78. package/dist/pages/toolbar.js.map +1 -0
  79. package/dist/realtime.d.ts +2 -0
  80. package/dist/realtime.js +21 -0
  81. package/dist/realtime.js.map +1 -0
  82. package/dist/routes/index.d.ts +2 -2
  83. package/dist/routes/index.js +2 -2
  84. package/dist/routes/index.js.map +1 -1
  85. package/dist/routes/logs.d.ts +173 -2
  86. package/dist/routes/logs.js +177 -86
  87. package/dist/routes/logs.js.map +1 -1
  88. package/dist/routes/overview.d.ts +27 -0
  89. package/dist/routes/overview.js +131 -0
  90. package/dist/routes/overview.js.map +1 -0
  91. package/dist/routes/routes.d.ts +92 -28
  92. package/dist/routes/routes.js +165 -97
  93. package/dist/routes/routes.js.map +1 -1
  94. package/dist/routes/settings.d.ts +16 -11
  95. package/dist/routes/settings.js +62 -54
  96. package/dist/routes/settings.js.map +1 -1
  97. package/dist/routes/tester.d.ts +7 -0
  98. package/dist/routes/tester.js +34 -0
  99. package/dist/routes/tester.js.map +1 -0
  100. package/dist/services/activity.d.ts +49 -0
  101. package/dist/services/activity.js +207 -0
  102. package/dist/services/activity.js.map +1 -0
  103. package/dist/services/aggregate-cache.d.ts +3 -0
  104. package/dist/services/aggregate-cache.js +16 -0
  105. package/dist/services/aggregate-cache.js.map +1 -0
  106. package/dist/services/api-origin.d.ts +1 -0
  107. package/dist/services/api-origin.js +9 -0
  108. package/dist/services/api-origin.js.map +1 -0
  109. package/dist/services/attention.d.ts +45 -0
  110. package/dist/services/attention.js +203 -0
  111. package/dist/services/attention.js.map +1 -0
  112. package/dist/services/composed-text.d.ts +6 -0
  113. package/dist/services/composed-text.js +23 -0
  114. package/dist/services/composed-text.js.map +1 -0
  115. package/dist/services/health-rules.d.ts +49 -0
  116. package/dist/services/health-rules.js +233 -0
  117. package/dist/services/health-rules.js.map +1 -0
  118. package/dist/services/index.d.ts +1 -3
  119. package/dist/services/index.js +3 -3
  120. package/dist/services/index.js.map +1 -1
  121. package/dist/services/introspection/decorators.d.ts +14 -0
  122. package/dist/services/introspection/decorators.js +192 -0
  123. package/dist/services/introspection/decorators.js.map +1 -0
  124. package/dist/services/introspection/errors.js +4 -4
  125. package/dist/services/introspection/errors.js.map +1 -1
  126. package/dist/services/introspection/index.d.ts +6 -8
  127. package/dist/services/introspection/index.js +96 -32
  128. package/dist/services/introspection/index.js.map +1 -1
  129. package/dist/services/introspection/probe.d.ts +2 -1
  130. package/dist/services/introspection/probe.js +11 -0
  131. package/dist/services/introspection/probe.js.map +1 -1
  132. package/dist/services/links.d.ts +25 -0
  133. package/dist/services/links.js +72 -0
  134. package/dist/services/links.js.map +1 -0
  135. package/dist/services/live-feed.d.ts +6 -0
  136. package/dist/services/live-feed.js +18 -0
  137. package/dist/services/live-feed.js.map +1 -0
  138. package/dist/services/live.d.ts +16 -0
  139. package/dist/services/live.js +32 -0
  140. package/dist/services/live.js.map +1 -0
  141. package/dist/services/overview.d.ts +122 -0
  142. package/dist/services/overview.js +324 -0
  143. package/dist/services/overview.js.map +1 -0
  144. package/dist/services/period.d.ts +0 -9
  145. package/dist/services/period.js +5 -52
  146. package/dist/services/period.js.map +1 -1
  147. package/dist/services/request-log/access.d.ts +5 -0
  148. package/dist/services/request-log/access.js +21 -0
  149. package/dist/services/request-log/access.js.map +1 -0
  150. package/dist/services/request-log/capture.d.ts +30 -0
  151. package/dist/services/request-log/capture.js +216 -39
  152. package/dist/services/request-log/capture.js.map +1 -1
  153. package/dist/services/request-log/list.d.ts +36 -0
  154. package/dist/services/request-log/list.js +201 -0
  155. package/dist/services/request-log/list.js.map +1 -0
  156. package/dist/services/request-log/read.d.ts +15 -2
  157. package/dist/services/request-log/read.js +47 -4
  158. package/dist/services/request-log/read.js.map +1 -1
  159. package/dist/services/request-log/redaction.d.ts +16 -3
  160. package/dist/services/request-log/redaction.js +149 -27
  161. package/dist/services/request-log/redaction.js.map +1 -1
  162. package/dist/services/request-log/util.d.ts +10 -3
  163. package/dist/services/request-log/util.js +39 -22
  164. package/dist/services/request-log/util.js.map +1 -1
  165. package/dist/services/route-catalog.d.ts +62 -0
  166. package/dist/services/route-catalog.js +163 -0
  167. package/dist/services/route-catalog.js.map +1 -0
  168. package/dist/services/route-contract.d.ts +66 -0
  169. package/dist/services/route-contract.js +266 -0
  170. package/dist/services/route-contract.js.map +1 -0
  171. package/dist/services/route-health.d.ts +35 -0
  172. package/dist/services/route-health.js +179 -0
  173. package/dist/services/route-health.js.map +1 -0
  174. package/dist/services/route-statistics.d.ts +68 -0
  175. package/dist/services/route-statistics.js +277 -0
  176. package/dist/services/route-statistics.js.map +1 -0
  177. package/dist/services/routes-sync.d.ts +7 -3
  178. package/dist/services/routes-sync.js +96 -20
  179. package/dist/services/routes-sync.js.map +1 -1
  180. package/dist/services/scope.d.ts +0 -1
  181. package/dist/services/scope.js +4 -17
  182. package/dist/services/scope.js.map +1 -1
  183. package/dist/services/settings-form.d.ts +131 -0
  184. package/dist/services/settings-form.js +210 -0
  185. package/dist/services/settings-form.js.map +1 -0
  186. package/dist/services/settings.d.ts +2 -0
  187. package/dist/services/settings.js +5 -0
  188. package/dist/services/settings.js.map +1 -1
  189. package/dist/services/statistics-aggregate.d.ts +6 -41
  190. package/dist/services/statistics-aggregate.js +55 -280
  191. package/dist/services/statistics-aggregate.js.map +1 -1
  192. package/dist/services/statistics-utils.d.ts +7 -12
  193. package/dist/services/statistics-utils.js +36 -51
  194. package/dist/services/statistics-utils.js.map +1 -1
  195. package/dist/services/statistics-write.js +64 -22
  196. package/dist/services/statistics-write.js.map +1 -1
  197. package/dist/services/tester-source.d.ts +11 -0
  198. package/dist/services/tester-source.js +48 -0
  199. package/dist/services/tester-source.js.map +1 -0
  200. package/dist/services/traffic-samples.d.ts +18 -0
  201. package/dist/services/traffic-samples.js +134 -0
  202. package/dist/services/traffic-samples.js.map +1 -0
  203. package/dist/services/traffic.d.ts +43 -0
  204. package/dist/services/traffic.js +270 -0
  205. package/dist/services/traffic.js.map +1 -0
  206. package/dist/services/window.d.ts +48 -0
  207. package/dist/services/window.js +179 -0
  208. package/dist/services/window.js.map +1 -0
  209. package/dist/types/constants.d.ts +11 -20
  210. package/dist/types/constants.js +15 -25
  211. package/dist/types/constants.js.map +1 -1
  212. package/dist/types/index.d.ts +0 -1
  213. package/dist/types/index.js +0 -1
  214. package/dist/types/index.js.map +1 -1
  215. package/dist/types/statistics.d.ts +5 -3
  216. package/dist/types/statistics.js +5 -0
  217. package/dist/types/statistics.js.map +1 -1
  218. package/frontend-vue/app/components/blocks/BetaBadge.vue +20 -0
  219. package/frontend-vue/app/components/blocks/HealthHero.vue +708 -0
  220. package/frontend-vue/app/components/blocks/LiveTraffic.vue +356 -0
  221. package/frontend-vue/app/components/blocks/LogsEmptyState.vue +228 -0
  222. package/frontend-vue/app/components/blocks/LogsFilters.vue +279 -0
  223. package/frontend-vue/app/components/blocks/RequestDetail.vue +722 -0
  224. package/frontend-vue/app/components/blocks/RetentionInput.vue +227 -0
  225. package/frontend-vue/app/components/blocks/RouteDocumentation.vue +611 -0
  226. package/frontend-vue/app/components/blocks/RouteHeader.vue +320 -0
  227. package/frontend-vue/app/components/blocks/RouteTester.vue +1879 -0
  228. package/frontend-vue/app/components/blocks/RouteTree.vue +676 -0
  229. package/frontend-vue/app/components/blocks/ScopeChip.vue +89 -0
  230. package/frontend-vue/app/components/blocks/SettingNumberInput.vue +65 -0
  231. package/frontend-vue/app/components/blocks/SplitLayout.vue +41 -0
  232. package/frontend-vue/app/components/internal/ApiBody.vue +129 -0
  233. package/frontend-vue/app/components/internal/ApiJsonTree.vue +82 -0
  234. package/frontend-vue/app/components/internal/ApiKeyValues.vue +41 -0
  235. package/frontend-vue/app/components/internal/ApiMethodBadge.vue +19 -19
  236. package/frontend-vue/app/components/internal/ApiPath.vue +33 -0
  237. package/frontend-vue/app/components/internal/ApiStatusBadge.vue +20 -15
  238. package/frontend-vue/app/components/internal/ApiTesterBadge.vue +17 -0
  239. package/frontend-vue/app/composables/useApiOrigin.ts +19 -0
  240. package/frontend-vue/app/composables/useApiPeriod.ts +19 -0
  241. package/frontend-vue/app/composables/useApiResource.ts +92 -0
  242. package/frontend-vue/app/composables/useDateFormat.ts +23 -0
  243. package/frontend-vue/app/composables/useLiveMissedErrors.ts +33 -0
  244. package/frontend-vue/app/composables/useRouteDetail.ts +253 -0
  245. package/frontend-vue/app/composables/useRouteSelection.ts +43 -0
  246. package/frontend-vue/app/config/shortcuts-registry.ts +30 -0
  247. package/frontend-vue/app/plugins/displays.ts +92 -0
  248. package/frontend-vue/app/utils/format.ts +281 -0
  249. package/frontend-vue/app/utils/http.ts +127 -0
  250. package/frontend-vue/app/utils/logsQuery.ts +261 -0
  251. package/frontend-vue/app/utils/minuteHistogram.ts +116 -0
  252. package/frontend-vue/app/utils/requestDrawer.ts +257 -0
  253. package/frontend-vue/app/utils/routeExplorer.ts +206 -0
  254. package/frontend-vue/app/utils/search.ts +45 -0
  255. package/frontend-vue/app/utils/settingsForm.ts +119 -0
  256. package/frontend-vue/app/utils/snippets.ts +501 -0
  257. package/frontend-vue/app/utils/testerHistory.ts +354 -0
  258. package/frontend-vue/app/utils/testerRequest.ts +632 -11
  259. package/frontend-vue/dms.frontend.build.ts +7 -0
  260. package/frontend-vue/dms.frontend.ts +10 -3
  261. package/frontend-vue/i18n/locales/api-en-GB.json +866 -0
  262. package/frontend-vue/i18n/locales/api-fr-FR.json +866 -0
  263. package/frontend-vue/package.json +4 -5
  264. package/frontend-vue/pnpm-lock.yaml +97 -3375
  265. package/frontend-vue/tests/format.test.ts +180 -0
  266. package/frontend-vue/tests/http.test.ts +61 -0
  267. package/frontend-vue/tests/logsQuery.test.ts +255 -0
  268. package/frontend-vue/tests/minuteHistogram.test.ts +94 -0
  269. package/frontend-vue/tests/registration.test.ts +24 -7
  270. package/frontend-vue/tests/requestDrawer.test.ts +179 -0
  271. package/frontend-vue/tests/routeExplorer.test.ts +206 -0
  272. package/frontend-vue/tests/settingsForm.test.ts +155 -0
  273. package/frontend-vue/tests/snippets.test.ts +285 -0
  274. package/frontend-vue/tests/testerHistory.test.ts +295 -0
  275. package/frontend-vue/tests/testerRequest.test.ts +471 -76
  276. package/frontend-vue/tests/tooltipTriggers.test.ts +51 -0
  277. package/package.json +8 -8
  278. package/dist/middlewares/index.d.ts +0 -1
  279. package/dist/middlewares/index.js +0 -18
  280. package/dist/middlewares/index.js.map +0 -1
  281. package/dist/middlewares/request-log-capture.d.ts +0 -1
  282. package/dist/middlewares/request-log-capture.js +0 -6
  283. package/dist/middlewares/request-log-capture.js.map +0 -1
  284. package/dist/pages/all.d.ts +0 -4
  285. package/dist/pages/all.js +0 -21
  286. package/dist/pages/all.js.map +0 -1
  287. package/dist/pages/logs/page.js +0 -29
  288. package/dist/pages/logs/page.js.map +0 -1
  289. package/dist/pages/routes/page.d.ts +0 -9
  290. package/dist/pages/routes/page.js +0 -29
  291. package/dist/pages/routes/page.js.map +0 -1
  292. package/dist/pages/settings/form.d.ts +0 -3
  293. package/dist/pages/settings/form.js +0 -80
  294. package/dist/pages/settings/form.js.map +0 -1
  295. package/dist/pages/settings/page.d.ts +0 -9
  296. package/dist/pages/settings/page.js +0 -26
  297. package/dist/pages/settings/page.js.map +0 -1
  298. package/dist/pages/summary/page.d.ts +0 -9
  299. package/dist/pages/summary/page.js +0 -29
  300. package/dist/pages/summary/page.js.map +0 -1
  301. package/dist/routes/monitoring.d.ts +0 -17
  302. package/dist/routes/monitoring.js +0 -101
  303. package/dist/routes/monitoring.js.map +0 -1
  304. package/dist/routes/summary.d.ts +0 -32
  305. package/dist/routes/summary.js +0 -181
  306. package/dist/routes/summary.js.map +0 -1
  307. package/dist/services/request-log/index.d.ts +0 -3
  308. package/dist/services/request-log/index.js +0 -12
  309. package/dist/services/request-log/index.js.map +0 -1
  310. package/dist/services/statistics-read.d.ts +0 -4
  311. package/dist/services/statistics-read.js +0 -48
  312. package/dist/services/statistics-read.js.map +0 -1
  313. package/dist/services/tree.d.ts +0 -10
  314. package/dist/services/tree.js +0 -128
  315. package/dist/services/tree.js.map +0 -1
  316. package/dist/types/charts.d.ts +0 -9
  317. package/dist/types/charts.js +0 -3
  318. package/dist/types/charts.js.map +0 -1
  319. package/frontend-vue/app/components/ConfigurationView.vue +0 -187
  320. package/frontend-vue/app/components/DocumentationView.vue +0 -224
  321. package/frontend-vue/app/components/LogDetailDrawer.vue +0 -178
  322. package/frontend-vue/app/components/LogsView.vue +0 -347
  323. package/frontend-vue/app/components/RouteDetailTabs.vue +0 -179
  324. package/frontend-vue/app/components/RouteTree.vue +0 -196
  325. package/frontend-vue/app/components/RoutesView.vue +0 -79
  326. package/frontend-vue/app/components/StatsView.vue +0 -268
  327. package/frontend-vue/app/components/SummaryView.vue +0 -657
  328. package/frontend-vue/app/components/TesterPanel.vue +0 -499
  329. package/frontend-vue/app/components/internal/PeriodSelect.vue +0 -58
  330. package/frontend-vue/app/components/internal/RouteTreeNode.vue +0 -168
  331. package/frontend-vue/app/components/internal/StatusBreakdownBars.vue +0 -162
  332. package/frontend-vue/app/components/internal/StatusDonut.vue +0 -84
  333. package/frontend-vue/app/components/internal/UnitAreaChart.vue +0 -73
  334. package/frontend-vue/app/composables/useApiIntrospection.ts +0 -350
  335. package/frontend-vue/app/composables/useLogDetailDrawer.ts +0 -50
  336. package/frontend-vue/app/composables/useSelectedPeriod.ts +0 -107
  337. package/frontend-vue/app/composables/useStatsPeriods.ts +0 -139
  338. package/frontend-vue/app/custom-layouts/.gitkeep +0 -0
  339. package/frontend-vue/app/custom-pages/.gitkeep +0 -0
  340. package/frontend-vue/app/utils/httpMethod.ts +0 -49
  341. package/frontend-vue/app/utils/statusClass.ts +0 -49
  342. package/frontend-vue/i18n/locales/en-GB.json +0 -240
  343. package/frontend-vue/i18n/locales/fr-FR.json +0 -240
  344. package/frontend-vue/public/.gitkeep +0 -0
  345. package/frontend-vue/server/.gitkeep +0 -0
  346. package/frontend-vue/tests/periods.test.ts +0 -145
  347. package/frontend-vue/tests/persistence.test.ts +0 -45
@@ -0,0 +1,676 @@
1
+ <script setup lang="ts">
2
+ import { computed, nextTick, onBeforeUnmount, onMounted, ref, watch } from 'vue'
3
+ import { formatCount } from '../../utils/format'
4
+ import {
5
+ bySeverity,
6
+ groupRoutes,
7
+ initialRoute,
8
+ lastRoute,
9
+ listedFolders,
10
+ needsAttention,
11
+ optionId,
12
+ rememberRoute,
13
+ type RouteState,
14
+ stepFrom,
15
+ windowParts,
16
+ } from '../../utils/routeExplorer'
17
+ import { closestMatch } from '../../utils/search'
18
+ import ApiMethodBadge from '../internal/ApiMethodBadge.vue'
19
+ import ApiPath from '../internal/ApiPath.vue'
20
+
21
+ // Every route in scope, grouped by folder, with its traffic and health over
22
+ // the health window the list states. The selection is the page's `?route=`,
23
+ // so the rest of the page follows it and it survives a reload.
24
+ defineOptions({ inheritAttrs: false })
25
+
26
+ const props = withDefaults(
27
+ defineProps<{
28
+ fetchUrl: string
29
+ queryKey?: string
30
+ /** The live feed (`LIVE_REQUESTS_TOPIC`): the list is read again on it. */
31
+ realtimeTopic?: string
32
+ /**
33
+ * Anchor of the route's header (`RouteHeader`), its key path on the
34
+ * page: a route chosen on a phone, where the detail sits below the list,
35
+ * brings it into view.
36
+ */
37
+ detailBlock?: string
38
+ }>(),
39
+ {
40
+ queryKey: 'route',
41
+ },
42
+ )
43
+
44
+ interface RouteRow {
45
+ ref: string
46
+ method: string
47
+ path: string
48
+ folder: string
49
+ controller: string | null
50
+ handler: string
51
+ requests: number
52
+ state: RouteState
53
+ }
54
+
55
+ const METHOD_FILTERS = ['GET', 'POST', 'PUT', 'PATCH', 'DELETE']
56
+ /** A shape per issue, so slow and a high 4xx rate never read alike. */
57
+ const STATE_ICON: Partial<Record<RouteState, { name: string; class: string }>> =
58
+ {
59
+ failing: { name: 'i-ph-x-circle-fill', class: 'text-error' },
60
+ slow: { name: 'i-ph-timer-bold', class: 'text-warning' },
61
+ 'client-errors': { name: 'i-ph-warning-fill', class: 'text-warning' },
62
+ recovered: {
63
+ name: 'i-ph-arrow-counter-clockwise-bold',
64
+ class: 'text-info',
65
+ },
66
+ }
67
+ const STATE_DOT: Record<RouteState, string> = {
68
+ failing: 'bg-error',
69
+ slow: 'bg-warning',
70
+ 'client-errors': 'bg-warning',
71
+ recovered: 'bg-info',
72
+ healthy: 'bg-success',
73
+ idle: 'bg-(--ui-border-accented)',
74
+ }
75
+ /** Rest after the last ↑ / ↓ before the page loads the route reached. */
76
+ const KEYBOARD_SETTLE_MS = 150
77
+ const REVEAL_MARGIN_PX = 8
78
+
79
+ const { t } = useI18n()
80
+ const { formatLocale: locale, formatNumber } = useRegionalFormat({
81
+ locale: 'format',
82
+ })
83
+ const selection = useRouteSelection(props.queryKey)
84
+ const { data, error, pending, refresh } = useApiResource<{
85
+ routes: RouteRow[]
86
+ /** Minutes of traffic each state is judged on. */
87
+ healthWindowMinutes?: number
88
+ /** Minutes of traffic each request count covers. */
89
+ requestsWindowMinutes?: number
90
+ }>(() => props.fetchUrl)
91
+
92
+ // Live, the states and counts are read again in place, at the page's pace:
93
+ // the list keeps its order, its scroll and the focus.
94
+ usePageLiveRefresh(() => void refresh(), { realtimeTopic: props.realtimeTopic })
95
+
96
+ const search = ref('')
97
+ const method = ref('all')
98
+ const onlyAttention = ref(false)
99
+ const hideIdle = ref(false)
100
+ const collapsed = ref<Set<string>>(new Set())
101
+ // Open while nothing is selected; once a route is, the stacked layout folds
102
+ // the list to its header so the detail comes first.
103
+ const listOpen = ref(!selection.ref.value)
104
+ /** The route the keyboard asked for, until the page has loaded it. */
105
+ const cursor = ref<string | null>(null)
106
+ let settle: ReturnType<typeof setTimeout> | null = null
107
+ const searchInput = ref<{ inputRef?: HTMLInputElement } | null>(null)
108
+ const scroller = ref<HTMLElement | null>(null)
109
+ const tree = ref<HTMLElement | null>(null)
110
+ /** The fold toggle, shown only while the list sits above the detail. */
111
+ const foldToggle = ref<HTMLButtonElement | null>(null)
112
+
113
+ const routes = computed(() => data.value?.routes ?? [])
114
+ const attentionCount = computed(
115
+ () => routes.value.filter(needsAttention).length,
116
+ )
117
+ const idleCount = computed(
118
+ () => routes.value.filter((route) => route.state === 'idle').length,
119
+ )
120
+ const indexOf = computed(
121
+ () => new Map(routes.value.map((route, index) => [route.ref, index])),
122
+ )
123
+ const folderOf = computed(() => listedFolders(routes.value))
124
+
125
+ /** The listed route the URL names. */
126
+ const selected = computed(() => {
127
+ const current = selection.ref.value
128
+ if (!current) return null
129
+ return routes.value.find((route) => route.ref === current) ?? null
130
+ })
131
+ const active = computed(() => cursor.value ?? selected.value?.ref ?? null)
132
+ const activeId = computed(() => {
133
+ const index = active.value ? indexOf.value.get(active.value) : undefined
134
+ return index === undefined ? undefined : optionId(index)
135
+ })
136
+
137
+ function windowLabel(minutes: number | undefined) {
138
+ if (!minutes) return null
139
+ const { unit, amount } = windowParts(minutes)
140
+ return t(`api.routes.window.${unit}`, { amount })
141
+ }
142
+ const healthWindow = computed(() =>
143
+ windowLabel(data.value?.healthWindowMinutes),
144
+ )
145
+ const requestsWindow = computed(() =>
146
+ windowLabel(data.value?.requestsWindowMinutes),
147
+ )
148
+
149
+ const methodItems = computed(() => [
150
+ { label: t('api.routes.tree.all'), value: 'all' },
151
+ ...METHOD_FILTERS.map((value) => ({
152
+ label: value === 'DELETE' ? 'DEL' : value,
153
+ value,
154
+ })),
155
+ ])
156
+
157
+ const visible = computed(() => {
158
+ const needle = search.value.trim().toLowerCase()
159
+ return routes.value.filter(
160
+ (route) =>
161
+ (method.value === 'all' || route.method === method.value) &&
162
+ (!onlyAttention.value || needsAttention(route)) &&
163
+ (!hideIdle.value || route.state !== 'idle') &&
164
+ (!needle ||
165
+ route.path.toLowerCase().includes(needle) ||
166
+ route.handler.toLowerCase().includes(needle) ||
167
+ (route.controller ?? '').toLowerCase().includes(needle)),
168
+ )
169
+ })
170
+
171
+ // Needing attention, the list is flat and worst first, like the Overview.
172
+ const flatMode = computed(() => onlyAttention.value)
173
+ const folders = computed(() => groupRoutes(visible.value, folderOf.value))
174
+ const flat = computed(() =>
175
+ flatMode.value
176
+ ? bySeverity(visible.value)
177
+ : folders.value.flatMap((folder) =>
178
+ collapsed.value.has(folder.path) ? [] : folder.routes,
179
+ ),
180
+ )
181
+ /** What the list draws: its folders, or one flat run worst first. */
182
+ const sections = computed(() =>
183
+ flatMode.value
184
+ ? [{ path: null, routes: flat.value, worst: 'idle' as RouteState }]
185
+ : folders.value,
186
+ )
187
+ const allCollapsed = computed(
188
+ () =>
189
+ folders.value.length > 0 &&
190
+ folders.value.every((folder) => collapsed.value.has(folder.path)),
191
+ )
192
+
193
+ const suggestion = computed(() =>
194
+ search.value.trim() && visible.value.length === 0
195
+ ? closestMatch(
196
+ search.value.trim(),
197
+ routes.value.map((route) => route.path),
198
+ )
199
+ : null,
200
+ )
201
+
202
+ function stateLabel(state: RouteState) {
203
+ return t(`api.routes.state.${state.replace('-', '_')}`)
204
+ }
205
+
206
+ function requestsLabel(route: RouteRow) {
207
+ const count = formatCount(route.requests, locale.value)
208
+ return requestsWindow.value
209
+ ? t('api.routes.tree.requests_window', {
210
+ count,
211
+ window: requestsWindow.value,
212
+ })
213
+ : t('api.routes.tree.requests', { count })
214
+ }
215
+
216
+ function toggleFolder(path: string) {
217
+ const next = new Set(collapsed.value)
218
+ if (next.has(path)) next.delete(path)
219
+ else next.add(path)
220
+ collapsed.value = next
221
+ }
222
+
223
+ function toggleAll() {
224
+ collapsed.value = allCollapsed.value
225
+ ? new Set()
226
+ : new Set(folders.value.map((folder) => folder.path))
227
+ }
228
+
229
+ function stopSettling() {
230
+ if (settle) clearTimeout(settle)
231
+ settle = null
232
+ }
233
+
234
+ /**
235
+ * Scrolls the list, and only the list, until the active route shows: to the
236
+ * nearest edge as the keyboard walks, in the middle on arrival so the route
237
+ * reads with what surrounds it.
238
+ */
239
+ function revealActive(center = false) {
240
+ const container = scroller.value
241
+ if (!container || !active.value) return
242
+ const row = container.querySelector<HTMLElement>(
243
+ `[data-route="${CSS.escape(active.value)}"]`,
244
+ )
245
+ if (!row) return
246
+ const top = row.offsetTop
247
+ const bottom = top + row.offsetHeight
248
+ const above = top < container.scrollTop
249
+ const below = bottom > container.scrollTop + container.clientHeight
250
+ if (!above && !below) return
251
+ if (center) {
252
+ container.scrollTop = top - (container.clientHeight - row.offsetHeight) / 2
253
+ } else if (above) {
254
+ container.scrollTop = top - REVEAL_MARGIN_PX
255
+ } else {
256
+ container.scrollTop = bottom - container.clientHeight + REVEAL_MARGIN_PX
257
+ }
258
+ }
259
+
260
+ /** A route clicked: a history entry, and on a phone the detail comes up. */
261
+ async function choose(route: RouteRow) {
262
+ stopSettling()
263
+ cursor.value = null
264
+ await selection.select(route.ref)
265
+ // Beside the detail the list stays; stacked above it, it folds away.
266
+ if (!foldToggle.value?.checkVisibility()) return
267
+ listOpen.value = false
268
+ if (!props.detailBlock) return
269
+ await nextTick()
270
+ scrollToBlock(props.detailBlock, { block: 'start', behavior: 'smooth' })
271
+ }
272
+
273
+ /**
274
+ * ↑ / ↓ walk the list at once and load the route reached once the keys rest,
275
+ * replacing the history entry: Back then leaves the page.
276
+ */
277
+ async function move(step: number) {
278
+ const next = stepFrom(flat.value, active.value, step)
279
+ if (!next) return
280
+ cursor.value = next.ref
281
+ await nextTick()
282
+ revealActive()
283
+ stopSettling()
284
+ settle = setTimeout(() => {
285
+ settle = null
286
+ void selection.select(next.ref, { replace: true })
287
+ }, KEYBOARD_SETTLE_MS)
288
+ }
289
+
290
+ function clearFilters() {
291
+ search.value = ''
292
+ method.value = 'all'
293
+ onlyAttention.value = false
294
+ hideIdle.value = false
295
+ }
296
+
297
+ // "/" opens the filter, as the request logs open their search; listed on
298
+ // the DMS Shortcuts page (`app/config/shortcuts-registry.ts`). Like every
299
+ // `defineShortcuts` key, it does not fire while the user types in a field.
300
+ defineShortcuts({
301
+ '/': () => {
302
+ listOpen.value = true
303
+ void nextTick(() => searchInput.value?.inputRef?.focus())
304
+ },
305
+ })
306
+
307
+ function onListKey(event: KeyboardEvent) {
308
+ const length = flat.value.length
309
+ const steps: Record<string, number> = {
310
+ ArrowDown: 1,
311
+ ArrowUp: -1,
312
+ Home: -length,
313
+ End: length,
314
+ }
315
+ const step = steps[event.key]
316
+ if (step === undefined) return
317
+ event.preventDefault()
318
+ void move(step)
319
+ }
320
+
321
+ /** ↓ from the filter goes down into the list; Enter opens the first match. */
322
+ function onSearchKey(event: KeyboardEvent) {
323
+ if (event.key === 'ArrowDown') {
324
+ event.preventDefault()
325
+ tree.value?.focus()
326
+ void move(1)
327
+ } else if (event.key === 'Enter' && flat.value[0]) {
328
+ event.preventDefault()
329
+ void choose(flat.value[0])
330
+ }
331
+ }
332
+
333
+ onBeforeUnmount(stopSettling)
334
+
335
+ // A page opened without a route shows the last one looked at in this tab,
336
+ // else the one needing a look first, without a history entry of its own,
337
+ // over the module's last period.
338
+ watch(
339
+ routes,
340
+ (all) => {
341
+ if (selection.ref.value || all.length === 0) return
342
+ const first = initialRoute(all, lastRoute())
343
+ if (first) void selection.select(first.ref, { replace: true })
344
+ },
345
+ { immediate: true },
346
+ )
347
+
348
+ watch(selection.ref, (current) => {
349
+ if (!settle) cursor.value = null
350
+ if (current) rememberRoute(current)
351
+ })
352
+
353
+ // The selected route is never hidden: its folder opens and the list
354
+ // scrolls to it, on arrival as on a link followed.
355
+ watch(
356
+ [() => selected.value?.ref, () => routes.value.length],
357
+ async ([current]) => {
358
+ if (!current) return
359
+ const folder = folderOf.value.get(current)
360
+ if (!flatMode.value && folder && collapsed.value.has(folder))
361
+ toggleFolder(folder)
362
+ await nextTick()
363
+ revealActive(true)
364
+ },
365
+ { flush: 'post' },
366
+ )
367
+ onMounted(() => {
368
+ if (selection.ref.value) rememberRoute(selection.ref.value)
369
+ // Once the list is laid out.
370
+ void nextTick(() => revealActive(true))
371
+ })
372
+
373
+ const count = (value: number) =>
374
+ formatNumber(value, { notation: 'compact', maximumFractionDigits: 1 })
375
+ </script>
376
+
377
+ <template>
378
+ <DmsCard
379
+ :padded="false"
380
+ class="flex flex-col overflow-hidden @5xl:max-h-[calc(100dvh-2rem)] @5xl:min-h-[24rem]"
381
+ >
382
+ <!-- Stacked above the detail, the list folds to the route it shows. -->
383
+ <button
384
+ ref="foldToggle"
385
+ type="button"
386
+ class="hover:bg-elevated flex items-center gap-2 px-3 py-2.5 text-left text-[13px] @5xl:hidden"
387
+ :aria-expanded="listOpen"
388
+ aria-controls="api-route-list"
389
+ @click="listOpen = !listOpen"
390
+ >
391
+ <UIcon name="i-ph-tree-structure" class="text-muted size-4 shrink-0" />
392
+ <template v-if="selected">
393
+ <ApiMethodBadge :method="selected.method" size="sm" />
394
+ <ApiPath :path="selected.path" class="grow" />
395
+ </template>
396
+ <span v-else class="text-default grow">
397
+ {{ t('api.routes.tree.label') }}
398
+ </span>
399
+ <span class="text-dimmed font-mono text-[11px] tabular-nums">
400
+ {{ formatCount(routes.length, locale) }}
401
+ </span>
402
+ <UIcon
403
+ :name="listOpen ? 'i-ph-caret-up' : 'i-ph-caret-down'"
404
+ class="text-muted size-3.5 shrink-0"
405
+ />
406
+ </button>
407
+
408
+ <div
409
+ id="api-route-list"
410
+ class="border-default flex min-h-0 flex-1 flex-col @max-5xl:border-t"
411
+ :class="!listOpen && '@max-5xl:hidden'"
412
+ >
413
+ <div class="border-default flex flex-col gap-2.5 border-b p-3">
414
+ <UInput
415
+ ref="searchInput"
416
+ v-model="search"
417
+ icon="i-ph-magnifying-glass"
418
+ size="sm"
419
+ :placeholder="t('api.routes.tree.search')"
420
+ :aria-label="t('api.routes.tree.search')"
421
+ @keydown="onSearchKey"
422
+ >
423
+ <template #trailing>
424
+ <UKbd value="/" />
425
+ </template>
426
+ </UInput>
427
+ <DmsSegmented
428
+ v-model="method"
429
+ :items="methodItems"
430
+ size="sm"
431
+ variant="mono"
432
+ block
433
+ :aria-label="t('api.routes.tree.method')"
434
+ />
435
+ <label
436
+ class="text-muted flex cursor-pointer items-center gap-2 text-[13px]"
437
+ >
438
+ <USwitch v-model="onlyAttention" size="sm" />
439
+ <span class="grow">{{ t('api.routes.tree.only_attention') }}</span>
440
+ <DmsStatusPill
441
+ v-if="attentionCount"
442
+ tone="warning"
443
+ :label="String(attentionCount)"
444
+ dot="none"
445
+ size="sm"
446
+ />
447
+ </label>
448
+ <label
449
+ class="text-muted flex cursor-pointer items-center gap-2 text-[13px]"
450
+ >
451
+ <USwitch v-model="hideIdle" size="sm" />
452
+ <span class="grow">{{ t('api.routes.tree.hide_idle') }}</span>
453
+ <span
454
+ v-if="idleCount"
455
+ class="text-dimmed font-mono text-[11px] tabular-nums"
456
+ >
457
+ {{ formatCount(idleCount, locale) }}
458
+ </span>
459
+ </label>
460
+ </div>
461
+
462
+ <div
463
+ ref="scroller"
464
+ class="relative min-h-0 flex-1 overflow-y-auto py-1.5 @max-5xl:max-h-[50vh]"
465
+ >
466
+ <p
467
+ v-if="healthWindow && routes.length"
468
+ class="text-dimmed px-3 pb-1.5 pt-0.5 font-mono text-[11px]"
469
+ >
470
+ {{ t('api.routes.tree.window', { window: healthWindow }) }}
471
+ </p>
472
+ <div v-if="pending" class="flex flex-col gap-2 px-3 py-2">
473
+ <USkeleton v-for="index in 8" :key="index" class="h-6 w-full" />
474
+ </div>
475
+ <DmsEmptyState
476
+ v-else-if="error && !data"
477
+ size="sm"
478
+ variant="error"
479
+ :title="t('api.routes.tree.error')"
480
+ :actions="[
481
+ { label: t('api.common.retry'), onClick: () => refresh() },
482
+ ]"
483
+ />
484
+ <DmsEmptyState
485
+ v-else-if="routes.length === 0"
486
+ size="sm"
487
+ :title="t('api.routes.tree.empty_title')"
488
+ :description="t('api.routes.tree.empty_description')"
489
+ />
490
+ <DmsEmptyState
491
+ v-else-if="visible.length === 0"
492
+ size="sm"
493
+ variant="no-result"
494
+ :title="
495
+ search.trim()
496
+ ? t('api.routes.tree.no_match', { search: search.trim() })
497
+ : t('api.routes.tree.no_match_filters')
498
+ "
499
+ :actions="[
500
+ {
501
+ label: t('api.routes.tree.clear'),
502
+ color: 'neutral',
503
+ variant: 'outline',
504
+ onClick: clearFilters,
505
+ },
506
+ ]"
507
+ >
508
+ <p v-if="suggestion" class="text-muted text-sm">
509
+ {{ t('api.routes.tree.did_you_mean') }}
510
+ <button
511
+ type="button"
512
+ class="text-primary font-mono hover:underline"
513
+ @click="search = suggestion"
514
+ >
515
+ {{ suggestion }}
516
+ </button>
517
+ </p>
518
+ </DmsEmptyState>
519
+
520
+ <!-- One focus stop: ↑ / ↓ move the active route
521
+ (aria-activedescendant), a click opens it. -->
522
+ <div
523
+ v-else
524
+ ref="tree"
525
+ role="tree"
526
+ tabindex="0"
527
+ class="focus:outline-none"
528
+ :aria-label="t('api.routes.tree.label')"
529
+ :aria-activedescendant="activeId"
530
+ @keydown="onListKey"
531
+ >
532
+ <div
533
+ v-for="section in sections"
534
+ :key="section.path ?? ''"
535
+ :role="section.path ? 'treeitem' : 'none'"
536
+ :aria-level="section.path ? 1 : undefined"
537
+ :aria-expanded="
538
+ section.path ? !collapsed.has(section.path) : undefined
539
+ "
540
+ :aria-label="section.path ?? undefined"
541
+ class="mb-1"
542
+ >
543
+ <div
544
+ v-if="section.path"
545
+ class="text-muted hover:text-default flex w-full cursor-pointer select-none items-center gap-1.5 px-3 py-1.5 font-mono text-[12px]"
546
+ @click="toggleFolder(section.path)"
547
+ >
548
+ <UIcon
549
+ :name="
550
+ collapsed.has(section.path)
551
+ ? 'i-ph-caret-right'
552
+ : 'i-ph-caret-down'
553
+ "
554
+ class="size-3 shrink-0"
555
+ />
556
+ <span class="truncate">{{ section.path }}</span>
557
+ <UIcon
558
+ v-if="STATE_ICON[section.worst]"
559
+ :name="STATE_ICON[section.worst]!.name"
560
+ :class="STATE_ICON[section.worst]!.class"
561
+ class="size-3 shrink-0"
562
+ role="img"
563
+ :aria-label="stateLabel(section.worst)"
564
+ />
565
+ <span class="grow" />
566
+ <span
567
+ class="text-dimmed tabular-nums"
568
+ :title="
569
+ t('api.routes.tree.folder_routes', section.routes.length)
570
+ "
571
+ >
572
+ {{ section.routes.length }}
573
+ </span>
574
+ </div>
575
+ <div
576
+ v-if="!section.path || !collapsed.has(section.path)"
577
+ :role="section.path ? 'group' : 'none'"
578
+ >
579
+ <div
580
+ v-for="route in section.routes"
581
+ :id="optionId(indexOf.get(route.ref) ?? 0)"
582
+ :key="route.ref"
583
+ role="treeitem"
584
+ :aria-level="section.path ? 2 : 1"
585
+ :aria-selected="route.ref === active"
586
+ :data-route="route.ref"
587
+ class="group mx-1.5 flex cursor-pointer items-center gap-2 rounded-md border px-2 py-1.5 text-[12.5px] transition-colors"
588
+ :class="
589
+ route.ref === active
590
+ ? 'border-primary/60 bg-primary/10 text-highlighted'
591
+ : 'hover:bg-elevated text-default border-transparent'
592
+ "
593
+ @click="choose(route)"
594
+ >
595
+ <ApiMethodBadge :method="route.method" size="sm" />
596
+ <ApiPath
597
+ :path="route.path"
598
+ :prefix="section.path ?? ''"
599
+ class="grow"
600
+ />
601
+ <span
602
+ class="text-dimmed font-mono text-[11px] tabular-nums"
603
+ :title="requestsLabel(route)"
604
+ >
605
+ {{ count(route.requests) }}
606
+ </span>
607
+ <UIcon
608
+ v-if="STATE_ICON[route.state]"
609
+ :name="STATE_ICON[route.state]!.name"
610
+ :class="STATE_ICON[route.state]!.class"
611
+ class="size-3.5 shrink-0"
612
+ role="img"
613
+ :aria-label="stateLabel(route.state)"
614
+ />
615
+ <span
616
+ v-else
617
+ class="mx-1 size-1.5 shrink-0 rounded-full"
618
+ :class="STATE_DOT[route.state]"
619
+ role="img"
620
+ :aria-label="stateLabel(route.state)"
621
+ />
622
+ </div>
623
+ </div>
624
+ </div>
625
+ </div>
626
+ </div>
627
+
628
+ <div
629
+ class="border-default text-dimmed flex items-center gap-2 border-t px-3 py-2 font-mono text-[11px]"
630
+ >
631
+ <!-- The count wraps rather than being cut: the toggle beside it is an
632
+ icon, its name in a tooltip, so the line usually holds it all. -->
633
+ <span class="min-w-0">
634
+ {{
635
+ t(
636
+ flatMode
637
+ ? 'api.routes.tree.footer_flat'
638
+ : 'api.routes.tree.footer',
639
+ {
640
+ shown: formatCount(visible.length, locale),
641
+ total: formatCount(routes.length, locale),
642
+ folders: folders.length,
643
+ },
644
+ )
645
+ }}
646
+ </span>
647
+ <span class="grow" />
648
+ <UTooltip
649
+ v-if="!flatMode && folders.length > 1"
650
+ :text="
651
+ allCollapsed
652
+ ? t('api.routes.tree.expand_all')
653
+ : t('api.routes.tree.collapse_all')
654
+ "
655
+ >
656
+ <UButton
657
+ size="xs"
658
+ color="neutral"
659
+ variant="ghost"
660
+ square
661
+ class="shrink-0"
662
+ :icon="allCollapsed ? 'i-ph-caret-up-down' : 'i-ph-caret-line-up'"
663
+ :aria-label="
664
+ allCollapsed
665
+ ? t('api.routes.tree.expand_all')
666
+ : t('api.routes.tree.collapse_all')
667
+ "
668
+ @click="toggleAll"
669
+ />
670
+ </UTooltip>
671
+ <UKbd value="↑" size="sm" class="shrink-0 @max-5xl:hidden" />
672
+ <UKbd value="↓" size="sm" class="shrink-0 @max-5xl:hidden" />
673
+ </div>
674
+ </div>
675
+ </DmsCard>
676
+ </template>