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/router/providers/ReactServerTemplateProvider.ts ADDED
@@ -0,0 +1,542 @@
1
+ import { $inject, Alepha } from "alepha";
2
+ import { $logger } from "alepha/logger";
3
+ import { AlephaContext } from "alepha/react";
4
+ import type { SimpleHead } from "alepha/react/head";
5
+ import { createElement, type ReactNode } from "react";
6
+ import { renderToString } from "react-dom/server";
7
+ import ErrorViewer from "../components/ErrorViewer.tsx";
8
+ import { Redirection } from "../errors/Redirection.ts";
9
+ import type { ReactRouterState } from "./ReactPageProvider.ts";
10
+
11
+ /**
12
+ * Handles HTML streaming for SSR.
13
+ *
14
+ * Uses hardcoded HTML structure - all customization via $head primitive.
15
+ * Pre-encodes static parts as Uint8Array for zero-copy streaming.
16
+ */
17
+ export class ReactServerTemplateProvider {
18
+ protected readonly log = $logger();
19
+ protected readonly alepha = $inject(Alepha);
20
+
21
+ /**
22
+ * Shared TextEncoder - reused across all requests.
23
+ */
24
+ protected readonly encoder = new TextEncoder();
25
+
26
+ /**
27
+ * Pre-encoded static HTML parts for zero-copy streaming.
28
+ */
29
+ protected readonly SLOTS = {
30
+ DOCTYPE: this.encoder.encode("<!DOCTYPE html>\n"),
31
+ HTML_OPEN: this.encoder.encode("<html"),
32
+ HTML_CLOSE: this.encoder.encode(">\n"),
33
+ HEAD_OPEN: this.encoder.encode("<head>"),
34
+ HEAD_CLOSE: this.encoder.encode("</head>\n"),
35
+ BODY_OPEN: this.encoder.encode("<body"),
36
+ BODY_CLOSE: this.encoder.encode(">\n"),
37
+ ROOT_OPEN: this.encoder.encode('<div id="root">'),
38
+ ROOT_CLOSE: this.encoder.encode("</div>\n"),
39
+ BODY_HTML_CLOSE: this.encoder.encode("</body>\n</html>"),
40
+ HYDRATION_PREFIX: this.encoder.encode("<script>window.__ssr="),
41
+ HYDRATION_SUFFIX: this.encoder.encode("</script>"),
42
+ } as const;
43
+
44
+ /**
45
+ * Early head content (charset, viewport, entry assets).
46
+ * Set once during configuration, reused for all requests.
47
+ */
48
+ protected earlyHeadContent = "";
49
+
50
+ /**
51
+ * Root element ID for React mounting.
52
+ */
53
+ public readonly rootId = "root";
54
+
55
+ /**
56
+ * Regex for extracting root div content from HTML.
57
+ */
58
+ public readonly rootDivRegex = new RegExp(
59
+ `<div[^>]*\\s+id=["']${this.rootId}["'][^>]*>([\\s\\S]*?)<\\/div>`,
60
+ "i",
61
+ );
62
+
63
+ /**
64
+ * Extract content inside the root div from HTML.
65
+ */
66
+ public extractRootContent(html: string): string | undefined {
67
+ return html.match(this.rootDivRegex)?.[1];
68
+ }
69
+
70
+ /**
71
+ * Set early head content (charset, viewport, entry assets).
72
+ * Called once during server configuration.
73
+ */
74
+ public setEarlyHeadContent(
75
+ entryAssets: string,
76
+ globalHead?: SimpleHead,
77
+ ): void {
78
+ const charset = globalHead?.charset ?? "UTF-8";
79
+ const viewport =
80
+ globalHead?.viewport ?? "width=device-width, initial-scale=1";
81
+
82
+ this.earlyHeadContent =
83
+ `<meta charset="${this.escapeHtml(charset)}">\n` +
84
+ `<meta name="viewport" content="${this.escapeHtml(viewport)}">\n` +
85
+ entryAssets;
86
+ }
87
+
88
+ /**
89
+ * Render attributes record to HTML string.
90
+ */
91
+ public renderAttributes(attrs?: Record<string, string>): string {
92
+ if (!attrs) return "";
93
+ const entries = Object.entries(attrs);
94
+ if (entries.length === 0) return "";
95
+ return entries
96
+ .map(([key, value]) => ` ${key}="${this.escapeHtml(value)}"`)
97
+ .join("");
98
+ }
99
+
100
+ /**
101
+ * Render head content (title, meta, link, script tags).
102
+ */
103
+ public renderHeadContent(head?: SimpleHead): string {
104
+ if (!head) return "";
105
+
106
+ let content = "";
107
+
108
+ if (head.title) {
109
+ content += `<title>${this.escapeHtml(head.title)}</title>\n`;
110
+ }
111
+
112
+ if (head.meta) {
113
+ for (const meta of head.meta) {
114
+ if (meta.property) {
115
+ content += `<meta property="${this.escapeHtml(meta.property)}" content="${this.escapeHtml(meta.content)}">\n`;
116
+ } else if (meta.name) {
117
+ content += `<meta name="${this.escapeHtml(meta.name)}" content="${this.escapeHtml(meta.content)}">\n`;
118
+ }
119
+ }
120
+ }
121
+
122
+ if (head.link) {
123
+ for (const link of head.link) {
124
+ content += `<link rel="${this.escapeHtml(link.rel)}" href="${this.escapeHtml(link.href)}"`;
125
+ if (link.type) content += ` type="${this.escapeHtml(link.type)}"`;
126
+ if (link.as) content += ` as="${this.escapeHtml(link.as)}"`;
127
+ if (link.crossorigin != null) content += ' crossorigin=""';
128
+ content += ">\n";
129
+ }
130
+ }
131
+
132
+ if (head.script) {
133
+ for (const script of head.script) {
134
+ if (typeof script === "string") {
135
+ content += `<script>${script}</script>\n`;
136
+ } else {
137
+ const { content: scriptContent, ...rest } = script;
138
+ const attrs = Object.entries(rest)
139
+ .filter(([, v]) => v !== false && v !== undefined)
140
+ .map(([k, v]) =>
141
+ v === true ? k : `${k}="${this.escapeHtml(String(v))}"`,
142
+ )
143
+ .join(" ");
144
+ content += scriptContent
145
+ ? `<script ${attrs}>${scriptContent}</script>\n`
146
+ : `<script ${attrs}></script>\n`;
147
+ }
148
+ }
149
+ }
150
+
151
+ return content;
152
+ }
153
+
154
+ /**
155
+ * Escape HTML special characters.
156
+ */
157
+ public escapeHtml(str: string): string {
158
+ return str
159
+ .replace(/&/g, "&amp;")
160
+ .replace(/</g, "&lt;")
161
+ .replace(/>/g, "&gt;")
162
+ .replace(/"/g, "&quot;")
163
+ .replace(/'/g, "&#039;");
164
+ }
165
+
166
+ /**
167
+ * Safely serialize data to JSON for embedding in HTML.
168
+ */
169
+ public safeJsonSerialize(data: unknown): string {
170
+ return JSON.stringify(data)
171
+ .replace(/</g, "\\u003c")
172
+ .replace(/>/g, "\\u003e")
173
+ .replace(/&/g, "\\u0026");
174
+ }
175
+
176
+ /**
177
+ * Build hydration data from router state.
178
+ */
179
+ public buildHydrationData(state: ReactRouterState): HydrationData {
180
+ const { request, context, ...store } =
181
+ this.alepha.context.als?.getStore() ?? {};
182
+
183
+ const layers = state.layers.map((layer) => ({
184
+ part: layer.part,
185
+ name: layer.name,
186
+ config: layer.config,
187
+ props: layer.props,
188
+ error: layer.error
189
+ ? {
190
+ ...layer.error,
191
+ name: layer.error.name,
192
+ message: layer.error.message,
193
+ stack: !this.alepha.isProduction() ? layer.error.stack : undefined,
194
+ }
195
+ : undefined,
196
+ }));
197
+
198
+ const hydrationData: HydrationData = { layers };
199
+
200
+ for (const [key, value] of Object.entries(store)) {
201
+ if (
202
+ key.charAt(0) !== "_" &&
203
+ key !== "alepha.react.router.state" &&
204
+ key !== "registry"
205
+ ) {
206
+ hydrationData[key] = value;
207
+ }
208
+ }
209
+
210
+ return hydrationData;
211
+ }
212
+
213
+ // ---------------------------------------------------------------------------
214
+ // Core streaming methods
215
+ // ---------------------------------------------------------------------------
216
+
217
+ /**
218
+ * Pipe React stream to controller with backpressure handling.
219
+ * Returns true if stream completed successfully, false if error occurred.
220
+ */
221
+ protected async pipeReactStream(
222
+ controller: ReadableStreamDefaultController<Uint8Array>,
223
+ reactStream: ReadableStream<Uint8Array>,
224
+ state: ReactRouterState,
225
+ ): Promise<boolean> {
226
+ const reader = reactStream.getReader();
227
+
228
+ try {
229
+ while (true) {
230
+ // Backpressure: wait if buffer is full
231
+ if (controller.desiredSize !== null && controller.desiredSize <= 0) {
232
+ await new Promise<void>((resolve) => queueMicrotask(resolve));
233
+ }
234
+
235
+ const { done, value } = await reader.read();
236
+ if (done) break;
237
+ controller.enqueue(value);
238
+ }
239
+ return true;
240
+ } catch (error) {
241
+ this.log.error("React stream error", error);
242
+ controller.enqueue(
243
+ this.encoder.encode(
244
+ this.renderErrorToString(
245
+ error instanceof Error ? error : new Error(String(error)),
246
+ state,
247
+ ),
248
+ ),
249
+ );
250
+ return false;
251
+ } finally {
252
+ reader.releaseLock();
253
+ }
254
+ }
255
+
256
+ /**
257
+ * Stream complete HTML document (head already closed).
258
+ * Used by both createHtmlStream and late phase of createEarlyHtmlStream.
259
+ */
260
+ protected async streamBodyAndClose(
261
+ controller: ReadableStreamDefaultController<Uint8Array>,
262
+ reactStream: ReadableStream<Uint8Array>,
263
+ state: ReactRouterState,
264
+ hydration: boolean,
265
+ ): Promise<void> {
266
+ const { encoder, SLOTS: slots } = this;
267
+
268
+ // Body open
269
+ controller.enqueue(slots.BODY_OPEN);
270
+ controller.enqueue(
271
+ encoder.encode(this.renderAttributes(state.head?.bodyAttributes)),
272
+ );
273
+ controller.enqueue(slots.BODY_CLOSE);
274
+
275
+ // Root + React content
276
+ controller.enqueue(slots.ROOT_OPEN);
277
+ await this.pipeReactStream(controller, reactStream, state);
278
+ controller.enqueue(slots.ROOT_CLOSE);
279
+
280
+ // Hydration
281
+ if (hydration) {
282
+ controller.enqueue(slots.HYDRATION_PREFIX);
283
+ controller.enqueue(
284
+ encoder.encode(this.safeJsonSerialize(this.buildHydrationData(state))),
285
+ );
286
+ controller.enqueue(slots.HYDRATION_SUFFIX);
287
+ }
288
+
289
+ controller.enqueue(slots.BODY_HTML_CLOSE);
290
+ }
291
+
292
+ // ---------------------------------------------------------------------------
293
+ // Public streaming APIs
294
+ // ---------------------------------------------------------------------------
295
+
296
+ /**
297
+ * Create HTML stream with early head optimization.
298
+ *
299
+ * Flow:
300
+ * 1. Send DOCTYPE, <html>, <head> open, entry preloads (IMMEDIATE)
301
+ * 2. Run async work (page loaders)
302
+ * 3. Send rest of head, body, React content, hydration
303
+ */
304
+ public createEarlyHtmlStream(
305
+ globalHead: SimpleHead,
306
+ asyncWork: () => Promise<
307
+ | { state: ReactRouterState; reactStream: ReadableStream<Uint8Array> }
308
+ | { redirect: string }
309
+ | null
310
+ >,
311
+ options: {
312
+ hydration?: boolean;
313
+ onError?: (error: unknown) => void;
314
+ } = {},
315
+ ): ReadableStream<Uint8Array> {
316
+ const { hydration = true, onError } = options;
317
+ const { encoder, SLOTS: slots } = this;
318
+
319
+ let headClosed = false;
320
+ let bodyStarted = false;
321
+ let routerState: ReactRouterState | undefined;
322
+
323
+ return new ReadableStream<Uint8Array>({
324
+ start: async (controller) => {
325
+ try {
326
+ // === EARLY PHASE (before async work) ===
327
+ controller.enqueue(slots.DOCTYPE);
328
+ controller.enqueue(slots.HTML_OPEN);
329
+ controller.enqueue(
330
+ encoder.encode(this.renderAttributes(globalHead?.htmlAttributes)),
331
+ );
332
+ controller.enqueue(slots.HTML_CLOSE);
333
+ controller.enqueue(slots.HEAD_OPEN);
334
+ if (this.earlyHeadContent) {
335
+ controller.enqueue(encoder.encode(this.earlyHeadContent));
336
+ }
337
+
338
+ // === ASYNC WORK ===
339
+ const result = await asyncWork();
340
+
341
+ // Handle redirect
342
+ if (!result || "redirect" in result) {
343
+ if (result && "redirect" in result) {
344
+ this.log.debug("Loader redirect, using meta refresh", {
345
+ redirect: result.redirect,
346
+ });
347
+ controller.enqueue(
348
+ encoder.encode(
349
+ `<meta http-equiv="refresh" content="0; url=${this.escapeHtml(result.redirect)}">\n`,
350
+ ),
351
+ );
352
+ }
353
+ controller.enqueue(slots.HEAD_CLOSE);
354
+ controller.enqueue(encoder.encode("<body></body></html>"));
355
+ controller.close();
356
+ return;
357
+ }
358
+
359
+ const { state, reactStream } = result;
360
+ routerState = state;
361
+
362
+ // === LATE PHASE (after async work) ===
363
+ controller.enqueue(
364
+ encoder.encode(this.renderHeadContent(state.head)),
365
+ );
366
+ controller.enqueue(slots.HEAD_CLOSE);
367
+ headClosed = true;
368
+ bodyStarted = true;
369
+
370
+ await this.streamBodyAndClose(
371
+ controller,
372
+ reactStream,
373
+ state,
374
+ hydration,
375
+ );
376
+ controller.close();
377
+ } catch (error) {
378
+ onError?.(error);
379
+ try {
380
+ this.injectErrorHtml(controller, error, routerState, {
381
+ headClosed,
382
+ bodyStarted,
383
+ });
384
+ controller.close();
385
+ } catch {
386
+ controller.error(error);
387
+ }
388
+ }
389
+ },
390
+ });
391
+ }
392
+
393
+ /**
394
+ * Create HTML stream (non-early version, for testing/prerender).
395
+ */
396
+ public createHtmlStream(
397
+ reactStream: ReadableStream<Uint8Array>,
398
+ state: ReactRouterState,
399
+ options: { hydration?: boolean; onError?: (error: unknown) => void } = {},
400
+ ): ReadableStream<Uint8Array> {
401
+ const { hydration = true, onError } = options;
402
+ const { encoder, SLOTS: slots } = this;
403
+
404
+ return new ReadableStream<Uint8Array>({
405
+ start: async (controller) => {
406
+ try {
407
+ // Head
408
+ controller.enqueue(slots.DOCTYPE);
409
+ controller.enqueue(slots.HTML_OPEN);
410
+ controller.enqueue(
411
+ encoder.encode(this.renderAttributes(state.head?.htmlAttributes)),
412
+ );
413
+ controller.enqueue(slots.HTML_CLOSE);
414
+ controller.enqueue(slots.HEAD_OPEN);
415
+ if (this.earlyHeadContent) {
416
+ controller.enqueue(encoder.encode(this.earlyHeadContent));
417
+ }
418
+ controller.enqueue(
419
+ encoder.encode(this.renderHeadContent(state.head)),
420
+ );
421
+ controller.enqueue(slots.HEAD_CLOSE);
422
+
423
+ // Body (shared logic)
424
+ await this.streamBodyAndClose(
425
+ controller,
426
+ reactStream,
427
+ state,
428
+ hydration,
429
+ );
430
+ controller.close();
431
+ } catch (error) {
432
+ onError?.(error);
433
+ controller.error(error);
434
+ }
435
+ },
436
+ });
437
+ }
438
+
439
+ // ---------------------------------------------------------------------------
440
+ // Error handling
441
+ // ---------------------------------------------------------------------------
442
+
443
+ /**
444
+ * Inject error HTML when streaming fails.
445
+ */
446
+ protected injectErrorHtml(
447
+ controller: ReadableStreamDefaultController<Uint8Array>,
448
+ error: unknown,
449
+ routerState: ReactRouterState | undefined,
450
+ streamState: { headClosed: boolean; bodyStarted: boolean },
451
+ ): void {
452
+ const { encoder, SLOTS: slots } = this;
453
+
454
+ if (!streamState.headClosed) {
455
+ controller.enqueue(
456
+ encoder.encode(this.renderHeadContent(routerState?.head)),
457
+ );
458
+ controller.enqueue(slots.HEAD_CLOSE);
459
+ }
460
+
461
+ if (!streamState.bodyStarted) {
462
+ controller.enqueue(slots.BODY_OPEN);
463
+ controller.enqueue(
464
+ encoder.encode(
465
+ this.renderAttributes(routerState?.head?.bodyAttributes),
466
+ ),
467
+ );
468
+ controller.enqueue(slots.BODY_CLOSE);
469
+ controller.enqueue(slots.ROOT_OPEN);
470
+ }
471
+
472
+ controller.enqueue(
473
+ encoder.encode(
474
+ this.renderErrorToString(
475
+ error instanceof Error ? error : new Error(String(error)),
476
+ routerState,
477
+ ),
478
+ ),
479
+ );
480
+
481
+ controller.enqueue(slots.ROOT_CLOSE);
482
+ controller.enqueue(slots.BODY_HTML_CLOSE);
483
+ }
484
+
485
+ /**
486
+ * Render error to HTML string.
487
+ */
488
+ protected renderErrorToString(
489
+ error: Error,
490
+ routerState: ReactRouterState | undefined,
491
+ ): string {
492
+ this.log.error("SSR rendering error", error);
493
+
494
+ let errorElement: ReactNode;
495
+
496
+ if (routerState?.onError) {
497
+ try {
498
+ const result = routerState.onError(error, routerState);
499
+ if (result instanceof Redirection) {
500
+ this.log.warn("Error handler returned Redirection but headers sent", {
501
+ redirect: result.redirect,
502
+ });
503
+ } else if (result != null) {
504
+ errorElement = result;
505
+ }
506
+ } catch (handlerError) {
507
+ this.log.error("Error handler threw", handlerError);
508
+ }
509
+ }
510
+
511
+ if (!errorElement) {
512
+ errorElement = createElement(ErrorViewer, {
513
+ error,
514
+ alepha: this.alepha,
515
+ });
516
+ }
517
+
518
+ const wrappedElement = createElement(
519
+ AlephaContext.Provider,
520
+ { value: this.alepha },
521
+ errorElement,
522
+ );
523
+
524
+ try {
525
+ return renderToString(wrappedElement);
526
+ } catch (renderError) {
527
+ this.log.error("Failed to render error component", renderError);
528
+ return error.message;
529
+ }
530
+ }
531
+ }
532
+
533
+ /**
534
+ * Hydration state serialized to window.__ssr
535
+ */
536
+ export interface HydrationData {
537
+ layers: Array<{
538
+ data?: unknown;
539
+ error?: { name: string; message: string; stack?: string };
540
+ }>;
541
+ [key: string]: unknown;
542
+ }