alepha 0.15.0 → 0.15.2

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (551) hide show
  1. package/README.md +43 -98
  2. package/dist/api/audits/index.d.ts +630 -653
  3. package/dist/api/audits/index.d.ts.map +1 -1
  4. package/dist/api/audits/index.js +12 -35
  5. package/dist/api/audits/index.js.map +1 -1
  6. package/dist/api/files/index.d.ts +365 -358
  7. package/dist/api/files/index.d.ts.map +1 -1
  8. package/dist/api/files/index.js +12 -5
  9. package/dist/api/files/index.js.map +1 -1
  10. package/dist/api/jobs/index.d.ts +255 -248
  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.browser.js +4 -4
  19. package/dist/api/notifications/index.browser.js.map +1 -1
  20. package/dist/api/notifications/index.d.ts +84 -78
  21. package/dist/api/notifications/index.d.ts.map +1 -1
  22. package/dist/api/notifications/index.js +14 -8
  23. package/dist/api/notifications/index.js.map +1 -1
  24. package/dist/api/parameters/index.d.ts +528 -535
  25. package/dist/api/parameters/index.d.ts.map +1 -1
  26. package/dist/api/parameters/index.js +30 -37
  27. package/dist/api/parameters/index.js.map +1 -1
  28. package/dist/api/users/index.d.ts +1221 -910
  29. package/dist/api/users/index.d.ts.map +1 -1
  30. package/dist/api/users/index.js +2556 -248
  31. package/dist/api/users/index.js.map +1 -1
  32. package/dist/api/verifications/index.d.ts +142 -136
  33. package/dist/api/verifications/index.d.ts.map +1 -1
  34. package/dist/api/verifications/index.js +12 -4
  35. package/dist/api/verifications/index.js.map +1 -1
  36. package/dist/batch/index.d.ts +142 -162
  37. package/dist/batch/index.d.ts.map +1 -1
  38. package/dist/batch/index.js +31 -44
  39. package/dist/batch/index.js.map +1 -1
  40. package/dist/bucket/index.d.ts +595 -171
  41. package/dist/bucket/index.d.ts.map +1 -1
  42. package/dist/bucket/index.js +1856 -12
  43. package/dist/bucket/index.js.map +1 -1
  44. package/dist/cache/core/index.d.ts +225 -53
  45. package/dist/cache/core/index.d.ts.map +1 -1
  46. package/dist/cache/core/index.js +213 -7
  47. package/dist/cache/core/index.js.map +1 -1
  48. package/dist/cache/redis/index.d.ts +1 -0
  49. package/dist/cache/redis/index.d.ts.map +1 -1
  50. package/dist/cache/redis/index.js +6 -2
  51. package/dist/cache/redis/index.js.map +1 -1
  52. package/dist/cli/index.d.ts +834 -226
  53. package/dist/cli/index.d.ts.map +1 -1
  54. package/dist/cli/index.js +2872 -417
  55. package/dist/cli/index.js.map +1 -1
  56. package/dist/command/index.d.ts +458 -310
  57. package/dist/command/index.d.ts.map +1 -1
  58. package/dist/command/index.js +2011 -76
  59. package/dist/command/index.js.map +1 -1
  60. package/dist/core/index.browser.js +309 -97
  61. package/dist/core/index.browser.js.map +1 -1
  62. package/dist/core/index.d.ts +796 -701
  63. package/dist/core/index.d.ts.map +1 -1
  64. package/dist/core/index.js +329 -97
  65. package/dist/core/index.js.map +1 -1
  66. package/dist/core/index.native.js +309 -97
  67. package/dist/core/index.native.js.map +1 -1
  68. package/dist/datetime/index.d.ts +59 -44
  69. package/dist/datetime/index.d.ts.map +1 -1
  70. package/dist/datetime/index.js +15 -0
  71. package/dist/datetime/index.js.map +1 -1
  72. package/dist/email/index.d.ts +314 -19
  73. package/dist/email/index.d.ts.map +1 -1
  74. package/dist/email/index.js +1852 -7
  75. package/dist/email/index.js.map +1 -1
  76. package/dist/fake/index.d.ts +5500 -5418
  77. package/dist/fake/index.d.ts.map +1 -1
  78. package/dist/fake/index.js +113 -42
  79. package/dist/fake/index.js.map +1 -1
  80. package/dist/lock/core/index.d.ts +219 -212
  81. package/dist/lock/core/index.d.ts.map +1 -1
  82. package/dist/lock/core/index.js +11 -4
  83. package/dist/lock/core/index.js.map +1 -1
  84. package/dist/lock/redis/index.d.ts.map +1 -1
  85. package/dist/logger/index.d.ts +41 -90
  86. package/dist/logger/index.d.ts.map +1 -1
  87. package/dist/logger/index.js +15 -68
  88. package/dist/logger/index.js.map +1 -1
  89. package/dist/mcp/index.d.ts +228 -230
  90. package/dist/mcp/index.d.ts.map +1 -1
  91. package/dist/mcp/index.js +32 -31
  92. package/dist/mcp/index.js.map +1 -1
  93. package/dist/orm/index.browser.js +12 -12
  94. package/dist/orm/index.browser.js.map +1 -1
  95. package/dist/orm/index.bun.js +90 -80
  96. package/dist/orm/index.bun.js.map +1 -1
  97. package/dist/orm/index.d.ts +1434 -1459
  98. package/dist/orm/index.d.ts.map +1 -1
  99. package/dist/orm/index.js +112 -130
  100. package/dist/orm/index.js.map +1 -1
  101. package/dist/queue/core/index.d.ts +262 -254
  102. package/dist/queue/core/index.d.ts.map +1 -1
  103. package/dist/queue/core/index.js +14 -6
  104. package/dist/queue/core/index.js.map +1 -1
  105. package/dist/queue/redis/index.d.ts.map +1 -1
  106. package/dist/react/auth/index.browser.js +108 -0
  107. package/dist/react/auth/index.browser.js.map +1 -0
  108. package/dist/react/auth/index.d.ts +100 -0
  109. package/dist/react/auth/index.d.ts.map +1 -0
  110. package/dist/react/auth/index.js +145 -0
  111. package/dist/react/auth/index.js.map +1 -0
  112. package/dist/react/core/index.d.ts +469 -0
  113. package/dist/react/core/index.d.ts.map +1 -0
  114. package/dist/react/core/index.js +464 -0
  115. package/dist/react/core/index.js.map +1 -0
  116. package/dist/react/form/index.d.ts +232 -0
  117. package/dist/react/form/index.d.ts.map +1 -0
  118. package/dist/react/form/index.js +432 -0
  119. package/dist/react/form/index.js.map +1 -0
  120. package/dist/react/head/index.browser.js +423 -0
  121. package/dist/react/head/index.browser.js.map +1 -0
  122. package/dist/react/head/index.d.ts +288 -0
  123. package/dist/react/head/index.d.ts.map +1 -0
  124. package/dist/react/head/index.js +465 -0
  125. package/dist/react/head/index.js.map +1 -0
  126. package/dist/react/i18n/index.d.ts +175 -0
  127. package/dist/react/i18n/index.d.ts.map +1 -0
  128. package/dist/react/i18n/index.js +224 -0
  129. package/dist/react/i18n/index.js.map +1 -0
  130. package/dist/react/router/index.browser.js +1980 -0
  131. package/dist/react/router/index.browser.js.map +1 -0
  132. package/dist/react/router/index.d.ts +2068 -0
  133. package/dist/react/router/index.d.ts.map +1 -0
  134. package/dist/react/router/index.js +4932 -0
  135. package/dist/react/router/index.js.map +1 -0
  136. package/dist/react/websocket/index.d.ts +117 -0
  137. package/dist/react/websocket/index.d.ts.map +1 -0
  138. package/dist/react/websocket/index.js +107 -0
  139. package/dist/react/websocket/index.js.map +1 -0
  140. package/dist/redis/index.bun.js +4 -0
  141. package/dist/redis/index.bun.js.map +1 -1
  142. package/dist/redis/index.d.ts +127 -130
  143. package/dist/redis/index.d.ts.map +1 -1
  144. package/dist/redis/index.js +16 -25
  145. package/dist/redis/index.js.map +1 -1
  146. package/dist/retry/index.d.ts +80 -71
  147. package/dist/retry/index.d.ts.map +1 -1
  148. package/dist/retry/index.js +11 -2
  149. package/dist/retry/index.js.map +1 -1
  150. package/dist/router/index.d.ts +6 -6
  151. package/dist/router/index.d.ts.map +1 -1
  152. package/dist/scheduler/index.d.ts +119 -28
  153. package/dist/scheduler/index.d.ts.map +1 -1
  154. package/dist/scheduler/index.js +404 -3
  155. package/dist/scheduler/index.js.map +1 -1
  156. package/dist/security/index.d.ts +642 -228
  157. package/dist/security/index.d.ts.map +1 -1
  158. package/dist/security/index.js +1579 -37
  159. package/dist/security/index.js.map +1 -1
  160. package/dist/server/auth/index.d.ts +1141 -111
  161. package/dist/server/auth/index.d.ts.map +1 -1
  162. package/dist/server/auth/index.js +1261 -25
  163. package/dist/server/auth/index.js.map +1 -1
  164. package/dist/server/cache/index.d.ts +63 -78
  165. package/dist/server/cache/index.d.ts.map +1 -1
  166. package/dist/server/cache/index.js +7 -22
  167. package/dist/server/cache/index.js.map +1 -1
  168. package/dist/server/compress/index.d.ts +13 -5
  169. package/dist/server/compress/index.d.ts.map +1 -1
  170. package/dist/server/compress/index.js +10 -2
  171. package/dist/server/compress/index.js.map +1 -1
  172. package/dist/server/cookies/index.d.ts +46 -22
  173. package/dist/server/cookies/index.d.ts.map +1 -1
  174. package/dist/server/cookies/index.js +7 -5
  175. package/dist/server/cookies/index.js.map +1 -1
  176. package/dist/server/core/index.d.ts +307 -196
  177. package/dist/server/core/index.d.ts.map +1 -1
  178. package/dist/server/core/index.js +271 -38
  179. package/dist/server/core/index.js.map +1 -1
  180. package/dist/server/cors/index.d.ts +24 -34
  181. package/dist/server/cors/index.d.ts.map +1 -1
  182. package/dist/server/cors/index.js +7 -21
  183. package/dist/server/cors/index.js.map +1 -1
  184. package/dist/server/health/index.d.ts +25 -19
  185. package/dist/server/health/index.d.ts.map +1 -1
  186. package/dist/server/health/index.js +8 -2
  187. package/dist/server/health/index.js.map +1 -1
  188. package/dist/server/helmet/index.d.ts +13 -5
  189. package/dist/server/helmet/index.d.ts.map +1 -1
  190. package/dist/server/helmet/index.js +11 -3
  191. package/dist/server/helmet/index.js.map +1 -1
  192. package/dist/server/links/index.browser.js +9 -1
  193. package/dist/server/links/index.browser.js.map +1 -1
  194. package/dist/server/links/index.d.ts +133 -128
  195. package/dist/server/links/index.d.ts.map +1 -1
  196. package/dist/server/links/index.js +24 -11
  197. package/dist/server/links/index.js.map +1 -1
  198. package/dist/server/metrics/index.d.ts +524 -4
  199. package/dist/server/metrics/index.d.ts.map +1 -1
  200. package/dist/server/metrics/index.js +4472 -7
  201. package/dist/server/metrics/index.js.map +1 -1
  202. package/dist/server/multipart/index.d.ts +15 -9
  203. package/dist/server/multipart/index.d.ts.map +1 -1
  204. package/dist/server/multipart/index.js +9 -3
  205. package/dist/server/multipart/index.js.map +1 -1
  206. package/dist/server/proxy/index.d.ts +110 -104
  207. package/dist/server/proxy/index.d.ts.map +1 -1
  208. package/dist/server/proxy/index.js +8 -2
  209. package/dist/server/proxy/index.js.map +1 -1
  210. package/dist/server/rate-limit/index.d.ts +46 -51
  211. package/dist/server/rate-limit/index.d.ts.map +1 -1
  212. package/dist/server/rate-limit/index.js +18 -55
  213. package/dist/server/rate-limit/index.js.map +1 -1
  214. package/dist/server/static/index.d.ts +181 -48
  215. package/dist/server/static/index.d.ts.map +1 -1
  216. package/dist/server/static/index.js +1848 -5
  217. package/dist/server/static/index.js.map +1 -1
  218. package/dist/server/swagger/index.d.ts +348 -53
  219. package/dist/server/swagger/index.d.ts.map +1 -1
  220. package/dist/server/swagger/index.js +1849 -6
  221. package/dist/server/swagger/index.js.map +1 -1
  222. package/dist/sms/index.d.ts +312 -18
  223. package/dist/sms/index.d.ts.map +1 -1
  224. package/dist/sms/index.js +1854 -10
  225. package/dist/sms/index.js.map +1 -1
  226. package/dist/system/index.browser.js +496 -0
  227. package/dist/system/index.browser.js.map +1 -0
  228. package/dist/system/index.d.ts +1158 -0
  229. package/dist/system/index.d.ts.map +1 -0
  230. package/dist/{file → system}/index.js +412 -20
  231. package/dist/system/index.js.map +1 -0
  232. package/dist/thread/index.d.ts +82 -73
  233. package/dist/thread/index.d.ts.map +1 -1
  234. package/dist/thread/index.js +13 -4
  235. package/dist/thread/index.js.map +1 -1
  236. package/dist/topic/core/index.d.ts +330 -323
  237. package/dist/topic/core/index.d.ts.map +1 -1
  238. package/dist/topic/core/index.js +12 -5
  239. package/dist/topic/core/index.js.map +1 -1
  240. package/dist/topic/redis/index.d.ts +6 -6
  241. package/dist/topic/redis/index.d.ts.map +1 -1
  242. package/dist/vite/index.d.ts +163 -5825
  243. package/dist/vite/index.d.ts.map +1 -1
  244. package/dist/vite/index.js +130 -477
  245. package/dist/vite/index.js.map +1 -1
  246. package/dist/websocket/index.browser.js +3 -3
  247. package/dist/websocket/index.browser.js.map +1 -1
  248. package/dist/websocket/index.d.ts +287 -283
  249. package/dist/websocket/index.d.ts.map +1 -1
  250. package/dist/websocket/index.js +15 -11
  251. package/dist/websocket/index.js.map +1 -1
  252. package/package.json +86 -17
  253. package/src/api/audits/index.ts +10 -33
  254. package/src/api/files/__tests__/$bucket.spec.ts +1 -1
  255. package/src/api/files/controllers/AdminFileStatsController.spec.ts +1 -1
  256. package/src/api/files/controllers/FileController.spec.ts +1 -1
  257. package/src/api/files/index.ts +10 -3
  258. package/src/api/files/jobs/FileJobs.spec.ts +1 -1
  259. package/src/api/files/services/FileService.spec.ts +1 -1
  260. package/src/api/jobs/index.ts +10 -3
  261. package/src/api/keys/controllers/AdminApiKeyController.ts +75 -0
  262. package/src/api/keys/controllers/ApiKeyController.ts +103 -0
  263. package/src/api/keys/entities/apiKeyEntity.ts +41 -0
  264. package/src/api/keys/index.ts +49 -0
  265. package/src/api/keys/schemas/adminApiKeyQuerySchema.ts +7 -0
  266. package/src/api/keys/schemas/adminApiKeyResourceSchema.ts +17 -0
  267. package/src/api/keys/schemas/createApiKeyBodySchema.ts +7 -0
  268. package/src/api/keys/schemas/createApiKeyResponseSchema.ts +11 -0
  269. package/src/api/keys/schemas/listApiKeyResponseSchema.ts +15 -0
  270. package/src/api/keys/schemas/revokeApiKeyParamsSchema.ts +5 -0
  271. package/src/api/keys/schemas/revokeApiKeyResponseSchema.ts +5 -0
  272. package/src/api/keys/services/ApiKeyService.spec.ts +553 -0
  273. package/src/api/keys/services/ApiKeyService.ts +306 -0
  274. package/src/api/logs/TODO.md +52 -0
  275. package/src/api/notifications/index.ts +10 -4
  276. package/src/api/parameters/index.ts +9 -30
  277. package/src/api/parameters/primitives/$config.ts +12 -4
  278. package/src/api/parameters/services/ConfigStore.ts +9 -3
  279. package/src/api/users/__tests__/ApiKeys-integration.spec.ts +1035 -0
  280. package/src/api/users/__tests__/ApiKeys.spec.ts +401 -0
  281. package/src/api/users/index.ts +14 -3
  282. package/src/api/users/primitives/$realm.ts +33 -5
  283. package/src/api/users/providers/RealmProvider.ts +1 -12
  284. package/src/api/users/services/SessionService.ts +1 -11
  285. package/src/api/verifications/controllers/VerificationController.ts +2 -0
  286. package/src/api/verifications/index.ts +10 -4
  287. package/src/batch/index.ts +9 -36
  288. package/src/batch/primitives/$batch.ts +0 -8
  289. package/src/batch/providers/BatchProvider.ts +29 -2
  290. package/src/bucket/__tests__/shared.ts +1 -1
  291. package/src/bucket/index.ts +13 -6
  292. package/src/bucket/primitives/$bucket.ts +1 -1
  293. package/src/bucket/providers/LocalFileStorageProvider.ts +1 -1
  294. package/src/bucket/providers/MemoryFileStorageProvider.ts +1 -1
  295. package/src/cache/core/__tests__/shared.ts +30 -0
  296. package/src/cache/core/index.ts +11 -6
  297. package/src/cache/core/primitives/$cache.spec.ts +5 -0
  298. package/src/cache/core/providers/CacheProvider.ts +17 -0
  299. package/src/cache/core/providers/MemoryCacheProvider.ts +300 -1
  300. package/src/cache/redis/__tests__/cache-redis.spec.ts +5 -0
  301. package/src/cache/redis/providers/RedisCacheProvider.ts +9 -0
  302. package/src/cli/apps/AlephaCli.ts +3 -16
  303. package/src/cli/apps/AlephaPackageBuilderCli.ts +10 -2
  304. package/src/cli/atoms/appEntryOptions.ts +13 -0
  305. package/src/cli/atoms/buildOptions.ts +1 -1
  306. package/src/cli/atoms/changelogOptions.ts +1 -1
  307. package/src/cli/commands/build.ts +64 -52
  308. package/src/cli/commands/db.ts +17 -11
  309. package/src/cli/commands/deploy.ts +1 -1
  310. package/src/cli/commands/dev.ts +13 -49
  311. package/src/cli/commands/gen/env.ts +6 -3
  312. package/src/cli/commands/gen/openapi.ts +5 -2
  313. package/src/cli/commands/init.spec.ts +544 -0
  314. package/src/cli/commands/init.ts +101 -58
  315. package/src/cli/commands/lint.ts +8 -2
  316. package/src/cli/commands/typecheck.ts +11 -0
  317. package/src/cli/defineConfig.ts +9 -0
  318. package/src/cli/index.ts +2 -1
  319. package/src/cli/providers/AppEntryProvider.ts +131 -0
  320. package/src/cli/providers/ViteBuildProvider.ts +40 -0
  321. package/src/cli/providers/ViteDevServerProvider.ts +378 -0
  322. package/src/cli/services/AlephaCliUtils.ts +39 -93
  323. package/src/cli/services/PackageManagerUtils.ts +140 -17
  324. package/src/cli/services/ProjectScaffolder.ts +169 -101
  325. package/src/cli/services/ViteUtils.ts +82 -0
  326. package/src/cli/{assets/claudeMd.ts → templates/agentMd.ts} +41 -28
  327. package/src/cli/{assets → templates}/apiHelloControllerTs.ts +2 -1
  328. package/src/cli/{assets → templates}/biomeJson.ts +2 -1
  329. package/src/cli/{assets → templates}/dummySpecTs.ts +2 -1
  330. package/src/cli/{assets → templates}/editorconfig.ts +2 -1
  331. package/src/cli/templates/gitignore.ts +39 -0
  332. package/src/cli/{assets → templates}/mainBrowserTs.ts +2 -1
  333. package/src/cli/templates/mainCss.ts +33 -0
  334. package/src/cli/templates/mainServerTs.ts +33 -0
  335. package/src/cli/{assets → templates}/tsconfigJson.ts +2 -1
  336. package/src/cli/templates/webAppRouterTs.ts +50 -0
  337. package/src/cli/templates/webHelloComponentTsx.ts +20 -0
  338. package/src/command/helpers/Runner.spec.ts +4 -0
  339. package/src/command/helpers/Runner.ts +3 -21
  340. package/src/command/index.ts +12 -4
  341. package/src/command/providers/CliProvider.spec.ts +1067 -0
  342. package/src/command/providers/CliProvider.ts +203 -40
  343. package/src/core/Alepha.ts +3 -9
  344. package/src/core/__tests__/Alepha-start.spec.ts +4 -4
  345. package/src/core/helpers/jsonSchemaToTypeBox.spec.ts +771 -0
  346. package/src/core/helpers/jsonSchemaToTypeBox.ts +62 -10
  347. package/src/core/index.shared.ts +1 -0
  348. package/src/core/index.ts +20 -0
  349. package/src/core/primitives/$module.ts +12 -0
  350. package/src/core/providers/EventManager.spec.ts +0 -71
  351. package/src/core/providers/EventManager.ts +3 -15
  352. package/src/core/providers/Json.ts +2 -14
  353. package/src/core/providers/KeylessJsonSchemaCodec.spec.ts +257 -0
  354. package/src/core/providers/KeylessJsonSchemaCodec.ts +396 -14
  355. package/src/core/providers/SchemaValidator.spec.ts +236 -0
  356. package/src/datetime/index.ts +15 -0
  357. package/src/email/index.ts +10 -5
  358. package/src/email/providers/LocalEmailProvider.spec.ts +1 -1
  359. package/src/email/providers/LocalEmailProvider.ts +1 -1
  360. package/src/fake/__tests__/keyName.example.ts +1 -1
  361. package/src/fake/__tests__/keyName.spec.ts +5 -5
  362. package/src/fake/index.ts +9 -6
  363. package/src/fake/providers/FakeProvider.spec.ts +258 -40
  364. package/src/fake/providers/FakeProvider.ts +133 -19
  365. package/src/lock/core/index.ts +11 -4
  366. package/src/logger/index.ts +17 -66
  367. package/src/logger/providers/PrettyFormatterProvider.ts +0 -9
  368. package/src/mcp/errors/McpError.ts +30 -0
  369. package/src/mcp/index.ts +13 -27
  370. package/src/mcp/transports/SseMcpTransport.ts +6 -7
  371. package/src/orm/__tests__/PostgresProvider.spec.ts +2 -2
  372. package/src/orm/index.browser.ts +2 -2
  373. package/src/orm/index.bun.ts +4 -2
  374. package/src/orm/index.ts +21 -47
  375. package/src/orm/providers/DrizzleKitProvider.ts +3 -5
  376. package/src/orm/providers/drivers/BunSqliteProvider.ts +1 -0
  377. package/src/orm/services/Repository.ts +18 -3
  378. package/src/queue/core/index.ts +14 -6
  379. package/src/react/auth/__tests__/$auth.spec.ts +202 -0
  380. package/src/react/auth/hooks/useAuth.ts +32 -0
  381. package/src/react/auth/index.browser.ts +13 -0
  382. package/src/react/auth/index.shared.ts +2 -0
  383. package/src/react/auth/index.ts +48 -0
  384. package/src/react/auth/providers/ReactAuthProvider.ts +16 -0
  385. package/src/react/auth/services/ReactAuth.ts +135 -0
  386. package/src/react/core/__tests__/Router.spec.tsx +169 -0
  387. package/src/react/core/components/ClientOnly.tsx +49 -0
  388. package/src/react/core/components/ErrorBoundary.tsx +73 -0
  389. package/src/react/core/contexts/AlephaContext.ts +7 -0
  390. package/src/react/core/contexts/AlephaProvider.tsx +42 -0
  391. package/src/react/core/hooks/useAction.browser.spec.tsx +569 -0
  392. package/src/react/core/hooks/useAction.ts +480 -0
  393. package/src/react/core/hooks/useAlepha.ts +26 -0
  394. package/src/react/core/hooks/useClient.ts +17 -0
  395. package/src/react/core/hooks/useEvents.ts +51 -0
  396. package/src/react/core/hooks/useInject.ts +12 -0
  397. package/src/react/core/hooks/useStore.ts +52 -0
  398. package/src/react/core/index.ts +90 -0
  399. package/src/react/form/components/FormState.tsx +17 -0
  400. package/src/react/form/errors/FormValidationError.ts +18 -0
  401. package/src/react/form/hooks/useForm.browser.spec.tsx +366 -0
  402. package/src/react/form/hooks/useForm.ts +47 -0
  403. package/src/react/form/hooks/useFormState.ts +130 -0
  404. package/src/react/form/index.ts +44 -0
  405. package/src/react/form/services/FormModel.ts +614 -0
  406. package/src/react/head/helpers/SeoExpander.spec.ts +203 -0
  407. package/src/react/head/helpers/SeoExpander.ts +142 -0
  408. package/src/react/head/hooks/useHead.spec.tsx +288 -0
  409. package/src/react/head/hooks/useHead.ts +62 -0
  410. package/src/react/head/index.browser.ts +26 -0
  411. package/src/react/head/index.ts +44 -0
  412. package/src/react/head/interfaces/Head.ts +105 -0
  413. package/src/react/head/primitives/$head.ts +25 -0
  414. package/src/react/head/providers/BrowserHeadProvider.browser.spec.ts +196 -0
  415. package/src/react/head/providers/BrowserHeadProvider.ts +212 -0
  416. package/src/react/head/providers/HeadProvider.ts +168 -0
  417. package/src/react/head/providers/ServerHeadProvider.ts +31 -0
  418. package/src/react/i18n/__tests__/integration.spec.tsx +239 -0
  419. package/src/react/i18n/components/Localize.spec.tsx +357 -0
  420. package/src/react/i18n/components/Localize.tsx +35 -0
  421. package/src/react/i18n/hooks/useI18n.browser.spec.tsx +438 -0
  422. package/src/react/i18n/hooks/useI18n.ts +18 -0
  423. package/src/react/i18n/index.ts +41 -0
  424. package/src/react/i18n/primitives/$dictionary.ts +69 -0
  425. package/src/react/i18n/providers/I18nProvider.spec.ts +389 -0
  426. package/src/react/i18n/providers/I18nProvider.ts +278 -0
  427. package/src/react/router/__tests__/page-head-browser.browser.spec.ts +95 -0
  428. package/src/react/router/__tests__/page-head.spec.ts +48 -0
  429. package/src/react/router/__tests__/seo-head.spec.ts +125 -0
  430. package/src/react/router/atoms/ssrManifestAtom.ts +58 -0
  431. package/src/react/router/components/ErrorViewer.tsx +872 -0
  432. package/src/react/router/components/Link.tsx +23 -0
  433. package/src/react/router/components/NestedView.tsx +223 -0
  434. package/src/react/router/components/NotFound.tsx +30 -0
  435. package/src/react/router/constants/PAGE_PRELOAD_KEY.ts +6 -0
  436. package/src/react/router/contexts/RouterLayerContext.ts +12 -0
  437. package/src/react/router/errors/Redirection.ts +28 -0
  438. package/src/react/router/hooks/useActive.ts +52 -0
  439. package/src/react/router/hooks/useQueryParams.ts +63 -0
  440. package/src/react/router/hooks/useRouter.ts +20 -0
  441. package/src/react/router/hooks/useRouterState.ts +11 -0
  442. package/src/react/router/index.browser.ts +45 -0
  443. package/src/react/router/index.shared.ts +19 -0
  444. package/src/react/router/index.ts +142 -0
  445. package/src/react/router/primitives/$page.browser.spec.tsx +851 -0
  446. package/src/react/router/primitives/$page.spec.tsx +708 -0
  447. package/src/react/router/primitives/$page.ts +497 -0
  448. package/src/react/router/providers/ReactBrowserProvider.ts +309 -0
  449. package/src/react/router/providers/ReactBrowserRendererProvider.ts +25 -0
  450. package/src/react/router/providers/ReactBrowserRouterProvider.ts +168 -0
  451. package/src/react/router/providers/ReactPageProvider.ts +726 -0
  452. package/src/react/router/providers/ReactServerProvider.spec.tsx +316 -0
  453. package/src/react/router/providers/ReactServerProvider.ts +558 -0
  454. package/src/react/router/providers/ReactServerTemplateProvider.ts +979 -0
  455. package/src/react/router/providers/SSRManifestProvider.ts +334 -0
  456. package/src/react/router/services/ReactPageServerService.ts +48 -0
  457. package/src/react/router/services/ReactPageService.ts +27 -0
  458. package/src/react/router/services/ReactRouter.ts +262 -0
  459. package/src/react/websocket/hooks/useRoom.tsx +242 -0
  460. package/src/react/websocket/index.ts +7 -0
  461. package/src/redis/__tests__/redis.spec.ts +13 -0
  462. package/src/redis/index.ts +9 -25
  463. package/src/redis/providers/BunRedisProvider.ts +9 -0
  464. package/src/redis/providers/NodeRedisProvider.ts +8 -0
  465. package/src/redis/providers/RedisProvider.ts +16 -0
  466. package/src/retry/index.ts +11 -2
  467. package/src/router/index.ts +15 -0
  468. package/src/scheduler/index.ts +11 -2
  469. package/src/security/__tests__/BasicAuth.spec.ts +2 -0
  470. package/src/security/__tests__/ServerSecurityProvider.spec.ts +13 -5
  471. package/src/security/index.ts +15 -10
  472. package/src/security/interfaces/IssuerResolver.ts +27 -0
  473. package/src/security/primitives/$issuer.ts +55 -0
  474. package/src/security/providers/SecurityProvider.ts +179 -0
  475. package/src/security/providers/ServerBasicAuthProvider.ts +6 -2
  476. package/src/security/providers/ServerSecurityProvider.ts +36 -22
  477. package/src/server/auth/index.ts +12 -7
  478. package/src/server/cache/index.ts +7 -22
  479. package/src/server/compress/index.ts +10 -2
  480. package/src/server/cookies/index.ts +7 -5
  481. package/src/server/cookies/primitives/$cookie.ts +33 -11
  482. package/src/server/core/index.ts +17 -7
  483. package/src/server/core/interfaces/ServerRequest.ts +83 -1
  484. package/src/server/core/primitives/$action.spec.ts +1 -1
  485. package/src/server/core/primitives/$action.ts +8 -3
  486. package/src/server/core/providers/BunHttpServerProvider.ts +1 -1
  487. package/src/server/core/providers/NodeHttpServerProvider.spec.ts +125 -0
  488. package/src/server/core/providers/NodeHttpServerProvider.ts +77 -22
  489. package/src/server/core/providers/ServerLoggerProvider.ts +2 -2
  490. package/src/server/core/providers/ServerProvider.ts +9 -12
  491. package/src/server/core/services/ServerRequestParser.spec.ts +520 -0
  492. package/src/server/core/services/ServerRequestParser.ts +306 -13
  493. package/src/server/cors/index.ts +7 -21
  494. package/src/server/cors/primitives/$cors.ts +6 -2
  495. package/src/server/health/index.ts +8 -2
  496. package/src/server/helmet/index.ts +11 -3
  497. package/src/server/links/atoms/apiLinksAtom.ts +7 -0
  498. package/src/server/links/index.browser.ts +2 -0
  499. package/src/server/links/index.ts +13 -6
  500. package/src/server/metrics/index.ts +10 -3
  501. package/src/server/multipart/index.ts +9 -3
  502. package/src/server/proxy/index.ts +8 -2
  503. package/src/server/rate-limit/index.ts +21 -25
  504. package/src/server/rate-limit/primitives/$rateLimit.ts +6 -2
  505. package/src/server/rate-limit/providers/ServerRateLimitProvider.spec.ts +38 -14
  506. package/src/server/rate-limit/providers/ServerRateLimitProvider.ts +22 -56
  507. package/src/server/static/index.ts +8 -2
  508. package/src/server/static/providers/ServerStaticProvider.ts +1 -1
  509. package/src/server/swagger/index.ts +9 -4
  510. package/src/server/swagger/providers/ServerSwaggerProvider.ts +1 -1
  511. package/src/sms/index.ts +9 -5
  512. package/src/sms/providers/LocalSmsProvider.spec.ts +1 -1
  513. package/src/sms/providers/LocalSmsProvider.ts +1 -1
  514. package/src/system/index.browser.ts +11 -0
  515. package/src/system/index.ts +62 -0
  516. package/src/{file → system}/providers/FileSystemProvider.ts +16 -0
  517. package/src/{file → system}/providers/MemoryFileSystemProvider.ts +116 -3
  518. package/src/system/providers/MemoryShellProvider.ts +164 -0
  519. package/src/{file → system}/providers/NodeFileSystemProvider.spec.ts +2 -2
  520. package/src/{file → system}/providers/NodeFileSystemProvider.ts +36 -0
  521. package/src/system/providers/NodeShellProvider.ts +184 -0
  522. package/src/system/providers/ShellProvider.ts +74 -0
  523. package/src/{file → system}/services/FileDetector.spec.ts +2 -2
  524. package/src/thread/index.ts +11 -2
  525. package/src/topic/core/index.ts +12 -5
  526. package/src/vite/index.ts +3 -2
  527. package/src/vite/tasks/buildClient.ts +2 -8
  528. package/src/vite/tasks/buildServer.ts +84 -21
  529. package/src/vite/tasks/copyAssets.ts +5 -4
  530. package/src/vite/tasks/generateSitemap.ts +64 -23
  531. package/src/vite/tasks/index.ts +0 -2
  532. package/src/vite/tasks/prerenderPages.ts +49 -24
  533. package/src/websocket/index.ts +12 -8
  534. package/dist/file/index.d.ts +0 -839
  535. package/dist/file/index.d.ts.map +0 -1
  536. package/dist/file/index.js.map +0 -1
  537. package/src/cli/assets/indexHtml.ts +0 -15
  538. package/src/cli/assets/mainServerTs.ts +0 -24
  539. package/src/cli/assets/webAppRouterTs.ts +0 -15
  540. package/src/cli/assets/webHelloComponentTsx.ts +0 -16
  541. package/src/cli/commands/format.ts +0 -23
  542. package/src/file/index.ts +0 -43
  543. package/src/vite/helpers/boot.ts +0 -117
  544. package/src/vite/plugins/viteAlephaDev.ts +0 -177
  545. package/src/vite/tasks/devServer.ts +0 -71
  546. package/src/vite/tasks/runAlepha.ts +0 -270
  547. /package/dist/orm/{chunk-DtkW-qnP.js → chunk-DH6iiROE.js} +0 -0
  548. /package/src/cli/{assets → templates}/apiIndexTs.ts +0 -0
  549. /package/src/cli/{assets → templates}/webIndexTs.ts +0 -0
  550. /package/src/{file → system}/errors/FileError.ts +0 -0
  551. /package/src/{file → system}/services/FileDetector.ts +0 -0
@@ -1,10 +1,10 @@
1
1
  import "alepha/security";
2
2
  import * as alepha1 from "alepha";
3
- import { Alepha, KIND, Primitive, Static, TObject } from "alepha";
3
+ import { Alepha, FileLike, Json, KIND, Primitive, Static, StreamLike, TObject } from "alepha";
4
4
  import { ActionPrimitive, RequestConfigSchema, ServerProvider, ServerRouterProvider } from "alepha/server";
5
5
  import { ServerStaticProvider } from "alepha/server/static";
6
- import { FileSystemProvider } from "alepha/file";
7
6
  import * as alepha_logger0 from "alepha/logger";
7
+ import { Readable } from "node:stream";
8
8
 
9
9
  //#region ../../src/server/swagger/primitives/$swagger.d.ts
10
10
  /**
@@ -37,79 +37,79 @@ declare const $swagger: {
37
37
  interface SwaggerPrimitiveOptions {
38
38
  info?: OpenApiDocument["info"];
39
39
  /**
40
- * @default: "/docs"
41
- */
40
+ * @default: "/docs"
41
+ */
42
42
  prefix?: string;
43
43
  /**
44
- * If true, docs will be disabled.
45
- */
44
+ * If true, docs will be disabled.
45
+ */
46
46
  disabled?: boolean;
47
47
  /**
48
- * Tags to exclude from the documentation.
49
- */
48
+ * Tags to exclude from the documentation.
49
+ */
50
50
  excludeTags?: string[];
51
51
  /**
52
- * Enable Swagger UI.
53
- *
54
- * @default true
55
- */
52
+ * Enable Swagger UI.
53
+ *
54
+ * @default true
55
+ */
56
56
  ui?: boolean | SwaggerUiOptions;
57
57
  /**
58
- * Function to rewrite the OpenAPI document before serving it.
59
- */
58
+ * Function to rewrite the OpenAPI document before serving it.
59
+ */
60
60
  rewrite?: (doc: OpenApiDocument) => void;
61
61
  }
62
62
  interface SwaggerUiOptions {
63
63
  root?: string;
64
64
  initOAuth?: {
65
65
  /**
66
- * Default clientId.
67
- */
66
+ * Default clientId.
67
+ */
68
68
  clientId?: string;
69
69
  /**
70
- * realm query parameter (for oauth1) added to authorizationUrl and tokenUrl.
71
- */
70
+ * realm query parameter (for oauth1) added to authorizationUrl and tokenUrl.
71
+ */
72
72
  realm?: string;
73
73
  /**
74
- * application name, displayed in authorization popup.
75
- */
74
+ * application name, displayed in authorization popup.
75
+ */
76
76
  appName?: string;
77
77
  /**
78
- * scope separator for passing scopes, encoded before calling, default
79
- * value is a space (encoded value %20).
80
- *
81
- * @default ' '
82
- */
78
+ * scope separator for passing scopes, encoded before calling, default
79
+ * value is a space (encoded value %20).
80
+ *
81
+ * @default ' '
82
+ */
83
83
  scopeSeparator?: string;
84
84
  /**
85
- * string array or scope separator (i.e. space) separated string of
86
- * initially selected oauth scopes
87
- *
88
- * @default []
89
- */
85
+ * string array or scope separator (i.e. space) separated string of
86
+ * initially selected oauth scopes
87
+ *
88
+ * @default []
89
+ */
90
90
  scopes?: string | string[];
91
91
  /**
92
- * Additional query parameters added to authorizationUrl and tokenUrl.
93
- * MUST be an object
94
- */
92
+ * Additional query parameters added to authorizationUrl and tokenUrl.
93
+ * MUST be an object
94
+ */
95
95
  additionalQueryStringParams?: {
96
96
  [key: string]: any;
97
97
  };
98
98
  /**
99
- * Only activated for the accessCode flow. During the authorization_code
100
- * request to the tokenUrl, pass the Client Password using the HTTP Basic
101
- * Authentication scheme (Authorization header with Basic
102
- * base64encode(client_id + client_secret)).
103
- *
104
- * @default false
105
- */
99
+ * Only activated for the accessCode flow. During the authorization_code
100
+ * request to the tokenUrl, pass the Client Password using the HTTP Basic
101
+ * Authentication scheme (Authorization header with Basic
102
+ * base64encode(client_id + client_secret)).
103
+ *
104
+ * @default false
105
+ */
106
106
  useBasicAuthenticationWithAccessCodeGrant?: boolean;
107
107
  /**
108
- * Only applies to Authorization Code flows. Proof Key for Code Exchange
109
- * brings enhanced security for OAuth public clients.
110
- *
111
- * @default false
112
- */
108
+ * Only applies to Authorization Code flows. Proof Key for Code Exchange
109
+ * brings enhanced security for OAuth public clients.
110
+ *
111
+ * @default false
112
+ */
113
113
  usePkceWithAuthorizationCodeGrant?: boolean;
114
114
  };
115
115
  }
@@ -155,6 +155,296 @@ interface OpenApiOperation {
155
155
  security?: Array<Record<string, any[]>>;
156
156
  }
157
157
  //#endregion
158
+ //#region ../../src/system/providers/FileSystemProvider.d.ts
159
+ /**
160
+ * Options for creating a file from a URL
161
+ */
162
+ interface CreateFileFromUrlOptions {
163
+ /**
164
+ * The URL to load the file from (file://, http://, or https://)
165
+ */
166
+ url: string;
167
+ /**
168
+ * The MIME type of the file (optional, will be detected from filename if not provided)
169
+ */
170
+ type?: string;
171
+ /**
172
+ * The name of the file (optional, will be extracted from URL if not provided)
173
+ */
174
+ name?: string;
175
+ }
176
+ /**
177
+ * Options for creating a file from a path (URL with file:// scheme)
178
+ */
179
+ interface CreateFileFromPathOptions {
180
+ /**
181
+ * The path to the file on the local filesystem
182
+ */
183
+ path: string;
184
+ /**
185
+ * The MIME type of the file (optional, will be detected from filename if not provided)
186
+ */
187
+ type?: string;
188
+ /**
189
+ * The name of the file (optional, will be extracted from URL if not provided)
190
+ */
191
+ name?: string;
192
+ }
193
+ /**
194
+ * Options for creating a file from a Buffer
195
+ */
196
+ interface CreateFileFromBufferOptions {
197
+ /**
198
+ * The Buffer containing the file data
199
+ */
200
+ buffer: Buffer;
201
+ /**
202
+ * The MIME type of the file (optional, will be detected from name if not provided)
203
+ */
204
+ type?: string;
205
+ /**
206
+ * The name of the file (required for proper content type detection)
207
+ */
208
+ name?: string;
209
+ }
210
+ /**
211
+ * Options for creating a file from a stream
212
+ */
213
+ interface CreateFileFromStreamOptions {
214
+ /**
215
+ * The readable stream containing the file data
216
+ */
217
+ stream: StreamLike;
218
+ /**
219
+ * The MIME type of the file (optional, will be detected from name if not provided)
220
+ */
221
+ type?: string;
222
+ /**
223
+ * The name of the file (required for proper content type detection)
224
+ */
225
+ name?: string;
226
+ /**
227
+ * The size of the file in bytes (optional)
228
+ */
229
+ size?: number;
230
+ }
231
+ /**
232
+ * Options for creating a file from text content
233
+ */
234
+ interface CreateFileFromTextOptions {
235
+ /**
236
+ * The text content to create the file from
237
+ */
238
+ text: string;
239
+ /**
240
+ * The MIME type of the file (default: text/plain)
241
+ */
242
+ type?: string;
243
+ /**
244
+ * The name of the file (default: "file.txt")
245
+ */
246
+ name?: string;
247
+ }
248
+ interface CreateFileFromResponseOptions {
249
+ /**
250
+ * The Response object containing the file data
251
+ */
252
+ response: Response;
253
+ /**
254
+ * Override the name (optional, uses filename from Content-Disposition header if not provided)
255
+ */
256
+ name?: string;
257
+ /**
258
+ * Override the MIME type (optional, uses file.type if not provided)
259
+ */
260
+ type?: string;
261
+ }
262
+ /**
263
+ * Options for creating a file from a Web File object
264
+ */
265
+ interface CreateFileFromWebFileOptions {
266
+ /**
267
+ * The Web File object
268
+ */
269
+ file: File;
270
+ /**
271
+ * Override the MIME type (optional, uses file.type if not provided)
272
+ */
273
+ type?: string;
274
+ /**
275
+ * Override the name (optional, uses file.name if not provided)
276
+ */
277
+ name?: string;
278
+ /**
279
+ * Override the size (optional, uses file.size if not provided)
280
+ */
281
+ size?: number;
282
+ }
283
+ /**
284
+ * Options for creating a file from an ArrayBuffer
285
+ */
286
+ interface CreateFileFromArrayBufferOptions {
287
+ /**
288
+ * The ArrayBuffer containing the file data
289
+ */
290
+ arrayBuffer: ArrayBuffer;
291
+ /**
292
+ * The MIME type of the file (optional, will be detected from name if not provided)
293
+ */
294
+ type?: string;
295
+ /**
296
+ * The name of the file (required for proper content type detection)
297
+ */
298
+ name?: string;
299
+ }
300
+ /**
301
+ * Union type for all createFile options
302
+ */
303
+ type CreateFileOptions = CreateFileFromUrlOptions | CreateFileFromPathOptions | CreateFileFromBufferOptions | CreateFileFromStreamOptions | CreateFileFromTextOptions | CreateFileFromWebFileOptions | CreateFileFromResponseOptions | CreateFileFromArrayBufferOptions;
304
+ /**
305
+ * Options for rm (remove) operation
306
+ */
307
+ interface RmOptions {
308
+ /**
309
+ * If true, removes directories and their contents recursively
310
+ */
311
+ recursive?: boolean;
312
+ /**
313
+ * If true, no error will be thrown if the path does not exist
314
+ */
315
+ force?: boolean;
316
+ }
317
+ /**
318
+ * Options for cp (copy) operation
319
+ */
320
+ interface CpOptions {
321
+ /**
322
+ * If true, copy directories recursively
323
+ */
324
+ recursive?: boolean;
325
+ /**
326
+ * If true, overwrite existing destination
327
+ */
328
+ force?: boolean;
329
+ }
330
+ /**
331
+ * Options for mkdir operation
332
+ */
333
+ interface MkdirOptions {
334
+ /**
335
+ * If true, creates parent directories as needed
336
+ */
337
+ recursive?: boolean;
338
+ /**
339
+ * File mode (permission and sticky bits)
340
+ */
341
+ mode?: number;
342
+ }
343
+ /**
344
+ * Options for ls (list) operation
345
+ */
346
+ interface LsOptions {
347
+ /**
348
+ * If true, list contents of directories recursively
349
+ */
350
+ recursive?: boolean;
351
+ /**
352
+ * If true, include hidden files (starting with .)
353
+ */
354
+ hidden?: boolean;
355
+ }
356
+ /**
357
+ * FileSystem interface providing utilities for working with files.
358
+ */
359
+ declare abstract class FileSystemProvider {
360
+ /**
361
+ * Joins multiple path segments into a single path.
362
+ *
363
+ * @param paths - The path segments to join
364
+ * @returns The joined path
365
+ */
366
+ abstract join(...paths: string[]): string;
367
+ /**
368
+ * Creates a FileLike object from various sources.
369
+ *
370
+ * @param options - Options for creating the file
371
+ * @returns A FileLike object
372
+ */
373
+ abstract createFile(options: CreateFileOptions): FileLike;
374
+ /**
375
+ * Removes a file or directory.
376
+ *
377
+ * @param path - The path to remove
378
+ * @param options - Remove options
379
+ */
380
+ abstract rm(path: string, options?: RmOptions): Promise<void>;
381
+ /**
382
+ * Copies a file or directory.
383
+ *
384
+ * @param src - Source path
385
+ * @param dest - Destination path
386
+ * @param options - Copy options
387
+ */
388
+ abstract cp(src: string, dest: string, options?: CpOptions): Promise<void>;
389
+ /**
390
+ * Moves/renames a file or directory.
391
+ *
392
+ * @param src - Source path
393
+ * @param dest - Destination path
394
+ */
395
+ abstract mv(src: string, dest: string): Promise<void>;
396
+ /**
397
+ * Creates a directory.
398
+ *
399
+ * @param path - The directory path to create
400
+ * @param options - Mkdir options
401
+ */
402
+ abstract mkdir(path: string, options?: MkdirOptions): Promise<void>;
403
+ /**
404
+ * Lists files in a directory.
405
+ *
406
+ * @param path - The directory path to list
407
+ * @param options - List options
408
+ * @returns Array of filenames
409
+ */
410
+ abstract ls(path: string, options?: LsOptions): Promise<string[]>;
411
+ /**
412
+ * Checks if a file or directory exists.
413
+ *
414
+ * @param path - The path to check
415
+ * @returns True if the path exists, false otherwise
416
+ */
417
+ abstract exists(path: string): Promise<boolean>;
418
+ /**
419
+ * Reads the content of a file.
420
+ *
421
+ * @param path - The file path to read
422
+ * @returns The file content as a Buffer
423
+ */
424
+ abstract readFile(path: string): Promise<Buffer>;
425
+ /**
426
+ * Writes data to a file.
427
+ *
428
+ * @param path - The file path to write to
429
+ * @param data - The data to write (Buffer or string)
430
+ */
431
+ abstract writeFile(path: string, data: Uint8Array | Buffer | string | FileLike): Promise<void>;
432
+ /**
433
+ * Reads the content of a file as a string.
434
+ *
435
+ * @param path - The file path to read
436
+ * @returns The file content as a string
437
+ */
438
+ abstract readTextFile(path: string): Promise<string>;
439
+ /**
440
+ * Reads the content of a file as JSON.
441
+ *
442
+ * @param path - The file path to read
443
+ * @returns The parsed JSON content
444
+ */
445
+ abstract readJsonFile<T = unknown>(path: string): Promise<T>;
446
+ }
447
+ //#endregion
158
448
  //#region ../../src/server/swagger/providers/ServerSwaggerProvider.d.ts
159
449
  /**
160
450
  * Swagger provider configuration atom
@@ -200,21 +490,26 @@ declare class ServerSwaggerProvider {
200
490
  declare module "alepha/server" {
201
491
  interface ActionPrimitiveOptions<TConfig extends RequestConfigSchema> {
202
492
  /**
203
- * Short description of the route.
204
- */
493
+ * Short description of the route.
494
+ */
205
495
  summary?: string;
206
496
  /**
207
- * Don't include this action in the Swagger documentation.
208
- */
497
+ * Don't include this action in the Swagger documentation.
498
+ */
209
499
  hide?: boolean;
210
500
  }
211
501
  }
212
502
  /**
213
- * Plugin for Alepha Server that provides Swagger documentation capabilities.
214
- * It generates OpenAPI v3 documentation for the server's endpoints ($action).
215
- * It also provides a Swagger UI for interactive API documentation.
503
+ * | type | quality | stability |
504
+ * |------|---------|-----------|
505
+ * | backend | standard | stable |
506
+ *
507
+ * Automatic API documentation generation.
508
+ *
509
+ * **Features:**
510
+ * - Swagger/OpenAPI configuration
511
+ * - Routes: `GET /swagger/ui`, `GET /swagger.json`
216
512
  *
217
- * @see {@link ServerSwaggerProvider}
218
513
  * @module alepha.server.swagger
219
514
  */
220
515
  declare const AlephaServerSwagger: alepha1.Service<alepha1.Module>;
@@ -1 +1 @@
1
- {"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/server/swagger/primitives/$swagger.ts","../../../src/server/swagger/providers/ServerSwaggerProvider.ts","../../../src/server/swagger/index.ts"],"mappings":"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"}
1
+ {"version":3,"file":"index.d.ts","names":[],"sources":["../../../src/server/swagger/primitives/$swagger.ts","../../../src/system/providers/FileSystemProvider.ts","../../../src/server/swagger/providers/ServerSwaggerProvider.ts","../../../src/server/swagger/index.ts"],"mappings":"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"}