@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,704 @@
1
+ import type { EventPublisher, PublishableMessage } from '@geekmidas/events';
2
+ import type { Service, ServiceRegisterOptions } from '@geekmidas/services';
3
+ import { describe, expect, it } from 'vitest';
4
+ import { z } from 'zod/v4';
5
+ import { sniffService } from '../Construct';
6
+ import { c } from '../crons';
7
+ import { e } from '../endpoints';
8
+ import { f } from '../functions';
9
+ import { s } from '../subscribers';
10
+
11
+ describe('Construct environment getter', () => {
12
+ describe('Function', () => {
13
+ it('should return empty array when no services are provided', async () => {
14
+ const fn = f.handle(async () => ({ success: true }));
15
+
16
+ expect(await fn.getEnvironment()).toEqual([]);
17
+ });
18
+
19
+ it('should detect environment variables from a single service', async () => {
20
+ const databaseService = {
21
+ serviceName: 'database' as const,
22
+ register({ envParser }) {
23
+ return envParser.create((get) => ({
24
+ url: get('DATABASE_URL').string(),
25
+ port: get('DATABASE_PORT').string().transform(Number).default(5432),
26
+ }));
27
+ },
28
+ } satisfies Service<'database', any>;
29
+
30
+ const fn = f
31
+ .services([databaseService])
32
+ .handle(async () => ({ success: true }));
33
+
34
+ const envVars = await fn.getEnvironment();
35
+
36
+ expect(envVars).toEqual(['DATABASE_PORT', 'DATABASE_URL']);
37
+ });
38
+
39
+ it('should detect environment variables from multiple services', async () => {
40
+ const databaseService = {
41
+ serviceName: 'database' as const,
42
+ register({ envParser }) {
43
+ return envParser.create((get) => ({
44
+ url: get('DATABASE_URL').string(),
45
+ }));
46
+ },
47
+ } satisfies Service<'database', any>;
48
+
49
+ const redisService = {
50
+ serviceName: 'redis' as const,
51
+ register({ envParser }) {
52
+ return envParser.create((get) => ({
53
+ url: get('REDIS_URL').string(),
54
+ ttl: get('REDIS_TTL').string().transform(Number).default(3600),
55
+ }));
56
+ },
57
+ } satisfies Service<'redis', any>;
58
+
59
+ const fn = f
60
+ .services([databaseService, redisService])
61
+ .handle(async () => ({ success: true }));
62
+
63
+ const envVars = await fn.getEnvironment();
64
+
65
+ expect(envVars).toEqual(['DATABASE_URL', 'REDIS_TTL', 'REDIS_URL']);
66
+ });
67
+
68
+ it('should deduplicate environment variables across services', async () => {
69
+ const service1 = {
70
+ serviceName: 'service1' as const,
71
+ register({ envParser }) {
72
+ return envParser.create((get) => ({
73
+ apiKey: get('SHARED_API_KEY').string(),
74
+ }));
75
+ },
76
+ } satisfies Service<'service1', any>;
77
+
78
+ const service2 = {
79
+ serviceName: 'service2' as const,
80
+ register({ envParser }) {
81
+ return envParser.create((get) => ({
82
+ apiKey: get('SHARED_API_KEY').string(),
83
+ }));
84
+ },
85
+ } satisfies Service<'service2', any>;
86
+
87
+ const fn = f
88
+ .services([service1, service2])
89
+ .handle(async () => ({ success: true }));
90
+
91
+ const envVars = await fn.getEnvironment();
92
+
93
+ // Should only appear once despite being used in both services
94
+ expect(envVars).toEqual(['SHARED_API_KEY']);
95
+ });
96
+
97
+ it('should handle services with nested configuration', async () => {
98
+ const configService = {
99
+ serviceName: 'config' as const,
100
+ register({ envParser }) {
101
+ return envParser.create((get) => ({
102
+ database: {
103
+ host: get('DB_HOST').string(),
104
+ port: get('DB_PORT').string().transform(Number),
105
+ },
106
+ api: {
107
+ key: get('API_KEY').string(),
108
+ url: get('API_URL').string().url(),
109
+ },
110
+ }));
111
+ },
112
+ } satisfies Service<'config', any>;
113
+
114
+ const fn = f
115
+ .services([configService])
116
+ .handle(async () => ({ success: true }));
117
+
118
+ const envVars = await fn.getEnvironment();
119
+
120
+ expect(envVars).toEqual(['API_KEY', 'API_URL', 'DB_HOST', 'DB_PORT']);
121
+ });
122
+
123
+ it('should handle services that return non-ConfigParser values', async () => {
124
+ const simpleService = {
125
+ serviceName: 'simple' as const,
126
+ register(_options: ServiceRegisterOptions) {
127
+ // This service doesn't use envParser - just returns a plain object
128
+ return { value: 'test' };
129
+ },
130
+ } satisfies Service<'simple', any>;
131
+
132
+ const databaseService = {
133
+ serviceName: 'database' as const,
134
+ register({ envParser }) {
135
+ return envParser.create((get) => ({
136
+ url: get('DATABASE_URL').string(),
137
+ }));
138
+ },
139
+ } satisfies Service<'database', any>;
140
+
141
+ const fn = f
142
+ .services([simpleService, databaseService])
143
+ .handle(async () => ({ success: true }));
144
+
145
+ const envVars = await fn.getEnvironment();
146
+
147
+ // Should only include env vars from databaseService
148
+ expect(envVars).toEqual(['DATABASE_URL']);
149
+ });
150
+ });
151
+
152
+ describe('Endpoint', () => {
153
+ it('should detect environment variables from endpoint services', async () => {
154
+ const authService = {
155
+ serviceName: 'auth' as const,
156
+ register({ envParser }) {
157
+ return envParser.create((get) => ({
158
+ secret: get('JWT_SECRET').string(),
159
+ expiresIn: get('JWT_EXPIRES_IN').string().default('15m'),
160
+ }));
161
+ },
162
+ } satisfies Service<'auth', any>;
163
+
164
+ const endpoint = e
165
+ .services([authService])
166
+ .get('/users')
167
+ .handle(async () => []);
168
+
169
+ const envVars = await endpoint.getEnvironment();
170
+
171
+ expect(envVars).toEqual(['JWT_EXPIRES_IN', 'JWT_SECRET']);
172
+ });
173
+
174
+ it('should work with different HTTP methods', async () => {
175
+ const storageService = {
176
+ serviceName: 'storage' as const,
177
+ register({ envParser }) {
178
+ return envParser.create((get) => ({
179
+ bucket: get('S3_BUCKET').string(),
180
+ region: get('AWS_REGION').string().default('us-east-1'),
181
+ }));
182
+ },
183
+ } satisfies Service<'storage', any>;
184
+
185
+ const postEndpoint = e
186
+ .services([storageService])
187
+ .post('/upload')
188
+ .handle(async () => ({ success: true }));
189
+
190
+ const getEndpoint = e
191
+ .services([storageService])
192
+ .get('/files')
193
+ .handle(async () => []);
194
+
195
+ expect(await postEndpoint.getEnvironment()).toEqual([
196
+ 'AWS_REGION',
197
+ 'S3_BUCKET',
198
+ ]);
199
+ expect(await getEndpoint.getEnvironment()).toEqual([
200
+ 'AWS_REGION',
201
+ 'S3_BUCKET',
202
+ ]);
203
+ });
204
+ });
205
+
206
+ describe('Cron', () => {
207
+ it('should detect environment variables from cron services', async () => {
208
+ const emailService = {
209
+ serviceName: 'email' as const,
210
+ register({ envParser }) {
211
+ return envParser.create((get) => ({
212
+ smtpHost: get('SMTP_HOST').string(),
213
+ smtpPort: get('SMTP_PORT').string().transform(Number).default(587),
214
+ smtpUser: get('SMTP_USER').string(),
215
+ smtpPass: get('SMTP_PASS').string(),
216
+ }));
217
+ },
218
+ } satisfies Service<'email', any>;
219
+
220
+ const cronJob = c
221
+ .services([emailService])
222
+ .schedule('rate(1 hour)')
223
+ .handle(async () => {
224
+ // Send daily report email
225
+ });
226
+
227
+ const envVars = await cronJob.getEnvironment();
228
+
229
+ expect(envVars).toEqual([
230
+ 'SMTP_HOST',
231
+ 'SMTP_PASS',
232
+ 'SMTP_PORT',
233
+ 'SMTP_USER',
234
+ ]);
235
+ });
236
+ });
237
+
238
+ describe('Subscriber', () => {
239
+ it('should detect environment variables from subscriber services', async () => {
240
+ type UserEvents =
241
+ | PublishableMessage<'user.created', { userId: string }>
242
+ | PublishableMessage<'user.updated', { userId: string }>;
243
+
244
+ class UserEventPublisher implements EventPublisher<UserEvents> {
245
+ async publish(_events: UserEvents[]): Promise<void> {}
246
+ }
247
+
248
+ const eventPublisherService: Service<'events', UserEventPublisher> = {
249
+ serviceName: 'events' as const,
250
+ register() {
251
+ return new UserEventPublisher();
252
+ },
253
+ };
254
+
255
+ const notificationService = {
256
+ serviceName: 'notification' as const,
257
+ register({ envParser }) {
258
+ return envParser
259
+ .create((get) => ({
260
+ apiKey: get('NOTIFICATION_API_KEY').string(),
261
+ endpoint: get('NOTIFICATION_ENDPOINT')
262
+ .string()
263
+ .url()
264
+ .default('https://api.example.com/notify'),
265
+ }))
266
+ .parse();
267
+ },
268
+ } satisfies Service<'notification', any>;
269
+
270
+ const subscriber = s
271
+ .publisher(eventPublisherService)
272
+ .services([notificationService])
273
+ .subscribe('user.created')
274
+ .handle(async () => {
275
+ // Handle user created events
276
+ });
277
+
278
+ const envVars = await subscriber.getEnvironment();
279
+
280
+ expect(envVars).toEqual([
281
+ 'NOTIFICATION_API_KEY',
282
+ 'NOTIFICATION_ENDPOINT',
283
+ ]);
284
+ });
285
+ });
286
+
287
+ describe('Edge cases', () => {
288
+ it('should return empty array when services array is empty', async () => {
289
+ const fn = f.services([]).handle(async () => ({ success: true }));
290
+
291
+ expect(await fn.getEnvironment()).toEqual([]);
292
+ });
293
+
294
+ it('should handle service with optional environment variables', async () => {
295
+ const optionalConfigService = {
296
+ serviceName: 'optionalConfig' as const,
297
+ register({ envParser }) {
298
+ return envParser.create((get) => ({
299
+ required: get('REQUIRED_VAR').string(),
300
+ optional1: get('OPTIONAL_VAR_1').string().optional(),
301
+ optional2: get('OPTIONAL_VAR_2').string().optional(),
302
+ }));
303
+ },
304
+ } satisfies Service<'optionalConfig', any>;
305
+
306
+ const fn = f
307
+ .services([optionalConfigService])
308
+ .handle(async () => ({ success: true }));
309
+
310
+ const envVars = await fn.getEnvironment();
311
+
312
+ // Should include both required and optional variables
313
+ expect(envVars).toEqual([
314
+ 'OPTIONAL_VAR_1',
315
+ 'OPTIONAL_VAR_2',
316
+ 'REQUIRED_VAR',
317
+ ]);
318
+ });
319
+
320
+ it('should be callable multiple times with consistent results', async () => {
321
+ const service = {
322
+ serviceName: 'testService' as const,
323
+ register({ envParser }) {
324
+ return envParser.create((get) => ({
325
+ var1: get('VAR_1').string(),
326
+ var2: get('VAR_2').string(),
327
+ }));
328
+ },
329
+ } satisfies Service<'testService', any>;
330
+
331
+ const fn = f.services([service]).handle(async () => ({ success: true }));
332
+
333
+ const firstCall = await fn.getEnvironment();
334
+ const secondCall = await fn.getEnvironment();
335
+ const thirdCall = await fn.getEnvironment();
336
+
337
+ expect(firstCall).toEqual(['VAR_1', 'VAR_2']);
338
+ expect(secondCall).toEqual(['VAR_1', 'VAR_2']);
339
+ expect(thirdCall).toEqual(['VAR_1', 'VAR_2']);
340
+ });
341
+
342
+ it('should handle services with complex transformations', async () => {
343
+ const complexService = {
344
+ serviceName: 'complex' as const,
345
+ register({ envParser }) {
346
+ return envParser.create((get) => ({
347
+ origins: get('ALLOWED_ORIGINS')
348
+ .string()
349
+ .transform((v) => v.split(',')),
350
+ flags: get('FEATURE_FLAGS')
351
+ .string()
352
+ .transform((v) => v.split(',').map((f) => f.trim())),
353
+ config: get('JSON_CONFIG')
354
+ .string()
355
+ .transform((v) => JSON.parse(v))
356
+ .pipe(z.record(z.string(), z.boolean())),
357
+ }));
358
+ },
359
+ } satisfies Service<'complex', any>;
360
+
361
+ const fn = f
362
+ .services([complexService])
363
+ .handle(async () => ({ success: true }));
364
+
365
+ const envVars = await fn.getEnvironment();
366
+
367
+ expect(envVars).toEqual([
368
+ 'ALLOWED_ORIGINS',
369
+ 'FEATURE_FLAGS',
370
+ 'JSON_CONFIG',
371
+ ]);
372
+ });
373
+
374
+ it('should handle services that throw synchronous errors during registration', async () => {
375
+ const throwingService = {
376
+ serviceName: 'throwing' as const,
377
+ register({ envParser }) {
378
+ const config = envParser
379
+ .create((get) => ({
380
+ url: get('SERVICE_URL').string(),
381
+ }))
382
+ .parse();
383
+
384
+ // Simulate a library that validates config immediately
385
+ // Sniffer returns '' for strings, so this will throw
386
+ if (!config.url || config.url === '') {
387
+ throw new Error('Invalid URL provided');
388
+ }
389
+
390
+ return { url: config.url };
391
+ },
392
+ } satisfies Service<'throwing', any>;
393
+
394
+ // Verify env vars are captured even when service throws
395
+ const result = await sniffService(throwingService);
396
+ expect(result.envVars).toEqual(['SERVICE_URL']);
397
+ expect(result.error).toBeDefined();
398
+ expect(result.error?.message).toBe('Invalid URL provided');
399
+
400
+ // Also verify it works in a construct context with multiple services
401
+ const workingService = {
402
+ serviceName: 'working' as const,
403
+ register({ envParser }) {
404
+ return envParser
405
+ .create((get) => ({
406
+ key: get('API_KEY').string(),
407
+ }))
408
+ .parse();
409
+ },
410
+ } satisfies Service<'working', any>;
411
+
412
+ const fn = f
413
+ .services([throwingService, workingService])
414
+ .handle(async () => ({ success: true }));
415
+
416
+ const envVars = await fn.getEnvironment();
417
+ expect(envVars).toEqual(['API_KEY', 'SERVICE_URL']);
418
+ });
419
+
420
+ it('should handle services that return rejecting promises', async () => {
421
+ const asyncThrowingService = {
422
+ serviceName: 'asyncThrowing' as const,
423
+ async register({ envParser }) {
424
+ const config = envParser
425
+ .create((get) => ({
426
+ secret: get('AUTH_SECRET').string(),
427
+ frontendUrl: get('FRONTEND_URL').string(),
428
+ }))
429
+ .parse();
430
+
431
+ // Simulate an async library that validates config
432
+ await Promise.resolve();
433
+ if (!config.frontendUrl) {
434
+ throw new Error('Frontend URL is required');
435
+ }
436
+
437
+ return { config };
438
+ },
439
+ } satisfies Service<'asyncThrowing', any>;
440
+
441
+ // Verify env vars are captured even when service rejects
442
+ const result = await sniffService(asyncThrowingService);
443
+ expect(result.envVars).toEqual(['AUTH_SECRET', 'FRONTEND_URL']);
444
+ expect(result.error).toBeDefined();
445
+ expect(result.error?.message).toBe('Frontend URL is required');
446
+
447
+ // Also verify via construct
448
+ const fn = f
449
+ .services([asyncThrowingService])
450
+ .handle(async () => ({ success: true }));
451
+
452
+ const envVars = await fn.getEnvironment();
453
+ expect(envVars).toEqual(['AUTH_SECRET', 'FRONTEND_URL']);
454
+ });
455
+
456
+ it('should handle services that create fire-and-forget rejecting promises (BetterAuth scenario)', async () => {
457
+ // This test uses the REAL better-auth library to verify that
458
+ // the sniffer gracefully handles libraries that create internal
459
+ // fire-and-forget promises which reject on invalid config
460
+ const { betterAuth } = await import('better-auth');
461
+
462
+ const betterAuthService = {
463
+ serviceName: 'auth' as const,
464
+ register({ envParser }) {
465
+ const config = envParser
466
+ .create((get) => ({
467
+ secret: get('BETTER_AUTH_SECRET').string(),
468
+ baseURL: get('BETTER_AUTH_URL').string(),
469
+ trustedOrigins: get('BETTER_AUTH_TRUSTED_ORIGINS').string(),
470
+ }))
471
+ .parse();
472
+
473
+ // When sniffer runs, config values are empty strings
474
+ // BetterAuth will create fire-and-forget promises that reject
475
+ // when it tries to validate trustedOrigins with new URL('')
476
+ const auth = betterAuth({
477
+ secret: config.secret,
478
+ baseURL: config.baseURL,
479
+ trustedOrigins: config.trustedOrigins
480
+ ? config.trustedOrigins.split(',')
481
+ : [],
482
+ database: {
483
+ // Use memory adapter to avoid DB setup
484
+ type: 'sqlite',
485
+ url: ':memory:',
486
+ },
487
+ });
488
+
489
+ return auth;
490
+ },
491
+ } satisfies Service<'auth', any>;
492
+
493
+ // Verify env vars are captured even though BetterAuth's internal
494
+ // fire-and-forget promise will reject on invalid trustedOrigins
495
+ const result = await sniffService(betterAuthService);
496
+ expect(result.envVars).toEqual([
497
+ 'BETTER_AUTH_SECRET',
498
+ 'BETTER_AUTH_TRUSTED_ORIGINS',
499
+ 'BETTER_AUTH_URL',
500
+ ]);
501
+ // Synchronous registration succeeds
502
+ expect(result.error).toBeUndefined();
503
+ // But fire-and-forget rejections are captured from better-auth
504
+ expect(result.unhandledRejections.length).toBeGreaterThan(0);
505
+ // Log the actual errors for debugging visibility
506
+ console.log(
507
+ 'Captured better-auth unhandled rejections:',
508
+ result.unhandledRejections.map((e) => e.message),
509
+ );
510
+
511
+ // Most importantly: the process should NOT crash from unhandled rejection
512
+ const fn = f
513
+ .services([betterAuthService])
514
+ .handle(async () => ({ success: true }));
515
+
516
+ const envVars = await fn.getEnvironment();
517
+ expect(envVars).toEqual([
518
+ 'BETTER_AUTH_SECRET',
519
+ 'BETTER_AUTH_TRUSTED_ORIGINS',
520
+ 'BETTER_AUTH_URL',
521
+ ]);
522
+ });
523
+
524
+ it('should handle multiple problematic services without crashing', async () => {
525
+ const service1 = {
526
+ serviceName: 'service1' as const,
527
+ register({ envParser }) {
528
+ envParser.create((get) => ({
529
+ var1: get('VAR_1').string(),
530
+ }));
531
+ throw new Error('Service 1 failed');
532
+ },
533
+ } satisfies Service<'service1', any>;
534
+
535
+ const service2 = {
536
+ serviceName: 'service2' as const,
537
+ register({ envParser }) {
538
+ const config = envParser.create((get) => ({
539
+ var2: get('VAR_2').string(),
540
+ }));
541
+
542
+ // Fire-and-forget rejection
543
+ Promise.reject(new Error('Service 2 async error'));
544
+
545
+ return config;
546
+ },
547
+ } satisfies Service<'service2', any>;
548
+
549
+ const service3 = {
550
+ serviceName: 'service3' as const,
551
+ register({ envParser }) {
552
+ return envParser.create((get) => ({
553
+ var3: get('VAR_3').string(),
554
+ }));
555
+ },
556
+ } satisfies Service<'service3', any>;
557
+
558
+ // Verify individual services
559
+ const result1 = await sniffService(service1);
560
+ expect(result1.envVars).toEqual(['VAR_1']);
561
+ expect(result1.error?.message).toBe('Service 1 failed');
562
+
563
+ const result2 = await sniffService(service2);
564
+ expect(result2.envVars).toEqual(['VAR_2']);
565
+ // Fire-and-forget - no error captured
566
+ expect(result2.error).toBeUndefined();
567
+
568
+ const result3 = await sniffService(service3);
569
+ expect(result3.envVars).toEqual(['VAR_3']);
570
+ expect(result3.error).toBeUndefined();
571
+
572
+ // Verify all work together in construct
573
+ const fn = f
574
+ .services([service1, service2, service3])
575
+ .handle(async () => ({ success: true }));
576
+
577
+ const envVars = await fn.getEnvironment();
578
+ expect(envVars).toEqual(['VAR_1', 'VAR_2', 'VAR_3']);
579
+ });
580
+ });
581
+
582
+ describe('markOptional option', () => {
583
+ const dbService = {
584
+ serviceName: 'db' as const,
585
+ register({ envParser }) {
586
+ return envParser
587
+ .create((get) => ({
588
+ url: get('DATABASE_URL').string(),
589
+ pool: get('DB_POOL_SIZE').string().transform(Number).default(10),
590
+ }))
591
+ .parse();
592
+ },
593
+ } satisfies Service<'db', any>;
594
+
595
+ const authService = {
596
+ serviceName: 'auth' as const,
597
+ register({ envParser }) {
598
+ return envParser
599
+ .create((get) => ({
600
+ secret: get('JWT_SECRET').string(),
601
+ ttl: get('JWT_TTL').string().optional(),
602
+ }))
603
+ .parse();
604
+ },
605
+ } satisfies Service<'auth', any>;
606
+
607
+ it('returns plain var names when markOptional is false (default)', async () => {
608
+ const fn = f
609
+ .services([dbService])
610
+ .handle(async () => ({ success: true }));
611
+
612
+ expect(await fn.getEnvironment()).toEqual([
613
+ 'DATABASE_URL',
614
+ 'DB_POOL_SIZE',
615
+ ]);
616
+ expect(await fn.getEnvironment({ markOptional: false })).toEqual([
617
+ 'DATABASE_URL',
618
+ 'DB_POOL_SIZE',
619
+ ]);
620
+ });
621
+
622
+ it('suffixes optional vars with ? when markOptional is true', async () => {
623
+ const fn = f
624
+ .services([dbService])
625
+ .handle(async () => ({ success: true }));
626
+
627
+ expect(await fn.getEnvironment({ markOptional: true })).toEqual([
628
+ 'DATABASE_URL',
629
+ 'DB_POOL_SIZE?',
630
+ ]);
631
+ });
632
+
633
+ it('marks vars with .optional() as optional', async () => {
634
+ const fn = f
635
+ .services([authService])
636
+ .handle(async () => ({ success: true }));
637
+
638
+ expect(await fn.getEnvironment({ markOptional: true })).toEqual([
639
+ 'JWT_SECRET',
640
+ 'JWT_TTL?',
641
+ ]);
642
+ });
643
+
644
+ it('marks optional vars across multiple services', async () => {
645
+ const fn = f
646
+ .services([dbService, authService])
647
+ .handle(async () => ({ success: true }));
648
+
649
+ expect(await fn.getEnvironment({ markOptional: true })).toEqual([
650
+ 'DATABASE_URL',
651
+ 'DB_POOL_SIZE?',
652
+ 'JWT_SECRET',
653
+ 'JWT_TTL?',
654
+ ]);
655
+ });
656
+
657
+ it('works on Endpoint constructs', async () => {
658
+ const endpoint = e
659
+ .services([dbService])
660
+ .get('/users')
661
+ .handle(async () => []);
662
+
663
+ expect(await endpoint.getEnvironment({ markOptional: true })).toEqual([
664
+ 'DATABASE_URL',
665
+ 'DB_POOL_SIZE?',
666
+ ]);
667
+ });
668
+
669
+ it('works on Cron constructs', async () => {
670
+ const cron = c
671
+ .schedule('rate(1 hour)')
672
+ .services([authService])
673
+ .handle(async () => {});
674
+
675
+ expect(await cron.getEnvironment({ markOptional: true })).toEqual([
676
+ 'JWT_SECRET',
677
+ 'JWT_TTL?',
678
+ ]);
679
+ });
680
+
681
+ it('required-only vars have no ? suffix', async () => {
682
+ const requiredOnly = {
683
+ serviceName: 'required' as const,
684
+ register({ envParser }) {
685
+ return envParser
686
+ .create((get) => ({
687
+ a: get('VAR_A').string(),
688
+ b: get('VAR_B').string(),
689
+ }))
690
+ .parse();
691
+ },
692
+ } satisfies Service<'required', any>;
693
+
694
+ const fn = f
695
+ .services([requiredOnly])
696
+ .handle(async () => ({ success: true }));
697
+
698
+ expect(await fn.getEnvironment({ markOptional: true })).toEqual([
699
+ 'VAR_A',
700
+ 'VAR_B',
701
+ ]);
702
+ });
703
+ });
704
+ });