@underpostnet/cyberia 3.2.90 → 3.3.73

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 (490) hide show
  1. package/.dockerignore +1 -0
  2. package/.env.example +16 -0
  3. package/.github/workflows/coverall.cyberia.ci.yml +107 -0
  4. package/.github/workflows/cyberia-client.cd.yml +6 -18
  5. package/.github/workflows/cyberia-server.cd.yml +6 -18
  6. package/.github/workflows/docker-image.cyberia-client.ci.yml +8 -5
  7. package/.github/workflows/docker-image.cyberia-client.dev.ci.yml +8 -3
  8. package/.github/workflows/docker-image.cyberia-server.ci.yml +8 -5
  9. package/.github/workflows/docker-image.cyberia-server.dev.ci.yml +8 -5
  10. package/.github/workflows/docker-image.engine-cyberia.ci.yml +15 -1
  11. package/.github/workflows/docker-image.engine-cyberia.dev.ci.yml +15 -1
  12. package/.github/workflows/engine-cyberia.cd.yml +6 -78
  13. package/.github/workflows/engine-cyberia.ci.yml +4 -5
  14. package/.github/workflows/ghpkg.ci.yml +42 -21
  15. package/.github/workflows/hardhat.ci.yml +12 -11
  16. package/.github/workflows/npmpkg.ci.yml +17 -15
  17. package/.github/workflows/pwa-microservices-template-page.cd.yml +1 -16
  18. package/.github/workflows/pwa-microservices-template-test.ci.yml +2 -2
  19. package/.github/workflows/release.cd.yml +2 -9
  20. package/.prettierignore +1 -0
  21. package/AGENTS.md +47 -0
  22. package/CHANGELOG.md +581 -2417
  23. package/CLI-HELP.md +416 -127
  24. package/Dockerfile +25 -9
  25. package/Dockerfile.dev +25 -9
  26. package/Dockerfile.test +4 -4
  27. package/README.md +21 -1
  28. package/bin/build.js +70 -43
  29. package/bin/build.template.js +8 -3
  30. package/bin/cyberia.js +372 -135
  31. package/bin/deploy.js +18 -104
  32. package/bin/index.js +372 -135
  33. package/compose.env +16 -0
  34. package/conf.js +93 -4
  35. package/deploy/cyberia-client/deploy.sh +47 -0
  36. package/deploy/cyberia-client/package.sh +18 -0
  37. package/deploy/cyberia-client/state.sh +14 -0
  38. package/deploy/cyberia-server/deploy.sh +47 -0
  39. package/deploy/cyberia-server/package.sh +18 -0
  40. package/deploy/cyberia-server/state.sh +14 -0
  41. package/deploy/dd-cyberia/deploy.sh +22 -0
  42. package/deploy/dd-cyberia/init.sh +55 -0
  43. package/deploy/dd-cyberia/package.sh +17 -0
  44. package/deploy/dd-cyberia/state.sh +14 -0
  45. package/deploy/dd-cyberia/sync-deploy.sh +116 -0
  46. package/deploy/lib/github-actions-logging.sh +594 -0
  47. package/deploy/lib/host.sh +185 -0
  48. package/deploy/lib/state.sh +62 -0
  49. package/deploy/pwa-microservices-template/deploy.sh +45 -0
  50. package/deploy/release/deploy.sh +32 -0
  51. package/deployment.yaml +7 -2
  52. package/docker-compose.yml +31 -37
  53. package/examples/static-page/README.md +19 -19
  54. package/examples/static-page/ssr-components/CustomPage.js +2 -2
  55. package/hardhat/hardhat.config.js +1 -6
  56. package/hardhat/package-lock.json +104 -43
  57. package/hardhat/package.json +3 -3
  58. package/manifests/alertmanager/deployment.yaml +81 -0
  59. package/manifests/blackbox-exporter/deployment.yaml +75 -0
  60. package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml +36 -7
  61. package/manifests/cronjobs/dd-cron/dd-cron-vultr.yaml +77 -0
  62. package/manifests/deployment/dd-cyberia-development/deployment.yaml +7 -2
  63. package/manifests/deployment/dd-default-development/deployment.yaml +2 -2
  64. package/manifests/grafana/deployment.yaml +26 -7
  65. package/manifests/grafana/kustomization.yaml +1 -0
  66. package/manifests/grafana/service.yaml +6 -1
  67. package/manifests/mariadb/pv.yaml +1 -0
  68. package/manifests/mongodb/statefulset.yaml +9 -2
  69. package/manifests/mysql/pv-pvc.yaml +14 -1
  70. package/manifests/postgresql/pv.yaml +12 -1
  71. package/manifests/postgresql/pvc.yaml +1 -0
  72. package/manifests/prometheus/deployment.yaml +18 -22
  73. package/package.json +83 -10
  74. package/scripts/audit-selinux.sh +64 -0
  75. package/scripts/event-monitor.sh +56 -0
  76. package/scripts/gpu-diag.sh +0 -0
  77. package/scripts/ip-info.sh +0 -0
  78. package/scripts/k3s-node-setup.sh +30 -14
  79. package/scripts/kubeadm-node-setup.sh +40 -31
  80. package/scripts/lxd-vm-setup.sh +0 -0
  81. package/scripts/maas-nat-firewalld.sh +0 -0
  82. package/scripts/maas-setup.sh +8 -8
  83. package/scripts/nat-iptables.sh +2 -0
  84. package/scripts/rhel-grpc-setup.sh +0 -0
  85. package/scripts/rocky-kickstart.sh +25 -9
  86. package/scripts/selinux-normalize.sh +907 -0
  87. package/scripts/shutdown-machine.sh +843 -0
  88. package/scripts/test-monitor.sh +3 -3
  89. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.controller.js +1 -1
  90. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.router.js +2 -2
  91. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.service.js +2 -2
  92. package/src/api/core/core.controller.js +1 -1
  93. package/src/api/core/core.router.js +2 -2
  94. package/src/api/core/core.service.js +2 -2
  95. package/src/api/crypto/crypto.controller.js +1 -1
  96. package/src/api/crypto/crypto.service.js +1 -1
  97. package/src/api/cyberia-action/cyberia-action.controller.js +1 -1
  98. package/src/api/cyberia-action/cyberia-action.router.js +1 -1
  99. package/src/api/cyberia-action/cyberia-action.service.js +2 -2
  100. package/src/api/cyberia-client-hints/cyberia-client-hints.controller.js +1 -1
  101. package/src/api/cyberia-client-hints/cyberia-client-hints.router.js +1 -1
  102. package/src/api/cyberia-client-hints/cyberia-client-hints.service.js +2 -2
  103. package/src/api/cyberia-dialogue/cyberia-dialogue.controller.js +1 -1
  104. package/src/api/cyberia-dialogue/cyberia-dialogue.router.js +1 -1
  105. package/src/api/cyberia-dialogue/cyberia-dialogue.service.js +2 -2
  106. package/src/api/cyberia-entity/cyberia-entity.controller.js +1 -1
  107. package/src/api/cyberia-entity/cyberia-entity.router.js +1 -1
  108. package/src/api/cyberia-entity/cyberia-entity.service.js +2 -2
  109. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.controller.js +1 -1
  110. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.router.js +1 -1
  111. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.service.js +2 -2
  112. package/src/api/cyberia-instance/cyberia-fallback-capture.js +466 -0
  113. package/src/api/cyberia-instance/cyberia-fallback-default-items.js +63 -0
  114. package/src/api/cyberia-instance/cyberia-fallback-world.js +16 -1
  115. package/src/api/cyberia-instance/cyberia-instance-map.service.js +1 -1
  116. package/src/api/cyberia-instance/cyberia-instance.controller.js +4 -1
  117. package/src/api/cyberia-instance/cyberia-instance.router.js +15 -2
  118. package/src/api/cyberia-instance/cyberia-instance.service.js +45 -2
  119. package/src/api/cyberia-instance-conf/cyberia-instance-conf.controller.js +1 -1
  120. package/src/api/cyberia-instance-conf/cyberia-instance-conf.model.js +1 -0
  121. package/src/api/cyberia-instance-conf/cyberia-instance-conf.router.js +1 -1
  122. package/src/api/cyberia-instance-conf/cyberia-instance-conf.service.js +2 -2
  123. package/src/api/cyberia-map/cyberia-map.controller.js +1 -1
  124. package/src/api/cyberia-map/cyberia-map.router.js +1 -1
  125. package/src/api/cyberia-map/cyberia-map.service.js +2 -2
  126. package/src/api/cyberia-quest/cyberia-quest.controller.js +1 -1
  127. package/src/api/cyberia-quest/cyberia-quest.router.js +1 -1
  128. package/src/api/cyberia-quest/cyberia-quest.service.js +2 -2
  129. package/src/api/cyberia-quest-progress/cyberia-quest-progress.controller.js +1 -1
  130. package/src/api/cyberia-quest-progress/cyberia-quest-progress.router.js +1 -1
  131. package/src/api/cyberia-quest-progress/cyberia-quest-progress.service.js +2 -2
  132. package/src/api/cyberia-saga/cyberia-saga.controller.js +1 -1
  133. package/src/api/cyberia-saga/cyberia-saga.router.js +1 -1
  134. package/src/api/cyberia-saga/cyberia-saga.service.js +2 -2
  135. package/src/api/cyberia-server-defaults/cyberia-server-defaults.js +16 -29
  136. package/src/api/cyberia-skill/cyberia-skill.controller.js +1 -1
  137. package/src/api/cyberia-skill/cyberia-skill.router.js +1 -1
  138. package/src/api/cyberia-skill/cyberia-skill.service.js +2 -2
  139. package/src/api/default/default.controller.js +1 -1
  140. package/src/api/default/default.router.js +1 -1
  141. package/src/api/default/default.service.js +2 -2
  142. package/src/api/document/document.controller.js +1 -1
  143. package/src/api/document/document.router.js +1 -1
  144. package/src/api/document/document.service.js +2 -2
  145. package/src/api/file/file.controller.js +1 -1
  146. package/src/api/file/file.router.js +1 -1
  147. package/src/api/file/file.service.js +2 -2
  148. package/src/api/instance/instance.controller.js +1 -1
  149. package/src/api/instance/instance.router.js +1 -1
  150. package/src/api/instance/instance.service.js +2 -2
  151. package/src/api/ipfs/ipfs.controller.js +1 -1
  152. package/src/api/ipfs/ipfs.router.js +2 -2
  153. package/src/api/ipfs/ipfs.service.js +2 -2
  154. package/src/api/object-layer/object-layer.controller.js +1 -1
  155. package/src/api/object-layer/object-layer.model.js +204 -3
  156. package/src/api/object-layer/object-layer.router.js +2 -2
  157. package/src/api/object-layer/object-layer.service.js +4 -17
  158. package/src/api/object-layer-render-frames/object-layer-render-frames.controller.js +1 -1
  159. package/src/api/object-layer-render-frames/object-layer-render-frames.router.js +1 -1
  160. package/src/api/object-layer-render-frames/object-layer-render-frames.service.js +2 -2
  161. package/src/api/test/test.controller.js +1 -1
  162. package/src/api/test/test.service.js +1 -1
  163. package/src/api/user/guest.service.js +3 -3
  164. package/src/api/user/user.controller.js +1 -1
  165. package/src/api/user/user.router.js +2 -2
  166. package/src/api/user/user.service.js +4 -4
  167. package/src/api.js +5 -9
  168. package/src/cli/app.js +391 -0
  169. package/src/cli/baremetal.js +30 -36
  170. package/src/cli/client.js +306 -0
  171. package/src/cli/cloud-init.js +3 -3
  172. package/src/cli/cluster.js +242 -135
  173. package/src/cli/db.js +126 -67
  174. package/src/cli/deploy.js +158 -60
  175. package/src/cli/docker-compose.js +5 -5
  176. package/src/cli/domains.js +184 -0
  177. package/src/cli/dotenv-store.js +143 -0
  178. package/src/cli/event.js +2281 -0
  179. package/src/cli/fs.js +3 -3
  180. package/src/cli/host.js +672 -0
  181. package/src/cli/image.js +4 -7
  182. package/src/cli/index.js +426 -134
  183. package/src/cli/ipfs.js +34 -30
  184. package/src/cli/kickstart.js +1 -1
  185. package/src/cli/kubectl.js +218 -41
  186. package/src/cli/lxd.js +3 -3
  187. package/src/cli/monitor.js +1359 -26
  188. package/src/cli/package.js +90 -0
  189. package/src/cli/release.js +73 -34
  190. package/src/cli/repository.js +564 -367
  191. package/src/cli/run.js +362 -654
  192. package/src/cli/secrets.js +2158 -964
  193. package/src/cli/ssh.js +651 -331
  194. package/src/cli/state.js +394 -0
  195. package/src/cli/static.js +2 -2
  196. package/src/cli/system.js +26 -13
  197. package/src/cli/test.js +199 -125
  198. package/src/cli/vultr.js +623 -0
  199. package/src/cli/wireguard.js +2930 -0
  200. package/src/client/components/core/CalendarCore.js +53 -96
  201. package/src/client/components/core/Docs.js +258 -211
  202. package/src/client/components/core/FileExplorer.js +0 -21
  203. package/src/client/components/core/PanelForm.js +4 -4
  204. package/src/client/components/core/Repository.js +56 -0
  205. package/src/client/components/core/Translate.js +7 -0
  206. package/src/client/components/core/{FullScreen.js → ViewModeController.js} +42 -39
  207. package/src/client/components/core/Wallet.js +0 -11
  208. package/src/client/components/core/Worker.js +7 -1
  209. package/src/client/components/cryptokoyn/SettingsCryptokoyn.js +2 -2
  210. package/src/client/components/cyberia/FallbackWorldEngineCyberia.js +368 -0
  211. package/src/client/components/cyberia-portal/AppShellCyberiaPortal.js +35 -1
  212. package/src/client/components/cyberia-portal/RouterCyberiaPortal.js +4 -0
  213. package/src/client/components/cyberia-portal/SettingsCyberiaPortal.js +2 -2
  214. package/src/client/components/cyberia-portal/TranslateCyberiaPortal.js +4 -0
  215. package/src/client/components/default/AppShellDefault.js +1 -1
  216. package/src/client/components/default/SettingsDefault.js +2 -2
  217. package/src/client/components/itemledger/SettingsItemledger.js +2 -2
  218. package/src/client/components/underpost/AppShellUnderpost.js +3 -2
  219. package/src/client/components/underpost/SettingsUnderpost.js +2 -2
  220. package/src/client/public/cyberia-docs/ARCHITECTURE.md +17 -3
  221. package/src/client/public/cyberia-docs/CYBERIA-CLI.md +32 -5
  222. package/src/client/public/cyberia-docs/CYBERIA-SERVER.md +1 -1
  223. package/src/client/public/cyberia-docs/CYBERIA.md +21 -1
  224. package/src/client/public/cyberia-docs/HARDHAT-MODULE.md +23 -6
  225. package/src/client/public/cyberia-docs/ROADMAP.md +1 -1
  226. package/src/client/public/cyberia-docs/WHITE-PAPER.md +1 -1
  227. package/src/client/public/default/android-chrome-144x144.png +0 -0
  228. package/src/client/public/default/android-chrome-192x192.png +0 -0
  229. package/src/client/public/default/android-chrome-256x256.png +0 -0
  230. package/src/client/public/default/android-chrome-36x36.png +0 -0
  231. package/src/client/public/default/android-chrome-384x384.png +0 -0
  232. package/src/client/public/default/android-chrome-48x48.png +0 -0
  233. package/src/client/public/default/android-chrome-512x512.png +0 -0
  234. package/src/client/public/default/android-chrome-72x72.png +0 -0
  235. package/src/client/public/default/android-chrome-96x96.png +0 -0
  236. package/src/client/public/default/apple-touch-icon-1024x1024.png +0 -0
  237. package/src/client/public/default/apple-touch-icon-114x114.png +0 -0
  238. package/src/client/public/default/apple-touch-icon-120x120.png +0 -0
  239. package/src/client/public/default/apple-touch-icon-144x144.png +0 -0
  240. package/src/client/public/default/apple-touch-icon-152x152.png +0 -0
  241. package/src/client/public/default/apple-touch-icon-167x167.png +0 -0
  242. package/src/client/public/default/apple-touch-icon-180x180.png +0 -0
  243. package/src/client/public/default/apple-touch-icon-57x57.png +0 -0
  244. package/src/client/public/default/apple-touch-icon-60x60.png +0 -0
  245. package/src/client/public/default/apple-touch-icon-72x72.png +0 -0
  246. package/src/client/public/default/apple-touch-icon-76x76.png +0 -0
  247. package/src/client/public/default/apple-touch-icon-precomposed.png +0 -0
  248. package/src/client/public/default/apple-touch-icon.png +0 -0
  249. package/src/client/public/default/apple-touch-startup-image-1125x2436.png +0 -0
  250. package/src/client/public/default/apple-touch-startup-image-1136x640.png +0 -0
  251. package/src/client/public/default/apple-touch-startup-image-1170x2532.png +0 -0
  252. package/src/client/public/default/apple-touch-startup-image-1179x2556.png +0 -0
  253. package/src/client/public/default/apple-touch-startup-image-1242x2208.png +0 -0
  254. package/src/client/public/default/apple-touch-startup-image-1242x2688.png +0 -0
  255. package/src/client/public/default/apple-touch-startup-image-1284x2778.png +0 -0
  256. package/src/client/public/default/apple-touch-startup-image-1290x2796.png +0 -0
  257. package/src/client/public/default/apple-touch-startup-image-1334x750.png +0 -0
  258. package/src/client/public/default/apple-touch-startup-image-1488x2266.png +0 -0
  259. package/src/client/public/default/apple-touch-startup-image-1536x2048.png +0 -0
  260. package/src/client/public/default/apple-touch-startup-image-1620x2160.png +0 -0
  261. package/src/client/public/default/apple-touch-startup-image-1640x2160.png +0 -0
  262. package/src/client/public/default/apple-touch-startup-image-1668x2224.png +0 -0
  263. package/src/client/public/default/apple-touch-startup-image-1668x2388.png +0 -0
  264. package/src/client/public/default/apple-touch-startup-image-1792x828.png +0 -0
  265. package/src/client/public/default/apple-touch-startup-image-2048x1536.png +0 -0
  266. package/src/client/public/default/apple-touch-startup-image-2048x2732.png +0 -0
  267. package/src/client/public/default/apple-touch-startup-image-2160x1620.png +0 -0
  268. package/src/client/public/default/apple-touch-startup-image-2160x1640.png +0 -0
  269. package/src/client/public/default/apple-touch-startup-image-2208x1242.png +0 -0
  270. package/src/client/public/default/apple-touch-startup-image-2224x1668.png +0 -0
  271. package/src/client/public/default/apple-touch-startup-image-2266x1488.png +0 -0
  272. package/src/client/public/default/apple-touch-startup-image-2388x1668.png +0 -0
  273. package/src/client/public/default/apple-touch-startup-image-2436x1125.png +0 -0
  274. package/src/client/public/default/apple-touch-startup-image-2532x1170.png +0 -0
  275. package/src/client/public/default/apple-touch-startup-image-2556x1179.png +0 -0
  276. package/src/client/public/default/apple-touch-startup-image-2688x1242.png +0 -0
  277. package/src/client/public/default/apple-touch-startup-image-2732x2048.png +0 -0
  278. package/src/client/public/default/apple-touch-startup-image-2778x1284.png +0 -0
  279. package/src/client/public/default/apple-touch-startup-image-2796x1290.png +0 -0
  280. package/src/client/public/default/apple-touch-startup-image-640x1136.png +0 -0
  281. package/src/client/public/default/apple-touch-startup-image-750x1334.png +0 -0
  282. package/src/client/public/default/apple-touch-startup-image-828x1792.png +0 -0
  283. package/src/client/public/default/assets/background/white.jpg +0 -0
  284. package/src/client/public/default/browserconfig.xml +1 -1
  285. package/src/client/public/default/favicon-16x16.png +0 -0
  286. package/src/client/public/default/favicon-32x32.png +0 -0
  287. package/src/client/public/default/favicon-48x48.png +0 -0
  288. package/src/client/public/default/favicon.ico +0 -0
  289. package/src/client/public/default/manifest.webmanifest +5 -5
  290. package/src/client/public/default/mstile-144x144.png +0 -0
  291. package/src/client/public/default/mstile-150x150.png +0 -0
  292. package/src/client/public/default/mstile-310x150.png +0 -0
  293. package/src/client/public/default/mstile-310x310.png +0 -0
  294. package/src/client/public/default/mstile-70x70.png +0 -0
  295. package/src/client/public/default/yandex-browser-50x50.png +0 -0
  296. package/src/client/public/default/yandex-browser-manifest.json +1 -1
  297. package/src/client/services/cyberia-instance/cyberia-instance.service.js +40 -0
  298. package/src/client/services/object-layer/object-layer.management.js +4 -4
  299. package/src/client/ssr/RootDocument.js +1 -1
  300. package/src/client/ssr/body/404.js +1 -1
  301. package/src/client/ssr/body/500.js +1 -1
  302. package/src/client/ssr/body/CacheControl.js +1 -1
  303. package/src/client/ssr/body/CyberiaDefaultSplashScreen.js +1 -1
  304. package/src/client/ssr/body/DefaultSplashScreen.js +1 -1
  305. package/src/client/ssr/body/SwaggerDarkMode.js +1 -1
  306. package/src/client/ssr/body/UnderpostDefaultSplashScreen.js +1 -1
  307. package/src/client/ssr/head/CryptokoynScripts.js +1 -1
  308. package/src/client/ssr/head/Css.js +1 -1
  309. package/src/client/ssr/head/CyberiaPortalScripts.js +1 -1
  310. package/src/client/ssr/head/DefaultScripts.js +1 -1
  311. package/src/client/ssr/head/ItemledgerScripts.js +1 -1
  312. package/src/client/ssr/head/Microdata.js +1 -1
  313. package/src/client/ssr/head/Production.js +1 -1
  314. package/src/client/ssr/head/Pwa.js +1 -1
  315. package/src/client/ssr/head/PwaItemledger.js +1 -1
  316. package/src/client/ssr/head/Seo.js +1 -1
  317. package/src/client/ssr/head/UnderpostScripts.js +1 -1
  318. package/src/client/ssr/mailer/DefaultRecoverEmail.js +1 -1
  319. package/src/client/ssr/mailer/DefaultVerifyEmail.js +1 -1
  320. package/src/client/ssr/views/Cyberia404.js +7 -5
  321. package/src/client/ssr/views/CyberiaServerMetrics.js +1 -1
  322. package/src/client/ssr/views/Maintenance.js +1 -1
  323. package/src/client/ssr/views/NoNetworkConnection.js +1 -1
  324. package/src/client/ssr/views/Test.js +1 -1
  325. package/src/client/sw/core.sw.js +20 -14
  326. package/src/client-builder/client-build-docs.js +61 -46
  327. package/src/client-builder/client-build-live.js +2 -2
  328. package/src/client-builder/client-build.js +58 -44
  329. package/src/client-builder/client-dev-server.js +3 -3
  330. package/src/client-builder/client-icons.js +2 -2
  331. package/src/client-builder/ssr.js +3 -3
  332. package/src/client.build.js +3 -6
  333. package/src/client.dev.js +3 -6
  334. package/src/db/DataBaseProvider.js +186 -3
  335. package/src/db/mariadb/MariaDB.js +3 -2
  336. package/src/db/mongo/MongoBootstrap.js +273 -101
  337. package/src/db/mongo/MongooseDB.js +11 -8
  338. package/src/{server/valkey.js → db/valkey/Valkey.js} +5 -4
  339. package/src/grpc/cyberia/grpc-server.js +1 -1
  340. package/src/index.js +103 -23
  341. package/src/mailer/EmailRender.js +2 -2
  342. package/src/mailer/MailerInterceptor.js +87 -0
  343. package/src/mailer/MailerProvider.js +50 -6
  344. package/src/projects/cyberia/atlas-sprite-sheet-generator.js +1 -1
  345. package/src/projects/cyberia/besu-genesis-generator.js +3 -3
  346. package/src/projects/cyberia/catalog-cyberia.js +54 -6
  347. package/src/projects/cyberia/gemini-client.js +1 -1
  348. package/src/projects/cyberia/generate-saga.js +15 -24
  349. package/src/projects/cyberia/hot-reload-trigger.js +1 -1
  350. package/src/projects/cyberia/instance-data.js +22 -3
  351. package/src/projects/cyberia/ipfs-client.js +4 -4
  352. package/src/projects/cyberia/map-preview-generator.js +1 -1
  353. package/src/projects/cyberia/object-layer.js +12 -22
  354. package/src/projects/cyberia/semantic-layer-generator.js +1 -1
  355. package/src/projects/underpost/catalog-underpost.js +13 -2
  356. package/src/proxy.js +4 -7
  357. package/src/runtime/cyberia-client/Dockerfile +9 -4
  358. package/src/runtime/cyberia-client/Dockerfile.dev +8 -2
  359. package/src/runtime/cyberia-server/Dockerfile +9 -4
  360. package/src/runtime/cyberia-server/Dockerfile.dev +8 -2
  361. package/src/runtime/engine-cyberia/Dockerfile +25 -9
  362. package/src/runtime/engine-cyberia/Dockerfile.dev +25 -9
  363. package/src/runtime/engine-cyberia/Dockerfile.test +4 -4
  364. package/src/runtime/engine-cyberia/compose.env +16 -0
  365. package/src/runtime/engine-cyberia/docker-compose.yml +31 -37
  366. package/src/runtime/express/Express.js +32 -27
  367. package/src/runtime/lampp/Lampp.js +22 -70
  368. package/src/runtime/nginx/Nginx.js +1 -1
  369. package/src/runtime/wp/Wp.js +16 -48
  370. package/src/server/{catalog.js → build/catalog.js} +15 -5
  371. package/src/server/build/coverage.js +117 -0
  372. package/src/server/build/execution.js +402 -0
  373. package/src/server/build/package.js +465 -0
  374. package/src/server/build/testing.js +528 -0
  375. package/src/server/{dns.js → network/dns.js} +241 -14
  376. package/src/server/network/forward-proxy.js +541 -0
  377. package/src/server/{middlewares.js → network/middlewares.js} +59 -4
  378. package/src/server/network/node-capability.js +98 -0
  379. package/src/server/{peer.js → network/peer.js} +3 -3
  380. package/src/server/{proxy.js → network/proxy.js} +7 -13
  381. package/src/server/network/router.js +356 -0
  382. package/src/server/{tls.js → network/tls.js} +2 -2
  383. package/src/server/network/underpost-compression.js +186 -0
  384. package/src/server/{underpost-gateway.js → network/underpost-gateway.js} +26 -16
  385. package/src/server/{underpost-ingress.js → network/underpost-ingress.js} +19 -3
  386. package/src/server/{cri.js → ops/cri.js} +2 -2
  387. package/src/server/ops/cron.js +949 -0
  388. package/src/server/ops/event-notification.js +284 -0
  389. package/src/server/{logger.js → ops/logger.js} +108 -23
  390. package/src/server/ops/monitoring.js +1724 -0
  391. package/src/server/ops/systemd.js +259 -0
  392. package/src/server/{conf.js → runtime/conf.js} +521 -520
  393. package/src/server/runtime/config-scope.js +215 -0
  394. package/src/server/runtime/environment.js +149 -0
  395. package/src/server/{process.js → runtime/process.js} +153 -13
  396. package/src/server/{runtime-status.js → runtime/runtime-status.js} +155 -16
  397. package/src/server/{runtime.js → runtime/runtime.js} +12 -8
  398. package/src/server/{start.js → runtime/start.js} +128 -39
  399. package/src/server/{auth.js → security/auth.js} +7 -8
  400. package/src/server/security/container-storage.js +382 -0
  401. package/src/server/{crypto.js → security/crypto.js} +1 -1
  402. package/src/server/security/selinux.js +185 -0
  403. package/src/server/{backup.js → storage/backup.js} +17 -8
  404. package/src/server/{data-query.js → storage/data-query.js} +1 -1
  405. package/src/server/{downloader.js → storage/downloader.js} +2 -2
  406. package/src/server/storage/repository.js +68 -0
  407. package/src/server.js +4 -7
  408. package/src/ws/IoInterface.js +1 -1
  409. package/src/ws/IoServer.js +1 -1
  410. package/src/ws/core/core.ws.connection.js +1 -1
  411. package/src/ws/core/core.ws.emit.js +1 -1
  412. package/src/ws/core/core.ws.server.js +1 -1
  413. package/src/ws/default/default.ws.connection.js +1 -1
  414. package/src/ws/default/default.ws.emit.js +1 -1
  415. package/src/ws/default/default.ws.server.js +1 -1
  416. package/test/e2e/event-e2e-public-ingress-down.js +45 -0
  417. package/test/e2e/event-e2e-wireguard-server-down.js +38 -0
  418. package/test/e2e/event-e2e-wireguard-spoke-down.js +40 -0
  419. package/test/{api.test.js → integration/app/api.test.js} +33 -14
  420. package/test/integration/app/cyberia/cyberia-cli-plain-reads.test.js +30 -0
  421. package/test/{cyberia-instance-conf-defaults.test.js → integration/app/cyberia/cyberia-instance-conf-defaults.test.js} +2 -1
  422. package/test/integration/app/cyberia/cyberia-load.test.js +467 -0
  423. package/test/integration/app/cyberia/fallback-world-capture.test.js +253 -0
  424. package/test/integration/app/cyberia/object-layer-item-id.test.js +327 -0
  425. package/test/{shape-generator.test.js → integration/app/cyberia/shape-generator.test.js} +1 -1
  426. package/test/integration/infra/1-security/config-scope.test.js +305 -0
  427. package/test/integration/infra/1-security/container-storage.test.js +356 -0
  428. package/test/integration/infra/1-security/in-pod-cli-surface.test.js +86 -0
  429. package/test/integration/infra/1-security/secret-onboarding.test.js +930 -0
  430. package/test/integration/infra/1-security/selinux.test.js +69 -0
  431. package/test/{sops-secret-store.test.js → integration/infra/1-security/sops-secret-store.test.js} +415 -61
  432. package/test/integration/infra/1-security/systemd-service.test.js +70 -0
  433. package/test/integration/infra/1-security/underpost-config-secret.test.js +367 -0
  434. package/test/integration/infra/2-network/dns-firewall.test.js +566 -0
  435. package/test/integration/infra/2-network/node-capability.test.js +182 -0
  436. package/test/integration/infra/2-network/wireguard-cli.test.js +1163 -0
  437. package/test/integration/infra/2-network/wireguard-edge.test.js +1731 -0
  438. package/test/{cluster-instances.test.js → integration/infra/3-cluster/cluster-instances.test.js} +11 -15
  439. package/test/{deploy-node-placement.test.js → integration/infra/3-cluster/deploy-node-placement.test.js} +3 -3
  440. package/test/integration/infra/3-cluster/docker-compose-stack.test.js +313 -0
  441. package/test/integration/infra/4-ingress/deploy-routes.test.js +379 -0
  442. package/test/integration/infra/4-ingress/gateway-static-assets.test.js +453 -0
  443. package/test/{instance-traffic-plan.test.js → integration/infra/4-ingress/instance-traffic-plan.test.js} +10 -6
  444. package/test/{underpost-gateway.test.js → integration/infra/4-ingress/underpost-gateway.test.js} +47 -6
  445. package/test/{underpost-ingress.test.js → integration/infra/4-ingress/underpost-ingress.test.js} +56 -4
  446. package/test/integration/infra/5-observability/cron-jobs.test.js +652 -0
  447. package/test/{deploy-monitor.test.js → integration/infra/5-observability/deploy-monitor.test.js} +29 -31
  448. package/test/integration/infra/5-observability/event-notification.test.js +197 -0
  449. package/test/integration/infra/5-observability/event-remediation.test.js +502 -0
  450. package/test/integration/infra/5-observability/event-targets.test.js +1174 -0
  451. package/test/integration/infra/5-observability/monitoring-stack.test.js +902 -0
  452. package/test/support/shell-harness.js +73 -0
  453. package/test/unit/build-template.test.js +97 -0
  454. package/test/unit/build-workflow-offline.test.js +132 -0
  455. package/test/unit/catalog.test.js +71 -0
  456. package/test/unit/client-build-docs.test.js +334 -0
  457. package/test/unit/conf-loading.test.js +303 -0
  458. package/test/unit/conf-resolution.test.js +979 -0
  459. package/test/unit/coverage-artifact.test.js +130 -0
  460. package/test/{crypto.test.js → unit/crypto.test.js} +1 -1
  461. package/test/unit/deploy-env-resolution.test.js +38 -0
  462. package/test/unit/deploy-log-table.test.js +447 -0
  463. package/test/unit/execution-profiles.test.js +219 -0
  464. package/test/unit/fleet-sync-source.test.js +149 -0
  465. package/test/unit/logger-redaction.test.js +112 -0
  466. package/test/unit/package.test.js +403 -0
  467. package/test/unit/prepare-host.test.js +299 -0
  468. package/test/unit/process-environment.test.js +18 -0
  469. package/test/unit/propagation-message.test.js +78 -0
  470. package/test/unit/redeploy-plan.test.js +24 -0
  471. package/test/unit/release-bump.test.js +474 -0
  472. package/test/unit/ssh-output-redaction.test.js +28 -0
  473. package/test/unit/start-options.test.js +46 -0
  474. package/test/unit/test-tiers.test.js +193 -0
  475. package/vitest.config.js +58 -0
  476. package/.nycrc +0 -9
  477. package/manifests/cronjobs/dd-cron/dd-cron-dns.yaml +0 -48
  478. package/manifests/mongodb/pv-pvc.yaml +0 -59
  479. package/scripts/link-local-underpost-cli.sh +0 -6
  480. package/src/api/user/user.build.js +0 -16
  481. package/src/cli/env.js +0 -177
  482. package/src/client/components/core/Blockchain.js +0 -41
  483. package/src/client/components/core/Blog.js +0 -9
  484. package/src/client/components/core/KeyboardAvoidance.js +0 -145
  485. package/src/client/public/default/assets/background/dark.jpg +0 -0
  486. package/src/client/public/default/assets/background/white0-min.jpg +0 -0
  487. package/src/client/public/default/assets/background/white0.jpg +0 -0
  488. package/src/client/public/doc/favicon.ico +0 -0
  489. package/src/client/public/doc/sitemap +0 -148
  490. package/src/server/cron.js +0 -476
package/test/unit/client-build-docs.test.js ADDED
@@ -0,0 +1,334 @@
1
+ 'use strict';
2
+
3
+ import { expect } from 'chai';
4
+ import fs from 'fs-extra';
5
+ import shell from 'shelljs';
6
+ import { COVERAGE_BUNDLE_DIRECTORY } from '../../src/server/build/coverage.js';
7
+ import { buildCoverage, buildDocs, buildSwaggerUiOptions } from '../../src/client-builder/client-build-docs.js';
8
+
9
+ // swagger-autogen is a code generator that walks the real router files and
10
+ // writes into ./public. The doc it is handed is what this module is responsible
11
+ // for, so the generator itself is replaced and its arguments are asserted.
12
+ const generated = vi.hoisted(() => []);
13
+ vi.mock('swagger-autogen', () => ({
14
+ default: (options) => async (outputFile, routes, doc) => {
15
+ generated.push({ options, outputFile, routes, doc });
16
+ },
17
+ }));
18
+
19
+ describe('client coverage build', () => {
20
+ let fixturePath;
21
+
22
+ afterEach(() => {
23
+ if (fixturePath) fs.removeSync(fixturePath);
24
+ fixturePath = undefined;
25
+ vi.restoreAllMocks();
26
+ });
27
+
28
+ it('publishes the Vitest lcov HTML report at the coverage route root', async () => {
29
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
30
+ const reportPath = `${fixturePath}/coverage/lcov-report`;
31
+ const docsDestination = `${fixturePath}/public/docs/`;
32
+ fs.outputFileSync(`${reportPath}/index.html`, '<!doctype html><title>Coverage</title>');
33
+ fs.outputFileSync(`${reportPath}/base.css`, 'body {}');
34
+
35
+ await buildCoverage({ docs: { coveragePath: fixturePath }, docsDestination });
36
+
37
+ expect(fs.existsSync(`${docsDestination}coverage/index.html`)).to.equal(true);
38
+ expect(fs.existsSync(`${docsDestination}coverage/base.css`)).to.equal(true);
39
+ expect(fs.existsSync(`${docsDestination}coverage/lcov-report`)).to.equal(false);
40
+ });
41
+
42
+ it('prefers an html report directory over the lcov one', async () => {
43
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
44
+ fs.outputFileSync(`${fixturePath}/coverage/html/index.html`, '<!doctype html><title>html</title>');
45
+ fs.outputFileSync(`${fixturePath}/coverage/lcov-report/index.html`, '<!doctype html><title>lcov</title>');
46
+
47
+ await buildCoverage({ docs: { coveragePath: fixturePath }, docsDestination: `${fixturePath}/out/` });
48
+
49
+ expect(fs.readFileSync(`${fixturePath}/out/coverage/index.html`, 'utf8')).to.include('html');
50
+ });
51
+
52
+ it('publishes a flat report directory that carries the index itself', async () => {
53
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
54
+ fs.outputFileSync(`${fixturePath}/coverage/index.html`, '<!doctype html><title>flat</title>');
55
+
56
+ await buildCoverage({
57
+ docs: { coveragePath: fixturePath, coverageOutputDir: 'report' },
58
+ docsDestination: `${fixturePath}/out/`,
59
+ });
60
+
61
+ expect(fs.existsSync(`${fixturePath}/out/report/index.html`)).to.equal(true);
62
+ });
63
+
64
+ it('publishes the unavailable page for a coverage directory with no HTML index', async () => {
65
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
66
+ fs.outputFileSync(`${fixturePath}/coverage/lcov.info`, 'TN:\n');
67
+
68
+ await buildCoverage({ docs: { coveragePath: fixturePath }, docsDestination: `${fixturePath}/out/` });
69
+
70
+ expect(fs.readFileSync(`${fixturePath}/out/coverage/index.html`, 'utf8')).to.include('Coverage report unavailable');
71
+ });
72
+
73
+ it('publishes the report an assembled deploy artifact bundled', async () => {
74
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
75
+ fs.outputFileSync(
76
+ `${fixturePath}/${COVERAGE_BUNDLE_DIRECTORY}/index.html`,
77
+ '<!doctype html><title>bundled</title>',
78
+ );
79
+
80
+ await buildCoverage({ docs: { coveragePath: fixturePath }, docsDestination: `${fixturePath}/out/` });
81
+
82
+ expect(fs.readFileSync(`${fixturePath}/out/coverage/index.html`, 'utf8')).to.include('bundled');
83
+ });
84
+
85
+ it('prefers a freshly generated report over the bundled artifact', async () => {
86
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
87
+ fs.outputFileSync(`${fixturePath}/coverage/lcov-report/index.html`, '<!doctype html><title>fresh</title>');
88
+ fs.outputFileSync(
89
+ `${fixturePath}/${COVERAGE_BUNDLE_DIRECTORY}/index.html`,
90
+ '<!doctype html><title>bundled</title>',
91
+ );
92
+
93
+ await buildCoverage({ docs: { coveragePath: fixturePath }, docsDestination: `${fixturePath}/out/` });
94
+
95
+ expect(fs.readFileSync(`${fixturePath}/out/coverage/index.html`, 'utf8')).to.include('fresh');
96
+ });
97
+
98
+ // Regression: the build used to shell out to `npm test` when no report was present. Inside a
99
+ // pod that spent minutes of the build phase on a test runner, and the suite's expected
100
+ // non-zero exits latched `container-status=error`, failing a healthy rollout.
101
+ it('never runs a test runner to produce a missing report', async () => {
102
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
103
+ fs.outputJsonSync(`${fixturePath}/package.json`, {
104
+ scripts: { coverage: 'vitest run --coverage', test: 'vitest run' },
105
+ });
106
+ const exec = vi.spyOn(shell, 'exec');
107
+
108
+ await buildCoverage({ docs: { coveragePath: fixturePath }, docsDestination: `${fixturePath}/out/` });
109
+
110
+ expect(exec.mock.calls.length).to.equal(0);
111
+ expect(fs.readFileSync(`${fixturePath}/out/coverage/index.html`, 'utf8')).to.include('Coverage report unavailable');
112
+ });
113
+
114
+ it('publishes nothing for a deploy that declares no coverage source', async () => {
115
+ fixturePath = fs.mkdtempSync('/tmp/engine-coverage-');
116
+
117
+ await buildCoverage({ docs: {}, docsDestination: `${fixturePath}/out/` });
118
+
119
+ expect(fs.existsSync(`${fixturePath}/out`)).to.equal(false);
120
+ });
121
+ });
122
+
123
+ describe('docs build', () => {
124
+ let fixturePath;
125
+ let publicRoot;
126
+
127
+ const PACKAGE_DATA = { version: 'v1.2.3' };
128
+ const HOST = 'docs.fixture.test';
129
+
130
+ const runBuildDocs = async (overrides = {}) =>
131
+ buildDocs({
132
+ host: HOST,
133
+ path: '/',
134
+ port: 4000,
135
+ metadata: { title: 'Fixture API', description: 'fixture docs' },
136
+ apis: ['user', 'object-layer', 'unknown-api'],
137
+ publicClientId: 'fixture',
138
+ rootClientPath: `${fixturePath}/client`,
139
+ packageData: PACKAGE_DATA,
140
+ docs: { jsJsonPath: `${fixturePath}/typedoc.json`, coveragePath: `${fixturePath}/nothing-here` },
141
+ ...overrides,
142
+ });
143
+
144
+ beforeEach(() => {
145
+ generated.length = 0;
146
+ fixturePath = fs.mkdtempSync('/tmp/engine-docs-');
147
+ publicRoot = `./public/${HOST}`;
148
+ if (fs.existsSync(publicRoot)) throw new Error(`Refusing to write fixtures into an existing site: ${publicRoot}`);
149
+ vi.useFakeTimers();
150
+ });
151
+
152
+ afterEach(() => {
153
+ vi.useRealTimers();
154
+ vi.restoreAllMocks();
155
+ fs.removeSync(fixturePath);
156
+ fs.removeSync(publicRoot);
157
+ fs.removeSync('.typedoc.tmp.json');
158
+ });
159
+
160
+ const flushApiDocs = async () => {
161
+ await vi.advanceTimersByTimeAsync(1);
162
+ };
163
+
164
+ it('renders the typedoc runtime config without mutating the base config on disk', async () => {
165
+ const baseConfig = { tsconfig: './tsconfig.docs.json', name: 'Base', entryPoints: ['./src'] };
166
+ fs.outputJsonSync(`${fixturePath}/typedoc.json`, baseConfig);
167
+ fs.outputFileSync(`${fixturePath}/reference-a.md`, '# a');
168
+ let tmpConfig;
169
+ vi.spyOn(shell, 'exec').mockImplementation(() => {
170
+ tmpConfig = JSON.parse(fs.readFileSync('.typedoc.tmp.json', 'utf8'));
171
+ return { code: 0, stdout: '', stderr: '' };
172
+ });
173
+
174
+ await runBuildDocs({
175
+ docs: {
176
+ jsJsonPath: `${fixturePath}/typedoc.json`,
177
+ coveragePath: `${fixturePath}/nothing-here`,
178
+ references: [`${fixturePath}/reference-a.md`, `${fixturePath}/missing.md`],
179
+ },
180
+ });
181
+ await flushApiDocs();
182
+
183
+ expect(tmpConfig.name).to.equal('Fixture API');
184
+ expect(tmpConfig.out).to.equal(`./public/${HOST}/docs/engine/1.2.3/`);
185
+ expect(tmpConfig.favicon).to.equal(`./public/${HOST}/favicon.ico`);
186
+ expect(tmpConfig.tsconfig.startsWith('/')).to.equal(true);
187
+ expect(tmpConfig.projectDocuments).to.deep.equal([`${fixturePath}/reference-a.md`]);
188
+ expect(fs.readJsonSync(`${fixturePath}/typedoc.json`)).to.deep.equal(baseConfig);
189
+ expect(fs.existsSync('.typedoc.tmp.json')).to.equal(false);
190
+ });
191
+
192
+ it('keeps the base name and drops the documents key when nothing resolves', async () => {
193
+ fs.outputJsonSync(`${fixturePath}/typedoc.json`, { tsconfig: './tsconfig.docs.json', name: 'Base' });
194
+ let tmpConfig;
195
+ vi.spyOn(shell, 'exec').mockImplementation(() => {
196
+ tmpConfig = JSON.parse(fs.readFileSync('.typedoc.tmp.json', 'utf8'));
197
+ return { code: 0, stdout: '', stderr: '' };
198
+ });
199
+
200
+ await runBuildDocs({ metadata: {}, docs: { jsJsonPath: `${fixturePath}/typedoc.json`, references: [] } });
201
+ await flushApiDocs();
202
+
203
+ expect(tmpConfig.name).to.equal('Base');
204
+ expect(tmpConfig).not.to.have.property('projectDocuments');
205
+ });
206
+
207
+ it('skips the typedoc build when the deploy declares no config', async () => {
208
+ const exec = vi.spyOn(shell, 'exec');
209
+ await runBuildDocs({ docs: { jsJsonPath: `${fixturePath}/absent.json` } });
210
+ await flushApiDocs();
211
+ expect(exec.mock.calls.length).to.equal(0);
212
+ });
213
+
214
+ it('documents only the routers it has schemas for, at the deploy version', async () => {
215
+ const exec = vi.spyOn(shell, 'exec').mockReturnValue({ code: 0, stdout: '', stderr: '' });
216
+ await runBuildDocs();
217
+ await flushApiDocs();
218
+
219
+ expect(exec.mock.calls.length).to.equal(0);
220
+ expect(generated.length).to.equal(1);
221
+ const [{ options, outputFile, routes, doc }] = generated;
222
+ expect(options).to.deep.equal({ openapi: '3.0.0' });
223
+ expect(outputFile).to.equal(`./public/${HOST}/swagger-output.json`);
224
+ expect(routes).to.deep.equal(['./src/api/user/user.router.js', './src/api/object-layer/object-layer.router.js']);
225
+ expect(doc.info).to.deep.equal({ version: 'v1.2.3', title: 'Fixture API', description: 'fixture docs' });
226
+ expect(doc.components.securitySchemes.bearerAuth).to.deep.equal({ type: 'http', scheme: 'bearer' });
227
+ });
228
+
229
+ it('falls back to a generic title and empty description without metadata', async () => {
230
+ await runBuildDocs({ metadata: {}, docs: { jsJsonPath: `${fixturePath}/absent.json` } });
231
+ await flushApiDocs();
232
+ expect(generated[0].doc.info.title).to.equal('REST API');
233
+ expect(generated[0].doc.info.description).to.equal('');
234
+ });
235
+
236
+ it('points the server at localhost in development and at the host in production', async () => {
237
+ const previousEnv = process.env.NODE_ENV;
238
+ const previousApi = process.env.BASE_API;
239
+ process.env.BASE_API = 'api';
240
+ try {
241
+ process.env.NODE_ENV = 'development';
242
+ await runBuildDocs({ path: '/store', docs: { jsJsonPath: `${fixturePath}/absent.json` } });
243
+ await flushApiDocs();
244
+ expect(generated[0].doc.servers[0].url).to.equal('http://localhost:4000/store/api');
245
+ expect(generated[0].outputFile).to.equal(`./public/${HOST}/store/swagger-output.json`);
246
+
247
+ generated.length = 0;
248
+ process.env.NODE_ENV = 'production';
249
+ await runBuildDocs({ docs: { jsJsonPath: `${fixturePath}/absent.json` } });
250
+ await flushApiDocs();
251
+ expect(generated[0].doc.servers[0].url).to.equal(`https://${HOST}/api`);
252
+ } finally {
253
+ process.env.NODE_ENV = previousEnv;
254
+ if (previousApi === undefined) delete process.env.BASE_API;
255
+ else process.env.BASE_API = previousApi;
256
+ }
257
+ });
258
+
259
+ it('points the server at the API runtime when the client and the API are split', async () => {
260
+ const previousEnv = process.env.NODE_ENV;
261
+ const previousApi = process.env.BASE_API;
262
+ process.env.BASE_API = 'api';
263
+ try {
264
+ process.env.NODE_ENV = 'development';
265
+ await runBuildDocs({
266
+ apiBaseHost: 'localhost:4017',
267
+ apiBaseProxyPath: '/',
268
+ docs: { jsJsonPath: `${fixturePath}/absent.json` },
269
+ });
270
+ await flushApiDocs();
271
+ expect(generated[0].doc.servers[0].url).to.equal('http://localhost:4017/api');
272
+
273
+ generated.length = 0;
274
+ process.env.NODE_ENV = 'production';
275
+ await runBuildDocs({
276
+ path: '/store',
277
+ apiBaseHost: 'api.fixture.test',
278
+ apiBaseProxyPath: '/store',
279
+ docs: { jsJsonPath: `${fixturePath}/absent.json` },
280
+ });
281
+ await flushApiDocs();
282
+ expect(generated[0].doc.servers[0].url).to.equal('https://api.fixture.test/store/api');
283
+ } finally {
284
+ process.env.NODE_ENV = previousEnv;
285
+ if (previousApi === undefined) delete process.env.BASE_API;
286
+ else process.env.BASE_API = previousApi;
287
+ }
288
+ });
289
+
290
+ // swagger-autogen has no OAS-3 requestBody support, so the generated document
291
+ // is patched afterwards. The patch has to survive an operation the generator
292
+ // did not emit, and has to strip the OAS-2 `in: body` parameter it did.
293
+ it('injects the request bodies into the generated document', async () => {
294
+ const outputFile = `./public/${HOST}/swagger-output.json`;
295
+ await runBuildDocs({ docs: { jsJsonPath: `${fixturePath}/absent.json` } });
296
+ fs.outputJsonSync(outputFile, {
297
+ paths: {
298
+ '/user': {
299
+ post: {
300
+ parameters: [
301
+ { in: 'body', name: 'obj' },
302
+ { in: 'query', name: 'q' },
303
+ ],
304
+ },
305
+ },
306
+ '/user/{id}': { get: {} },
307
+ },
308
+ });
309
+ await flushApiDocs();
310
+
311
+ const patched = fs.readJsonSync(outputFile);
312
+ expect(patched.paths['/user'].post.requestBody.content['application/json'].schema.$ref).to.equal(
313
+ '#/components/schemas/userRequest',
314
+ );
315
+ expect(patched.paths['/user'].post.parameters).to.deep.equal([{ in: 'query', name: 'q' }]);
316
+ expect(patched.paths['/user/{id}'].get).not.to.have.property('requestBody');
317
+ });
318
+
319
+ it('leaves the generated document alone when no operation matches', async () => {
320
+ const outputFile = `./public/${HOST}/swagger-output.json`;
321
+ await runBuildDocs({ docs: { jsJsonPath: `${fixturePath}/absent.json` } });
322
+ fs.outputJsonSync(outputFile, { paths: { '/health': { get: {} } } });
323
+ await flushApiDocs();
324
+ expect(fs.readJsonSync(outputFile)).to.deep.equal({ paths: { '/health': { get: {} } } });
325
+ });
326
+ });
327
+
328
+ describe('swagger UI options', () => {
329
+ it('renders the dark mode toggle css and script from the SSR component', async () => {
330
+ const { customCss, customJsStr } = await buildSwaggerUiOptions();
331
+ expect(customCss).to.be.a('string').and.not.equal('');
332
+ expect(customJsStr).to.be.a('string').and.not.equal('');
333
+ });
334
+ });
package/test/unit/conf-loading.test.js ADDED
@@ -0,0 +1,303 @@
1
+ 'use strict';
2
+
3
+ import { expect } from 'chai';
4
+ import fs from 'fs-extra';
5
+ import {
6
+ Config,
7
+ buildApiConf,
8
+ buildClientStaticConf,
9
+ deployEnvContentFactory,
10
+ deployOciEnvFilePath,
11
+ getConfFilePath,
12
+ loadConf,
13
+ ociEnvContentFactory,
14
+ } from '../../src/server/runtime/conf.js';
15
+
16
+ const restoreEnv = (name, value) => {
17
+ if (value === undefined) delete process.env[name];
18
+ else process.env[name] = value;
19
+ };
20
+
21
+ describe('deploy configuration loading', () => {
22
+ const originalNodeEnv = process.env.NODE_ENV;
23
+ const originalSubConf = process.env.DEPLOY_SUB_CONF;
24
+ const originalDeployId = process.env.DEPLOY_ID;
25
+ const originalKubernetesHost = process.env.KUBERNETES_SERVICE_HOST;
26
+ const originalRuntimeFixture = process.env.CONF_RUNTIME_FIXTURE;
27
+ const originalConfig = structuredClone(Config.default);
28
+
29
+ afterEach(() => {
30
+ vi.restoreAllMocks();
31
+ restoreEnv('NODE_ENV', originalNodeEnv);
32
+ restoreEnv('DEPLOY_SUB_CONF', originalSubConf);
33
+ restoreEnv('DEPLOY_ID', originalDeployId);
34
+ restoreEnv('KUBERNETES_SERVICE_HOST', originalKubernetesHost);
35
+ restoreEnv('CONF_RUNTIME_FIXTURE', originalRuntimeFixture);
36
+ for (const key of Object.keys(Config.default)) delete Config.default[key];
37
+ Object.assign(Config.default, structuredClone(originalConfig));
38
+ });
39
+
40
+ it('uses a server sub-configuration only in development', () => {
41
+ vi.spyOn(fs, 'existsSync').mockImplementation((filePath) => `${filePath}`.endsWith('conf.server.dev.nexodev.json'));
42
+ process.env.DEPLOY_SUB_CONF = 'nexodev';
43
+
44
+ process.env.NODE_ENV = 'development';
45
+ expect(getConfFilePath('dd-core', 'server')).to.equal('./engine-private/conf/dd-core/conf.server.dev.nexodev.json');
46
+
47
+ process.env.NODE_ENV = 'production';
48
+ expect(getConfFilePath('dd-core', 'server')).to.equal('./engine-private/conf/dd-core/conf.server.json');
49
+ });
50
+
51
+ it('parses existing deploy files while falling back for missing config types', () => {
52
+ const folder = './engine-private/conf/dd-fixture';
53
+ const files = new Map([
54
+ [`${folder}/conf.server.json`, JSON.stringify({ 'base.test': { '/': { port: 4000 } } })],
55
+ [`${folder}/conf.server.dev.nexodev.json`, JSON.stringify({ 'dev.test': { '/': { port: 4017 } } })],
56
+ [`${folder}/.env.production`, 'DEPLOY_ID=dd-fixture\n'],
57
+ [`${folder}/.env.development`, 'DEPLOY_ID=dd-fixture\n'],
58
+ [`${folder}/.env.test`, 'DEPLOY_ID=dd-fixture\n'],
59
+ [`${folder}/package.json`, JSON.stringify({ name: 'fixture', scripts: { start: 'node src/server dd-fixture' } })],
60
+ ['./package.json', JSON.stringify({ name: 'engine', scripts: { dev: 'node src/server' } })],
61
+ ]);
62
+
63
+ vi.spyOn(fs, 'existsSync').mockImplementation((filePath) => {
64
+ const path = `${filePath}`;
65
+ return path === folder || files.has(path);
66
+ });
67
+ vi.spyOn(fs, 'readFileSync').mockImplementation((filePath) => files.get(`${filePath}`));
68
+ vi.spyOn(fs, 'readdirSync').mockImplementation((dir) =>
69
+ [...files.keys()].filter((path) => path.startsWith(`${dir}/`)).map((path) => path.slice(`${dir}/`.length)),
70
+ );
71
+ vi.spyOn(fs, 'writeFileSync').mockImplementation(() => undefined);
72
+ process.env.NODE_ENV = 'development';
73
+
74
+ loadConf('dd-fixture', 'nexodev');
75
+
76
+ expect(Config.default.server).to.deep.equal({ 'dev.test': { '/': { port: 4017 } } });
77
+ expect(Config.default.client).to.deep.equal(originalConfig.client);
78
+ });
79
+
80
+ // A container carries only the environment it runs: the other two are a host checkout's
81
+ // convenience, and materializing them writes a second and third copy of that deploy's
82
+ // credentials onto a tree the whole `container_t` domain can read.
83
+ it('materializes only the environments the checkout actually carries', () => {
84
+ const folder = './engine-private/conf/dd-narrow';
85
+ const files = new Map([
86
+ [`${folder}/conf.server.json`, JSON.stringify({ 'narrow.test': { '/': { port: 3000 } } })],
87
+ [`${folder}/.env.production`, 'DEPLOY_ID=dd-narrow\nSECRET=value\n'],
88
+ ['./package.json', JSON.stringify({ name: 'underpost-engine', scripts: { start: 'node bin' } })],
89
+ [`${folder}/package.json`, JSON.stringify({ name: 'narrow', scripts: { start: 'node bin' } })],
90
+ ]);
91
+ const written = new Map();
92
+ vi.spyOn(fs, 'existsSync').mockImplementation((path) => `${path}` === folder || files.has(`${path}`));
93
+ vi.spyOn(fs, 'readFileSync').mockImplementation((filePath) => files.get(`${filePath}`));
94
+ vi.spyOn(fs, 'readdirSync').mockImplementation((dir) =>
95
+ [...files.keys()].filter((path) => path.startsWith(`${dir}/`)).map((path) => path.slice(`${dir}/`.length)),
96
+ );
97
+ vi.spyOn(fs, 'writeFileSync').mockImplementation((filePath, value) => written.set(`${filePath}`, `${value}`));
98
+ process.env.NODE_ENV = 'production';
99
+
100
+ loadConf('dd-narrow');
101
+
102
+ expect([...written.keys()].filter((path) => path.startsWith('./.env')).sort()).to.deep.equal([
103
+ './.env',
104
+ './.env.production',
105
+ ]);
106
+ });
107
+
108
+ it('keeps the selected production mode while applying the container overlay', () => {
109
+ const folder = './engine-private/conf/dd-runtime';
110
+ const files = new Map([
111
+ [`${folder}/conf.server.json`, JSON.stringify({ 'runtime.test': { '/': { port: 3000 } } })],
112
+ [`${folder}/.env.production`, 'DEPLOY_ID=dd-runtime\nNODE_ENV=development\nCONF_RUNTIME_FIXTURE=host\n'],
113
+ [`${folder}/.env.production.oci`, 'CONF_RUNTIME_FIXTURE=container\n'],
114
+ [`${folder}/.env.development`, 'DEPLOY_ID=dd-runtime\nNODE_ENV=development\n'],
115
+ [`${folder}/.env.test`, 'DEPLOY_ID=dd-runtime\nNODE_ENV=test\n'],
116
+ [`${folder}/package.json`, JSON.stringify({ name: 'runtime', scripts: { start: 'node src/server' } })],
117
+ ['./package.json', JSON.stringify({ name: 'engine', scripts: { prod: 'node src/server' } })],
118
+ ]);
119
+
120
+ vi.spyOn(fs, 'existsSync').mockImplementation((filePath) => `${filePath}` === folder || files.has(`${filePath}`));
121
+ vi.spyOn(fs, 'readFileSync').mockImplementation((filePath) => files.get(`${filePath}`));
122
+ vi.spyOn(fs, 'readdirSync').mockImplementation((dir) =>
123
+ [...files.keys()].filter((path) => path.startsWith(`${dir}/`)).map((path) => path.slice(`${dir}/`.length)),
124
+ );
125
+ vi.spyOn(fs, 'writeFileSync').mockImplementation((filePath, content) => files.set(`${filePath}`, content));
126
+ process.env.NODE_ENV = 'production';
127
+ process.env.KUBERNETES_SERVICE_HOST = '10.96.0.1';
128
+
129
+ loadConf('dd-runtime');
130
+
131
+ expect(process.env.NODE_ENV).to.equal('production');
132
+ expect(process.env.CONF_RUNTIME_FIXTURE).to.equal('container');
133
+ expect(files.get('./.env')).to.include('CONF_RUNTIME_FIXTURE=container');
134
+ expect(files.get('./.env')).to.not.include('CONF_RUNTIME_FIXTURE=host');
135
+ });
136
+ });
137
+
138
+ describe('OCI runtime env overlay', () => {
139
+ const folder = './engine-private/conf/dd-oci';
140
+ const base = ['# deployment base', 'DEPLOY_ID=dd-oci', 'DB_HOST=mongodb://127.0.0.1:27017', 'PORT=3000'].join('\n');
141
+ const overlay = ['DB_HOST=mongodb://mongodb-0.mongodb-service:27017', 'VALKEY_HOST=valkey-service'].join('\n');
142
+ const originalKubernetesHost = process.env.KUBERNETES_SERVICE_HOST;
143
+
144
+ const mockFiles = (files) => {
145
+ vi.spyOn(fs, 'existsSync').mockImplementation((filePath) => files.has(`${filePath}`));
146
+ vi.spyOn(fs, 'readFileSync').mockImplementation((filePath) => files.get(`${filePath}`));
147
+ vi.spyOn(fs, 'readdirSync').mockImplementation((dir) =>
148
+ [...files.keys()].filter((path) => path.startsWith(`${dir}/`)).map((path) => path.slice(`${dir}/`.length)),
149
+ );
150
+ };
151
+
152
+ afterEach(() => {
153
+ vi.restoreAllMocks();
154
+ restoreEnv('KUBERNETES_SERVICE_HOST', originalKubernetesHost);
155
+ });
156
+
157
+ it('names the overlay per environment, beside the deployment env file', () => {
158
+ vi.spyOn(fs, 'existsSync').mockReturnValue(false);
159
+ expect(deployOciEnvFilePath('dd-oci', 'production')).to.equal(`${folder}/.env.production.oci`);
160
+ expect(deployOciEnvFilePath('dd-oci')).to.equal(`${folder}/.env.production.oci`);
161
+ });
162
+
163
+ it('replaces overridden keys in place and keeps everything else verbatim', () => {
164
+ const merged = ociEnvContentFactory(base, overlay);
165
+ expect(merged.split('\n').filter((line) => line.startsWith('DB_HOST='))).to.have.lengthOf(1);
166
+ expect(merged).to.contain('# deployment base');
167
+ expect(merged).to.contain('PORT=3000');
168
+ expect(merged).to.contain('DB_HOST=mongodb://mongodb-0.mongodb-service:27017');
169
+ expect(merged).to.contain('VALKEY_HOST=valkey-service');
170
+ expect(merged).to.not.contain('mongodb://127.0.0.1:27017');
171
+ });
172
+
173
+ it('leaves the base untouched when the overlay is empty', () => {
174
+ expect(ociEnvContentFactory(base, ' \n')).to.equal(base);
175
+ });
176
+
177
+ it('reads the base file unchanged outside a container', () => {
178
+ delete process.env.KUBERNETES_SERVICE_HOST;
179
+ mockFiles(
180
+ new Map([
181
+ [`${folder}/.env.production`, base],
182
+ [`${folder}/.env.production.oci`, overlay],
183
+ ]),
184
+ );
185
+
186
+ const resolved = deployEnvContentFactory('dd-oci', 'production');
187
+ expect(resolved.overlay).to.equal(null);
188
+ expect(resolved.values.DB_HOST).to.equal('mongodb://127.0.0.1:27017');
189
+ expect(resolved.values.VALKEY_HOST).to.equal(undefined);
190
+ });
191
+
192
+ it('applies the overlay inside a container', () => {
193
+ process.env.KUBERNETES_SERVICE_HOST = '10.96.0.1';
194
+ mockFiles(
195
+ new Map([
196
+ [`${folder}/.env.production`, base],
197
+ [`${folder}/.env.production.oci`, overlay],
198
+ ]),
199
+ );
200
+
201
+ const resolved = deployEnvContentFactory('dd-oci', 'production');
202
+ expect(resolved.source).to.equal(`${folder}/.env.production`);
203
+ expect(resolved.overlay).to.equal(`${folder}/.env.production.oci`);
204
+ expect(resolved.values.DB_HOST).to.equal('mongodb://mongodb-0.mongodb-service:27017');
205
+ expect(resolved.values.VALKEY_HOST).to.equal('valkey-service');
206
+ expect(resolved.values.PORT).to.equal('3000');
207
+ });
208
+
209
+ it('degrades to the base file inside a container with no overlay declared', () => {
210
+ process.env.KUBERNETES_SERVICE_HOST = '10.96.0.1';
211
+ mockFiles(new Map([[`${folder}/.env.production`, base]]));
212
+
213
+ const resolved = deployEnvContentFactory('dd-oci', 'production');
214
+ expect(resolved.overlay).to.equal(null);
215
+ expect(resolved.content).to.equal(base);
216
+ });
217
+
218
+ it('honours an explicit oci selector over container detection', () => {
219
+ delete process.env.KUBERNETES_SERVICE_HOST;
220
+ mockFiles(
221
+ new Map([
222
+ [`${folder}/.env.production`, base],
223
+ [`${folder}/.env.production.oci`, overlay],
224
+ ]),
225
+ );
226
+
227
+ expect(deployEnvContentFactory('dd-oci', 'production', '', { oci: true }).values.VALKEY_HOST).to.equal(
228
+ 'valkey-service',
229
+ );
230
+ });
231
+
232
+ it('overlays a sub-configuration source from the plain environment overlay', () => {
233
+ process.env.KUBERNETES_SERVICE_HOST = '10.96.0.1';
234
+ mockFiles(
235
+ new Map([
236
+ [`${folder}/.env.production`, base],
237
+ [`${folder}/.env.production.api`, `${base}\nPORT=4000`],
238
+ [`${folder}/.env.production.oci`, overlay],
239
+ ]),
240
+ );
241
+
242
+ const resolved = deployEnvContentFactory('dd-oci', 'production', 'api');
243
+ expect(resolved.source).to.equal(`${folder}/.env.production.api`);
244
+ expect(resolved.values.PORT).to.equal('4000');
245
+ expect(resolved.values.DB_HOST).to.equal('mongodb://mongodb-0.mongodb-service:27017');
246
+ });
247
+ });
248
+
249
+ describe('separate client and api development servers', () => {
250
+ const folder = './engine-private/conf/dd-split';
251
+ const originalNodeEnv = process.env.NODE_ENV;
252
+ const base = { deployId: 'dd-split', subConf: 'local', host: 'default.net', path: '/' };
253
+ let written;
254
+
255
+ beforeEach(() => {
256
+ written = new Map([
257
+ [`${folder}/conf.server.dev.local.json`, JSON.stringify({ 'default.net': { '/': { client: 'Default' } } })],
258
+ [`${folder}/.env.development`, 'DEPLOY_ID=dd-split\nPORT=4000\n'],
259
+ ]);
260
+ vi.spyOn(fs, 'existsSync').mockImplementation((filePath) => written.has(`${filePath}`));
261
+ vi.spyOn(fs, 'readFileSync').mockImplementation((filePath) => written.get(`${filePath}`));
262
+ vi.spyOn(fs, 'writeFileSync').mockImplementation((filePath, content) => written.set(`${filePath}`, content));
263
+ process.env.NODE_ENV = 'development';
264
+ });
265
+
266
+ afterEach(() => {
267
+ vi.restoreAllMocks();
268
+ restoreEnv('NODE_ENV', originalNodeEnv);
269
+ });
270
+
271
+ it('derives the api sub-conf and names it back to the caller', async () => {
272
+ expect(await buildApiConf({ ...base, origin: 'http://localhost:4004' })).to.equal('local-dev-api');
273
+ expect(
274
+ JSON.parse(written.get(`${folder}/conf.server.dev.local-dev-api.json`))['default.net']['/'].origins,
275
+ ).to.deep.equal(['http://localhost:4004']);
276
+ expect(written.has(`${folder}/.env.development.local-dev-api`)).to.equal(true);
277
+ });
278
+
279
+ it('derives nothing without a client origin, so an ordinary api run keeps its own sub-conf', async () => {
280
+ expect(await buildApiConf({ ...base })).to.equal(undefined);
281
+ expect(written.has(`${folder}/conf.server.dev.local-dev-api.json`)).to.equal(false);
282
+ });
283
+
284
+ it('refuses an origin for a host/path the sub-conf does not declare', async () => {
285
+ await expect(buildApiConf({ ...base, host: 'other.net', origin: 'http://localhost:4004' })).rejects.toThrow(
286
+ 'No other.net/ instance in conf.server.dev.local.json',
287
+ );
288
+ });
289
+
290
+ it('tells the client server which step has not run yet', async () => {
291
+ await expect(buildClientStaticConf({ ...base })).rejects.toThrow('npm run dev:api dd-split local default.net /');
292
+ });
293
+
294
+ it('points the client at the api port and itself at the origin the api was given', async () => {
295
+ await buildApiConf({ ...base, origin: 'http://localhost:4004' });
296
+ await buildClientStaticConf({ ...base });
297
+
298
+ const instance = JSON.parse(written.get(`${folder}/conf.server.dev.local-dev-client.json`))['default.net']['/'];
299
+ expect(instance.apiBaseHost).to.equal('localhost:4001');
300
+ expect(instance.apiBaseProxyPath).to.equal('/');
301
+ expect(written.get(`${folder}/.env.development.local-dev-client`)).to.include('PORT=4003');
302
+ });
303
+ });