@geekmidas/constructs 10.0.0-alpha.99 → 10.0.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (533) hide show
  1. package/CHANGELOG.md +437 -0
  2. package/README.md +193 -285
  3. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
  4. package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
  5. package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
  6. package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
  7. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
  8. package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
  9. package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
  10. package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
  11. package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
  12. package/dist/Construct-BWF5HxaM.mjs.map +1 -0
  13. package/dist/Construct-JlyQkBkv.d.cts +117 -0
  14. package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
  15. package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
  16. package/dist/Construct-TGIM_E4o.cjs.map +1 -0
  17. package/dist/Construct-pxwC6fDD.d.mts +117 -0
  18. package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
  19. package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
  20. package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
  21. package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
  22. package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
  23. package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
  24. package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
  25. package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
  26. package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
  27. package/dist/Queue-BL68oDJ-.d.mts +66 -0
  28. package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
  29. package/dist/Queue-DxJ6btRE.d.cts +66 -0
  30. package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
  31. package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
  32. package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
  33. package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
  34. package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
  35. package/dist/Topic-DJXoDeMP.d.cts +60 -0
  36. package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
  37. package/dist/Topic-DxWQBgMN.d.mts +60 -0
  38. package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
  39. package/dist/adaptors/aws.cjs +205 -355
  40. package/dist/adaptors/aws.cjs.map +1 -1
  41. package/dist/adaptors/aws.d.cts +48 -126
  42. package/dist/adaptors/aws.d.cts.map +1 -1
  43. package/dist/adaptors/aws.d.mts +49 -127
  44. package/dist/adaptors/aws.d.mts.map +1 -1
  45. package/dist/adaptors/aws.mjs +178 -325
  46. package/dist/adaptors/aws.mjs.map +1 -1
  47. package/dist/adaptors/hono.cjs +9 -3
  48. package/dist/adaptors/hono.d.cts +15 -7
  49. package/dist/adaptors/hono.d.cts.map +1 -1
  50. package/dist/adaptors/hono.d.mts +17 -9
  51. package/dist/adaptors/hono.d.mts.map +1 -1
  52. package/dist/adaptors/hono.mjs +9 -2
  53. package/dist/adaptors/testing.cjs +209 -831
  54. package/dist/adaptors/testing.cjs.map +1 -1
  55. package/dist/adaptors/testing.d.cts +55 -351
  56. package/dist/adaptors/testing.d.cts.map +1 -1
  57. package/dist/adaptors/testing.d.mts +53 -349
  58. package/dist/adaptors/testing.d.mts.map +1 -1
  59. package/dist/adaptors/testing.mjs +195 -798
  60. package/dist/adaptors/testing.mjs.map +1 -1
  61. package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
  62. package/dist/clone-I_WIpiFf.cjs.map +1 -0
  63. package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
  64. package/dist/clone-pdXxc0t3.mjs.map +1 -0
  65. package/dist/crons/index.cjs +66 -190
  66. package/dist/crons/index.cjs.map +1 -1
  67. package/dist/crons/index.d.cts +35 -70
  68. package/dist/crons/index.d.cts.map +1 -1
  69. package/dist/crons/index.d.mts +32 -70
  70. package/dist/crons/index.d.mts.map +1 -1
  71. package/dist/crons/index.mjs +63 -184
  72. package/dist/crons/index.mjs.map +1 -1
  73. package/dist/endpoints/index.cjs +761 -19
  74. package/dist/endpoints/index.cjs.map +1 -0
  75. package/dist/endpoints/index.d.cts +322 -22
  76. package/dist/endpoints/index.d.cts.map +1 -1
  77. package/dist/endpoints/index.d.mts +321 -22
  78. package/dist/endpoints/index.d.mts.map +1 -1
  79. package/dist/endpoints/index.mjs +751 -6
  80. package/dist/endpoints/index.mjs.map +1 -0
  81. package/dist/functions/index.cjs +5 -2
  82. package/dist/functions/index.d.cts +3 -3
  83. package/dist/functions/index.d.mts +3 -3
  84. package/dist/functions/index.mjs +5 -2
  85. package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
  86. package/dist/functions-EqTloHjo.mjs.map +1 -0
  87. package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
  88. package/dist/functions-SqtCDc9c.cjs.map +1 -0
  89. package/dist/index-C7iynzLI.d.mts +139 -0
  90. package/dist/index-C7iynzLI.d.mts.map +1 -0
  91. package/dist/index-D4dM_WDY.d.cts +142 -0
  92. package/dist/index-D4dM_WDY.d.cts.map +1 -0
  93. package/dist/index.cjs +3 -6
  94. package/dist/index.d.cts +4 -27
  95. package/dist/index.d.mts +4 -27
  96. package/dist/index.mjs +3 -3
  97. package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
  98. package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
  99. package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
  100. package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
  101. package/dist/monitors/index.cjs +49 -0
  102. package/dist/monitors/index.cjs.map +1 -0
  103. package/dist/monitors/index.d.cts +45 -0
  104. package/dist/monitors/index.d.cts.map +1 -0
  105. package/dist/monitors/index.d.mts +45 -0
  106. package/dist/monitors/index.d.mts.map +1 -0
  107. package/dist/monitors/index.mjs +48 -0
  108. package/dist/monitors/index.mjs.map +1 -0
  109. package/dist/processAudits-BJZT5gmy.cjs +92 -0
  110. package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
  111. package/dist/processAudits-CwyaaSQc.mjs +80 -0
  112. package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
  113. package/dist/publisher-BZgcrVPy.cjs +53 -0
  114. package/dist/publisher-BZgcrVPy.cjs.map +1 -0
  115. package/dist/publisher-CnpeMv-r.mjs +41 -0
  116. package/dist/publisher-CnpeMv-r.mjs.map +1 -0
  117. package/dist/queue/index.cjs +114 -6
  118. package/dist/queue/index.cjs.map +1 -0
  119. package/dist/queue/index.d.cts +45 -3
  120. package/dist/queue/index.d.cts.map +1 -0
  121. package/dist/queue/index.d.mts +44 -3
  122. package/dist/queue/index.d.mts.map +1 -0
  123. package/dist/queue/index.mjs +112 -3
  124. package/dist/queue/index.mjs.map +1 -0
  125. package/dist/subscribers/index.cjs +80 -111
  126. package/dist/subscribers/index.cjs.map +1 -1
  127. package/dist/subscribers/index.d.cts +43 -46
  128. package/dist/subscribers/index.d.cts.map +1 -1
  129. package/dist/subscribers/index.d.mts +42 -46
  130. package/dist/subscribers/index.d.mts.map +1 -1
  131. package/dist/subscribers/index.mjs +78 -108
  132. package/dist/subscribers/index.mjs.map +1 -1
  133. package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
  134. package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
  135. package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
  136. package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
  137. package/dist/topic/index.cjs +91 -3
  138. package/dist/topic/index.cjs.map +1 -0
  139. package/dist/topic/index.d.cts +32 -2
  140. package/dist/topic/index.d.cts.map +1 -0
  141. package/dist/topic/index.d.mts +32 -2
  142. package/dist/topic/index.d.mts.map +1 -0
  143. package/dist/topic/index.mjs +89 -2
  144. package/dist/topic/index.mjs.map +1 -0
  145. package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
  146. package/dist/types-BdAaYDvd.d.cts.map +1 -0
  147. package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
  148. package/dist/types-DNngH0fX.d.mts.map +1 -0
  149. package/dist/types.d.cts +1 -1
  150. package/dist/types.d.mts +1 -1
  151. package/dist/types.mjs +0 -1
  152. package/package.json +55 -223
  153. package/src/Construct.ts +209 -0
  154. package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
  155. package/src/__benchmarks__/endpoint.bench.ts +494 -0
  156. package/src/__benchmarks__/fixtures.ts +241 -0
  157. package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
  158. package/src/__benchmarks__/hono-server.bench.ts +249 -0
  159. package/src/__benchmarks__/response-builder.bench.ts +428 -0
  160. package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
  161. package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
  162. package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
  163. package/src/__tests__/Construct.environment.spec.ts +704 -0
  164. package/src/__tests__/builder-reuse.spec.ts +587 -0
  165. package/src/__tests__/monitor.spec.ts +636 -0
  166. package/src/__tests__/publisher.setting.spec.ts +508 -0
  167. package/src/__tests__/publisher.spec.ts +452 -0
  168. package/src/adaptors/aws.ts +6 -0
  169. package/src/adaptors/hono.ts +1 -0
  170. package/src/adaptors/testing.ts +11 -0
  171. package/src/clone.ts +38 -0
  172. package/src/crons/AWSScheduledFunction.ts +73 -0
  173. package/src/crons/Cron.ts +149 -0
  174. package/src/crons/CronBuilder.ts +261 -0
  175. package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
  176. package/src/crons/__tests__/Cron.spec.ts +472 -0
  177. package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
  178. package/src/crons/index.ts +12 -0
  179. package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
  180. package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
  181. package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
  182. package/src/endpoints/Authorizer.ts +152 -0
  183. package/src/endpoints/Endpoint.ts +1287 -0
  184. package/src/endpoints/EndpointBuilder.ts +749 -0
  185. package/src/endpoints/EndpointFactory.ts +1179 -0
  186. package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
  187. package/src/endpoints/MswEndpointAdaptor.ts +226 -0
  188. package/src/endpoints/TestEndpointAdaptor.ts +466 -0
  189. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
  190. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
  191. package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
  192. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
  193. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
  194. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
  195. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
  196. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
  197. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
  198. package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
  199. package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
  200. package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
  201. package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
  202. package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
  203. package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
  204. package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
  205. package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
  206. package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
  207. package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
  208. package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
  209. package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
  210. package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
  211. package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
  212. package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
  213. package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
  214. package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
  215. package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
  216. package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
  217. package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
  218. package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
  219. package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
  220. package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
  221. package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
  222. package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
  223. package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
  224. package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
  225. package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
  226. package/src/endpoints/__tests__/helpers.spec.ts +37 -0
  227. package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
  228. package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
  229. package/src/endpoints/audit.ts +87 -0
  230. package/src/endpoints/helpers.ts +98 -0
  231. package/src/endpoints/index.ts +42 -0
  232. package/src/endpoints/lazyAccessors.ts +241 -0
  233. package/src/endpoints/parseHonoQuery.ts +16 -0
  234. package/src/endpoints/parseQueryParams.ts +32 -0
  235. package/src/endpoints/processAudits.ts +371 -0
  236. package/src/endpoints/rls.ts +67 -0
  237. package/src/functions/AWSLambdaFunction.ts +374 -0
  238. package/src/functions/BaseFunctionBuilder.ts +212 -0
  239. package/src/functions/Function.ts +238 -0
  240. package/src/functions/FunctionBuilder.ts +381 -0
  241. package/src/functions/FunctionExecutionWrapper.ts +216 -0
  242. package/src/functions/TestFunctionAdaptor.ts +252 -0
  243. package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
  244. package/src/functions/__tests__/Function.audits.spec.ts +393 -0
  245. package/src/functions/__tests__/Function.spec.ts +477 -0
  246. package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
  247. package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
  248. package/src/functions/index.ts +12 -0
  249. package/src/index.ts +29 -0
  250. package/src/monitor.ts +145 -0
  251. package/src/monitors/heartbeat.ts +86 -0
  252. package/src/monitors/index.ts +6 -0
  253. package/src/publisher.ts +93 -0
  254. package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
  255. package/src/queue/Queue.ts +128 -0
  256. package/src/queue/QueueBuilder.ts +115 -0
  257. package/src/queue/TestQueueAdaptor.ts +63 -0
  258. package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
  259. package/src/queue/index.ts +12 -0
  260. package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
  261. package/src/subscribers/Subscriber.ts +117 -0
  262. package/src/subscribers/SubscriberBuilder.ts +183 -0
  263. package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
  264. package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
  265. package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
  266. package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
  267. package/src/subscribers/index.ts +6 -0
  268. package/src/telemetry.ts +103 -0
  269. package/src/topic/Topic.ts +103 -0
  270. package/src/topic/TopicBuilder.ts +53 -0
  271. package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
  272. package/src/topic/index.ts +11 -0
  273. package/src/types.ts +13 -0
  274. package/test.ts +91 -0
  275. package/tsconfig.json +9 -0
  276. package/tsdown.config.ts +35 -0
  277. package/dist/Construct-B1vGBPme.mjs.map +0 -1
  278. package/dist/Construct-BQALFCh2.d.cts +0 -230
  279. package/dist/Construct-BQALFCh2.d.cts.map +0 -1
  280. package/dist/Construct-DUSXuTHP.cjs.map +0 -1
  281. package/dist/Construct-QXnl3VqT.d.mts +0 -230
  282. package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
  283. package/dist/Cron-DI3nKoic.d.cts +0 -45
  284. package/dist/Cron-DI3nKoic.d.cts.map +0 -1
  285. package/dist/Cron-uYAHPnp7.d.mts +0 -45
  286. package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
  287. package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
  288. package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
  289. package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
  290. package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
  291. package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
  292. package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
  293. package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
  294. package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
  295. package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
  296. package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
  297. package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
  298. package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
  299. package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
  300. package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
  301. package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
  302. package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
  303. package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
  304. package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
  305. package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
  306. package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
  307. package/dist/Function-DuqGcbOI.d.mts +0 -76
  308. package/dist/Function-DuqGcbOI.d.mts.map +0 -1
  309. package/dist/Function-Pu-1kKZz.d.cts +0 -76
  310. package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
  311. package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
  312. package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
  313. package/dist/Queue-A3wfD0it.cjs +0 -109
  314. package/dist/Queue-A3wfD0it.cjs.map +0 -1
  315. package/dist/Queue-D6USGS4q.mjs +0 -104
  316. package/dist/Queue-D6USGS4q.mjs.map +0 -1
  317. package/dist/Queue-DlsHRzUp.d.mts +0 -105
  318. package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
  319. package/dist/Queue-HPyi0e1i.d.cts +0 -105
  320. package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
  321. package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
  322. package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
  323. package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
  324. package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
  325. package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
  326. package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
  327. package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
  328. package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
  329. package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
  330. package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
  331. package/dist/Subscriber-CtN9R48-.d.mts +0 -61
  332. package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
  333. package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
  334. package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
  335. package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
  336. package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
  337. package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
  338. package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
  339. package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
  340. package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
  341. package/dist/Topic-D74b5cgs.mjs +0 -99
  342. package/dist/Topic-D74b5cgs.mjs.map +0 -1
  343. package/dist/Topic-GHxcU8AG.cjs +0 -104
  344. package/dist/Topic-GHxcU8AG.cjs.map +0 -1
  345. package/dist/auth-BMCJN30Y.d.cts +0 -268
  346. package/dist/auth-BMCJN30Y.d.cts.map +0 -1
  347. package/dist/auth-CcuceLYo.d.mts +0 -268
  348. package/dist/auth-CcuceLYo.d.mts.map +0 -1
  349. package/dist/auth.cjs +0 -433
  350. package/dist/auth.cjs.map +0 -1
  351. package/dist/auth.d.cts +0 -2
  352. package/dist/auth.d.mts +0 -2
  353. package/dist/auth.mjs +0 -426
  354. package/dist/auth.mjs.map +0 -1
  355. package/dist/cache-CXh6GIgb.d.mts +0 -44
  356. package/dist/cache-CXh6GIgb.d.mts.map +0 -1
  357. package/dist/cache-DnGDGly3.d.cts +0 -44
  358. package/dist/cache-DnGDGly3.d.cts.map +0 -1
  359. package/dist/cache.cjs +0 -69
  360. package/dist/cache.cjs.map +0 -1
  361. package/dist/cache.d.cts +0 -2
  362. package/dist/cache.d.mts +0 -2
  363. package/dist/cache.mjs +0 -68
  364. package/dist/cache.mjs.map +0 -1
  365. package/dist/cipher-C1lEFX63.mjs +0 -225
  366. package/dist/cipher-C1lEFX63.mjs.map +0 -1
  367. package/dist/cipher-CVxfwLjk.cjs +0 -332
  368. package/dist/cipher-CVxfwLjk.cjs.map +0 -1
  369. package/dist/clone-EKNovYHu.mjs.map +0 -1
  370. package/dist/clone-UGJpvQnL.cjs.map +0 -1
  371. package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
  372. package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
  373. package/dist/construct-interface-DluK3_da.d.mts +0 -162
  374. package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
  375. package/dist/construct-interface.cjs +0 -114
  376. package/dist/construct-interface.cjs.map +0 -1
  377. package/dist/construct-interface.d.cts +0 -2
  378. package/dist/construct-interface.d.mts +0 -2
  379. package/dist/construct-interface.mjs +0 -107
  380. package/dist/construct-interface.mjs.map +0 -1
  381. package/dist/credential.cjs +0 -156
  382. package/dist/credential.cjs.map +0 -1
  383. package/dist/credential.d.cts +0 -86
  384. package/dist/credential.d.cts.map +0 -1
  385. package/dist/credential.d.mts +0 -86
  386. package/dist/credential.d.mts.map +0 -1
  387. package/dist/credential.mjs +0 -152
  388. package/dist/credential.mjs.map +0 -1
  389. package/dist/database/kysely.cjs +0 -4
  390. package/dist/database/kysely.d.cts +0 -2
  391. package/dist/database/kysely.d.mts +0 -2
  392. package/dist/database/kysely.mjs +0 -2
  393. package/dist/email.cjs +0 -72
  394. package/dist/email.cjs.map +0 -1
  395. package/dist/email.d.cts +0 -46
  396. package/dist/email.d.cts.map +0 -1
  397. package/dist/email.d.mts +0 -46
  398. package/dist/email.d.mts.map +0 -1
  399. package/dist/email.mjs +0 -71
  400. package/dist/email.mjs.map +0 -1
  401. package/dist/encryption.cjs +0 -96
  402. package/dist/encryption.cjs.map +0 -1
  403. package/dist/encryption.d.cts +0 -117
  404. package/dist/encryption.d.cts.map +0 -1
  405. package/dist/encryption.d.mts +0 -117
  406. package/dist/encryption.d.mts.map +0 -1
  407. package/dist/encryption.mjs +0 -83
  408. package/dist/encryption.mjs.map +0 -1
  409. package/dist/external-api-MJ8id87V.d.mts +0 -105
  410. package/dist/external-api-MJ8id87V.d.mts.map +0 -1
  411. package/dist/external-api-O107yzZJ.d.cts +0 -105
  412. package/dist/external-api-O107yzZJ.d.cts.map +0 -1
  413. package/dist/external-api.cjs +0 -142
  414. package/dist/external-api.cjs.map +0 -1
  415. package/dist/external-api.d.cts +0 -2
  416. package/dist/external-api.d.mts +0 -2
  417. package/dist/external-api.mjs +0 -139
  418. package/dist/external-api.mjs.map +0 -1
  419. package/dist/file-server.cjs +0 -186
  420. package/dist/file-server.cjs.map +0 -1
  421. package/dist/file-server.d.cts +0 -152
  422. package/dist/file-server.d.cts.map +0 -1
  423. package/dist/file-server.d.mts +0 -152
  424. package/dist/file-server.d.mts.map +0 -1
  425. package/dist/file-server.mjs +0 -184
  426. package/dist/file-server.mjs.map +0 -1
  427. package/dist/functions-BFizikJU.mjs.map +0 -1
  428. package/dist/functions-CfzJG9hK.cjs.map +0 -1
  429. package/dist/index-BuzRvKOQ.d.cts +0 -115
  430. package/dist/index-BuzRvKOQ.d.cts.map +0 -1
  431. package/dist/index-CTkKOer4.d.mts +0 -115
  432. package/dist/index-CTkKOer4.d.mts.map +0 -1
  433. package/dist/index-CeEtxDmK.d.cts +0 -79
  434. package/dist/index-CeEtxDmK.d.cts.map +0 -1
  435. package/dist/index-CeEtxDmK.d.mts +0 -79
  436. package/dist/index-CeEtxDmK.d.mts.map +0 -1
  437. package/dist/index.d.cts.map +0 -1
  438. package/dist/index.d.mts.map +0 -1
  439. package/dist/kms-B-Hm3d5r.cjs +0 -85
  440. package/dist/kms-B-Hm3d5r.cjs.map +0 -1
  441. package/dist/kms-BdUlMJEZ.mjs +0 -85
  442. package/dist/kms-BdUlMJEZ.mjs.map +0 -1
  443. package/dist/kysely-Bii4l6eP.mjs +0 -370
  444. package/dist/kysely-Bii4l6eP.mjs.map +0 -1
  445. package/dist/kysely-CO_Dk43W.cjs +0 -383
  446. package/dist/kysely-CO_Dk43W.cjs.map +0 -1
  447. package/dist/kysely-D0bpzgPs.d.cts +0 -175
  448. package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
  449. package/dist/kysely-DUqC3Ie0.d.mts +0 -175
  450. package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
  451. package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
  452. package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
  453. package/dist/lazyAccessors-CFanua0O.mjs +0 -174
  454. package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
  455. package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
  456. package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
  457. package/dist/mobile-app.cjs +0 -73
  458. package/dist/mobile-app.cjs.map +0 -1
  459. package/dist/mobile-app.d.cts +0 -61
  460. package/dist/mobile-app.d.cts.map +0 -1
  461. package/dist/mobile-app.d.mts +0 -61
  462. package/dist/mobile-app.d.mts.map +0 -1
  463. package/dist/mobile-app.mjs +0 -72
  464. package/dist/mobile-app.mjs.map +0 -1
  465. package/dist/object-storage.cjs +0 -56
  466. package/dist/object-storage.cjs.map +0 -1
  467. package/dist/object-storage.d.cts +0 -32
  468. package/dist/object-storage.d.cts.map +0 -1
  469. package/dist/object-storage.d.mts +0 -32
  470. package/dist/object-storage.d.mts.map +0 -1
  471. package/dist/object-storage.mjs +0 -55
  472. package/dist/object-storage.mjs.map +0 -1
  473. package/dist/processAudits-BRRVVHUB.mjs +0 -131
  474. package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
  475. package/dist/processAudits-DasOZjPl.cjs +0 -154
  476. package/dist/processAudits-DasOZjPl.cjs.map +0 -1
  477. package/dist/rest-api.cjs +0 -216
  478. package/dist/rest-api.cjs.map +0 -1
  479. package/dist/rest-api.d.cts +0 -241
  480. package/dist/rest-api.d.cts.map +0 -1
  481. package/dist/rest-api.d.mts +0 -241
  482. package/dist/rest-api.d.mts.map +0 -1
  483. package/dist/rest-api.mjs +0 -215
  484. package/dist/rest-api.mjs.map +0 -1
  485. package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
  486. package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
  487. package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
  488. package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
  489. package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
  490. package/dist/shutdown-BMJmAhSt.cjs +0 -38
  491. package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
  492. package/dist/shutdown-C7xa8x9S.mjs +0 -27
  493. package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
  494. package/dist/site.cjs +0 -74
  495. package/dist/site.cjs.map +0 -1
  496. package/dist/site.d.cts +0 -104
  497. package/dist/site.d.cts.map +0 -1
  498. package/dist/site.d.mts +0 -104
  499. package/dist/site.d.mts.map +0 -1
  500. package/dist/site.mjs +0 -73
  501. package/dist/site.mjs.map +0 -1
  502. package/dist/stages-BSCF19o2.d.cts +0 -56
  503. package/dist/stages-BSCF19o2.d.cts.map +0 -1
  504. package/dist/stages-BSCF19o2.d.mts +0 -56
  505. package/dist/stages-BSCF19o2.d.mts.map +0 -1
  506. package/dist/surfaceEnv-CNimK76p.cjs +0 -56
  507. package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
  508. package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
  509. package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
  510. package/dist/telemetry-B48RLjyk.d.cts +0 -40
  511. package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
  512. package/dist/telemetry-DRtT1_0A.d.mts +0 -40
  513. package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
  514. package/dist/telemetry.cjs +0 -56
  515. package/dist/telemetry.cjs.map +0 -1
  516. package/dist/telemetry.d.cts +0 -2
  517. package/dist/telemetry.d.mts +0 -2
  518. package/dist/telemetry.mjs +0 -55
  519. package/dist/telemetry.mjs.map +0 -1
  520. package/dist/tracing-CxaZ98IB.mjs +0 -110
  521. package/dist/tracing-CxaZ98IB.mjs.map +0 -1
  522. package/dist/tracing-DPMidF_r.cjs +0 -127
  523. package/dist/tracing-DPMidF_r.cjs.map +0 -1
  524. package/dist/types-DMuSQeLL.d.cts.map +0 -1
  525. package/dist/types-DMuSQeLL.d.mts.map +0 -1
  526. package/dist/worker.cjs +0 -191
  527. package/dist/worker.cjs.map +0 -1
  528. package/dist/worker.d.cts +0 -171
  529. package/dist/worker.d.cts.map +0 -1
  530. package/dist/worker.d.mts +0 -171
  531. package/dist/worker.d.mts.map +0 -1
  532. package/dist/worker.mjs +0 -190
  533. package/dist/worker.mjs.map +0 -1
@@ -0,0 +1,479 @@
1
+ import type { Logger } from '@geekmidas/logger';
2
+ import { ConsoleLogger } from '@geekmidas/logger/console';
3
+ import { describe, expect, it, vi } from 'vitest';
4
+ import { z } from 'zod';
5
+ import { EndpointFactory } from '../EndpointFactory';
6
+
7
+ describe('EndpointFactory', () => {
8
+ describe('joinPaths', () => {
9
+ it('should join simple paths', () => {
10
+ expect(EndpointFactory.joinPaths('/users', '/api')).toBe('/api/users');
11
+ expect(EndpointFactory.joinPaths('users', '/api')).toBe('/api/users');
12
+ expect(EndpointFactory.joinPaths('/users', 'api')).toBe('/api/users');
13
+ expect(EndpointFactory.joinPaths('users', 'api')).toBe('/api/users');
14
+ });
15
+
16
+ it('should handle empty base path', () => {
17
+ expect(EndpointFactory.joinPaths('/users', '')).toBe('/users');
18
+ expect(EndpointFactory.joinPaths('users', '')).toBe('/users');
19
+ });
20
+
21
+ it('should handle empty segment path', () => {
22
+ expect(EndpointFactory.joinPaths('', '/api')).toBe('/api');
23
+ expect(EndpointFactory.joinPaths('', 'api')).toBe('/api');
24
+ });
25
+
26
+ it('should handle both paths empty', () => {
27
+ expect(EndpointFactory.joinPaths('', '')).toBe('/');
28
+ });
29
+
30
+ it('should handle trailing slashes in base path', () => {
31
+ expect(EndpointFactory.joinPaths('/users', '/api/')).toBe('/api/users');
32
+ expect(EndpointFactory.joinPaths('users', '/api/')).toBe('/api/users');
33
+ expect(EndpointFactory.joinPaths('/users', 'api/')).toBe('/api/users');
34
+ expect(EndpointFactory.joinPaths('users', 'api/')).toBe('/api/users');
35
+ });
36
+
37
+ it('should handle root paths', () => {
38
+ expect(EndpointFactory.joinPaths('/users', '/')).toBe('/users');
39
+ expect(EndpointFactory.joinPaths('users', '/')).toBe('/users');
40
+ expect(EndpointFactory.joinPaths('/', '/')).toBe('/');
41
+ });
42
+
43
+ it('should handle multiple slashes', () => {
44
+ expect(EndpointFactory.joinPaths('//users', '/api')).toBe('/api//users');
45
+ expect(EndpointFactory.joinPaths('/users', '//api')).toBe('/api/users');
46
+ });
47
+
48
+ it('should handle complex paths', () => {
49
+ expect(EndpointFactory.joinPaths('/users/:id', '/api/v1')).toBe(
50
+ '/api/v1/users/:id',
51
+ );
52
+ expect(
53
+ EndpointFactory.joinPaths(
54
+ '/posts/:postId/comments/:commentId',
55
+ '/blog',
56
+ ),
57
+ ).toBe('/blog/posts/:postId/comments/:commentId');
58
+ });
59
+
60
+ it('should handle paths with query parameters notation', () => {
61
+ expect(EndpointFactory.joinPaths('/users?page=1', '/api')).toBe(
62
+ '/api/users?page=1',
63
+ );
64
+ expect(EndpointFactory.joinPaths('/search', '/api')).toBe('/api/search');
65
+ });
66
+
67
+ it('should handle nested segments', () => {
68
+ expect(EndpointFactory.joinPaths('/admin/users', '/api')).toBe(
69
+ '/api/admin/users',
70
+ );
71
+ expect(EndpointFactory.joinPaths('/v2/resources/items', '/api/v1')).toBe(
72
+ '/api/v1/v2/resources/items',
73
+ );
74
+ });
75
+
76
+ it('should not add extra slashes when paths already have them', () => {
77
+ expect(EndpointFactory.joinPaths('/users', '/api')).toBe('/api/users');
78
+ expect(EndpointFactory.joinPaths('/', '/api')).toBe('/api');
79
+ });
80
+
81
+ it('should preserve path parameters', () => {
82
+ expect(EndpointFactory.joinPaths('/:id', '/users')).toBe('/users/:id');
83
+ expect(
84
+ EndpointFactory.joinPaths('/:userId/posts/:postId', '/api/users'),
85
+ ).toBe('/api/users/:userId/posts/:postId');
86
+ });
87
+
88
+ it('should work with undefined base path (default parameter)', () => {
89
+ expect(EndpointFactory.joinPaths('/users')).toBe('/users');
90
+ expect(EndpointFactory.joinPaths('users')).toBe('/users');
91
+ expect(EndpointFactory.joinPaths('')).toBe('/');
92
+ });
93
+ });
94
+
95
+ describe('authorize', () => {
96
+ const mockLogger: Logger = {
97
+ debug: vi.fn(),
98
+ info: vi.fn(),
99
+ warn: vi.fn(),
100
+ error: vi.fn(),
101
+ fatal: vi.fn(),
102
+ trace: vi.fn(),
103
+ child: vi.fn(() => mockLogger),
104
+ };
105
+
106
+ it('should create a factory with authorization function', () => {
107
+ const factory = new EndpointFactory();
108
+ const authFn = async () => true;
109
+
110
+ const authorizedFactory = factory.authorize(authFn);
111
+
112
+ expect(authorizedFactory).toBeInstanceOf(EndpointFactory);
113
+ expect(authorizedFactory).not.toBe(factory);
114
+ });
115
+
116
+ it('should apply authorization to created endpoints', async () => {
117
+ const authFn = vi.fn().mockResolvedValue(true);
118
+ const factory = new EndpointFactory()
119
+ .services([])
120
+ .logger(mockLogger)
121
+ .authorize(authFn);
122
+
123
+ const endpoint = factory
124
+ .get('/test')
125
+ .handle(async () => ({ success: true }));
126
+
127
+ expect(endpoint.authorize).toBe(authFn);
128
+ });
129
+
130
+ it('should handle authorization with different service types', async () => {
131
+ const AuthService = {
132
+ serviceName: 'AuthService' as const,
133
+
134
+ async register() {
135
+ return { validateToken: (token: string) => token === 'valid' };
136
+ },
137
+ };
138
+
139
+ const authFn = async ({ header, services }: any) => {
140
+ const token = header('authorization')?.replace('Bearer ', '');
141
+ return services.AuthService.validateToken(token);
142
+ };
143
+
144
+ const factory = new EndpointFactory()
145
+ .services([AuthService])
146
+ .logger(mockLogger)
147
+ .authorize(authFn);
148
+
149
+ const endpoint = factory
150
+ .post('/protected')
151
+ .body(z.object({ data: z.string() }))
152
+ .handle(async () => ({ success: true }));
153
+
154
+ expect(endpoint.authorize).toBe(authFn);
155
+ });
156
+
157
+ it('should chain with other factory methods', () => {
158
+ const authFn = async () => true;
159
+ const sessionFn = async () => ({ userId: 'user1' });
160
+
161
+ const factory = new EndpointFactory()
162
+ .route('/api')
163
+ .services([])
164
+ .logger(mockLogger)
165
+ .authorize(authFn)
166
+ .session(sessionFn);
167
+
168
+ const endpoint = factory
169
+ .get('/test')
170
+ .handle(async () => ({ success: true }));
171
+
172
+ expect(endpoint.authorize).toBe(authFn);
173
+ expect(endpoint.getSession).toBe(sessionFn);
174
+ });
175
+
176
+ it('should preserve authorization in factory chains', () => {
177
+ const authFn = async () => true;
178
+ const newLogger = new ConsoleLogger();
179
+
180
+ const factory = new EndpointFactory()
181
+ .services([])
182
+ .authorize(authFn)
183
+ .logger(newLogger); // Chain after authorize
184
+
185
+ const endpoint = factory
186
+ .get('/test')
187
+ .handle(async () => ({ success: true }));
188
+
189
+ expect(endpoint.authorize).toBe(authFn);
190
+ expect(endpoint.logger).toBe(newLogger);
191
+ });
192
+
193
+ it('should handle authorization function returning boolean', async () => {
194
+ const authFn = ({ header }: any) => {
195
+ return header('authorization') === 'Bearer valid-token';
196
+ };
197
+
198
+ const factory = new EndpointFactory()
199
+ .services([])
200
+ .logger(mockLogger)
201
+ .authorize(authFn);
202
+
203
+ const endpoint = factory
204
+ .get('/test')
205
+ .handle(async () => ({ success: true }));
206
+
207
+ expect(endpoint.authorize).toBe(authFn);
208
+ });
209
+
210
+ it('should handle authorization function returning Promise<boolean>', async () => {
211
+ const authFn = async ({ header }: any) => {
212
+ await new Promise((resolve) => setTimeout(resolve, 1));
213
+ return header('authorization') === 'Bearer valid-token';
214
+ };
215
+
216
+ const factory = new EndpointFactory()
217
+ .services([])
218
+ .logger(mockLogger)
219
+ .authorize(authFn);
220
+
221
+ const endpoint = factory
222
+ .get('/test')
223
+ .handle(async () => ({ success: true }));
224
+
225
+ expect(endpoint.authorize).toBe(authFn);
226
+ });
227
+ });
228
+
229
+ describe('route', () => {
230
+ it('should create a sub-factory with path prefix', () => {
231
+ const factory = new EndpointFactory();
232
+ const apiFactory = factory.route('/api');
233
+ const v1Factory = apiFactory.route('/v1');
234
+
235
+ const endpoint = v1Factory.get('/users').handle(async () => []);
236
+
237
+ expect(endpoint.route).toBe('/api/v1/users');
238
+ });
239
+
240
+ it('should preserve services, auth, and logger in sub-routes', () => {
241
+ const authFn = async () => true;
242
+ const sessionFn = async () => ({ userId: 'user1' });
243
+
244
+ const TestService = {
245
+ serviceName: 'TestService' as const,
246
+ async register() {
247
+ return {};
248
+ },
249
+ };
250
+
251
+ const factory = new EndpointFactory()
252
+ .services([TestService])
253
+ .authorize(authFn)
254
+ .session(sessionFn)
255
+ .route('/api');
256
+
257
+ const endpoint = factory.get('/test').handle(async () => ({}));
258
+
259
+ expect(endpoint.route).toBe('/api/test');
260
+ expect(endpoint.authorize).toBe(authFn);
261
+ expect(endpoint.getSession).toBe(sessionFn);
262
+ });
263
+ });
264
+
265
+ describe('services', () => {
266
+ const Service1 = {
267
+ serviceName: 'Service1' as const,
268
+ async register() {
269
+ return { method1: () => 'service1' };
270
+ },
271
+ };
272
+
273
+ const Service2 = {
274
+ serviceName: 'Service2' as const,
275
+ async register() {
276
+ return { method2: () => 'service2' };
277
+ },
278
+ };
279
+
280
+ it('should add services to factory', () => {
281
+ const factory = new EndpointFactory().services([Service1, Service2]);
282
+ const endpoint = factory.get('/test').handle(async ({ services }) => ({
283
+ result1: (await services[Service1.serviceName]).method1(),
284
+ result2: (await services[Service2.serviceName]).method2(),
285
+ }));
286
+
287
+ expect(endpoint.services).toEqual([Service1, Service2]);
288
+ });
289
+
290
+ it('should handle duplicate services', () => {
291
+ const factory = new EndpointFactory()
292
+ .services([Service1])
293
+ .services([Service1, Service2]);
294
+
295
+ const endpoint = factory.get('/test').handle(async () => ({}));
296
+
297
+ // Should contain unique services
298
+ const serviceNames = endpoint.services.map((s) => s.serviceName);
299
+ expect(serviceNames).toContain('Service1');
300
+ expect(serviceNames).toContain('Service2');
301
+ });
302
+
303
+ it('should merge services in options', () => {
304
+ const factory = new EndpointFactory({
305
+ defaultServices: [Service1],
306
+ }).services([Service2]);
307
+
308
+ const endpoint = factory.get('/test').handle(async () => ({}));
309
+
310
+ expect(endpoint.services).toEqual([Service2, Service1]);
311
+ });
312
+ });
313
+
314
+ describe('logger', () => {
315
+ it('should set custom logger', () => {
316
+ const customLogger: Logger = {
317
+ debug: vi.fn(),
318
+ info: vi.fn(),
319
+ warn: vi.fn(),
320
+ error: vi.fn(),
321
+ fatal: vi.fn(),
322
+ trace: vi.fn(),
323
+ child: vi.fn(),
324
+ };
325
+
326
+ const factory = new EndpointFactory().logger(customLogger);
327
+ const endpoint = factory.get('/test').handle(async () => ({}));
328
+
329
+ expect(endpoint.logger).toBe(customLogger);
330
+ });
331
+
332
+ it('should use default logger when not specified', () => {
333
+ const factory = new EndpointFactory();
334
+ const endpoint = factory.get('/test').handle(async () => ({}));
335
+
336
+ expect(endpoint.logger).toBeDefined();
337
+ expect(endpoint.logger).toBeInstanceOf(ConsoleLogger);
338
+ });
339
+ });
340
+
341
+ describe('session', () => {
342
+ it('should set session extractor', () => {
343
+ const sessionFn = async () => ({ userId: '123', role: 'admin' });
344
+ const factory = new EndpointFactory().session(sessionFn);
345
+
346
+ const endpoint = factory.get('/test').handle(async ({ session }) => ({
347
+ session,
348
+ }));
349
+
350
+ expect(endpoint.getSession).toBe(sessionFn);
351
+ });
352
+
353
+ it('should handle session with services', () => {
354
+ const SessionService = {
355
+ serviceName: 'SessionService' as const,
356
+ async register() {
357
+ return {
358
+ getSession: (token: string) => ({ userId: token }),
359
+ };
360
+ },
361
+ };
362
+
363
+ const sessionFn = async ({ header, services }: any) => {
364
+ const token = header('authorization');
365
+ return services.SessionService.getSession(token);
366
+ };
367
+
368
+ const factory = new EndpointFactory()
369
+ .services([SessionService])
370
+ .session(sessionFn);
371
+
372
+ const endpoint = factory.get('/test').handle(async () => ({}));
373
+
374
+ expect(endpoint.getSession).toBe(sessionFn);
375
+ });
376
+ });
377
+
378
+ describe('HTTP method builders', () => {
379
+ const testMethods = [
380
+ { method: 'get', httpMethod: 'GET' },
381
+ { method: 'post', httpMethod: 'POST' },
382
+ { method: 'put', httpMethod: 'PUT' },
383
+ { method: 'delete', httpMethod: 'DELETE' },
384
+ { method: 'patch', httpMethod: 'PATCH' },
385
+ { method: 'options', httpMethod: 'OPTIONS' },
386
+ ] as const;
387
+
388
+ testMethods.forEach(({ method, httpMethod }) => {
389
+ it(`should create ${httpMethod} endpoint`, () => {
390
+ const factory = new EndpointFactory();
391
+ const builder = (factory as any)[method]('/test');
392
+ const endpoint = builder.handle(async () => ({}));
393
+
394
+ expect(endpoint.method).toBe(httpMethod);
395
+ expect(endpoint.route).toBe('/test');
396
+ });
397
+ });
398
+
399
+ it('should apply basePath to all HTTP methods', () => {
400
+ const factory = new EndpointFactory().route('/api/v1');
401
+
402
+ testMethods.forEach(({ method, httpMethod }) => {
403
+ const builder = (factory as any)[method]('/test');
404
+ const endpoint = builder.handle(async () => ({}));
405
+
406
+ expect(endpoint.method).toBe(httpMethod);
407
+ expect(endpoint.route).toBe('/api/v1/test');
408
+ });
409
+ });
410
+ });
411
+
412
+ describe('constructor options', () => {
413
+ it('should initialize with all options', () => {
414
+ const authFn = async () => true;
415
+ const sessionFn = async () => ({ userId: '123' });
416
+ const logger: Logger = new ConsoleLogger();
417
+
418
+ const TestService = {
419
+ serviceName: 'TestService' as const,
420
+ async register() {
421
+ return {};
422
+ },
423
+ };
424
+
425
+ const factory = new EndpointFactory({
426
+ basePath: '/api',
427
+ defaultServices: [TestService],
428
+ defaultAuthorizeFn: authFn,
429
+ defaultLogger: logger,
430
+ defaultSessionExtractor: sessionFn,
431
+ });
432
+
433
+ const endpoint = factory.get('/test').handle(async () => ({}));
434
+
435
+ expect(endpoint.route).toBe('/api/test');
436
+ expect(endpoint.authorize).toBe(authFn);
437
+ expect(endpoint.getSession).toBe(sessionFn);
438
+ expect(endpoint.logger).toBe(logger);
439
+ expect(endpoint.services).toEqual([TestService]);
440
+ });
441
+
442
+ it('should handle empty options', () => {
443
+ const factory = new EndpointFactory({});
444
+ const endpoint = factory.get('/test').handle(async () => ({}));
445
+
446
+ expect(endpoint.route).toBe('/test');
447
+ expect(endpoint.services).toEqual([]);
448
+ });
449
+ });
450
+
451
+ describe('type safety', () => {
452
+ it('should maintain type information through chains', () => {
453
+ const TypedService = {
454
+ serviceName: 'TypedService' as const,
455
+ async register() {
456
+ return { getData: () => ({ value: 42 }) };
457
+ },
458
+ };
459
+
460
+ const factory = new EndpointFactory()
461
+ .services([TypedService])
462
+ .session(async () => ({ userId: '123' }));
463
+
464
+ const endpoint = factory
465
+ .post('/data')
466
+ .body(z.object({ input: z.number() }))
467
+ .output(z.object({ result: z.number() }))
468
+ .handle(async ({ body, services }) => ({
469
+ result:
470
+ body.input +
471
+ (await services[TypedService.serviceName]).getData().value,
472
+ }));
473
+
474
+ // Type assertions to ensure type safety
475
+ expect(endpoint.route).toBe('/data');
476
+ expect(endpoint.method).toBe('POST');
477
+ });
478
+ });
479
+ });
@@ -0,0 +1,155 @@
1
+ import type { Service } from '@geekmidas/services';
2
+ import { describe, expect, it } from 'vitest';
3
+ import { EndpointFactory } from '../EndpointFactory';
4
+
5
+ const CacheService = {
6
+ serviceName: 'cache' as const,
7
+ async register() {
8
+ return { get: () => 'cached' };
9
+ },
10
+ } satisfies Service<'cache', any>;
11
+
12
+ const DatabaseService = {
13
+ serviceName: 'database' as const,
14
+ async register() {
15
+ return { query: () => 'result' };
16
+ },
17
+ } satisfies Service<'database', any>;
18
+
19
+ describe('EndpointFactory - State Isolation', () => {
20
+ it('should create independent endpoints with sequential factory.services() calls', () => {
21
+ const factory = new EndpointFactory();
22
+
23
+ const endpoint1 = factory
24
+ .services([CacheService, DatabaseService])
25
+ .post('/user')
26
+ .handle(() => ({}));
27
+
28
+ const endpoint2 = factory
29
+ .services([CacheService])
30
+ .get('/user')
31
+ .handle(() => ({}));
32
+
33
+ expect(endpoint1.services.map((s) => s.serviceName)).toEqual([
34
+ 'cache',
35
+ 'database',
36
+ ]);
37
+ expect(endpoint2.services.map((s) => s.serviceName)).toEqual(['cache']);
38
+ });
39
+
40
+ it('should create independent builders from reused factory instance', () => {
41
+ const factory = new EndpointFactory().services([
42
+ CacheService,
43
+ DatabaseService,
44
+ ]);
45
+
46
+ const builder1 = factory.post('/users');
47
+ const builder2 = factory.get('/users');
48
+
49
+ // Both should have the factory's default services
50
+ expect((builder1 as any)._services.map((s: any) => s.serviceName)).toEqual([
51
+ 'cache',
52
+ 'database',
53
+ ]);
54
+ expect((builder2 as any)._services.map((s: any) => s.serviceName)).toEqual([
55
+ 'cache',
56
+ 'database',
57
+ ]);
58
+
59
+ // But they should not share the same array reference
60
+ expect((builder1 as any)._services === (builder2 as any)._services).toBe(
61
+ false,
62
+ );
63
+ });
64
+
65
+ it('should not leak services between independent builder chains', () => {
66
+ const factory = new EndpointFactory();
67
+
68
+ const builder1 = factory.post('/api1').services([CacheService]);
69
+ const builder2 = factory.post('/api2').services([DatabaseService]);
70
+
71
+ expect((builder1 as any)._services.map((s: any) => s.serviceName)).toEqual([
72
+ 'cache',
73
+ ]);
74
+ expect((builder2 as any)._services.map((s: any) => s.serviceName)).toEqual([
75
+ 'database',
76
+ ]);
77
+ });
78
+
79
+ it('should allow builder to add services without affecting other builders', () => {
80
+ const factory = new EndpointFactory().services([CacheService]);
81
+
82
+ const endpoint1 = factory
83
+ .post('/test')
84
+ .services([DatabaseService])
85
+ .handle(() => ({}));
86
+
87
+ const endpoint2 = factory.get('/test').handle(() => ({}));
88
+
89
+ expect(endpoint1.services.map((s) => s.serviceName)).toEqual([
90
+ 'cache',
91
+ 'database',
92
+ ]);
93
+ expect(endpoint2.services.map((s) => s.serviceName)).toEqual(['cache']);
94
+ });
95
+
96
+ it('should support base router pattern with extended services', () => {
97
+ // Create a base router with default services
98
+ const r = new EndpointFactory().services([CacheService, DatabaseService]);
99
+
100
+ // Create endpoint with additional service
101
+ const getUsers = r
102
+ .services([CacheService])
103
+ .get('/users')
104
+ .handle(() => ({}));
105
+
106
+ // Create endpoint with just base services
107
+ const createUser = r.post('/users').handle(() => ({}));
108
+
109
+ // getUsers should have additional service (but deduplicated)
110
+ expect(getUsers.services.map((s) => s.serviceName)).toEqual([
111
+ 'cache',
112
+ 'database',
113
+ ]);
114
+
115
+ // createUser should only have base services
116
+ expect(createUser.services.map((s) => s.serviceName)).toEqual([
117
+ 'cache',
118
+ 'database',
119
+ ]);
120
+ });
121
+
122
+ it('should support base router pattern with truly additional services', () => {
123
+ const AdditionalService = {
124
+ serviceName: 'additional' as const,
125
+ async register() {
126
+ return { process: () => 'processed' };
127
+ },
128
+ } satisfies Service<'additional', any>;
129
+
130
+ // Create a base router with default services
131
+ const r = new EndpointFactory().services([CacheService, DatabaseService]);
132
+
133
+ // Create endpoint with additional service
134
+ const getUsers = r
135
+ .services([AdditionalService])
136
+ .get('/users')
137
+ .handle(() => ({}));
138
+
139
+ // Create endpoint with just base services
140
+ const createUser = r.post('/users').handle(() => ({}));
141
+
142
+ // getUsers should have all three services
143
+ expect(getUsers.services.map((s) => s.serviceName)).toEqual([
144
+ 'additional',
145
+ 'cache',
146
+ 'database',
147
+ ]);
148
+
149
+ // createUser should only have base services
150
+ expect(createUser.services.map((s) => s.serviceName)).toEqual([
151
+ 'cache',
152
+ 'database',
153
+ ]);
154
+ });
155
+ });