cyberia 3.0.3 → 3.2.5

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 (296) hide show
  1. package/{.env.production → .env.example} +20 -4
  2. package/.github/workflows/engine-cyberia.cd.yml +43 -10
  3. package/.github/workflows/engine-cyberia.ci.yml +48 -26
  4. package/.github/workflows/ghpkg.ci.yml +5 -5
  5. package/.github/workflows/gitlab.ci.yml +1 -1
  6. package/.github/workflows/hardhat.ci.yml +82 -0
  7. package/.github/workflows/npmpkg.ci.yml +60 -14
  8. package/.github/workflows/publish.ci.yml +26 -7
  9. package/.github/workflows/publish.cyberia.ci.yml +5 -5
  10. package/.github/workflows/pwa-microservices-template-page.cd.yml +6 -7
  11. package/.github/workflows/pwa-microservices-template-test.ci.yml +4 -4
  12. package/.github/workflows/release.cd.yml +14 -8
  13. package/.vscode/extensions.json +9 -8
  14. package/.vscode/settings.json +3 -2
  15. package/CHANGELOG.md +643 -1
  16. package/CLI-HELP.md +132 -57
  17. package/Dockerfile +4 -2
  18. package/README.md +347 -22
  19. package/WHITE-PAPER.md +1540 -0
  20. package/bin/build.js +21 -12
  21. package/bin/cyberia.js +2640 -106
  22. package/bin/deploy.js +258 -372
  23. package/bin/file.js +5 -1
  24. package/bin/index.js +2640 -106
  25. package/bin/vs.js +3 -3
  26. package/conf.js +169 -105
  27. package/deployment.yaml +236 -20
  28. package/hardhat/.env.example +31 -0
  29. package/hardhat/README.md +531 -0
  30. package/hardhat/WHITE-PAPER.md +1540 -0
  31. package/hardhat/contracts/ObjectLayerToken.sol +391 -0
  32. package/hardhat/deployments/.gitkeep +0 -0
  33. package/hardhat/deployments/hardhat-ObjectLayerToken.json +11 -0
  34. package/hardhat/hardhat.config.js +136 -0
  35. package/hardhat/ignition/modules/ObjectLayerToken.js +21 -0
  36. package/hardhat/networks/besu-object-layer.network.json +138 -0
  37. package/hardhat/package-lock.json +4323 -0
  38. package/hardhat/package.json +36 -0
  39. package/hardhat/scripts/deployObjectLayerToken.js +98 -0
  40. package/hardhat/test/ObjectLayerToken.js +592 -0
  41. package/hardhat/types/ethers-contracts/ObjectLayerToken.ts +690 -0
  42. package/hardhat/types/ethers-contracts/common.ts +92 -0
  43. package/hardhat/types/ethers-contracts/factories/ObjectLayerToken__factory.ts +1055 -0
  44. package/hardhat/types/ethers-contracts/factories/index.ts +4 -0
  45. package/hardhat/types/ethers-contracts/hardhat.d.ts +47 -0
  46. package/hardhat/types/ethers-contracts/index.ts +6 -0
  47. package/jsdoc.dd-cyberia.json +68 -0
  48. package/jsdoc.json +65 -49
  49. package/manifests/cronjobs/dd-cron/dd-cron-backup.yaml +5 -4
  50. package/manifests/cronjobs/dd-cron/dd-cron-dns.yaml +5 -4
  51. package/manifests/deployment/dd-cyberia-development/deployment.yaml +562 -0
  52. package/manifests/deployment/dd-cyberia-development/proxy.yaml +297 -0
  53. package/manifests/deployment/dd-cyberia-development/pv-pvc.yaml +132 -0
  54. package/manifests/deployment/dd-default-development/deployment.yaml +2 -2
  55. package/manifests/deployment/dd-test-development/deployment.yaml +88 -74
  56. package/manifests/deployment/dd-test-development/proxy.yaml +13 -4
  57. package/manifests/deployment/playwright/deployment.yaml +1 -1
  58. package/manifests/pv-pvc-dd.yaml +1 -1
  59. package/nodemon.json +1 -1
  60. package/package.json +60 -48
  61. package/proxy.yaml +118 -10
  62. package/pv-pvc.yaml +132 -0
  63. package/scripts/k3s-node-setup.sh +1 -1
  64. package/scripts/ports-ls.sh +2 -0
  65. package/scripts/rhel-grpc-setup.sh +56 -0
  66. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.controller.js +47 -1
  67. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.model.js +17 -2
  68. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.router.js +5 -0
  69. package/src/api/atlas-sprite-sheet/atlas-sprite-sheet.service.js +80 -7
  70. package/src/api/cyberia-dialogue/cyberia-dialogue.controller.js +93 -0
  71. package/src/api/cyberia-dialogue/cyberia-dialogue.model.js +36 -0
  72. package/src/api/cyberia-dialogue/cyberia-dialogue.router.js +29 -0
  73. package/src/api/cyberia-dialogue/cyberia-dialogue.service.js +51 -0
  74. package/src/api/cyberia-entity/cyberia-entity.controller.js +74 -0
  75. package/src/api/cyberia-entity/cyberia-entity.model.js +24 -0
  76. package/src/api/cyberia-entity/cyberia-entity.router.js +27 -0
  77. package/src/api/cyberia-entity/cyberia-entity.service.js +42 -0
  78. package/src/api/cyberia-instance/cyberia-fallback-world.js +368 -0
  79. package/src/api/cyberia-instance/cyberia-instance.controller.js +92 -0
  80. package/src/api/cyberia-instance/cyberia-instance.model.js +84 -0
  81. package/src/api/cyberia-instance/cyberia-instance.router.js +63 -0
  82. package/src/api/cyberia-instance/cyberia-instance.service.js +191 -0
  83. package/src/api/cyberia-instance/cyberia-portal-connector.js +486 -0
  84. package/src/api/cyberia-instance-conf/cyberia-instance-conf.controller.js +74 -0
  85. package/src/api/cyberia-instance-conf/cyberia-instance-conf.defaults.js +413 -0
  86. package/src/api/cyberia-instance-conf/cyberia-instance-conf.model.js +228 -0
  87. package/src/api/cyberia-instance-conf/cyberia-instance-conf.router.js +27 -0
  88. package/src/api/cyberia-instance-conf/cyberia-instance-conf.service.js +42 -0
  89. package/src/api/cyberia-map/cyberia-map.controller.js +79 -0
  90. package/src/api/cyberia-map/cyberia-map.model.js +30 -0
  91. package/src/api/cyberia-map/cyberia-map.router.js +40 -0
  92. package/src/api/cyberia-map/cyberia-map.service.js +74 -0
  93. package/src/api/document/document.service.js +1 -1
  94. package/src/api/file/file.controller.js +3 -1
  95. package/src/api/file/file.ref.json +18 -0
  96. package/src/api/file/file.service.js +28 -5
  97. package/src/api/ipfs/ipfs.controller.js +4 -25
  98. package/src/api/ipfs/ipfs.model.js +43 -34
  99. package/src/api/ipfs/ipfs.router.js +8 -13
  100. package/src/api/ipfs/ipfs.service.js +56 -104
  101. package/src/api/object-layer/README.md +347 -22
  102. package/src/api/object-layer/object-layer.controller.js +6 -2
  103. package/src/api/object-layer/object-layer.model.js +12 -8
  104. package/src/api/object-layer/object-layer.router.js +698 -42
  105. package/src/api/object-layer/object-layer.service.js +119 -37
  106. package/src/api/object-layer-render-frames/object-layer-render-frames.model.js +1 -2
  107. package/src/api/user/user.router.js +10 -5
  108. package/src/api/user/user.service.js +15 -14
  109. package/src/cli/baremetal.js +6 -10
  110. package/src/cli/cloud-init.js +0 -3
  111. package/src/cli/cluster.js +7 -7
  112. package/src/cli/db.js +723 -857
  113. package/src/cli/deploy.js +215 -105
  114. package/src/cli/env.js +34 -5
  115. package/src/cli/fs.js +5 -4
  116. package/src/cli/image.js +0 -3
  117. package/src/cli/index.js +83 -15
  118. package/src/cli/kubectl.js +211 -0
  119. package/src/cli/monitor.js +5 -6
  120. package/src/cli/release.js +284 -0
  121. package/src/cli/repository.js +708 -62
  122. package/src/cli/run.js +371 -151
  123. package/src/cli/secrets.js +73 -2
  124. package/src/cli/ssh.js +1 -1
  125. package/src/cli/test.js +3 -3
  126. package/src/client/Cryptokoyn.index.js +3 -4
  127. package/src/client/CyberiaPortal.index.js +3 -4
  128. package/src/client/Default.index.js +3 -4
  129. package/src/client/Itemledger.index.js +4 -963
  130. package/src/client/Underpost.index.js +3 -4
  131. package/src/client/components/core/AgGrid.js +20 -5
  132. package/src/client/components/core/Alert.js +2 -2
  133. package/src/client/components/core/AppStore.js +69 -0
  134. package/src/client/components/core/CalendarCore.js +2 -2
  135. package/src/client/components/core/Content.js +22 -3
  136. package/src/client/components/core/Docs.js +30 -6
  137. package/src/client/components/core/DropDown.js +137 -17
  138. package/src/client/components/core/FileExplorer.js +71 -4
  139. package/src/client/components/core/Input.js +1 -1
  140. package/src/client/components/core/Keyboard.js +2 -2
  141. package/src/client/components/core/LogIn.js +2 -2
  142. package/src/client/components/core/LogOut.js +2 -2
  143. package/src/client/components/core/Modal.js +20 -7
  144. package/src/client/components/core/Panel.js +0 -1
  145. package/src/client/components/core/PanelForm.js +19 -19
  146. package/src/client/components/core/RichText.js +1 -2
  147. package/src/client/components/core/SocketIo.js +82 -29
  148. package/src/client/components/core/SocketIoHandler.js +75 -0
  149. package/src/client/components/core/Stream.js +143 -95
  150. package/src/client/components/core/Webhook.js +40 -7
  151. package/src/client/components/cryptokoyn/AppStoreCryptokoyn.js +5 -0
  152. package/src/client/components/cryptokoyn/LogInCryptokoyn.js +3 -3
  153. package/src/client/components/cryptokoyn/LogOutCryptokoyn.js +2 -2
  154. package/src/client/components/cryptokoyn/MenuCryptokoyn.js +3 -3
  155. package/src/client/components/cryptokoyn/SocketIoCryptokoyn.js +3 -51
  156. package/src/client/components/cyberia/InstanceEngineCyberia.js +700 -0
  157. package/src/client/components/cyberia/MapEngineCyberia.js +1359 -2
  158. package/src/client/components/cyberia/ObjectLayerEngineModal.js +17 -6
  159. package/src/client/components/cyberia/ObjectLayerEngineViewer.js +92 -54
  160. package/src/client/components/cyberia-portal/AppStoreCyberiaPortal.js +5 -0
  161. package/src/client/components/cyberia-portal/CommonCyberiaPortal.js +217 -30
  162. package/src/client/components/cyberia-portal/CssCyberiaPortal.js +44 -2
  163. package/src/client/components/cyberia-portal/LogInCyberiaPortal.js +3 -4
  164. package/src/client/components/cyberia-portal/LogOutCyberiaPortal.js +2 -2
  165. package/src/client/components/cyberia-portal/MenuCyberiaPortal.js +104 -9
  166. package/src/client/components/cyberia-portal/RoutesCyberiaPortal.js +5 -0
  167. package/src/client/components/cyberia-portal/SocketIoCyberiaPortal.js +3 -49
  168. package/src/client/components/cyberia-portal/TranslateCyberiaPortal.js +4 -0
  169. package/src/client/components/default/AppStoreDefault.js +5 -0
  170. package/src/client/components/default/LogInDefault.js +3 -3
  171. package/src/client/components/default/LogOutDefault.js +2 -2
  172. package/src/client/components/default/MenuDefault.js +5 -5
  173. package/src/client/components/default/SocketIoDefault.js +3 -51
  174. package/src/client/components/itemledger/AppStoreItemledger.js +5 -0
  175. package/src/client/components/itemledger/LogInItemledger.js +3 -3
  176. package/src/client/components/itemledger/LogOutItemledger.js +2 -2
  177. package/src/client/components/itemledger/MenuItemledger.js +3 -3
  178. package/src/client/components/itemledger/SocketIoItemledger.js +3 -51
  179. package/src/client/components/underpost/AppStoreUnderpost.js +5 -0
  180. package/src/client/components/underpost/CssUnderpost.js +59 -0
  181. package/src/client/components/underpost/LogInUnderpost.js +6 -3
  182. package/src/client/components/underpost/LogOutUnderpost.js +4 -2
  183. package/src/client/components/underpost/MenuUnderpost.js +104 -18
  184. package/src/client/components/underpost/RoutesUnderpost.js +2 -0
  185. package/src/client/components/underpost/SocketIoUnderpost.js +3 -51
  186. package/src/client/public/cryptokoyn/assets/logo/base-icon.png +0 -0
  187. package/src/client/public/cryptokoyn/browserconfig.xml +12 -0
  188. package/src/client/public/cryptokoyn/microdata.json +85 -0
  189. package/src/client/public/cryptokoyn/site.webmanifest +57 -0
  190. package/src/client/public/cryptokoyn/sitemap +3 -3
  191. package/src/client/public/default/sitemap +3 -3
  192. package/src/client/public/itemledger/browserconfig.xml +2 -2
  193. package/src/client/public/itemledger/manifest.webmanifest +4 -4
  194. package/src/client/public/itemledger/microdata.json +71 -0
  195. package/src/client/public/itemledger/sitemap +3 -3
  196. package/src/client/public/itemledger/yandex-browser-manifest.json +2 -2
  197. package/src/client/public/test/sitemap +3 -3
  198. package/src/client/services/core/core.service.js +20 -8
  199. package/src/client/services/cyberia-dialogue/cyberia-dialogue.service.js +105 -0
  200. package/src/client/services/cyberia-entity/cyberia-entity.management.js +57 -0
  201. package/src/client/services/cyberia-entity/cyberia-entity.service.js +105 -0
  202. package/src/client/services/cyberia-instance/cyberia-instance.management.js +194 -0
  203. package/src/client/services/cyberia-instance/cyberia-instance.service.js +122 -0
  204. package/src/client/services/cyberia-instance-conf/cyberia-instance-conf.service.js +105 -0
  205. package/src/client/services/cyberia-map/cyberia-map.management.js +193 -0
  206. package/src/client/services/cyberia-map/cyberia-map.service.js +126 -0
  207. package/src/client/services/instance/instance.management.js +2 -2
  208. package/src/client/services/ipfs/ipfs.service.js +3 -23
  209. package/src/client/services/object-layer/object-layer.management.js +3 -3
  210. package/src/client/services/object-layer/object-layer.service.js +21 -0
  211. package/src/client/services/user/user.management.js +2 -2
  212. package/src/client/ssr/body/404.js +15 -11
  213. package/src/client/ssr/body/500.js +15 -11
  214. package/src/client/ssr/body/SwaggerDarkMode.js +285 -0
  215. package/src/client/ssr/head/PwaItemledger.js +60 -0
  216. package/src/client/ssr/offline/NoNetworkConnection.js +11 -10
  217. package/src/client/ssr/pages/CyberiaServerMetrics.js +1 -1
  218. package/src/client/ssr/pages/Test.js +11 -10
  219. package/src/client.build.js +0 -3
  220. package/src/client.dev.js +0 -3
  221. package/src/db/DataBaseProvider.js +17 -2
  222. package/src/db/mariadb/MariaDB.js +14 -9
  223. package/src/db/mongo/MongooseDB.js +17 -1
  224. package/src/grpc/cyberia/OFF_CHAIN_ECONOMY.md +305 -0
  225. package/src/grpc/cyberia/README.md +326 -0
  226. package/src/grpc/cyberia/grpc-server.js +530 -0
  227. package/src/index.js +24 -1
  228. package/src/proxy.js +0 -3
  229. package/src/runtime/express/Dockerfile +4 -0
  230. package/src/runtime/express/Express.js +33 -10
  231. package/src/runtime/lampp/Dockerfile +13 -2
  232. package/src/runtime/lampp/Lampp.js +33 -17
  233. package/src/runtime/wp/Dockerfile +68 -0
  234. package/src/runtime/wp/Wp.js +639 -0
  235. package/src/server/auth.js +36 -15
  236. package/src/server/backup.js +39 -12
  237. package/src/server/besu-genesis-generator.js +1630 -0
  238. package/src/server/client-build-docs.js +133 -17
  239. package/src/server/client-build-live.js +9 -18
  240. package/src/server/client-build.js +229 -101
  241. package/src/server/client-dev-server.js +14 -13
  242. package/src/server/client-formatted.js +109 -57
  243. package/src/server/conf.js +391 -164
  244. package/src/server/cron.js +27 -24
  245. package/src/server/dns.js +29 -12
  246. package/src/server/downloader.js +0 -2
  247. package/src/server/ipfs-client.js +24 -1
  248. package/src/server/logger.js +27 -9
  249. package/src/server/object-layer.js +217 -103
  250. package/src/server/peer.js +8 -2
  251. package/src/server/process.js +1 -50
  252. package/src/server/proxy.js +4 -8
  253. package/src/server/runtime.js +30 -9
  254. package/src/server/semantic-layer-generator-floor.js +359 -0
  255. package/src/server/semantic-layer-generator-skin.js +1294 -0
  256. package/src/server/semantic-layer-generator.js +116 -555
  257. package/src/server/ssr.js +0 -3
  258. package/src/server/start.js +19 -12
  259. package/src/server/tls.js +0 -2
  260. package/src/server.js +0 -4
  261. package/src/ws/IoInterface.js +1 -10
  262. package/src/ws/IoServer.js +14 -33
  263. package/src/ws/core/channels/core.ws.chat.js +65 -20
  264. package/src/ws/core/channels/core.ws.mailer.js +113 -32
  265. package/src/ws/core/channels/core.ws.stream.js +90 -31
  266. package/src/ws/core/core.ws.connection.js +12 -33
  267. package/src/ws/core/core.ws.emit.js +10 -26
  268. package/src/ws/core/core.ws.server.js +25 -58
  269. package/src/ws/default/channels/default.ws.main.js +53 -12
  270. package/src/ws/default/default.ws.connection.js +26 -13
  271. package/src/ws/default/default.ws.server.js +30 -12
  272. package/.env.development +0 -43
  273. package/.env.test +0 -43
  274. package/hardhat/contracts/CryptoKoyn.sol +0 -59
  275. package/hardhat/contracts/ItemLedger.sol +0 -73
  276. package/hardhat/contracts/Lock.sol +0 -34
  277. package/hardhat/hardhat.config.cjs +0 -45
  278. package/hardhat/ignition/modules/Lock.js +0 -18
  279. package/hardhat/networks/cryptokoyn-itemledger.network.json +0 -29
  280. package/hardhat/scripts/deployCryptokoyn.cjs +0 -25
  281. package/hardhat/scripts/deployItemledger.cjs +0 -25
  282. package/hardhat/test/Lock.js +0 -126
  283. package/hardhat/white-paper.md +0 -581
  284. package/src/client/components/cryptokoyn/CommonCryptokoyn.js +0 -29
  285. package/src/client/components/cryptokoyn/ElementsCryptokoyn.js +0 -38
  286. package/src/client/components/cyberia-portal/ElementsCyberiaPortal.js +0 -38
  287. package/src/client/components/default/ElementsDefault.js +0 -38
  288. package/src/client/components/itemledger/CommonItemledger.js +0 -29
  289. package/src/client/components/itemledger/ElementsItemledger.js +0 -38
  290. package/src/client/components/underpost/CommonUnderpost.js +0 -29
  291. package/src/client/components/underpost/ElementsUnderpost.js +0 -38
  292. package/src/ws/core/management/core.ws.chat.js +0 -8
  293. package/src/ws/core/management/core.ws.mailer.js +0 -16
  294. package/src/ws/core/management/core.ws.stream.js +0 -8
  295. package/src/ws/default/management/default.ws.main.js +0 -8
  296. package/white-paper.md +0 -581
package/src/server/ssr.js CHANGED
@@ -5,7 +5,6 @@
5
5
  */
6
6
 
7
7
  import fs from 'fs-extra';
8
- import dotenv from 'dotenv';
9
8
  import vm from 'node:vm';
10
9
 
11
10
  import Underpost from '../index.js';
@@ -14,8 +13,6 @@ import { srcFormatted, JSONweb } from './client-formatted.js';
14
13
  import { loggerFactory } from './logger.js';
15
14
  import { getRootDirectory } from './process.js';
16
15
 
17
- dotenv.config();
18
-
19
16
  const logger = loggerFactory(import.meta);
20
17
 
21
18
  /**
@@ -147,27 +147,33 @@ class UnderpostStartUp {
147
147
  * @param {string} deployId - The ID of the deployment.
148
148
  * @param {string} env - The environment of the deployment.
149
149
  * @param {Object} options - Options for the build.
150
+ * @param {boolean} options.skipPullBase - Whether to skip pulling the base code and use the current workspace code directly.
150
151
  * @param {boolean} options.underpostQuicklyInstall - Whether to use underpost quickly install.
151
152
  * @memberof UnderpostStartUp
152
153
  */
153
- async build(deployId = 'dd-default', env = 'development', options = { underpostQuicklyInstall: false }) {
154
+ async build(
155
+ deployId = 'dd-default',
156
+ env = 'development',
157
+ options = { underpostQuicklyInstall: false, skipPullBase: false },
158
+ ) {
154
159
  const buildBasePath = `/home/dd`;
155
160
  const repoName = `engine-${deployId.split('-')[1]}`;
156
- shellExec(`cd ${buildBasePath} && underpost clone ${process.env.GITHUB_USERNAME}/${repoName}`);
157
- shellExec(`mkdir -p ${buildBasePath}/engine`);
158
- shellExec(`cd ${buildBasePath} && sudo cp -a ./${repoName}/. ./engine`);
159
- shellExec(`cd ${buildBasePath} && sudo rm -rf ./${repoName}`);
160
- shellExec(`cd ${buildBasePath}/engine && underpost clone ${process.env.GITHUB_USERNAME}/${repoName}-private`);
161
- shellExec(`cd ${buildBasePath}/engine && sudo mv ./${repoName}-private ./engine-private`);
161
+ if (!options.skipPullBase) {
162
+ shellExec(`cd ${buildBasePath} && underpost clone ${process.env.GITHUB_USERNAME}/${repoName}`);
163
+ shellExec(`mkdir -p ${buildBasePath}/engine`);
164
+ shellExec(`cd ${buildBasePath} && sudo cp -a ./${repoName}/. ./engine`);
165
+ shellExec(`cd ${buildBasePath} && sudo rm -rf ./${repoName}`);
166
+ }
162
167
  shellCd(`${buildBasePath}/engine`);
168
+ Underpost.repo.privateEngineRepoFactory(deployId);
163
169
  shellExec(options?.underpostQuicklyInstall ? `underpost install` : `npm install`);
164
- shellExec(`node bin/deploy conf ${deployId} ${env}`);
170
+ shellExec(`node bin env ${deployId} ${env}`);
165
171
  if (fs.existsSync('./engine-private/itc-scripts')) {
166
172
  const itcScripts = await fs.readdir('./engine-private/itc-scripts');
167
173
  for (const itcScript of itcScripts)
168
174
  if (itcScript.match(deployId)) shellExec(`node ./engine-private/itc-scripts/${itcScript}`);
169
175
  }
170
- shellExec(`node bin/deploy build-full-client ${deployId}`);
176
+ shellExec(`node bin client ${deployId}`);
171
177
  },
172
178
  /**
173
179
  * Runs a deployment.
@@ -177,19 +183,20 @@ class UnderpostStartUp {
177
183
  * @memberof UnderpostStartUp
178
184
  */
179
185
  async run(deployId = 'dd-default', env = 'development', options = {}) {
180
- const runCmd = env === 'production' ? 'run prod-img' : 'run dev-img';
186
+ const runCmd = env === 'production' ? 'run prod:container' : 'run dev:container';
181
187
  if (fs.existsSync(`./engine-private/replica`)) {
182
188
  const replicas = await fs.readdir(`./engine-private/replica`);
183
189
  for (const replica of replicas) {
184
190
  if (!replica.match(deployId)) continue;
185
- shellExec(`node bin/deploy conf ${replica} ${env}`);
191
+ shellExec(`node bin env ${replica} ${env}`);
186
192
  shellExec(`npm ${runCmd} ${replica}`, { async: true });
187
193
  await awaitDeployMonitor(true);
188
194
  }
189
195
  }
190
- shellExec(`node bin/deploy conf ${deployId} ${env}`);
196
+ shellExec(`node bin env ${deployId} ${env}`);
191
197
  shellExec(`npm ${runCmd} ${deployId}`, { async: true });
192
198
  await awaitDeployMonitor(true);
199
+ if (env === 'production' && Underpost.env.isInsideContainer()) Underpost.secret.globalSecretClean();
193
200
  Underpost.env.set('container-status', `${deployId}-${env}-running-deployment`);
194
201
  },
195
202
  };
package/src/server/tls.js CHANGED
@@ -7,10 +7,8 @@
7
7
  import fs from 'fs-extra';
8
8
  import https from 'https';
9
9
  import path from 'path';
10
- import dotenv from 'dotenv';
11
10
  import { loggerFactory } from './logger.js';
12
11
 
13
- dotenv.config();
14
12
  const logger = loggerFactory(import.meta);
15
13
 
16
14
  const DEFAULT_HOST = 'localhost';
package/src/server.js CHANGED
@@ -3,15 +3,11 @@
3
3
  // https://nodejs.org/api
4
4
  // https://expressjs.com/en/4x/api.html
5
5
 
6
- import dotenv from 'dotenv';
7
6
  import { loggerFactory } from './server/logger.js';
8
7
  import { buildClient } from './server/client-build.js';
9
8
  import { buildRuntime } from './server/runtime.js';
10
9
  import { ProcessController } from './server/process.js';
11
10
  import { Config } from './server/conf.js';
12
-
13
- dotenv.config();
14
-
15
11
  await Config.build();
16
12
 
17
13
  const logger = loggerFactory(import.meta);
@@ -126,13 +126,4 @@ class IoChannel {
126
126
  }
127
127
  }
128
128
 
129
- /**
130
- * Backward compatibility function to create a new channel instance.
131
- * @memberof SocketIoInterface
132
- * @function IoCreateChannel
133
- * @param {ChannelInterface} IoInterface - The interface object defining the channel's behavior.
134
- * @returns {IoChannel} An instance of the IoChannel class.
135
- */
136
- const IoCreateChannel = (IoInterface) => new IoChannel(IoInterface);
137
-
138
- export { IoChannel, IoCreateChannel };
129
+ export { IoChannel };
@@ -1,7 +1,6 @@
1
1
  /**
2
2
  * Module for creating and managing WebSocket servers.
3
- * @module src/ws/IoServer
4
- * @namespace SocketIoServer
3
+ * @module ws/IoServer
5
4
  */
6
5
 
7
6
  'use strict';
@@ -9,33 +8,27 @@
9
8
  import { Server } from 'socket.io';
10
9
  import { loggerFactory } from '../server/logger.js';
11
10
  import Underpost from '../index.js';
12
- import http from 'http';
13
11
 
14
12
  const logger = loggerFactory(import.meta);
15
13
 
16
14
  /**
17
- * @class IoServerClass
18
- * @alias IoServerClass
19
- * @memberof SocketIoServer
20
- * @classdesc Provides a static factory method to create and configure a Socket.IO server,
21
- * encapsulating WebSocket server initialization logic and CORS configuration.
15
+ * @class IoServer
16
+ * @classdesc Factory for creating and configuring Socket.IO server instances
17
+ * with CORS configuration and HTTP server attachment.
22
18
  */
23
- class IoServerClass {
19
+ class IoServer {
24
20
  /**
25
21
  * Creates a new WebSocket server instance attached to an HTTP server.
26
22
  *
27
23
  * @static
28
- * @param {http.Server} httpServer - The HTTP server instance to attach the WebSocket server to.
29
- * @param {Object} options - Configuration options for the WebSocket server.
30
- * @param {string[]} options.origins - List of allowed origins for Cross-Origin Resource Sharing (CORS).
31
- * @param {string} options.path - The base path for the API. The WebSocket path ('/socket.io') will be appended to this.
32
- * @param {function(import('socket.io').Socket): void} ConnectionHandler - The connection handler function to be executed on a new connection.
33
- * @returns {Object} An object containing the final options and the server instance.
34
- * @returns {import('socket.io').ServerOptions} return.options - The final options object used to create the WebSocket server.
35
- * @returns {import('socket.io').Server} return.ioServer - The created and listening WebSocket server instance.
36
- * @returns {object} return.meta - The module's import meta object (`import.meta`).
24
+ * @param {import('http').Server} httpServer - The HTTP server instance to attach to.
25
+ * @param {Object} options - Configuration options.
26
+ * @param {string[]} options.origins - Allowed CORS origins.
27
+ * @param {string} options.path - Base API path. Socket.IO path is appended automatically.
28
+ * @param {function(import('socket.io').Socket): void} connectionHandler - Handler for new connections.
29
+ * @returns {{ options: import('socket.io').ServerOptions, ioServer: import('socket.io').Server, meta: ImportMeta }}
37
30
  */
38
- static create(httpServer, options = {}, ConnectionHandler = () => {}) {
31
+ static create(httpServer, options = {}, connectionHandler = () => {}) {
39
32
  logger.info('origins', options.origins);
40
33
  const wsOptions = {
41
34
  cors: {
@@ -55,12 +48,11 @@ class IoServerClass {
55
48
  ],
56
49
  credentials: true,
57
50
  },
58
- // Ensure the path ends correctly, appending '/socket.io/'
59
51
  path: options.path !== '/' ? `${options.path}/socket.io/` : '/socket.io/',
60
52
  };
61
53
 
62
54
  const ioServerInstance = Underpost.start.listenServerFactory(() =>
63
- new Server(httpServer, wsOptions).on('connection', ConnectionHandler),
55
+ new Server(httpServer, wsOptions).on('connection', connectionHandler),
64
56
  );
65
57
 
66
58
  logger.info('Socket.IO Server created and listening', { path: wsOptions.path });
@@ -73,15 +65,4 @@ class IoServerClass {
73
65
  }
74
66
  }
75
67
 
76
- /**
77
- * Backward compatibility export for the server creation function.
78
- * @memberof SocketIoServer
79
- * @function IoServer
80
- * @param {http.Server} httpServer - The HTTP server instance.
81
- * @param {Object} options - Configuration options.
82
- * @param {function(import('socket.io').Socket): void} ConnectionHandler - The connection handler function.
83
- * @returns {Object} The server configuration object.
84
- */
85
- const IoServer = IoServerClass.create;
86
-
87
- export { IoServerClass, IoServer };
68
+ export { IoServer };
@@ -1,23 +1,68 @@
1
- import { loggerFactory } from '../../../server/logger.js';
2
- import { IoCreateChannel } from '../../IoInterface.js';
3
- import { CoreWsEmit } from '../core.ws.emit.js';
4
-
5
- const channel = 'chat';
6
- const logger = loggerFactory(import.meta);
7
-
8
- const CoreWsChatController = {
9
- channel,
10
- controller: function (socket, client, payload, wsManagementId) {
11
- for (const socketId of Object.keys(client)) {
12
- if (socketId !== socket.id) {
13
- CoreWsEmit(channel, client[socketId], { id: socket.id, ...payload });
1
+ /**
2
+ * Chat WebSocket channel — broadcasts messages to all connected sockets except the sender.
3
+ * @module ws/core/channels/core.ws.chat
4
+ */
5
+
6
+ import { IoChannel } from '../../IoInterface.js';
7
+ import { CoreWsEmitter } from '../core.ws.emit.js';
8
+
9
+ /**
10
+ * @class CoreWsChatChannel
11
+ * @classdesc Manages the chat WebSocket channel with per-instance state.
12
+ * Broadcasts incoming messages to all other connected sockets.
13
+ */
14
+ class CoreWsChatChannel {
15
+ /** @type {Object.<string, Object>} Per-instance state keyed by wsManagementId. */
16
+ static #state = {};
17
+
18
+ /** @type {IoChannel} */
19
+ static #io = new IoChannel({
20
+ channel: 'chat',
21
+ controller(socket, client, payload, wsManagementId) {
22
+ for (const socketId of Object.keys(client)) {
23
+ if (socketId !== socket.id) {
24
+ CoreWsEmitter.emit('chat', client[socketId], { id: socket.id, ...payload });
25
+ }
14
26
  }
15
- }
16
- },
17
- connection: function (socket, client, wsManagementId) {},
18
- disconnect: function (socket, client, reason, wsManagementId) {},
19
- };
27
+ },
28
+ });
29
+
30
+ /** @returns {Object.<string, import('socket.io').Socket>} Connected sockets map. */
31
+ static get client() {
32
+ return this.#io.client;
33
+ }
34
+
35
+ /** @returns {string} Channel name. */
36
+ static get channel() {
37
+ return this.#io.channel;
38
+ }
39
+
40
+ /**
41
+ * Initializes state for a server instance.
42
+ * @param {string} wsManagementId - Unique server context ID.
43
+ */
44
+ static init(wsManagementId) {
45
+ this.#state[wsManagementId] = {};
46
+ }
47
+
48
+ /**
49
+ * Registers a socket connection.
50
+ * @param {import('socket.io').Socket} socket
51
+ * @param {string} wsManagementId
52
+ */
53
+ static connection(socket, wsManagementId) {
54
+ return this.#io.connection(socket, wsManagementId);
55
+ }
20
56
 
21
- const CoreWsChatChannel = IoCreateChannel(CoreWsChatController);
57
+ /**
58
+ * Handles socket disconnection.
59
+ * @param {import('socket.io').Socket} socket
60
+ * @param {string} reason
61
+ * @param {string} wsManagementId
62
+ */
63
+ static disconnect(socket, reason, wsManagementId) {
64
+ return this.#io.disconnect(socket, reason, wsManagementId);
65
+ }
66
+ }
22
67
 
23
- export { CoreWsChatChannel, CoreWsChatController };
68
+ export { CoreWsChatChannel };
@@ -1,35 +1,116 @@
1
- import { loggerFactory } from '../../../server/logger.js';
2
- import { IoCreateChannel } from '../../IoInterface.js';
3
- import { CoreWsMailerManagement } from '../management/core.ws.mailer.js';
4
-
5
- const channel = 'mailer';
6
- const logger = loggerFactory(import.meta);
7
-
8
- const CoreWsMailerController = {
9
- channel,
10
- controller: function (socket, client, payload, wsManagementId) {
11
- switch (payload.status) {
12
- case 'register-user':
13
- CoreWsMailerManagement.element[wsManagementId][socket.id] = {
14
- model: {
15
- user: payload.user,
16
- },
17
- };
18
- break;
19
- case 'unregister-user':
20
- delete CoreWsMailerManagement.element[wsManagementId][socket.id];
21
- break;
22
-
23
- default:
24
- break;
1
+ /**
2
+ * Mailer WebSocket channel — manages user↔socket bidirectional mapping
3
+ * for targeted real-time pushes (e.g. email confirmation notifications).
4
+ * @module ws/core/channels/core.ws.mailer
5
+ */
6
+
7
+ import { IoChannel } from '../../IoInterface.js';
8
+
9
+ /**
10
+ * @class CoreWsMailerChannel
11
+ * @classdesc Manages the mailer WebSocket channel with O(1) user↔socket lookup.
12
+ * Handles register/unregister messages and cleanup on disconnect.
13
+ */
14
+ class CoreWsMailerChannel {
15
+ /** @type {Object.<string, Object.<string, { model: { user: Object } }>>} Socket data keyed by `[wsManagementId][socketId]`. */
16
+ static #data = {};
17
+
18
+ /** @type {Object.<string, Object.<string, string>>} Reverse index: `[wsManagementId][userId]` → socketId. */
19
+ static #userIndex = {};
20
+
21
+ /** @type {IoChannel} */
22
+ static #io = new IoChannel({
23
+ channel: 'mailer',
24
+ controller(socket, client, payload, wsManagementId) {
25
+ switch (payload.status) {
26
+ case 'register-user':
27
+ CoreWsMailerChannel.setUser(wsManagementId, socket.id, payload.user);
28
+ break;
29
+ case 'unregister-user':
30
+ CoreWsMailerChannel.removeSocket(wsManagementId, socket.id);
31
+ break;
32
+ default:
33
+ break;
34
+ }
35
+ },
36
+ disconnect(socket, client, reason, wsManagementId) {
37
+ CoreWsMailerChannel.removeSocket(wsManagementId, socket.id);
38
+ },
39
+ });
40
+
41
+ /** @returns {Object.<string, import('socket.io').Socket>} Connected sockets map. */
42
+ static get client() {
43
+ return this.#io.client;
44
+ }
45
+
46
+ /** @returns {string} Channel name. */
47
+ static get channel() {
48
+ return this.#io.channel;
49
+ }
50
+
51
+ /**
52
+ * Initializes state for a server instance.
53
+ * @param {string} wsManagementId - Unique server context ID (`${host}${path}`).
54
+ */
55
+ static init(wsManagementId) {
56
+ this.#data[wsManagementId] = {};
57
+ this.#userIndex[wsManagementId] = {};
58
+ }
59
+
60
+ /**
61
+ * Registers a socket connection.
62
+ * @param {import('socket.io').Socket} socket
63
+ * @param {string} wsManagementId
64
+ */
65
+ static connection(socket, wsManagementId) {
66
+ return this.#io.connection(socket, wsManagementId);
67
+ }
68
+
69
+ /**
70
+ * Handles socket disconnection.
71
+ * @param {import('socket.io').Socket} socket
72
+ * @param {string} reason
73
+ * @param {string} wsManagementId
74
+ */
75
+ static disconnect(socket, reason, wsManagementId) {
76
+ return this.#io.disconnect(socket, reason, wsManagementId);
77
+ }
78
+
79
+ /**
80
+ * Registers a user↔socket mapping.
81
+ * @param {string} wsManagementId
82
+ * @param {string} socketId
83
+ * @param {Object} user - User data with `_id` property.
84
+ */
85
+ static setUser(wsManagementId, socketId, user) {
86
+ this.#data[wsManagementId][socketId] = { model: { user } };
87
+ if (user?._id) {
88
+ this.#userIndex[wsManagementId][user._id.toString()] = socketId;
89
+ }
90
+ }
91
+
92
+ /**
93
+ * Removes a socket entry and its reverse user index.
94
+ * @param {string} wsManagementId
95
+ * @param {string} socketId
96
+ */
97
+ static removeSocket(wsManagementId, socketId) {
98
+ const entry = this.#data[wsManagementId]?.[socketId];
99
+ if (entry?.model?.user?._id) {
100
+ delete this.#userIndex[wsManagementId][entry.model.user._id.toString()];
25
101
  }
26
- },
27
- connection: function (socket, client, wsManagementId) {},
28
- disconnect: function (socket, client, reason, wsManagementId) {
29
- delete CoreWsMailerManagement.element[wsManagementId][socket.id];
30
- },
31
- };
102
+ delete this.#data[wsManagementId]?.[socketId];
103
+ }
32
104
 
33
- const CoreWsMailerChannel = IoCreateChannel(CoreWsMailerController);
105
+ /**
106
+ * Finds the socket ID for a user (O(1) reverse index lookup).
107
+ * @param {string} wsManagementId
108
+ * @param {string} userId - The user `_id`.
109
+ * @returns {string|undefined} Socket ID, or `undefined` if not connected.
110
+ */
111
+ static getUserWsId(wsManagementId, userId) {
112
+ return this.#userIndex[wsManagementId]?.[userId];
113
+ }
114
+ }
34
115
 
35
- export { CoreWsMailerChannel, CoreWsMailerController };
116
+ export { CoreWsMailerChannel };
@@ -1,31 +1,90 @@
1
- import { loggerFactory } from '../../../server/logger.js';
2
- import { IoCreateChannel } from '../../IoInterface.js';
3
- import { CoreWsStreamManagement } from '../management/core.ws.stream.js';
4
-
5
- const channel = 'stream';
6
- const logger = loggerFactory(import.meta);
7
-
8
- const CoreWsStreamController = {
9
- channel,
10
- stream: true,
11
- controller: function (socket, client, payload, wsManagementId, args) {
12
- const [roomId, userId] = args;
13
- CoreWsStreamManagement.element[wsManagementId][socket.id] = args;
14
-
15
- socket.join(roomId); // Join the room
16
- socket.broadcast.emit(`${channel}-user-connected`, userId); // Tell everyone else in the room that we joined
17
- },
18
- connection: function (socket, client, wsManagementId) {
19
- CoreWsStreamManagement.element[wsManagementId][socket.id] = [];
20
- },
21
- disconnect: function (socket, client, reason, wsManagementId) {
22
- // Communicate the disconnection
23
- const [roomId, userId] = CoreWsStreamManagement.element[wsManagementId][socket.id];
24
- socket.broadcast.emit(`${channel}-user-disconnected`, userId);
25
- delete CoreWsStreamManagement.element[wsManagementId][socket.id];
26
- },
27
- };
28
-
29
- const CoreWsStreamChannel = IoCreateChannel(CoreWsStreamController);
30
-
31
- export { CoreWsStreamChannel, CoreWsStreamController };
1
+ /**
2
+ * Stream WebSocket channel — manages per-socket room membership and user tracking.
3
+ * @module ws/core/channels/core.ws.stream
4
+ */
5
+
6
+ import { IoChannel } from '../../IoInterface.js';
7
+
8
+ /**
9
+ * @class CoreWsStreamChannel
10
+ * @classdesc Manages the stream WebSocket channel. Each socket can join a room
11
+ * and broadcast connection/disconnection events to other room members.
12
+ */
13
+ class CoreWsStreamChannel {
14
+ /** @type {Object.<string, Object.<string, Array>>} Per-socket room/user args keyed by `[wsManagementId][socketId]`. */
15
+ static #state = {};
16
+
17
+ /** @type {IoChannel} */
18
+ static #io = new IoChannel({
19
+ channel: 'stream',
20
+ stream: true,
21
+ controller(socket, client, payload, wsManagementId, args) {
22
+ const [roomId, userId] = args;
23
+
24
+ // Collect existing users in the room before registering the new one
25
+ const existingUsers = [];
26
+ for (const entry of Object.values(CoreWsStreamChannel.#state[wsManagementId])) {
27
+ if (entry[0] === roomId && entry[1]) existingUsers.push(entry[1]);
28
+ }
29
+
30
+ CoreWsStreamChannel.#state[wsManagementId][socket.id] = args;
31
+ socket.join(roomId);
32
+ socket.to(roomId).emit('stream-user-connected', userId);
33
+
34
+ // Tell the joining user about everyone already in the room
35
+ if (existingUsers.length > 0) socket.emit('stream-existing-users', existingUsers);
36
+ },
37
+ connection(socket, client, wsManagementId) {
38
+ CoreWsStreamChannel.#state[wsManagementId][socket.id] = [];
39
+ },
40
+ disconnect(socket, client, reason, wsManagementId) {
41
+ const entry = CoreWsStreamChannel.#state[wsManagementId]?.[socket.id];
42
+ if (!entry || entry.length === 0) {
43
+ if (CoreWsStreamChannel.#state[wsManagementId]) delete CoreWsStreamChannel.#state[wsManagementId][socket.id];
44
+ return;
45
+ }
46
+ const [roomId, userId] = entry;
47
+ socket.to(roomId).emit('stream-user-disconnected', userId);
48
+ delete CoreWsStreamChannel.#state[wsManagementId][socket.id];
49
+ },
50
+ });
51
+
52
+ /** @returns {Object.<string, import('socket.io').Socket>} Connected sockets map. */
53
+ static get client() {
54
+ return this.#io.client;
55
+ }
56
+
57
+ /** @returns {string} Channel name. */
58
+ static get channel() {
59
+ return this.#io.channel;
60
+ }
61
+
62
+ /**
63
+ * Initializes state for a server instance.
64
+ * @param {string} wsManagementId - Unique server context ID (`${host}${path}`).
65
+ */
66
+ static init(wsManagementId) {
67
+ this.#state[wsManagementId] = {};
68
+ }
69
+
70
+ /**
71
+ * Registers a socket connection.
72
+ * @param {import('socket.io').Socket} socket
73
+ * @param {string} wsManagementId
74
+ */
75
+ static connection(socket, wsManagementId) {
76
+ return this.#io.connection(socket, wsManagementId);
77
+ }
78
+
79
+ /**
80
+ * Handles socket disconnection.
81
+ * @param {import('socket.io').Socket} socket
82
+ * @param {string} reason
83
+ * @param {string} wsManagementId
84
+ */
85
+ static disconnect(socket, reason, wsManagementId) {
86
+ return this.#io.disconnect(socket, reason, wsManagementId);
87
+ }
88
+ }
89
+
90
+ export { CoreWsStreamChannel };
@@ -1,47 +1,36 @@
1
1
  /**
2
- * Module for handling new WebSocket connections and setting up channel listeners.
3
- * @module ws/core.ws.connection
4
- * @namespace CoreWsConnection
2
+ * Core WebSocket connection handler wires sockets to all channels.
3
+ * @module ws/core/core.ws.connection
5
4
  */
6
5
 
7
6
  import { loggerFactory } from '../../server/logger.js';
8
7
  import { CoreWsChatChannel } from './channels/core.ws.chat.js';
9
8
  import { CoreWsMailerChannel } from './channels/core.ws.mailer.js';
10
9
  import { CoreWsStreamChannel } from './channels/core.ws.stream.js';
11
- import { Socket } from 'socket.io'; // Added for JSDoc type hinting
12
10
 
13
11
  const logger = loggerFactory(import.meta);
14
12
 
15
13
  /**
16
- * @class CoreWsConnectionManager
17
- * @alias CoreWsConnectionManager
18
- * @memberof CoreWsConnection
19
- * @classdesc Manages the lifecycle of a new WebSocket connection, setting up listeners for
20
- * all registered channels (Chat, Mailer, Stream) and handling disconnection by delegating to channel handlers.
14
+ * @class CoreWsConnectionHandler
15
+ * @classdesc Subscribes a new socket to all core channels (chat, mailer, stream)
16
+ * and delegates disconnect events to each channel.
21
17
  */
22
- class CoreWsConnectionManager {
18
+ class CoreWsConnectionHandler {
23
19
  /**
24
- * Handles a new WebSocket connection by subscribing it to all active channels
25
- * and setting up the disconnect listener.
26
- *
27
- * @static
28
- * @param {Socket} socket - The Socket.IO socket object representing the client connection.
29
- * @param {string} wsManagementId - Unique identifier for the WebSocket management context.
30
- * @returns {void}
20
+ * Handles a new WebSocket connection.
21
+ * @param {import('socket.io').Socket} socket
22
+ * @param {string} wsManagementId
31
23
  */
32
- static handleConnection(socket, wsManagementId) {
24
+ static handle(socket, wsManagementId) {
33
25
  logger.info(`New connection established. Socket ID: ${socket.id}`);
34
26
 
35
- // Subscribe socket to all channel connection handlers (assuming these channels are IoChannel instances)
36
27
  CoreWsChatChannel.connection(socket, wsManagementId);
37
28
  CoreWsMailerChannel.connection(socket, wsManagementId);
38
29
  CoreWsStreamChannel.connection(socket, wsManagementId);
39
30
 
40
- // Set up the disconnect listener
41
31
  socket.on('disconnect', (reason) => {
42
- logger.info(`Connection disconnected. Socket ID: ${socket.id} due to reason: ${reason}`);
32
+ logger.info(`Connection disconnected. Socket ID: ${socket.id}, reason: ${reason}`);
43
33
 
44
- // Notify all channels of the disconnection
45
34
  CoreWsChatChannel.disconnect(socket, reason, wsManagementId);
46
35
  CoreWsMailerChannel.disconnect(socket, reason, wsManagementId);
47
36
  CoreWsStreamChannel.disconnect(socket, reason, wsManagementId);
@@ -49,14 +38,4 @@ class CoreWsConnectionManager {
49
38
  }
50
39
  }
51
40
 
52
- /**
53
- * Backward compatibility export for the connection handler function.
54
- * @memberof CoreWsConnection
55
- * @function CoreWsConnection
56
- * @param {Socket} socket - The Socket.IO socket object.
57
- * @param {string} wsManagementId - Unique identifier for the WebSocket management context.
58
- * @returns {void}
59
- */
60
- const CoreWsConnection = CoreWsConnectionManager.handleConnection;
61
-
62
- export { CoreWsConnectionManager, CoreWsConnection };
41
+ export { CoreWsConnectionHandler };