@geekmidas/constructs 10.0.0-alpha.98 → 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,749 @@
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 type { RateLimitConfig } from '@geekmidas/rate-limit';
9
+ import type { Service } from '@geekmidas/services';
10
+ import type { StandardSchemaV1 } from '@standard-schema/spec';
11
+ import uniqBy from 'lodash.uniqby';
12
+ import { ConstructType } from '../Construct';
13
+ import { cloneWith } from '../clone';
14
+ import { BaseFunctionBuilder } from '../functions';
15
+ import type { HttpMethod } from '../types';
16
+ import type { Authorizer, SecurityScheme } from './Authorizer';
17
+ import { getSecurityScheme } from './Authorizer';
18
+ import type { ActorExtractor, MappedAudit } from './audit';
19
+ import type {
20
+ AuthorizeFn,
21
+ EndpointHandler,
22
+ SessionFn,
23
+ SuccessStatus,
24
+ } from './Endpoint';
25
+ import { Endpoint, type EndpointSchemas } from './Endpoint';
26
+ import type { RlsBypass, RlsConfig } from './rls';
27
+ import { RLS_BYPASS } from './rls';
28
+
29
+ export class EndpointBuilder<
30
+ TRoute extends string,
31
+ TMethod extends HttpMethod,
32
+ TInput extends EndpointSchemas = {},
33
+ TServices extends Service[] = [],
34
+ TLogger extends Logger = Logger,
35
+ OutSchema extends StandardSchemaV1 | undefined = undefined,
36
+ TSession = unknown,
37
+ TEventPublisher extends EventPublisher<any> | undefined = undefined,
38
+ TEventPublisherServiceName extends string = string,
39
+ TAuthorizers extends readonly string[] = readonly string[],
40
+ TAuditStorage extends AuditStorage | undefined = undefined,
41
+ TAuditStorageServiceName extends string = string,
42
+ TAuditAction extends AuditableAction<string, unknown> = AuditableAction<
43
+ string,
44
+ unknown
45
+ >,
46
+ TDatabase = undefined,
47
+ TDatabaseServiceName extends string = string,
48
+ > extends BaseFunctionBuilder<
49
+ TInput,
50
+ OutSchema,
51
+ TServices,
52
+ TLogger,
53
+ TEventPublisher,
54
+ TEventPublisherServiceName,
55
+ TAuditStorage,
56
+ TAuditStorageServiceName,
57
+ TDatabase,
58
+ TDatabaseServiceName
59
+ > {
60
+ protected schemas: TInput = {} as TInput;
61
+ protected _description?: string;
62
+ protected _status?: SuccessStatus;
63
+ protected _tags?: string[];
64
+ protected _memorySize?: number;
65
+ protected _responseType: string = 'application/json';
66
+ _getSession: SessionFn<TServices, TLogger, TSession, TDatabase> = () =>
67
+ ({}) as TSession;
68
+ _authorize: AuthorizeFn<TServices, TLogger, TSession, TInput, TDatabase> =
69
+ () => true;
70
+ _rateLimit?: RateLimitConfig;
71
+ _availableAuthorizers: Authorizer[] = [];
72
+ _authorizerName?: TAuthorizers[number];
73
+ _actorExtractor?: ActorExtractor<TServices, TSession, TLogger>;
74
+ _audits: MappedAudit<TAuditAction, OutSchema>[] = [];
75
+ _customSecuritySchemes: Record<string, SecurityScheme> = {};
76
+ _rlsConfig?: RlsConfig<TServices, TSession, TLogger>;
77
+ _rlsBypass?: boolean;
78
+
79
+ constructor(
80
+ readonly route: TRoute,
81
+ readonly method: TMethod,
82
+ ) {
83
+ super(ConstructType.Endpoint);
84
+ }
85
+
86
+ // Internal setter for EndpointFactory to set default publisher
87
+ _setPublisher(
88
+ publisher: Service<TEventPublisherServiceName, TEventPublisher>,
89
+ ) {
90
+ this._publisher = publisher;
91
+ }
92
+
93
+ // Internal setter for EndpointFactory to set default auditor storage
94
+ _setAuditorStorage(
95
+ storage: Service<TAuditStorageServiceName, TAuditStorage>,
96
+ ) {
97
+ this._auditorStorage = storage;
98
+ }
99
+
100
+ // Internal setter for EndpointFactory to set default database service
101
+ _setDatabaseService(service: Service<TDatabaseServiceName, TDatabase>) {
102
+ this._databaseService = service;
103
+ }
104
+
105
+ description(description: string): this {
106
+ return cloneWith(this, { _description: description });
107
+ }
108
+
109
+ status(status: SuccessStatus): this {
110
+ return cloneWith(this, { _status: status });
111
+ }
112
+
113
+ override event<TEvent extends MappedEvent<TEventPublisher, OutSchema>>(
114
+ event: TEvent,
115
+ ): this {
116
+ // Replaced rather than pushed: a clone shares whatever array the field
117
+ // points at, so an in-place push would be seen by the base it came from.
118
+ return cloneWith(this, { _events: [...this._events, event] });
119
+ }
120
+
121
+ tags(tags: string[]): this {
122
+ return cloneWith(this, { _tags: tags });
123
+ }
124
+
125
+ memorySize(memorySize: number): this {
126
+ return cloneWith(this, { _memorySize: memorySize });
127
+ }
128
+
129
+ /**
130
+ * Set the response content type for this endpoint.
131
+ *
132
+ * Defaults to `'application/json'`. When set to any other value
133
+ * (e.g. `'text/html'`, `'text/plain'`), the response body is emitted
134
+ * as-is rather than JSON-serialized, and the `Content-Type` header
135
+ * reflects the declared value. Runtime overrides via `r.header()` still win.
136
+ *
137
+ * @param type - The MIME type to return (e.g. `'text/html'`)
138
+ *
139
+ * @example
140
+ * ```typescript
141
+ * e.get('/checkout-page')
142
+ * .output(z.string())
143
+ * .responseType('text/html')
144
+ * .handle(async () => '<html>...</html>');
145
+ * ```
146
+ */
147
+ responseType(type: string): this {
148
+ return cloneWith(this, { _responseType: type });
149
+ }
150
+
151
+ override publisher<T extends EventPublisher<any>, TName extends string>(
152
+ publisher: Service<TName, T>,
153
+ ): EndpointBuilder<
154
+ TRoute,
155
+ TMethod,
156
+ TInput,
157
+ TServices,
158
+ TLogger,
159
+ OutSchema,
160
+ TSession,
161
+ T,
162
+ TName,
163
+ TAuthorizers,
164
+ TAuditStorage,
165
+ TAuditStorageServiceName,
166
+ TAuditAction,
167
+ TDatabase,
168
+ TDatabaseServiceName
169
+ > {
170
+ return cloneWith(this, {
171
+ _publisher: publisher as unknown as Service<
172
+ TEventPublisherServiceName,
173
+ TEventPublisher
174
+ >,
175
+ }) as unknown as EndpointBuilder<
176
+ TRoute,
177
+ TMethod,
178
+ TInput,
179
+ TServices,
180
+ TLogger,
181
+ OutSchema,
182
+ TSession,
183
+ T,
184
+ TName,
185
+ TAuthorizers,
186
+ TAuditStorage,
187
+ TAuditStorageServiceName,
188
+ TAuditAction,
189
+ TDatabase,
190
+ TDatabaseServiceName
191
+ >;
192
+ }
193
+
194
+ body<T extends StandardSchemaV1>(
195
+ schema: T,
196
+ ): EndpointBuilder<
197
+ TRoute,
198
+ TMethod,
199
+ Omit<TInput, 'body'> & { body: T },
200
+ TServices,
201
+ TLogger,
202
+ OutSchema,
203
+ TSession,
204
+ TEventPublisher,
205
+ TEventPublisherServiceName,
206
+ TAuthorizers,
207
+ TAuditStorage,
208
+ TAuditStorageServiceName,
209
+ TAuditAction,
210
+ TDatabase,
211
+ TDatabaseServiceName
212
+ > {
213
+ // A new object rather than a field set on the shared one: a clone
214
+ // keeps its base's `schemas` reference.
215
+ // @ts-expect-error
216
+ return cloneWith(this, { schemas: { ...this.schemas, body: schema } });
217
+ }
218
+
219
+ search<T extends StandardSchemaV1>(
220
+ schema: T,
221
+ ): EndpointBuilder<
222
+ TRoute,
223
+ TMethod,
224
+ Omit<TInput, 'query'> & { query: T },
225
+ TServices,
226
+ TLogger,
227
+ OutSchema,
228
+ TSession,
229
+ TEventPublisher,
230
+ TEventPublisherServiceName,
231
+ TAuthorizers,
232
+ TAuditStorage,
233
+ TAuditStorageServiceName,
234
+ TAuditAction,
235
+ TDatabase,
236
+ TDatabaseServiceName
237
+ > {
238
+ // A new object rather than a field set on the shared one: a clone
239
+ // keeps its base's `schemas` reference.
240
+ // @ts-expect-error
241
+ return cloneWith(this, { schemas: { ...this.schemas, query: schema } });
242
+ }
243
+
244
+ query<T extends StandardSchemaV1>(
245
+ schema: T,
246
+ ): EndpointBuilder<
247
+ TRoute,
248
+ TMethod,
249
+ Omit<TInput, 'query'> & { query: T },
250
+ TServices,
251
+ TLogger,
252
+ OutSchema,
253
+ TSession,
254
+ TEventPublisher,
255
+ TEventPublisherServiceName,
256
+ TAuthorizers,
257
+ TAuditStorage,
258
+ TAuditStorageServiceName,
259
+ TAuditAction,
260
+ TDatabase,
261
+ TDatabaseServiceName
262
+ > {
263
+ return this.search(schema);
264
+ }
265
+
266
+ params<T extends StandardSchemaV1>(
267
+ schema: T,
268
+ ): EndpointBuilder<
269
+ TRoute,
270
+ TMethod,
271
+ Omit<TInput, 'params'> & { params: T },
272
+ TServices,
273
+ TLogger,
274
+ OutSchema,
275
+ TSession,
276
+ TEventPublisher,
277
+ TEventPublisherServiceName,
278
+ TAuthorizers,
279
+ TAuditStorage,
280
+ TAuditStorageServiceName,
281
+ TAuditAction,
282
+ TDatabase,
283
+ TDatabaseServiceName
284
+ > {
285
+ // A new object rather than a field set on the shared one: a clone
286
+ // keeps its base's `schemas` reference.
287
+ // @ts-expect-error
288
+ return cloneWith(this, { schemas: { ...this.schemas, params: schema } });
289
+ }
290
+
291
+ authorize(
292
+ fn: AuthorizeFn<TServices, TLogger, TSession, TInput, TDatabase>,
293
+ ): this {
294
+ return cloneWith(this, { _authorize: fn });
295
+ }
296
+
297
+ rateLimit(config: RateLimitConfig): this {
298
+ return cloneWith(this, { _rateLimit: config });
299
+ }
300
+
301
+ authorizer(
302
+ name: TAuthorizers[number] | 'none',
303
+ ): EndpointBuilder<
304
+ TRoute,
305
+ TMethod,
306
+ TInput,
307
+ TServices,
308
+ TLogger,
309
+ OutSchema,
310
+ TSession,
311
+ TEventPublisher,
312
+ TEventPublisherServiceName,
313
+ TAuthorizers,
314
+ TAuditStorage,
315
+ TAuditStorageServiceName,
316
+ TAuditAction,
317
+ TDatabase,
318
+ TDatabaseServiceName
319
+ > {
320
+ // Special case: 'none' explicitly marks endpoint as having no authorizer
321
+ if (name === 'none') {
322
+ return cloneWith(this, { _authorizerName: undefined });
323
+ }
324
+
325
+ // Validate that the authorizer exists in available authorizers
326
+ const authorizerExists = this._availableAuthorizers.some(
327
+ (a) => a.name === name,
328
+ );
329
+ if (!authorizerExists && this._availableAuthorizers.length > 0) {
330
+ const available = this._availableAuthorizers
331
+ .map((a) => a.name)
332
+ .join(', ');
333
+ throw new Error(
334
+ `Authorizer "${name as string}" not found in available authorizers: ${available}`,
335
+ );
336
+ }
337
+ return cloneWith(this, { _authorizerName: name });
338
+ }
339
+
340
+ services<T extends Service[]>(
341
+ services: T,
342
+ ): EndpointBuilder<
343
+ TRoute,
344
+ TMethod,
345
+ TInput,
346
+ [...TServices, ...T],
347
+ TLogger,
348
+ OutSchema,
349
+ TSession,
350
+ TEventPublisher,
351
+ TEventPublisherServiceName,
352
+ TAuthorizers,
353
+ TAuditStorage,
354
+ TAuditStorageServiceName,
355
+ TAuditAction,
356
+ TDatabase,
357
+ TDatabaseServiceName
358
+ > {
359
+ return cloneWith(this, {
360
+ _services: uniqBy(
361
+ [...this._services, ...services],
362
+ (s) => s.serviceName,
363
+ ) as TServices,
364
+ }) as unknown as EndpointBuilder<
365
+ TRoute,
366
+ TMethod,
367
+ TInput,
368
+ [...TServices, ...T],
369
+ TLogger,
370
+ OutSchema,
371
+ TSession,
372
+ TEventPublisher,
373
+ TEventPublisherServiceName,
374
+ TAuthorizers,
375
+ TAuditStorage,
376
+ TAuditStorageServiceName,
377
+ TAuditAction,
378
+ TDatabase,
379
+ TDatabaseServiceName
380
+ >;
381
+ }
382
+
383
+ logger<T extends Logger>(
384
+ logger: T,
385
+ ): EndpointBuilder<
386
+ TRoute,
387
+ TMethod,
388
+ TInput,
389
+ TServices,
390
+ T,
391
+ OutSchema,
392
+ TSession,
393
+ TEventPublisher,
394
+ TEventPublisherServiceName,
395
+ TAuthorizers,
396
+ TAuditStorage,
397
+ TAuditStorageServiceName,
398
+ TAuditAction,
399
+ TDatabase,
400
+ TDatabaseServiceName
401
+ > {
402
+ return cloneWith(this, {
403
+ _logger: logger as unknown as TLogger,
404
+ }) as unknown as EndpointBuilder<
405
+ TRoute,
406
+ TMethod,
407
+ TInput,
408
+ TServices,
409
+ T,
410
+ OutSchema,
411
+ TSession,
412
+ TEventPublisher,
413
+ TEventPublisherServiceName,
414
+ TAuthorizers,
415
+ TAuditStorage,
416
+ TAuditStorageServiceName,
417
+ TAuditAction,
418
+ TDatabase,
419
+ TDatabaseServiceName
420
+ >;
421
+ }
422
+
423
+ output<T extends StandardSchemaV1>(
424
+ schema: T,
425
+ ): EndpointBuilder<
426
+ TRoute,
427
+ TMethod,
428
+ TInput,
429
+ TServices,
430
+ TLogger,
431
+ T,
432
+ TSession,
433
+ TEventPublisher,
434
+ TEventPublisherServiceName,
435
+ TAuthorizers,
436
+ TAuditStorage,
437
+ TAuditStorageServiceName,
438
+ TAuditAction,
439
+ TDatabase,
440
+ TDatabaseServiceName
441
+ > {
442
+ return cloneWith(this, {
443
+ outputSchema: schema as unknown as OutSchema,
444
+ }) as unknown as EndpointBuilder<
445
+ TRoute,
446
+ TMethod,
447
+ TInput,
448
+ TServices,
449
+ TLogger,
450
+ T,
451
+ TSession,
452
+ TEventPublisher,
453
+ TEventPublisherServiceName,
454
+ TAuthorizers,
455
+ TAuditStorage,
456
+ TAuditStorageServiceName,
457
+ TAuditAction,
458
+ TDatabase,
459
+ TDatabaseServiceName
460
+ >;
461
+ }
462
+
463
+ /**
464
+ * Set the auditor storage service for this endpoint.
465
+ * This enables audit functionality and makes `auditor` available in the handler context.
466
+ * The audit action type is automatically inferred from the storage's generic parameter.
467
+ */
468
+ override auditor<T extends AuditStorage<any>, TName extends string>(
469
+ storage: Service<TName, T>,
470
+ ): EndpointBuilder<
471
+ TRoute,
472
+ TMethod,
473
+ TInput,
474
+ TServices,
475
+ TLogger,
476
+ OutSchema,
477
+ TSession,
478
+ TEventPublisher,
479
+ TEventPublisherServiceName,
480
+ TAuthorizers,
481
+ T,
482
+ TName,
483
+ ExtractStorageAuditAction<T>,
484
+ TDatabase,
485
+ TDatabaseServiceName
486
+ > {
487
+ return cloneWith(this, {
488
+ _auditorStorage: storage as unknown as Service<
489
+ TAuditStorageServiceName,
490
+ TAuditStorage
491
+ >,
492
+ }) as unknown as EndpointBuilder<
493
+ TRoute,
494
+ TMethod,
495
+ TInput,
496
+ TServices,
497
+ TLogger,
498
+ OutSchema,
499
+ TSession,
500
+ TEventPublisher,
501
+ TEventPublisherServiceName,
502
+ TAuthorizers,
503
+ T,
504
+ TName,
505
+ ExtractStorageAuditAction<T>,
506
+ TDatabase,
507
+ TDatabaseServiceName
508
+ >;
509
+ }
510
+
511
+ /**
512
+ * Set the actor extractor function for audit records.
513
+ * The actor is extracted from the request context and attached to all audits.
514
+ */
515
+ actor(
516
+ extractor: ActorExtractor<TServices, TSession, TLogger>,
517
+ ): EndpointBuilder<
518
+ TRoute,
519
+ TMethod,
520
+ TInput,
521
+ TServices,
522
+ TLogger,
523
+ OutSchema,
524
+ TSession,
525
+ TEventPublisher,
526
+ TEventPublisherServiceName,
527
+ TAuthorizers,
528
+ TAuditStorage,
529
+ TAuditStorageServiceName,
530
+ TAuditAction,
531
+ TDatabase,
532
+ TDatabaseServiceName
533
+ > {
534
+ return cloneWith(this, { _actorExtractor: extractor });
535
+ }
536
+
537
+ /**
538
+ * Add declarative audit definitions that are processed after the handler executes.
539
+ * Similar to `.event()` for events, but for audits.
540
+ *
541
+ * @example
542
+ * ```typescript
543
+ * .audit<AppAuditAction>([
544
+ * {
545
+ * type: 'user.created',
546
+ * payload: (response) => ({ userId: response.id, email: response.email }),
547
+ * when: (response) => response.active,
548
+ * entityId: (response) => response.id,
549
+ * table: 'users',
550
+ * },
551
+ * ])
552
+ * ```
553
+ */
554
+ audit(audits: MappedAudit<TAuditAction, OutSchema>[]): this {
555
+ return cloneWith(this, { _audits: audits });
556
+ }
557
+
558
+ /**
559
+ * Set the database service for this endpoint.
560
+ * The database will be available in the handler context as `db`.
561
+ * When audit storage is configured and uses the same database,
562
+ * `db` will automatically be the transaction for ACID compliance.
563
+ *
564
+ * @example
565
+ * ```typescript
566
+ * .database(databaseService)
567
+ * .handle(async ({ db }) => {
568
+ * // db is the raw database or transaction (when auditor uses same db)
569
+ * return await db.selectFrom('users').selectAll().execute();
570
+ * })
571
+ * ```
572
+ */
573
+ override database<T, TName extends string>(
574
+ service: Service<TName, T>,
575
+ ): EndpointBuilder<
576
+ TRoute,
577
+ TMethod,
578
+ TInput,
579
+ TServices,
580
+ TLogger,
581
+ OutSchema,
582
+ TSession,
583
+ TEventPublisher,
584
+ TEventPublisherServiceName,
585
+ TAuthorizers,
586
+ TAuditStorage,
587
+ TAuditStorageServiceName,
588
+ TAuditAction,
589
+ T,
590
+ TName
591
+ > {
592
+ return cloneWith(this, {
593
+ _databaseService: service as unknown as Service<
594
+ TDatabaseServiceName,
595
+ TDatabase
596
+ >,
597
+ }) as unknown as EndpointBuilder<
598
+ TRoute,
599
+ TMethod,
600
+ TInput,
601
+ TServices,
602
+ TLogger,
603
+ OutSchema,
604
+ TSession,
605
+ TEventPublisher,
606
+ TEventPublisherServiceName,
607
+ TAuthorizers,
608
+ TAuditStorage,
609
+ TAuditStorageServiceName,
610
+ TAuditAction,
611
+ T,
612
+ TName
613
+ >;
614
+ }
615
+
616
+ /**
617
+ * Configure RLS (Row-Level Security) context for this endpoint.
618
+ * Pass `false` or `RLS_BYPASS` to explicitly bypass RLS for this endpoint.
619
+ *
620
+ * @example
621
+ * ```typescript
622
+ * // Custom RLS config for this endpoint
623
+ * .rls({
624
+ * extractor: ({ session }) => ({
625
+ * user_id: session.userId,
626
+ * tenant_id: session.tenantId,
627
+ * }),
628
+ * prefix: 'app',
629
+ * })
630
+ *
631
+ * // Bypass RLS (for admin endpoints)
632
+ * .rls(false)
633
+ * ```
634
+ */
635
+ rls(
636
+ config: RlsConfig<TServices, TSession, TLogger> | false | RlsBypass,
637
+ ): this {
638
+ if (config === false || config === RLS_BYPASS) {
639
+ return cloneWith(this, { _rlsBypass: true, _rlsConfig: undefined });
640
+ }
641
+ return cloneWith(this, { _rlsConfig: config, _rlsBypass: false });
642
+ }
643
+
644
+ /**
645
+ * Explicitly bypass RLS for this endpoint.
646
+ * Useful for admin operations that need unrestricted database access.
647
+ *
648
+ * @example
649
+ * ```typescript
650
+ * .rlsBypass()
651
+ * .handle(async ({ db }) => {
652
+ * // Full access, no RLS filtering
653
+ * return db.selectFrom('orders').selectAll().execute();
654
+ * })
655
+ * ```
656
+ */
657
+ rlsBypass(): this {
658
+ return cloneWith(this, { _rlsBypass: true, _rlsConfig: undefined });
659
+ }
660
+
661
+ // EndpointBuilder doesn't have a generic input method - it uses body, query, params instead
662
+ input(_schema: any): any {
663
+ throw new Error(
664
+ 'EndpointBuilder does not support generic input. Use body(), query(), or params() instead.',
665
+ );
666
+ }
667
+
668
+ handle(
669
+ fn: EndpointHandler<
670
+ TInput,
671
+ TServices,
672
+ TLogger,
673
+ OutSchema,
674
+ TSession,
675
+ TDatabase,
676
+ TAuditStorage,
677
+ TAuditAction
678
+ >,
679
+ ): Endpoint<
680
+ TRoute,
681
+ TMethod,
682
+ TInput,
683
+ OutSchema,
684
+ TServices,
685
+ TLogger,
686
+ TSession,
687
+ TEventPublisher,
688
+ TEventPublisherServiceName,
689
+ TAuditStorage,
690
+ TAuditStorageServiceName,
691
+ TAuditAction,
692
+ TDatabase,
693
+ TDatabaseServiceName
694
+ > {
695
+ // Find authorizer metadata if name is set
696
+ // If the authorizer name is set but not in availableAuthorizers, create a simple authorizer object
697
+ let authorizer: Authorizer | undefined;
698
+ if (this._authorizerName) {
699
+ const existingAuthorizer = this._availableAuthorizers.find(
700
+ (a) => a.name === this._authorizerName,
701
+ );
702
+
703
+ if (existingAuthorizer) {
704
+ authorizer = existingAuthorizer;
705
+ } else {
706
+ // Create authorizer with security scheme if available (built-in or custom)
707
+ const securityScheme = getSecurityScheme(
708
+ this._authorizerName as string,
709
+ this._customSecuritySchemes,
710
+ );
711
+ authorizer = {
712
+ name: this._authorizerName as string,
713
+ securityScheme,
714
+ };
715
+ }
716
+ }
717
+
718
+ const endpoint = new Endpoint({
719
+ fn,
720
+ method: this.method,
721
+ route: this.route,
722
+ description: this._description,
723
+ tags: this._tags,
724
+ input: this.schemas,
725
+ output: this.outputSchema,
726
+ services: this._services,
727
+ logger: this._logger,
728
+ timeout: this._timeout,
729
+ memorySize: this._memorySize,
730
+ authorize: this._authorize,
731
+ status: this._status,
732
+ getSession: this._getSession,
733
+ rateLimit: this._rateLimit,
734
+ publisherService: this._publisher,
735
+ events: this._events,
736
+ authorizer,
737
+ auditorStorageService: this._auditorStorage,
738
+ actorExtractor: this._actorExtractor,
739
+ audits: this._audits,
740
+ databaseService: this._databaseService,
741
+ rlsConfig: this._rlsConfig,
742
+ rlsBypass: this._rlsBypass,
743
+ responseType: this._responseType,
744
+ });
745
+ endpoint.monitors = this._monitors;
746
+
747
+ return endpoint;
748
+ }
749
+ }