@geekmidas/constructs 10.0.0-alpha.98 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (533) hide show
  1. package/CHANGELOG.md +437 -0
  2. package/README.md +193 -285
  3. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
  4. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
  5. package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
  6. package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
  7. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
  8. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
  9. package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
  10. package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
  11. package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
  12. package/dist/Construct-BWF5HxaM.mjs.map +1 -0
  13. package/dist/Construct-JlyQkBkv.d.cts +117 -0
  14. package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
  15. package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
  16. package/dist/Construct-TGIM_E4o.cjs.map +1 -0
  17. package/dist/Construct-pxwC6fDD.d.mts +117 -0
  18. package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
  19. package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
  20. package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
  21. package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
  22. package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
  23. package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
  24. package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
  25. package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
  26. package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
  27. package/dist/Queue-BL68oDJ-.d.mts +66 -0
  28. package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
  29. package/dist/Queue-DxJ6btRE.d.cts +66 -0
  30. package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
  31. package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
  32. package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
  33. package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
  34. package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
  35. package/dist/Topic-DJXoDeMP.d.cts +60 -0
  36. package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
  37. package/dist/Topic-DxWQBgMN.d.mts +60 -0
  38. package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
  39. package/dist/adaptors/aws.cjs +205 -355
  40. package/dist/adaptors/aws.cjs.map +1 -1
  41. package/dist/adaptors/aws.d.cts +48 -126
  42. package/dist/adaptors/aws.d.cts.map +1 -1
  43. package/dist/adaptors/aws.d.mts +49 -127
  44. package/dist/adaptors/aws.d.mts.map +1 -1
  45. package/dist/adaptors/aws.mjs +178 -325
  46. package/dist/adaptors/aws.mjs.map +1 -1
  47. package/dist/adaptors/hono.cjs +9 -3
  48. package/dist/adaptors/hono.d.cts +15 -7
  49. package/dist/adaptors/hono.d.cts.map +1 -1
  50. package/dist/adaptors/hono.d.mts +17 -9
  51. package/dist/adaptors/hono.d.mts.map +1 -1
  52. package/dist/adaptors/hono.mjs +9 -2
  53. package/dist/adaptors/testing.cjs +209 -831
  54. package/dist/adaptors/testing.cjs.map +1 -1
  55. package/dist/adaptors/testing.d.cts +55 -351
  56. package/dist/adaptors/testing.d.cts.map +1 -1
  57. package/dist/adaptors/testing.d.mts +53 -349
  58. package/dist/adaptors/testing.d.mts.map +1 -1
  59. package/dist/adaptors/testing.mjs +195 -798
  60. package/dist/adaptors/testing.mjs.map +1 -1
  61. package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
  62. package/dist/clone-I_WIpiFf.cjs.map +1 -0
  63. package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
  64. package/dist/clone-pdXxc0t3.mjs.map +1 -0
  65. package/dist/crons/index.cjs +66 -190
  66. package/dist/crons/index.cjs.map +1 -1
  67. package/dist/crons/index.d.cts +35 -70
  68. package/dist/crons/index.d.cts.map +1 -1
  69. package/dist/crons/index.d.mts +32 -70
  70. package/dist/crons/index.d.mts.map +1 -1
  71. package/dist/crons/index.mjs +63 -184
  72. package/dist/crons/index.mjs.map +1 -1
  73. package/dist/endpoints/index.cjs +761 -19
  74. package/dist/endpoints/index.cjs.map +1 -0
  75. package/dist/endpoints/index.d.cts +322 -22
  76. package/dist/endpoints/index.d.cts.map +1 -1
  77. package/dist/endpoints/index.d.mts +321 -22
  78. package/dist/endpoints/index.d.mts.map +1 -1
  79. package/dist/endpoints/index.mjs +751 -6
  80. package/dist/endpoints/index.mjs.map +1 -0
  81. package/dist/functions/index.cjs +5 -2
  82. package/dist/functions/index.d.cts +3 -3
  83. package/dist/functions/index.d.mts +3 -3
  84. package/dist/functions/index.mjs +5 -2
  85. package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
  86. package/dist/functions-EqTloHjo.mjs.map +1 -0
  87. package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
  88. package/dist/functions-SqtCDc9c.cjs.map +1 -0
  89. package/dist/index-C7iynzLI.d.mts +139 -0
  90. package/dist/index-C7iynzLI.d.mts.map +1 -0
  91. package/dist/index-D4dM_WDY.d.cts +142 -0
  92. package/dist/index-D4dM_WDY.d.cts.map +1 -0
  93. package/dist/index.cjs +3 -6
  94. package/dist/index.d.cts +4 -27
  95. package/dist/index.d.mts +4 -27
  96. package/dist/index.mjs +3 -3
  97. package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
  98. package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
  99. package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
  100. package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
  101. package/dist/monitors/index.cjs +49 -0
  102. package/dist/monitors/index.cjs.map +1 -0
  103. package/dist/monitors/index.d.cts +45 -0
  104. package/dist/monitors/index.d.cts.map +1 -0
  105. package/dist/monitors/index.d.mts +45 -0
  106. package/dist/monitors/index.d.mts.map +1 -0
  107. package/dist/monitors/index.mjs +48 -0
  108. package/dist/monitors/index.mjs.map +1 -0
  109. package/dist/processAudits-BJZT5gmy.cjs +92 -0
  110. package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
  111. package/dist/processAudits-CwyaaSQc.mjs +80 -0
  112. package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
  113. package/dist/publisher-BZgcrVPy.cjs +53 -0
  114. package/dist/publisher-BZgcrVPy.cjs.map +1 -0
  115. package/dist/publisher-CnpeMv-r.mjs +41 -0
  116. package/dist/publisher-CnpeMv-r.mjs.map +1 -0
  117. package/dist/queue/index.cjs +114 -6
  118. package/dist/queue/index.cjs.map +1 -0
  119. package/dist/queue/index.d.cts +45 -3
  120. package/dist/queue/index.d.cts.map +1 -0
  121. package/dist/queue/index.d.mts +44 -3
  122. package/dist/queue/index.d.mts.map +1 -0
  123. package/dist/queue/index.mjs +112 -3
  124. package/dist/queue/index.mjs.map +1 -0
  125. package/dist/subscribers/index.cjs +80 -111
  126. package/dist/subscribers/index.cjs.map +1 -1
  127. package/dist/subscribers/index.d.cts +43 -46
  128. package/dist/subscribers/index.d.cts.map +1 -1
  129. package/dist/subscribers/index.d.mts +42 -46
  130. package/dist/subscribers/index.d.mts.map +1 -1
  131. package/dist/subscribers/index.mjs +78 -108
  132. package/dist/subscribers/index.mjs.map +1 -1
  133. package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
  134. package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
  135. package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
  136. package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
  137. package/dist/topic/index.cjs +91 -3
  138. package/dist/topic/index.cjs.map +1 -0
  139. package/dist/topic/index.d.cts +32 -2
  140. package/dist/topic/index.d.cts.map +1 -0
  141. package/dist/topic/index.d.mts +32 -2
  142. package/dist/topic/index.d.mts.map +1 -0
  143. package/dist/topic/index.mjs +89 -2
  144. package/dist/topic/index.mjs.map +1 -0
  145. package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
  146. package/dist/types-BdAaYDvd.d.cts.map +1 -0
  147. package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
  148. package/dist/types-DNngH0fX.d.mts.map +1 -0
  149. package/dist/types.d.cts +1 -1
  150. package/dist/types.d.mts +1 -1
  151. package/dist/types.mjs +0 -1
  152. package/package.json +55 -223
  153. package/src/Construct.ts +209 -0
  154. package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
  155. package/src/__benchmarks__/endpoint.bench.ts +494 -0
  156. package/src/__benchmarks__/fixtures.ts +241 -0
  157. package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
  158. package/src/__benchmarks__/hono-server.bench.ts +249 -0
  159. package/src/__benchmarks__/response-builder.bench.ts +428 -0
  160. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
  161. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
  162. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
  163. package/src/__tests__/Construct.environment.spec.ts +704 -0
  164. package/src/__tests__/builder-reuse.spec.ts +587 -0
  165. package/src/__tests__/monitor.spec.ts +636 -0
  166. package/src/__tests__/publisher.setting.spec.ts +508 -0
  167. package/src/__tests__/publisher.spec.ts +452 -0
  168. package/src/adaptors/aws.ts +6 -0
  169. package/src/adaptors/hono.ts +1 -0
  170. package/src/adaptors/testing.ts +11 -0
  171. package/src/clone.ts +38 -0
  172. package/src/crons/AWSScheduledFunction.ts +73 -0
  173. package/src/crons/Cron.ts +149 -0
  174. package/src/crons/CronBuilder.ts +261 -0
  175. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
  176. package/src/crons/__tests__/Cron.spec.ts +472 -0
  177. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
  178. package/src/crons/index.ts +12 -0
  179. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
  180. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
  181. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
  182. package/src/endpoints/Authorizer.ts +152 -0
  183. package/src/endpoints/Endpoint.ts +1287 -0
  184. package/src/endpoints/EndpointBuilder.ts +749 -0
  185. package/src/endpoints/EndpointFactory.ts +1179 -0
  186. package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
  187. package/src/endpoints/MswEndpointAdaptor.ts +226 -0
  188. package/src/endpoints/TestEndpointAdaptor.ts +466 -0
  189. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
  190. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
  191. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
  192. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
  193. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
  194. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
  195. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
  196. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
  197. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
  198. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
  199. package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
  200. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
  201. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
  202. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
  203. package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
  204. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
  205. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
  206. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
  207. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
  208. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
  209. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
  210. package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
  211. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
  212. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
  213. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
  214. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
  215. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
  216. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
  217. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
  218. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
  219. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
  220. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
  221. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
  222. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
  223. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
  224. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
  225. package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
  226. package/src/endpoints/__tests__/helpers.spec.ts +37 -0
  227. package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
  228. package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
  229. package/src/endpoints/audit.ts +87 -0
  230. package/src/endpoints/helpers.ts +98 -0
  231. package/src/endpoints/index.ts +42 -0
  232. package/src/endpoints/lazyAccessors.ts +241 -0
  233. package/src/endpoints/parseHonoQuery.ts +16 -0
  234. package/src/endpoints/parseQueryParams.ts +32 -0
  235. package/src/endpoints/processAudits.ts +371 -0
  236. package/src/endpoints/rls.ts +67 -0
  237. package/src/functions/AWSLambdaFunction.ts +374 -0
  238. package/src/functions/BaseFunctionBuilder.ts +212 -0
  239. package/src/functions/Function.ts +238 -0
  240. package/src/functions/FunctionBuilder.ts +381 -0
  241. package/src/functions/FunctionExecutionWrapper.ts +216 -0
  242. package/src/functions/TestFunctionAdaptor.ts +252 -0
  243. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
  244. package/src/functions/__tests__/Function.audits.spec.ts +393 -0
  245. package/src/functions/__tests__/Function.spec.ts +477 -0
  246. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
  247. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
  248. package/src/functions/index.ts +12 -0
  249. package/src/index.ts +29 -0
  250. package/src/monitor.ts +145 -0
  251. package/src/monitors/heartbeat.ts +86 -0
  252. package/src/monitors/index.ts +6 -0
  253. package/src/publisher.ts +93 -0
  254. package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
  255. package/src/queue/Queue.ts +128 -0
  256. package/src/queue/QueueBuilder.ts +115 -0
  257. package/src/queue/TestQueueAdaptor.ts +63 -0
  258. package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
  259. package/src/queue/index.ts +12 -0
  260. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
  261. package/src/subscribers/Subscriber.ts +117 -0
  262. package/src/subscribers/SubscriberBuilder.ts +183 -0
  263. package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
  264. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
  265. package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
  266. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
  267. package/src/subscribers/index.ts +6 -0
  268. package/src/telemetry.ts +103 -0
  269. package/src/topic/Topic.ts +103 -0
  270. package/src/topic/TopicBuilder.ts +53 -0
  271. package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
  272. package/src/topic/index.ts +11 -0
  273. package/src/types.ts +13 -0
  274. package/test.ts +91 -0
  275. package/tsconfig.json +9 -0
  276. package/tsdown.config.ts +35 -0
  277. package/dist/Construct-B1vGBPme.mjs.map +0 -1
  278. package/dist/Construct-BQALFCh2.d.cts +0 -230
  279. package/dist/Construct-BQALFCh2.d.cts.map +0 -1
  280. package/dist/Construct-DUSXuTHP.cjs.map +0 -1
  281. package/dist/Construct-QXnl3VqT.d.mts +0 -230
  282. package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
  283. package/dist/Cron-DI3nKoic.d.cts +0 -45
  284. package/dist/Cron-DI3nKoic.d.cts.map +0 -1
  285. package/dist/Cron-uYAHPnp7.d.mts +0 -45
  286. package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
  287. package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
  288. package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
  289. package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
  290. package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
  291. package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
  292. package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
  293. package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
  294. package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
  295. package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
  296. package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
  297. package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
  298. package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
  299. package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
  300. package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
  301. package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
  302. package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
  303. package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
  304. package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
  305. package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
  306. package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
  307. package/dist/Function-DuqGcbOI.d.mts +0 -76
  308. package/dist/Function-DuqGcbOI.d.mts.map +0 -1
  309. package/dist/Function-Pu-1kKZz.d.cts +0 -76
  310. package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
  311. package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
  312. package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
  313. package/dist/Queue-A3wfD0it.cjs +0 -109
  314. package/dist/Queue-A3wfD0it.cjs.map +0 -1
  315. package/dist/Queue-D6USGS4q.mjs +0 -104
  316. package/dist/Queue-D6USGS4q.mjs.map +0 -1
  317. package/dist/Queue-DlsHRzUp.d.mts +0 -105
  318. package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
  319. package/dist/Queue-HPyi0e1i.d.cts +0 -105
  320. package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
  321. package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
  322. package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
  323. package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
  324. package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
  325. package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
  326. package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
  327. package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
  328. package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
  329. package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
  330. package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
  331. package/dist/Subscriber-CtN9R48-.d.mts +0 -61
  332. package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
  333. package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
  334. package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
  335. package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
  336. package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
  337. package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
  338. package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
  339. package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
  340. package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
  341. package/dist/Topic-D74b5cgs.mjs +0 -99
  342. package/dist/Topic-D74b5cgs.mjs.map +0 -1
  343. package/dist/Topic-GHxcU8AG.cjs +0 -104
  344. package/dist/Topic-GHxcU8AG.cjs.map +0 -1
  345. package/dist/auth-BMCJN30Y.d.cts +0 -268
  346. package/dist/auth-BMCJN30Y.d.cts.map +0 -1
  347. package/dist/auth-CcuceLYo.d.mts +0 -268
  348. package/dist/auth-CcuceLYo.d.mts.map +0 -1
  349. package/dist/auth.cjs +0 -433
  350. package/dist/auth.cjs.map +0 -1
  351. package/dist/auth.d.cts +0 -2
  352. package/dist/auth.d.mts +0 -2
  353. package/dist/auth.mjs +0 -426
  354. package/dist/auth.mjs.map +0 -1
  355. package/dist/cache-CXh6GIgb.d.mts +0 -44
  356. package/dist/cache-CXh6GIgb.d.mts.map +0 -1
  357. package/dist/cache-DnGDGly3.d.cts +0 -44
  358. package/dist/cache-DnGDGly3.d.cts.map +0 -1
  359. package/dist/cache.cjs +0 -69
  360. package/dist/cache.cjs.map +0 -1
  361. package/dist/cache.d.cts +0 -2
  362. package/dist/cache.d.mts +0 -2
  363. package/dist/cache.mjs +0 -68
  364. package/dist/cache.mjs.map +0 -1
  365. package/dist/cipher-C1lEFX63.mjs +0 -225
  366. package/dist/cipher-C1lEFX63.mjs.map +0 -1
  367. package/dist/cipher-CVxfwLjk.cjs +0 -332
  368. package/dist/cipher-CVxfwLjk.cjs.map +0 -1
  369. package/dist/clone-EKNovYHu.mjs.map +0 -1
  370. package/dist/clone-UGJpvQnL.cjs.map +0 -1
  371. package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
  372. package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
  373. package/dist/construct-interface-DluK3_da.d.mts +0 -162
  374. package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
  375. package/dist/construct-interface.cjs +0 -114
  376. package/dist/construct-interface.cjs.map +0 -1
  377. package/dist/construct-interface.d.cts +0 -2
  378. package/dist/construct-interface.d.mts +0 -2
  379. package/dist/construct-interface.mjs +0 -107
  380. package/dist/construct-interface.mjs.map +0 -1
  381. package/dist/credential.cjs +0 -156
  382. package/dist/credential.cjs.map +0 -1
  383. package/dist/credential.d.cts +0 -86
  384. package/dist/credential.d.cts.map +0 -1
  385. package/dist/credential.d.mts +0 -86
  386. package/dist/credential.d.mts.map +0 -1
  387. package/dist/credential.mjs +0 -152
  388. package/dist/credential.mjs.map +0 -1
  389. package/dist/database/kysely.cjs +0 -4
  390. package/dist/database/kysely.d.cts +0 -2
  391. package/dist/database/kysely.d.mts +0 -2
  392. package/dist/database/kysely.mjs +0 -2
  393. package/dist/email.cjs +0 -72
  394. package/dist/email.cjs.map +0 -1
  395. package/dist/email.d.cts +0 -46
  396. package/dist/email.d.cts.map +0 -1
  397. package/dist/email.d.mts +0 -46
  398. package/dist/email.d.mts.map +0 -1
  399. package/dist/email.mjs +0 -71
  400. package/dist/email.mjs.map +0 -1
  401. package/dist/encryption.cjs +0 -96
  402. package/dist/encryption.cjs.map +0 -1
  403. package/dist/encryption.d.cts +0 -117
  404. package/dist/encryption.d.cts.map +0 -1
  405. package/dist/encryption.d.mts +0 -117
  406. package/dist/encryption.d.mts.map +0 -1
  407. package/dist/encryption.mjs +0 -83
  408. package/dist/encryption.mjs.map +0 -1
  409. package/dist/external-api-MJ8id87V.d.mts +0 -105
  410. package/dist/external-api-MJ8id87V.d.mts.map +0 -1
  411. package/dist/external-api-O107yzZJ.d.cts +0 -105
  412. package/dist/external-api-O107yzZJ.d.cts.map +0 -1
  413. package/dist/external-api.cjs +0 -142
  414. package/dist/external-api.cjs.map +0 -1
  415. package/dist/external-api.d.cts +0 -2
  416. package/dist/external-api.d.mts +0 -2
  417. package/dist/external-api.mjs +0 -139
  418. package/dist/external-api.mjs.map +0 -1
  419. package/dist/file-server.cjs +0 -186
  420. package/dist/file-server.cjs.map +0 -1
  421. package/dist/file-server.d.cts +0 -152
  422. package/dist/file-server.d.cts.map +0 -1
  423. package/dist/file-server.d.mts +0 -152
  424. package/dist/file-server.d.mts.map +0 -1
  425. package/dist/file-server.mjs +0 -184
  426. package/dist/file-server.mjs.map +0 -1
  427. package/dist/functions-BFizikJU.mjs.map +0 -1
  428. package/dist/functions-CfzJG9hK.cjs.map +0 -1
  429. package/dist/index-BuzRvKOQ.d.cts +0 -115
  430. package/dist/index-BuzRvKOQ.d.cts.map +0 -1
  431. package/dist/index-CTkKOer4.d.mts +0 -115
  432. package/dist/index-CTkKOer4.d.mts.map +0 -1
  433. package/dist/index-CeEtxDmK.d.cts +0 -79
  434. package/dist/index-CeEtxDmK.d.cts.map +0 -1
  435. package/dist/index-CeEtxDmK.d.mts +0 -79
  436. package/dist/index-CeEtxDmK.d.mts.map +0 -1
  437. package/dist/index.d.cts.map +0 -1
  438. package/dist/index.d.mts.map +0 -1
  439. package/dist/kms-B-Hm3d5r.cjs +0 -85
  440. package/dist/kms-B-Hm3d5r.cjs.map +0 -1
  441. package/dist/kms-BdUlMJEZ.mjs +0 -85
  442. package/dist/kms-BdUlMJEZ.mjs.map +0 -1
  443. package/dist/kysely-Bii4l6eP.mjs +0 -370
  444. package/dist/kysely-Bii4l6eP.mjs.map +0 -1
  445. package/dist/kysely-CO_Dk43W.cjs +0 -383
  446. package/dist/kysely-CO_Dk43W.cjs.map +0 -1
  447. package/dist/kysely-D0bpzgPs.d.cts +0 -175
  448. package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
  449. package/dist/kysely-DUqC3Ie0.d.mts +0 -175
  450. package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
  451. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
  452. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
  453. package/dist/lazyAccessors-CFanua0O.mjs +0 -174
  454. package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
  455. package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
  456. package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
  457. package/dist/mobile-app.cjs +0 -73
  458. package/dist/mobile-app.cjs.map +0 -1
  459. package/dist/mobile-app.d.cts +0 -61
  460. package/dist/mobile-app.d.cts.map +0 -1
  461. package/dist/mobile-app.d.mts +0 -61
  462. package/dist/mobile-app.d.mts.map +0 -1
  463. package/dist/mobile-app.mjs +0 -72
  464. package/dist/mobile-app.mjs.map +0 -1
  465. package/dist/object-storage.cjs +0 -56
  466. package/dist/object-storage.cjs.map +0 -1
  467. package/dist/object-storage.d.cts +0 -32
  468. package/dist/object-storage.d.cts.map +0 -1
  469. package/dist/object-storage.d.mts +0 -32
  470. package/dist/object-storage.d.mts.map +0 -1
  471. package/dist/object-storage.mjs +0 -55
  472. package/dist/object-storage.mjs.map +0 -1
  473. package/dist/processAudits-BRRVVHUB.mjs +0 -131
  474. package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
  475. package/dist/processAudits-DasOZjPl.cjs +0 -154
  476. package/dist/processAudits-DasOZjPl.cjs.map +0 -1
  477. package/dist/rest-api.cjs +0 -216
  478. package/dist/rest-api.cjs.map +0 -1
  479. package/dist/rest-api.d.cts +0 -241
  480. package/dist/rest-api.d.cts.map +0 -1
  481. package/dist/rest-api.d.mts +0 -241
  482. package/dist/rest-api.d.mts.map +0 -1
  483. package/dist/rest-api.mjs +0 -215
  484. package/dist/rest-api.mjs.map +0 -1
  485. package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
  486. package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
  487. package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
  488. package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
  489. package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
  490. package/dist/shutdown-BMJmAhSt.cjs +0 -38
  491. package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
  492. package/dist/shutdown-C7xa8x9S.mjs +0 -27
  493. package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
  494. package/dist/site.cjs +0 -74
  495. package/dist/site.cjs.map +0 -1
  496. package/dist/site.d.cts +0 -104
  497. package/dist/site.d.cts.map +0 -1
  498. package/dist/site.d.mts +0 -104
  499. package/dist/site.d.mts.map +0 -1
  500. package/dist/site.mjs +0 -73
  501. package/dist/site.mjs.map +0 -1
  502. package/dist/stages-BSCF19o2.d.cts +0 -56
  503. package/dist/stages-BSCF19o2.d.cts.map +0 -1
  504. package/dist/stages-BSCF19o2.d.mts +0 -56
  505. package/dist/stages-BSCF19o2.d.mts.map +0 -1
  506. package/dist/surfaceEnv-CNimK76p.cjs +0 -56
  507. package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
  508. package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
  509. package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
  510. package/dist/telemetry-B48RLjyk.d.cts +0 -40
  511. package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
  512. package/dist/telemetry-DRtT1_0A.d.mts +0 -40
  513. package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
  514. package/dist/telemetry.cjs +0 -56
  515. package/dist/telemetry.cjs.map +0 -1
  516. package/dist/telemetry.d.cts +0 -2
  517. package/dist/telemetry.d.mts +0 -2
  518. package/dist/telemetry.mjs +0 -55
  519. package/dist/telemetry.mjs.map +0 -1
  520. package/dist/tracing-CxaZ98IB.mjs +0 -110
  521. package/dist/tracing-CxaZ98IB.mjs.map +0 -1
  522. package/dist/tracing-DPMidF_r.cjs +0 -127
  523. package/dist/tracing-DPMidF_r.cjs.map +0 -1
  524. package/dist/types-DMuSQeLL.d.cts.map +0 -1
  525. package/dist/types-DMuSQeLL.d.mts.map +0 -1
  526. package/dist/worker.cjs +0 -191
  527. package/dist/worker.cjs.map +0 -1
  528. package/dist/worker.d.cts +0 -171
  529. package/dist/worker.d.cts.map +0 -1
  530. package/dist/worker.d.mts +0 -171
  531. package/dist/worker.d.mts.map +0 -1
  532. package/dist/worker.mjs +0 -190
  533. package/dist/worker.mjs.map +0 -1
@@ -0,0 +1,857 @@
1
+ import { EnvironmentParser } from '@geekmidas/envkit';
2
+ import type { Logger } from '@geekmidas/logger';
3
+ import { ServiceDiscovery } from '@geekmidas/services';
4
+ import { describe, expect, it, vi } from 'vitest';
5
+ import { z } from 'zod/v4';
6
+ import { Endpoint } from '../Endpoint';
7
+
8
+ describe('Endpoint', () => {
9
+ describe('toOpenApi3Route', () => {
10
+ it('should generate basic OpenAPI spec for GET endpoint', async () => {
11
+ const endpoint = new Endpoint({
12
+ route: '/users',
13
+ method: 'GET',
14
+ authorize: undefined,
15
+ description: 'Get all users',
16
+ fn: async () => [],
17
+ input: undefined,
18
+ status: undefined,
19
+ getSession: undefined,
20
+ output: undefined,
21
+ services: [],
22
+ logger: {} as any,
23
+ timeout: undefined,
24
+ memorySize: undefined,
25
+ });
26
+
27
+ const spec = await endpoint.toOpenApi3Route();
28
+
29
+ expect(spec).toEqual({
30
+ '/users': {
31
+ get: {
32
+ description: 'Get all users',
33
+ responses: {
34
+ '200': {
35
+ description: 'Successful response',
36
+ },
37
+ },
38
+ },
39
+ },
40
+ });
41
+ });
42
+
43
+ it('should include response schema when output is defined', async () => {
44
+ const outputSchema = z.object({
45
+ id: z.string(),
46
+ name: z.string(),
47
+ });
48
+
49
+ const endpoint = new Endpoint({
50
+ route: '/users/:id',
51
+ method: 'GET',
52
+ description: 'Get user by ID',
53
+ fn: async () => ({ id: '1', name: 'John' }),
54
+ input: undefined,
55
+ output: outputSchema,
56
+ authorize: undefined,
57
+ services: [],
58
+ status: undefined,
59
+ getSession: undefined,
60
+ logger: {} as any,
61
+ timeout: undefined,
62
+ memorySize: undefined,
63
+ });
64
+
65
+ const spec = await endpoint.toOpenApi3Route();
66
+ const doc = spec['/users/{id}'];
67
+ expect(doc.get.responses?.['200']).toHaveProperty('content');
68
+ expect(
69
+ (doc.get.responses?.['200'] as any).content['application/json'].schema,
70
+ ).toMatchObject({
71
+ type: 'object',
72
+ properties: {
73
+ id: { type: 'string' },
74
+ name: { type: 'string' },
75
+ },
76
+ required: ['id', 'name'],
77
+ });
78
+ });
79
+
80
+ it('should use the endpoint responseType as the OpenAPI content key', async () => {
81
+ const endpoint = new Endpoint({
82
+ route: '/checkout-page',
83
+ method: 'GET',
84
+ description: 'Hosted checkout page',
85
+ fn: async () => '<html></html>',
86
+ input: undefined,
87
+ output: z.string(),
88
+ authorize: undefined,
89
+ services: [],
90
+ status: undefined,
91
+ getSession: undefined,
92
+ logger: {} as any,
93
+ timeout: undefined,
94
+ memorySize: undefined,
95
+ responseType: 'text/html',
96
+ });
97
+
98
+ const spec = await endpoint.toOpenApi3Route();
99
+ const response200 = (spec['/checkout-page'].get.responses?.['200'] ??
100
+ {}) as any;
101
+
102
+ expect(response200.content).toHaveProperty('text/html');
103
+ expect(response200.content).not.toHaveProperty('application/json');
104
+ expect(response200.content['text/html'].schema).toMatchObject({
105
+ type: 'string',
106
+ });
107
+ });
108
+
109
+ it('should include request body for POST endpoint', async () => {
110
+ const bodySchema = z.object({
111
+ name: z.string(),
112
+ email: z.string().email(),
113
+ });
114
+
115
+ const endpoint = new Endpoint({
116
+ route: '/users',
117
+ method: 'POST',
118
+ authorize: undefined,
119
+ description: 'Create a new user',
120
+ fn: async (ctx) => ({ id: '1', ...(ctx as any).body }),
121
+ input: {
122
+ body: bodySchema,
123
+ },
124
+ output: undefined,
125
+ status: undefined,
126
+ getSession: undefined,
127
+ services: [],
128
+ logger: {} as any,
129
+ timeout: undefined,
130
+ memorySize: undefined,
131
+ });
132
+
133
+ const spec = await endpoint.toOpenApi3Route();
134
+
135
+ expect(spec['/users']?.post).toHaveProperty('requestBody');
136
+ expect((spec['/users']?.post! as any).requestBody).toMatchObject({
137
+ required: true,
138
+ content: {
139
+ 'application/json': {
140
+ schema: {
141
+ type: 'object',
142
+ properties: {
143
+ name: { type: 'string' },
144
+ email: { type: 'string', format: 'email' },
145
+ },
146
+ required: ['name', 'email'],
147
+ },
148
+ },
149
+ },
150
+ });
151
+ });
152
+
153
+ it('should include path parameters at route level', async () => {
154
+ const paramsSchema = z.object({
155
+ id: z.string(),
156
+ subId: z.string().optional(),
157
+ });
158
+
159
+ const endpoint = new Endpoint({
160
+ route: '/users/:id/items/:subId',
161
+ method: 'GET',
162
+ status: undefined,
163
+ authorize: undefined,
164
+ getSession: undefined,
165
+ description: 'Get user item',
166
+ fn: async (ctx) => ({
167
+ userId: (ctx as any).params.id,
168
+ itemId: (ctx as any).params.subId,
169
+ }),
170
+ input: {
171
+ params: paramsSchema,
172
+ },
173
+ output: undefined,
174
+ services: [],
175
+ logger: {} as any,
176
+ timeout: undefined,
177
+ memorySize: undefined,
178
+ });
179
+
180
+ const spec = await endpoint.toOpenApi3Route();
181
+
182
+ const doc = spec['/users/{id}/items/{subId}'];
183
+
184
+ // Path parameters should be at route level, not method level
185
+ expect(doc).toHaveProperty('parameters');
186
+ const parameters = doc.parameters;
187
+
188
+ expect(parameters).toHaveLength(2);
189
+ expect(parameters).toContainEqual({
190
+ name: 'id',
191
+ in: 'path',
192
+ required: true,
193
+ schema: { type: 'string' },
194
+ });
195
+ expect(parameters).toContainEqual({
196
+ name: 'subId',
197
+ in: 'path',
198
+ required: false,
199
+ schema: { type: 'string' },
200
+ });
201
+
202
+ // Method should not have path parameters
203
+ expect(doc.get.parameters).toBeUndefined();
204
+ });
205
+
206
+ it('should include query parameters', async () => {
207
+ const searchSchema = z.object({
208
+ page: z.number().optional(),
209
+ limit: z.number().optional(),
210
+ sort: z.enum(['asc', 'desc']),
211
+ });
212
+
213
+ const endpoint = new Endpoint({
214
+ route: '/users',
215
+ method: 'GET',
216
+ authorize: undefined,
217
+ description: 'List users with pagination',
218
+ fn: async (_ctx) => [],
219
+ input: {
220
+ query: searchSchema,
221
+ },
222
+ output: undefined,
223
+ services: [],
224
+ logger: {} as any,
225
+ timeout: undefined,
226
+ memorySize: undefined,
227
+ status: undefined,
228
+ getSession: undefined,
229
+ });
230
+
231
+ const spec = await endpoint.toOpenApi3Route();
232
+
233
+ expect(spec['/users']?.get).toHaveProperty('parameters');
234
+ const parameters = (spec['/users']?.get! as any).parameters;
235
+
236
+ expect(parameters).toHaveLength(3);
237
+ expect(parameters).toContainEqual({
238
+ name: 'page',
239
+ in: 'query',
240
+ required: false,
241
+ schema: { type: 'number' },
242
+ });
243
+ expect(parameters).toContainEqual({
244
+ name: 'limit',
245
+ in: 'query',
246
+ required: false,
247
+ schema: { type: 'number' },
248
+ });
249
+ expect(parameters).toContainEqual({
250
+ name: 'sort',
251
+ in: 'query',
252
+ required: true,
253
+ schema: { type: 'string', enum: ['asc', 'desc'] },
254
+ });
255
+ });
256
+
257
+ it('should handle PUT endpoint with body and params', async () => {
258
+ const bodySchema = z.object({
259
+ name: z.string(),
260
+ email: z.string().email(),
261
+ });
262
+ const paramsSchema = z.object({
263
+ id: z.string(),
264
+ });
265
+ const outputSchema = z.object({
266
+ id: z.string(),
267
+ name: z.string(),
268
+ email: z.string(),
269
+ updatedAt: z.string(),
270
+ });
271
+
272
+ const endpoint = new Endpoint({
273
+ route: '/users/:id',
274
+ method: 'PUT',
275
+ description: 'Update user',
276
+ status: undefined,
277
+ getSession: undefined,
278
+ authorize: undefined,
279
+ fn: async (ctx) => ({
280
+ id: (ctx as any).params.id,
281
+ ...(ctx as any).body,
282
+ updatedAt: new Date().toISOString(),
283
+ }),
284
+ input: {
285
+ body: bodySchema,
286
+ params: paramsSchema,
287
+ },
288
+ output: outputSchema,
289
+ services: [],
290
+ logger: {} as any,
291
+ timeout: undefined,
292
+ memorySize: undefined,
293
+ });
294
+
295
+ const spec = await endpoint.toOpenApi3Route();
296
+ const doc = spec['/users/{id}'];
297
+
298
+ // Check request body
299
+ expect(doc.put).toHaveProperty('requestBody');
300
+ expect(
301
+ (doc.put as any).requestBody.content['application/json'].schema,
302
+ ).toMatchObject({
303
+ type: 'object',
304
+ properties: {
305
+ name: { type: 'string' },
306
+ email: { type: 'string', format: 'email' },
307
+ },
308
+ });
309
+
310
+ // Check path parameters at route level
311
+ expect(doc).toHaveProperty('parameters');
312
+ expect(doc.parameters).toHaveLength(1);
313
+ expect(doc.parameters?.[0]).toEqual({
314
+ name: 'id',
315
+ in: 'path',
316
+ required: true,
317
+ schema: { type: 'string' },
318
+ });
319
+
320
+ // Method should not have path parameters
321
+ expect((doc.put as any).parameters).toBeUndefined();
322
+
323
+ // Check response
324
+ expect(
325
+ (doc.put.responses?.['200'] as any).content['application/json'].schema,
326
+ ).toMatchObject({
327
+ type: 'object',
328
+ properties: {
329
+ id: { type: 'string' },
330
+ name: { type: 'string' },
331
+ email: { type: 'string' },
332
+ updatedAt: { type: 'string' },
333
+ },
334
+ });
335
+ });
336
+
337
+ it('should handle endpoint without any schemas', async () => {
338
+ const endpoint = new Endpoint({
339
+ route: '/health',
340
+ method: 'GET',
341
+ authorize: undefined,
342
+ fn: async () => ({ status: 'ok' }),
343
+ status: undefined,
344
+ getSession: undefined,
345
+ input: undefined,
346
+ output: undefined,
347
+ services: [],
348
+ logger: {} as any,
349
+ timeout: undefined,
350
+ memorySize: undefined,
351
+ description: undefined,
352
+ });
353
+
354
+ const spec = await endpoint.toOpenApi3Route();
355
+
356
+ expect(spec).toEqual({
357
+ '/health': {
358
+ get: {
359
+ responses: {
360
+ '200': {
361
+ description: 'Successful response',
362
+ },
363
+ },
364
+ },
365
+ },
366
+ });
367
+ });
368
+
369
+ it('should not include body for GET endpoint even if provided', async () => {
370
+ const bodySchema = z.object({ invalid: z.string() });
371
+
372
+ const endpoint = new Endpoint({
373
+ route: '/users',
374
+ method: 'GET',
375
+ status: undefined,
376
+ getSession: undefined,
377
+ authorize: undefined,
378
+ output: z.object({
379
+ users: z.array(z.object({ id: z.string(), name: z.string() })),
380
+ }),
381
+ fn: async () => ({
382
+ users: [],
383
+ }),
384
+ input: {
385
+ body: bodySchema,
386
+ },
387
+ services: [],
388
+ logger: {} as any,
389
+ timeout: undefined,
390
+ memorySize: undefined,
391
+ description: undefined,
392
+ });
393
+
394
+ const spec = await endpoint.toOpenApi3Route();
395
+
396
+ expect(spec['/users']?.get).not.toHaveProperty('requestBody');
397
+ });
398
+
399
+ it('should correctly separate path and query parameters', async () => {
400
+ const paramsSchema = z.object({
401
+ userId: z.string(),
402
+ itemId: z.string(),
403
+ });
404
+ const querySchema = z.object({
405
+ limit: z.number().optional(),
406
+ offset: z.number().optional(),
407
+ filter: z.string(),
408
+ });
409
+
410
+ const endpoint = new Endpoint({
411
+ route: '/users/:userId/items/:itemId',
412
+ method: 'GET',
413
+ description: 'Get user item with pagination',
414
+ fn: async () => ({}),
415
+ input: {
416
+ params: paramsSchema,
417
+ query: querySchema,
418
+ },
419
+ output: undefined,
420
+ services: [],
421
+ logger: {} as any,
422
+ timeout: undefined,
423
+ memorySize: undefined,
424
+ status: undefined,
425
+ getSession: undefined,
426
+ authorize: undefined,
427
+ });
428
+
429
+ const spec = await endpoint.toOpenApi3Route();
430
+ const doc = spec['/users/{userId}/items/{itemId}'];
431
+
432
+ // Path parameters should be at route level
433
+ expect(doc.parameters).toBeDefined();
434
+ expect(doc.parameters).toHaveLength(2);
435
+ expect(doc.parameters).toContainEqual({
436
+ name: 'userId',
437
+ in: 'path',
438
+ required: true,
439
+ schema: { type: 'string' },
440
+ });
441
+ expect(doc.parameters).toContainEqual({
442
+ name: 'itemId',
443
+ in: 'path',
444
+ required: true,
445
+ schema: { type: 'string' },
446
+ });
447
+
448
+ // Query parameters should be at method level
449
+ expect(doc.get.parameters).toBeDefined();
450
+ expect(doc.get.parameters).toHaveLength(3);
451
+ expect(doc.get.parameters).toContainEqual({
452
+ name: 'limit',
453
+ in: 'query',
454
+ required: false,
455
+ schema: { type: 'number' },
456
+ });
457
+ expect(doc.get.parameters).toContainEqual({
458
+ name: 'offset',
459
+ in: 'query',
460
+ required: false,
461
+ schema: { type: 'number' },
462
+ });
463
+ expect(doc.get.parameters).toContainEqual({
464
+ name: 'filter',
465
+ in: 'query',
466
+ required: true,
467
+ schema: { type: 'string' },
468
+ });
469
+ });
470
+ });
471
+
472
+ describe('authorize property', () => {
473
+ const mockLogger: Logger = {
474
+ debug: vi.fn(),
475
+ info: vi.fn(),
476
+ warn: vi.fn(),
477
+ error: vi.fn(),
478
+ fatal: vi.fn(),
479
+ trace: vi.fn(),
480
+ child: vi.fn(() => mockLogger),
481
+ };
482
+
483
+ const services = ServiceDiscovery.getInstance(new EnvironmentParser({}));
484
+
485
+ it('should have default authorize function that returns true', async () => {
486
+ const endpoint = new Endpoint({
487
+ route: '/test',
488
+ method: 'GET',
489
+ fn: async () => ({ success: true }),
490
+ input: undefined,
491
+ output: undefined,
492
+ services: [],
493
+ authorize: undefined,
494
+ logger: mockLogger,
495
+ timeout: undefined,
496
+ memorySize: undefined,
497
+ status: undefined,
498
+ getSession: undefined,
499
+ description: undefined,
500
+ });
501
+
502
+ const result = await endpoint.authorize({
503
+ header: vi.fn(),
504
+ services,
505
+ logger: mockLogger,
506
+ session: {},
507
+ cookie: vi.fn(),
508
+ });
509
+
510
+ expect(result).toBe(true);
511
+ });
512
+
513
+ it('should allow custom authorize function', async () => {
514
+ const endpoint = new Endpoint({
515
+ route: '/test',
516
+ method: 'GET',
517
+ fn: async () => ({ success: true }),
518
+ input: undefined,
519
+ output: undefined,
520
+ services: [],
521
+ logger: mockLogger,
522
+ authorize: undefined,
523
+ timeout: undefined,
524
+ memorySize: undefined,
525
+ status: undefined,
526
+ getSession: undefined,
527
+ description: undefined,
528
+ });
529
+
530
+ const customAuthFn = vi.fn().mockResolvedValue(false);
531
+ endpoint.authorize = customAuthFn;
532
+
533
+ const mockContext = {
534
+ header: vi.fn(),
535
+ services,
536
+ logger: mockLogger,
537
+ session: {},
538
+ cookie: vi.fn(),
539
+ };
540
+
541
+ const result = await endpoint.authorize(mockContext);
542
+
543
+ expect(result).toBe(false);
544
+ expect(customAuthFn).toHaveBeenCalledWith(mockContext);
545
+ });
546
+
547
+ it('should support synchronous authorize function', () => {
548
+ const endpoint = new Endpoint({
549
+ route: '/test',
550
+ method: 'GET',
551
+ fn: async () => ({ success: true }),
552
+ input: undefined,
553
+ output: undefined,
554
+ services: [],
555
+ logger: mockLogger,
556
+ timeout: undefined,
557
+ memorySize: undefined,
558
+ authorize: undefined,
559
+ status: undefined,
560
+ getSession: undefined,
561
+ description: undefined,
562
+ });
563
+
564
+ const syncAuthFn = vi.fn().mockReturnValue(true);
565
+ endpoint.authorize = syncAuthFn;
566
+
567
+ const mockContext = {
568
+ header: vi.fn(),
569
+ services,
570
+ logger: mockLogger,
571
+ session: {},
572
+ cookie: vi.fn(),
573
+ };
574
+
575
+ const result = endpoint.authorize(mockContext);
576
+
577
+ expect(result).toBe(true);
578
+ expect(syncAuthFn).toHaveBeenCalledWith(mockContext);
579
+ });
580
+
581
+ it('should receive header function in context', async () => {
582
+ const endpoint = new Endpoint({
583
+ route: '/test',
584
+ method: 'GET',
585
+ fn: async () => ({ success: true }),
586
+ input: undefined,
587
+ output: undefined,
588
+ services: [],
589
+ authorize: undefined,
590
+ logger: mockLogger,
591
+ timeout: undefined,
592
+ memorySize: undefined,
593
+ status: undefined,
594
+ getSession: undefined,
595
+ description: undefined,
596
+ });
597
+
598
+ const headerFn = vi.fn().mockReturnValue('Bearer token123');
599
+
600
+ endpoint.authorize = ({ header }) => {
601
+ return header('authorization') === 'Bearer token123';
602
+ };
603
+
604
+ const result = await endpoint.authorize({
605
+ header: headerFn,
606
+ services,
607
+ logger: mockLogger,
608
+ session: {},
609
+ cookie: vi.fn(),
610
+ });
611
+
612
+ expect(result).toBe(true);
613
+ expect(headerFn).toHaveBeenCalledWith('authorization');
614
+ });
615
+
616
+ it('should receive services in context', async () => {
617
+ const TestService = {
618
+ serviceName: 'TestService' as const,
619
+ register() {
620
+ return {
621
+ validateUser(id: string) {
622
+ return id === 'valid';
623
+ },
624
+ };
625
+ },
626
+ };
627
+
628
+ await services.register([TestService]);
629
+ const endpoint = new Endpoint({
630
+ route: '/test',
631
+ method: 'GET',
632
+ fn: async () => ({ success: true }),
633
+ input: undefined,
634
+ output: undefined,
635
+ services: [TestService],
636
+ logger: mockLogger,
637
+ timeout: undefined,
638
+ memorySize: undefined,
639
+ status: undefined,
640
+ authorize: async ({ services }) => {
641
+ return services.TestService.validateUser('valid');
642
+ },
643
+ getSession: undefined,
644
+ description: undefined,
645
+ });
646
+
647
+ const result = await endpoint.authorize({
648
+ header: vi.fn(),
649
+ services: { TestService: TestService.register() },
650
+ logger: mockLogger,
651
+ session: {},
652
+ cookie: vi.fn(),
653
+ });
654
+
655
+ expect(result).toBe(true);
656
+ });
657
+
658
+ it('should receive logger in context', async () => {
659
+ const endpoint = new Endpoint({
660
+ route: '/test',
661
+ method: 'GET',
662
+ fn: async () => ({ success: true }),
663
+ input: undefined,
664
+ output: undefined,
665
+ authorize: undefined,
666
+ services: [],
667
+ logger: mockLogger,
668
+ timeout: undefined,
669
+ memorySize: undefined,
670
+ status: undefined,
671
+ getSession: undefined,
672
+ description: undefined,
673
+ });
674
+
675
+ const loggerSpy = vi.fn();
676
+ const testLogger = {
677
+ ...mockLogger,
678
+ info: loggerSpy,
679
+ };
680
+
681
+ endpoint.authorize = ({ logger }) => {
682
+ logger.info('Authorization check');
683
+ return true;
684
+ };
685
+
686
+ const result = await endpoint.authorize({
687
+ header: vi.fn(),
688
+ services,
689
+ logger: testLogger,
690
+ cookie: vi.fn(),
691
+ session: {},
692
+ });
693
+
694
+ expect(result).toBe(true);
695
+ expect(loggerSpy).toHaveBeenCalledWith('Authorization check');
696
+ });
697
+
698
+ it('should receive session in context', async () => {
699
+ const endpoint = new Endpoint({
700
+ route: '/test',
701
+ method: 'GET',
702
+ fn: async () => ({ success: true }),
703
+ input: undefined,
704
+ output: undefined,
705
+ authorize: undefined,
706
+ services: [],
707
+ logger: mockLogger,
708
+ timeout: undefined,
709
+ memorySize: undefined,
710
+ status: undefined,
711
+ getSession: () => ({ role: 'admin' }),
712
+ description: undefined,
713
+ });
714
+
715
+ const mockSession = { userId: 'user123', role: 'admin' };
716
+
717
+ endpoint.authorize = ({ session }) => {
718
+ return session.role === 'admin';
719
+ };
720
+
721
+ const result = await endpoint.authorize({
722
+ header: vi.fn(),
723
+ services,
724
+ logger: mockLogger,
725
+ session: mockSession,
726
+ cookie: vi.fn(),
727
+ });
728
+
729
+ expect(result).toBe(true);
730
+ });
731
+
732
+ it('should handle authorize function that throws error', async () => {
733
+ const endpoint = new Endpoint({
734
+ route: '/test',
735
+ method: 'GET',
736
+ fn: async () => ({ success: true }),
737
+ input: undefined,
738
+ output: undefined,
739
+ services: [],
740
+ authorize: async () => {
741
+ throw new Error('Authorization failed');
742
+ },
743
+
744
+ logger: mockLogger,
745
+ timeout: undefined,
746
+ memorySize: undefined,
747
+ status: undefined,
748
+ getSession: undefined,
749
+ description: undefined,
750
+ });
751
+
752
+ await expect(() =>
753
+ endpoint.authorize({
754
+ header: vi.fn(),
755
+ services,
756
+ logger: mockLogger,
757
+ session: {},
758
+ cookie: vi.fn(),
759
+ }),
760
+ ).rejects.toThrow('Authorization failed');
761
+ });
762
+
763
+ it('should handle async authorize function that throws error', async () => {
764
+ const endpoint = new Endpoint({
765
+ route: '/test',
766
+ method: 'GET',
767
+ fn: async () => ({ success: true }),
768
+ input: undefined,
769
+ output: undefined,
770
+ services: [],
771
+ logger: mockLogger,
772
+ timeout: undefined,
773
+ memorySize: undefined,
774
+ authorize: undefined,
775
+ status: undefined,
776
+ getSession: undefined,
777
+ description: undefined,
778
+ });
779
+
780
+ endpoint.authorize = async () => {
781
+ throw new Error('Async authorization failed');
782
+ };
783
+
784
+ await expect(
785
+ endpoint.authorize({
786
+ header: vi.fn(),
787
+ services,
788
+ logger: mockLogger,
789
+ session: {},
790
+ cookie: vi.fn(),
791
+ }),
792
+ ).rejects.toThrow('Async authorization failed');
793
+ });
794
+
795
+ it('should work with complex authorization logic', async () => {
796
+ const endpoint = new Endpoint({
797
+ route: '/admin/users',
798
+ method: 'GET',
799
+ authorize: undefined,
800
+ fn: async () => ({ users: [] }),
801
+ input: undefined,
802
+ output: undefined,
803
+ services: [],
804
+ logger: mockLogger,
805
+ timeout: undefined,
806
+ memorySize: undefined,
807
+ status: undefined,
808
+ getSession: undefined,
809
+ description: undefined,
810
+ });
811
+
812
+ endpoint.authorize = async ({ header, session }) => {
813
+ // Simulate complex authorization logic
814
+ const token = header('authorization');
815
+ if (!token) return false;
816
+
817
+ const user = session as any;
818
+ if (!user?.role) return false;
819
+
820
+ return user.role === 'admin' || user.role === 'superuser';
821
+ };
822
+
823
+ // Test with admin role
824
+ const adminResult = await endpoint.authorize({
825
+ header: vi.fn().mockReturnValue('Bearer admin-token'),
826
+ services,
827
+ logger: mockLogger,
828
+ cookie: vi.fn(),
829
+ session: { userId: 'admin1', role: 'admin' },
830
+ });
831
+
832
+ expect(adminResult).toBe(true);
833
+
834
+ // Test with user role
835
+ const userResult = await endpoint.authorize({
836
+ header: vi.fn().mockReturnValue('Bearer user-token'),
837
+ services,
838
+ cookie: vi.fn(),
839
+ logger: mockLogger,
840
+ session: { userId: 'user1', role: 'user' },
841
+ });
842
+
843
+ expect(userResult).toBe(false);
844
+
845
+ // Test with no token
846
+ const noTokenResult = await endpoint.authorize({
847
+ header: vi.fn().mockReturnValue(undefined),
848
+ services,
849
+ logger: mockLogger,
850
+ session: { userId: 'user1', role: 'admin' },
851
+ cookie: vi.fn(),
852
+ });
853
+
854
+ expect(noTokenResult).toBe(false);
855
+ });
856
+ });
857
+ });