@geekmidas/constructs 10.0.0-alpha.13 → 10.0.0-alpha.131

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 (444) hide show
  1. package/README.md +222 -158
  2. package/dist/Construct-127M7yrl.d.cts +231 -0
  3. package/dist/Construct-127M7yrl.d.cts.map +1 -0
  4. package/dist/{Construct-BeYVu_QF.mjs → Construct-CGuc_Ijk.mjs} +8 -9
  5. package/dist/Construct-CGuc_Ijk.mjs.map +1 -0
  6. package/dist/{Construct-DqdlARxq.cjs → Construct-DorKS0Ua.cjs} +8 -9
  7. package/dist/Construct-DorKS0Ua.cjs.map +1 -0
  8. package/dist/Construct-DySlwh8o.d.mts +231 -0
  9. package/dist/Construct-DySlwh8o.d.mts.map +1 -0
  10. package/dist/{Cron-DKqnnTdH.d.cts → Cron-CFkpEys6.d.cts} +14 -7
  11. package/dist/Cron-CFkpEys6.d.cts.map +1 -0
  12. package/dist/{Cron-SyqS5oWJ.d.mts → Cron-CQoDSu-n.d.mts} +14 -7
  13. package/dist/Cron-CQoDSu-n.d.mts.map +1 -0
  14. package/dist/CronBuilder-1W-G_i15.d.mts +47 -0
  15. package/dist/CronBuilder-1W-G_i15.d.mts.map +1 -0
  16. package/dist/{CronBuilder-D_0HNBTr.mjs → CronBuilder-BJ5LoadF.mjs} +28 -11
  17. package/dist/CronBuilder-BJ5LoadF.mjs.map +1 -0
  18. package/dist/{CronBuilder-BdnI6lxF.cjs → CronBuilder-B_NSP-Y5.cjs} +27 -10
  19. package/dist/CronBuilder-B_NSP-Y5.cjs.map +1 -0
  20. package/dist/CronBuilder-OaCRRFVk.d.cts +47 -0
  21. package/dist/CronBuilder-OaCRRFVk.d.cts.map +1 -0
  22. package/dist/{Endpoint-C6yyHpRS.d.cts → Endpoint-BEh-jW-f.d.cts} +122 -41
  23. package/dist/Endpoint-BEh-jW-f.d.cts.map +1 -0
  24. package/dist/Endpoint-BcUorcBa.cjs +576 -0
  25. package/dist/Endpoint-BcUorcBa.cjs.map +1 -0
  26. package/dist/Endpoint-BgvG36NO.mjs +547 -0
  27. package/dist/Endpoint-BgvG36NO.mjs.map +1 -0
  28. package/dist/{Endpoint-DuT4TEEq.d.mts → Endpoint-DTXDggNl.d.mts} +124 -43
  29. package/dist/Endpoint-DTXDggNl.d.mts.map +1 -0
  30. package/dist/{index-BPSZ_Lp_.d.cts → EndpointFactory-B2dCS9dy.d.cts} +187 -104
  31. package/dist/EndpointFactory-B2dCS9dy.d.cts.map +1 -0
  32. package/dist/{EndpointFactory-ptPR1cXw.mjs → EndpointFactory-C1NlpCAS.mjs} +270 -54
  33. package/dist/EndpointFactory-C1NlpCAS.mjs.map +1 -0
  34. package/dist/{index-BoZ-iisU.d.mts → EndpointFactory-D2HXcUrJ.d.mts} +188 -105
  35. package/dist/EndpointFactory-D2HXcUrJ.d.mts.map +1 -0
  36. package/dist/{EndpointFactory-M8OQKZRY.cjs → EndpointFactory-gqmIRVWg.cjs} +310 -52
  37. package/dist/EndpointFactory-gqmIRVWg.cjs.map +1 -0
  38. package/dist/Function-BIEsY0Hm.d.cts +76 -0
  39. package/dist/Function-BIEsY0Hm.d.cts.map +1 -0
  40. package/dist/Function-DfMzTGS4.d.mts +76 -0
  41. package/dist/Function-DfMzTGS4.d.mts.map +1 -0
  42. package/dist/{HonoEndpointAdaptor-7QagYKdP.cjs → HonoEndpointAdaptor-BJlj20fQ.cjs} +79 -31
  43. package/dist/HonoEndpointAdaptor-BJlj20fQ.cjs.map +1 -0
  44. package/dist/{HonoEndpointAdaptor-CYHA0WAt.mjs → HonoEndpointAdaptor-BlbkUDNo.mjs} +76 -28
  45. package/dist/HonoEndpointAdaptor-BlbkUDNo.mjs.map +1 -0
  46. package/dist/ObjectSubscriberBuilder-HmBwFn2o.d.mts +129 -0
  47. package/dist/ObjectSubscriberBuilder-HmBwFn2o.d.mts.map +1 -0
  48. package/dist/ObjectSubscriberBuilder-l-64yUiF.d.cts +129 -0
  49. package/dist/ObjectSubscriberBuilder-l-64yUiF.d.cts.map +1 -0
  50. package/dist/ProcessorBuilder-B2_stA8f.d.mts +216 -0
  51. package/dist/ProcessorBuilder-B2_stA8f.d.mts.map +1 -0
  52. package/dist/ProcessorBuilder-C62bIOwj.d.cts +216 -0
  53. package/dist/ProcessorBuilder-C62bIOwj.d.cts.map +1 -0
  54. package/dist/{Queue-D9X6OoON.d.mts → Queue-BnK3UH8r.d.mts} +42 -41
  55. package/dist/Queue-BnK3UH8r.d.mts.map +1 -0
  56. package/dist/{Queue-DYPB2KWL.d.cts → Queue-C4rijiM7.d.cts} +43 -42
  57. package/dist/Queue-C4rijiM7.d.cts.map +1 -0
  58. package/dist/Queue-D4Iaidrs.cjs +109 -0
  59. package/dist/Queue-D4Iaidrs.cjs.map +1 -0
  60. package/dist/Queue-u8w8_HpE.mjs +104 -0
  61. package/dist/Queue-u8w8_HpE.mjs.map +1 -0
  62. package/dist/QueueBuilder-2wP5lEC8.mjs +118 -0
  63. package/dist/QueueBuilder-2wP5lEC8.mjs.map +1 -0
  64. package/dist/QueueBuilder-B3vL1ED2.d.mts +75 -0
  65. package/dist/QueueBuilder-B3vL1ED2.d.mts.map +1 -0
  66. package/dist/QueueBuilder-BcPBQSSX.d.cts +75 -0
  67. package/dist/QueueBuilder-BcPBQSSX.d.cts.map +1 -0
  68. package/dist/QueueBuilder-BxsZ9o5z.cjs +135 -0
  69. package/dist/QueueBuilder-BxsZ9o5z.cjs.map +1 -0
  70. package/dist/Subscriber-BdCtfFXL.d.cts +73 -0
  71. package/dist/Subscriber-BdCtfFXL.d.cts.map +1 -0
  72. package/dist/Subscriber-DDo4HFNn.d.mts +73 -0
  73. package/dist/Subscriber-DDo4HFNn.d.mts.map +1 -0
  74. package/dist/SubscriberBuilder-3msj1U2w.mjs +230 -0
  75. package/dist/SubscriberBuilder-3msj1U2w.mjs.map +1 -0
  76. package/dist/SubscriberBuilder-CQst6Iz3.cjs +253 -0
  77. package/dist/SubscriberBuilder-CQst6Iz3.cjs.map +1 -0
  78. package/dist/Topic-DN2gYJ-p.mjs +99 -0
  79. package/dist/Topic-DN2gYJ-p.mjs.map +1 -0
  80. package/dist/Topic-Dp9Q7Lj2.cjs +104 -0
  81. package/dist/Topic-Dp9Q7Lj2.cjs.map +1 -0
  82. package/dist/adaptors/aws.cjs +134 -160
  83. package/dist/adaptors/aws.cjs.map +1 -1
  84. package/dist/adaptors/aws.d.cts +57 -48
  85. package/dist/adaptors/aws.d.cts.map +1 -1
  86. package/dist/adaptors/aws.d.mts +58 -49
  87. package/dist/adaptors/aws.d.mts.map +1 -1
  88. package/dist/adaptors/aws.mjs +130 -157
  89. package/dist/adaptors/aws.mjs.map +1 -1
  90. package/dist/adaptors/hono.cjs +1 -1
  91. package/dist/adaptors/hono.d.cts +5 -6
  92. package/dist/adaptors/hono.d.cts.map +1 -1
  93. package/dist/adaptors/hono.d.mts +6 -7
  94. package/dist/adaptors/hono.d.mts.map +1 -1
  95. package/dist/adaptors/hono.mjs +1 -1
  96. package/dist/adaptors/testing.cjs +824 -38
  97. package/dist/adaptors/testing.cjs.map +1 -1
  98. package/dist/adaptors/testing.d.cts +368 -39
  99. package/dist/adaptors/testing.d.cts.map +1 -1
  100. package/dist/adaptors/testing.d.mts +367 -38
  101. package/dist/adaptors/testing.d.mts.map +1 -1
  102. package/dist/adaptors/testing.mjs +802 -34
  103. package/dist/adaptors/testing.mjs.map +1 -1
  104. package/dist/auth-BMCJN30Y.d.cts +268 -0
  105. package/dist/auth-BMCJN30Y.d.cts.map +1 -0
  106. package/dist/auth-D_0788uW.d.mts +268 -0
  107. package/dist/auth-D_0788uW.d.mts.map +1 -0
  108. package/dist/auth.cjs +289 -46
  109. package/dist/auth.cjs.map +1 -1
  110. package/dist/auth.d.cts +2 -104
  111. package/dist/auth.d.mts +2 -104
  112. package/dist/auth.mjs +285 -48
  113. package/dist/auth.mjs.map +1 -1
  114. package/dist/cache-5QZzh5Er.d.mts +44 -0
  115. package/dist/cache-5QZzh5Er.d.mts.map +1 -0
  116. package/dist/cache-DnGDGly3.d.cts +44 -0
  117. package/dist/cache-DnGDGly3.d.cts.map +1 -0
  118. package/dist/cache.d.cts +2 -43
  119. package/dist/cache.d.mts +2 -43
  120. package/dist/cipher-C1lEFX63.mjs +225 -0
  121. package/dist/cipher-C1lEFX63.mjs.map +1 -0
  122. package/dist/cipher-CVxfwLjk.cjs +332 -0
  123. package/dist/cipher-CVxfwLjk.cjs.map +1 -0
  124. package/dist/cipher-DSDxPRIp.d.cts +106 -0
  125. package/dist/cipher-DSDxPRIp.d.cts.map +1 -0
  126. package/dist/cipher-DSDxPRIp.d.mts +106 -0
  127. package/dist/cipher-DSDxPRIp.d.mts.map +1 -0
  128. package/dist/{construct-interface-DPlxfpoS.d.mts → construct-interface-B1AfqRl4.d.cts} +42 -8
  129. package/dist/construct-interface-B1AfqRl4.d.cts.map +1 -0
  130. package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-ZvYQbivO.d.mts} +42 -8
  131. package/dist/construct-interface-ZvYQbivO.d.mts.map +1 -0
  132. package/dist/construct-interface.cjs +30 -4
  133. package/dist/construct-interface.cjs.map +1 -1
  134. package/dist/construct-interface.d.cts +2 -2
  135. package/dist/construct-interface.d.mts +2 -2
  136. package/dist/construct-interface.mjs +30 -5
  137. package/dist/construct-interface.mjs.map +1 -1
  138. package/dist/credential-DYymbp_7.cjs +257 -0
  139. package/dist/credential-DYymbp_7.cjs.map +1 -0
  140. package/dist/credential-DfSAOOdY.mjs +222 -0
  141. package/dist/credential-DfSAOOdY.mjs.map +1 -0
  142. package/dist/credential.cjs +7 -129
  143. package/dist/credential.d.cts +2 -58
  144. package/dist/credential.d.mts +2 -58
  145. package/dist/credential.mjs +2 -128
  146. package/dist/crons/index.cjs +126 -1
  147. package/dist/crons/index.cjs.map +1 -1
  148. package/dist/crons/index.d.cts +43 -3
  149. package/dist/crons/index.d.cts.map +1 -1
  150. package/dist/crons/index.d.mts +43 -3
  151. package/dist/crons/index.d.mts.map +1 -1
  152. package/dist/crons/index.mjs +125 -2
  153. package/dist/crons/index.mjs.map +1 -1
  154. package/dist/database/kysely.cjs +3 -194
  155. package/dist/database/kysely.d.cts +2 -149
  156. package/dist/database/kysely.d.mts +2 -149
  157. package/dist/database/kysely.mjs +2 -192
  158. package/dist/email.d.cts +1 -1
  159. package/dist/email.d.cts.map +1 -1
  160. package/dist/email.d.mts +2 -2
  161. package/dist/email.d.mts.map +1 -1
  162. package/dist/encryption/kms.cjs +95 -0
  163. package/dist/encryption/kms.cjs.map +1 -0
  164. package/dist/encryption/kms.d.cts +7 -0
  165. package/dist/encryption/kms.d.cts.map +1 -0
  166. package/dist/encryption/kms.d.mts +7 -0
  167. package/dist/encryption/kms.d.mts.map +1 -0
  168. package/dist/encryption/kms.mjs +93 -0
  169. package/dist/encryption/kms.mjs.map +1 -0
  170. package/dist/encryption.cjs +116 -0
  171. package/dist/encryption.cjs.map +1 -0
  172. package/dist/encryption.d.cts +37 -0
  173. package/dist/encryption.d.cts.map +1 -0
  174. package/dist/encryption.d.mts +37 -0
  175. package/dist/encryption.d.mts.map +1 -0
  176. package/dist/encryption.mjs +101 -0
  177. package/dist/encryption.mjs.map +1 -0
  178. package/dist/endpoints/index.cjs +25 -10
  179. package/dist/endpoints/index.d.cts +105 -3
  180. package/dist/endpoints/index.d.cts.map +1 -0
  181. package/dist/endpoints/index.d.mts +105 -3
  182. package/dist/endpoints/index.d.mts.map +1 -0
  183. package/dist/endpoints/index.mjs +5 -4
  184. package/dist/expire-C586zznE.d.cts +38 -0
  185. package/dist/expire-C586zznE.d.cts.map +1 -0
  186. package/dist/expire-C586zznE.d.mts +38 -0
  187. package/dist/expire-C586zznE.d.mts.map +1 -0
  188. package/dist/expire-CieftS01.cjs +67 -0
  189. package/dist/expire-CieftS01.cjs.map +1 -0
  190. package/dist/expire-CpzUAfr9.mjs +50 -0
  191. package/dist/expire-CpzUAfr9.mjs.map +1 -0
  192. package/dist/external-api.cjs +106 -0
  193. package/dist/external-api.cjs.map +1 -0
  194. package/dist/external-api.d.cts +2 -0
  195. package/dist/external-api.d.mts +2 -0
  196. package/dist/external-api.mjs +103 -0
  197. package/dist/external-api.mjs.map +1 -0
  198. package/dist/fake-BUgcX2Dk.d.cts +201 -0
  199. package/dist/fake-BUgcX2Dk.d.cts.map +1 -0
  200. package/dist/fake-D472nkKb.d.mts +201 -0
  201. package/dist/fake-D472nkKb.d.mts.map +1 -0
  202. package/dist/file-server.cjs +123 -30
  203. package/dist/file-server.cjs.map +1 -1
  204. package/dist/file-server.d.cts +115 -1
  205. package/dist/file-server.d.cts.map +1 -1
  206. package/dist/file-server.d.mts +115 -1
  207. package/dist/file-server.d.mts.map +1 -1
  208. package/dist/file-server.mjs +122 -32
  209. package/dist/file-server.mjs.map +1 -1
  210. package/dist/functions/index.cjs +1 -1
  211. package/dist/functions/index.d.cts +2 -1
  212. package/dist/functions/index.d.mts +2 -1
  213. package/dist/functions/index.mjs +1 -1
  214. package/dist/{functions-C53GW2eQ.mjs → functions-BvIDQKAA.mjs} +117 -22
  215. package/dist/functions-BvIDQKAA.mjs.map +1 -0
  216. package/dist/{functions-B6qCvfmy.cjs → functions-DLF6-IK8.cjs} +122 -18
  217. package/dist/functions-DLF6-IK8.cjs.map +1 -0
  218. package/dist/index-BtzMzhMA.d.cts +115 -0
  219. package/dist/index-BtzMzhMA.d.cts.map +1 -0
  220. package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
  221. package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
  222. package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
  223. package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
  224. package/dist/index-DuriFjYD.d.mts +115 -0
  225. package/dist/index-DuriFjYD.d.mts.map +1 -0
  226. package/dist/index.cjs +4 -1
  227. package/dist/index.d.cts +26 -3
  228. package/dist/index.d.cts.map +1 -0
  229. package/dist/index.d.mts +26 -3
  230. package/dist/index.d.mts.map +1 -0
  231. package/dist/index.mjs +3 -2
  232. package/dist/kysely-BHYV-WC-.d.cts +216 -0
  233. package/dist/kysely-BHYV-WC-.d.cts.map +1 -0
  234. package/dist/kysely-CAW3QSqp.d.mts +216 -0
  235. package/dist/kysely-CAW3QSqp.d.mts.map +1 -0
  236. package/dist/kysely-Cs4uPO8k.mjs +371 -0
  237. package/dist/kysely-Cs4uPO8k.mjs.map +1 -0
  238. package/dist/kysely-CukArHJ0.cjs +384 -0
  239. package/dist/kysely-CukArHJ0.cjs.map +1 -0
  240. package/dist/{telemetry-DGcFlVpB.d.cts → lambdaTelemetry-8vnmVZQ5.d.cts} +2 -2
  241. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +1 -0
  242. package/dist/{telemetry-DGcFlVpB.d.mts → lambdaTelemetry-8vnmVZQ5.d.mts} +2 -2
  243. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +1 -0
  244. package/dist/mobile-app.cjs +74 -0
  245. package/dist/mobile-app.cjs.map +1 -0
  246. package/dist/mobile-app.d.cts +73 -0
  247. package/dist/mobile-app.d.cts.map +1 -0
  248. package/dist/mobile-app.d.mts +73 -0
  249. package/dist/mobile-app.d.mts.map +1 -0
  250. package/dist/mobile-app.mjs +73 -0
  251. package/dist/mobile-app.mjs.map +1 -0
  252. package/dist/object-storage.cjs +8 -1
  253. package/dist/object-storage.cjs.map +1 -1
  254. package/dist/object-storage.d.cts +10 -1
  255. package/dist/object-storage.d.cts.map +1 -1
  256. package/dist/object-storage.d.mts +10 -1
  257. package/dist/object-storage.d.mts.map +1 -1
  258. package/dist/object-storage.mjs +7 -2
  259. package/dist/object-storage.mjs.map +1 -1
  260. package/dist/pattern-C1CEcglD.mjs +241 -0
  261. package/dist/pattern-C1CEcglD.mjs.map +1 -0
  262. package/dist/pattern-QFaUIr77.cjs +288 -0
  263. package/dist/pattern-QFaUIr77.cjs.map +1 -0
  264. package/dist/processors/index.cjs +214 -0
  265. package/dist/processors/index.cjs.map +1 -0
  266. package/dist/processors/index.d.cts +78 -0
  267. package/dist/processors/index.d.cts.map +1 -0
  268. package/dist/processors/index.d.mts +78 -0
  269. package/dist/processors/index.d.mts.map +1 -0
  270. package/dist/processors/index.mjs +193 -0
  271. package/dist/processors/index.mjs.map +1 -0
  272. package/dist/queue/index.cjs +5 -192
  273. package/dist/queue/index.d.cts +3 -53
  274. package/dist/queue/index.d.mts +3 -53
  275. package/dist/queue/index.mjs +3 -190
  276. package/dist/random-password.cjs +86 -0
  277. package/dist/random-password.cjs.map +1 -0
  278. package/dist/random-password.d.cts +30 -0
  279. package/dist/random-password.d.cts.map +1 -0
  280. package/dist/random-password.d.mts +30 -0
  281. package/dist/random-password.d.mts.map +1 -0
  282. package/dist/random-password.mjs +84 -0
  283. package/dist/random-password.mjs.map +1 -0
  284. package/dist/{lazyAccessors-BHtcqgz2.mjs → readRequestBody-BTIl3k-D.mjs} +99 -39
  285. package/dist/readRequestBody-BTIl3k-D.mjs.map +1 -0
  286. package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-Dej_L3c4.cjs} +118 -46
  287. package/dist/readRequestBody-Dej_L3c4.cjs.map +1 -0
  288. package/dist/requestLogger-BZcXwdBs.cjs +207 -0
  289. package/dist/requestLogger-BZcXwdBs.cjs.map +1 -0
  290. package/dist/requestLogger-pA4gi3E1.mjs +178 -0
  291. package/dist/requestLogger-pA4gi3E1.mjs.map +1 -0
  292. package/dist/rest-api.cjs +76 -43
  293. package/dist/rest-api.cjs.map +1 -1
  294. package/dist/rest-api.d.cts +64 -31
  295. package/dist/rest-api.d.cts.map +1 -1
  296. package/dist/rest-api.d.mts +64 -31
  297. package/dist/rest-api.d.mts.map +1 -1
  298. package/dist/rest-api.mjs +76 -43
  299. package/dist/rest-api.mjs.map +1 -1
  300. package/dist/runSubscriber-B1Yg4dID.cjs +128 -0
  301. package/dist/runSubscriber-B1Yg4dID.cjs.map +1 -0
  302. package/dist/runSubscriber-JCgkeYbE.mjs +111 -0
  303. package/dist/runSubscriber-JCgkeYbE.mjs.map +1 -0
  304. package/dist/shutdown-BMJmAhSt.cjs +38 -0
  305. package/dist/shutdown-BMJmAhSt.cjs.map +1 -0
  306. package/dist/shutdown-C7xa8x9S.mjs +27 -0
  307. package/dist/shutdown-C7xa8x9S.mjs.map +1 -0
  308. package/dist/site.cjs +9 -3
  309. package/dist/site.cjs.map +1 -1
  310. package/dist/site.d.cts +44 -1
  311. package/dist/site.d.cts.map +1 -1
  312. package/dist/site.d.mts +44 -1
  313. package/dist/site.d.mts.map +1 -1
  314. package/dist/site.mjs +9 -3
  315. package/dist/site.mjs.map +1 -1
  316. package/dist/stages-DaTaoQei.d.cts +73 -0
  317. package/dist/stages-DaTaoQei.d.cts.map +1 -0
  318. package/dist/stages-DaTaoQei.d.mts +73 -0
  319. package/dist/stages-DaTaoQei.d.mts.map +1 -0
  320. package/dist/subscribers/index.cjs +134 -1
  321. package/dist/subscribers/index.cjs.map +1 -0
  322. package/dist/subscribers/index.d.cts +74 -3
  323. package/dist/subscribers/index.d.cts.map +1 -0
  324. package/dist/subscribers/index.d.mts +74 -3
  325. package/dist/subscribers/index.d.mts.map +1 -0
  326. package/dist/subscribers/index.mjs +132 -2
  327. package/dist/subscribers/index.mjs.map +1 -0
  328. package/dist/telemetry-B48RLjyk.d.cts +40 -0
  329. package/dist/telemetry-B48RLjyk.d.cts.map +1 -0
  330. package/dist/telemetry-BEoBn6GO.d.mts +40 -0
  331. package/dist/telemetry-BEoBn6GO.d.mts.map +1 -0
  332. package/dist/telemetry.cjs +56 -0
  333. package/dist/telemetry.cjs.map +1 -0
  334. package/dist/telemetry.d.cts +2 -0
  335. package/dist/telemetry.d.mts +2 -0
  336. package/dist/telemetry.mjs +55 -0
  337. package/dist/telemetry.mjs.map +1 -0
  338. package/dist/topic/index.cjs +2 -134
  339. package/dist/topic/index.d.cts +2 -3
  340. package/dist/topic/index.d.mts +2 -3
  341. package/dist/topic/index.mjs +2 -132
  342. package/dist/tracing-Bbj1uoFJ.mjs +127 -0
  343. package/dist/tracing-Bbj1uoFJ.mjs.map +1 -0
  344. package/dist/tracing-C0ooU0V2.cjs +150 -0
  345. package/dist/tracing-C0ooU0V2.cjs.map +1 -0
  346. package/dist/websocket-api.cjs +769 -0
  347. package/dist/websocket-api.cjs.map +1 -0
  348. package/dist/websocket-api.d.cts +449 -0
  349. package/dist/websocket-api.d.cts.map +1 -0
  350. package/dist/websocket-api.d.mts +449 -0
  351. package/dist/websocket-api.d.mts.map +1 -0
  352. package/dist/websocket-api.mjs +755 -0
  353. package/dist/websocket-api.mjs.map +1 -0
  354. package/dist/worker.cjs +70 -23
  355. package/dist/worker.cjs.map +1 -1
  356. package/dist/worker.d.cts +86 -36
  357. package/dist/worker.d.cts.map +1 -1
  358. package/dist/worker.d.mts +87 -37
  359. package/dist/worker.d.mts.map +1 -1
  360. package/dist/worker.mjs +70 -23
  361. package/dist/worker.mjs.map +1 -1
  362. package/package.json +145 -44
  363. package/dist/Construct-BeYVu_QF.mjs.map +0 -1
  364. package/dist/Construct-DfbwIntp.d.cts +0 -115
  365. package/dist/Construct-DfbwIntp.d.cts.map +0 -1
  366. package/dist/Construct-DqdlARxq.cjs.map +0 -1
  367. package/dist/Construct-l5aOn_jv.d.mts +0 -115
  368. package/dist/Construct-l5aOn_jv.d.mts.map +0 -1
  369. package/dist/Cron-DKqnnTdH.d.cts.map +0 -1
  370. package/dist/Cron-SyqS5oWJ.d.mts.map +0 -1
  371. package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
  372. package/dist/CronBuilder-CRGnDfTq.d.mts +0 -41
  373. package/dist/CronBuilder-CRGnDfTq.d.mts.map +0 -1
  374. package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
  375. package/dist/CronBuilder-Df1q9PNy.d.cts +0 -41
  376. package/dist/CronBuilder-Df1q9PNy.d.cts.map +0 -1
  377. package/dist/Endpoint-BCiCYvx2.mjs +0 -1665
  378. package/dist/Endpoint-BCiCYvx2.mjs.map +0 -1
  379. package/dist/Endpoint-C6yyHpRS.d.cts.map +0 -1
  380. package/dist/Endpoint-DuT4TEEq.d.mts.map +0 -1
  381. package/dist/Endpoint-s0AyrQGC.cjs +0 -1683
  382. package/dist/Endpoint-s0AyrQGC.cjs.map +0 -1
  383. package/dist/EndpointFactory-M8OQKZRY.cjs.map +0 -1
  384. package/dist/EndpointFactory-ptPR1cXw.mjs.map +0 -1
  385. package/dist/HonoEndpointAdaptor-7QagYKdP.cjs.map +0 -1
  386. package/dist/HonoEndpointAdaptor-CYHA0WAt.mjs.map +0 -1
  387. package/dist/Queue-D9X6OoON.d.mts.map +0 -1
  388. package/dist/Queue-DYPB2KWL.d.cts.map +0 -1
  389. package/dist/Subscriber-C4heaAyO.d.mts +0 -51
  390. package/dist/Subscriber-C4heaAyO.d.mts.map +0 -1
  391. package/dist/Subscriber-CotDUELC.d.cts +0 -51
  392. package/dist/Subscriber-CotDUELC.d.cts.map +0 -1
  393. package/dist/SubscriberBuilder-BEv0eoHy.d.cts +0 -59
  394. package/dist/SubscriberBuilder-BEv0eoHy.d.cts.map +0 -1
  395. package/dist/SubscriberBuilder-C0ZEtGDI.cjs +0 -125
  396. package/dist/SubscriberBuilder-C0ZEtGDI.cjs.map +0 -1
  397. package/dist/SubscriberBuilder-h7B_cHMr.mjs +0 -114
  398. package/dist/SubscriberBuilder-h7B_cHMr.mjs.map +0 -1
  399. package/dist/SubscriberBuilder-tyH5yTk5.d.mts +0 -59
  400. package/dist/SubscriberBuilder-tyH5yTk5.d.mts.map +0 -1
  401. package/dist/Topic-DEVGo0Dm.d.cts +0 -89
  402. package/dist/Topic-DEVGo0Dm.d.cts.map +0 -1
  403. package/dist/Topic-zk_6Gthr.d.mts +0 -89
  404. package/dist/Topic-zk_6Gthr.d.mts.map +0 -1
  405. package/dist/auth.d.cts.map +0 -1
  406. package/dist/auth.d.mts.map +0 -1
  407. package/dist/cache.d.cts.map +0 -1
  408. package/dist/cache.d.mts.map +0 -1
  409. package/dist/construct-interface-DPlxfpoS.d.mts.map +0 -1
  410. package/dist/construct-interface-DgXTJcOD.d.cts.map +0 -1
  411. package/dist/credential.cjs.map +0 -1
  412. package/dist/credential.d.cts.map +0 -1
  413. package/dist/credential.d.mts.map +0 -1
  414. package/dist/credential.mjs.map +0 -1
  415. package/dist/database/kysely.cjs.map +0 -1
  416. package/dist/database/kysely.d.cts.map +0 -1
  417. package/dist/database/kysely.d.mts.map +0 -1
  418. package/dist/database/kysely.mjs.map +0 -1
  419. package/dist/functions-B6qCvfmy.cjs.map +0 -1
  420. package/dist/functions-C53GW2eQ.mjs.map +0 -1
  421. package/dist/index-B2urf3YI.d.cts +0 -26
  422. package/dist/index-B2urf3YI.d.cts.map +0 -1
  423. package/dist/index-BPSZ_Lp_.d.cts.map +0 -1
  424. package/dist/index-BoZ-iisU.d.mts.map +0 -1
  425. package/dist/index-CdaU--_B.d.cts +0 -165
  426. package/dist/index-CdaU--_B.d.cts.map +0 -1
  427. package/dist/index-DMCDvnsM.d.mts +0 -26
  428. package/dist/index-DMCDvnsM.d.mts.map +0 -1
  429. package/dist/index-PQRWOQj4.d.mts +0 -165
  430. package/dist/index-PQRWOQj4.d.mts.map +0 -1
  431. package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
  432. package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
  433. package/dist/processAudits-BpRlPQMW.mjs +0 -77
  434. package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
  435. package/dist/processAudits-D_2W5x8k.cjs +0 -88
  436. package/dist/processAudits-D_2W5x8k.cjs.map +0 -1
  437. package/dist/queue/index.cjs.map +0 -1
  438. package/dist/queue/index.d.cts.map +0 -1
  439. package/dist/queue/index.d.mts.map +0 -1
  440. package/dist/queue/index.mjs.map +0 -1
  441. package/dist/telemetry-DGcFlVpB.d.cts.map +0 -1
  442. package/dist/telemetry-DGcFlVpB.d.mts.map +0 -1
  443. package/dist/topic/index.cjs.map +0 -1
  444. package/dist/topic/index.mjs.map +0 -1
@@ -0,0 +1 @@
1
+ {"version":3,"file":"EndpointFactory-gqmIRVWg.cjs","names":["HttpError","BaseFunctionBuilder","cloneWith","servicesOf","uniqBy","idsOf","serviceOf","Endpoint","DEFAULT_LOGGER","uniqBy","servicesOf","serviceOf","isConsumable","idsOf"],"sources":["../src/endpoints/Authorizer.ts","../src/endpoints/rls.ts","../src/endpoints/upload.ts","../src/endpoints/EndpointBuilder.ts","../src/endpoints/EndpointFactory.ts"],"sourcesContent":["/**\n * OpenAPI 3.1 compliant security scheme definition.\n * @see https://spec.openapis.org/oas/v3.1.0#security-scheme-object\n */\nexport interface SecurityScheme {\n\t/** The type of the security scheme */\n\ttype: 'apiKey' | 'http' | 'mutualTLS' | 'oauth2' | 'openIdConnect';\n\t/** A description for security scheme */\n\tdescription?: string;\n\t/** Required for apiKey. The name of the header, query or cookie parameter */\n\tname?: string;\n\t/** Required for apiKey. The location of the API key */\n\tin?: 'query' | 'header' | 'cookie';\n\t/** Required for http. The name of the HTTP Authorization scheme (e.g., 'bearer') */\n\tscheme?: string;\n\t/** Optional for http bearer. A hint to the format of the bearer token */\n\tbearerFormat?: string;\n\t/** Required for oauth2. An object containing configuration for the flow types */\n\tflows?: OAuthFlows;\n\t/** Required for openIdConnect. The URL to discover OAuth2 configuration */\n\topenIdConnectUrl?: string;\n\t/** Vendor extensions (e.g., x-amazon-apigateway-authtype) */\n\t[key: `x-${string}`]: unknown;\n}\n\n/**\n * OAuth2 flow configuration\n */\nexport interface OAuthFlows {\n\timplicit?: OAuthFlow;\n\tpassword?: OAuthFlow;\n\tclientCredentials?: OAuthFlow;\n\tauthorizationCode?: OAuthFlow;\n}\n\nexport interface OAuthFlow {\n\tauthorizationUrl?: string;\n\ttokenUrl?: string;\n\trefreshUrl?: string;\n\tscopes: Record<string, string>;\n}\n\n/**\n * Built-in security schemes available by default.\n * Users can use these without defining them via .securitySchemes().\n */\nexport const BUILT_IN_SECURITY_SCHEMES = {\n\tjwt: {\n\t\ttype: 'http',\n\t\tscheme: 'bearer',\n\t\tbearerFormat: 'JWT',\n\t\tdescription: 'JWT Bearer token authentication',\n\t},\n\tbearer: {\n\t\ttype: 'http',\n\t\tscheme: 'bearer',\n\t\tdescription: 'Bearer token authentication',\n\t},\n\tapiKey: {\n\t\ttype: 'apiKey',\n\t\tin: 'header',\n\t\tname: 'X-API-Key',\n\t\tdescription: 'API key authentication via header',\n\t},\n\toauth2: {\n\t\ttype: 'oauth2',\n\t\tflows: {},\n\t\tdescription: 'OAuth 2.0 authentication',\n\t},\n\toidc: {\n\t\ttype: 'openIdConnect',\n\t\topenIdConnectUrl: '',\n\t\tdescription: 'OpenID Connect authentication',\n\t},\n\tiam: {\n\t\ttype: 'apiKey',\n\t\tin: 'header',\n\t\tname: 'Authorization',\n\t\tdescription: 'AWS IAM Signature Version 4 authentication',\n\t\t'x-amazon-apigateway-authtype': 'awsSigv4',\n\t},\n} as const satisfies Record<string, SecurityScheme>;\n\n/** Names of built-in security schemes */\nexport type BuiltInSecuritySchemeId = keyof typeof BUILT_IN_SECURITY_SCHEMES;\n\n/**\n * Represents an authorizer configuration for endpoints\n */\nexport interface Authorizer {\n\t/**\n\t * Unique identifier for the authorizer\n\t */\n\tname: string;\n\t/**\n\t * The OpenAPI security scheme definition for this authorizer\n\t */\n\tsecurityScheme?: SecurityScheme;\n\t/**\n\t * Type of authorizer (e.g., 'iam', 'jwt', 'custom')\n\t * @deprecated Use securityScheme.type instead\n\t */\n\ttype?: string;\n\t/**\n\t * Description of what this authorizer does\n\t * @deprecated Use securityScheme.description instead\n\t */\n\tdescription?: string;\n\t/**\n\t * Additional metadata specific to the authorizer type\n\t * @deprecated Use securityScheme with x-* extensions instead\n\t */\n\tmetadata?: Record<string, unknown>;\n}\n\n/**\n * Helper to create an authorizer configuration\n */\nexport function createAuthorizer(\n\tname: string,\n\toptions?: Omit<Authorizer, 'name'>,\n): Authorizer {\n\treturn {\n\t\tname,\n\t\t...options,\n\t};\n}\n\n/**\n * Check if a name is a built-in security scheme\n */\nexport function isBuiltInSecurityScheme(\n\tname: string,\n): name is BuiltInSecuritySchemeId {\n\treturn name in BUILT_IN_SECURITY_SCHEMES;\n}\n\n/**\n * Get a security scheme by name (built-in or custom)\n */\nexport function getSecurityScheme(\n\tname: string,\n\tcustomSchemes?: Record<string, SecurityScheme>,\n): SecurityScheme | undefined {\n\tif (customSchemes && name in customSchemes) {\n\t\treturn customSchemes[name];\n\t}\n\tif (isBuiltInSecurityScheme(name)) {\n\t\treturn BUILT_IN_SECURITY_SCHEMES[name];\n\t}\n\treturn undefined;\n}\n","import type { Logger } from '@geekmidas/logger';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { CookieFn, HeaderFn } from './Endpoint';\n\n/**\n * RLS context - key-value pairs to set as PostgreSQL session variables.\n * Keys become `prefix.key` (e.g., `app.user_id`).\n */\nexport interface RlsContext {\n\t[key: string]: string | number | boolean | null | undefined;\n}\n\n/**\n * Function type for extracting RLS context from request context.\n *\n * @template TServices - Available service dependencies\n * @template TSession - Session data type\n * @template TLogger - Logger type\n *\n * @example\n * ```ts\n * const extractor: RlsContextExtractor<[], UserSession> = ({ session }) => ({\n * user_id: session.userId,\n * tenant_id: session.tenantId,\n * roles: session.roles.join(','),\n * });\n * ```\n */\nexport type RlsContextExtractor<\n\tTServices extends Service[] = [],\n\tTSession = unknown,\n\tTLogger extends Logger = Logger,\n> = (ctx: {\n\tservices: ServiceRecord<TServices>;\n\tsession: TSession;\n\theader: HeaderFn;\n\tcookie: CookieFn;\n\tlogger: TLogger;\n}) => RlsContext | Promise<RlsContext>;\n\n/**\n * Configuration for RLS on an endpoint or factory.\n *\n * @template TServices - Available service dependencies\n * @template TSession - Session data type\n * @template TLogger - Logger type\n */\nexport interface RlsConfig<\n\tTServices extends Service[] = [],\n\tTSession = unknown,\n\tTLogger extends Logger = Logger,\n> {\n\t/** Function to extract RLS context from request */\n\textractor: RlsContextExtractor<TServices, TSession, TLogger>;\n\t/** Prefix for PostgreSQL session variables (default: 'app') */\n\tprefix?: string;\n}\n\n/**\n * Symbol used to bypass RLS for an endpoint.\n */\nexport const RLS_BYPASS = Symbol.for('geekmidas.rls.bypass');\n\n/**\n * Type for RLS bypass marker.\n */\nexport type RlsBypass = typeof RLS_BYPASS;\n","/**\n * Direct uploads: an endpoint that hands the browser a signed form, so the\n * file goes straight to the bucket and never through the server.\n *\n * The endpoint decides *where* — the key, from the session and the body — and\n * the form's policy decides *what*: the storage itself refuses a file larger\n * than `maxSize`, or of a type `accept` does not allow. Nothing the client\n * sends after this request is trusted to the server that issued it. That the\n * upload finished arrives as the bucket's `object.created` event.\n */\n\nimport { HttpError } from '@geekmidas/errors';\nimport type { StorageClient, UploadPost } from '@geekmidas/storage';\nimport type {\n\tStandardJSONSchemaV1,\n\tStandardSchemaV1,\n} from '@standard-schema/spec';\n\nexport type { UploadPost };\n\n/** What an endpoint's `.upload(bucket, …)` allows. */\nexport interface UploadOptions<TContext> {\n\t/** Where the object lands, from what the handler would be given. */\n\tkey: (ctx: TContext) => string | Promise<string>;\n\t/** The largest file the storage accepts, in bytes. */\n\tmaxSize: number;\n\t/**\n\t * The types the file may be: `image/png`, or `image/*` for any image.\n\t * Absent, any type is accepted.\n\t *\n\t * A storage policy fixes one type, or one prefix, and cannot say \"either of\n\t * these\". So with more than one, `contentType` says which this upload is\n\t * — and it must be one of them.\n\t */\n\taccept?: readonly string[];\n\t/** The type this upload is sent as — required when `accept` lists several. */\n\tcontentType?: (ctx: TContext) => string | Promise<string>;\n\t/** How long the form is valid, in seconds. Defaults to 300. */\n\texpiresIn?: number;\n}\n\n/** The longest a signature may be valid for: S3's limit, seven days. */\nconst MAX_EXPIRES_IN = 7 * 24 * 60 * 60;\n\n/** A media type, or a whole top-level type: `image/png`, `image/*`. */\nconst MEDIA_TYPE =\n\t/^[a-z0-9][a-z0-9!#$&^_.+-]*\\/(\\*|[a-z0-9][a-z0-9!#$&^_.+-]*)$/i;\n\n/** An upload's `maxSize` that is not a positive whole number of bytes. */\nexport class UploadMaxSizeInvalid extends Error {\n\tconstructor(readonly maxSize: number) {\n\t\tsuper(\n\t\t\t`An upload's maxSize is ${maxSize}, and it has to be a positive whole ` +\n\t\t\t\t`number of bytes — 5 * 1024 * 1024 for 5 MiB.`,\n\t\t);\n\t\tthis.name = 'UploadMaxSizeInvalid';\n\t}\n}\n\n/** An upload's `expiresIn` outside what a signature can be valid for. */\nexport class UploadExpiryInvalid extends Error {\n\tconstructor(readonly expiresIn: number) {\n\t\tsuper(\n\t\t\t`An upload's expiresIn is ${expiresIn}, and it has to be a whole number ` +\n\t\t\t\t`of seconds from 1 to ${MAX_EXPIRES_IN} (seven days, the longest S3 ` +\n\t\t\t\t`signs for). The default, 300, is usually right.`,\n\t\t);\n\t\tthis.name = 'UploadExpiryInvalid';\n\t}\n}\n\n/** An entry in `accept` that is not a media type. */\nexport class UploadAcceptInvalid extends Error {\n\tconstructor(readonly entry: string) {\n\t\tsuper(\n\t\t\t`'${entry}' in an upload's accept is not a media type. Name one ` +\n\t\t\t\t`('image/png') or a whole type ('image/*').`,\n\t\t);\n\t\tthis.name = 'UploadAcceptInvalid';\n\t}\n}\n\n/** Several accepted types, and nothing saying which one an upload is. */\nexport class UploadContentTypeUnresolved extends Error {\n\tconstructor(readonly accept: readonly string[]) {\n\t\tsuper(\n\t\t\t`An upload accepts ${accept.join(', ')}, and a signed form can fix only ` +\n\t\t\t\t`one type. Add contentType: ({ body }) => body.contentType, with the ` +\n\t\t\t\t`body naming which of them this file is.`,\n\t\t);\n\t\tthis.name = 'UploadContentTypeUnresolved';\n\t}\n}\n\n/** A request for an upload of a type the endpoint does not accept. */\nexport class UploadContentTypeRefused extends HttpError {\n\tconstructor(\n\t\treadonly contentType: string,\n\t\treadonly accept: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t415,\n\t\t\t`'${contentType}' is not accepted here. Upload one of: ${accept.join(', ')}.`,\n\t\t\t{ details: { contentType, accept } },\n\t\t);\n\t\tthis.name = 'UploadContentTypeRefused';\n\t}\n}\n\n/**\n * Check an upload's options when the endpoint is built, so a mistake fails at\n * startup rather than on the first request.\n */\nexport function checkUploadOptions(options: UploadOptions<never>): void {\n\tif (!Number.isInteger(options.maxSize) || options.maxSize <= 0) {\n\t\tthrow new UploadMaxSizeInvalid(options.maxSize);\n\t}\n\tconst { expiresIn } = options;\n\tif (\n\t\texpiresIn !== undefined &&\n\t\t(!Number.isInteger(expiresIn) ||\n\t\t\texpiresIn < 1 ||\n\t\t\texpiresIn > MAX_EXPIRES_IN)\n\t) {\n\t\tthrow new UploadExpiryInvalid(expiresIn);\n\t}\n\tfor (const entry of options.accept ?? []) {\n\t\tif (!MEDIA_TYPE.test(entry)) throw new UploadAcceptInvalid(entry);\n\t}\n\tif ((options.accept?.length ?? 0) > 1 && !options.contentType) {\n\t\tthrow new UploadContentTypeUnresolved(options.accept!);\n\t}\n}\n\n/** Whether `type` is one `accept` allows — exactly, or under a `type/*`. */\nfunction accepts(accept: readonly string[], type: string): boolean {\n\tconst wanted = type.toLowerCase();\n\treturn accept.some((entry) => {\n\t\tconst allowed = entry.toLowerCase();\n\t\treturn allowed.endsWith('/*')\n\t\t\t? wanted.startsWith(allowed.slice(0, -1))\n\t\t\t: allowed === wanted;\n\t});\n}\n\n/**\n * The signed form for one request: the key and type resolved from the\n * handler's context, and the policy the storage enforces.\n *\n * @throws {UploadContentTypeRefused} when the resolved type is not accepted\n */\nexport async function issueUpload<TContext>(\n\tstorage: StorageClient,\n\tctx: TContext,\n\toptions: UploadOptions<TContext>,\n): Promise<UploadPost> {\n\tconst key = await options.key(ctx);\n\tconst accept = options.accept ?? [];\n\tconst resolved = options.contentType\n\t\t? await options.contentType(ctx)\n\t\t: undefined;\n\n\tlet contentType: string | { startsWith: string } | undefined;\n\tif (resolved !== undefined) {\n\t\tif (accept.length > 0 && !accepts(accept, resolved)) {\n\t\t\tthrow new UploadContentTypeRefused(resolved, accept);\n\t\t}\n\t\tcontentType = resolved;\n\t} else if (accept.length === 1) {\n\t\tconst only = accept[0]!;\n\t\tcontentType = only.endsWith('/*')\n\t\t\t? { startsWith: only.slice(0, -1) }\n\t\t\t: only;\n\t}\n\n\treturn storage.getUploadPost({\n\t\tkey,\n\t\tmaxSize: options.maxSize,\n\t\t...(contentType ? { contentType } : {}),\n\t\t...(options.expiresIn !== undefined\n\t\t\t? { expiresIn: options.expiresIn }\n\t\t\t: {}),\n\t});\n}\n\n/** The JSON Schema of an {@link UploadPost}, for the endpoint's OpenAPI. */\nconst UPLOAD_POST_JSON_SCHEMA = {\n\ttype: 'object',\n\tproperties: {\n\t\turl: { type: 'string', format: 'uri' },\n\t\tfields: { type: 'object', additionalProperties: { type: 'string' } },\n\t\tkey: { type: 'string' },\n\t\texpiresAt: { type: 'string', format: 'date-time' },\n\t},\n\trequired: ['url', 'fields', 'key', 'expiresAt'],\n\tadditionalProperties: false,\n} as const;\n\n/** Whether `value` is an {@link UploadPost}. */\nfunction isUploadPost(value: unknown): value is UploadPost {\n\tif (!value || typeof value !== 'object') return false;\n\tconst { url, fields, key, expiresAt } = value as Record<string, unknown>;\n\treturn (\n\t\ttypeof url === 'string' &&\n\t\ttypeof key === 'string' &&\n\t\ttypeof expiresAt === 'string' &&\n\t\t!!fields &&\n\t\ttypeof fields === 'object' &&\n\t\tObject.values(fields).every((field) => typeof field === 'string')\n\t);\n}\n\n/**\n * An upload endpoint's output, when it declares none of its own: the signed\n * form, as the handler is given it.\n *\n * Written by hand rather than with a schema library, so the endpoint runtime\n * imports none — the Standard Schema and Standard JSON Schema interfaces are\n * the whole of what validation and OpenAPI need.\n */\nexport const UPLOAD_POST_SCHEMA: StandardSchemaV1<UploadPost> &\n\tStandardJSONSchemaV1<UploadPost> = {\n\t'~standard': {\n\t\tversion: 1,\n\t\tvendor: 'geekmidas',\n\t\tvalidate: (value) =>\n\t\t\tisUploadPost(value)\n\t\t\t\t? { value }\n\t\t\t\t: { issues: [{ message: 'Expected an upload form' }] },\n\t\tjsonSchema: {\n\t\t\tinput: () => structuredClone(UPLOAD_POST_JSON_SCHEMA),\n\t\t\toutput: () => structuredClone(UPLOAD_POST_JSON_SCHEMA),\n\t\t},\n\t},\n};\n","import type {\n\tAuditableAction,\n\tAuditStorage,\n\tExtractStorageAuditAction,\n} from '@geekmidas/audit';\nimport type { Logger } from '@geekmidas/logger';\nimport type { RateLimitConfig } from '@geekmidas/rate-limit';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service } from '@geekmidas/services';\nimport type { StorageClient } from '@geekmidas/storage';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport uniqBy from 'lodash.uniqby';\nimport { ConstructType } from '../Construct';\nimport { cloneWith } from '../clone';\nimport {\n\ttype Consumable,\n\tidsOf,\n\ttype ServicesOf,\n\tserviceOf,\n\tservicesOf,\n} from '../construct-interface';\nimport { BaseFunctionBuilder } from '../functions';\nimport type { EventFor } from '../publisher';\nimport type { EndpointTelemetry } from '../telemetry';\nimport type { Topic } from '../topic/Topic';\nimport type { HttpMethod } from '../types';\nimport type { Authorizer, SecurityScheme } from './Authorizer';\nimport { getSecurityScheme } from './Authorizer';\nimport type { ActorExtractor, MappedAudit } from './audit';\nimport type {\n\tAuthorizeFn,\n\tEndpointContext,\n\tEndpointHandler,\n\tEndpointStatus,\n\tSessionFn,\n} from './Endpoint';\nimport {\n\tEndpoint,\n\ttype EndpointSchemas,\n\ttype EndpointSurface,\n} from './Endpoint';\nimport type { RlsBypass, RlsConfig } from './rls';\nimport { RLS_BYPASS } from './rls';\nimport {\n\tcheckUploadOptions,\n\tissueUpload,\n\tUPLOAD_POST_SCHEMA,\n\ttype UploadOptions,\n\ttype UploadPost,\n} from './upload';\n\nexport class EndpointBuilder<\n\tTRoute extends string,\n\tTMethod extends HttpMethod,\n\tTInput extends EndpointSchemas = {},\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTSession = unknown,\n\tTAuthorizers extends readonly string[] = readonly string[],\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends BaseFunctionBuilder<\n\tTInput,\n\tOutSchema,\n\tTServices,\n\tTLogger,\n\tTAuditStorage,\n\tTAuditStorageServiceName,\n\tTDatabase,\n\tTDatabaseServiceName\n> {\n\tprotected schemas: TInput = {} as TInput;\n\tprotected _description?: string;\n\tprotected _status?: EndpointStatus;\n\tprotected _tags?: string[];\n\tprotected _memorySize?: number;\n\tprotected _responseType: string = 'application/json';\n\t/** Set by a factory's `.session()`; absent, the endpoint reads none. */\n\t_getSession?: SessionFn<TServices, TLogger, TSession, TDatabase>;\n\t_authorize: AuthorizeFn<TServices, TLogger, TSession, TInput, TDatabase> =\n\t\t() => true;\n\t_rateLimit?: RateLimitConfig;\n\t_availableAuthorizers: Authorizer[] = [];\n\t_authorizerName?: TAuthorizers[number];\n\t_actorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n\t_audits: MappedAudit<TAuditAction, OutSchema>[] = [];\n\t/**\n\t * Internal: the surface this builder came from, carried to the endpoint.\n\t *\n\t * Assigned by the factory before the builder is handed out, which is the\n\t * only way a builder is ever created.\n\t */\n\t_surface!: EndpointSurface;\n\t_customSecuritySchemes: Record<string, SecurityScheme> = {};\n\t_rlsConfig?: RlsConfig<TServices, TSession, TLogger>;\n\t_rlsBypass?: boolean;\n\t_telemetry?: EndpointTelemetry;\n\n\tconstructor(\n\t\treadonly route: TRoute,\n\t\treadonly method: TMethod,\n\t) {\n\t\tsuper(ConstructType.Endpoint);\n\t}\n\n\t// Internal setter for EndpointFactory to set default auditor storage\n\t_setAuditorStorage(\n\t\tstorage: Service<TAuditStorageServiceName, TAuditStorage>,\n\t) {\n\t\tthis._auditorStorage = storage;\n\t}\n\n\t// Internal setter for EndpointFactory to set default database service\n\t_setDatabaseService(service: Service<TDatabaseServiceName, TDatabase>) {\n\t\tthis._databaseService = service;\n\t}\n\n\tdescription(description: string): this {\n\t\treturn cloneWith(this, { _description: description });\n\t}\n\n\t/**\n\t * The status a successful request is answered with — a 2xx, or a 3xx for\n\t * an endpoint that always redirects (with a `Location` header). One that\n\t * sometimes redirects returns `response.redirect(url)` instead.\n\t */\n\tstatus(status: EndpointStatus): this {\n\t\treturn cloneWith(this, { _status: status });\n\t}\n\n\t/**\n\t * Publish `event` to `topic` once the handler has succeeded — repeatable,\n\t * one call per event, to as many topics as the endpoint names. The topic\n\t * becomes a dependency as with `.dependsOn([topic])`, so `services.<topic>`\n\t * is there for events the handler decides on itself.\n\t *\n\t * @example\n\t * ```ts\n\t * router.post('/users')\n\t * .event(users, {\n\t * type: 'user.created',\n\t * payload: (user) => ({ userId: user.id, email: user.email }),\n\t * })\n\t * ```\n\t */\n\tevent<TTopic extends Topic<any, any>>(\n\t\ttopic: TTopic,\n\t\tevent: EventFor<TTopic, InferStandardSchema<OutSchema>>,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\t[...TServices, TTopic['service']],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn this.withEvent(topic, event as never) as unknown as EndpointBuilder<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\t[...TServices, TTopic['service']],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\ttags(tags: string[]): this {\n\t\treturn cloneWith(this, { _tags: tags });\n\t}\n\n\tmemorySize(memorySize: number): this {\n\t\treturn cloneWith(this, { _memorySize: memorySize });\n\t}\n\n\t/**\n\t * This route's telemetry, beside what its surface's `Telemetry` says for\n\t * every route: `{ ignore: true }` records no span for it — a health check,\n\t * a probe — and `attributes` are set on its request span.\n\t *\n\t * @example\n\t * ```ts\n\t * router.get('/health').telemetry({ ignore: true }).handle(() => 'ok');\n\t * ```\n\t */\n\ttelemetry(options: EndpointTelemetry): this {\n\t\treturn cloneWith(this, { _telemetry: { ...options } });\n\t}\n\n\t/**\n\t * Set the response content type for this endpoint.\n\t *\n\t * Defaults to `'application/json'`. When set to any other value\n\t * (e.g. `'text/html'`, `'text/plain'`), the response body is emitted\n\t * as-is rather than JSON-serialized, and the `Content-Type` header\n\t * reflects the declared value. Runtime overrides via `r.header()` still win.\n\t *\n\t * @param type - The MIME type to return (e.g. `'text/html'`)\n\t *\n\t * @example\n\t * ```typescript\n\t * api.get('/checkout-page')\n\t * .output(z.string())\n\t * .responseType('text/html')\n\t * .handle(async () => '<html>...</html>');\n\t * ```\n\t */\n\tresponseType(type: string): this {\n\t\treturn cloneWith(this, { _responseType: type });\n\t}\n\n\tbody<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tOmit<TInput, 'body'> & { body: T },\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tthis.schemas.body = schema as unknown as T;\n\t\t// @ts-expect-error\n\t\treturn this;\n\t}\n\n\tsearch<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tOmit<TInput, 'query'> & { query: T },\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tthis.schemas.query = schema as unknown as T;\n\t\t// @ts-expect-error\n\t\treturn this;\n\t}\n\n\tquery<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tOmit<TInput, 'query'> & { query: T },\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn this.search(schema);\n\t}\n\n\tparams<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tOmit<TInput, 'params'> & { params: T },\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tthis.schemas.params = schema as unknown as T;\n\t\t// @ts-expect-error\n\t\treturn this;\n\t}\n\n\tauthorize(\n\t\tfn: AuthorizeFn<TServices, TLogger, TSession, TInput, TDatabase>,\n\t): this {\n\t\treturn cloneWith(this, { _authorize: fn });\n\t}\n\n\trateLimit(config: RateLimitConfig): this {\n\t\treturn cloneWith(this, { _rateLimit: config });\n\t}\n\n\tauthorizer(\n\t\tname: TAuthorizers[number] | 'none',\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\t// Special case: 'none' explicitly marks endpoint as having no authorizer\n\t\tif (name === 'none') {\n\t\t\treturn cloneWith(this, { _authorizerName: undefined });\n\t\t}\n\n\t\t// Validate that the authorizer exists in available authorizers\n\t\tconst authorizerExists = this._availableAuthorizers.some(\n\t\t\t(a) => a.name === name,\n\t\t);\n\t\tif (!authorizerExists && this._availableAuthorizers.length > 0) {\n\t\t\tconst available = this._availableAuthorizers\n\t\t\t\t.map((a) => a.name)\n\t\t\t\t.join(', ');\n\t\t\tthrow new Error(\n\t\t\t\t`Authorizer \"${name as string}\" not found in available authorizers: ${available}`,\n\t\t\t);\n\t\t}\n\n\t\treturn cloneWith(this, { _authorizerName: name });\n\t}\n\n\t/**\n\t * Depend on constructs — a database, a bucket, a mail sender, a queue, a\n\t * topic.\n\t *\n\t * It records the edge and dissolves each construct's client into the\n\t * handler's service record under the construct's own id, so\n\t * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.\n\t *\n\t * Constructs only. A `Service` does not match the shape, which is what keeps\n\t * env sniffing confined to `.services()` and the explicit lift.\n\t */\n\tdependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\t[...TServices, ...ServicesOf<T>],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\t// Both halves of the edge, from one call and one clone: the services the\n\t\t// handler runs with, and the ids the manifest records. Recording them\n\t\t// separately is what let them drift apart.\n\t\t//\n\t\t// `servicesOf` is the half that validates, so it runs first — recording\n\t\t// ids ahead of it left a caught `NotAConstruct` with `undefined` already\n\t\t// on a `string[]`.\n\t\tconst services = servicesOf(constructs) as unknown as Service[];\n\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(service: Service) => service.serviceName,\n\t\t\t),\n\t\t\t_constructs: idsOf(constructs, this._constructs),\n\t\t}) as unknown as EndpointBuilder<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\t[...TServices, ...ServicesOf<T>],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Hand the browser a signed form that uploads one file straight to\n\t * `bucket` — the file never passes through this server.\n\t *\n\t * The endpoint decides where (`key`, from what the handler is given) and\n\t * the form's policy decides what: the storage refuses a file over\n\t * `maxSize`, or of a type `accept` does not allow. The handler receives\n\t * the form as `upload`, and returns it unless it has more to say — it is\n\t * the endpoint's output when no `.output()` came first. The bucket\n\t * becomes a dependency, as with `.dependsOn([bucket])`.\n\t *\n\t * The last step before `.handle()`: the key is resolved from the body,\n\t * params and session, so they are declared first.\n\t *\n\t * @example\n\t * ```ts\n\t * router\n\t * .post('/me/avatar')\n\t * .upload(uploads, {\n\t * key: ({ session }) => `avatars/${session.userId}.png`,\n\t * maxSize: 5 * 1024 * 1024,\n\t * accept: ['image/png'],\n\t * })\n\t * .handle(async ({ upload }) => upload);\n\t * ```\n\t */\n\tupload<TBucket extends Consumable<string, StorageClient>>(\n\t\tbucket: TBucket,\n\t\toptions: UploadOptions<\n\t\t\tEndpointContext<\n\t\t\t\tTInput,\n\t\t\t\t[...TServices, TBucket['service']],\n\t\t\t\tTLogger,\n\t\t\t\tTSession,\n\t\t\t\tTAuditAction,\n\t\t\t\tTDatabase,\n\t\t\t\tTAuditStorage\n\t\t\t>\n\t\t>,\n\t): UploadEndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\t[...TServices, TBucket['service']],\n\t\tTLogger,\n\t\t[OutSchema] extends [undefined] ? typeof UPLOAD_POST_SCHEMA : OutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tcheckUploadOptions(options);\n\t\tconst [service] = servicesOf([bucket]) as unknown as Service[];\n\n\t\tconst next = Object.create(UploadEndpointBuilder.prototype);\n\t\treturn Object.assign(next, this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, service!],\n\t\t\t\t(s: Service) => s.serviceName,\n\t\t\t),\n\t\t\t_constructs: idsOf([bucket], this._constructs),\n\t\t\toutputSchema: this.outputSchema ?? UPLOAD_POST_SCHEMA,\n\t\t\t_upload: { serviceName: service!.serviceName, options },\n\t\t});\n\t}\n\n\tservices<T extends Service[]>(\n\t\tservices: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\t[...TServices, ...T],\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_services: uniqBy(\n\t\t\t\t[...this._services, ...services],\n\t\t\t\t(s) => s.serviceName,\n\t\t\t) as TServices,\n\t\t}) as unknown as EndpointBuilder<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\t[...TServices, ...T],\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\tlogger<T extends Logger>(\n\t\tlogger: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tTServices,\n\t\tT,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_logger: logger as unknown as TLogger,\n\t\t}) as unknown as EndpointBuilder<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tT,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\toutput<T extends StandardSchemaV1>(\n\t\tschema: T,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tT,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\toutputSchema: schema as unknown as OutSchema,\n\t\t}) as unknown as EndpointBuilder<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tT,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Set the auditor storage service for this endpoint.\n\t * This enables audit functionality and makes `auditor` available in the handler context.\n\t * The audit action type is automatically inferred from the storage's generic parameter.\n\t */\n\toverride auditor<T extends AuditStorage<any>, TName extends string>(\n\t\tstorage: Service<TName, T>,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tT,\n\t\tTName,\n\t\tExtractStorageAuditAction<T>,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, {\n\t\t\t_auditorStorage: storage as unknown as Service<\n\t\t\t\tTAuditStorageServiceName,\n\t\t\t\tTAuditStorage\n\t\t\t>,\n\t\t}) as unknown as EndpointBuilder<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tT,\n\t\t\tTName,\n\t\t\tExtractStorageAuditAction<T>,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>;\n\t}\n\n\t/**\n\t * Set the actor extractor function for audit records.\n\t * The actor is extracted from the request context and attached to all audits.\n\t */\n\tactor(\n\t\textractor: ActorExtractor<TServices, TSession, TLogger>,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\treturn cloneWith(this, { _actorExtractor: extractor });\n\t}\n\n\t/**\n\t * Add declarative audit definitions that are processed after the handler executes.\n\t * Similar to `.event()` for events, but for audits.\n\t *\n\t * @example\n\t * ```typescript\n\t * .audit<AppAuditAction>([\n\t * {\n\t * type: 'user.created',\n\t * payload: (response) => ({ userId: response.id, email: response.email }),\n\t * when: (response) => response.active,\n\t * entityId: (response) => response.id,\n\t * table: 'users',\n\t * },\n\t * ])\n\t * ```\n\t */\n\taudit(audits: MappedAudit<TAuditAction, OutSchema>[]): this {\n\t\treturn cloneWith(this, { _audits: audits });\n\t}\n\n\t/**\n\t * Set the database service for this endpoint.\n\t * The database will be available in the handler context as `db`.\n\t * When audit storage is configured and uses the same database,\n\t * `db` will automatically be the transaction for ACID compliance.\n\t *\n\t * @example\n\t * ```typescript\n\t * .database(databaseService)\n\t * .handle(async ({ db }) => {\n\t * // db is the raw database or transaction (when auditor uses same db)\n\t * return await db.selectFrom('users').selectAll().execute();\n\t * })\n\t * ```\n\t */\n\toverride database<T, TName extends string>(\n\t\tsource: Consumable<TName, T> | Service<TName, T>,\n\t): EndpointBuilder<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tTServices,\n\t\tTLogger,\n\t\tOutSchema,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tT,\n\t\tTName\n\t> {\n\t\tconst service = serviceOf(source);\n\n\t\treturn cloneWith(this, {\n\t\t\t_databaseService: service as unknown as Service<\n\t\t\t\tTDatabaseServiceName,\n\t\t\t\tTDatabase\n\t\t\t>,\n\t\t}) as unknown as EndpointBuilder<\n\t\t\tTRoute,\n\t\t\tTMethod,\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tT,\n\t\t\tTName\n\t\t>;\n\t}\n\n\t/**\n\t * Configure RLS (Row-Level Security) context for this endpoint.\n\t * Pass `false` or `RLS_BYPASS` to explicitly bypass RLS for this endpoint.\n\t *\n\t * @example\n\t * ```typescript\n\t * // Custom RLS config for this endpoint\n\t * .rls({\n\t * extractor: ({ session }) => ({\n\t * user_id: session.userId,\n\t * tenant_id: session.tenantId,\n\t * }),\n\t * prefix: 'app',\n\t * })\n\t *\n\t * // Bypass RLS (for admin endpoints)\n\t * .rls(false)\n\t * ```\n\t */\n\trls(\n\t\tconfig: RlsConfig<TServices, TSession, TLogger> | false | RlsBypass,\n\t): this {\n\t\tif (config === false || config === RLS_BYPASS) {\n\t\t\tthis._rlsBypass = true;\n\t\t\tthis._rlsConfig = undefined;\n\t\t} else {\n\t\t\tthis._rlsConfig = config;\n\t\t\tthis._rlsBypass = false;\n\t\t}\n\t\treturn this;\n\t}\n\n\t/**\n\t * Explicitly bypass RLS for this endpoint.\n\t * Useful for admin operations that need unrestricted database access.\n\t *\n\t * @example\n\t * ```typescript\n\t * .rlsBypass()\n\t * .handle(async ({ db }) => {\n\t * // Full access, no RLS filtering\n\t * return db.selectFrom('orders').selectAll().execute();\n\t * })\n\t * ```\n\t */\n\trlsBypass(): this {\n\t\treturn cloneWith(this, { _rlsBypass: true, _rlsConfig: undefined });\n\t}\n\n\t// EndpointBuilder doesn't have a generic input method - it uses body, query, params instead\n\tinput(_schema: any): any {\n\t\tthrow new Error(\n\t\t\t'EndpointBuilder does not support generic input. Use body(), query(), or params() instead.',\n\t\t);\n\t}\n\n\thandle(\n\t\tfn: EndpointHandler<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTDatabase,\n\t\t\tTAuditStorage,\n\t\t\tTAuditAction\n\t\t>,\n\t): Endpoint<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tOutSchema,\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\t// Find authorizer metadata if name is set\n\t\t// If the authorizer name is set but not in availableAuthorizers, create a simple authorizer object\n\t\tlet authorizer: Authorizer | undefined;\n\t\tif (this._authorizerName) {\n\t\t\tconst existingAuthorizer = this._availableAuthorizers.find(\n\t\t\t\t(a) => a.name === this._authorizerName,\n\t\t\t);\n\n\t\t\tif (existingAuthorizer) {\n\t\t\t\tauthorizer = existingAuthorizer;\n\t\t\t} else {\n\t\t\t\t// Create authorizer with security scheme if available (built-in or custom)\n\t\t\t\tconst securityScheme = getSecurityScheme(\n\t\t\t\t\tthis._authorizerName as string,\n\t\t\t\t\tthis._customSecuritySchemes,\n\t\t\t\t);\n\t\t\t\tauthorizer = {\n\t\t\t\t\tname: this._authorizerName as string,\n\t\t\t\t\tsecurityScheme,\n\t\t\t\t};\n\t\t\t}\n\t\t}\n\n\t\tconst endpoint = new Endpoint({\n\t\t\tfn,\n\t\t\tmethod: this.method,\n\t\t\troute: this.route,\n\t\t\tdescription: this._description,\n\t\t\ttags: this._tags,\n\t\t\tinput: this.schemas,\n\t\t\toutput: this.outputSchema,\n\t\t\tservices: this._services,\n\t\t\tconstructs: this._constructs,\n\t\t\tlogger: this._logger,\n\t\t\ttimeout: this._timeout,\n\t\t\tmemorySize: this._memorySize,\n\t\t\tauthorize: this._authorize,\n\t\t\tstatus: this._status,\n\t\t\tgetSession: this._getSession,\n\t\t\trateLimit: this._rateLimit,\n\t\t\tevents: this._events,\n\t\t\tauthorizer,\n\t\t\tsurface: this._surface,\n\t\t\tauditorStorageService: this._auditorStorage,\n\t\t\tactorExtractor: this._actorExtractor,\n\t\t\taudits: this._audits,\n\t\t\tdatabaseService: this._databaseService,\n\t\t\trlsConfig: this._rlsConfig,\n\t\t\trlsBypass: this._rlsBypass,\n\t\t\tresponseType: this._responseType,\n\t\t\t...(this._telemetry ? { telemetry: this._telemetry } : {}),\n\t\t});\n\n\t\t// One field says which process runs a construct, whatever its kind. An\n\t\t// endpoint's is its surface; a cron's is the worker that handed out the\n\t\t// factory. The build partitions on this rather than on directories.\n\t\tendpoint.owner = this._surface?.id;\n\n\t\treturn endpoint;\n\t}\n}\n\n/**\n * A handler given an upload's signed form beside everything else: the\n * context `H` receives, with `upload`.\n */\nexport type UploadHandler<H extends (...args: any[]) => any> = (\n\tctx: Parameters<H>[0] & { upload: UploadPost },\n\tresponse: Parameters<H>[1],\n) => ReturnType<H>;\n\n/**\n * What `.upload(bucket, …)` returns: the same builder, whose handler is also\n * given the signed form.\n */\nexport class UploadEndpointBuilder<\n\tTRoute extends string,\n\tTMethod extends HttpMethod,\n\tTInput extends EndpointSchemas = {},\n\tTServices extends Service[] = [],\n\tTLogger extends Logger = Logger,\n\tOutSchema extends StandardSchemaV1 | undefined = undefined,\n\tTSession = unknown,\n\tTAuthorizers extends readonly string[] = readonly string[],\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTAuditAction extends AuditableAction<string, unknown> = AuditableAction<\n\t\tstring,\n\t\tunknown\n\t>,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n> extends EndpointBuilder<\n\tTRoute,\n\tTMethod,\n\tTInput,\n\tTServices,\n\tTLogger,\n\tOutSchema,\n\tTSession,\n\tTAuthorizers,\n\tTAuditStorage,\n\tTAuditStorageServiceName,\n\tTAuditAction,\n\tTDatabase,\n\tTDatabaseServiceName\n> {\n\t/** The bucket's service, and what an upload to it allows. */\n\t_upload!: {\n\t\tserviceName: string;\n\t\toptions: UploadOptions<any>;\n\t};\n\n\toverride handle(\n\t\tfn: UploadHandler<\n\t\t\tEndpointHandler<\n\t\t\t\tTInput,\n\t\t\t\tTServices,\n\t\t\t\tTLogger,\n\t\t\t\tOutSchema,\n\t\t\t\tTSession,\n\t\t\t\tTDatabase,\n\t\t\t\tTAuditStorage,\n\t\t\t\tTAuditAction\n\t\t\t>\n\t\t>,\n\t): Endpoint<\n\t\tTRoute,\n\t\tTMethod,\n\t\tTInput,\n\t\tOutSchema,\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tconst { serviceName, options } = this._upload;\n\n\t\t// Issued once the request has been parsed and authorized — the key is\n\t\t// resolved from the body and the session — and before the handler runs.\n\t\t// Defined on the context rather than spread into a copy, so the lazy\n\t\t// accessors on it stay lazy.\n\t\tconst handler = (async (ctx: any, response: any) => {\n\t\t\tconst storage = ctx.services[serviceName] as StorageClient;\n\t\t\tconst upload = await issueUpload(storage, ctx, options);\n\t\t\tObject.defineProperty(ctx, 'upload', {\n\t\t\t\tvalue: upload,\n\t\t\t\tenumerable: true,\n\t\t\t});\n\t\t\treturn fn(ctx, response);\n\t\t}) as unknown as EndpointHandler<\n\t\t\tTInput,\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tOutSchema,\n\t\t\tTSession,\n\t\t\tTDatabase,\n\t\t\tTAuditStorage,\n\t\t\tTAuditAction\n\t\t>;\n\n\t\treturn super.handle(handler);\n\t}\n}\n","import type {\n\tAuditableAction,\n\tAuditStorage,\n\tExtractStorageAuditAction,\n} from '@geekmidas/audit';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport type { Service } from '@geekmidas/services';\nimport uniqBy from 'lodash.uniqby';\nimport {\n\ttype Consumable,\n\tidsOf,\n\tisConsumable,\n\ttype ServicesOf,\n\tserviceOf,\n\tservicesOf,\n} from '../construct-interface';\nimport type { HttpMethod } from '../types';\nimport {\n\ttype Authorizer,\n\ttype BuiltInSecuritySchemeId,\n\tgetSecurityScheme,\n\ttype SecurityScheme,\n} from './Authorizer';\nimport type { ActorExtractor } from './audit';\nimport type { AuthorizeFn, EndpointSurface, SessionFn } from './Endpoint';\nimport { EndpointBuilder } from './EndpointBuilder';\nimport type { RlsConfig } from './rls';\n\n// Re-export SecurityScheme to make the type portable in declaration files\nexport type { SecurityScheme } from './Authorizer';\n\nexport class EndpointFactory<\n\tTServices extends Service[] = [],\n\tTBasePath extends string = '',\n\tTLogger extends Logger = Logger,\n\tTSession = unknown,\n\tTAuthorizers extends readonly string[] = readonly string[],\n\tTAuditStorage extends AuditStorage<any> | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTAuditAction extends AuditableAction<\n\t\tstring,\n\t\tunknown\n\t> = ExtractStorageAuditAction<NonNullable<TAuditStorage>>,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n\tTSecuritySchemes extends Record<string, SecurityScheme> = Record<\n\t\tstring,\n\t\tSecurityScheme\n\t>,\n\tTRlsConfig extends\n\t\t| RlsConfig<TServices, TSession, TLogger>\n\t\t| undefined = undefined,\n> {\n\tprivate defaultServices: TServices = [] as unknown as TServices;\n\t/**\n\t * The constructs `.dependsOn()` was given, kept alongside the services they\n\t * dissolve into.\n\t *\n\t * `.dependsOn()` collapses straight into `.services()`, which is right for\n\t * *running* — a handler wants clients, not ids — and loses the one thing the\n\t * manifest needs: which constructs this endpoint reaches. Keeping the ids\n\t * here is what lets a route declare its edges, and lets a target derive its\n\t * environment from the graph rather than from sniffing what the code touched.\n\t */\n\tprivate defaultConstructs: string[] = [];\n\tprivate basePath: TBasePath = '' as TBasePath;\n\tprivate defaultAuthorizeFn?: AuthorizeFn<\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tundefined,\n\t\tTDatabase\n\t>;\n\tprivate defaultSessionExtractor?: SessionFn<\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tTDatabase\n\t>;\n\tprivate defaultLogger: TLogger;\n\t/**\n\t * The surface this factory belongs to, stamped onto everything it builds.\n\t *\n\t * Set only by `RestApi`, which is the only thing that has one. A factory\n\t * with no surface produces endpoints that carry none, which is what a\n\t * standalone endpoint has always been.\n\t */\n\tprivate surface: EndpointSurface;\n\tprivate availableAuthorizers: Authorizer[];\n\tprivate defaultAuthorizerName?: TAuthorizers[number];\n\tprivate defaultAuditorStorage:\n\t\t| Service<TAuditStorageServiceName, TAuditStorage>\n\t\t| undefined;\n\tprivate defaultDatabaseService:\n\t\t| Service<TDatabaseServiceName, TDatabase>\n\t\t| undefined;\n\tprivate defaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n\tprivate customSecuritySchemes: TSecuritySchemes;\n\tprivate defaultRlsConfig?: TRlsConfig;\n\n\tconstructor({\n\t\tbasePath,\n\t\tdefaultAuthorizeFn,\n\t\tdefaultLogger = DEFAULT_LOGGER as TLogger,\n\t\tdefaultSessionExtractor,\n\t\t// @ts-expect-error\n\t\tdefaultServices = [] as TServices,\n\t\tdefaultConstructs = [] as string[],\n\t\tavailableAuthorizers = [],\n\t\tdefaultAuthorizerName,\n\t\tdefaultAuditorStorage,\n\t\tdefaultDatabaseService,\n\t\tdefaultActorExtractor,\n\t\tcustomSecuritySchemes = {} as TSecuritySchemes,\n\t\tdefaultRlsConfig,\n\t\tsurface,\n\t}: EndpointFactoryOptions<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t>) {\n\t\t// Initialize default services\n\t\tthis.defaultConstructs = [...new Set(defaultConstructs)];\n\t\tthis.defaultServices = uniqBy(\n\t\t\tdefaultServices,\n\t\t\t(s) => s.serviceName,\n\t\t) as TServices;\n\n\t\tthis.basePath = basePath || ('' as TBasePath);\n\t\tthis.defaultAuthorizeFn = defaultAuthorizeFn;\n\t\tthis.defaultLogger = defaultLogger;\n\t\tthis.defaultSessionExtractor = defaultSessionExtractor;\n\t\tthis.availableAuthorizers = availableAuthorizers;\n\t\tthis.defaultAuthorizerName = defaultAuthorizerName;\n\t\tthis.defaultAuditorStorage = defaultAuditorStorage;\n\t\tthis.defaultDatabaseService = defaultDatabaseService;\n\t\tthis.defaultActorExtractor = defaultActorExtractor;\n\t\tthis.customSecuritySchemes = customSecuritySchemes;\n\t\tthis.defaultRlsConfig = defaultRlsConfig;\n\t\tthis.surface = surface;\n\t}\n\n\tstatic joinPaths<TBasePath extends string, P extends string>(\n\t\tpath: P,\n\t\tbasePath: TBasePath = '' as TBasePath,\n\t): JoinPaths<TBasePath, P> {\n\t\t// Handle empty cases\n\t\tif (!basePath && !path) return '/' as JoinPaths<TBasePath, P>;\n\t\tif (!basePath)\n\t\t\treturn (path.startsWith('/') ? path : `/${path}`) as JoinPaths<\n\t\t\t\tTBasePath,\n\t\t\t\tP\n\t\t\t>;\n\t\tif (!path)\n\t\t\treturn (\n\t\t\t\tbasePath.startsWith('/') ? basePath : `/${basePath}`\n\t\t\t) as JoinPaths<TBasePath, P>;\n\n\t\tconst base = basePath.endsWith('/') ? basePath.slice(0, -1) : basePath;\n\t\tconst segment = path.startsWith('/') ? path : `/${path}`;\n\n\t\tlet result = base + segment;\n\n\t\t// Ensure leading slash\n\t\tif (!result.startsWith('/')) {\n\t\t\tresult = `/${result}`;\n\t\t}\n\n\t\t// Normalize multiple slashes (except in the middle of the path where they might be intentional)\n\t\tresult = result.replace(/^\\/+/g, '/');\n\n\t\t// Remove trailing slash unless it's the root path \"/\"\n\t\tif (result.length > 1 && result.endsWith('/')) {\n\t\t\tresult = result.slice(0, -1);\n\t\t}\n\n\t\treturn result as JoinPaths<TBasePath, P>;\n\t}\n\n\t// Configure available authorizers\n\tauthorizers<const T extends readonly string[]>(\n\t\tauthorizers: T,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tT,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t> {\n\t\tconst authorizerConfigs = authorizers.map((name) => ({\n\t\t\tname,\n\t\t\tsecurityScheme: getSecurityScheme(name, this.customSecuritySchemes),\n\t\t}));\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tT,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: authorizerConfigs,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this.defaultActorExtractor,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t/**\n\t * Define custom security schemes for this factory.\n\t * These extend the built-in schemes (jwt, bearer, apiKey, oauth2, oidc).\n\t *\n\t * @example\n\t * ```typescript\n\t * const router = e.securitySchemes({\n\t * awsIamSigV4: {\n\t * type: 'apiKey',\n\t * in: 'header',\n\t * name: 'Authorization',\n\t * 'x-amazon-apigateway-authtype': 'awsSigv4',\n\t * },\n\t * });\n\t * ```\n\t */\n\tsecuritySchemes<T extends Record<string, SecurityScheme>>(\n\t\tschemes: T,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes & T,\n\t\tTRlsConfig\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes & T,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this.defaultActorExtractor,\n\t\t\tcustomSecuritySchemes: {\n\t\t\t\t...this.customSecuritySchemes,\n\t\t\t\t...schemes,\n\t\t\t} as TSecuritySchemes & T,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t/**\n\t * Set the default authorizer for all endpoints created from this factory.\n\t * Individual endpoints can override this by calling `.authorizer()` on the builder.\n\t * Use `'none'` to explicitly disable authorization for all endpoints.\n\t *\n\t * Accepts:\n\t * - Built-in security scheme names: 'jwt', 'bearer', 'apiKey', 'oauth2', 'oidc'\n\t * - Custom security scheme names defined via `.securitySchemes()`\n\t * - 'none' to disable authorization\n\t */\n\tauthorizer(\n\t\tname:\n\t\t\t| BuiltInSecuritySchemeId\n\t\t\t| keyof TSecuritySchemes\n\t\t\t| TAuthorizers[number]\n\t\t\t| 'none',\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t> {\n\t\t// Validate that the authorizer exists in available authorizers (if authorizers() was called)\n\t\tif (name !== 'none' && this.availableAuthorizers.length > 0) {\n\t\t\tconst authorizerExists = this.availableAuthorizers.some(\n\t\t\t\t(a) => a.name === name,\n\t\t\t);\n\t\t\tif (!authorizerExists) {\n\t\t\t\tconst available = this.availableAuthorizers\n\t\t\t\t\t.map((a) => a.name)\n\t\t\t\t\t.join(', ');\n\t\t\t\tthrow new Error(\n\t\t\t\t\t`Authorizer \"${name as string}\" not found in available authorizers: ${available}`,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName:\n\t\t\t\tname === 'none' ? undefined : (name as TAuthorizers[number]),\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this.defaultActorExtractor,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t// Create a sub-router with a path prefix\n\troute<TPath extends string>(\n\t\tpath: TPath,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tJoinPaths<TBasePath, TPath>,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t> {\n\t\tconst newBasePath = EndpointFactory.joinPaths(path, this.basePath);\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tJoinPaths<TBasePath, TPath>,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: newBasePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this.defaultActorExtractor,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t// Create a new factory with authorization\n\tauthorize(\n\t\tfn: AuthorizeFn<TServices, TLogger, TSession, undefined, TDatabase>,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: fn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this.defaultActorExtractor,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t// Create a new factory with services\n\t/**\n\t * Depend on constructs — a database, a bucket, a mail sender, a queue, a\n\t * topic.\n\t *\n\t * It records the edge and dissolves each construct's client into the\n\t * handler's service record under the construct's own id, so\n\t * `.dependsOn([uploads])` is what makes `services.uploads` exist and type.\n\t *\n\t * Constructs only. A `Service` does not match the shape, which is what keeps\n\t * env sniffing confined to `.services()` and the explicit lift.\n\t */\n\tdependsOn<const S extends readonly Consumable[]>(\n\t\tconstructs: S,\n\t): EndpointFactory<\n\t\t[...ServicesOf<S>, ...TServices],\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tRlsConfig<[...ServicesOf<S>, ...TServices], TSession, TLogger> | undefined\n\t> {\n\t\t// The services are what a handler *runs* with; the ids are what the\n\t\t// manifest needs. Dissolving to services alone is what lost the edges —\n\t\t// the same information, one of the two forms discarded.\n\t\tconst next = this.services(servicesOf(constructs) as unknown as Service[]);\n\t\tnext.defaultConstructs = [\n\t\t\t...new Set([\n\t\t\t\t...this.defaultConstructs,\n\t\t\t\t...constructs.map((construct) => construct.id),\n\t\t\t]),\n\t\t];\n\n\t\treturn next as unknown as EndpointFactory<\n\t\t\t[...ServicesOf<S>, ...TServices],\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tRlsConfig<[...ServicesOf<S>, ...TServices], TSession, TLogger> | undefined\n\t\t>;\n\t}\n\n\tservices<S extends Service[]>(\n\t\tservices: S,\n\t): EndpointFactory<\n\t\t[...S, ...TServices],\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tRlsConfig<[...S, ...TServices], TSession, TLogger> | undefined\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\t[...S, ...TServices],\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tRlsConfig<[...S, ...TServices], TSession, TLogger> | undefined\n\t\t>({\n\t\t\tdefaultServices: [...services, ...this.defaultServices],\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<\n\t\t\t\t[...S, ...TServices],\n\t\t\t\tTLogger,\n\t\t\t\tTSession\n\t\t\t>,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor as unknown as\n\t\t\t\t| SessionFn<[...S, ...TServices], TLogger, TSession, TDatabase>\n\t\t\t\t| undefined,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this.defaultActorExtractor as unknown as\n\t\t\t\t| ActorExtractor<[...S, ...TServices], TSession, TLogger>\n\t\t\t\t| undefined,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig as unknown as\n\t\t\t\t| RlsConfig<[...S, ...TServices], TSession, TLogger>\n\t\t\t\t| undefined,\n\t\t});\n\t}\n\n\tlogger<L extends Logger>(\n\t\tlogger: L,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tL,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tRlsConfig<TServices, TSession, L> | undefined\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tL,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tRlsConfig<TServices, TSession, L> | undefined\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<\n\t\t\t\tTServices,\n\t\t\t\tL,\n\t\t\t\tTSession\n\t\t\t>,\n\t\t\tdefaultLogger: logger,\n\t\t\tdefaultSessionExtractor: this\n\t\t\t\t.defaultSessionExtractor as unknown as SessionFn<\n\t\t\t\tTServices,\n\t\t\t\tL,\n\t\t\t\tTSession\n\t\t\t>,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this\n\t\t\t\t.defaultActorExtractor as unknown as ActorExtractor<\n\t\t\t\tTServices,\n\t\t\t\tTSession,\n\t\t\t\tL\n\t\t\t>,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig as unknown as\n\t\t\t\t| RlsConfig<TServices, TSession, L>\n\t\t\t\t| undefined,\n\t\t});\n\t}\n\n\tsession<T>(\n\t\tsession: SessionFn<TServices, TLogger, T, TDatabase>,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tT,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tRlsConfig<TServices, T, TLogger> | undefined\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tT,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tRlsConfig<TServices, T, TLogger> | undefined\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn as unknown as AuthorizeFn<\n\t\t\t\tTServices,\n\t\t\t\tTLogger,\n\t\t\t\tT\n\t\t\t>,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: session,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this\n\t\t\t\t.defaultActorExtractor as unknown as ActorExtractor<\n\t\t\t\tTServices,\n\t\t\t\tT,\n\t\t\t\tTLogger\n\t\t\t>,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig as unknown as\n\t\t\t\t| RlsConfig<TServices, T, TLogger>\n\t\t\t\t| undefined,\n\t\t});\n\t}\n\n\t/**\n\t * Set the database service for endpoints created from this factory.\n\t * The database will be available in handler context as `db`.\n\t */\n\tdatabase<T, TName extends string>(\n\t\tsource: Consumable<TName, T> | Service<TName, T>,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tT,\n\t\tTName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t> {\n\t\tconst service = serviceOf(source);\n\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tT,\n\t\t\tTName,\n\t\t\tTSecuritySchemes,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\t// The database is an edge like any `.dependsOn()`: without its id here an\n\t\t\t// endpoint built from `api.database(db)` reached a database the\n\t\t\t// manifest never heard of, so nothing composed from the edges — a\n\t\t\t// deploy's grants, an app container's environment — included it.\n\t\t\tdefaultConstructs: isConsumable(source)\n\t\t\t\t? idsOf([source], this.defaultConstructs)\n\t\t\t\t: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn as unknown as\n\t\t\t\t| AuthorizeFn<TServices, TLogger, TSession, undefined, T>\n\t\t\t\t| undefined,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\t// Reset session extractor when database changes - user should call .session() after .database()\n\t\t\t// to get proper type inference for the new database type\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor as unknown as\n\t\t\t\t| SessionFn<TServices, TLogger, TSession, T>\n\t\t\t\t| undefined,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: service,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t/**\n\t * Set the auditor storage service for endpoints created from this factory.\n\t * This enables audit functionality and makes `auditor` available in handler context.\n\t * The audit action type is automatically inferred from the storage's generic parameter.\n\t */\n\tauditor<T extends AuditStorage<any>, TName extends string>(\n\t\tstorage: Service<TName, T>,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tT,\n\t\tTName,\n\t\tExtractStorageAuditAction<T>,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tT,\n\t\t\tTName,\n\t\t\tExtractStorageAuditAction<T>,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: storage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this\n\t\t\t\t.defaultActorExtractor as unknown as ActorExtractor<\n\t\t\t\tTServices,\n\t\t\t\tTSession,\n\t\t\t\tTLogger\n\t\t\t>,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t/**\n\t * Set the actor extractor function for endpoints created from this factory.\n\t * The actor is extracted from the request context and attached to all audits.\n\t */\n\tactor(\n\t\textractor: ActorExtractor<TServices, TSession, TLogger>,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTRlsConfig\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tTRlsConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: extractor,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: this.defaultRlsConfig,\n\t\t});\n\t}\n\n\t/**\n\t * Set the RLS (Row-Level Security) configuration for endpoints created from this factory.\n\t * This enables automatic PostgreSQL session variable setting for RLS policies.\n\t *\n\t * @example\n\t * ```typescript\n\t * const api = new EndpointFactory()\n\t * .database(databaseService)\n\t * .session(extractSession)\n\t * .rls({\n\t * extractor: ({ session }) => ({\n\t * user_id: session.userId,\n\t * tenant_id: session.tenantId,\n\t * }),\n\t * prefix: 'app',\n\t * });\n\t * ```\n\t */\n\trls<TConfig extends RlsConfig<TServices, TSession, TLogger>>(\n\t\tconfig: TConfig,\n\t): EndpointFactory<\n\t\tTServices,\n\t\tTBasePath,\n\t\tTLogger,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName,\n\t\tTSecuritySchemes,\n\t\tTConfig\n\t> {\n\t\treturn new EndpointFactory<\n\t\t\tTServices,\n\t\t\tTBasePath,\n\t\t\tTLogger,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName,\n\t\t\tTSecuritySchemes,\n\t\t\tTConfig\n\t\t>({\n\t\t\tdefaultServices: this.defaultServices,\n\t\t\tdefaultConstructs: this.defaultConstructs,\n\t\t\tbasePath: this.basePath,\n\t\t\tdefaultAuthorizeFn: this.defaultAuthorizeFn,\n\t\t\tdefaultLogger: this.defaultLogger,\n\t\t\tdefaultSessionExtractor: this.defaultSessionExtractor,\n\t\t\tavailableAuthorizers: this.availableAuthorizers,\n\t\t\tdefaultAuthorizerName: this.defaultAuthorizerName,\n\t\t\tdefaultAuditorStorage: this.defaultAuditorStorage,\n\t\t\tdefaultDatabaseService: this.defaultDatabaseService,\n\t\t\tdefaultActorExtractor: this.defaultActorExtractor,\n\t\t\tcustomSecuritySchemes: this.customSecuritySchemes,\n\t\t\tsurface: this.surface,\n\t\t\tdefaultRlsConfig: config,\n\t\t});\n\t}\n\n\tprivate createBuilder<TMethod extends HttpMethod, TPath extends string>(\n\t\tmethod: TMethod,\n\t\tpath: TPath,\n\t): EndpointBuilder<\n\t\tJoinPaths<TBasePath, TPath>,\n\t\tTMethod,\n\t\t{},\n\t\tTServices,\n\t\tTLogger,\n\t\tundefined,\n\t\tTSession,\n\t\tTAuthorizers,\n\t\tTAuditStorage,\n\t\tTAuditStorageServiceName,\n\t\tTAuditAction,\n\t\tTDatabase,\n\t\tTDatabaseServiceName\n\t> {\n\t\tconst fullPath = EndpointFactory.joinPaths(path, this.basePath);\n\t\tconst builder = new EndpointBuilder<\n\t\t\tJoinPaths<TBasePath, TPath>,\n\t\t\tTMethod,\n\t\t\t{},\n\t\t\tTServices,\n\t\t\tTLogger,\n\t\t\tundefined,\n\t\t\tTSession,\n\t\t\tTAuthorizers,\n\t\t\tTAuditStorage,\n\t\t\tTAuditStorageServiceName,\n\t\t\tTAuditAction,\n\t\t\tTDatabase,\n\t\t\tTDatabaseServiceName\n\t\t>(fullPath, method);\n\n\t\tif (this.defaultAuthorizeFn) {\n\t\t\tbuilder._authorize = this.defaultAuthorizeFn as any;\n\t\t}\n\t\tif (this.defaultServices.length) {\n\t\t\t// Create a copy to avoid sharing references between builders\n\t\t\tbuilder._services = [...this.defaultServices] as TServices;\n\t\t}\n\t\tif (this.defaultConstructs.length) {\n\t\t\t// Alongside the services, not instead of them: one is what the handler\n\t\t\t// runs with, the other is what the manifest records it reaches.\n\t\t\tbuilder._constructs = [...this.defaultConstructs];\n\t\t}\n\n\t\tif (this.defaultLogger) {\n\t\t\tbuilder._logger = this.defaultLogger as TLogger;\n\t\t}\n\n\t\tbuilder._surface = this.surface;\n\n\t\tif (this.defaultSessionExtractor) {\n\t\t\tbuilder._getSession = this.defaultSessionExtractor as SessionFn<\n\t\t\t\tTServices,\n\t\t\t\tTLogger,\n\t\t\t\tTSession\n\t\t\t>;\n\t\t}\n\n\t\t// Set available authorizers and default\n\t\tbuilder._availableAuthorizers = this.availableAuthorizers;\n\t\tif (this.defaultAuthorizerName) {\n\t\t\tbuilder._authorizerName = this.defaultAuthorizerName;\n\t\t}\n\n\t\t// Set auditor storage if configured\n\t\tif (this.defaultAuditorStorage) {\n\t\t\tbuilder._setAuditorStorage(this.defaultAuditorStorage as any);\n\t\t}\n\n\t\t// Set database service if configured\n\t\tif (this.defaultDatabaseService) {\n\t\t\tbuilder._setDatabaseService(this.defaultDatabaseService as any);\n\t\t}\n\n\t\t// Set actor extractor if configured\n\t\tif (this.defaultActorExtractor) {\n\t\t\tbuilder._actorExtractor = this.defaultActorExtractor;\n\t\t}\n\n\t\t// Set custom security schemes\n\t\tbuilder._customSecuritySchemes = this.customSecuritySchemes;\n\n\t\t// Set RLS config if configured\n\t\tif (this.defaultRlsConfig) {\n\t\t\tbuilder._rlsConfig = this.defaultRlsConfig as any;\n\t\t}\n\n\t\treturn builder;\n\t}\n\n\tpost<TPath extends string>(path: TPath) {\n\t\treturn this.createBuilder('POST', path);\n\t}\n\n\tget<TPath extends string>(path: TPath) {\n\t\treturn this.createBuilder('GET', path);\n\t}\n\n\tput<TPath extends string>(path: TPath) {\n\t\treturn this.createBuilder('PUT', path);\n\t}\n\n\tdelete<TPath extends string>(path: TPath) {\n\t\treturn this.createBuilder('DELETE', path);\n\t}\n\n\tpatch<TPath extends string>(path: TPath) {\n\t\treturn this.createBuilder('PATCH', path);\n\t}\n\n\toptions<TPath extends string>(path: TPath) {\n\t\treturn this.createBuilder('OPTIONS', path);\n\t}\n}\n\nexport type RemoveTrailingSlash<T extends string> = T extends `${infer Rest}/`\n\t? Rest extends ''\n\t\t? T // Keep \"/\" as is\n\t\t: Rest\n\t: T;\n\nexport type JoinPaths<\n\tTBasePath extends string,\n\tTPath extends string,\n> = RemoveTrailingSlash<\n\tTBasePath extends ''\n\t\t? TPath\n\t\t: TPath extends ''\n\t\t\t? TBasePath\n\t\t\t: TBasePath extends '/'\n\t\t\t\t? TPath extends `/${string}`\n\t\t\t\t\t? TPath\n\t\t\t\t\t: `/${TPath}`\n\t\t\t\t: TBasePath extends `${infer Base}/`\n\t\t\t\t\t? TPath extends `/${infer Rest}`\n\t\t\t\t\t\t? `${Base}/${Rest}`\n\t\t\t\t\t\t: `${Base}/${TPath}`\n\t\t\t\t\t: TPath extends `/${infer Rest}`\n\t\t\t\t\t\t? `${TBasePath}/${Rest}`\n\t\t\t\t\t\t: `${TBasePath}/${TPath}`\n>;\n\nexport interface EndpointFactoryOptions<\n\tTServices extends Service[] = [],\n\tTBasePath extends string = '',\n\tTLogger extends Logger = Logger,\n\tTSession = unknown,\n\tTAuthorizers extends readonly string[] = readonly string[],\n\tTAuditStorage extends AuditStorage | undefined = undefined,\n\tTAuditStorageServiceName extends string = string,\n\tTDatabase = undefined,\n\tTDatabaseServiceName extends string = string,\n\tTSecuritySchemes extends Record<string, SecurityScheme> = Record<\n\t\tstring,\n\t\tSecurityScheme\n\t>,\n\tTRlsConfig extends\n\t\t| RlsConfig<TServices, TSession, TLogger>\n\t\t| undefined = undefined,\n> {\n\tdefaultServices?: TServices;\n\t/** Construct ids from `.dependsOn()`, carried so a route can declare edges. */\n\tdefaultConstructs?: string[];\n\tbasePath?: TBasePath;\n\tdefaultAuthorizeFn?: AuthorizeFn<\n\t\tTServices,\n\t\tTLogger,\n\t\tTSession,\n\t\tundefined,\n\t\tTDatabase\n\t>;\n\tdefaultLogger?: TLogger;\n\tdefaultSessionExtractor?: SessionFn<TServices, TLogger, TSession, TDatabase>;\n\tavailableAuthorizers?: Authorizer[];\n\tdefaultAuthorizerName?: TAuthorizers[number];\n\tdefaultAuditorStorage?: Service<TAuditStorageServiceName, TAuditStorage>;\n\tdefaultDatabaseService?: Service<TDatabaseServiceName, TDatabase>;\n\tdefaultActorExtractor?: ActorExtractor<TServices, TSession, TLogger>;\n\tcustomSecuritySchemes?: TSecuritySchemes;\n\tdefaultRlsConfig?: TRlsConfig;\n\t/**\n\t * The surface this factory belongs to.\n\t *\n\t * Required. A factory exists to build endpoints for a surface, and an\n\t * endpoint without one has no logger, no env parser and nothing to\n\t * attribute its traffic to — which was survivable only while `e` existed.\n\t *\n\t * Carried through every derived factory, so `api.database(db)`\n\t * still produces endpoints that know which API serves them.\n\t */\n\tsurface: EndpointSurface;\n}\n"],"mappings":"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"}
@@ -0,0 +1,76 @@
1
+ import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.cjs";
2
+ import { n as ConstructType, o as TopicEvent, t as Construct } from "./Construct-127M7yrl.cjs";
3
+ import { Logger } from "@geekmidas/logger";
4
+ import { ComposableStandardSchema, InferComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
5
+ import { Service, ServiceRecord } from "@geekmidas/services";
6
+ import { AuditStorage, AuditableAction, Auditor } from "@geekmidas/audit";
7
+ //#region src/functions/Function.d.ts
8
+ declare class Function<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, Fn extends FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase, TAuditStorage, TAuditAction> = FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase, TAuditStorage, TAuditAction>> extends Construct<TLogger, OutSchema, TServices, TAuditStorageServiceName, TAuditStorage> {
9
+ readonly fn: Fn;
10
+ input?: TInput | undefined;
11
+ databaseService?: Service<TDatabaseServiceName, TDatabase>;
12
+ __IS_FUNCTION__: boolean;
13
+ static isFunction(obj: any): obj is Function<any, any, any, any, any>;
14
+ /**
15
+ * Validates data against a StandardSchema.
16
+ *
17
+ * @param schema - The StandardSchema to validate against
18
+ * @param data - The data to validate
19
+ * @returns Validation result with value or issues
20
+ */
21
+ static validate<T extends StandardSchemaV1>(schema: T, data: unknown): Promise<StandardSchemaV1.Result<unknown>> | StandardSchemaV1.Result<unknown>;
22
+ /**
23
+ * Parses and validates data against a schema, throwing an error if validation fails.
24
+ *
25
+ * @param schema - The StandardSchema to validate against
26
+ * @param data - The data to parse and validate
27
+ * @returns The validated data with proper typing
28
+ * @throws {UnprocessableEntityError} When validation fails
29
+ */
30
+ static parseSchema<T extends StandardSchemaV1>(schema: T, data: unknown): Promise<InferStandardSchema<T>>;
31
+ /**
32
+ * Parses and validates the endpoint output against the output schema.
33
+ *
34
+ * @param output - The raw output data to validate
35
+ * @returns The validated output data
36
+ * @throws {UnprocessableEntityError} When output validation fails
37
+ */
38
+ parseOutput(output: unknown): Promise<InferStandardSchema<OutSchema>>;
39
+ constructor(fn: Fn, timeout?: number // Default timeout of 30 seconds
40
+ , type?: ConstructType, input?: TInput | undefined, outputSchema?: OutSchema, services?: TServices, logger?: TLogger,
41
+ /** What it publishes once its handler succeeds, each to its own topic. */
42
+ events?: TopicEvent[], memorySize?: number, auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage>, databaseService?: Service<TDatabaseServiceName, TDatabase>,
43
+ /**
44
+ * The construct ids `.dependsOn()` named — last, so no existing positional
45
+ * argument moves.
46
+ */
47
+ constructs?: string[]);
48
+ }
49
+ type FunctionHandler<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TDatabase = undefined, TAuditStorage extends AuditStorage | undefined = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = (ctx: FunctionContext<TInput, TServices, TLogger, TDatabase, TAuditStorage, TAuditAction>) => OutSchema extends StandardSchemaV1 ? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>> : any | Promise<any>;
50
+ /**
51
+ * Conditional type that adds `db` property only when TDatabase is configured.
52
+ *
53
+ * Exported because a queue's and a subscriber's context take `db` the same
54
+ * way, and one definition is what keeps the three from disagreeing.
55
+ */
56
+ type DatabaseContext<TDatabase> = TDatabase extends undefined ? {} : {
57
+ db: TDatabase;
58
+ };
59
+ /**
60
+ * Conditional auditor context - only present when audit storage is configured.
61
+ */
62
+ type AuditorContext<TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TAuditStorage = undefined> = TAuditStorage extends undefined ? {} : {
63
+ /**
64
+ * Auditor instance for recording audit events.
65
+ * Only present when audit storage is configured on the function.
66
+ */
67
+ auditor: Auditor<TAuditAction>;
68
+ };
69
+ type FunctionContext<Input extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TDatabase = undefined, TAuditStorage extends AuditStorage | undefined = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = {
70
+ services: ServiceRecord<TServices>;
71
+ logger: TLogger;
72
+ input: InferComposableStandardSchema<Input>;
73
+ } & DatabaseContext<TDatabase> & AuditorContext<TAuditAction, TAuditStorage>;
74
+ //#endregion
75
+ export { FunctionHandler as i, Function as n, FunctionContext as r, DatabaseContext as t };
76
+ //# sourceMappingURL=Function-BIEsY0Hm.d.cts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Function-BIEsY0Hm.d.cts","names":[],"sources":["../src/functions/Function.ts"],"mappings":";;;;;;;cAgDa,SACZ,eAAe,kDACf,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,sBAAsB,sCACtB,kDACA,uBACA,8CACA,qBAAqB,mCAAmC,kCAIxD,WAAW,gBACV,QACA,WACA,SACA,WACA,WACA,eACA,gBACG,gBACH,QACA,WACA,SACA,WACA,WACA,eACA,uBAEQ,UACT,SACA,WACA,WACA,0BACA;WAyDiB,IAAI;EAGb,QAAQ;EAQC,kBAAkB,QAAQ,sBAAsB;EAlEjE;SAEO,WAAW,WAAW,OAAO;;;;;;;;SAe7B,SAAS,UAAU,kBAAkB,QAAQ,GAAG,gBAAa,QAAA,iBAAA,mBAAA,iBAAA;;;;;;;;;SAYvD,YAAY,UAAU,kBAClC,QAAQ,GACR,gBACE,QAAQ,oBAAoB;;;;;;;;EAezB,YAAY,kBAAkB,QAAQ,oBAAoB;EAOhE,YACiB,IAAI,IACpB;IACA,OAAM,eACC,QAAQ,oBACf,eAAe,WACf,WAAU,WACV,SAAQ,SAER;;EAAA,SAAQ,cACR,qBACA,wBAAwB,QAAQ,0BAA0B,gBAC1C,kBAAkB,QAAQ,sBAAsB,YAKhE;;;;;EAAA;;KAgBU,gBACX,eAAe,kDACf,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,uBACA,sBAAsB,sCACtB,qBAAqB,mCAAmC,qCAKxD,KAAK,gBACJ,QACA,WACA,SACA,WACA,eACA,kBAEG,kBAAkB,mBACpB,oBAAoB,aAAa,QAAQ,oBAAoB,oBACvD;;;;;;;KAQG,gBAAgB,aAAa;EAEpC,IAAI;;;;;KAKJ,eACJ,qBAAqB,mCAAmC,kCAIxD,6BACG;;;;;EAOD,SAAS,QAAQ;;KAGR,gBACX,cAAc,kDACd,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,uBACA,sBAAsB,sCACtB,qBAAqB,mCAAmC;EAKxD,UAAU,cAAc;EACxB,QAAQ;EACR,OAAO,8BAA8B;IAClC,gBAAgB,aACnB,eAAe,cAAc"}
@@ -0,0 +1,76 @@
1
+ import { n as StandardSchemaV1 } from "./index-DdRjYhiJ.mjs";
2
+ import { n as ConstructType, o as TopicEvent, t as Construct } from "./Construct-DySlwh8o.mjs";
3
+ import { Service, ServiceRecord } from "@geekmidas/services";
4
+ import { AuditStorage, AuditableAction, Auditor } from "@geekmidas/audit";
5
+ import { Logger } from "@geekmidas/logger";
6
+ import { ComposableStandardSchema, InferComposableStandardSchema, InferStandardSchema } from "@geekmidas/schema";
7
+ //#region src/functions/Function.d.ts
8
+ declare class Function<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TAuditStorage extends AuditStorage | undefined = undefined, TAuditStorageServiceName extends string = string, TDatabase = undefined, TDatabaseServiceName extends string = string, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, Fn extends FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase, TAuditStorage, TAuditAction> = FunctionHandler<TInput, TServices, TLogger, OutSchema, TDatabase, TAuditStorage, TAuditAction>> extends Construct<TLogger, OutSchema, TServices, TAuditStorageServiceName, TAuditStorage> {
9
+ readonly fn: Fn;
10
+ input?: TInput | undefined;
11
+ databaseService?: Service<TDatabaseServiceName, TDatabase>;
12
+ __IS_FUNCTION__: boolean;
13
+ static isFunction(obj: any): obj is Function<any, any, any, any, any>;
14
+ /**
15
+ * Validates data against a StandardSchema.
16
+ *
17
+ * @param schema - The StandardSchema to validate against
18
+ * @param data - The data to validate
19
+ * @returns Validation result with value or issues
20
+ */
21
+ static validate<T extends StandardSchemaV1>(schema: T, data: unknown): Promise<StandardSchemaV1.Result<unknown>> | StandardSchemaV1.Result<unknown>;
22
+ /**
23
+ * Parses and validates data against a schema, throwing an error if validation fails.
24
+ *
25
+ * @param schema - The StandardSchema to validate against
26
+ * @param data - The data to parse and validate
27
+ * @returns The validated data with proper typing
28
+ * @throws {UnprocessableEntityError} When validation fails
29
+ */
30
+ static parseSchema<T extends StandardSchemaV1>(schema: T, data: unknown): Promise<InferStandardSchema<T>>;
31
+ /**
32
+ * Parses and validates the endpoint output against the output schema.
33
+ *
34
+ * @param output - The raw output data to validate
35
+ * @returns The validated output data
36
+ * @throws {UnprocessableEntityError} When output validation fails
37
+ */
38
+ parseOutput(output: unknown): Promise<InferStandardSchema<OutSchema>>;
39
+ constructor(fn: Fn, timeout?: number // Default timeout of 30 seconds
40
+ , type?: ConstructType, input?: TInput | undefined, outputSchema?: OutSchema, services?: TServices, logger?: TLogger,
41
+ /** What it publishes once its handler succeeds, each to its own topic. */
42
+ events?: TopicEvent[], memorySize?: number, auditorStorageService?: Service<TAuditStorageServiceName, TAuditStorage>, databaseService?: Service<TDatabaseServiceName, TDatabase>,
43
+ /**
44
+ * The construct ids `.dependsOn()` named — last, so no existing positional
45
+ * argument moves.
46
+ */
47
+ constructs?: string[]);
48
+ }
49
+ type FunctionHandler<TInput extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, OutSchema extends StandardSchemaV1 | undefined = undefined, TDatabase = undefined, TAuditStorage extends AuditStorage | undefined = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = (ctx: FunctionContext<TInput, TServices, TLogger, TDatabase, TAuditStorage, TAuditAction>) => OutSchema extends StandardSchemaV1 ? InferStandardSchema<OutSchema> | Promise<InferStandardSchema<OutSchema>> : any | Promise<any>;
50
+ /**
51
+ * Conditional type that adds `db` property only when TDatabase is configured.
52
+ *
53
+ * Exported because a queue's and a subscriber's context take `db` the same
54
+ * way, and one definition is what keeps the three from disagreeing.
55
+ */
56
+ type DatabaseContext<TDatabase> = TDatabase extends undefined ? {} : {
57
+ db: TDatabase;
58
+ };
59
+ /**
60
+ * Conditional auditor context - only present when audit storage is configured.
61
+ */
62
+ type AuditorContext<TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>, TAuditStorage = undefined> = TAuditStorage extends undefined ? {} : {
63
+ /**
64
+ * Auditor instance for recording audit events.
65
+ * Only present when audit storage is configured on the function.
66
+ */
67
+ auditor: Auditor<TAuditAction>;
68
+ };
69
+ type FunctionContext<Input extends ComposableStandardSchema | undefined = undefined, TServices extends Service[] = [], TLogger extends Logger = Logger, TDatabase = undefined, TAuditStorage extends AuditStorage | undefined = undefined, TAuditAction extends AuditableAction<string, unknown> = AuditableAction<string, unknown>> = {
70
+ services: ServiceRecord<TServices>;
71
+ logger: TLogger;
72
+ input: InferComposableStandardSchema<Input>;
73
+ } & DatabaseContext<TDatabase> & AuditorContext<TAuditAction, TAuditStorage>;
74
+ //#endregion
75
+ export { FunctionHandler as i, Function as n, FunctionContext as r, DatabaseContext as t };
76
+ //# sourceMappingURL=Function-DfMzTGS4.d.mts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"Function-DfMzTGS4.d.mts","names":[],"sources":["../src/functions/Function.ts"],"mappings":";;;;;;;cAgDa,SACZ,eAAe,kDACf,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,sBAAsB,sCACtB,kDACA,uBACA,8CACA,qBAAqB,mCAAmC,kCAIxD,WAAW,gBACV,QACA,WACA,SACA,WACA,WACA,eACA,gBACG,gBACH,QACA,WACA,SACA,WACA,WACA,eACA,uBAEQ,UACT,SACA,WACA,WACA,0BACA;WAyDiB,IAAI;EAGb,QAAQ;EAQC,kBAAkB,QAAQ,sBAAsB;EAlEjE;SAEO,WAAW,WAAW,OAAO;;;;;;;;SAe7B,SAAS,UAAU,kBAAkB,QAAQ,GAAG,gBAAa,QAAA,iBAAA,mBAAA,iBAAA;;;;;;;;;SAYvD,YAAY,UAAU,kBAClC,QAAQ,GACR,gBACE,QAAQ,oBAAoB;;;;;;;;EAezB,YAAY,kBAAkB,QAAQ,oBAAoB;EAOhE,YACiB,IAAI,IACpB;IACA,OAAM,eACC,QAAQ,oBACf,eAAe,WACf,WAAU,WACV,SAAQ,SAER;;EAAA,SAAQ,cACR,qBACA,wBAAwB,QAAQ,0BAA0B,gBAC1C,kBAAkB,QAAQ,sBAAsB,YAKhE;;;;;EAAA;;KAgBU,gBACX,eAAe,kDACf,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,kBAAkB,0CAClB,uBACA,sBAAsB,sCACtB,qBAAqB,mCAAmC,qCAKxD,KAAK,gBACJ,QACA,WACA,SACA,WACA,eACA,kBAEG,kBAAkB,mBACpB,oBAAoB,aAAa,QAAQ,oBAAoB,oBACvD;;;;;;;KAQG,gBAAgB,aAAa;EAEpC,IAAI;;;;;KAKJ,eACJ,qBAAqB,mCAAmC,kCAIxD,6BACG;;;;;EAOD,SAAS,QAAQ;;KAGR,gBACX,cAAc,kDACd,kBAAkB,gBAClB,gBAAgB,SAAS,QACzB,uBACA,sBAAsB,sCACtB,qBAAqB,mCAAmC;EAKxD,UAAU,cAAc;EACxB,QAAQ;EACR,OAAO,8BAA8B;IAClC,gBAAgB,aACnB,eAAe,cAAc"}
@@ -1,12 +1,11 @@
1
1
  const require_rolldown_runtime = require("./rolldown-runtime-y5ARvAq5.cjs");
2
- const require_Endpoint = require("./Endpoint-s0AyrQGC.cjs");
3
- const require_lazyAccessors = require("./lazyAccessors-Dx9NLwJZ.cjs");
4
- const require_processAudits = require("./processAudits-D_2W5x8k.cjs");
2
+ const require_functions = require("./functions-DLF6-IK8.cjs");
3
+ const require_Endpoint = require("./Endpoint-BcUorcBa.cjs");
4
+ const require_readRequestBody = require("./readRequestBody-Dej_L3c4.cjs");
5
+ const require_requestLogger = require("./requestLogger-BZcXwdBs.cjs");
6
+ let _geekmidas_services = require("@geekmidas/services");
5
7
  let _geekmidas_errors = require("@geekmidas/errors");
6
8
  let hono_cookie = require("hono/cookie");
7
- let _geekmidas_db_rls = require("@geekmidas/db/rls");
8
- let _geekmidas_rate_limit = require("@geekmidas/rate-limit");
9
- let _geekmidas_services = require("@geekmidas/services");
10
9
  let hono = require("hono");
11
10
  let hono_logger = require("hono/logger");
12
11
  let hono_timing = require("hono/timing");
@@ -149,7 +148,20 @@ var HonoEndpoint = class HonoEndpoint {
149
148
  const method = endpoint.method.toLowerCase();
150
149
  const features = analyzeEndpointFeatures(endpoint);
151
150
  const validators = [];
152
- if (features.hasBodyValidation) validators.push((0, hono_validator.validator)("json", (value, c) => HonoEndpoint.validate(c, value, endpoint.input?.body)));
151
+ if (features.hasBodyValidation) validators.push(async (c, next) => {
152
+ let raw;
153
+ try {
154
+ raw = await require_readRequestBody.readRequestBody(c.req, c.req.header("content-type"), { untyped: "empty" });
155
+ } catch (error) {
156
+ if (!(0, _geekmidas_errors.isHttpError)(error)) throw error;
157
+ setErrorHeaders(c, error);
158
+ return c.json(errorBody(error), error.statusCode);
159
+ }
160
+ const body = await HonoEndpoint.validate(c, raw, endpoint.input?.body);
161
+ if (body instanceof Response) return body;
162
+ c.req.addValidatedData("json", body);
163
+ await next();
164
+ });
153
165
  if (features.hasQueryValidation) validators.push((0, hono_validator.validator)("query", (_, c) => {
154
166
  const parsedQuery = parseHonoQuery(c);
155
167
  return HonoEndpoint.validate(c, parsedQuery, endpoint.input?.query);
@@ -158,23 +170,21 @@ var HonoEndpoint = class HonoEndpoint {
158
170
  const handler = async (c) => {
159
171
  const startTime = Date.now();
160
172
  const requestId = c.req.header("X-Request-ID") ?? crypto.randomUUID();
161
- const logger = endpoint.logger.child({
173
+ let logger = require_requestLogger.requestLogger(endpoint, {
162
174
  requestId,
163
- endpoint: endpoint.fullPath,
164
- route: endpoint.route,
165
175
  host: c.req.header("host"),
166
- method: endpoint.method,
167
176
  path: c.req.path
168
177
  });
169
178
  c.header("X-Request-ID", requestId);
170
179
  return (0, _geekmidas_services.runWithRequestContext)({
171
180
  logger,
172
181
  requestId,
173
- startTime
182
+ startTime,
183
+ operation: `${endpoint.method} ${endpoint.route}`
174
184
  }, async () => {
175
185
  try {
176
- const header = require_lazyAccessors.createHonoHeaders(c);
177
- const cookie = require_lazyAccessors.createHonoCookies(c);
186
+ const header = require_readRequestBody.createHonoHeaders(c);
187
+ const cookie = require_readRequestBody.createHonoCookies(c);
178
188
  const services = features.hasServices ? await serviceDiscovery.register(endpoint.services) : {};
179
189
  const rawDb = features.hasDatabase ? await serviceDiscovery.register([endpoint.databaseService]).then((s) => s[endpoint.databaseService?.serviceName]) : void 0;
180
190
  const session = await endpoint.getSession({
@@ -184,6 +194,7 @@ var HonoEndpoint = class HonoEndpoint {
184
194
  cookie,
185
195
  ...rawDb !== void 0 && { db: rawDb }
186
196
  });
197
+ logger = (0, _geekmidas_services.currentRequestContext)()?.logger ?? logger;
187
198
  if (!await endpoint.authorize({
188
199
  header,
189
200
  cookie,
@@ -199,7 +210,7 @@ var HonoEndpoint = class HonoEndpoint {
199
210
  return c.json({ error: "Forbidden" }, 403);
200
211
  }
201
212
  if (features.hasRateLimit) {
202
- const rateLimitInfo = await (0, _geekmidas_rate_limit.checkRateLimit)(endpoint.rateLimit, {
213
+ const rateLimitHeaders = await require_requestLogger.enforceRateLimit(endpoint.rateLimit, {
203
214
  header,
204
215
  services,
205
216
  logger,
@@ -207,10 +218,9 @@ var HonoEndpoint = class HonoEndpoint {
207
218
  path: c.req.path,
208
219
  method: endpoint.method
209
220
  });
210
- const rateLimitHeaders = (0, _geekmidas_rate_limit.getRateLimitHeaders)(rateLimitInfo, endpoint.rateLimit);
211
- for (const [key, value] of Object.entries(rateLimitHeaders)) if (value) c.header(key, value);
221
+ for (const [key, value] of Object.entries(rateLimitHeaders)) c.header(key, value);
212
222
  }
213
- const auditContext = features.hasAudits ? await require_processAudits.createAuditContext(endpoint, serviceDiscovery, logger, {
223
+ const auditContext = features.hasAudits ? await require_requestLogger.createAuditContext(endpoint, serviceDiscovery, logger, {
214
224
  session,
215
225
  header,
216
226
  cookie,
@@ -225,7 +235,7 @@ var HonoEndpoint = class HonoEndpoint {
225
235
  cookie,
226
236
  logger
227
237
  }) : void 0;
228
- const { output, metadata } = await require_processAudits.executeWithAuditTransaction(auditContext, async (auditor) => {
238
+ const { output, metadata, redirect } = await require_requestLogger.executeWithAuditTransaction(auditContext, async (auditor) => {
229
239
  const baseDb = auditContext?.storage?.databaseServiceName && auditContext.storage.databaseServiceName === endpoint.databaseService?.serviceName ? auditor?.getTransaction?.() ?? rawDb : rawDb;
230
240
  const executeHandler = async (db) => {
231
241
  const responseBuilder = new require_Endpoint.ResponseBuilder();
@@ -247,16 +257,21 @@ var HonoEndpoint = class HonoEndpoint {
247
257
  data = response.data;
248
258
  metadata = response.metadata;
249
259
  }
260
+ const redirect = require_Endpoint.Endpoint.isRedirectStatus(metadata.status ?? endpoint.status);
250
261
  return {
251
- output: endpoint.outputSchema ? await endpoint.parseOutput(data) : void 0,
262
+ output: endpoint.outputSchema && !redirect ? await endpoint.parseOutput(data) : void 0,
252
263
  metadata,
253
- responseBuilder
264
+ responseBuilder,
265
+ redirect
254
266
  };
255
267
  };
256
- if (features.hasRls && rlsContext && baseDb) return (0, _geekmidas_db_rls.withRlsContext)(baseDb, rlsContext, async (trx) => executeHandler(trx), { prefix: endpoint.rlsConfig?.prefix });
268
+ if (features.hasRls && rlsContext && baseDb) {
269
+ const { withRlsContext } = await require_requestLogger.loadRls();
270
+ return withRlsContext(baseDb, rlsContext, async (trx) => executeHandler(trx), { prefix: endpoint.rlsConfig?.prefix });
271
+ }
257
272
  return executeHandler(baseDb);
258
273
  }, async (result, auditor) => {
259
- if (!audits?.length) return;
274
+ if (!audits?.length || result.redirect) return;
260
275
  for (const audit of audits) {
261
276
  if (audit.when && !audit.when(result.output)) continue;
262
277
  const payload = audit.payload(result.output);
@@ -272,31 +287,37 @@ var HonoEndpoint = class HonoEndpoint {
272
287
  if (metadata.status) status = metadata.status;
273
288
  if (metadata.headers) for (const [key, value] of Object.entries(metadata.headers)) c.header(key, value);
274
289
  if (metadata.cookies) for (const [name, { value, options }] of metadata.cookies) (0, hono_cookie.setCookie)(c, name, value, options);
275
- if (features.hasEvents && require_Endpoint.Endpoint.isSuccessStatus(status)) await require_lazyAccessors.publishConstructEvents(endpoint, output, serviceDiscovery, logger);
290
+ if (features.hasEvents && require_Endpoint.Endpoint.isSuccessStatus(status)) await require_functions.publishConstructEvents(endpoint, output, serviceDiscovery, logger);
276
291
  if (HonoEndpoint.isDev) logger.info({
277
292
  status,
278
293
  body: output
279
294
  }, "Outgoing response");
295
+ if (redirect) return c.body(null, status);
280
296
  if (endpoint.responseType === "application/json") return c.json(output, status);
281
297
  if (!(metadata.headers && hasContentTypeHeader(metadata.headers))) c.header("content-type", endpoint.responseType);
282
298
  return c.body(output, status);
283
299
  } catch (validationError) {
284
- logger.error(validationError, "Output validation failed");
300
+ logger.error({ err: validationError }, "Output validation failed");
285
301
  const error = (0, _geekmidas_errors.wrapError)(validationError, 422, "Response validation failed");
302
+ setErrorHeaders(c, error);
303
+ const body = errorBody(error);
286
304
  if (HonoEndpoint.isDev) logger.info({
287
305
  status: error.statusCode,
288
- body: error
306
+ body
289
307
  }, "Outgoing response");
290
- return c.json(error, error.statusCode);
308
+ return c.json(body, error.statusCode);
291
309
  }
292
310
  } catch (e) {
293
- logger.error(e, "Error processing endpoint request");
311
+ logger.error({ err: e }, "Error processing endpoint request");
294
312
  const error = (0, _geekmidas_errors.wrapError)(e, 500, "Internal Server Error");
313
+ if (error.statusCode >= 500 && e instanceof Error) c.error = e;
314
+ setErrorHeaders(c, error);
315
+ const body = errorBody(error);
295
316
  if (HonoEndpoint.isDev) logger.info({
296
317
  status: error.statusCode,
297
- body: error
318
+ body
298
319
  }, "Outgoing response");
299
- return c.json(error, error.statusCode);
320
+ return c.json(body, error.statusCode);
300
321
  }
301
322
  });
302
323
  };
@@ -313,6 +334,33 @@ var HonoEndpoint = class HonoEndpoint {
313
334
  });
314
335
  }
315
336
  };
337
+ /**
338
+ * What a client is told about a failed request: what went wrong, and the stack
339
+ * only under `gkm dev`. A server's stack is its file layout and its
340
+ * dependencies' versions — for the person debugging it, not for whoever sent
341
+ * the request. A server failure's details are the error it wrapped (an
342
+ * environment variable it could not read, a query that failed), so they go to
343
+ * the log and not the response either; a 4xx's details are the client's.
344
+ */
345
+ function errorBody(error) {
346
+ const internal = error.statusCode >= 500 && !HonoEndpoint.isDev;
347
+ return {
348
+ name: error.name,
349
+ message: error.message,
350
+ statusCode: error.statusCode,
351
+ statusMessage: error.statusMessage,
352
+ code: error.code,
353
+ ...internal ? {} : { details: error.details },
354
+ ...HonoEndpoint.isDev ? { stack: error.stack } : {}
355
+ };
356
+ }
357
+ /**
358
+ * The headers an error says its response carries — a 429's `Retry-After` and
359
+ * `X-RateLimit-*` — on the response that reports it.
360
+ */
361
+ function setErrorHeaders(c, error) {
362
+ for (const [key, value] of Object.entries(error.headers ?? {})) c.header(key, value);
363
+ }
316
364
  //#endregion
317
365
  Object.defineProperty(exports, "HonoEndpoint", {
318
366
  enumerable: true,
@@ -321,4 +369,4 @@ Object.defineProperty(exports, "HonoEndpoint", {
321
369
  }
322
370
  });
323
371
 
324
- //# sourceMappingURL=HonoEndpointAdaptor-7QagYKdP.cjs.map
372
+ //# sourceMappingURL=HonoEndpointAdaptor-BJlj20fQ.cjs.map