@antelopejs/dms-api 0.1.7 → 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 +2 -6
  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,180 @@
1
+ import { describe, expect, it } from 'vitest'
2
+ import {
3
+ cachedDateFormat,
4
+ type DateFormat,
5
+ durationParts,
6
+ formatDecimal,
7
+ formatClock,
8
+ formatFullDateTime,
9
+ formatMs,
10
+ formatPercent,
11
+ formatRelativeDay,
12
+ formatThreshold,
13
+ spanPart,
14
+ } from '../app/utils/format'
15
+
16
+ // What the blocks pass, the DMS's regional formatter, without preferences.
17
+ const formatIn = (locale: string, extra: Intl.DateTimeFormatOptions = {}) =>
18
+ cachedDateFormat(
19
+ (options) => new Intl.DateTimeFormat(locale, { ...options, ...extra }),
20
+ )
21
+ const en: DateFormat = formatIn('en-GB')
22
+ const fr: DateFormat = formatIn('fr-FR')
23
+
24
+ // Intl writes French spaces as narrow no-break ones: compare on plain spaces.
25
+ const plain = (text: string) => text.replace(/[  ]/g, ' ')
26
+
27
+ describe('formatPercent', () => {
28
+ it('writes a percentage the way the locale does', () => {
29
+ expect(formatPercent(11.44, 'en-GB')).toBe('11.4%')
30
+ expect(plain(formatPercent(11.44, 'fr-FR'))).toBe('11,4 %')
31
+ })
32
+
33
+ it('keeps two decimals under 1 %, so a small rate does not read as zero', () => {
34
+ expect(formatPercent(0.04, 'en-GB')).toBe('0.04%')
35
+ expect(formatPercent(0, 'en-GB')).toBe('0%')
36
+ })
37
+ })
38
+
39
+ describe('spanPart', () => {
40
+ const MINUTE = 60_000
41
+
42
+ it('names a window in one unit, hours up to two days', () => {
43
+ expect(spanPart(15 * MINUTE)).toEqual({ amount: 15, unit: 'min' })
44
+ expect(spanPart(24 * 60 * MINUTE)).toEqual({ amount: 24, unit: 'h' })
45
+ expect(spanPart(7 * 24 * 60 * MINUTE)).toEqual({ amount: 7, unit: 'd' })
46
+ })
47
+ })
48
+
49
+ describe('formatDecimal', () => {
50
+ it('keeps one decimal under 10, none above', () => {
51
+ expect(formatDecimal(4.25, 'en-GB')).toBe('4.3')
52
+ expect(formatDecimal(1250.4, 'en-GB')).toBe('1,250')
53
+ })
54
+ })
55
+
56
+ describe('formatRelativeDay', () => {
57
+ const now = new Date(2026, 9, 10, 18, 0)
58
+
59
+ it('gives the time alone today', () => {
60
+ expect(formatRelativeDay(new Date(2026, 9, 10, 17, 33), en, now)).toBe(
61
+ '17:33',
62
+ )
63
+ })
64
+
65
+ it('names yesterday in the interface language', () => {
66
+ const date = new Date(2026, 9, 9, 17, 33)
67
+ expect(formatRelativeDay(date, en, now)).toBe('yesterday 17:33')
68
+ expect(formatRelativeDay(date, fr, now)).toBe('hier 17:33')
69
+ })
70
+
71
+ it('names the weekday within the week', () => {
72
+ // 10 October 2026 is a Saturday.
73
+ expect(formatRelativeDay(new Date(2026, 9, 5, 9, 5), en, now)).toBe(
74
+ 'Mon 09:05',
75
+ )
76
+ })
77
+
78
+ it('gives the date before, with the year when it is not this one', () => {
79
+ expect(formatRelativeDay(new Date(2026, 8, 28, 9, 5), en, now)).toBe(
80
+ '28 Sept, 09:05',
81
+ )
82
+ expect(formatRelativeDay(new Date(2025, 8, 28, 9, 5), en, now)).toBe(
83
+ '28 Sept 2025, 09:05',
84
+ )
85
+ })
86
+
87
+ it('is empty without a date', () => {
88
+ expect(formatRelativeDay(null, en, now)).toBe('')
89
+ expect(formatRelativeDay('not a date', en, now)).toBe('')
90
+ })
91
+ })
92
+
93
+ describe('formatFullDateTime', () => {
94
+ it('writes the whole date, for a tooltip', () => {
95
+ const text = formatFullDateTime(new Date(2026, 9, 9, 17, 33), en)
96
+ expect(text).toContain('9 October 2026')
97
+ expect(text).toContain('17:33')
98
+ })
99
+ })
100
+
101
+ describe('durationParts', () => {
102
+ const MINUTE = 60_000
103
+ const HOUR = 60 * MINUTE
104
+
105
+ it('keeps the two largest units, rounded down', () => {
106
+ expect(durationParts(45_400)).toEqual([{ amount: 45, unit: 's' }])
107
+ expect(durationParts(38 * MINUTE + 59_000)).toEqual([
108
+ { amount: 38, unit: 'min' },
109
+ ])
110
+ expect(durationParts(2 * HOUR + 5 * MINUTE)).toEqual([
111
+ { amount: 2, unit: 'h' },
112
+ { amount: 5, unit: 'min' },
113
+ ])
114
+ expect(durationParts(3 * 24 * HOUR + 4 * HOUR + 10 * MINUTE)).toEqual([
115
+ { amount: 3, unit: 'd' },
116
+ { amount: 4, unit: 'h' },
117
+ ])
118
+ })
119
+
120
+ it('drops a second unit at zero', () => {
121
+ expect(durationParts(2 * HOUR)).toEqual([{ amount: 2, unit: 'h' }])
122
+ expect(durationParts(24 * HOUR)).toEqual([{ amount: 1, unit: 'd' }])
123
+ })
124
+
125
+ it('never goes below zero', () => {
126
+ expect(durationParts(-5000)).toEqual([{ amount: 0, unit: 's' }])
127
+ })
128
+ })
129
+
130
+ describe('formatMs', () => {
131
+ it('writes ms, seconds from 10 s, and "< 1 ms" under a millisecond', () => {
132
+ expect(formatMs(0, 'en-GB')).toBe('0 ms')
133
+ expect(formatMs(0.4, 'en-GB')).toBe('< 1 ms')
134
+ expect(formatMs(1840, 'en-GB')).toBe('1,840 ms')
135
+ expect(formatMs(12_400, 'en-GB')).toBe('12.4 s')
136
+ expect(plain(formatMs(12_400, 'fr-FR'))).toBe('12,4 s')
137
+ })
138
+ })
139
+
140
+ describe('formatThreshold', () => {
141
+ it('writes a threshold in ms under a second, in seconds from one', () => {
142
+ expect(formatThreshold(800, 'en-GB')).toBe('800 ms')
143
+ expect(formatThreshold(1000, 'en-GB')).toBe('1 s')
144
+ expect(formatThreshold(1500, 'en-GB')).toBe('1.5 s')
145
+ expect(formatThreshold(2000, 'en-GB')).toBe('2 s')
146
+ expect(plain(formatThreshold(1500, 'fr-FR'))).toBe('1,5 s')
147
+ })
148
+ })
149
+
150
+ describe('one clock for the console', () => {
151
+ it('writes every time on 24 hours unless the user asks otherwise', () => {
152
+ const evening = new Date(2026, 9, 10, 20, 45, 7)
153
+ const british = formatIn('en-GB')
154
+ expect(formatFullDateTime(evening, british)).toContain('20:45')
155
+ expect(formatFullDateTime(evening, british)).not.toMatch(/PM/i)
156
+ expect(formatClock(evening, british, false, evening)).toBe('20:45:07')
157
+ expect(
158
+ formatRelativeDay(new Date(2026, 9, 10, 0, 5), british, evening),
159
+ ).toBe('00:05')
160
+ // A 12-hour clock chosen in Language & region.
161
+ const twelve = formatIn('en-GB', { hourCycle: 'h12' })
162
+ expect(formatClock(evening, twelve, false, evening)).toMatch(/pm/i)
163
+ })
164
+
165
+ it("names the day in the user's time zone", () => {
166
+ const utc = formatIn('en-GB', { timeZone: 'UTC' })
167
+ const tokyo = formatIn('en-GB', { timeZone: 'Asia/Tokyo' })
168
+ const now = new Date('2026-10-10T12:00:00Z')
169
+ // 20:00 UTC on the 10th is already the 11th in Tokyo, 05:00.
170
+ const late = new Date('2026-10-10T20:00:00Z')
171
+ expect(formatRelativeDay(late, utc, now)).toBe('20:00')
172
+ expect(
173
+ formatRelativeDay(late, tokyo, new Date('2026-10-11T03:00:00Z')),
174
+ ).toBe('05:00')
175
+ // 20:00 UTC on the 8th: the day before in Tokyo, two days in UTC.
176
+ const earlier = new Date('2026-10-08T20:00:00Z')
177
+ expect(formatRelativeDay(earlier, tokyo, now)).toBe('yesterday 05:00')
178
+ expect(formatRelativeDay(earlier, utc, now)).toBe('Thu 20:00')
179
+ })
180
+ })
@@ -0,0 +1,61 @@
1
+ import { describe, expect, it } from 'vitest'
2
+ import {
3
+ acceptsRequestBody,
4
+ isWritingMethod,
5
+ methodTone,
6
+ parseRouteRef,
7
+ pathSegments,
8
+ startsWithRequestBody,
9
+ statusClassOf,
10
+ statusText,
11
+ statusTone,
12
+ } from '../app/utils/http'
13
+
14
+ describe('http', () => {
15
+ it('gives every method one tone', () => {
16
+ expect(methodTone('get')).toBe('info')
17
+ expect(methodTone('POST')).toBe('success')
18
+ expect(methodTone('PATCH')).toBe('warning')
19
+ expect(methodTone('DELETE')).toBe('error')
20
+ expect(methodTone('OPTIONS')).toBe('neutral')
21
+ })
22
+
23
+ it('tints a status by its class', () => {
24
+ expect(statusClassOf(201)).toBe('2xx')
25
+ expect(statusTone(304)).toBe('info')
26
+ expect(statusTone('422')).toBe('warning')
27
+ expect(statusTone(500)).toBe('error')
28
+ expect(statusTone(0)).toBe('neutral')
29
+ expect(statusText(201)).toBe('Created')
30
+ })
31
+
32
+ it('knows which calls change data', () => {
33
+ expect(isWritingMethod('get')).toBe(false)
34
+ expect(isWritingMethod('delete')).toBe(true)
35
+ })
36
+
37
+ it('knows which calls carry a body, and which start with one', () => {
38
+ expect(acceptsRequestBody('get')).toBe(false)
39
+ expect(acceptsRequestBody('HEAD')).toBe(false)
40
+ expect(acceptsRequestBody('DELETE')).toBe(true)
41
+ expect(startsWithRequestBody('post')).toBe(true)
42
+ expect(startsWithRequestBody('DELETE')).toBe(false)
43
+ expect(startsWithRequestBody('GET')).toBe(false)
44
+ })
45
+
46
+ it('splits a path on its params', () => {
47
+ expect(pathSegments('/api/orders/:id/refund')).toEqual([
48
+ { text: '/api/orders/', param: false },
49
+ { text: ':id', param: true },
50
+ { text: '/refund', param: false },
51
+ ])
52
+ })
53
+
54
+ it('reads a route reference', () => {
55
+ expect(parseRouteRef('patch /api/orders/:id')).toEqual({
56
+ method: 'PATCH',
57
+ path: '/api/orders/:id',
58
+ })
59
+ expect(parseRouteRef('nope')).toBeNull()
60
+ })
61
+ })
@@ -0,0 +1,255 @@
1
+ import { describe, expect, it } from 'vitest'
2
+ import {
3
+ bodyLimit,
4
+ clearedLogsFilters,
5
+ hasLogsFilters,
6
+ isAllTime,
7
+ isRouteRef,
8
+ linkedPeriod,
9
+ logsEmptyCause,
10
+ readLogsFilters,
11
+ routeMethod,
12
+ windowPreset,
13
+ withLogsFilters,
14
+ type LogsPeriod,
15
+ } from '../app/utils/logsQuery'
16
+
17
+ const lastDay: LogsPeriod = { preset: 'last-24h', range: null }
18
+ const allTime: LogsPeriod = { preset: 'all', range: null }
19
+ const incident = {
20
+ from: new Date('2026-10-10T18:31:00.000Z'),
21
+ to: new Date('2026-10-10T18:46:00.000Z'),
22
+ }
23
+ const customPeriod: LogsPeriod = { preset: 'custom', range: incident }
24
+
25
+ describe('readLogsFilters', () => {
26
+ it('reads the filters a link or the page wrote', () => {
27
+ expect(
28
+ readLogsFilters({
29
+ 'api.period': 'last-24h',
30
+ method: 'POST',
31
+ slow: 'true',
32
+ route: 'POST /webhooks/stripe',
33
+ error: 'boom',
34
+ from: 'overview',
35
+ }),
36
+ ).toEqual({
37
+ method: 'POST',
38
+ slow: true,
39
+ route: 'POST /webhooks/stripe',
40
+ path: undefined,
41
+ error: 'boom',
42
+ from: 'overview',
43
+ })
44
+ })
45
+
46
+ it('leaves out what the table would not apply', () => {
47
+ expect(
48
+ readLogsFilters({
49
+ method: 'post',
50
+ slow: '1',
51
+ from: 'x',
52
+ }),
53
+ ).toEqual({
54
+ method: undefined,
55
+ slow: false,
56
+ route: undefined,
57
+ path: undefined,
58
+ error: undefined,
59
+ from: undefined,
60
+ })
61
+ })
62
+
63
+ it('takes the first of repeated values', () => {
64
+ expect(readLogsFilters({ method: ['GET', 'POST'] }).method).toBe('GET')
65
+ })
66
+ })
67
+
68
+ describe('the period', () => {
69
+ it('tells "All time", a custom range and a preset apart', () => {
70
+ expect(isAllTime(allTime)).toBe(true)
71
+ expect(isAllTime(null)).toBe(false)
72
+ expect(windowPreset(lastDay)).toBe('last-24h')
73
+ expect(windowPreset(allTime)).toBeUndefined()
74
+ expect(windowPreset(customPeriod)).toBeUndefined()
75
+ expect(windowPreset(null)).toBeUndefined()
76
+ })
77
+
78
+ it('carries a preset on a link to the request logs, nothing else', () => {
79
+ expect(linkedPeriod(lastDay)).toEqual({ 'api.period': 'last-24h' })
80
+ expect(linkedPeriod(customPeriod)).toEqual({})
81
+ expect(linkedPeriod(null)).toEqual({})
82
+ })
83
+ })
84
+
85
+ describe('withLogsFilters', () => {
86
+ it('sets and removes filters, keeping the rest of the query', () => {
87
+ expect(
88
+ withLogsFilters(
89
+ {
90
+ 'requests.tab': '5xx',
91
+ record: 'r1',
92
+ 'api.period': 'last-hour',
93
+ method: 'GET',
94
+ },
95
+ { allTime: true, method: null, slow: true },
96
+ ),
97
+ ).toEqual({
98
+ 'requests.tab': '5xx',
99
+ record: 'r1',
100
+ 'api.period': 'all',
101
+ slow: 'true',
102
+ })
103
+ })
104
+
105
+ it('forgets the origin once all time is asked for', () => {
106
+ expect(
107
+ withLogsFilters(
108
+ { route: 'GET /a', 'api.period': 'last-24h', from: 'overview' },
109
+ { allTime: true },
110
+ ),
111
+ ).toEqual({ route: 'GET /a', 'api.period': 'all' })
112
+ })
113
+
114
+ it('forgets the origin with the last linked filter', () => {
115
+ expect(
116
+ withLogsFilters(
117
+ { route: 'GET /a', error: 'boom', from: 'routes' },
118
+ { route: null },
119
+ ),
120
+ ).toEqual({ error: 'boom', from: 'routes' })
121
+ expect(
122
+ withLogsFilters({ error: 'boom', from: 'routes' }, { error: null }),
123
+ ).toEqual({})
124
+ })
125
+
126
+ it('clears every filter, not the tab nor the period', () => {
127
+ expect(
128
+ clearedLogsFilters({
129
+ 'api.period': 'last-24h',
130
+ method: 'GET',
131
+ slow: 'true',
132
+ route: 'GET /a',
133
+ error: 'boom',
134
+ from: 'overview',
135
+ 'requests.tab': '4xx',
136
+ }),
137
+ ).toEqual({ 'requests.tab': '4xx', 'api.period': 'last-24h' })
138
+ })
139
+ })
140
+
141
+ describe('routeMethod', () => {
142
+ it('reads the method a route reference fixes', () => {
143
+ expect(routeMethod('post /webhooks/stripe')).toBe('POST')
144
+ expect(routeMethod('garbage')).toBeUndefined()
145
+ expect(routeMethod(undefined)).toBeUndefined()
146
+ })
147
+ })
148
+
149
+ describe('logsEmptyCause', () => {
150
+ const none = readLogsFilters({})
151
+
152
+ it('names the most specific cause', () => {
153
+ expect(logsEmptyCause('error', 'x', none, lastDay)).toBe('error')
154
+ expect(
155
+ logsEmptyCause(
156
+ 'filtered',
157
+ 'zzzz',
158
+ readLogsFilters({ route: 'GET /a' }),
159
+ lastDay,
160
+ ),
161
+ ).toBe('search')
162
+ // The DMS says first run: the URL's filters are not its own.
163
+ expect(
164
+ logsEmptyCause(
165
+ 'firstRun',
166
+ '',
167
+ readLogsFilters({ route: 'GET /a' }),
168
+ allTime,
169
+ ),
170
+ ).toBe('link')
171
+ // A period frames the rows, the one the selector applies included.
172
+ expect(logsEmptyCause('firstRun', ' ', none, lastDay)).toBe('filters')
173
+ expect(logsEmptyCause('firstRun', undefined, none, allTime)).toBe(
174
+ 'first-run',
175
+ )
176
+ })
177
+ })
178
+
179
+ describe('bodyLimit', () => {
180
+ it('does not round a small limit down to 0 KB', () => {
181
+ expect(bodyLimit(0)).toEqual({ unit: 'none', amount: 0 })
182
+ expect(bodyLimit(300)).toEqual({ unit: 'b', amount: 300 })
183
+ expect(bodyLimit(65_536)).toEqual({ unit: 'kb', amount: 64 })
184
+ expect(bodyLimit(1_536)).toEqual({ unit: 'kb', amount: 1.5 })
185
+ })
186
+ })
187
+
188
+ describe('incident range', () => {
189
+ const query = {
190
+ route: 'GET /a',
191
+ since: incident.from.toISOString(),
192
+ until: incident.to.toISOString(),
193
+ 'api.period': 'last-7-days',
194
+ from: 'overview',
195
+ 'requests.tab': '5xx',
196
+ }
197
+
198
+ it('reads a range from both bounds, as a linked filter', () => {
199
+ expect(readLogsFilters(query).incident).toEqual(incident)
200
+ expect(readLogsFilters({ since: query.since }).incident).toBeUndefined()
201
+ expect(
202
+ readLogsFilters({ since: 'soon', until: query.until }).incident,
203
+ ).toBeUndefined()
204
+ })
205
+
206
+ it('removes the range alone, the period kept', () => {
207
+ expect(withLogsFilters(query, { incident: null })).toEqual({
208
+ route: 'GET /a',
209
+ 'api.period': 'last-7-days',
210
+ from: 'overview',
211
+ 'requests.tab': '5xx',
212
+ })
213
+ expect(withLogsFilters(query, { allTime: true })).toEqual({
214
+ route: 'GET /a',
215
+ since: query.since,
216
+ until: query.until,
217
+ 'api.period': 'all',
218
+ 'requests.tab': '5xx',
219
+ })
220
+ })
221
+
222
+ it('clears with the other filters', () => {
223
+ expect(clearedLogsFilters(query)).toEqual({
224
+ 'api.period': 'last-7-days',
225
+ 'requests.tab': '5xx',
226
+ })
227
+ })
228
+
229
+ it('keeps the origin while the range alone is left', () => {
230
+ expect(withLogsFilters(query, { route: null })).toMatchObject({
231
+ since: query.since,
232
+ from: 'overview',
233
+ })
234
+ })
235
+
236
+ it('counts as a link filter for the empty state', () => {
237
+ const filters = readLogsFilters(query)
238
+ expect(logsEmptyCause('firstRun', '', filters, lastDay)).toBe('link')
239
+ expect(hasLogsFilters(readLogsFilters({ ...query, route: '' }))).toBe(true)
240
+ })
241
+ })
242
+
243
+ describe('the filters to clear', () => {
244
+ it('leave the period out', () => {
245
+ expect(hasLogsFilters(readLogsFilters({ 'api.period': 'all' }))).toBe(false)
246
+ expect(hasLogsFilters(readLogsFilters({ slow: 'true' }))).toBe(true)
247
+ })
248
+ })
249
+
250
+ describe('route chips', () => {
251
+ it('tells a route reference from anything else', () => {
252
+ expect(isRouteRef('GET /api/orders')).toBe(true)
253
+ expect(isRouteRef('garbage')).toBe(false)
254
+ })
255
+ })
@@ -0,0 +1,94 @@
1
+ import { describe, expect, it } from 'vitest'
2
+ import {
3
+ axisTicks,
4
+ liveStatus,
5
+ minuteBars,
6
+ peakBar,
7
+ scaleCeiling,
8
+ } from '../app/utils/minuteHistogram'
9
+
10
+ const MINUTE = 60_000
11
+ const START = Date.UTC(2026, 9, 10, 16, 40)
12
+
13
+ function bucket(index: number, success: number, client = 0, server = 0) {
14
+ return {
15
+ start: START + index * MINUTE,
16
+ success,
17
+ clientErrors: client,
18
+ serverErrors: server,
19
+ }
20
+ }
21
+
22
+ describe('scaleCeiling', () => {
23
+ it('follows the busiest minute of ordinary traffic', () => {
24
+ expect(scaleCeiling([0, 10, 12, 14, 0])).toBe(14)
25
+ })
26
+
27
+ it('cuts a spike that would crush the other minutes', () => {
28
+ const totals = [...Array.from({ length: 59 }, () => 12), 125]
29
+ expect(scaleCeiling(totals)).toBe(24)
30
+ })
31
+
32
+ it('ignores empty minutes', () => {
33
+ expect(scaleCeiling([0, 0, 0, 3])).toBe(3)
34
+ expect(scaleCeiling([0, 0])).toBe(0)
35
+ })
36
+ })
37
+
38
+ describe('minuteBars', () => {
39
+ const buckets = [
40
+ ...Array.from({ length: 58 }, (_, index) => bucket(index, 10, 1, 1)),
41
+ bucket(58, 0),
42
+ bucket(59, 100, 0, 25),
43
+ ]
44
+ const { bars, ceiling, clipped } = minuteBars(
45
+ buckets,
46
+ new Date(START + 59 * MINUTE + 20_000).toISOString(),
47
+ )
48
+
49
+ it('cuts the spike and says so', () => {
50
+ expect(ceiling).toBe(24)
51
+ expect(clipped).toBe(true)
52
+ expect(bars[59].clipped).toBe(true)
53
+ const heights = bars[59].heights
54
+ expect(
55
+ heights.success + heights.clientErrors + heights.serverErrors,
56
+ ).toBeCloseTo(100)
57
+ // Each class keeps its share of the cut bar.
58
+ expect(heights.serverErrors).toBeCloseTo(20)
59
+ })
60
+
61
+ it('stacks an ordinary minute on the scale', () => {
62
+ expect(bars[0].total).toBe(12)
63
+ expect(bars[0].heights.success).toBeCloseTo((10 / 24) * 100)
64
+ expect(bars[0].clipped).toBe(false)
65
+ })
66
+
67
+ it('draws nothing for an empty minute', () => {
68
+ expect(bars[58].heights).toEqual({
69
+ success: 0,
70
+ clientErrors: 0,
71
+ serverErrors: 0,
72
+ })
73
+ })
74
+
75
+ it('marks the minute still running', () => {
76
+ expect(bars.filter((bar) => bar.current).map((bar) => bar.start)).toEqual([
77
+ START + 59 * MINUTE,
78
+ ])
79
+ })
80
+
81
+ it('finds the busiest minute and the axis ticks', () => {
82
+ expect(peakBar(bars)?.start).toBe(START + 59 * MINUTE)
83
+ expect(axisTicks(bars)).toEqual([0, 29, 59])
84
+ expect(peakBar(minuteBars([bucket(0, 0)]).bars)).toBeUndefined()
85
+ })
86
+ })
87
+
88
+ describe('live indicator', () => {
89
+ it('says reconnecting from the first failure, paused whatever failed', () => {
90
+ expect(liveStatus(true, 0)).toBe('live')
91
+ expect(liveStatus(true, 1)).toBe('reconnecting')
92
+ expect(liveStatus(false, 4)).toBe('paused')
93
+ })
94
+ })
@@ -1,8 +1,12 @@
1
1
  import { expect, it, vi } from 'vitest'
2
2
  import frontendModule from '../dms.frontend'
3
3
 
4
- it('registers API dashboard components without leaking internal paths into their names', async () => {
4
+ vi.mock('../app/plugins/displays', () => ({ default: () => {} }))
5
+
6
+ it('registers the blocks the backend pages name, and nothing else', async () => {
5
7
  const registerComponent = vi.fn()
8
+ const registerPlugin = vi.fn()
9
+ const registerMiddleware = vi.fn()
6
10
  await frontendModule.setup({
7
11
  options: { public: {} },
8
12
  registerComponent,
@@ -10,19 +14,32 @@ it('registers API dashboard components without leaking internal paths into their
10
14
  registerDynamicPage: vi.fn(),
11
15
  registerLayout: vi.fn(),
12
16
  registerErrorPage: vi.fn(),
13
- registerPlugin: vi.fn(),
14
- registerMiddleware: vi.fn(),
17
+ registerPlugin,
18
+ registerMiddleware,
15
19
  provide: vi.fn(),
16
20
  use: vi.fn(),
17
21
  })
22
+ expect(frontendModule.componentPrefix).toBe('DmsApi')
18
23
  const names = registerComponent.mock.calls.map(([name]) => name)
19
24
  expect(names).toEqual(
20
25
  expect.arrayContaining([
21
- 'DmsApiSummaryView',
22
- 'DmsApiTesterPanel',
23
- 'DmsApiPeriodSelect',
26
+ 'LiveTraffic',
27
+ 'LogsEmptyState',
28
+ 'LogsFilters',
29
+ 'RequestDetail',
30
+ 'RouteTree',
31
+ 'RouteHeader',
32
+ 'RouteDocumentation',
33
+ 'RouteTester',
34
+ 'ScopeChip',
35
+ 'SplitLayout',
24
36
  ]),
25
37
  )
38
+ expect(names).not.toContain('ApiMethodBadge')
26
39
  expect(new Set(names).size).toBe(names.length)
27
- expect(names).not.toContain('DmsApiInternalPeriodSelect')
40
+ // Universal: the cell displays draw in the server render too.
41
+ expect(registerPlugin).toHaveBeenCalledTimes(1)
42
+ expect(registerPlugin.mock.calls[0]?.[1]).toEqual({ clientOnly: false })
43
+ // The side panel and its URL are the DMS's: no middleware.
44
+ expect(registerMiddleware).not.toHaveBeenCalled()
28
45
  })