alepha 0.13.7 → 0.14.0

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 (512) hide show
  1. package/README.md +5 -2
  2. package/assets/swagger-ui/swagger-ui-bundle.js +1 -1
  3. package/assets/swagger-ui/swagger-ui-standalone-preset.js +1 -1
  4. package/assets/swagger-ui/swagger-ui.css +1 -1
  5. package/dist/{api-audits → api/audits}/index.browser.js +4 -4
  6. package/dist/api/audits/index.browser.js.map +1 -0
  7. package/dist/{api-audits → api/audits}/index.d.ts +10 -9
  8. package/dist/api/audits/index.d.ts.map +1 -0
  9. package/dist/{api-audits → api/audits}/index.js +8 -8
  10. package/dist/api/audits/index.js.map +1 -0
  11. package/dist/{api-files → api/files}/index.browser.js +5 -5
  12. package/dist/api/files/index.browser.js.map +1 -0
  13. package/dist/{api-files → api/files}/index.d.ts +18 -10
  14. package/dist/api/files/index.d.ts.map +1 -0
  15. package/dist/{api-files → api/files}/index.js +10 -10
  16. package/dist/api/files/index.js.map +1 -0
  17. package/dist/{api-jobs → api/jobs}/index.browser.js +5 -5
  18. package/dist/api/jobs/index.browser.js.map +1 -0
  19. package/dist/{api-jobs → api/jobs}/index.d.ts +168 -167
  20. package/dist/api/jobs/index.d.ts.map +1 -0
  21. package/dist/{api-jobs → api/jobs}/index.js +9 -9
  22. package/dist/api/jobs/index.js.map +1 -0
  23. package/dist/{api-notifications → api/notifications}/index.browser.js +11 -11
  24. package/dist/api/notifications/index.browser.js.map +1 -0
  25. package/dist/api/notifications/index.d.ts +327 -0
  26. package/dist/api/notifications/index.d.ts.map +1 -0
  27. package/dist/{api-notifications → api/notifications}/index.js +11 -11
  28. package/dist/api/notifications/index.js.map +1 -0
  29. package/dist/{api-parameters → api/parameters}/index.browser.js +2 -2
  30. package/dist/api/parameters/index.browser.js.map +1 -0
  31. package/dist/{api-parameters → api/parameters}/index.d.ts +11 -11
  32. package/dist/api/parameters/index.d.ts.map +1 -0
  33. package/dist/{api-parameters → api/parameters}/index.js +7 -7
  34. package/dist/api/parameters/index.js.map +1 -0
  35. package/dist/{api-users → api/users}/index.browser.js +6 -6
  36. package/dist/api/users/index.browser.js.map +1 -0
  37. package/dist/{api-users → api/users}/index.d.ts +836 -836
  38. package/dist/api/users/index.d.ts.map +1 -0
  39. package/dist/{api-users → api/users}/index.js +99 -766
  40. package/dist/api/users/index.js.map +1 -0
  41. package/dist/{api-verifications → api/verifications}/index.browser.js +5 -5
  42. package/dist/api/verifications/index.browser.js.map +1 -0
  43. package/dist/api/verifications/index.d.ts +248 -0
  44. package/dist/api/verifications/index.d.ts.map +1 -0
  45. package/dist/{api-verifications → api/verifications}/index.js +11 -11
  46. package/dist/api/verifications/index.js.map +1 -0
  47. package/dist/batch/index.d.ts.map +1 -0
  48. package/dist/bucket/index.d.ts.map +1 -0
  49. package/dist/cache/{index.d.ts → core/index.d.ts} +4 -4
  50. package/dist/cache/core/index.d.ts.map +1 -0
  51. package/dist/cache/{index.js → core/index.js} +5 -5
  52. package/dist/cache/core/index.js.map +1 -0
  53. package/dist/{cache-redis → cache/redis}/index.d.ts +2 -2
  54. package/dist/cache/redis/index.d.ts.map +1 -0
  55. package/dist/{cache-redis → cache/redis}/index.js +2 -2
  56. package/dist/cache/redis/index.js.map +1 -0
  57. package/dist/cli/index.d.ts +78 -58
  58. package/dist/cli/index.d.ts.map +1 -0
  59. package/dist/cli/index.js +454 -154
  60. package/dist/cli/index.js.map +1 -1
  61. package/dist/command/index.d.ts +15 -5
  62. package/dist/command/index.d.ts.map +1 -0
  63. package/dist/command/index.js +45 -6
  64. package/dist/command/index.js.map +1 -1
  65. package/dist/core/index.browser.js +1334 -1318
  66. package/dist/core/index.browser.js.map +1 -1
  67. package/dist/core/index.d.ts +75 -71
  68. package/dist/core/index.d.ts.map +1 -0
  69. package/dist/core/index.js +1337 -1321
  70. package/dist/core/index.js.map +1 -1
  71. package/dist/core/index.native.js +1337 -1321
  72. package/dist/core/index.native.js.map +1 -1
  73. package/dist/datetime/index.d.ts.map +1 -0
  74. package/dist/email/index.d.ts.map +1 -0
  75. package/dist/fake/index.d.ts.map +1 -0
  76. package/dist/file/index.d.ts.map +1 -0
  77. package/dist/lock/{index.d.ts → core/index.d.ts} +5 -5
  78. package/dist/lock/core/index.d.ts.map +1 -0
  79. package/dist/lock/{index.js → core/index.js} +5 -5
  80. package/dist/lock/core/index.js.map +1 -0
  81. package/dist/{lock-redis → lock/redis}/index.d.ts +2 -2
  82. package/dist/lock/redis/index.d.ts.map +1 -0
  83. package/dist/{lock-redis → lock/redis}/index.js +2 -2
  84. package/dist/lock/redis/index.js.map +1 -0
  85. package/dist/logger/index.d.ts +1 -0
  86. package/dist/logger/index.d.ts.map +1 -0
  87. package/dist/mcp/index.d.ts +820 -0
  88. package/dist/mcp/index.d.ts.map +1 -0
  89. package/dist/mcp/index.js +978 -0
  90. package/dist/mcp/index.js.map +1 -0
  91. package/dist/orm/index.d.ts +180 -107
  92. package/dist/orm/index.d.ts.map +1 -0
  93. package/dist/orm/index.js +260 -174
  94. package/dist/orm/index.js.map +1 -1
  95. package/dist/queue/core/index.d.ts +548 -0
  96. package/dist/queue/core/index.d.ts.map +1 -0
  97. package/dist/queue/core/index.js +391 -0
  98. package/dist/queue/core/index.js.map +1 -0
  99. package/dist/queue/redis/index.d.ts +28 -0
  100. package/dist/queue/redis/index.d.ts.map +1 -0
  101. package/dist/queue/redis/index.js +43 -0
  102. package/dist/queue/redis/index.js.map +1 -0
  103. package/dist/redis/index.d.ts.map +1 -0
  104. package/dist/retry/index.d.ts.map +1 -0
  105. package/dist/router/index.d.ts.map +1 -0
  106. package/dist/scheduler/index.d.ts +1 -1
  107. package/dist/scheduler/index.d.ts.map +1 -0
  108. package/dist/scheduler/index.js +1 -393
  109. package/dist/scheduler/index.js.map +1 -1
  110. package/dist/security/index.d.ts +1 -1
  111. package/dist/security/index.d.ts.map +1 -0
  112. package/dist/security/index.js +2 -1413
  113. package/dist/security/index.js.map +1 -1
  114. package/dist/{server-auth → server/auth}/index.browser.js +6 -6
  115. package/dist/server/auth/index.browser.js.map +1 -0
  116. package/dist/{server-auth → server/auth}/index.d.ts +167 -167
  117. package/dist/server/auth/index.d.ts.map +1 -0
  118. package/dist/server/auth/index.js +742 -0
  119. package/dist/server/auth/index.js.map +1 -0
  120. package/dist/{server-cache → server/cache}/index.d.ts +2 -2
  121. package/dist/server/cache/index.d.ts.map +1 -0
  122. package/dist/{server-cache → server/cache}/index.js +2 -2
  123. package/dist/server/cache/index.js.map +1 -0
  124. package/dist/{server-compress → server/compress}/index.d.ts +2 -2
  125. package/dist/server/compress/index.d.ts.map +1 -0
  126. package/dist/{server-compress → server/compress}/index.js +2 -2
  127. package/dist/server/compress/index.js.map +1 -0
  128. package/dist/{server-cookies → server/cookies}/index.browser.js +3 -3
  129. package/dist/server/cookies/index.browser.js.map +1 -0
  130. package/dist/{server-cookies → server/cookies}/index.d.ts +4 -4
  131. package/dist/server/cookies/index.d.ts.map +1 -0
  132. package/dist/{server-cookies → server/cookies}/index.js +4 -4
  133. package/dist/server/cookies/index.js.map +1 -0
  134. package/dist/server/{index.browser.js → core/index.browser.js} +14 -14
  135. package/dist/server/core/index.browser.js.map +1 -0
  136. package/dist/server/{index.d.ts → core/index.d.ts} +36 -36
  137. package/dist/server/core/index.d.ts.map +1 -0
  138. package/dist/server/{index.js → core/index.js} +27 -27
  139. package/dist/server/core/index.js.map +1 -0
  140. package/dist/{server-cors → server/cors}/index.d.ts +3 -3
  141. package/dist/server/cors/index.d.ts.map +1 -0
  142. package/dist/{server-cors → server/cors}/index.js +3 -3
  143. package/dist/server/cors/index.js.map +1 -0
  144. package/dist/{server-health → server/health}/index.d.ts +3 -3
  145. package/dist/server/health/index.d.ts.map +1 -0
  146. package/dist/{server-health → server/health}/index.js +3 -3
  147. package/dist/server/health/index.js.map +1 -0
  148. package/dist/{server-helmet → server/helmet}/index.d.ts +2 -2
  149. package/dist/server/helmet/index.d.ts.map +1 -0
  150. package/dist/{server-helmet → server/helmet}/index.js +2 -2
  151. package/dist/server/helmet/index.js.map +1 -0
  152. package/dist/{server-links → server/links}/index.browser.js +5 -5
  153. package/dist/server/links/index.browser.js.map +1 -0
  154. package/dist/{server-links → server/links}/index.d.ts +40 -40
  155. package/dist/server/links/index.d.ts.map +1 -0
  156. package/dist/{server-links → server/links}/index.js +7 -7
  157. package/dist/server/links/index.js.map +1 -0
  158. package/dist/{server-metrics → server/metrics}/index.d.ts +2 -2
  159. package/dist/server/metrics/index.d.ts.map +1 -0
  160. package/dist/server/metrics/index.js +74 -0
  161. package/dist/server/metrics/index.js.map +1 -0
  162. package/dist/{server-multipart → server/multipart}/index.d.ts +2 -2
  163. package/dist/server/multipart/index.d.ts.map +1 -0
  164. package/dist/{server-multipart → server/multipart}/index.js +2 -2
  165. package/dist/server/multipart/index.js.map +1 -0
  166. package/dist/{server-proxy → server/proxy}/index.d.ts +3 -3
  167. package/dist/server/proxy/index.d.ts.map +1 -0
  168. package/dist/{server-proxy → server/proxy}/index.js +3 -3
  169. package/dist/server/proxy/index.js.map +1 -0
  170. package/dist/{server-rate-limit → server/rate-limit}/index.d.ts +4 -4
  171. package/dist/server/rate-limit/index.d.ts.map +1 -0
  172. package/dist/{server-rate-limit → server/rate-limit}/index.js +4 -4
  173. package/dist/server/rate-limit/index.js.map +1 -0
  174. package/dist/{server-security → server/security}/index.browser.js +1 -1
  175. package/dist/server/security/index.browser.js.map +1 -0
  176. package/dist/{server-security → server/security}/index.d.ts +4 -4
  177. package/dist/server/security/index.d.ts.map +1 -0
  178. package/dist/{server-security → server/security}/index.js +4 -4
  179. package/dist/server/security/index.js.map +1 -0
  180. package/dist/{server-static → server/static}/index.d.ts +3 -3
  181. package/dist/server/static/index.d.ts.map +1 -0
  182. package/dist/{server-static → server/static}/index.js +3 -3
  183. package/dist/server/static/index.js.map +1 -0
  184. package/dist/{server-swagger → server/swagger}/index.d.ts +3 -3
  185. package/dist/server/swagger/index.d.ts.map +1 -0
  186. package/dist/{server-swagger → server/swagger}/index.js +4 -4
  187. package/dist/server/swagger/index.js.map +1 -0
  188. package/dist/sms/index.d.ts.map +1 -0
  189. package/dist/thread/index.d.ts.map +1 -0
  190. package/dist/topic/{index.d.ts → core/index.d.ts} +6 -6
  191. package/dist/topic/core/index.d.ts.map +1 -0
  192. package/dist/topic/{index.js → core/index.js} +6 -6
  193. package/dist/topic/core/index.js.map +1 -0
  194. package/dist/{topic-redis → topic/redis}/index.d.ts +2 -2
  195. package/dist/topic/redis/index.d.ts.map +1 -0
  196. package/dist/{topic-redis → topic/redis}/index.js +2 -2
  197. package/dist/topic/redis/index.js.map +1 -0
  198. package/dist/vite/index.d.ts +21 -2
  199. package/dist/vite/index.d.ts.map +1 -0
  200. package/dist/vite/index.js +48 -19
  201. package/dist/vite/index.js.map +1 -1
  202. package/dist/websocket/index.d.ts.map +1 -0
  203. package/package.json +162 -158
  204. package/src/{api-files → api/files}/index.ts +1 -0
  205. package/src/{api-parameters → api/parameters}/index.ts +1 -1
  206. package/src/{api-users → api/users}/primitives/$userRealm.ts +1 -1
  207. package/src/{api-users → api/users}/providers/UserRealmProvider.ts +6 -7
  208. package/src/{api-verifications → api/verifications}/index.ts +2 -0
  209. package/src/cli/apps/AlephaCli.ts +2 -0
  210. package/src/cli/apps/AlephaPackageBuilderCli.ts +83 -54
  211. package/src/cli/assets/appRouterTs.ts +1 -1
  212. package/src/cli/assets/biomeJson.ts +1 -1
  213. package/src/cli/assets/indexHtml.ts +1 -1
  214. package/src/cli/assets/mainBrowserTs.ts +1 -1
  215. package/src/cli/assets/mainTs.ts +9 -10
  216. package/src/cli/assets/viteConfigTs.ts +1 -1
  217. package/src/cli/commands/ChangelogCommands.ts +389 -0
  218. package/src/cli/commands/CoreCommands.ts +10 -6
  219. package/src/cli/commands/DrizzleCommands.ts +204 -4
  220. package/src/cli/commands/VerifyCommands.ts +4 -1
  221. package/src/cli/commands/ViteCommands.ts +46 -25
  222. package/src/cli/services/AlephaCliUtils.ts +52 -164
  223. package/src/command/providers/CliProvider.ts +76 -5
  224. package/src/core/providers/SchemaValidator.ts +24 -2
  225. package/src/mcp/errors/McpError.ts +72 -0
  226. package/src/mcp/helpers/jsonrpc.ts +163 -0
  227. package/src/mcp/index.ts +132 -0
  228. package/src/mcp/interfaces/McpTypes.ts +248 -0
  229. package/src/mcp/primitives/$prompt.ts +188 -0
  230. package/src/mcp/primitives/$resource.ts +171 -0
  231. package/src/mcp/primitives/$tool.ts +285 -0
  232. package/src/mcp/providers/McpServerProvider.ts +382 -0
  233. package/src/mcp/transports/SseMcpTransport.ts +172 -0
  234. package/src/mcp/transports/StdioMcpTransport.ts +126 -0
  235. package/src/orm/index.ts +12 -0
  236. package/src/orm/providers/drivers/CloudflareD1Provider.ts +164 -0
  237. package/src/orm/providers/drivers/NodeSqliteProvider.ts +3 -1
  238. package/src/queue/{index.ts → core/index.ts} +2 -3
  239. package/src/queue/{primitives → core/primitives}/$queue.ts +17 -162
  240. package/src/queue/core/providers/MemoryQueueProvider.ts +19 -0
  241. package/src/queue/core/providers/QueueProvider.ts +23 -0
  242. package/src/queue/core/providers/WorkerProvider.ts +244 -0
  243. package/src/queue/redis/providers/RedisQueueProvider.ts +31 -0
  244. package/src/server/{index.ts → core/index.ts} +1 -0
  245. package/src/{server-rate-limit → server/rate-limit}/index.ts +1 -1
  246. package/src/{server-swagger → server/swagger}/providers/ServerSwaggerProvider.ts +1 -0
  247. package/src/vite/plugins/viteAlephaBuild.ts +8 -2
  248. package/src/vite/plugins/viteAlephaDev.ts +6 -2
  249. package/src/vite/tasks/buildServer.ts +1 -1
  250. package/src/vite/tasks/copyAssets.ts +32 -8
  251. package/src/vite/tasks/generateCloudflare.ts +43 -15
  252. package/src/vite/tasks/runAlepha.ts +1 -0
  253. package/dist/api-audits/index.browser.js.map +0 -1
  254. package/dist/api-audits/index.js.map +0 -1
  255. package/dist/api-files/index.browser.js.map +0 -1
  256. package/dist/api-files/index.js.map +0 -1
  257. package/dist/api-jobs/index.browser.js.map +0 -1
  258. package/dist/api-jobs/index.js.map +0 -1
  259. package/dist/api-notifications/index.browser.js.map +0 -1
  260. package/dist/api-notifications/index.d.ts +0 -327
  261. package/dist/api-notifications/index.js.map +0 -1
  262. package/dist/api-parameters/index.browser.js.map +0 -1
  263. package/dist/api-parameters/index.js.map +0 -1
  264. package/dist/api-users/index.browser.js.map +0 -1
  265. package/dist/api-users/index.js.map +0 -1
  266. package/dist/api-verifications/index.browser.js.map +0 -1
  267. package/dist/api-verifications/index.d.ts +0 -229
  268. package/dist/api-verifications/index.js.map +0 -1
  269. package/dist/cache/index.js.map +0 -1
  270. package/dist/cache-redis/index.js.map +0 -1
  271. package/dist/lock/index.js.map +0 -1
  272. package/dist/lock-redis/index.js.map +0 -1
  273. package/dist/queue/index.d.ts +0 -1265
  274. package/dist/queue/index.js +0 -1037
  275. package/dist/queue/index.js.map +0 -1
  276. package/dist/queue-redis/index.d.ts +0 -82
  277. package/dist/queue-redis/index.js +0 -872
  278. package/dist/queue-redis/index.js.map +0 -1
  279. package/dist/server/index.browser.js.map +0 -1
  280. package/dist/server/index.js.map +0 -1
  281. package/dist/server-auth/index.browser.js.map +0 -1
  282. package/dist/server-auth/index.js +0 -1973
  283. package/dist/server-auth/index.js.map +0 -1
  284. package/dist/server-cache/index.js.map +0 -1
  285. package/dist/server-compress/index.js.map +0 -1
  286. package/dist/server-cookies/index.browser.js.map +0 -1
  287. package/dist/server-cookies/index.js.map +0 -1
  288. package/dist/server-cors/index.js.map +0 -1
  289. package/dist/server-health/index.js.map +0 -1
  290. package/dist/server-helmet/index.js.map +0 -1
  291. package/dist/server-links/index.browser.js.map +0 -1
  292. package/dist/server-links/index.js.map +0 -1
  293. package/dist/server-metrics/index.js +0 -4532
  294. package/dist/server-metrics/index.js.map +0 -1
  295. package/dist/server-multipart/index.js.map +0 -1
  296. package/dist/server-proxy/index.js.map +0 -1
  297. package/dist/server-rate-limit/index.js.map +0 -1
  298. package/dist/server-security/index.browser.js.map +0 -1
  299. package/dist/server-security/index.js.map +0 -1
  300. package/dist/server-static/index.js.map +0 -1
  301. package/dist/server-swagger/index.js.map +0 -1
  302. package/dist/topic/index.js.map +0 -1
  303. package/dist/topic-redis/index.js.map +0 -1
  304. package/src/queue/interfaces/QueueJob.ts +0 -459
  305. package/src/queue/providers/MemoryQueueProvider.ts +0 -850
  306. package/src/queue/providers/QueueProvider.ts +0 -319
  307. package/src/queue/providers/WorkerProvider.ts +0 -344
  308. package/src/queue-redis/providers/RedisQueueProvider.ts +0 -1209
  309. /package/src/{api-audits → api/audits}/controllers/AuditController.ts +0 -0
  310. /package/src/{api-audits → api/audits}/entities/audits.ts +0 -0
  311. /package/src/{api-audits → api/audits}/index.browser.ts +0 -0
  312. /package/src/{api-audits → api/audits}/index.ts +0 -0
  313. /package/src/{api-audits → api/audits}/primitives/$audit.ts +0 -0
  314. /package/src/{api-audits → api/audits}/schemas/auditQuerySchema.ts +0 -0
  315. /package/src/{api-audits → api/audits}/schemas/auditResourceSchema.ts +0 -0
  316. /package/src/{api-audits → api/audits}/schemas/createAuditSchema.ts +0 -0
  317. /package/src/{api-audits → api/audits}/services/AuditService.ts +0 -0
  318. /package/src/{api-files → api/files}/controllers/FileController.ts +0 -0
  319. /package/src/{api-files → api/files}/controllers/StorageStatsController.ts +0 -0
  320. /package/src/{api-files → api/files}/entities/files.ts +0 -0
  321. /package/src/{api-files → api/files}/index.browser.ts +0 -0
  322. /package/src/{api-files → api/files}/jobs/FileJobs.ts +0 -0
  323. /package/src/{api-files → api/files}/schemas/fileQuerySchema.ts +0 -0
  324. /package/src/{api-files → api/files}/schemas/fileResourceSchema.ts +0 -0
  325. /package/src/{api-files → api/files}/schemas/storageStatsSchema.ts +0 -0
  326. /package/src/{api-files → api/files}/services/FileService.ts +0 -0
  327. /package/src/{api-jobs → api/jobs}/controllers/JobController.ts +0 -0
  328. /package/src/{api-jobs → api/jobs}/entities/jobExecutions.ts +0 -0
  329. /package/src/{api-jobs → api/jobs}/index.browser.ts +0 -0
  330. /package/src/{api-jobs → api/jobs}/index.ts +0 -0
  331. /package/src/{api-jobs → api/jobs}/primitives/$job.ts +0 -0
  332. /package/src/{api-jobs → api/jobs}/providers/JobProvider.ts +0 -0
  333. /package/src/{api-jobs → api/jobs}/schemas/jobExecutionQuerySchema.ts +0 -0
  334. /package/src/{api-jobs → api/jobs}/schemas/jobExecutionResourceSchema.ts +0 -0
  335. /package/src/{api-jobs → api/jobs}/schemas/triggerJobSchema.ts +0 -0
  336. /package/src/{api-jobs → api/jobs}/services/JobService.ts +0 -0
  337. /package/src/{api-notifications → api/notifications}/controllers/NotificationController.ts +0 -0
  338. /package/src/{api-notifications → api/notifications}/entities/notifications.ts +0 -0
  339. /package/src/{api-notifications → api/notifications}/index.browser.ts +0 -0
  340. /package/src/{api-notifications → api/notifications}/index.ts +0 -0
  341. /package/src/{api-notifications → api/notifications}/jobs/NotificationJobs.ts +0 -0
  342. /package/src/{api-notifications → api/notifications}/primitives/$notification.ts +0 -0
  343. /package/src/{api-notifications → api/notifications}/queues/NotificationQueues.ts +0 -0
  344. /package/src/{api-notifications → api/notifications}/schemas/notificationContactPreferencesSchema.ts +0 -0
  345. /package/src/{api-notifications → api/notifications}/schemas/notificationContactSchema.ts +0 -0
  346. /package/src/{api-notifications → api/notifications}/schemas/notificationCreateSchema.ts +0 -0
  347. /package/src/{api-notifications → api/notifications}/schemas/notificationQuerySchema.ts +0 -0
  348. /package/src/{api-notifications → api/notifications}/services/NotificationSenderService.ts +0 -0
  349. /package/src/{api-notifications → api/notifications}/services/NotificationService.ts +0 -0
  350. /package/src/{api-parameters → api/parameters}/controllers/ConfigController.ts +0 -0
  351. /package/src/{api-parameters → api/parameters}/entities/parameters.ts +0 -0
  352. /package/src/{api-parameters → api/parameters}/index.browser.ts +0 -0
  353. /package/src/{api-parameters → api/parameters}/primitives/$config.ts +0 -0
  354. /package/src/{api-parameters → api/parameters}/schedulers/ConfigActivationScheduler.ts +0 -0
  355. /package/src/{api-parameters → api/parameters}/services/ConfigStore.ts +0 -0
  356. /package/src/{api-users → api/users}/atoms/realmAuthSettingsAtom.ts +0 -0
  357. /package/src/{api-users → api/users}/controllers/IdentityController.ts +0 -0
  358. /package/src/{api-users → api/users}/controllers/SessionController.ts +0 -0
  359. /package/src/{api-users → api/users}/controllers/UserController.ts +0 -0
  360. /package/src/{api-users → api/users}/controllers/UserRealmController.ts +0 -0
  361. /package/src/{api-users → api/users}/entities/identities.ts +0 -0
  362. /package/src/{api-users → api/users}/entities/sessions.ts +0 -0
  363. /package/src/{api-users → api/users}/entities/users.ts +0 -0
  364. /package/src/{api-users → api/users}/index.browser.ts +0 -0
  365. /package/src/{api-users → api/users}/index.ts +0 -0
  366. /package/src/{api-users → api/users}/notifications/UserNotifications.ts +0 -0
  367. /package/src/{api-users → api/users}/schemas/completePasswordResetRequestSchema.ts +0 -0
  368. /package/src/{api-users → api/users}/schemas/completeRegistrationRequestSchema.ts +0 -0
  369. /package/src/{api-users → api/users}/schemas/createUserSchema.ts +0 -0
  370. /package/src/{api-users → api/users}/schemas/identityQuerySchema.ts +0 -0
  371. /package/src/{api-users → api/users}/schemas/identityResourceSchema.ts +0 -0
  372. /package/src/{api-users → api/users}/schemas/loginSchema.ts +0 -0
  373. /package/src/{api-users → api/users}/schemas/passwordResetIntentResponseSchema.ts +0 -0
  374. /package/src/{api-users → api/users}/schemas/registerQuerySchema.ts +0 -0
  375. /package/src/{api-users → api/users}/schemas/registerRequestSchema.ts +0 -0
  376. /package/src/{api-users → api/users}/schemas/registerResponseSchema.ts +0 -0
  377. /package/src/{api-users → api/users}/schemas/registerSchema.ts +0 -0
  378. /package/src/{api-users → api/users}/schemas/registrationIntentResponseSchema.ts +0 -0
  379. /package/src/{api-users → api/users}/schemas/resetPasswordSchema.ts +0 -0
  380. /package/src/{api-users → api/users}/schemas/sessionQuerySchema.ts +0 -0
  381. /package/src/{api-users → api/users}/schemas/sessionResourceSchema.ts +0 -0
  382. /package/src/{api-users → api/users}/schemas/updateUserSchema.ts +0 -0
  383. /package/src/{api-users → api/users}/schemas/userQuerySchema.ts +0 -0
  384. /package/src/{api-users → api/users}/schemas/userRealmConfigSchema.ts +0 -0
  385. /package/src/{api-users → api/users}/schemas/userResourceSchema.ts +0 -0
  386. /package/src/{api-users → api/users}/services/CredentialService.ts +0 -0
  387. /package/src/{api-users → api/users}/services/IdentityService.ts +0 -0
  388. /package/src/{api-users → api/users}/services/RegistrationService.ts +0 -0
  389. /package/src/{api-users → api/users}/services/SessionCrudService.ts +0 -0
  390. /package/src/{api-users → api/users}/services/SessionService.ts +0 -0
  391. /package/src/{api-users → api/users}/services/UserService.ts +0 -0
  392. /package/src/{api-verifications → api/verifications}/controllers/VerificationController.ts +0 -0
  393. /package/src/{api-verifications → api/verifications}/entities/verifications.ts +0 -0
  394. /package/src/{api-verifications → api/verifications}/index.browser.ts +0 -0
  395. /package/src/{api-verifications → api/verifications}/jobs/VerificationJobs.ts +0 -0
  396. /package/src/{api-verifications → api/verifications}/parameters/VerificationParameters.ts +0 -0
  397. /package/src/{api-verifications → api/verifications}/schemas/requestVerificationCodeResponseSchema.ts +0 -0
  398. /package/src/{api-verifications → api/verifications}/schemas/validateVerificationCodeResponseSchema.ts +0 -0
  399. /package/src/{api-verifications → api/verifications}/schemas/verificationSettingsSchema.ts +0 -0
  400. /package/src/{api-verifications → api/verifications}/schemas/verificationTypeEnumSchema.ts +0 -0
  401. /package/src/{api-verifications → api/verifications}/services/VerificationService.ts +0 -0
  402. /package/src/cache/{errors → core/errors}/CacheError.ts +0 -0
  403. /package/src/cache/{index.ts → core/index.ts} +0 -0
  404. /package/src/cache/{primitives → core/primitives}/$cache.ts +0 -0
  405. /package/src/cache/{providers → core/providers}/CacheProvider.ts +0 -0
  406. /package/src/cache/{providers → core/providers}/MemoryCacheProvider.ts +0 -0
  407. /package/src/{cache-redis → cache/redis}/index.ts +0 -0
  408. /package/src/{cache-redis → cache/redis}/providers/RedisCacheProvider.ts +0 -0
  409. /package/src/lock/{index.ts → core/index.ts} +0 -0
  410. /package/src/lock/{primitives → core/primitives}/$lock.ts +0 -0
  411. /package/src/lock/{providers → core/providers}/LockProvider.ts +0 -0
  412. /package/src/lock/{providers → core/providers}/LockTopicProvider.ts +0 -0
  413. /package/src/lock/{providers → core/providers}/MemoryLockProvider.ts +0 -0
  414. /package/src/{lock-redis → lock/redis}/index.ts +0 -0
  415. /package/src/{lock-redis → lock/redis}/providers/RedisLockProvider.ts +0 -0
  416. /package/src/queue/{primitives → core/primitives}/$consumer.ts +0 -0
  417. /package/src/{queue-redis → queue/redis}/index.ts +0 -0
  418. /package/src/{server-auth → server/auth}/constants/routes.ts +0 -0
  419. /package/src/{server-auth → server/auth}/index.browser.ts +0 -0
  420. /package/src/{server-auth → server/auth}/index.shared.ts +0 -0
  421. /package/src/{server-auth → server/auth}/index.ts +0 -0
  422. /package/src/{server-auth → server/auth}/primitives/$auth.ts +0 -0
  423. /package/src/{server-auth → server/auth}/primitives/$authApple.ts +0 -0
  424. /package/src/{server-auth → server/auth}/primitives/$authCredentials.ts +0 -0
  425. /package/src/{server-auth → server/auth}/primitives/$authGithub.ts +0 -0
  426. /package/src/{server-auth → server/auth}/primitives/$authGoogle.ts +0 -0
  427. /package/src/{server-auth → server/auth}/providers/ServerAuthProvider.ts +0 -0
  428. /package/src/{server-auth → server/auth}/schemas/authenticationProviderSchema.ts +0 -0
  429. /package/src/{server-auth → server/auth}/schemas/tokenResponseSchema.ts +0 -0
  430. /package/src/{server-auth → server/auth}/schemas/tokensSchema.ts +0 -0
  431. /package/src/{server-auth → server/auth}/schemas/userinfoResponseSchema.ts +0 -0
  432. /package/src/{server-cache → server/cache}/index.ts +0 -0
  433. /package/src/{server-cache → server/cache}/providers/ServerCacheProvider.ts +0 -0
  434. /package/src/{server-compress → server/compress}/index.ts +0 -0
  435. /package/src/{server-compress → server/compress}/providers/ServerCompressProvider.ts +0 -0
  436. /package/src/{server-cookies → server/cookies}/index.browser.ts +0 -0
  437. /package/src/{server-cookies → server/cookies}/index.ts +0 -0
  438. /package/src/{server-cookies → server/cookies}/primitives/$cookie.browser.ts +0 -0
  439. /package/src/{server-cookies → server/cookies}/primitives/$cookie.ts +0 -0
  440. /package/src/{server-cookies → server/cookies}/providers/ServerCookiesProvider.ts +0 -0
  441. /package/src/{server-cookies → server/cookies}/services/CookieParser.ts +0 -0
  442. /package/src/server/{constants → core/constants}/routeMethods.ts +0 -0
  443. /package/src/server/{errors → core/errors}/BadRequestError.ts +0 -0
  444. /package/src/server/{errors → core/errors}/ConflictError.ts +0 -0
  445. /package/src/server/{errors → core/errors}/ForbiddenError.ts +0 -0
  446. /package/src/server/{errors → core/errors}/HttpError.ts +0 -0
  447. /package/src/server/{errors → core/errors}/NotFoundError.ts +0 -0
  448. /package/src/server/{errors → core/errors}/UnauthorizedError.ts +0 -0
  449. /package/src/server/{errors → core/errors}/ValidationError.ts +0 -0
  450. /package/src/server/{helpers → core/helpers}/ServerReply.ts +0 -0
  451. /package/src/server/{helpers → core/helpers}/isMultipart.ts +0 -0
  452. /package/src/server/{index.browser.ts → core/index.browser.ts} +0 -0
  453. /package/src/server/{index.shared.ts → core/index.shared.ts} +0 -0
  454. /package/src/server/{interfaces → core/interfaces}/ServerRequest.ts +0 -0
  455. /package/src/server/{primitives → core/primitives}/$action.ts +0 -0
  456. /package/src/server/{primitives → core/primitives}/$route.ts +0 -0
  457. /package/src/server/{providers → core/providers}/BunHttpServerProvider.ts +0 -0
  458. /package/src/server/{providers → core/providers}/NodeHttpServerProvider.ts +0 -0
  459. /package/src/server/{providers → core/providers}/ServerBodyParserProvider.ts +0 -0
  460. /package/src/server/{providers → core/providers}/ServerLoggerProvider.ts +0 -0
  461. /package/src/server/{providers → core/providers}/ServerNotReadyProvider.ts +0 -0
  462. /package/src/server/{providers → core/providers}/ServerProvider.ts +0 -0
  463. /package/src/server/{providers → core/providers}/ServerRouterProvider.ts +0 -0
  464. /package/src/server/{providers → core/providers}/ServerTimingProvider.ts +0 -0
  465. /package/src/server/{schemas → core/schemas}/errorSchema.ts +0 -0
  466. /package/src/server/{schemas → core/schemas}/okSchema.ts +0 -0
  467. /package/src/server/{services → core/services}/HttpClient.ts +0 -0
  468. /package/src/server/{services → core/services}/ServerRequestParser.ts +0 -0
  469. /package/src/server/{services → core/services}/UserAgentParser.ts +0 -0
  470. /package/src/{server-cors → server/cors}/index.ts +0 -0
  471. /package/src/{server-cors → server/cors}/primitives/$cors.ts +0 -0
  472. /package/src/{server-cors → server/cors}/providers/ServerCorsProvider.ts +0 -0
  473. /package/src/{server-health → server/health}/index.ts +0 -0
  474. /package/src/{server-health → server/health}/providers/ServerHealthProvider.ts +0 -0
  475. /package/src/{server-health → server/health}/schemas/healthSchema.ts +0 -0
  476. /package/src/{server-helmet → server/helmet}/index.ts +0 -0
  477. /package/src/{server-helmet → server/helmet}/providers/ServerHelmetProvider.ts +0 -0
  478. /package/src/{server-links → server/links}/index.browser.ts +0 -0
  479. /package/src/{server-links → server/links}/index.ts +0 -0
  480. /package/src/{server-links → server/links}/primitives/$client.ts +0 -0
  481. /package/src/{server-links → server/links}/primitives/$remote.ts +0 -0
  482. /package/src/{server-links → server/links}/providers/LinkProvider.ts +0 -0
  483. /package/src/{server-links → server/links}/providers/RemotePrimitiveProvider.ts +0 -0
  484. /package/src/{server-links → server/links}/providers/ServerLinksProvider.ts +0 -0
  485. /package/src/{server-links → server/links}/schemas/apiLinksResponseSchema.ts +0 -0
  486. /package/src/{server-metrics → server/metrics}/index.ts +0 -0
  487. /package/src/{server-metrics → server/metrics}/providers/ServerMetricsProvider.ts +0 -0
  488. /package/src/{server-multipart → server/multipart}/index.ts +0 -0
  489. /package/src/{server-multipart → server/multipart}/providers/ServerMultipartProvider.ts +0 -0
  490. /package/src/{server-proxy → server/proxy}/index.ts +0 -0
  491. /package/src/{server-proxy → server/proxy}/primitives/$proxy.ts +0 -0
  492. /package/src/{server-proxy → server/proxy}/providers/ServerProxyProvider.ts +0 -0
  493. /package/src/{server-rate-limit → server/rate-limit}/primitives/$rateLimit.ts +0 -0
  494. /package/src/{server-rate-limit → server/rate-limit}/providers/ServerRateLimitProvider.ts +0 -0
  495. /package/src/{server-security → server/security}/index.browser.ts +0 -0
  496. /package/src/{server-security → server/security}/index.ts +0 -0
  497. /package/src/{server-security → server/security}/primitives/$basicAuth.ts +0 -0
  498. /package/src/{server-security → server/security}/providers/ServerBasicAuthProvider.ts +0 -0
  499. /package/src/{server-security → server/security}/providers/ServerSecurityProvider.ts +0 -0
  500. /package/src/{server-static → server/static}/index.ts +0 -0
  501. /package/src/{server-static → server/static}/primitives/$serve.ts +0 -0
  502. /package/src/{server-static → server/static}/providers/ServerStaticProvider.ts +0 -0
  503. /package/src/{server-swagger → server/swagger}/index.ts +0 -0
  504. /package/src/{server-swagger → server/swagger}/primitives/$swagger.ts +0 -0
  505. /package/src/topic/{errors → core/errors}/TopicTimeoutError.ts +0 -0
  506. /package/src/topic/{index.ts → core/index.ts} +0 -0
  507. /package/src/topic/{primitives → core/primitives}/$subscriber.ts +0 -0
  508. /package/src/topic/{primitives → core/primitives}/$topic.ts +0 -0
  509. /package/src/topic/{providers → core/providers}/MemoryTopicProvider.ts +0 -0
  510. /package/src/topic/{providers → core/providers}/TopicProvider.ts +0 -0
  511. /package/src/{topic-redis → topic/redis}/index.ts +0 -0
  512. /package/src/{topic-redis → topic/redis}/providers/RedisTopicProvider.ts +0 -0
@@ -0,0 +1,548 @@
1
+ import * as alepha1 from "alepha";
2
+ import { Alepha, KIND, Primitive, Service, Static, TSchema } from "alepha";
3
+ import * as alepha_logger1 from "alepha/logger";
4
+ import { DateTimeProvider } from "alepha/datetime";
5
+
6
+ //#region ../../src/queue/core/providers/QueueProvider.d.ts
7
+ /**
8
+ * Minimalist Queue interface.
9
+ *
10
+ * Will be probably enhanced in the future to support more advanced features. But for now, it's enough!
11
+ */
12
+ declare abstract class QueueProvider {
13
+ /**
14
+ * Push a message to the queue.
15
+ *
16
+ * @param queue Name of the queue to push the message to.
17
+ * @param message String message to be pushed to the queue. Buffer messages are not supported for now.
18
+ */
19
+ abstract push(queue: string, message: string): Promise<void>;
20
+ /**
21
+ * Pop a message from the queue.
22
+ *
23
+ * @param queue Name of the queue to pop the message from.
24
+ *
25
+ * @returns The message popped or `undefined` if the queue is empty.
26
+ */
27
+ abstract pop(queue: string): Promise<string | undefined>;
28
+ }
29
+ //#endregion
30
+ //#region ../../src/queue/core/providers/MemoryQueueProvider.d.ts
31
+ declare class MemoryQueueProvider implements QueueProvider {
32
+ protected readonly log: alepha_logger1.Logger;
33
+ protected queueList: Record<string, string[]>;
34
+ push(queue: string, ...messages: string[]): Promise<void>;
35
+ pop(queue: string): Promise<string | undefined>;
36
+ }
37
+ //#endregion
38
+ //#region ../../src/queue/core/providers/WorkerProvider.d.ts
39
+ declare const envSchema: alepha1.TObject<{
40
+ /**
41
+ * The interval in milliseconds to wait before checking for new messages.
42
+ */
43
+ QUEUE_WORKER_INTERVAL: alepha1.TInteger;
44
+ /**
45
+ * The maximum interval in milliseconds to wait before checking for new messages.
46
+ */
47
+ QUEUE_WORKER_MAX_INTERVAL: alepha1.TInteger;
48
+ /**
49
+ * The number of workers to run concurrently. Defaults to 1.
50
+ * Useful only if you are doing a lot of I/O.
51
+ */
52
+ QUEUE_WORKER_CONCURRENCY: alepha1.TInteger;
53
+ }>;
54
+ declare module "alepha" {
55
+ interface Env extends Partial<Static<typeof envSchema>> {}
56
+ }
57
+ declare class WorkerProvider {
58
+ protected readonly log: alepha_logger1.Logger;
59
+ protected readonly env: {
60
+ QUEUE_WORKER_INTERVAL: number;
61
+ QUEUE_WORKER_MAX_INTERVAL: number;
62
+ QUEUE_WORKER_CONCURRENCY: number;
63
+ };
64
+ protected readonly alepha: Alepha;
65
+ protected readonly queueProvider: QueueProvider;
66
+ protected readonly dateTimeProvider: DateTimeProvider;
67
+ protected workerPromises: Array<Promise<void>>;
68
+ protected workersRunning: number;
69
+ protected abortController: AbortController;
70
+ protected workerIntervals: Record<number, number>;
71
+ protected consumers: Array<Consumer>;
72
+ get isRunning(): boolean;
73
+ protected readonly start: alepha1.HookPrimitive<"start">;
74
+ /**
75
+ * Start the workers.
76
+ * This method will create an endless loop that will check for new messages!
77
+ */
78
+ protected startWorkers(): void;
79
+ protected readonly stop: alepha1.HookPrimitive<"stop">;
80
+ /**
81
+ * Wait for the next message, where `n` is the worker number.
82
+ *
83
+ * This method will wait for a certain amount of time, increasing the wait time again if no message is found.
84
+ */
85
+ protected waitForNextMessage(n: number): Promise<void>;
86
+ /**
87
+ * Get the next message.
88
+ */
89
+ protected getNextMessage(): Promise<undefined | NextMessage>;
90
+ /**
91
+ * Process a message from a queue.
92
+ */
93
+ protected processMessage(response: {
94
+ message: any;
95
+ consumer: Consumer;
96
+ }): Promise<void>;
97
+ /**
98
+ * Stop the workers.
99
+ *
100
+ * This method will stop the workers and wait for them to finish processing.
101
+ */
102
+ protected stopWorkers(): Promise<void>;
103
+ /**
104
+ * Force the workers to get back to work.
105
+ */
106
+ wakeUp(): void;
107
+ }
108
+ interface Consumer<T extends TSchema = TSchema> {
109
+ queue: QueuePrimitive<T>;
110
+ handler: (message: QueueMessage<T>) => Promise<void>;
111
+ }
112
+ interface NextMessage {
113
+ consumer: Consumer;
114
+ message: string;
115
+ }
116
+ //#endregion
117
+ //#region ../../src/queue/core/primitives/$queue.d.ts
118
+ /**
119
+ * Creates a queue primitive for asynchronous message processing with background workers.
120
+ *
121
+ * The $queue primitive enables powerful asynchronous communication patterns in your application.
122
+ * It provides type-safe message queuing with automatic worker processing, making it perfect for
123
+ * decoupling components and handling background tasks efficiently.
124
+ *
125
+ * **Background Processing**
126
+ * - Automatic worker threads for non-blocking message processing
127
+ * - Built-in retry mechanisms and error handling
128
+ * - Dead letter queues for failed message handling
129
+ * - Graceful shutdown and worker lifecycle management
130
+ *
131
+ * **Type Safety**
132
+ * - Full TypeScript support with schema validation using TypeBox
133
+ * - Type-safe message payloads with automatic inference
134
+ * - Runtime validation of all queued messages
135
+ * - Compile-time errors for invalid message structures
136
+ *
137
+ * **Storage Flexibility**
138
+ * - Memory provider for development and testing
139
+ * - Redis provider for production scalability and persistence
140
+ * - Custom provider support for specialized backends
141
+ * - Automatic failover and connection pooling
142
+ *
143
+ * **Performance & Scalability**
144
+ * - Batch processing support for high-throughput scenarios
145
+ * - Horizontal scaling with distributed queue backends
146
+ * - Configurable concurrency and worker pools
147
+ * - Efficient serialization and message routing
148
+ *
149
+ * **Reliability**
150
+ * - Message persistence across application restarts
151
+ * - Automatic retry with exponential backoff
152
+ * - Dead letter handling for permanently failed messages
153
+ * - Comprehensive logging and monitoring integration
154
+ *
155
+ * @example Basic notification queue
156
+ * ```typescript
157
+ * const emailQueue = $queue({
158
+ * name: "email-notifications",
159
+ * schema: t.object({
160
+ * to: t.text(),
161
+ * subject: t.text(),
162
+ * body: t.text(),
163
+ * priority: t.optional(t.enum(["high", "normal"]))
164
+ * }),
165
+ * handler: async (message) => {
166
+ * await emailService.send(message.payload);
167
+ * console.log(`Email sent to ${message.payload.to}`);
168
+ * }
169
+ * });
170
+ *
171
+ * // Push messages for background processing
172
+ * await emailQueue.push({
173
+ * to: "user@example.com",
174
+ * subject: "Welcome!",
175
+ * body: "Welcome to our platform",
176
+ * priority: "high"
177
+ * });
178
+ * ```
179
+ *
180
+ * @example Batch processing with Redis
181
+ * ```typescript
182
+ * const imageQueue = $queue({
183
+ * name: "image-processing",
184
+ * provider: RedisQueueProvider,
185
+ * schema: t.object({
186
+ * imageId: t.text(),
187
+ * operations: t.array(t.enum(["resize", "compress", "thumbnail"]))
188
+ * }),
189
+ * handler: async (message) => {
190
+ * for (const op of message.payload.operations) {
191
+ * await processImage(message.payload.imageId, op);
192
+ * }
193
+ * }
194
+ * });
195
+ *
196
+ * // Batch processing multiple images
197
+ * await imageQueue.push(
198
+ * { imageId: "img1", operations: ["resize", "thumbnail"] },
199
+ * { imageId: "img2", operations: ["compress"] },
200
+ * { imageId: "img3", operations: ["resize", "compress", "thumbnail"] }
201
+ * );
202
+ * ```
203
+ *
204
+ * @example Development with memory provider
205
+ * ```typescript
206
+ * const taskQueue = $queue({
207
+ * name: "dev-tasks",
208
+ * provider: "memory",
209
+ * schema: t.object({
210
+ * taskType: t.enum(["cleanup", "backup", "report"]),
211
+ * data: t.record(t.text(), t.any())
212
+ * }),
213
+ * handler: async (message) => {
214
+ * switch (message.payload.taskType) {
215
+ * case "cleanup":
216
+ * await performCleanup(message.payload.data);
217
+ * break;
218
+ * case "backup":
219
+ * await createBackup(message.payload.data);
220
+ * break;
221
+ * case "report":
222
+ * await generateReport(message.payload.data);
223
+ * break;
224
+ * }
225
+ * }
226
+ * });
227
+ * ```
228
+ */
229
+ declare const $queue: {
230
+ <T extends TSchema>(options: QueuePrimitiveOptions<T>): QueuePrimitive<T>;
231
+ [KIND]: typeof QueuePrimitive;
232
+ };
233
+ interface QueuePrimitiveOptions<T extends TSchema> {
234
+ /**
235
+ * Unique name for the queue.
236
+ *
237
+ * This name is used for:
238
+ * - Queue identification across the system
239
+ * - Storage backend key generation
240
+ * - Logging and monitoring
241
+ * - Worker assignment and routing
242
+ *
243
+ * If not provided, defaults to the property key where the queue is declared.
244
+ *
245
+ * @example "email-notifications"
246
+ * @example "image-processing"
247
+ * @example "order-fulfillment"
248
+ */
249
+ name?: string;
250
+ /**
251
+ * Human-readable description of the queue's purpose.
252
+ *
253
+ * Used for:
254
+ * - Documentation generation
255
+ * - Monitoring dashboards
256
+ * - Development team communication
257
+ * - Queue management interfaces
258
+ *
259
+ * @example "Process user registration emails and welcome sequences"
260
+ * @example "Handle image uploads, resizing, and thumbnail generation"
261
+ * @example "Manage order processing, payment, and shipping workflows"
262
+ */
263
+ description?: string;
264
+ /**
265
+ * Queue storage provider configuration.
266
+ *
267
+ * Options:
268
+ * - **"memory"**: In-memory queue (default for development, lost on restart)
269
+ * - **Service<QueueProvider>**: Custom provider class (e.g., RedisQueueProvider)
270
+ * - **undefined**: Uses the default queue provider from dependency injection
271
+ *
272
+ * **Provider Selection Guidelines**:
273
+ * - Development: Use "memory" for fast, simple testing
274
+ * - Production: Use Redis or database-backed providers for persistence
275
+ * - High-throughput: Use specialized providers with connection pooling
276
+ * - Distributed systems: Use Redis or message brokers for scalability
277
+ *
278
+ * @default Uses injected QueueProvider
279
+ * @example "memory"
280
+ * @example RedisQueueProvider
281
+ * @example DatabaseQueueProvider
282
+ */
283
+ provider?: "memory" | Service<QueueProvider>;
284
+ /**
285
+ * TypeBox schema defining the structure of messages in this queue.
286
+ *
287
+ * This schema:
288
+ * - Validates all messages pushed to the queue
289
+ * - Provides full TypeScript type inference
290
+ * - Ensures type safety between producers and consumers
291
+ * - Enables automatic serialization/deserialization
292
+ *
293
+ * **Schema Design Best Practices**:
294
+ * - Keep schemas simple and focused on the specific task
295
+ * - Use optional fields for data that might not always be available
296
+ * - Include version fields for schema evolution
297
+ * - Use union types for different message types in the same queue
298
+ *
299
+ * @example
300
+ * ```ts
301
+ * t.object({
302
+ * userId: t.text(),
303
+ * action: t.enum(["create", "update"]),
304
+ * data: t.record(t.text(), t.any()),
305
+ * timestamp: t.optional(t.number())
306
+ * })
307
+ * ```
308
+ */
309
+ schema: T;
310
+ /**
311
+ * Message handler function that processes queue messages.
312
+ *
313
+ * This function:
314
+ * - Runs in background worker threads for non-blocking processing
315
+ * - Receives type-safe message payloads based on the schema
316
+ * - Should be idempotent to handle potential retries
317
+ * - Can throw errors to trigger retry mechanisms
318
+ * - Has access to the full Alepha dependency injection container
319
+ *
320
+ * **Handler Best Practices**:
321
+ * - Keep handlers focused on a single responsibility
322
+ * - Use proper error handling and logging
323
+ * - Make operations idempotent when possible
324
+ * - Validate critical business logic within handlers
325
+ * - Consider using transactions for data consistency
326
+ *
327
+ * @param message - The queue message with validated payload
328
+ * @returns Promise that resolves when processing is complete
329
+ *
330
+ * @example
331
+ * ```ts
332
+ * handler: async (message) => {
333
+ * const { userId, email, template } = message.payload;
334
+ *
335
+ * try {
336
+ * await this.emailService.send({
337
+ * to: email,
338
+ * template,
339
+ * data: { userId }
340
+ * });
341
+ *
342
+ * await this.userService.markEmailSent(userId, template);
343
+ * } catch (error) {
344
+ * // Log error and let the queue system handle retries
345
+ * this.logger.error(`Failed to send email to ${email}`, error);
346
+ * throw error;
347
+ * }
348
+ * }
349
+ * ```
350
+ */
351
+ handler?: (message: QueueMessage<T>) => Promise<void>;
352
+ }
353
+ declare class QueuePrimitive<T extends TSchema> extends Primitive<QueuePrimitiveOptions<T>> {
354
+ protected readonly log: alepha_logger1.Logger;
355
+ protected readonly workerProvider: WorkerProvider;
356
+ readonly provider: QueueProvider | MemoryQueueProvider;
357
+ push(...payloads: Array<Static<T>>): Promise<void>;
358
+ get name(): string;
359
+ protected $provider(): QueueProvider | MemoryQueueProvider;
360
+ }
361
+ interface QueueMessageSchema {
362
+ payload: TSchema;
363
+ }
364
+ interface QueueMessage<T extends TSchema> {
365
+ payload: Static<T>;
366
+ }
367
+ //#endregion
368
+ //#region ../../src/queue/core/primitives/$consumer.d.ts
369
+ /**
370
+ * Creates a consumer primitive to process messages from a specific queue.
371
+ *
372
+ * Provides a dedicated message consumer that connects to a queue and processes messages
373
+ * with custom handler logic, enabling scalable architectures where multiple consumers
374
+ * can process messages from the same queue.
375
+ *
376
+ * **Key Features**
377
+ * - Seamless integration with any $queue primitive
378
+ * - Full type safety inherited from queue schema
379
+ * - Automatic worker management for background processing
380
+ * - Built-in error handling and retry mechanisms
381
+ * - Support for multiple consumers per queue for horizontal scaling
382
+ *
383
+ * **Common Use Cases**
384
+ * - Email sending and notification services
385
+ * - Image and media processing workers
386
+ * - Data synchronization and background jobs
387
+ *
388
+ * @example
389
+ * ```ts
390
+ * class EmailService {
391
+ * emailQueue = $queue({
392
+ * name: "emails",
393
+ * schema: t.object({
394
+ * to: t.text(),
395
+ * subject: t.text(),
396
+ * body: t.text()
397
+ * })
398
+ * });
399
+ *
400
+ * emailConsumer = $consumer({
401
+ * queue: this.emailQueue,
402
+ * handler: async (message) => {
403
+ * const { to, subject, body } = message.payload;
404
+ * await this.sendEmail(to, subject, body);
405
+ * }
406
+ * });
407
+ *
408
+ * async sendWelcomeEmail(userEmail: string) {
409
+ * await this.emailQueue.push({
410
+ * to: userEmail,
411
+ * subject: "Welcome!",
412
+ * body: "Thanks for joining."
413
+ * });
414
+ * }
415
+ * }
416
+ * ```
417
+ */
418
+ declare const $consumer: {
419
+ <T extends TSchema>(options: ConsumerPrimitiveOptions<T>): ConsumerPrimitive<T>;
420
+ [KIND]: typeof ConsumerPrimitive;
421
+ };
422
+ interface ConsumerPrimitiveOptions<T extends TSchema> {
423
+ /**
424
+ * The queue primitive that this consumer will process messages from.
425
+ *
426
+ * This establishes the connection between the consumer and its source queue:
427
+ * - The consumer inherits the queue's message schema for type safety
428
+ * - Messages pushed to the queue will be automatically routed to this consumer
429
+ * - Multiple consumers can be attached to the same queue for parallel processing
430
+ * - The consumer will use the queue's provider and configuration settings
431
+ *
432
+ * **Queue Integration Benefits**:
433
+ * - Type safety: Consumer handler gets fully typed message payloads
434
+ * - Schema validation: Messages are validated before reaching the consumer
435
+ * - Error handling: Failed messages can be retried or moved to dead letter queues
436
+ * - Monitoring: Queue metrics include consumer processing statistics
437
+ *
438
+ * @example
439
+ * ```ts
440
+ * // First, define a queue
441
+ * emailQueue = $queue({
442
+ * name: "emails",
443
+ * schema: t.object({ to: t.text(), subject: t.text() })
444
+ * });
445
+ *
446
+ * // Then, create a consumer for that queue
447
+ * emailConsumer = $consumer({
448
+ * queue: this.emailQueue, // Reference the queue primitive
449
+ * handler: async (message) => { } // process email
450
+ * });
451
+ * ```
452
+ */
453
+ queue: QueuePrimitive<T>;
454
+ /**
455
+ * Message handler function that processes individual messages from the queue.
456
+ *
457
+ * This function:
458
+ * - Receives fully typed and validated message payloads from the connected queue
459
+ * - Runs in the background worker system for non-blocking operation
460
+ * - Should implement the core business logic for processing this message type
461
+ * - Can throw errors to trigger the queue's retry mechanisms
462
+ * - Has access to the full Alepha dependency injection container
463
+ * - Should be idempotent to handle potential duplicate deliveries
464
+ *
465
+ * **Handler Design Guidelines**:
466
+ * - Keep handlers focused on a single responsibility
467
+ * - Use proper error handling and meaningful error messages
468
+ * - Log important processing steps for debugging and monitoring
469
+ * - Consider transaction boundaries for data consistency
470
+ * - Make operations idempotent when possible
471
+ * - Validate business rules within the handler logic
472
+ *
473
+ * **Error Handling Strategy**:
474
+ * - Throw errors for temporary failures that should be retried
475
+ * - Log and handle permanent failures gracefully
476
+ * - Use specific error types to control retry behavior
477
+ * - Consider implementing circuit breakers for external service calls
478
+ *
479
+ * @param message - The queue message containing the validated payload
480
+ * @param message.payload - The typed message data based on the queue's schema
481
+ * @returns Promise that resolves when processing is complete
482
+ *
483
+ * @example
484
+ * ```ts
485
+ * handler: async (message) => {
486
+ * const { userId, action, data } = message.payload;
487
+ *
488
+ * try {
489
+ * // Log processing start
490
+ * this.logger.info(`Processing ${action} for user ${userId}`);
491
+ *
492
+ * // Validate business rules
493
+ * if (!await this.userService.exists(userId)) {
494
+ * throw new Error(`User ${userId} not found`);
495
+ * }
496
+ *
497
+ * // Perform the main processing logic
498
+ * switch (action) {
499
+ * case "create":
500
+ * await this.processCreation(userId, data);
501
+ * break;
502
+ * case "update":
503
+ * await this.processUpdate(userId, data);
504
+ * break;
505
+ * default:
506
+ * throw new Error(`Unknown action: ${action}`);
507
+ * }
508
+ *
509
+ * // Log successful completion
510
+ * this.logger.info(`Successfully processed ${action} for user ${userId}`);
511
+ *
512
+ * } catch (error) {
513
+ * // Log error with context
514
+ * this.logger.error(`Failed to process ${action} for user ${userId}`, {
515
+ * error: error.message,
516
+ * userId,
517
+ * action,
518
+ * data
519
+ * });
520
+ *
521
+ * // Re-throw to trigger queue retry mechanism
522
+ * throw error;
523
+ * }
524
+ * }
525
+ * ```
526
+ */
527
+ handler: (message: {
528
+ payload: Static<T>;
529
+ }) => Promise<void>;
530
+ }
531
+ declare class ConsumerPrimitive<T extends TSchema> extends Primitive<ConsumerPrimitiveOptions<T>> {}
532
+ //#endregion
533
+ //#region ../../src/queue/core/index.d.ts
534
+ /**
535
+ * Provides asynchronous message queuing and processing capabilities through declarative queue descriptors.
536
+ *
537
+ * The queue module enables reliable background job processing and message passing using the `$queue` descriptor
538
+ * on class properties. It supports schema validation, automatic retries, and multiple queue backends for
539
+ * building scalable, decoupled applications with robust error handling.
540
+ *
541
+ * @see {@link $queue}
542
+ * @see {@link $consumer}
543
+ * @module alepha.queue
544
+ */
545
+ declare const AlephaQueue: alepha1.Service<alepha1.Module>;
546
+ //#endregion
547
+ export { $consumer, $queue, AlephaQueue, Consumer, ConsumerPrimitive, ConsumerPrimitiveOptions, MemoryQueueProvider, NextMessage, QueueMessage, QueueMessageSchema, QueuePrimitive, QueuePrimitiveOptions, QueueProvider, WorkerProvider };
548
+ //# sourceMappingURL=index.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/queue/core/providers/QueueProvider.ts","../../../src/queue/core/providers/MemoryQueueProvider.ts","../../../src/queue/core/providers/WorkerProvider.ts","../../../src/queue/core/primitives/$queue.ts","../../../src/queue/core/primitives/$consumer.ts","../../../src/queue/core/index.ts"],"sourcesContent":[],"mappings":"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"}