@geekmidas/constructs 10.0.0-alpha.17 → 10.0.0-alpha.170
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 +246 -158
- package/dist/Construct-127M7yrl.d.cts +231 -0
- package/dist/Construct-127M7yrl.d.cts.map +1 -0
- package/dist/Construct-BMk_CRSD.d.mts +231 -0
- package/dist/Construct-BMk_CRSD.d.mts.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/{Cron-l4Wlz6G9.d.mts → Cron-Ca_qHQu2.d.cts} +16 -9
- package/dist/Cron-Ca_qHQu2.d.cts.map +1 -0
- package/dist/{Cron-zsoSAwZo.d.cts → Cron-DPJiR7Lt.d.mts} +15 -8
- package/dist/Cron-DPJiR7Lt.d.mts.map +1 -0
- package/dist/CronBuilder-BC4za5Bx.d.mts +47 -0
- package/dist/CronBuilder-BC4za5Bx.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-C3RrAF1-.d.cts +47 -0
- package/dist/CronBuilder-C3RrAF1-.d.cts.map +1 -0
- package/dist/Endpoint-52z1P0Ue.cjs +581 -0
- package/dist/Endpoint-52z1P0Ue.cjs.map +1 -0
- package/dist/{Endpoint-DBflWAe4.d.cts → Endpoint-BlIZLsBQ.d.cts} +101 -20
- package/dist/Endpoint-BlIZLsBQ.d.cts.map +1 -0
- package/dist/{Endpoint-oS-Fe3d_.d.mts → Endpoint-DC7mreOr.d.mts} +104 -23
- package/dist/Endpoint-DC7mreOr.d.mts.map +1 -0
- package/dist/Endpoint-sUOU7uLx.mjs +552 -0
- package/dist/Endpoint-sUOU7uLx.mjs.map +1 -0
- package/dist/{EndpointFactory-Bm3aKRdV.mjs → EndpointFactory-Bzi9Sl7r.mjs} +269 -53
- package/dist/EndpointFactory-Bzi9Sl7r.mjs.map +1 -0
- package/dist/{EndpointFactory-CLvWuHyt.cjs → EndpointFactory-Cf_Cs1ym.cjs} +309 -51
- package/dist/EndpointFactory-Cf_Cs1ym.cjs.map +1 -0
- package/dist/{index-Cc4kKPag.d.mts → EndpointFactory-DCmnCmkX.d.mts} +189 -106
- package/dist/EndpointFactory-DCmnCmkX.d.mts.map +1 -0
- package/dist/{index-C1ZwNOOk.d.cts → EndpointFactory-cVTb8kCc.d.cts} +187 -104
- package/dist/EndpointFactory-cVTb8kCc.d.cts.map +1 -0
- package/dist/Function-BIEsY0Hm.d.cts +76 -0
- package/dist/Function-BIEsY0Hm.d.cts.map +1 -0
- package/dist/Function-BKReud5p.d.mts +76 -0
- package/dist/Function-BKReud5p.d.mts.map +1 -0
- package/dist/{HonoEndpointAdaptor-92zavCsV.cjs → HonoEndpointAdaptor-BTbqfSaa.cjs} +115 -41
- package/dist/HonoEndpointAdaptor-BTbqfSaa.cjs.map +1 -0
- package/dist/{HonoEndpointAdaptor-yYaU7jVJ.mjs → HonoEndpointAdaptor-CBVey2cY.mjs} +112 -38
- package/dist/HonoEndpointAdaptor-CBVey2cY.mjs.map +1 -0
- package/dist/ObjectSubscriberBuilder-AwGKoUKy.d.mts +129 -0
- package/dist/ObjectSubscriberBuilder-AwGKoUKy.d.mts.map +1 -0
- package/dist/ObjectSubscriberBuilder-CB6imsX4.d.cts +129 -0
- package/dist/ObjectSubscriberBuilder-CB6imsX4.d.cts.map +1 -0
- package/dist/ProcessorBuilder-CeEZ2vCx.d.cts +216 -0
- package/dist/ProcessorBuilder-CeEZ2vCx.d.cts.map +1 -0
- package/dist/ProcessorBuilder-CwIlm75W.d.mts +216 -0
- package/dist/ProcessorBuilder-CwIlm75W.d.mts.map +1 -0
- package/dist/Queue-9Hh20ZCk.mjs +104 -0
- package/dist/Queue-9Hh20ZCk.mjs.map +1 -0
- package/dist/{Queue-D9X6OoON.d.mts → Queue-B8HGg439.d.mts} +42 -41
- package/dist/Queue-B8HGg439.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-W1wueijP.cjs +109 -0
- package/dist/Queue-W1wueijP.cjs.map +1 -0
- package/dist/QueueBuilder-BDcv9B71.cjs +135 -0
- package/dist/QueueBuilder-BDcv9B71.cjs.map +1 -0
- package/dist/QueueBuilder-CUERv8jt.d.mts +75 -0
- package/dist/QueueBuilder-CUERv8jt.d.mts.map +1 -0
- package/dist/QueueBuilder-CmB1vOgn.d.cts +75 -0
- package/dist/QueueBuilder-CmB1vOgn.d.cts.map +1 -0
- package/dist/QueueBuilder-CrZL8HHs.mjs +118 -0
- package/dist/QueueBuilder-CrZL8HHs.mjs.map +1 -0
- package/dist/Subscriber-5rCX1Nph.d.cts +83 -0
- package/dist/Subscriber-5rCX1Nph.d.cts.map +1 -0
- package/dist/Subscriber-CtQXhcL7.d.mts +83 -0
- package/dist/Subscriber-CtQXhcL7.d.mts.map +1 -0
- package/dist/SubscriberBuilder-CpFhShTJ.mjs +238 -0
- package/dist/SubscriberBuilder-CpFhShTJ.mjs.map +1 -0
- package/dist/SubscriberBuilder-DJEvNRdD.cjs +261 -0
- package/dist/SubscriberBuilder-DJEvNRdD.cjs.map +1 -0
- package/dist/Topic-BGoOeCT6.mjs +99 -0
- package/dist/Topic-BGoOeCT6.mjs.map +1 -0
- package/dist/Topic-DLCZBNwK.cjs +104 -0
- package/dist/Topic-DLCZBNwK.cjs.map +1 -0
- package/dist/adaptors/aws.cjs +147 -168
- 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 +142 -164
- package/dist/adaptors/aws.mjs.map +1 -1
- package/dist/adaptors/awsWebsocket.cjs +354 -0
- package/dist/adaptors/awsWebsocket.cjs.map +1 -0
- package/dist/adaptors/awsWebsocket.d.cts +156 -0
- package/dist/adaptors/awsWebsocket.d.cts.map +1 -0
- package/dist/adaptors/awsWebsocket.d.mts +156 -0
- package/dist/adaptors/awsWebsocket.d.mts.map +1 -0
- package/dist/adaptors/awsWebsocket.mjs +347 -0
- package/dist/adaptors/awsWebsocket.mjs.map +1 -0
- package/dist/adaptors/hono.cjs +1 -1
- package/dist/adaptors/hono.d.cts +8 -7
- package/dist/adaptors/hono.d.cts.map +1 -1
- package/dist/adaptors/hono.d.mts +10 -9
- package/dist/adaptors/hono.d.mts.map +1 -1
- package/dist/adaptors/hono.mjs +1 -1
- package/dist/adaptors/testing.cjs +1174 -41
- package/dist/adaptors/testing.cjs.map +1 -1
- package/dist/adaptors/testing.d.cts +517 -40
- package/dist/adaptors/testing.d.cts.map +1 -1
- package/dist/adaptors/testing.d.mts +517 -40
- package/dist/adaptors/testing.d.mts.map +1 -1
- package/dist/adaptors/testing.mjs +1140 -36
- package/dist/adaptors/testing.mjs.map +1 -1
- package/dist/auth-1yI2wR-4.d.cts +274 -0
- package/dist/auth-1yI2wR-4.d.cts.map +1 -0
- package/dist/auth-D4NMXgLt.d.mts +274 -0
- package/dist/auth-D4NMXgLt.d.mts.map +1 -0
- package/dist/auth.cjs +311 -26
- 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 +307 -28
- package/dist/auth.mjs.map +1 -1
- package/dist/cache-0VoeOTF9.d.mts +44 -0
- package/dist/cache-0VoeOTF9.d.mts.map +1 -0
- package/dist/cache-CW-sArzS.d.cts +44 -0
- package/dist/cache-CW-sArzS.d.cts.map +1 -0
- package/dist/cache.cjs +4 -20
- package/dist/cache.cjs.map +1 -1
- package/dist/cache.d.cts +2 -43
- package/dist/cache.d.mts +2 -43
- package/dist/cache.mjs +4 -20
- package/dist/cache.mjs.map +1 -1
- 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-DhbaONW2.d.cts} +63 -8
- package/dist/construct-interface-DhbaONW2.d.cts.map +1 -0
- package/dist/{construct-interface-DgXTJcOD.d.cts → construct-interface-DxfkFxkl.d.mts} +63 -8
- package/dist/construct-interface-DxfkFxkl.d.mts.map +1 -0
- package/dist/construct-interface.cjs +47 -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 +45 -5
- package/dist/construct-interface.mjs.map +1 -1
- package/dist/credential-B80mOxwT.mjs +222 -0
- package/dist/credential-B80mOxwT.mjs.map +1 -0
- package/dist/credential-RlgbzZAc.cjs +257 -0
- package/dist/credential-RlgbzZAc.cjs.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 +127 -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 +126 -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.cjs +24 -17
- package/dist/email.cjs.map +1 -1
- package/dist/email.d.cts +15 -5
- package/dist/email.d.cts.map +1 -1
- package/dist/email.d.mts +16 -6
- package/dist/email.d.mts.map +1 -1
- package/dist/email.mjs +23 -17
- package/dist/email.mjs.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 +32 -10
- package/dist/endpoints/index.d.cts +106 -3
- package/dist/endpoints/index.d.cts.map +1 -0
- package/dist/endpoints/index.d.mts +106 -3
- package/dist/endpoints/index.d.mts.map +1 -0
- package/dist/endpoints/index.mjs +6 -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-BvOXkZmj.d.mts +201 -0
- package/dist/fake-BvOXkZmj.d.mts.map +1 -0
- package/dist/fake-Djx8E0o1.d.cts +201 -0
- package/dist/fake-Djx8E0o1.d.cts.map +1 -0
- package/dist/file-server.cjs +200 -48
- package/dist/file-server.cjs.map +1 -1
- package/dist/file-server.d.cts +147 -15
- package/dist/file-server.d.cts.map +1 -1
- package/dist/file-server.d.mts +147 -15
- package/dist/file-server.d.mts.map +1 -1
- package/dist/file-server.mjs +198 -50
- 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/inbox-BjvMs7EJ.d.cts +195 -0
- package/dist/inbox-BjvMs7EJ.d.cts.map +1 -0
- package/dist/inbox-C8bOR9UL.d.mts +195 -0
- package/dist/inbox-C8bOR9UL.d.mts.map +1 -0
- package/dist/inbox.cjs +291 -0
- package/dist/inbox.cjs.map +1 -0
- package/dist/inbox.d.cts +2 -0
- package/dist/inbox.d.mts +2 -0
- package/dist/inbox.mjs +283 -0
- package/dist/inbox.mjs.map +1 -0
- package/dist/index-DaK-C7N3.d.cts +115 -0
- package/dist/index-DaK-C7N3.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-vCS4HBEG.d.mts +115 -0
- package/dist/index-vCS4HBEG.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-2HqIQ2fC.d.cts +216 -0
- package/dist/kysely-2HqIQ2fC.d.cts.map +1 -0
- package/dist/kysely-BGvpd_ZH.d.mts +216 -0
- package/dist/kysely-BGvpd_ZH.d.mts.map +1 -0
- package/dist/kysely-Bc9xzaik.mjs +371 -0
- package/dist/kysely-Bc9xzaik.mjs.map +1 -0
- package/dist/kysely-D7f6J2lh.cjs +384 -0
- package/dist/kysely-D7f6J2lh.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 +78 -0
- package/dist/mobile-app.cjs.map +1 -0
- package/dist/mobile-app.d.cts +77 -0
- package/dist/mobile-app.d.cts.map +1 -0
- package/dist/mobile-app.d.mts +77 -0
- package/dist/mobile-app.d.mts.map +1 -0
- package/dist/mobile-app.mjs +77 -0
- package/dist/mobile-app.mjs.map +1 -0
- package/dist/object-storage.cjs +14 -7
- package/dist/object-storage.cjs.map +1 -1
- package/dist/object-storage.d.cts +12 -3
- package/dist/object-storage.d.cts.map +1 -1
- package/dist/object-storage.d.mts +12 -3
- package/dist/object-storage.d.mts.map +1 -1
- package/dist/object-storage.mjs +14 -9
- package/dist/object-storage.mjs.map +1 -1
- package/dist/optionalPeers-D7Wt6dnF.mjs +140 -0
- package/dist/optionalPeers-D7Wt6dnF.mjs.map +1 -0
- package/dist/optionalPeers-DuNQXXe1.cjs +223 -0
- package/dist/optionalPeers-DuNQXXe1.cjs.map +1 -0
- package/dist/origins-BjxYht13.cjs +96 -0
- package/dist/origins-BjxYht13.cjs.map +1 -0
- package/dist/origins-Boc9qbo-.mjs +73 -0
- package/dist/origins-Boc9qbo-.mjs.map +1 -0
- 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/privateAddress-Bg5fUsbp.mjs +21 -0
- package/dist/privateAddress-Bg5fUsbp.mjs.map +1 -0
- package/dist/privateAddress-CqGyuFHn.cjs +26 -0
- package/dist/privateAddress-CqGyuFHn.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/readRequestBody-BmKnPl0a.mjs +293 -0
- package/dist/readRequestBody-BmKnPl0a.mjs.map +1 -0
- package/dist/{lazyAccessors-Dx9NLwJZ.cjs → readRequestBody-CN9GVdeE.cjs} +141 -47
- package/dist/readRequestBody-CN9GVdeE.cjs.map +1 -0
- package/dist/{processAudits-D_2W5x8k.cjs → requestLogger-CnoYd-Ah.cjs} +63 -3
- package/dist/requestLogger-CnoYd-Ah.cjs.map +1 -0
- package/dist/{processAudits-BpRlPQMW.mjs → requestLogger-D2JS7pPM.mjs} +51 -3
- package/dist/requestLogger-D2JS7pPM.mjs.map +1 -0
- package/dist/rest-api.cjs +100 -73
- package/dist/rest-api.cjs.map +1 -1
- package/dist/rest-api.d.cts +83 -59
- package/dist/rest-api.d.cts.map +1 -1
- package/dist/rest-api.d.mts +83 -59
- package/dist/rest-api.d.mts.map +1 -1
- package/dist/rest-api.mjs +97 -76
- package/dist/rest-api.mjs.map +1 -1
- package/dist/runSubscriber-HEqXkin1.mjs +117 -0
- package/dist/runSubscriber-HEqXkin1.mjs.map +1 -0
- package/dist/runSubscriber-sVJfLA0-.cjs +134 -0
- package/dist/runSubscriber-sVJfLA0-.cjs.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 +137 -10
- package/dist/site.cjs.map +1 -1
- package/dist/site.d.cts +153 -3
- package/dist/site.d.cts.map +1 -1
- package/dist/site.d.mts +153 -3
- package/dist/site.d.mts.map +1 -1
- package/dist/site.mjs +117 -13
- 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-BirKau0X.d.mts +40 -0
- package/dist/telemetry-BirKau0X.d.mts.map +1 -0
- package/dist/telemetry-DjJgtQ_N.d.cts +40 -0
- package/dist/telemetry-DjJgtQ_N.d.cts.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-C6LGg9-D.mjs +1716 -0
- package/dist/websocket-api-C6LGg9-D.mjs.map +1 -0
- package/dist/websocket-api-CD-E5Ogr.d.cts +1207 -0
- package/dist/websocket-api-CD-E5Ogr.d.cts.map +1 -0
- package/dist/websocket-api-CoKPJJRl.cjs +1895 -0
- package/dist/websocket-api-CoKPJJRl.cjs.map +1 -0
- package/dist/websocket-api-pJJfeTcm.d.mts +1207 -0
- package/dist/websocket-api-pJJfeTcm.d.mts.map +1 -0
- package/dist/websocket-api.cjs +42 -0
- package/dist/websocket-api.d.cts +2 -0
- package/dist/websocket-api.d.mts +2 -0
- package/dist/websocket-api.mjs +3 -0
- package/dist/worker.cjs +174 -32
- package/dist/worker.cjs.map +1 -1
- package/dist/worker.d.cts +147 -47
- package/dist/worker.d.cts.map +1 -1
- package/dist/worker.d.mts +147 -47
- package/dist/worker.d.mts.map +1 -1
- package/dist/worker.mjs +175 -33
- package/dist/worker.mjs.map +1 -1
- package/package.json +180 -43
- 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-l4Wlz6G9.d.mts.map +0 -1
- package/dist/Cron-zsoSAwZo.d.cts.map +0 -1
- package/dist/CronBuilder-BdnI6lxF.cjs.map +0 -1
- package/dist/CronBuilder-CyT71Nzg.d.cts +0 -41
- package/dist/CronBuilder-CyT71Nzg.d.cts.map +0 -1
- package/dist/CronBuilder-D_0HNBTr.mjs.map +0 -1
- package/dist/CronBuilder-UoNgFe8S.d.mts +0 -41
- package/dist/CronBuilder-UoNgFe8S.d.mts.map +0 -1
- package/dist/Endpoint-BpZHtJ2W.cjs +0 -1689
- package/dist/Endpoint-BpZHtJ2W.cjs.map +0 -1
- package/dist/Endpoint-DBflWAe4.d.cts.map +0 -1
- package/dist/Endpoint-ONsly_dq.mjs +0 -1671
- package/dist/Endpoint-ONsly_dq.mjs.map +0 -1
- package/dist/Endpoint-oS-Fe3d_.d.mts.map +0 -1
- package/dist/EndpointFactory-Bm3aKRdV.mjs.map +0 -1
- package/dist/EndpointFactory-CLvWuHyt.cjs.map +0 -1
- package/dist/HonoEndpointAdaptor-92zavCsV.cjs.map +0 -1
- package/dist/HonoEndpointAdaptor-yYaU7jVJ.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-C1ZwNOOk.d.cts.map +0 -1
- package/dist/index-Cc4kKPag.d.mts.map +0 -1
- package/dist/index-DMCDvnsM.d.mts +0 -26
- package/dist/index-DMCDvnsM.d.mts.map +0 -1
- package/dist/index-D_frT6MP.d.cts +0 -165
- package/dist/index-D_frT6MP.d.cts.map +0 -1
- package/dist/index-DcyIYbDS.d.mts +0 -165
- package/dist/index-DcyIYbDS.d.mts.map +0 -1
- package/dist/lazyAccessors-BHtcqgz2.mjs +0 -211
- package/dist/lazyAccessors-BHtcqgz2.mjs.map +0 -1
- package/dist/lazyAccessors-Dx9NLwJZ.cjs.map +0 -1
- package/dist/processAudits-BpRlPQMW.mjs.map +0 -1
- 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
|
@@ -0,0 +1 @@
|
|
|
1
|
+
{"version":3,"file":"websocket-api-CoKPJJRl.cjs","names":["toJsonSchema","HttpError","runWithRequestContext","ServiceDiscovery","isPrivateAddress","servicesOf","idsOf","loadIoredis","randomBytes","ownOrigins","loadWs","trustsOrigin","canonicalId","providedKeyFor","DEFAULT_LOGGER","envParserFor","serviceKey","loadHono","edgeTo","webSocketSinkDriverFor","API_GATEWAY_WEBSOCKET_SCHEME","UnregisteredWebSocketScheme"],"sources":["../src/websocket/frame.ts","../src/websocket/publisher.ts","../src/websocket/core.ts","../src/websocket/limits.ts","../src/websocket/testing.ts","../src/websocket/route.ts","../src/websocket/transport.ts","../src/websocket/server.ts","../src/websocket-api.ts"],"sourcesContent":["/**\n * The shape a surface's frames take on the wire.\n *\n * By default a frame is `{ \"action\": …, \"id\"?: …, \"data\": … }` — API\n * Gateway's shape. A surface that names a discriminator — `frame: {\n * discriminator: 'type' }` — sends and reads flat frames instead: the action\n * under that key, and the data's own fields beside it.\n *\n * ```json\n * {\"type\":\"chat.message.created\",\"chatId\":\"c1\",\"message\":{…}}\n * ```\n *\n * A flat frame has no `id` of its own: every field but the discriminator is\n * the data, so a reply is paired by its action, not an echoed id.\n */\n\nimport { toJsonSchema } from '@geekmidas/schema/conversion';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { WebSocketMessages } from './publisher';\n\n/** `WebSocketApiConfig.frame`: where a flat frame keeps its action. */\nexport interface WebSocketFrame {\n\t/** The key a frame's action lives in — `type` for `{ \"type\": … }`. */\n\tdiscriminator: string;\n}\n\n/** A frame as the server reads it, whatever shape it arrived in. */\nexport interface DecodedFrame {\n\taction: string;\n\t/** Echoed on the reply. Only an `{ action, data }` frame carries one. */\n\tid?: string | number;\n\tdata?: unknown;\n}\n\n/** A declared message whose schema does not describe an object. */\nexport class WebSocketMessageNotAnObject extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t\treadonly discriminator: string,\n\t) {\n\t\tsuper(\n\t\t\t`${surface} sends flat frames, keyed by '${discriminator}', so each message's fields sit beside it — but '${action}' is not an object schema. Declare it as an object (z.object({ … })), or drop \\`frame\\` to send { action, data }.`,\n\t\t);\n\t\tthis.name = 'WebSocketMessageNotAnObject';\n\t}\n}\n\n/** A declared message whose schema has a field named the discriminator. */\nexport class WebSocketMessageDeclaresDiscriminator extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t\treadonly discriminator: string,\n\t) {\n\t\tsuper(\n\t\t\t`${surface}'s '${action}' message declares a '${discriminator}' field, which is where its flat frames keep the action. Rename the field, or give \\`frame.discriminator\\` a key no message uses.`,\n\t\t);\n\t\tthis.name = 'WebSocketMessageDeclaresDiscriminator';\n\t}\n}\n\n/** Data sent in a flat frame that is not an object. */\nexport class WebSocketDataNotAnObject extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t\treadonly discriminator: string,\n\t) {\n\t\tsuper(\n\t\t\t`${surface} sends flat frames, keyed by '${discriminator}', and '${action}''s data is not an object, so it has no fields to put beside it. Send an object. Nothing was sent.`,\n\t\t);\n\t\tthis.name = 'WebSocketDataNotAnObject';\n\t}\n}\n\n/** Data sent in a flat frame that carries the discriminator itself. */\nexport class WebSocketDataHasDiscriminator extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t\treadonly discriminator: string,\n\t) {\n\t\tsuper(\n\t\t\t`'${action}''s data on ${surface} has a '${discriminator}' field, which is where its flat frames keep the action. Rename the field. Nothing was sent.`,\n\t\t);\n\t\tthis.name = 'WebSocketDataHasDiscriminator';\n\t}\n}\n\n/** How one surface writes and reads its frames. */\nexport class FrameShape {\n\tconstructor(\n\t\treadonly surface: string,\n\t\t/** The flat frame's key; absent, frames are `{ action, data }`. */\n\t\treadonly discriminator?: string,\n\t) {}\n\n\t/** The key an inbound frame names its action under. */\n\tget key(): string {\n\t\treturn this.discriminator ?? 'action';\n\t}\n\n\t/**\n\t * The frame for `action`'s `data`, serialised.\n\t *\n\t * @throws {WebSocketDataNotAnObject}, {WebSocketDataHasDiscriminator} for\n\t * a flat frame whose data cannot sit beside the discriminator.\n\t */\n\tencode(action: string, data: unknown, id?: string | number): string {\n\t\tconst { discriminator } = this;\n\t\tif (discriminator === undefined) {\n\t\t\treturn JSON.stringify({\n\t\t\t\taction,\n\t\t\t\t...(id !== undefined ? { id } : {}),\n\t\t\t\tdata,\n\t\t\t});\n\t\t}\n\t\tif (!isRecord(data)) {\n\t\t\tthrow new WebSocketDataNotAnObject(this.surface, action, discriminator);\n\t\t}\n\t\tif (Object.hasOwn(data, discriminator)) {\n\t\t\tthrow new WebSocketDataHasDiscriminator(\n\t\t\t\tthis.surface,\n\t\t\t\taction,\n\t\t\t\tdiscriminator,\n\t\t\t);\n\t\t}\n\t\treturn JSON.stringify({ [discriminator]: action, ...data });\n\t}\n\n\t/** A parsed frame's action, id and data — `undefined` when it names none. */\n\tdecode(frame: unknown): DecodedFrame | undefined {\n\t\tif (!isRecord(frame)) return undefined;\n\t\tconst { discriminator } = this;\n\t\tif (discriminator === undefined) {\n\t\t\tif (typeof frame.action !== 'string') return undefined;\n\t\t\treturn {\n\t\t\t\taction: frame.action,\n\t\t\t\t...(isId(frame.id) ? { id: frame.id } : {}),\n\t\t\t\tdata: frame.data,\n\t\t\t};\n\t\t}\n\t\tconst { [discriminator]: action, ...data } = frame;\n\t\tif (typeof action !== 'string') return undefined;\n\t\treturn { action, data };\n\t}\n\n\t/** The id a frame that names no action carried, to echo on its error. */\n\tidOf(frame: unknown): string | number | undefined {\n\t\tif (this.discriminator !== undefined || !isRecord(frame)) return undefined;\n\t\treturn isId(frame.id) ? frame.id : undefined;\n\t}\n\n\t/**\n\t * Refuse a declared message a flat frame cannot carry: one that is not an\n\t * object, or that has a field named the discriminator.\n\t *\n\t * @throws {WebSocketMessageNotAnObject}, {WebSocketMessageDeclaresDiscriminator}\n\t */\n\tcheck(messages: WebSocketMessages): void {\n\t\tconst { discriminator } = this;\n\t\tif (discriminator === undefined) return;\n\t\tfor (const [action, schema] of Object.entries(messages)) {\n\t\t\tconst shape = objectShape(toJsonSchema(schema as StandardSchemaV1));\n\t\t\tif (!shape) {\n\t\t\t\tthrow new WebSocketMessageNotAnObject(\n\t\t\t\t\tthis.surface,\n\t\t\t\t\taction,\n\t\t\t\t\tdiscriminator,\n\t\t\t\t);\n\t\t\t}\n\t\t\tif (shape.has(discriminator)) {\n\t\t\t\tthrow new WebSocketMessageDeclaresDiscriminator(\n\t\t\t\t\tthis.surface,\n\t\t\t\t\taction,\n\t\t\t\t\tdiscriminator,\n\t\t\t\t);\n\t\t\t}\n\t\t}\n\t}\n}\n\n/**\n * The fields a JSON Schema's object declares, or `undefined` when it is not\n * an object. A union or intersection is one when each of its members is.\n */\nfunction objectShape(schema: unknown): Set<string> | undefined {\n\tif (!isRecord(schema)) return undefined;\n\n\tconst members = (schema.anyOf ?? schema.oneOf ?? schema.allOf) as\n\t\t| unknown[]\n\t\t| undefined;\n\tif (Array.isArray(members) && members.length > 0) {\n\t\tconst fields = new Set<string>();\n\t\tfor (const member of members) {\n\t\t\tconst shape = objectShape(member);\n\t\t\tif (!shape) return undefined;\n\t\t\tfor (const field of shape) fields.add(field);\n\t\t}\n\t\treturn fields;\n\t}\n\n\tif (schema.type !== 'object') return undefined;\n\treturn new Set(\n\t\tisRecord(schema.properties) ? Object.keys(schema.properties) : [],\n\t);\n}\n\nfunction isRecord(value: unknown): value is Record<string, unknown> {\n\treturn typeof value === 'object' && value !== null && !Array.isArray(value);\n}\n\nfunction isId(value: unknown): value is string | number {\n\treturn typeof value === 'string' || typeof value === 'number';\n}\n","import type { StandardSchemaV1 } from '@standard-schema/spec';\nimport { FrameShape } from './frame';\n\n/**\n * Where a publisher's frames go once they are encoded — the one thing a\n * runtime supplies to send to its sockets.\n *\n * On Node it is a `TransportSink`: each id's process, over Redis or memory.\n * On API Gateway it would be the management API's `postToConnection`; under\n * test, a recording. A payload is the frame already serialised, once, however\n * many ids it goes to. An id that is gone is dropped, not an error.\n */\nexport interface WebSocketSink {\n\tsend(ids: readonly string[], payload: string): Promise<void>;\n\t/** Every open connection but `except`. */\n\tbroadcast(payload: string, except?: readonly string[]): Promise<void>;\n\tclose(ids: readonly string[], code: number, reason: string): Promise<void>;\n}\n\n/**\n * What a surface sends its sockets, by action — `WebSocketApiConfig.messages`.\n */\nexport type WebSocketMessages = Record<string, StandardSchemaV1>;\n\n/** A surface that declares no messages: any action, any data. */\nexport type NoMessages = Record<never, never>;\n\n/** The actions a publisher sends: the declared ones, or any. */\nexport type MessageAction<TMessages extends WebSocketMessages> = [\n\tkeyof TMessages,\n] extends [never]\n\t? string\n\t: keyof TMessages & string;\n\n/** What `action`'s data is, as its schema takes it. */\nexport type MessageData<\n\tTMessages extends WebSocketMessages,\n\tTAction extends string,\n> = TAction extends keyof TMessages\n\t? StandardSchemaV1.InferInput<TMessages[TAction]>\n\t: unknown;\n\n/** A message sent on an action the surface does not declare. */\nexport class UnknownWebSocketMessage extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t\treadonly declared: readonly string[],\n\t) {\n\t\tsuper(\n\t\t\t`${surface} sends no '${action}' message. It declares ${declared\n\t\t\t\t.map((a) => `'${a}'`)\n\t\t\t\t.join(', ')} — send one of them, or add '${action}' to its messages.`,\n\t\t);\n\t\tthis.name = 'UnknownWebSocketMessage';\n\t}\n}\n\n/** A message whose data its action's schema refused. */\nexport class InvalidWebSocketMessage extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t\treadonly issues: readonly StandardSchemaV1.Issue[],\n\t) {\n\t\tsuper(\n\t\t\t`${surface}'s '${action}' message was refused by its schema: ${issues\n\t\t\t\t.map((issue) => issue.message)\n\t\t\t\t.join('; ')}. Nothing was sent.`,\n\t\t);\n\t\tthis.name = 'InvalidWebSocketMessage';\n\t}\n}\n\n/**\n * How anything reaches a socket — `services.realtime` in an endpoint, and\n * `sockets` in a route of the surface itself.\n *\n * A message is `{ action, data }`, the shape a client's frames arrive in —\n * or, where the surface names a `frame.discriminator`, flat: `{ [key]: action,\n * ...data }`.\n * Where the surface declares its messages, `action` is one of them and\n * `data` is typed and checked by its schema before anything is sent; where it\n * declares none, any action and any JSON value go. A message is serialised\n * once, whatever the number of sockets it goes to. An id whose process has\n * gone is dropped silently, as API Gateway's `postToConnection` to a closed\n * connection is a no-op the sender rarely wants to handle.\n */\nexport class WebSocketPublisher<\n\tTMessages extends WebSocketMessages = NoMessages,\n> {\n\tconstructor(\n\t\t/** Where an encoded frame goes. */\n\t\tprivate readonly sink: WebSocketSink,\n\t\t/** The surface's declared messages, which every send is checked by. */\n\t\tprivate readonly declared?: { surface: string; messages: TMessages },\n\t\t/** How the surface writes a frame. Absent, `{ action, data }`. */\n\t\tprivate readonly frame: FrameShape = new FrameShape(\n\t\t\tdeclared?.surface ?? '',\n\t\t),\n\t) {}\n\n\t/** Send `action`'s message to each connection. */\n\tasync send<TAction extends MessageAction<TMessages>>(\n\t\tids: string | readonly string[],\n\t\taction: TAction,\n\t\tdata: MessageData<TMessages, TAction>,\n\t): Promise<void> {\n\t\tconst payload = await this.payload(action, data);\n\t\tawait this.sink.send(listOf(ids), payload);\n\t}\n\n\t/** Send `action`'s message to every open connection, on every process. */\n\tasync broadcast<TAction extends MessageAction<TMessages>>(\n\t\taction: TAction,\n\t\tdata: MessageData<TMessages, TAction>,\n\t\toptions: { except?: readonly string[] } = {},\n\t): Promise<void> {\n\t\tconst payload = await this.payload(action, data);\n\t\tawait this.sink.broadcast(\n\t\t\tpayload,\n\t\t\toptions.except?.length ? options.except : undefined,\n\t\t);\n\t}\n\n\t/** Close each connection, with a close code and reason its client sees. */\n\tasync close(\n\t\tids: string | readonly string[],\n\t\tcode = 1000,\n\t\treason = '',\n\t): Promise<void> {\n\t\tawait this.sink.close(listOf(ids), code, reason);\n\t}\n\n\t/**\n\t * The frame, checked by the action's schema where the surface declares\n\t * its messages.\n\t *\n\t * @throws {UnknownWebSocketMessage}, {InvalidWebSocketMessage}, and for a\n\t * flat frame {WebSocketDataNotAnObject}, {WebSocketDataHasDiscriminator}\n\t */\n\tprivate async payload(action: string, data: unknown): Promise<string> {\n\t\tif (!this.declared) return this.frame.encode(action, data);\n\n\t\tconst { surface, messages } = this.declared;\n\t\tconst schema = messages[action];\n\t\tif (!schema) {\n\t\t\tthrow new UnknownWebSocketMessage(surface, action, Object.keys(messages));\n\t\t}\n\t\tconst result = await schema['~standard'].validate(data);\n\t\tif (result.issues) {\n\t\t\tthrow new InvalidWebSocketMessage(surface, action, result.issues);\n\t\t}\n\t\treturn this.frame.encode(action, result.value);\n\t}\n}\n\nfunction listOf(ids: string | readonly string[]): readonly string[] {\n\treturn typeof ids === 'string' ? [ids] : ids;\n}\n","/**\n * A WebSocket surface with no socket in it.\n *\n * Everything a surface does that is not the transport: which route answers\n * an action, a frame decoded and checked against its route's `body`, the\n * connect handler's verdict and the `data` it keeps, the disconnect handler,\n * each handler's services and `sockets`. A runtime — an adaptor — owns the\n * socket, or the absence of one, and calls in with a connection id:\n *\n * - Node (`WebSocketSurfaceServer`) upgrades on its HTTP server, holds the\n * sockets, pings them and writes what the core hands back;\n * - API Gateway accepts the socket itself, and a Lambda calls `connect()`,\n * `message()` and `disconnect()` per event;\n * - a test calls them directly.\n *\n * What reaches a socket from a handler goes through `sockets`, a publisher\n * over the adaptor's `WebSocketSink`.\n */\n\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport { HttpError } from '@geekmidas/errors';\nimport type { Logger } from '@geekmidas/logger';\nimport { runWithRequestContext, ServiceDiscovery } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { Authenticator } from '../construct-interface';\nimport { FrameShape, type WebSocketFrame } from './frame';\nimport {\n\ttype NoMessages,\n\ttype WebSocketMessages,\n\tWebSocketPublisher,\n\ttype WebSocketSink,\n} from './publisher';\nimport type { Connection, WebSocketRoute } from './route';\n\n/** Two routes answer one action. */\nexport class DuplicateWebSocketRoute extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t) {\n\t\tsuper(\n\t\t\t`Two routes on ${surface} answer '${action}'. Each action has one handler — rename one of them.`,\n\t\t);\n\t\tthis.name = 'DuplicateWebSocketRoute';\n\t}\n}\n\nexport interface WebSocketCoreOptions<\n\tTMessages extends WebSocketMessages = NoMessages,\n> {\n\tsurface: string;\n\t/** Every route handed in; those built from another surface are skipped. */\n\troutes: readonly WebSocketRoute[];\n\t/** What the surface sends its sockets — see `WebSocketApiConfig.messages`. */\n\tmessages?: TMessages;\n\t/** The shape its frames take — see `WebSocketApiConfig.frame`. */\n\tframe?: WebSocketFrame;\n\t/** Where `sockets` sends, in every handler: the adaptor's own. */\n\tsink: WebSocketSink;\n\tenvParser: EnvironmentParser<{}>;\n\tlogger: Logger;\n\t/** What turns a handshake's headers into the `session` connect sees. */\n\tauthenticator?: Authenticator;\n}\n\n/** A handshake, as the adaptor that received it saw it. */\nexport interface ConnectRequest {\n\t/** The id the adaptor gives the connection — sends address it by this. */\n\tconnectionId: string;\n\theaders: Headers;\n\tquery: URLSearchParams;\n\t/**\n\t * Whose connection it is, when the adaptor already knows (a test).\n\t * Absent, the surface's authenticator verifies `headers`; `null` is no\n\t * session.\n\t */\n\tsession?: unknown;\n}\n\n/**\n * For one call: services to use in place of registering them — a test's\n * transaction for `database`. Only those the route depends on are handed in.\n */\nexport interface WebSocketCallOptions {\n\tservices?: Record<string, unknown>;\n}\n\n/** Whether a handshake may become a connection. */\nexport type ConnectOutcome =\n\t| { accepted: true; connection: Connection }\n\t| {\n\t\t\taccepted: false;\n\t\t\t/** The status a refused upgrade answers with: the `HttpError`'s, or 500. */\n\t\t\tstatus: number;\n\t\t\tstatusText: string;\n\t\t\t/** What the connect handler, or the authenticator, threw. */\n\t\t\terror: unknown;\n\t };\n\n/** Writes one serialised frame to the connection a message arrived on. */\nexport type WriteFrame = (payload: string) => void;\n\n/** What became of one inbound frame. Whatever it wrote went through `write`. */\nexport type MessageOutcome =\n\t| {\n\t\t\tok: true;\n\t\t\taction: string;\n\t\t\tid?: string | number;\n\t\t\t/** The handler's return — sent back as the reply when defined. */\n\t\t\treturned: unknown;\n\t }\n\t| {\n\t\t\tok: false;\n\t\t\t/** Absent when the frame named no action. */\n\t\t\taction?: string;\n\t\t\tid?: string | number;\n\t\t\t/** What the `$error` frame said. */\n\t\t\tmessage: string;\n\t\t\tissues?: readonly StandardSchemaV1.Issue[];\n\t\t\t/** What the handler threw, when it got that far. */\n\t\t\terror?: unknown;\n\t };\n\nexport type DisconnectOutcome = { ok: true } | { ok: false; error: unknown };\n\nexport class WebSocketCore<TMessages extends WebSocketMessages = NoMessages> {\n\treadonly surface: string;\n\t/** How frames are read and written — what an adaptor decodes replies by. */\n\treadonly frame: FrameShape;\n\t/** `sockets` in every handler. */\n\treadonly sockets: WebSocketPublisher<TMessages>;\n\n\tprivate readonly routes = new Map<string, WebSocketRoute>();\n\tprivate readonly lifecycle: {\n\t\tconnect?: WebSocketRoute;\n\t\tdisconnect?: WebSocketRoute;\n\t} = {};\n\n\t/**\n\t * @throws {DuplicateWebSocketRoute} when two routes answer one action, and\n\t * the frame checks of `FrameShape.check` for declared messages.\n\t */\n\tconstructor(private readonly options: WebSocketCoreOptions<TMessages>) {\n\t\tthis.surface = options.surface;\n\t\tfor (const route of options.routes) {\n\t\t\tif (route.surface.id !== options.surface) continue;\n\t\t\tif (route.kind === 'message') {\n\t\t\t\tif (this.routes.has(route.action)) {\n\t\t\t\t\tthrow new DuplicateWebSocketRoute(options.surface, route.action);\n\t\t\t\t}\n\t\t\t\tthis.routes.set(route.action, route);\n\t\t\t} else {\n\t\t\t\tif (this.lifecycle[route.kind]) {\n\t\t\t\t\tthrow new DuplicateWebSocketRoute(options.surface, route.action);\n\t\t\t\t}\n\t\t\t\tthis.lifecycle[route.kind] = route;\n\t\t\t}\n\t\t}\n\n\t\tthis.frame = new FrameShape(options.surface, options.frame?.discriminator);\n\t\tif (options.messages) this.frame.check(options.messages);\n\t\tthis.sockets = new WebSocketPublisher<TMessages>(\n\t\t\toptions.sink,\n\t\t\toptions.messages\n\t\t\t\t? { surface: options.surface, messages: options.messages }\n\t\t\t\t: undefined,\n\t\t\tthis.frame,\n\t\t);\n\t}\n\n\t/**\n\t * Run the connect handler for a handshake: accepted with the connection's\n\t * `data` (what the handler returned, `{}` for nothing), or refused with\n\t * the status of the `HttpError` it threw — 500 for anything else. A surface\n\t * with no connect handler accepts every handshake, and verifies no session.\n\t */\n\tasync connect(\n\t\trequest: ConnectRequest,\n\t\toptions: WebSocketCallOptions = {},\n\t): Promise<ConnectOutcome> {\n\t\tconst { connectionId, headers, query } = request;\n\t\tconst route = this.lifecycle.connect;\n\t\tif (!route)\n\t\t\treturn { accepted: true, connection: { id: connectionId, data: {} } };\n\n\t\ttry {\n\t\t\tconst session =\n\t\t\t\t'session' in request\n\t\t\t\t\t? request.session\n\t\t\t\t\t: this.options.authenticator\n\t\t\t\t\t\t? await this.options.authenticator.verify(\n\t\t\t\t\t\t\t\theaders,\n\t\t\t\t\t\t\t\tthis.options.envParser,\n\t\t\t\t\t\t\t)\n\t\t\t\t\t\t: null;\n\t\t\tconst returned = await this.run(\n\t\t\t\troute,\n\t\t\t\tconnectionId,\n\t\t\t\t(base) => ({ ...base, connectionId, headers, query, session }),\n\t\t\t\toptions,\n\t\t\t);\n\t\t\tconst data =\n\t\t\t\treturned && typeof returned === 'object'\n\t\t\t\t\t? (returned as Record<string, unknown>)\n\t\t\t\t\t: {};\n\t\t\treturn { accepted: true, connection: { id: connectionId, data } };\n\t\t} catch (error) {\n\t\t\tif (error instanceof HttpError) {\n\t\t\t\treturn {\n\t\t\t\t\taccepted: false,\n\t\t\t\t\tstatus: error.statusCode,\n\t\t\t\t\tstatusText: error.statusMessage,\n\t\t\t\t\terror,\n\t\t\t\t};\n\t\t\t}\n\t\t\tthis.options.logger.error(\n\t\t\t\t{ err: error, connectionId },\n\t\t\t\t'WebSocket connect handler failed',\n\t\t\t);\n\t\t\treturn {\n\t\t\t\taccepted: false,\n\t\t\t\tstatus: 500,\n\t\t\t\tstatusText: 'Internal Server Error',\n\t\t\t\terror,\n\t\t\t};\n\t\t}\n\t}\n\n\t/**\n\t * Parse, validate and run one inbound frame. The reply — the handler's\n\t * return, encoded — and every `$error` are written with `write`; an error\n\t * is a frame, never a close. A binary frame is refused: frames are text.\n\t */\n\tasync message(\n\t\tconnection: Connection,\n\t\traw: string | Uint8Array,\n\t\twrite: WriteFrame,\n\t\toptions: WebSocketCallOptions = {},\n\t): Promise<MessageOutcome> {\n\t\tif (typeof raw !== 'string') {\n\t\t\treturn this.error(write, {}, 'Frames are JSON text.');\n\t\t}\n\n\t\tlet parsed: unknown;\n\t\ttry {\n\t\t\tparsed = JSON.parse(raw);\n\t\t} catch {\n\t\t\treturn this.error(write, {}, 'Frames are JSON.');\n\t\t}\n\t\tconst frame = this.frame.decode(parsed);\n\t\tif (!frame) {\n\t\t\treturn this.error(\n\t\t\t\twrite,\n\t\t\t\t{ id: this.frame.idOf(parsed) },\n\t\t\t\t`A frame names its \\`${this.frame.key}\\`.`,\n\t\t\t);\n\t\t}\n\n\t\tconst { action, id } = frame;\n\t\tconst route = this.routes.get(action) ?? this.routes.get('$default');\n\t\tif (!route) {\n\t\t\treturn this.error(write, { action, id }, `No route answers '${action}'.`);\n\t\t}\n\n\t\tlet body = frame.data;\n\t\tif (route.schema) {\n\t\t\tconst result = await route.schema['~standard'].validate(frame.data);\n\t\t\tif (result.issues) {\n\t\t\t\treturn this.error(\n\t\t\t\t\twrite,\n\t\t\t\t\t{ action, id },\n\t\t\t\t\t'The frame was invalid.',\n\t\t\t\t\tresult.issues,\n\t\t\t\t);\n\t\t\t}\n\t\t\tbody = result.value;\n\t\t}\n\n\t\ttry {\n\t\t\tconst returned = await this.run(\n\t\t\t\troute,\n\t\t\t\tconnection.id,\n\t\t\t\t(base) => ({\n\t\t\t\t\t...base,\n\t\t\t\t\tconnection,\n\t\t\t\t\tbody,\n\t\t\t\t\treply: (message: unknown) => write(JSON.stringify(message)),\n\t\t\t\t}),\n\t\t\t\toptions,\n\t\t\t);\n\t\t\tif (returned !== undefined) {\n\t\t\t\twrite(this.frame.encode(action, returned, id));\n\t\t\t}\n\t\t\treturn {\n\t\t\t\tok: true,\n\t\t\t\taction,\n\t\t\t\t...(id !== undefined ? { id } : {}),\n\t\t\t\treturned,\n\t\t\t};\n\t\t} catch (error) {\n\t\t\tif (error instanceof HttpError) {\n\t\t\t\treturn this.error(\n\t\t\t\t\twrite,\n\t\t\t\t\t{ action, id },\n\t\t\t\t\terror.message,\n\t\t\t\t\tundefined,\n\t\t\t\t\terror,\n\t\t\t\t);\n\t\t\t}\n\t\t\tthis.options.logger.error(\n\t\t\t\t{ err: error, connectionId: connection.id, action },\n\t\t\t\t'WebSocket route failed',\n\t\t\t);\n\t\t\treturn this.error(\n\t\t\t\twrite,\n\t\t\t\t{ action, id },\n\t\t\t\t'The route failed.',\n\t\t\t\tundefined,\n\t\t\t\terror,\n\t\t\t);\n\t\t}\n\t}\n\n\t/**\n\t * Run the disconnect handler for a connection that has closed. What it\n\t * throws is logged and returned, never thrown: the socket is gone either\n\t * way.\n\t */\n\tasync disconnect(\n\t\tconnection: Connection,\n\t\tclose: { code: number; reason: string },\n\t\toptions: WebSocketCallOptions = {},\n\t): Promise<DisconnectOutcome> {\n\t\tconst route = this.lifecycle.disconnect;\n\t\tif (!route) return { ok: true };\n\t\ttry {\n\t\t\tawait this.run(\n\t\t\t\troute,\n\t\t\t\tconnection.id,\n\t\t\t\t(base) => ({ ...base, connection, ...close }),\n\t\t\t\toptions,\n\t\t\t);\n\t\t\treturn { ok: true };\n\t\t} catch (error) {\n\t\t\tthis.options.logger.error(\n\t\t\t\t{ err: error, connectionId: connection.id },\n\t\t\t\t'WebSocket disconnect handler failed',\n\t\t\t);\n\t\t\treturn { ok: false, error };\n\t\t}\n\t}\n\n\t/** Run a handler with its services, inside a request context of its own. */\n\tprivate async run(\n\t\troute: WebSocketRoute,\n\t\tconnectionId: string,\n\t\tcontext: (base: {\n\t\t\tservices: unknown;\n\t\t\tlogger: Logger;\n\t\t\tsockets: WebSocketPublisher<TMessages>;\n\t\t}) => object,\n\t\toptions: WebSocketCallOptions,\n\t): Promise<unknown> {\n\t\tconst logger = this.options.logger.child({\n\t\t\tconnectionId,\n\t\t\taction: route.action,\n\t\t});\n\t\treturn runWithRequestContext(\n\t\t\t{\n\t\t\t\tlogger,\n\t\t\t\trequestId: connectionId,\n\t\t\t\tstartTime: Date.now(),\n\t\t\t\toperation: `ws ${route.action}`,\n\t\t\t},\n\t\t\tasync () => {\n\t\t\t\tconst services = await this.services(route, options.services);\n\t\t\t\treturn (route.handler as (context: object) => unknown)(\n\t\t\t\t\tcontext({ services, logger, sockets: this.sockets }),\n\t\t\t\t);\n\t\t\t},\n\t\t);\n\t}\n\n\t/** The route's services: the overrides it names, the rest registered. */\n\tprivate async services(\n\t\troute: WebSocketRoute,\n\t\toverrides: Record<string, unknown> = {},\n\t): Promise<Record<string, unknown>> {\n\t\tconst given: Record<string, unknown> = {};\n\t\tconst wanted = route.services.filter((service) => {\n\t\t\tif (!Object.hasOwn(overrides, service.serviceName)) return true;\n\t\t\tgiven[service.serviceName] = overrides[service.serviceName];\n\t\t\treturn false;\n\t\t});\n\t\tconst registered = wanted.length\n\t\t\t? await ServiceDiscovery.getInstance(this.options.envParser).register([\n\t\t\t\t\t...wanted,\n\t\t\t\t])\n\t\t\t: {};\n\t\treturn { ...registered, ...given };\n\t}\n\n\tprivate error(\n\t\twrite: WriteFrame,\n\t\tat: { action?: string; id?: string | number },\n\t\tmessage: string,\n\t\tissues?: readonly StandardSchemaV1.Issue[],\n\t\terror?: unknown,\n\t): MessageOutcome {\n\t\twrite(\n\t\t\tthis.frame.encode(\n\t\t\t\t'$error',\n\t\t\t\t{ message, ...(issues ? { issues } : {}) },\n\t\t\t\tat.id,\n\t\t\t),\n\t\t);\n\t\treturn {\n\t\t\tok: false,\n\t\t\t...(at.action !== undefined ? { action: at.action } : {}),\n\t\t\t...(at.id !== undefined ? { id: at.id } : {}),\n\t\t\tmessage,\n\t\t\t...(issues ? { issues } : {}),\n\t\t\t...(error !== undefined ? { error } : {}),\n\t\t};\n\t}\n}\n","/**\n * What one client may ask of a WebSocket surface: how fast it opens\n * handshakes, how many it has in flight, how many sockets it holds, and how\n * fast each socket sends.\n *\n * The Node adaptor enforces them around the core — nothing here is the\n * surface's logic. A client is its address; a handshake, an open socket and\n * an identity's sockets are counted in a {@link WebSocketLimitStore}, which on\n * the Redis transport is that same Redis, so a limit holds across every\n * replica of the surface rather than per process. A socket's message rate is\n * its own, and is counted where the socket is.\n */\n\nimport type { IncomingMessage } from 'node:http';\nimport { isPrivateAddress } from '../privateAddress';\n\n/** Close codes the limits close a socket with. */\nexport const LIMIT_CLOSE = {\n\t/** Policy violation: it kept sending past its rate, or its identity has too many sockets. */\n\tpolicy: 1008,\n} as const;\n\n/**\n * What one client may ask of the surface. Every limit is on by default; set\n * one to `false` to lift it.\n */\nexport interface WebSocketLimits<TData = Record<string, unknown>> {\n\t/**\n\t * Handshakes one client address may start in a minute, across every\n\t * replica. Past it, an upgrade is answered 429 with `Retry-After` before\n\t * the connect handler — and the session lookup it makes — runs.\n\t * Default 120.\n\t */\n\thandshakesPerMinute?: number | false;\n\t/**\n\t * Handshakes one client address may have in flight at once — waiting on\n\t * the connect handler. Past it, 429. Default 16.\n\t */\n\tinFlightHandshakes?: number | false;\n\t/**\n\t * Open sockets one client address may hold, across every replica. Past\n\t * it, a new upgrade is answered 429. Default 256: many people share an\n\t * address behind a NAT.\n\t */\n\tconnectionsPerIp?: number | false;\n\t/**\n\t * Frames one socket may send a second, refilled continuously. Past it, a\n\t * frame is dropped and the socket is sent one `$error`; if it keeps\n\t * sending before its budget refills, it is closed with 1008. Default 50.\n\t */\n\tmessagesPerSecond?: number | false;\n\t/** Frames a socket may send at once before the rate applies. Default 100. */\n\tburst?: number;\n\t/**\n\t * Who a connection is, for {@link maxConnections}: a key read from what\n\t * the connect handler returned — `(data) => data.userId`. Absent, or\n\t * `undefined` for a connection, its sockets are not counted per identity.\n\t */\n\tmaxConnectionsPer?: (data: TData) => string | undefined;\n\t/**\n\t * Sockets one identity may hold, across every replica. Default 16, and\n\t * only with {@link maxConnectionsPer}.\n\t */\n\tmaxConnections?: number;\n\t/**\n\t * What a socket over {@link maxConnections} does: `'refuse'` answers the\n\t * new upgrade 429; `'closeOldest'` lets it in and closes that identity's\n\t * oldest sockets with 1008 — a user who opened a new tab keeps it.\n\t * Default `'refuse'`.\n\t */\n\toverflow?: 'refuse' | 'closeOldest';\n}\n\n/** The limits with every default filled in; `undefined` is off. */\nexport interface ResolvedWebSocketLimits {\n\thandshakesPerMinute?: number;\n\tinFlightHandshakes?: number;\n\tconnectionsPerIp?: number;\n\tmessagesPerSecond?: number;\n\tburst: number;\n\tmaxConnectionsPer?: (data: Record<string, unknown>) => string | undefined;\n\tmaxConnections: number;\n\toverflow: 'refuse' | 'closeOldest';\n}\n\nexport const DEFAULT_WEBSOCKET_LIMITS = {\n\thandshakesPerMinute: 120,\n\tinFlightHandshakes: 16,\n\tconnectionsPerIp: 256,\n\tmessagesPerSecond: 50,\n\tburst: 100,\n\tmaxConnections: 16,\n} as const;\n\n/** A limit that is not a whole number of at least one. */\nexport class InvalidWebSocketLimit extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly limit: string,\n\t\treadonly value: unknown,\n\t) {\n\t\tsuper(\n\t\t\t`${surface} sets limits.${limit} to ${String(value)}. A limit is a whole number of 1 or more — or false, to lift it.`,\n\t\t);\n\t\tthis.name = 'InvalidWebSocketLimit';\n\t}\n}\n\n/**\n * Fill in the defaults.\n *\n * @throws {InvalidWebSocketLimit} for a limit that is not a positive integer.\n */\nexport function resolveLimits(\n\tsurface: string,\n\tlimits: WebSocketLimits<any> = {},\n): ResolvedWebSocketLimits {\n\tconst pick = (\n\t\tname: keyof typeof DEFAULT_WEBSOCKET_LIMITS,\n\t\tvalue: number | false | undefined,\n\t): number | undefined => {\n\t\tif (value === false) return undefined;\n\t\tconst resolved = value ?? DEFAULT_WEBSOCKET_LIMITS[name];\n\t\tif (!Number.isInteger(resolved) || resolved < 1) {\n\t\t\tthrow new InvalidWebSocketLimit(surface, name, value);\n\t\t}\n\t\treturn resolved;\n\t};\n\tconst messagesPerSecond = pick('messagesPerSecond', limits.messagesPerSecond);\n\treturn {\n\t\t...optional(\n\t\t\t'handshakesPerMinute',\n\t\t\tpick('handshakesPerMinute', limits.handshakesPerMinute),\n\t\t),\n\t\t...optional(\n\t\t\t'inFlightHandshakes',\n\t\t\tpick('inFlightHandshakes', limits.inFlightHandshakes),\n\t\t),\n\t\t...optional(\n\t\t\t'connectionsPerIp',\n\t\t\tpick('connectionsPerIp', limits.connectionsPerIp),\n\t\t),\n\t\t...optional('messagesPerSecond', messagesPerSecond),\n\t\tburst: pick('burst', limits.burst) ?? DEFAULT_WEBSOCKET_LIMITS.burst,\n\t\t...(limits.maxConnectionsPer\n\t\t\t? { maxConnectionsPer: limits.maxConnectionsPer }\n\t\t\t: {}),\n\t\tmaxConnections:\n\t\t\tpick('maxConnections', limits.maxConnections) ??\n\t\t\tDEFAULT_WEBSOCKET_LIMITS.maxConnections,\n\t\toverflow: limits.overflow ?? 'refuse',\n\t};\n}\n\nfunction optional<K extends string>(\n\tkey: K,\n\tvalue: number | undefined,\n): Partial<Record<K, number>> {\n\treturn value === undefined ? {} : ({ [key]: value } as Record<K, number>);\n}\n\n/**\n * Where a surface's limits are counted. Every replica of a surface must see\n * the same store for a limit to hold across them: the Redis transport's own\n * Redis, or — in one process — memory.\n */\nexport interface WebSocketLimitStore {\n\t/**\n\t * Count one more hit in the window `key` names, opening a window of\n\t * `windowMs` on the first. Atomic: concurrent handshakes are each counted.\n\t */\n\thit(\n\t\tkey: string,\n\t\twindowMs: number,\n\t): Promise<{ count: number; resetMs: number }>;\n\t/**\n\t * Hold `member` in the set `key` until `ttlMs` from now — or until\n\t * {@link release}d — and return every member still held, oldest first.\n\t * A member a dead process never released lapses when its time is up.\n\t */\n\thold(key: string, member: string, ttlMs: number): Promise<string[]>;\n\t/** Let `member` go. */\n\trelease(key: string, member: string): Promise<void>;\n\t/** Hold each of `held` for another `ttlMs`. */\n\trenew(\n\t\theld: readonly { key: string; member: string }[],\n\t\tttlMs: number,\n\t): Promise<void>;\n}\n\n/**\n * In one process. Two servers on one `memory://` channel — replicas in a\n * test — share it, as they share the channel.\n */\nexport class MemoryLimitStore implements WebSocketLimitStore {\n\tprivate readonly windows = new Map<\n\t\tstring,\n\t\t{ count: number; resetAt: number }\n\t>();\n\t/** key → member → [opened, expires] */\n\tprivate readonly sets = new Map<string, Map<string, [number, number]>>();\n\n\tasync hit(\n\t\tkey: string,\n\t\twindowMs: number,\n\t): Promise<{ count: number; resetMs: number }> {\n\t\tconst now = Date.now();\n\t\tlet window = this.windows.get(key);\n\t\tif (!window || window.resetAt <= now) {\n\t\t\twindow = { count: 0, resetAt: now + windowMs };\n\t\t\tthis.windows.set(key, window);\n\t\t}\n\t\twindow.count++;\n\t\treturn { count: window.count, resetMs: window.resetAt - now };\n\t}\n\n\tasync hold(key: string, member: string, ttlMs: number): Promise<string[]> {\n\t\tconst now = Date.now();\n\t\tlet set = this.sets.get(key);\n\t\tif (!set) {\n\t\t\tset = new Map();\n\t\t\tthis.sets.set(key, set);\n\t\t}\n\t\tfor (const [held, [, expires]] of set) {\n\t\t\tif (expires <= now) set.delete(held);\n\t\t}\n\t\tconst opened = set.get(member)?.[0] ?? now;\n\t\tset.set(member, [opened, now + ttlMs]);\n\t\treturn [...set].sort((a, b) => a[1][0] - b[1][0]).map(([held]) => held);\n\t}\n\n\tasync release(key: string, member: string): Promise<void> {\n\t\tconst set = this.sets.get(key);\n\t\tset?.delete(member);\n\t\tif (set?.size === 0) this.sets.delete(key);\n\t}\n\n\tasync renew(\n\t\theld: readonly { key: string; member: string }[],\n\t\tttlMs: number,\n\t): Promise<void> {\n\t\tconst expires = Date.now() + ttlMs;\n\t\tfor (const { key, member } of held) {\n\t\t\tconst entry = this.sets.get(key)?.get(member);\n\t\t\tif (entry) entry[1] = expires;\n\t\t}\n\t}\n}\n\n/** The subset of an ioredis client the Redis store uses. */\nexport interface RedisEvalClient {\n\teval(\n\t\tscript: string,\n\t\tnumKeys: number,\n\t\t...args: (string | number)[]\n\t): Promise<unknown>;\n}\n\n// A fixed window: the first hit opens it.\nconst HIT = `\nlocal count = redis.call('INCR', KEYS[1])\nif count == 1 then redis.call('PEXPIRE', KEYS[1], ARGV[1]) end\nlocal ttl = redis.call('PTTL', KEYS[1])\nif ttl < 0 then\n redis.call('PEXPIRE', KEYS[1], ARGV[1])\n ttl = tonumber(ARGV[1])\nend\nreturn { count, ttl }\n`;\n\n// A sorted set scored by expiry. The member carries when it was opened, so\n// \"oldest\" survives renewal, which rescores it.\nconst HOLD = `\nredis.call('ZREMRANGEBYSCORE', KEYS[1], '-inf', ARGV[1])\nredis.call('ZADD', KEYS[1], ARGV[2], ARGV[3])\nredis.call('PEXPIRE', KEYS[1], ARGV[4])\nreturn redis.call('ZRANGE', KEYS[1], 0, -1)\n`;\n\nconst RENEW = `\nfor i, key in ipairs(KEYS) do\n redis.call('ZADD', key, 'XX', ARGV[1], ARGV[i + 2])\n redis.call('PEXPIRE', key, ARGV[2])\nend\nreturn 0\n`;\n\n/**\n * Over Redis — the transport's own — so every replica counts in one place.\n * Each operation is one script, so concurrent handshakes on any replica are\n * each counted.\n */\nexport class RedisLimitStore implements WebSocketLimitStore {\n\t/** member as handed in → member as stored, with its opening time. */\n\tprivate readonly stored = new Map<string, string>();\n\n\tconstructor(\n\t\tprivate readonly client: RedisEvalClient,\n\t\tprivate readonly prefix: string,\n\t) {}\n\n\tprivate key(key: string): string {\n\t\treturn `${this.prefix}:limits:${key}`;\n\t}\n\n\tprivate storedAs(key: string, member: string): string {\n\t\tconst id = `${key}\\n${member}`;\n\t\tlet stored = this.stored.get(id);\n\t\tif (!stored) {\n\t\t\tstored = `${Date.now().toString(36).padStart(9, '0')}|${member}`;\n\t\t\tthis.stored.set(id, stored);\n\t\t}\n\t\treturn stored;\n\t}\n\n\tasync hit(\n\t\tkey: string,\n\t\twindowMs: number,\n\t): Promise<{ count: number; resetMs: number }> {\n\t\tconst [count, resetMs] = (await this.client.eval(\n\t\t\tHIT,\n\t\t\t1,\n\t\t\tthis.key(key),\n\t\t\twindowMs,\n\t\t)) as [number, number];\n\t\treturn { count: Number(count), resetMs: Number(resetMs) };\n\t}\n\n\tasync hold(key: string, member: string, ttlMs: number): Promise<string[]> {\n\t\tconst now = Date.now();\n\t\tconst members = (await this.client.eval(\n\t\t\tHOLD,\n\t\t\t1,\n\t\t\tthis.key(key),\n\t\t\tnow,\n\t\t\tnow + ttlMs,\n\t\t\tthis.storedAs(key, member),\n\t\t\tttlMs,\n\t\t)) as string[];\n\t\treturn members\n\t\t\t.sort()\n\t\t\t.map((stored) => stored.slice(stored.indexOf('|') + 1));\n\t}\n\n\tasync release(key: string, member: string): Promise<void> {\n\t\tconst id = `${key}\\n${member}`;\n\t\tconst stored = this.stored.get(id);\n\t\tthis.stored.delete(id);\n\t\tif (!stored) return;\n\t\tawait this.client.eval(\n\t\t\t\"return redis.call('ZREM', KEYS[1], ARGV[1])\",\n\t\t\t1,\n\t\t\tthis.key(key),\n\t\t\tstored,\n\t\t);\n\t}\n\n\tasync renew(\n\t\theld: readonly { key: string; member: string }[],\n\t\tttlMs: number,\n\t): Promise<void> {\n\t\tconst known = held.flatMap(({ key, member }) => {\n\t\t\tconst stored = this.stored.get(`${key}\\n${member}`);\n\t\t\treturn stored ? [{ key: this.key(key), stored }] : [];\n\t\t});\n\t\tif (known.length === 0) return;\n\t\tawait this.client.eval(\n\t\t\tRENEW,\n\t\t\tknown.length,\n\t\t\t...known.map(({ key }) => key),\n\t\t\tDate.now() + ttlMs,\n\t\t\tttlMs,\n\t\t\t...known.map(({ stored }) => stored),\n\t\t);\n\t}\n}\n\n/**\n * A socket's inbound budget: `burst` frames at once, refilled at `rate` a\n * second.\n */\nexport class TokenBucket {\n\tprivate tokens: number;\n\tprivate at = Date.now();\n\n\tconstructor(\n\t\tprivate readonly rate: number,\n\t\tprivate readonly burst: number,\n\t) {\n\t\tthis.tokens = burst;\n\t}\n\n\t/** Spend one token, if there is one. */\n\ttake(now = Date.now()): boolean {\n\t\tthis.tokens = Math.min(\n\t\t\tthis.burst,\n\t\t\tthis.tokens + ((now - this.at) / 1000) * this.rate,\n\t\t);\n\t\tthis.at = now;\n\t\tif (this.tokens < 1) return false;\n\t\tthis.tokens -= 1;\n\t\treturn true;\n\t}\n\n\t/** Whether it has refilled completely since it last ran dry. */\n\tget full(): boolean {\n\t\treturn this.tokens >= this.burst - 1;\n\t}\n}\n\n/**\n * The client a handshake is counted against. Behind the stack's edge — a\n * private peer — the address the edge put last in `X-Forwarded-For`, the one\n * it saw; Traefik and Caddy both replace what an outside client sent there.\n * From anywhere else, the peer itself: a header a client could set never\n * picks the bucket it is counted in.\n */\nexport function clientAddress(request: IncomingMessage): string {\n\tconst peer = request.socket.remoteAddress ?? 'unknown';\n\tconst forwarded = request.headers['x-forwarded-for'];\n\tif (!forwarded || !isPrivateAddress(peer)) return peer;\n\tconst chain = (Array.isArray(forwarded) ? forwarded.join(',') : forwarded)\n\t\t.split(',')\n\t\t.map((hop) => hop.trim())\n\t\t.filter(Boolean);\n\treturn chain.at(-1) ?? peer;\n}\n","/**\n * The Test adaptor: a surface's routes called directly, with no server and\n * no socket — what `route.request()` and `surface.testPublisher()` are built\n * on.\n *\n * A route's `request()` builds a core over just that route and calls\n * `connect()`, `message()` or `disconnect()` on it, as the Node adaptor does\n * for a socket. What its handler sends through `sockets` goes to a recording\n * publisher, the same one `surface.testPublisher()` hands an endpoint's spec.\n */\n\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport type { WebSocketCore } from './core';\nimport type { FrameShape } from './frame';\nimport {\n\ttype NoMessages,\n\ttype WebSocketMessages,\n\tWebSocketPublisher,\n\ttype WebSocketSink,\n} from './publisher';\nimport type { Connection, WebSocketRoute } from './route';\n\n/** One recorded message: its action and data, and the frame on the wire. */\nexport type RecordedMessage<TMessages extends WebSocketMessages = NoMessages> =\n\t[keyof TMessages] extends [never]\n\t\t? { action: string; data: unknown; frame: Record<string, unknown> }\n\t\t: {\n\t\t\t\t[A in keyof TMessages & string]: {\n\t\t\t\t\taction: A;\n\t\t\t\t\t/** As its schema returned it — what the client receives. */\n\t\t\t\t\tdata: StandardSchemaV1.InferOutput<TMessages[A]>;\n\t\t\t\t\t/** The frame as the client parses it — the wire shape. */\n\t\t\t\t\tframe: Record<string, unknown>;\n\t\t\t\t};\n\t\t\t}[keyof TMessages & string];\n\n/** A `send(ids, …)`, as it was recorded. */\nexport type RecordedSend<TMessages extends WebSocketMessages = NoMessages> =\n\tRecordedMessage<TMessages> & { ids: string[] };\n\n/** A `broadcast(…)`, as it was recorded. */\nexport type RecordedBroadcast<\n\tTMessages extends WebSocketMessages = NoMessages,\n> = RecordedMessage<TMessages> & { except: string[] };\n\n/** A `close(ids, code, reason)`, as it was recorded. */\nexport interface RecordedClose {\n\tids: string[];\n\tcode: number;\n\treason: string;\n}\n\n/**\n * A sink that keeps what it is handed, decoded by the surface's frame shape,\n * and sends it nowhere.\n */\nexport class RecordingSink implements WebSocketSink {\n\treadonly sent: RecordedSend<any>[] = [];\n\treadonly broadcasts: RecordedBroadcast<any>[] = [];\n\treadonly closed: RecordedClose[] = [];\n\n\tconstructor(private readonly frame: FrameShape) {}\n\n\tasync send(ids: readonly string[], payload: string): Promise<void> {\n\t\tthis.sent.push({ ids: [...ids], ...this.decode(payload) });\n\t}\n\n\tasync broadcast(payload: string, except?: readonly string[]): Promise<void> {\n\t\tthis.broadcasts.push({\n\t\t\texcept: [...(except ?? [])],\n\t\t\t...this.decode(payload),\n\t\t});\n\t}\n\n\tasync close(\n\t\tids: readonly string[],\n\t\tcode: number,\n\t\treason: string,\n\t): Promise<void> {\n\t\tthis.closed.push({ ids: [...ids], code, reason });\n\t}\n\n\tclear(): void {\n\t\tthis.sent.length = 0;\n\t\tthis.broadcasts.length = 0;\n\t\tthis.closed.length = 0;\n\t}\n\n\tprivate decode(payload: string): RecordedMessage {\n\t\tconst frame = JSON.parse(payload) as Record<string, unknown>;\n\t\t// A publisher only ever hands over a frame it encoded itself.\n\t\tconst { action, data } = this.frame.decode(frame)!;\n\t\treturn { action, data, frame };\n\t}\n}\n\n/**\n * A surface's publisher that records rather than sends — what\n * `surface.testPublisher()` returns, of the type `services.<surface>` is.\n *\n * Every send is still checked by the declared `messages` and encoded by the\n * surface's `frame`, so an invalid push fails the spec as it would fail\n * deployed, and `frame` on each record is what the client would parse.\n */\nexport class TestWebSocketPublisher<\n\tTMessages extends WebSocketMessages = NoMessages,\n> extends WebSocketPublisher<TMessages> {\n\t/** Where the records are kept — what `route.request()` builds its core on. */\n\treadonly recording: RecordingSink;\n\n\tconstructor(\n\t\tframe: FrameShape,\n\t\tdeclared?: { surface: string; messages: TMessages },\n\t) {\n\t\tconst recording = new RecordingSink(frame);\n\t\tsuper(recording, declared, frame);\n\t\tthis.recording = recording;\n\t}\n\n\t/** Each `send(ids, action, data)`, in order. */\n\tget sent(): readonly RecordedSend<TMessages>[] {\n\t\treturn this.recording.sent;\n\t}\n\n\t/** Each `broadcast(action, data, { except })`, in order. */\n\tget broadcasts(): readonly RecordedBroadcast<TMessages>[] {\n\t\treturn this.recording.broadcasts;\n\t}\n\n\t/** Each `close(ids, code, reason)`, in order. */\n\tget closed(): readonly RecordedClose[] {\n\t\treturn this.recording.closed;\n\t}\n\n\t/** Forget everything recorded so far. */\n\tclear(): void {\n\t\tthis.recording.clear();\n\t}\n}\n\n/** A frame `route.request()` sent was refused before its handler ran. */\nexport class InvalidWebSocketRequest extends Error {\n\tconstructor(\n\t\treadonly surface: string,\n\t\treadonly action: string,\n\t\t/** What the `$error` frame said. */\n\t\treadonly reason: string,\n\t\treadonly issues?: readonly StandardSchemaV1.Issue[],\n\t) {\n\t\tsuper(\n\t\t\t`${surface}'s '${action}' route refused the request: ${reason}${\n\t\t\t\tissues?.length\n\t\t\t\t\t? ` ${issues.map((issue) => issue.message).join('; ')}.`\n\t\t\t\t\t: ''\n\t\t\t} Send a body its schema accepts.`,\n\t\t);\n\t\tthis.name = 'InvalidWebSocketRequest';\n\t}\n}\n\n/** What a surface hands its routes' `request()`. */\nexport interface WebSocketTestSurface {\n\treadonly id: string;\n\tcore(options: {\n\t\tenvParser: EnvironmentParser<{}>;\n\t\tsink: WebSocketSink;\n\t\tmodules?: readonly object[];\n\t}): WebSocketCore<any>;\n\treadonly envParser: EnvironmentParser<{}>;\n\ttestPublisher(): TestWebSocketPublisher<any>;\n}\n\n/** Overrides every `request()` takes. */\nexport interface WebSocketTestCallOptions {\n\t/**\n\t * Instances for the route's dependencies, by service name — a test's\n\t * transaction for `database`. Any it depends on and is not handed here is\n\t * registered, as deployed.\n\t */\n\tservices?: Record<string, unknown>;\n\t/**\n\t * The handler's `sockets`. Pass `surface.testPublisher()` to assert what\n\t * it sent; absent, a fresh one that nobody reads.\n\t */\n\tsockets?: TestWebSocketPublisher<any>;\n}\n\nexport interface TestConnectRequest extends WebSocketTestCallOptions {\n\t/** The id the connection is given. Absent, `test.<n>`. */\n\tconnectionId?: string;\n\t/** The handshake's headers — what `.auth()` verifies without a `session`. */\n\theaders?: ConstructorParameters<typeof Headers>[0];\n\t/** The upgrade URL's query. */\n\tquery?: string | Record<string, string> | URLSearchParams;\n\t/**\n\t * What the surface's `.auth()` would have resolved — `null` for no\n\t * session. Absent, `.auth()` verifies `headers`, as on a real upgrade.\n\t */\n\tsession?: unknown;\n}\n\nexport interface TestMessageRequest<TBody = unknown>\n\textends WebSocketTestCallOptions {\n\t/** The connection the frame arrives on. Absent, `test.<n>` with no data. */\n\tconnection?: TestConnection;\n\t/** The frame's data — checked by the route's `body`, as a frame's is. */\n\tbody: TBody;\n\t/** The frame's `id`, echoed on its reply. Only `{ action, data }` frames. */\n\tid?: string | number;\n}\n\nexport interface TestDisconnectRequest extends WebSocketTestCallOptions {\n\t/** The connection that closed. Absent, `test.<n>` with no data. */\n\tconnection?: TestConnection;\n\t/** Default 1000. */\n\tcode?: number;\n\t/** Default ''. */\n\treason?: string;\n}\n\n/** A connection a test names: either part may be left to its default. */\nexport interface TestConnection {\n\tid?: string;\n\tdata?: Record<string, unknown>;\n}\n\n/** What a message route's `fullRequest()` resolves with. */\nexport interface TestMessageResponse<TReturned = unknown> {\n\t/** The handler's return — the reply, before it was encoded. */\n\treturned: TReturned;\n\t/**\n\t * Every frame written back to the connection, parsed, in order: each\n\t * `reply()` and the reply to the frame itself.\n\t */\n\tframes: unknown[];\n}\n\nlet issued = 0;\n\n/** A connection id no other test call is using. */\nfunction nextConnectionId(): string {\n\tissued += 1;\n\treturn `test.${issued}`;\n}\n\nfunction connectionOf(given?: TestConnection): Connection {\n\treturn { id: given?.id ?? nextConnectionId(), data: given?.data ?? {} };\n}\n\nfunction coreFor(\n\troute: WebSocketRoute<any, any, any, any, any>,\n\tsurface: WebSocketTestSurface,\n\tsockets: TestWebSocketPublisher<any> | undefined,\n): WebSocketCore<any> {\n\treturn surface.core({\n\t\tenvParser: surface.envParser,\n\t\tsink: (sockets ?? surface.testPublisher()).recording,\n\t\tmodules: [{ route }],\n\t});\n}\n\n/** `connect.request()`: the connection's `data`, or what refused it. */\nexport async function requestConnect(\n\troute: WebSocketRoute<any, any, any, any, any>,\n\tsurface: WebSocketTestSurface,\n\trequest: TestConnectRequest = {},\n): Promise<Record<string, unknown>> {\n\tconst core = coreFor(route, surface, request.sockets);\n\tconst outcome = await core.connect(\n\t\t{\n\t\t\tconnectionId: request.connectionId ?? nextConnectionId(),\n\t\t\theaders: new Headers(request.headers),\n\t\t\tquery: new URLSearchParams(request.query),\n\t\t\t...('session' in request ? { session: request.session } : {}),\n\t\t},\n\t\trequest.services ? { services: request.services } : {},\n\t);\n\tif (!outcome.accepted) throw outcome.error;\n\treturn outcome.connection.data;\n}\n\n/** A message route's `fullRequest()`: what it returned and wrote. */\nexport async function requestMessage(\n\troute: WebSocketRoute<any, any, any, any, any>,\n\tsurface: WebSocketTestSurface,\n\trequest: TestMessageRequest,\n): Promise<TestMessageResponse> {\n\tconst core = coreFor(route, surface, request.sockets);\n\tconst frames: unknown[] = [];\n\tconst outcome = await core.message(\n\t\tconnectionOf(request.connection),\n\t\tcore.frame.encode(route.action, request.body, request.id),\n\t\t(payload) => frames.push(JSON.parse(payload)),\n\t\trequest.services ? { services: request.services } : {},\n\t);\n\tif (outcome.ok) return { returned: outcome.returned, frames };\n\tif ('error' in outcome) throw outcome.error;\n\tthrow new InvalidWebSocketRequest(\n\t\tsurface.id,\n\t\troute.action,\n\t\toutcome.message,\n\t\toutcome.issues,\n\t);\n}\n\n/** `disconnect.request()`: resolves once the handler has run. */\nexport async function requestDisconnect(\n\troute: WebSocketRoute<any, any, any, any, any>,\n\tsurface: WebSocketTestSurface,\n\trequest: TestDisconnectRequest = {},\n): Promise<void> {\n\tconst core = coreFor(route, surface, request.sockets);\n\tconst outcome = await core.disconnect(\n\t\tconnectionOf(request.connection),\n\t\t{ code: request.code ?? 1000, reason: request.reason ?? '' },\n\t\trequest.services ? { services: request.services } : {},\n\t);\n\tif (!outcome.ok) throw outcome.error;\n}\n","import type { Logger } from '@geekmidas/logger';\nimport type { InferStandardSchema } from '@geekmidas/schema';\nimport type { Service, ServiceRecord } from '@geekmidas/services';\nimport type { StandardSchemaV1 } from '@standard-schema/spec';\nimport {\n\ttype Consumable,\n\tidsOf,\n\ttype ServicesOf,\n\tservicesOf,\n} from '../construct-interface';\nimport type {\n\tNoMessages,\n\tWebSocketMessages,\n\tWebSocketPublisher,\n} from './publisher';\nimport {\n\trequestConnect,\n\trequestDisconnect,\n\trequestMessage,\n\ttype TestConnectRequest,\n\ttype TestDisconnectRequest,\n\ttype TestMessageRequest,\n\ttype TestMessageResponse,\n\ttype TestWebSocketPublisher,\n\ttype WebSocketTestSurface,\n} from './testing';\n\n/** One open connection, as a handler sees it. */\nexport interface Connection {\n\treadonly id: string;\n\t/**\n\t * What the connect handler returned — who the connection is for, the room\n\t * it joined. `{}` when it returned nothing.\n\t */\n\treadonly data: Record<string, unknown>;\n}\n\ninterface BaseContext<\n\tTServices extends Service[],\n\tTMessages extends WebSocketMessages,\n> {\n\tservices: ServiceRecord<TServices>;\n\tlogger: Logger;\n\t/** Every socket this surface holds, on whichever process holds it. */\n\tsockets: WebSocketPublisher<TMessages>;\n}\n\nexport interface ConnectContext<\n\tTServices extends Service[],\n\tTMessages extends WebSocketMessages = NoMessages,\n> extends BaseContext<TServices, TMessages> {\n\tconnectionId: string;\n\theaders: Headers;\n\tquery: URLSearchParams;\n\t/**\n\t * Whose connection it is, from the surface's `.auth()` — `null` when the\n\t * upgrade carried no session, and when the surface names no authenticator.\n\t * Throw an `UnauthorizedError` to refuse it.\n\t */\n\tsession: unknown;\n}\n\nexport interface MessageContext<\n\tTBody,\n\tTServices extends Service[],\n\tTMessages extends WebSocketMessages = NoMessages,\n> extends BaseContext<TServices, TMessages> {\n\tconnection: Connection;\n\tbody: TBody;\n\t/** Send to this connection alone. */\n\treply(message: unknown): void;\n}\n\nexport interface DisconnectContext<\n\tTServices extends Service[],\n\tTMessages extends WebSocketMessages = NoMessages,\n> extends BaseContext<TServices, TMessages> {\n\tconnection: Connection;\n\tcode: number;\n\treason: string;\n}\n\n/** What a frame is dispatched on: an action, or the connection's lifecycle. */\nexport type RouteKind = 'connect' | 'disconnect' | 'message';\n\n/**\n * A handler bound to a WebSocket surface — what `realtime.route('chat.send')\n * …handle()` returns, and what a file exports.\n *\n * Carries `surface` and `constructs` the way an endpoint does, so discovery\n * records what its process reaches without knowing what a route is.\n */\nexport class WebSocketRoute<\n\tTKind extends RouteKind = RouteKind,\n\tTSchema extends StandardSchemaV1 | undefined = StandardSchemaV1 | undefined,\n\tTServices extends Service[] = Service[],\n\t/** What the handler returns. */\n\tTReturn = unknown,\n\tTMessages extends WebSocketMessages = WebSocketMessages,\n> {\n\treadonly __IS_WEBSOCKET_ROUTE__ = true;\n\n\tstatic isRoute(value: unknown): value is WebSocketRoute {\n\t\treturn Boolean(\n\t\t\tvalue &&\n\t\t\t\t(value as { __IS_WEBSOCKET_ROUTE__?: unknown })\n\t\t\t\t\t.__IS_WEBSOCKET_ROUTE__ === true,\n\t\t);\n\t}\n\n\tconstructor(\n\t\treadonly kind: TKind,\n\t\t/** The `action` it answers; `$connect` and `$disconnect` for the lifecycle. */\n\t\treadonly action: string,\n\t\t/** The surface it was built from — what `request()` builds a core on. */\n\t\treadonly surface: WebSocketTestSurface,\n\t\treadonly services: readonly Service[],\n\t\t/** Construct ids it depends on — its edges in the manifest. */\n\t\treadonly constructs: readonly string[],\n\t\treadonly handler: (context: never) => unknown,\n\t\treadonly schema?: TSchema,\n\t) {}\n\n\t/**\n\t * Run the handler as its surface would, with no server and no socket —\n\t * as `endpoint.request()` runs an endpoint.\n\t *\n\t * - `connect`: resolves with the connection's `data`, or rejects with what\n\t * refused it (an `UnauthorizedError` stays a 401).\n\t * - a message route: `body` is encoded as a frame and checked by the\n\t * route's schema; resolves with the handler's return, or rejects with\n\t * what it threw or an `InvalidWebSocketRequest`.\n\t * - `disconnect`: resolves once the handler has run, or rejects with what\n\t * it threw.\n\t */\n\trequest(\n\t\t...[request]: RequestArgs<TKind, TSchema, TServices, TMessages>\n\t): Promise<WebSocketRouteResult<TKind, TReturn>> {\n\t\tconst route = this as AnyRoute;\n\t\tconst given = (request ?? {}) as TestConnectRequest & TestDisconnectRequest;\n\t\tif (this.kind === 'connect') {\n\t\t\treturn requestConnect(route, this.surface, given) as never;\n\t\t}\n\t\tif (this.kind === 'disconnect') {\n\t\t\treturn requestDisconnect(route, this.surface, given) as never;\n\t\t}\n\t\treturn requestMessage(\n\t\t\troute,\n\t\t\tthis.surface,\n\t\t\tgiven as unknown as TestMessageRequest,\n\t\t).then(({ returned }) => returned) as never;\n\t}\n\n\t/**\n\t * A message route's `request()`, with every frame it wrote back to the\n\t * connection — each `reply()` and the reply itself — beside its return.\n\t */\n\tfullRequest(\n\t\tthis: WebSocketRoute<'message', TSchema, TServices, TReturn, TMessages>,\n\t\trequest: WebSocketRouteRequest<'message', TSchema, TServices, TMessages>,\n\t): Promise<TestMessageResponse<Awaited<TReturn>>> {\n\t\treturn requestMessage(\n\t\t\tthis as AnyRoute,\n\t\t\tthis.surface,\n\t\t\trequest as unknown as TestMessageRequest,\n\t\t) as Promise<TestMessageResponse<Awaited<TReturn>>>;\n\t}\n}\n\ntype AnyRoute = WebSocketRoute<any, any, any, any, any>;\n\n/** A message route needs a body; the lifecycle's request may be left out. */\ntype RequestArgs<\n\tTKind extends RouteKind,\n\tTSchema extends StandardSchemaV1 | undefined,\n\tTServices extends Service[],\n\tTMessages extends WebSocketMessages,\n> = TKind extends 'message'\n\t? [request: WebSocketRouteRequest<TKind, TSchema, TServices, TMessages>]\n\t: [request?: WebSocketRouteRequest<TKind, TSchema, TServices, TMessages>];\n\n/** What `request()` takes for each kind of route. */\nexport type WebSocketRouteRequest<\n\tTKind extends RouteKind,\n\tTSchema extends StandardSchemaV1 | undefined,\n\tTServices extends Service[],\n\tTMessages extends WebSocketMessages,\n> = TestCallOverrides<TServices, TMessages> &\n\t(TKind extends 'connect'\n\t\t? Omit<TestConnectRequest, 'services' | 'sockets'>\n\t\t: TKind extends 'disconnect'\n\t\t\t? Omit<TestDisconnectRequest, 'services' | 'sockets'>\n\t\t\t: Omit<\n\t\t\t\t\tTestMessageRequest<\n\t\t\t\t\t\tTSchema extends StandardSchemaV1\n\t\t\t\t\t\t\t? StandardSchemaV1.InferInput<TSchema>\n\t\t\t\t\t\t\t: unknown\n\t\t\t\t\t>,\n\t\t\t\t\t'services' | 'sockets'\n\t\t\t\t>);\n\n/** `services` typed by what the route depends on; `sockets` by the surface. */\nexport interface TestCallOverrides<\n\tTServices extends Service[],\n\tTMessages extends WebSocketMessages,\n> {\n\t/**\n\t * Instances for the route's dependencies — a test's transaction for\n\t * `database`. Any it depends on and is not handed here is registered.\n\t */\n\tservices?: Partial<ServiceRecord<TServices>>;\n\t/** The handler's `sockets` — `surface.testPublisher()` to assert on. */\n\tsockets?: TestWebSocketPublisher<TMessages>;\n}\n\n/** What `request()` resolves with for each kind of route. */\nexport type WebSocketRouteResult<\n\tTKind extends RouteKind,\n\tTReturn,\n> = TKind extends 'connect'\n\t? ConnectData<Awaited<TReturn>>\n\t: TKind extends 'disconnect'\n\t\t? undefined\n\t\t: Awaited<TReturn>;\n\n/** A connect handler's return as the connection keeps it: `{}` for nothing. */\ntype ConnectData<T> = T extends undefined ? {} : T;\n\n/** What a handler may return, by kind: connect's becomes `data`. */\ntype HandlerReturn<TKind extends RouteKind> = TKind extends 'connect'\n\t?\n\t\t\t| Record<string, unknown>\n\t\t\t| undefined\n\t\t\t| Promise<Record<string, unknown> | undefined>\n\t: unknown;\n\n/** The builder `connect()`, `disconnect()` and `route()` start. */\nexport class WebSocketRouteBuilder<\n\tTKind extends RouteKind,\n\tTSchema extends StandardSchemaV1 | undefined = undefined,\n\tTServices extends Service[] = [],\n\t/** The surface's declared messages, which `sockets` sends. */\n\tTMessages extends WebSocketMessages = NoMessages,\n> {\n\tconstructor(\n\t\tprivate readonly kind: TKind,\n\t\tprivate readonly action: string,\n\t\tprivate readonly surface: WebSocketTestSurface,\n\t\tprivate readonly _services: readonly Service[] = [],\n\t\tprivate readonly _constructs: readonly string[] = [],\n\t\tprivate readonly schema?: TSchema,\n\t) {}\n\n\t/** The schema a frame's `data` must satisfy before the handler runs. */\n\tbody<S extends StandardSchemaV1>(\n\t\tschema: S,\n\t): WebSocketRouteBuilder<TKind, S, TServices, TMessages> {\n\t\treturn new WebSocketRouteBuilder(\n\t\t\tthis.kind,\n\t\t\tthis.action,\n\t\t\tthis.surface,\n\t\t\tthis._services,\n\t\t\tthis._constructs,\n\t\t\tschema,\n\t\t);\n\t}\n\n\t/** What the handler reaches, as `services.<id>` — per route, as an endpoint's. */\n\tdependsOn<const T extends readonly Consumable[]>(\n\t\tconstructs: T,\n\t): WebSocketRouteBuilder<\n\t\tTKind,\n\t\tTSchema,\n\t\t[...TServices, ...ServicesOf<T>],\n\t\tTMessages\n\t> {\n\t\treturn new WebSocketRouteBuilder(\n\t\t\tthis.kind,\n\t\t\tthis.action,\n\t\t\tthis.surface,\n\t\t\t[...this._services, ...(servicesOf(constructs) as Service[])],\n\t\t\tidsOf(constructs, this._constructs),\n\t\t\tthis.schema,\n\t\t) as never;\n\t}\n\n\t/**\n\t * The handler. A message handler's return value, when there is one, is\n\t * sent back to the connection as the reply to that frame; a connect\n\t * handler's is kept as the connection's `data`.\n\t */\n\thandle<TReturn extends HandlerReturn<TKind>>(\n\t\thandler: TKind extends 'connect'\n\t\t\t? (context: ConnectContext<TServices, TMessages>) => TReturn\n\t\t\t: TKind extends 'disconnect'\n\t\t\t\t? (context: DisconnectContext<TServices, TMessages>) => TReturn\n\t\t\t\t: (\n\t\t\t\t\t\tcontext: MessageContext<\n\t\t\t\t\t\t\tTSchema extends StandardSchemaV1\n\t\t\t\t\t\t\t\t? InferStandardSchema<TSchema>\n\t\t\t\t\t\t\t\t: unknown,\n\t\t\t\t\t\t\tTServices,\n\t\t\t\t\t\t\tTMessages\n\t\t\t\t\t\t>,\n\t\t\t\t\t) => TReturn,\n\t): WebSocketRoute<TKind, TSchema, TServices, TReturn, TMessages> {\n\t\treturn new WebSocketRoute(\n\t\t\tthis.kind,\n\t\t\tthis.action,\n\t\t\tthis.surface,\n\t\t\tthis._services,\n\t\t\tthis._constructs,\n\t\t\thandler as (context: never) => unknown,\n\t\t\tthis.schema,\n\t\t);\n\t}\n}\n","/**\n * How a send reaches the process holding the socket.\n *\n * A connection id names the process it lives on — `<instance>.<n>` — so a send\n * needs no registry: it is published to that instance's channel and nowhere\n * else. A broadcast goes to every instance. On a stack the channels are Redis\n * pub/sub, so an endpoint in another container reaches a socket the same way a\n * route beside it does; in one process (a test, a single dev server) they are\n * a map.\n */\n\nimport { loadIoredis } from '../optionalPeers';\nimport {\n\tMemoryLimitStore,\n\tRedisLimitStore,\n\ttype WebSocketLimitStore,\n} from './limits';\nimport type { WebSocketSink } from './publisher';\n\n/** What one process is asked to do with the sockets it holds. */\nexport type Delivery =\n\t| { kind: 'send'; ids: readonly string[]; payload: string }\n\t| { kind: 'broadcast'; payload: string; except?: readonly string[] }\n\t| { kind: 'close'; ids: readonly string[]; code: number; reason: string };\n\nexport interface WebSocketTransport {\n\t/** Deliver to one instance, or to every instance when it is `'*'`. */\n\tpublish(instance: string, delivery: Delivery): Promise<void>;\n\t/** Receive what is published to `instance`, and every broadcast. */\n\tsubscribe(\n\t\tinstance: string,\n\t\treceive: (delivery: Delivery) => void,\n\t): Promise<void>;\n\tclose(): Promise<void>;\n\t/**\n\t * Where the surface's limits are counted — somewhere every process on\n\t * this transport sees, so a limit holds across them. Absent, each\n\t * process counts its own.\n\t */\n\tlimits?(): WebSocketLimitStore;\n}\n\n/** Every instance — what a broadcast is published to. */\nexport const EVERY_INSTANCE = '*';\n\n/** The instance a connection id was issued by: everything before its dot. */\nexport function instanceOf(connectionId: string): string | undefined {\n\tconst dot = connectionId.indexOf('.');\n\treturn dot > 0 ? connectionId.slice(0, dot) : undefined;\n}\n\n/**\n * A publisher's sink over a transport: a send goes to the instance each\n * connection id names, a broadcast to every instance. What `services.<id>`\n * sends through, and what the Node adaptor's own `sockets` do.\n */\nexport class TransportSink implements WebSocketSink {\n\tconstructor(\n\t\tprivate readonly transport: WebSocketTransport,\n\t\t/**\n\t\t * Delivers to this process's own sockets without a round trip through\n\t\t * the transport — set by the process that holds them.\n\t\t */\n\t\tprivate readonly local?: {\n\t\t\tinstance: string;\n\t\t\tdeliver(delivery: Delivery): void;\n\t\t},\n\t) {}\n\n\tsend(ids: readonly string[], payload: string): Promise<void> {\n\t\treturn this.each(ids, (group) => ({ kind: 'send', ids: group, payload }));\n\t}\n\n\tasync broadcast(payload: string, except?: readonly string[]): Promise<void> {\n\t\tawait this.transport.publish(EVERY_INSTANCE, {\n\t\t\tkind: 'broadcast',\n\t\t\tpayload,\n\t\t\t...(except?.length ? { except } : {}),\n\t\t});\n\t}\n\n\tclose(ids: readonly string[], code: number, reason: string): Promise<void> {\n\t\treturn this.each(ids, (group) => ({\n\t\t\tkind: 'close',\n\t\t\tids: group,\n\t\t\tcode,\n\t\t\treason,\n\t\t}));\n\t}\n\n\t/** One delivery per process that holds any of `ids`. */\n\tprivate async each(\n\t\tids: readonly string[],\n\t\tdelivery: (group: string[]) => Delivery,\n\t): Promise<void> {\n\t\tconst byInstance = new Map<string, string[]>();\n\t\tfor (const id of ids) {\n\t\t\tconst instance = instanceOf(id);\n\t\t\tif (!instance) continue;\n\t\t\tconst group = byInstance.get(instance) ?? [];\n\t\t\tgroup.push(id);\n\t\t\tbyInstance.set(instance, group);\n\t\t}\n\n\t\tawait Promise.all(\n\t\t\t[...byInstance].map(([instance, group]) =>\n\t\t\t\tthis.local?.instance === instance\n\t\t\t\t\t? this.local.deliver(delivery(group))\n\t\t\t\t\t: this.transport.publish(instance, delivery(group)),\n\t\t\t),\n\t\t);\n\t}\n}\n\n/** A connection string names no transport this package knows. */\nexport class UnsupportedWebSocketTransport extends Error {\n\tconstructor(readonly connectionString: string) {\n\t\tsuper(\n\t\t\t`'${redact(connectionString)}' is not a WebSocket publisher connection string. ` +\n\t\t\t\t'Use redis://, rediss:// or memory:// — gkm composes it as <ID>_PUBLISHER_CONNECTION_STRING.',\n\t\t);\n\t\tthis.name = 'UnsupportedWebSocketTransport';\n\t}\n}\n\n/** The scheme alone, so an error never prints a password. */\nfunction redact(connectionString: string): string {\n\tconst scheme = connectionString.split('://')[0];\n\treturn scheme && scheme !== connectionString\n\t\t? `${scheme}://…`\n\t\t: connectionString.slice(0, 12);\n}\n\n// On globalThis, as the shutdown hooks are: a package loaded as ESM and CJS\n// would otherwise hold two maps, and a publisher would talk to the empty one.\nconst key = Symbol.for('@geekmidas/constructs/websocket/memory');\nconst registry = globalThis as Record<\n\tsymbol,\n\tMap<string, Map<string, (delivery: Delivery) => void>> | undefined\n>;\nregistry[key] ??= new Map();\nconst channels = registry[key];\n\n// The limits each channel counts in, beside it: two servers on one channel\n// are replicas, and share them.\nconst limitsKey = Symbol.for('@geekmidas/constructs/websocket/memory-limits');\nconst limitRegistry = globalThis as Record<\n\tsymbol,\n\tMap<string, MemoryLimitStore> | undefined\n>;\nlimitRegistry[limitsKey] ??= new Map();\nconst limitStores = limitRegistry[limitsKey];\n\n/**\n * In one process: the server and whoever sends meet in a map, keyed by the\n * channel the connection string names.\n */\nexport class MemoryTransport implements WebSocketTransport {\n\tprivate readonly subscribed = new Set<string>();\n\n\tconstructor(private readonly channel: string) {}\n\n\tasync publish(instance: string, delivery: Delivery): Promise<void> {\n\t\tconst instances = channels.get(this.channel);\n\t\tif (!instances) return;\n\t\tif (instance === EVERY_INSTANCE) {\n\t\t\tfor (const receive of instances.values()) receive(delivery);\n\t\t\treturn;\n\t\t}\n\t\tinstances.get(instance)?.(delivery);\n\t}\n\n\tasync subscribe(\n\t\tinstance: string,\n\t\treceive: (delivery: Delivery) => void,\n\t): Promise<void> {\n\t\tlet instances = channels.get(this.channel);\n\t\tif (!instances) {\n\t\t\tinstances = new Map();\n\t\t\tchannels.set(this.channel, instances);\n\t\t}\n\t\tinstances.set(instance, receive);\n\t\tthis.subscribed.add(instance);\n\t}\n\n\tasync close(): Promise<void> {\n\t\tconst instances = channels.get(this.channel);\n\t\tfor (const instance of this.subscribed) instances?.delete(instance);\n\t\tthis.subscribed.clear();\n\t\t// The last process on the channel is gone: what it counted goes too.\n\t\tif (!instances?.size) limitStores.delete(this.channel);\n\t}\n\n\tlimits(): WebSocketLimitStore {\n\t\tlet store = limitStores.get(this.channel);\n\t\tif (!store) {\n\t\t\tstore = new MemoryLimitStore();\n\t\t\tlimitStores.set(this.channel, store);\n\t\t}\n\t\treturn store;\n\t}\n}\n\n/** The subset of an ioredis client the transport uses. */\ninterface RedisClient {\n\tpublish(channel: string, message: string): Promise<number>;\n\tsubscribe(...channels: string[]): Promise<unknown>;\n\ton(\n\t\tevent: 'message',\n\t\tlistener: (channel: string, message: string) => void,\n\t): unknown;\n\tduplicate(): RedisClient;\n\tquit(): Promise<unknown>;\n\teval(\n\t\tscript: string,\n\t\tnumKeys: number,\n\t\t...args: (string | number)[]\n\t): Promise<unknown>;\n}\n\n/**\n * Over Redis pub/sub: one channel per instance and one for broadcasts, under\n * a prefix that keeps two surfaces — or two projects on one Redis — apart.\n * Channels are not scoped by database index, so the prefix is what does it.\n *\n * Publishing and subscribing take separate connections, because a connection\n * that has subscribed can do nothing else.\n */\nexport class RedisTransport implements WebSocketTransport {\n\tprivate subscriber?: RedisClient;\n\tprivate closed?: Promise<void>;\n\n\tconstructor(\n\t\tprivate readonly client: RedisClient,\n\t\tprivate readonly prefix: string,\n\t) {}\n\n\tprivate channel(instance: string): string {\n\t\treturn `${this.prefix}:${instance}`;\n\t}\n\n\tasync publish(instance: string, delivery: Delivery): Promise<void> {\n\t\tawait this.client.publish(this.channel(instance), JSON.stringify(delivery));\n\t}\n\n\tasync subscribe(\n\t\tinstance: string,\n\t\treceive: (delivery: Delivery) => void,\n\t): Promise<void> {\n\t\tconst subscriber = this.client.duplicate();\n\t\tthis.subscriber = subscriber;\n\t\tconst own = this.channel(instance);\n\t\tconst every = this.channel(EVERY_INSTANCE);\n\t\tsubscriber.on('message', (channel, message) => {\n\t\t\tif (channel !== own && channel !== every) return;\n\t\t\treceive(JSON.parse(message) as Delivery);\n\t\t});\n\t\tawait subscriber.subscribe(own, every);\n\t}\n\n\t/** Counted in this Redis, under the transport's prefix. */\n\tlimits(): WebSocketLimitStore {\n\t\treturn new RedisLimitStore(this.client, this.prefix);\n\t}\n\n\t/** Idempotent: the server and a shutdown hook may both close it. */\n\tclose(): Promise<void> {\n\t\tthis.closed ??= Promise.all([\n\t\t\tthis.subscriber?.quit(),\n\t\t\tthis.client.quit(),\n\t\t]).then(() => undefined);\n\t\treturn this.closed;\n\t}\n}\n\n/**\n * The transport a connection string names.\n *\n * `redis://` and `rediss://` take an optional `channel` query parameter, the\n * prefix every channel is named under; `memory://<channel>` is in-process.\n * Absent, the channel is `fallback` — the surface's own.\n */\nexport async function transportFromConnectionString(\n\tconnectionString: string,\n\tfallback: string,\n): Promise<WebSocketTransport> {\n\t// Not parsed as a URL: a channel is `gkm:ws:<id>`, colons and all.\n\tif (connectionString.startsWith('memory://')) {\n\t\treturn new MemoryTransport(\n\t\t\tconnectionString.slice('memory://'.length) || fallback,\n\t\t);\n\t}\n\n\tconst url = URL.canParse(connectionString)\n\t\t? new URL(connectionString)\n\t\t: undefined;\n\tif (!url) throw new UnsupportedWebSocketTransport(connectionString);\n\n\tif (url.protocol === 'redis:' || url.protocol === 'rediss:') {\n\t\tconst channel = url.searchParams.get('channel') || fallback;\n\t\turl.searchParams.delete('channel');\n\t\tconst { Redis } = await loadIoredis();\n\t\tconst client = new Redis(url.toString(), {\n\t\t\t// A publish while Redis restarts waits for it rather than failing the\n\t\t\t// request that sent it.\n\t\t\tmaxRetriesPerRequest: null,\n\t\t\tlazyConnect: false,\n\t\t});\n\t\treturn new RedisTransport(client as unknown as RedisClient, channel);\n\t}\n\n\tthrow new UnsupportedWebSocketTransport(connectionString);\n}\n","/**\n * The Node adaptor: the process that holds a WebSocket surface's sockets.\n *\n * Node's own `http` server and `ws`, nothing between them. This owns what\n * only a real socket has — the upgrade, the Origin check, connection ids,\n * the heartbeat, backpressure, and the limits on what one client may ask of\n * it (`limits.ts`) — and hands the rest to the surface's `WebSocketCore`: a\n * handshake to `connect()`, each frame to `message()`, a close to\n * `disconnect()`. The HTTP server is whatever the entry started — the\n * generated one serves `/health` on the same port — and this attaches to its\n * `upgrade` event.\n */\n\nimport { randomBytes } from 'node:crypto';\nimport type { IncomingMessage, Server } from 'node:http';\nimport type { Duplex } from 'node:stream';\nimport type { Logger } from '@geekmidas/logger';\nimport { trustsOrigin } from '@geekmidas/manifest';\nimport type { RawData, WebSocket, WebSocketServer } from 'ws';\nimport { loadWs } from '../optionalPeers';\nimport type { WebSocketCore } from './core';\nimport {\n\tclientAddress,\n\tLIMIT_CLOSE,\n\tMemoryLimitStore,\n\ttype ResolvedWebSocketLimits,\n\tresolveLimits,\n\tTokenBucket,\n\ttype WebSocketLimitStore,\n} from './limits';\nimport { ownOrigins } from './origins';\nimport type {\n\tNoMessages,\n\tWebSocketMessages,\n\tWebSocketPublisher,\n\tWebSocketSink,\n} from './publisher';\nimport type { Connection } from './route';\nimport {\n\ttype Delivery,\n\tTransportSink,\n\ttype WebSocketTransport,\n} from './transport';\n\n/** Close codes a client sees. */\nexport const CLOSE = {\n\tnormal: 1000,\n\t/**\n\t * It kept sending past its message rate, or its identity opened more\n\t * sockets than `limits.maxConnections` and this was the oldest.\n\t */\n\tpolicy: LIMIT_CLOSE.policy,\n\t/** The process is stopping; reconnect and land on another. */\n\tserviceRestart: 1012,\n\t/** It stopped reading, and what was queued for it passed the limit. */\n\ttooSlow: 1013,\n} as const;\n\nexport interface WebSocketServerOptions<\n\tTMessages extends WebSocketMessages = NoMessages,\n> {\n\t/**\n\t * The surface's core, over the sink this process sends through — its own\n\t * sockets directly, every other process's over `transport`.\n\t */\n\tcore(sink: WebSocketSink): WebSocketCore<TMessages>;\n\ttransport: WebSocketTransport;\n\t/**\n\t * Origins a browser may open a socket from. A request with an `Origin`\n\t * not in the list is refused with 403; one with none — a server, a load\n\t * generator — is not a browser, and is let through unless\n\t * `requireOrigin` is set.\n\t */\n\ttrustedOrigins: readonly string[];\n\t/**\n\t * Refuse, with 403, an upgrade that sends no `Origin`. Every browser\n\t * sends one and a native client sends the socket's own; a server or a\n\t * script sends none. Off by default: the limits hold either way.\n\t */\n\trequireOrigin?: boolean;\n\t/**\n\t * The surface's own public address, `<ID>_URL`. Its origin is always\n\t * trusted: a native client (React Native's `WebSocket`) sends the socket's\n\t * own origin as its `Origin`.\n\t */\n\turl?: string;\n\t/** How often each socket is pinged; one that missed the last is dropped. */\n\theartbeatMs?: number;\n\t/** The largest frame accepted, in bytes. */\n\tmaxPayload?: number;\n\t/** Queued bytes a socket may hold before it is closed as too slow. */\n\tmaxBufferedBytes?: number;\n\t/**\n\t * What one client may ask of it — `resolveLimits(id, config.limits)`.\n\t * Absent, the defaults.\n\t */\n\tlimits?: ResolvedWebSocketLimits;\n\t/** Where a limit store that cannot be reached is reported. */\n\tlogger?: Logger;\n}\n\n/** A place in a limit's count, given back when it is done with. */\ninterface Lease {\n\tkey: string;\n\tmember: string;\n}\n\ninterface Held {\n\tsocket: WebSocket;\n\tconnection: Connection;\n\talive: boolean;\n\t/** Its places in the client address's and the identity's counts. */\n\tleases: Lease[];\n\t/** Its inbound budget, where there is a message rate. */\n\tbucket?: TokenBucket;\n\t/** It has been sent the `$error` for running its budget dry. */\n\twarned: boolean;\n}\n\n/** A handshake is counted as in flight for at most this long. */\nconst IN_FLIGHT_TTL_MS = 30_000;\n\nexport class WebSocketSurfaceServer<\n\tTMessages extends WebSocketMessages = NoMessages,\n> {\n\t/** This process, as connection ids name it. */\n\treadonly instance = randomBytes(6).toString('hex');\n\t/** Where each handshake, frame and close is handed. */\n\treadonly core: WebSocketCore<TMessages>;\n\n\tprivate readonly held = new Map<string, Held>();\n\tprivate readonly heartbeat: NodeJS.Timeout;\n\tprivate readonly heartbeatMs: number;\n\tprivate readonly trusted: readonly string[];\n\tprivate readonly sink: TransportSink;\n\tprivate readonly limits: ResolvedWebSocketLimits;\n\tprivate readonly store: WebSocketLimitStore;\n\tprivate next = 0;\n\tprivate closing = false;\n\n\tprivate constructor(\n\t\tprivate readonly wss: WebSocketServer,\n\t\tprivate readonly options: WebSocketServerOptions<TMessages>,\n\t) {\n\t\t// Local sends skip the transport.\n\t\tthis.sink = new TransportSink(options.transport, {\n\t\t\tinstance: this.instance,\n\t\t\tdeliver: (delivery) => this.deliver(delivery),\n\t\t});\n\t\tthis.core = options.core(this.sink);\n\t\tthis.trusted = [...options.trustedOrigins, ...ownOrigins(options.url)];\n\t\tthis.limits = options.limits ?? resolveLimits(this.core.surface);\n\t\t// Where every process on the transport counts, so a limit holds\n\t\t// across replicas.\n\t\tthis.store = options.transport.limits?.() ?? new MemoryLimitStore();\n\n\t\tthis.heartbeatMs = options.heartbeatMs ?? 30_000;\n\t\tthis.heartbeat = setInterval(() => this.beat(), this.heartbeatMs);\n\t\tthis.heartbeat.unref();\n\t}\n\n\tstatic async start<TMessages extends WebSocketMessages = NoMessages>(\n\t\toptions: WebSocketServerOptions<TMessages>,\n\t): Promise<WebSocketSurfaceServer<TMessages>> {\n\t\tconst { WebSocketServer } = await loadWs();\n\t\tconst wss = new WebSocketServer({\n\t\t\tnoServer: true,\n\t\t\tmaxPayload: options.maxPayload ?? 1024 * 1024,\n\t\t\t// Compression costs a zlib context per socket — tens of KB each,\n\t\t\t// the largest share of a connection's memory — for frames that are\n\t\t\t// mostly small JSON.\n\t\t\tperMessageDeflate: false,\n\t\t\tclientTracking: false,\n\t\t});\n\t\tconst server = new WebSocketSurfaceServer<TMessages>(wss, options);\n\t\tawait options.transport.subscribe(server.instance, (delivery) =>\n\t\t\tserver.deliver(delivery),\n\t\t);\n\t\treturn server;\n\t}\n\n\t/** `sockets` in a route: local sends skip the transport. */\n\tget publisher(): WebSocketPublisher<TMessages> {\n\t\treturn this.core.sockets;\n\t}\n\n\t/** How many sockets this process holds. */\n\tget size(): number {\n\t\treturn this.held.size;\n\t}\n\n\t/** Take over `server`'s upgrades. */\n\tattach(server: Server): void {\n\t\tserver.on('upgrade', (request, socket, head) => {\n\t\t\tvoid this.upgrade(request, socket, head);\n\t\t});\n\t}\n\n\t/**\n\t * Upgrade one request, or refuse it with a status line. The cheap checks\n\t * come first — the Origin, the client's handshake rate, its handshakes in\n\t * flight and its open sockets — so a flood is refused before the connect\n\t * handler, and the session lookup it makes, runs.\n\t */\n\tasync upgrade(\n\t\trequest: IncomingMessage,\n\t\tsocket: Duplex,\n\t\thead: Buffer,\n\t): Promise<void> {\n\t\tif (this.closing) return refuse(socket, 503, 'Service Unavailable');\n\n\t\tconst origin = request.headers.origin;\n\t\tif (\n\t\t\torigin ? !trustsOrigin(origin, this.trusted) : this.options.requireOrigin\n\t\t) {\n\t\t\treturn refuse(socket, 403, 'Forbidden');\n\t\t}\n\n\t\tconst { limits } = this;\n\t\tconst client = clientAddress(request);\n\t\tconst connectionId = `${this.instance}.${(this.next++).toString(36)}`;\n\n\t\tif (limits.handshakesPerMinute) {\n\t\t\tconst window = await this.guard(() =>\n\t\t\t\tthis.store.hit(`handshakes:${client}`, 60_000),\n\t\t\t);\n\t\t\tif (window && window.count > limits.handshakesPerMinute) {\n\t\t\t\treturn tooMany(socket, window.resetMs);\n\t\t\t}\n\t\t}\n\n\t\t// Counted until the connect handler has answered.\n\t\tconst inFlight: Lease = {\n\t\t\tkey: `in-flight:${client}`,\n\t\t\tmember: connectionId,\n\t\t};\n\t\tif (\n\t\t\tlimits.inFlightHandshakes &&\n\t\t\t!(await this.claim(inFlight, limits.inFlightHandshakes, IN_FLIGHT_TTL_MS))\n\t\t) {\n\t\t\treturn tooMany(socket);\n\t\t}\n\n\t\tconst leases: Lease[] = [];\n\t\tconst releaseAll = () => {\n\t\t\tfor (const lease of leases.splice(0)) this.release(lease);\n\t\t};\n\t\ttry {\n\t\t\tif (limits.connectionsPerIp) {\n\t\t\t\tconst lease = { key: `ip:${client}`, member: connectionId };\n\t\t\t\tif (!(await this.claim(lease, limits.connectionsPerIp))) {\n\t\t\t\t\treturn tooMany(socket);\n\t\t\t\t}\n\t\t\t\tleases.push(lease);\n\t\t\t}\n\n\t\t\tconst outcome = await this.core.connect({\n\t\t\t\tconnectionId,\n\t\t\t\theaders: headersOf(request),\n\t\t\t\tquery: new URL(request.url ?? '/', 'http://localhost').searchParams,\n\t\t\t});\n\t\t\tif (!outcome.accepted) {\n\t\t\t\treleaseAll();\n\t\t\t\treturn refuse(socket, outcome.status, outcome.statusText);\n\t\t\t}\n\n\t\t\tconst identity = limits.maxConnectionsPer?.(outcome.connection.data);\n\t\t\tif (identity !== undefined) {\n\t\t\t\tconst lease = { key: `identity:${identity}`, member: connectionId };\n\t\t\t\tleases.push(lease);\n\t\t\t\tconst held = await this.guard(() =>\n\t\t\t\t\tthis.store.hold(lease.key, lease.member, this.connectionTtl),\n\t\t\t\t);\n\t\t\t\tif (held && held.length > limits.maxConnections) {\n\t\t\t\t\tif (limits.overflow === 'refuse') {\n\t\t\t\t\t\treleaseAll();\n\t\t\t\t\t\treturn tooMany(socket);\n\t\t\t\t\t}\n\t\t\t\t\t// Its oldest sockets make room, on whichever process holds them.\n\t\t\t\t\tconst oldest = held\n\t\t\t\t\t\t.filter((id) => id !== connectionId)\n\t\t\t\t\t\t.slice(0, held.length - limits.maxConnections);\n\t\t\t\t\tfor (const id of oldest) {\n\t\t\t\t\t\tthis.release({ key: lease.key, member: id });\n\t\t\t\t\t}\n\t\t\t\t\tawait this.guard(() =>\n\t\t\t\t\t\tthis.sink.close(oldest, CLOSE.policy, 'Too many connections'),\n\t\t\t\t\t);\n\t\t\t\t}\n\t\t\t}\n\n\t\t\t// The client may have gone while the connect handler ran.\n\t\t\tif (socket.destroyed) return releaseAll();\n\n\t\t\tconst opened = leases.splice(0);\n\t\t\tthis.wss.handleUpgrade(request, socket, head, (ws) =>\n\t\t\t\tthis.open(ws, outcome.connection, opened),\n\t\t\t);\n\t\t} finally {\n\t\t\tif (limits.inFlightHandshakes) this.release(inFlight);\n\t\t}\n\t}\n\n\tprivate open(\n\t\tsocket: WebSocket,\n\t\tconnection: Connection,\n\t\tleases: Lease[],\n\t): void {\n\t\tconst { messagesPerSecond, burst } = this.limits;\n\t\tconst held: Held = {\n\t\t\tsocket,\n\t\t\tconnection,\n\t\t\talive: true,\n\t\t\tleases,\n\t\t\twarned: false,\n\t\t\t...(messagesPerSecond\n\t\t\t\t? { bucket: new TokenBucket(messagesPerSecond, burst) }\n\t\t\t\t: {}),\n\t\t};\n\t\tthis.held.set(connection.id, held);\n\t\tconst write = (payload: string) => this.write(held, payload);\n\n\t\tsocket.on('pong', () => {\n\t\t\theld.alive = true;\n\t\t});\n\t\tsocket.on('message', (raw, isBinary) => {\n\t\t\theld.alive = true;\n\t\t\tif (!this.admit(held)) return;\n\t\t\tvoid this.core.message(\n\t\t\t\tconnection,\n\t\t\t\tisBinary ? bytesOf(raw) : raw.toString(),\n\t\t\t\twrite,\n\t\t\t);\n\t\t});\n\t\tsocket.on('error', () => socket.terminate());\n\t\tsocket.on('close', (code, reason) => {\n\t\t\tthis.held.delete(connection.id);\n\t\t\tfor (const lease of held.leases.splice(0)) this.release(lease);\n\t\t\tvoid this.core.disconnect(connection, {\n\t\t\t\tcode,\n\t\t\t\treason: reason.toString(),\n\t\t\t});\n\t\t});\n\t}\n\n\t/**\n\t * Whether a frame is within its socket's budget. The first past it is\n\t * answered with one `$error`; another before the budget has refilled\n\t * closes the socket with 1008.\n\t */\n\tprivate admit(held: Held): boolean {\n\t\tconst { bucket } = held;\n\t\tif (!bucket) return true;\n\t\tif (bucket.take()) {\n\t\t\tif (held.warned && bucket.full) held.warned = false;\n\t\t\treturn true;\n\t\t}\n\t\tif (held.socket.readyState !== held.socket.OPEN) return false;\n\t\tif (held.warned) {\n\t\t\theld.socket.close(CLOSE.policy, 'Too many messages');\n\t\t\treturn false;\n\t\t}\n\t\theld.warned = true;\n\t\tthis.write(\n\t\t\theld,\n\t\t\tthis.core.frame.encode('$error', {\n\t\t\t\tmessage:\n\t\t\t\t\t`Too many messages: at most ${this.limits.messagesPerSecond} a ` +\n\t\t\t\t\t`second, ${this.limits.burst} at once. Frames are dropped until ` +\n\t\t\t\t\t'the socket slows down, and it is closed if it keeps sending.',\n\t\t\t}),\n\t\t);\n\t\treturn false;\n\t}\n\n\t/**\n\t * Take a place in `lease`'s count — or none, when that would put it past\n\t * `max`. A store that cannot be reached lets the handshake through.\n\t */\n\tprivate async claim(\n\t\tlease: Lease,\n\t\tmax: number,\n\t\tttlMs = this.connectionTtl,\n\t): Promise<boolean> {\n\t\tconst held = await this.guard(() =>\n\t\t\tthis.store.hold(lease.key, lease.member, ttlMs),\n\t\t);\n\t\tif (!held || held.length <= max) return true;\n\t\tthis.release(lease);\n\t\treturn false;\n\t}\n\n\tprivate release(lease: Lease): void {\n\t\tvoid this.guard(() => this.store.release(lease.key, lease.member));\n\t}\n\n\t/**\n\t * How long a socket's place in a count outlives its process, should it\n\t * die without giving it back: three heartbeats, each of which renews it.\n\t */\n\tprivate get connectionTtl(): number {\n\t\treturn this.heartbeatMs * 3;\n\t}\n\n\t/** The store's answer — or nothing, logged, when it fails. */\n\tprivate async guard<T>(call: () => Promise<T>): Promise<T | undefined> {\n\t\ttry {\n\t\t\treturn await call();\n\t\t} catch (err) {\n\t\t\tthis.options.logger?.warn(\n\t\t\t\t{ err },\n\t\t\t\t'WebSocket limit store failed; the limit was not applied',\n\t\t\t);\n\t\t\treturn undefined;\n\t\t}\n\t}\n\n\t/** Write, unless the socket has stopped reading and its queue is full. */\n\tprivate write(held: Held, payload: string): void {\n\t\tconst { socket } = held;\n\t\tif (socket.readyState !== socket.OPEN) return;\n\t\tif (\n\t\t\tsocket.bufferedAmount > (this.options.maxBufferedBytes ?? 4 * 1024 * 1024)\n\t\t) {\n\t\t\tsocket.close(CLOSE.tooSlow, 'Too slow');\n\t\t\treturn;\n\t\t}\n\t\tsocket.send(payload);\n\t}\n\n\t/** What the transport, or a local publisher, asked of this process. */\n\tprivate deliver(delivery: Delivery): void {\n\t\tswitch (delivery.kind) {\n\t\t\tcase 'send':\n\t\t\t\tfor (const id of delivery.ids) {\n\t\t\t\t\tconst held = this.held.get(id);\n\t\t\t\t\tif (held) this.write(held, delivery.payload);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\tcase 'broadcast': {\n\t\t\t\tconst except = delivery.except ? new Set(delivery.except) : undefined;\n\t\t\t\tfor (const [id, held] of this.held) {\n\t\t\t\t\tif (!except?.has(id)) this.write(held, delivery.payload);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t\t}\n\t\t\tcase 'close':\n\t\t\t\tfor (const id of delivery.ids) {\n\t\t\t\t\tthis.held.get(id)?.socket.close(delivery.code, delivery.reason);\n\t\t\t\t}\n\t\t\t\treturn;\n\t\t}\n\t}\n\n\t/**\n\t * Drop every socket that missed the last ping, and ping the rest — whose\n\t * places in the limits' counts are renewed.\n\t */\n\tprivate beat(): void {\n\t\tconst renewed: Lease[] = [];\n\t\tfor (const [id, held] of this.held) {\n\t\t\tif (!held.alive) {\n\t\t\t\theld.socket.terminate();\n\t\t\t\tthis.held.delete(id);\n\t\t\t\tcontinue;\n\t\t\t}\n\t\t\theld.alive = false;\n\t\t\theld.socket.ping();\n\t\t\trenewed.push(...held.leases);\n\t\t}\n\t\tif (renewed.length > 0) {\n\t\t\tvoid this.guard(() => this.store.renew(renewed, this.connectionTtl));\n\t\t}\n\t}\n\n\t/**\n\t * Stop: refuse new upgrades, close every socket with `code` — 1012 tells\n\t * a client to reconnect, and it lands on a process that is still up — and\n\t * leave the transport.\n\t */\n\tasync close(\n\t\tcode: number = CLOSE.serviceRestart,\n\t\treason = 'Restarting',\n\t): Promise<void> {\n\t\tif (this.closing) return;\n\t\tthis.closing = true;\n\t\tclearInterval(this.heartbeat);\n\n\t\tconst closed = [...this.held.values()].map(\n\t\t\t({ socket }) =>\n\t\t\t\tnew Promise<void>((resolve) => {\n\t\t\t\t\tif (socket.readyState === socket.CLOSED) return resolve();\n\t\t\t\t\tsocket.once('close', () => resolve());\n\t\t\t\t\tsocket.close(code, reason);\n\t\t\t\t\t// A client that never answers the close is cut off.\n\t\t\t\t\tsetTimeout(() => {\n\t\t\t\t\t\tsocket.terminate();\n\t\t\t\t\t\tresolve();\n\t\t\t\t\t}, 2_000).unref();\n\t\t\t\t}),\n\t\t);\n\t\tawait Promise.all(closed);\n\t\tawait this.options.transport.close();\n\t\tthis.wss.close();\n\t}\n}\n\n/** A binary frame's bytes, however `ws` delivered them. */\nfunction bytesOf(raw: RawData): Uint8Array {\n\tif (Array.isArray(raw)) return Buffer.concat(raw);\n\treturn raw instanceof ArrayBuffer ? new Uint8Array(raw) : raw;\n}\n\nfunction headersOf(request: IncomingMessage): Headers {\n\tconst headers = new Headers();\n\tfor (const [name, value] of Object.entries(request.headers)) {\n\t\tif (value === undefined) continue;\n\t\tfor (const one of Array.isArray(value) ? value : [value]) {\n\t\t\theaders.append(name, one);\n\t\t}\n\t}\n\treturn headers;\n}\n\nfunction refuse(\n\tsocket: Duplex,\n\tstatus: number,\n\tmessage: string,\n\theaders: Record<string, string> = {},\n): void {\n\tif (!socket.destroyed) {\n\t\tconst extra = Object.entries(headers)\n\t\t\t.map(([name, value]) => `${name}: ${value}\\r\\n`)\n\t\t\t.join('');\n\t\tsocket.end(\n\t\t\t`HTTP/1.1 ${status} ${message}\\r\\n${extra}Connection: close\\r\\nContent-Length: 0\\r\\n\\r\\n`,\n\t\t);\n\t}\n}\n\n/** 429 — with when to come back, where a window says. */\nfunction tooMany(socket: Duplex, retryAfterMs?: number): void {\n\trefuse(\n\t\tsocket,\n\t\t429,\n\t\t'Too Many Requests',\n\t\tretryAfterMs === undefined\n\t\t\t? {}\n\t\t\t: { 'Retry-After': String(Math.max(1, Math.ceil(retryAfterMs / 1000))) },\n\t);\n}\n","/**\n * `WebSocketApi` — a surface that holds long-lived connections.\n *\n * A process of its own, like a `RestApi`: it owns an address, its routes are\n * built from it, and they run in its container and nowhere else. A frame is\n * routed on its `action` — `{ \"action\": \"chat.send\", \"data\": … }`, API\n * Gateway's shape — and the connection's lifecycle on `$connect` and\n * `$disconnect`. A surface whose clients already parse flat frames names the\n * key the action lives in instead — `frame: { discriminator: 'type' }` reads\n * and writes `{ \"type\": \"chat.send\", …data }`.\n *\n * Anything else reaches a socket through the surface's publisher:\n * `.dependsOn([realtime])` puts `services.realtime` in an endpoint, a cron or\n * a subscriber, and whichever replica holds the socket delivers. What it\n * sends is declared in `messages`, which the publisher is typed by.\n *\n * ```ts\n * export const realtime = new WebSocketApi('Realtime', {\n * path: 'apps/realtime',\n * messages: { 'chat.sent': z.object({ text: z.string() }) },\n * logger,\n * });\n *\n * export const send = realtime\n * .route('chat.send')\n * .body(z.object({ text: z.string() }))\n * .handle(async ({ body, sockets }) => sockets.broadcast('chat.sent', body));\n * ```\n */\n\nimport type { Server } from 'node:http';\nimport type { EnvironmentParser } from '@geekmidas/envkit';\nimport type { Logger } from '@geekmidas/logger';\nimport { DEFAULT_LOGGER } from '@geekmidas/logger/console';\nimport {\n\tAPI_GATEWAY_WEBSOCKET_SCHEME,\n\tassertHostLabels,\n\ttype ConstructName,\n\tcanonicalId,\n\ttype Declaration,\n\tprovidedKeyFor,\n\tserviceKey,\n\ttype WebSocketEdgeLimits,\n} from '@geekmidas/manifest';\n\n/** Thrown at construction for an alias or redirect that cannot be a host label. */\nexport { InvalidHostLabel } from '@geekmidas/manifest';\n\nimport type { Service, ServiceRegisterOptions } from '@geekmidas/services';\nimport type { Hono } from 'hono';\nimport {\n\ttype Authenticator,\n\ttype Declarable,\n\tedgeTo,\n} from './construct-interface';\nimport { envParserFor } from './endpoints/surfaceEnv';\nimport { loadHono } from './optionalPeers';\nimport { onShutdown } from './shutdown';\nimport type { Telemetry } from './telemetry';\nimport { WebSocketCore } from './websocket/core';\nimport {\n\tUnregisteredWebSocketScheme,\n\twebSocketSinkDriverFor,\n} from './websocket/drivers';\nimport { FrameShape, type WebSocketFrame } from './websocket/frame';\nimport {\n\ttype ResolvedWebSocketLimits,\n\tresolveLimits,\n\ttype WebSocketLimits,\n} from './websocket/limits';\nimport {\n\ttype NoMessages,\n\ttype WebSocketMessages,\n\tWebSocketPublisher,\n\ttype WebSocketSink,\n} from './websocket/publisher';\nimport { WebSocketRoute, WebSocketRouteBuilder } from './websocket/route';\nimport { WebSocketSurfaceServer } from './websocket/server';\nimport { TestWebSocketPublisher } from './websocket/testing';\nimport {\n\tTransportSink,\n\ttransportFromConnectionString,\n} from './websocket/transport';\n\nexport {\n\ttype ConnectOutcome,\n\ttype ConnectRequest,\n\ttype DisconnectOutcome,\n\tDuplicateWebSocketRoute,\n\ttype MessageOutcome,\n\ttype WebSocketCallOptions,\n\tWebSocketCore,\n\ttype WebSocketCoreOptions,\n\ttype WriteFrame,\n} from './websocket/core';\nexport {\n\tregisterWebSocketSinkDriver,\n\tUnregisteredWebSocketScheme,\n\ttype WebSocketSinkDriver,\n} from './websocket/drivers';\nexport {\n\tWebSocketDataHasDiscriminator,\n\tWebSocketDataNotAnObject,\n\ttype WebSocketFrame,\n\tWebSocketMessageDeclaresDiscriminator,\n\tWebSocketMessageNotAnObject,\n} from './websocket/frame';\nexport {\n\tDEFAULT_WEBSOCKET_LIMITS,\n\tInvalidWebSocketLimit,\n\tLIMIT_CLOSE,\n\tMemoryLimitStore,\n\tRedisLimitStore,\n\ttype ResolvedWebSocketLimits,\n\tresolveLimits,\n\tTokenBucket,\n\ttype WebSocketLimitStore,\n\ttype WebSocketLimits,\n} from './websocket/limits';\nexport {\n\tInvalidWebSocketMessage,\n\ttype MessageAction,\n\ttype MessageData,\n\ttype NoMessages,\n\tUnknownWebSocketMessage,\n\ttype WebSocketMessages,\n\tWebSocketPublisher,\n\ttype WebSocketSink,\n} from './websocket/publisher';\nexport type {\n\tConnectContext,\n\tConnection,\n\tDisconnectContext,\n\tMessageContext,\n\tRouteKind,\n\tTestCallOverrides,\n\tWebSocketRouteRequest,\n\tWebSocketRouteResult,\n} from './websocket/route';\nexport { WebSocketRoute, WebSocketRouteBuilder } from './websocket/route';\nexport {\n\tCLOSE,\n\ttype WebSocketServerOptions,\n\tWebSocketSurfaceServer,\n} from './websocket/server';\nexport {\n\tInvalidWebSocketRequest,\n\ttype RecordedBroadcast,\n\ttype RecordedClose,\n\ttype RecordedMessage,\n\ttype RecordedSend,\n\tRecordingSink,\n\ttype TestConnection,\n\ttype TestConnectRequest,\n\ttype TestDisconnectRequest,\n\ttype TestMessageRequest,\n\ttype TestMessageResponse,\n\tTestWebSocketPublisher,\n\ttype WebSocketTestSurface,\n} from './websocket/testing';\nexport {\n\ttype Delivery,\n\tMemoryTransport,\n\tRedisTransport,\n\tTransportSink,\n\ttransportFromConnectionString,\n\tUnsupportedWebSocketTransport,\n\ttype WebSocketTransport,\n} from './websocket/transport';\n\nexport interface WebSocketApiConfig<\n\tTMessages extends WebSocketMessages = NoMessages,\n> {\n\t/** The app that serves it, relative to the workspace root. */\n\tpath: string;\n\t/**\n\t * What it sends its sockets, by action — each with the schema its `data`\n\t * is checked by before it is sent.\n\t *\n\t * ```ts\n\t * messages: {\n\t * announcement: z.object({ text: z.string() }),\n\t * 'chat.said': z.object({ from: z.string(), text: z.string() }),\n\t * }\n\t * ```\n\t *\n\t * The publisher is typed by it — `services.realtime.broadcast(\n\t * 'announcement', { text })` — in an endpoint and in a route's `sockets`\n\t * alike. Absent, any action and any data go, unchecked.\n\t */\n\tmessages?: TMessages;\n\t/**\n\t * The shape its frames take. Absent, `{ \"action\": …, \"id\"?: …, \"data\": … }`.\n\t *\n\t * With a `discriminator`, frames are flat — the action under that key and\n\t * the data's fields beside it, both ways, `$error` replies included:\n\t *\n\t * ```ts\n\t * frame: { discriminator: 'type' },\n\t * // realtime.send(ids, 'chat.message.created', { chatId, message })\n\t * // wire: {\"type\":\"chat.message.created\",\"chatId\":\"…\",\"message\":{…}}\n\t * ```\n\t *\n\t * Every message must then be an object schema that has no field of that\n\t * name; one that is not is refused when the surface is built. A flat frame\n\t * carries no `id`: every other field is the data.\n\t */\n\tframe?: WebSocketFrame;\n\t/** The label it answers on. Absent, its id kebab-cased. */\n\tsubdomain?: string;\n\t/**\n\t * More labels it answers on under the stage's domain, exactly as on its\n\t * own — `['rest']` serves `rest.myapp.com` beside `api.myapp.com`. Its own\n\t * label stays canonical: `<ID>_URL`, clients and OpenAPI are built on it.\n\t */\n\taliases?: readonly string[];\n\t/** How many processes serve it on one machine. Default 1. */\n\treplicas?: number;\n\tlogger?: Logger;\n\tenvParser?: EnvironmentParser<{}>;\n\ttelemetry?: Telemetry;\n\t/** Seconds between pings; a socket that misses one is dropped. Default 30. */\n\theartbeat?: number;\n\t/**\n\t * The largest frame accepted, in bytes. Default 1 MiB. A surface that\n\t * only pushes — its clients write over HTTP — declares no routes and\n\t * sets this small.\n\t */\n\tmaxPayload?: number;\n\t/**\n\t * What one client may ask of it: handshakes a minute, handshakes in\n\t * flight and open sockets per client address, frames a second per\n\t * socket, and — with `maxConnectionsPer` — sockets per identity. All but\n\t * the last are on by default; on the Redis transport they hold across\n\t * every replica. See `WebSocketLimits`.\n\t *\n\t * ```ts\n\t * limits: {\n\t * messagesPerSecond: 20,\n\t * maxConnectionsPer: (data) => data.userId as string,\n\t * maxConnections: 5,\n\t * overflow: 'closeOldest',\n\t * }\n\t * ```\n\t */\n\tlimits?: WebSocketLimits;\n\t/**\n\t * Refuse, with 403, an upgrade that sends no `Origin` — which no browser\n\t * and no native client omits, but a script does. Default false: a server\n\t * may hold a socket too, and the limits apply to it either way.\n\t */\n\trequireOrigin?: boolean;\n}\n\n/** A replica count that is not a whole number of at least one. */\nexport class InvalidReplicaCount extends Error {\n\tconstructor(\n\t\treadonly id: string,\n\t\treadonly replicas: number,\n\t) {\n\t\tsuper(\n\t\t\t`${id} asks for ${replicas} replicas. A surface runs on at least one process — give a whole number of 1 or more.`,\n\t\t);\n\t\tthis.name = 'InvalidReplicaCount';\n\t}\n}\n\nexport class WebSocketApi<\n\tTName extends string = string,\n\tTMessages extends WebSocketMessages = NoMessages,\n> implements Declarable<TName>\n{\n\treadonly id: TName;\n\n\treadonly keys: {\n\t\turl: string;\n\t\ttrustedOrigins: string;\n\t\tpublisherConnectionString: string;\n\t};\n\n\treadonly logger: Logger;\n\treadonly envParser: EnvironmentParser<{}>;\n\treadonly telemetry?: Telemetry;\n\t/**\n\t * The shape its frames take — `{ action, data }`, or flat under\n\t * `discriminator`. What a client of the surface decodes by.\n\t */\n\treadonly frame: { readonly discriminator?: string };\n\t/** What one client may ask of it, defaults filled in. */\n\treadonly limits: ResolvedWebSocketLimits;\n\n\t/**\n\t * The surface as a dependency: `services.<id>` is its publisher, so an\n\t * endpoint sends to a socket the way a route beside it does.\n\t */\n\treadonly service: Service<Uncapitalize<TName>, WebSocketPublisher<TMessages>>;\n\n\tconstructor(\n\t\tid: ConstructName<TName>,\n\t\tprivate readonly config: WebSocketApiConfig<TMessages>,\n\t\t/** Internal: how `.auth()` carries the authenticator into its copy. */\n\t\treadonly authenticator?: Authenticator,\n\t) {\n\t\tconst canonical = canonicalId(id as string);\n\t\tthis.id = canonical as TName;\n\t\tassertHostLabels({\n\t\t\tid: canonical,\n\t\t\t...(config.subdomain ? { subdomain: config.subdomain } : {}),\n\t\t\t...(config.aliases ? { aliases: config.aliases } : {}),\n\t\t});\n\n\t\tconst replicas = config.replicas ?? 1;\n\t\tif (!Number.isInteger(replicas) || replicas < 1) {\n\t\t\tthrow new InvalidReplicaCount(canonical, replicas);\n\t\t}\n\n\t\tconst frame = new FrameShape(canonical, config.frame?.discriminator);\n\t\tif (config.messages) frame.check(config.messages);\n\t\tthis.frame = config.frame\n\t\t\t? { discriminator: config.frame.discriminator }\n\t\t\t: {};\n\t\tthis.limits = resolveLimits(canonical, config.limits);\n\n\t\tthis.keys = {\n\t\t\turl: providedKeyFor(canonical, 'websocket-api', 'url'),\n\t\t\ttrustedOrigins: providedKeyFor(\n\t\t\t\tcanonical,\n\t\t\t\t'websocket-api',\n\t\t\t\t'trustedOrigins',\n\t\t\t),\n\t\t\tpublisherConnectionString: providedKeyFor(\n\t\t\t\tcanonical,\n\t\t\t\t'websocket-api',\n\t\t\t\t'publisherConnectionString',\n\t\t\t),\n\t\t};\n\t\tthis.logger = config.logger ?? DEFAULT_LOGGER;\n\t\tthis.telemetry = config.telemetry;\n\t\tthis.envParser = envParserFor(\n\t\t\tconfig.envParser\n\t\t\t\t? { id: canonical, envParser: config.envParser }\n\t\t\t\t: undefined,\n\t\t);\n\n\t\tconst envVar = this.keys.publisherConnectionString;\n\t\tconst channel = channelOf(canonical);\n\t\tthis.service = {\n\t\t\tserviceName: serviceKey(canonical) as Uncapitalize<TName>,\n\t\t\t// The same publisher an adaptor builds over a sink of its own: only\n\t\t\t// where the sink sends differs, by the string's scheme.\n\t\t\tregister: async ({ envParser }) => {\n\t\t\t\tconst { connectionString } = envParser\n\t\t\t\t\t.create((get) => ({ connectionString: get(envVar).string() }))\n\t\t\t\t\t.parse();\n\t\t\t\treturn this.publisher(\n\t\t\t\t\tawait sinkFromConnectionString(this.id, connectionString, channel),\n\t\t\t\t);\n\t\t\t},\n\t\t};\n\t}\n\n\t/** The handler a connection's upgrade runs: refuse it, or say who it is. */\n\tconnect(): WebSocketRouteBuilder<'connect', undefined, [], TMessages> {\n\t\treturn new WebSocketRouteBuilder('connect', '$connect', this);\n\t}\n\n\t/** The handler a closed connection runs. */\n\tdisconnect(): WebSocketRouteBuilder<'disconnect', undefined, [], TMessages> {\n\t\treturn new WebSocketRouteBuilder('disconnect', '$disconnect', this);\n\t}\n\n\t/**\n\t * The handler for frames whose `action` — or, for flat frames, whose\n\t * discriminator — is `action`. `$default` answers\n\t * any action nothing else does.\n\t */\n\troute(\n\t\taction: string,\n\t): WebSocketRouteBuilder<'message', undefined, [], TMessages> {\n\t\treturn new WebSocketRouteBuilder('message', action, this);\n\t}\n\n\t/** What authenticates a connection — its session reaches `connect()`. */\n\tauth(construct: Authenticator): WebSocketApi<TName, TMessages> {\n\t\treturn new WebSocketApi<TName, TMessages>(\n\t\t\tthis.id as ConstructName<TName>,\n\t\t\tthis.config,\n\t\t\tconstruct,\n\t\t);\n\t}\n\n\t/**\n\t * Serve it: the routes exported by `modules` that were built from this\n\t * surface, on whatever HTTP server `attach` is handed.\n\t *\n\t * `app` answers plain HTTP — the generated entry puts `/health` in front\n\t * of it — and `attach` takes over the server's upgrades. The sockets are\n\t * closed with 1012 when the server shuts down.\n\t */\n\tasync server(\n\t\toptions: ServiceRegisterOptions & { modules?: readonly object[] },\n\t): Promise<{\n\t\tapp: Hono;\n\t\tattach(server: Server): void;\n\t\t/** Close every socket with 1012, so the HTTP server can close. */\n\t\trelease(): Promise<void>;\n\t\tserver: WebSocketSurfaceServer<TMessages>;\n\t}> {\n\t\tconst { Hono } = await loadHono('A WebSocketApi');\n\n\t\tconst { connectionString, origins, url } = options.envParser\n\t\t\t.create((get) => ({\n\t\t\t\tconnectionString: get(this.keys.publisherConnectionString)\n\t\t\t\t\t.string()\n\t\t\t\t\t// One process with nobody else sending: the sockets and the\n\t\t\t\t\t// routes meet in memory.\n\t\t\t\t\t.default(`memory://${channelOf(this.id)}`),\n\t\t\t\torigins: get(this.keys.trustedOrigins)\n\t\t\t\t\t.string()\n\t\t\t\t\t.default('')\n\t\t\t\t\t.transform((value: string) =>\n\t\t\t\t\t\tvalue\n\t\t\t\t\t\t\t.split(',')\n\t\t\t\t\t\t\t.map((origin) => origin.trim())\n\t\t\t\t\t\t\t.filter(Boolean),\n\t\t\t\t\t),\n\t\t\t\t// Its own address: a native client sends that origin.\n\t\t\t\turl: get(this.keys.url).string().optional(),\n\t\t\t}))\n\t\t\t.parse();\n\n\t\tconst server = await WebSocketSurfaceServer.start<TMessages>({\n\t\t\tcore: (sink) =>\n\t\t\t\tthis.core({\n\t\t\t\t\tenvParser: options.envParser,\n\t\t\t\t\tsink,\n\t\t\t\t\t...(options.modules ? { modules: options.modules } : {}),\n\t\t\t\t}),\n\t\t\ttransport: await transportFromConnectionString(\n\t\t\t\tconnectionString,\n\t\t\t\tchannelOf(this.id),\n\t\t\t),\n\t\t\ttrustedOrigins: origins,\n\t\t\t...(this.config.requireOrigin ? { requireOrigin: true } : {}),\n\t\t\tlimits: this.limits,\n\t\t\tlogger: this.logger,\n\t\t\t...(url ? { url } : {}),\n\t\t\t...(this.config.heartbeat\n\t\t\t\t? { heartbeatMs: this.config.heartbeat * 1000 }\n\t\t\t\t: {}),\n\t\t\t...(this.config.maxPayload ? { maxPayload: this.config.maxPayload } : {}),\n\t\t});\n\t\tonShutdown(() => server.close());\n\n\t\tconst app = new Hono();\n\t\t// Its own, so a process with nothing in front of it — `gkm dev`'s —\n\t\t// answers a probe too. A production entry puts one before it anyway.\n\t\tapp.get('/health', (c) =>\n\t\t\tc.json({ status: 'ok', connections: server.size }),\n\t\t);\n\t\tapp.get('/', (c) =>\n\t\t\tc.json({ surface: this.id, connections: server.size }, 426, {\n\t\t\t\tUpgrade: 'websocket',\n\t\t\t}),\n\t\t);\n\n\t\treturn {\n\t\t\tapp,\n\t\t\tattach: (http) => server.attach(http),\n\t\t\trelease: () => server.close(),\n\t\t\tserver,\n\t\t};\n\t}\n\n\t/**\n\t * The surface with no socket in it — what every runtime serves. The\n\t * routes exported by `modules` that were built from this surface answer\n\t * its frames; `sink` is where its handlers' `sockets` send.\n\t *\n\t * `server()` is the Node adaptor over it. Another runtime (a Lambda\n\t * behind API Gateway, a test) builds one with a sink of its own and\n\t * calls `connect()`, `message()` and `disconnect()` per connection id.\n\t *\n\t * @throws {DuplicateWebSocketRoute} when two routes answer one action.\n\t */\n\tcore(options: {\n\t\tenvParser: EnvironmentParser<{}>;\n\t\tsink: WebSocketSink;\n\t\tmodules?: readonly object[];\n\t}): WebSocketCore<TMessages> {\n\t\treturn new WebSocketCore<TMessages>({\n\t\t\tsurface: this.id,\n\t\t\troutes: (options.modules ?? []).flatMap((module) =>\n\t\t\t\tObject.values(module).filter(WebSocketRoute.isRoute),\n\t\t\t),\n\t\t\tsink: options.sink,\n\t\t\tenvParser: options.envParser,\n\t\t\tlogger: this.logger,\n\t\t\t...(this.config.frame ? { frame: this.config.frame } : {}),\n\t\t\t...(this.declared ? { messages: this.declared.messages } : {}),\n\t\t\t...(this.authenticator ? { authenticator: this.authenticator } : {}),\n\t\t});\n\t}\n\n\t/**\n\t * The surface's publisher over `sink` — typed, checked and encoded as\n\t * `services.<id>` is. What an adaptor with a sink of its own (MSW, a\n\t * Lambda) hands the code that sends to its connections.\n\t */\n\tpublisher(sink: WebSocketSink): WebSocketPublisher<TMessages> {\n\t\treturn new WebSocketPublisher<TMessages>(\n\t\t\tsink,\n\t\t\tthis.declared,\n\t\t\tnew FrameShape(this.id, this.config.frame?.discriminator),\n\t\t);\n\t}\n\n\t/**\n\t * A publisher of the type `services.<id>` is, that records rather than\n\t * sends — hand it to an endpoint's spec, or to a route's `request()` as\n\t * `sockets`, and assert on `sent`, `broadcasts` and `closed`.\n\t *\n\t * Every send is checked by the declared `messages` and encoded by `frame`,\n\t * as deployed: an invalid push rejects, and each record carries the\n\t * frame a client would parse.\n\t *\n\t * ```ts\n\t * const realtime = surface.testPublisher();\n\t * await sendMessage.request({ services: { realtime }, … });\n\t * expect(realtime.sent).toEqual([\n\t * { ids: ['a.1'], action: 'chat.sent', data: { text: 'hi' }, frame: … },\n\t * ]);\n\t * ```\n\t */\n\ttestPublisher(): TestWebSocketPublisher<TMessages> {\n\t\treturn new TestWebSocketPublisher<TMessages>(\n\t\t\tnew FrameShape(this.id, this.config.frame?.discriminator),\n\t\t\tthis.declared,\n\t\t);\n\t}\n\n\t/**\n\t * The per-address limits the edge in front of it enforces too, so a\n\t * flood is refused before it reaches a replica.\n\t */\n\tprivate get edgeLimits(): WebSocketEdgeLimits | undefined {\n\t\tconst { handshakesPerMinute, connectionsPerIp } = this.limits;\n\t\tif (!handshakesPerMinute && !connectionsPerIp) return undefined;\n\t\treturn {\n\t\t\t...(handshakesPerMinute ? { handshakesPerMinute } : {}),\n\t\t\t...(connectionsPerIp ? { connectionsPerIp } : {}),\n\t\t};\n\t}\n\n\t/** The declared messages, with the surface they are checked for. */\n\tprivate get declared(): { surface: string; messages: TMessages } | undefined {\n\t\treturn this.config.messages\n\t\t\t? { surface: this.id, messages: this.config.messages }\n\t\t\t: undefined;\n\t}\n\n\tdeclare(): Declaration[] {\n\t\treturn [\n\t\t\t{\n\t\t\t\tkind: 'websocket-api',\n\t\t\t\tid: this.id,\n\t\t\t\tpath: this.config.path,\n\t\t\t\t...(this.config.subdomain ? { subdomain: this.config.subdomain } : {}),\n\t\t\t\t...(this.config.aliases?.length\n\t\t\t\t\t? { aliases: [...this.config.aliases] }\n\t\t\t\t\t: {}),\n\t\t\t\t...(this.config.frame?.discriminator\n\t\t\t\t\t? { discriminator: this.config.frame.discriminator }\n\t\t\t\t\t: {}),\n\t\t\t\t...(this.authenticator ? { auth: edgeTo(this.authenticator) } : {}),\n\t\t\t\t...(this.config.telemetry\n\t\t\t\t\t? { telemetry: this.config.telemetry.id }\n\t\t\t\t\t: {}),\n\t\t\t\t...(this.config.replicas && this.config.replicas > 1\n\t\t\t\t\t? { replicas: this.config.replicas }\n\t\t\t\t\t: {}),\n\t\t\t\t...(this.edgeLimits ? { limits: this.edgeLimits } : {}),\n\t\t\t\tprovides: [\n\t\t\t\t\tthis.keys.url,\n\t\t\t\t\tthis.keys.trustedOrigins,\n\t\t\t\t\tthis.keys.publisherConnectionString,\n\t\t\t\t],\n\t\t\t},\n\t\t];\n\t}\n}\n\n/**\n * Where `services.<surface>` sends, by the publisher string's scheme: a\n * registered driver's sink — API Gateway's management API on an AWS stage,\n * registered by the build's entry — or else whichever process holds the\n * sockets (`redis://`, `memory://`).\n *\n * @throws {UnregisteredWebSocketScheme} for `apigateway://` with no driver.\n */\nasync function sinkFromConnectionString(\n\tsurface: string,\n\tconnectionString: string,\n\tchannel: string,\n): Promise<WebSocketSink> {\n\tconst driver = webSocketSinkDriverFor(connectionString);\n\tif (driver) return driver.sink(connectionString);\n\tif (connectionString.startsWith(API_GATEWAY_WEBSOCKET_SCHEME)) {\n\t\tthrow new UnregisteredWebSocketScheme(\n\t\t\tsurface,\n\t\t\tAPI_GATEWAY_WEBSOCKET_SCHEME,\n\t\t);\n\t}\n\tconst transport = await transportFromConnectionString(\n\t\tconnectionString,\n\t\tchannel,\n\t);\n\tonShutdown(() => transport.close());\n\treturn new TransportSink(transport);\n}\n\n/** The prefix a surface's channels are named under. */\nfunction channelOf(id: string): string {\n\treturn `gkm:ws:${id}`;\n}\n"],"mappings":"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"}
|