@underpostnet/cyberia 3.3.0 → 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 (471) hide show
  1. package/.dockerignore +1 -0
  2. package/.github/workflows/coverall.cyberia.ci.yml +34 -14
  3. package/.github/workflows/cyberia-client.cd.yml +5 -0
  4. package/.github/workflows/cyberia-server.cd.yml +5 -0
  5. package/.github/workflows/docker-image.cyberia-client.ci.yml +8 -5
  6. package/.github/workflows/docker-image.cyberia-client.dev.ci.yml +8 -3
  7. package/.github/workflows/docker-image.cyberia-server.ci.yml +8 -5
  8. package/.github/workflows/docker-image.cyberia-server.dev.ci.yml +8 -5
  9. package/.github/workflows/docker-image.engine-cyberia.ci.yml +15 -1
  10. package/.github/workflows/docker-image.engine-cyberia.dev.ci.yml +15 -1
  11. package/.github/workflows/engine-cyberia.cd.yml +3 -0
  12. package/.github/workflows/engine-cyberia.ci.yml +4 -5
  13. package/.github/workflows/ghpkg.ci.yml +35 -20
  14. package/.github/workflows/hardhat.ci.yml +12 -11
  15. package/.github/workflows/npmpkg.ci.yml +17 -15
  16. package/.github/workflows/pwa-microservices-template-test.ci.yml +2 -2
  17. package/.github/workflows/release.cd.yml +1 -0
  18. package/.prettierignore +1 -0
  19. package/AGENTS.md +47 -0
  20. package/CHANGELOG.md +565 -2510
  21. package/CLI-HELP.md +306 -147
  22. package/Dockerfile +25 -9
  23. package/Dockerfile.dev +25 -9
  24. package/Dockerfile.test +4 -4
  25. package/README.md +21 -1
  26. package/bin/build.js +66 -41
  27. package/bin/build.template.js +8 -3
  28. package/bin/cyberia.js +308 -91
  29. package/bin/deploy.js +18 -104
  30. package/bin/index.js +308 -91
  31. package/conf.js +91 -4
  32. package/deploy/cyberia-client/deploy.sh +47 -0
  33. package/deploy/cyberia-client/package.sh +18 -0
  34. package/deploy/cyberia-client/state.sh +14 -0
  35. package/deploy/cyberia-server/deploy.sh +47 -0
  36. package/deploy/cyberia-server/package.sh +18 -0
  37. package/deploy/cyberia-server/state.sh +14 -0
  38. package/deploy/dd-cyberia/deploy.sh +6 -26
  39. package/deploy/dd-cyberia/init.sh +35 -43
  40. package/deploy/dd-cyberia/package.sh +17 -0
  41. package/deploy/dd-cyberia/state.sh +14 -0
  42. package/deploy/dd-cyberia/sync-deploy.sh +92 -170
  43. package/deploy/lib/github-actions-logging.sh +594 -0
  44. package/deploy/lib/host.sh +185 -0
  45. package/deploy/lib/state.sh +62 -0
  46. package/deploy/pwa-microservices-template/deploy.sh +12 -39
  47. package/deploy/release/deploy.sh +9 -39
  48. package/deployment.yaml +7 -2
  49. package/docker-compose.yml +7 -7
  50. package/examples/static-page/README.md +19 -19
  51. package/examples/static-page/ssr-components/CustomPage.js +2 -2
  52. package/hardhat/hardhat.config.js +1 -6
  53. package/hardhat/package-lock.json +101 -40
  54. package/hardhat/package.json +2 -2
  55. package/manifests/alertmanager/deployment.yaml +81 -0
  56. package/manifests/blackbox-exporter/deployment.yaml +75 -0
  57. package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml +32 -7
  58. package/manifests/cronjobs/dd-cron/dd-cron-vultr.yaml +32 -7
  59. package/manifests/deployment/dd-cyberia-development/deployment.yaml +7 -2
  60. package/manifests/deployment/dd-default-development/deployment.yaml +2 -2
  61. package/manifests/grafana/deployment.yaml +26 -7
  62. package/manifests/grafana/kustomization.yaml +1 -0
  63. package/manifests/grafana/service.yaml +6 -1
  64. package/manifests/mariadb/pv.yaml +1 -0
  65. package/manifests/mongodb/statefulset.yaml +9 -2
  66. package/manifests/mysql/pv-pvc.yaml +14 -1
  67. package/manifests/postgresql/pv.yaml +12 -1
  68. package/manifests/postgresql/pvc.yaml +1 -0
  69. package/manifests/prometheus/deployment.yaml +18 -22
  70. package/package.json +83 -10
  71. package/scripts/event-monitor.sh +56 -0
  72. package/scripts/k3s-node-setup.sh +27 -14
  73. package/scripts/kubeadm-node-setup.sh +31 -11
  74. package/scripts/maas-setup.sh +8 -8
  75. package/scripts/selinux-normalize.sh +907 -0
  76. package/scripts/shutdown-machine.sh +843 -0
  77. package/scripts/test-monitor.sh +3 -3
  78. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.controller.js +1 -1
  79. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.router.js +2 -2
  80. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.service.js +2 -2
  81. package/src/api/core/core.controller.js +1 -1
  82. package/src/api/core/core.router.js +2 -2
  83. package/src/api/core/core.service.js +2 -2
  84. package/src/api/crypto/crypto.controller.js +1 -1
  85. package/src/api/crypto/crypto.service.js +1 -1
  86. package/src/api/cyberia-action/cyberia-action.controller.js +1 -1
  87. package/src/api/cyberia-action/cyberia-action.router.js +1 -1
  88. package/src/api/cyberia-action/cyberia-action.service.js +2 -2
  89. package/src/api/cyberia-client-hints/cyberia-client-hints.controller.js +1 -1
  90. package/src/api/cyberia-client-hints/cyberia-client-hints.router.js +1 -1
  91. package/src/api/cyberia-client-hints/cyberia-client-hints.service.js +2 -2
  92. package/src/api/cyberia-dialogue/cyberia-dialogue.controller.js +1 -1
  93. package/src/api/cyberia-dialogue/cyberia-dialogue.router.js +1 -1
  94. package/src/api/cyberia-dialogue/cyberia-dialogue.service.js +2 -2
  95. package/src/api/cyberia-entity/cyberia-entity.controller.js +1 -1
  96. package/src/api/cyberia-entity/cyberia-entity.router.js +1 -1
  97. package/src/api/cyberia-entity/cyberia-entity.service.js +2 -2
  98. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.controller.js +1 -1
  99. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.router.js +1 -1
  100. package/src/api/cyberia-entity-type-default/cyberia-entity-type-default.service.js +2 -2
  101. package/src/api/cyberia-instance/cyberia-fallback-capture.js +466 -0
  102. package/src/api/cyberia-instance/cyberia-fallback-world.js +8 -0
  103. package/src/api/cyberia-instance/cyberia-instance-map.service.js +1 -1
  104. package/src/api/cyberia-instance/cyberia-instance.controller.js +1 -1
  105. package/src/api/cyberia-instance/cyberia-instance.router.js +2 -2
  106. package/src/api/cyberia-instance/cyberia-instance.service.js +2 -2
  107. package/src/api/cyberia-instance-conf/cyberia-instance-conf.controller.js +1 -1
  108. package/src/api/cyberia-instance-conf/cyberia-instance-conf.router.js +1 -1
  109. package/src/api/cyberia-instance-conf/cyberia-instance-conf.service.js +2 -2
  110. package/src/api/cyberia-map/cyberia-map.controller.js +1 -1
  111. package/src/api/cyberia-map/cyberia-map.router.js +1 -1
  112. package/src/api/cyberia-map/cyberia-map.service.js +2 -2
  113. package/src/api/cyberia-quest/cyberia-quest.controller.js +1 -1
  114. package/src/api/cyberia-quest/cyberia-quest.router.js +1 -1
  115. package/src/api/cyberia-quest/cyberia-quest.service.js +2 -2
  116. package/src/api/cyberia-quest-progress/cyberia-quest-progress.controller.js +1 -1
  117. package/src/api/cyberia-quest-progress/cyberia-quest-progress.router.js +1 -1
  118. package/src/api/cyberia-quest-progress/cyberia-quest-progress.service.js +2 -2
  119. package/src/api/cyberia-saga/cyberia-saga.controller.js +1 -1
  120. package/src/api/cyberia-saga/cyberia-saga.router.js +1 -1
  121. package/src/api/cyberia-saga/cyberia-saga.service.js +2 -2
  122. package/src/api/cyberia-server-defaults/cyberia-server-defaults.js +0 -26
  123. package/src/api/cyberia-skill/cyberia-skill.controller.js +1 -1
  124. package/src/api/cyberia-skill/cyberia-skill.router.js +1 -1
  125. package/src/api/cyberia-skill/cyberia-skill.service.js +2 -2
  126. package/src/api/default/default.controller.js +1 -1
  127. package/src/api/default/default.router.js +1 -1
  128. package/src/api/default/default.service.js +2 -2
  129. package/src/api/document/document.controller.js +1 -1
  130. package/src/api/document/document.router.js +1 -1
  131. package/src/api/document/document.service.js +2 -2
  132. package/src/api/file/file.controller.js +1 -1
  133. package/src/api/file/file.router.js +1 -1
  134. package/src/api/file/file.service.js +2 -2
  135. package/src/api/instance/instance.controller.js +1 -1
  136. package/src/api/instance/instance.router.js +1 -1
  137. package/src/api/instance/instance.service.js +2 -2
  138. package/src/api/ipfs/ipfs.controller.js +1 -1
  139. package/src/api/ipfs/ipfs.router.js +2 -2
  140. package/src/api/ipfs/ipfs.service.js +2 -2
  141. package/src/api/object-layer/object-layer.controller.js +1 -1
  142. package/src/api/object-layer/object-layer.router.js +2 -2
  143. package/src/api/object-layer/object-layer.service.js +3 -3
  144. package/src/api/object-layer-render-frames/object-layer-render-frames.controller.js +1 -1
  145. package/src/api/object-layer-render-frames/object-layer-render-frames.router.js +1 -1
  146. package/src/api/object-layer-render-frames/object-layer-render-frames.service.js +2 -2
  147. package/src/api/test/test.controller.js +1 -1
  148. package/src/api/test/test.service.js +1 -1
  149. package/src/api/user/guest.service.js +3 -3
  150. package/src/api/user/user.controller.js +1 -1
  151. package/src/api/user/user.router.js +2 -2
  152. package/src/api/user/user.service.js +4 -4
  153. package/src/api.js +5 -9
  154. package/src/cli/app.js +391 -0
  155. package/src/cli/baremetal.js +30 -35
  156. package/src/cli/client.js +306 -0
  157. package/src/cli/cloud-init.js +3 -3
  158. package/src/cli/cluster.js +184 -82
  159. package/src/cli/db.js +120 -68
  160. package/src/cli/deploy.js +153 -71
  161. package/src/cli/docker-compose.js +5 -5
  162. package/src/cli/domains.js +184 -0
  163. package/src/cli/dotenv-store.js +143 -0
  164. package/src/cli/event.js +2281 -0
  165. package/src/cli/fs.js +3 -3
  166. package/src/cli/host.js +672 -0
  167. package/src/cli/image.js +4 -6
  168. package/src/cli/index.js +322 -142
  169. package/src/cli/ipfs.js +34 -30
  170. package/src/cli/kickstart.js +1 -1
  171. package/src/cli/kubectl.js +218 -41
  172. package/src/cli/lxd.js +3 -3
  173. package/src/cli/monitor.js +1359 -26
  174. package/src/cli/package.js +90 -0
  175. package/src/cli/release.js +16 -12
  176. package/src/cli/repository.js +558 -363
  177. package/src/cli/run.js +331 -650
  178. package/src/cli/secrets.js +2158 -964
  179. package/src/cli/ssh.js +478 -279
  180. package/src/cli/state.js +394 -0
  181. package/src/cli/static.js +2 -2
  182. package/src/cli/system.js +1 -1
  183. package/src/cli/test.js +199 -125
  184. package/src/cli/vultr.js +61 -21
  185. package/src/cli/wireguard.js +1111 -306
  186. package/src/client/components/core/CalendarCore.js +53 -96
  187. package/src/client/components/core/Docs.js +258 -211
  188. package/src/client/components/core/FileExplorer.js +0 -21
  189. package/src/client/components/core/PanelForm.js +4 -4
  190. package/src/client/components/core/Repository.js +56 -0
  191. package/src/client/components/core/Translate.js +7 -0
  192. package/src/client/components/core/{FullScreen.js → ViewModeController.js} +42 -39
  193. package/src/client/components/core/Wallet.js +0 -11
  194. package/src/client/components/core/Worker.js +7 -1
  195. package/src/client/components/cryptokoyn/SettingsCryptokoyn.js +2 -2
  196. package/src/client/components/cyberia-portal/AppShellCyberiaPortal.js +2 -1
  197. package/src/client/components/cyberia-portal/SettingsCyberiaPortal.js +2 -2
  198. package/src/client/components/default/AppShellDefault.js +1 -1
  199. package/src/client/components/default/SettingsDefault.js +2 -2
  200. package/src/client/components/itemledger/SettingsItemledger.js +2 -2
  201. package/src/client/components/underpost/AppShellUnderpost.js +3 -2
  202. package/src/client/components/underpost/SettingsUnderpost.js +2 -2
  203. package/src/client/public/cyberia-docs/CYBERIA-CLI.md +32 -5
  204. package/src/client/public/cyberia-docs/CYBERIA.md +21 -1
  205. package/src/client/public/cyberia-docs/HARDHAT-MODULE.md +23 -6
  206. package/src/client/public/cyberia-docs/ROADMAP.md +1 -1
  207. package/src/client/public/cyberia-docs/WHITE-PAPER.md +1 -1
  208. package/src/client/public/default/android-chrome-144x144.png +0 -0
  209. package/src/client/public/default/android-chrome-192x192.png +0 -0
  210. package/src/client/public/default/android-chrome-256x256.png +0 -0
  211. package/src/client/public/default/android-chrome-36x36.png +0 -0
  212. package/src/client/public/default/android-chrome-384x384.png +0 -0
  213. package/src/client/public/default/android-chrome-48x48.png +0 -0
  214. package/src/client/public/default/android-chrome-512x512.png +0 -0
  215. package/src/client/public/default/android-chrome-72x72.png +0 -0
  216. package/src/client/public/default/android-chrome-96x96.png +0 -0
  217. package/src/client/public/default/apple-touch-icon-1024x1024.png +0 -0
  218. package/src/client/public/default/apple-touch-icon-114x114.png +0 -0
  219. package/src/client/public/default/apple-touch-icon-120x120.png +0 -0
  220. package/src/client/public/default/apple-touch-icon-144x144.png +0 -0
  221. package/src/client/public/default/apple-touch-icon-152x152.png +0 -0
  222. package/src/client/public/default/apple-touch-icon-167x167.png +0 -0
  223. package/src/client/public/default/apple-touch-icon-180x180.png +0 -0
  224. package/src/client/public/default/apple-touch-icon-57x57.png +0 -0
  225. package/src/client/public/default/apple-touch-icon-60x60.png +0 -0
  226. package/src/client/public/default/apple-touch-icon-72x72.png +0 -0
  227. package/src/client/public/default/apple-touch-icon-76x76.png +0 -0
  228. package/src/client/public/default/apple-touch-icon-precomposed.png +0 -0
  229. package/src/client/public/default/apple-touch-icon.png +0 -0
  230. package/src/client/public/default/apple-touch-startup-image-1125x2436.png +0 -0
  231. package/src/client/public/default/apple-touch-startup-image-1136x640.png +0 -0
  232. package/src/client/public/default/apple-touch-startup-image-1170x2532.png +0 -0
  233. package/src/client/public/default/apple-touch-startup-image-1179x2556.png +0 -0
  234. package/src/client/public/default/apple-touch-startup-image-1242x2208.png +0 -0
  235. package/src/client/public/default/apple-touch-startup-image-1242x2688.png +0 -0
  236. package/src/client/public/default/apple-touch-startup-image-1284x2778.png +0 -0
  237. package/src/client/public/default/apple-touch-startup-image-1290x2796.png +0 -0
  238. package/src/client/public/default/apple-touch-startup-image-1334x750.png +0 -0
  239. package/src/client/public/default/apple-touch-startup-image-1488x2266.png +0 -0
  240. package/src/client/public/default/apple-touch-startup-image-1536x2048.png +0 -0
  241. package/src/client/public/default/apple-touch-startup-image-1620x2160.png +0 -0
  242. package/src/client/public/default/apple-touch-startup-image-1640x2160.png +0 -0
  243. package/src/client/public/default/apple-touch-startup-image-1668x2224.png +0 -0
  244. package/src/client/public/default/apple-touch-startup-image-1668x2388.png +0 -0
  245. package/src/client/public/default/apple-touch-startup-image-1792x828.png +0 -0
  246. package/src/client/public/default/apple-touch-startup-image-2048x1536.png +0 -0
  247. package/src/client/public/default/apple-touch-startup-image-2048x2732.png +0 -0
  248. package/src/client/public/default/apple-touch-startup-image-2160x1620.png +0 -0
  249. package/src/client/public/default/apple-touch-startup-image-2160x1640.png +0 -0
  250. package/src/client/public/default/apple-touch-startup-image-2208x1242.png +0 -0
  251. package/src/client/public/default/apple-touch-startup-image-2224x1668.png +0 -0
  252. package/src/client/public/default/apple-touch-startup-image-2266x1488.png +0 -0
  253. package/src/client/public/default/apple-touch-startup-image-2388x1668.png +0 -0
  254. package/src/client/public/default/apple-touch-startup-image-2436x1125.png +0 -0
  255. package/src/client/public/default/apple-touch-startup-image-2532x1170.png +0 -0
  256. package/src/client/public/default/apple-touch-startup-image-2556x1179.png +0 -0
  257. package/src/client/public/default/apple-touch-startup-image-2688x1242.png +0 -0
  258. package/src/client/public/default/apple-touch-startup-image-2732x2048.png +0 -0
  259. package/src/client/public/default/apple-touch-startup-image-2778x1284.png +0 -0
  260. package/src/client/public/default/apple-touch-startup-image-2796x1290.png +0 -0
  261. package/src/client/public/default/apple-touch-startup-image-640x1136.png +0 -0
  262. package/src/client/public/default/apple-touch-startup-image-750x1334.png +0 -0
  263. package/src/client/public/default/apple-touch-startup-image-828x1792.png +0 -0
  264. package/src/client/public/default/assets/background/white.jpg +0 -0
  265. package/src/client/public/default/browserconfig.xml +1 -1
  266. package/src/client/public/default/favicon-16x16.png +0 -0
  267. package/src/client/public/default/favicon-32x32.png +0 -0
  268. package/src/client/public/default/favicon-48x48.png +0 -0
  269. package/src/client/public/default/favicon.ico +0 -0
  270. package/src/client/public/default/manifest.webmanifest +5 -5
  271. package/src/client/public/default/mstile-144x144.png +0 -0
  272. package/src/client/public/default/mstile-150x150.png +0 -0
  273. package/src/client/public/default/mstile-310x150.png +0 -0
  274. package/src/client/public/default/mstile-310x310.png +0 -0
  275. package/src/client/public/default/mstile-70x70.png +0 -0
  276. package/src/client/public/default/yandex-browser-50x50.png +0 -0
  277. package/src/client/public/default/yandex-browser-manifest.json +1 -1
  278. package/src/client/ssr/RootDocument.js +1 -1
  279. package/src/client/ssr/body/404.js +1 -1
  280. package/src/client/ssr/body/500.js +1 -1
  281. package/src/client/ssr/body/CacheControl.js +1 -1
  282. package/src/client/ssr/body/CyberiaDefaultSplashScreen.js +1 -1
  283. package/src/client/ssr/body/DefaultSplashScreen.js +1 -1
  284. package/src/client/ssr/body/SwaggerDarkMode.js +1 -1
  285. package/src/client/ssr/body/UnderpostDefaultSplashScreen.js +1 -1
  286. package/src/client/ssr/head/CryptokoynScripts.js +1 -1
  287. package/src/client/ssr/head/Css.js +1 -1
  288. package/src/client/ssr/head/CyberiaPortalScripts.js +1 -1
  289. package/src/client/ssr/head/DefaultScripts.js +1 -1
  290. package/src/client/ssr/head/ItemledgerScripts.js +1 -1
  291. package/src/client/ssr/head/Microdata.js +1 -1
  292. package/src/client/ssr/head/Production.js +1 -1
  293. package/src/client/ssr/head/Pwa.js +1 -1
  294. package/src/client/ssr/head/PwaItemledger.js +1 -1
  295. package/src/client/ssr/head/Seo.js +1 -1
  296. package/src/client/ssr/head/UnderpostScripts.js +1 -1
  297. package/src/client/ssr/mailer/DefaultRecoverEmail.js +1 -1
  298. package/src/client/ssr/mailer/DefaultVerifyEmail.js +1 -1
  299. package/src/client/ssr/views/Cyberia404.js +7 -5
  300. package/src/client/ssr/views/CyberiaServerMetrics.js +1 -1
  301. package/src/client/ssr/views/Maintenance.js +1 -1
  302. package/src/client/ssr/views/NoNetworkConnection.js +1 -1
  303. package/src/client/ssr/views/Test.js +1 -1
  304. package/src/client/sw/core.sw.js +20 -14
  305. package/src/client-builder/client-build-docs.js +61 -46
  306. package/src/client-builder/client-build-live.js +2 -2
  307. package/src/client-builder/client-build.js +38 -30
  308. package/src/client-builder/client-dev-server.js +3 -3
  309. package/src/client-builder/client-icons.js +2 -2
  310. package/src/client-builder/ssr.js +3 -3
  311. package/src/client.build.js +3 -6
  312. package/src/client.dev.js +3 -6
  313. package/src/db/DataBaseProvider.js +186 -3
  314. package/src/db/mariadb/MariaDB.js +3 -2
  315. package/src/db/mongo/MongoBootstrap.js +273 -101
  316. package/src/db/mongo/MongooseDB.js +7 -8
  317. package/src/{server/valkey.js → db/valkey/Valkey.js} +5 -4
  318. package/src/grpc/cyberia/grpc-server.js +1 -1
  319. package/src/index.js +79 -23
  320. package/src/mailer/EmailRender.js +2 -2
  321. package/src/mailer/MailerInterceptor.js +87 -0
  322. package/src/mailer/MailerProvider.js +50 -6
  323. package/src/projects/cyberia/atlas-sprite-sheet-generator.js +1 -1
  324. package/src/projects/cyberia/besu-genesis-generator.js +3 -3
  325. package/src/projects/cyberia/catalog-cyberia.js +53 -10
  326. package/src/projects/cyberia/gemini-client.js +1 -1
  327. package/src/projects/cyberia/generate-saga.js +1 -1
  328. package/src/projects/cyberia/hot-reload-trigger.js +1 -1
  329. package/src/projects/cyberia/instance-data.js +1 -1
  330. package/src/projects/cyberia/ipfs-client.js +4 -4
  331. package/src/projects/cyberia/map-preview-generator.js +1 -1
  332. package/src/projects/cyberia/object-layer.js +1 -1
  333. package/src/projects/cyberia/semantic-layer-generator.js +1 -1
  334. package/src/projects/underpost/catalog-underpost.js +9 -1
  335. package/src/proxy.js +4 -7
  336. package/src/runtime/cyberia-client/Dockerfile +9 -4
  337. package/src/runtime/cyberia-client/Dockerfile.dev +8 -2
  338. package/src/runtime/cyberia-server/Dockerfile +9 -4
  339. package/src/runtime/cyberia-server/Dockerfile.dev +8 -2
  340. package/src/runtime/engine-cyberia/Dockerfile +25 -9
  341. package/src/runtime/engine-cyberia/Dockerfile.dev +25 -9
  342. package/src/runtime/engine-cyberia/Dockerfile.test +4 -4
  343. package/src/runtime/engine-cyberia/docker-compose.yml +7 -7
  344. package/src/runtime/express/Express.js +32 -27
  345. package/src/runtime/lampp/Lampp.js +22 -70
  346. package/src/runtime/nginx/Nginx.js +1 -1
  347. package/src/runtime/wp/Wp.js +16 -48
  348. package/src/server/{catalog.js → build/catalog.js} +15 -5
  349. package/src/server/build/coverage.js +117 -0
  350. package/src/server/build/execution.js +402 -0
  351. package/src/server/build/package.js +465 -0
  352. package/src/server/build/testing.js +528 -0
  353. package/src/server/{dns.js → network/dns.js} +144 -11
  354. package/src/server/{forward-proxy.js → network/forward-proxy.js} +10 -18
  355. package/src/server/{middlewares.js → network/middlewares.js} +3 -3
  356. package/src/server/network/node-capability.js +98 -0
  357. package/src/server/{peer.js → network/peer.js} +3 -3
  358. package/src/server/{proxy.js → network/proxy.js} +7 -13
  359. package/src/server/network/router.js +356 -0
  360. package/src/server/{tls.js → network/tls.js} +2 -2
  361. package/src/server/{underpost-compression.js → network/underpost-compression.js} +1 -1
  362. package/src/server/{underpost-gateway.js → network/underpost-gateway.js} +7 -7
  363. package/src/server/{underpost-ingress.js → network/underpost-ingress.js} +2 -2
  364. package/src/server/{cri.js → ops/cri.js} +2 -2
  365. package/src/server/{cron.js → ops/cron.js} +349 -74
  366. package/src/server/ops/event-notification.js +284 -0
  367. package/src/server/{logger.js → ops/logger.js} +108 -23
  368. package/src/server/ops/monitoring.js +1724 -0
  369. package/src/server/{systemd.js → ops/systemd.js} +55 -1
  370. package/src/server/{conf.js → runtime/conf.js} +513 -422
  371. package/src/server/runtime/config-scope.js +215 -0
  372. package/src/server/runtime/environment.js +149 -0
  373. package/src/server/{process.js → runtime/process.js} +153 -12
  374. package/src/server/{runtime-status.js → runtime/runtime-status.js} +155 -16
  375. package/src/server/{runtime.js → runtime/runtime.js} +12 -8
  376. package/src/server/{start.js → runtime/start.js} +128 -39
  377. package/src/server/{auth.js → security/auth.js} +7 -8
  378. package/src/server/security/container-storage.js +382 -0
  379. package/src/server/{crypto.js → security/crypto.js} +1 -1
  380. package/src/server/{selinux.js → security/selinux.js} +1 -1
  381. package/src/server/{backup.js → storage/backup.js} +17 -8
  382. package/src/server/{data-query.js → storage/data-query.js} +1 -1
  383. package/src/server/{downloader.js → storage/downloader.js} +2 -2
  384. package/src/server/storage/repository.js +68 -0
  385. package/src/server.js +4 -7
  386. package/src/ws/IoInterface.js +1 -1
  387. package/src/ws/IoServer.js +1 -1
  388. package/src/ws/core/core.ws.connection.js +1 -1
  389. package/src/ws/core/core.ws.emit.js +1 -1
  390. package/src/ws/core/core.ws.server.js +1 -1
  391. package/src/ws/default/default.ws.connection.js +1 -1
  392. package/src/ws/default/default.ws.emit.js +1 -1
  393. package/src/ws/default/default.ws.server.js +1 -1
  394. package/test/e2e/event-e2e-public-ingress-down.js +45 -0
  395. package/test/e2e/event-e2e-wireguard-server-down.js +38 -0
  396. package/test/e2e/event-e2e-wireguard-spoke-down.js +40 -0
  397. package/test/{api.test.js → integration/app/api.test.js} +33 -14
  398. package/test/integration/app/cyberia/cyberia-cli-plain-reads.test.js +30 -0
  399. package/test/{cyberia-instance-conf-defaults.test.js → integration/app/cyberia/cyberia-instance-conf-defaults.test.js} +1 -1
  400. package/test/integration/app/cyberia/cyberia-load.test.js +467 -0
  401. package/test/integration/app/cyberia/fallback-world-capture.test.js +253 -0
  402. package/test/integration/app/cyberia/object-layer-item-id.test.js +327 -0
  403. package/test/{shape-generator.test.js → integration/app/cyberia/shape-generator.test.js} +1 -1
  404. package/test/integration/infra/1-security/config-scope.test.js +305 -0
  405. package/test/integration/infra/1-security/container-storage.test.js +356 -0
  406. package/test/integration/infra/1-security/in-pod-cli-surface.test.js +86 -0
  407. package/test/integration/infra/1-security/secret-onboarding.test.js +930 -0
  408. package/test/{selinux.test.js → integration/infra/1-security/selinux.test.js} +2 -4
  409. package/test/{sops-secret-store.test.js → integration/infra/1-security/sops-secret-store.test.js} +415 -61
  410. package/test/integration/infra/1-security/systemd-service.test.js +70 -0
  411. package/test/integration/infra/1-security/underpost-config-secret.test.js +367 -0
  412. package/test/integration/infra/2-network/dns-firewall.test.js +566 -0
  413. package/test/integration/infra/2-network/node-capability.test.js +182 -0
  414. package/test/integration/infra/2-network/wireguard-cli.test.js +1163 -0
  415. package/test/{wireguard-edge.test.js → integration/infra/2-network/wireguard-edge.test.js} +609 -55
  416. package/test/{cluster-instances.test.js → integration/infra/3-cluster/cluster-instances.test.js} +11 -15
  417. package/test/{deploy-node-placement.test.js → integration/infra/3-cluster/deploy-node-placement.test.js} +3 -3
  418. package/test/integration/infra/3-cluster/docker-compose-stack.test.js +313 -0
  419. package/test/integration/infra/4-ingress/deploy-routes.test.js +379 -0
  420. package/test/integration/infra/4-ingress/gateway-static-assets.test.js +453 -0
  421. package/test/{instance-traffic-plan.test.js → integration/infra/4-ingress/instance-traffic-plan.test.js} +10 -6
  422. package/test/{underpost-gateway.test.js → integration/infra/4-ingress/underpost-gateway.test.js} +6 -6
  423. package/test/{underpost-ingress.test.js → integration/infra/4-ingress/underpost-ingress.test.js} +4 -4
  424. package/test/integration/infra/5-observability/cron-jobs.test.js +652 -0
  425. package/test/{deploy-monitor.test.js → integration/infra/5-observability/deploy-monitor.test.js} +29 -31
  426. package/test/integration/infra/5-observability/event-notification.test.js +197 -0
  427. package/test/integration/infra/5-observability/event-remediation.test.js +502 -0
  428. package/test/integration/infra/5-observability/event-targets.test.js +1174 -0
  429. package/test/integration/infra/5-observability/monitoring-stack.test.js +902 -0
  430. package/test/support/shell-harness.js +73 -0
  431. package/test/unit/build-template.test.js +97 -0
  432. package/test/unit/build-workflow-offline.test.js +132 -0
  433. package/test/unit/catalog.test.js +71 -0
  434. package/test/unit/client-build-docs.test.js +334 -0
  435. package/test/unit/conf-loading.test.js +303 -0
  436. package/test/unit/conf-resolution.test.js +979 -0
  437. package/test/unit/coverage-artifact.test.js +130 -0
  438. package/test/{crypto.test.js → unit/crypto.test.js} +1 -1
  439. package/test/unit/deploy-env-resolution.test.js +38 -0
  440. package/test/unit/deploy-log-table.test.js +447 -0
  441. package/test/unit/execution-profiles.test.js +219 -0
  442. package/test/unit/fleet-sync-source.test.js +149 -0
  443. package/test/unit/logger-redaction.test.js +112 -0
  444. package/test/unit/package.test.js +403 -0
  445. package/test/unit/prepare-host.test.js +299 -0
  446. package/test/unit/process-environment.test.js +18 -0
  447. package/test/unit/propagation-message.test.js +78 -0
  448. package/test/unit/redeploy-plan.test.js +24 -0
  449. package/test/unit/release-bump.test.js +474 -0
  450. package/test/unit/ssh-output-redaction.test.js +28 -0
  451. package/test/unit/start-options.test.js +46 -0
  452. package/test/unit/test-tiers.test.js +193 -0
  453. package/vitest.config.js +58 -0
  454. package/.nycrc +0 -9
  455. package/deploy/lib/logging.sh +0 -96
  456. package/manifests/cronjobs/dd-cron/dd-cron-dns.yaml +0 -48
  457. package/manifests/mongodb/pv-pvc.yaml +0 -59
  458. package/scripts/coverall-test-cyberia.sh +0 -24
  459. package/scripts/coverall-test.sh +0 -24
  460. package/scripts/link-local-underpost-cli.sh +0 -6
  461. package/src/api/user/user.build.js +0 -16
  462. package/src/cli/env.js +0 -177
  463. package/src/client/components/core/Blockchain.js +0 -41
  464. package/src/client/components/core/Blog.js +0 -9
  465. package/src/client/components/core/KeyboardAvoidance.js +0 -145
  466. package/src/client/public/default/assets/background/dark.jpg +0 -0
  467. package/src/client/public/default/assets/background/white0-min.jpg +0 -0
  468. package/src/client/public/default/assets/background/white0.jpg +0 -0
  469. package/src/client/public/doc/favicon.ico +0 -0
  470. package/src/client/public/doc/sitemap +0 -148
  471. package/src/server/environment.js +0 -98
@@ -0,0 +1,466 @@
1
+ /**
2
+ * Fallback-world capture — materialise the in-memory procedural world into
3
+ * MongoDB so it can be exported, versioned, and re-imported like any authored
4
+ * instance.
5
+ *
6
+ * The fallback world (cyberia-fallback-world.js) is never persisted: every
7
+ * engine process rebuilds it from code defaults at boot and serves it whenever
8
+ * a requested instance is absent. Capturing it means writing everything that
9
+ * in-memory world serves under a real instance code:
10
+ *
11
+ * - CyberiaInstance — map graph, portal edges, player spawn, item ids
12
+ * - CyberiaMap — one document per generated map (entities included)
13
+ * - CyberiaInstanceConf — the world's simulation config
14
+ * - CyberiaSkill / CyberiaEntityTypeDefault / CyberiaDialogue /
15
+ * CyberiaAction / CyberiaQuest — the content collections the fallback path
16
+ * reads from code defaults INSTEAD of Mongo; a persisted instance reads
17
+ * them from Mongo, so they must exist there for the capture to serve the
18
+ * same world (see instance-data.js#fetchFullInstance).
19
+ *
20
+ * ObjectLayer/atlas assets are NOT generated here — they come from the asset
21
+ * pipeline (`bin/cyberia ol <ids> --import`). The capture reports the missing
22
+ * ids so the caller can stop before writing an incomplete backup.
23
+ *
24
+ * Map and content codes are namespaced under the instance code by default, so
25
+ * two captures never overwrite each other's documents (map/action/quest codes
26
+ * are globally unique). `keepFallbackCodes` preserves the raw
27
+ * `fallback-map-*` / canonical action-quest codes instead.
28
+ *
29
+ * @module src/api/cyberia-instance/cyberia-fallback-capture
30
+ */
31
+
32
+ import { loggerFactory } from '../../server/ops/logger.js';
33
+ import { collectReferencedItemIds } from './cyberia-fallback-world.js';
34
+ import {
35
+ DefaultCyberiaActions,
36
+ DefaultCyberiaQuests,
37
+ DefaultCyberiaDialogues,
38
+ DefaultSkillConfig,
39
+ ENTITY_TYPE_DEFAULTS,
40
+ fillInstanceConfDefaults,
41
+ } from '../cyberia-server-defaults/cyberia-server-defaults.js';
42
+
43
+ const logger = loggerFactory(import.meta);
44
+
45
+ const FALLBACK_MAP_CODE_PREFIX = 'fallback-map-';
46
+
47
+ /** Mongo document keys that must never travel inside a `$set` payload. */
48
+ const DOC_METADATA_KEYS = ['_id', '__v', 'createdAt', 'updatedAt'];
49
+
50
+ const stripDocMetadata = (doc, extraKeys = []) => {
51
+ const out = { ...doc };
52
+ for (const key of [...DOC_METADATA_KEYS, ...extraKeys]) delete out[key];
53
+ return out;
54
+ };
55
+
56
+ const escapeRegExp = (value) => String(value).replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
57
+
58
+ /** Namespaced map code for a captured fallback map (`fallback-map-2` → `X-map-2`). */
59
+ function captureMapCode(mapCode, instanceCode) {
60
+ const suffix = mapCode.startsWith(FALLBACK_MAP_CODE_PREFIX)
61
+ ? mapCode.slice(FALLBACK_MAP_CODE_PREFIX.length)
62
+ : mapCode;
63
+ return `${instanceCode}-map-${suffix}`;
64
+ }
65
+
66
+ /** Namespaced action/quest code for a captured world. */
67
+ const captureContentCode = (code, instanceCode) => `${instanceCode}-${code}`;
68
+
69
+ /**
70
+ * Build the code translation tables for one capture.
71
+ *
72
+ * @param {object} world Result of `generateFallbackWorld()`.
73
+ * @param {string} instanceCode
74
+ * @param {boolean} keepFallbackCodes
75
+ * @returns {{ mapCodes: Map<string,string>, questCodes: Map<string,string>, actionCodes: Map<string,string> }}
76
+ */
77
+ function buildCaptureCodeMaps({ world, instanceCode, keepFallbackCodes, actions, quests }) {
78
+ const mapCodes = new Map();
79
+ const rememberMapCode = (code) => {
80
+ if (!code || mapCodes.has(code)) return;
81
+ mapCodes.set(code, keepFallbackCodes ? code : captureMapCode(code, instanceCode));
82
+ };
83
+
84
+ for (const code of world.instance?.cyberiaMapCodes || []) rememberMapCode(code);
85
+ for (const map of world.maps || []) rememberMapCode(map.code);
86
+ for (const portal of world.instance?.portals || []) {
87
+ rememberMapCode(portal.sourceMapCode);
88
+ rememberMapCode(portal.targetMapCode);
89
+ }
90
+
91
+ const contentCodes = (docs) =>
92
+ new Map(
93
+ (docs || [])
94
+ .filter((doc) => doc?.code)
95
+ .map((doc) => [doc.code, keepFallbackCodes ? doc.code : captureContentCode(doc.code, instanceCode)]),
96
+ );
97
+
98
+ return { mapCodes, actionCodes: contentCodes(actions), questCodes: contentCodes(quests) };
99
+ }
100
+
101
+ /**
102
+ * Translate one default action into its captured form. Returns `null` when the
103
+ * action lives on a map this world does not contain — a persisted instance
104
+ * only ever serves actions bound to its own maps.
105
+ */
106
+ function captureAction(action, { mapCodes, actionCodes, questCodes }) {
107
+ const sourceMapCode = mapCodes.get(action.sourceMapCode);
108
+ if (!sourceMapCode) return null;
109
+ return {
110
+ ...action,
111
+ code: actionCodes.get(action.code) || action.code,
112
+ sourceMapCode,
113
+ questDialogueCodes: (action.questDialogueCodes || []).map((entry) => ({
114
+ ...entry,
115
+ questCode: questCodes.get(entry.questCode) || entry.questCode,
116
+ })),
117
+ };
118
+ }
119
+
120
+ /** Translate one default quest into its captured form (`null` = foreign map). */
121
+ function captureQuest(quest, { mapCodes, questCodes }) {
122
+ const sourceMapCode = mapCodes.get(quest.sourceMapCode);
123
+ if (!sourceMapCode) return null;
124
+ const translate = (codes) => (codes || []).map((code) => questCodes.get(code) || code);
125
+ return {
126
+ ...quest,
127
+ code: questCodes.get(quest.code) || quest.code,
128
+ sourceMapCode,
129
+ prerequisiteCodes: translate(quest.prerequisiteCodes),
130
+ unlocksQuestCodes: translate(quest.unlocksQuestCodes),
131
+ };
132
+ }
133
+
134
+ /**
135
+ * Pure planner: turn an in-memory fallback world into the exact set of
136
+ * documents a capture writes. No I/O — the whole translation is testable
137
+ * without a database.
138
+ *
139
+ * @param {object} params
140
+ * @param {object} params.world Result of `generateFallbackWorld()`.
141
+ * @param {string} params.instanceCode Code the capture is stored under.
142
+ * @param {boolean} [params.keepFallbackCodes=false]
143
+ * @param {Array} [params.actions=DefaultCyberiaActions]
144
+ * @param {Array} [params.quests=DefaultCyberiaQuests]
145
+ * @returns {{
146
+ * instance: object, conf: object, maps: object[], actions: object[], quests: object[],
147
+ * codeMaps: object, skippedActionCodes: string[], skippedQuestCodes: string[], itemIds: string[]
148
+ * }}
149
+ */
150
+ function planFallbackCapture({
151
+ world,
152
+ instanceCode,
153
+ keepFallbackCodes = false,
154
+ actions = DefaultCyberiaActions,
155
+ quests = DefaultCyberiaQuests,
156
+ }) {
157
+ if (!world?.instance || !Array.isArray(world.maps)) throw new Error('planFallbackCapture: invalid world');
158
+ if (!instanceCode) throw new Error('planFallbackCapture: instanceCode is required');
159
+
160
+ const codeMaps = buildCaptureCodeMaps({ world, instanceCode, keepFallbackCodes, actions, quests });
161
+ const { mapCodes } = codeMaps;
162
+
163
+ const maps = world.maps.map((map) => ({
164
+ code: mapCodes.get(map.code) || map.code,
165
+ name: map.name || mapCodes.get(map.code) || map.code,
166
+ description: map.description || '',
167
+ gridX: map.gridX,
168
+ gridY: map.gridY,
169
+ cellWidth: map.cellWidth,
170
+ cellHeight: map.cellHeight,
171
+ entities: (map.entities || []).map((entity) => ({ ...entity })),
172
+ tags: ['fallback', 'procedural', 'captured'],
173
+ }));
174
+
175
+ const spawn = world.instance.playerSpawn || {};
176
+ const instance = {
177
+ code: instanceCode,
178
+ name: instanceCode,
179
+ description: 'Captured procedural fallback world',
180
+ tags: ['fallback', 'procedural', 'captured'],
181
+ cyberiaMapCodes: (world.instance.cyberiaMapCodes || []).map((code) => mapCodes.get(code) || code),
182
+ portals: (world.instance.portals || []).map((portal) => ({
183
+ ...portal,
184
+ sourceMapCode: mapCodes.get(portal.sourceMapCode) || portal.sourceMapCode,
185
+ targetMapCode: mapCodes.get(portal.targetMapCode) || portal.targetMapCode,
186
+ })),
187
+ playerSpawn: {
188
+ ...spawn,
189
+ ...(spawn.sourceMapCode ? { sourceMapCode: mapCodes.get(spawn.sourceMapCode) || spawn.sourceMapCode } : {}),
190
+ },
191
+ topologyMode: 'procedural',
192
+ itemIds: (world.instance.itemIds || []).map((entry) => ({ ...entry })),
193
+ };
194
+
195
+ const conf = { ...fillInstanceConfDefaults(world.config || {}), instanceCode };
196
+
197
+ const capturedActions = [];
198
+ const skippedActionCodes = [];
199
+ for (const action of actions) {
200
+ const captured = captureAction(action, codeMaps);
201
+ if (captured) capturedActions.push(captured);
202
+ else skippedActionCodes.push(action.code);
203
+ }
204
+
205
+ const capturedQuests = [];
206
+ const skippedQuestCodes = [];
207
+ for (const quest of quests) {
208
+ const captured = captureQuest(quest, codeMaps);
209
+ if (captured) capturedQuests.push(captured);
210
+ else skippedQuestCodes.push(quest.code);
211
+ }
212
+
213
+ return {
214
+ instance,
215
+ conf,
216
+ maps,
217
+ actions: capturedActions,
218
+ quests: capturedQuests,
219
+ codeMaps,
220
+ skippedActionCodes,
221
+ skippedQuestCodes,
222
+ itemIds: collectCaptureItemIds({ instance, conf, maps, actions: capturedActions, quests: capturedQuests }),
223
+ };
224
+ }
225
+
226
+ /**
227
+ * Every ObjectLayer item id the captured instance needs an atlas for: what the
228
+ * maps place, what the instance and conf declare, what the seeded skills and
229
+ * entity-type defaults reference, and what the vendor/assembler/quest catalogs
230
+ * draw icons for.
231
+ *
232
+ * @returns {string[]} Sorted, de-duplicated item ids.
233
+ */
234
+ function collectCaptureItemIds({ instance, conf, maps, actions, quests }) {
235
+ const ids = collectReferencedItemIds();
236
+ const push = (id) => {
237
+ if (typeof id === 'string' && id.length > 0 && !id.startsWith('$')) ids.add(id);
238
+ };
239
+
240
+ for (const map of maps || []) {
241
+ for (const entity of map.entities || []) (entity.objectLayerItemIds || []).forEach(push);
242
+ }
243
+ for (const entry of instance?.itemIds || []) push(typeof entry === 'string' ? entry : entry?.id);
244
+
245
+ for (const entityDefault of conf?.entityDefaults || []) {
246
+ (entityDefault.liveItemIds || []).forEach(push);
247
+ (entityDefault.deadItemIds || []).forEach(push);
248
+ (entityDefault.dropItemIds || []).forEach(push);
249
+ for (const slot of entityDefault.defaultObjectLayers || []) push(slot.itemId);
250
+ }
251
+ for (const skillConfig of conf?.skillConfig || []) {
252
+ push(skillConfig.triggerItemId);
253
+ for (const skill of skillConfig.skills || []) push(skill.summonedEntityItemId);
254
+ }
255
+
256
+ for (const action of actions || []) {
257
+ for (const shopItem of action.shopItems || []) {
258
+ push(shopItem.itemId);
259
+ push(shopItem.priceItemId);
260
+ }
261
+ for (const recipe of action.craftRecipes || []) {
262
+ (recipe.ingredients || []).forEach((ingredient) => push(ingredient.itemId));
263
+ (recipe.outputItems || []).forEach((output) => push(output.itemId));
264
+ }
265
+ }
266
+ for (const quest of quests || []) {
267
+ for (const step of quest.steps || []) {
268
+ for (const objective of step.objectives || []) push(objective.itemId);
269
+ }
270
+ for (const reward of quest.rewards || []) push(reward.itemId);
271
+ }
272
+
273
+ return [...ids].sort();
274
+ }
275
+
276
+ /**
277
+ * Insert the content collections the fallback path serves from code defaults.
278
+ *
279
+ * Insert-only: an existing document is left exactly as the operator (or an
280
+ * earlier import) left it, so a capture never silently rewrites content shared
281
+ * with other instances. Returns per-collection insert counts.
282
+ */
283
+ async function seedMissingContentDefaults({ CyberiaSkill, CyberiaEntityTypeDefault, CyberiaDialogue }) {
284
+ const inserted = { skills: 0, entityTypeDefaults: 0, dialogues: 0 };
285
+
286
+ const insertIfMissing = async (Model, filter, doc, counterKey) => {
287
+ if (!Model) return;
288
+ const existing = await Model.findOne(filter).lean();
289
+ if (existing) return;
290
+ await Model.create(doc);
291
+ inserted[counterKey]++;
292
+ };
293
+
294
+ for (const skill of DefaultSkillConfig) {
295
+ await insertIfMissing(
296
+ CyberiaSkill,
297
+ { triggerItemId: skill.triggerItemId },
298
+ { triggerItemId: skill.triggerItemId, logicEventIds: skill.logicEventIds || [], skills: skill.skills || [] },
299
+ 'skills',
300
+ );
301
+ }
302
+
303
+ for (const entityDefault of ENTITY_TYPE_DEFAULTS) {
304
+ await insertIfMissing(
305
+ CyberiaEntityTypeDefault,
306
+ { entityType: entityDefault.entityType, liveItemIds: entityDefault.liveItemIds || [] },
307
+ {
308
+ entityType: entityDefault.entityType,
309
+ liveItemIds: entityDefault.liveItemIds || [],
310
+ deadItemIds: entityDefault.deadItemIds || [],
311
+ dropItemIds: entityDefault.dropItemIds || [],
312
+ defaultObjectLayers: entityDefault.defaultObjectLayers || [],
313
+ behavior: entityDefault.behavior || '',
314
+ },
315
+ 'entityTypeDefaults',
316
+ );
317
+ }
318
+
319
+ for (const dialogue of DefaultCyberiaDialogues) {
320
+ await insertIfMissing(
321
+ CyberiaDialogue,
322
+ { code: dialogue.code, order: dialogue.order },
323
+ { ...dialogue },
324
+ 'dialogues',
325
+ );
326
+ }
327
+
328
+ return inserted;
329
+ }
330
+
331
+ /**
332
+ * Remove documents left over in this capture's own namespace by a previous,
333
+ * larger capture (e.g. a world that used to have more maps). Only ever touches
334
+ * codes prefixed with the instance code, and never runs in `keepFallbackCodes`
335
+ * mode where the codes are the globally shared canonical ones.
336
+ */
337
+ async function pruneStaleCaptureDocs({ models, instanceCode, plan }) {
338
+ const namespace = new RegExp(`^${escapeRegExp(instanceCode)}-`);
339
+ const pruned = { maps: 0, actions: 0, quests: 0 };
340
+
341
+ const prune = async (Model, keepCodes, counterKey) => {
342
+ if (!Model) return;
343
+ const result = await Model.deleteMany({ code: { $regex: namespace, $nin: keepCodes } });
344
+ pruned[counterKey] = result?.deletedCount || 0;
345
+ };
346
+
347
+ await prune(
348
+ models.CyberiaMap,
349
+ plan.maps.map((map) => map.code),
350
+ 'maps',
351
+ );
352
+ await prune(
353
+ models.CyberiaAction,
354
+ plan.actions.map((action) => action.code),
355
+ 'actions',
356
+ );
357
+ await prune(
358
+ models.CyberiaQuest,
359
+ plan.quests.map((quest) => quest.code),
360
+ 'quests',
361
+ );
362
+
363
+ return pruned;
364
+ }
365
+
366
+ /**
367
+ * Materialise an in-memory fallback world into MongoDB under `instanceCode`.
368
+ *
369
+ * Idempotent: every write is an upsert keyed by the document's natural code,
370
+ * so re-running a capture converges on the same state. Nothing is deleted
371
+ * except stale documents inside this capture's own code namespace.
372
+ *
373
+ * @param {object} params
374
+ * @param {object} params.models `{ CyberiaInstance, CyberiaInstanceConf, CyberiaMap, CyberiaAction,
375
+ * CyberiaQuest, CyberiaSkill, CyberiaEntityTypeDefault,
376
+ * CyberiaDialogue, ObjectLayer }`
377
+ * @param {object} params.world Result of `generateFallbackWorld()`.
378
+ * @param {string} params.instanceCode
379
+ * @param {boolean} [params.keepFallbackCodes=false]
380
+ * @returns {Promise<{plan: object, inserted: object, pruned: object, missingObjectLayerItemIds: string[]}>}
381
+ */
382
+ async function captureFallbackWorld({ models, world, instanceCode, keepFallbackCodes = false }) {
383
+ const plan = planFallbackCapture({ world, instanceCode, keepFallbackCodes });
384
+
385
+ // Conf first: the instance document carries the ObjectId ref to it.
386
+ const confDoc = await models.CyberiaInstanceConf.findOneAndUpdate(
387
+ { instanceCode },
388
+ { $set: stripDocMetadata(plan.conf, ['instanceCode']) },
389
+ { upsert: true, returnDocument: 'after' },
390
+ );
391
+ logger.info('Captured CyberiaInstanceConf', { instanceCode });
392
+
393
+ for (const map of plan.maps) {
394
+ await models.CyberiaMap.findOneAndUpdate(
395
+ { code: map.code },
396
+ { $set: stripDocMetadata(map, ['code']) },
397
+ { upsert: true },
398
+ );
399
+ }
400
+ logger.info(`Captured ${plan.maps.length} CyberiaMap document(s)`, { codes: plan.maps.map((m) => m.code) });
401
+
402
+ await models.CyberiaInstance.findOneAndUpdate(
403
+ { code: instanceCode },
404
+ {
405
+ $set: {
406
+ ...stripDocMetadata(plan.instance, ['code']),
407
+ ...(confDoc?._id ? { conf: confDoc._id } : {}),
408
+ },
409
+ $setOnInsert: { status: 'unlisted' },
410
+ },
411
+ { upsert: true },
412
+ );
413
+ logger.info('Captured CyberiaInstance', { code: instanceCode, maps: plan.instance.cyberiaMapCodes.length });
414
+
415
+ for (const action of plan.actions) {
416
+ await models.CyberiaAction.findOneAndUpdate(
417
+ { code: action.code },
418
+ { $set: stripDocMetadata(action, ['code']) },
419
+ { upsert: true },
420
+ );
421
+ }
422
+ for (const quest of plan.quests) {
423
+ await models.CyberiaQuest.findOneAndUpdate(
424
+ { code: quest.code },
425
+ { $set: stripDocMetadata(quest, ['code']) },
426
+ { upsert: true },
427
+ );
428
+ }
429
+ logger.info(`Captured ${plan.actions.length} CyberiaAction and ${plan.quests.length} CyberiaQuest document(s)`);
430
+ if (plan.skippedActionCodes.length > 0 || plan.skippedQuestCodes.length > 0) {
431
+ logger.warn('Skipped mission content bound to maps outside the captured world', {
432
+ actions: plan.skippedActionCodes,
433
+ quests: plan.skippedQuestCodes,
434
+ });
435
+ }
436
+
437
+ const inserted = await seedMissingContentDefaults(models);
438
+ logger.info('Seeded missing content defaults', inserted);
439
+
440
+ // `keepFallbackCodes` reuses the globally shared canonical codes, so nothing
441
+ // in that namespace belongs exclusively to this capture.
442
+ const pruned = keepFallbackCodes
443
+ ? { maps: 0, actions: 0, quests: 0 }
444
+ : await pruneStaleCaptureDocs({ models, instanceCode, plan });
445
+ if (pruned.maps || pruned.actions || pruned.quests)
446
+ logger.info('Pruned stale documents from a previous capture', pruned);
447
+
448
+ const presentItemIds = new Set(
449
+ (await models.ObjectLayer.find({ 'data.item.id': { $in: plan.itemIds } }, { 'data.item.id': 1 }).lean()).map(
450
+ (doc) => doc.data?.item?.id,
451
+ ),
452
+ );
453
+ const missingObjectLayerItemIds = plan.itemIds.filter((id) => !presentItemIds.has(id));
454
+
455
+ return { plan, inserted, pruned, missingObjectLayerItemIds };
456
+ }
457
+
458
+ export {
459
+ planFallbackCapture,
460
+ captureFallbackWorld,
461
+ collectCaptureItemIds,
462
+ captureMapCode,
463
+ captureContentCode,
464
+ seedMissingContentDefaults,
465
+ FALLBACK_MAP_CODE_PREFIX,
466
+ };
@@ -66,6 +66,13 @@ const DEFAULT_GRID_SIZE = 64;
66
66
 
67
67
  const KNOWN_DEFAULT_ITEM_IDS = new Set(DefaultCyberiaItems.map((e) => e.item.id));
68
68
 
69
+ /**
70
+ * Every item id the canonical defaults can place, equip, summon, sell, or
71
+ * craft. Shared with the fallback-world capture, which must resolve an atlas
72
+ * for each of them before writing a backup.
73
+ *
74
+ * @returns {Set<string>}
75
+ */
69
76
  function collectReferencedItemIds() {
70
77
  const ids = new Set();
71
78
  const push = (id) => {
@@ -366,6 +373,7 @@ export {
366
373
  generateFallbackWorld,
367
374
  generateFallbackMap,
368
375
  auditFallbackItemIds,
376
+ collectReferencedItemIds,
369
377
  fallbackListInstance,
370
378
  DEFAULT_FALLBACK_INSTANCE_CODE,
371
379
  };
@@ -25,7 +25,7 @@ import {
25
25
  renderMapPreviewPng,
26
26
  } from '../../projects/cyberia/map-preview-generator.js';
27
27
  import { FileFactory } from '../file/file.service.js';
28
- import { loggerFactory } from '../../server/logger.js';
28
+ import { loggerFactory } from '../../server/ops/logger.js';
29
29
  import {
30
30
  CYBERIA_INSTANCE_CONF_DEFAULTS,
31
31
  DefaultCyberiaActions,
@@ -4,7 +4,7 @@ import {
4
4
  sendBlob,
5
5
  serviceHandler,
6
6
  setCrossOriginHeaders,
7
- } from '../../server/middlewares.js';
7
+ } from '../../server/network/middlewares.js';
8
8
  import { CyberiaInstanceService } from './cyberia-instance.service.js';
9
9
  import { CyberiaInstanceMapService } from './cyberia-instance-map.service.js';
10
10
  import { CyberiaInstanceBootService } from './cyberia-instance-boot.service.js';
@@ -1,6 +1,6 @@
1
1
  import express from 'express';
2
- import { registerCrudRoutes } from '../../server/middlewares.js';
3
- import { userGuard, moderatorGuard } from '../../server/auth.js';
2
+ import { registerCrudRoutes } from '../../server/network/middlewares.js';
3
+ import { userGuard, moderatorGuard } from '../../server/security/auth.js';
4
4
  import { CyberiaInstanceController } from './cyberia-instance.controller.js';
5
5
 
6
6
  class CyberiaInstanceRouter {
@@ -1,6 +1,6 @@
1
1
  import { DataBaseProviderService } from '../../db/DataBaseProvider.js';
2
- import { loggerFactory } from '../../server/logger.js';
3
- import { DataQuery } from '../../server/data-query.js';
2
+ import { loggerFactory } from '../../server/ops/logger.js';
3
+ import { DataQuery } from '../../server/storage/data-query.js';
4
4
  import { connectPortals } from './cyberia-portal-connector.js';
5
5
  import {
6
6
  generateFallbackWorld,
@@ -1,4 +1,4 @@
1
- import { buildCrudController } from '../../server/middlewares.js';
1
+ import { buildCrudController } from '../../server/network/middlewares.js';
2
2
  import { CyberiaInstanceConfService } from './cyberia-instance-conf.service.js';
3
3
 
4
4
  const CyberiaInstanceConfController = buildCrudController(CyberiaInstanceConfService);
@@ -1,5 +1,5 @@
1
1
  import express from 'express';
2
- import { registerCrudRoutes } from '../../server/middlewares.js';
2
+ import { registerCrudRoutes } from '../../server/network/middlewares.js';
3
3
  import { CyberiaInstanceConfController } from './cyberia-instance-conf.controller.js';
4
4
 
5
5
  class CyberiaInstanceConfRouter {
@@ -1,6 +1,6 @@
1
1
  import { DataBaseProviderService } from '../../db/DataBaseProvider.js';
2
- import { loggerFactory } from '../../server/logger.js';
3
- import { DataQuery } from '../../server/data-query.js';
2
+ import { loggerFactory } from '../../server/ops/logger.js';
3
+ import { DataQuery } from '../../server/storage/data-query.js';
4
4
 
5
5
  const logger = loggerFactory(import.meta);
6
6
 
@@ -1,4 +1,4 @@
1
- import { buildCrudController } from '../../server/middlewares.js';
1
+ import { buildCrudController } from '../../server/network/middlewares.js';
2
2
  import { CyberiaMapService } from './cyberia-map.service.js';
3
3
 
4
4
  const CyberiaMapController = buildCrudController(CyberiaMapService);
@@ -1,5 +1,5 @@
1
1
  import express from 'express';
2
- import { registerCrudRoutes } from '../../server/middlewares.js';
2
+ import { registerCrudRoutes } from '../../server/network/middlewares.js';
3
3
  import { CyberiaMapController } from './cyberia-map.controller.js';
4
4
 
5
5
  class CyberiaMapRouter {
@@ -1,6 +1,6 @@
1
1
  import { DataBaseProviderService } from '../../db/DataBaseProvider.js';
2
- import { loggerFactory } from '../../server/logger.js';
3
- import { DataQuery } from '../../server/data-query.js';
2
+ import { loggerFactory } from '../../server/ops/logger.js';
3
+ import { DataQuery } from '../../server/storage/data-query.js';
4
4
 
5
5
  const logger = loggerFactory(import.meta);
6
6
 
@@ -1,4 +1,4 @@
1
- import { buildCrudController, serviceHandler } from '../../server/middlewares.js';
1
+ import { buildCrudController, serviceHandler } from '../../server/network/middlewares.js';
2
2
  import { CyberiaQuestService } from './cyberia-quest.service.js';
3
3
 
4
4
  const CyberiaQuestController = buildCrudController(CyberiaQuestService, {
@@ -1,5 +1,5 @@
1
1
  import express from 'express';
2
- import { registerCrudRoutes } from '../../server/middlewares.js';
2
+ import { registerCrudRoutes } from '../../server/network/middlewares.js';
3
3
  import { CyberiaQuestController } from './cyberia-quest.controller.js';
4
4
 
5
5
  class CyberiaQuestRouter {
@@ -1,6 +1,6 @@
1
1
  import { DataBaseProviderService } from '../../db/DataBaseProvider.js';
2
- import { loggerFactory } from '../../server/logger.js';
3
- import { DataQuery } from '../../server/data-query.js';
2
+ import { loggerFactory } from '../../server/ops/logger.js';
3
+ import { DataQuery } from '../../server/storage/data-query.js';
4
4
  import { DefaultCyberiaQuests } from '../cyberia-server-defaults/cyberia-server-defaults.js';
5
5
 
6
6
  const logger = loggerFactory(import.meta);
@@ -1,4 +1,4 @@
1
- import { buildCrudController } from '../../server/middlewares.js';
1
+ import { buildCrudController } from '../../server/network/middlewares.js';
2
2
  import { CyberiaQuestProgressService } from './cyberia-quest-progress.service.js';
3
3
 
4
4
  const CyberiaQuestProgressController = buildCrudController(CyberiaQuestProgressService);
@@ -1,5 +1,5 @@
1
1
  import express from 'express';
2
- import { registerCrudRoutes } from '../../server/middlewares.js';
2
+ import { registerCrudRoutes } from '../../server/network/middlewares.js';
3
3
  import { CyberiaQuestProgressController } from './cyberia-quest-progress.controller.js';
4
4
 
5
5
  class CyberiaQuestProgressRouter {
@@ -1,6 +1,6 @@
1
1
  import { DataBaseProviderService } from '../../db/DataBaseProvider.js';
2
- import { loggerFactory } from '../../server/logger.js';
3
- import { DataQuery } from '../../server/data-query.js';
2
+ import { loggerFactory } from '../../server/ops/logger.js';
3
+ import { DataQuery } from '../../server/storage/data-query.js';
4
4
 
5
5
  const logger = loggerFactory(import.meta);
6
6
 
@@ -1,4 +1,4 @@
1
- import { buildCrudController } from '../../server/middlewares.js';
1
+ import { buildCrudController } from '../../server/network/middlewares.js';
2
2
  import { CyberiaSagaService } from './cyberia-saga.service.js';
3
3
 
4
4
  const CyberiaSagaController = buildCrudController(CyberiaSagaService);
@@ -1,5 +1,5 @@
1
1
  import express from 'express';
2
- import { registerCrudRoutes } from '../../server/middlewares.js';
2
+ import { registerCrudRoutes } from '../../server/network/middlewares.js';
3
3
  import { CyberiaSagaController } from './cyberia-saga.controller.js';
4
4
 
5
5
  class CyberiaSagaRouter {
@@ -1,6 +1,6 @@
1
1
  import { DataBaseProviderService } from '../../db/DataBaseProvider.js';
2
- import { loggerFactory } from '../../server/logger.js';
3
- import { DataQuery } from '../../server/data-query.js';
2
+ import { loggerFactory } from '../../server/ops/logger.js';
3
+ import { DataQuery } from '../../server/storage/data-query.js';
4
4
 
5
5
  const logger = loggerFactory(import.meta);
6
6