@geekmidas/constructs 10.0.0-alpha.99 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (533) hide show
  1. package/CHANGELOG.md +437 -0
  2. package/README.md +193 -285
  3. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
  4. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
  5. package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
  6. package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
  7. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
  8. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
  9. package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
  10. package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
  11. package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
  12. package/dist/Construct-BWF5HxaM.mjs.map +1 -0
  13. package/dist/Construct-JlyQkBkv.d.cts +117 -0
  14. package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
  15. package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
  16. package/dist/Construct-TGIM_E4o.cjs.map +1 -0
  17. package/dist/Construct-pxwC6fDD.d.mts +117 -0
  18. package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
  19. package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
  20. package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
  21. package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
  22. package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
  23. package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
  24. package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
  25. package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
  26. package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
  27. package/dist/Queue-BL68oDJ-.d.mts +66 -0
  28. package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
  29. package/dist/Queue-DxJ6btRE.d.cts +66 -0
  30. package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
  31. package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
  32. package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
  33. package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
  34. package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
  35. package/dist/Topic-DJXoDeMP.d.cts +60 -0
  36. package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
  37. package/dist/Topic-DxWQBgMN.d.mts +60 -0
  38. package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
  39. package/dist/adaptors/aws.cjs +205 -355
  40. package/dist/adaptors/aws.cjs.map +1 -1
  41. package/dist/adaptors/aws.d.cts +48 -126
  42. package/dist/adaptors/aws.d.cts.map +1 -1
  43. package/dist/adaptors/aws.d.mts +49 -127
  44. package/dist/adaptors/aws.d.mts.map +1 -1
  45. package/dist/adaptors/aws.mjs +178 -325
  46. package/dist/adaptors/aws.mjs.map +1 -1
  47. package/dist/adaptors/hono.cjs +9 -3
  48. package/dist/adaptors/hono.d.cts +15 -7
  49. package/dist/adaptors/hono.d.cts.map +1 -1
  50. package/dist/adaptors/hono.d.mts +17 -9
  51. package/dist/adaptors/hono.d.mts.map +1 -1
  52. package/dist/adaptors/hono.mjs +9 -2
  53. package/dist/adaptors/testing.cjs +209 -831
  54. package/dist/adaptors/testing.cjs.map +1 -1
  55. package/dist/adaptors/testing.d.cts +55 -351
  56. package/dist/adaptors/testing.d.cts.map +1 -1
  57. package/dist/adaptors/testing.d.mts +53 -349
  58. package/dist/adaptors/testing.d.mts.map +1 -1
  59. package/dist/adaptors/testing.mjs +195 -798
  60. package/dist/adaptors/testing.mjs.map +1 -1
  61. package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
  62. package/dist/clone-I_WIpiFf.cjs.map +1 -0
  63. package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
  64. package/dist/clone-pdXxc0t3.mjs.map +1 -0
  65. package/dist/crons/index.cjs +66 -190
  66. package/dist/crons/index.cjs.map +1 -1
  67. package/dist/crons/index.d.cts +35 -70
  68. package/dist/crons/index.d.cts.map +1 -1
  69. package/dist/crons/index.d.mts +32 -70
  70. package/dist/crons/index.d.mts.map +1 -1
  71. package/dist/crons/index.mjs +63 -184
  72. package/dist/crons/index.mjs.map +1 -1
  73. package/dist/endpoints/index.cjs +761 -19
  74. package/dist/endpoints/index.cjs.map +1 -0
  75. package/dist/endpoints/index.d.cts +322 -22
  76. package/dist/endpoints/index.d.cts.map +1 -1
  77. package/dist/endpoints/index.d.mts +321 -22
  78. package/dist/endpoints/index.d.mts.map +1 -1
  79. package/dist/endpoints/index.mjs +751 -6
  80. package/dist/endpoints/index.mjs.map +1 -0
  81. package/dist/functions/index.cjs +5 -2
  82. package/dist/functions/index.d.cts +3 -3
  83. package/dist/functions/index.d.mts +3 -3
  84. package/dist/functions/index.mjs +5 -2
  85. package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
  86. package/dist/functions-EqTloHjo.mjs.map +1 -0
  87. package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
  88. package/dist/functions-SqtCDc9c.cjs.map +1 -0
  89. package/dist/index-C7iynzLI.d.mts +139 -0
  90. package/dist/index-C7iynzLI.d.mts.map +1 -0
  91. package/dist/index-D4dM_WDY.d.cts +142 -0
  92. package/dist/index-D4dM_WDY.d.cts.map +1 -0
  93. package/dist/index.cjs +3 -6
  94. package/dist/index.d.cts +4 -27
  95. package/dist/index.d.mts +4 -27
  96. package/dist/index.mjs +3 -3
  97. package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
  98. package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
  99. package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
  100. package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
  101. package/dist/monitors/index.cjs +49 -0
  102. package/dist/monitors/index.cjs.map +1 -0
  103. package/dist/monitors/index.d.cts +45 -0
  104. package/dist/monitors/index.d.cts.map +1 -0
  105. package/dist/monitors/index.d.mts +45 -0
  106. package/dist/monitors/index.d.mts.map +1 -0
  107. package/dist/monitors/index.mjs +48 -0
  108. package/dist/monitors/index.mjs.map +1 -0
  109. package/dist/processAudits-BJZT5gmy.cjs +92 -0
  110. package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
  111. package/dist/processAudits-CwyaaSQc.mjs +80 -0
  112. package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
  113. package/dist/publisher-BZgcrVPy.cjs +53 -0
  114. package/dist/publisher-BZgcrVPy.cjs.map +1 -0
  115. package/dist/publisher-CnpeMv-r.mjs +41 -0
  116. package/dist/publisher-CnpeMv-r.mjs.map +1 -0
  117. package/dist/queue/index.cjs +114 -6
  118. package/dist/queue/index.cjs.map +1 -0
  119. package/dist/queue/index.d.cts +45 -3
  120. package/dist/queue/index.d.cts.map +1 -0
  121. package/dist/queue/index.d.mts +44 -3
  122. package/dist/queue/index.d.mts.map +1 -0
  123. package/dist/queue/index.mjs +112 -3
  124. package/dist/queue/index.mjs.map +1 -0
  125. package/dist/subscribers/index.cjs +80 -111
  126. package/dist/subscribers/index.cjs.map +1 -1
  127. package/dist/subscribers/index.d.cts +43 -46
  128. package/dist/subscribers/index.d.cts.map +1 -1
  129. package/dist/subscribers/index.d.mts +42 -46
  130. package/dist/subscribers/index.d.mts.map +1 -1
  131. package/dist/subscribers/index.mjs +78 -108
  132. package/dist/subscribers/index.mjs.map +1 -1
  133. package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
  134. package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
  135. package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
  136. package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
  137. package/dist/topic/index.cjs +91 -3
  138. package/dist/topic/index.cjs.map +1 -0
  139. package/dist/topic/index.d.cts +32 -2
  140. package/dist/topic/index.d.cts.map +1 -0
  141. package/dist/topic/index.d.mts +32 -2
  142. package/dist/topic/index.d.mts.map +1 -0
  143. package/dist/topic/index.mjs +89 -2
  144. package/dist/topic/index.mjs.map +1 -0
  145. package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
  146. package/dist/types-BdAaYDvd.d.cts.map +1 -0
  147. package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
  148. package/dist/types-DNngH0fX.d.mts.map +1 -0
  149. package/dist/types.d.cts +1 -1
  150. package/dist/types.d.mts +1 -1
  151. package/dist/types.mjs +0 -1
  152. package/package.json +55 -223
  153. package/src/Construct.ts +209 -0
  154. package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
  155. package/src/__benchmarks__/endpoint.bench.ts +494 -0
  156. package/src/__benchmarks__/fixtures.ts +241 -0
  157. package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
  158. package/src/__benchmarks__/hono-server.bench.ts +249 -0
  159. package/src/__benchmarks__/response-builder.bench.ts +428 -0
  160. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
  161. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
  162. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
  163. package/src/__tests__/Construct.environment.spec.ts +704 -0
  164. package/src/__tests__/builder-reuse.spec.ts +587 -0
  165. package/src/__tests__/monitor.spec.ts +636 -0
  166. package/src/__tests__/publisher.setting.spec.ts +508 -0
  167. package/src/__tests__/publisher.spec.ts +452 -0
  168. package/src/adaptors/aws.ts +6 -0
  169. package/src/adaptors/hono.ts +1 -0
  170. package/src/adaptors/testing.ts +11 -0
  171. package/src/clone.ts +38 -0
  172. package/src/crons/AWSScheduledFunction.ts +73 -0
  173. package/src/crons/Cron.ts +149 -0
  174. package/src/crons/CronBuilder.ts +261 -0
  175. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
  176. package/src/crons/__tests__/Cron.spec.ts +472 -0
  177. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
  178. package/src/crons/index.ts +12 -0
  179. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
  180. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
  181. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
  182. package/src/endpoints/Authorizer.ts +152 -0
  183. package/src/endpoints/Endpoint.ts +1287 -0
  184. package/src/endpoints/EndpointBuilder.ts +749 -0
  185. package/src/endpoints/EndpointFactory.ts +1179 -0
  186. package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
  187. package/src/endpoints/MswEndpointAdaptor.ts +226 -0
  188. package/src/endpoints/TestEndpointAdaptor.ts +466 -0
  189. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
  190. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
  191. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
  192. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
  193. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
  194. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
  195. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
  196. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
  197. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
  198. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
  199. package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
  200. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
  201. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
  202. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
  203. package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
  204. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
  205. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
  206. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
  207. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
  208. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
  209. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
  210. package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
  211. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
  212. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
  213. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
  214. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
  215. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
  216. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
  217. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
  218. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
  219. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
  220. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
  221. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
  222. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
  223. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
  224. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
  225. package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
  226. package/src/endpoints/__tests__/helpers.spec.ts +37 -0
  227. package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
  228. package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
  229. package/src/endpoints/audit.ts +87 -0
  230. package/src/endpoints/helpers.ts +98 -0
  231. package/src/endpoints/index.ts +42 -0
  232. package/src/endpoints/lazyAccessors.ts +241 -0
  233. package/src/endpoints/parseHonoQuery.ts +16 -0
  234. package/src/endpoints/parseQueryParams.ts +32 -0
  235. package/src/endpoints/processAudits.ts +371 -0
  236. package/src/endpoints/rls.ts +67 -0
  237. package/src/functions/AWSLambdaFunction.ts +374 -0
  238. package/src/functions/BaseFunctionBuilder.ts +212 -0
  239. package/src/functions/Function.ts +238 -0
  240. package/src/functions/FunctionBuilder.ts +381 -0
  241. package/src/functions/FunctionExecutionWrapper.ts +216 -0
  242. package/src/functions/TestFunctionAdaptor.ts +252 -0
  243. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
  244. package/src/functions/__tests__/Function.audits.spec.ts +393 -0
  245. package/src/functions/__tests__/Function.spec.ts +477 -0
  246. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
  247. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
  248. package/src/functions/index.ts +12 -0
  249. package/src/index.ts +29 -0
  250. package/src/monitor.ts +145 -0
  251. package/src/monitors/heartbeat.ts +86 -0
  252. package/src/monitors/index.ts +6 -0
  253. package/src/publisher.ts +93 -0
  254. package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
  255. package/src/queue/Queue.ts +128 -0
  256. package/src/queue/QueueBuilder.ts +115 -0
  257. package/src/queue/TestQueueAdaptor.ts +63 -0
  258. package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
  259. package/src/queue/index.ts +12 -0
  260. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
  261. package/src/subscribers/Subscriber.ts +117 -0
  262. package/src/subscribers/SubscriberBuilder.ts +183 -0
  263. package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
  264. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
  265. package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
  266. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
  267. package/src/subscribers/index.ts +6 -0
  268. package/src/telemetry.ts +103 -0
  269. package/src/topic/Topic.ts +103 -0
  270. package/src/topic/TopicBuilder.ts +53 -0
  271. package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
  272. package/src/topic/index.ts +11 -0
  273. package/src/types.ts +13 -0
  274. package/test.ts +91 -0
  275. package/tsconfig.json +9 -0
  276. package/tsdown.config.ts +35 -0
  277. package/dist/Construct-B1vGBPme.mjs.map +0 -1
  278. package/dist/Construct-BQALFCh2.d.cts +0 -230
  279. package/dist/Construct-BQALFCh2.d.cts.map +0 -1
  280. package/dist/Construct-DUSXuTHP.cjs.map +0 -1
  281. package/dist/Construct-QXnl3VqT.d.mts +0 -230
  282. package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
  283. package/dist/Cron-DI3nKoic.d.cts +0 -45
  284. package/dist/Cron-DI3nKoic.d.cts.map +0 -1
  285. package/dist/Cron-uYAHPnp7.d.mts +0 -45
  286. package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
  287. package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
  288. package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
  289. package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
  290. package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
  291. package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
  292. package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
  293. package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
  294. package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
  295. package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
  296. package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
  297. package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
  298. package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
  299. package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
  300. package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
  301. package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
  302. package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
  303. package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
  304. package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
  305. package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
  306. package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
  307. package/dist/Function-DuqGcbOI.d.mts +0 -76
  308. package/dist/Function-DuqGcbOI.d.mts.map +0 -1
  309. package/dist/Function-Pu-1kKZz.d.cts +0 -76
  310. package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
  311. package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
  312. package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
  313. package/dist/Queue-A3wfD0it.cjs +0 -109
  314. package/dist/Queue-A3wfD0it.cjs.map +0 -1
  315. package/dist/Queue-D6USGS4q.mjs +0 -104
  316. package/dist/Queue-D6USGS4q.mjs.map +0 -1
  317. package/dist/Queue-DlsHRzUp.d.mts +0 -105
  318. package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
  319. package/dist/Queue-HPyi0e1i.d.cts +0 -105
  320. package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
  321. package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
  322. package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
  323. package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
  324. package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
  325. package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
  326. package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
  327. package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
  328. package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
  329. package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
  330. package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
  331. package/dist/Subscriber-CtN9R48-.d.mts +0 -61
  332. package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
  333. package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
  334. package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
  335. package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
  336. package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
  337. package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
  338. package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
  339. package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
  340. package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
  341. package/dist/Topic-D74b5cgs.mjs +0 -99
  342. package/dist/Topic-D74b5cgs.mjs.map +0 -1
  343. package/dist/Topic-GHxcU8AG.cjs +0 -104
  344. package/dist/Topic-GHxcU8AG.cjs.map +0 -1
  345. package/dist/auth-BMCJN30Y.d.cts +0 -268
  346. package/dist/auth-BMCJN30Y.d.cts.map +0 -1
  347. package/dist/auth-CcuceLYo.d.mts +0 -268
  348. package/dist/auth-CcuceLYo.d.mts.map +0 -1
  349. package/dist/auth.cjs +0 -433
  350. package/dist/auth.cjs.map +0 -1
  351. package/dist/auth.d.cts +0 -2
  352. package/dist/auth.d.mts +0 -2
  353. package/dist/auth.mjs +0 -426
  354. package/dist/auth.mjs.map +0 -1
  355. package/dist/cache-CXh6GIgb.d.mts +0 -44
  356. package/dist/cache-CXh6GIgb.d.mts.map +0 -1
  357. package/dist/cache-DnGDGly3.d.cts +0 -44
  358. package/dist/cache-DnGDGly3.d.cts.map +0 -1
  359. package/dist/cache.cjs +0 -69
  360. package/dist/cache.cjs.map +0 -1
  361. package/dist/cache.d.cts +0 -2
  362. package/dist/cache.d.mts +0 -2
  363. package/dist/cache.mjs +0 -68
  364. package/dist/cache.mjs.map +0 -1
  365. package/dist/cipher-C1lEFX63.mjs +0 -225
  366. package/dist/cipher-C1lEFX63.mjs.map +0 -1
  367. package/dist/cipher-CVxfwLjk.cjs +0 -332
  368. package/dist/cipher-CVxfwLjk.cjs.map +0 -1
  369. package/dist/clone-EKNovYHu.mjs.map +0 -1
  370. package/dist/clone-UGJpvQnL.cjs.map +0 -1
  371. package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
  372. package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
  373. package/dist/construct-interface-DluK3_da.d.mts +0 -162
  374. package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
  375. package/dist/construct-interface.cjs +0 -114
  376. package/dist/construct-interface.cjs.map +0 -1
  377. package/dist/construct-interface.d.cts +0 -2
  378. package/dist/construct-interface.d.mts +0 -2
  379. package/dist/construct-interface.mjs +0 -107
  380. package/dist/construct-interface.mjs.map +0 -1
  381. package/dist/credential.cjs +0 -156
  382. package/dist/credential.cjs.map +0 -1
  383. package/dist/credential.d.cts +0 -86
  384. package/dist/credential.d.cts.map +0 -1
  385. package/dist/credential.d.mts +0 -86
  386. package/dist/credential.d.mts.map +0 -1
  387. package/dist/credential.mjs +0 -152
  388. package/dist/credential.mjs.map +0 -1
  389. package/dist/database/kysely.cjs +0 -4
  390. package/dist/database/kysely.d.cts +0 -2
  391. package/dist/database/kysely.d.mts +0 -2
  392. package/dist/database/kysely.mjs +0 -2
  393. package/dist/email.cjs +0 -72
  394. package/dist/email.cjs.map +0 -1
  395. package/dist/email.d.cts +0 -46
  396. package/dist/email.d.cts.map +0 -1
  397. package/dist/email.d.mts +0 -46
  398. package/dist/email.d.mts.map +0 -1
  399. package/dist/email.mjs +0 -71
  400. package/dist/email.mjs.map +0 -1
  401. package/dist/encryption.cjs +0 -96
  402. package/dist/encryption.cjs.map +0 -1
  403. package/dist/encryption.d.cts +0 -117
  404. package/dist/encryption.d.cts.map +0 -1
  405. package/dist/encryption.d.mts +0 -117
  406. package/dist/encryption.d.mts.map +0 -1
  407. package/dist/encryption.mjs +0 -83
  408. package/dist/encryption.mjs.map +0 -1
  409. package/dist/external-api-MJ8id87V.d.mts +0 -105
  410. package/dist/external-api-MJ8id87V.d.mts.map +0 -1
  411. package/dist/external-api-O107yzZJ.d.cts +0 -105
  412. package/dist/external-api-O107yzZJ.d.cts.map +0 -1
  413. package/dist/external-api.cjs +0 -142
  414. package/dist/external-api.cjs.map +0 -1
  415. package/dist/external-api.d.cts +0 -2
  416. package/dist/external-api.d.mts +0 -2
  417. package/dist/external-api.mjs +0 -139
  418. package/dist/external-api.mjs.map +0 -1
  419. package/dist/file-server.cjs +0 -186
  420. package/dist/file-server.cjs.map +0 -1
  421. package/dist/file-server.d.cts +0 -152
  422. package/dist/file-server.d.cts.map +0 -1
  423. package/dist/file-server.d.mts +0 -152
  424. package/dist/file-server.d.mts.map +0 -1
  425. package/dist/file-server.mjs +0 -184
  426. package/dist/file-server.mjs.map +0 -1
  427. package/dist/functions-BFizikJU.mjs.map +0 -1
  428. package/dist/functions-CfzJG9hK.cjs.map +0 -1
  429. package/dist/index-BuzRvKOQ.d.cts +0 -115
  430. package/dist/index-BuzRvKOQ.d.cts.map +0 -1
  431. package/dist/index-CTkKOer4.d.mts +0 -115
  432. package/dist/index-CTkKOer4.d.mts.map +0 -1
  433. package/dist/index-CeEtxDmK.d.cts +0 -79
  434. package/dist/index-CeEtxDmK.d.cts.map +0 -1
  435. package/dist/index-CeEtxDmK.d.mts +0 -79
  436. package/dist/index-CeEtxDmK.d.mts.map +0 -1
  437. package/dist/index.d.cts.map +0 -1
  438. package/dist/index.d.mts.map +0 -1
  439. package/dist/kms-B-Hm3d5r.cjs +0 -85
  440. package/dist/kms-B-Hm3d5r.cjs.map +0 -1
  441. package/dist/kms-BdUlMJEZ.mjs +0 -85
  442. package/dist/kms-BdUlMJEZ.mjs.map +0 -1
  443. package/dist/kysely-Bii4l6eP.mjs +0 -370
  444. package/dist/kysely-Bii4l6eP.mjs.map +0 -1
  445. package/dist/kysely-CO_Dk43W.cjs +0 -383
  446. package/dist/kysely-CO_Dk43W.cjs.map +0 -1
  447. package/dist/kysely-D0bpzgPs.d.cts +0 -175
  448. package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
  449. package/dist/kysely-DUqC3Ie0.d.mts +0 -175
  450. package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
  451. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
  452. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
  453. package/dist/lazyAccessors-CFanua0O.mjs +0 -174
  454. package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
  455. package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
  456. package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
  457. package/dist/mobile-app.cjs +0 -73
  458. package/dist/mobile-app.cjs.map +0 -1
  459. package/dist/mobile-app.d.cts +0 -61
  460. package/dist/mobile-app.d.cts.map +0 -1
  461. package/dist/mobile-app.d.mts +0 -61
  462. package/dist/mobile-app.d.mts.map +0 -1
  463. package/dist/mobile-app.mjs +0 -72
  464. package/dist/mobile-app.mjs.map +0 -1
  465. package/dist/object-storage.cjs +0 -56
  466. package/dist/object-storage.cjs.map +0 -1
  467. package/dist/object-storage.d.cts +0 -32
  468. package/dist/object-storage.d.cts.map +0 -1
  469. package/dist/object-storage.d.mts +0 -32
  470. package/dist/object-storage.d.mts.map +0 -1
  471. package/dist/object-storage.mjs +0 -55
  472. package/dist/object-storage.mjs.map +0 -1
  473. package/dist/processAudits-BRRVVHUB.mjs +0 -131
  474. package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
  475. package/dist/processAudits-DasOZjPl.cjs +0 -154
  476. package/dist/processAudits-DasOZjPl.cjs.map +0 -1
  477. package/dist/rest-api.cjs +0 -216
  478. package/dist/rest-api.cjs.map +0 -1
  479. package/dist/rest-api.d.cts +0 -241
  480. package/dist/rest-api.d.cts.map +0 -1
  481. package/dist/rest-api.d.mts +0 -241
  482. package/dist/rest-api.d.mts.map +0 -1
  483. package/dist/rest-api.mjs +0 -215
  484. package/dist/rest-api.mjs.map +0 -1
  485. package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
  486. package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
  487. package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
  488. package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
  489. package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
  490. package/dist/shutdown-BMJmAhSt.cjs +0 -38
  491. package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
  492. package/dist/shutdown-C7xa8x9S.mjs +0 -27
  493. package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
  494. package/dist/site.cjs +0 -74
  495. package/dist/site.cjs.map +0 -1
  496. package/dist/site.d.cts +0 -104
  497. package/dist/site.d.cts.map +0 -1
  498. package/dist/site.d.mts +0 -104
  499. package/dist/site.d.mts.map +0 -1
  500. package/dist/site.mjs +0 -73
  501. package/dist/site.mjs.map +0 -1
  502. package/dist/stages-BSCF19o2.d.cts +0 -56
  503. package/dist/stages-BSCF19o2.d.cts.map +0 -1
  504. package/dist/stages-BSCF19o2.d.mts +0 -56
  505. package/dist/stages-BSCF19o2.d.mts.map +0 -1
  506. package/dist/surfaceEnv-CNimK76p.cjs +0 -56
  507. package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
  508. package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
  509. package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
  510. package/dist/telemetry-B48RLjyk.d.cts +0 -40
  511. package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
  512. package/dist/telemetry-DRtT1_0A.d.mts +0 -40
  513. package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
  514. package/dist/telemetry.cjs +0 -56
  515. package/dist/telemetry.cjs.map +0 -1
  516. package/dist/telemetry.d.cts +0 -2
  517. package/dist/telemetry.d.mts +0 -2
  518. package/dist/telemetry.mjs +0 -55
  519. package/dist/telemetry.mjs.map +0 -1
  520. package/dist/tracing-CxaZ98IB.mjs +0 -110
  521. package/dist/tracing-CxaZ98IB.mjs.map +0 -1
  522. package/dist/tracing-DPMidF_r.cjs +0 -127
  523. package/dist/tracing-DPMidF_r.cjs.map +0 -1
  524. package/dist/types-DMuSQeLL.d.cts.map +0 -1
  525. package/dist/types-DMuSQeLL.d.mts.map +0 -1
  526. package/dist/worker.cjs +0 -191
  527. package/dist/worker.cjs.map +0 -1
  528. package/dist/worker.d.cts +0 -171
  529. package/dist/worker.d.cts.map +0 -1
  530. package/dist/worker.d.mts +0 -171
  531. package/dist/worker.d.mts.map +0 -1
  532. package/dist/worker.mjs +0 -190
  533. package/dist/worker.mjs.map +0 -1
@@ -0,0 +1,1179 @@
1
+ import type {
2
+ AuditableAction,
3
+ AuditStorage,
4
+ ExtractStorageAuditAction,
5
+ } from '@geekmidas/audit';
6
+ import type { EventPublisher, MappedEvent } from '@geekmidas/events';
7
+ import type { Logger } from '@geekmidas/logger';
8
+ import { ConsoleLogger } from '@geekmidas/logger/console';
9
+ import type { Service } from '@geekmidas/services';
10
+ import uniqBy from 'lodash.uniqby';
11
+ import { cloneWith } from '../clone';
12
+ import { addMonitor, type MonitorService } from '../monitor';
13
+ import type { HttpMethod } from '../types';
14
+ import {
15
+ type Authorizer,
16
+ type BuiltInSecuritySchemeId,
17
+ getSecurityScheme,
18
+ type SecurityScheme,
19
+ } from './Authorizer';
20
+ import type { ActorExtractor } from './audit';
21
+ import type { AuthorizeFn, SessionFn } from './Endpoint';
22
+ import { EndpointBuilder } from './EndpointBuilder';
23
+ import type { RlsConfig } from './rls';
24
+
25
+ // Re-export SecurityScheme to make the type portable in declaration files
26
+ export type { SecurityScheme } from './Authorizer';
27
+
28
+ const DEFAULT_LOGGER = new ConsoleLogger() as any;
29
+
30
+ export class EndpointFactory<
31
+ TServices extends Service[] = [],
32
+ TBasePath extends string = '',
33
+ TLogger extends Logger = Logger,
34
+ TSession = unknown,
35
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
36
+ TEventPublisherServiceName extends string = string,
37
+ TAuthorizers extends readonly string[] = readonly string[],
38
+ TAuditStorage extends AuditStorage<any> | undefined = undefined,
39
+ TAuditStorageServiceName extends string = string,
40
+ TAuditAction extends AuditableAction<
41
+ string,
42
+ unknown
43
+ > = ExtractStorageAuditAction<NonNullable<TAuditStorage>>,
44
+ TDatabase = undefined,
45
+ TDatabaseServiceName extends string = string,
46
+ TSecuritySchemes extends Record<string, SecurityScheme> = Record<
47
+ string,
48
+ SecurityScheme
49
+ >,
50
+ TRlsConfig extends
51
+ | RlsConfig<TServices, TSession, TLogger>
52
+ | undefined = undefined,
53
+ > {
54
+ private defaultServices: TServices = [] as unknown as TServices;
55
+ private basePath: TBasePath = '' as TBasePath;
56
+ private defaultAuthorizeFn?: AuthorizeFn<
57
+ TServices,
58
+ TLogger,
59
+ TSession,
60
+ undefined,
61
+ TDatabase
62
+ >;
63
+ private defaultEventPublisher:
64
+ | Service<TEventPublisherServiceName, TEventPublisher>
65
+ | undefined;
66
+ private defaultSessionExtractor?: SessionFn<
67
+ TServices,
68
+ TLogger,
69
+ TSession,
70
+ TDatabase
71
+ >;
72
+ private defaultLogger: TLogger = DEFAULT_LOGGER;
73
+ private availableAuthorizers: Authorizer[] = [];
74
+ private defaultAuthorizerName?: TAuthorizers[number];
75
+ private defaultAuditorStorage:
76
+ | Service<TAuditStorageServiceName, TAuditStorage>
77
+ | undefined;
78
+ private defaultDatabaseService:
79
+ | Service<TDatabaseServiceName, TDatabase>
80
+ | undefined;
81
+ private defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;
82
+ private customSecuritySchemes: TSecuritySchemes = {} as TSecuritySchemes;
83
+ private defaultRlsConfig?: TRlsConfig;
84
+ private defaultMonitors: MonitorService[] = [];
85
+
86
+ constructor({
87
+ basePath,
88
+ defaultAuthorizeFn,
89
+ defaultLogger,
90
+ defaultSessionExtractor,
91
+ // @ts-expect-error
92
+ defaultServices = [] as TServices,
93
+ defaultEventPublisher,
94
+ availableAuthorizers = [],
95
+ defaultAuthorizerName,
96
+ defaultAuditorStorage,
97
+ defaultDatabaseService,
98
+ defaultActorExtractor,
99
+ customSecuritySchemes = {} as TSecuritySchemes,
100
+ defaultRlsConfig,
101
+ defaultMonitors = [],
102
+ }: EndpointFactoryOptions<
103
+ TServices,
104
+ TBasePath,
105
+ TLogger,
106
+ TSession,
107
+ TEventPublisher,
108
+ TEventPublisherServiceName,
109
+ TAuthorizers,
110
+ TAuditStorage,
111
+ TAuditStorageServiceName,
112
+ TDatabase,
113
+ TDatabaseServiceName,
114
+ TSecuritySchemes,
115
+ TRlsConfig
116
+ > = {}) {
117
+ // Initialize default services
118
+ this.defaultServices = uniqBy(
119
+ defaultServices,
120
+ (s) => s.serviceName,
121
+ ) as TServices;
122
+
123
+ this.basePath = basePath || ('' as TBasePath);
124
+ this.defaultAuthorizeFn = defaultAuthorizeFn;
125
+ this.defaultLogger = defaultLogger || (DEFAULT_LOGGER as TLogger);
126
+ this.defaultSessionExtractor = defaultSessionExtractor;
127
+ this.defaultEventPublisher = defaultEventPublisher;
128
+ this.availableAuthorizers = availableAuthorizers;
129
+ this.defaultAuthorizerName = defaultAuthorizerName;
130
+ this.defaultAuditorStorage = defaultAuditorStorage;
131
+ this.defaultDatabaseService = defaultDatabaseService;
132
+ this.defaultActorExtractor = defaultActorExtractor;
133
+ this.customSecuritySchemes = customSecuritySchemes;
134
+ this.defaultRlsConfig = defaultRlsConfig;
135
+ this.defaultMonitors = defaultMonitors;
136
+ }
137
+
138
+ /**
139
+ * Report every endpoint's requests to a monitor. Endpoints built from this
140
+ * factory inherit it, and can add their own with `.monitor()`.
141
+ */
142
+ monitor(monitor: MonitorService): this {
143
+ return cloneWith(this, {
144
+ defaultMonitors: addMonitor(this.defaultMonitors, monitor),
145
+ });
146
+ }
147
+
148
+ static joinPaths<TBasePath extends string, P extends string>(
149
+ path: P,
150
+ basePath: TBasePath = '' as TBasePath,
151
+ ): JoinPaths<TBasePath, P> {
152
+ // Handle empty cases
153
+ if (!basePath && !path) return '/' as JoinPaths<TBasePath, P>;
154
+ if (!basePath)
155
+ return (path.startsWith('/') ? path : `/${path}`) as JoinPaths<
156
+ TBasePath,
157
+ P
158
+ >;
159
+ if (!path)
160
+ return (
161
+ basePath.startsWith('/') ? basePath : `/${basePath}`
162
+ ) as JoinPaths<TBasePath, P>;
163
+
164
+ const base = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;
165
+ const segment = path.startsWith('/') ? path : `/${path}`;
166
+
167
+ let result = base + segment;
168
+
169
+ // Ensure leading slash
170
+ if (!result.startsWith('/')) {
171
+ result = `/${result}`;
172
+ }
173
+
174
+ // Normalize multiple slashes (except in the middle of the path where they might be intentional)
175
+ result = result.replace(/^\/+/g, '/');
176
+
177
+ // Remove trailing slash unless it's the root path "/"
178
+ if (result.length > 1 && result.endsWith('/')) {
179
+ result = result.slice(0, -1);
180
+ }
181
+
182
+ return result as JoinPaths<TBasePath, P>;
183
+ }
184
+
185
+ // Configure available authorizers
186
+ authorizers<const T extends readonly string[]>(
187
+ authorizers: T,
188
+ ): EndpointFactory<
189
+ TServices,
190
+ TBasePath,
191
+ TLogger,
192
+ TSession,
193
+ TEventPublisher,
194
+ TEventPublisherServiceName,
195
+ T,
196
+ TAuditStorage,
197
+ TAuditStorageServiceName,
198
+ TAuditAction,
199
+ TDatabase,
200
+ TDatabaseServiceName,
201
+ TSecuritySchemes,
202
+ TRlsConfig
203
+ > {
204
+ const authorizerConfigs = authorizers.map((name) => ({
205
+ name,
206
+ securityScheme: getSecurityScheme(name, this.customSecuritySchemes),
207
+ }));
208
+ return new EndpointFactory<
209
+ TServices,
210
+ TBasePath,
211
+ TLogger,
212
+ TSession,
213
+ TEventPublisher,
214
+ TEventPublisherServiceName,
215
+ T,
216
+ TAuditStorage,
217
+ TAuditStorageServiceName,
218
+ TAuditAction,
219
+ TDatabase,
220
+ TDatabaseServiceName,
221
+ TSecuritySchemes,
222
+ TRlsConfig
223
+ >({
224
+ defaultServices: this.defaultServices,
225
+ basePath: this.basePath,
226
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
227
+ defaultLogger: this.defaultLogger,
228
+ defaultSessionExtractor: this.defaultSessionExtractor,
229
+ defaultEventPublisher: this.defaultEventPublisher,
230
+ defaultMonitors: this.defaultMonitors,
231
+ availableAuthorizers: authorizerConfigs,
232
+ defaultAuthorizerName: this.defaultAuthorizerName,
233
+ defaultAuditorStorage: this.defaultAuditorStorage,
234
+ defaultDatabaseService: this.defaultDatabaseService,
235
+ defaultActorExtractor: this.defaultActorExtractor,
236
+ customSecuritySchemes: this.customSecuritySchemes,
237
+ defaultRlsConfig: this.defaultRlsConfig,
238
+ });
239
+ }
240
+
241
+ /**
242
+ * Define custom security schemes for this factory.
243
+ * These extend the built-in schemes (jwt, bearer, apiKey, oauth2, oidc).
244
+ *
245
+ * @example
246
+ * ```typescript
247
+ * const router = e.securitySchemes({
248
+ * awsIamSigV4: {
249
+ * type: 'apiKey',
250
+ * in: 'header',
251
+ * name: 'Authorization',
252
+ * 'x-amazon-apigateway-authtype': 'awsSigv4',
253
+ * },
254
+ * });
255
+ * ```
256
+ */
257
+ securitySchemes<T extends Record<string, SecurityScheme>>(
258
+ schemes: T,
259
+ ): EndpointFactory<
260
+ TServices,
261
+ TBasePath,
262
+ TLogger,
263
+ TSession,
264
+ TEventPublisher,
265
+ TEventPublisherServiceName,
266
+ TAuthorizers,
267
+ TAuditStorage,
268
+ TAuditStorageServiceName,
269
+ TAuditAction,
270
+ TDatabase,
271
+ TDatabaseServiceName,
272
+ TSecuritySchemes & T,
273
+ TRlsConfig
274
+ > {
275
+ return new EndpointFactory<
276
+ TServices,
277
+ TBasePath,
278
+ TLogger,
279
+ TSession,
280
+ TEventPublisher,
281
+ TEventPublisherServiceName,
282
+ TAuthorizers,
283
+ TAuditStorage,
284
+ TAuditStorageServiceName,
285
+ TAuditAction,
286
+ TDatabase,
287
+ TDatabaseServiceName,
288
+ TSecuritySchemes & T,
289
+ TRlsConfig
290
+ >({
291
+ defaultServices: this.defaultServices,
292
+ basePath: this.basePath,
293
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
294
+ defaultLogger: this.defaultLogger,
295
+ defaultSessionExtractor: this.defaultSessionExtractor,
296
+ defaultEventPublisher: this.defaultEventPublisher,
297
+ defaultMonitors: this.defaultMonitors,
298
+ availableAuthorizers: this.availableAuthorizers,
299
+ defaultAuthorizerName: this.defaultAuthorizerName,
300
+ defaultAuditorStorage: this.defaultAuditorStorage,
301
+ defaultDatabaseService: this.defaultDatabaseService,
302
+ defaultActorExtractor: this.defaultActorExtractor,
303
+ customSecuritySchemes: {
304
+ ...this.customSecuritySchemes,
305
+ ...schemes,
306
+ } as TSecuritySchemes & T,
307
+ defaultRlsConfig: this.defaultRlsConfig,
308
+ });
309
+ }
310
+
311
+ /**
312
+ * Set the default authorizer for all endpoints created from this factory.
313
+ * Individual endpoints can override this by calling `.authorizer()` on the builder.
314
+ * Use `'none'` to explicitly disable authorization for all endpoints.
315
+ *
316
+ * Accepts:
317
+ * - Built-in security scheme names: 'jwt', 'bearer', 'apiKey', 'oauth2', 'oidc'
318
+ * - Custom security scheme names defined via `.securitySchemes()`
319
+ * - 'none' to disable authorization
320
+ */
321
+ authorizer(
322
+ name:
323
+ | BuiltInSecuritySchemeId
324
+ | keyof TSecuritySchemes
325
+ | TAuthorizers[number]
326
+ | 'none',
327
+ ): EndpointFactory<
328
+ TServices,
329
+ TBasePath,
330
+ TLogger,
331
+ TSession,
332
+ TEventPublisher,
333
+ TEventPublisherServiceName,
334
+ TAuthorizers,
335
+ TAuditStorage,
336
+ TAuditStorageServiceName,
337
+ TAuditAction,
338
+ TDatabase,
339
+ TDatabaseServiceName,
340
+ TSecuritySchemes,
341
+ TRlsConfig
342
+ > {
343
+ // Validate that the authorizer exists in available authorizers (if authorizers() was called)
344
+ if (name !== 'none' && this.availableAuthorizers.length > 0) {
345
+ const authorizerExists = this.availableAuthorizers.some(
346
+ (a) => a.name === name,
347
+ );
348
+ if (!authorizerExists) {
349
+ const available = this.availableAuthorizers
350
+ .map((a) => a.name)
351
+ .join(', ');
352
+ throw new Error(
353
+ `Authorizer "${name as string}" not found in available authorizers: ${available}`,
354
+ );
355
+ }
356
+ }
357
+
358
+ return new EndpointFactory<
359
+ TServices,
360
+ TBasePath,
361
+ TLogger,
362
+ TSession,
363
+ TEventPublisher,
364
+ TEventPublisherServiceName,
365
+ TAuthorizers,
366
+ TAuditStorage,
367
+ TAuditStorageServiceName,
368
+ TAuditAction,
369
+ TDatabase,
370
+ TDatabaseServiceName,
371
+ TSecuritySchemes,
372
+ TRlsConfig
373
+ >({
374
+ defaultServices: this.defaultServices,
375
+ basePath: this.basePath,
376
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
377
+ defaultLogger: this.defaultLogger,
378
+ defaultSessionExtractor: this.defaultSessionExtractor,
379
+ defaultEventPublisher: this.defaultEventPublisher,
380
+ defaultMonitors: this.defaultMonitors,
381
+ availableAuthorizers: this.availableAuthorizers,
382
+ defaultAuthorizerName:
383
+ name === 'none' ? undefined : (name as TAuthorizers[number]),
384
+ defaultAuditorStorage: this.defaultAuditorStorage,
385
+ defaultDatabaseService: this.defaultDatabaseService,
386
+ defaultActorExtractor: this.defaultActorExtractor,
387
+ customSecuritySchemes: this.customSecuritySchemes,
388
+ defaultRlsConfig: this.defaultRlsConfig,
389
+ });
390
+ }
391
+
392
+ // Create a sub-router with a path prefix
393
+ route<TPath extends string>(
394
+ path: TPath,
395
+ ): EndpointFactory<
396
+ TServices,
397
+ JoinPaths<TBasePath, TPath>,
398
+ TLogger,
399
+ TSession,
400
+ TEventPublisher,
401
+ TEventPublisherServiceName,
402
+ TAuthorizers,
403
+ TAuditStorage,
404
+ TAuditStorageServiceName,
405
+ TAuditAction,
406
+ TDatabase,
407
+ TDatabaseServiceName,
408
+ TSecuritySchemes,
409
+ TRlsConfig
410
+ > {
411
+ const newBasePath = EndpointFactory.joinPaths(path, this.basePath);
412
+ return new EndpointFactory<
413
+ TServices,
414
+ JoinPaths<TBasePath, TPath>,
415
+ TLogger,
416
+ TSession,
417
+ TEventPublisher,
418
+ TEventPublisherServiceName,
419
+ TAuthorizers,
420
+ TAuditStorage,
421
+ TAuditStorageServiceName,
422
+ TAuditAction,
423
+ TDatabase,
424
+ TDatabaseServiceName,
425
+ TSecuritySchemes,
426
+ TRlsConfig
427
+ >({
428
+ defaultServices: this.defaultServices,
429
+ basePath: newBasePath,
430
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
431
+ defaultLogger: this.defaultLogger,
432
+ defaultSessionExtractor: this.defaultSessionExtractor,
433
+ defaultEventPublisher: this.defaultEventPublisher,
434
+ defaultMonitors: this.defaultMonitors,
435
+ availableAuthorizers: this.availableAuthorizers,
436
+ defaultAuthorizerName: this.defaultAuthorizerName,
437
+ defaultAuditorStorage: this.defaultAuditorStorage,
438
+ defaultDatabaseService: this.defaultDatabaseService,
439
+ defaultActorExtractor: this.defaultActorExtractor,
440
+ customSecuritySchemes: this.customSecuritySchemes,
441
+ defaultRlsConfig: this.defaultRlsConfig,
442
+ });
443
+ }
444
+
445
+ // Create a new factory with authorization
446
+ authorize(
447
+ fn: AuthorizeFn<TServices, TLogger, TSession, undefined, TDatabase>,
448
+ ): EndpointFactory<
449
+ TServices,
450
+ TBasePath,
451
+ TLogger,
452
+ TSession,
453
+ TEventPublisher,
454
+ TEventPublisherServiceName,
455
+ TAuthorizers,
456
+ TAuditStorage,
457
+ TAuditStorageServiceName,
458
+ TAuditAction,
459
+ TDatabase,
460
+ TDatabaseServiceName,
461
+ TSecuritySchemes,
462
+ TRlsConfig
463
+ > {
464
+ return new EndpointFactory<
465
+ TServices,
466
+ TBasePath,
467
+ TLogger,
468
+ TSession,
469
+ TEventPublisher,
470
+ TEventPublisherServiceName,
471
+ TAuthorizers,
472
+ TAuditStorage,
473
+ TAuditStorageServiceName,
474
+ TAuditAction,
475
+ TDatabase,
476
+ TDatabaseServiceName,
477
+ TSecuritySchemes,
478
+ TRlsConfig
479
+ >({
480
+ defaultServices: this.defaultServices,
481
+ basePath: this.basePath,
482
+ defaultAuthorizeFn: fn,
483
+ defaultLogger: this.defaultLogger,
484
+ defaultSessionExtractor: this.defaultSessionExtractor,
485
+ defaultEventPublisher: this.defaultEventPublisher,
486
+ defaultMonitors: this.defaultMonitors,
487
+ availableAuthorizers: this.availableAuthorizers,
488
+ defaultAuthorizerName: this.defaultAuthorizerName,
489
+ defaultAuditorStorage: this.defaultAuditorStorage,
490
+ defaultDatabaseService: this.defaultDatabaseService,
491
+ defaultActorExtractor: this.defaultActorExtractor,
492
+ customSecuritySchemes: this.customSecuritySchemes,
493
+ defaultRlsConfig: this.defaultRlsConfig,
494
+ });
495
+ }
496
+
497
+ // Create a new factory with services
498
+ services<S extends Service[]>(
499
+ services: S,
500
+ ): EndpointFactory<
501
+ [...S, ...TServices],
502
+ TBasePath,
503
+ TLogger,
504
+ TSession,
505
+ TEventPublisher,
506
+ TEventPublisherServiceName,
507
+ TAuthorizers,
508
+ TAuditStorage,
509
+ TAuditStorageServiceName,
510
+ TAuditAction,
511
+ TDatabase,
512
+ TDatabaseServiceName,
513
+ TSecuritySchemes,
514
+ RlsConfig<[...S, ...TServices], TSession, TLogger> | undefined
515
+ > {
516
+ return new EndpointFactory<
517
+ [...S, ...TServices],
518
+ TBasePath,
519
+ TLogger,
520
+ TSession,
521
+ TEventPublisher,
522
+ TEventPublisherServiceName,
523
+ TAuthorizers,
524
+ TAuditStorage,
525
+ TAuditStorageServiceName,
526
+ TAuditAction,
527
+ TDatabase,
528
+ TDatabaseServiceName,
529
+ TSecuritySchemes,
530
+ RlsConfig<[...S, ...TServices], TSession, TLogger> | undefined
531
+ >({
532
+ defaultServices: [...services, ...this.defaultServices],
533
+ basePath: this.basePath,
534
+ defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<
535
+ [...S, ...TServices],
536
+ TLogger,
537
+ TSession
538
+ >,
539
+ defaultLogger: this.defaultLogger,
540
+ defaultSessionExtractor: this.defaultSessionExtractor as unknown as
541
+ | SessionFn<[...S, ...TServices], TLogger, TSession, TDatabase>
542
+ | undefined,
543
+ defaultEventPublisher: this.defaultEventPublisher,
544
+ defaultMonitors: this.defaultMonitors,
545
+ availableAuthorizers: this.availableAuthorizers,
546
+ defaultAuthorizerName: this.defaultAuthorizerName,
547
+ defaultAuditorStorage: this.defaultAuditorStorage,
548
+ defaultDatabaseService: this.defaultDatabaseService,
549
+ defaultActorExtractor: this.defaultActorExtractor as unknown as
550
+ | ActorExtractor<[...S, ...TServices], TSession, TLogger>
551
+ | undefined,
552
+ customSecuritySchemes: this.customSecuritySchemes,
553
+ defaultRlsConfig: this.defaultRlsConfig as unknown as
554
+ | RlsConfig<[...S, ...TServices], TSession, TLogger>
555
+ | undefined,
556
+ });
557
+ }
558
+
559
+ logger<L extends Logger>(
560
+ logger: L,
561
+ ): EndpointFactory<
562
+ TServices,
563
+ TBasePath,
564
+ L,
565
+ TSession,
566
+ TEventPublisher,
567
+ TEventPublisherServiceName,
568
+ TAuthorizers,
569
+ TAuditStorage,
570
+ TAuditStorageServiceName,
571
+ TAuditAction,
572
+ TDatabase,
573
+ TDatabaseServiceName,
574
+ TSecuritySchemes,
575
+ RlsConfig<TServices, TSession, L> | undefined
576
+ > {
577
+ return new EndpointFactory<
578
+ TServices,
579
+ TBasePath,
580
+ L,
581
+ TSession,
582
+ TEventPublisher,
583
+ TEventPublisherServiceName,
584
+ TAuthorizers,
585
+ TAuditStorage,
586
+ TAuditStorageServiceName,
587
+ TAuditAction,
588
+ TDatabase,
589
+ TDatabaseServiceName,
590
+ TSecuritySchemes,
591
+ RlsConfig<TServices, TSession, L> | undefined
592
+ >({
593
+ defaultServices: this.defaultServices,
594
+ basePath: this.basePath,
595
+ defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<
596
+ TServices,
597
+ L,
598
+ TSession
599
+ >,
600
+ defaultLogger: logger,
601
+ defaultSessionExtractor: this
602
+ .defaultSessionExtractor as unknown as SessionFn<
603
+ TServices,
604
+ L,
605
+ TSession
606
+ >,
607
+ defaultEventPublisher: this.defaultEventPublisher,
608
+ defaultMonitors: this.defaultMonitors,
609
+ availableAuthorizers: this.availableAuthorizers,
610
+ defaultAuthorizerName: this.defaultAuthorizerName,
611
+ defaultAuditorStorage: this.defaultAuditorStorage,
612
+ defaultDatabaseService: this.defaultDatabaseService,
613
+ defaultActorExtractor: this
614
+ .defaultActorExtractor as unknown as ActorExtractor<
615
+ TServices,
616
+ TSession,
617
+ L
618
+ >,
619
+ customSecuritySchemes: this.customSecuritySchemes,
620
+ defaultRlsConfig: this.defaultRlsConfig as unknown as
621
+ | RlsConfig<TServices, TSession, L>
622
+ | undefined,
623
+ });
624
+ }
625
+
626
+ publisher<
627
+ T extends EventPublisher<any>,
628
+ TServiceName extends string = string,
629
+ >(
630
+ publisher: Service<TServiceName, T>,
631
+ ): EndpointFactory<
632
+ TServices,
633
+ TBasePath,
634
+ TLogger,
635
+ TSession,
636
+ T,
637
+ TServiceName,
638
+ TAuthorizers,
639
+ TAuditStorage,
640
+ TAuditStorageServiceName,
641
+ TAuditAction,
642
+ TDatabase,
643
+ TDatabaseServiceName,
644
+ TSecuritySchemes,
645
+ TRlsConfig
646
+ > {
647
+ return new EndpointFactory<
648
+ TServices,
649
+ TBasePath,
650
+ TLogger,
651
+ TSession,
652
+ T,
653
+ TServiceName,
654
+ TAuthorizers,
655
+ TAuditStorage,
656
+ TAuditStorageServiceName,
657
+ TAuditAction,
658
+ TDatabase,
659
+ TDatabaseServiceName,
660
+ TSecuritySchemes,
661
+ TRlsConfig
662
+ >({
663
+ defaultServices: this.defaultServices,
664
+ basePath: this.basePath,
665
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
666
+ defaultLogger: this.defaultLogger,
667
+ defaultSessionExtractor: this.defaultSessionExtractor,
668
+ defaultEventPublisher: publisher,
669
+ defaultMonitors: this.defaultMonitors,
670
+ availableAuthorizers: this.availableAuthorizers,
671
+ defaultAuthorizerName: this.defaultAuthorizerName,
672
+ defaultAuditorStorage: this.defaultAuditorStorage,
673
+ defaultDatabaseService: this.defaultDatabaseService,
674
+ defaultActorExtractor: this.defaultActorExtractor,
675
+ customSecuritySchemes: this.customSecuritySchemes,
676
+ defaultRlsConfig: this.defaultRlsConfig,
677
+ });
678
+ }
679
+
680
+ session<T>(
681
+ session: SessionFn<TServices, TLogger, T, TDatabase>,
682
+ ): EndpointFactory<
683
+ TServices,
684
+ TBasePath,
685
+ TLogger,
686
+ T,
687
+ TEventPublisher,
688
+ TEventPublisherServiceName,
689
+ TAuthorizers,
690
+ TAuditStorage,
691
+ TAuditStorageServiceName,
692
+ TAuditAction,
693
+ TDatabase,
694
+ TDatabaseServiceName,
695
+ TSecuritySchemes,
696
+ RlsConfig<TServices, T, TLogger> | undefined
697
+ > {
698
+ return new EndpointFactory<
699
+ TServices,
700
+ TBasePath,
701
+ TLogger,
702
+ T,
703
+ TEventPublisher,
704
+ TEventPublisherServiceName,
705
+ TAuthorizers,
706
+ TAuditStorage,
707
+ TAuditStorageServiceName,
708
+ TAuditAction,
709
+ TDatabase,
710
+ TDatabaseServiceName,
711
+ TSecuritySchemes,
712
+ RlsConfig<TServices, T, TLogger> | undefined
713
+ >({
714
+ defaultServices: this.defaultServices,
715
+ basePath: this.basePath,
716
+ defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<
717
+ TServices,
718
+ TLogger,
719
+ T
720
+ >,
721
+ defaultLogger: this.defaultLogger,
722
+ defaultSessionExtractor: session,
723
+ defaultEventPublisher: this.defaultEventPublisher,
724
+ defaultMonitors: this.defaultMonitors,
725
+ availableAuthorizers: this.availableAuthorizers,
726
+ defaultAuthorizerName: this.defaultAuthorizerName,
727
+ defaultAuditorStorage: this.defaultAuditorStorage,
728
+ defaultDatabaseService: this.defaultDatabaseService,
729
+ defaultActorExtractor: this
730
+ .defaultActorExtractor as unknown as ActorExtractor<
731
+ TServices,
732
+ T,
733
+ TLogger
734
+ >,
735
+ customSecuritySchemes: this.customSecuritySchemes,
736
+ defaultRlsConfig: this.defaultRlsConfig as unknown as
737
+ | RlsConfig<TServices, T, TLogger>
738
+ | undefined,
739
+ });
740
+ }
741
+
742
+ /**
743
+ * Set the database service for endpoints created from this factory.
744
+ * The database will be available in handler context as `db`.
745
+ */
746
+ database<T, TName extends string>(
747
+ service: Service<TName, T>,
748
+ ): EndpointFactory<
749
+ TServices,
750
+ TBasePath,
751
+ TLogger,
752
+ TSession,
753
+ TEventPublisher,
754
+ TEventPublisherServiceName,
755
+ TAuthorizers,
756
+ TAuditStorage,
757
+ TAuditStorageServiceName,
758
+ TAuditAction,
759
+ T,
760
+ TName,
761
+ TSecuritySchemes,
762
+ TRlsConfig
763
+ > {
764
+ return new EndpointFactory<
765
+ TServices,
766
+ TBasePath,
767
+ TLogger,
768
+ TSession,
769
+ TEventPublisher,
770
+ TEventPublisherServiceName,
771
+ TAuthorizers,
772
+ TAuditStorage,
773
+ TAuditStorageServiceName,
774
+ TAuditAction,
775
+ T,
776
+ TName,
777
+ TSecuritySchemes,
778
+ TRlsConfig
779
+ >({
780
+ defaultServices: this.defaultServices,
781
+ basePath: this.basePath,
782
+ defaultAuthorizeFn: this.defaultAuthorizeFn as unknown as
783
+ | AuthorizeFn<TServices, TLogger, TSession, undefined, T>
784
+ | undefined,
785
+ defaultLogger: this.defaultLogger,
786
+ // Reset session extractor when database changes - user should call .session() after .database()
787
+ // to get proper type inference for the new database type
788
+ defaultSessionExtractor: this.defaultSessionExtractor as unknown as
789
+ | SessionFn<TServices, TLogger, TSession, T>
790
+ | undefined,
791
+ defaultEventPublisher: this.defaultEventPublisher,
792
+ defaultMonitors: this.defaultMonitors,
793
+ availableAuthorizers: this.availableAuthorizers,
794
+ defaultAuthorizerName: this.defaultAuthorizerName,
795
+ defaultAuditorStorage: this.defaultAuditorStorage,
796
+ defaultDatabaseService: service,
797
+ customSecuritySchemes: this.customSecuritySchemes,
798
+ defaultRlsConfig: this.defaultRlsConfig,
799
+ });
800
+ }
801
+
802
+ /**
803
+ * Set the auditor storage service for endpoints created from this factory.
804
+ * This enables audit functionality and makes `auditor` available in handler context.
805
+ * The audit action type is automatically inferred from the storage's generic parameter.
806
+ */
807
+ auditor<T extends AuditStorage<any>, TName extends string>(
808
+ storage: Service<TName, T>,
809
+ ): EndpointFactory<
810
+ TServices,
811
+ TBasePath,
812
+ TLogger,
813
+ TSession,
814
+ TEventPublisher,
815
+ TEventPublisherServiceName,
816
+ TAuthorizers,
817
+ T,
818
+ TName,
819
+ ExtractStorageAuditAction<T>,
820
+ TDatabase,
821
+ TDatabaseServiceName,
822
+ TSecuritySchemes,
823
+ TRlsConfig
824
+ > {
825
+ return new EndpointFactory<
826
+ TServices,
827
+ TBasePath,
828
+ TLogger,
829
+ TSession,
830
+ TEventPublisher,
831
+ TEventPublisherServiceName,
832
+ TAuthorizers,
833
+ T,
834
+ TName,
835
+ ExtractStorageAuditAction<T>,
836
+ TDatabase,
837
+ TDatabaseServiceName,
838
+ TSecuritySchemes,
839
+ TRlsConfig
840
+ >({
841
+ defaultServices: this.defaultServices,
842
+ basePath: this.basePath,
843
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
844
+ defaultLogger: this.defaultLogger,
845
+ defaultSessionExtractor: this.defaultSessionExtractor,
846
+ defaultEventPublisher: this.defaultEventPublisher,
847
+ defaultMonitors: this.defaultMonitors,
848
+ availableAuthorizers: this.availableAuthorizers,
849
+ defaultAuthorizerName: this.defaultAuthorizerName,
850
+ defaultAuditorStorage: storage,
851
+ defaultDatabaseService: this.defaultDatabaseService,
852
+ defaultActorExtractor: this
853
+ .defaultActorExtractor as unknown as ActorExtractor<
854
+ TServices,
855
+ TSession,
856
+ TLogger
857
+ >,
858
+ customSecuritySchemes: this.customSecuritySchemes,
859
+ defaultRlsConfig: this.defaultRlsConfig,
860
+ });
861
+ }
862
+
863
+ /**
864
+ * Set the actor extractor function for endpoints created from this factory.
865
+ * The actor is extracted from the request context and attached to all audits.
866
+ */
867
+ actor(
868
+ extractor: ActorExtractor<TServices, TSession, TLogger>,
869
+ ): EndpointFactory<
870
+ TServices,
871
+ TBasePath,
872
+ TLogger,
873
+ TSession,
874
+ TEventPublisher,
875
+ TEventPublisherServiceName,
876
+ TAuthorizers,
877
+ TAuditStorage,
878
+ TAuditStorageServiceName,
879
+ TAuditAction,
880
+ TDatabase,
881
+ TDatabaseServiceName,
882
+ TSecuritySchemes,
883
+ TRlsConfig
884
+ > {
885
+ return new EndpointFactory<
886
+ TServices,
887
+ TBasePath,
888
+ TLogger,
889
+ TSession,
890
+ TEventPublisher,
891
+ TEventPublisherServiceName,
892
+ TAuthorizers,
893
+ TAuditStorage,
894
+ TAuditStorageServiceName,
895
+ TAuditAction,
896
+ TDatabase,
897
+ TDatabaseServiceName,
898
+ TSecuritySchemes,
899
+ TRlsConfig
900
+ >({
901
+ defaultServices: this.defaultServices,
902
+ basePath: this.basePath,
903
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
904
+ defaultLogger: this.defaultLogger,
905
+ defaultSessionExtractor: this.defaultSessionExtractor,
906
+ defaultEventPublisher: this.defaultEventPublisher,
907
+ defaultMonitors: this.defaultMonitors,
908
+ availableAuthorizers: this.availableAuthorizers,
909
+ defaultAuthorizerName: this.defaultAuthorizerName,
910
+ defaultAuditorStorage: this.defaultAuditorStorage,
911
+ defaultDatabaseService: this.defaultDatabaseService,
912
+ defaultActorExtractor: extractor,
913
+ customSecuritySchemes: this.customSecuritySchemes,
914
+ defaultRlsConfig: this.defaultRlsConfig,
915
+ });
916
+ }
917
+
918
+ /**
919
+ * Set the RLS (Row-Level Security) configuration for endpoints created from this factory.
920
+ * This enables automatic PostgreSQL session variable setting for RLS policies.
921
+ *
922
+ * @example
923
+ * ```typescript
924
+ * const api = new EndpointFactory()
925
+ * .database(databaseService)
926
+ * .session(extractSession)
927
+ * .rls({
928
+ * extractor: ({ session }) => ({
929
+ * user_id: session.userId,
930
+ * tenant_id: session.tenantId,
931
+ * }),
932
+ * prefix: 'app',
933
+ * });
934
+ * ```
935
+ */
936
+ rls<TConfig extends RlsConfig<TServices, TSession, TLogger>>(
937
+ config: TConfig,
938
+ ): EndpointFactory<
939
+ TServices,
940
+ TBasePath,
941
+ TLogger,
942
+ TSession,
943
+ TEventPublisher,
944
+ TEventPublisherServiceName,
945
+ TAuthorizers,
946
+ TAuditStorage,
947
+ TAuditStorageServiceName,
948
+ TAuditAction,
949
+ TDatabase,
950
+ TDatabaseServiceName,
951
+ TSecuritySchemes,
952
+ TConfig
953
+ > {
954
+ return new EndpointFactory<
955
+ TServices,
956
+ TBasePath,
957
+ TLogger,
958
+ TSession,
959
+ TEventPublisher,
960
+ TEventPublisherServiceName,
961
+ TAuthorizers,
962
+ TAuditStorage,
963
+ TAuditStorageServiceName,
964
+ TAuditAction,
965
+ TDatabase,
966
+ TDatabaseServiceName,
967
+ TSecuritySchemes,
968
+ TConfig
969
+ >({
970
+ defaultServices: this.defaultServices,
971
+ basePath: this.basePath,
972
+ defaultAuthorizeFn: this.defaultAuthorizeFn,
973
+ defaultLogger: this.defaultLogger,
974
+ defaultSessionExtractor: this.defaultSessionExtractor,
975
+ defaultEventPublisher: this.defaultEventPublisher,
976
+ defaultMonitors: this.defaultMonitors,
977
+ availableAuthorizers: this.availableAuthorizers,
978
+ defaultAuthorizerName: this.defaultAuthorizerName,
979
+ defaultAuditorStorage: this.defaultAuditorStorage,
980
+ defaultDatabaseService: this.defaultDatabaseService,
981
+ defaultActorExtractor: this.defaultActorExtractor,
982
+ customSecuritySchemes: this.customSecuritySchemes,
983
+ defaultRlsConfig: config,
984
+ });
985
+ }
986
+
987
+ private createBuilder<TMethod extends HttpMethod, TPath extends string>(
988
+ method: TMethod,
989
+ path: TPath,
990
+ ): EndpointBuilder<
991
+ JoinPaths<TBasePath, TPath>,
992
+ TMethod,
993
+ {},
994
+ TServices,
995
+ TLogger,
996
+ undefined,
997
+ TSession,
998
+ TEventPublisher,
999
+ TEventPublisherServiceName,
1000
+ TAuthorizers,
1001
+ TAuditStorage,
1002
+ TAuditStorageServiceName,
1003
+ TAuditAction,
1004
+ TDatabase,
1005
+ TDatabaseServiceName
1006
+ > {
1007
+ const fullPath = EndpointFactory.joinPaths(path, this.basePath);
1008
+ const builder = new EndpointBuilder<
1009
+ JoinPaths<TBasePath, TPath>,
1010
+ TMethod,
1011
+ {},
1012
+ TServices,
1013
+ TLogger,
1014
+ undefined,
1015
+ TSession,
1016
+ TEventPublisher,
1017
+ TEventPublisherServiceName,
1018
+ TAuthorizers,
1019
+ TAuditStorage,
1020
+ TAuditStorageServiceName,
1021
+ TAuditAction,
1022
+ TDatabase,
1023
+ TDatabaseServiceName
1024
+ >(fullPath, method);
1025
+
1026
+ if (this.defaultAuthorizeFn) {
1027
+ builder._authorize = this.defaultAuthorizeFn as any;
1028
+ }
1029
+ if (this.defaultServices.length) {
1030
+ // Create a copy to avoid sharing references between builders
1031
+ builder._services = [...this.defaultServices] as TServices;
1032
+ }
1033
+
1034
+ if (this.defaultLogger) {
1035
+ builder._logger = this.defaultLogger as TLogger;
1036
+ }
1037
+
1038
+ if (this.defaultSessionExtractor) {
1039
+ builder._getSession = this.defaultSessionExtractor as SessionFn<
1040
+ TServices,
1041
+ TLogger,
1042
+ TSession
1043
+ >;
1044
+ }
1045
+
1046
+ if (this.defaultEventPublisher) {
1047
+ builder._setPublisher(this.defaultEventPublisher);
1048
+ }
1049
+
1050
+ builder._monitors = [...this.defaultMonitors];
1051
+
1052
+ // Set available authorizers and default
1053
+ builder._availableAuthorizers = this.availableAuthorizers;
1054
+ if (this.defaultAuthorizerName) {
1055
+ builder._authorizerName = this.defaultAuthorizerName;
1056
+ }
1057
+
1058
+ // Set auditor storage if configured
1059
+ if (this.defaultAuditorStorage) {
1060
+ builder._setAuditorStorage(this.defaultAuditorStorage as any);
1061
+ }
1062
+
1063
+ // Set database service if configured
1064
+ if (this.defaultDatabaseService) {
1065
+ builder._setDatabaseService(this.defaultDatabaseService as any);
1066
+ }
1067
+
1068
+ // Set actor extractor if configured
1069
+ if (this.defaultActorExtractor) {
1070
+ builder._actorExtractor = this.defaultActorExtractor;
1071
+ }
1072
+
1073
+ // Set custom security schemes
1074
+ builder._customSecuritySchemes = this.customSecuritySchemes;
1075
+
1076
+ // Set RLS config if configured
1077
+ if (this.defaultRlsConfig) {
1078
+ builder._rlsConfig = this.defaultRlsConfig as any;
1079
+ }
1080
+
1081
+ return builder;
1082
+ }
1083
+
1084
+ post<TPath extends string>(path: TPath) {
1085
+ return this.createBuilder('POST', path);
1086
+ }
1087
+
1088
+ get<TPath extends string>(path: TPath) {
1089
+ return this.createBuilder('GET', path);
1090
+ }
1091
+
1092
+ put<TPath extends string>(path: TPath) {
1093
+ return this.createBuilder('PUT', path);
1094
+ }
1095
+
1096
+ delete<TPath extends string>(path: TPath) {
1097
+ return this.createBuilder('DELETE', path);
1098
+ }
1099
+
1100
+ patch<TPath extends string>(path: TPath) {
1101
+ return this.createBuilder('PATCH', path);
1102
+ }
1103
+
1104
+ options<TPath extends string>(path: TPath) {
1105
+ return this.createBuilder('OPTIONS', path);
1106
+ }
1107
+ }
1108
+
1109
+ export type RemoveTrailingSlash<T extends string> = T extends `${infer Rest}/`
1110
+ ? Rest extends ''
1111
+ ? T // Keep "/" as is
1112
+ : Rest
1113
+ : T;
1114
+
1115
+ export type JoinPaths<
1116
+ TBasePath extends string,
1117
+ TPath extends string,
1118
+ > = RemoveTrailingSlash<
1119
+ TBasePath extends ''
1120
+ ? TPath
1121
+ : TPath extends ''
1122
+ ? TBasePath
1123
+ : TBasePath extends '/'
1124
+ ? TPath extends `/${string}`
1125
+ ? TPath
1126
+ : `/${TPath}`
1127
+ : TBasePath extends `${infer Base}/`
1128
+ ? TPath extends `/${infer Rest}`
1129
+ ? `${Base}/${Rest}`
1130
+ : `${Base}/${TPath}`
1131
+ : TPath extends `/${infer Rest}`
1132
+ ? `${TBasePath}/${Rest}`
1133
+ : `${TBasePath}/${TPath}`
1134
+ >;
1135
+
1136
+ export interface EndpointFactoryOptions<
1137
+ TServices extends Service[] = [],
1138
+ TBasePath extends string = '',
1139
+ TLogger extends Logger = Logger,
1140
+ TSession = unknown,
1141
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
1142
+ TEventPublisherServiceName extends string = string,
1143
+ TAuthorizers extends readonly string[] = readonly string[],
1144
+ TAuditStorage extends AuditStorage | undefined = undefined,
1145
+ TAuditStorageServiceName extends string = string,
1146
+ TDatabase = undefined,
1147
+ TDatabaseServiceName extends string = string,
1148
+ TSecuritySchemes extends Record<string, SecurityScheme> = Record<
1149
+ string,
1150
+ SecurityScheme
1151
+ >,
1152
+ TRlsConfig extends
1153
+ | RlsConfig<TServices, TSession, TLogger>
1154
+ | undefined = undefined,
1155
+ > {
1156
+ defaultServices?: TServices;
1157
+ basePath?: TBasePath;
1158
+ defaultAuthorizeFn?: AuthorizeFn<
1159
+ TServices,
1160
+ TLogger,
1161
+ TSession,
1162
+ undefined,
1163
+ TDatabase
1164
+ >;
1165
+ defaultLogger?: TLogger;
1166
+ defaultSessionExtractor?: SessionFn<TServices, TLogger, TSession, TDatabase>;
1167
+ defaultEventPublisher?: Service<TEventPublisherServiceName, TEventPublisher>;
1168
+ defaultEvents?: MappedEvent<TEventPublisher, undefined>[];
1169
+ availableAuthorizers?: Authorizer[];
1170
+ defaultAuthorizerName?: TAuthorizers[number];
1171
+ defaultAuditorStorage?: Service<TAuditStorageServiceName, TAuditStorage>;
1172
+ defaultDatabaseService?: Service<TDatabaseServiceName, TDatabase>;
1173
+ defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;
1174
+ customSecuritySchemes?: TSecuritySchemes;
1175
+ defaultRlsConfig?: TRlsConfig;
1176
+ defaultMonitors?: MonitorService[];
1177
+ }
1178
+
1179
+ export const e = new EndpointFactory();