@geekmidas/constructs 10.0.0-alpha.13 → 10.0.0-alpha.131
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +222 -158
- package/dist/Construct-127M7yrl.d.cts +231 -0
- package/dist/Construct-127M7yrl.d.cts.map +1 -0
- package/dist/{Construct-BeYVu_QF.mjs → Construct-CGuc_Ijk.mjs} +8 -9
- package/dist/Construct-CGuc_Ijk.mjs.map +1 -0
- package/dist/{Construct-DqdlARxq.cjs → Construct-DorKS0Ua.cjs} +8 -9
- package/dist/Construct-DorKS0Ua.cjs.map +1 -0
- package/dist/Construct-DySlwh8o.d.mts +231 -0
- package/dist/Construct-DySlwh8o.d.mts.map +1 -0
- package/dist/{Cron-DKqnnTdH.d.cts → Cron-CFkpEys6.d.cts} +14 -7
- package/dist/Cron-CFkpEys6.d.cts.map +1 -0
- package/dist/{Cron-SyqS5oWJ.d.mts → Cron-CQoDSu-n.d.mts} +14 -7
- package/dist/Cron-CQoDSu-n.d.mts.map +1 -0
- package/dist/CronBuilder-1W-G_i15.d.mts +47 -0
- package/dist/CronBuilder-1W-G_i15.d.mts.map +1 -0
- package/dist/{CronBuilder-D_0HNBTr.mjs → CronBuilder-BJ5LoadF.mjs} +28 -11
- package/dist/CronBuilder-BJ5LoadF.mjs.map +1 -0
- package/dist/{CronBuilder-BdnI6lxF.cjs → CronBuilder-B_NSP-Y5.cjs} +27 -10
- package/dist/CronBuilder-B_NSP-Y5.cjs.map +1 -0
- package/dist/CronBuilder-OaCRRFVk.d.cts +47 -0
- package/dist/CronBuilder-OaCRRFVk.d.cts.map +1 -0
- package/dist/{Endpoint-C6yyHpRS.d.cts → Endpoint-BEh-jW-f.d.cts} +122 -41
- package/dist/Endpoint-BEh-jW-f.d.cts.map +1 -0
- package/dist/Endpoint-BcUorcBa.cjs +576 -0
- package/dist/Endpoint-BcUorcBa.cjs.map +1 -0
- package/dist/Endpoint-BgvG36NO.mjs +547 -0
- package/dist/Endpoint-BgvG36NO.mjs.map +1 -0
- package/dist/{Endpoint-DuT4TEEq.d.mts → Endpoint-DTXDggNl.d.mts} +124 -43
- package/dist/Endpoint-DTXDggNl.d.mts.map +1 -0
- package/dist/{index-BPSZ_Lp_.d.cts → EndpointFactory-B2dCS9dy.d.cts} +187 -104
- package/dist/EndpointFactory-B2dCS9dy.d.cts.map +1 -0
- package/dist/{EndpointFactory-ptPR1cXw.mjs → EndpointFactory-C1NlpCAS.mjs} +270 -54
- package/dist/EndpointFactory-C1NlpCAS.mjs.map +1 -0
- package/dist/{index-BoZ-iisU.d.mts → EndpointFactory-D2HXcUrJ.d.mts} +188 -105
- package/dist/EndpointFactory-D2HXcUrJ.d.mts.map +1 -0
- package/dist/{EndpointFactory-M8OQKZRY.cjs → EndpointFactory-gqmIRVWg.cjs} +310 -52
- package/dist/EndpointFactory-gqmIRVWg.cjs.map +1 -0
- package/dist/Function-BIEsY0Hm.d.cts +76 -0
- package/dist/Function-BIEsY0Hm.d.cts.map +1 -0
- package/dist/Function-DfMzTGS4.d.mts +76 -0
- package/dist/Function-DfMzTGS4.d.mts.map +1 -0
- package/dist/{HonoEndpointAdaptor-7QagYKdP.cjs → HonoEndpointAdaptor-BJlj20fQ.cjs} +79 -31
- package/dist/HonoEndpointAdaptor-BJlj20fQ.cjs.map +1 -0
- package/dist/{HonoEndpointAdaptor-CYHA0WAt.mjs → HonoEndpointAdaptor-BlbkUDNo.mjs} +76 -28
- package/dist/HonoEndpointAdaptor-BlbkUDNo.mjs.map +1 -0
- package/dist/ObjectSubscriberBuilder-HmBwFn2o.d.mts +129 -0
- package/dist/ObjectSubscriberBuilder-HmBwFn2o.d.mts.map +1 -0
- package/dist/ObjectSubscriberBuilder-l-64yUiF.d.cts +129 -0
- package/dist/ObjectSubscriberBuilder-l-64yUiF.d.cts.map +1 -0
- package/dist/ProcessorBuilder-B2_stA8f.d.mts +216 -0
- package/dist/ProcessorBuilder-B2_stA8f.d.mts.map +1 -0
- package/dist/ProcessorBuilder-C62bIOwj.d.cts +216 -0
- package/dist/ProcessorBuilder-C62bIOwj.d.cts.map +1 -0
- package/dist/{Queue-D9X6OoON.d.mts → Queue-BnK3UH8r.d.mts} +42 -41
- package/dist/Queue-BnK3UH8r.d.mts.map +1 -0
- package/dist/{Queue-DYPB2KWL.d.cts → Queue-C4rijiM7.d.cts} +43 -42
- package/dist/Queue-C4rijiM7.d.cts.map +1 -0
- package/dist/Queue-D4Iaidrs.cjs +109 -0
- package/dist/Queue-D4Iaidrs.cjs.map +1 -0
- package/dist/Queue-u8w8_HpE.mjs +104 -0
- package/dist/Queue-u8w8_HpE.mjs.map +1 -0
- package/dist/QueueBuilder-2wP5lEC8.mjs +118 -0
- package/dist/QueueBuilder-2wP5lEC8.mjs.map +1 -0
- package/dist/QueueBuilder-B3vL1ED2.d.mts +75 -0
- package/dist/QueueBuilder-B3vL1ED2.d.mts.map +1 -0
- package/dist/QueueBuilder-BcPBQSSX.d.cts +75 -0
- package/dist/QueueBuilder-BcPBQSSX.d.cts.map +1 -0
- package/dist/QueueBuilder-BxsZ9o5z.cjs +135 -0
- package/dist/QueueBuilder-BxsZ9o5z.cjs.map +1 -0
- package/dist/Subscriber-BdCtfFXL.d.cts +73 -0
- package/dist/Subscriber-BdCtfFXL.d.cts.map +1 -0
- package/dist/Subscriber-DDo4HFNn.d.mts +73 -0
- package/dist/Subscriber-DDo4HFNn.d.mts.map +1 -0
- package/dist/SubscriberBuilder-3msj1U2w.mjs +230 -0
- package/dist/SubscriberBuilder-3msj1U2w.mjs.map +1 -0
- package/dist/SubscriberBuilder-CQst6Iz3.cjs +253 -0
- package/dist/SubscriberBuilder-CQst6Iz3.cjs.map +1 -0
- package/dist/Topic-DN2gYJ-p.mjs +99 -0
- package/dist/Topic-DN2gYJ-p.mjs.map +1 -0
- package/dist/Topic-Dp9Q7Lj2.cjs +104 -0
- package/dist/Topic-Dp9Q7Lj2.cjs.map +1 -0
- package/dist/adaptors/aws.cjs +134 -160
- package/dist/adaptors/aws.cjs.map +1 -1
- package/dist/adaptors/aws.d.cts +57 -48
- package/dist/adaptors/aws.d.cts.map +1 -1
- package/dist/adaptors/aws.d.mts +58 -49
- package/dist/adaptors/aws.d.mts.map +1 -1
- package/dist/adaptors/aws.mjs +130 -157
- package/dist/adaptors/aws.mjs.map +1 -1
- package/dist/adaptors/hono.cjs +1 -1
- package/dist/adaptors/hono.d.cts +5 -6
- package/dist/adaptors/hono.d.cts.map +1 -1
- package/dist/adaptors/hono.d.mts +6 -7
- package/dist/adaptors/hono.d.mts.map +1 -1
- package/dist/adaptors/hono.mjs +1 -1
- package/dist/adaptors/testing.cjs +824 -38
- package/dist/adaptors/testing.cjs.map +1 -1
- package/dist/adaptors/testing.d.cts +368 -39
- package/dist/adaptors/testing.d.cts.map +1 -1
- package/dist/adaptors/testing.d.mts +367 -38
- package/dist/adaptors/testing.d.mts.map +1 -1
- package/dist/adaptors/testing.mjs +802 -34
- package/dist/adaptors/testing.mjs.map +1 -1
- package/dist/auth-BMCJN30Y.d.cts +268 -0
- package/dist/auth-BMCJN30Y.d.cts.map +1 -0
- package/dist/auth-D_0788uW.d.mts +268 -0
- package/dist/auth-D_0788uW.d.mts.map +1 -0
- package/dist/auth.cjs +289 -46
- package/dist/auth.cjs.map +1 -1
- package/dist/auth.d.cts +2 -104
- package/dist/auth.d.mts +2 -104
- package/dist/auth.mjs +285 -48
- package/dist/auth.mjs.map +1 -1
- package/dist/cache-5QZzh5Er.d.mts +44 -0
- package/dist/cache-5QZzh5Er.d.mts.map +1 -0
- package/dist/cache-DnGDGly3.d.cts +44 -0
- package/dist/cache-DnGDGly3.d.cts.map +1 -0
- package/dist/cache.d.cts +2 -43
- package/dist/cache.d.mts +2 -43
- package/dist/cipher-C1lEFX63.mjs +225 -0
- package/dist/cipher-C1lEFX63.mjs.map +1 -0
- package/dist/cipher-CVxfwLjk.cjs +332 -0
- package/dist/cipher-CVxfwLjk.cjs.map +1 -0
- package/dist/cipher-DSDxPRIp.d.cts +106 -0
- package/dist/cipher-DSDxPRIp.d.cts.map +1 -0
- package/dist/cipher-DSDxPRIp.d.mts +106 -0
- package/dist/cipher-DSDxPRIp.d.mts.map +1 -0
- package/dist/{construct-interface-DPlxfpoS.d.mts → construct-interface-B1AfqRl4.d.cts} +42 -8
- package/dist/construct-interface-B1AfqRl4.d.cts.map +1 -0
- package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-ZvYQbivO.d.mts} +42 -8
- package/dist/construct-interface-ZvYQbivO.d.mts.map +1 -0
- package/dist/construct-interface.cjs +30 -4
- package/dist/construct-interface.cjs.map +1 -1
- package/dist/construct-interface.d.cts +2 -2
- package/dist/construct-interface.d.mts +2 -2
- package/dist/construct-interface.mjs +30 -5
- package/dist/construct-interface.mjs.map +1 -1
- package/dist/credential-DYymbp_7.cjs +257 -0
- package/dist/credential-DYymbp_7.cjs.map +1 -0
- package/dist/credential-DfSAOOdY.mjs +222 -0
- package/dist/credential-DfSAOOdY.mjs.map +1 -0
- package/dist/credential.cjs +7 -129
- package/dist/credential.d.cts +2 -58
- package/dist/credential.d.mts +2 -58
- package/dist/credential.mjs +2 -128
- package/dist/crons/index.cjs +126 -1
- package/dist/crons/index.cjs.map +1 -1
- package/dist/crons/index.d.cts +43 -3
- package/dist/crons/index.d.cts.map +1 -1
- package/dist/crons/index.d.mts +43 -3
- package/dist/crons/index.d.mts.map +1 -1
- package/dist/crons/index.mjs +125 -2
- package/dist/crons/index.mjs.map +1 -1
- package/dist/database/kysely.cjs +3 -194
- package/dist/database/kysely.d.cts +2 -149
- package/dist/database/kysely.d.mts +2 -149
- package/dist/database/kysely.mjs +2 -192
- package/dist/email.d.cts +1 -1
- package/dist/email.d.cts.map +1 -1
- package/dist/email.d.mts +2 -2
- package/dist/email.d.mts.map +1 -1
- package/dist/encryption/kms.cjs +95 -0
- package/dist/encryption/kms.cjs.map +1 -0
- package/dist/encryption/kms.d.cts +7 -0
- package/dist/encryption/kms.d.cts.map +1 -0
- package/dist/encryption/kms.d.mts +7 -0
- package/dist/encryption/kms.d.mts.map +1 -0
- package/dist/encryption/kms.mjs +93 -0
- package/dist/encryption/kms.mjs.map +1 -0
- package/dist/encryption.cjs +116 -0
- package/dist/encryption.cjs.map +1 -0
- package/dist/encryption.d.cts +37 -0
- package/dist/encryption.d.cts.map +1 -0
- package/dist/encryption.d.mts +37 -0
- package/dist/encryption.d.mts.map +1 -0
- package/dist/encryption.mjs +101 -0
- package/dist/encryption.mjs.map +1 -0
- package/dist/endpoints/index.cjs +25 -10
- package/dist/endpoints/index.d.cts +105 -3
- package/dist/endpoints/index.d.cts.map +1 -0
- package/dist/endpoints/index.d.mts +105 -3
- package/dist/endpoints/index.d.mts.map +1 -0
- package/dist/endpoints/index.mjs +5 -4
- package/dist/expire-C586zznE.d.cts +38 -0
- package/dist/expire-C586zznE.d.cts.map +1 -0
- package/dist/expire-C586zznE.d.mts +38 -0
- package/dist/expire-C586zznE.d.mts.map +1 -0
- package/dist/expire-CieftS01.cjs +67 -0
- package/dist/expire-CieftS01.cjs.map +1 -0
- package/dist/expire-CpzUAfr9.mjs +50 -0
- package/dist/expire-CpzUAfr9.mjs.map +1 -0
- package/dist/external-api.cjs +106 -0
- package/dist/external-api.cjs.map +1 -0
- package/dist/external-api.d.cts +2 -0
- package/dist/external-api.d.mts +2 -0
- package/dist/external-api.mjs +103 -0
- package/dist/external-api.mjs.map +1 -0
- package/dist/fake-BUgcX2Dk.d.cts +201 -0
- package/dist/fake-BUgcX2Dk.d.cts.map +1 -0
- package/dist/fake-D472nkKb.d.mts +201 -0
- package/dist/fake-D472nkKb.d.mts.map +1 -0
- package/dist/file-server.cjs +123 -30
- package/dist/file-server.cjs.map +1 -1
- package/dist/file-server.d.cts +115 -1
- package/dist/file-server.d.cts.map +1 -1
- package/dist/file-server.d.mts +115 -1
- package/dist/file-server.d.mts.map +1 -1
- package/dist/file-server.mjs +122 -32
- package/dist/file-server.mjs.map +1 -1
- package/dist/functions/index.cjs +1 -1
- package/dist/functions/index.d.cts +2 -1
- package/dist/functions/index.d.mts +2 -1
- package/dist/functions/index.mjs +1 -1
- package/dist/{functions-C53GW2eQ.mjs → functions-BvIDQKAA.mjs} +117 -22
- package/dist/functions-BvIDQKAA.mjs.map +1 -0
- package/dist/{functions-B6qCvfmy.cjs → functions-DLF6-IK8.cjs} +122 -18
- package/dist/functions-DLF6-IK8.cjs.map +1 -0
- package/dist/index-BtzMzhMA.d.cts +115 -0
- package/dist/index-BtzMzhMA.d.cts.map +1 -0
- package/dist/{index-CeEtxDmK.d.cts → index-DdRjYhiJ.d.cts} +42 -2
- package/dist/{index-CeEtxDmK.d.cts.map → index-DdRjYhiJ.d.cts.map} +1 -1
- package/dist/{index-CeEtxDmK.d.mts → index-DdRjYhiJ.d.mts} +42 -2
- package/dist/{index-CeEtxDmK.d.mts.map → index-DdRjYhiJ.d.mts.map} +1 -1
- package/dist/index-DuriFjYD.d.mts +115 -0
- package/dist/index-DuriFjYD.d.mts.map +1 -0
- package/dist/index.cjs +4 -1
- package/dist/index.d.cts +26 -3
- package/dist/index.d.cts.map +1 -0
- package/dist/index.d.mts +26 -3
- package/dist/index.d.mts.map +1 -0
- package/dist/index.mjs +3 -2
- package/dist/kysely-BHYV-WC-.d.cts +216 -0
- package/dist/kysely-BHYV-WC-.d.cts.map +1 -0
- package/dist/kysely-CAW3QSqp.d.mts +216 -0
- package/dist/kysely-CAW3QSqp.d.mts.map +1 -0
- package/dist/kysely-Cs4uPO8k.mjs +371 -0
- package/dist/kysely-Cs4uPO8k.mjs.map +1 -0
- package/dist/kysely-CukArHJ0.cjs +384 -0
- package/dist/kysely-CukArHJ0.cjs.map +1 -0
- package/dist/{telemetry-DGcFlVpB.d.cts → lambdaTelemetry-8vnmVZQ5.d.cts} +2 -2
- package/dist/lambdaTelemetry-8vnmVZQ5.d.cts.map +1 -0
- package/dist/{telemetry-DGcFlVpB.d.mts → lambdaTelemetry-8vnmVZQ5.d.mts} +2 -2
- package/dist/lambdaTelemetry-8vnmVZQ5.d.mts.map +1 -0
- package/dist/mobile-app.cjs +74 -0
- package/dist/mobile-app.cjs.map +1 -0
- package/dist/mobile-app.d.cts +73 -0
- package/dist/mobile-app.d.cts.map +1 -0
- package/dist/mobile-app.d.mts +73 -0
- package/dist/mobile-app.d.mts.map +1 -0
- package/dist/mobile-app.mjs +73 -0
- package/dist/mobile-app.mjs.map +1 -0
- package/dist/object-storage.cjs +8 -1
- package/dist/object-storage.cjs.map +1 -1
- package/dist/object-storage.d.cts +10 -1
- package/dist/object-storage.d.cts.map +1 -1
- package/dist/object-storage.d.mts +10 -1
- package/dist/object-storage.d.mts.map +1 -1
- package/dist/object-storage.mjs +7 -2
- package/dist/object-storage.mjs.map +1 -1
- package/dist/pattern-C1CEcglD.mjs +241 -0
- package/dist/pattern-C1CEcglD.mjs.map +1 -0
- package/dist/pattern-QFaUIr77.cjs +288 -0
- package/dist/pattern-QFaUIr77.cjs.map +1 -0
- package/dist/processors/index.cjs +214 -0
- package/dist/processors/index.cjs.map +1 -0
- package/dist/processors/index.d.cts +78 -0
- package/dist/processors/index.d.cts.map +1 -0
- package/dist/processors/index.d.mts +78 -0
- package/dist/processors/index.d.mts.map +1 -0
- package/dist/processors/index.mjs +193 -0
- package/dist/processors/index.mjs.map +1 -0
- package/dist/queue/index.cjs +5 -192
- package/dist/queue/index.d.cts +3 -53
- package/dist/queue/index.d.mts +3 -53
- package/dist/queue/index.mjs +3 -190
- package/dist/random-password.cjs +86 -0
- package/dist/random-password.cjs.map +1 -0
- package/dist/random-password.d.cts +30 -0
- package/dist/random-password.d.cts.map +1 -0
- package/dist/random-password.d.mts +30 -0
- package/dist/random-password.d.mts.map +1 -0
- package/dist/random-password.mjs +84 -0
- package/dist/random-password.mjs.map +1 -0
- package/dist/{lazyAccessors-BHtcqgz2.mjs → readRequestBody-BTIl3k-D.mjs} +99 -39
- package/dist/readRequestBody-BTIl3k-D.mjs.map +1 -0
- package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-Dej_L3c4.cjs} +118 -46
- package/dist/readRequestBody-Dej_L3c4.cjs.map +1 -0
- package/dist/requestLogger-BZcXwdBs.cjs +207 -0
- package/dist/requestLogger-BZcXwdBs.cjs.map +1 -0
- package/dist/requestLogger-pA4gi3E1.mjs +178 -0
- package/dist/requestLogger-pA4gi3E1.mjs.map +1 -0
- package/dist/rest-api.cjs +76 -43
- package/dist/rest-api.cjs.map +1 -1
- package/dist/rest-api.d.cts +64 -31
- package/dist/rest-api.d.cts.map +1 -1
- package/dist/rest-api.d.mts +64 -31
- package/dist/rest-api.d.mts.map +1 -1
- package/dist/rest-api.mjs +76 -43
- package/dist/rest-api.mjs.map +1 -1
- package/dist/runSubscriber-B1Yg4dID.cjs +128 -0
- package/dist/runSubscriber-B1Yg4dID.cjs.map +1 -0
- package/dist/runSubscriber-JCgkeYbE.mjs +111 -0
- package/dist/runSubscriber-JCgkeYbE.mjs.map +1 -0
- package/dist/shutdown-BMJmAhSt.cjs +38 -0
- package/dist/shutdown-BMJmAhSt.cjs.map +1 -0
- package/dist/shutdown-C7xa8x9S.mjs +27 -0
- package/dist/shutdown-C7xa8x9S.mjs.map +1 -0
- package/dist/site.cjs +9 -3
- package/dist/site.cjs.map +1 -1
- package/dist/site.d.cts +44 -1
- package/dist/site.d.cts.map +1 -1
- package/dist/site.d.mts +44 -1
- package/dist/site.d.mts.map +1 -1
- package/dist/site.mjs +9 -3
- package/dist/site.mjs.map +1 -1
- package/dist/stages-DaTaoQei.d.cts +73 -0
- package/dist/stages-DaTaoQei.d.cts.map +1 -0
- package/dist/stages-DaTaoQei.d.mts +73 -0
- package/dist/stages-DaTaoQei.d.mts.map +1 -0
- package/dist/subscribers/index.cjs +134 -1
- package/dist/subscribers/index.cjs.map +1 -0
- package/dist/subscribers/index.d.cts +74 -3
- package/dist/subscribers/index.d.cts.map +1 -0
- package/dist/subscribers/index.d.mts +74 -3
- package/dist/subscribers/index.d.mts.map +1 -0
- package/dist/subscribers/index.mjs +132 -2
- package/dist/subscribers/index.mjs.map +1 -0
- package/dist/telemetry-B48RLjyk.d.cts +40 -0
- package/dist/telemetry-B48RLjyk.d.cts.map +1 -0
- package/dist/telemetry-BEoBn6GO.d.mts +40 -0
- package/dist/telemetry-BEoBn6GO.d.mts.map +1 -0
- package/dist/telemetry.cjs +56 -0
- package/dist/telemetry.cjs.map +1 -0
- package/dist/telemetry.d.cts +2 -0
- package/dist/telemetry.d.mts +2 -0
- package/dist/telemetry.mjs +55 -0
- package/dist/telemetry.mjs.map +1 -0
- package/dist/topic/index.cjs +2 -134
- package/dist/topic/index.d.cts +2 -3
- package/dist/topic/index.d.mts +2 -3
- package/dist/topic/index.mjs +2 -132
- package/dist/tracing-Bbj1uoFJ.mjs +127 -0
- package/dist/tracing-Bbj1uoFJ.mjs.map +1 -0
- package/dist/tracing-C0ooU0V2.cjs +150 -0
- package/dist/tracing-C0ooU0V2.cjs.map +1 -0
- package/dist/websocket-api.cjs +769 -0
- package/dist/websocket-api.cjs.map +1 -0
- package/dist/websocket-api.d.cts +449 -0
- package/dist/websocket-api.d.cts.map +1 -0
- package/dist/websocket-api.d.mts +449 -0
- package/dist/websocket-api.d.mts.map +1 -0
- package/dist/websocket-api.mjs +755 -0
- package/dist/websocket-api.mjs.map +1 -0
- package/dist/worker.cjs +70 -23
- package/dist/worker.cjs.map +1 -1
- package/dist/worker.d.cts +86 -36
- package/dist/worker.d.cts.map +1 -1
- package/dist/worker.d.mts +87 -37
- package/dist/worker.d.mts.map +1 -1
- package/dist/worker.mjs +70 -23
- package/dist/worker.mjs.map +1 -1
- package/package.json +145 -44
- package/dist/Construct-BeYVu_QF.mjs.map +0 -1
- package/dist/Construct-DfbwIntp.d.cts +0 -115
- package/dist/Construct-DfbwIntp.d.cts.map +0 -1
- package/dist/Construct-DqdlARxq.cjs.map +0 -1
- package/dist/Construct-l5aOn_jv.d.mts +0 -115
- package/dist/Construct-l5aOn_jv.d.mts.map +0 -1
- package/dist/Cron-DKqnnTdH.d.cts.map +0 -1
- package/dist/Cron-SyqS5oWJ.d.mts.map +0 -1
- package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
- package/dist/CronBuilder-CRGnDfTq.d.mts +0 -41
- package/dist/CronBuilder-CRGnDfTq.d.mts.map +0 -1
- package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
- package/dist/CronBuilder-Df1q9PNy.d.cts +0 -41
- package/dist/CronBuilder-Df1q9PNy.d.cts.map +0 -1
- package/dist/Endpoint-BCiCYvx2.mjs +0 -1665
- package/dist/Endpoint-BCiCYvx2.mjs.map +0 -1
- package/dist/Endpoint-C6yyHpRS.d.cts.map +0 -1
- package/dist/Endpoint-DuT4TEEq.d.mts.map +0 -1
- package/dist/Endpoint-s0AyrQGC.cjs +0 -1683
- package/dist/Endpoint-s0AyrQGC.cjs.map +0 -1
- package/dist/EndpointFactory-M8OQKZRY.cjs.map +0 -1
- package/dist/EndpointFactory-ptPR1cXw.mjs.map +0 -1
- package/dist/HonoEndpointAdaptor-7QagYKdP.cjs.map +0 -1
- package/dist/HonoEndpointAdaptor-CYHA0WAt.mjs.map +0 -1
- package/dist/Queue-D9X6OoON.d.mts.map +0 -1
- package/dist/Queue-DYPB2KWL.d.cts.map +0 -1
- package/dist/Subscriber-C4heaAyO.d.mts +0 -51
- package/dist/Subscriber-C4heaAyO.d.mts.map +0 -1
- package/dist/Subscriber-CotDUELC.d.cts +0 -51
- package/dist/Subscriber-CotDUELC.d.cts.map +0 -1
- package/dist/SubscriberBuilder-BEv0eoHy.d.cts +0 -59
- package/dist/SubscriberBuilder-BEv0eoHy.d.cts.map +0 -1
- package/dist/SubscriberBuilder-C0ZEtGDI.cjs +0 -125
- package/dist/SubscriberBuilder-C0ZEtGDI.cjs.map +0 -1
- package/dist/SubscriberBuilder-h7B_cHMr.mjs +0 -114
- package/dist/SubscriberBuilder-h7B_cHMr.mjs.map +0 -1
- package/dist/SubscriberBuilder-tyH5yTk5.d.mts +0 -59
- package/dist/SubscriberBuilder-tyH5yTk5.d.mts.map +0 -1
- package/dist/Topic-DEVGo0Dm.d.cts +0 -89
- package/dist/Topic-DEVGo0Dm.d.cts.map +0 -1
- package/dist/Topic-zk_6Gthr.d.mts +0 -89
- package/dist/Topic-zk_6Gthr.d.mts.map +0 -1
- package/dist/auth.d.cts.map +0 -1
- package/dist/auth.d.mts.map +0 -1
- package/dist/cache.d.cts.map +0 -1
- package/dist/cache.d.mts.map +0 -1
- package/dist/construct-interface-DPlxfpoS.d.mts.map +0 -1
- package/dist/construct-interface-DgXTJcOD.d.cts.map +0 -1
- package/dist/credential.cjs.map +0 -1
- package/dist/credential.d.cts.map +0 -1
- package/dist/credential.d.mts.map +0 -1
- package/dist/credential.mjs.map +0 -1
- package/dist/database/kysely.cjs.map +0 -1
- package/dist/database/kysely.d.cts.map +0 -1
- package/dist/database/kysely.d.mts.map +0 -1
- package/dist/database/kysely.mjs.map +0 -1
- package/dist/functions-B6qCvfmy.cjs.map +0 -1
- package/dist/functions-C53GW2eQ.mjs.map +0 -1
- package/dist/index-B2urf3YI.d.cts +0 -26
- package/dist/index-B2urf3YI.d.cts.map +0 -1
- package/dist/index-BPSZ_Lp_.d.cts.map +0 -1
- package/dist/index-BoZ-iisU.d.mts.map +0 -1
- package/dist/index-CdaU--_B.d.cts +0 -165
- package/dist/index-CdaU--_B.d.cts.map +0 -1
- package/dist/index-DMCDvnsM.d.mts +0 -26
- package/dist/index-DMCDvnsM.d.mts.map +0 -1
- package/dist/index-PQRWOQj4.d.mts +0 -165
- package/dist/index-PQRWOQj4.d.mts.map +0 -1
- package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
- package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
- package/dist/processAudits-BpRlPQMW.mjs +0 -77
- package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
- package/dist/processAudits-D_2W5x8k.cjs +0 -88
- package/dist/processAudits-D_2W5x8k.cjs.map +0 -1
- package/dist/queue/index.cjs.map +0 -1
- package/dist/queue/index.d.cts.map +0 -1
- package/dist/queue/index.d.mts.map +0 -1
- package/dist/queue/index.mjs.map +0 -1
- package/dist/telemetry-DGcFlVpB.d.cts.map +0 -1
- package/dist/telemetry-DGcFlVpB.d.mts.map +0 -1
- package/dist/topic/index.cjs.map +0 -1
- package/dist/topic/index.mjs.map +0 -1
|
@@ -1,4 +1,137 @@
|
|
|
1
1
|
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
-
const require_SubscriberBuilder = require("../SubscriberBuilder-
|
|
2
|
+
const require_SubscriberBuilder = require("../SubscriberBuilder-CQst6Iz3.cjs");
|
|
3
|
+
const require_runSubscriber = require("../runSubscriber-B1Yg4dID.cjs");
|
|
4
|
+
let _geekmidas_events = require("@geekmidas/events");
|
|
5
|
+
let _geekmidas_services = require("@geekmidas/services");
|
|
6
|
+
let _geekmidas_errors = require("@geekmidas/errors");
|
|
7
|
+
let _geekmidas_events_sns = require("@geekmidas/events/sns");
|
|
8
|
+
//#region src/subscribers/SnsPushSubscriberAdaptor.ts
|
|
9
|
+
/**
|
|
10
|
+
* A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
|
|
11
|
+
* poller.
|
|
12
|
+
*
|
|
13
|
+
* The notification is read as the Lambda event SNS would have invoked a
|
|
14
|
+
* function with, and run through the same parsing, services and handler as the
|
|
15
|
+
* Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
|
|
16
|
+
* server serving this route has no reason to install `@middy/core`.
|
|
17
|
+
*/
|
|
18
|
+
var SnsPushSubscriberAdaptor = class {
|
|
19
|
+
envParser;
|
|
20
|
+
subscriber;
|
|
21
|
+
options;
|
|
22
|
+
constructor(envParser, subscriber, options) {
|
|
23
|
+
this.envParser = envParser;
|
|
24
|
+
this.subscriber = subscriber;
|
|
25
|
+
this.options = options;
|
|
26
|
+
}
|
|
27
|
+
async handle(body, request = {}) {
|
|
28
|
+
const message = body;
|
|
29
|
+
if (typeof message?.Type !== "string" || !message.TopicArn) return refuse(400, "not an SNS message");
|
|
30
|
+
if (message.TopicArn !== this.options.topicArn) return refuse(403, `not subscribed to ${message.TopicArn}`);
|
|
31
|
+
if (this.options.verify) try {
|
|
32
|
+
await (0, _geekmidas_events_sns.verifySnsMessage)(message);
|
|
33
|
+
} catch (error) {
|
|
34
|
+
this.subscriber.logger.warn({
|
|
35
|
+
err: error,
|
|
36
|
+
topicArn: message.TopicArn
|
|
37
|
+
}, "Refused an SNS message that did not verify");
|
|
38
|
+
return refuse(403, error.name);
|
|
39
|
+
}
|
|
40
|
+
switch (message.Type) {
|
|
41
|
+
case "SubscriptionConfirmation":
|
|
42
|
+
if (this.options.confirm) {
|
|
43
|
+
await this.options.confirm(message);
|
|
44
|
+
this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
|
|
45
|
+
return {
|
|
46
|
+
status: 200,
|
|
47
|
+
body: { status: "confirmed" }
|
|
48
|
+
};
|
|
49
|
+
}
|
|
50
|
+
await (0, _geekmidas_events_sns.confirmSnsSubscription)(this.options.emulatorEndpoint && message.SubscribeURL ? {
|
|
51
|
+
...message,
|
|
52
|
+
SubscribeURL: throughEndpoint(message.SubscribeURL, this.options.emulatorEndpoint)
|
|
53
|
+
} : message);
|
|
54
|
+
this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
|
|
55
|
+
return {
|
|
56
|
+
status: 200,
|
|
57
|
+
body: { status: "confirmed" }
|
|
58
|
+
};
|
|
59
|
+
case "Notification":
|
|
60
|
+
if (this.options.subscriptionArn && request.subscriptionArn !== this.options.subscriptionArn) {
|
|
61
|
+
this.subscriber.logger.warn({
|
|
62
|
+
topicArn: message.TopicArn,
|
|
63
|
+
subscriptionArn: request.subscriptionArn
|
|
64
|
+
}, "Refused an SNS notification from a subscription the deploy did not make");
|
|
65
|
+
return refuse(403, "not the recorded subscription");
|
|
66
|
+
}
|
|
67
|
+
try {
|
|
68
|
+
await this.notify(message);
|
|
69
|
+
return {
|
|
70
|
+
status: 200,
|
|
71
|
+
body: { status: "ok" }
|
|
72
|
+
};
|
|
73
|
+
} catch (error) {
|
|
74
|
+
return refuse(500, error.name);
|
|
75
|
+
}
|
|
76
|
+
default: return {
|
|
77
|
+
status: 200,
|
|
78
|
+
body: { status: "ignored" }
|
|
79
|
+
};
|
|
80
|
+
}
|
|
81
|
+
}
|
|
82
|
+
async notify(message) {
|
|
83
|
+
const requestId = message.MessageId;
|
|
84
|
+
const logger = this.subscriber.logger.child({ requestId });
|
|
85
|
+
await (0, _geekmidas_services.runWithRequestContext)({
|
|
86
|
+
logger,
|
|
87
|
+
requestId,
|
|
88
|
+
startTime: Date.now(),
|
|
89
|
+
operation: `subscriber ${this.subscriber.topicName ?? "sns"}`
|
|
90
|
+
}, () => (0, _geekmidas_events.consumeTraced)({
|
|
91
|
+
system: "aws_sns",
|
|
92
|
+
destination: this.subscriber.topicName ?? message.TopicArn.split(":").pop() ?? message.TopicArn,
|
|
93
|
+
type: message.MessageAttributes?.type?.Value,
|
|
94
|
+
messageId: message.MessageId
|
|
95
|
+
}, (0, _geekmidas_events.carrierFromAttributes)(message.MessageAttributes), () => this.run(message, logger)));
|
|
96
|
+
}
|
|
97
|
+
async run(message, logger) {
|
|
98
|
+
try {
|
|
99
|
+
const { services, db } = await require_runSubscriber.subscriberContext(this.subscriber, this.envParser);
|
|
100
|
+
const events = await require_runSubscriber.subscribedEvents(this.subscriber, (0, _geekmidas_events_sns.toSnsEvent)(message), logger);
|
|
101
|
+
await require_runSubscriber.runSubscriber(this.subscriber, {
|
|
102
|
+
events,
|
|
103
|
+
services,
|
|
104
|
+
logger,
|
|
105
|
+
db
|
|
106
|
+
});
|
|
107
|
+
} catch (error) {
|
|
108
|
+
logger.error(error, "Error processing subscriber");
|
|
109
|
+
throw (0, _geekmidas_errors.wrapError)(error);
|
|
110
|
+
}
|
|
111
|
+
}
|
|
112
|
+
};
|
|
113
|
+
/** `url`, sent to `endpoint`'s origin instead of its own. */
|
|
114
|
+
function throughEndpoint(url, endpoint) {
|
|
115
|
+
const target = new URL(url);
|
|
116
|
+
const origin = new URL(endpoint);
|
|
117
|
+
target.protocol = origin.protocol;
|
|
118
|
+
target.host = origin.host;
|
|
119
|
+
return target.toString();
|
|
120
|
+
}
|
|
121
|
+
function refuse(status, error) {
|
|
122
|
+
return {
|
|
123
|
+
status,
|
|
124
|
+
body: {
|
|
125
|
+
status: "refused",
|
|
126
|
+
error
|
|
127
|
+
}
|
|
128
|
+
};
|
|
129
|
+
}
|
|
130
|
+
//#endregion
|
|
131
|
+
exports.ObjectSubscriberBuilder = require_SubscriberBuilder.ObjectSubscriberBuilder;
|
|
132
|
+
exports.ObjectSubscriberHasNoEvents = require_SubscriberBuilder.ObjectSubscriberHasNoEvents;
|
|
133
|
+
exports.SnsPushSubscriberAdaptor = SnsPushSubscriberAdaptor;
|
|
3
134
|
exports.Subscriber = require_SubscriberBuilder.Subscriber;
|
|
4
135
|
exports.SubscriberBuilder = require_SubscriberBuilder.SubscriberBuilder;
|
|
136
|
+
|
|
137
|
+
//# sourceMappingURL=index.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.cjs","names":["verifySnsMessage","confirmSnsSubscription","runWithRequestContext","consumeTraced","carrierFromAttributes","subscriberContext","subscribedEvents","toSnsEvent","runSubscriber","wrapError"],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport { wrapError } from '@geekmidas/errors';\nimport { carrierFromAttributes, consumeTraced } from '@geekmidas/events';\nimport {\n\tconfirmSnsSubscription,\n\ttype SnsHttpMessage,\n\ttoSnsEvent,\n\tverifySnsMessage,\n} from '@geekmidas/events/sns';\nimport { runWithRequestContext } from '@geekmidas/services';\nimport {\n\trunSubscriber,\n\tsubscribedEvents,\n\tsubscriberContext,\n} from './runSubscriber';\nimport type { Subscriber } from './Subscriber';\n\nexport interface SnsPushOptions {\n\t/** The topic this subscriber is subscribed to. Anything else is refused. */\n\ttopicArn: string;\n\t/**\n\t * Verify each message's signature. Off only against an emulator, which\n\t * signs nothing — decided by the connection string's endpoint, never by\n\t * anything the request says about itself.\n\t */\n\tverify: boolean;\n\t/**\n\t * The emulator's address, as this server was configured with it. An\n\t * emulator names itself in `SubscribeURL` by the port it listens on inside\n\t * its container, which is not the port published to the host — so against\n\t * one, the confirmation is sent here instead. From configuration, never\n\t * from the request.\n\t */\n\temulatorEndpoint?: string;\n\t/**\n\t * The subscription the deploy made for this route, as it recorded it\n\t * (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its\n\t * `x-amz-sns-subscription-arn` header is refused — a subscription someone\n\t * added by hand, pointing at this route.\n\t *\n\t * Defence in depth, not authentication: SNS does not sign its headers.\n\t * What authenticates a message is its signature and its `TopicArn`.\n\t */\n\tsubscriptionArn?: string;\n\t/**\n\t * How a confirmation is confirmed. By visiting its `SubscribeURL` when\n\t * unset — what an emulator takes. Against SNS itself, the server confirms\n\t * through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`\n\t * every notification carries cannot cut the route off.\n\t */\n\tconfirm?: (message: SnsHttpMessage) => Promise<unknown>;\n}\n\n/** What SNS said about a request, outside its signed body. */\nexport interface SnsPushRequest {\n\t/** The `x-amz-sns-subscription-arn` header. */\n\tsubscriptionArn?: string;\n}\n\n/** What to answer SNS with. A non-2xx tells SNS to retry. */\nexport interface SnsPushResponse {\n\tstatus: 200 | 400 | 403 | 500;\n\tbody: { status: string; error?: string };\n}\n\n/**\n * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a\n * poller.\n *\n * The notification is read as the Lambda event SNS would have invoked a\n * function with, and run through the same parsing, services and handler as the\n * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a\n * server serving this route has no reason to install `@middy/core`.\n */\nexport class SnsPushSubscriberAdaptor {\n\tconstructor(\n\t\tprivate readonly envParser: EnvironmentParser<{}>,\n\t\treadonly subscriber: Subscriber<any, any, any, any, any, any, any>,\n\t\tprivate readonly options: SnsPushOptions,\n\t) {}\n\n\tasync handle(\n\t\tbody: unknown,\n\t\trequest: SnsPushRequest = {},\n\t): Promise<SnsPushResponse> {\n\t\tconst message = body as SnsHttpMessage;\n\t\tif (typeof message?.Type !== 'string' || !message.TopicArn) {\n\t\t\treturn refuse(400, 'not an SNS message');\n\t\t}\n\t\t// Checked before the signature: a genuine message for another topic is\n\t\t// still not this subscriber's to confirm or to handle.\n\t\tif (message.TopicArn !== this.options.topicArn) {\n\t\t\treturn refuse(403, `not subscribed to ${message.TopicArn}`);\n\t\t}\n\n\t\tif (this.options.verify) {\n\t\t\ttry {\n\t\t\t\tawait verifySnsMessage(message);\n\t\t\t} catch (error) {\n\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t{ err: error, topicArn: message.TopicArn },\n\t\t\t\t\t'Refused an SNS message that did not verify',\n\t\t\t\t);\n\t\t\t\treturn refuse(403, (error as Error).name);\n\t\t\t}\n\t\t}\n\n\t\tswitch (message.Type) {\n\t\t\tcase 'SubscriptionConfirmation':\n\t\t\t\tif (this.options.confirm) {\n\t\t\t\t\tawait this.options.confirm(message);\n\t\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t\t);\n\t\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\t\t}\n\t\t\t\tawait confirmSnsSubscription(\n\t\t\t\t\tthis.options.emulatorEndpoint && message.SubscribeURL\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t...message,\n\t\t\t\t\t\t\t\tSubscribeURL: throughEndpoint(\n\t\t\t\t\t\t\t\t\tmessage.SubscribeURL,\n\t\t\t\t\t\t\t\t\tthis.options.emulatorEndpoint,\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: message,\n\t\t\t\t);\n\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t);\n\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\tcase 'Notification':\n\t\t\t\tif (\n\t\t\t\t\tthis.options.subscriptionArn &&\n\t\t\t\t\trequest.subscriptionArn !== this.options.subscriptionArn\n\t\t\t\t) {\n\t\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttopicArn: message.TopicArn,\n\t\t\t\t\t\t\tsubscriptionArn: request.subscriptionArn,\n\t\t\t\t\t\t},\n\t\t\t\t\t\t'Refused an SNS notification from a subscription the deploy did not make',\n\t\t\t\t\t);\n\t\t\t\t\treturn refuse(403, 'not the recorded subscription');\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait this.notify(message);\n\t\t\t\t\treturn { status: 200, body: { status: 'ok' } };\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Already logged. A 500 makes SNS retry, which is the point of\n\t\t\t\t\t// answering at all.\n\t\t\t\t\treturn refuse(500, (error as Error).name);\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn { status: 200, body: { status: 'ignored' } };\n\t\t}\n\t}\n\n\tprivate async notify(message: SnsHttpMessage): Promise<void> {\n\t\tconst requestId = message.MessageId;\n\t\tconst logger = this.subscriber.logger.child({ requestId });\n\n\t\tawait runWithRequestContext(\n\t\t\t{\n\t\t\t\tlogger,\n\t\t\t\trequestId,\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\toperation: `subscriber ${this.subscriber.topicName ?? 'sns'}`,\n\t\t\t},\n\t\t\t// A CONSUMER span, child of the publisher's: SNS hands the trace\n\t\t\t// context on in the message attributes it was published with.\n\t\t\t() =>\n\t\t\t\tconsumeTraced(\n\t\t\t\t\t{\n\t\t\t\t\t\tsystem: 'aws_sns',\n\t\t\t\t\t\tdestination:\n\t\t\t\t\t\t\tthis.subscriber.topicName ??\n\t\t\t\t\t\t\tmessage.TopicArn.split(':').pop() ??\n\t\t\t\t\t\t\tmessage.TopicArn,\n\t\t\t\t\t\ttype: message.MessageAttributes?.type?.Value,\n\t\t\t\t\t\tmessageId: message.MessageId,\n\t\t\t\t\t},\n\t\t\t\t\tcarrierFromAttributes(message.MessageAttributes),\n\t\t\t\t\t() => this.run(message, logger),\n\t\t\t\t),\n\t\t);\n\t}\n\n\tprivate async run(\n\t\tmessage: SnsHttpMessage,\n\t\tlogger: Subscriber<any, any, any, any, any, any, any>['logger'],\n\t): Promise<void> {\n\t\ttry {\n\t\t\tconst { services, db } = await subscriberContext(\n\t\t\t\tthis.subscriber,\n\t\t\t\tthis.envParser,\n\t\t\t);\n\t\t\tconst events = await subscribedEvents(\n\t\t\t\tthis.subscriber,\n\t\t\t\ttoSnsEvent(message),\n\t\t\t\tlogger,\n\t\t\t);\n\t\t\tawait runSubscriber(this.subscriber, {\n\t\t\t\tevents,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t\tdb,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tlogger.error(error as object, 'Error processing subscriber');\n\t\t\tthrow wrapError(error);\n\t\t}\n\t}\n}\n\n/** `url`, sent to `endpoint`'s origin instead of its own. */\nfunction throughEndpoint(url: string, endpoint: string): string {\n\tconst target = new URL(url);\n\tconst origin = new URL(endpoint);\n\ttarget.protocol = origin.protocol;\n\ttarget.host = origin.host;\n\treturn target.toString();\n}\n\nfunction refuse(\n\tstatus: SnsPushResponse['status'],\n\terror: string,\n): SnsPushResponse {\n\treturn { status, body: { status: 'refused', error } };\n}\n"],"mappings":"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"}
|
|
@@ -1,3 +1,74 @@
|
|
|
1
|
-
import { t as Subscriber } from "../Subscriber-
|
|
2
|
-
import {
|
|
3
|
-
|
|
1
|
+
import { t as Subscriber } from "../Subscriber-BdCtfFXL.cjs";
|
|
2
|
+
import { a as ObjectSubscriberHasNoEvents, i as ObjectSubscriberHandler, n as ObjectSubscriberBuilder, o as SubscriberBuilder, r as ObjectSubscriberContext, t as ObjectSubscriber } from "../ObjectSubscriberBuilder-l-64yUiF.cjs";
|
|
3
|
+
import { EnvironmentParser } from "@geekmidas/envkit";
|
|
4
|
+
import { SnsHttpMessage } from "@geekmidas/events/sns";
|
|
5
|
+
//#region src/subscribers/SnsPushSubscriberAdaptor.d.ts
|
|
6
|
+
interface SnsPushOptions {
|
|
7
|
+
/** The topic this subscriber is subscribed to. Anything else is refused. */
|
|
8
|
+
topicArn: string;
|
|
9
|
+
/**
|
|
10
|
+
* Verify each message's signature. Off only against an emulator, which
|
|
11
|
+
* signs nothing — decided by the connection string's endpoint, never by
|
|
12
|
+
* anything the request says about itself.
|
|
13
|
+
*/
|
|
14
|
+
verify: boolean;
|
|
15
|
+
/**
|
|
16
|
+
* The emulator's address, as this server was configured with it. An
|
|
17
|
+
* emulator names itself in `SubscribeURL` by the port it listens on inside
|
|
18
|
+
* its container, which is not the port published to the host — so against
|
|
19
|
+
* one, the confirmation is sent here instead. From configuration, never
|
|
20
|
+
* from the request.
|
|
21
|
+
*/
|
|
22
|
+
emulatorEndpoint?: string;
|
|
23
|
+
/**
|
|
24
|
+
* The subscription the deploy made for this route, as it recorded it
|
|
25
|
+
* (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its
|
|
26
|
+
* `x-amz-sns-subscription-arn` header is refused — a subscription someone
|
|
27
|
+
* added by hand, pointing at this route.
|
|
28
|
+
*
|
|
29
|
+
* Defence in depth, not authentication: SNS does not sign its headers.
|
|
30
|
+
* What authenticates a message is its signature and its `TopicArn`.
|
|
31
|
+
*/
|
|
32
|
+
subscriptionArn?: string;
|
|
33
|
+
/**
|
|
34
|
+
* How a confirmation is confirmed. By visiting its `SubscribeURL` when
|
|
35
|
+
* unset — what an emulator takes. Against SNS itself, the server confirms
|
|
36
|
+
* through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`
|
|
37
|
+
* every notification carries cannot cut the route off.
|
|
38
|
+
*/
|
|
39
|
+
confirm?: (message: SnsHttpMessage) => Promise<unknown>;
|
|
40
|
+
}
|
|
41
|
+
/** What SNS said about a request, outside its signed body. */
|
|
42
|
+
interface SnsPushRequest {
|
|
43
|
+
/** The `x-amz-sns-subscription-arn` header. */
|
|
44
|
+
subscriptionArn?: string;
|
|
45
|
+
}
|
|
46
|
+
/** What to answer SNS with. A non-2xx tells SNS to retry. */
|
|
47
|
+
interface SnsPushResponse {
|
|
48
|
+
status: 200 | 400 | 403 | 500;
|
|
49
|
+
body: {
|
|
50
|
+
status: string;
|
|
51
|
+
error?: string;
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
|
|
56
|
+
* poller.
|
|
57
|
+
*
|
|
58
|
+
* The notification is read as the Lambda event SNS would have invoked a
|
|
59
|
+
* function with, and run through the same parsing, services and handler as the
|
|
60
|
+
* Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
|
|
61
|
+
* server serving this route has no reason to install `@middy/core`.
|
|
62
|
+
*/
|
|
63
|
+
export declare class SnsPushSubscriberAdaptor {
|
|
64
|
+
private readonly envParser;
|
|
65
|
+
readonly subscriber: Subscriber<any, any, any, any, any, any, any>;
|
|
66
|
+
private readonly options;
|
|
67
|
+
constructor(envParser: EnvironmentParser<{}>, subscriber: Subscriber<any, any, any, any, any, any, any>, options: SnsPushOptions);
|
|
68
|
+
handle(body: unknown, request?: SnsPushRequest): Promise<SnsPushResponse>;
|
|
69
|
+
private notify;
|
|
70
|
+
private run;
|
|
71
|
+
}
|
|
72
|
+
//#endregion
|
|
73
|
+
export { type ObjectSubscriber, ObjectSubscriberBuilder, type ObjectSubscriberContext, type ObjectSubscriberHandler, ObjectSubscriberHasNoEvents, type SnsPushOptions, type SnsPushRequest, type SnsPushResponse, Subscriber, SubscriberBuilder };
|
|
74
|
+
//# sourceMappingURL=index.d.cts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.cts","names":[],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"mappings":";;;;;UAiBiB;;EAEhB;;;;;;EAMA;;;;;;;;EAQA;;;;;;;;;;EAUA;;;;;;;EAOA,WAAW,SAAS,mBAAmB;;;UAIvB;;EAEhB;;;UAIgB;EAChB;EACA;IAAQ;IAAgB;;;;;;;;;;;;qBAYZ;mBAEM;WACR,YAAY;mBACJ;EAHlB,YACkB,WAAW,uBACnB,YAAY,+CACJ,SAAS;EAGrB,OACL,eACA,UAAS,iBACP,QAAQ;UA4EG;UA8BA"}
|
|
@@ -1,3 +1,74 @@
|
|
|
1
|
-
import { t as Subscriber } from "../Subscriber-
|
|
2
|
-
import {
|
|
3
|
-
|
|
1
|
+
import { t as Subscriber } from "../Subscriber-DDo4HFNn.mjs";
|
|
2
|
+
import { a as ObjectSubscriberHasNoEvents, i as ObjectSubscriberHandler, n as ObjectSubscriberBuilder, o as SubscriberBuilder, r as ObjectSubscriberContext, t as ObjectSubscriber } from "../ObjectSubscriberBuilder-HmBwFn2o.mjs";
|
|
3
|
+
import { EnvironmentParser } from "@geekmidas/envkit";
|
|
4
|
+
import { SnsHttpMessage } from "@geekmidas/events/sns";
|
|
5
|
+
//#region src/subscribers/SnsPushSubscriberAdaptor.d.ts
|
|
6
|
+
interface SnsPushOptions {
|
|
7
|
+
/** The topic this subscriber is subscribed to. Anything else is refused. */
|
|
8
|
+
topicArn: string;
|
|
9
|
+
/**
|
|
10
|
+
* Verify each message's signature. Off only against an emulator, which
|
|
11
|
+
* signs nothing — decided by the connection string's endpoint, never by
|
|
12
|
+
* anything the request says about itself.
|
|
13
|
+
*/
|
|
14
|
+
verify: boolean;
|
|
15
|
+
/**
|
|
16
|
+
* The emulator's address, as this server was configured with it. An
|
|
17
|
+
* emulator names itself in `SubscribeURL` by the port it listens on inside
|
|
18
|
+
* its container, which is not the port published to the host — so against
|
|
19
|
+
* one, the confirmation is sent here instead. From configuration, never
|
|
20
|
+
* from the request.
|
|
21
|
+
*/
|
|
22
|
+
emulatorEndpoint?: string;
|
|
23
|
+
/**
|
|
24
|
+
* The subscription the deploy made for this route, as it recorded it
|
|
25
|
+
* (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its
|
|
26
|
+
* `x-amz-sns-subscription-arn` header is refused — a subscription someone
|
|
27
|
+
* added by hand, pointing at this route.
|
|
28
|
+
*
|
|
29
|
+
* Defence in depth, not authentication: SNS does not sign its headers.
|
|
30
|
+
* What authenticates a message is its signature and its `TopicArn`.
|
|
31
|
+
*/
|
|
32
|
+
subscriptionArn?: string;
|
|
33
|
+
/**
|
|
34
|
+
* How a confirmation is confirmed. By visiting its `SubscribeURL` when
|
|
35
|
+
* unset — what an emulator takes. Against SNS itself, the server confirms
|
|
36
|
+
* through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`
|
|
37
|
+
* every notification carries cannot cut the route off.
|
|
38
|
+
*/
|
|
39
|
+
confirm?: (message: SnsHttpMessage) => Promise<unknown>;
|
|
40
|
+
}
|
|
41
|
+
/** What SNS said about a request, outside its signed body. */
|
|
42
|
+
interface SnsPushRequest {
|
|
43
|
+
/** The `x-amz-sns-subscription-arn` header. */
|
|
44
|
+
subscriptionArn?: string;
|
|
45
|
+
}
|
|
46
|
+
/** What to answer SNS with. A non-2xx tells SNS to retry. */
|
|
47
|
+
interface SnsPushResponse {
|
|
48
|
+
status: 200 | 400 | 403 | 500;
|
|
49
|
+
body: {
|
|
50
|
+
status: string;
|
|
51
|
+
error?: string;
|
|
52
|
+
};
|
|
53
|
+
}
|
|
54
|
+
/**
|
|
55
|
+
* A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
|
|
56
|
+
* poller.
|
|
57
|
+
*
|
|
58
|
+
* The notification is read as the Lambda event SNS would have invoked a
|
|
59
|
+
* function with, and run through the same parsing, services and handler as the
|
|
60
|
+
* Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
|
|
61
|
+
* server serving this route has no reason to install `@middy/core`.
|
|
62
|
+
*/
|
|
63
|
+
export declare class SnsPushSubscriberAdaptor {
|
|
64
|
+
private readonly envParser;
|
|
65
|
+
readonly subscriber: Subscriber<any, any, any, any, any, any, any>;
|
|
66
|
+
private readonly options;
|
|
67
|
+
constructor(envParser: EnvironmentParser<{}>, subscriber: Subscriber<any, any, any, any, any, any, any>, options: SnsPushOptions);
|
|
68
|
+
handle(body: unknown, request?: SnsPushRequest): Promise<SnsPushResponse>;
|
|
69
|
+
private notify;
|
|
70
|
+
private run;
|
|
71
|
+
}
|
|
72
|
+
//#endregion
|
|
73
|
+
export { type ObjectSubscriber, ObjectSubscriberBuilder, type ObjectSubscriberContext, type ObjectSubscriberHandler, ObjectSubscriberHasNoEvents, type SnsPushOptions, type SnsPushRequest, type SnsPushResponse, Subscriber, SubscriberBuilder };
|
|
74
|
+
//# sourceMappingURL=index.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.d.mts","names":[],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"mappings":";;;;;UAiBiB;;EAEhB;;;;;;EAMA;;;;;;;;EAQA;;;;;;;;;;EAUA;;;;;;;EAOA,WAAW,SAAS,mBAAmB;;;UAIvB;;EAEhB;;;UAIgB;EAChB;EACA;IAAQ;IAAgB;;;;;;;;;;;;qBAYZ;mBAEM;WACR,YAAY;mBACJ;EAHlB,YACkB,WAAW,uBACnB,YAAY,+CACJ,SAAS;EAGrB,OACL,eACA,UAAS,iBACP,QAAQ;UA4EG;UA8BA"}
|
|
@@ -1,2 +1,132 @@
|
|
|
1
|
-
import { n as Subscriber, t as SubscriberBuilder } from "../SubscriberBuilder-
|
|
2
|
-
|
|
1
|
+
import { i as ObjectSubscriberHasNoEvents, n as Subscriber, r as ObjectSubscriberBuilder, t as SubscriberBuilder } from "../SubscriberBuilder-3msj1U2w.mjs";
|
|
2
|
+
import { n as subscribedEvents, r as subscriberContext, t as runSubscriber } from "../runSubscriber-JCgkeYbE.mjs";
|
|
3
|
+
import { carrierFromAttributes, consumeTraced } from "@geekmidas/events";
|
|
4
|
+
import { runWithRequestContext } from "@geekmidas/services";
|
|
5
|
+
import { wrapError } from "@geekmidas/errors";
|
|
6
|
+
import { confirmSnsSubscription, toSnsEvent, verifySnsMessage } from "@geekmidas/events/sns";
|
|
7
|
+
//#region src/subscribers/SnsPushSubscriberAdaptor.ts
|
|
8
|
+
/**
|
|
9
|
+
* A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a
|
|
10
|
+
* poller.
|
|
11
|
+
*
|
|
12
|
+
* The notification is read as the Lambda event SNS would have invoked a
|
|
13
|
+
* function with, and run through the same parsing, services and handler as the
|
|
14
|
+
* Lambda adaptor — without its middy wrapper, which is Lambda's alone: a
|
|
15
|
+
* server serving this route has no reason to install `@middy/core`.
|
|
16
|
+
*/
|
|
17
|
+
var SnsPushSubscriberAdaptor = class {
|
|
18
|
+
envParser;
|
|
19
|
+
subscriber;
|
|
20
|
+
options;
|
|
21
|
+
constructor(envParser, subscriber, options) {
|
|
22
|
+
this.envParser = envParser;
|
|
23
|
+
this.subscriber = subscriber;
|
|
24
|
+
this.options = options;
|
|
25
|
+
}
|
|
26
|
+
async handle(body, request = {}) {
|
|
27
|
+
const message = body;
|
|
28
|
+
if (typeof message?.Type !== "string" || !message.TopicArn) return refuse(400, "not an SNS message");
|
|
29
|
+
if (message.TopicArn !== this.options.topicArn) return refuse(403, `not subscribed to ${message.TopicArn}`);
|
|
30
|
+
if (this.options.verify) try {
|
|
31
|
+
await verifySnsMessage(message);
|
|
32
|
+
} catch (error) {
|
|
33
|
+
this.subscriber.logger.warn({
|
|
34
|
+
err: error,
|
|
35
|
+
topicArn: message.TopicArn
|
|
36
|
+
}, "Refused an SNS message that did not verify");
|
|
37
|
+
return refuse(403, error.name);
|
|
38
|
+
}
|
|
39
|
+
switch (message.Type) {
|
|
40
|
+
case "SubscriptionConfirmation":
|
|
41
|
+
if (this.options.confirm) {
|
|
42
|
+
await this.options.confirm(message);
|
|
43
|
+
this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
|
|
44
|
+
return {
|
|
45
|
+
status: 200,
|
|
46
|
+
body: { status: "confirmed" }
|
|
47
|
+
};
|
|
48
|
+
}
|
|
49
|
+
await confirmSnsSubscription(this.options.emulatorEndpoint && message.SubscribeURL ? {
|
|
50
|
+
...message,
|
|
51
|
+
SubscribeURL: throughEndpoint(message.SubscribeURL, this.options.emulatorEndpoint)
|
|
52
|
+
} : message);
|
|
53
|
+
this.subscriber.logger.info({ topicArn: message.TopicArn }, "Confirmed SNS subscription");
|
|
54
|
+
return {
|
|
55
|
+
status: 200,
|
|
56
|
+
body: { status: "confirmed" }
|
|
57
|
+
};
|
|
58
|
+
case "Notification":
|
|
59
|
+
if (this.options.subscriptionArn && request.subscriptionArn !== this.options.subscriptionArn) {
|
|
60
|
+
this.subscriber.logger.warn({
|
|
61
|
+
topicArn: message.TopicArn,
|
|
62
|
+
subscriptionArn: request.subscriptionArn
|
|
63
|
+
}, "Refused an SNS notification from a subscription the deploy did not make");
|
|
64
|
+
return refuse(403, "not the recorded subscription");
|
|
65
|
+
}
|
|
66
|
+
try {
|
|
67
|
+
await this.notify(message);
|
|
68
|
+
return {
|
|
69
|
+
status: 200,
|
|
70
|
+
body: { status: "ok" }
|
|
71
|
+
};
|
|
72
|
+
} catch (error) {
|
|
73
|
+
return refuse(500, error.name);
|
|
74
|
+
}
|
|
75
|
+
default: return {
|
|
76
|
+
status: 200,
|
|
77
|
+
body: { status: "ignored" }
|
|
78
|
+
};
|
|
79
|
+
}
|
|
80
|
+
}
|
|
81
|
+
async notify(message) {
|
|
82
|
+
const requestId = message.MessageId;
|
|
83
|
+
const logger = this.subscriber.logger.child({ requestId });
|
|
84
|
+
await runWithRequestContext({
|
|
85
|
+
logger,
|
|
86
|
+
requestId,
|
|
87
|
+
startTime: Date.now(),
|
|
88
|
+
operation: `subscriber ${this.subscriber.topicName ?? "sns"}`
|
|
89
|
+
}, () => consumeTraced({
|
|
90
|
+
system: "aws_sns",
|
|
91
|
+
destination: this.subscriber.topicName ?? message.TopicArn.split(":").pop() ?? message.TopicArn,
|
|
92
|
+
type: message.MessageAttributes?.type?.Value,
|
|
93
|
+
messageId: message.MessageId
|
|
94
|
+
}, carrierFromAttributes(message.MessageAttributes), () => this.run(message, logger)));
|
|
95
|
+
}
|
|
96
|
+
async run(message, logger) {
|
|
97
|
+
try {
|
|
98
|
+
const { services, db } = await subscriberContext(this.subscriber, this.envParser);
|
|
99
|
+
const events = await subscribedEvents(this.subscriber, toSnsEvent(message), logger);
|
|
100
|
+
await runSubscriber(this.subscriber, {
|
|
101
|
+
events,
|
|
102
|
+
services,
|
|
103
|
+
logger,
|
|
104
|
+
db
|
|
105
|
+
});
|
|
106
|
+
} catch (error) {
|
|
107
|
+
logger.error(error, "Error processing subscriber");
|
|
108
|
+
throw wrapError(error);
|
|
109
|
+
}
|
|
110
|
+
}
|
|
111
|
+
};
|
|
112
|
+
/** `url`, sent to `endpoint`'s origin instead of its own. */
|
|
113
|
+
function throughEndpoint(url, endpoint) {
|
|
114
|
+
const target = new URL(url);
|
|
115
|
+
const origin = new URL(endpoint);
|
|
116
|
+
target.protocol = origin.protocol;
|
|
117
|
+
target.host = origin.host;
|
|
118
|
+
return target.toString();
|
|
119
|
+
}
|
|
120
|
+
function refuse(status, error) {
|
|
121
|
+
return {
|
|
122
|
+
status,
|
|
123
|
+
body: {
|
|
124
|
+
status: "refused",
|
|
125
|
+
error
|
|
126
|
+
}
|
|
127
|
+
};
|
|
128
|
+
}
|
|
129
|
+
//#endregion
|
|
130
|
+
export { ObjectSubscriberBuilder, ObjectSubscriberHasNoEvents, SnsPushSubscriberAdaptor, Subscriber, SubscriberBuilder };
|
|
131
|
+
|
|
132
|
+
//# sourceMappingURL=index.mjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"index.mjs","names":[],"sources":["../../src/subscribers/SnsPushSubscriberAdaptor.ts"],"sourcesContent":["import type { EnvironmentParser } from '@geekmidas/envkit';\nimport { wrapError } from '@geekmidas/errors';\nimport { carrierFromAttributes, consumeTraced } from '@geekmidas/events';\nimport {\n\tconfirmSnsSubscription,\n\ttype SnsHttpMessage,\n\ttoSnsEvent,\n\tverifySnsMessage,\n} from '@geekmidas/events/sns';\nimport { runWithRequestContext } from '@geekmidas/services';\nimport {\n\trunSubscriber,\n\tsubscribedEvents,\n\tsubscriberContext,\n} from './runSubscriber';\nimport type { Subscriber } from './Subscriber';\n\nexport interface SnsPushOptions {\n\t/** The topic this subscriber is subscribed to. Anything else is refused. */\n\ttopicArn: string;\n\t/**\n\t * Verify each message's signature. Off only against an emulator, which\n\t * signs nothing — decided by the connection string's endpoint, never by\n\t * anything the request says about itself.\n\t */\n\tverify: boolean;\n\t/**\n\t * The emulator's address, as this server was configured with it. An\n\t * emulator names itself in `SubscribeURL` by the port it listens on inside\n\t * its container, which is not the port published to the host — so against\n\t * one, the confirmation is sent here instead. From configuration, never\n\t * from the request.\n\t */\n\temulatorEndpoint?: string;\n\t/**\n\t * The subscription the deploy made for this route, as it recorded it\n\t * (`GKM_SNS_SUBSCRIPTIONS`). A notification naming another one in its\n\t * `x-amz-sns-subscription-arn` header is refused — a subscription someone\n\t * added by hand, pointing at this route.\n\t *\n\t * Defence in depth, not authentication: SNS does not sign its headers.\n\t * What authenticates a message is its signature and its `TopicArn`.\n\t */\n\tsubscriptionArn?: string;\n\t/**\n\t * How a confirmation is confirmed. By visiting its `SubscribeURL` when\n\t * unset — what an emulator takes. Against SNS itself, the server confirms\n\t * through the API with `AuthenticateOnUnsubscribe`, so the `UnsubscribeURL`\n\t * every notification carries cannot cut the route off.\n\t */\n\tconfirm?: (message: SnsHttpMessage) => Promise<unknown>;\n}\n\n/** What SNS said about a request, outside its signed body. */\nexport interface SnsPushRequest {\n\t/** The `x-amz-sns-subscription-arn` header. */\n\tsubscriptionArn?: string;\n}\n\n/** What to answer SNS with. A non-2xx tells SNS to retry. */\nexport interface SnsPushResponse {\n\tstatus: 200 | 400 | 403 | 500;\n\tbody: { status: string; error?: string };\n}\n\n/**\n * A topic subscriber run by SNS pushing to an HTTP endpoint, rather than by a\n * poller.\n *\n * The notification is read as the Lambda event SNS would have invoked a\n * function with, and run through the same parsing, services and handler as the\n * Lambda adaptor — without its middy wrapper, which is Lambda's alone: a\n * server serving this route has no reason to install `@middy/core`.\n */\nexport class SnsPushSubscriberAdaptor {\n\tconstructor(\n\t\tprivate readonly envParser: EnvironmentParser<{}>,\n\t\treadonly subscriber: Subscriber<any, any, any, any, any, any, any>,\n\t\tprivate readonly options: SnsPushOptions,\n\t) {}\n\n\tasync handle(\n\t\tbody: unknown,\n\t\trequest: SnsPushRequest = {},\n\t): Promise<SnsPushResponse> {\n\t\tconst message = body as SnsHttpMessage;\n\t\tif (typeof message?.Type !== 'string' || !message.TopicArn) {\n\t\t\treturn refuse(400, 'not an SNS message');\n\t\t}\n\t\t// Checked before the signature: a genuine message for another topic is\n\t\t// still not this subscriber's to confirm or to handle.\n\t\tif (message.TopicArn !== this.options.topicArn) {\n\t\t\treturn refuse(403, `not subscribed to ${message.TopicArn}`);\n\t\t}\n\n\t\tif (this.options.verify) {\n\t\t\ttry {\n\t\t\t\tawait verifySnsMessage(message);\n\t\t\t} catch (error) {\n\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t{ err: error, topicArn: message.TopicArn },\n\t\t\t\t\t'Refused an SNS message that did not verify',\n\t\t\t\t);\n\t\t\t\treturn refuse(403, (error as Error).name);\n\t\t\t}\n\t\t}\n\n\t\tswitch (message.Type) {\n\t\t\tcase 'SubscriptionConfirmation':\n\t\t\t\tif (this.options.confirm) {\n\t\t\t\t\tawait this.options.confirm(message);\n\t\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t\t);\n\t\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\t\t}\n\t\t\t\tawait confirmSnsSubscription(\n\t\t\t\t\tthis.options.emulatorEndpoint && message.SubscribeURL\n\t\t\t\t\t\t? {\n\t\t\t\t\t\t\t\t...message,\n\t\t\t\t\t\t\t\tSubscribeURL: throughEndpoint(\n\t\t\t\t\t\t\t\t\tmessage.SubscribeURL,\n\t\t\t\t\t\t\t\t\tthis.options.emulatorEndpoint,\n\t\t\t\t\t\t\t\t),\n\t\t\t\t\t\t\t}\n\t\t\t\t\t\t: message,\n\t\t\t\t);\n\t\t\t\tthis.subscriber.logger.info(\n\t\t\t\t\t{ topicArn: message.TopicArn },\n\t\t\t\t\t'Confirmed SNS subscription',\n\t\t\t\t);\n\t\t\t\treturn { status: 200, body: { status: 'confirmed' } };\n\t\t\tcase 'Notification':\n\t\t\t\tif (\n\t\t\t\t\tthis.options.subscriptionArn &&\n\t\t\t\t\trequest.subscriptionArn !== this.options.subscriptionArn\n\t\t\t\t) {\n\t\t\t\t\tthis.subscriber.logger.warn(\n\t\t\t\t\t\t{\n\t\t\t\t\t\t\ttopicArn: message.TopicArn,\n\t\t\t\t\t\t\tsubscriptionArn: request.subscriptionArn,\n\t\t\t\t\t\t},\n\t\t\t\t\t\t'Refused an SNS notification from a subscription the deploy did not make',\n\t\t\t\t\t);\n\t\t\t\t\treturn refuse(403, 'not the recorded subscription');\n\t\t\t\t}\n\t\t\t\ttry {\n\t\t\t\t\tawait this.notify(message);\n\t\t\t\t\treturn { status: 200, body: { status: 'ok' } };\n\t\t\t\t} catch (error) {\n\t\t\t\t\t// Already logged. A 500 makes SNS retry, which is the point of\n\t\t\t\t\t// answering at all.\n\t\t\t\t\treturn refuse(500, (error as Error).name);\n\t\t\t\t}\n\t\t\tdefault:\n\t\t\t\treturn { status: 200, body: { status: 'ignored' } };\n\t\t}\n\t}\n\n\tprivate async notify(message: SnsHttpMessage): Promise<void> {\n\t\tconst requestId = message.MessageId;\n\t\tconst logger = this.subscriber.logger.child({ requestId });\n\n\t\tawait runWithRequestContext(\n\t\t\t{\n\t\t\t\tlogger,\n\t\t\t\trequestId,\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\toperation: `subscriber ${this.subscriber.topicName ?? 'sns'}`,\n\t\t\t},\n\t\t\t// A CONSUMER span, child of the publisher's: SNS hands the trace\n\t\t\t// context on in the message attributes it was published with.\n\t\t\t() =>\n\t\t\t\tconsumeTraced(\n\t\t\t\t\t{\n\t\t\t\t\t\tsystem: 'aws_sns',\n\t\t\t\t\t\tdestination:\n\t\t\t\t\t\t\tthis.subscriber.topicName ??\n\t\t\t\t\t\t\tmessage.TopicArn.split(':').pop() ??\n\t\t\t\t\t\t\tmessage.TopicArn,\n\t\t\t\t\t\ttype: message.MessageAttributes?.type?.Value,\n\t\t\t\t\t\tmessageId: message.MessageId,\n\t\t\t\t\t},\n\t\t\t\t\tcarrierFromAttributes(message.MessageAttributes),\n\t\t\t\t\t() => this.run(message, logger),\n\t\t\t\t),\n\t\t);\n\t}\n\n\tprivate async run(\n\t\tmessage: SnsHttpMessage,\n\t\tlogger: Subscriber<any, any, any, any, any, any, any>['logger'],\n\t): Promise<void> {\n\t\ttry {\n\t\t\tconst { services, db } = await subscriberContext(\n\t\t\t\tthis.subscriber,\n\t\t\t\tthis.envParser,\n\t\t\t);\n\t\t\tconst events = await subscribedEvents(\n\t\t\t\tthis.subscriber,\n\t\t\t\ttoSnsEvent(message),\n\t\t\t\tlogger,\n\t\t\t);\n\t\t\tawait runSubscriber(this.subscriber, {\n\t\t\t\tevents,\n\t\t\t\tservices,\n\t\t\t\tlogger,\n\t\t\t\tdb,\n\t\t\t});\n\t\t} catch (error) {\n\t\t\tlogger.error(error as object, 'Error processing subscriber');\n\t\t\tthrow wrapError(error);\n\t\t}\n\t}\n}\n\n/** `url`, sent to `endpoint`'s origin instead of its own. */\nfunction throughEndpoint(url: string, endpoint: string): string {\n\tconst target = new URL(url);\n\tconst origin = new URL(endpoint);\n\ttarget.protocol = origin.protocol;\n\ttarget.host = origin.host;\n\treturn target.toString();\n}\n\nfunction refuse(\n\tstatus: SnsPushResponse['status'],\n\terror: string,\n): SnsPushResponse {\n\treturn { status, body: { status: 'refused', error } };\n}\n"],"mappings":"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"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { i as Declarable } from "./construct-interface-B1AfqRl4.cjs";
|
|
2
|
+
import { ConstructName, Declaration } from "@geekmidas/manifest";
|
|
3
|
+
//#region src/telemetry.d.ts
|
|
4
|
+
interface TelemetryConfig {
|
|
5
|
+
/**
|
|
6
|
+
* Request paths no span is recorded for, on every surface that uses this —
|
|
7
|
+
* health checks, by default the only noise worth naming. A trailing `*`
|
|
8
|
+
* matches a prefix. One route on one surface says so itself:
|
|
9
|
+
* `.telemetry({ ignore: true })`.
|
|
10
|
+
*/
|
|
11
|
+
ignorePaths?: readonly string[];
|
|
12
|
+
/**
|
|
13
|
+
* Resource attributes every span and log record carries —
|
|
14
|
+
* `{ 'service.namespace': 'shop' }`. The service's name is not one of
|
|
15
|
+
* them: it is the app's, set per process.
|
|
16
|
+
*/
|
|
17
|
+
attributes?: Readonly<Record<string, string>>;
|
|
18
|
+
}
|
|
19
|
+
declare class Telemetry<TName extends string = string> implements Declarable<TName> {
|
|
20
|
+
readonly id: TName;
|
|
21
|
+
readonly ignorePaths: readonly string[];
|
|
22
|
+
readonly attributes: Readonly<Record<string, string>>;
|
|
23
|
+
constructor(id: ConstructName<TName>, config?: TelemetryConfig);
|
|
24
|
+
/**
|
|
25
|
+
* One node, providing OpenTelemetry's own variables. No address of its
|
|
26
|
+
* own: where the telemetry goes is the deploy's, so it is resolved by the
|
|
27
|
+
* target for each stage, never declared here.
|
|
28
|
+
*/
|
|
29
|
+
declare(): Declaration[];
|
|
30
|
+
}
|
|
31
|
+
/** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */
|
|
32
|
+
interface EndpointTelemetry {
|
|
33
|
+
/** Record no span for this route. */
|
|
34
|
+
ignore?: boolean;
|
|
35
|
+
/** Attributes this route's request span carries. */
|
|
36
|
+
attributes?: Readonly<Record<string, string>>;
|
|
37
|
+
}
|
|
38
|
+
//#endregion
|
|
39
|
+
export { Telemetry as n, TelemetryConfig as r, EndpointTelemetry as t };
|
|
40
|
+
//# sourceMappingURL=telemetry-B48RLjyk.d.cts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry-B48RLjyk.d.cts","names":[],"sources":["../src/telemetry.ts"],"mappings":";;;UAkCiB;;;;;;;EAOhB;;;;;;EAMA,aAAa,SAAS;;cAGV,UAAU,0CACX,WAAW;WAEb,IAAI;WACJ;WACA,YAAY,SAAS;EAE9B,YAAY,IAAI,cAAc,QAAQ,SAAQ;;;;;;EAW9C,WAAW;;;UAgBK;;EAEhB;;EAEA,aAAa,SAAS"}
|
|
@@ -0,0 +1,40 @@
|
|
|
1
|
+
import { i as Declarable } from "./construct-interface-ZvYQbivO.mjs";
|
|
2
|
+
import { ConstructName, Declaration } from "@geekmidas/manifest";
|
|
3
|
+
//#region src/telemetry.d.ts
|
|
4
|
+
interface TelemetryConfig {
|
|
5
|
+
/**
|
|
6
|
+
* Request paths no span is recorded for, on every surface that uses this —
|
|
7
|
+
* health checks, by default the only noise worth naming. A trailing `*`
|
|
8
|
+
* matches a prefix. One route on one surface says so itself:
|
|
9
|
+
* `.telemetry({ ignore: true })`.
|
|
10
|
+
*/
|
|
11
|
+
ignorePaths?: readonly string[];
|
|
12
|
+
/**
|
|
13
|
+
* Resource attributes every span and log record carries —
|
|
14
|
+
* `{ 'service.namespace': 'shop' }`. The service's name is not one of
|
|
15
|
+
* them: it is the app's, set per process.
|
|
16
|
+
*/
|
|
17
|
+
attributes?: Readonly<Record<string, string>>;
|
|
18
|
+
}
|
|
19
|
+
declare class Telemetry<TName extends string = string> implements Declarable<TName> {
|
|
20
|
+
readonly id: TName;
|
|
21
|
+
readonly ignorePaths: readonly string[];
|
|
22
|
+
readonly attributes: Readonly<Record<string, string>>;
|
|
23
|
+
constructor(id: ConstructName<TName>, config?: TelemetryConfig);
|
|
24
|
+
/**
|
|
25
|
+
* One node, providing OpenTelemetry's own variables. No address of its
|
|
26
|
+
* own: where the telemetry goes is the deploy's, so it is resolved by the
|
|
27
|
+
* target for each stage, never declared here.
|
|
28
|
+
*/
|
|
29
|
+
declare(): Declaration[];
|
|
30
|
+
}
|
|
31
|
+
/** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */
|
|
32
|
+
interface EndpointTelemetry {
|
|
33
|
+
/** Record no span for this route. */
|
|
34
|
+
ignore?: boolean;
|
|
35
|
+
/** Attributes this route's request span carries. */
|
|
36
|
+
attributes?: Readonly<Record<string, string>>;
|
|
37
|
+
}
|
|
38
|
+
//#endregion
|
|
39
|
+
export { Telemetry as n, TelemetryConfig as r, EndpointTelemetry as t };
|
|
40
|
+
//# sourceMappingURL=telemetry-BEoBn6GO.d.mts.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry-BEoBn6GO.d.mts","names":[],"sources":["../src/telemetry.ts"],"mappings":";;;UAkCiB;;;;;;;EAOhB;;;;;;EAMA,aAAa,SAAS;;cAGV,UAAU,0CACX,WAAW;WAEb,IAAI;WACJ;WACA,YAAY,SAAS;EAE9B,YAAY,IAAI,cAAc,QAAQ,SAAQ;;;;;;EAW9C,WAAW;;;UAgBK;;EAEhB;;EAEA,aAAa,SAAS"}
|
|
@@ -0,0 +1,56 @@
|
|
|
1
|
+
Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
|
|
2
|
+
let _geekmidas_manifest = require("@geekmidas/manifest");
|
|
3
|
+
//#region src/telemetry.ts
|
|
4
|
+
/**
|
|
5
|
+
* `Telemetry` — what an application emits, declared.
|
|
6
|
+
*
|
|
7
|
+
* Traces and logs over OTLP, from every process that is given it. The
|
|
8
|
+
* construct says *what* is emitted — which requests are noise, which
|
|
9
|
+
* attributes every span carries — and never where it goes or how much of it:
|
|
10
|
+
* the provider and the sample rate are the deploy's, per stage
|
|
11
|
+
* (`deploy.telemetry` in `gkm.config.ts`), and locally `gkm dev` runs
|
|
12
|
+
* OpenObserve and sends everything there.
|
|
13
|
+
*
|
|
14
|
+
* ```ts
|
|
15
|
+
* export const telemetry = new Telemetry('Telemetry', {
|
|
16
|
+
* ignorePaths: ['/health', '/ready'],
|
|
17
|
+
* attributes: { 'service.namespace': 'shop' },
|
|
18
|
+
* });
|
|
19
|
+
*
|
|
20
|
+
* // passed like the logger: a fact about the process
|
|
21
|
+
* new RestApi('Api', { path: 'apps/api', defaultAuthorizer: 'none', telemetry });
|
|
22
|
+
* new Worker('Jobs', { logger, telemetry });
|
|
23
|
+
* ```
|
|
24
|
+
*
|
|
25
|
+
* Each process given it is an edge to this node, so the `OTEL_*` keys it
|
|
26
|
+
* provides reach exactly those processes, and the build of each one fails
|
|
27
|
+
* without the OpenTelemetry packages it needs.
|
|
28
|
+
*/
|
|
29
|
+
var Telemetry = class {
|
|
30
|
+
id;
|
|
31
|
+
ignorePaths;
|
|
32
|
+
attributes;
|
|
33
|
+
constructor(id, config = {}) {
|
|
34
|
+
this.id = (0, _geekmidas_manifest.canonicalId)(id);
|
|
35
|
+
this.ignorePaths = [...config.ignorePaths ?? []];
|
|
36
|
+
this.attributes = { ...config.attributes };
|
|
37
|
+
}
|
|
38
|
+
/**
|
|
39
|
+
* One node, providing OpenTelemetry's own variables. No address of its
|
|
40
|
+
* own: where the telemetry goes is the deploy's, so it is resolved by the
|
|
41
|
+
* target for each stage, never declared here.
|
|
42
|
+
*/
|
|
43
|
+
declare() {
|
|
44
|
+
return [{
|
|
45
|
+
kind: "telemetry",
|
|
46
|
+
id: this.id,
|
|
47
|
+
...this.ignorePaths.length ? { ignorePaths: this.ignorePaths } : {},
|
|
48
|
+
...Object.keys(this.attributes).length ? { attributes: this.attributes } : {},
|
|
49
|
+
provides: [..._geekmidas_manifest.TELEMETRY_KEYS]
|
|
50
|
+
}];
|
|
51
|
+
}
|
|
52
|
+
};
|
|
53
|
+
//#endregion
|
|
54
|
+
exports.Telemetry = Telemetry;
|
|
55
|
+
|
|
56
|
+
//# sourceMappingURL=telemetry.cjs.map
|
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"telemetry.cjs","names":["canonicalId","TELEMETRY_KEYS"],"sources":["../src/telemetry.ts"],"sourcesContent":["/**\n * `Telemetry` — what an application emits, declared.\n *\n * Traces and logs over OTLP, from every process that is given it. The\n * construct says *what* is emitted — which requests are noise, which\n * attributes every span carries — and never where it goes or how much of it:\n * the provider and the sample rate are the deploy's, per stage\n * (`deploy.telemetry` in `gkm.config.ts`), and locally `gkm dev` runs\n * OpenObserve and sends everything there.\n *\n * ```ts\n * export const telemetry = new Telemetry('Telemetry', {\n * ignorePaths: ['/health', '/ready'],\n * attributes: { 'service.namespace': 'shop' },\n * });\n *\n * // passed like the logger: a fact about the process\n * new RestApi('Api', { path: 'apps/api', defaultAuthorizer: 'none', telemetry });\n * new Worker('Jobs', { logger, telemetry });\n * ```\n *\n * Each process given it is an edge to this node, so the `OTEL_*` keys it\n * provides reach exactly those processes, and the build of each one fails\n * without the OpenTelemetry packages it needs.\n */\n\nimport {\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tTELEMETRY_KEYS,\n} from '@geekmidas/manifest';\nimport type { Declarable } from './construct-interface';\n\nexport interface TelemetryConfig {\n\t/**\n\t * Request paths no span is recorded for, on every surface that uses this —\n\t * health checks, by default the only noise worth naming. A trailing `*`\n\t * matches a prefix. One route on one surface says so itself:\n\t * `.telemetry({ ignore: true })`.\n\t */\n\tignorePaths?: readonly string[];\n\t/**\n\t * Resource attributes every span and log record carries —\n\t * `{ 'service.namespace': 'shop' }`. The service's name is not one of\n\t * them: it is the app's, set per process.\n\t */\n\tattributes?: Readonly<Record<string, string>>;\n}\n\nexport class Telemetry<TName extends string = string>\n\timplements Declarable<TName>\n{\n\treadonly id: TName;\n\treadonly ignorePaths: readonly string[];\n\treadonly attributes: Readonly<Record<string, string>>;\n\n\tconstructor(id: ConstructName<TName>, config: TelemetryConfig = {}) {\n\t\tthis.id = canonicalId(id as string) as TName;\n\t\tthis.ignorePaths = [...(config.ignorePaths ?? [])];\n\t\tthis.attributes = { ...config.attributes };\n\t}\n\n\t/**\n\t * One node, providing OpenTelemetry's own variables. No address of its\n\t * own: where the telemetry goes is the deploy's, so it is resolved by the\n\t * target for each stage, never declared here.\n\t */\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'telemetry',\n\t\t\t\tid: this.id,\n\t\t\t\t...(this.ignorePaths.length ? { ignorePaths: this.ignorePaths } : {}),\n\t\t\t\t...(Object.keys(this.attributes).length\n\t\t\t\t\t? { attributes: this.attributes }\n\t\t\t\t\t: {}),\n\t\t\t\tprovides: [...TELEMETRY_KEYS],\n\t\t\t},\n\t\t];\n\t}\n}\n\n/** Per-route telemetry, on the endpoint builder — `.telemetry({ ignore: true })`. */\nexport interface EndpointTelemetry {\n\t/** Record no span for this route. */\n\tignore?: boolean;\n\t/** Attributes this route's request span carries. */\n\tattributes?: Readonly<Record<string, string>>;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;AAkDA,IAAa,YAAb,MAEA;CACC;CACA;CACA;CAEA,YAAY,IAA0B,SAA0B,CAAC,GAAG;EACnE,KAAK,MAAA,GAAKA,oBAAAA,YAAAA,CAAY,EAAY;EAClC,KAAK,cAAc,CAAC,GAAI,OAAO,eAAe,CAAC,CAAE;EACjD,KAAK,aAAa,EAAE,GAAG,OAAO,WAAW;CAC1C;;;;;;CAOA,UAAyB;EACxB,OAAO,CACN;GACC,MAAM;GACN,IAAI,KAAK;GACT,GAAI,KAAK,YAAY,SAAS,EAAE,aAAa,KAAK,YAAY,IAAI,CAAC;GACnE,GAAI,OAAO,KAAK,KAAK,UAAU,CAAC,CAAC,SAC9B,EAAE,YAAY,KAAK,WAAW,IAC9B,CAAC;GACJ,UAAU,CAAC,GAAGC,oBAAAA,cAAc;EAC7B,CACD;CACD;AACD"}
|