@zintrust/core 0.1.40 → 0.1.42

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 (590) hide show
  1. package/bin/zintrust-main.d.ts.map +1 -1
  2. package/bin/zintrust-main.js +22 -1
  3. package/package.json +24 -4
  4. package/public/error-pages/404.html +2 -2
  5. package/src/auth/Auth.js +1 -1
  6. package/src/boot/Application.d.ts +1 -16
  7. package/src/boot/Application.d.ts.map +1 -1
  8. package/src/boot/Application.js +2 -290
  9. package/src/boot/Server.d.ts +1 -1
  10. package/src/boot/Server.d.ts.map +1 -1
  11. package/src/boot/bootstrap.js +50 -16
  12. package/src/boot/registry/registerRoute.d.ts +6 -0
  13. package/src/boot/registry/registerRoute.d.ts.map +1 -0
  14. package/src/boot/registry/registerRoute.js +96 -0
  15. package/src/boot/registry/runtime.d.ts +15 -0
  16. package/src/boot/registry/runtime.d.ts.map +1 -0
  17. package/src/boot/registry/runtime.js +364 -0
  18. package/src/boot/registry/type.d.ts +25 -0
  19. package/src/boot/registry/type.d.ts.map +1 -0
  20. package/src/boot/registry/type.js +1 -0
  21. package/src/boot/registry/worker.d.ts +6 -0
  22. package/src/boot/registry/worker.d.ts.map +1 -0
  23. package/src/boot/registry/worker.js +35 -0
  24. package/src/cache/drivers/KVRemoteDriver.d.ts.map +1 -1
  25. package/src/cache/drivers/KVRemoteDriver.js +14 -1
  26. package/src/cli/CLI.d.ts.map +1 -1
  27. package/src/cli/CLI.js +94 -34
  28. package/src/cli/ErrorHandler.js +1 -1
  29. package/src/cli/commands/ConfigCommand.d.ts.map +1 -1
  30. package/src/cli/commands/ConfigCommand.js +3 -5
  31. package/src/cli/commands/ContainerProxiesCommand.d.ts +5 -0
  32. package/src/cli/commands/ContainerProxiesCommand.d.ts.map +1 -0
  33. package/src/cli/commands/ContainerProxiesCommand.js +77 -0
  34. package/src/cli/commands/ContainerWorkersCommand.d.ts +5 -0
  35. package/src/cli/commands/ContainerWorkersCommand.d.ts.map +1 -0
  36. package/src/cli/commands/ContainerWorkersCommand.js +57 -0
  37. package/src/cli/commands/D1LearnCommand.d.ts +9 -0
  38. package/src/cli/commands/D1LearnCommand.d.ts.map +1 -0
  39. package/src/cli/commands/D1LearnCommand.js +143 -0
  40. package/src/cli/commands/D1MigrateCommand.d.ts.map +1 -1
  41. package/src/cli/commands/D1MigrateCommand.js +55 -16
  42. package/src/cli/commands/DeployCommand.d.ts +16 -0
  43. package/src/cli/commands/DeployCommand.d.ts.map +1 -0
  44. package/src/cli/commands/DeployCommand.js +110 -0
  45. package/src/cli/commands/DeployContainerProxiesCommand.d.ts +5 -0
  46. package/src/cli/commands/DeployContainerProxiesCommand.d.ts.map +1 -0
  47. package/src/cli/commands/DeployContainerProxiesCommand.js +27 -0
  48. package/src/cli/commands/DeployContainerWorkersCommand.d.ts +5 -0
  49. package/src/cli/commands/DeployContainerWorkersCommand.d.ts.map +1 -0
  50. package/src/cli/commands/DeployContainerWorkersCommand.js +27 -0
  51. package/src/cli/commands/DockerComposeCommandUtils.d.ts +3 -0
  52. package/src/cli/commands/DockerComposeCommandUtils.d.ts.map +1 -0
  53. package/src/cli/commands/DockerComposeCommandUtils.js +34 -0
  54. package/src/cli/commands/DoctorArchitectureCommand.d.ts +5 -0
  55. package/src/cli/commands/DoctorArchitectureCommand.d.ts.map +1 -0
  56. package/src/cli/commands/DoctorArchitectureCommand.js +54 -0
  57. package/src/cli/commands/InitContainerCommand.d.ts +5 -0
  58. package/src/cli/commands/InitContainerCommand.d.ts.map +1 -0
  59. package/src/cli/commands/InitContainerCommand.js +231 -0
  60. package/src/cli/commands/InitEcosystemCommand.d.ts +6 -0
  61. package/src/cli/commands/InitEcosystemCommand.d.ts.map +1 -0
  62. package/src/cli/commands/InitEcosystemCommand.js +51 -0
  63. package/src/cli/commands/InitProducerCommand.d.ts +5 -0
  64. package/src/cli/commands/InitProducerCommand.d.ts.map +1 -0
  65. package/src/cli/commands/InitProducerCommand.js +47 -0
  66. package/src/cli/commands/InitProxyCommand.d.ts +5 -0
  67. package/src/cli/commands/InitProxyCommand.d.ts.map +1 -0
  68. package/src/cli/commands/InitProxyCommand.js +442 -0
  69. package/src/cli/commands/MigrateCommand.d.ts.map +1 -1
  70. package/src/cli/commands/MigrateCommand.js +78 -36
  71. package/src/cli/commands/MigrateWorkerCommand.d.ts.map +1 -1
  72. package/src/cli/commands/MigrateWorkerCommand.js +36 -2
  73. package/src/cli/commands/MongoDBProxyCommand.d.ts +5 -0
  74. package/src/cli/commands/MongoDBProxyCommand.d.ts.map +1 -0
  75. package/src/cli/commands/MongoDBProxyCommand.js +98 -0
  76. package/src/cli/commands/MySqlProxyCommand.d.ts +6 -0
  77. package/src/cli/commands/MySqlProxyCommand.d.ts.map +1 -0
  78. package/src/cli/commands/MySqlProxyCommand.js +32 -0
  79. package/src/cli/commands/PostgresProxyCommand.d.ts +6 -0
  80. package/src/cli/commands/PostgresProxyCommand.d.ts.map +1 -0
  81. package/src/cli/commands/PostgresProxyCommand.js +32 -0
  82. package/src/cli/commands/ProxyCommand.d.ts +12 -0
  83. package/src/cli/commands/ProxyCommand.d.ts.map +1 -0
  84. package/src/cli/commands/ProxyCommand.js +80 -0
  85. package/src/cli/commands/ProxyCommandUtils.d.ts +6 -0
  86. package/src/cli/commands/ProxyCommandUtils.d.ts.map +1 -0
  87. package/src/cli/commands/ProxyCommandUtils.js +38 -0
  88. package/src/cli/commands/PutCommand.d.ts +6 -0
  89. package/src/cli/commands/PutCommand.d.ts.map +1 -0
  90. package/src/cli/commands/PutCommand.js +173 -0
  91. package/src/cli/commands/QueueRecoveryCommand.d.ts +6 -0
  92. package/src/cli/commands/QueueRecoveryCommand.d.ts.map +1 -0
  93. package/src/cli/commands/QueueRecoveryCommand.js +612 -0
  94. package/src/cli/commands/RedisProxyCommand.d.ts +6 -0
  95. package/src/cli/commands/RedisProxyCommand.d.ts.map +1 -0
  96. package/src/cli/commands/RedisProxyCommand.js +53 -0
  97. package/src/cli/commands/ScheduleListCommand.d.ts +6 -0
  98. package/src/cli/commands/ScheduleListCommand.d.ts.map +1 -0
  99. package/src/cli/commands/ScheduleListCommand.js +62 -0
  100. package/src/cli/commands/ScheduleRunCommand.d.ts +6 -0
  101. package/src/cli/commands/ScheduleRunCommand.d.ts.map +1 -0
  102. package/src/cli/commands/ScheduleRunCommand.js +32 -0
  103. package/src/cli/commands/ScheduleStartCommand.d.ts +6 -0
  104. package/src/cli/commands/ScheduleStartCommand.d.ts.map +1 -0
  105. package/src/cli/commands/ScheduleStartCommand.js +40 -0
  106. package/src/cli/commands/SecretsCommand.d.ts.map +1 -1
  107. package/src/cli/commands/SecretsCommand.js +2 -2
  108. package/src/cli/commands/SmtpProxyCommand.d.ts +6 -0
  109. package/src/cli/commands/SmtpProxyCommand.d.ts.map +1 -0
  110. package/src/cli/commands/SmtpProxyCommand.js +56 -0
  111. package/src/cli/commands/SqlProxyCommandUtils.d.ts +46 -0
  112. package/src/cli/commands/SqlProxyCommandUtils.d.ts.map +1 -0
  113. package/src/cli/commands/SqlProxyCommandUtils.js +48 -0
  114. package/src/cli/commands/SqlServerProxyCommand.d.ts +5 -0
  115. package/src/cli/commands/SqlServerProxyCommand.d.ts.map +1 -0
  116. package/src/cli/commands/SqlServerProxyCommand.js +85 -0
  117. package/src/cli/commands/StartCommand.d.ts.map +1 -1
  118. package/src/cli/commands/StartCommand.js +132 -17
  119. package/src/cli/commands/WorkerCommands.d.ts +1 -0
  120. package/src/cli/commands/WorkerCommands.d.ts.map +1 -1
  121. package/src/cli/commands/WorkerCommands.js +140 -6
  122. package/src/cli/commands/index.d.ts +2 -0
  123. package/src/cli/commands/index.d.ts.map +1 -1
  124. package/src/cli/commands/index.js +2 -0
  125. package/src/cli/commands/runner/index.d.ts +2 -2
  126. package/src/cli/commands/runner/index.d.ts.map +1 -1
  127. package/src/cli/commands/runner/index.js +15 -4
  128. package/src/cli/commands/schedule/ScheduleCliSupport.d.ts +6 -0
  129. package/src/cli/commands/schedule/ScheduleCliSupport.d.ts.map +1 -0
  130. package/src/cli/commands/schedule/ScheduleCliSupport.js +55 -0
  131. package/src/cli/config/ConfigManager.d.ts.map +1 -1
  132. package/src/cli/config/ConfigManager.js +8 -1
  133. package/src/cli/d1/D1SqlMigrations.d.ts.map +1 -1
  134. package/src/cli/d1/D1SqlMigrations.js +14 -1
  135. package/src/cli/d1/WranglerConfig.d.ts.map +1 -1
  136. package/src/cli/d1/WranglerConfig.js +34 -2
  137. package/src/cli/index.d.ts +4 -0
  138. package/src/cli/index.d.ts.map +1 -1
  139. package/src/cli/index.js +4 -0
  140. package/src/cli/scaffolding/ProjectScaffolder.d.ts.map +1 -1
  141. package/src/cli/scaffolding/ProjectScaffolder.js +2 -0
  142. package/src/cli/scaffolding/ServiceScaffolder.d.ts.map +1 -1
  143. package/src/cli/scaffolding/ServiceScaffolder.js +1 -0
  144. package/src/cli/services/VersionChecker.d.ts.map +1 -1
  145. package/src/cli/services/VersionChecker.js +5 -1
  146. package/src/cli/utils/DatabaseCliUtils.d.ts.map +1 -1
  147. package/src/cli/utils/DatabaseCliUtils.js +6 -1
  148. package/src/cli/utils/EnvFileLoader.d.ts.map +1 -1
  149. package/src/cli/utils/EnvFileLoader.js +35 -15
  150. package/src/cli/workers/QueueWorkRunner.js +1 -1
  151. package/src/cli.d.ts +5 -0
  152. package/src/cli.d.ts.map +1 -0
  153. package/src/cli.js +4 -0
  154. package/src/collections/index.d.ts +2 -2
  155. package/src/collections/index.d.ts.map +1 -1
  156. package/src/collections/index.js +1 -1
  157. package/src/common/HealthRoutes.d.ts.map +1 -1
  158. package/src/common/HealthRoutes.js +50 -2
  159. package/src/common/RemoteSignedJson.d.ts +1 -0
  160. package/src/common/RemoteSignedJson.d.ts.map +1 -1
  161. package/src/common/RemoteSignedJson.js +81 -29
  162. package/src/common/index.d.ts +1 -0
  163. package/src/common/index.d.ts.map +1 -1
  164. package/src/common/index.js +12 -1
  165. package/src/common/utility.d.ts.map +1 -1
  166. package/src/common/utility.js +2 -6
  167. package/src/config/FileLogWriter.d.ts.map +1 -1
  168. package/src/config/FileLogWriter.js +21 -6
  169. package/src/config/app.d.ts +4 -0
  170. package/src/config/app.d.ts.map +1 -1
  171. package/src/config/app.js +4 -0
  172. package/src/config/cache.d.ts.map +1 -1
  173. package/src/config/cache.js +22 -2
  174. package/src/config/cloudflare.d.ts +5 -1
  175. package/src/config/cloudflare.d.ts.map +1 -1
  176. package/src/config/cloudflare.js +67 -8
  177. package/src/config/database.d.ts.map +1 -1
  178. package/src/config/database.js +48 -13
  179. package/src/config/env.d.ts +87 -2
  180. package/src/config/env.d.ts.map +1 -1
  181. package/src/config/env.js +158 -19
  182. package/src/config/index.d.ts +1 -0
  183. package/src/config/index.d.ts.map +1 -1
  184. package/src/config/mail.d.ts.map +1 -1
  185. package/src/config/mail.js +16 -10
  186. package/src/config/middleware.d.ts +5 -0
  187. package/src/config/middleware.d.ts.map +1 -1
  188. package/src/config/middleware.js +19 -1
  189. package/src/config/queue.d.ts.map +1 -1
  190. package/src/config/queue.js +70 -9
  191. package/src/config/redis.d.ts.map +1 -1
  192. package/src/config/redis.js +48 -13
  193. package/src/config/storage.d.ts.map +1 -1
  194. package/src/config/storage.js +1 -0
  195. package/src/config/type.d.ts +18 -0
  196. package/src/config/type.d.ts.map +1 -1
  197. package/src/config/workers.d.ts.map +1 -1
  198. package/src/config/workers.js +122 -16
  199. package/src/functions/cloudflare.d.ts.map +1 -1
  200. package/src/functions/cloudflare.js +55 -1
  201. package/src/health/StartupHealthChecks.js +1 -1
  202. package/src/helper/index.d.ts +225 -0
  203. package/src/helper/index.d.ts.map +1 -0
  204. package/src/helper/index.js +347 -0
  205. package/src/http/FileUpload.d.ts +3 -2
  206. package/src/http/FileUpload.d.ts.map +1 -1
  207. package/src/http/Kernel.d.ts.map +1 -1
  208. package/src/http/Kernel.js +2 -1
  209. package/src/http/error-pages/ErrorPageRenderer.d.ts +4 -0
  210. package/src/http/error-pages/ErrorPageRenderer.d.ts.map +1 -1
  211. package/src/http/error-pages/ErrorPageRenderer.js +141 -1
  212. package/src/http/middleware/BodyParsingMiddleware.d.ts.map +1 -1
  213. package/src/http/middleware/BodyParsingMiddleware.js +33 -6
  214. package/src/index.d.ts +26 -57
  215. package/src/index.d.ts.map +1 -1
  216. package/src/index.js +32 -18
  217. package/src/microservices/ServiceAuthMiddleware.d.ts.map +1 -1
  218. package/src/microservices/ServiceAuthMiddleware.js +12 -4
  219. package/src/middleware/CsrfMiddleware.d.ts.map +1 -1
  220. package/src/middleware/CsrfMiddleware.js +30 -16
  221. package/src/middleware/ErrorHandlerMiddleware.d.ts.map +1 -1
  222. package/src/middleware/ErrorHandlerMiddleware.js +2 -1
  223. package/src/migrations/MigrationDiscovery.d.ts.map +1 -1
  224. package/src/migrations/MigrationDiscovery.js +2 -1
  225. package/src/migrations/MigrationLoader.js +1 -1
  226. package/src/migrations/schema/SchemaCompiler.d.ts.map +1 -1
  227. package/src/migrations/schema/SchemaCompiler.js +6 -3
  228. package/src/node-singletons/crypto.d.ts +1 -1
  229. package/src/node-singletons/crypto.d.ts.map +1 -1
  230. package/src/node-singletons/crypto.js +1 -1
  231. package/src/node-singletons/fs.d.ts +1 -1
  232. package/src/node-singletons/fs.d.ts.map +1 -1
  233. package/src/node-singletons/path.d.ts +1 -1
  234. package/src/node-singletons/path.d.ts.map +1 -1
  235. package/src/node-singletons/path.js +1 -1
  236. package/src/node-singletons/stream.d.ts +11 -0
  237. package/src/node-singletons/stream.d.ts.map +1 -0
  238. package/src/node-singletons/stream.js +8 -0
  239. package/src/observability/OpenTelemetry.d.ts +7 -0
  240. package/src/observability/OpenTelemetry.d.ts.map +1 -1
  241. package/src/observability/OpenTelemetry.js +49 -2
  242. package/src/orm/Database.d.ts +4 -0
  243. package/src/orm/Database.d.ts.map +1 -1
  244. package/src/orm/Database.js +80 -9
  245. package/src/orm/DatabaseAdapter.d.ts +1 -0
  246. package/src/orm/DatabaseAdapter.d.ts.map +1 -1
  247. package/src/orm/DatabaseRuntimeRegistration.d.ts.map +1 -1
  248. package/src/orm/DatabaseRuntimeRegistration.js +2 -0
  249. package/src/orm/QueryBuilder.d.ts +1 -0
  250. package/src/orm/QueryBuilder.d.ts.map +1 -1
  251. package/src/orm/QueryBuilder.js +33 -3
  252. package/src/orm/SchemaCompiler.d.ts.map +1 -1
  253. package/src/orm/SchemaCompiler.js +6 -3
  254. package/src/orm/SchemaStatemenWriter.d.ts +15 -0
  255. package/src/orm/SchemaStatemenWriter.d.ts.map +1 -0
  256. package/src/orm/SchemaStatemenWriter.js +78 -0
  257. package/src/orm/adapters/D1Adapter.d.ts.map +1 -1
  258. package/src/orm/adapters/D1Adapter.js +52 -2
  259. package/src/orm/adapters/D1RemoteAdapter.d.ts.map +1 -1
  260. package/src/orm/adapters/D1RemoteAdapter.js +150 -89
  261. package/src/orm/adapters/MongoDBProxyAdapter.d.ts +3 -0
  262. package/src/orm/adapters/MongoDBProxyAdapter.d.ts.map +1 -0
  263. package/src/orm/adapters/MongoDBProxyAdapter.js +128 -0
  264. package/src/orm/adapters/MySQLProxyAdapter.d.ts +11 -0
  265. package/src/orm/adapters/MySQLProxyAdapter.d.ts.map +1 -0
  266. package/src/orm/adapters/MySQLProxyAdapter.js +162 -0
  267. package/src/orm/adapters/PostgreSQLProxyAdapter.d.ts +11 -0
  268. package/src/orm/adapters/PostgreSQLProxyAdapter.d.ts.map +1 -0
  269. package/src/orm/adapters/PostgreSQLProxyAdapter.js +163 -0
  270. package/src/orm/adapters/ProxyCache.d.ts +9 -0
  271. package/src/orm/adapters/ProxyCache.d.ts.map +1 -0
  272. package/src/orm/adapters/ProxyCache.js +24 -0
  273. package/src/orm/adapters/ProxySignedRequest.d.ts +11 -0
  274. package/src/orm/adapters/ProxySignedRequest.d.ts.map +1 -0
  275. package/src/orm/adapters/ProxySignedRequest.js +30 -0
  276. package/src/orm/adapters/ProxySigningPath.d.ts +3 -0
  277. package/src/orm/adapters/ProxySigningPath.d.ts.map +1 -0
  278. package/src/orm/adapters/ProxySigningPath.js +25 -0
  279. package/src/orm/adapters/SqlProxyAdapterUtils.d.ts +19 -0
  280. package/src/orm/adapters/SqlProxyAdapterUtils.d.ts.map +1 -0
  281. package/src/orm/adapters/SqlProxyAdapterUtils.js +36 -0
  282. package/src/orm/adapters/SqlProxyRegistryMode.d.ts +12 -0
  283. package/src/orm/adapters/SqlProxyRegistryMode.d.ts.map +1 -0
  284. package/src/orm/adapters/SqlProxyRegistryMode.js +24 -0
  285. package/src/orm/adapters/SqlServerProxyAdapter.d.ts +6 -0
  286. package/src/orm/adapters/SqlServerProxyAdapter.d.ts.map +1 -0
  287. package/src/orm/adapters/SqlServerProxyAdapter.js +154 -0
  288. package/src/orm/migrations/MigrationStore.js +1 -1
  289. package/src/performance/Optimizer.d.ts +1 -0
  290. package/src/performance/Optimizer.d.ts.map +1 -1
  291. package/src/performance/Optimizer.js +21 -8
  292. package/src/proxy/ErrorHandler.d.ts +11 -0
  293. package/src/proxy/ErrorHandler.d.ts.map +1 -0
  294. package/src/proxy/ErrorHandler.js +7 -0
  295. package/src/proxy/PoolManager.d.ts +8 -0
  296. package/src/proxy/PoolManager.d.ts.map +1 -0
  297. package/src/proxy/PoolManager.js +18 -0
  298. package/src/proxy/ProxyBackend.d.ts +18 -0
  299. package/src/proxy/ProxyBackend.d.ts.map +1 -0
  300. package/src/proxy/ProxyBackend.js +1 -0
  301. package/src/proxy/ProxyConfig.d.ts +12 -0
  302. package/src/proxy/ProxyConfig.d.ts.map +1 -0
  303. package/src/proxy/ProxyConfig.js +1 -0
  304. package/src/proxy/ProxyRegistry.d.ts +10 -0
  305. package/src/proxy/ProxyRegistry.d.ts.map +1 -0
  306. package/src/proxy/ProxyRegistry.js +11 -0
  307. package/src/proxy/ProxyRequestParsing.d.ts +9 -0
  308. package/src/proxy/ProxyRequestParsing.d.ts.map +1 -0
  309. package/src/proxy/ProxyRequestParsing.js +16 -0
  310. package/src/proxy/ProxyServer.d.ts +21 -0
  311. package/src/proxy/ProxyServer.d.ts.map +1 -0
  312. package/src/proxy/ProxyServer.js +84 -0
  313. package/src/proxy/ProxyServerUtils.d.ts +37 -0
  314. package/src/proxy/ProxyServerUtils.d.ts.map +1 -0
  315. package/src/proxy/ProxyServerUtils.js +42 -0
  316. package/src/proxy/ProxySigningConfigResolver.d.ts +22 -0
  317. package/src/proxy/ProxySigningConfigResolver.d.ts.map +1 -0
  318. package/src/proxy/ProxySigningConfigResolver.js +24 -0
  319. package/src/proxy/ProxySigningRequest.d.ts +12 -0
  320. package/src/proxy/ProxySigningRequest.d.ts.map +1 -0
  321. package/src/proxy/ProxySigningRequest.js +31 -0
  322. package/src/proxy/RequestValidator.d.ts +15 -0
  323. package/src/proxy/RequestValidator.d.ts.map +1 -0
  324. package/src/proxy/RequestValidator.js +26 -0
  325. package/src/proxy/SigningService.d.ts +39 -0
  326. package/src/proxy/SigningService.d.ts.map +1 -0
  327. package/src/proxy/SigningService.js +107 -0
  328. package/src/proxy/SqlPayloadValidator.d.ts +13 -0
  329. package/src/proxy/SqlPayloadValidator.d.ts.map +1 -0
  330. package/src/proxy/SqlPayloadValidator.js +14 -0
  331. package/src/proxy/SqlProxyDbOverrides.d.ts +17 -0
  332. package/src/proxy/SqlProxyDbOverrides.d.ts.map +1 -0
  333. package/src/proxy/SqlProxyDbOverrides.js +1 -0
  334. package/src/proxy/SqlProxyServerDeps.d.ts +12 -0
  335. package/src/proxy/SqlProxyServerDeps.d.ts.map +1 -0
  336. package/src/proxy/SqlProxyServerDeps.js +9 -0
  337. package/src/proxy/StatementPayloadValidator.d.ts +13 -0
  338. package/src/proxy/StatementPayloadValidator.d.ts.map +1 -0
  339. package/src/proxy/StatementPayloadValidator.js +18 -0
  340. package/src/proxy/StatementRegistryLoader.d.ts +2 -0
  341. package/src/proxy/StatementRegistryLoader.d.ts.map +1 -0
  342. package/src/proxy/StatementRegistryLoader.js +36 -0
  343. package/src/proxy/StatementRegistryResolver.d.ts +15 -0
  344. package/src/proxy/StatementRegistryResolver.d.ts.map +1 -0
  345. package/src/proxy/StatementRegistryResolver.js +34 -0
  346. package/src/proxy/d1/ZintrustD1Proxy.d.ts +3 -0
  347. package/src/proxy/d1/ZintrustD1Proxy.d.ts.map +1 -0
  348. package/src/proxy/d1/ZintrustD1Proxy.js +2 -0
  349. package/src/proxy/d1/register.d.ts +2 -0
  350. package/src/proxy/d1/register.d.ts.map +1 -0
  351. package/src/proxy/d1/register.js +5 -0
  352. package/src/proxy/isMutatingSql.d.ts +2 -0
  353. package/src/proxy/isMutatingSql.d.ts.map +1 -0
  354. package/src/proxy/isMutatingSql.js +12 -0
  355. package/src/proxy/kv/ZintrustKvProxy.d.ts +3 -0
  356. package/src/proxy/kv/ZintrustKvProxy.d.ts.map +1 -0
  357. package/src/proxy/kv/ZintrustKvProxy.js +2 -0
  358. package/src/proxy/kv/register.d.ts +2 -0
  359. package/src/proxy/kv/register.d.ts.map +1 -0
  360. package/src/proxy/kv/register.js +5 -0
  361. package/src/proxy/mongodb/MongoDBProxyServer.d.ts +33 -0
  362. package/src/proxy/mongodb/MongoDBProxyServer.d.ts.map +1 -0
  363. package/src/proxy/mongodb/MongoDBProxyServer.js +202 -0
  364. package/src/proxy/mongodb/register.d.ts +2 -0
  365. package/src/proxy/mongodb/register.d.ts.map +1 -0
  366. package/src/proxy/mongodb/register.js +5 -0
  367. package/src/proxy/mysql/MySqlProxyServer.d.ts +8 -0
  368. package/src/proxy/mysql/MySqlProxyServer.d.ts.map +1 -0
  369. package/src/proxy/mysql/MySqlProxyServer.js +202 -0
  370. package/src/proxy/mysql/register.d.ts +2 -0
  371. package/src/proxy/mysql/register.d.ts.map +1 -0
  372. package/src/proxy/mysql/register.js +5 -0
  373. package/src/proxy/postgres/PostgresProxyServer.d.ts +8 -0
  374. package/src/proxy/postgres/PostgresProxyServer.d.ts.map +1 -0
  375. package/src/proxy/postgres/PostgresProxyServer.js +178 -0
  376. package/src/proxy/postgres/register.d.ts +2 -0
  377. package/src/proxy/postgres/register.d.ts.map +1 -0
  378. package/src/proxy/postgres/register.js +5 -0
  379. package/src/proxy/redis/RedisProxyServer.d.ts +12 -0
  380. package/src/proxy/redis/RedisProxyServer.d.ts.map +1 -0
  381. package/src/proxy/redis/RedisProxyServer.js +192 -0
  382. package/src/proxy/redis/register.d.ts +2 -0
  383. package/src/proxy/redis/register.d.ts.map +1 -0
  384. package/src/proxy/redis/register.js +5 -0
  385. package/src/proxy/smtp/SmtpProxyServer.d.ts +19 -0
  386. package/src/proxy/smtp/SmtpProxyServer.d.ts.map +1 -0
  387. package/src/proxy/smtp/SmtpProxyServer.js +290 -0
  388. package/src/proxy/smtp/register.d.ts +2 -0
  389. package/src/proxy/smtp/register.d.ts.map +1 -0
  390. package/src/proxy/smtp/register.js +5 -0
  391. package/src/proxy/sqlserver/SqlServerProxyServer.d.ts +8 -0
  392. package/src/proxy/sqlserver/SqlServerProxyServer.d.ts.map +1 -0
  393. package/src/proxy/sqlserver/SqlServerProxyServer.js +203 -0
  394. package/src/proxy/sqlserver/register.d.ts +2 -0
  395. package/src/proxy/sqlserver/register.d.ts.map +1 -0
  396. package/src/proxy/sqlserver/register.js +5 -0
  397. package/src/proxy.d.ts +4 -0
  398. package/src/proxy.d.ts.map +1 -0
  399. package/src/proxy.js +3 -0
  400. package/src/routes/doc.d.ts.map +1 -1
  401. package/src/routes/doc.js +16 -2
  402. package/src/routes/error.d.ts +5 -4
  403. package/src/routes/error.d.ts.map +1 -1
  404. package/src/routes/error.js +15 -13
  405. package/src/routes/errorPages.d.ts +2 -0
  406. package/src/routes/errorPages.d.ts.map +1 -1
  407. package/src/routes/errorPages.js +144 -4
  408. package/src/runtime/PluginAutoImports.d.ts +1 -0
  409. package/src/runtime/PluginAutoImports.d.ts.map +1 -1
  410. package/src/runtime/PluginAutoImports.js +94 -9
  411. package/src/runtime/RuntimeAdapter.d.ts +8 -9
  412. package/src/runtime/RuntimeAdapter.d.ts.map +1 -1
  413. package/src/runtime/RuntimeAdapter.js +120 -34
  414. package/src/runtime/RuntimeServices.d.ts +47 -0
  415. package/src/runtime/RuntimeServices.d.ts.map +1 -0
  416. package/src/runtime/RuntimeServices.js +164 -0
  417. package/src/runtime/StartupConfigFileRegistry.d.ts +4 -4
  418. package/src/runtime/StartupConfigFileRegistry.d.ts.map +1 -1
  419. package/src/runtime/StartupConfigFileRegistry.js +12 -0
  420. package/src/runtime/WorkerAdapterImports.d.ts +5 -0
  421. package/src/runtime/WorkerAdapterImports.d.ts.map +1 -0
  422. package/src/runtime/WorkerAdapterImports.js +17 -0
  423. package/src/runtime/WorkersModule.d.ts +6 -0
  424. package/src/runtime/WorkersModule.d.ts.map +1 -0
  425. package/src/runtime/WorkersModule.js +278 -0
  426. package/src/runtime/adapters/CloudflareAdapter.d.ts.map +1 -1
  427. package/src/runtime/adapters/CloudflareAdapter.js +19 -2
  428. package/src/runtime/adapters/DenoAdapter.js +1 -0
  429. package/src/runtime/adapters/FargateAdapter.js +1 -1
  430. package/src/runtime/adapters/LambdaAdapter.js +1 -1
  431. package/src/runtime/adapters/NodeServerAdapter.js +1 -1
  432. package/src/runtime/detectRuntime.d.ts +10 -0
  433. package/src/runtime/detectRuntime.d.ts.map +1 -0
  434. package/src/runtime/detectRuntime.js +57 -0
  435. package/src/runtime/useFileLoader.d.ts.map +1 -1
  436. package/src/runtime/useFileLoader.js +16 -0
  437. package/src/scheduler/Schedule.d.ts +36 -0
  438. package/src/scheduler/Schedule.d.ts.map +1 -0
  439. package/src/scheduler/Schedule.js +197 -0
  440. package/src/scheduler/ScheduleHttpGateway.d.ts +8 -0
  441. package/src/scheduler/ScheduleHttpGateway.d.ts.map +1 -0
  442. package/src/scheduler/ScheduleHttpGateway.js +196 -0
  443. package/src/scheduler/ScheduleRunner.d.ts +6 -0
  444. package/src/scheduler/ScheduleRunner.d.ts.map +1 -1
  445. package/src/scheduler/ScheduleRunner.js +166 -29
  446. package/src/scheduler/SchedulerRuntime.d.ts +15 -0
  447. package/src/scheduler/SchedulerRuntime.d.ts.map +1 -0
  448. package/src/scheduler/SchedulerRuntime.js +79 -0
  449. package/src/scheduler/cron/Cron.d.ts +19 -0
  450. package/src/scheduler/cron/Cron.d.ts.map +1 -0
  451. package/src/scheduler/cron/Cron.js +200 -0
  452. package/src/scheduler/leader/SchedulerLeader.d.ts +14 -0
  453. package/src/scheduler/leader/SchedulerLeader.d.ts.map +1 -0
  454. package/src/scheduler/leader/SchedulerLeader.js +187 -0
  455. package/src/scheduler/state/ScheduleStateStore.d.ts +27 -0
  456. package/src/scheduler/state/ScheduleStateStore.d.ts.map +1 -0
  457. package/src/scheduler/state/ScheduleStateStore.js +27 -0
  458. package/src/scheduler/types.d.ts +10 -0
  459. package/src/scheduler/types.d.ts.map +1 -1
  460. package/src/schedules/index.d.ts +1 -0
  461. package/src/schedules/index.d.ts.map +1 -1
  462. package/src/schedules/index.js +1 -0
  463. package/src/schedules/job-tracking-cleanup.d.ts +4 -0
  464. package/src/schedules/job-tracking-cleanup.d.ts.map +1 -0
  465. package/src/schedules/job-tracking-cleanup.js +116 -0
  466. package/src/schedules/log-cleanup.d.ts +1 -2
  467. package/src/schedules/log-cleanup.d.ts.map +1 -1
  468. package/src/schedules/log-cleanup.js +12 -15
  469. package/src/scripts/TemplateImportsCheck.js +2 -2
  470. package/src/scripts/TemplateSync.js +3 -4
  471. package/src/security/CsrfTokenManager.d.ts.map +1 -1
  472. package/src/security/CsrfTokenManager.js +12 -0
  473. package/src/security/Hash.d.ts +1 -1
  474. package/src/security/Hash.d.ts.map +1 -1
  475. package/src/security/Hash.js +31 -36
  476. package/src/security/Sanitizer.d.ts.map +1 -1
  477. package/src/security/Sanitizer.js +1 -9
  478. package/src/security/SignedRequest.d.ts.map +1 -1
  479. package/src/security/SignedRequest.js +2 -2
  480. package/src/seeders/SeederLoader.js +1 -1
  481. package/src/session/SessionManager.d.ts +3 -0
  482. package/src/session/SessionManager.d.ts.map +1 -1
  483. package/src/session/SessionManager.js +49 -10
  484. package/src/sockets/CloudflareSocket.d.ts +24 -0
  485. package/src/sockets/CloudflareSocket.d.ts.map +1 -0
  486. package/src/sockets/CloudflareSocket.js +259 -0
  487. package/src/start.d.ts.map +1 -1
  488. package/src/start.js +1 -8
  489. package/src/templates/docker/docker-compose.ecosystem.yml.tpl +301 -0
  490. package/src/templates/docker/docker-compose.schedules.yml.tpl +84 -0
  491. package/src/templates/project/basic/app/Schedules/index.ts.tpl +0 -0
  492. package/src/templates/project/basic/config/database.ts.tpl +1 -1
  493. package/src/templates/project/basic/src/zintrust.plugins.wg.ts.tpl +8 -0
  494. package/src/toolkit/Secrets/Manifest.d.ts.map +1 -1
  495. package/src/toolkit/Secrets/Manifest.js +5 -7
  496. package/src/tools/mail/drivers/Smtp.d.ts.map +1 -1
  497. package/src/tools/mail/drivers/Smtp.js +229 -18
  498. package/src/tools/mail/index.d.ts.map +1 -1
  499. package/src/tools/mail/index.js +5 -4
  500. package/src/tools/mail/template-loader.d.ts.map +1 -1
  501. package/src/tools/mail/template-loader.js +197 -29
  502. package/src/tools/mail/templates/auth-password-reset.d.ts +3 -0
  503. package/src/tools/mail/templates/auth-password-reset.d.ts.map +1 -0
  504. package/src/tools/mail/templates/auth-password-reset.js +231 -0
  505. package/src/tools/mail/templates/auth-welcome.d.ts +3 -0
  506. package/src/tools/mail/templates/auth-welcome.d.ts.map +1 -0
  507. package/src/tools/mail/templates/auth-welcome.js +236 -0
  508. package/src/tools/mail/templates/general.d.ts +3 -0
  509. package/src/tools/mail/templates/general.d.ts.map +1 -0
  510. package/src/tools/mail/templates/general.js +109 -0
  511. package/src/tools/mail/templates/index.js +2 -2
  512. package/src/tools/mail/templates/job-completed.d.ts +3 -0
  513. package/src/tools/mail/templates/job-completed.d.ts.map +1 -0
  514. package/src/tools/mail/templates/job-completed.js +188 -0
  515. package/src/tools/mail/templates/notifications-new-comment.d.ts +3 -0
  516. package/src/tools/mail/templates/notifications-new-comment.d.ts.map +1 -0
  517. package/src/tools/mail/templates/notifications-new-comment.js +228 -0
  518. package/src/tools/mail/templates/password-reset.d.ts +3 -0
  519. package/src/tools/mail/templates/password-reset.d.ts.map +1 -0
  520. package/src/tools/mail/templates/password-reset.js +221 -0
  521. package/src/tools/mail/templates/performance-report.d.ts +3 -0
  522. package/src/tools/mail/templates/performance-report.d.ts.map +1 -0
  523. package/src/tools/mail/templates/performance-report.js +258 -0
  524. package/src/tools/mail/templates/welcome.d.ts +3 -0
  525. package/src/tools/mail/templates/welcome.d.ts.map +1 -0
  526. package/src/tools/mail/templates/welcome.js +187 -0
  527. package/src/tools/mail/templates/worker-alert.d.ts +3 -0
  528. package/src/tools/mail/templates/worker-alert.d.ts.map +1 -0
  529. package/src/tools/mail/templates/worker-alert.js +229 -0
  530. package/src/tools/notification/Notification.js +1 -1
  531. package/src/tools/notification/testingHelpers.js +6 -5
  532. package/src/tools/queue/AdvancedQueue.js +2 -6
  533. package/src/tools/queue/IdempotencyManager.d.ts +6 -0
  534. package/src/tools/queue/IdempotencyManager.d.ts.map +1 -0
  535. package/src/tools/queue/IdempotencyManager.js +36 -0
  536. package/src/tools/queue/JobHeartbeatStore.d.ts +16 -0
  537. package/src/tools/queue/JobHeartbeatStore.d.ts.map +1 -0
  538. package/src/tools/queue/JobHeartbeatStore.js +67 -0
  539. package/src/tools/queue/JobReconciliationRunner.d.ts +16 -0
  540. package/src/tools/queue/JobReconciliationRunner.d.ts.map +1 -0
  541. package/src/tools/queue/JobReconciliationRunner.js +56 -0
  542. package/src/tools/queue/JobRecoveryDaemon.d.ts +27 -0
  543. package/src/tools/queue/JobRecoveryDaemon.d.ts.map +1 -0
  544. package/src/tools/queue/JobRecoveryDaemon.js +303 -0
  545. package/src/tools/queue/JobStateTracker.d.ts +140 -0
  546. package/src/tools/queue/JobStateTracker.d.ts.map +1 -0
  547. package/src/tools/queue/JobStateTracker.js +409 -0
  548. package/src/tools/queue/JobStateTrackerDbPersistence.d.ts +12 -0
  549. package/src/tools/queue/JobStateTrackerDbPersistence.d.ts.map +1 -0
  550. package/src/tools/queue/JobStateTrackerDbPersistence.js +239 -0
  551. package/src/tools/queue/Queue.d.ts.map +1 -1
  552. package/src/tools/queue/Queue.js +160 -16
  553. package/src/tools/queue/QueueDataRedactor.d.ts +6 -0
  554. package/src/tools/queue/QueueDataRedactor.d.ts.map +1 -0
  555. package/src/tools/queue/QueueDataRedactor.js +45 -0
  556. package/src/tools/queue/QueueExtensions.d.ts.map +1 -1
  557. package/src/tools/queue/QueueExtensions.js +2 -1
  558. package/src/tools/queue/QueueReliabilityMetrics.d.ts +38 -0
  559. package/src/tools/queue/QueueReliabilityMetrics.d.ts.map +1 -0
  560. package/src/tools/queue/QueueReliabilityMetrics.js +131 -0
  561. package/src/tools/queue/QueueReliabilityOrchestrator.d.ts +7 -0
  562. package/src/tools/queue/QueueReliabilityOrchestrator.d.ts.map +1 -0
  563. package/src/tools/queue/QueueReliabilityOrchestrator.js +59 -0
  564. package/src/tools/queue/QueueRuntimeRegistration.d.ts +1 -9
  565. package/src/tools/queue/QueueRuntimeRegistration.d.ts.map +1 -1
  566. package/src/tools/queue/QueueRuntimeRegistration.js +75 -4
  567. package/src/tools/queue/QueueTracing.d.ts +32 -0
  568. package/src/tools/queue/QueueTracing.d.ts.map +1 -0
  569. package/src/tools/queue/QueueTracing.js +151 -0
  570. package/src/tools/queue/StalledJobMonitor.d.ts +5 -0
  571. package/src/tools/queue/StalledJobMonitor.d.ts.map +1 -0
  572. package/src/tools/queue/StalledJobMonitor.js +21 -0
  573. package/src/tools/queue/TimeoutManager.d.ts +14 -0
  574. package/src/tools/queue/TimeoutManager.d.ts.map +1 -0
  575. package/src/tools/queue/TimeoutManager.js +77 -0
  576. package/src/tools/queue/drivers/Redis.d.ts +1 -0
  577. package/src/tools/queue/drivers/Redis.d.ts.map +1 -1
  578. package/src/tools/queue/drivers/Redis.js +1 -0
  579. package/src/tools/queue/index.d.ts +10 -0
  580. package/src/tools/queue/index.d.ts.map +1 -1
  581. package/src/tools/queue/index.js +10 -0
  582. package/src/tools/storage/drivers/R2.d.ts +13 -0
  583. package/src/tools/storage/drivers/R2.d.ts.map +1 -1
  584. package/src/tools/storage/drivers/R2.js +29 -0
  585. package/src/zintrust.plugins.d.ts +9 -0
  586. package/src/zintrust.plugins.d.ts.map +1 -0
  587. package/src/zintrust.plugins.js +7 -0
  588. package/src/zintrust.plugins.wg.d.ts +9 -0
  589. package/src/zintrust.plugins.wg.d.ts.map +1 -0
  590. package/src/zintrust.plugins.wg.js +7 -0
@@ -4,45 +4,184 @@
4
4
  */
5
5
  import { Logger } from '../config/logger.js';
6
6
  import { ErrorFactory } from '../exceptions/ZintrustError.js';
7
+ import { Cron } from './cron/Cron.js';
8
+ import { InMemoryScheduleStateStore, } from './state/ScheduleStateStore.js';
9
+ const nowMs = () => Date.now();
10
+ const randomInt = (min, maxInclusive) => {
11
+ if (!Number.isFinite(min) || !Number.isFinite(maxInclusive))
12
+ return 0;
13
+ if (maxInclusive <= min)
14
+ return Math.floor(min);
15
+ return Math.floor(min + Math.random() * (maxInclusive - min + 1)); //NOSONAR
16
+ };
17
+ const resolveBackoffDelayMs = (state) => {
18
+ const policy = state.schedule.backoff;
19
+ if (!policy)
20
+ return 0;
21
+ const initialMs = Number.isFinite(policy.initialMs)
22
+ ? Math.max(0, Math.floor(policy.initialMs))
23
+ : 0;
24
+ const maxMs = Number.isFinite(policy.maxMs) ? Math.max(0, Math.floor(policy.maxMs)) : 0;
25
+ if (initialMs <= 0 || maxMs <= 0)
26
+ return 0;
27
+ const factor = policy.factor === undefined || !Number.isFinite(policy.factor) || policy.factor <= 1
28
+ ? 2
29
+ : policy.factor;
30
+ const power = Math.max(0, state.consecutiveFailures - 1);
31
+ const raw = initialMs * Math.pow(factor, power);
32
+ return Math.min(maxMs, Math.floor(raw));
33
+ };
34
+ const resolveJitterMs = (jitterMs) => {
35
+ return typeof jitterMs === 'number' && jitterMs > 0 ? randomInt(0, Math.floor(jitterMs)) : 0;
36
+ };
37
+ const computeBackoffDelay = (state) => {
38
+ if (state.schedule.enabled === false)
39
+ return null;
40
+ const backoffDelayMs = resolveBackoffDelayMs(state);
41
+ if (backoffDelayMs > 0) {
42
+ const jitter = resolveJitterMs(state.schedule.jitterMs);
43
+ return backoffDelayMs + jitter;
44
+ }
45
+ return null;
46
+ };
47
+ const computeCronDelay = (schedule) => {
48
+ if (typeof schedule.cron !== 'string' || schedule.cron.trim().length === 0) {
49
+ return null;
50
+ }
51
+ const tz = typeof schedule.timezone === 'string' && schedule.timezone.trim().length > 0
52
+ ? schedule.timezone
53
+ : 'UTC';
54
+ const nextAt = Cron.nextRunAtMs(nowMs(), schedule.cron, tz);
55
+ const baseDelay = Math.max(0, nextAt - nowMs());
56
+ const jitter = resolveJitterMs(schedule.jitterMs);
57
+ return baseDelay + jitter;
58
+ };
59
+ const computeIntervalDelay = (schedule) => {
60
+ if (typeof schedule.intervalMs !== 'number' || schedule.intervalMs <= 0) {
61
+ return null;
62
+ }
63
+ const base = Math.floor(schedule.intervalMs);
64
+ const jitter = resolveJitterMs(schedule.jitterMs);
65
+ return base + jitter;
66
+ };
67
+ const computeNextDelayMs = (state, outcome) => {
68
+ const schedule = state.schedule;
69
+ if (schedule.enabled === false)
70
+ return null;
71
+ if (outcome === 'failure') {
72
+ const backoffDelay = computeBackoffDelay(state);
73
+ if (backoffDelay !== null)
74
+ return backoffDelay;
75
+ }
76
+ const cronDelay = computeCronDelay(schedule);
77
+ if (cronDelay !== null)
78
+ return cronDelay;
79
+ const intervalDelay = computeIntervalDelay(schedule);
80
+ if (intervalDelay !== null)
81
+ return intervalDelay;
82
+ return null;
83
+ };
84
+ const clearTimer = (state) => {
85
+ if (state.timeoutId !== undefined) {
86
+ globalThis.clearTimeout(state.timeoutId);
87
+ state.timeoutId = undefined;
88
+ }
89
+ };
90
+ const scheduleNext = (state, kernel, invoke, outcome, store) => {
91
+ clearTimer(state);
92
+ const delay = computeNextDelayMs(state, outcome);
93
+ if (delay === null)
94
+ return;
95
+ const nextRunAt = nowMs() + delay;
96
+ void store.set(state.schedule.name, {
97
+ nextRunAt,
98
+ consecutiveFailures: state.consecutiveFailures,
99
+ });
100
+ state.timeoutId = globalThis.setTimeout(() => {
101
+ void runOnceAndReschedule(state, kernel, invoke, store);
102
+ }, delay);
103
+ };
104
+ const runOnceAndReschedule = async (state, kernel, invoke, store) => {
105
+ const outcome = await invoke(state, kernel);
106
+ scheduleNext(state, kernel, invoke, outcome, store);
107
+ };
7
108
  const createRegister = (runner, invokeHandler) => (schedule) => {
8
- if (runner.schedules.has(schedule.name)) {
109
+ const existing = runner.schedules.get(schedule.name);
110
+ if (existing !== undefined) {
9
111
  Logger.warn(`Schedule replaced: ${schedule.name}`);
112
+ // Reuse the same internal state to avoid leaving old timers/reschedule loops behind.
113
+ existing.schedule = schedule;
114
+ // If disabled, ensure any pending timer is cleared.
115
+ if (schedule.enabled === false) {
116
+ clearTimer(existing);
117
+ return;
118
+ }
119
+ // If a run is currently in progress, let it finish and reschedule naturally.
120
+ if (existing.isRunning) {
121
+ return;
122
+ }
123
+ // If schedules are already started, apply the new schedule immediately.
124
+ if (runner.started) {
125
+ if (schedule.runOnStart === true) {
126
+ void runOnceAndReschedule(existing, runner.kernel, invokeHandler, runner.store);
127
+ return;
128
+ }
129
+ scheduleNext(existing, runner.kernel, invokeHandler, 'success', runner.store);
130
+ }
131
+ return;
10
132
  }
11
133
  const state = {
12
134
  schedule,
13
135
  isRunning: false,
136
+ consecutiveFailures: 0,
14
137
  };
15
138
  runner.schedules.set(schedule.name, state);
16
139
  // If schedules are already started, register should take effect immediately.
17
140
  if (runner.started && schedule.enabled !== false) {
18
141
  if (schedule.runOnStart === true) {
19
- void invokeHandler(state, runner.kernel);
20
- }
21
- if (typeof schedule.intervalMs === 'number' && schedule.intervalMs > 0) {
22
- state.intervalId = globalThis.setInterval(() => {
23
- void invokeHandler(state, runner.kernel);
24
- }, schedule.intervalMs);
142
+ void runOnceAndReschedule(state, runner.kernel, invokeHandler, runner.store);
143
+ return;
25
144
  }
145
+ // Auto scheduling
146
+ scheduleNext(state, runner.kernel, invokeHandler, 'success', runner.store);
26
147
  }
27
148
  };
28
- const createInvokeHandler = () => async (state, kernel) => {
149
+ const createInvokeHandler = (store) => async (state, kernel) => {
29
150
  if (state.isRunning) {
30
151
  Logger.info(`Skipping overlapping run for schedule: ${state.schedule.name}`);
31
- return;
152
+ return 'failure';
32
153
  }
33
154
  state.isRunning = true;
34
155
  try {
35
156
  const handlerPromise = Promise.resolve()
36
157
  .then(async () => state.schedule.handler(kernel))
37
158
  .then(() => {
38
- state.lastRunAt = Date.now();
159
+ state.lastRunAt = nowMs();
160
+ state.consecutiveFailures = 0;
161
+ void store.set(state.schedule.name, {
162
+ lastRunAt: state.lastRunAt,
163
+ lastSuccessAt: state.lastRunAt,
164
+ lastErrorAt: undefined,
165
+ lastErrorMessage: undefined,
166
+ consecutiveFailures: state.consecutiveFailures,
167
+ });
168
+ return 'success';
39
169
  })
40
170
  .catch((error) => {
171
+ state.consecutiveFailures = Math.min(1_000_000, state.consecutiveFailures + 1);
172
+ const errMsg = error instanceof Error ? error.message : String(error);
173
+ const at = nowMs();
174
+ void store.set(state.schedule.name, {
175
+ lastRunAt: at,
176
+ lastErrorAt: at,
177
+ lastErrorMessage: errMsg,
178
+ consecutiveFailures: state.consecutiveFailures,
179
+ });
41
180
  Logger.error(`Schedule '${state.schedule.name}' failed:`, error);
42
- })
43
- .then(() => undefined);
44
- state.runningPromise = handlerPromise;
45
- await handlerPromise;
181
+ return 'failure';
182
+ });
183
+ state.runningPromise = handlerPromise.then(() => undefined);
184
+ return await handlerPromise;
46
185
  }
47
186
  finally {
48
187
  state.isRunning = false;
@@ -59,16 +198,12 @@ const createStart = (runner, invokeHandler) => (kernel) => {
59
198
  if (schedule.enabled === false)
60
199
  continue;
61
200
  if (schedule.runOnStart === true) {
62
- // fire-and-forget (handled by invokeHandler which logs errors)
63
- void invokeHandler(state, kernel);
64
- }
65
- if (typeof schedule.intervalMs === 'number' && schedule.intervalMs > 0) {
66
- const id = globalThis.setInterval(() => {
67
- // fire and forget invocation; overlapping runs are protected inside
68
- void invokeHandler(state, kernel);
69
- }, schedule.intervalMs);
70
- state.intervalId = id;
201
+ // fire-and-forget; next scheduling happens after the handler completes
202
+ void runOnceAndReschedule(state, kernel, invokeHandler, runner.store);
203
+ continue;
71
204
  }
205
+ // Auto scheduling
206
+ scheduleNext(state, kernel, invokeHandler, 'success', runner.store);
72
207
  }
73
208
  };
74
209
  const createStop = (runner) => async () => {
@@ -76,12 +211,9 @@ const createStop = (runner) => async () => {
76
211
  return;
77
212
  runner.started = false;
78
213
  runner.kernel = undefined;
79
- // Clear intervals
214
+ // Clear timers
80
215
  for (const [, state] of runner.schedules) {
81
- if (state.intervalId !== undefined) {
82
- globalThis.clearInterval(state.intervalId);
83
- state.intervalId = undefined;
84
- }
216
+ clearTimer(state);
85
217
  }
86
218
  // Await running handlers (runningPromise is guaranteed not to reject)
87
219
  const running = [];
@@ -136,20 +268,25 @@ export const create = () => {
136
268
  schedules: new Map(),
137
269
  started: false,
138
270
  kernel: undefined,
271
+ store: InMemoryScheduleStateStore.create(),
139
272
  };
140
- const invokeHandler = createInvokeHandler();
273
+ const invokeHandler = createInvokeHandler(runner.store);
141
274
  const register = createRegister(runner, invokeHandler);
142
275
  const start = createStart(runner, invokeHandler);
143
276
  const stopRaw = createStop(runner);
144
277
  const stop = createStopWithTimeout(stopRaw);
145
278
  const list = createList(runner);
146
279
  const runOnce = createRunOnce(runner, invokeHandler);
280
+ const getState = async (name) => runner.store.get(name);
281
+ const listStates = async () => runner.store.list();
147
282
  return Object.freeze({
148
283
  register,
149
284
  start,
150
285
  stop,
151
286
  list,
152
287
  runOnce,
288
+ getState,
289
+ listStates,
153
290
  });
154
291
  };
155
292
  export default { create };
@@ -0,0 +1,15 @@
1
+ import type { ScheduleRunState } from './state/ScheduleStateStore';
2
+ import type { ISchedule, IScheduleKernel } from './types';
3
+ export declare const SchedulerRuntime: Readonly<{
4
+ registerMany: (schedules: ReadonlyArray<ISchedule>, source?: "core" | "app") => void;
5
+ start(kernel?: IScheduleKernel): void;
6
+ stop(timeoutMs?: number): Promise<void>;
7
+ list(): ISchedule[];
8
+ listWithState(): Promise<Array<{
9
+ schedule: ISchedule;
10
+ state: ScheduleRunState | null;
11
+ }>>;
12
+ runOnce(name: string, kernel?: IScheduleKernel): Promise<void>;
13
+ }>;
14
+ export default SchedulerRuntime;
15
+ //# sourceMappingURL=SchedulerRuntime.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SchedulerRuntime.d.ts","sourceRoot":"","sources":["../../../src/scheduler/SchedulerRuntime.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,KAAK,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AAmDnE,eAAO,MAAM,gBAAgB;8BAzBhB,aAAa,CAAC,SAAS,CAAC,WAC3B,MAAM,GAAG,KAAK,KACrB,IAAI;mBAyBU,eAAe,GAAG,IAAI;qBAqBd,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAOrC,SAAS,EAAE;qBAGI,OAAO,CAAC,KAAK,CAAC;QAAE,QAAQ,EAAE,SAAS,CAAC;QAAC,KAAK,EAAE,gBAAgB,GAAG,IAAI,CAAA;KAAE,CAAC,CAAC;kBAkB1E,MAAM,WAAW,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC;EAGtC,CAAC;AAEjC,eAAe,gBAAgB,CAAC"}
@@ -0,0 +1,79 @@
1
+ import { Logger } from '../config/logger.js';
2
+ import { createScheduleRunner } from './index.js';
3
+ import { SchedulerLeader } from './leader/SchedulerLeader.js';
4
+ const state = {
5
+ runner: createScheduleRunner(),
6
+ registered: new Map(),
7
+ leader: SchedulerLeader.create(),
8
+ leaderStarted: false,
9
+ };
10
+ const registerMany = (schedules, source = 'core') => {
11
+ for (const schedule of schedules) {
12
+ if (schedule === undefined || schedule === null || typeof schedule.name !== 'string')
13
+ continue;
14
+ const name = schedule.name.trim();
15
+ if (name.length === 0)
16
+ continue;
17
+ const existing = state.registered.get(name);
18
+ // If app already registered, it always wins.
19
+ if (existing === 'app')
20
+ continue;
21
+ // Prevent repeated registrations from the same source.
22
+ if (existing === source)
23
+ continue;
24
+ if (existing === 'core' && source === 'app') {
25
+ Logger.info('Schedule overridden by app/Schedules', { name });
26
+ }
27
+ state.registered.set(name, source);
28
+ state.runner.register(schedule);
29
+ }
30
+ };
31
+ export const SchedulerRuntime = Object.freeze({
32
+ registerMany,
33
+ start(kernel) {
34
+ // If leader mode is enabled, only the leader instance starts timers.
35
+ if (state.leader.isEnabled()) {
36
+ if (state.leaderStarted)
37
+ return;
38
+ state.leaderStarted = true;
39
+ state.leader.start({
40
+ onBecameLeader: () => {
41
+ state.runner.start(kernel);
42
+ },
43
+ onLostLeadership: () => {
44
+ // Best-effort stop; leadership transitions should not crash the process.
45
+ void state.runner.stop();
46
+ },
47
+ });
48
+ return;
49
+ }
50
+ state.runner.start(kernel);
51
+ },
52
+ async stop(timeoutMs) {
53
+ if (state.leaderStarted) {
54
+ state.leaderStarted = false;
55
+ await state.leader.stop();
56
+ }
57
+ await state.runner.stop(timeoutMs);
58
+ },
59
+ list() {
60
+ return state.runner.list();
61
+ },
62
+ async listWithState() {
63
+ const schedules = state.runner.list();
64
+ const getState = state.runner
65
+ .getState;
66
+ if (typeof getState !== 'function') {
67
+ return schedules.map((schedule) => ({ schedule, state: null }));
68
+ }
69
+ const rows = await Promise.all(schedules.map(async (schedule) => {
70
+ const stateRow = (await getState(schedule.name));
71
+ return { schedule, state: stateRow };
72
+ }));
73
+ return rows;
74
+ },
75
+ async runOnce(name, kernel) {
76
+ await state.runner.runOnce(name, kernel);
77
+ },
78
+ });
79
+ export default SchedulerRuntime;
@@ -0,0 +1,19 @@
1
+ type CronAllowed = Readonly<{
2
+ any: true;
3
+ }> | Readonly<{
4
+ any: false;
5
+ values: ReadonlySet<number>;
6
+ }>;
7
+ export type CronSpec = Readonly<{
8
+ minute: CronAllowed;
9
+ hour: CronAllowed;
10
+ dayOfMonth: CronAllowed;
11
+ month: CronAllowed;
12
+ dayOfWeek: CronAllowed;
13
+ }>;
14
+ export declare const Cron: Readonly<{
15
+ parse(expr: string): CronSpec;
16
+ nextRunAtMs(nowMs: number, expr: string, timeZone?: string): number;
17
+ }>;
18
+ export default Cron;
19
+ //# sourceMappingURL=Cron.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Cron.d.ts","sourceRoot":"","sources":["../../../../src/scheduler/cron/Cron.ts"],"names":[],"mappings":"AAEA,KAAK,WAAW,GAAG,QAAQ,CAAC;IAAE,GAAG,EAAE,IAAI,CAAA;CAAE,CAAC,GAAG,QAAQ,CAAC;IAAE,GAAG,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,WAAW,CAAC,MAAM,CAAC,CAAA;CAAE,CAAC,CAAC;AAEnG,MAAM,MAAM,QAAQ,GAAG,QAAQ,CAAC;IAC9B,MAAM,EAAE,WAAW,CAAC;IACpB,IAAI,EAAE,WAAW,CAAC;IAClB,UAAU,EAAE,WAAW,CAAC;IACxB,KAAK,EAAE,WAAW,CAAC;IACnB,SAAS,EAAE,WAAW,CAAC;CACxB,CAAC,CAAC;AA0LH,eAAO,MAAM,IAAI;gBACH,MAAM,GAAG,QAAQ;uBA+BV,MAAM,QAAQ,MAAM,aAAY,MAAM,GAAW,MAAM;EAoB1E,CAAC;AAEH,eAAe,IAAI,CAAC"}
@@ -0,0 +1,200 @@
1
+ const ANY = Object.freeze({ any: true });
2
+ const toInt = (value) => {
3
+ const n = Number.parseInt(value, 10);
4
+ return Number.isFinite(n) ? n : null;
5
+ };
6
+ const clamp = (n, range) => Math.min(range.max, Math.max(range.min, n));
7
+ const expandStep = (step, range, out) => {
8
+ for (let i = range.min; i <= range.max; i += step)
9
+ out.add(i);
10
+ };
11
+ const expandRange = (trimmed, range, out) => {
12
+ const left = trimmed.slice(0, trimmed.indexOf('-'));
13
+ const rest = trimmed.slice(trimmed.indexOf('-') + 1);
14
+ const slashIdx = rest.indexOf('/');
15
+ const right = slashIdx === -1 ? rest : rest.slice(0, slashIdx);
16
+ const stepRaw = slashIdx === -1 ? null : rest.slice(slashIdx + 1);
17
+ const start = toInt(left);
18
+ const end = toInt(right);
19
+ const step = stepRaw === null ? 1 : toInt(stepRaw);
20
+ if (start === null || end === null || step === null || step <= 0)
21
+ return;
22
+ const a = clamp(start, range);
23
+ const b = clamp(end, range);
24
+ const lo = Math.min(a, b);
25
+ const hi = Math.max(a, b);
26
+ for (let i = lo; i <= hi; i += step)
27
+ out.add(i);
28
+ };
29
+ const expandPart = (part, range, out) => {
30
+ const trimmed = part.trim();
31
+ if (trimmed.length === 0)
32
+ return;
33
+ if (trimmed.startsWith('*/')) {
34
+ const step = toInt(trimmed.slice(2));
35
+ if (step !== null && step > 0)
36
+ expandStep(step, range, out);
37
+ return;
38
+ }
39
+ if (trimmed.includes('-')) {
40
+ expandRange(trimmed, range, out);
41
+ return;
42
+ }
43
+ const num = toInt(trimmed);
44
+ if (num !== null)
45
+ out.add(clamp(num, range));
46
+ };
47
+ const parseField = (raw, range, normalize) => {
48
+ const value = raw.trim();
49
+ if (value === '*' || value.length === 0)
50
+ return ANY;
51
+ const set = new Set();
52
+ for (const part of value.split(',')) {
53
+ expandPart(part, range, set);
54
+ }
55
+ if (normalize !== undefined) {
56
+ const normalized = new Set();
57
+ for (const n of set)
58
+ normalized.add(normalize(n));
59
+ return Object.freeze({ any: false, values: normalized });
60
+ }
61
+ return Object.freeze({ any: false, values: set });
62
+ };
63
+ const matches = (allowed, value) => {
64
+ if (allowed.any)
65
+ return true;
66
+ return allowed.values.has(value);
67
+ };
68
+ const weekdayToDow = (weekdayShort) => {
69
+ switch (weekdayShort) {
70
+ case 'Sun':
71
+ return 0;
72
+ case 'Mon':
73
+ return 1;
74
+ case 'Tue':
75
+ return 2;
76
+ case 'Wed':
77
+ return 3;
78
+ case 'Thu':
79
+ return 4;
80
+ case 'Fri':
81
+ return 5;
82
+ case 'Sat':
83
+ return 6;
84
+ default:
85
+ return 0;
86
+ }
87
+ };
88
+ const dtfCache = new Map();
89
+ const getFormatter = (timeZone) => {
90
+ const key = `en-US|${timeZone}`;
91
+ const cached = dtfCache.get(key);
92
+ if (cached)
93
+ return cached;
94
+ const fmt = new Intl.DateTimeFormat('en-US', {
95
+ timeZone,
96
+ weekday: 'short',
97
+ year: 'numeric',
98
+ month: '2-digit',
99
+ day: '2-digit',
100
+ hour: '2-digit',
101
+ minute: '2-digit',
102
+ hourCycle: 'h23',
103
+ });
104
+ dtfCache.set(key, fmt);
105
+ return fmt;
106
+ };
107
+ const getZonedParts = (date, timeZone) => {
108
+ // Fallback to UTC if Intl timeZone support is unavailable.
109
+ try {
110
+ const fmt = getFormatter(timeZone);
111
+ const parts = fmt.formatToParts(date);
112
+ const get = (type) => parts.find((p) => p.type === type)?.value;
113
+ const minute = Number.parseInt(get('minute') ?? '0', 10);
114
+ const hour = Number.parseInt(get('hour') ?? '0', 10);
115
+ const day = Number.parseInt(get('day') ?? '1', 10);
116
+ const month = Number.parseInt(get('month') ?? '1', 10);
117
+ const weekday = get('weekday') ?? 'Sun';
118
+ const dow = weekdayToDow(weekday);
119
+ return { minute, hour, day, month, dow };
120
+ }
121
+ catch {
122
+ return {
123
+ minute: date.getUTCMinutes(),
124
+ hour: date.getUTCHours(),
125
+ day: date.getUTCDate(),
126
+ month: date.getUTCMonth() + 1,
127
+ dow: date.getUTCDay(),
128
+ };
129
+ }
130
+ };
131
+ const domDowMatches = (spec, parts) => {
132
+ const domAny = spec.dayOfMonth.any;
133
+ const dowAny = spec.dayOfWeek.any;
134
+ const domOk = matches(spec.dayOfMonth, parts.day);
135
+ const dowOk = matches(spec.dayOfWeek, parts.dow);
136
+ // Vixie cron semantics:
137
+ // - if either DOM or DOW is '*', require the other field to match
138
+ // - if both are restricted, match if either matches
139
+ if (domAny && dowAny)
140
+ return true;
141
+ if (domAny)
142
+ return dowOk;
143
+ if (dowAny)
144
+ return domOk;
145
+ return domOk || dowOk;
146
+ };
147
+ const matchesSpec = (spec, parts) => {
148
+ return (matches(spec.minute, parts.minute) &&
149
+ matches(spec.hour, parts.hour) &&
150
+ matches(spec.month, parts.month) &&
151
+ domDowMatches(spec, parts));
152
+ };
153
+ export const Cron = Object.freeze({
154
+ parse(expr) {
155
+ const raw = String(expr ?? '').trim();
156
+ const parts = raw.split(/\s+/).filter(Boolean);
157
+ if (parts.length !== 5) {
158
+ // Return an "any" spec for invalid inputs; runner will treat it as "every minute".
159
+ return Object.freeze({
160
+ minute: ANY,
161
+ hour: ANY,
162
+ dayOfMonth: ANY,
163
+ month: ANY,
164
+ dayOfWeek: ANY,
165
+ });
166
+ }
167
+ const [min, hour, dom, month, dow] = parts;
168
+ const normalizeDow = (n) => {
169
+ // allow 7 as Sunday
170
+ if (n === 7)
171
+ return 0;
172
+ return clamp(n, { min: 0, max: 6 });
173
+ };
174
+ return Object.freeze({
175
+ minute: parseField(min, { min: 0, max: 59 }),
176
+ hour: parseField(hour, { min: 0, max: 23 }),
177
+ dayOfMonth: parseField(dom, { min: 1, max: 31 }),
178
+ month: parseField(month, { min: 1, max: 12 }),
179
+ dayOfWeek: parseField(dow, { min: 0, max: 7 }, normalizeDow),
180
+ });
181
+ },
182
+ nextRunAtMs(nowMs, expr, timeZone = 'UTC') {
183
+ const spec = this.parse(expr);
184
+ const base = new Date(nowMs);
185
+ // Cron is minute-resolution; start from next minute boundary.
186
+ base.setUTCSeconds(0, 0);
187
+ base.setTime(base.getTime() + 60_000);
188
+ // Bound search to 366 days (minute granularity). This is defensive; typical crons resolve quickly.
189
+ const maxIterations = 366 * 24 * 60;
190
+ for (let i = 0; i < maxIterations; i++) {
191
+ const parts = getZonedParts(base, timeZone);
192
+ if (matchesSpec(spec, parts))
193
+ return base.getTime();
194
+ base.setTime(base.getTime() + 60_000);
195
+ }
196
+ // Fallback: run in 60s.
197
+ return nowMs + 60_000;
198
+ },
199
+ });
200
+ export default Cron;
@@ -0,0 +1,14 @@
1
+ export type SchedulerLeaderHooks = Readonly<{
2
+ onBecameLeader: () => void;
3
+ onLostLeadership: () => void;
4
+ }>;
5
+ export type SchedulerLeaderApi = Readonly<{
6
+ isEnabled: () => boolean;
7
+ start: (hooks: SchedulerLeaderHooks) => void;
8
+ stop: () => Promise<void>;
9
+ }>;
10
+ export declare const SchedulerLeader: Readonly<{
11
+ create(): SchedulerLeaderApi;
12
+ }>;
13
+ export default SchedulerLeader;
14
+ //# sourceMappingURL=SchedulerLeader.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"SchedulerLeader.d.ts","sourceRoot":"","sources":["../../../../src/scheduler/leader/SchedulerLeader.ts"],"names":[],"mappings":"AAoFA,MAAM,MAAM,oBAAoB,GAAG,QAAQ,CAAC;IAC1C,cAAc,EAAE,MAAM,IAAI,CAAC;IAC3B,gBAAgB,EAAE,MAAM,IAAI,CAAC;CAC9B,CAAC,CAAC;AAEH,MAAM,MAAM,kBAAkB,GAAG,QAAQ,CAAC;IACxC,SAAS,EAAE,MAAM,OAAO,CAAC;IACzB,KAAK,EAAE,CAAC,KAAK,EAAE,oBAAoB,KAAK,IAAI,CAAC;IAC7C,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;CAC3B,CAAC,CAAC;AAgGH,eAAO,MAAM,eAAe;cAChB,kBAAkB;EAkD5B,CAAC;AAEH,eAAe,eAAe,CAAC"}