@digitaldefiance/node-express-suite 3.6.21 → 3.6.22

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 (860) hide show
  1. package/package.json +8 -7
  2. package/src/__tests__/fixtures/{index.ts → index.d.ts} +1 -0
  3. package/src/__tests__/fixtures/index.d.ts.map +1 -0
  4. package/src/__tests__/fixtures/index.js +5 -0
  5. package/src/__tests__/fixtures/index.js.map +1 -0
  6. package/src/__tests__/fixtures/model-mocks.mock.d.ts +12 -0
  7. package/src/__tests__/fixtures/model-mocks.mock.d.ts.map +1 -0
  8. package/src/__tests__/fixtures/model-mocks.mock.js +102 -0
  9. package/src/__tests__/fixtures/model-mocks.mock.js.map +1 -0
  10. package/src/__tests__/helpers/application.mock.d.ts +8 -0
  11. package/src/__tests__/helpers/application.mock.d.ts.map +1 -0
  12. package/src/__tests__/helpers/application.mock.js +77 -0
  13. package/src/__tests__/helpers/application.mock.js.map +1 -0
  14. package/src/__tests__/helpers/{index.ts → index.d.ts} +1 -0
  15. package/src/__tests__/helpers/index.d.ts.map +1 -0
  16. package/src/__tests__/helpers/index.js +7 -0
  17. package/src/__tests__/helpers/index.js.map +1 -0
  18. package/src/__tests__/helpers/setup-test-env.d.ts +12 -0
  19. package/src/__tests__/helpers/setup-test-env.d.ts.map +1 -0
  20. package/src/__tests__/helpers/setup-test-env.js +121 -0
  21. package/src/__tests__/helpers/setup-test-env.js.map +1 -0
  22. package/src/__tests__/{index.ts → index.d.ts} +1 -0
  23. package/src/__tests__/index.d.ts.map +1 -0
  24. package/src/__tests__/index.js +6 -0
  25. package/src/__tests__/index.js.map +1 -0
  26. package/src/application-base.d.ts +122 -0
  27. package/src/application-base.d.ts.map +1 -0
  28. package/src/application-base.js +359 -0
  29. package/src/application-base.js.map +1 -0
  30. package/src/application-concrete.d.ts +12 -0
  31. package/src/application-concrete.d.ts.map +1 -0
  32. package/src/application-concrete.js +21 -0
  33. package/src/application-concrete.js.map +1 -0
  34. package/src/application.d.ts +28 -0
  35. package/src/application.d.ts.map +1 -0
  36. package/src/application.js +167 -0
  37. package/src/application.js.map +1 -0
  38. package/src/backup-code.d.ts +68 -0
  39. package/src/backup-code.d.ts.map +1 -0
  40. package/src/backup-code.js +238 -0
  41. package/src/backup-code.js.map +1 -0
  42. package/src/builders/application-builder.d.ts +34 -0
  43. package/src/builders/application-builder.d.ts.map +1 -0
  44. package/src/builders/application-builder.js +64 -0
  45. package/src/builders/application-builder.js.map +1 -0
  46. package/src/builders/{index.ts → index.d.ts} +1 -0
  47. package/src/builders/index.d.ts.map +1 -0
  48. package/src/builders/index.js +5 -0
  49. package/src/builders/index.js.map +1 -0
  50. package/src/constants.d.ts +16 -0
  51. package/src/constants.d.ts.map +1 -0
  52. package/src/constants.js +58 -0
  53. package/src/constants.js.map +1 -0
  54. package/src/container/{index.ts → index.d.ts} +1 -0
  55. package/src/container/index.d.ts.map +1 -0
  56. package/src/container/index.js +6 -0
  57. package/src/container/index.js.map +1 -0
  58. package/src/container/service-container.d.ts +11 -0
  59. package/src/container/service-container.d.ts.map +1 -0
  60. package/src/container/service-container.js +38 -0
  61. package/src/container/service-container.js.map +1 -0
  62. package/src/container/service-definitions.d.ts +11 -0
  63. package/src/container/service-definitions.d.ts.map +1 -0
  64. package/src/container/service-definitions.js +13 -0
  65. package/src/container/service-definitions.js.map +1 -0
  66. package/src/controllers/base.d.ts +66 -0
  67. package/src/controllers/base.d.ts.map +1 -0
  68. package/src/controllers/base.js +305 -0
  69. package/src/controllers/base.js.map +1 -0
  70. package/src/controllers/{index.ts → index.d.ts} +1 -0
  71. package/src/controllers/index.d.ts.map +1 -0
  72. package/src/controllers/index.js +6 -0
  73. package/src/controllers/index.js.map +1 -0
  74. package/src/controllers/user.d.ts +50 -0
  75. package/src/controllers/user.d.ts.map +1 -0
  76. package/src/controllers/user.js +918 -0
  77. package/src/controllers/user.js.map +1 -0
  78. package/src/database/{database-initializer.ts → database-initializer.d.ts} +3 -3
  79. package/src/database/database-initializer.d.ts.map +1 -0
  80. package/src/database/database-initializer.js +3 -0
  81. package/src/database/database-initializer.js.map +1 -0
  82. package/src/database/{index.ts → index.d.ts} +1 -0
  83. package/src/database/index.d.ts.map +1 -0
  84. package/src/database/index.js +5 -0
  85. package/src/database/index.js.map +1 -0
  86. package/src/decorators/base-controller.d.ts +10 -0
  87. package/src/decorators/base-controller.d.ts.map +1 -0
  88. package/src/decorators/base-controller.js +60 -0
  89. package/src/decorators/base-controller.js.map +1 -0
  90. package/src/decorators/controller.d.ts +38 -0
  91. package/src/decorators/controller.d.ts.map +1 -0
  92. package/src/decorators/controller.js +68 -0
  93. package/src/decorators/controller.js.map +1 -0
  94. package/src/decorators/{index.ts → index.d.ts} +1 -0
  95. package/src/decorators/index.d.ts.map +1 -0
  96. package/src/decorators/index.js +7 -0
  97. package/src/decorators/index.js.map +1 -0
  98. package/src/decorators/zod-validation.d.ts +5 -0
  99. package/src/decorators/zod-validation.d.ts.map +1 -0
  100. package/src/decorators/zod-validation.js +48 -0
  101. package/src/decorators/zod-validation.js.map +1 -0
  102. package/src/defaults.d.ts +7 -0
  103. package/src/defaults.d.ts.map +1 -0
  104. package/src/defaults.js +204 -0
  105. package/src/defaults.js.map +1 -0
  106. package/src/documents/base.d.ts +4 -0
  107. package/src/documents/base.d.ts.map +1 -0
  108. package/src/documents/base.js +3 -0
  109. package/src/documents/base.js.map +1 -0
  110. package/src/documents/email-token.d.ts +8 -0
  111. package/src/documents/email-token.d.ts.map +1 -0
  112. package/src/documents/email-token.js +3 -0
  113. package/src/documents/email-token.js.map +1 -0
  114. package/src/documents/{index.ts → index.d.ts} +1 -0
  115. package/src/documents/index.d.ts.map +1 -0
  116. package/src/documents/index.js +3 -0
  117. package/src/documents/index.js.map +1 -0
  118. package/src/documents/{mnemonic.ts → mnemonic.d.ts} +2 -4
  119. package/src/documents/mnemonic.d.ts.map +1 -0
  120. package/src/documents/mnemonic.js +3 -0
  121. package/src/documents/mnemonic.js.map +1 -0
  122. package/src/documents/{role.ts → role.d.ts} +2 -3
  123. package/src/documents/role.d.ts.map +1 -0
  124. package/src/documents/role.js +3 -0
  125. package/src/documents/role.js.map +1 -0
  126. package/src/documents/used-direct-login-token.d.ts +5 -0
  127. package/src/documents/used-direct-login-token.d.ts.map +1 -0
  128. package/src/documents/used-direct-login-token.js +3 -0
  129. package/src/documents/used-direct-login-token.js.map +1 -0
  130. package/src/documents/{user-role.ts → user-role.d.ts} +2 -4
  131. package/src/documents/user-role.d.ts.map +1 -0
  132. package/src/documents/user-role.js +3 -0
  133. package/src/documents/user-role.js.map +1 -0
  134. package/src/documents/{user.ts → user.d.ts} +2 -5
  135. package/src/documents/user.d.ts.map +1 -0
  136. package/src/documents/user.js +3 -0
  137. package/src/documents/user.js.map +1 -0
  138. package/src/enumerations/base-model-name.d.ts +38 -0
  139. package/src/enumerations/base-model-name.d.ts.map +1 -0
  140. package/src/enumerations/base-model-name.js +34 -0
  141. package/src/enumerations/base-model-name.js.map +1 -0
  142. package/src/enumerations/{index.ts → index.d.ts} +1 -0
  143. package/src/enumerations/index.d.ts.map +1 -0
  144. package/src/enumerations/index.js +8 -0
  145. package/src/enumerations/index.js.map +1 -0
  146. package/src/enumerations/length-encoding-type.d.ts +7 -0
  147. package/src/enumerations/length-encoding-type.d.ts.map +1 -0
  148. package/src/enumerations/length-encoding-type.js +11 -0
  149. package/src/enumerations/length-encoding-type.js.map +1 -0
  150. package/src/enumerations/schema-collection.d.ts +34 -0
  151. package/src/enumerations/schema-collection.d.ts.map +1 -0
  152. package/src/enumerations/schema-collection.js +38 -0
  153. package/src/enumerations/schema-collection.js.map +1 -0
  154. package/src/enumerations/symmetric-error-type.d.ts +5 -0
  155. package/src/enumerations/symmetric-error-type.d.ts.map +1 -0
  156. package/src/enumerations/symmetric-error-type.js +9 -0
  157. package/src/enumerations/symmetric-error-type.js.map +1 -0
  158. package/src/environment.d.ts +190 -0
  159. package/src/environment.d.ts.map +1 -0
  160. package/src/environment.js +646 -0
  161. package/src/environment.js.map +1 -0
  162. package/src/errors/express-validation.d.ts +9 -0
  163. package/src/errors/express-validation.d.ts.map +1 -0
  164. package/src/errors/express-validation.js +18 -0
  165. package/src/errors/express-validation.js.map +1 -0
  166. package/src/errors/{index.ts → index.d.ts} +1 -0
  167. package/src/errors/index.d.ts.map +1 -0
  168. package/src/errors/index.js +16 -0
  169. package/src/errors/index.js.map +1 -0
  170. package/src/errors/invalid-backup-code-version.d.ts +6 -0
  171. package/src/errors/invalid-backup-code-version.d.ts.map +1 -0
  172. package/src/errors/invalid-backup-code-version.js +16 -0
  173. package/src/errors/invalid-backup-code-version.js.map +1 -0
  174. package/src/errors/invalid-jwt-token.d.ts +5 -0
  175. package/src/errors/invalid-jwt-token.d.ts.map +1 -0
  176. package/src/errors/invalid-jwt-token.js +12 -0
  177. package/src/errors/invalid-jwt-token.js.map +1 -0
  178. package/src/errors/invalid-model.d.ts +6 -0
  179. package/src/errors/invalid-model.d.ts.map +1 -0
  180. package/src/errors/invalid-model.js +14 -0
  181. package/src/errors/invalid-model.js.map +1 -0
  182. package/src/errors/invalid-new-password.d.ts +5 -0
  183. package/src/errors/invalid-new-password.d.ts.map +1 -0
  184. package/src/errors/invalid-new-password.js +14 -0
  185. package/src/errors/invalid-new-password.js.map +1 -0
  186. package/src/errors/invalid-password.d.ts +5 -0
  187. package/src/errors/invalid-password.d.ts.map +1 -0
  188. package/src/errors/invalid-password.js +14 -0
  189. package/src/errors/invalid-password.js.map +1 -0
  190. package/src/errors/missing-validated-data.d.ts +7 -0
  191. package/src/errors/missing-validated-data.d.ts.map +1 -0
  192. package/src/errors/missing-validated-data.js +36 -0
  193. package/src/errors/missing-validated-data.js.map +1 -0
  194. package/src/errors/mnemonic-or-password-required.d.ts +5 -0
  195. package/src/errors/mnemonic-or-password-required.d.ts.map +1 -0
  196. package/src/errors/mnemonic-or-password-required.js +14 -0
  197. package/src/errors/mnemonic-or-password-required.js.map +1 -0
  198. package/src/errors/model-not-registered.d.ts +6 -0
  199. package/src/errors/model-not-registered.d.ts.map +1 -0
  200. package/src/errors/model-not-registered.js +14 -0
  201. package/src/errors/model-not-registered.js.map +1 -0
  202. package/src/errors/mongoose-validation.d.ts +12 -0
  203. package/src/errors/mongoose-validation.d.ts.map +1 -0
  204. package/src/errors/mongoose-validation.js +17 -0
  205. package/src/errors/mongoose-validation.js.map +1 -0
  206. package/src/errors/symmetric.d.ts +8 -0
  207. package/src/errors/symmetric.d.ts.map +1 -0
  208. package/src/errors/symmetric.js +22 -0
  209. package/src/errors/symmetric.js.map +1 -0
  210. package/src/errors/token-expired.d.ts +5 -0
  211. package/src/errors/token-expired.d.ts.map +1 -0
  212. package/src/errors/token-expired.js +12 -0
  213. package/src/errors/token-expired.js.map +1 -0
  214. package/src/get-language.d.ts +2 -0
  215. package/src/get-language.d.ts.map +1 -0
  216. package/src/get-language.js +30 -0
  217. package/src/get-language.js.map +1 -0
  218. package/src/get-timezone.d.ts +2 -0
  219. package/src/get-timezone.d.ts.map +1 -0
  220. package/src/get-timezone.js +39 -0
  221. package/src/get-timezone.js.map +1 -0
  222. package/src/{index.ts → index.d.ts} +1 -1
  223. package/src/index.d.ts.map +1 -0
  224. package/src/index.js +42 -0
  225. package/src/index.js.map +1 -0
  226. package/src/interfaces/{api-error-response.ts → api-error-response.d.ts} +2 -2
  227. package/src/interfaces/api-error-response.d.ts.map +1 -0
  228. package/src/interfaces/api-error-response.js +3 -0
  229. package/src/interfaces/api-error-response.js.map +1 -0
  230. package/src/interfaces/api-express-validation-error-response.d.ts +7 -0
  231. package/src/interfaces/api-express-validation-error-response.d.ts.map +1 -0
  232. package/src/interfaces/api-express-validation-error-response.js +3 -0
  233. package/src/interfaces/api-express-validation-error-response.js.map +1 -0
  234. package/src/interfaces/api-message-response.d.ts +4 -0
  235. package/src/interfaces/api-message-response.d.ts.map +1 -0
  236. package/src/interfaces/api-message-response.js +3 -0
  237. package/src/interfaces/api-message-response.js.map +1 -0
  238. package/src/interfaces/{api-mongo-validation-error-response.ts → api-mongo-validation-error-response.d.ts} +2 -2
  239. package/src/interfaces/api-mongo-validation-error-response.d.ts.map +1 -0
  240. package/src/interfaces/api-mongo-validation-error-response.js +3 -0
  241. package/src/interfaces/api-mongo-validation-error-response.js.map +1 -0
  242. package/src/interfaces/api-responses/{backup-codes-response.ts → backup-codes-response.d.ts} +2 -2
  243. package/src/interfaces/api-responses/backup-codes-response.d.ts.map +1 -0
  244. package/src/interfaces/api-responses/backup-codes-response.js +3 -0
  245. package/src/interfaces/api-responses/backup-codes-response.js.map +1 -0
  246. package/src/interfaces/api-responses/{challenge-response.ts → challenge-response.d.ts} +3 -3
  247. package/src/interfaces/api-responses/challenge-response.d.ts.map +1 -0
  248. package/src/interfaces/api-responses/challenge-response.js +3 -0
  249. package/src/interfaces/api-responses/challenge-response.js.map +1 -0
  250. package/src/interfaces/api-responses/{code-count-response.ts → code-count-response.d.ts} +2 -2
  251. package/src/interfaces/api-responses/code-count-response.d.ts.map +1 -0
  252. package/src/interfaces/api-responses/code-count-response.js +3 -0
  253. package/src/interfaces/api-responses/code-count-response.js.map +1 -0
  254. package/src/interfaces/api-responses/{index.ts → index.d.ts} +1 -0
  255. package/src/interfaces/api-responses/index.d.ts.map +1 -0
  256. package/src/interfaces/api-responses/index.js +12 -0
  257. package/src/interfaces/api-responses/index.js.map +1 -0
  258. package/src/interfaces/api-responses/{login-response.ts → login-response.d.ts} +4 -4
  259. package/src/interfaces/api-responses/login-response.d.ts.map +1 -0
  260. package/src/interfaces/api-responses/login-response.js +3 -0
  261. package/src/interfaces/api-responses/login-response.js.map +1 -0
  262. package/src/interfaces/api-responses/{mnemonic-response.ts → mnemonic-response.d.ts} +2 -2
  263. package/src/interfaces/api-responses/mnemonic-response.d.ts.map +1 -0
  264. package/src/interfaces/api-responses/mnemonic-response.js +3 -0
  265. package/src/interfaces/api-responses/mnemonic-response.js.map +1 -0
  266. package/src/interfaces/api-responses/{registration-response.ts → registration-response.d.ts} +3 -3
  267. package/src/interfaces/api-responses/registration-response.d.ts.map +1 -0
  268. package/src/interfaces/api-responses/registration-response.js +3 -0
  269. package/src/interfaces/api-responses/registration-response.js.map +1 -0
  270. package/src/interfaces/api-responses/{request-user-response.ts → request-user-response.d.ts} +2 -2
  271. package/src/interfaces/api-responses/request-user-response.d.ts.map +1 -0
  272. package/src/interfaces/api-responses/request-user-response.js +3 -0
  273. package/src/interfaces/api-responses/request-user-response.js.map +1 -0
  274. package/src/interfaces/api-responses/user-settings-response.d.ts +12 -0
  275. package/src/interfaces/api-responses/user-settings-response.d.ts.map +1 -0
  276. package/src/interfaces/api-responses/user-settings-response.js +3 -0
  277. package/src/interfaces/api-responses/user-settings-response.js.map +1 -0
  278. package/src/interfaces/application.d.ts +16 -0
  279. package/src/interfaces/application.d.ts.map +1 -0
  280. package/src/interfaces/application.js +3 -0
  281. package/src/interfaces/application.js.map +1 -0
  282. package/src/interfaces/backend-objects/email-token.d.ts +4 -0
  283. package/src/interfaces/backend-objects/email-token.d.ts.map +1 -0
  284. package/src/interfaces/backend-objects/email-token.js +3 -0
  285. package/src/interfaces/backend-objects/email-token.js.map +1 -0
  286. package/src/interfaces/backend-objects/{index.ts → index.d.ts} +1 -0
  287. package/src/interfaces/backend-objects/index.d.ts.map +1 -0
  288. package/src/interfaces/backend-objects/index.js +8 -0
  289. package/src/interfaces/backend-objects/index.js.map +1 -0
  290. package/src/interfaces/backend-objects/request-user.d.ts +5 -0
  291. package/src/interfaces/backend-objects/request-user.d.ts.map +1 -0
  292. package/src/interfaces/backend-objects/request-user.js +3 -0
  293. package/src/interfaces/backend-objects/request-user.js.map +1 -0
  294. package/src/interfaces/backend-objects/role.d.ts +4 -0
  295. package/src/interfaces/backend-objects/role.d.ts.map +1 -0
  296. package/src/interfaces/backend-objects/role.js +3 -0
  297. package/src/interfaces/backend-objects/role.js.map +1 -0
  298. package/src/interfaces/backend-objects/user.d.ts +4 -0
  299. package/src/interfaces/backend-objects/user.d.ts.map +1 -0
  300. package/src/interfaces/backend-objects/user.js +3 -0
  301. package/src/interfaces/backend-objects/user.js.map +1 -0
  302. package/src/interfaces/checksum-config.d.ts +5 -0
  303. package/src/interfaces/checksum-config.d.ts.map +1 -0
  304. package/src/interfaces/checksum-config.js +3 -0
  305. package/src/interfaces/checksum-config.js.map +1 -0
  306. package/src/interfaces/checksum-consts.d.ts +11 -0
  307. package/src/interfaces/checksum-consts.d.ts.map +1 -0
  308. package/src/interfaces/checksum-consts.js +3 -0
  309. package/src/interfaces/checksum-consts.js.map +1 -0
  310. package/src/interfaces/constants.d.ts +98 -0
  311. package/src/interfaces/constants.d.ts.map +1 -0
  312. package/src/interfaces/constants.js +3 -0
  313. package/src/interfaces/constants.js.map +1 -0
  314. package/src/interfaces/controller-config.d.ts +21 -0
  315. package/src/interfaces/controller-config.d.ts.map +1 -0
  316. package/src/interfaces/controller-config.js +3 -0
  317. package/src/interfaces/controller-config.js.map +1 -0
  318. package/src/interfaces/create-user-basics.d.ts +18 -0
  319. package/src/interfaces/create-user-basics.d.ts.map +1 -0
  320. package/src/interfaces/create-user-basics.js +3 -0
  321. package/src/interfaces/create-user-basics.js.map +1 -0
  322. package/src/interfaces/csp-config.d.ts +7 -0
  323. package/src/interfaces/csp-config.d.ts.map +1 -0
  324. package/src/interfaces/csp-config.js +13 -0
  325. package/src/interfaces/csp-config.js.map +1 -0
  326. package/src/interfaces/csp-definition.d.ts +13 -0
  327. package/src/interfaces/csp-definition.d.ts.map +1 -0
  328. package/src/interfaces/csp-definition.js +22 -0
  329. package/src/interfaces/csp-definition.js.map +1 -0
  330. package/src/interfaces/{db-init-result.ts → db-init-result.d.ts} +2 -2
  331. package/src/interfaces/db-init-result.d.ts.map +1 -0
  332. package/src/interfaces/db-init-result.js +3 -0
  333. package/src/interfaces/db-init-result.js.map +1 -0
  334. package/src/interfaces/deep-partial.d.ts +4 -0
  335. package/src/interfaces/deep-partial.d.ts.map +1 -0
  336. package/src/interfaces/deep-partial.js +3 -0
  337. package/src/interfaces/deep-partial.js.map +1 -0
  338. package/src/interfaces/{discriminator-collections.ts → discriminator-collections.d.ts} +3 -3
  339. package/src/interfaces/discriminator-collections.d.ts.map +1 -0
  340. package/src/interfaces/discriminator-collections.js +3 -0
  341. package/src/interfaces/discriminator-collections.js.map +1 -0
  342. package/src/interfaces/email-service.d.ts +4 -0
  343. package/src/interfaces/email-service.d.ts.map +1 -0
  344. package/src/interfaces/email-service.js +3 -0
  345. package/src/interfaces/email-service.js.map +1 -0
  346. package/src/interfaces/environment-mongo.d.ts +76 -0
  347. package/src/interfaces/environment-mongo.d.ts.map +1 -0
  348. package/src/interfaces/environment-mongo.js +3 -0
  349. package/src/interfaces/environment-mongo.js.map +1 -0
  350. package/src/interfaces/environment.d.ts +184 -0
  351. package/src/interfaces/environment.d.ts.map +1 -0
  352. package/src/interfaces/environment.js +3 -0
  353. package/src/interfaces/environment.js.map +1 -0
  354. package/src/interfaces/failable-result.d.ts +7 -0
  355. package/src/interfaces/failable-result.d.ts.map +1 -0
  356. package/src/interfaces/failable-result.js +3 -0
  357. package/src/interfaces/failable-result.js.map +1 -0
  358. package/src/interfaces/fec-consts.d.ts +5 -0
  359. package/src/interfaces/fec-consts.d.ts.map +1 -0
  360. package/src/interfaces/fec-consts.js +3 -0
  361. package/src/interfaces/fec-consts.js.map +1 -0
  362. package/src/interfaces/flexible-csp.d.ts +8 -0
  363. package/src/interfaces/flexible-csp.d.ts.map +1 -0
  364. package/src/interfaces/flexible-csp.js +14 -0
  365. package/src/interfaces/flexible-csp.js.map +1 -0
  366. package/src/interfaces/handleable-error-options.d.ts +7 -0
  367. package/src/interfaces/handleable-error-options.d.ts.map +1 -0
  368. package/src/interfaces/handleable-error-options.js +3 -0
  369. package/src/interfaces/handleable-error-options.js.map +1 -0
  370. package/src/interfaces/{index.ts → index.d.ts} +1 -0
  371. package/src/interfaces/index.d.ts.map +1 -0
  372. package/src/interfaces/index.js +38 -0
  373. package/src/interfaces/index.js.map +1 -0
  374. package/src/interfaces/jwt-consts.d.ts +11 -0
  375. package/src/interfaces/jwt-consts.d.ts.map +1 -0
  376. package/src/interfaces/jwt-consts.js +3 -0
  377. package/src/interfaces/jwt-consts.js.map +1 -0
  378. package/src/interfaces/jwt-sign-response.d.ts +11 -0
  379. package/src/interfaces/jwt-sign-response.d.ts.map +1 -0
  380. package/src/interfaces/jwt-sign-response.js +3 -0
  381. package/src/interfaces/jwt-sign-response.js.map +1 -0
  382. package/src/interfaces/models/{email-token.ts → email-token.d.ts} +1 -1
  383. package/src/interfaces/models/email-token.d.ts.map +1 -0
  384. package/src/interfaces/models/email-token.js +3 -0
  385. package/src/interfaces/models/email-token.js.map +1 -0
  386. package/src/interfaces/models/{index.ts → index.d.ts} +1 -0
  387. package/src/interfaces/models/index.d.ts.map +1 -0
  388. package/src/interfaces/models/index.js +11 -0
  389. package/src/interfaces/models/index.js.map +1 -0
  390. package/src/interfaces/models/{mnemonic.ts → mnemonic.d.ts} +1 -1
  391. package/src/interfaces/models/mnemonic.d.ts.map +1 -0
  392. package/src/interfaces/models/mnemonic.js +3 -0
  393. package/src/interfaces/models/mnemonic.js.map +1 -0
  394. package/src/interfaces/models/{role.ts → role.d.ts} +1 -1
  395. package/src/interfaces/models/role.d.ts.map +1 -0
  396. package/src/interfaces/models/role.js +3 -0
  397. package/src/interfaces/models/role.js.map +1 -0
  398. package/src/interfaces/models/{token-role.ts → token-role.d.ts} +1 -1
  399. package/src/interfaces/models/token-role.d.ts.map +1 -0
  400. package/src/interfaces/models/token-role.js +3 -0
  401. package/src/interfaces/models/token-role.js.map +1 -0
  402. package/src/interfaces/models/{used-direct-login-token.ts → used-direct-login-token.d.ts} +2 -3
  403. package/src/interfaces/models/used-direct-login-token.d.ts.map +1 -0
  404. package/src/interfaces/models/used-direct-login-token.js +3 -0
  405. package/src/interfaces/models/used-direct-login-token.js.map +1 -0
  406. package/src/interfaces/models/{user-role.ts → user-role.d.ts} +1 -1
  407. package/src/interfaces/models/user-role.d.ts.map +1 -0
  408. package/src/interfaces/models/user-role.js +3 -0
  409. package/src/interfaces/models/user-role.js.map +1 -0
  410. package/src/interfaces/models/{user.ts → user.d.ts} +3 -11
  411. package/src/interfaces/models/user.d.ts.map +1 -0
  412. package/src/interfaces/models/user.js +3 -0
  413. package/src/interfaces/models/user.js.map +1 -0
  414. package/src/interfaces/mongo-errors.d.ts +5 -0
  415. package/src/interfaces/mongo-errors.d.ts.map +1 -0
  416. package/src/interfaces/mongo-errors.js +3 -0
  417. package/src/interfaces/mongo-errors.js.map +1 -0
  418. package/src/interfaces/request-user.d.ts +58 -0
  419. package/src/interfaces/request-user.d.ts.map +1 -0
  420. package/src/interfaces/request-user.js +3 -0
  421. package/src/interfaces/request-user.js.map +1 -0
  422. package/src/interfaces/required-string-keys.d.ts +22 -0
  423. package/src/interfaces/required-string-keys.d.ts.map +1 -0
  424. package/src/interfaces/required-string-keys.js +3 -0
  425. package/src/interfaces/required-string-keys.js.map +1 -0
  426. package/src/interfaces/schema.d.ts +29 -0
  427. package/src/interfaces/schema.d.ts.map +1 -0
  428. package/src/interfaces/schema.js +3 -0
  429. package/src/interfaces/schema.js.map +1 -0
  430. package/src/interfaces/server-init-result.d.ts +36 -0
  431. package/src/interfaces/server-init-result.d.ts.map +1 -0
  432. package/src/interfaces/server-init-result.js +3 -0
  433. package/src/interfaces/server-init-result.js.map +1 -0
  434. package/src/interfaces/status-code-response.d.ts +7 -0
  435. package/src/interfaces/status-code-response.d.ts.map +1 -0
  436. package/src/interfaces/status-code-response.js +3 -0
  437. package/src/interfaces/status-code-response.js.map +1 -0
  438. package/src/interfaces/symmetric-encryption-results.d.ts +3 -3
  439. package/src/interfaces/symmetric-encryption-results.d.ts.map +1 -1
  440. package/src/interfaces/symmetric-encryption-results.js.map +1 -1
  441. package/src/interfaces/{test-environment.ts → test-environment.d.ts} +6 -6
  442. package/src/interfaces/test-environment.d.ts.map +1 -0
  443. package/src/interfaces/test-environment.js +3 -0
  444. package/src/interfaces/test-environment.js.map +1 -0
  445. package/src/interfaces/{token-response.ts → token-response.d.ts} +2 -2
  446. package/src/interfaces/token-response.d.ts.map +1 -0
  447. package/src/interfaces/token-response.js +3 -0
  448. package/src/interfaces/token-response.js.map +1 -0
  449. package/src/middlewares/authenticate-crypto.d.ts +10 -0
  450. package/src/middlewares/authenticate-crypto.d.ts.map +1 -0
  451. package/src/middlewares/authenticate-crypto.js +126 -0
  452. package/src/middlewares/authenticate-crypto.js.map +1 -0
  453. package/src/middlewares/authenticate-token.d.ts +21 -0
  454. package/src/middlewares/authenticate-token.d.ts.map +1 -0
  455. package/src/middlewares/authenticate-token.js +104 -0
  456. package/src/middlewares/authenticate-token.js.map +1 -0
  457. package/src/middlewares/cleanup-crypto.d.ts +7 -0
  458. package/src/middlewares/cleanup-crypto.d.ts.map +1 -0
  459. package/src/middlewares/cleanup-crypto.js +32 -0
  460. package/src/middlewares/cleanup-crypto.js.map +1 -0
  461. package/src/middlewares/{index.ts → index.d.ts} +1 -0
  462. package/src/middlewares/index.d.ts.map +1 -0
  463. package/src/middlewares/index.js +8 -0
  464. package/src/middlewares/index.js.map +1 -0
  465. package/src/middlewares/set-global-context-language.d.ts +3 -0
  466. package/src/middlewares/set-global-context-language.d.ts.map +1 -0
  467. package/src/middlewares/set-global-context-language.js +14 -0
  468. package/src/middlewares/set-global-context-language.js.map +1 -0
  469. package/src/middlewares.d.ts +8 -0
  470. package/src/middlewares.d.ts.map +1 -0
  471. package/src/middlewares.js +91 -0
  472. package/src/middlewares.js.map +1 -0
  473. package/src/model-registry.d.ts +23 -0
  474. package/src/model-registry.d.ts.map +1 -0
  475. package/src/model-registry.js +47 -0
  476. package/src/model-registry.js.map +1 -0
  477. package/src/models/email-token.d.ts +35 -11
  478. package/src/models/email-token.d.ts.map +1 -0
  479. package/src/models/email-token.js +11 -0
  480. package/src/models/email-token.js.map +1 -0
  481. package/src/models/{index.ts → index.d.ts} +1 -0
  482. package/src/models/index.d.ts.map +1 -0
  483. package/src/models/index.js +10 -0
  484. package/src/models/index.js.map +1 -0
  485. package/src/models/mnemonic.d.ts +35 -11
  486. package/src/models/mnemonic.d.ts.map +1 -0
  487. package/src/models/mnemonic.js +11 -0
  488. package/src/models/mnemonic.js.map +1 -0
  489. package/src/models/role.d.ts +35 -11
  490. package/src/models/role.d.ts.map +1 -0
  491. package/src/models/role.js +11 -0
  492. package/src/models/role.js.map +1 -0
  493. package/src/models/used-direct-login-token.d.ts +35 -11
  494. package/src/models/used-direct-login-token.d.ts.map +1 -0
  495. package/src/models/used-direct-login-token.js +11 -0
  496. package/src/models/used-direct-login-token.js.map +1 -0
  497. package/src/models/user-role.d.ts +3 -10
  498. package/src/models/user-role.d.ts.map +1 -0
  499. package/src/models/user-role.js +10 -0
  500. package/src/models/user-role.js.map +1 -0
  501. package/src/models/user.d.ts +3 -16
  502. package/src/models/user.d.ts.map +1 -0
  503. package/src/models/user.js +11 -0
  504. package/src/models/user.js.map +1 -0
  505. package/src/pipeline/{index.ts → index.d.ts} +1 -0
  506. package/src/pipeline/index.d.ts.map +1 -0
  507. package/src/pipeline/index.js +5 -0
  508. package/src/pipeline/index.js.map +1 -0
  509. package/src/pipeline/pipeline-builder.d.ts +8 -0
  510. package/src/pipeline/pipeline-builder.d.ts.map +1 -0
  511. package/src/pipeline/pipeline-builder.js +18 -0
  512. package/src/pipeline/pipeline-builder.js.map +1 -0
  513. package/src/plugins/{index.ts → index.d.ts} +1 -0
  514. package/src/plugins/index.d.ts.map +1 -0
  515. package/src/plugins/index.js +6 -0
  516. package/src/plugins/index.js.map +1 -0
  517. package/src/plugins/plugin-interface.d.ts +8 -0
  518. package/src/plugins/plugin-interface.d.ts.map +1 -0
  519. package/src/plugins/plugin-interface.js +3 -0
  520. package/src/plugins/plugin-interface.js.map +1 -0
  521. package/src/plugins/plugin-manager.d.ts +12 -0
  522. package/src/plugins/plugin-manager.d.ts.map +1 -0
  523. package/src/plugins/plugin-manager.js +37 -0
  524. package/src/plugins/plugin-manager.js.map +1 -0
  525. package/src/registry/email-service-registry.d.ts +27 -0
  526. package/src/registry/email-service-registry.d.ts.map +1 -0
  527. package/src/registry/email-service-registry.js +42 -0
  528. package/src/registry/email-service-registry.js.map +1 -0
  529. package/src/registry/{index.ts → index.d.ts} +1 -0
  530. package/src/registry/index.d.ts.map +1 -0
  531. package/src/registry/index.js +6 -0
  532. package/src/registry/index.js.map +1 -0
  533. package/src/responses/{index.ts → index.d.ts} +1 -0
  534. package/src/responses/index.d.ts.map +1 -0
  535. package/src/responses/index.js +5 -0
  536. package/src/responses/index.js.map +1 -0
  537. package/src/responses/response-builder.d.ts +24 -0
  538. package/src/responses/response-builder.d.ts.map +1 -0
  539. package/src/responses/response-builder.js +63 -0
  540. package/src/responses/response-builder.js.map +1 -0
  541. package/src/routers/api.d.ts +28 -0
  542. package/src/routers/api.d.ts.map +1 -0
  543. package/src/routers/api.js +80 -0
  544. package/src/routers/api.js.map +1 -0
  545. package/src/routers/app.d.ts +32 -0
  546. package/src/routers/app.d.ts.map +1 -0
  547. package/src/routers/app.js +228 -0
  548. package/src/routers/app.js.map +1 -0
  549. package/src/routers/base.d.ts +8 -0
  550. package/src/routers/base.d.ts.map +1 -0
  551. package/src/routers/base.js +14 -0
  552. package/src/routers/base.js.map +1 -0
  553. package/src/routers/{index.ts → index.d.ts} +1 -0
  554. package/src/routers/index.d.ts.map +1 -0
  555. package/src/routers/index.js +7 -0
  556. package/src/routers/index.js.map +1 -0
  557. package/src/routers/router-config.d.ts +18 -0
  558. package/src/routers/router-config.d.ts.map +1 -0
  559. package/src/routers/router-config.js +8 -0
  560. package/src/routers/router-config.js.map +1 -0
  561. package/src/routing/index.d.ts +2 -0
  562. package/src/routing/index.d.ts.map +1 -0
  563. package/src/routing/index.js +5 -0
  564. package/src/routing/index.js.map +1 -0
  565. package/src/routing/route-builder.d.ts +36 -0
  566. package/src/routing/route-builder.d.ts.map +1 -0
  567. package/src/routing/route-builder.js +86 -0
  568. package/src/routing/route-builder.js.map +1 -0
  569. package/src/schemas/email-token.d.ts +47 -13
  570. package/src/schemas/email-token.d.ts.map +1 -0
  571. package/src/schemas/email-token.js +55 -0
  572. package/src/schemas/email-token.js.map +1 -0
  573. package/src/schemas/{index.ts → index.d.ts} +1 -0
  574. package/src/schemas/index.d.ts.map +1 -0
  575. package/src/schemas/index.js +11 -0
  576. package/src/schemas/index.js.map +1 -0
  577. package/src/schemas/mnemonic.d.ts +26 -10
  578. package/src/schemas/mnemonic.d.ts.map +1 -0
  579. package/src/schemas/mnemonic.js +31 -0
  580. package/src/schemas/mnemonic.js.map +1 -0
  581. package/src/schemas/role.d.ts +40 -13
  582. package/src/schemas/role.d.ts.map +1 -0
  583. package/src/schemas/role.js +89 -0
  584. package/src/schemas/role.js.map +1 -0
  585. package/src/schemas/schema.d.ts +42 -0
  586. package/src/schemas/schema.d.ts.map +1 -0
  587. package/src/schemas/schema.js +70 -0
  588. package/src/schemas/schema.js.map +1 -0
  589. package/src/schemas/used-direct-login-token.d.ts +35 -12
  590. package/src/schemas/used-direct-login-token.d.ts.map +1 -0
  591. package/src/schemas/used-direct-login-token.js +24 -0
  592. package/src/schemas/used-direct-login-token.js.map +1 -0
  593. package/src/schemas/user-role.d.ts +37 -12
  594. package/src/schemas/user-role.d.ts.map +1 -0
  595. package/src/schemas/user-role.js +55 -0
  596. package/src/schemas/user-role.js.map +1 -0
  597. package/src/schemas/user.d.ts +23 -18
  598. package/src/schemas/user.d.ts.map +1 -0
  599. package/src/schemas/user.js +195 -0
  600. package/src/schemas/user.js.map +1 -0
  601. package/src/services/backup-code.d.ts +76 -0
  602. package/src/services/backup-code.d.ts.map +1 -0
  603. package/src/services/backup-code.js +185 -0
  604. package/src/services/backup-code.js.map +1 -0
  605. package/src/services/base.d.ts +10 -0
  606. package/src/services/base.d.ts.map +1 -0
  607. package/src/services/base.js +15 -0
  608. package/src/services/base.js.map +1 -0
  609. package/src/services/checksum.d.ts +69 -0
  610. package/src/services/checksum.d.ts.map +1 -0
  611. package/src/services/checksum.js +145 -0
  612. package/src/services/checksum.js.map +1 -0
  613. package/src/services/crc.d.ts +87 -0
  614. package/src/services/crc.d.ts.map +1 -0
  615. package/src/services/crc.js +198 -0
  616. package/src/services/crc.js.map +1 -0
  617. package/src/services/database-initialization.d.ts +111 -0
  618. package/src/services/database-initialization.d.ts.map +1 -0
  619. package/src/services/database-initialization.js +879 -0
  620. package/src/services/database-initialization.js.map +1 -0
  621. package/src/services/{db-init-cache.ts → db-init-cache.d.ts} +5 -11
  622. package/src/services/db-init-cache.d.ts.map +1 -0
  623. package/src/services/db-init-cache.js +3 -0
  624. package/src/services/db-init-cache.js.map +1 -0
  625. package/src/services/direct-login-token.d.ts +6 -0
  626. package/src/services/direct-login-token.d.ts.map +1 -0
  627. package/src/services/direct-login-token.js +41 -0
  628. package/src/services/direct-login-token.js.map +1 -0
  629. package/src/services/dummy-email-service.d.ts +10 -0
  630. package/src/services/dummy-email-service.d.ts.map +1 -0
  631. package/src/services/dummy-email-service.js +16 -0
  632. package/src/services/dummy-email-service.js.map +1 -0
  633. package/src/services/fec-usage-example.d.ts +38 -0
  634. package/src/services/fec-usage-example.d.ts.map +1 -0
  635. package/src/services/fec-usage-example.js +75 -0
  636. package/src/services/fec-usage-example.js.map +1 -0
  637. package/src/services/fec.d.ts +46 -0
  638. package/src/services/fec.d.ts.map +1 -0
  639. package/src/services/fec.js +214 -0
  640. package/src/services/fec.js.map +1 -0
  641. package/src/services/{index.ts → index.d.ts} +1 -0
  642. package/src/services/index.d.ts.map +1 -0
  643. package/src/services/index.js +23 -0
  644. package/src/services/index.js.map +1 -0
  645. package/src/services/jwt.d.ts +30 -0
  646. package/src/services/jwt.d.ts.map +1 -0
  647. package/src/services/jwt.js +90 -0
  648. package/src/services/jwt.js.map +1 -0
  649. package/src/services/key-wrapping.d.ts +61 -0
  650. package/src/services/key-wrapping.d.ts.map +1 -0
  651. package/src/services/key-wrapping.js +307 -0
  652. package/src/services/key-wrapping.js.map +1 -0
  653. package/src/services/mnemonic.d.ts +61 -0
  654. package/src/services/mnemonic.d.ts.map +1 -0
  655. package/src/services/mnemonic.js +114 -0
  656. package/src/services/mnemonic.js.map +1 -0
  657. package/src/services/request-user.d.ts +23 -0
  658. package/src/services/request-user.d.ts.map +1 -0
  659. package/src/services/request-user.js +66 -0
  660. package/src/services/request-user.js.map +1 -0
  661. package/src/services/role.d.ts +86 -0
  662. package/src/services/role.d.ts.map +1 -0
  663. package/src/services/role.js +285 -0
  664. package/src/services/role.js.map +1 -0
  665. package/src/services/symmetric.d.ts +42 -0
  666. package/src/services/symmetric.d.ts.map +1 -0
  667. package/src/services/symmetric.js +101 -0
  668. package/src/services/symmetric.js.map +1 -0
  669. package/src/services/system-user.d.ts +17 -0
  670. package/src/services/system-user.d.ts.map +1 -0
  671. package/src/services/system-user.js +46 -0
  672. package/src/services/system-user.js.map +1 -0
  673. package/src/services/user.d.ts +349 -0
  674. package/src/services/user.d.ts.map +1 -0
  675. package/src/services/user.js +1442 -0
  676. package/src/services/user.js.map +1 -0
  677. package/src/services/xor.d.ts +24 -0
  678. package/src/services/xor.d.ts.map +1 -0
  679. package/src/services/xor.js +37 -0
  680. package/src/services/xor.js.map +1 -0
  681. package/src/testing.d.ts +3 -0
  682. package/src/testing.d.ts.map +1 -0
  683. package/src/testing.js +7 -0
  684. package/src/testing.js.map +1 -0
  685. package/src/transactions/{index.ts → index.d.ts} +1 -0
  686. package/src/transactions/index.d.ts.map +1 -0
  687. package/src/transactions/index.js +5 -0
  688. package/src/transactions/index.js.map +1 -0
  689. package/src/transactions/transaction-manager.d.ts +12 -0
  690. package/src/transactions/transaction-manager.d.ts.map +1 -0
  691. package/src/transactions/transaction-manager.js +30 -0
  692. package/src/transactions/transaction-manager.js.map +1 -0
  693. package/src/types/{app-config.ts → app-config.d.ts} +9 -10
  694. package/src/types/app-config.d.ts.map +1 -0
  695. package/src/types/app-config.js +3 -0
  696. package/src/types/app-config.js.map +1 -0
  697. package/src/types/{controller-config.ts → controller-config.d.ts} +7 -8
  698. package/src/types/controller-config.d.ts.map +1 -0
  699. package/src/types/controller-config.js +3 -0
  700. package/src/types/controller-config.js.map +1 -0
  701. package/src/types/{environment-variables.ts → environment-variables.d.ts} +5 -26
  702. package/src/types/environment-variables.d.ts.map +1 -0
  703. package/src/types/environment-variables.js +39 -0
  704. package/src/types/environment-variables.js.map +1 -0
  705. package/src/types/id-converters.d.ts +28 -0
  706. package/src/types/id-converters.d.ts.map +1 -0
  707. package/src/types/id-converters.js +45 -0
  708. package/src/types/id-converters.js.map +1 -0
  709. package/src/types/{index.ts → index.d.ts} +1 -0
  710. package/src/types/index.d.ts.map +1 -0
  711. package/src/types/index.js +6 -0
  712. package/src/types/index.js.map +1 -0
  713. package/src/types/{mongoose-helpers.ts → mongoose-helpers.d.ts} +2 -2
  714. package/src/types/mongoose-helpers.d.ts.map +1 -0
  715. package/src/types/mongoose-helpers.js +6 -0
  716. package/src/types/mongoose-helpers.js.map +1 -0
  717. package/src/types.d.ts +67 -34
  718. package/src/types.d.ts.map +1 -0
  719. package/src/types.js +14 -0
  720. package/src/types.js.map +1 -0
  721. package/src/utils.d.ts +210 -0
  722. package/src/utils.d.ts.map +1 -0
  723. package/src/utils.js +818 -0
  724. package/src/utils.js.map +1 -0
  725. package/src/validation/{index.ts → index.d.ts} +1 -0
  726. package/src/validation/index.d.ts.map +1 -0
  727. package/src/validation/index.js +5 -0
  728. package/src/validation/index.js.map +1 -0
  729. package/src/validation/validation-builder.d.ts +32 -0
  730. package/src/validation/validation-builder.d.ts.map +1 -0
  731. package/src/validation/validation-builder.js +81 -0
  732. package/src/validation/validation-builder.js.map +1 -0
  733. package/LICENSE +0 -21
  734. package/src/__tests__/fixtures/model-mocks.mock.ts +0 -164
  735. package/src/__tests__/helpers/application.mock.ts +0 -89
  736. package/src/__tests__/helpers/setup-test-env.ts +0 -190
  737. package/src/application-base.ts +0 -536
  738. package/src/application-concrete.ts +0 -42
  739. package/src/application.ts +0 -321
  740. package/src/backup-code.ts +0 -348
  741. package/src/builders/application-builder.ts +0 -131
  742. package/src/constants.ts +0 -83
  743. package/src/container/service-container.ts +0 -50
  744. package/src/container/service-definitions.ts +0 -11
  745. package/src/controllers/base.ts +0 -499
  746. package/src/controllers/user.ts +0 -1711
  747. package/src/decorators/base-controller.ts +0 -77
  748. package/src/decorators/controller.ts +0 -146
  749. package/src/decorators/zod-validation.ts +0 -58
  750. package/src/defaults.ts +0 -249
  751. package/src/documents/base.ts +0 -10
  752. package/src/documents/email-token.ts +0 -13
  753. package/src/documents/used-direct-login-token.ts +0 -7
  754. package/src/enumerations/base-model-name.ts +0 -41
  755. package/src/enumerations/length-encoding-type.ts +0 -6
  756. package/src/enumerations/schema-collection.ts +0 -33
  757. package/src/enumerations/symmetric-error-type.ts +0 -4
  758. package/src/environment.ts +0 -836
  759. package/src/errors/express-validation.ts +0 -21
  760. package/src/errors/invalid-backup-code-version.ts +0 -15
  761. package/src/errors/invalid-jwt-token.ts +0 -11
  762. package/src/errors/invalid-model.ts +0 -11
  763. package/src/errors/invalid-new-password.ts +0 -18
  764. package/src/errors/invalid-password.ts +0 -13
  765. package/src/errors/missing-validated-data.ts +0 -36
  766. package/src/errors/mnemonic-or-password-required.ts +0 -13
  767. package/src/errors/model-not-registered.ts +0 -11
  768. package/src/errors/mongoose-validation.ts +0 -38
  769. package/src/errors/symmetric.ts +0 -37
  770. package/src/errors/token-expired.ts +0 -11
  771. package/src/get-language.ts +0 -53
  772. package/src/get-timezone.ts +0 -61
  773. package/src/interfaces/api-express-validation-error-response.ts +0 -8
  774. package/src/interfaces/api-message-response.ts +0 -3
  775. package/src/interfaces/api-responses/user-settings-response.ts +0 -12
  776. package/src/interfaces/application.ts +0 -16
  777. package/src/interfaces/backend-objects/email-token.ts +0 -9
  778. package/src/interfaces/backend-objects/request-user.ts +0 -8
  779. package/src/interfaces/backend-objects/role.ts +0 -6
  780. package/src/interfaces/backend-objects/user.ts +0 -7
  781. package/src/interfaces/checksum-config.ts +0 -4
  782. package/src/interfaces/checksum-consts.ts +0 -13
  783. package/src/interfaces/constants.ts +0 -103
  784. package/src/interfaces/controller-config.ts +0 -36
  785. package/src/interfaces/create-user-basics.ts +0 -17
  786. package/src/interfaces/csp-config.ts +0 -16
  787. package/src/interfaces/csp-definition.ts +0 -49
  788. package/src/interfaces/deep-partial.ts +0 -3
  789. package/src/interfaces/email-service.ts +0 -8
  790. package/src/interfaces/environment-mongo.ts +0 -76
  791. package/src/interfaces/environment.ts +0 -185
  792. package/src/interfaces/failable-result.ts +0 -6
  793. package/src/interfaces/fec-consts.ts +0 -4
  794. package/src/interfaces/flexible-csp.ts +0 -18
  795. package/src/interfaces/handleable-error-options.ts +0 -6
  796. package/src/interfaces/jwt-consts.ts +0 -23
  797. package/src/interfaces/jwt-sign-response.ts +0 -19
  798. package/src/interfaces/mongo-errors.ts +0 -5
  799. package/src/interfaces/request-user.ts +0 -70
  800. package/src/interfaces/required-string-keys.ts +0 -26
  801. package/src/interfaces/schema.ts +0 -31
  802. package/src/interfaces/server-init-result.ts +0 -40
  803. package/src/interfaces/status-code-response.ts +0 -7
  804. package/src/interfaces/symmetric-encryption-results.ts +0 -4
  805. package/src/middlewares/authenticate-crypto.ts +0 -216
  806. package/src/middlewares/authenticate-token.ts +0 -150
  807. package/src/middlewares/cleanup-crypto.ts +0 -37
  808. package/src/middlewares/set-global-context-language.ts +0 -24
  809. package/src/middlewares.ts +0 -112
  810. package/src/model-registry.ts +0 -79
  811. package/src/models/email-token.ts +0 -15
  812. package/src/models/mnemonic.ts +0 -15
  813. package/src/models/role.ts +0 -15
  814. package/src/models/used-direct-login-token.ts +0 -15
  815. package/src/models/user-role.ts +0 -13
  816. package/src/models/user.ts +0 -15
  817. package/src/pipeline/pipeline-builder.ts +0 -18
  818. package/src/plugins/plugin-interface.ts +0 -8
  819. package/src/plugins/plugin-manager.ts +0 -42
  820. package/src/registry/email-service-registry.ts +0 -53
  821. package/src/responses/response-builder.ts +0 -86
  822. package/src/routers/api.ts +0 -196
  823. package/src/routers/app.ts +0 -333
  824. package/src/routers/base.ts +0 -13
  825. package/src/routers/router-config.ts +0 -16
  826. package/src/routing/index.ts +0 -1
  827. package/src/routing/route-builder.ts +0 -128
  828. package/src/schemas/email-token.ts +0 -95
  829. package/src/schemas/mnemonic.ts +0 -37
  830. package/src/schemas/role.ts +0 -137
  831. package/src/schemas/schema.ts +0 -164
  832. package/src/schemas/used-direct-login-token.ts +0 -45
  833. package/src/schemas/user-role.ts +0 -79
  834. package/src/schemas/user.ts +0 -224
  835. package/src/services/backup-code.ts +0 -321
  836. package/src/services/base.ts +0 -30
  837. package/src/services/checksum.ts +0 -167
  838. package/src/services/crc.ts +0 -213
  839. package/src/services/database-initialization.ts +0 -1648
  840. package/src/services/direct-login-token.ts +0 -61
  841. package/src/services/dummy-email-service.ts +0 -20
  842. package/src/services/fec-usage-example.ts +0 -102
  843. package/src/services/fec.ts +0 -355
  844. package/src/services/jwt.ts +0 -130
  845. package/src/services/key-wrapping.ts +0 -447
  846. package/src/services/mnemonic.ts +0 -168
  847. package/src/services/request-user.ts +0 -101
  848. package/src/services/role.ts +0 -414
  849. package/src/services/symmetric.ts +0 -139
  850. package/src/services/system-user.ts +0 -79
  851. package/src/services/user.ts +0 -2281
  852. package/src/services/xor.ts +0 -34
  853. package/src/testing.ts +0 -3
  854. package/src/transactions/transaction-manager.ts +0 -37
  855. package/src/types/id-converters.ts +0 -53
  856. package/src/types/mongoose-override.d.ts +0 -1
  857. package/src/types/mongoose.d.ts +0 -1
  858. package/src/types.ts +0 -130
  859. package/src/utils.ts +0 -1087
  860. package/src/validation/validation-builder.ts +0 -115
@@ -1,1648 +0,0 @@
1
- import {
2
- ECIES,
3
- EmailString,
4
- IECIESConfig,
5
- MemberType,
6
- SecureBuffer,
7
- SecureString,
8
- } from '@digitaldefiance/ecies-lib';
9
- import {
10
- TranslatableGenericError,
11
- TranslatableHandleableGenericError,
12
- } from '@digitaldefiance/i18n-lib';
13
- import { Connection, Types } from '@digitaldefiance/mongoose-types';
14
- import {
15
- Member as BackendMember,
16
- ECIESService,
17
- } from '@digitaldefiance/node-ecies-lib';
18
- import {
19
- AccountStatus,
20
- getSuiteCoreI18nEngine,
21
- IFailableResult,
22
- SuiteCoreComponentId,
23
- SuiteCoreStringKey,
24
- TranslatableSuiteError,
25
- TranslatableSuiteHandleableError,
26
- } from '@digitaldefiance/suite-core-lib';
27
- import { crc32 } from 'crc';
28
- import { createHash, randomBytes } from 'crypto';
29
- import * as fs from 'fs';
30
- import { ObjectId as MongoObjectId } from 'mongodb';
31
- import * as path from 'path';
32
- import { BackupCode } from '../backup-code';
33
- import { IMnemonicDocument } from '../documents/mnemonic';
34
- import { IRoleDocument } from '../documents/role';
35
- import { IUserDocument } from '../documents/user';
36
- import { IUserRoleDocument } from '../documents/user-role';
37
- import { BaseModelName } from '../enumerations/base-model-name';
38
- import { Environment } from '../environment';
39
- import { IDBInitResult } from '../interfaces';
40
- import { IApplication } from '../interfaces/application';
41
- import { IServerInitResult } from '../interfaces/server-init-result';
42
- import { ModelRegistry } from '../model-registry';
43
- import { KeyWrappingService } from '../services/key-wrapping';
44
- import { convertObjectIdToGenericId } from '../types/id-converters';
45
- import { debugLog, directLog, withTransaction } from '../utils';
46
- import { BackupCodeService } from './backup-code';
47
- import { MnemonicService } from './mnemonic';
48
- import { RoleService } from './role';
49
- import { SystemUserService } from './system-user';
50
-
51
- export abstract class DatabaseInitializationService {
52
- // Static initialization state management
53
- protected static initializationPromises = new Map<
54
- string,
55
- Promise<IFailableResult<IServerInitResult>>
56
- >();
57
- protected static initializationLock = new Map<string, boolean>();
58
- protected static defaultI18nTFunc(
59
- str: string,
60
- variables?: Record<string, unknown>,
61
- language?: string,
62
- application?: IApplication,
63
- ): string {
64
- // Handles template strings with {{component.key}} syntax
65
- return getSuiteCoreI18nEngine(
66
- application ? { constants: application.constants } : undefined,
67
- ).t(str, variables, language);
68
- }
69
-
70
- /**
71
- * Get the mnemonic or generate a new one if not present
72
- * @param mnemonic The existing mnemonic or undefined
73
- * @param eciesService The ECIES service to generate a new mnemonic
74
- * @returns The existing or new mnemonic
75
- */
76
- public static mnemonicOrNew(
77
- mnemonic: SecureString | undefined,
78
- eciesService: ECIESService,
79
- ): SecureString {
80
- return mnemonic && mnemonic.hasValue
81
- ? mnemonic
82
- : eciesService.generateNewMnemonic();
83
- }
84
- /**
85
- * Generate a cache key for a user based on their details
86
- * @param username The username
87
- * @param email The email address
88
- * @param mnemonic The mnemonic
89
- * @param id The user ID
90
- * @returns The generated cache key
91
- */
92
- public static cacheKey<I extends Types.ObjectId | string = Types.ObjectId>(
93
- username: string,
94
- email: EmailString,
95
- mnemonic: SecureString,
96
- id: I,
97
- idToString: (id: I) => string = (id) => String(id),
98
- ): string {
99
- const combined = `${username}|${email.email}|${mnemonic.value}|${idToString(
100
- id,
101
- )}`;
102
- const buffer = Buffer.from(combined, 'utf-8');
103
- const crcHash = crc32(buffer);
104
- return crcHash.toString(16).padStart(8, '0');
105
- }
106
- /**
107
- * Get a cached BackendMember or create a new one if not cached
108
- * @param username The username
109
- * @param email The email address
110
- * @param mnemonic The mnemonic or undefined to generate a new one
111
- * @param memberType The type of member (Admin, Member, System)
112
- * @param eciesService The ECIES service to handle key generation
113
- * @param memberId Optional specific member ID to use
114
- * @param createdBy Optional ID of the user who created this member
115
- * @returns The cached or newly created BackendMember and the mnemonic used
116
- */
117
- public static cacheOrNew<I extends Types.ObjectId | string = Types.ObjectId>(
118
- username: string,
119
- email: EmailString,
120
- mnemonic: SecureString | undefined,
121
- memberType: MemberType,
122
- eciesService: ECIESService,
123
- memberId?: I,
124
- createdBy?: I,
125
- idGenerator?: () => I,
126
- idToString: (id: I) => string = (id) => String(id),
127
- ): {
128
- member: BackendMember<I>;
129
- mnemonic: SecureString;
130
- } {
131
- const m = this.mnemonicOrNew(mnemonic, eciesService);
132
-
133
- const newId: I = memberId
134
- ? memberId
135
- : idGenerator
136
- ? idGenerator()
137
- : convertObjectIdToGenericId<I>(new MongoObjectId());
138
- const key = DatabaseInitializationService.cacheKey(
139
- username,
140
- email,
141
- m,
142
- newId,
143
- idToString,
144
- );
145
- if (!global.__MEMBER_CACHE__) {
146
- global.__MEMBER_CACHE__ = new Map<
147
- string,
148
- {
149
- member: BackendMember<Types.ObjectId>;
150
- mnemonic: SecureString;
151
- }
152
- >();
153
- }
154
- if (!global.__MEMBER_CACHE__.has(key)) {
155
- const { wallet } = eciesService.walletAndSeedFromMnemonic(m);
156
-
157
- // Get private key from wallet
158
- const privateKey = wallet.getPrivateKey();
159
- // Get compressed public key (already includes prefix)
160
- const publicKeyWithPrefix = eciesService.getPublicKey(
161
- Buffer.from(privateKey),
162
- );
163
-
164
- const user: BackendMember<I> = new BackendMember<I>(
165
- eciesService,
166
- memberType,
167
- username,
168
- email,
169
- publicKeyWithPrefix,
170
- new SecureBuffer(privateKey),
171
- wallet,
172
- newId,
173
- undefined,
174
- undefined,
175
- createdBy,
176
- );
177
- global.__MEMBER_CACHE__.set(key, {
178
- mnemonic: m,
179
- member: user as unknown as BackendMember<Types.ObjectId>,
180
- });
181
- return { mnemonic: m, member: user };
182
- } else {
183
- return global.__MEMBER_CACHE__.get(key)! as {
184
- mnemonic: SecureString;
185
- member: BackendMember<I>;
186
- };
187
- }
188
- }
189
-
190
- /**
191
- * Generate a random password
192
- * @param length The length of the password
193
- * @returns The generated password
194
- */
195
- public static generatePassword(length: number): string {
196
- const specialCharacters = "!@#$%^&*()_+-=[]{};':|,.<>/?";
197
- const numbers = '0123456789';
198
- const letters = 'abcdefghijklmnopqrstuvwxyzABCDEFGHIJKLMNOPQRSTUVWXYZ';
199
-
200
- // Get a random character from a string
201
- const getRandomChar = (chars: string): string => {
202
- // amazonq-ignore-next-line false positive
203
- const randomIndex = randomBytes(1)[0] % chars.length;
204
- return chars[randomIndex];
205
- };
206
-
207
- // Start with one of each required character type
208
- // amazonq-ignore-next-line false positive
209
- let password = '';
210
- password += getRandomChar(letters);
211
- password += getRandomChar(numbers);
212
- password += getRandomChar(specialCharacters);
213
-
214
- // Fill the rest with random characters from all types
215
- const allCharacters = specialCharacters + numbers + letters;
216
- for (let i = password.length; i < length; i++) {
217
- password += getRandomChar(allCharacters);
218
- }
219
-
220
- // Shuffle the password characters to avoid predictable pattern
221
- const chars = password.split('');
222
- for (let i = chars.length - 1; i > 0; i--) {
223
- // amazonq-ignore-next-line already fixed
224
- const j = randomBytes(1)[0] % (i + 1);
225
- [chars[i], chars[j]] = [chars[j], chars[i]];
226
- }
227
- return chars.join('');
228
- }
229
-
230
- /**
231
- * Drops the database
232
- * @param connection The database connection
233
- * @returns True if the database was dropped, false if not connected
234
- */
235
- public static async dropDatabase(connection: Connection): Promise<boolean> {
236
- if (!connection.db) return false;
237
- debugLog(
238
- true,
239
- 'warn',
240
- this.defaultI18nTFunc('{{SuiteCoreStringKey.Admin_DroppingDatabase}}'),
241
- );
242
- return connection.db.dropDatabase();
243
- }
244
-
245
- public static getInitOptions<
246
- I extends Types.ObjectId | string = Types.ObjectId,
247
- >(
248
- application: IApplication,
249
- ): {
250
- adminId?: I;
251
- adminMnemonic?: SecureString;
252
- adminPassword?: SecureString;
253
- adminRoleId?: I;
254
- adminUserRoleId?: I;
255
- adminBackupCodes?: BackupCode[];
256
- memberId?: I;
257
- memberMnemonic?: SecureString;
258
- memberPassword?: SecureString;
259
- memberRoleId?: I;
260
- memberUserRoleId?: I;
261
- memberBackupCodes?: BackupCode[];
262
- systemId?: I;
263
- systemMnemonic?: SecureString;
264
- systemPassword?: SecureString;
265
- systemRoleId?: I;
266
- systemUserRoleId?: I;
267
- systemBackupCodes?: BackupCode[];
268
- } {
269
- const env = application.environment as Environment<I>;
270
- return {
271
- adminId: env.adminId,
272
- adminMnemonic: env.adminMnemonic?.hasValue
273
- ? env.adminMnemonic
274
- : undefined,
275
- adminPassword: env.adminPassword?.hasValue
276
- ? env.adminPassword
277
- : undefined,
278
- adminRoleId: env.adminRoleId as I,
279
- adminUserRoleId: env.adminUserRoleId,
280
- adminBackupCodes: env.adminBackupCodes,
281
- memberId: env.memberId,
282
- memberMnemonic: env.memberMnemonic?.hasValue
283
- ? env.memberMnemonic
284
- : undefined,
285
- memberPassword: env.memberPassword?.hasValue
286
- ? env.memberPassword
287
- : undefined,
288
- memberRoleId: env.memberRoleId as I,
289
- memberUserRoleId: env.memberUserRoleId,
290
- memberBackupCodes: env.memberBackupCodes,
291
- systemId: env.systemId,
292
- systemMnemonic: env.systemMnemonic?.hasValue
293
- ? env.systemMnemonic
294
- : undefined,
295
- systemPassword: env.systemPassword?.hasValue
296
- ? env.systemPassword
297
- : undefined,
298
- systemRoleId: env.systemRoleId as I,
299
- systemUserRoleId: env.systemUserRoleId,
300
- systemBackupCodes: env.systemBackupCodes,
301
- };
302
- }
303
-
304
- public static serverInitResultHash<
305
- I extends Types.ObjectId | string = Types.ObjectId,
306
- >(
307
- serverInitResult: IServerInitResult<I>,
308
- idToString: (id: I) => string = (id) => String(id),
309
- ): string {
310
- const h = createHash('sha256');
311
- h.update(idToString(serverInitResult.adminUser._id as I));
312
- h.update(idToString(serverInitResult.adminRole._id as I));
313
- h.update(idToString(serverInitResult.adminUserRole._id as I));
314
- h.update(serverInitResult.adminUsername);
315
- h.update(serverInitResult.adminEmail);
316
- h.update(serverInitResult.adminMnemonic);
317
- h.update(serverInitResult.adminPassword);
318
- h.update(serverInitResult.adminUser.publicKey);
319
- serverInitResult.adminBackupCodes.map((bc) => h.update(bc));
320
- h.update(idToString(serverInitResult.memberUser._id as I));
321
- h.update(idToString(serverInitResult.memberRole._id as I));
322
- h.update(idToString(serverInitResult.memberUserRole._id as I));
323
- h.update(serverInitResult.memberUsername);
324
- h.update(serverInitResult.memberEmail);
325
- h.update(serverInitResult.memberMnemonic);
326
- h.update(serverInitResult.memberPassword);
327
- h.update(serverInitResult.memberUser.publicKey);
328
- serverInitResult.memberBackupCodes.map((bc) => h.update(bc));
329
- h.update(idToString(serverInitResult.systemUser._id as I));
330
- h.update(idToString(serverInitResult.systemRole._id as I));
331
- h.update(idToString(serverInitResult.systemUserRole._id as I));
332
- h.update(serverInitResult.systemUsername);
333
- h.update(serverInitResult.systemEmail);
334
- h.update(serverInitResult.systemMnemonic);
335
- h.update(serverInitResult.systemPassword);
336
- h.update(serverInitResult.systemUser.publicKey);
337
- serverInitResult.systemBackupCodes.map((bc) => h.update(bc));
338
- return h.digest('hex');
339
- }
340
-
341
- /**
342
- * Initialize the user database with default users and roles (with dependency injection)
343
- * @param application The application
344
- * @param keyWrappingService The key wrapping service
345
- * @param mnemonicService The mnemonic service
346
- * @param eciesService The ECIES service
347
- * @param roleService The role service
348
- * @param backupCodeService The backup code service
349
- * @returns The result of the initialization
350
- */
351
- public static async initUserDbWithServices<
352
- I extends Types.ObjectId | string = Types.ObjectId,
353
- >(
354
- application: IApplication,
355
- keyWrappingService: KeyWrappingService,
356
- mnemonicService: MnemonicService<I>,
357
- eciesService: ECIESService,
358
- roleService: RoleService<I>,
359
- backupCodeService: BackupCodeService<I>,
360
- idGenerator?: () => I,
361
- idToString: (id: I) => string = (id) =>
362
- application.constants.idProvider.idToString(id),
363
- ): Promise<IDBInitResult<IServerInitResult<I>>> {
364
- const engine = getSuiteCoreI18nEngine({ constants: application.constants });
365
- const isTestEnvironment = process.env['NODE_ENV'] === 'test';
366
- const options =
367
- DatabaseInitializationService.getInitOptions<I>(application);
368
- const effectiveIdGenerator: () => I = (idGenerator ??
369
- (() =>
370
- application.environment.idAdapter(
371
- application.constants.idProvider.generate(),
372
- ))) as () => I;
373
- const UserModel = ModelRegistry.instance.getTypedModel<
374
- IUserDocument<string, I>
375
- >(BaseModelName.User);
376
- const RoleModel = ModelRegistry.instance.getTypedModel<IRoleDocument<I>>(
377
- BaseModelName.Role,
378
- );
379
- const adminUserId: I = options.adminId ?? effectiveIdGenerator();
380
- const adminRoleId: I = options.adminRoleId ?? effectiveIdGenerator();
381
- const adminUserRoleId: I =
382
- options.adminUserRoleId ?? effectiveIdGenerator();
383
- const memberUserId: I = options.memberId ?? effectiveIdGenerator();
384
- const memberRoleId: I = options.memberRoleId ?? effectiveIdGenerator();
385
- const memberUserRoleId: I =
386
- options.memberUserRoleId ?? effectiveIdGenerator();
387
- const systemUserId: I = options.systemId ?? effectiveIdGenerator();
388
- const systemRoleId: I = options.systemRoleId ?? effectiveIdGenerator();
389
- const systemUserRoleId: I =
390
- options.systemUserRoleId ?? effectiveIdGenerator();
391
-
392
- // Check for existing users and roles with optimized queries
393
- // Use lean() for better performance on read-only operations
394
- const [existingUsers, existingRoles] = await Promise.all([
395
- UserModel.find({
396
- username: {
397
- $in: [
398
- application.constants.SystemUser,
399
- application.constants.AdministratorUser,
400
- application.constants.MemberUser,
401
- ],
402
- },
403
- }).lean(),
404
- RoleModel.find({
405
- name: {
406
- $in: [
407
- application.constants.AdministratorRole,
408
- application.constants.MemberRole,
409
- application.constants.SystemRole,
410
- ],
411
- },
412
- }).lean(),
413
- ]);
414
-
415
- if (existingUsers.length > 0 || existingRoles.length > 0) {
416
- // Database is already initialized, return the existing data
417
- const existingAdminUser = existingUsers.find(
418
- (u) => u.username === application.constants.AdministratorUser,
419
- );
420
- const existingMemberUser = existingUsers.find(
421
- (u) => u.username === application.constants.MemberUser,
422
- );
423
- const existingSystemUser = existingUsers.find(
424
- (u) => u.username === application.constants.SystemUser,
425
- );
426
-
427
- if (existingAdminUser && existingMemberUser && existingSystemUser) {
428
- const adminUserDoc = UserModel.hydrate(existingAdminUser);
429
- const memberUserDoc = UserModel.hydrate(existingMemberUser);
430
- const systemUserDoc = UserModel.hydrate(existingSystemUser);
431
-
432
- // Try to construct a minimal result from existing data
433
- // Note: This is a fallback case and some data may not be available
434
- const UserRoleModel = ModelRegistry.instance.getTypedModel<
435
- IUserRoleDocument<I>
436
- >(BaseModelName.UserRole);
437
- const [
438
- adminRole,
439
- memberRole,
440
- systemRole,
441
- adminUserRole,
442
- memberUserRole,
443
- systemUserRole,
444
- ] = await Promise.all([
445
- RoleModel.findOne({ name: application.constants.AdministratorRole }),
446
- RoleModel.findOne({ name: application.constants.MemberRole }),
447
- RoleModel.findOne({ name: application.constants.SystemRole }),
448
- UserRoleModel.findOne({ userId: adminUserDoc._id }),
449
- UserRoleModel.findOne({ userId: memberUserDoc._id }),
450
- UserRoleModel.findOne({ userId: systemUserDoc._id }),
451
- ]);
452
-
453
- // detailed case
454
- if (
455
- adminRole &&
456
- memberRole &&
457
- systemRole &&
458
- adminUserRole &&
459
- memberUserRole &&
460
- systemUserRole
461
- ) {
462
- return {
463
- alreadyInitialized: true,
464
- success: false,
465
- data: {
466
- adminRole,
467
- adminUserRole,
468
- adminUser: adminUserDoc,
469
- adminUsername: adminUserDoc.username,
470
- adminEmail: adminUserDoc.email,
471
- adminMnemonic: '', // Not available in fallback
472
- adminPassword: '', // Not available in fallback
473
- adminBackupCodes: [], // Not available in fallback
474
- adminMember: {} as BackendMember<I>, // Not available in fallback
475
- memberRole,
476
- memberUserRole,
477
- memberUser: memberUserDoc,
478
- memberUsername: memberUserDoc.username,
479
- memberEmail: memberUserDoc.email,
480
- memberMnemonic: '', // Not available in fallback
481
- memberPassword: '', // Not available in fallback
482
- memberBackupCodes: [], // Not available in fallback
483
- memberMember: {} as BackendMember<I>, // Not available in fallback
484
- systemRole,
485
- systemUserRole,
486
- systemUser: systemUserDoc,
487
- systemUsername: systemUserDoc.username,
488
- systemEmail: systemUserDoc.email,
489
- systemMnemonic: '', // Not available in fallback
490
- systemPassword: '', // Not available in fallback
491
- systemBackupCodes: [], // Not available in fallback
492
- systemMember: {} as BackendMember<I>, // Not available in fallback
493
- },
494
- message: engine.translate(
495
- SuiteCoreComponentId,
496
- SuiteCoreStringKey.Admin_DatabaseAlreadyInitialized,
497
- ),
498
- error: new Error(
499
- engine.translate(
500
- SuiteCoreComponentId,
501
- SuiteCoreStringKey.Admin_DatabaseAlreadyInitialized,
502
- ),
503
- ),
504
- };
505
- }
506
- }
507
-
508
- // basic case
509
- return {
510
- alreadyInitialized: true,
511
- success: false,
512
- message: engine.translate(
513
- SuiteCoreComponentId,
514
- SuiteCoreStringKey.Admin_DatabaseAlreadyInitialized,
515
- ),
516
- error: new Error(
517
- engine.translate(
518
- SuiteCoreComponentId,
519
- SuiteCoreStringKey.Admin_DatabaseAlreadyInitialized,
520
- ),
521
- ),
522
- };
523
- }
524
-
525
- debugLog(
526
- application.environment.detailedDebug,
527
- 'log',
528
- engine.translate(
529
- SuiteCoreComponentId,
530
- SuiteCoreStringKey.Admin_SettingUpUsersAndRoles,
531
- ),
532
- );
533
- const now = new Date();
534
-
535
- // Add a small random delay in test environments to reduce collision probability
536
- if (isTestEnvironment) {
537
- const delay = (randomBytes(1)[0] % 50) + 10; // 10-60ms random delay (reduced)
538
- await new Promise((resolve) => setTimeout(resolve, delay));
539
- }
540
-
541
- try {
542
- // Use test-optimized settings for better performance
543
- const transactionOptions = isTestEnvironment
544
- ? { timeoutMs: 15000, retryAttempts: 2 } // Reduced timeout and retries for tests
545
- : { timeoutMs: 120000 }; // Keep original production timeout
546
-
547
- const result = await withTransaction<{
548
- adminRole: IRoleDocument<I>;
549
- memberRole: IRoleDocument<I>;
550
- systemRole: IRoleDocument<I>;
551
- systemDoc: IUserDocument<string, I>;
552
- systemUserRoleDoc: IUserRoleDocument<I>;
553
- systemPassword: string;
554
- systemMnemonic: string;
555
- systemBackupCodes: BackupCode[];
556
- systemMember: BackendMember<I>;
557
- adminDoc: IUserDocument<string, I>;
558
- adminUserRoleDoc: IUserRoleDocument<I>;
559
- adminPassword: string;
560
- adminMnemonic: string;
561
- adminBackupCodes: BackupCode[];
562
- adminMember: BackendMember<I>;
563
- memberDoc: IUserDocument<string, I>;
564
- memberUserRoleDoc: IUserRoleDocument<I>;
565
- memberPassword: string;
566
- memberMnemonic: string;
567
- memberBackupCodes: BackupCode[];
568
- memberUser: BackendMember<I>;
569
- }>(
570
- application.db.connection,
571
- application.environment.mongo.useTransactions,
572
- undefined,
573
- async (sess) => {
574
- // Check if admin role already exists
575
- let adminRole = await RoleModel.findOne({
576
- name: application.constants.AdministratorRole,
577
- }).session(sess ?? null);
578
- if (!adminRole) {
579
- const adminRoleDocs = await RoleModel.create(
580
- [
581
- {
582
- _id: adminRoleId as I,
583
- name: application.constants.AdministratorRole,
584
- admin: true,
585
- member: true,
586
- system: false,
587
- child: false,
588
- createdAt: now,
589
- updatedAt: now,
590
- createdBy: systemUserId as I,
591
- updatedBy: systemUserId as I,
592
- },
593
- ],
594
- { session: sess },
595
- );
596
- if (adminRoleDocs.length !== 1) {
597
- throw new TranslatableSuiteError(
598
- SuiteCoreStringKey.Error_FailedToCreateRoleTemplate,
599
- {
600
- NAME: application.constants.AdministratorRole,
601
- },
602
- );
603
- }
604
- adminRole = adminRoleDocs[0];
605
- }
606
-
607
- // Check if member role already exists
608
- let memberRole = await RoleModel.findOne({
609
- name: application.constants.MemberRole,
610
- }).session(sess ?? null);
611
- if (!memberRole) {
612
- const memberRoleDocs = await RoleModel.create(
613
- [
614
- {
615
- _id: memberRoleId as I,
616
- name: application.constants.MemberRole,
617
- admin: false,
618
- member: true,
619
- child: false,
620
- system: false,
621
- createdAt: now,
622
- updatedAt: now,
623
- createdBy: systemUserId as I,
624
- updatedBy: systemUserId as I,
625
- },
626
- ],
627
- { session: sess },
628
- );
629
- if (memberRoleDocs.length !== 1) {
630
- throw new TranslatableSuiteError(
631
- SuiteCoreStringKey.Error_FailedToCreateRoleTemplate,
632
- {
633
- NAME: engine.translate(
634
- SuiteCoreComponentId,
635
- SuiteCoreStringKey.Common_Member,
636
- ),
637
- },
638
- );
639
- }
640
- memberRole = memberRoleDocs[0];
641
- }
642
-
643
- // Check if system role already exists
644
- let systemRole = await RoleModel.findOne({
645
- name: application.constants.SystemRole,
646
- }).session(sess ?? null);
647
- if (!systemRole) {
648
- const systemRoleDocs = await RoleModel.create(
649
- [
650
- {
651
- _id: systemRoleId as I,
652
- name: application.constants.SystemRole,
653
- admin: true,
654
- member: true,
655
- system: true,
656
- child: false,
657
- createdAt: now,
658
- updatedAt: now,
659
- createdBy: systemUserId as I,
660
- updatedBy: systemUserId as I,
661
- },
662
- ],
663
- { session: sess },
664
- );
665
- if (systemRoleDocs.length !== 1) {
666
- throw new TranslatableSuiteError(
667
- SuiteCoreStringKey.Error_FailedToCreateRoleTemplate,
668
- );
669
- }
670
- systemRole = systemRoleDocs[0];
671
- }
672
-
673
- const systemUser = DatabaseInitializationService.cacheOrNew<I>(
674
- application.constants.SystemUser,
675
- new EmailString(application.constants.SystemEmail),
676
- options.systemMnemonic!,
677
- MemberType.System,
678
- eciesService,
679
- systemUserId as I,
680
- systemUserId as I,
681
- effectiveIdGenerator,
682
- idToString,
683
- );
684
- backupCodeService.setSystemUser(systemUser.member);
685
- SystemUserService.setSystemUser(
686
- systemUser.member,
687
- application.constants,
688
- );
689
- // Encrypt mnemonic for recovery
690
- const systemEncryptedMnemonic = systemUser.member
691
- .encryptData(Buffer.from(systemUser.mnemonic.value ?? '', 'utf-8'))
692
- .toString('hex');
693
- const systemMnemonicDoc = await mnemonicService.addMnemonic(
694
- systemUser.mnemonic,
695
- sess,
696
- );
697
- if (!systemMnemonicDoc) {
698
- throw new Error(
699
- engine.translate(
700
- SuiteCoreComponentId,
701
- SuiteCoreStringKey.Error_FailedToStoreUserMnemonicTemplate,
702
- {
703
- NAME: engine.translate(
704
- SuiteCoreComponentId,
705
- SuiteCoreStringKey.Common_System,
706
- ),
707
- },
708
- ),
709
- );
710
- }
711
- const systemPasswordSecure = options.systemPassword
712
- ? options.systemPassword
713
- : new SecureString(this.generatePassword(16));
714
-
715
- const systemWrapped = keyWrappingService.wrapSecret(
716
- systemUser.member.privateKey!,
717
- systemPasswordSecure,
718
- application.constants,
719
- );
720
- const systemBackupCodes =
721
- options.systemBackupCodes ?? BackupCode.generateBackupCodes();
722
- const encryptedSystemBackupCodes =
723
- await BackupCode.encryptBackupCodes(
724
- systemUser.member,
725
- systemUser.member,
726
- systemBackupCodes,
727
- );
728
- const systemDocs = await UserModel.create(
729
- [
730
- {
731
- _id: systemUserId as I,
732
- username: application.constants.SystemUser,
733
- email: application.constants.SystemEmail,
734
- publicKey: systemUser.member.publicKey.toString('hex'),
735
- duressPasswords: [],
736
- mnemonicRecovery: systemEncryptedMnemonic,
737
- mnemonicId: systemMnemonicDoc._id,
738
- passwordWrappedPrivateKey: systemWrapped,
739
- backupCodes: encryptedSystemBackupCodes,
740
- timezone: application.environment.timezone,
741
- siteLanguage: 'en-US',
742
- emailVerified: true,
743
- darkMode: false,
744
- accountStatus: AccountStatus.Active,
745
- directChallenge: true, // allow direct challenge login by default
746
- createdAt: now,
747
- updatedAt: now,
748
- createdBy: systemUserId as I,
749
- updatedBy: systemUserId as I,
750
- },
751
- ],
752
- { session: sess },
753
- );
754
- if (systemDocs.length !== 1) {
755
- throw new Error(
756
- engine.translate(
757
- SuiteCoreComponentId,
758
- SuiteCoreStringKey.Error_FailedToCreateUserTemplate,
759
- {
760
- NAME: engine.translate(
761
- SuiteCoreComponentId,
762
- SuiteCoreStringKey.Common_System,
763
- ),
764
- },
765
- ),
766
- );
767
- }
768
-
769
- const systemDoc = systemDocs[0];
770
-
771
- // Create admin user-role relationship
772
- const systemUserRoleDoc = await roleService.addUserToRole(
773
- systemRoleId as I,
774
- systemUserId as I,
775
- systemUserId as I,
776
- sess,
777
- systemUserRoleId,
778
- );
779
-
780
- if (!systemUser.mnemonic.value) {
781
- throw new Error(
782
- engine.translate(
783
- SuiteCoreComponentId,
784
- SuiteCoreStringKey.Error_MnemonicIsNullTemplate,
785
- {
786
- NAME: SuiteCoreStringKey.Common_System,
787
- },
788
- ),
789
- );
790
- }
791
-
792
- const adminUser = DatabaseInitializationService.cacheOrNew<I>(
793
- application.constants.AdministratorUser,
794
- new EmailString(application.constants.AdministratorEmail),
795
- options.adminMnemonic,
796
- MemberType.User,
797
- eciesService,
798
- adminUserId as I,
799
- systemDoc._id,
800
- effectiveIdGenerator,
801
- idToString,
802
- );
803
- // Encrypt mnemonic for recovery
804
- const adminEncryptedMnemonic = adminUser.member
805
- .encryptData(Buffer.from(adminUser.mnemonic.value ?? '', 'utf-8'))
806
- .toString('hex');
807
- const adminMnemonicDoc = await mnemonicService.addMnemonic(
808
- adminUser.mnemonic,
809
- sess,
810
- );
811
- if (!adminMnemonicDoc) {
812
- throw new Error(
813
- engine.translate(
814
- SuiteCoreComponentId,
815
- SuiteCoreStringKey.Error_FailedToStoreUserMnemonicTemplate,
816
- {
817
- NAME: engine.translate(
818
- SuiteCoreComponentId,
819
- SuiteCoreStringKey.Common_Admin,
820
- ),
821
- },
822
- ),
823
- );
824
- }
825
- const adminPasswordSecure = options.adminPassword
826
- ? options.adminPassword
827
- : new SecureString(this.generatePassword(16));
828
-
829
- const adminWrapped = keyWrappingService.wrapSecret(
830
- adminUser.member.privateKey!,
831
- adminPasswordSecure,
832
- );
833
- const adminBackupCodes =
834
- options.adminBackupCodes ?? BackupCode.generateBackupCodes();
835
- const encryptedAdminBackupCodes = await BackupCode.encryptBackupCodes(
836
- adminUser.member,
837
- systemUser.member,
838
- adminBackupCodes,
839
- );
840
- const adminDocs = await UserModel.create(
841
- [
842
- {
843
- _id: adminUserId as I,
844
- username: application.constants.AdministratorUser,
845
- email: application.constants.AdministratorEmail,
846
- publicKey: adminUser.member.publicKey.toString('hex'),
847
- duressPasswords: [],
848
- mnemonicRecovery: adminEncryptedMnemonic,
849
- mnemonicId: adminMnemonicDoc._id,
850
- passwordWrappedPrivateKey: adminWrapped,
851
- backupCodes: encryptedAdminBackupCodes,
852
- timezone: application.environment.timezone,
853
- siteLanguage: 'en-US',
854
- emailVerified: true,
855
- accountStatus: AccountStatus.Active,
856
- directChallenge: true,
857
- createdAt: now,
858
- updatedAt: now,
859
- createdBy: systemUserId as I,
860
- updatedBy: systemUserId as I,
861
- },
862
- ],
863
- { session: sess },
864
- );
865
- if (adminDocs.length !== 1) {
866
- throw new Error(
867
- engine.translate(
868
- SuiteCoreComponentId,
869
- SuiteCoreStringKey.Error_FailedToCreateUserTemplate,
870
- {
871
- NAME: engine.translate(
872
- SuiteCoreComponentId,
873
- SuiteCoreStringKey.Common_Admin,
874
- ),
875
- },
876
- ),
877
- );
878
- }
879
-
880
- const adminDoc = adminDocs[0];
881
-
882
- // Create admin user-role relationship
883
- const adminUserRoleDoc = await roleService.addUserToRole(
884
- adminRoleId as I,
885
- adminUserId as I,
886
- systemUserId as I,
887
- sess,
888
- adminUserRoleId,
889
- );
890
-
891
- if (!adminUser.mnemonic.value) {
892
- throw new Error(
893
- engine.translate(
894
- SuiteCoreComponentId,
895
- SuiteCoreStringKey.Error_MnemonicIsNullTemplate,
896
- {
897
- NAME: engine.translate(
898
- SuiteCoreComponentId,
899
- SuiteCoreStringKey.Common_Admin,
900
- ),
901
- },
902
- ),
903
- );
904
- }
905
-
906
- const memberUser = DatabaseInitializationService.cacheOrNew<I>(
907
- application.constants.MemberUser,
908
- new EmailString(application.constants.MemberEmail),
909
- options.memberMnemonic,
910
- MemberType.User,
911
- eciesService,
912
- memberUserId as I,
913
- systemDoc._id,
914
- effectiveIdGenerator,
915
- idToString,
916
- );
917
- const memberPasswordSecure = options.memberPassword
918
- ? options.memberPassword
919
- : new SecureString(this.generatePassword(16));
920
-
921
- const memberMnemonicDoc = await mnemonicService.addMnemonic(
922
- memberUser.mnemonic,
923
- sess,
924
- );
925
- if (!memberMnemonicDoc) {
926
- throw new Error(
927
- engine.translate(
928
- SuiteCoreComponentId,
929
- SuiteCoreStringKey.Error_FailedToStoreUserMnemonicTemplate,
930
- {
931
- NAME: engine.translate(
932
- SuiteCoreComponentId,
933
- SuiteCoreStringKey.Common_Member,
934
- ),
935
- },
936
- ),
937
- );
938
- }
939
-
940
- // Encrypt mnemonic for recovery
941
- const encryptedMemberMnemonic = memberUser.member
942
- .encryptData(Buffer.from(memberUser.mnemonic.value ?? '', 'utf-8'))
943
- .toString('hex');
944
- const memberWrapped = keyWrappingService.wrapSecret(
945
- memberUser.member.privateKey!,
946
- memberPasswordSecure,
947
- );
948
- const memberBackupCodes =
949
- options.memberBackupCodes ?? BackupCode.generateBackupCodes();
950
- const encryptedMemberBackupCodes =
951
- await BackupCode.encryptBackupCodes(
952
- memberUser.member,
953
- systemUser.member,
954
- memberBackupCodes,
955
- );
956
- const memberDocs = await UserModel.create(
957
- [
958
- {
959
- _id: memberUserId as I,
960
- username: application.constants.MemberUser,
961
- email: application.constants.MemberEmail,
962
- publicKey: memberUser.member.publicKey.toString('hex'),
963
- mnemonicId: memberMnemonicDoc._id,
964
- mnemonicRecovery: encryptedMemberMnemonic,
965
- passwordWrappedPrivateKey: memberWrapped,
966
- backupCodes: encryptedMemberBackupCodes,
967
- duressPasswords: [],
968
- timezone: application.environment.timezone,
969
- siteLanguage: 'en-US',
970
- emailVerified: true,
971
- accountStatus: AccountStatus.Active,
972
- directChallenge: true,
973
- createdAt: now,
974
- updatedAt: now,
975
- createdBy: systemUserId as I,
976
- updatedBy: systemUserId as I,
977
- },
978
- ],
979
- { session: sess },
980
- );
981
- if (memberDocs.length !== 1) {
982
- throw new Error(
983
- engine.translate(
984
- SuiteCoreComponentId,
985
- SuiteCoreStringKey.Error_FailedToCreateUserTemplate,
986
- {
987
- NAME: engine.translate(
988
- SuiteCoreComponentId,
989
- SuiteCoreStringKey.Common_Member,
990
- ),
991
- },
992
- ),
993
- );
994
- }
995
-
996
- const memberDoc = memberDocs[0];
997
-
998
- // Create member user-role relationship
999
- const memberUserRoleDoc = await roleService.addUserToRole(
1000
- memberRoleId as I,
1001
- memberUserId as I,
1002
- systemUserId as I,
1003
- sess,
1004
- memberUserRoleId,
1005
- );
1006
-
1007
- if (!memberUser.mnemonic.value) {
1008
- throw new Error(
1009
- engine.translate(
1010
- SuiteCoreComponentId,
1011
- SuiteCoreStringKey.Error_MnemonicIsNullTemplate,
1012
- {
1013
- NAME: engine.translate(
1014
- SuiteCoreComponentId,
1015
- SuiteCoreStringKey.Common_Member,
1016
- ),
1017
- },
1018
- ),
1019
- );
1020
- }
1021
-
1022
- return {
1023
- adminRole,
1024
- memberRole,
1025
- systemRole,
1026
- systemDoc,
1027
- systemUserRoleDoc,
1028
- systemPassword: systemPasswordSecure.notNullValue,
1029
- systemMnemonic: systemUser.mnemonic.notNullValue,
1030
- systemBackupCodes: systemBackupCodes,
1031
- systemMember: systemUser.member,
1032
- adminDoc,
1033
- adminUserRoleDoc,
1034
- adminPassword: adminPasswordSecure.notNullValue,
1035
- adminMnemonic: adminUser.mnemonic.notNullValue,
1036
- adminBackupCodes: adminBackupCodes,
1037
- adminMember: adminUser.member,
1038
- memberDoc,
1039
- memberUserRoleDoc,
1040
- memberPassword: memberPasswordSecure.notNullValue,
1041
- memberMnemonic: memberUser.mnemonic.notNullValue,
1042
- memberBackupCodes: memberBackupCodes,
1043
- memberUser: memberUser.member,
1044
- };
1045
- },
1046
- transactionOptions,
1047
- );
1048
-
1049
- return {
1050
- alreadyInitialized: false,
1051
- success: true,
1052
- data: {
1053
- adminRole: result.adminRole,
1054
- adminUserRole: result.adminUserRoleDoc,
1055
- adminUser: result.adminDoc,
1056
- adminUsername: result.adminDoc.username,
1057
- adminEmail: result.adminDoc.email,
1058
- adminMnemonic: result.adminMnemonic,
1059
- adminPassword: result.adminPassword,
1060
- adminBackupCodes: result.adminBackupCodes.map((bc) => bc.value ?? ''),
1061
- adminMember: result.adminMember,
1062
- memberRole: result.memberRole,
1063
- memberUserRole: result.memberUserRoleDoc,
1064
- memberUser: result.memberDoc,
1065
- memberUsername: result.memberDoc.username,
1066
- memberEmail: result.memberDoc.email,
1067
- memberMnemonic: result.memberMnemonic,
1068
- memberPassword: result.memberPassword,
1069
- memberBackupCodes: result.memberBackupCodes.map(
1070
- (bc) => bc.value ?? '',
1071
- ),
1072
- memberMember: result.memberUser,
1073
- systemRole: result.systemRole,
1074
- systemUserRole: result.systemUserRoleDoc,
1075
- systemUser: result.systemDoc,
1076
- systemUsername: result.systemDoc.username,
1077
- systemEmail: result.systemDoc.email,
1078
- systemMnemonic: result.systemMnemonic,
1079
- systemPassword: result.systemPassword,
1080
- systemBackupCodes: result.systemBackupCodes.map(
1081
- (bc) => bc.value ?? '',
1082
- ),
1083
- systemMember: result.systemMember,
1084
- },
1085
- };
1086
- } catch (error) {
1087
- // Check if it's a translatable error and display cleanly
1088
- if (
1089
- error instanceof TranslatableGenericError ||
1090
- error instanceof TranslatableHandleableGenericError ||
1091
- error instanceof TranslatableSuiteError ||
1092
- error instanceof TranslatableSuiteHandleableError
1093
- ) {
1094
- return {
1095
- alreadyInitialized: false,
1096
- success: false,
1097
- message: (error as Error).message,
1098
- error: error as Error,
1099
- };
1100
- }
1101
-
1102
- return {
1103
- alreadyInitialized: false,
1104
- success: false,
1105
- message: engine.translate(
1106
- SuiteCoreComponentId,
1107
- SuiteCoreStringKey.Admin_Error_FailedToInitializeUserDatabase,
1108
- ),
1109
- error:
1110
- error instanceof Error
1111
- ? error
1112
- : new Error(
1113
- engine.translate(
1114
- SuiteCoreComponentId,
1115
- SuiteCoreStringKey.Admin_Error_FailedToInitializeUserDatabase,
1116
- ),
1117
- ),
1118
- };
1119
- }
1120
- }
1121
-
1122
- public static serverInitResultsToDotEnv<
1123
- I extends Types.ObjectId | string = Types.ObjectId,
1124
- >(
1125
- serverInitResult: IServerInitResult<I>,
1126
- idToString: (id: I) => string = (id) => String(id),
1127
- ): string {
1128
- return `ADMIN_ID="${idToString(serverInitResult.adminUser._id as I)}"
1129
- ADMIN_MNEMONIC="${serverInitResult.adminMnemonic}"
1130
- ADMIN_ROLE_ID="${idToString(serverInitResult.adminRole._id as I)}"
1131
- ADMIN_USER_ROLE_ID="${idToString(serverInitResult.adminUserRole._id as I)}"
1132
- ADMIN_PASSWORD="${serverInitResult.adminPassword}"
1133
- MEMBER_ID="${idToString(serverInitResult.memberUser._id as I)}"
1134
- MEMBER_MNEMONIC="${serverInitResult.memberMnemonic}"
1135
- MEMBER_ROLE_ID="${idToString(serverInitResult.memberRole._id as I)}"
1136
- MEMBER_USER_ROLE_ID="${idToString(serverInitResult.memberUserRole._id as I)}"
1137
- MEMBER_PASSWORD="${serverInitResult.memberPassword}"
1138
- SYSTEM_ID="${idToString(serverInitResult.systemUser._id as I)}"
1139
- SYSTEM_MNEMONIC="${serverInitResult.systemMnemonic}"
1140
- SYSTEM_PUBLIC_KEY="${serverInitResult.systemUser.publicKey}"
1141
- SYSTEM_ROLE_ID="${idToString(serverInitResult.systemRole._id as I)}"
1142
- SYSTEM_USER_ROLE_ID="${idToString(serverInitResult.systemUserRole._id as I)}"
1143
- SYSTEM_PASSWORD="${serverInitResult.systemPassword}"
1144
- `;
1145
- }
1146
-
1147
- public static printServerInitResults<
1148
- I extends Types.ObjectId | string = Types.ObjectId,
1149
- >(
1150
- result: IServerInitResult<I>,
1151
- printDotEnv: boolean = true,
1152
- idToString: (id: I) => string = (id) => String(id),
1153
- ): void {
1154
- debugLog(
1155
- true,
1156
- 'log',
1157
- this.defaultI18nTFunc(
1158
- '\n=== {{SuiteCoreStringKey.Admin_AccountCredentials}} ===',
1159
- ),
1160
- );
1161
- directLog(
1162
- true,
1163
- 'log',
1164
- this.defaultI18nTFunc(
1165
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_ID}}: {id}',
1166
- {
1167
- id: idToString(result.systemUser._id as I),
1168
- },
1169
- ),
1170
- );
1171
- directLog(
1172
- true,
1173
- 'log',
1174
- this.defaultI18nTFunc(
1175
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_Role}}: {roleName}',
1176
- {
1177
- roleName: result.systemRole.name,
1178
- },
1179
- ),
1180
- );
1181
- directLog(
1182
- true,
1183
- 'log',
1184
- this.defaultI18nTFunc(
1185
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_Role}} {{SuiteCoreStringKey.Common_ID}}: {roleId}',
1186
- {
1187
- roleId: idToString(result.systemRole._id as I),
1188
- },
1189
- ),
1190
- );
1191
- directLog(
1192
- true,
1193
- 'log',
1194
- this.defaultI18nTFunc(
1195
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_User}} {{SuiteCoreStringKey.Common_Role}} {{SuiteCoreStringKey.Common_ID}}: {userRoleId}',
1196
- {
1197
- userRoleId: idToString(result.systemUserRole._id as I),
1198
- },
1199
- ),
1200
- );
1201
- directLog(
1202
- true,
1203
- 'log',
1204
- this.defaultI18nTFunc(
1205
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_Username}}: {username}',
1206
- {
1207
- username: result.systemUsername,
1208
- },
1209
- ),
1210
- );
1211
- directLog(
1212
- true,
1213
- 'log',
1214
- this.defaultI18nTFunc(
1215
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_Email}}: {email}',
1216
- {
1217
- email: result.systemEmail,
1218
- },
1219
- ),
1220
- );
1221
- directLog(
1222
- true,
1223
- 'log',
1224
- this.defaultI18nTFunc(
1225
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_Password}}: {password}',
1226
- {
1227
- password: result.systemPassword,
1228
- },
1229
- ),
1230
- );
1231
- directLog(
1232
- true,
1233
- 'log',
1234
- this.defaultI18nTFunc(
1235
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_Mnemonic}}: {mnemonic}',
1236
- {
1237
- mnemonic: result.systemMnemonic,
1238
- },
1239
- ),
1240
- );
1241
- directLog(
1242
- true,
1243
- 'log',
1244
- this.defaultI18nTFunc(
1245
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_PublicKey}}: {publicKey}',
1246
- {
1247
- publicKey: result.systemUser.publicKey,
1248
- },
1249
- ),
1250
- );
1251
- directLog(
1252
- true,
1253
- 'log',
1254
- `${this.defaultI18nTFunc(
1255
- '{{SuiteCoreStringKey.Common_System}} {{SuiteCoreStringKey.Common_BackupCodes}}',
1256
- )}: ${result.systemBackupCodes.join(', ')}`,
1257
- );
1258
- directLog(true, 'log', '');
1259
- directLog(
1260
- true,
1261
- 'log',
1262
- this.defaultI18nTFunc(
1263
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_ID}}: {id}',
1264
- {
1265
- id: idToString(result.adminUser._id as I),
1266
- },
1267
- ),
1268
- );
1269
- directLog(
1270
- true,
1271
- 'log',
1272
- this.defaultI18nTFunc(
1273
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_Role}}: {roleName}',
1274
- {
1275
- roleName: result.adminRole.name,
1276
- },
1277
- ),
1278
- );
1279
- directLog(
1280
- true,
1281
- 'log',
1282
- this.defaultI18nTFunc(
1283
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_Role}} {{SuiteCoreStringKey.Common_ID}}: {roleId}',
1284
- {
1285
- roleId: idToString(result.adminRole._id as I),
1286
- },
1287
- ),
1288
- );
1289
- directLog(
1290
- true,
1291
- 'log',
1292
- this.defaultI18nTFunc(
1293
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_User}} {{SuiteCoreStringKey.Common_Role}} {{SuiteCoreStringKey.Common_ID}}: {userRoleId}',
1294
- {
1295
- userRoleId: idToString(result.adminUserRole._id as I),
1296
- },
1297
- ),
1298
- );
1299
- directLog(
1300
- true,
1301
- 'log',
1302
- this.defaultI18nTFunc(
1303
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_Username}}: {username}',
1304
- {
1305
- username: result.adminUsername,
1306
- },
1307
- ),
1308
- );
1309
- directLog(
1310
- true,
1311
- 'log',
1312
- this.defaultI18nTFunc(
1313
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_Email}}: {email}',
1314
- {
1315
- email: result.adminEmail,
1316
- },
1317
- ),
1318
- );
1319
- directLog(
1320
- true,
1321
- 'log',
1322
- this.defaultI18nTFunc(
1323
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_Password}}: {password}',
1324
- {
1325
- password: result.adminPassword,
1326
- },
1327
- ),
1328
- );
1329
- directLog(
1330
- true,
1331
- 'log',
1332
- this.defaultI18nTFunc(
1333
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_Mnemonic}}: {mnemonic}',
1334
- {
1335
- mnemonic: result.adminMnemonic,
1336
- },
1337
- ),
1338
- );
1339
- directLog(
1340
- true,
1341
- 'log',
1342
- this.defaultI18nTFunc(
1343
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_PublicKey}}: {publicKey}',
1344
- {
1345
- publicKey: result.adminUser.publicKey,
1346
- },
1347
- ),
1348
- );
1349
- directLog(
1350
- true,
1351
- 'log',
1352
- `${this.defaultI18nTFunc(
1353
- '{{SuiteCoreStringKey.Common_Admin}} {{SuiteCoreStringKey.Common_BackupCodes}}',
1354
- )}: ${result.adminBackupCodes.join(', ')}`,
1355
- );
1356
- directLog(true, 'log', '');
1357
- directLog(
1358
- true,
1359
- 'log',
1360
- this.defaultI18nTFunc(
1361
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_ID}}: {id}',
1362
- {
1363
- id: idToString(result.memberUser._id as I),
1364
- },
1365
- ),
1366
- );
1367
- directLog(
1368
- true,
1369
- 'log',
1370
- this.defaultI18nTFunc(
1371
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_Role}}: {roleName}',
1372
- {
1373
- roleName: result.memberRole.name,
1374
- },
1375
- ),
1376
- );
1377
- directLog(
1378
- true,
1379
- 'log',
1380
- this.defaultI18nTFunc(
1381
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_Role}} {{SuiteCoreStringKey.Common_ID}}: {roleId}',
1382
- {
1383
- roleId: idToString(result.memberRole._id as I),
1384
- },
1385
- ),
1386
- );
1387
- directLog(
1388
- true,
1389
- 'log',
1390
- this.defaultI18nTFunc(
1391
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_User}} {{SuiteCoreStringKey.Common_Role}} {{SuiteCoreStringKey.Common_ID}}: {userRoleId}',
1392
- {
1393
- userRoleId: idToString(result.memberUserRole._id as I),
1394
- },
1395
- ),
1396
- );
1397
- directLog(
1398
- true,
1399
- 'log',
1400
- this.defaultI18nTFunc(
1401
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_Username}}: {username}',
1402
- {
1403
- username: result.memberUsername,
1404
- },
1405
- ),
1406
- );
1407
- directLog(
1408
- true,
1409
- 'log',
1410
- this.defaultI18nTFunc(
1411
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_Email}}: {email}',
1412
- {
1413
- email: result.memberEmail,
1414
- },
1415
- ),
1416
- );
1417
- directLog(
1418
- true,
1419
- 'log',
1420
- this.defaultI18nTFunc(
1421
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_Password}}: {password}',
1422
- {
1423
- password: result.memberPassword,
1424
- },
1425
- ),
1426
- );
1427
- directLog(
1428
- true,
1429
- 'log',
1430
- this.defaultI18nTFunc(
1431
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_Mnemonic}}: {mnemonic}',
1432
- {
1433
- mnemonic: result.memberMnemonic,
1434
- },
1435
- ),
1436
- );
1437
- directLog(
1438
- true,
1439
- 'log',
1440
- this.defaultI18nTFunc(
1441
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_PublicKey}}: {publicKey}',
1442
- {
1443
- publicKey: result.memberUser.publicKey,
1444
- },
1445
- ),
1446
- );
1447
- directLog(
1448
- true,
1449
- 'log',
1450
- `${this.defaultI18nTFunc(
1451
- '{{SuiteCoreStringKey.Common_Member}} {{SuiteCoreStringKey.Common_BackupCodes}}',
1452
- )}: ${result.memberBackupCodes.join(', ')}`,
1453
- );
1454
- directLog(
1455
- true,
1456
- 'log',
1457
- this.defaultI18nTFunc(
1458
- '\n=== {{SuiteCoreStringKey.Admin_EndCredentials}} ===',
1459
- ),
1460
- );
1461
-
1462
- if (printDotEnv) {
1463
- directLog(true, 'log', '');
1464
- debugLog(
1465
- true,
1466
- 'log',
1467
- this.defaultI18nTFunc(
1468
- '=== {{SuiteCoreStringKey.Admin_DotEnvFormat}} ===',
1469
- ),
1470
- );
1471
- directLog(
1472
- true,
1473
- 'log',
1474
- this.serverInitResultsToDotEnv(result, idToString),
1475
- );
1476
- debugLog(
1477
- true,
1478
- 'log',
1479
- this.defaultI18nTFunc(
1480
- '=== {{SuiteCoreStringKey.Admin_EndDotEnvFormat}} ===',
1481
- ),
1482
- );
1483
- }
1484
- }
1485
-
1486
- public static setEnvFromInitResults<
1487
- I extends Types.ObjectId | string = Types.ObjectId,
1488
- >(
1489
- result: IServerInitResult<I>,
1490
- idToString: (id: I) => string = (id) => String(id),
1491
- ): void {
1492
- process.env['ADMIN_ID'] = idToString(result.adminUser._id as I);
1493
- process.env['ADMIN_PUBLIC_KEY'] = result.adminUser.publicKey;
1494
- process.env['ADMIN_MNEMONIC'] = result.adminMnemonic;
1495
- process.env['ADMIN_PASSWORD'] = result.adminPassword;
1496
- process.env['ADMIN_ROLE_ID'] = idToString(result.adminRole._id as I);
1497
- process.env['ADMIN_USER_ROLE_ID'] = idToString(
1498
- result.adminUserRole._id as I,
1499
- );
1500
- //
1501
- process.env['MEMBER_ID'] = idToString(result.memberUser._id as I);
1502
- process.env['MEMBER_PUBLIC_KEY'] = result.memberUser.publicKey;
1503
- process.env['MEMBER_MNEMONIC'] = result.memberMnemonic;
1504
- process.env['MEMBER_PASSWORD'] = result.memberPassword;
1505
- process.env['MEMBER_ROLE_ID'] = idToString(result.memberRole._id as I);
1506
- process.env['MEMBER_USER_ROLE_ID'] = idToString(
1507
- result.memberUserRole._id as I,
1508
- );
1509
- //
1510
- process.env['SYSTEM_ID'] = idToString(result.systemUser._id as I);
1511
- process.env['SYSTEM_PUBLIC_KEY'] = result.systemUser.publicKey;
1512
- process.env['SYSTEM_MNEMONIC'] = result.systemMnemonic;
1513
- process.env['SYSTEM_PASSWORD'] = result.systemPassword;
1514
- process.env['SYSTEM_ROLE_ID'] = idToString(result.systemRole._id as I);
1515
- process.env['SYSTEM_USER_ROLE_ID'] = idToString(
1516
- result.systemUserRole._id as I,
1517
- );
1518
- }
1519
-
1520
- /**
1521
- * Write initialization results to a .env file
1522
- * Updates or adds the credential variables in the specified .env file
1523
- * @param envFilePath Path to the .env file to update
1524
- * @param result The initialization results containing credentials
1525
- * @param idToString Function to convert IDs to strings
1526
- */
1527
- public static writeEnvFile<
1528
- I extends Types.ObjectId | string = Types.ObjectId,
1529
- >(
1530
- envFilePath: string,
1531
- result: IServerInitResult<I>,
1532
- idToString: (id: I) => string = (id) => String(id),
1533
- ): void {
1534
- // Ensure the directory exists
1535
- const dir = path.dirname(envFilePath);
1536
- if (!fs.existsSync(dir)) {
1537
- fs.mkdirSync(dir, { recursive: true });
1538
- }
1539
-
1540
- // Read existing .env file or create empty content
1541
- let envContent = '';
1542
- if (fs.existsSync(envFilePath)) {
1543
- envContent = fs.readFileSync(envFilePath, 'utf-8');
1544
- }
1545
-
1546
- // Define the credentials to update
1547
- const credentials = {
1548
- ADMIN_ID: idToString(result.adminUser._id as I),
1549
- ADMIN_MNEMONIC: result.adminMnemonic,
1550
- ADMIN_ROLE_ID: idToString(result.adminRole._id as I),
1551
- ADMIN_USER_ROLE_ID: idToString(result.adminUserRole._id as I),
1552
- ADMIN_PASSWORD: result.adminPassword,
1553
- MEMBER_ID: idToString(result.memberUser._id as I),
1554
- MEMBER_MNEMONIC: result.memberMnemonic,
1555
- MEMBER_ROLE_ID: idToString(result.memberRole._id as I),
1556
- MEMBER_USER_ROLE_ID: idToString(result.memberUserRole._id as I),
1557
- MEMBER_PASSWORD: result.memberPassword,
1558
- SYSTEM_ID: idToString(result.systemUser._id as I),
1559
- SYSTEM_MNEMONIC: result.systemMnemonic,
1560
- SYSTEM_PUBLIC_KEY: result.systemUser.publicKey,
1561
- SYSTEM_ROLE_ID: idToString(result.systemRole._id as I),
1562
- SYSTEM_USER_ROLE_ID: idToString(result.systemUserRole._id as I),
1563
- SYSTEM_PASSWORD: result.systemPassword,
1564
- };
1565
-
1566
- // Update or add each credential
1567
- for (const [key, value] of Object.entries(credentials)) {
1568
- const regex = new RegExp(`^${key}=.*$`, 'm');
1569
- const newLine = `${key}="${value}"`;
1570
-
1571
- if (regex.test(envContent)) {
1572
- // Update existing line
1573
- envContent = envContent.replace(regex, newLine);
1574
- } else {
1575
- // Add new line (append to end)
1576
- if (envContent && !envContent.endsWith('\n')) {
1577
- envContent += '\n';
1578
- }
1579
- envContent += newLine + '\n';
1580
- }
1581
- }
1582
-
1583
- // Write back to file
1584
- fs.writeFileSync(envFilePath, envContent, 'utf-8');
1585
- debugLog(
1586
- true,
1587
- 'log',
1588
- this.defaultI18nTFunc(
1589
- '{{SuiteCoreStringKey.Admin_CredentialsWrittenToEnv}}',
1590
- {
1591
- path: envFilePath,
1592
- },
1593
- ),
1594
- );
1595
- }
1596
-
1597
- /**
1598
- * Initialize the user database with default users and roles (convenience method)
1599
- * This method creates the necessary services and calls initUserDbWithServices
1600
- * @param application The application
1601
- * @returns The result of the initialization
1602
- */
1603
- public static async initUserDb<
1604
- I extends Types.ObjectId | string = Types.ObjectId,
1605
- >(
1606
- application: IApplication,
1607
- idGenerator?: () => I,
1608
- idToString: (id: I) => string = (id) =>
1609
- application.constants.idProvider.idToString(id),
1610
- ): Promise<IFailableResult<IServerInitResult<I>>> {
1611
- const mnemonicModel = ModelRegistry.instance.getTypedModel<
1612
- IMnemonicDocument<I>
1613
- >(BaseModelName.Mnemonic);
1614
- const mnemonicService = new MnemonicService(
1615
- mnemonicModel,
1616
- application.environment.mnemonicHmacSecret,
1617
- application.constants,
1618
- );
1619
- const config: IECIESConfig = {
1620
- curveName: ECIES.CURVE_NAME,
1621
- primaryKeyDerivationPath: ECIES.PRIMARY_KEY_DERIVATION_PATH,
1622
- mnemonicStrength: ECIES.MNEMONIC_STRENGTH,
1623
- symmetricAlgorithm: ECIES.SYMMETRIC_ALGORITHM_CONFIGURATION,
1624
- symmetricKeyBits: ECIES.SYMMETRIC.KEY_BITS,
1625
- symmetricKeyMode: ECIES.SYMMETRIC.MODE,
1626
- };
1627
- const eciesService = new ECIESService(config);
1628
- const roleService = new RoleService<I>(application);
1629
- const keyWrappingService = new KeyWrappingService();
1630
- const backupCodeService = new BackupCodeService<I>(
1631
- application,
1632
- eciesService,
1633
- keyWrappingService,
1634
- roleService,
1635
- );
1636
-
1637
- return this.initUserDbWithServices<I>(
1638
- application,
1639
- keyWrappingService,
1640
- mnemonicService,
1641
- eciesService,
1642
- roleService,
1643
- backupCodeService,
1644
- idGenerator,
1645
- idToString,
1646
- );
1647
- }
1648
- }