@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.
- package/CHANGELOG.md +437 -0
- package/README.md +193 -285
- package/dist/AWSScheduledFunction-BzGCUbkk.d.mts +117 -0
- package/dist/AWSScheduledFunction-BzGCUbkk.d.mts.map +1 -0
- package/dist/AWSScheduledFunction-C42adp8A.cjs +266 -0
- package/dist/AWSScheduledFunction-C42adp8A.cjs.map +1 -0
- package/dist/AWSScheduledFunction-CsNJhXQj.d.cts +117 -0
- package/dist/AWSScheduledFunction-CsNJhXQj.d.cts.map +1 -0
- package/dist/AWSScheduledFunction-KP6lqbsW.mjs +254 -0
- package/dist/AWSScheduledFunction-KP6lqbsW.mjs.map +1 -0
- package/dist/{Construct-B1vGBPme.mjs → Construct-BWF5HxaM.mjs} +37 -47
- package/dist/Construct-BWF5HxaM.mjs.map +1 -0
- package/dist/Construct-JlyQkBkv.d.cts +117 -0
- package/dist/Construct-JlyQkBkv.d.cts.map +1 -0
- package/dist/{Construct-DUSXuTHP.cjs → Construct-TGIM_E4o.cjs} +88 -67
- package/dist/Construct-TGIM_E4o.cjs.map +1 -0
- package/dist/Construct-pxwC6fDD.d.mts +117 -0
- package/dist/Construct-pxwC6fDD.d.mts.map +1 -0
- package/dist/{Endpoint-Du-NwPX2.d.mts → Endpoint-B0P_pEMr.d.mts} +85 -126
- package/dist/Endpoint-B0P_pEMr.d.mts.map +1 -0
- package/dist/{Endpoint-aCvBMPoH.d.cts → Endpoint-BLZ7r67m.d.cts} +84 -125
- package/dist/Endpoint-BLZ7r67m.d.cts.map +1 -0
- package/dist/{HonoEndpointAdaptor-PtPlbeKY.mjs → HonoEndpointAdaptor-BMVwx2cz.mjs} +69 -81
- package/dist/HonoEndpointAdaptor-BMVwx2cz.mjs.map +1 -0
- package/dist/{HonoEndpointAdaptor-zVzVLJEO.cjs → HonoEndpointAdaptor-DPDsDi-D.cjs} +77 -92
- package/dist/HonoEndpointAdaptor-DPDsDi-D.cjs.map +1 -0
- package/dist/Queue-BL68oDJ-.d.mts +66 -0
- package/dist/Queue-BL68oDJ-.d.mts.map +1 -0
- package/dist/Queue-DxJ6btRE.d.cts +66 -0
- package/dist/Queue-DxJ6btRE.d.cts.map +1 -0
- package/dist/Subscriber-BpVhcGhX.d.cts +47 -0
- package/dist/Subscriber-BpVhcGhX.d.cts.map +1 -0
- package/dist/Subscriber-DF6xsBAJ.d.mts +47 -0
- package/dist/Subscriber-DF6xsBAJ.d.mts.map +1 -0
- package/dist/Topic-DJXoDeMP.d.cts +60 -0
- package/dist/Topic-DJXoDeMP.d.cts.map +1 -0
- package/dist/Topic-DxWQBgMN.d.mts +60 -0
- package/dist/Topic-DxWQBgMN.d.mts.map +1 -0
- package/dist/adaptors/aws.cjs +205 -355
- package/dist/adaptors/aws.cjs.map +1 -1
- package/dist/adaptors/aws.d.cts +48 -126
- package/dist/adaptors/aws.d.cts.map +1 -1
- package/dist/adaptors/aws.d.mts +49 -127
- package/dist/adaptors/aws.d.mts.map +1 -1
- package/dist/adaptors/aws.mjs +178 -325
- package/dist/adaptors/aws.mjs.map +1 -1
- package/dist/adaptors/hono.cjs +9 -3
- package/dist/adaptors/hono.d.cts +15 -7
- package/dist/adaptors/hono.d.cts.map +1 -1
- package/dist/adaptors/hono.d.mts +17 -9
- package/dist/adaptors/hono.d.mts.map +1 -1
- package/dist/adaptors/hono.mjs +9 -2
- package/dist/adaptors/testing.cjs +209 -831
- package/dist/adaptors/testing.cjs.map +1 -1
- package/dist/adaptors/testing.d.cts +55 -351
- package/dist/adaptors/testing.d.cts.map +1 -1
- package/dist/adaptors/testing.d.mts +53 -349
- package/dist/adaptors/testing.d.mts.map +1 -1
- package/dist/adaptors/testing.mjs +195 -798
- package/dist/adaptors/testing.mjs.map +1 -1
- package/dist/{clone-UGJpvQnL.cjs → clone-I_WIpiFf.cjs} +8 -7
- package/dist/clone-I_WIpiFf.cjs.map +1 -0
- package/dist/{clone-EKNovYHu.mjs → clone-pdXxc0t3.mjs} +3 -3
- package/dist/clone-pdXxc0t3.mjs.map +1 -0
- package/dist/crons/index.cjs +66 -190
- package/dist/crons/index.cjs.map +1 -1
- package/dist/crons/index.d.cts +35 -70
- package/dist/crons/index.d.cts.map +1 -1
- package/dist/crons/index.d.mts +32 -70
- package/dist/crons/index.d.mts.map +1 -1
- package/dist/crons/index.mjs +63 -184
- package/dist/crons/index.mjs.map +1 -1
- package/dist/endpoints/index.cjs +761 -19
- package/dist/endpoints/index.cjs.map +1 -0
- package/dist/endpoints/index.d.cts +322 -22
- package/dist/endpoints/index.d.cts.map +1 -1
- package/dist/endpoints/index.d.mts +321 -22
- package/dist/endpoints/index.d.mts.map +1 -1
- package/dist/endpoints/index.mjs +751 -6
- package/dist/endpoints/index.mjs.map +1 -0
- package/dist/functions/index.cjs +5 -2
- package/dist/functions/index.d.cts +3 -3
- package/dist/functions/index.d.mts +3 -3
- package/dist/functions/index.mjs +5 -2
- package/dist/{functions-BFizikJU.mjs → functions-EqTloHjo.mjs} +331 -425
- package/dist/functions-EqTloHjo.mjs.map +1 -0
- package/dist/{functions-CfzJG9hK.cjs → functions-SqtCDc9c.cjs} +370 -459
- package/dist/functions-SqtCDc9c.cjs.map +1 -0
- package/dist/index-C7iynzLI.d.mts +139 -0
- package/dist/index-C7iynzLI.d.mts.map +1 -0
- package/dist/index-D4dM_WDY.d.cts +142 -0
- package/dist/index-D4dM_WDY.d.cts.map +1 -0
- package/dist/index.cjs +3 -6
- package/dist/index.d.cts +4 -27
- package/dist/index.d.mts +4 -27
- package/dist/index.mjs +3 -3
- package/dist/{Endpoint-BG4UJ9oA.mjs → lazyAccessors-CCTK19xj.mjs} +1040 -914
- package/dist/lazyAccessors-CCTK19xj.mjs.map +1 -0
- package/dist/{Endpoint-BoUg8ocM.cjs → lazyAccessors-D04oftGw.cjs} +1127 -960
- package/dist/lazyAccessors-D04oftGw.cjs.map +1 -0
- package/dist/monitors/index.cjs +49 -0
- package/dist/monitors/index.cjs.map +1 -0
- package/dist/monitors/index.d.cts +45 -0
- package/dist/monitors/index.d.cts.map +1 -0
- package/dist/monitors/index.d.mts +45 -0
- package/dist/monitors/index.d.mts.map +1 -0
- package/dist/monitors/index.mjs +48 -0
- package/dist/monitors/index.mjs.map +1 -0
- package/dist/processAudits-BJZT5gmy.cjs +92 -0
- package/dist/processAudits-BJZT5gmy.cjs.map +1 -0
- package/dist/processAudits-CwyaaSQc.mjs +80 -0
- package/dist/processAudits-CwyaaSQc.mjs.map +1 -0
- package/dist/publisher-BZgcrVPy.cjs +53 -0
- package/dist/publisher-BZgcrVPy.cjs.map +1 -0
- package/dist/publisher-CnpeMv-r.mjs +41 -0
- package/dist/publisher-CnpeMv-r.mjs.map +1 -0
- package/dist/queue/index.cjs +114 -6
- package/dist/queue/index.cjs.map +1 -0
- package/dist/queue/index.d.cts +45 -3
- package/dist/queue/index.d.cts.map +1 -0
- package/dist/queue/index.d.mts +44 -3
- package/dist/queue/index.d.mts.map +1 -0
- package/dist/queue/index.mjs +112 -3
- package/dist/queue/index.mjs.map +1 -0
- package/dist/subscribers/index.cjs +80 -111
- package/dist/subscribers/index.cjs.map +1 -1
- package/dist/subscribers/index.d.cts +43 -46
- package/dist/subscribers/index.d.cts.map +1 -1
- package/dist/subscribers/index.d.mts +42 -46
- package/dist/subscribers/index.d.mts.map +1 -1
- package/dist/subscribers/index.mjs +78 -108
- package/dist/subscribers/index.mjs.map +1 -1
- package/dist/{lambdaTelemetry-8vnmVZQ5.d.cts → telemetry-C--EgYVr.d.mts} +7 -4
- package/dist/telemetry-C--EgYVr.d.mts.map +1 -0
- package/dist/{lambdaTelemetry-8vnmVZQ5.d.mts → telemetry-Dqx-D3F7.d.cts} +7 -4
- package/dist/telemetry-Dqx-D3F7.d.cts.map +1 -0
- package/dist/topic/index.cjs +91 -3
- package/dist/topic/index.cjs.map +1 -0
- package/dist/topic/index.d.cts +32 -2
- package/dist/topic/index.d.cts.map +1 -0
- package/dist/topic/index.d.mts +32 -2
- package/dist/topic/index.d.mts.map +1 -0
- package/dist/topic/index.mjs +89 -2
- package/dist/topic/index.mjs.map +1 -0
- package/dist/{types-DMuSQeLL.d.cts → types-BdAaYDvd.d.cts} +5 -3
- package/dist/types-BdAaYDvd.d.cts.map +1 -0
- package/dist/{types-DMuSQeLL.d.mts → types-DNngH0fX.d.mts} +5 -3
- package/dist/types-DNngH0fX.d.mts.map +1 -0
- package/dist/types.d.cts +1 -1
- package/dist/types.d.mts +1 -1
- package/dist/types.mjs +0 -1
- package/package.json +55 -223
- package/src/Construct.ts +209 -0
- package/src/__benchmarks__/build-time-optimization.bench.ts +274 -0
- package/src/__benchmarks__/endpoint.bench.ts +494 -0
- package/src/__benchmarks__/fixtures.ts +241 -0
- package/src/__benchmarks__/hono-adaptor.bench.ts +533 -0
- package/src/__benchmarks__/hono-server.bench.ts +249 -0
- package/src/__benchmarks__/response-builder.bench.ts +428 -0
- package/src/__benchmarks__/strategies/strategy-a-lazy-services.ts +319 -0
- package/src/__benchmarks__/strategies/strategy-c-middleware.ts +530 -0
- package/src/__benchmarks__/strategies/strategy-d-opt-in-events.ts +567 -0
- package/src/__tests__/Construct.environment.spec.ts +704 -0
- package/src/__tests__/builder-reuse.spec.ts +587 -0
- package/src/__tests__/monitor.spec.ts +636 -0
- package/src/__tests__/publisher.setting.spec.ts +508 -0
- package/src/__tests__/publisher.spec.ts +452 -0
- package/src/adaptors/aws.ts +6 -0
- package/src/adaptors/hono.ts +1 -0
- package/src/adaptors/testing.ts +11 -0
- package/src/clone.ts +38 -0
- package/src/crons/AWSScheduledFunction.ts +73 -0
- package/src/crons/Cron.ts +149 -0
- package/src/crons/CronBuilder.ts +261 -0
- package/src/crons/__tests__/AWSScheduledFunction.spec.ts +152 -0
- package/src/crons/__tests__/Cron.spec.ts +472 -0
- package/src/crons/__tests__/CronBuilder.state-isolation.spec.ts +273 -0
- package/src/crons/index.ts +12 -0
- package/src/endpoints/AmazonApiGatewayEndpointAdaptor.ts +698 -0
- package/src/endpoints/AmazonApiGatewayV1EndpointAdaptor.ts +105 -0
- package/src/endpoints/AmazonApiGatewayV2EndpointAdaptor.ts +97 -0
- package/src/endpoints/Authorizer.ts +152 -0
- package/src/endpoints/Endpoint.ts +1287 -0
- package/src/endpoints/EndpointBuilder.ts +749 -0
- package/src/endpoints/EndpointFactory.ts +1179 -0
- package/src/endpoints/HonoEndpointAdaptor.ts +692 -0
- package/src/endpoints/MswEndpointAdaptor.ts +226 -0
- package/src/endpoints/TestEndpointAdaptor.ts +466 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.audits.spec.ts +499 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.events.spec.ts +560 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV1EndpointAdaptor.spec.ts +1304 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.audits.spec.ts +626 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.events.spec.ts +732 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.factory-publisher.spec.ts +296 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.kysely-audit.integration.spec.ts +951 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.responseType.spec.ts +111 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.rls.spec.ts +307 -0
- package/src/endpoints/__tests__/AmazonApiGatewayV2EndpointAdaptor.spec.ts +629 -0
- package/src/endpoints/__tests__/Authorizer.spec.ts +286 -0
- package/src/endpoints/__tests__/Endpoint.cookies.spec.ts +207 -0
- package/src/endpoints/__tests__/Endpoint.headers.spec.ts +187 -0
- package/src/endpoints/__tests__/Endpoint.manifest.spec.ts +175 -0
- package/src/endpoints/__tests__/Endpoint.spec.ts +857 -0
- package/src/endpoints/__tests__/EndpointBuilder.audit.spec.ts +451 -0
- package/src/endpoints/__tests__/EndpointBuilder.responseType.spec.ts +50 -0
- package/src/endpoints/__tests__/EndpointBuilder.spec.ts +531 -0
- package/src/endpoints/__tests__/EndpointFactory.authorizers.spec.ts +492 -0
- package/src/endpoints/__tests__/EndpointFactory.database-auditor.spec.ts +509 -0
- package/src/endpoints/__tests__/EndpointFactory.reference-audit.spec.ts +190 -0
- package/src/endpoints/__tests__/EndpointFactory.spec.ts +479 -0
- package/src/endpoints/__tests__/EndpointFactory.state-isolation.spec.ts +155 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.audit-transactions.spec.ts +703 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.audits.spec.ts +632 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.events.spec.ts +577 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.kysely-audit.integration.spec.ts +1067 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.openapi.spec.ts +317 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.pgboss-publisher.spec.ts +289 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.responseType.spec.ts +128 -0
- package/src/endpoints/__tests__/HonoEndpointAdaptor.spec.ts +1207 -0
- package/src/endpoints/__tests__/MswEndpointAdaptor.spec.ts +211 -0
- package/src/endpoints/__tests__/ResponseBuilder.spec.ts +235 -0
- package/src/endpoints/__tests__/TestEndpointAdaptor.audits.spec.ts +602 -0
- package/src/endpoints/__tests__/TestEndpointAdaptor.spec.ts +1044 -0
- package/src/endpoints/__tests__/__snapshots__/HonoEndpointAdaptor.spec.ts.snap +54 -0
- package/src/endpoints/__tests__/endpoint-types.test.ts +88 -0
- package/src/endpoints/__tests__/helpers.spec.ts +37 -0
- package/src/endpoints/__tests__/lazyAccessors.spec.ts +330 -0
- package/src/endpoints/__tests__/processAudits.spec.ts +631 -0
- package/src/endpoints/audit.ts +87 -0
- package/src/endpoints/helpers.ts +98 -0
- package/src/endpoints/index.ts +42 -0
- package/src/endpoints/lazyAccessors.ts +241 -0
- package/src/endpoints/parseHonoQuery.ts +16 -0
- package/src/endpoints/parseQueryParams.ts +32 -0
- package/src/endpoints/processAudits.ts +371 -0
- package/src/endpoints/rls.ts +67 -0
- package/src/functions/AWSLambdaFunction.ts +374 -0
- package/src/functions/BaseFunctionBuilder.ts +212 -0
- package/src/functions/Function.ts +238 -0
- package/src/functions/FunctionBuilder.ts +381 -0
- package/src/functions/FunctionExecutionWrapper.ts +216 -0
- package/src/functions/TestFunctionAdaptor.ts +252 -0
- package/src/functions/__tests__/AWSLambdaFunctionAdaptor.spec.ts +513 -0
- package/src/functions/__tests__/Function.audits.spec.ts +393 -0
- package/src/functions/__tests__/Function.spec.ts +477 -0
- package/src/functions/__tests__/FunctionBuilder.state-isolation.spec.ts +250 -0
- package/src/functions/__tests__/TestFunctionAdaptor.spec.ts +480 -0
- package/src/functions/index.ts +12 -0
- package/src/index.ts +29 -0
- package/src/monitor.ts +145 -0
- package/src/monitors/heartbeat.ts +86 -0
- package/src/monitors/index.ts +6 -0
- package/src/publisher.ts +93 -0
- package/src/queue/AWSLambdaQueueAdaptor.ts +162 -0
- package/src/queue/Queue.ts +128 -0
- package/src/queue/QueueBuilder.ts +115 -0
- package/src/queue/TestQueueAdaptor.ts +63 -0
- package/src/queue/__tests__/QueueBuilder.spec.ts +137 -0
- package/src/queue/index.ts +12 -0
- package/src/subscribers/AWSLambdaSubscriberAdaptor.ts +342 -0
- package/src/subscribers/Subscriber.ts +117 -0
- package/src/subscribers/SubscriberBuilder.ts +183 -0
- package/src/subscribers/TestSubscriberAdaptor.ts +133 -0
- package/src/subscribers/__tests__/AWSLambdaSubscriberAdaptor.spec.ts +1018 -0
- package/src/subscribers/__tests__/Subscriber.spec.ts +430 -0
- package/src/subscribers/__tests__/TestSubscriberAdaptor.spec.ts +652 -0
- package/src/subscribers/index.ts +6 -0
- package/src/telemetry.ts +103 -0
- package/src/topic/Topic.ts +103 -0
- package/src/topic/TopicBuilder.ts +53 -0
- package/src/topic/__tests__/TopicBuilder.spec.ts +82 -0
- package/src/topic/index.ts +11 -0
- package/src/types.ts +13 -0
- package/test.ts +91 -0
- package/tsconfig.json +9 -0
- package/tsdown.config.ts +35 -0
- package/dist/Construct-B1vGBPme.mjs.map +0 -1
- package/dist/Construct-BQALFCh2.d.cts +0 -230
- package/dist/Construct-BQALFCh2.d.cts.map +0 -1
- package/dist/Construct-DUSXuTHP.cjs.map +0 -1
- package/dist/Construct-QXnl3VqT.d.mts +0 -230
- package/dist/Construct-QXnl3VqT.d.mts.map +0 -1
- package/dist/Cron-DI3nKoic.d.cts +0 -45
- package/dist/Cron-DI3nKoic.d.cts.map +0 -1
- package/dist/Cron-uYAHPnp7.d.mts +0 -45
- package/dist/Cron-uYAHPnp7.d.mts.map +0 -1
- package/dist/CronBuilder-C0Ek1-RA.cjs +0 -121
- package/dist/CronBuilder-C0Ek1-RA.cjs.map +0 -1
- package/dist/CronBuilder-DaSUm2Na.d.mts +0 -47
- package/dist/CronBuilder-DaSUm2Na.d.mts.map +0 -1
- package/dist/CronBuilder-Dmix_Pen.mjs +0 -109
- package/dist/CronBuilder-Dmix_Pen.mjs.map +0 -1
- package/dist/CronBuilder-g1lZLWyG.d.cts +0 -47
- package/dist/CronBuilder-g1lZLWyG.d.cts.map +0 -1
- package/dist/Endpoint-BG4UJ9oA.mjs.map +0 -1
- package/dist/Endpoint-BoUg8ocM.cjs.map +0 -1
- package/dist/Endpoint-Du-NwPX2.d.mts.map +0 -1
- package/dist/Endpoint-aCvBMPoH.d.cts.map +0 -1
- package/dist/EndpointFactory-BDtsrEvJ.mjs +0 -791
- package/dist/EndpointFactory-BDtsrEvJ.mjs.map +0 -1
- package/dist/EndpointFactory-DJ7gXLpR.cjs +0 -833
- package/dist/EndpointFactory-DJ7gXLpR.cjs.map +0 -1
- package/dist/EndpointFactory-DMYdJCOj.d.mts +0 -363
- package/dist/EndpointFactory-DMYdJCOj.d.mts.map +0 -1
- package/dist/EndpointFactory-I7s1co3Y.d.cts +0 -363
- package/dist/EndpointFactory-I7s1co3Y.d.cts.map +0 -1
- package/dist/Function-DuqGcbOI.d.mts +0 -76
- package/dist/Function-DuqGcbOI.d.mts.map +0 -1
- package/dist/Function-Pu-1kKZz.d.cts +0 -76
- package/dist/Function-Pu-1kKZz.d.cts.map +0 -1
- package/dist/HonoEndpointAdaptor-PtPlbeKY.mjs.map +0 -1
- package/dist/HonoEndpointAdaptor-zVzVLJEO.cjs.map +0 -1
- package/dist/Queue-A3wfD0it.cjs +0 -109
- package/dist/Queue-A3wfD0it.cjs.map +0 -1
- package/dist/Queue-D6USGS4q.mjs +0 -104
- package/dist/Queue-D6USGS4q.mjs.map +0 -1
- package/dist/Queue-DlsHRzUp.d.mts +0 -105
- package/dist/Queue-DlsHRzUp.d.mts.map +0 -1
- package/dist/Queue-HPyi0e1i.d.cts +0 -105
- package/dist/Queue-HPyi0e1i.d.cts.map +0 -1
- package/dist/QueueBuilder-BjuF0UBl.cjs +0 -135
- package/dist/QueueBuilder-BjuF0UBl.cjs.map +0 -1
- package/dist/QueueBuilder-Cue73M4t.mjs +0 -118
- package/dist/QueueBuilder-Cue73M4t.mjs.map +0 -1
- package/dist/QueueBuilder-OSi6LkV9.d.cts +0 -75
- package/dist/QueueBuilder-OSi6LkV9.d.cts.map +0 -1
- package/dist/QueueBuilder-QHsnVt1P.d.mts +0 -75
- package/dist/QueueBuilder-QHsnVt1P.d.mts.map +0 -1
- package/dist/Subscriber-Bpp02cGr.d.cts +0 -61
- package/dist/Subscriber-Bpp02cGr.d.cts.map +0 -1
- package/dist/Subscriber-CtN9R48-.d.mts +0 -61
- package/dist/Subscriber-CtN9R48-.d.mts.map +0 -1
- package/dist/SubscriberBuilder-CDy4nHCz.mjs +0 -134
- package/dist/SubscriberBuilder-CDy4nHCz.mjs.map +0 -1
- package/dist/SubscriberBuilder-CuCMFpYW.d.mts +0 -67
- package/dist/SubscriberBuilder-CuCMFpYW.d.mts.map +0 -1
- package/dist/SubscriberBuilder-D_owVoHo.cjs +0 -145
- package/dist/SubscriberBuilder-D_owVoHo.cjs.map +0 -1
- package/dist/SubscriberBuilder-g3fAVWgs.d.cts +0 -67
- package/dist/SubscriberBuilder-g3fAVWgs.d.cts.map +0 -1
- package/dist/Topic-D74b5cgs.mjs +0 -99
- package/dist/Topic-D74b5cgs.mjs.map +0 -1
- package/dist/Topic-GHxcU8AG.cjs +0 -104
- package/dist/Topic-GHxcU8AG.cjs.map +0 -1
- package/dist/auth-BMCJN30Y.d.cts +0 -268
- package/dist/auth-BMCJN30Y.d.cts.map +0 -1
- package/dist/auth-CcuceLYo.d.mts +0 -268
- package/dist/auth-CcuceLYo.d.mts.map +0 -1
- package/dist/auth.cjs +0 -433
- package/dist/auth.cjs.map +0 -1
- package/dist/auth.d.cts +0 -2
- package/dist/auth.d.mts +0 -2
- package/dist/auth.mjs +0 -426
- package/dist/auth.mjs.map +0 -1
- package/dist/cache-CXh6GIgb.d.mts +0 -44
- package/dist/cache-CXh6GIgb.d.mts.map +0 -1
- package/dist/cache-DnGDGly3.d.cts +0 -44
- package/dist/cache-DnGDGly3.d.cts.map +0 -1
- package/dist/cache.cjs +0 -69
- package/dist/cache.cjs.map +0 -1
- package/dist/cache.d.cts +0 -2
- package/dist/cache.d.mts +0 -2
- package/dist/cache.mjs +0 -68
- package/dist/cache.mjs.map +0 -1
- package/dist/cipher-C1lEFX63.mjs +0 -225
- package/dist/cipher-C1lEFX63.mjs.map +0 -1
- package/dist/cipher-CVxfwLjk.cjs +0 -332
- package/dist/cipher-CVxfwLjk.cjs.map +0 -1
- package/dist/clone-EKNovYHu.mjs.map +0 -1
- package/dist/clone-UGJpvQnL.cjs.map +0 -1
- package/dist/construct-interface-B1AfqRl4.d.cts +0 -162
- package/dist/construct-interface-B1AfqRl4.d.cts.map +0 -1
- package/dist/construct-interface-DluK3_da.d.mts +0 -162
- package/dist/construct-interface-DluK3_da.d.mts.map +0 -1
- package/dist/construct-interface.cjs +0 -114
- package/dist/construct-interface.cjs.map +0 -1
- package/dist/construct-interface.d.cts +0 -2
- package/dist/construct-interface.d.mts +0 -2
- package/dist/construct-interface.mjs +0 -107
- package/dist/construct-interface.mjs.map +0 -1
- package/dist/credential.cjs +0 -156
- package/dist/credential.cjs.map +0 -1
- package/dist/credential.d.cts +0 -86
- package/dist/credential.d.cts.map +0 -1
- package/dist/credential.d.mts +0 -86
- package/dist/credential.d.mts.map +0 -1
- package/dist/credential.mjs +0 -152
- package/dist/credential.mjs.map +0 -1
- package/dist/database/kysely.cjs +0 -4
- package/dist/database/kysely.d.cts +0 -2
- package/dist/database/kysely.d.mts +0 -2
- package/dist/database/kysely.mjs +0 -2
- package/dist/email.cjs +0 -72
- package/dist/email.cjs.map +0 -1
- package/dist/email.d.cts +0 -46
- package/dist/email.d.cts.map +0 -1
- package/dist/email.d.mts +0 -46
- package/dist/email.d.mts.map +0 -1
- package/dist/email.mjs +0 -71
- package/dist/email.mjs.map +0 -1
- package/dist/encryption.cjs +0 -96
- package/dist/encryption.cjs.map +0 -1
- package/dist/encryption.d.cts +0 -117
- package/dist/encryption.d.cts.map +0 -1
- package/dist/encryption.d.mts +0 -117
- package/dist/encryption.d.mts.map +0 -1
- package/dist/encryption.mjs +0 -83
- package/dist/encryption.mjs.map +0 -1
- package/dist/external-api-MJ8id87V.d.mts +0 -105
- package/dist/external-api-MJ8id87V.d.mts.map +0 -1
- package/dist/external-api-O107yzZJ.d.cts +0 -105
- package/dist/external-api-O107yzZJ.d.cts.map +0 -1
- package/dist/external-api.cjs +0 -142
- package/dist/external-api.cjs.map +0 -1
- package/dist/external-api.d.cts +0 -2
- package/dist/external-api.d.mts +0 -2
- package/dist/external-api.mjs +0 -139
- package/dist/external-api.mjs.map +0 -1
- package/dist/file-server.cjs +0 -186
- package/dist/file-server.cjs.map +0 -1
- package/dist/file-server.d.cts +0 -152
- package/dist/file-server.d.cts.map +0 -1
- package/dist/file-server.d.mts +0 -152
- package/dist/file-server.d.mts.map +0 -1
- package/dist/file-server.mjs +0 -184
- package/dist/file-server.mjs.map +0 -1
- package/dist/functions-BFizikJU.mjs.map +0 -1
- package/dist/functions-CfzJG9hK.cjs.map +0 -1
- package/dist/index-BuzRvKOQ.d.cts +0 -115
- package/dist/index-BuzRvKOQ.d.cts.map +0 -1
- package/dist/index-CTkKOer4.d.mts +0 -115
- package/dist/index-CTkKOer4.d.mts.map +0 -1
- package/dist/index-CeEtxDmK.d.cts +0 -79
- package/dist/index-CeEtxDmK.d.cts.map +0 -1
- package/dist/index-CeEtxDmK.d.mts +0 -79
- package/dist/index-CeEtxDmK.d.mts.map +0 -1
- package/dist/index.d.cts.map +0 -1
- package/dist/index.d.mts.map +0 -1
- package/dist/kms-B-Hm3d5r.cjs +0 -85
- package/dist/kms-B-Hm3d5r.cjs.map +0 -1
- package/dist/kms-BdUlMJEZ.mjs +0 -85
- package/dist/kms-BdUlMJEZ.mjs.map +0 -1
- package/dist/kysely-Bii4l6eP.mjs +0 -370
- package/dist/kysely-Bii4l6eP.mjs.map +0 -1
- package/dist/kysely-CO_Dk43W.cjs +0 -383
- package/dist/kysely-CO_Dk43W.cjs.map +0 -1
- package/dist/kysely-D0bpzgPs.d.cts +0 -175
- package/dist/kysely-D0bpzgPs.d.cts.map +0 -1
- package/dist/kysely-DUqC3Ie0.d.mts +0 -175
- package/dist/kysely-DUqC3Ie0.d.mts.map +0 -1
- package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +0 -1
- package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +0 -1
- package/dist/lazyAccessors-CFanua0O.mjs +0 -174
- package/dist/lazyAccessors-CFanua0O.mjs.map +0 -1
- package/dist/lazyAccessors-hJKGv8Ay.cjs +0 -221
- package/dist/lazyAccessors-hJKGv8Ay.cjs.map +0 -1
- package/dist/mobile-app.cjs +0 -73
- package/dist/mobile-app.cjs.map +0 -1
- package/dist/mobile-app.d.cts +0 -61
- package/dist/mobile-app.d.cts.map +0 -1
- package/dist/mobile-app.d.mts +0 -61
- package/dist/mobile-app.d.mts.map +0 -1
- package/dist/mobile-app.mjs +0 -72
- package/dist/mobile-app.mjs.map +0 -1
- package/dist/object-storage.cjs +0 -56
- package/dist/object-storage.cjs.map +0 -1
- package/dist/object-storage.d.cts +0 -32
- package/dist/object-storage.d.cts.map +0 -1
- package/dist/object-storage.d.mts +0 -32
- package/dist/object-storage.d.mts.map +0 -1
- package/dist/object-storage.mjs +0 -55
- package/dist/object-storage.mjs.map +0 -1
- package/dist/processAudits-BRRVVHUB.mjs +0 -131
- package/dist/processAudits-BRRVVHUB.mjs.map +0 -1
- package/dist/processAudits-DasOZjPl.cjs +0 -154
- package/dist/processAudits-DasOZjPl.cjs.map +0 -1
- package/dist/rest-api.cjs +0 -216
- package/dist/rest-api.cjs.map +0 -1
- package/dist/rest-api.d.cts +0 -241
- package/dist/rest-api.d.cts.map +0 -1
- package/dist/rest-api.d.mts +0 -241
- package/dist/rest-api.d.mts.map +0 -1
- package/dist/rest-api.mjs +0 -215
- package/dist/rest-api.mjs.map +0 -1
- package/dist/rolldown-runtime-y5ARvAq5.cjs +0 -35
- package/dist/runSubscriber-BHvJ8POr.mjs +0 -109
- package/dist/runSubscriber-BHvJ8POr.mjs.map +0 -1
- package/dist/runSubscriber-D8nLXIv1.cjs +0 -126
- package/dist/runSubscriber-D8nLXIv1.cjs.map +0 -1
- package/dist/shutdown-BMJmAhSt.cjs +0 -38
- package/dist/shutdown-BMJmAhSt.cjs.map +0 -1
- package/dist/shutdown-C7xa8x9S.mjs +0 -27
- package/dist/shutdown-C7xa8x9S.mjs.map +0 -1
- package/dist/site.cjs +0 -74
- package/dist/site.cjs.map +0 -1
- package/dist/site.d.cts +0 -104
- package/dist/site.d.cts.map +0 -1
- package/dist/site.d.mts +0 -104
- package/dist/site.d.mts.map +0 -1
- package/dist/site.mjs +0 -73
- package/dist/site.mjs.map +0 -1
- package/dist/stages-BSCF19o2.d.cts +0 -56
- package/dist/stages-BSCF19o2.d.cts.map +0 -1
- package/dist/stages-BSCF19o2.d.mts +0 -56
- package/dist/stages-BSCF19o2.d.mts.map +0 -1
- package/dist/surfaceEnv-CNimK76p.cjs +0 -56
- package/dist/surfaceEnv-CNimK76p.cjs.map +0 -1
- package/dist/surfaceEnv-wMT5QzgZ.mjs +0 -45
- package/dist/surfaceEnv-wMT5QzgZ.mjs.map +0 -1
- package/dist/telemetry-B48RLjyk.d.cts +0 -40
- package/dist/telemetry-B48RLjyk.d.cts.map +0 -1
- package/dist/telemetry-DRtT1_0A.d.mts +0 -40
- package/dist/telemetry-DRtT1_0A.d.mts.map +0 -1
- package/dist/telemetry.cjs +0 -56
- package/dist/telemetry.cjs.map +0 -1
- package/dist/telemetry.d.cts +0 -2
- package/dist/telemetry.d.mts +0 -2
- package/dist/telemetry.mjs +0 -55
- package/dist/telemetry.mjs.map +0 -1
- package/dist/tracing-CxaZ98IB.mjs +0 -110
- package/dist/tracing-CxaZ98IB.mjs.map +0 -1
- package/dist/tracing-DPMidF_r.cjs +0 -127
- package/dist/tracing-DPMidF_r.cjs.map +0 -1
- package/dist/types-DMuSQeLL.d.cts.map +0 -1
- package/dist/types-DMuSQeLL.d.mts.map +0 -1
- package/dist/worker.cjs +0 -191
- package/dist/worker.cjs.map +0 -1
- package/dist/worker.d.cts +0 -171
- package/dist/worker.d.cts.map +0 -1
- package/dist/worker.d.mts +0 -171
- package/dist/worker.d.mts.map +0 -1
- package/dist/worker.mjs +0 -190
- package/dist/worker.mjs.map +0 -1
|
@@ -0,0 +1,86 @@
|
|
|
1
|
+
import type { Service } from '@geekmidas/services';
|
|
2
|
+
import type { ConstructMonitor } from '../monitor';
|
|
3
|
+
|
|
4
|
+
export interface HeartbeatOptions {
|
|
5
|
+
/**
|
|
6
|
+
* The environment variable holding the heartbeat URL. When it is unset the
|
|
7
|
+
* monitor does nothing, so only the stages that set it are monitored.
|
|
8
|
+
* @default 'HEARTBEAT_URL'
|
|
9
|
+
*/
|
|
10
|
+
env?: string;
|
|
11
|
+
/** The URL to request when a run starts. Omit for providers without one. */
|
|
12
|
+
start?: (url: string) => string;
|
|
13
|
+
/** The URL to request when a run succeeds. @default the URL itself */
|
|
14
|
+
success?: (url: string) => string;
|
|
15
|
+
/**
|
|
16
|
+
* The URL to request when a run fails. Omit to send nothing, and let the
|
|
17
|
+
* provider alert on the missed success ping instead.
|
|
18
|
+
*/
|
|
19
|
+
failure?: (url: string) => string;
|
|
20
|
+
/** Milliseconds to wait for the provider. @default 3000 */
|
|
21
|
+
timeout?: number;
|
|
22
|
+
}
|
|
23
|
+
|
|
24
|
+
/**
|
|
25
|
+
* A monitor that pings a URL when a run succeeds, and optionally when it
|
|
26
|
+
* starts or fails — the shape most heartbeat and cron-monitoring services
|
|
27
|
+
* share.
|
|
28
|
+
*
|
|
29
|
+
* @example
|
|
30
|
+
* ```typescript
|
|
31
|
+
* cron
|
|
32
|
+
* .schedule('rate(1 day)')
|
|
33
|
+
* .monitor(heartbeat.betterStack())
|
|
34
|
+
* .handle(async () => {});
|
|
35
|
+
* ```
|
|
36
|
+
*/
|
|
37
|
+
export function heartbeat(
|
|
38
|
+
options: HeartbeatOptions = {},
|
|
39
|
+
): Service<`heartbeat:${string}`, ConstructMonitor> {
|
|
40
|
+
const {
|
|
41
|
+
env = 'HEARTBEAT_URL',
|
|
42
|
+
start,
|
|
43
|
+
success = (url) => url,
|
|
44
|
+
failure,
|
|
45
|
+
timeout = 3000,
|
|
46
|
+
} = options;
|
|
47
|
+
|
|
48
|
+
return {
|
|
49
|
+
serviceName: `heartbeat:${env}`,
|
|
50
|
+
async register({ envParser }) {
|
|
51
|
+
const { url } = envParser
|
|
52
|
+
.create((get) => ({ url: get(env).string().optional() }))
|
|
53
|
+
.parse();
|
|
54
|
+
|
|
55
|
+
const ping = async (target?: (url: string) => string) => {
|
|
56
|
+
if (!url || !target) {
|
|
57
|
+
return;
|
|
58
|
+
}
|
|
59
|
+
const response = await fetch(target(url), {
|
|
60
|
+
signal: AbortSignal.timeout(timeout),
|
|
61
|
+
});
|
|
62
|
+
if (!response.ok) {
|
|
63
|
+
throw new Error(`Heartbeat responded with ${response.status}`);
|
|
64
|
+
}
|
|
65
|
+
};
|
|
66
|
+
|
|
67
|
+
return {
|
|
68
|
+
start: () => ping(start),
|
|
69
|
+
success: () => ping(success),
|
|
70
|
+
failure: () => ping(failure),
|
|
71
|
+
};
|
|
72
|
+
},
|
|
73
|
+
};
|
|
74
|
+
}
|
|
75
|
+
|
|
76
|
+
/** Better Stack heartbeats: `{url}` on success, `{url}/fail` on failure. */
|
|
77
|
+
heartbeat.betterStack = (env?: string) =>
|
|
78
|
+
heartbeat({ env, failure: (url) => `${url}/fail` });
|
|
79
|
+
|
|
80
|
+
/** Healthchecks.io: `{url}/start`, `{url}` and `{url}/fail`. */
|
|
81
|
+
heartbeat.healthchecks = (env?: string) =>
|
|
82
|
+
heartbeat({
|
|
83
|
+
env,
|
|
84
|
+
start: (url) => `${url}/start`,
|
|
85
|
+
failure: (url) => `${url}/fail`,
|
|
86
|
+
});
|
package/src/publisher.ts
ADDED
|
@@ -0,0 +1,93 @@
|
|
|
1
|
+
import type { AuditStorage } from '@geekmidas/audit';
|
|
2
|
+
import type { EventPublisher, MappedEvent } from '@geekmidas/events';
|
|
3
|
+
import type { Logger } from '@geekmidas/logger';
|
|
4
|
+
import type { InferStandardSchema } from '@geekmidas/schema';
|
|
5
|
+
import type { Service, ServiceDiscovery } from '@geekmidas/services';
|
|
6
|
+
import type { StandardSchemaV1 } from '@standard-schema/spec';
|
|
7
|
+
import type { Construct } from './Construct';
|
|
8
|
+
|
|
9
|
+
export async function publishEvents<
|
|
10
|
+
T extends EventPublisher<any> | undefined,
|
|
11
|
+
OutSchema extends StandardSchemaV1 | undefined = undefined,
|
|
12
|
+
TServiceName extends string = string,
|
|
13
|
+
TPublisherService extends Service<TServiceName, T> | undefined = undefined,
|
|
14
|
+
>(
|
|
15
|
+
logger: Logger,
|
|
16
|
+
serviceDiscovery: ServiceDiscovery<any>,
|
|
17
|
+
ev: MappedEvent<T, OutSchema>[] = [],
|
|
18
|
+
response: InferStandardSchema<OutSchema>,
|
|
19
|
+
publisherService: TPublisherService,
|
|
20
|
+
) {
|
|
21
|
+
try {
|
|
22
|
+
if (!ev?.length) {
|
|
23
|
+
logger.debug('No events to publish');
|
|
24
|
+
return;
|
|
25
|
+
}
|
|
26
|
+
if (!publisherService) {
|
|
27
|
+
logger.warn('No publisher service available');
|
|
28
|
+
return;
|
|
29
|
+
}
|
|
30
|
+
|
|
31
|
+
const services = await serviceDiscovery.register([publisherService]);
|
|
32
|
+
|
|
33
|
+
const publisher = services[
|
|
34
|
+
publisherService.serviceName
|
|
35
|
+
] as EventPublisher<any>;
|
|
36
|
+
|
|
37
|
+
const events: MappedEvent<T, OutSchema>[] = [];
|
|
38
|
+
|
|
39
|
+
for (const { when, payload, type, ...e } of ev) {
|
|
40
|
+
logger.debug({ event: type }, 'Processing event');
|
|
41
|
+
const resolvedPayload = await payload(response);
|
|
42
|
+
const event = {
|
|
43
|
+
...e,
|
|
44
|
+
type,
|
|
45
|
+
payload: resolvedPayload,
|
|
46
|
+
};
|
|
47
|
+
|
|
48
|
+
if (!when || when(response as any)) {
|
|
49
|
+
events.push(event);
|
|
50
|
+
}
|
|
51
|
+
}
|
|
52
|
+
|
|
53
|
+
if (events.length) {
|
|
54
|
+
logger.debug({ eventCount: ev.length }, 'Publishing events');
|
|
55
|
+
|
|
56
|
+
await publisher.publish(events).catch((err) => {
|
|
57
|
+
logger.error(err, 'Failed to publish events');
|
|
58
|
+
});
|
|
59
|
+
}
|
|
60
|
+
} catch (error) {
|
|
61
|
+
logger.error(error as any, 'Something went wrong publishing events');
|
|
62
|
+
}
|
|
63
|
+
}
|
|
64
|
+
|
|
65
|
+
export async function publishConstructEvents<
|
|
66
|
+
T extends EventPublisher<any> | undefined,
|
|
67
|
+
OutSchema extends StandardSchemaV1 | undefined = undefined,
|
|
68
|
+
TServiceName extends string = string,
|
|
69
|
+
TServices extends Service[] = [],
|
|
70
|
+
TAuditStorageServiceName extends string = string,
|
|
71
|
+
TAuditStorage extends AuditStorage | undefined = undefined,
|
|
72
|
+
>(
|
|
73
|
+
construct: Construct<
|
|
74
|
+
Logger,
|
|
75
|
+
TServiceName,
|
|
76
|
+
T,
|
|
77
|
+
OutSchema,
|
|
78
|
+
TServices,
|
|
79
|
+
TAuditStorageServiceName,
|
|
80
|
+
TAuditStorage
|
|
81
|
+
>,
|
|
82
|
+
response: InferStandardSchema<OutSchema>,
|
|
83
|
+
serviceDiscovery: ServiceDiscovery<any>,
|
|
84
|
+
logger: Logger = construct.logger,
|
|
85
|
+
) {
|
|
86
|
+
return publishEvents(
|
|
87
|
+
logger,
|
|
88
|
+
serviceDiscovery,
|
|
89
|
+
construct.events,
|
|
90
|
+
response,
|
|
91
|
+
construct.publisherService,
|
|
92
|
+
);
|
|
93
|
+
}
|
|
@@ -0,0 +1,162 @@
|
|
|
1
|
+
import type { EnvironmentParser } from '@geekmidas/envkit';
|
|
2
|
+
import { wrapError } from '@geekmidas/errors';
|
|
3
|
+
import type { Logger } from '@geekmidas/logger';
|
|
4
|
+
import type { InferStandardSchema } from '@geekmidas/schema';
|
|
5
|
+
import type { Service, ServiceRecord } from '@geekmidas/services';
|
|
6
|
+
import { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';
|
|
7
|
+
import type { StandardSchemaV1 } from '@standard-schema/spec';
|
|
8
|
+
import type {
|
|
9
|
+
Context,
|
|
10
|
+
Handler,
|
|
11
|
+
SQSBatchResponse,
|
|
12
|
+
SQSEvent,
|
|
13
|
+
SQSRecord,
|
|
14
|
+
} from 'aws-lambda';
|
|
15
|
+
import type { Queue } from './Queue';
|
|
16
|
+
|
|
17
|
+
export type AWSLambdaHandler<TEvent = any, TResult = any> = Handler<
|
|
18
|
+
TEvent,
|
|
19
|
+
TResult
|
|
20
|
+
>;
|
|
21
|
+
|
|
22
|
+
/**
|
|
23
|
+
* Runs a {@link Queue} worker as an AWS Lambda backed by an SQS event-source
|
|
24
|
+
* mapping. Unlike a subscriber, a queue drains *every* record (no type filter):
|
|
25
|
+
* each record body (`{ type, payload }`, as written by the SQS publisher) is
|
|
26
|
+
* unwrapped to its `payload`, validated against the queue's `messageSchema`, and
|
|
27
|
+
* the whole batch is handed to the handler as `messages`.
|
|
28
|
+
*
|
|
29
|
+
* Uses SQS partial-batch responses: a record that fails to parse, validate, or
|
|
30
|
+
* (when the handler throws) process is returned in `batchItemFailures` so SQS
|
|
31
|
+
* retries only those records.
|
|
32
|
+
*/
|
|
33
|
+
export class AWSLambdaQueue<
|
|
34
|
+
TName extends string = string,
|
|
35
|
+
TMessage extends StandardSchemaV1 = StandardSchemaV1,
|
|
36
|
+
TServices extends Service[] = [],
|
|
37
|
+
TLogger extends Logger = Logger,
|
|
38
|
+
> {
|
|
39
|
+
private _services?: ServiceRecord<TServices>;
|
|
40
|
+
|
|
41
|
+
constructor(
|
|
42
|
+
private readonly envParser: EnvironmentParser<{}>,
|
|
43
|
+
readonly queue: Queue<TName, TMessage, TServices, TLogger>,
|
|
44
|
+
) {}
|
|
45
|
+
|
|
46
|
+
get logger(): TLogger {
|
|
47
|
+
return this.queue.logger;
|
|
48
|
+
}
|
|
49
|
+
|
|
50
|
+
private async getServices(): Promise<ServiceRecord<TServices>> {
|
|
51
|
+
if (this._services) {
|
|
52
|
+
return this._services;
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
const serviceDiscovery = ServiceDiscovery.getInstance(this.envParser);
|
|
56
|
+
|
|
57
|
+
this._services =
|
|
58
|
+
this.queue.services.length > 0
|
|
59
|
+
? ((await serviceDiscovery.register(
|
|
60
|
+
this.queue.services,
|
|
61
|
+
)) as ServiceRecord<TServices>)
|
|
62
|
+
: ({} as ServiceRecord<TServices>);
|
|
63
|
+
|
|
64
|
+
return this._services;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
private safeJsonParse(value: string): unknown {
|
|
68
|
+
try {
|
|
69
|
+
return JSON.parse(value);
|
|
70
|
+
} catch {
|
|
71
|
+
return null;
|
|
72
|
+
}
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/**
|
|
76
|
+
* Unwrap the queue payload from an SQS record. The SQS publisher writes
|
|
77
|
+
* `{ type, payload }`; a payload-only body is also accepted as-is.
|
|
78
|
+
*/
|
|
79
|
+
private extractPayload(record: SQSRecord): unknown {
|
|
80
|
+
const body = this.safeJsonParse(record.body);
|
|
81
|
+
if (body && typeof body === 'object' && 'payload' in body) {
|
|
82
|
+
return (body as { payload: unknown }).payload;
|
|
83
|
+
}
|
|
84
|
+
return body ?? record.body;
|
|
85
|
+
}
|
|
86
|
+
|
|
87
|
+
private async _handler(
|
|
88
|
+
event: SQSEvent,
|
|
89
|
+
context: Context,
|
|
90
|
+
): Promise<SQSBatchResponse> {
|
|
91
|
+
const logger = this.queue.logger.child({
|
|
92
|
+
queue: {
|
|
93
|
+
name: this.queue.name,
|
|
94
|
+
fn: context.functionName,
|
|
95
|
+
},
|
|
96
|
+
req: { id: context.awsRequestId },
|
|
97
|
+
}) as TLogger;
|
|
98
|
+
|
|
99
|
+
const services = await this.getServices();
|
|
100
|
+
const schema = this.queue.messageSchema;
|
|
101
|
+
|
|
102
|
+
const batchItemFailures: { itemIdentifier: string }[] = [];
|
|
103
|
+
const messages: InferStandardSchema<TMessage>[] = [];
|
|
104
|
+
|
|
105
|
+
for (const record of event.Records) {
|
|
106
|
+
try {
|
|
107
|
+
const payload = this.extractPayload(record);
|
|
108
|
+
const validation = await schema['~standard'].validate(payload);
|
|
109
|
+
if (validation.issues) {
|
|
110
|
+
logger.error(
|
|
111
|
+
{ issues: validation.issues, messageId: record.messageId },
|
|
112
|
+
'Queue message failed validation',
|
|
113
|
+
);
|
|
114
|
+
batchItemFailures.push({ itemIdentifier: record.messageId });
|
|
115
|
+
continue;
|
|
116
|
+
}
|
|
117
|
+
messages.push(validation.value as InferStandardSchema<TMessage>);
|
|
118
|
+
} catch (error) {
|
|
119
|
+
logger.error(
|
|
120
|
+
{ error, messageId: record.messageId },
|
|
121
|
+
'Failed to parse SQS record',
|
|
122
|
+
);
|
|
123
|
+
batchItemFailures.push({ itemIdentifier: record.messageId });
|
|
124
|
+
}
|
|
125
|
+
}
|
|
126
|
+
|
|
127
|
+
if (messages.length === 0) {
|
|
128
|
+
return { batchItemFailures };
|
|
129
|
+
}
|
|
130
|
+
|
|
131
|
+
try {
|
|
132
|
+
await this.queue.handler({ messages, services, logger });
|
|
133
|
+
} catch (error) {
|
|
134
|
+
logger.error(wrapError(error), 'Queue handler failed; retrying batch');
|
|
135
|
+
// Handler processes the batch atomically — fail the whole batch so SQS
|
|
136
|
+
// retries every (valid) record.
|
|
137
|
+
for (const record of event.Records) {
|
|
138
|
+
if (
|
|
139
|
+
!batchItemFailures.some((f) => f.itemIdentifier === record.messageId)
|
|
140
|
+
) {
|
|
141
|
+
batchItemFailures.push({ itemIdentifier: record.messageId });
|
|
142
|
+
}
|
|
143
|
+
}
|
|
144
|
+
}
|
|
145
|
+
|
|
146
|
+
return { batchItemFailures };
|
|
147
|
+
}
|
|
148
|
+
|
|
149
|
+
get handler(): AWSLambdaHandler<SQSEvent, SQSBatchResponse> {
|
|
150
|
+
const handler = this._handler.bind(this);
|
|
151
|
+
|
|
152
|
+
return (async (event: SQSEvent, context: Context) => {
|
|
153
|
+
const startTime = Date.now();
|
|
154
|
+
const requestId = context.awsRequestId;
|
|
155
|
+
const logger = this.queue.logger.child({ requestId }) as TLogger;
|
|
156
|
+
|
|
157
|
+
return runWithRequestContext({ logger, requestId, startTime }, () =>
|
|
158
|
+
handler(event, context),
|
|
159
|
+
);
|
|
160
|
+
}) as unknown as AWSLambdaHandler<SQSEvent, SQSBatchResponse>;
|
|
161
|
+
}
|
|
162
|
+
}
|
|
@@ -0,0 +1,128 @@
|
|
|
1
|
+
import { environmentCase } from '@geekmidas/envkit';
|
|
2
|
+
import {
|
|
3
|
+
type EventPublisher,
|
|
4
|
+
type EventPublisherConnectionString,
|
|
5
|
+
type PublishableMessage,
|
|
6
|
+
Publisher,
|
|
7
|
+
} from '@geekmidas/events';
|
|
8
|
+
import type { Logger } from '@geekmidas/logger';
|
|
9
|
+
import { ConsoleLogger } from '@geekmidas/logger/console';
|
|
10
|
+
import type { InferStandardSchema } from '@geekmidas/schema';
|
|
11
|
+
import type { Service, ServiceRecord } from '@geekmidas/services';
|
|
12
|
+
import type { StandardSchemaV1 } from '@standard-schema/spec';
|
|
13
|
+
import { Construct, ConstructType } from '../Construct';
|
|
14
|
+
|
|
15
|
+
const DEFAULT_LOGGER = new ConsoleLogger() as unknown as Logger;
|
|
16
|
+
|
|
17
|
+
/**
|
|
18
|
+
* The wire message a queue carries: `{ type: <queue name>, payload: <message> }`.
|
|
19
|
+
* The producer publishes this shape and the worker receives the `payload`s as
|
|
20
|
+
* its `messages`. Typing `type` to the queue name keeps the publisher fully
|
|
21
|
+
* typed and lets pg-boss (local) / SQS (deployed) route by name.
|
|
22
|
+
*/
|
|
23
|
+
export type QueueMessage<
|
|
24
|
+
TName extends string,
|
|
25
|
+
TMessage extends StandardSchemaV1,
|
|
26
|
+
> = PublishableMessage<TName, InferStandardSchema<TMessage>>;
|
|
27
|
+
|
|
28
|
+
/**
|
|
29
|
+
* A queue worker — a point-to-point SQS-style queue and its single consumer.
|
|
30
|
+
* Unlike a `Subscriber` (topic fan-out, filtered by `subscribedEvents`), a queue
|
|
31
|
+
* drains every message of its one `message` type. Build one with `q` (see
|
|
32
|
+
* `QueueBuilder`); `gkm build` discovers it into the manifest's `queues` field.
|
|
33
|
+
*
|
|
34
|
+
* The producer side is {@link Queue.publisher} — a ready-to-inject `Service`
|
|
35
|
+
* that any endpoint/function drops into `.services([...])` to send messages.
|
|
36
|
+
*/
|
|
37
|
+
export class Queue<
|
|
38
|
+
TName extends string = string,
|
|
39
|
+
TMessage extends StandardSchemaV1 = StandardSchemaV1,
|
|
40
|
+
TServices extends Service[] = [],
|
|
41
|
+
TLogger extends Logger = Logger,
|
|
42
|
+
> extends Construct<TLogger, string, undefined, undefined, TServices> {
|
|
43
|
+
__IS_QUEUE__ = true;
|
|
44
|
+
|
|
45
|
+
static isQueue(
|
|
46
|
+
obj: unknown,
|
|
47
|
+
): obj is Queue<string, StandardSchemaV1, Service[], Logger> {
|
|
48
|
+
return Boolean(
|
|
49
|
+
obj &&
|
|
50
|
+
(obj as { __IS_QUEUE__?: boolean }).__IS_QUEUE__ === true &&
|
|
51
|
+
(obj as Construct).type === ConstructType.Queue,
|
|
52
|
+
);
|
|
53
|
+
}
|
|
54
|
+
|
|
55
|
+
constructor(
|
|
56
|
+
public readonly name: TName,
|
|
57
|
+
public readonly handler: QueueHandler<TMessage, TServices, TLogger>,
|
|
58
|
+
public readonly messageSchema: TMessage,
|
|
59
|
+
public override readonly timeout: number = 30000,
|
|
60
|
+
public override readonly services: TServices = [] as unknown as TServices,
|
|
61
|
+
public override readonly logger: TLogger = DEFAULT_LOGGER as TLogger,
|
|
62
|
+
/** SQS event-source batch size (deployed). */
|
|
63
|
+
public readonly batchSize?: number,
|
|
64
|
+
/** Whether the queue is FIFO (deployed). */
|
|
65
|
+
public readonly fifo?: boolean,
|
|
66
|
+
) {
|
|
67
|
+
super(
|
|
68
|
+
ConstructType.Queue,
|
|
69
|
+
logger,
|
|
70
|
+
services,
|
|
71
|
+
[],
|
|
72
|
+
undefined,
|
|
73
|
+
undefined,
|
|
74
|
+
timeout,
|
|
75
|
+
);
|
|
76
|
+
}
|
|
77
|
+
|
|
78
|
+
/**
|
|
79
|
+
* The producer side — a `Service` exposing an `EventPublisher` typed to this
|
|
80
|
+
* queue's message. Inject it via `.services([queue.publisher])`; the handler
|
|
81
|
+
* then calls `services.<name>Publisher.publish([{ type, payload }])`.
|
|
82
|
+
*
|
|
83
|
+
* It reads `<NAME>_PUBLISHER_CONNECTION_STRING` and builds the transport from
|
|
84
|
+
* the URL protocol — `pgboss://` locally, `sqs://` deployed — so the same
|
|
85
|
+
* code publishes to Postgres in dev and SQS in prod. Because it's a `Service`,
|
|
86
|
+
* `Construct.getEnvironment()` sniffs it, so the env requirement flows into
|
|
87
|
+
* the manifest and infra links exactly this queue with least privilege.
|
|
88
|
+
*/
|
|
89
|
+
get publisher(): Service<
|
|
90
|
+
`${TName}Publisher`,
|
|
91
|
+
EventPublisher<QueueMessage<TName, TMessage>>
|
|
92
|
+
> {
|
|
93
|
+
const envVar = `${environmentCase(this.name)}_PUBLISHER_CONNECTION_STRING`;
|
|
94
|
+
return {
|
|
95
|
+
serviceName: `${this.name}Publisher`,
|
|
96
|
+
async register({ envParser }) {
|
|
97
|
+
const { connectionString } = envParser
|
|
98
|
+
.create((get) => ({
|
|
99
|
+
connectionString: get(envVar).string(),
|
|
100
|
+
}))
|
|
101
|
+
.parse();
|
|
102
|
+
|
|
103
|
+
return Publisher.fromConnectionString<QueueMessage<TName, TMessage>>(
|
|
104
|
+
connectionString as EventPublisherConnectionString,
|
|
105
|
+
);
|
|
106
|
+
},
|
|
107
|
+
};
|
|
108
|
+
}
|
|
109
|
+
}
|
|
110
|
+
|
|
111
|
+
/** The context a queue handler receives — a batch of typed messages. */
|
|
112
|
+
export type QueueContext<
|
|
113
|
+
TMessage extends StandardSchemaV1,
|
|
114
|
+
TServices extends Service[] = [],
|
|
115
|
+
TLogger extends Logger = Logger,
|
|
116
|
+
> = {
|
|
117
|
+
messages: InferStandardSchema<TMessage>[];
|
|
118
|
+
services: ServiceRecord<TServices>;
|
|
119
|
+
logger: TLogger;
|
|
120
|
+
};
|
|
121
|
+
|
|
122
|
+
export type QueueHandler<
|
|
123
|
+
TMessage extends StandardSchemaV1,
|
|
124
|
+
TServices extends Service[] = [],
|
|
125
|
+
TLogger extends Logger = Logger,
|
|
126
|
+
> = (
|
|
127
|
+
ctx: QueueContext<TMessage, TServices, TLogger>,
|
|
128
|
+
) => unknown | Promise<unknown>;
|
|
@@ -0,0 +1,115 @@
|
|
|
1
|
+
import type { Logger } from '@geekmidas/logger';
|
|
2
|
+
import { DEFAULT_LOGGER } from '@geekmidas/logger/console';
|
|
3
|
+
import type { Service } from '@geekmidas/services';
|
|
4
|
+
import type { StandardSchemaV1 } from '@standard-schema/spec';
|
|
5
|
+
import { cloneWith } from '../clone';
|
|
6
|
+
import { Queue, type QueueHandler } from './Queue';
|
|
7
|
+
|
|
8
|
+
/**
|
|
9
|
+
* Builds a {@link Queue} worker — `q.queue('orders').services([db]).message(schema).handle(fn)`.
|
|
10
|
+
* Services are an array (sniffed for required env vars); `message` is the typed
|
|
11
|
+
* job payload; `handle` is the single consumer. The queue name is captured as a
|
|
12
|
+
* literal so `queue.publisher` is typed to `{ type: '<name>', payload }`.
|
|
13
|
+
*/
|
|
14
|
+
export class QueueBuilder<
|
|
15
|
+
TName extends string = string,
|
|
16
|
+
TMessage extends StandardSchemaV1 | undefined = undefined,
|
|
17
|
+
TServices extends Service[] = [],
|
|
18
|
+
TLogger extends Logger = Logger,
|
|
19
|
+
> {
|
|
20
|
+
private _name?: string;
|
|
21
|
+
private _messageSchema?: TMessage;
|
|
22
|
+
private _timeout = 30000;
|
|
23
|
+
private _batchSize?: number;
|
|
24
|
+
private _fifo?: boolean;
|
|
25
|
+
private _services: TServices = [] as Service[] as TServices;
|
|
26
|
+
private _logger: TLogger = DEFAULT_LOGGER as TLogger;
|
|
27
|
+
|
|
28
|
+
/** The queue name — drives the infra queue and its `<NAME>_*` env vars. */
|
|
29
|
+
queue<T extends string>(
|
|
30
|
+
name: T,
|
|
31
|
+
): QueueBuilder<T, TMessage, TServices, TLogger> {
|
|
32
|
+
return cloneWith(this, { _name: name }) as unknown as QueueBuilder<
|
|
33
|
+
T,
|
|
34
|
+
TMessage,
|
|
35
|
+
TServices,
|
|
36
|
+
TLogger
|
|
37
|
+
>;
|
|
38
|
+
}
|
|
39
|
+
|
|
40
|
+
timeout(timeout: number): this {
|
|
41
|
+
return cloneWith(this, { _timeout: timeout });
|
|
42
|
+
}
|
|
43
|
+
|
|
44
|
+
/** SQS event-source batch size (deployed). */
|
|
45
|
+
batchSize(batchSize: number): this {
|
|
46
|
+
return cloneWith(this, { _batchSize: batchSize });
|
|
47
|
+
}
|
|
48
|
+
|
|
49
|
+
/** Mark the queue as FIFO (deployed). */
|
|
50
|
+
fifo(fifo = true): this {
|
|
51
|
+
return cloneWith(this, { _fifo: fifo });
|
|
52
|
+
}
|
|
53
|
+
|
|
54
|
+
services<T extends Service[]>(
|
|
55
|
+
services: T,
|
|
56
|
+
): QueueBuilder<TName, TMessage, [...TServices, ...T], TLogger> {
|
|
57
|
+
return cloneWith(this, {
|
|
58
|
+
_services: [...this._services, ...services] as unknown as TServices,
|
|
59
|
+
}) as unknown as QueueBuilder<
|
|
60
|
+
TName,
|
|
61
|
+
TMessage,
|
|
62
|
+
[...TServices, ...T],
|
|
63
|
+
TLogger
|
|
64
|
+
>;
|
|
65
|
+
}
|
|
66
|
+
|
|
67
|
+
logger<T extends Logger>(
|
|
68
|
+
logger: T,
|
|
69
|
+
): QueueBuilder<TName, TMessage, TServices, T> {
|
|
70
|
+
return cloneWith(this, {
|
|
71
|
+
_logger: logger as unknown as TLogger,
|
|
72
|
+
}) as unknown as QueueBuilder<TName, TMessage, TServices, T>;
|
|
73
|
+
}
|
|
74
|
+
|
|
75
|
+
/** The typed message (job) payload the queue carries. */
|
|
76
|
+
message<T extends StandardSchemaV1>(
|
|
77
|
+
schema: T,
|
|
78
|
+
): QueueBuilder<TName, T, TServices, TLogger> {
|
|
79
|
+
return cloneWith(this, {
|
|
80
|
+
_messageSchema: schema as unknown as TMessage,
|
|
81
|
+
}) as unknown as QueueBuilder<TName, T, TServices, TLogger>;
|
|
82
|
+
}
|
|
83
|
+
|
|
84
|
+
handle(
|
|
85
|
+
fn: QueueHandler<NonNullable<TMessage>, TServices, TLogger>,
|
|
86
|
+
): Queue<TName, NonNullable<TMessage>, TServices, TLogger> {
|
|
87
|
+
if (!this._name) {
|
|
88
|
+
throw new Error(
|
|
89
|
+
'Queue requires a name — call .queue(name) before .handle().',
|
|
90
|
+
);
|
|
91
|
+
}
|
|
92
|
+
if (!this._messageSchema) {
|
|
93
|
+
throw new Error(
|
|
94
|
+
'Queue requires a message schema — call .message(schema) before .handle().',
|
|
95
|
+
);
|
|
96
|
+
}
|
|
97
|
+
|
|
98
|
+
const queue = new Queue<TName, NonNullable<TMessage>, TServices, TLogger>(
|
|
99
|
+
this._name as TName,
|
|
100
|
+
fn,
|
|
101
|
+
this._messageSchema as NonNullable<TMessage>,
|
|
102
|
+
this._timeout,
|
|
103
|
+
this._services,
|
|
104
|
+
this._logger,
|
|
105
|
+
this._batchSize,
|
|
106
|
+
this._fifo,
|
|
107
|
+
);
|
|
108
|
+
|
|
109
|
+
// No reset. `.handle()` reads this builder and leaves it alone, so a
|
|
110
|
+
// configured base keeps its configuration for every construct built
|
|
111
|
+
// from it. The reset that used to be here wiped the base on first use.
|
|
112
|
+
|
|
113
|
+
return queue;
|
|
114
|
+
}
|
|
115
|
+
}
|
|
@@ -0,0 +1,63 @@
|
|
|
1
|
+
import { EnvironmentParser } from '@geekmidas/envkit';
|
|
2
|
+
import type { Logger } from '@geekmidas/logger';
|
|
3
|
+
import type { InferStandardSchema } from '@geekmidas/schema';
|
|
4
|
+
import type { Service, ServiceRecord } from '@geekmidas/services';
|
|
5
|
+
import { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';
|
|
6
|
+
import type { StandardSchemaV1 } from '@standard-schema/spec';
|
|
7
|
+
import type { Queue } from './Queue';
|
|
8
|
+
|
|
9
|
+
/**
|
|
10
|
+
* In-memory test driver for a {@link Queue} worker. Hand it a batch of messages
|
|
11
|
+
* and it registers the queue's services, runs the handler in a request context,
|
|
12
|
+
* and returns the handler result — no SQS/pg-boss required.
|
|
13
|
+
*
|
|
14
|
+
* @example
|
|
15
|
+
* const adapter = new TestQueueAdaptor(ordersQueue);
|
|
16
|
+
* await adapter.invoke({ messages: [{ orderId: '123' }] });
|
|
17
|
+
*/
|
|
18
|
+
export class TestQueueAdaptor<
|
|
19
|
+
TName extends string = string,
|
|
20
|
+
TMessage extends StandardSchemaV1 = StandardSchemaV1,
|
|
21
|
+
TServices extends Service[] = [],
|
|
22
|
+
TLogger extends Logger = Logger,
|
|
23
|
+
> {
|
|
24
|
+
static getDefaultServiceDiscovery() {
|
|
25
|
+
return ServiceDiscovery.getInstance(new EnvironmentParser({}));
|
|
26
|
+
}
|
|
27
|
+
|
|
28
|
+
constructor(
|
|
29
|
+
private readonly queue: Queue<TName, TMessage, TServices, TLogger>,
|
|
30
|
+
private serviceDiscovery: ServiceDiscovery<any> = TestQueueAdaptor.getDefaultServiceDiscovery(),
|
|
31
|
+
) {}
|
|
32
|
+
|
|
33
|
+
async invoke(
|
|
34
|
+
request: TestQueueRequest<TMessage, TServices>,
|
|
35
|
+
): Promise<unknown> {
|
|
36
|
+
const logger = this.queue.logger.child({ test: true }) as TLogger;
|
|
37
|
+
|
|
38
|
+
const services =
|
|
39
|
+
request.services ??
|
|
40
|
+
((await this.serviceDiscovery.register(
|
|
41
|
+
this.queue.services,
|
|
42
|
+
)) as ServiceRecord<TServices>);
|
|
43
|
+
|
|
44
|
+
const requestId = `test-${Date.now()}`;
|
|
45
|
+
const startTime = Date.now();
|
|
46
|
+
|
|
47
|
+
return runWithRequestContext({ logger, requestId, startTime }, () =>
|
|
48
|
+
this.queue.handler({
|
|
49
|
+
messages: request.messages,
|
|
50
|
+
services,
|
|
51
|
+
logger,
|
|
52
|
+
}),
|
|
53
|
+
);
|
|
54
|
+
}
|
|
55
|
+
}
|
|
56
|
+
|
|
57
|
+
export type TestQueueRequest<
|
|
58
|
+
TMessage extends StandardSchemaV1 = StandardSchemaV1,
|
|
59
|
+
TServices extends Service[] = [],
|
|
60
|
+
> = {
|
|
61
|
+
messages: InferStandardSchema<TMessage>[];
|
|
62
|
+
services?: ServiceRecord<TServices>;
|
|
63
|
+
};
|