@zintrust/core 0.1.0 → 0.1.2

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 (518) hide show
  1. package/README.md +214 -0
  2. package/bin/zintrust.d.ts.map +1 -1
  3. package/bin/zintrust.js +18 -1
  4. package/package.json +4 -34
  5. package/public/index.html +535 -0
  6. package/src/boot/Application.d.ts.map +1 -1
  7. package/src/boot/Application.js +46 -3
  8. package/src/boot/Server.d.ts.map +1 -1
  9. package/src/boot/Server.js +3 -4
  10. package/src/boot/bootstrap.js +77 -6
  11. package/src/builder/BundleOptimizer.d.ts.map +1 -1
  12. package/src/builder/BundleOptimizer.js +25 -29
  13. package/src/cache/Cache.d.ts.map +1 -1
  14. package/src/cache/Cache.js +4 -2
  15. package/src/cache/drivers/KVDriver.d.ts.map +1 -1
  16. package/src/cache/drivers/KVDriver.js +8 -7
  17. package/src/cache/drivers/MemoryDriver.d.ts.map +1 -1
  18. package/src/cache/drivers/MemoryDriver.js +5 -0
  19. package/src/cache/drivers/RedisDriver.js +1 -1
  20. package/src/cli/BaseCommand.d.ts +2 -2
  21. package/src/cli/BaseCommand.d.ts.map +1 -1
  22. package/src/cli/BaseCommand.js +2 -1
  23. package/src/cli/CLI.d.ts.map +1 -1
  24. package/src/cli/CLI.js +22 -18
  25. package/src/cli/ErrorHandler.d.ts.map +1 -1
  26. package/src/cli/ErrorHandler.js +2 -4
  27. package/src/cli/commands/AddCommand.d.ts +81 -0
  28. package/src/cli/commands/AddCommand.d.ts.map +1 -1
  29. package/src/cli/commands/AddCommand.js +24 -5
  30. package/src/cli/commands/ConfigCommand.d.ts.map +1 -1
  31. package/src/cli/commands/ConfigCommand.js +59 -25
  32. package/src/cli/commands/D1MigrateCommand.d.ts +4 -0
  33. package/src/cli/commands/D1MigrateCommand.d.ts.map +1 -1
  34. package/src/cli/commands/D1MigrateCommand.js +6 -4
  35. package/src/cli/commands/FixCommand.d.ts.map +1 -1
  36. package/src/cli/commands/FixCommand.js +3 -15
  37. package/src/cli/commands/LogsCleanupCommand.d.ts +6 -0
  38. package/src/cli/commands/LogsCleanupCommand.d.ts.map +1 -0
  39. package/src/cli/commands/LogsCleanupCommand.js +20 -0
  40. package/src/cli/commands/LogsCommand.d.ts.map +1 -1
  41. package/src/cli/commands/LogsCommand.js +4 -6
  42. package/src/cli/commands/MakeMailTemplateCommand.d.ts +10 -0
  43. package/src/cli/commands/MakeMailTemplateCommand.d.ts.map +1 -0
  44. package/src/cli/commands/MakeMailTemplateCommand.js +74 -0
  45. package/src/cli/commands/MakeNotificationTemplateCommand.d.ts +10 -0
  46. package/src/cli/commands/MakeNotificationTemplateCommand.d.ts.map +1 -0
  47. package/src/cli/commands/MakeNotificationTemplateCommand.js +113 -0
  48. package/src/cli/commands/MigrateCommand.d.ts.map +1 -1
  49. package/src/cli/commands/MigrateCommand.js +3 -3
  50. package/src/cli/commands/NewCommand.d.ts +4 -0
  51. package/src/cli/commands/NewCommand.d.ts.map +1 -1
  52. package/src/cli/commands/NewCommand.js +34 -19
  53. package/src/cli/commands/PluginCommand.d.ts.map +1 -1
  54. package/src/cli/commands/PluginCommand.js +8 -4
  55. package/src/cli/commands/PrepareCommand.d.ts.map +1 -1
  56. package/src/cli/commands/PrepareCommand.js +1 -1
  57. package/src/cli/commands/QACommand.d.ts.map +1 -1
  58. package/src/cli/commands/QACommand.js +16 -26
  59. package/src/cli/commands/SecretsCommand.d.ts +16 -0
  60. package/src/cli/commands/SecretsCommand.d.ts.map +1 -0
  61. package/src/cli/commands/SecretsCommand.js +91 -0
  62. package/src/cli/commands/StartCommand.d.ts.map +1 -1
  63. package/src/cli/commands/StartCommand.js +2 -2
  64. package/src/cli/commands/TemplatesCommand.d.ts +3 -0
  65. package/src/cli/commands/TemplatesCommand.d.ts.map +1 -0
  66. package/src/cli/commands/TemplatesCommand.js +65 -0
  67. package/src/cli/commands/index.d.ts +5 -0
  68. package/src/cli/commands/index.d.ts.map +1 -1
  69. package/src/cli/commands/index.js +5 -0
  70. package/src/cli/config/ConfigManager.js +1 -1
  71. package/src/cli/index.d.ts +2 -1
  72. package/src/cli/index.d.ts.map +1 -1
  73. package/src/cli/index.js +2 -1
  74. package/src/cli/scaffolding/ControllerGenerator.d.ts.map +1 -1
  75. package/src/cli/scaffolding/ControllerGenerator.js +11 -10
  76. package/src/cli/scaffolding/FeatureScaffolder.js +4 -4
  77. package/src/cli/scaffolding/FileGenerator.js +1 -1
  78. package/src/cli/scaffolding/MigrationGenerator.d.ts.map +1 -1
  79. package/src/cli/scaffolding/MigrationGenerator.js +10 -9
  80. package/src/cli/scaffolding/ModelGenerator.d.ts.map +1 -1
  81. package/src/cli/scaffolding/ModelGenerator.js +11 -10
  82. package/src/cli/scaffolding/ProjectScaffolder.d.ts.map +1 -1
  83. package/src/cli/scaffolding/ProjectScaffolder.js +61 -11
  84. package/src/cli/scaffolding/ResponseFactoryGenerator.d.ts.map +1 -1
  85. package/src/cli/scaffolding/ResponseFactoryGenerator.js +2 -1
  86. package/src/cli/scaffolding/RouteGenerator.d.ts.map +1 -1
  87. package/src/cli/scaffolding/RouteGenerator.js +15 -14
  88. package/src/cli/scaffolding/SeederGenerator.js +1 -1
  89. package/src/cli/scaffolding/ServiceIntegrationTestGenerator.d.ts.map +1 -1
  90. package/src/cli/scaffolding/ServiceIntegrationTestGenerator.js +7 -6
  91. package/src/cli/scaffolding/ServiceRequestFactoryGenerator.d.ts +1 -1
  92. package/src/cli/scaffolding/ServiceRequestFactoryGenerator.d.ts.map +1 -1
  93. package/src/cli/scaffolding/ServiceRequestFactoryGenerator.js +2 -2
  94. package/src/cli/scaffolding/ServiceScaffolder.d.ts.map +1 -1
  95. package/src/cli/scaffolding/ServiceScaffolder.js +13 -12
  96. package/src/cli/scaffolding/TemplateEngine.d.ts +10 -3
  97. package/src/cli/scaffolding/TemplateEngine.d.ts.map +1 -1
  98. package/src/cli/scaffolding/TemplateEngine.js +15 -285
  99. package/src/cli/scaffolding/TemplateGenerator.d.ts +40 -0
  100. package/src/cli/scaffolding/TemplateGenerator.d.ts.map +1 -0
  101. package/src/cli/scaffolding/TemplateGenerator.js +172 -0
  102. package/src/cli/scaffolding/index.d.ts +1 -0
  103. package/src/cli/scaffolding/index.d.ts.map +1 -1
  104. package/src/cli/scaffolding/index.js +1 -0
  105. package/src/cli/utils/spawn.js +1 -1
  106. package/src/common/AwsSigV4.d.ts +41 -0
  107. package/src/common/AwsSigV4.d.ts.map +1 -0
  108. package/src/common/AwsSigV4.js +69 -0
  109. package/src/common/index.d.ts +39 -0
  110. package/src/common/index.d.ts.map +1 -1
  111. package/src/common/index.js +101 -8
  112. package/src/common/uuid.d.ts +3 -0
  113. package/src/common/uuid.d.ts.map +1 -0
  114. package/src/common/uuid.js +30 -0
  115. package/src/config/FileLogWriter.d.ts +22 -0
  116. package/src/config/FileLogWriter.d.ts.map +1 -0
  117. package/src/config/FileLogWriter.js +192 -0
  118. package/src/config/SecretsManager.d.ts.map +1 -1
  119. package/src/config/SecretsManager.js +26 -0
  120. package/src/config/StartupConfigValidator.d.ts +15 -0
  121. package/src/config/StartupConfigValidator.d.ts.map +1 -0
  122. package/src/config/StartupConfigValidator.js +86 -0
  123. package/src/config/app.d.ts +2 -1
  124. package/src/config/app.d.ts.map +1 -1
  125. package/src/config/app.js +65 -15
  126. package/src/config/broadcast.d.ts +47 -0
  127. package/src/config/broadcast.d.ts.map +1 -0
  128. package/src/config/broadcast.js +54 -0
  129. package/src/config/cache.d.ts +13 -17
  130. package/src/config/cache.d.ts.map +1 -1
  131. package/src/config/cache.js +9 -11
  132. package/src/config/cloudflare.d.ts +26 -0
  133. package/src/config/cloudflare.d.ts.map +1 -0
  134. package/src/config/cloudflare.js +38 -0
  135. package/src/config/env.d.ts +6 -0
  136. package/src/config/env.d.ts.map +1 -1
  137. package/src/config/env.js +6 -0
  138. package/src/config/index.d.ts +52 -28
  139. package/src/config/index.d.ts.map +1 -1
  140. package/src/config/index.js +3 -0
  141. package/src/config/logger.d.ts +2 -0
  142. package/src/config/logger.d.ts.map +1 -1
  143. package/src/config/logger.js +270 -11
  144. package/src/config/logging/HttpLogger.d.ts +23 -0
  145. package/src/config/logging/HttpLogger.d.ts.map +1 -0
  146. package/src/config/logging/HttpLogger.js +93 -0
  147. package/src/config/logging/KvLogger.d.ts +22 -0
  148. package/src/config/logging/KvLogger.d.ts.map +1 -0
  149. package/src/config/logging/KvLogger.js +143 -0
  150. package/src/config/logging/SlackLogger.d.ts +23 -0
  151. package/src/config/logging/SlackLogger.d.ts.map +1 -0
  152. package/src/config/logging/SlackLogger.js +119 -0
  153. package/src/config/mail.d.ts +81 -0
  154. package/src/config/mail.d.ts.map +1 -0
  155. package/src/config/mail.js +73 -0
  156. package/src/config/middleware.d.ts +8 -0
  157. package/src/config/middleware.d.ts.map +1 -0
  158. package/src/config/middleware.js +18 -0
  159. package/src/config/notification.d.ts +62 -0
  160. package/src/config/notification.d.ts.map +1 -0
  161. package/src/config/notification.js +43 -0
  162. package/src/config/security.d.ts.map +1 -1
  163. package/src/config/security.js +2 -2
  164. package/src/config/startup.d.ts +23 -0
  165. package/src/config/startup.d.ts.map +1 -0
  166. package/src/config/startup.js +15 -0
  167. package/src/config/storage.d.ts +21 -35
  168. package/src/config/storage.d.ts.map +1 -1
  169. package/src/config/storage.js +57 -37
  170. package/src/database/migrations/index.d.ts +1 -1
  171. package/src/database/migrations/index.d.ts.map +1 -1
  172. package/src/database/migrations/index.js +2 -1
  173. package/src/features/Queue.js +1 -25
  174. package/src/functions/lambda.d.ts.map +1 -1
  175. package/src/functions/lambda.js +6 -1
  176. package/src/health/RuntimeHealthProbes.d.ts +13 -0
  177. package/src/health/RuntimeHealthProbes.d.ts.map +1 -0
  178. package/src/health/RuntimeHealthProbes.js +62 -0
  179. package/src/health/StartupHealthChecks.d.ts +26 -0
  180. package/src/health/StartupHealthChecks.d.ts.map +1 -0
  181. package/src/health/StartupHealthChecks.js +124 -0
  182. package/src/http/ErrorResponse.d.ts +28 -0
  183. package/src/http/ErrorResponse.d.ts.map +1 -0
  184. package/src/http/ErrorResponse.js +42 -0
  185. package/src/http/Kernel.d.ts +5 -0
  186. package/src/http/Kernel.d.ts.map +1 -1
  187. package/src/http/Kernel.js +96 -30
  188. package/src/http/Request.d.ts +1 -1
  189. package/src/http/Request.d.ts.map +1 -1
  190. package/src/http/RequestContext.d.ts +20 -0
  191. package/src/http/RequestContext.d.ts.map +1 -0
  192. package/src/http/RequestContext.js +77 -0
  193. package/src/index.d.ts +9 -1
  194. package/src/index.d.ts.map +1 -1
  195. package/src/index.js +8 -2
  196. package/src/microservices/MicroserviceBootstrap.d.ts.map +1 -1
  197. package/src/microservices/MicroserviceBootstrap.js +6 -5
  198. package/src/microservices/MicroserviceManager.d.ts.map +1 -1
  199. package/src/microservices/MicroserviceManager.js +7 -5
  200. package/src/microservices/PostgresAdapter.d.ts.map +1 -1
  201. package/src/microservices/PostgresAdapter.js +7 -4
  202. package/src/microservices/ServiceBundler.d.ts.map +1 -1
  203. package/src/microservices/ServiceBundler.js +3 -1
  204. package/src/microservices/ServiceHealthMonitor.d.ts.map +1 -1
  205. package/src/microservices/ServiceHealthMonitor.js +7 -3
  206. package/src/middleware/CsrfMiddleware.d.ts.map +1 -1
  207. package/src/middleware/CsrfMiddleware.js +2 -19
  208. package/src/middleware/ErrorHandlerMiddleware.d.ts +6 -0
  209. package/src/middleware/ErrorHandlerMiddleware.d.ts.map +1 -0
  210. package/src/middleware/ErrorHandlerMiddleware.js +33 -0
  211. package/src/middleware/LoggingMiddleware.d.ts +9 -0
  212. package/src/middleware/LoggingMiddleware.d.ts.map +1 -0
  213. package/src/middleware/LoggingMiddleware.js +36 -0
  214. package/src/middleware/index.d.ts +2 -0
  215. package/src/middleware/index.d.ts.map +1 -1
  216. package/src/middleware/index.js +2 -0
  217. package/src/node-singletons/async_hooks.d.ts +9 -0
  218. package/src/node-singletons/async_hooks.d.ts.map +1 -0
  219. package/src/node-singletons/async_hooks.js +8 -0
  220. package/src/node-singletons/fs.d.ts +2 -2
  221. package/src/node-singletons/fs.d.ts.map +1 -1
  222. package/src/node-singletons/fs.js +2 -2
  223. package/src/node-singletons/http.d.ts +1 -1
  224. package/src/node-singletons/http.d.ts.map +1 -1
  225. package/src/node-singletons/http.js +1 -1
  226. package/src/node-singletons/index.d.ts +4 -0
  227. package/src/node-singletons/index.d.ts.map +1 -1
  228. package/src/node-singletons/index.js +4 -0
  229. package/src/node-singletons/net.d.ts +9 -0
  230. package/src/node-singletons/net.d.ts.map +1 -0
  231. package/src/node-singletons/net.js +8 -0
  232. package/src/node-singletons/os.d.ts +3 -3
  233. package/src/node-singletons/os.d.ts.map +1 -1
  234. package/src/node-singletons/os.js +3 -4
  235. package/src/node-singletons/path.d.ts +3 -1
  236. package/src/node-singletons/path.d.ts.map +1 -1
  237. package/src/node-singletons/path.js +3 -1
  238. package/src/node-singletons/perf-hooks.d.ts +3 -1
  239. package/src/node-singletons/perf-hooks.d.ts.map +1 -1
  240. package/src/node-singletons/perf-hooks.js +3 -1
  241. package/src/node-singletons/process.d.ts +23 -0
  242. package/src/node-singletons/process.d.ts.map +1 -0
  243. package/src/node-singletons/process.js +8 -0
  244. package/src/node-singletons/readline.d.ts +3 -3
  245. package/src/node-singletons/readline.d.ts.map +1 -1
  246. package/src/node-singletons/readline.js +3 -4
  247. package/src/node-singletons/tls.d.ts +9 -0
  248. package/src/node-singletons/tls.d.ts.map +1 -0
  249. package/src/node-singletons/tls.js +8 -0
  250. package/src/node-singletons/url.d.ts +3 -1
  251. package/src/node-singletons/url.d.ts.map +1 -1
  252. package/src/node-singletons/url.js +3 -1
  253. package/src/orm/ConnectionManager.d.ts +6 -1
  254. package/src/orm/ConnectionManager.d.ts.map +1 -1
  255. package/src/orm/ConnectionManager.js +14 -0
  256. package/src/orm/DatabaseAdapter.d.ts +6 -0
  257. package/src/orm/DatabaseAdapter.d.ts.map +1 -1
  258. package/src/orm/QueryBuilder.d.ts +8 -1
  259. package/src/orm/QueryBuilder.d.ts.map +1 -1
  260. package/src/orm/QueryBuilder.js +188 -28
  261. package/src/orm/adapters/D1Adapter.d.ts.map +1 -1
  262. package/src/orm/adapters/D1Adapter.js +18 -12
  263. package/src/orm/adapters/MySQLAdapter.d.ts.map +1 -1
  264. package/src/orm/adapters/MySQLAdapter.js +4 -0
  265. package/src/orm/adapters/PostgreSQLAdapter.d.ts.map +1 -1
  266. package/src/orm/adapters/PostgreSQLAdapter.js +4 -0
  267. package/src/orm/adapters/SQLServerAdapter.d.ts.map +1 -1
  268. package/src/orm/adapters/SQLServerAdapter.js +4 -0
  269. package/src/orm/adapters/SQLiteAdapter.d.ts.map +1 -1
  270. package/src/orm/adapters/SQLiteAdapter.js +4 -0
  271. package/src/performance/Benchmark.d.ts.map +1 -1
  272. package/src/performance/Benchmark.js +3 -0
  273. package/src/performance/CodeGenerationBenchmark.js +3 -3
  274. package/src/performance/Optimizer.d.ts +1 -1
  275. package/src/performance/Optimizer.d.ts.map +1 -1
  276. package/src/performance/Optimizer.js +157 -80
  277. package/src/performance/establish-baseline.js +3 -3
  278. package/src/runtime/PluginManager.d.ts +3 -1
  279. package/src/runtime/PluginManager.d.ts.map +1 -1
  280. package/src/runtime/PluginManager.js +124 -28
  281. package/src/runtime/RuntimeDetector.d.ts.map +1 -1
  282. package/src/runtime/RuntimeDetector.js +47 -5
  283. package/src/runtime/adapters/CloudflareAdapter.js +2 -2
  284. package/src/runtime/adapters/DenoAdapter.js +9 -7
  285. package/src/runtime/adapters/FargateAdapter.d.ts.map +1 -1
  286. package/src/runtime/adapters/FargateAdapter.js +4 -3
  287. package/src/runtime/adapters/LambdaAdapter.d.ts.map +1 -1
  288. package/src/runtime/adapters/LambdaAdapter.js +4 -2
  289. package/src/runtime/adapters/NodeServerAdapter.d.ts.map +1 -1
  290. package/src/runtime/adapters/NodeServerAdapter.js +7 -6
  291. package/src/scheduler/ScheduleRunner.d.ts +18 -0
  292. package/src/scheduler/ScheduleRunner.d.ts.map +1 -0
  293. package/src/scheduler/ScheduleRunner.js +155 -0
  294. package/src/scheduler/index.d.ts +3 -0
  295. package/src/scheduler/index.d.ts.map +1 -0
  296. package/src/scheduler/index.js +1 -0
  297. package/src/scheduler/types.d.ts +16 -0
  298. package/src/scheduler/types.d.ts.map +1 -0
  299. package/src/scheduler/types.js +4 -0
  300. package/src/schedules/index.d.ts +2 -0
  301. package/src/schedules/index.d.ts.map +1 -0
  302. package/src/schedules/index.js +1 -0
  303. package/src/schedules/log-cleanup.d.ts +4 -0
  304. package/src/schedules/log-cleanup.d.ts.map +1 -0
  305. package/src/schedules/log-cleanup.js +18 -0
  306. package/src/scripts/GenerateEnvArtifacts.d.ts +13 -0
  307. package/src/scripts/GenerateEnvArtifacts.d.ts.map +1 -0
  308. package/src/scripts/GenerateEnvArtifacts.js +171 -0
  309. package/src/scripts/TemplateSync.js +109 -70
  310. package/src/security/CsrfTokenManager.js +1 -1
  311. package/src/security/Encryptor.js +1 -1
  312. package/src/security/Hash.d.ts +14 -0
  313. package/src/security/Hash.d.ts.map +1 -0
  314. package/src/security/Hash.js +81 -0
  315. package/src/security/StartupSecretValidation.d.ts +20 -0
  316. package/src/security/StartupSecretValidation.d.ts.map +1 -0
  317. package/src/security/StartupSecretValidation.js +61 -0
  318. package/src/security/UrlValidator.d.ts +0 -1
  319. package/src/security/UrlValidator.d.ts.map +1 -1
  320. package/src/security/UrlValidator.js +1 -2
  321. package/src/security/Xss.d.ts +14 -0
  322. package/src/security/Xss.d.ts.map +1 -0
  323. package/src/security/Xss.js +57 -0
  324. package/src/security/XssProtection.d.ts.map +1 -1
  325. package/src/security/XssProtection.js +150 -16
  326. package/src/templates/adapters/MySQLAdapter.ts.tpl +5 -0
  327. package/src/templates/adapters/PostgreSQLAdapter.ts.tpl +5 -0
  328. package/src/templates/adapters/SQLServerAdapter.ts.tpl +5 -0
  329. package/src/templates/adapters/SQLiteAdapter.ts.tpl +5 -0
  330. package/src/templates/features/Queue.ts.tpl +1 -29
  331. package/src/templates/project/basic/.env.example.tpl +48 -0
  332. package/src/templates/project/basic/.env.tpl +89 -94
  333. package/src/templates/project/basic/app/Toolkit/Broadcast/sendBroadcast.ts.tpl +7 -0
  334. package/src/templates/project/basic/app/Toolkit/Mail/sendWelcomeEmail.ts.tpl +30 -0
  335. package/src/templates/project/basic/app/Toolkit/Notification/sendSlackNotification.ts.tpl +10 -0
  336. package/src/templates/project/basic/app/Toolkit/Notification/sendSms.ts.tpl +13 -0
  337. package/src/templates/project/basic/config/FileLogWriter.ts.tpl +240 -0
  338. package/src/templates/project/basic/config/SecretsManager.ts.tpl +32 -1
  339. package/src/templates/project/basic/config/StartupConfigValidator.ts.tpl +151 -0
  340. package/src/templates/project/basic/config/app.ts.tpl +84 -15
  341. package/src/templates/project/basic/config/broadcast.ts.tpl +97 -0
  342. package/src/templates/project/basic/config/cache.ts.tpl +19 -23
  343. package/src/templates/project/basic/config/cloudflare.ts.tpl +57 -0
  344. package/src/templates/project/basic/config/env.ts.tpl +7 -1
  345. package/src/templates/project/basic/config/index.ts.tpl +3 -0
  346. package/src/templates/project/basic/config/logger.ts.tpl +301 -11
  347. package/src/templates/project/basic/config/logging/HttpLogger.ts.tpl +121 -0
  348. package/src/templates/project/basic/config/logging/KvLogger.ts.tpl +181 -0
  349. package/src/templates/project/basic/config/logging/SlackLogger.ts.tpl +156 -0
  350. package/src/templates/project/basic/config/mail.ts.tpl +141 -0
  351. package/src/templates/project/basic/config/middleware.ts.tpl +27 -0
  352. package/src/templates/project/basic/config/notification.ts.tpl +86 -0
  353. package/src/templates/project/basic/config/security.ts.tpl +4 -5
  354. package/src/templates/project/basic/config/startup.ts.tpl +27 -0
  355. package/src/templates/project/basic/config/storage.ts.tpl +77 -42
  356. package/src/templates/project/basic/database/migrations/index.ts.tpl +1 -1
  357. package/src/templates/project/basic/package.json.tpl +1 -1
  358. package/src/templates/project/basic/routes/api.ts.tpl +9 -37
  359. package/src/templates/project/basic/routes/broadcast.ts.tpl +32 -0
  360. package/src/templates/project/basic/routes/health.ts.tpl +134 -0
  361. package/src/templates/project/basic/src/index.ts.tpl +38 -11
  362. package/src/templates/project/basic/template.json +3 -0
  363. package/src/toolkit/Secrets/EnvFile.d.ts +15 -0
  364. package/src/toolkit/Secrets/EnvFile.d.ts.map +1 -0
  365. package/src/toolkit/Secrets/EnvFile.js +63 -0
  366. package/src/toolkit/Secrets/Manifest.d.ts +24 -0
  367. package/src/toolkit/Secrets/Manifest.d.ts.map +1 -0
  368. package/src/toolkit/Secrets/Manifest.js +71 -0
  369. package/src/toolkit/Secrets/index.d.ts +42 -0
  370. package/src/toolkit/Secrets/index.d.ts.map +1 -0
  371. package/src/toolkit/Secrets/index.js +119 -0
  372. package/src/toolkit/Secrets/providers/AwsSecretsManager.d.ts +14 -0
  373. package/src/toolkit/Secrets/providers/AwsSecretsManager.d.ts.map +1 -0
  374. package/src/toolkit/Secrets/providers/AwsSecretsManager.js +131 -0
  375. package/src/toolkit/Secrets/providers/CloudflareKv.d.ts +9 -0
  376. package/src/toolkit/Secrets/providers/CloudflareKv.d.ts.map +1 -0
  377. package/src/toolkit/Secrets/providers/CloudflareKv.js +73 -0
  378. package/src/tools/broadcast/Broadcast.d.ts +7 -0
  379. package/src/tools/broadcast/Broadcast.d.ts.map +1 -0
  380. package/src/tools/broadcast/Broadcast.js +37 -0
  381. package/src/tools/broadcast/drivers/BaseDriver.d.ts +5 -0
  382. package/src/tools/broadcast/drivers/BaseDriver.d.ts.map +1 -0
  383. package/src/tools/broadcast/drivers/BaseDriver.js +8 -0
  384. package/src/tools/broadcast/drivers/InMemory.d.ts +18 -0
  385. package/src/tools/broadcast/drivers/InMemory.d.ts.map +1 -0
  386. package/src/tools/broadcast/drivers/InMemory.js +16 -0
  387. package/src/tools/broadcast/drivers/Pusher.d.ts +8 -0
  388. package/src/tools/broadcast/drivers/Pusher.d.ts.map +1 -0
  389. package/src/tools/broadcast/drivers/Pusher.js +75 -0
  390. package/src/tools/broadcast/drivers/Redis.d.ts +19 -0
  391. package/src/tools/broadcast/drivers/Redis.d.ts.map +1 -0
  392. package/src/tools/broadcast/drivers/Redis.js +73 -0
  393. package/src/tools/broadcast/drivers/RedisHttps.d.ts +14 -0
  394. package/src/tools/broadcast/drivers/RedisHttps.d.ts.map +1 -0
  395. package/src/tools/broadcast/drivers/RedisHttps.js +50 -0
  396. package/src/tools/broadcast/index.d.ts +7 -0
  397. package/src/tools/broadcast/index.d.ts.map +1 -0
  398. package/src/tools/broadcast/index.js +6 -0
  399. package/src/tools/http/Http.d.ts +51 -0
  400. package/src/tools/http/Http.d.ts.map +1 -0
  401. package/src/tools/http/Http.js +171 -0
  402. package/src/tools/http/HttpResponse.d.ts +32 -0
  403. package/src/tools/http/HttpResponse.d.ts.map +1 -0
  404. package/src/tools/http/HttpResponse.js +80 -0
  405. package/src/tools/http/index.d.ts +15 -0
  406. package/src/tools/http/index.d.ts.map +1 -0
  407. package/src/tools/http/index.js +9 -0
  408. package/src/tools/mail/Mail.d.ts +22 -0
  409. package/src/tools/mail/Mail.d.ts.map +1 -0
  410. package/src/tools/mail/Mail.js +105 -0
  411. package/src/tools/mail/attachments.d.ts +23 -0
  412. package/src/tools/mail/attachments.d.ts.map +1 -0
  413. package/src/tools/mail/attachments.js +26 -0
  414. package/src/tools/mail/drivers/BaseDriver.d.ts +5 -0
  415. package/src/tools/mail/drivers/BaseDriver.d.ts.map +1 -0
  416. package/src/tools/mail/drivers/BaseDriver.js +8 -0
  417. package/src/tools/mail/drivers/Mailgun.d.ts +31 -0
  418. package/src/tools/mail/drivers/Mailgun.d.ts.map +1 -0
  419. package/src/tools/mail/drivers/Mailgun.js +81 -0
  420. package/src/tools/mail/drivers/SendGrid.d.ts +29 -0
  421. package/src/tools/mail/drivers/SendGrid.d.ts.map +1 -0
  422. package/src/tools/mail/drivers/SendGrid.js +57 -0
  423. package/src/tools/mail/drivers/Ses.d.ts +24 -0
  424. package/src/tools/mail/drivers/Ses.d.ts.map +1 -0
  425. package/src/tools/mail/drivers/Ses.js +116 -0
  426. package/src/tools/mail/drivers/Smtp.d.ts +38 -0
  427. package/src/tools/mail/drivers/Smtp.d.ts.map +1 -0
  428. package/src/tools/mail/drivers/Smtp.js +327 -0
  429. package/src/tools/mail/templates/index.d.ts +27 -0
  430. package/src/tools/mail/templates/index.d.ts.map +1 -0
  431. package/src/tools/mail/templates/index.js +35 -0
  432. package/src/tools/mail/templates/markdown/index.d.ts +17 -0
  433. package/src/tools/mail/templates/markdown/index.d.ts.map +1 -0
  434. package/src/tools/mail/templates/markdown/index.js +49 -0
  435. package/src/tools/mail/templates/markdown/registry.d.ts +15 -0
  436. package/src/tools/mail/templates/markdown/registry.d.ts.map +1 -0
  437. package/src/tools/mail/templates/markdown/registry.js +34 -0
  438. package/src/tools/mail/templates/markdown/validator.d.ts +16 -0
  439. package/src/tools/mail/templates/markdown/validator.d.ts.map +1 -0
  440. package/src/tools/mail/templates/markdown/validator.js +24 -0
  441. package/src/tools/mail/testing.d.ts +41 -0
  442. package/src/tools/mail/testing.d.ts.map +1 -0
  443. package/src/tools/mail/testing.js +34 -0
  444. package/src/tools/notification/Driver.d.ts +11 -0
  445. package/src/tools/notification/Driver.d.ts.map +1 -0
  446. package/src/tools/notification/Driver.js +1 -0
  447. package/src/tools/notification/Notification.d.ts +11 -0
  448. package/src/tools/notification/Notification.d.ts.map +1 -0
  449. package/src/tools/notification/Notification.js +11 -0
  450. package/src/tools/notification/Registry.d.ts +10 -0
  451. package/src/tools/notification/Registry.d.ts.map +1 -0
  452. package/src/tools/notification/Registry.js +22 -0
  453. package/src/tools/notification/Service.d.ts +6 -0
  454. package/src/tools/notification/Service.d.ts.map +1 -0
  455. package/src/tools/notification/Service.js +18 -0
  456. package/src/tools/notification/config.d.ts +5 -0
  457. package/src/tools/notification/config.d.ts.map +1 -0
  458. package/src/tools/notification/config.js +5 -0
  459. package/src/tools/notification/drivers/BaseDriver.d.ts +5 -0
  460. package/src/tools/notification/drivers/BaseDriver.d.ts.map +1 -0
  461. package/src/tools/notification/drivers/BaseDriver.js +8 -0
  462. package/src/tools/notification/drivers/Console.d.ts +7 -0
  463. package/src/tools/notification/drivers/Console.d.ts.map +1 -0
  464. package/src/tools/notification/drivers/Console.js +13 -0
  465. package/src/tools/notification/drivers/Slack.d.ts +16 -0
  466. package/src/tools/notification/drivers/Slack.d.ts.map +1 -0
  467. package/src/tools/notification/drivers/Slack.js +24 -0
  468. package/src/tools/notification/drivers/Termii.d.ts +10 -0
  469. package/src/tools/notification/drivers/Termii.d.ts.map +1 -0
  470. package/src/tools/notification/drivers/Termii.js +47 -0
  471. package/src/tools/notification/drivers/Twilio.d.ts +21 -0
  472. package/src/tools/notification/drivers/Twilio.d.ts.map +1 -0
  473. package/src/tools/notification/drivers/Twilio.js +48 -0
  474. package/src/tools/notification/templates/markdown/index.d.ts +15 -0
  475. package/src/tools/notification/templates/markdown/index.d.ts.map +1 -0
  476. package/src/tools/notification/templates/markdown/index.js +38 -0
  477. package/src/tools/notification/templates/markdown/registry.d.ts +15 -0
  478. package/src/tools/notification/templates/markdown/registry.d.ts.map +1 -0
  479. package/src/tools/notification/templates/markdown/registry.js +36 -0
  480. package/src/tools/notification/testing.d.ts +19 -0
  481. package/src/tools/notification/testing.d.ts.map +1 -0
  482. package/src/tools/notification/testing.js +35 -0
  483. package/src/tools/notification/testingHelpers.d.ts +12 -0
  484. package/src/tools/notification/testingHelpers.d.ts.map +1 -0
  485. package/src/tools/notification/testingHelpers.js +32 -0
  486. package/src/tools/queue/Queue.d.ts +23 -0
  487. package/src/tools/queue/Queue.d.ts.map +1 -0
  488. package/src/tools/queue/Queue.js +38 -0
  489. package/src/tools/queue/drivers/InMemory.d.ts +10 -0
  490. package/src/tools/queue/drivers/InMemory.d.ts.map +1 -0
  491. package/src/tools/queue/drivers/InMemory.js +55 -0
  492. package/src/tools/queue/drivers/Redis.d.ts +10 -0
  493. package/src/tools/queue/drivers/Redis.d.ts.map +1 -0
  494. package/src/tools/queue/drivers/Redis.js +91 -0
  495. package/src/tools/storage/drivers/Gcs.d.ts +20 -0
  496. package/src/tools/storage/drivers/Gcs.d.ts.map +1 -0
  497. package/src/tools/storage/drivers/Gcs.js +152 -0
  498. package/src/tools/storage/drivers/Local.d.ts +17 -0
  499. package/src/tools/storage/drivers/Local.d.ts.map +1 -0
  500. package/src/tools/storage/drivers/Local.js +63 -0
  501. package/src/tools/storage/drivers/R2.d.ts +20 -0
  502. package/src/tools/storage/drivers/R2.d.ts.map +1 -0
  503. package/src/tools/storage/drivers/R2.js +73 -0
  504. package/src/tools/storage/drivers/S3.d.ts +26 -0
  505. package/src/tools/storage/drivers/S3.d.ts.map +1 -0
  506. package/src/tools/storage/drivers/S3.js +258 -0
  507. package/src/tools/storage/index.d.ts +24 -0
  508. package/src/tools/storage/index.d.ts.map +1 -0
  509. package/src/tools/storage/index.js +112 -0
  510. package/src/tools/storage/testing.d.ts +23 -0
  511. package/src/tools/storage/testing.d.ts.map +1 -0
  512. package/src/tools/storage/testing.js +52 -0
  513. package/src/tools/templates/MarkdownRenderer.d.ts +14 -0
  514. package/src/tools/templates/MarkdownRenderer.d.ts.map +1 -0
  515. package/src/tools/templates/MarkdownRenderer.js +300 -0
  516. package/src/tools/templates/index.d.ts +5 -0
  517. package/src/tools/templates/index.d.ts.map +1 -0
  518. package/src/tools/templates/index.js +4 -0
@@ -4,9 +4,10 @@
4
4
  * Sealed namespace for immutability
5
5
  */
6
6
 
7
+ import { appConfig } from '@config/app';
7
8
  import { Env } from '@config/env';
8
9
  import { Logger } from '@config/logger';
9
- import { ErrorFactory } from '@zintrust/core';
10
+ import { ErrorFactory } from '@exceptions/ZintrustError';
10
11
 
11
12
  /**
12
13
  * Helper to warn about missing secrets
@@ -14,9 +15,7 @@ import { ErrorFactory } from '@zintrust/core';
14
15
  function warnMissingSecret(secretName: string): string {
15
16
  Logger.error(`❌ CRITICAL: ${secretName} environment variable is not set!`);
16
17
  Logger.error('⚠️ Application may not function correctly. Set this in production immediately.');
17
-
18
- const nodeEnv = Env.get('NODE_ENV', 'development');
19
- if (nodeEnv === 'production') {
18
+ if (appConfig.isProduction()) {
20
19
  throw ErrorFactory.createConfigError(`Missing required secret: ${secretName}`, { secretName });
21
20
  }
22
21
 
@@ -44,7 +43,7 @@ const securityConfigObj = {
44
43
  algorithm: Env.get('JWT_ALGORITHM', 'HS256') as 'HS256' | 'HS512' | 'RS256',
45
44
  expiresIn: Env.get('JWT_EXPIRES_IN', '1h'),
46
45
  refreshExpiresIn: Env.get('JWT_REFRESH_EXPIRES_IN', '7d'),
47
- issuer: Env.get('JWT_ISSUER', '@zintrust/core'),
46
+ issuer: Env.get('JWT_ISSUER', 'zintrust'),
48
47
  audience: Env.get('JWT_AUDIENCE', 'zintrust-api'),
49
48
  },
50
49
 
@@ -0,0 +1,27 @@
1
+ /**
2
+ * Startup Configuration
3
+ *
4
+ * Startup-only controls (evaluated during Application.boot()).
5
+ */
6
+
7
+ import { Env } from '@config/env';
8
+
9
+ export type StartupConfig = {
10
+ healthChecksEnabled: boolean;
11
+ validateSecrets: boolean;
12
+ checkDatabase: boolean;
13
+ checkCache: boolean;
14
+ timeoutMs: number;
15
+ continueOnFailure: boolean;
16
+ };
17
+
18
+ export const startupConfig = Object.freeze({
19
+ healthChecksEnabled: Env.getBool('STARTUP_HEALTH_CHECKS', true),
20
+ validateSecrets: Env.getBool('STARTUP_VALIDATE_SECRETS', true),
21
+ checkDatabase: Env.getBool('STARTUP_CHECK_DB', false),
22
+ checkCache: Env.getBool('STARTUP_CHECK_CACHE', false),
23
+ timeoutMs: Env.getInt('STARTUP_HEALTH_TIMEOUT_MS', 2500),
24
+ continueOnFailure: Env.getBool('STARTUP_CONTINUE_ON_FAILURE', false),
25
+ } satisfies StartupConfig);
26
+
27
+ export default startupConfig;
@@ -18,8 +18,8 @@ type LocalStorageDriverConfig = {
18
18
 
19
19
  type S3StorageDriverConfig = {
20
20
  driver: 's3';
21
- key: EnvGetValue;
22
- secret: EnvGetValue;
21
+ accessKeyId: EnvGetValue;
22
+ secretAccessKey: EnvGetValue;
23
23
  region: typeof Env.AWS_REGION;
24
24
  bucket: EnvGetValue;
25
25
  url: EnvGetValue;
@@ -27,6 +27,16 @@ type S3StorageDriverConfig = {
27
27
  usePathStyleUrl: EnvGetBoolValue;
28
28
  };
29
29
 
30
+ type R2StorageDriverConfig = {
31
+ driver: 'r2';
32
+ accessKeyId: EnvGetValue;
33
+ secretAccessKey: EnvGetValue;
34
+ region: EnvGetValue;
35
+ bucket: EnvGetValue;
36
+ endpoint: EnvGetValue;
37
+ url: EnvGetValue;
38
+ };
39
+
30
40
  type GcsStorageDriverConfig = {
31
41
  driver: 'gcs';
32
42
  projectId: EnvGetValue;
@@ -38,6 +48,7 @@ type GcsStorageDriverConfig = {
38
48
  type StorageDrivers = {
39
49
  local: LocalStorageDriverConfig;
40
50
  s3: S3StorageDriverConfig;
51
+ r2: R2StorageDriverConfig;
41
52
  gcs: GcsStorageDriverConfig;
42
53
  };
43
54
 
@@ -45,11 +56,14 @@ type StorageDriverName = keyof StorageDrivers;
45
56
  type StorageDriverConfig = StorageDrivers[StorageDriverName];
46
57
 
47
58
  type StorageConfigRuntime = {
48
- default: string;
49
- drivers: StorageDrivers;
59
+ readonly default: string;
60
+ readonly drivers: StorageDrivers;
50
61
  };
51
62
 
52
- const isStorageDriverName = (value: string, drivers: StorageDrivers): value is StorageDriverName => {
63
+ const isStorageDriverName = (
64
+ value: string,
65
+ drivers: StorageDrivers
66
+ ): value is StorageDriverName => {
53
67
  return value in drivers;
54
68
  };
55
69
 
@@ -63,39 +77,54 @@ const getStorageDriver = (config: StorageConfigRuntime): StorageDriverConfig =>
63
77
  return config.drivers.local;
64
78
  };
65
79
 
80
+ const getDrivers = (): StorageDrivers => ({
81
+ local: {
82
+ driver: 'local' as const,
83
+ root: Env.get('STORAGE_PATH', 'storage'),
84
+ url: Env.get('STORAGE_URL', '/storage'),
85
+ visibility: Env.get('STORAGE_VISIBILITY', 'private'),
86
+ },
87
+ s3: {
88
+ driver: 's3' as const,
89
+ accessKeyId: Env.get('AWS_ACCESS_KEY_ID', ''),
90
+ secretAccessKey: Env.get('AWS_SECRET_ACCESS_KEY', ''),
91
+ region: Env.AWS_REGION,
92
+ bucket: Env.get('AWS_S3_BUCKET', ''),
93
+ url: Env.get('AWS_S3_URL', ''),
94
+ endpoint: Env.get('AWS_S3_ENDPOINT', ''),
95
+ usePathStyleUrl: Env.getBool('AWS_S3_USE_PATH_STYLE_URL', false),
96
+ },
97
+ r2: {
98
+ driver: 'r2' as const,
99
+ accessKeyId: Env.get('R2_ACCESS_KEY_ID', ''),
100
+ secretAccessKey: Env.get('R2_SECRET_ACCESS_KEY', ''),
101
+ region: Env.get('R2_REGION', ''),
102
+ bucket: Env.get('R2_BUCKET', ''),
103
+ endpoint: Env.get('R2_ENDPOINT', ''),
104
+ url: Env.get('R2_URL', ''),
105
+ },
106
+ gcs: {
107
+ driver: 'gcs' as const,
108
+ projectId: Env.get('GCS_PROJECT_ID', ''),
109
+ keyFile: Env.get('GCS_KEY_FILE', ''),
110
+ bucket: Env.get('GCS_BUCKET', ''),
111
+ url: Env.get('GCS_URL', ''),
112
+ },
113
+ });
114
+
66
115
  const storageConfigObj = {
67
116
  /**
68
- * Default storage driver
117
+ * Default storage driver (dynamic; tests may mutate process.env)
69
118
  */
70
- default: Env.get('STORAGE_DRIVER', 'local'),
119
+ get default(): string {
120
+ return Env.get('STORAGE_DRIVER', 'local');
121
+ },
71
122
 
72
123
  /**
73
- * Storage drivers configuration
124
+ * Storage drivers configuration (dynamic; tests may mutate process.env)
74
125
  */
75
- drivers: {
76
- local: {
77
- driver: 'local' as const,
78
- root: Env.get('STORAGE_PATH', 'storage'),
79
- url: Env.get('STORAGE_URL', '/storage'),
80
- visibility: Env.get('STORAGE_VISIBILITY', 'private'),
81
- },
82
- s3: {
83
- driver: 's3' as const,
84
- key: Env.get('AWS_ACCESS_KEY_ID'),
85
- secret: Env.get('AWS_SECRET_ACCESS_KEY'),
86
- region: Env.AWS_REGION,
87
- bucket: Env.get('AWS_S3_BUCKET'),
88
- url: Env.get('AWS_S3_URL'),
89
- endpoint: Env.get('AWS_S3_ENDPOINT'),
90
- usePathStyleUrl: Env.getBool('AWS_S3_USE_PATH_STYLE_URL', false),
91
- },
92
- gcs: {
93
- driver: 'gcs' as const,
94
- projectId: Env.get('GCS_PROJECT_ID'),
95
- keyFile: Env.get('GCS_KEY_FILE'),
96
- bucket: Env.get('GCS_BUCKET'),
97
- url: Env.get('GCS_URL'),
98
- },
126
+ get drivers(): StorageDrivers {
127
+ return getDrivers();
99
128
  },
100
129
 
101
130
  /**
@@ -108,26 +137,32 @@ const storageConfigObj = {
108
137
  /**
109
138
  * Temporary file settings
110
139
  */
111
- temp: {
112
- path: Env.get('TEMP_PATH', 'storage/temp'),
113
- maxAge: Env.getInt('TEMP_FILE_MAX_AGE', 86400), // 24 hours
140
+ get temp(): { path: string; maxAge: number } {
141
+ return {
142
+ path: Env.get('TEMP_PATH', 'storage/temp'),
143
+ maxAge: Env.getInt('TEMP_FILE_MAX_AGE', 86400), // 24 hours
144
+ };
114
145
  },
115
146
 
116
147
  /**
117
148
  * Uploads settings
118
149
  */
119
- uploads: {
120
- maxSize: Env.get('MAX_UPLOAD_SIZE', '100mb'),
121
- allowedMimes: Env.get('ALLOWED_UPLOAD_MIMES', 'jpg,jpeg,png,pdf,doc,docx'),
122
- path: Env.get('UPLOADS_PATH', 'storage/uploads'),
150
+ get uploads(): { maxSize: string; allowedMimes: string; path: string } {
151
+ return {
152
+ maxSize: Env.get('MAX_UPLOAD_SIZE', '100mb'),
153
+ allowedMimes: Env.get('ALLOWED_UPLOAD_MIMES', 'jpg,jpeg,png,pdf,doc,docx'),
154
+ path: Env.get('UPLOADS_PATH', 'storage/uploads'),
155
+ };
123
156
  },
124
157
 
125
158
  /**
126
159
  * Backups settings
127
160
  */
128
- backups: {
129
- path: Env.get('BACKUPS_PATH', 'storage/backups'),
130
- driver: Env.get('BACKUP_DRIVER', 's3'),
161
+ get backups(): { path: string; driver: string } {
162
+ return {
163
+ path: Env.get('BACKUPS_PATH', 'storage/backups'),
164
+ driver: Env.get('BACKUP_DRIVER', 's3'),
165
+ };
131
166
  },
132
167
  };
133
168
 
@@ -1,2 +1,2 @@
1
1
  // Placeholder for migrations
2
- export {};
2
+ export const migrations = Object.freeze([] as const);
@@ -11,7 +11,7 @@
11
11
  "type-check": "tsc --noEmit"
12
12
  },
13
13
  "dependencies": {
14
- "@zintrust/core": "^0.1.0"
14
+ "@zintrust/core": "^0.1.1"
15
15
  },
16
16
  "devDependencies": {
17
17
  "tsx": "^4.21.0",
@@ -5,8 +5,9 @@
5
5
 
6
6
  import { UserController } from '@app/Controllers/UserController';
7
7
  import { Env } from '@config/env';
8
- import { Logger } from '@config/logger';
9
- import { useDatabase, type IRouter, Router } from '@zintrust/core';
8
+ import { registerBroadcastRoutes } from '@routes/broadcast';
9
+ import { registerHealthRoutes } from '@routes/health';
10
+ import { type IRouter, Router } from '@routing/Router';
10
11
 
11
12
  export function registerRoutes(router: IRouter): void {
12
13
  const userController = UserController.create();
@@ -19,6 +20,12 @@ export function registerRoutes(router: IRouter): void {
19
20
  * Register public routes
20
21
  */
21
22
  function registerPublicRoutes(router: IRouter): void {
23
+ registerRootRoute(router);
24
+ registerHealthRoutes(router);
25
+ registerBroadcastRoutes(router);
26
+ }
27
+
28
+ function registerRootRoute(router: IRouter): void {
22
29
  Router.get(router, '/', async (_req, res) => {
23
30
  res.json({
24
31
  framework: 'Zintrust Framework',
@@ -28,41 +35,6 @@ function registerPublicRoutes(router: IRouter): void {
28
35
  database: Env.DB_CONNECTION ?? 'sqlite',
29
36
  });
30
37
  });
31
-
32
- Router.get(router, '/health', async (_req, res) => {
33
- try {
34
- const db = useDatabase();
35
- await db.query('SELECT 1');
36
-
37
- const uptime =
38
- typeof process !== 'undefined' && typeof process.uptime === 'function'
39
- ? process.uptime()
40
- : 0;
41
-
42
- res.json({
43
- status: 'healthy',
44
- timestamp: new Date().toISOString(),
45
- uptime,
46
- database: 'connected',
47
- environment: Env.NODE_ENV ?? 'development',
48
- });
49
- } catch (error) {
50
- Logger.error('Health check failed:', error);
51
-
52
- const isProd =
53
- typeof process !== 'undefined' &&
54
- typeof process.env === 'object' &&
55
- process.env !== null &&
56
- process.env['NODE_ENV'] === 'production';
57
-
58
- res.setStatus(503).json({
59
- status: 'unhealthy',
60
- timestamp: new Date().toISOString(),
61
- database: 'disconnected',
62
- error: isProd ? 'Service unavailable' : (error as Error).message,
63
- });
64
- }
65
- });
66
38
  }
67
39
 
68
40
  /**
@@ -0,0 +1,32 @@
1
+ /**
2
+ * Broadcast Routes
3
+ *
4
+ * Runtime-only endpoints for broadcast.
5
+ * Provider setup and secret provisioning remain CLI-only.
6
+ */
7
+
8
+ import { type IRouter, Router } from '@routing/Router';
9
+
10
+ export function registerBroadcastRoutes(router: IRouter): void {
11
+ Router.get(router, '/broadcast/health', async (_req, res) => {
12
+ res.json({ ok: true });
13
+ });
14
+
15
+ Router.post(router, '/broadcast/send', async (req: { body?: unknown }, res) => {
16
+ const body = (req.body ?? {}) as Record<string, unknown>;
17
+ const channel = typeof body['channel'] === 'string' ? body['channel'] : '';
18
+ const event = typeof body['event'] === 'string' ? body['event'] : '';
19
+ const data = body['data'];
20
+
21
+ if (!channel || !event) {
22
+ res
23
+ .setStatus(400)
24
+ .json({ ok: false, error: 'Invalid payload: channel and event are required' });
25
+ return;
26
+ }
27
+
28
+ const { Broadcast } = await import('@broadcast/Broadcast');
29
+ const result = await Broadcast.send(channel, event, data);
30
+ res.json({ ok: true, result });
31
+ });
32
+ }
@@ -0,0 +1,134 @@
1
+ /**
2
+ * Health Routes
3
+ * Provides health, liveness, and readiness endpoints.
4
+ */
5
+
6
+ import { appConfig } from '@/config';
7
+ import { RuntimeHealthProbes } from '@/health/RuntimeHealthProbes';
8
+ import { Env } from '@config/env';
9
+ import { Logger } from '@config/logger';
10
+ import { useDatabase } from '@orm/Database';
11
+ import { QueryBuilder } from '@orm/QueryBuilder';
12
+ import { type IRouter, Router } from '@routing/Router';
13
+
14
+ export function registerHealthRoutes(router: IRouter): void {
15
+ registerHealthRoute(router);
16
+ registerHealthLiveRoute(router);
17
+ registerHealthReadyRoute(router);
18
+ }
19
+
20
+ function registerHealthRoute(router: IRouter): void {
21
+ Router.get(router, '/health', async (_req, res) => {
22
+ const environment = Env.NODE_ENV ?? 'development';
23
+
24
+ try {
25
+ const db = useDatabase();
26
+ await QueryBuilder.ping(db);
27
+
28
+ const uptime =
29
+ typeof process !== 'undefined' && typeof process.uptime === 'function'
30
+ ? process.uptime()
31
+ : 0;
32
+
33
+ res.json({
34
+ status: 'healthy',
35
+ timestamp: new Date().toISOString(),
36
+ uptime,
37
+ database: 'connected',
38
+ environment,
39
+ });
40
+ } catch (error) {
41
+ Logger.error('Health check failed:', error);
42
+
43
+ const isProd = environment === 'production' || environment === 'prod';
44
+
45
+ res.setStatus(503).json({
46
+ status: 'unhealthy',
47
+ timestamp: new Date().toISOString(),
48
+ database: 'disconnected',
49
+ error: isProd ? 'Service unavailable' : (error as Error).message,
50
+ });
51
+ }
52
+ });
53
+ }
54
+
55
+ function registerHealthLiveRoute(router: IRouter): void {
56
+ Router.get(router, '/health/live', async (_req, res) => {
57
+ const uptime =
58
+ typeof process !== 'undefined' && typeof process.uptime === 'function' ? process.uptime() : 0;
59
+
60
+ res.json({
61
+ status: 'alive',
62
+ timestamp: new Date().toISOString(),
63
+ uptime,
64
+ });
65
+ });
66
+ }
67
+
68
+ function registerHealthReadyRoute(router: IRouter): void {
69
+ Router.get(router, '/health/ready', async (_req, res) => {
70
+ const startTime = Date.now();
71
+ const environment = appConfig.environment;
72
+
73
+ let databaseResponseTime: number | null = null;
74
+ let cacheResponseTime: number | null = null;
75
+
76
+ try {
77
+ const db = useDatabase();
78
+ await QueryBuilder.ping(db);
79
+
80
+ databaseResponseTime = Date.now() - startTime;
81
+
82
+ // Only probe KV at runtime when explicitly configured.
83
+ cacheResponseTime = await RuntimeHealthProbes.pingKvCache(2000);
84
+
85
+ res.json({
86
+ status: 'ready',
87
+ timestamp: new Date().toISOString(),
88
+ environment,
89
+ dependencies: {
90
+ database: {
91
+ status: 'ready',
92
+ responseTime: databaseResponseTime,
93
+ },
94
+ ...(cacheResponseTime === null
95
+ ? {}
96
+ : {
97
+ cache: {
98
+ status: 'ready',
99
+ responseTime: cacheResponseTime,
100
+ },
101
+ }),
102
+ },
103
+ });
104
+ } catch (error) {
105
+ Logger.error('Readiness check failed:', error);
106
+
107
+ const isProd = environment === 'production';
108
+
109
+ const responseTime = Date.now() - startTime;
110
+
111
+ const dependencies: Record<string, unknown> = {
112
+ database: {
113
+ status: databaseResponseTime === null ? 'unavailable' : 'ready',
114
+ responseTime: databaseResponseTime ?? responseTime,
115
+ },
116
+ };
117
+
118
+ if (RuntimeHealthProbes.getCacheDriverName() === 'kv') {
119
+ dependencies['cache'] = {
120
+ status: 'unavailable',
121
+ responseTime: cacheResponseTime ?? responseTime,
122
+ };
123
+ }
124
+
125
+ res.setStatus(503).json({
126
+ status: 'not_ready',
127
+ timestamp: new Date().toISOString(),
128
+ environment,
129
+ dependencies,
130
+ error: isProd ? 'Service unavailable' : (error as Error).message,
131
+ });
132
+ }
133
+ });
134
+ }
@@ -28,22 +28,49 @@ async function start() {
28
28
  await server.listen();
29
29
 
30
30
  Logger.info(`Server running at http://${host}:${port}`);
31
+
32
+ const shutdown = async (signal: string): Promise<void> => {
33
+ Logger.info(`${signal} received, shutting down gracefully...`);
34
+
35
+ const timeoutMs = Env.getInt('SHUTDOWN_TIMEOUT', 10000);
36
+ const withTimeout = async <T>(promise: Promise<T>, ms: number): Promise<T> => {
37
+ if (ms <= 0) return promise;
38
+ return new Promise<T>((resolve, reject) => {
39
+ const timer = setTimeout(() => reject(new globalThis.Error('Shutdown timed out')), ms);
40
+ promise
41
+ .then((value) => {
42
+ clearTimeout(timer);
43
+ resolve(value);
44
+ })
45
+ .catch((err) => {
46
+ clearTimeout(timer);
47
+ reject(err);
48
+ });
49
+ });
50
+ };
51
+
52
+ try {
53
+ await withTimeout(
54
+ (async () => {
55
+ await server.close();
56
+ await app.shutdown();
57
+ })(),
58
+ timeoutMs
59
+ );
60
+ process.exit(0);
61
+ } catch (error) {
62
+ Logger.error('Graceful shutdown failed:', error);
63
+ process.exit(1);
64
+ }
65
+ };
66
+
67
+ process.on('SIGTERM', () => void shutdown('SIGTERM'));
68
+ process.on('SIGINT', () => void shutdown('SIGINT'));
31
69
  } catch (error) {
32
70
  Logger.error('Failed to start application:', error);
33
71
  process.exit(1);
34
72
  }
35
73
  }
36
74
 
37
- // Handle graceful shutdown
38
- process.on('SIGTERM', () => {
39
- Logger.info('SIGTERM received, shutting down gracefully...');
40
- process.exit(0);
41
- });
42
-
43
- process.on('SIGINT', () => {
44
- Logger.info('SIGINT received, shutting down gracefully...');
45
- process.exit(0);
46
- });
47
-
48
75
  // Run start
49
76
  await start();
@@ -8,6 +8,9 @@
8
8
  "config",
9
9
  "database/migrations",
10
10
  "database/seeders",
11
+ "logs",
12
+ "storage",
13
+ "tmp",
11
14
  "public",
12
15
  "routes",
13
16
  "src",
@@ -0,0 +1,15 @@
1
+ export type EnvFileWriteMode = 'overwrite';
2
+ export declare const EnvFile: Readonly<{
3
+ read(params: {
4
+ cwd: string;
5
+ path: string;
6
+ }): Promise<Record<string, string>>;
7
+ write(params: {
8
+ cwd: string;
9
+ path: string;
10
+ values: Record<string, string>;
11
+ mode: EnvFileWriteMode;
12
+ }): Promise<void>;
13
+ }>;
14
+ export default EnvFile;
15
+ //# sourceMappingURL=EnvFile.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EnvFile.d.ts","sourceRoot":"","sources":["../../../../src/toolkit/Secrets/EnvFile.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,gBAAgB,GAAG,WAAW,CAAC;AAmC3C,eAAO,MAAM,OAAO;iBACC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;kBAgB9D;QAClB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC/B,IAAI,EAAE,gBAAgB,CAAC;KACxB,GAAG,OAAO,CAAC,IAAI,CAAC;EAgBjB,CAAC;AAEH,eAAe,OAAO,CAAC"}
@@ -0,0 +1,63 @@
1
+ import { ErrorFactory } from '../../exceptions/ZintrustError';
2
+ import { fsPromises as fs } from '../../node-singletons/fs';
3
+ import * as path from '../../node-singletons/path';
4
+ const isValidKey = (key) => /^[A-Z0-9_]+$/.test(key);
5
+ const parseEnvLine = (line) => {
6
+ const trimmed = line.trim();
7
+ if (trimmed === '' || trimmed.startsWith('#'))
8
+ return null;
9
+ const eq = trimmed.indexOf('=');
10
+ if (eq <= 0)
11
+ return null;
12
+ const key = trimmed.slice(0, eq).trim();
13
+ const raw = trimmed.slice(eq + 1);
14
+ if (!isValidKey(key))
15
+ return null;
16
+ // Preserve value verbatim (except strip surrounding quotes if present)
17
+ let value = raw;
18
+ const v = raw.trim();
19
+ if ((v.startsWith('"') && v.endsWith('"')) || (v.startsWith("'") && v.endsWith("'"))) {
20
+ value = v.slice(1, -1);
21
+ }
22
+ return { key, value };
23
+ };
24
+ const serializeEnv = (values) => {
25
+ const keys = Object.keys(values).sort((a, b) => a.localeCompare(b));
26
+ const lines = keys.map((key) => {
27
+ const value = values[key] ?? '';
28
+ // Write as JSON string to safely quote newlines, #, etc.
29
+ return `${key}=${JSON.stringify(value)}`;
30
+ });
31
+ return `${lines.join('\n')}\n`;
32
+ };
33
+ export const EnvFile = Object.freeze({
34
+ async read(params) {
35
+ const filePath = path.resolve(params.cwd, params.path);
36
+ try {
37
+ const raw = await fs.readFile(filePath, 'utf-8');
38
+ const result = {};
39
+ for (const line of raw.split(/\r?\n/)) {
40
+ const parsed = parseEnvLine(line);
41
+ if (parsed)
42
+ result[parsed.key] = parsed.value;
43
+ }
44
+ return result;
45
+ }
46
+ catch {
47
+ return {};
48
+ }
49
+ },
50
+ async write(params) {
51
+ const filePath = path.resolve(params.cwd, params.path);
52
+ for (const key of Object.keys(params.values)) {
53
+ if (!isValidKey(key)) {
54
+ throw ErrorFactory.createCliError(`Invalid env key: ${key}`);
55
+ }
56
+ }
57
+ const content = serializeEnv(params.values);
58
+ // Ensure parent dir exists for cases like ./.zintrust/.env.pull
59
+ await fs.mkdir(path.dirname(filePath), { recursive: true });
60
+ await fs.writeFile(filePath, content, 'utf-8');
61
+ },
62
+ });
63
+ export default EnvFile;
@@ -0,0 +1,24 @@
1
+ export type SecretsProviderName = 'aws' | 'cloudflare';
2
+ export type ManifestKeySpec = {
3
+ aws?: {
4
+ secretId: string;
5
+ jsonKey?: string;
6
+ };
7
+ cloudflare?: {
8
+ key: string;
9
+ namespaceId?: string;
10
+ };
11
+ };
12
+ export type SecretsManifest = {
13
+ provider: SecretsProviderName;
14
+ keys: Record<string, ManifestKeySpec>;
15
+ };
16
+ export declare const Manifest: Readonly<{
17
+ load(params: {
18
+ cwd: string;
19
+ path: string;
20
+ provider: SecretsProviderName;
21
+ }): Promise<SecretsManifest>;
22
+ }>;
23
+ export default Manifest;
24
+ //# sourceMappingURL=Manifest.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Manifest.d.ts","sourceRoot":"","sources":["../../../../src/toolkit/Secrets/Manifest.ts"],"names":[],"mappings":"AAIA,MAAM,MAAM,mBAAmB,GAAG,KAAK,GAAG,YAAY,CAAC;AAEvD,MAAM,MAAM,eAAe,GAAG;IAC5B,GAAG,CAAC,EAAE;QACJ,QAAQ,EAAE,MAAM,CAAC;QACjB,OAAO,CAAC,EAAE,MAAM,CAAC;KAClB,CAAC;IACF,UAAU,CAAC,EAAE;QACX,GAAG,EAAE,MAAM,CAAC;QACZ,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;CACH,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,QAAQ,EAAE,mBAAmB,CAAC;IAC9B,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;CACvC,CAAC;AA+DF,eAAO,MAAM,QAAQ;iBACA;QACjB,GAAG,EAAE,MAAM,CAAC;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,QAAQ,EAAE,mBAAmB,CAAC;KAC/B,GAAG,OAAO,CAAC,eAAe,CAAC;EA4B5B,CAAC;AAEH,eAAe,QAAQ,CAAC"}