alepha 0.15.1 → 0.15.3

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 (523) hide show
  1. package/README.md +68 -80
  2. package/dist/api/audits/index.d.ts +10 -33
  3. package/dist/api/audits/index.d.ts.map +1 -1
  4. package/dist/api/audits/index.js +10 -33
  5. package/dist/api/audits/index.js.map +1 -1
  6. package/dist/api/files/index.d.ts +10 -3
  7. package/dist/api/files/index.d.ts.map +1 -1
  8. package/dist/api/files/index.js +10 -3
  9. package/dist/api/files/index.js.map +1 -1
  10. package/dist/api/jobs/index.d.ts +162 -155
  11. package/dist/api/jobs/index.d.ts.map +1 -1
  12. package/dist/api/jobs/index.js +10 -3
  13. package/dist/api/jobs/index.js.map +1 -1
  14. package/dist/api/keys/index.d.ts +413 -0
  15. package/dist/api/keys/index.d.ts.map +1 -0
  16. package/dist/api/keys/index.js +476 -0
  17. package/dist/api/keys/index.js.map +1 -0
  18. package/dist/api/notifications/index.d.ts +10 -4
  19. package/dist/api/notifications/index.d.ts.map +1 -1
  20. package/dist/api/notifications/index.js +10 -4
  21. package/dist/api/notifications/index.js.map +1 -1
  22. package/dist/api/parameters/index.d.ts +43 -50
  23. package/dist/api/parameters/index.d.ts.map +1 -1
  24. package/dist/api/parameters/index.js +30 -37
  25. package/dist/api/parameters/index.js.map +1 -1
  26. package/dist/api/users/index.d.ts +1081 -760
  27. package/dist/api/users/index.d.ts.map +1 -1
  28. package/dist/api/users/index.js +2539 -218
  29. package/dist/api/users/index.js.map +1 -1
  30. package/dist/api/verifications/index.d.ts +138 -132
  31. package/dist/api/verifications/index.d.ts.map +1 -1
  32. package/dist/api/verifications/index.js +12 -4
  33. package/dist/api/verifications/index.js.map +1 -1
  34. package/dist/batch/index.d.ts +20 -40
  35. package/dist/batch/index.d.ts.map +1 -1
  36. package/dist/batch/index.js +31 -44
  37. package/dist/batch/index.js.map +1 -1
  38. package/dist/bucket/index.d.ts +440 -8
  39. package/dist/bucket/index.d.ts.map +1 -1
  40. package/dist/bucket/index.js +1861 -12
  41. package/dist/bucket/index.js.map +1 -1
  42. package/dist/cache/core/index.d.ts +179 -7
  43. package/dist/cache/core/index.d.ts.map +1 -1
  44. package/dist/cache/core/index.js +213 -7
  45. package/dist/cache/core/index.js.map +1 -1
  46. package/dist/cache/redis/index.d.ts +1 -0
  47. package/dist/cache/redis/index.d.ts.map +1 -1
  48. package/dist/cache/redis/index.js +4 -0
  49. package/dist/cache/redis/index.js.map +1 -1
  50. package/dist/cli/index.d.ts +638 -5645
  51. package/dist/cli/index.d.ts.map +1 -1
  52. package/dist/cli/index.js +2550 -368
  53. package/dist/cli/index.js.map +1 -1
  54. package/dist/command/index.d.ts +203 -45
  55. package/dist/command/index.d.ts.map +1 -1
  56. package/dist/command/index.js +2060 -71
  57. package/dist/command/index.js.map +1 -1
  58. package/dist/core/index.browser.js +70 -40
  59. package/dist/core/index.browser.js.map +1 -1
  60. package/dist/core/index.d.ts +34 -13
  61. package/dist/core/index.d.ts.map +1 -1
  62. package/dist/core/index.js +90 -40
  63. package/dist/core/index.js.map +1 -1
  64. package/dist/core/index.native.js +70 -40
  65. package/dist/core/index.native.js.map +1 -1
  66. package/dist/datetime/index.d.ts +15 -0
  67. package/dist/datetime/index.d.ts.map +1 -1
  68. package/dist/datetime/index.js +15 -0
  69. package/dist/datetime/index.js.map +1 -1
  70. package/dist/email/index.d.ts +323 -20
  71. package/dist/email/index.d.ts.map +1 -1
  72. package/dist/email/index.js +1857 -7
  73. package/dist/email/index.js.map +1 -1
  74. package/dist/fake/index.d.ts +90 -8
  75. package/dist/fake/index.d.ts.map +1 -1
  76. package/dist/fake/index.js +91 -20
  77. package/dist/fake/index.js.map +1 -1
  78. package/dist/lock/core/index.d.ts +11 -4
  79. package/dist/lock/core/index.d.ts.map +1 -1
  80. package/dist/lock/core/index.js +11 -4
  81. package/dist/lock/core/index.js.map +1 -1
  82. package/dist/logger/index.d.ts +17 -66
  83. package/dist/logger/index.d.ts.map +1 -1
  84. package/dist/logger/index.js +14 -63
  85. package/dist/logger/index.js.map +1 -1
  86. package/dist/mcp/index.d.ts +10 -30
  87. package/dist/mcp/index.d.ts.map +1 -1
  88. package/dist/mcp/index.js +12 -35
  89. package/dist/mcp/index.js.map +1 -1
  90. package/dist/orm/index.browser.js +3 -3
  91. package/dist/orm/index.browser.js.map +1 -1
  92. package/dist/orm/index.bun.js +39 -20
  93. package/dist/orm/index.bun.js.map +1 -1
  94. package/dist/orm/index.d.ts +517 -540
  95. package/dist/orm/index.d.ts.map +1 -1
  96. package/dist/orm/index.js +58 -71
  97. package/dist/orm/index.js.map +1 -1
  98. package/dist/queue/core/index.d.ts +18 -10
  99. package/dist/queue/core/index.d.ts.map +1 -1
  100. package/dist/queue/core/index.js +14 -6
  101. package/dist/queue/core/index.js.map +1 -1
  102. package/dist/react/auth/index.browser.js +108 -0
  103. package/dist/react/auth/index.browser.js.map +1 -0
  104. package/dist/react/auth/index.d.ts +100 -0
  105. package/dist/react/auth/index.d.ts.map +1 -0
  106. package/dist/react/auth/index.js +145 -0
  107. package/dist/react/auth/index.js.map +1 -0
  108. package/dist/react/core/index.d.ts +469 -0
  109. package/dist/react/core/index.d.ts.map +1 -0
  110. package/dist/react/core/index.js +464 -0
  111. package/dist/react/core/index.js.map +1 -0
  112. package/dist/react/form/index.d.ts +232 -0
  113. package/dist/react/form/index.d.ts.map +1 -0
  114. package/dist/react/form/index.js +432 -0
  115. package/dist/react/form/index.js.map +1 -0
  116. package/dist/react/head/index.browser.js +423 -0
  117. package/dist/react/head/index.browser.js.map +1 -0
  118. package/dist/react/head/index.d.ts +288 -0
  119. package/dist/react/head/index.d.ts.map +1 -0
  120. package/dist/react/head/index.js +465 -0
  121. package/dist/react/head/index.js.map +1 -0
  122. package/dist/react/i18n/index.d.ts +175 -0
  123. package/dist/react/i18n/index.d.ts.map +1 -0
  124. package/dist/react/i18n/index.js +224 -0
  125. package/dist/react/i18n/index.js.map +1 -0
  126. package/dist/react/router/index.browser.js +1974 -0
  127. package/dist/react/router/index.browser.js.map +1 -0
  128. package/dist/react/router/index.d.ts +1956 -0
  129. package/dist/react/router/index.d.ts.map +1 -0
  130. package/dist/react/router/index.js +4722 -0
  131. package/dist/react/router/index.js.map +1 -0
  132. package/dist/react/websocket/index.d.ts +117 -0
  133. package/dist/react/websocket/index.d.ts.map +1 -0
  134. package/dist/react/websocket/index.js +107 -0
  135. package/dist/react/websocket/index.js.map +1 -0
  136. package/dist/redis/index.bun.js +4 -0
  137. package/dist/redis/index.bun.js.map +1 -1
  138. package/dist/redis/index.d.ts +41 -44
  139. package/dist/redis/index.d.ts.map +1 -1
  140. package/dist/redis/index.js +16 -25
  141. package/dist/redis/index.js.map +1 -1
  142. package/dist/retry/index.d.ts +11 -2
  143. package/dist/retry/index.d.ts.map +1 -1
  144. package/dist/retry/index.js +11 -2
  145. package/dist/retry/index.js.map +1 -1
  146. package/dist/scheduler/index.d.ts +11 -2
  147. package/dist/scheduler/index.d.ts.map +1 -1
  148. package/dist/scheduler/index.js +11 -2
  149. package/dist/scheduler/index.js.map +1 -1
  150. package/dist/security/index.d.ts +140 -49
  151. package/dist/security/index.d.ts.map +1 -1
  152. package/dist/security/index.js +164 -32
  153. package/dist/security/index.js.map +1 -1
  154. package/dist/server/auth/index.d.ts +12 -7
  155. package/dist/server/auth/index.d.ts.map +1 -1
  156. package/dist/server/auth/index.js +12 -7
  157. package/dist/server/auth/index.js.map +1 -1
  158. package/dist/server/cache/index.d.ts +7 -22
  159. package/dist/server/cache/index.d.ts.map +1 -1
  160. package/dist/server/cache/index.js +7 -22
  161. package/dist/server/cache/index.js.map +1 -1
  162. package/dist/server/compress/index.d.ts +10 -2
  163. package/dist/server/compress/index.d.ts.map +1 -1
  164. package/dist/server/compress/index.js +10 -2
  165. package/dist/server/compress/index.js.map +1 -1
  166. package/dist/server/cookies/index.d.ts +40 -16
  167. package/dist/server/cookies/index.d.ts.map +1 -1
  168. package/dist/server/cookies/index.js +7 -5
  169. package/dist/server/cookies/index.js.map +1 -1
  170. package/dist/server/core/index.d.ts +124 -23
  171. package/dist/server/core/index.d.ts.map +1 -1
  172. package/dist/server/core/index.js +231 -14
  173. package/dist/server/core/index.js.map +1 -1
  174. package/dist/server/cors/index.d.ts +13 -23
  175. package/dist/server/cors/index.d.ts.map +1 -1
  176. package/dist/server/cors/index.js +7 -21
  177. package/dist/server/cors/index.js.map +1 -1
  178. package/dist/server/health/index.d.ts +8 -2
  179. package/dist/server/health/index.d.ts.map +1 -1
  180. package/dist/server/health/index.js +8 -2
  181. package/dist/server/health/index.js.map +1 -1
  182. package/dist/server/helmet/index.d.ts +11 -3
  183. package/dist/server/helmet/index.d.ts.map +1 -1
  184. package/dist/server/helmet/index.js +11 -3
  185. package/dist/server/helmet/index.js.map +1 -1
  186. package/dist/server/links/index.d.ts +11 -6
  187. package/dist/server/links/index.d.ts.map +1 -1
  188. package/dist/server/links/index.js +11 -6
  189. package/dist/server/links/index.js.map +1 -1
  190. package/dist/server/metrics/index.d.ts +10 -3
  191. package/dist/server/metrics/index.d.ts.map +1 -1
  192. package/dist/server/metrics/index.js +10 -3
  193. package/dist/server/metrics/index.js.map +1 -1
  194. package/dist/server/multipart/index.d.ts +9 -3
  195. package/dist/server/multipart/index.d.ts.map +1 -1
  196. package/dist/server/multipart/index.js +9 -3
  197. package/dist/server/multipart/index.js.map +1 -1
  198. package/dist/server/proxy/index.d.ts +8 -2
  199. package/dist/server/proxy/index.d.ts.map +1 -1
  200. package/dist/server/proxy/index.js +8 -2
  201. package/dist/server/proxy/index.js.map +1 -1
  202. package/dist/server/rate-limit/index.d.ts +30 -35
  203. package/dist/server/rate-limit/index.d.ts.map +1 -1
  204. package/dist/server/rate-limit/index.js +18 -55
  205. package/dist/server/rate-limit/index.js.map +1 -1
  206. package/dist/server/static/index.d.ts +137 -4
  207. package/dist/server/static/index.d.ts.map +1 -1
  208. package/dist/server/static/index.js +1853 -5
  209. package/dist/server/static/index.js.map +1 -1
  210. package/dist/server/swagger/index.d.ts +309 -6
  211. package/dist/server/swagger/index.d.ts.map +1 -1
  212. package/dist/server/swagger/index.js +1854 -6
  213. package/dist/server/swagger/index.js.map +1 -1
  214. package/dist/sms/index.d.ts +309 -7
  215. package/dist/sms/index.d.ts.map +1 -1
  216. package/dist/sms/index.js +1856 -7
  217. package/dist/sms/index.js.map +1 -1
  218. package/dist/system/index.browser.js +1218 -0
  219. package/dist/system/index.browser.js.map +1 -0
  220. package/dist/{file → system}/index.d.ts +343 -16
  221. package/dist/system/index.d.ts.map +1 -0
  222. package/dist/{file → system}/index.js +419 -22
  223. package/dist/system/index.js.map +1 -0
  224. package/dist/thread/index.d.ts +11 -2
  225. package/dist/thread/index.d.ts.map +1 -1
  226. package/dist/thread/index.js +11 -2
  227. package/dist/thread/index.js.map +1 -1
  228. package/dist/topic/core/index.d.ts +12 -5
  229. package/dist/topic/core/index.d.ts.map +1 -1
  230. package/dist/topic/core/index.js +12 -5
  231. package/dist/topic/core/index.js.map +1 -1
  232. package/dist/vite/index.d.ts +5 -6272
  233. package/dist/vite/index.d.ts.map +1 -1
  234. package/dist/vite/index.js +23 -10
  235. package/dist/vite/index.js.map +1 -1
  236. package/dist/websocket/index.d.ts +12 -8
  237. package/dist/websocket/index.d.ts.map +1 -1
  238. package/dist/websocket/index.js +12 -8
  239. package/dist/websocket/index.js.map +1 -1
  240. package/package.json +82 -11
  241. package/src/api/audits/index.ts +10 -33
  242. package/src/api/files/__tests__/$bucket.spec.ts +1 -1
  243. package/src/api/files/controllers/AdminFileStatsController.spec.ts +1 -1
  244. package/src/api/files/controllers/FileController.spec.ts +1 -1
  245. package/src/api/files/index.ts +10 -3
  246. package/src/api/files/jobs/FileJobs.spec.ts +1 -1
  247. package/src/api/files/services/FileService.spec.ts +1 -1
  248. package/src/api/jobs/index.ts +10 -3
  249. package/src/api/keys/controllers/AdminApiKeyController.ts +75 -0
  250. package/src/api/keys/controllers/ApiKeyController.ts +103 -0
  251. package/src/api/keys/entities/apiKeyEntity.ts +41 -0
  252. package/src/api/keys/index.ts +49 -0
  253. package/src/api/keys/schemas/adminApiKeyQuerySchema.ts +7 -0
  254. package/src/api/keys/schemas/adminApiKeyResourceSchema.ts +17 -0
  255. package/src/api/keys/schemas/createApiKeyBodySchema.ts +7 -0
  256. package/src/api/keys/schemas/createApiKeyResponseSchema.ts +11 -0
  257. package/src/api/keys/schemas/listApiKeyResponseSchema.ts +15 -0
  258. package/src/api/keys/schemas/revokeApiKeyParamsSchema.ts +5 -0
  259. package/src/api/keys/schemas/revokeApiKeyResponseSchema.ts +5 -0
  260. package/src/api/keys/services/ApiKeyService.spec.ts +553 -0
  261. package/src/api/keys/services/ApiKeyService.ts +306 -0
  262. package/src/api/logs/TODO.md +55 -0
  263. package/src/api/notifications/index.ts +10 -4
  264. package/src/api/parameters/index.ts +9 -30
  265. package/src/api/parameters/primitives/$config.ts +12 -4
  266. package/src/api/parameters/services/ConfigStore.ts +9 -3
  267. package/src/api/users/__tests__/ApiKeys-integration.spec.ts +1035 -0
  268. package/src/api/users/__tests__/ApiKeys.spec.ts +401 -0
  269. package/src/api/users/index.ts +14 -3
  270. package/src/api/users/primitives/$realm.ts +33 -5
  271. package/src/api/users/providers/RealmProvider.ts +1 -12
  272. package/src/api/users/services/SessionService.ts +1 -1
  273. package/src/api/verifications/controllers/VerificationController.ts +2 -0
  274. package/src/api/verifications/index.ts +10 -4
  275. package/src/batch/index.ts +9 -36
  276. package/src/batch/primitives/$batch.ts +0 -8
  277. package/src/batch/providers/BatchProvider.ts +29 -2
  278. package/src/bucket/__tests__/shared.ts +1 -1
  279. package/src/bucket/index.ts +13 -6
  280. package/src/bucket/primitives/$bucket.ts +1 -1
  281. package/src/bucket/providers/LocalFileStorageProvider.ts +1 -1
  282. package/src/bucket/providers/MemoryFileStorageProvider.ts +1 -1
  283. package/src/cache/core/__tests__/shared.ts +30 -0
  284. package/src/cache/core/index.ts +11 -6
  285. package/src/cache/core/primitives/$cache.spec.ts +5 -0
  286. package/src/cache/core/providers/CacheProvider.ts +17 -0
  287. package/src/cache/core/providers/MemoryCacheProvider.ts +300 -1
  288. package/src/cache/redis/__tests__/cache-redis.spec.ts +5 -0
  289. package/src/cache/redis/providers/RedisCacheProvider.ts +9 -0
  290. package/src/cli/apps/AlephaCli.ts +1 -14
  291. package/src/cli/apps/AlephaPackageBuilderCli.ts +10 -1
  292. package/src/cli/atoms/buildOptions.ts +99 -9
  293. package/src/cli/commands/build.ts +150 -37
  294. package/src/cli/commands/db.ts +22 -18
  295. package/src/cli/commands/deploy.ts +1 -1
  296. package/src/cli/commands/dev.ts +1 -20
  297. package/src/cli/commands/gen/env.ts +5 -2
  298. package/src/cli/commands/gen/openapi.ts +5 -2
  299. package/src/cli/commands/init.spec.ts +588 -0
  300. package/src/cli/commands/init.ts +115 -58
  301. package/src/cli/commands/lint.ts +7 -1
  302. package/src/cli/commands/typecheck.ts +11 -0
  303. package/src/cli/providers/AppEntryProvider.ts +1 -1
  304. package/src/cli/providers/ViteBuildProvider.ts +8 -50
  305. package/src/cli/providers/ViteDevServerProvider.ts +35 -16
  306. package/src/cli/services/AlephaCliUtils.ts +52 -121
  307. package/src/cli/services/PackageManagerUtils.ts +129 -11
  308. package/src/cli/services/ProjectScaffolder.spec.ts +97 -0
  309. package/src/cli/services/ProjectScaffolder.ts +148 -81
  310. package/src/cli/services/ViteUtils.ts +82 -0
  311. package/src/cli/{assets/claudeMd.ts → templates/agentMd.ts} +37 -24
  312. package/src/cli/templates/apiAppSecurityTs.ts +11 -0
  313. package/src/cli/templates/apiIndexTs.ts +30 -0
  314. package/src/cli/templates/gitignore.ts +39 -0
  315. package/src/cli/{assets → templates}/mainCss.ts +11 -2
  316. package/src/cli/templates/mainServerTs.ts +33 -0
  317. package/src/cli/templates/webAppRouterTs.ts +74 -0
  318. package/src/cli/templates/webHelloComponentTsx.ts +30 -0
  319. package/src/command/helpers/Runner.spec.ts +139 -0
  320. package/src/command/helpers/Runner.ts +7 -22
  321. package/src/command/index.ts +12 -4
  322. package/src/command/providers/CliProvider.spec.ts +1392 -0
  323. package/src/command/providers/CliProvider.ts +320 -47
  324. package/src/core/Alepha.ts +34 -27
  325. package/src/core/__tests__/Alepha-start.spec.ts +4 -4
  326. package/src/core/helpers/jsonSchemaToTypeBox.spec.ts +771 -0
  327. package/src/core/helpers/jsonSchemaToTypeBox.ts +62 -10
  328. package/src/core/index.shared.ts +1 -0
  329. package/src/core/index.ts +20 -0
  330. package/src/core/providers/EventManager.spec.ts +0 -71
  331. package/src/core/providers/EventManager.ts +3 -15
  332. package/src/core/providers/Json.ts +2 -14
  333. package/src/datetime/index.ts +15 -0
  334. package/src/email/index.ts +10 -5
  335. package/src/email/providers/LocalEmailProvider.spec.ts +1 -1
  336. package/src/email/providers/LocalEmailProvider.ts +1 -1
  337. package/src/fake/__tests__/keyName.example.ts +1 -1
  338. package/src/fake/__tests__/keyName.spec.ts +5 -5
  339. package/src/fake/index.ts +9 -6
  340. package/src/fake/providers/FakeProvider.spec.ts +258 -40
  341. package/src/fake/providers/FakeProvider.ts +133 -19
  342. package/src/lock/core/index.ts +11 -4
  343. package/src/logger/index.ts +17 -66
  344. package/src/mcp/index.ts +10 -27
  345. package/src/mcp/transports/SseMcpTransport.ts +0 -11
  346. package/src/orm/__tests__/PostgresProvider.spec.ts +2 -2
  347. package/src/orm/index.browser.ts +2 -2
  348. package/src/orm/index.bun.ts +5 -3
  349. package/src/orm/index.ts +23 -53
  350. package/src/orm/providers/drivers/BunSqliteProvider.ts +5 -1
  351. package/src/orm/providers/drivers/CloudflareD1Provider.ts +57 -30
  352. package/src/orm/providers/drivers/DatabaseProvider.ts +9 -1
  353. package/src/orm/providers/drivers/NodeSqliteProvider.ts +4 -1
  354. package/src/orm/services/Repository.ts +7 -3
  355. package/src/queue/core/index.ts +14 -6
  356. package/src/react/auth/__tests__/$auth.spec.ts +202 -0
  357. package/src/react/auth/hooks/useAuth.ts +32 -0
  358. package/src/react/auth/index.browser.ts +13 -0
  359. package/src/react/auth/index.shared.ts +2 -0
  360. package/src/react/auth/index.ts +48 -0
  361. package/src/react/auth/providers/ReactAuthProvider.ts +16 -0
  362. package/src/react/auth/services/ReactAuth.ts +135 -0
  363. package/src/react/core/__tests__/Router.spec.tsx +169 -0
  364. package/src/react/core/components/ClientOnly.tsx +49 -0
  365. package/src/react/core/components/ErrorBoundary.tsx +73 -0
  366. package/src/react/core/contexts/AlephaContext.ts +7 -0
  367. package/src/react/core/contexts/AlephaProvider.tsx +42 -0
  368. package/src/react/core/hooks/useAction.browser.spec.tsx +569 -0
  369. package/src/react/core/hooks/useAction.ts +480 -0
  370. package/src/react/core/hooks/useAlepha.ts +26 -0
  371. package/src/react/core/hooks/useClient.ts +17 -0
  372. package/src/react/core/hooks/useEvents.ts +51 -0
  373. package/src/react/core/hooks/useInject.ts +12 -0
  374. package/src/react/core/hooks/useStore.ts +52 -0
  375. package/src/react/core/index.ts +90 -0
  376. package/src/react/form/components/FormState.tsx +17 -0
  377. package/src/react/form/errors/FormValidationError.ts +18 -0
  378. package/src/react/form/hooks/useForm.browser.spec.tsx +366 -0
  379. package/src/react/form/hooks/useForm.ts +47 -0
  380. package/src/react/form/hooks/useFormState.ts +130 -0
  381. package/src/react/form/index.ts +44 -0
  382. package/src/react/form/services/FormModel.ts +614 -0
  383. package/src/react/head/helpers/SeoExpander.spec.ts +203 -0
  384. package/src/react/head/helpers/SeoExpander.ts +142 -0
  385. package/src/react/head/hooks/useHead.spec.tsx +288 -0
  386. package/src/react/head/hooks/useHead.ts +62 -0
  387. package/src/react/head/index.browser.ts +26 -0
  388. package/src/react/head/index.ts +44 -0
  389. package/src/react/head/interfaces/Head.ts +105 -0
  390. package/src/react/head/primitives/$head.ts +25 -0
  391. package/src/react/head/providers/BrowserHeadProvider.browser.spec.ts +196 -0
  392. package/src/react/head/providers/BrowserHeadProvider.ts +212 -0
  393. package/src/react/head/providers/HeadProvider.ts +168 -0
  394. package/src/react/head/providers/ServerHeadProvider.ts +31 -0
  395. package/src/react/i18n/__tests__/integration.spec.tsx +239 -0
  396. package/src/react/i18n/components/Localize.spec.tsx +357 -0
  397. package/src/react/i18n/components/Localize.tsx +35 -0
  398. package/src/react/i18n/hooks/useI18n.browser.spec.tsx +438 -0
  399. package/src/react/i18n/hooks/useI18n.ts +18 -0
  400. package/src/react/i18n/index.ts +41 -0
  401. package/src/react/i18n/primitives/$dictionary.ts +69 -0
  402. package/src/react/i18n/providers/I18nProvider.spec.ts +389 -0
  403. package/src/react/i18n/providers/I18nProvider.ts +278 -0
  404. package/src/react/router/__tests__/page-head-browser.browser.spec.ts +95 -0
  405. package/src/react/router/__tests__/page-head.spec.ts +48 -0
  406. package/src/react/router/__tests__/seo-head.spec.ts +125 -0
  407. package/src/react/router/atoms/ssrManifestAtom.ts +58 -0
  408. package/src/react/router/components/ErrorViewer.tsx +872 -0
  409. package/src/react/router/components/Link.tsx +23 -0
  410. package/src/react/router/components/NestedView.tsx +223 -0
  411. package/src/react/router/components/NotFound.tsx +30 -0
  412. package/src/react/router/constants/PAGE_PRELOAD_KEY.ts +6 -0
  413. package/src/react/router/contexts/RouterLayerContext.ts +12 -0
  414. package/src/react/router/errors/Redirection.ts +28 -0
  415. package/src/react/router/hooks/useActive.ts +52 -0
  416. package/src/react/router/hooks/useQueryParams.ts +63 -0
  417. package/src/react/router/hooks/useRouter.ts +20 -0
  418. package/src/react/router/hooks/useRouterState.ts +11 -0
  419. package/src/react/router/index.browser.ts +45 -0
  420. package/src/react/router/index.shared.ts +19 -0
  421. package/src/react/router/index.ts +146 -0
  422. package/src/react/router/primitives/$page.browser.spec.tsx +851 -0
  423. package/src/react/router/primitives/$page.spec.tsx +676 -0
  424. package/src/react/router/primitives/$page.ts +489 -0
  425. package/src/react/router/providers/ReactBrowserProvider.ts +312 -0
  426. package/src/react/router/providers/ReactBrowserRendererProvider.ts +25 -0
  427. package/src/react/router/providers/ReactBrowserRouterProvider.ts +168 -0
  428. package/src/react/router/providers/ReactPageProvider.ts +726 -0
  429. package/src/react/router/providers/ReactPreloadProvider.spec.ts +142 -0
  430. package/src/react/router/providers/ReactPreloadProvider.ts +85 -0
  431. package/src/react/router/providers/ReactServerProvider.spec.tsx +316 -0
  432. package/src/react/router/providers/ReactServerProvider.ts +487 -0
  433. package/src/react/router/providers/ReactServerTemplateProvider.spec.ts +210 -0
  434. package/src/react/router/providers/ReactServerTemplateProvider.ts +542 -0
  435. package/src/react/router/providers/SSRManifestProvider.ts +334 -0
  436. package/src/react/router/services/ReactPageServerService.ts +48 -0
  437. package/src/react/router/services/ReactPageService.ts +27 -0
  438. package/src/react/router/services/ReactRouter.ts +262 -0
  439. package/src/react/websocket/hooks/useRoom.tsx +242 -0
  440. package/src/react/websocket/index.ts +7 -0
  441. package/src/redis/__tests__/redis.spec.ts +13 -0
  442. package/src/redis/index.ts +9 -25
  443. package/src/redis/providers/BunRedisProvider.ts +9 -0
  444. package/src/redis/providers/NodeRedisProvider.ts +8 -0
  445. package/src/redis/providers/RedisProvider.ts +16 -0
  446. package/src/retry/index.ts +11 -2
  447. package/src/router/index.ts +15 -0
  448. package/src/scheduler/index.ts +11 -2
  449. package/src/security/__tests__/BasicAuth.spec.ts +2 -0
  450. package/src/security/__tests__/ServerSecurityProvider.spec.ts +90 -5
  451. package/src/security/index.ts +15 -10
  452. package/src/security/interfaces/IssuerResolver.ts +27 -0
  453. package/src/security/primitives/$issuer.ts +55 -0
  454. package/src/security/providers/SecurityProvider.ts +179 -0
  455. package/src/security/providers/ServerBasicAuthProvider.ts +6 -2
  456. package/src/security/providers/ServerSecurityProvider.ts +63 -41
  457. package/src/server/auth/index.ts +12 -7
  458. package/src/server/cache/index.ts +7 -22
  459. package/src/server/compress/index.ts +10 -2
  460. package/src/server/cookies/index.ts +7 -5
  461. package/src/server/cookies/primitives/$cookie.ts +33 -11
  462. package/src/server/core/index.ts +16 -6
  463. package/src/server/core/interfaces/ServerRequest.ts +83 -1
  464. package/src/server/core/primitives/$action.spec.ts +1 -1
  465. package/src/server/core/primitives/$action.ts +8 -3
  466. package/src/server/core/providers/NodeHttpServerProvider.spec.ts +9 -3
  467. package/src/server/core/providers/NodeHttpServerProvider.ts +9 -3
  468. package/src/server/core/services/ServerRequestParser.spec.ts +520 -0
  469. package/src/server/core/services/ServerRequestParser.ts +306 -13
  470. package/src/server/cors/index.ts +7 -21
  471. package/src/server/cors/primitives/$cors.ts +6 -2
  472. package/src/server/health/index.ts +8 -2
  473. package/src/server/helmet/index.ts +11 -3
  474. package/src/server/links/index.ts +11 -6
  475. package/src/server/metrics/index.ts +10 -3
  476. package/src/server/multipart/index.ts +9 -3
  477. package/src/server/proxy/index.ts +8 -2
  478. package/src/server/rate-limit/index.ts +21 -25
  479. package/src/server/rate-limit/primitives/$rateLimit.ts +6 -2
  480. package/src/server/rate-limit/providers/ServerRateLimitProvider.spec.ts +38 -14
  481. package/src/server/rate-limit/providers/ServerRateLimitProvider.ts +22 -56
  482. package/src/server/static/index.ts +8 -2
  483. package/src/server/static/providers/ServerStaticProvider.ts +1 -1
  484. package/src/server/swagger/index.ts +9 -4
  485. package/src/server/swagger/providers/ServerSwaggerProvider.ts +1 -1
  486. package/src/sms/index.ts +9 -5
  487. package/src/sms/providers/LocalSmsProvider.spec.ts +1 -1
  488. package/src/sms/providers/LocalSmsProvider.ts +1 -1
  489. package/src/system/index.browser.ts +36 -0
  490. package/src/system/index.ts +62 -0
  491. package/src/system/index.workerd.ts +1 -0
  492. package/src/{file → system}/providers/FileSystemProvider.ts +24 -0
  493. package/src/{file → system}/providers/MemoryFileSystemProvider.ts +116 -3
  494. package/src/system/providers/MemoryShellProvider.ts +164 -0
  495. package/src/{file → system}/providers/NodeFileSystemProvider.spec.ts +2 -2
  496. package/src/{file → system}/providers/NodeFileSystemProvider.ts +47 -2
  497. package/src/system/providers/NodeShellProvider.ts +184 -0
  498. package/src/system/providers/ShellProvider.ts +74 -0
  499. package/src/{file → system}/services/FileDetector.spec.ts +2 -2
  500. package/src/thread/index.ts +11 -2
  501. package/src/topic/core/index.ts +12 -5
  502. package/src/vite/tasks/buildClient.ts +2 -7
  503. package/src/vite/tasks/buildServer.ts +19 -13
  504. package/src/vite/tasks/generateCloudflare.ts +10 -7
  505. package/src/vite/tasks/generateDocker.ts +4 -0
  506. package/src/websocket/index.ts +12 -8
  507. package/dist/file/index.d.ts.map +0 -1
  508. package/dist/file/index.js.map +0 -1
  509. package/src/cli/assets/apiIndexTs.ts +0 -16
  510. package/src/cli/assets/mainServerTs.ts +0 -24
  511. package/src/cli/assets/webAppRouterTs.ts +0 -16
  512. package/src/cli/assets/webHelloComponentTsx.ts +0 -20
  513. package/src/cli/providers/ViteTemplateProvider.ts +0 -27
  514. package/src/file/index.ts +0 -43
  515. /package/src/cli/{assets → templates}/apiHelloControllerTs.ts +0 -0
  516. /package/src/cli/{assets → templates}/biomeJson.ts +0 -0
  517. /package/src/cli/{assets → templates}/dummySpecTs.ts +0 -0
  518. /package/src/cli/{assets → templates}/editorconfig.ts +0 -0
  519. /package/src/cli/{assets → templates}/mainBrowserTs.ts +0 -0
  520. /package/src/cli/{assets → templates}/tsconfigJson.ts +0 -0
  521. /package/src/cli/{assets → templates}/webIndexTs.ts +0 -0
  522. /package/src/{file → system}/errors/FileError.ts +0 -0
  523. /package/src/{file → system}/services/FileDetector.ts +0 -0
package/src/react/head/providers/HeadProvider.ts ADDED
@@ -0,0 +1,168 @@
1
+ import { $inject } from "alepha";
2
+ import { $logger } from "alepha/logger";
3
+ import { SeoExpander } from "../helpers/SeoExpander.ts";
4
+ import type { Head } from "../interfaces/Head.ts";
5
+
6
+ /**
7
+ * Provides methods to fill and merge head information into the application state.
8
+ *
9
+ * Used both on server and client side to manage document head.
10
+ *
11
+ * @see {@link SeoExpander}
12
+ * @see {@link ServerHeadProvider}
13
+ * @see {@link BrowserHeadProvider}
14
+ */
15
+ export class HeadProvider {
16
+ protected readonly log = $logger();
17
+ protected readonly seoExpander = $inject(SeoExpander);
18
+
19
+ public global?: Array<Head | (() => Head)> = [];
20
+
21
+ /**
22
+ * Track if we've warned about page-level htmlAttributes to avoid spam.
23
+ */
24
+ protected warnedAboutHtmlAttributes = false;
25
+
26
+ /**
27
+ * Resolve global head configuration (from $head primitives only).
28
+ *
29
+ * This is used to get htmlAttributes early, before page loaders run.
30
+ * Only htmlAttributes from global $head are allowed; page-level htmlAttributes
31
+ * are ignored for early streaming optimization.
32
+ *
33
+ * @returns Merged global head with htmlAttributes
34
+ */
35
+ public resolveGlobalHead(): Head {
36
+ const head: Head = {};
37
+
38
+ for (const h of this.global ?? []) {
39
+ const resolved = typeof h === "function" ? h() : h;
40
+ if (resolved.htmlAttributes) {
41
+ head.htmlAttributes = {
42
+ ...head.htmlAttributes,
43
+ ...resolved.htmlAttributes,
44
+ };
45
+ }
46
+ }
47
+
48
+ return head;
49
+ }
50
+
51
+ public fillHead(state: HeadState) {
52
+ state.head = {
53
+ ...state.head,
54
+ };
55
+
56
+ for (const h of this.global ?? []) {
57
+ const head = typeof h === "function" ? h() : h;
58
+ this.mergeHead(state, head);
59
+ }
60
+
61
+ for (const layer of state.layers) {
62
+ if (layer.route?.head && !layer.error) {
63
+ this.fillHeadByPage(layer.route, state, layer.props ?? {});
64
+ }
65
+ }
66
+ }
67
+
68
+ protected mergeHead(state: HeadState, head: Head): void {
69
+ // Expand SEO fields into meta tags
70
+ const { meta, link } = this.seoExpander.expand(head);
71
+ state.head = {
72
+ ...state.head,
73
+ ...head,
74
+ meta: [...(state.head.meta ?? []), ...meta, ...(head.meta ?? [])],
75
+ link: [...(state.head.link ?? []), ...link, ...(head.link ?? [])],
76
+ script: [...(state.head.script ?? []), ...(head.script ?? [])],
77
+ };
78
+ }
79
+
80
+ protected fillHeadByPage(
81
+ page: HeadRoute,
82
+ state: HeadState,
83
+ props: Record<string, any>,
84
+ ): void {
85
+ if (!page.head) {
86
+ return;
87
+ }
88
+
89
+ state.head ??= {};
90
+
91
+ const head =
92
+ typeof page.head === "function"
93
+ ? page.head(props, state.head)
94
+ : page.head;
95
+
96
+ // Expand SEO fields into meta tags
97
+ const { meta, link } = this.seoExpander.expand(head);
98
+ state.head.meta = [...(state.head.meta ?? []), ...meta];
99
+ state.head.link = [...(state.head.link ?? []), ...link];
100
+
101
+ if (head.title) {
102
+ state.head ??= {};
103
+
104
+ if (state.head.titleSeparator) {
105
+ state.head.title = `${head.title}${state.head.titleSeparator}${state.head.title}`;
106
+ } else {
107
+ state.head.title = head.title;
108
+ }
109
+
110
+ state.head.titleSeparator = head.titleSeparator;
111
+ }
112
+
113
+ // htmlAttributes from pages are ignored for early streaming optimization.
114
+ // Only global $head can set htmlAttributes.
115
+ if (head.htmlAttributes && !this.warnedAboutHtmlAttributes) {
116
+ this.warnedAboutHtmlAttributes = true;
117
+ this.log.warn(
118
+ "Page-level htmlAttributes are ignored. Use global $head() for htmlAttributes instead, " +
119
+ "as they are sent before page loaders run for early streaming optimization.",
120
+ );
121
+ }
122
+
123
+ if (head.bodyAttributes) {
124
+ state.head.bodyAttributes = {
125
+ ...state.head.bodyAttributes,
126
+ ...head.bodyAttributes,
127
+ };
128
+ }
129
+
130
+ if (head.meta) {
131
+ state.head.meta = [...(state.head.meta ?? []), ...(head.meta ?? [])];
132
+ }
133
+
134
+ if (head.link) {
135
+ state.head.link = [...(state.head.link ?? []), ...(head.link ?? [])];
136
+ }
137
+
138
+ if (head.script) {
139
+ state.head.script = [
140
+ ...(state.head.script ?? []),
141
+ ...(head.script ?? []),
142
+ ];
143
+ }
144
+ }
145
+ }
146
+
147
+ // ---------------------------------------------------------------------------------------------------------------------
148
+
149
+ /**
150
+ * Minimal route interface for head processing.
151
+ * Avoids circular dependency with alepha/react/router.
152
+ */
153
+ interface HeadRoute {
154
+ head?: Head | ((props: Record<string, any>, previous?: Head) => Head);
155
+ }
156
+
157
+ /**
158
+ * Minimal state interface for head processing.
159
+ * Avoids circular dependency with alepha/react/router.
160
+ */
161
+ interface HeadState {
162
+ head: Head;
163
+ layers: Array<{
164
+ route?: HeadRoute;
165
+ props?: Record<string, any>;
166
+ error?: Error;
167
+ }>;
168
+ }
package/src/react/head/providers/ServerHeadProvider.ts ADDED
@@ -0,0 +1,31 @@
1
+ import { $inject } from "alepha";
2
+ import type { Head, SimpleHead } from "../interfaces/Head.ts";
3
+ import { HeadProvider } from "./HeadProvider.ts";
4
+
5
+ /**
6
+ * Server-side head provider that fills head content from route configurations.
7
+ *
8
+ * Used by ReactServerProvider to collect title, meta tags, and other head
9
+ * elements which are then rendered by ReactServerTemplateProvider.
10
+ */
11
+ export class ServerHeadProvider {
12
+ protected readonly headProvider = $inject(HeadProvider);
13
+
14
+ /**
15
+ * Resolve global head configuration (htmlAttributes only).
16
+ *
17
+ * Used for early streaming optimization - htmlAttributes can be sent
18
+ * before page loaders run since they come from global $head only.
19
+ */
20
+ public resolveGlobalHead(): Head {
21
+ return this.headProvider.resolveGlobalHead();
22
+ }
23
+
24
+ /**
25
+ * Fill head state from route configurations.
26
+ * Delegates to HeadProvider to merge head data from all route layers.
27
+ */
28
+ public fillHead(state: { head: SimpleHead; layers: Array<any> }): void {
29
+ this.headProvider.fillHead(state as any);
30
+ }
31
+ }
package/src/react/i18n/__tests__/integration.spec.tsx ADDED
@@ -0,0 +1,239 @@
1
+ import { Alepha } from "alepha";
2
+ import { describe, test } from "vitest";
3
+ import { AlephaReactI18n } from "../index.ts";
4
+ import { $dictionary } from "../primitives/$dictionary.ts";
5
+ import { I18nProvider } from "../providers/I18nProvider.ts";
6
+
7
+ describe("I18n Integration Tests", () => {
8
+ test("should lazy load dictionaries on server start", async ({ expect }) => {
9
+ let enLoaded = false;
10
+ let frLoaded = false;
11
+
12
+ class App {
13
+ en = $dictionary({
14
+ lazy: async () => {
15
+ enLoaded = true;
16
+ return { default: { hello: "Hello" } };
17
+ },
18
+ });
19
+
20
+ fr = $dictionary({
21
+ lazy: async () => {
22
+ frLoaded = true;
23
+ return { default: { hello: "Bonjour" } };
24
+ },
25
+ });
26
+ }
27
+
28
+ const alepha = Alepha.create().with(AlephaReactI18n);
29
+ const app = alepha.inject(App);
30
+
31
+ expect(enLoaded).toBe(false);
32
+ expect(frLoaded).toBe(false);
33
+
34
+ await alepha.start();
35
+
36
+ expect(enLoaded).toBe(true);
37
+ expect(frLoaded).toBe(true);
38
+ });
39
+
40
+ test("should share I18nProvider instance across application", async ({
41
+ expect,
42
+ }) => {
43
+ class App {
44
+ en = $dictionary({
45
+ lazy: async () => ({ default: { key: "value" } }),
46
+ });
47
+ }
48
+
49
+ const alepha = Alepha.create().with(AlephaReactI18n);
50
+ const app = alepha.inject(App);
51
+
52
+ const i18n1 = alepha.inject(I18nProvider);
53
+ const i18n2 = alepha.inject(I18nProvider);
54
+
55
+ expect(i18n1).toBe(i18n2);
56
+ expect(i18n1.registry).toBe(i18n2.registry);
57
+ });
58
+
59
+ test("should support multiple dictionary registrations", async ({
60
+ expect,
61
+ }) => {
62
+ class App {
63
+ en = $dictionary({
64
+ lazy: async () => ({
65
+ default: {
66
+ "app.title": "My Application",
67
+ "app.subtitle": "Built with Alepha",
68
+ "auth.login": "Log In",
69
+ "auth.logout": "Log Out",
70
+ },
71
+ }),
72
+ });
73
+
74
+ fr = $dictionary({
75
+ lazy: async () => ({
76
+ default: {
77
+ "app.title": "Mon Application",
78
+ "app.subtitle": "Construit avec Alepha",
79
+ "auth.login": "Se connecter",
80
+ "auth.logout": "Se déconnecter",
81
+ },
82
+ }),
83
+ });
84
+ }
85
+
86
+ const alepha = Alepha.create().with(AlephaReactI18n);
87
+ const app = alepha.inject(App);
88
+ const i18n = alepha.inject(I18nProvider);
89
+
90
+ await alepha.start();
91
+
92
+ // Test English
93
+ expect(i18n.tr("app.title")).toBe("My Application");
94
+ expect(i18n.tr("app.subtitle")).toBe("Built with Alepha");
95
+ expect(i18n.tr("auth.login")).toBe("Log In");
96
+ expect(i18n.tr("auth.logout")).toBe("Log Out");
97
+
98
+ // Switch to French
99
+ await i18n.setLang("fr");
100
+
101
+ expect(i18n.tr("app.title")).toBe("Mon Application");
102
+ expect(i18n.tr("app.subtitle")).toBe("Construit avec Alepha");
103
+ expect(i18n.tr("auth.login")).toBe("Se connecter");
104
+ expect(i18n.tr("auth.logout")).toBe("Se déconnecter");
105
+ });
106
+
107
+ test("should handle translation with complex interpolation across languages", async ({
108
+ expect,
109
+ }) => {
110
+ class App {
111
+ en = $dictionary({
112
+ lazy: async () => ({
113
+ default: {
114
+ notification: "$1 sent you $2 message(s) about $3",
115
+ },
116
+ }),
117
+ });
118
+
119
+ fr = $dictionary({
120
+ lazy: async () => ({
121
+ default: {
122
+ notification: "$1 vous a envoyé $2 message(s) à propos de $3",
123
+ },
124
+ }),
125
+ });
126
+
127
+ es = $dictionary({
128
+ lazy: async () => ({
129
+ default: {
130
+ notification: "$1 te envió $2 mensaje(s) sobre $3",
131
+ },
132
+ }),
133
+ });
134
+ }
135
+
136
+ const alepha = Alepha.create().with(AlephaReactI18n);
137
+ const app = alepha.inject(App);
138
+ const i18n = alepha.inject(I18nProvider);
139
+
140
+ await alepha.start();
141
+
142
+ const args = ["John", "3", "your project"];
143
+
144
+ expect(i18n.tr("notification", { args })).toBe(
145
+ "John sent you 3 message(s) about your project",
146
+ );
147
+
148
+ await i18n.setLang("fr");
149
+ expect(i18n.tr("notification", { args })).toBe(
150
+ "John vous a envoyé 3 message(s) à propos de your project",
151
+ );
152
+
153
+ await i18n.setLang("es");
154
+ expect(i18n.tr("notification", { args })).toBe(
155
+ "John te envió 3 mensaje(s) sobre your project",
156
+ );
157
+ });
158
+
159
+ test("should properly cleanup on stop", async ({ expect }) => {
160
+ class App {
161
+ en = $dictionary({
162
+ lazy: async () => ({ default: { test: "Test" } }),
163
+ });
164
+ }
165
+
166
+ const alepha = Alepha.create().with(AlephaReactI18n);
167
+ const app = alepha.inject(App);
168
+ const i18n = alepha.inject(I18nProvider);
169
+
170
+ await alepha.start();
171
+ expect(i18n.registry[0].translations).toEqual({ test: "Test" });
172
+
173
+ await alepha.stop();
174
+ // Registry should still exist after stop
175
+ expect(i18n.registry).toBeDefined();
176
+ });
177
+
178
+ test("should work with empty language fallback chain", async ({ expect }) => {
179
+ class App {
180
+ en = $dictionary({
181
+ lazy: async () => ({ default: { only_en: "Only in English" } }),
182
+ });
183
+
184
+ fr = $dictionary({
185
+ lazy: async () => ({ default: { only_fr: "Seulement en français" } }),
186
+ });
187
+ }
188
+
189
+ const alepha = Alepha.create().with(AlephaReactI18n);
190
+ const app = alepha.inject(App);
191
+ const i18n = alepha.inject(I18nProvider);
192
+
193
+ await alepha.start();
194
+
195
+ // In English, can't find French-only key
196
+ expect(i18n.tr("only_fr")).toBe("only_fr");
197
+ expect(i18n.tr("only_en")).toBe("Only in English");
198
+
199
+ // In French, falls back to English for English-only key
200
+ await i18n.setLang("fr");
201
+ expect(i18n.tr("only_fr")).toBe("Seulement en français");
202
+ expect(i18n.tr("only_en")).toBe("Only in English");
203
+ });
204
+
205
+ test("should handle rapid language switches", async ({ expect }) => {
206
+ class App {
207
+ en = $dictionary({
208
+ lazy: async () => ({ default: { status: "Active" } }),
209
+ });
210
+
211
+ fr = $dictionary({
212
+ lazy: async () => ({ default: { status: "Actif" } }),
213
+ });
214
+
215
+ de = $dictionary({
216
+ lazy: async () => ({ default: { status: "Aktiv" } }),
217
+ });
218
+ }
219
+
220
+ const alepha = Alepha.create().with(AlephaReactI18n);
221
+ const app = alepha.inject(App);
222
+ const i18n = alepha.inject(I18nProvider);
223
+
224
+ await alepha.start();
225
+
226
+ // Rapidly switch languages
227
+ await i18n.setLang("fr");
228
+ expect(i18n.tr("status")).toBe("Actif");
229
+
230
+ await i18n.setLang("de");
231
+ expect(i18n.tr("status")).toBe("Aktiv");
232
+
233
+ await i18n.setLang("en");
234
+ expect(i18n.tr("status")).toBe("Active");
235
+
236
+ await i18n.setLang("fr");
237
+ expect(i18n.tr("status")).toBe("Actif");
238
+ });
239
+ });