@geekmidas/constructs 10.0.0-alpha.155 → 10.0.0-alpha.156
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 +23 -0
- package/dist/{Construct-DorKS0Ua.cjs → Construct-B8yWxGlR.cjs} +2 -2
- package/dist/{Construct-DorKS0Ua.cjs.map → Construct-B8yWxGlR.cjs.map} +1 -1
- package/dist/{Construct-DySlwh8o.d.mts → Construct-BMk_CRSD.d.mts} +2 -2
- package/dist/{Construct-DySlwh8o.d.mts.map → Construct-BMk_CRSD.d.mts.map} +1 -1
- package/dist/{Construct-CGuc_Ijk.mjs → Construct-CRV3RN2U.mjs} +11 -2
- package/dist/{Construct-CGuc_Ijk.mjs.map → Construct-CRV3RN2U.mjs.map} +1 -1
- package/dist/{Cron-D8mB_cPX.d.mts → Cron-D6Y7BBt3.d.mts} +5 -5
- package/dist/{Cron-D8mB_cPX.d.mts.map → Cron-D6Y7BBt3.d.mts.map} +1 -1
- package/dist/{CronBuilder-Cmajva3g.d.mts → CronBuilder-4BZhkChG.d.mts} +5 -5
- package/dist/{CronBuilder-Cmajva3g.d.mts.map → CronBuilder-4BZhkChG.d.mts.map} +1 -1
- package/dist/{CronBuilder-B_NSP-Y5.cjs → CronBuilder-B4DYaEjl.cjs} +4 -4
- package/dist/{CronBuilder-B_NSP-Y5.cjs.map → CronBuilder-B4DYaEjl.cjs.map} +1 -1
- package/dist/{CronBuilder-BJ5LoadF.mjs → CronBuilder-CukJuL3b.mjs} +3 -3
- package/dist/{CronBuilder-BJ5LoadF.mjs.map → CronBuilder-CukJuL3b.mjs.map} +1 -1
- package/dist/{Endpoint-BbHh3Qoc.d.mts → Endpoint-BUoDD96P.d.mts} +5 -5
- package/dist/{Endpoint-BbHh3Qoc.d.mts.map → Endpoint-BUoDD96P.d.mts.map} +1 -1
- package/dist/{Endpoint-sUOU7uLx.mjs → Endpoint-BuKHHVZc.mjs} +3 -3
- package/dist/{Endpoint-sUOU7uLx.mjs.map → Endpoint-BuKHHVZc.mjs.map} +1 -1
- package/dist/{Endpoint-52z1P0Ue.cjs → Endpoint-D2ckHqIx.cjs} +3 -3
- package/dist/{Endpoint-52z1P0Ue.cjs.map → Endpoint-D2ckHqIx.cjs.map} +1 -1
- package/dist/{EndpointFactory-qcLzi4f-.d.mts → EndpointFactory-BbVOeryo.d.mts} +5 -5
- package/dist/{EndpointFactory-qcLzi4f-.d.mts.map → EndpointFactory-BbVOeryo.d.mts.map} +1 -1
- package/dist/{EndpointFactory-Bzi9Sl7r.mjs → EndpointFactory-BsJUlUyL.mjs} +4 -4
- package/dist/{EndpointFactory-Bzi9Sl7r.mjs.map → EndpointFactory-BsJUlUyL.mjs.map} +1 -1
- package/dist/{EndpointFactory-Cf_Cs1ym.cjs → EndpointFactory-c4tHjQKM.cjs} +5 -5
- package/dist/{EndpointFactory-Cf_Cs1ym.cjs.map → EndpointFactory-c4tHjQKM.cjs.map} +1 -1
- package/dist/{Function-DfMzTGS4.d.mts → Function-BKReud5p.d.mts} +3 -3
- package/dist/{Function-DfMzTGS4.d.mts.map → Function-BKReud5p.d.mts.map} +1 -1
- package/dist/{HonoEndpointAdaptor-DR3j7S35.mjs → HonoEndpointAdaptor-BC7CZ7Cr.mjs} +7 -6
- package/dist/HonoEndpointAdaptor-BC7CZ7Cr.mjs.map +1 -0
- package/dist/{HonoEndpointAdaptor-BXBdb2Bt.cjs → HonoEndpointAdaptor-BGEW1Tu8.cjs} +9 -8
- package/dist/HonoEndpointAdaptor-BGEW1Tu8.cjs.map +1 -0
- package/dist/{ObjectSubscriberBuilder-Cv8C7yS1.d.mts → ObjectSubscriberBuilder-DfzXQEKW.d.mts} +4 -4
- package/dist/{ObjectSubscriberBuilder-Cv8C7yS1.d.mts.map → ObjectSubscriberBuilder-DfzXQEKW.d.mts.map} +1 -1
- package/dist/ObjectSubscriberBuilder-LWkey_oq.d.cts.map +1 -1
- package/dist/{ProcessorBuilder-CwfP-M33.d.mts → ProcessorBuilder-D4oYvZeG.d.mts} +2 -2
- package/dist/{ProcessorBuilder-CwfP-M33.d.mts.map → ProcessorBuilder-D4oYvZeG.d.mts.map} +1 -1
- package/dist/{Queue-u8w8_HpE.mjs → Queue-0FpvxdOa.mjs} +2 -2
- package/dist/{Queue-u8w8_HpE.mjs.map → Queue-0FpvxdOa.mjs.map} +1 -1
- package/dist/{Queue-BnK3UH8r.d.mts → Queue-B8HGg439.d.mts} +3 -3
- package/dist/{Queue-BnK3UH8r.d.mts.map → Queue-B8HGg439.d.mts.map} +1 -1
- package/dist/{Queue-D4Iaidrs.cjs → Queue-DZpV13LN.cjs} +2 -2
- package/dist/{Queue-D4Iaidrs.cjs.map → Queue-DZpV13LN.cjs.map} +1 -1
- package/dist/{QueueBuilder-2wP5lEC8.mjs → QueueBuilder-Bmyay_Di.mjs} +2 -2
- package/dist/{QueueBuilder-2wP5lEC8.mjs.map → QueueBuilder-Bmyay_Di.mjs.map} +1 -1
- package/dist/{QueueBuilder-DmwFtLzQ.d.mts → QueueBuilder-CVS_qPuo.d.mts} +2 -2
- package/dist/{QueueBuilder-DmwFtLzQ.d.mts.map → QueueBuilder-CVS_qPuo.d.mts.map} +1 -1
- package/dist/{QueueBuilder-BxsZ9o5z.cjs → QueueBuilder-FXkSDah1.cjs} +2 -2
- package/dist/{QueueBuilder-BxsZ9o5z.cjs.map → QueueBuilder-FXkSDah1.cjs.map} +1 -1
- package/dist/{Subscriber-CW_Dl-YR.d.mts → Subscriber-CtQXhcL7.d.mts} +3 -3
- package/dist/{Subscriber-CW_Dl-YR.d.mts.map → Subscriber-CtQXhcL7.d.mts.map} +1 -1
- package/dist/{SubscriberBuilder-CWzKwX1p.cjs → SubscriberBuilder-Bfn-iDSk.cjs} +4 -3
- package/dist/SubscriberBuilder-Bfn-iDSk.cjs.map +1 -0
- package/dist/{SubscriberBuilder-BL_GTcwh.mjs → SubscriberBuilder-CxG1OOug.mjs} +4 -3
- package/dist/SubscriberBuilder-CxG1OOug.mjs.map +1 -0
- package/dist/{Topic-DN2gYJ-p.mjs → Topic-DoEdDgh7.mjs} +2 -2
- package/dist/{Topic-DN2gYJ-p.mjs.map → Topic-DoEdDgh7.mjs.map} +1 -1
- package/dist/{Topic-Dp9Q7Lj2.cjs → Topic-t5GhqaeT.cjs} +2 -2
- package/dist/{Topic-Dp9Q7Lj2.cjs.map → Topic-t5GhqaeT.cjs.map} +1 -1
- package/dist/adaptors/aws.cjs +28 -16
- package/dist/adaptors/aws.cjs.map +1 -1
- package/dist/adaptors/aws.d.cts +141 -0
- package/dist/adaptors/aws.d.cts.map +1 -1
- package/dist/adaptors/aws.d.mts +147 -6
- package/dist/adaptors/aws.d.mts.map +1 -1
- package/dist/adaptors/aws.mjs +21 -15
- package/dist/adaptors/aws.mjs.map +1 -1
- package/dist/adaptors/hono.cjs +1 -1
- package/dist/adaptors/hono.d.mts +2 -2
- package/dist/adaptors/hono.mjs +1 -1
- package/dist/adaptors/testing.cjs +25 -15
- package/dist/adaptors/testing.cjs.map +1 -1
- package/dist/adaptors/testing.d.cts +1 -1
- package/dist/adaptors/testing.d.cts.map +1 -1
- package/dist/adaptors/testing.d.mts +9 -9
- package/dist/adaptors/testing.d.mts.map +1 -1
- package/dist/adaptors/testing.mjs +21 -11
- package/dist/adaptors/testing.mjs.map +1 -1
- package/dist/apigateway-Dyjy_JwI.mjs +329 -0
- package/dist/apigateway-Dyjy_JwI.mjs.map +1 -0
- package/dist/apigateway-zHDoMwlI.cjs +370 -0
- package/dist/apigateway-zHDoMwlI.cjs.map +1 -0
- package/dist/auth-BqWz2JxC.d.cts.map +1 -1
- package/dist/auth-DnB9H9KL.d.mts.map +1 -1
- package/dist/auth.cjs +7 -21
- package/dist/auth.cjs.map +1 -1
- package/dist/auth.mjs +6 -20
- package/dist/auth.mjs.map +1 -1
- package/dist/{cache-e3tfMQ9g.d.mts → cache-CCHcO9Oo.d.mts} +2 -2
- package/dist/cache-CCHcO9Oo.d.mts.map +1 -0
- package/dist/cache-CQjMNPrC.d.cts.map +1 -1
- package/dist/cache.cjs +3 -19
- package/dist/cache.cjs.map +1 -1
- package/dist/cache.d.mts +1 -1
- package/dist/cache.mjs +2 -18
- package/dist/cache.mjs.map +1 -1
- package/dist/crons/index.cjs +4 -3
- package/dist/crons/index.cjs.map +1 -1
- package/dist/crons/index.d.cts.map +1 -1
- package/dist/crons/index.d.mts +2 -2
- package/dist/crons/index.d.mts.map +1 -1
- package/dist/crons/index.mjs +4 -3
- package/dist/crons/index.mjs.map +1 -1
- package/dist/database/kysely.cjs +1 -1
- package/dist/database/kysely.d.mts +1 -1
- package/dist/email.cjs +4 -16
- package/dist/email.cjs.map +1 -1
- package/dist/email.d.cts.map +1 -1
- package/dist/email.d.mts.map +1 -1
- package/dist/email.mjs +2 -14
- package/dist/email.mjs.map +1 -1
- package/dist/endpoints/index.cjs +4 -4
- package/dist/endpoints/index.d.cts +1 -1
- package/dist/endpoints/index.d.cts.map +1 -1
- package/dist/endpoints/index.d.mts +4 -4
- package/dist/endpoints/index.d.mts.map +1 -1
- package/dist/endpoints/index.mjs +4 -4
- package/dist/file-server.cjs +1 -1
- package/dist/file-server.d.mts +1 -1
- package/dist/file-server.mjs +1 -1
- package/dist/functions/index.cjs +1 -1
- package/dist/functions/index.d.mts +2 -2
- package/dist/functions/index.mjs +1 -1
- package/dist/{functions-BvIDQKAA.mjs → functions-BF039DT8.mjs} +2 -2
- package/dist/{functions-BvIDQKAA.mjs.map → functions-BF039DT8.mjs.map} +1 -1
- package/dist/{functions-DLF6-IK8.cjs → functions-BqAq_0xQ.cjs} +3 -3
- package/dist/{functions-DLF6-IK8.cjs.map → functions-BqAq_0xQ.cjs.map} +1 -1
- package/dist/{inbox-CjxpLVkH.d.mts → inbox-YOdxlyfj.d.mts} +2 -2
- package/dist/{inbox-CjxpLVkH.d.mts.map → inbox-YOdxlyfj.d.mts.map} +1 -1
- package/dist/inbox.cjs +1 -1
- package/dist/inbox.d.mts +1 -1
- package/dist/inbox.mjs +1 -1
- package/dist/{index-DCkDQkwj.d.mts → index-BoQ3-M-K.d.mts} +4 -4
- package/dist/{index-DCkDQkwj.d.mts.map → index-BoQ3-M-K.d.mts.map} +1 -1
- package/dist/index.cjs +1 -1
- package/dist/index.d.mts +1 -1
- package/dist/index.mjs +1 -1
- package/dist/{kysely-CukArHJ0.cjs → kysely-CeoQdAkg.cjs} +2 -2
- package/dist/{kysely-CukArHJ0.cjs.map → kysely-CeoQdAkg.cjs.map} +1 -1
- package/dist/{kysely-DE4kADWD.d.mts → kysely-De5rAC-E.d.mts} +2 -2
- package/dist/{kysely-DE4kADWD.d.mts.map → kysely-De5rAC-E.d.mts.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-C7T9covD.cjs +24 -0
- package/dist/origins-C7T9covD.cjs.map +1 -0
- package/dist/origins-CX6Ot7ax.mjs +19 -0
- package/dist/origins-CX6Ot7ax.mjs.map +1 -0
- package/dist/{pattern-QFaUIr77.cjs → pattern-HnNOPhE2.cjs} +2 -2
- package/dist/{pattern-QFaUIr77.cjs.map → pattern-HnNOPhE2.cjs.map} +1 -1
- package/dist/{pattern-C1CEcglD.mjs → pattern-YSqfAhXm.mjs} +2 -2
- package/dist/{pattern-C1CEcglD.mjs.map → pattern-YSqfAhXm.mjs.map} +1 -1
- 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 +1 -1
- package/dist/processors/index.d.mts +1 -1
- package/dist/processors/index.mjs +1 -1
- package/dist/queue/index.cjs +2 -2
- package/dist/queue/index.d.mts +2 -2
- package/dist/queue/index.mjs +2 -2
- package/dist/{readRequestBody-BTIl3k-D.mjs → readRequestBody-BmKnPl0a.mjs} +26 -4
- package/dist/readRequestBody-BmKnPl0a.mjs.map +1 -0
- package/dist/{readRequestBody-Dej_L3c4.cjs → readRequestBody-CN9GVdeE.cjs} +26 -4
- package/dist/readRequestBody-CN9GVdeE.cjs.map +1 -0
- package/dist/{requestLogger-BZcXwdBs.cjs → requestLogger-CnoYd-Ah.cjs} +4 -63
- package/dist/requestLogger-CnoYd-Ah.cjs.map +1 -0
- package/dist/{requestLogger-pA4gi3E1.mjs → requestLogger-D2JS7pPM.mjs} +3 -56
- package/dist/requestLogger-D2JS7pPM.mjs.map +1 -0
- package/dist/rest-api.cjs +1 -1
- package/dist/rest-api.d.mts +2 -2
- package/dist/rest-api.mjs +1 -1
- package/dist/{rolldown-runtime-y5ARvAq5.cjs → rolldown-runtime-Ctb5zv51.cjs} +15 -0
- package/dist/{runSubscriber-DyHWp_Lf.mjs → runSubscriber-HEqXkin1.mjs} +3 -2
- package/dist/runSubscriber-HEqXkin1.mjs.map +1 -0
- package/dist/{runSubscriber-CC_2C9F2.cjs → runSubscriber-sVJfLA0-.cjs} +3 -2
- package/dist/runSubscriber-sVJfLA0-.cjs.map +1 -0
- package/dist/subscribers/index.cjs +6 -6
- package/dist/subscribers/index.cjs.map +1 -1
- package/dist/subscribers/index.d.cts +1 -1
- package/dist/subscribers/index.d.mts +3 -3
- package/dist/subscribers/index.mjs +3 -3
- package/dist/subscribers/index.mjs.map +1 -1
- package/dist/topic/index.cjs +1 -1
- package/dist/topic/index.d.mts +1 -1
- package/dist/topic/index.mjs +1 -1
- package/dist/{websocket-api-Dn_3Y2fI.mjs → websocket-api-BvKS9x-l.mjs} +453 -44
- package/dist/websocket-api-BvKS9x-l.mjs.map +1 -0
- package/dist/{websocket-api-CLnV_7CB.d.cts → websocket-api-C3dWKNxO.d.cts} +481 -208
- package/dist/websocket-api-C3dWKNxO.d.cts.map +1 -0
- package/dist/{websocket-api-9bXfgrqd.cjs → websocket-api-CAQA_QOE.cjs} +494 -43
- package/dist/websocket-api-CAQA_QOE.cjs.map +1 -0
- package/dist/{websocket-api-DSWDhZph.d.mts → websocket-api-CDAxOTQZ.d.mts} +481 -208
- package/dist/websocket-api-CDAxOTQZ.d.mts.map +1 -0
- package/dist/websocket-api.cjs +8 -1
- package/dist/websocket-api.d.cts +2 -2
- package/dist/websocket-api.d.mts +2 -2
- package/dist/websocket-api.mjs +2 -2
- package/dist/worker.cjs +4 -4
- package/dist/worker.d.mts +9 -9
- package/dist/worker.mjs +4 -4
- package/package.json +41 -31
- package/dist/HonoEndpointAdaptor-BXBdb2Bt.cjs.map +0 -1
- package/dist/HonoEndpointAdaptor-DR3j7S35.mjs.map +0 -1
- package/dist/SubscriberBuilder-BL_GTcwh.mjs.map +0 -1
- package/dist/SubscriberBuilder-CWzKwX1p.cjs.map +0 -1
- package/dist/cache-e3tfMQ9g.d.mts.map +0 -1
- package/dist/readRequestBody-BTIl3k-D.mjs.map +0 -1
- package/dist/readRequestBody-Dej_L3c4.cjs.map +0 -1
- package/dist/requestLogger-BZcXwdBs.cjs.map +0 -1
- package/dist/requestLogger-pA4gi3E1.mjs.map +0 -1
- package/dist/runSubscriber-CC_2C9F2.cjs.map +0 -1
- package/dist/runSubscriber-DyHWp_Lf.mjs.map +0 -1
- package/dist/websocket-api-9bXfgrqd.cjs.map +0 -1
- package/dist/websocket-api-CLnV_7CB.d.cts.map +0 -1
- package/dist/websocket-api-DSWDhZph.d.mts.map +0 -1
- package/dist/websocket-api-Dn_3Y2fI.mjs.map +0 -1
|
@@ -1,7 +1,10 @@
|
|
|
1
1
|
import { t as onShutdown } from "./shutdown-C7xa8x9S.mjs";
|
|
2
2
|
import { edgeTo, idsOf, servicesOf } from "./construct-interface.mjs";
|
|
3
|
+
import { c as loadHono, m as loadWs, u as loadIoredis } from "./optionalPeers-D7Wt6dnF.mjs";
|
|
4
|
+
import { t as isPrivateAddress } from "./privateAddress-Bg5fUsbp.mjs";
|
|
3
5
|
import { n as envParserFor } from "./surfaceEnv-wMT5QzgZ.mjs";
|
|
4
|
-
import {
|
|
6
|
+
import { t as ownOrigins } from "./origins-CX6Ot7ax.mjs";
|
|
7
|
+
import { API_GATEWAY_WEBSOCKET_SCHEME, canonicalId, provideKey, serviceKey, trustsOrigin } from "@geekmidas/manifest";
|
|
5
8
|
import { DEFAULT_LOGGER } from "@geekmidas/logger/console";
|
|
6
9
|
import { randomBytes } from "node:crypto";
|
|
7
10
|
import { ServiceDiscovery, runWithRequestContext } from "@geekmidas/services";
|
|
@@ -489,6 +492,228 @@ var WebSocketCore = class {
|
|
|
489
492
|
}
|
|
490
493
|
};
|
|
491
494
|
//#endregion
|
|
495
|
+
//#region src/websocket/limits.ts
|
|
496
|
+
/** Close codes the limits close a socket with. */
|
|
497
|
+
const LIMIT_CLOSE = {
|
|
498
|
+
/** Policy violation: it kept sending past its rate, or its identity has too many sockets. */
|
|
499
|
+
policy: 1008 };
|
|
500
|
+
const DEFAULT_WEBSOCKET_LIMITS = {
|
|
501
|
+
handshakesPerMinute: 120,
|
|
502
|
+
inFlightHandshakes: 16,
|
|
503
|
+
connectionsPerIp: 256,
|
|
504
|
+
messagesPerSecond: 50,
|
|
505
|
+
burst: 100,
|
|
506
|
+
maxConnections: 16
|
|
507
|
+
};
|
|
508
|
+
/** A limit that is not a whole number of at least one. */
|
|
509
|
+
var InvalidWebSocketLimit = class extends Error {
|
|
510
|
+
surface;
|
|
511
|
+
limit;
|
|
512
|
+
value;
|
|
513
|
+
constructor(surface, limit, value) {
|
|
514
|
+
super(`${surface} sets limits.${limit} to ${String(value)}. A limit is a whole number of 1 or more — or false, to lift it.`);
|
|
515
|
+
this.surface = surface;
|
|
516
|
+
this.limit = limit;
|
|
517
|
+
this.value = value;
|
|
518
|
+
this.name = "InvalidWebSocketLimit";
|
|
519
|
+
}
|
|
520
|
+
};
|
|
521
|
+
/**
|
|
522
|
+
* Fill in the defaults.
|
|
523
|
+
*
|
|
524
|
+
* @throws {InvalidWebSocketLimit} for a limit that is not a positive integer.
|
|
525
|
+
*/
|
|
526
|
+
function resolveLimits(surface, limits = {}) {
|
|
527
|
+
const pick = (name, value) => {
|
|
528
|
+
if (value === false) return void 0;
|
|
529
|
+
const resolved = value ?? DEFAULT_WEBSOCKET_LIMITS[name];
|
|
530
|
+
if (!Number.isInteger(resolved) || resolved < 1) throw new InvalidWebSocketLimit(surface, name, value);
|
|
531
|
+
return resolved;
|
|
532
|
+
};
|
|
533
|
+
const messagesPerSecond = pick("messagesPerSecond", limits.messagesPerSecond);
|
|
534
|
+
return {
|
|
535
|
+
...optional("handshakesPerMinute", pick("handshakesPerMinute", limits.handshakesPerMinute)),
|
|
536
|
+
...optional("inFlightHandshakes", pick("inFlightHandshakes", limits.inFlightHandshakes)),
|
|
537
|
+
...optional("connectionsPerIp", pick("connectionsPerIp", limits.connectionsPerIp)),
|
|
538
|
+
...optional("messagesPerSecond", messagesPerSecond),
|
|
539
|
+
burst: pick("burst", limits.burst) ?? DEFAULT_WEBSOCKET_LIMITS.burst,
|
|
540
|
+
...limits.maxConnectionsPer ? { maxConnectionsPer: limits.maxConnectionsPer } : {},
|
|
541
|
+
maxConnections: pick("maxConnections", limits.maxConnections) ?? DEFAULT_WEBSOCKET_LIMITS.maxConnections,
|
|
542
|
+
overflow: limits.overflow ?? "refuse"
|
|
543
|
+
};
|
|
544
|
+
}
|
|
545
|
+
function optional(key, value) {
|
|
546
|
+
return value === void 0 ? {} : { [key]: value };
|
|
547
|
+
}
|
|
548
|
+
/**
|
|
549
|
+
* In one process. Two servers on one `memory://` channel — replicas in a
|
|
550
|
+
* test — share it, as they share the channel.
|
|
551
|
+
*/
|
|
552
|
+
var MemoryLimitStore = class {
|
|
553
|
+
windows = /* @__PURE__ */ new Map();
|
|
554
|
+
/** key → member → [opened, expires] */
|
|
555
|
+
sets = /* @__PURE__ */ new Map();
|
|
556
|
+
async hit(key, windowMs) {
|
|
557
|
+
const now = Date.now();
|
|
558
|
+
let window = this.windows.get(key);
|
|
559
|
+
if (!window || window.resetAt <= now) {
|
|
560
|
+
window = {
|
|
561
|
+
count: 0,
|
|
562
|
+
resetAt: now + windowMs
|
|
563
|
+
};
|
|
564
|
+
this.windows.set(key, window);
|
|
565
|
+
}
|
|
566
|
+
window.count++;
|
|
567
|
+
return {
|
|
568
|
+
count: window.count,
|
|
569
|
+
resetMs: window.resetAt - now
|
|
570
|
+
};
|
|
571
|
+
}
|
|
572
|
+
async hold(key, member, ttlMs) {
|
|
573
|
+
const now = Date.now();
|
|
574
|
+
let set = this.sets.get(key);
|
|
575
|
+
if (!set) {
|
|
576
|
+
set = /* @__PURE__ */ new Map();
|
|
577
|
+
this.sets.set(key, set);
|
|
578
|
+
}
|
|
579
|
+
for (const [held, [, expires]] of set) if (expires <= now) set.delete(held);
|
|
580
|
+
const opened = set.get(member)?.[0] ?? now;
|
|
581
|
+
set.set(member, [opened, now + ttlMs]);
|
|
582
|
+
return [...set].sort((a, b) => a[1][0] - b[1][0]).map(([held]) => held);
|
|
583
|
+
}
|
|
584
|
+
async release(key, member) {
|
|
585
|
+
const set = this.sets.get(key);
|
|
586
|
+
set?.delete(member);
|
|
587
|
+
if (set?.size === 0) this.sets.delete(key);
|
|
588
|
+
}
|
|
589
|
+
async renew(held, ttlMs) {
|
|
590
|
+
const expires = Date.now() + ttlMs;
|
|
591
|
+
for (const { key, member } of held) {
|
|
592
|
+
const entry = this.sets.get(key)?.get(member);
|
|
593
|
+
if (entry) entry[1] = expires;
|
|
594
|
+
}
|
|
595
|
+
}
|
|
596
|
+
};
|
|
597
|
+
const HIT = `
|
|
598
|
+
local count = redis.call('INCR', KEYS[1])
|
|
599
|
+
if count == 1 then redis.call('PEXPIRE', KEYS[1], ARGV[1]) end
|
|
600
|
+
local ttl = redis.call('PTTL', KEYS[1])
|
|
601
|
+
if ttl < 0 then
|
|
602
|
+
redis.call('PEXPIRE', KEYS[1], ARGV[1])
|
|
603
|
+
ttl = tonumber(ARGV[1])
|
|
604
|
+
end
|
|
605
|
+
return { count, ttl }
|
|
606
|
+
`;
|
|
607
|
+
const HOLD = `
|
|
608
|
+
redis.call('ZREMRANGEBYSCORE', KEYS[1], '-inf', ARGV[1])
|
|
609
|
+
redis.call('ZADD', KEYS[1], ARGV[2], ARGV[3])
|
|
610
|
+
redis.call('PEXPIRE', KEYS[1], ARGV[4])
|
|
611
|
+
return redis.call('ZRANGE', KEYS[1], 0, -1)
|
|
612
|
+
`;
|
|
613
|
+
const RENEW = `
|
|
614
|
+
for i, key in ipairs(KEYS) do
|
|
615
|
+
redis.call('ZADD', key, 'XX', ARGV[1], ARGV[i + 2])
|
|
616
|
+
redis.call('PEXPIRE', key, ARGV[2])
|
|
617
|
+
end
|
|
618
|
+
return 0
|
|
619
|
+
`;
|
|
620
|
+
/**
|
|
621
|
+
* Over Redis — the transport's own — so every replica counts in one place.
|
|
622
|
+
* Each operation is one script, so concurrent handshakes on any replica are
|
|
623
|
+
* each counted.
|
|
624
|
+
*/
|
|
625
|
+
var RedisLimitStore = class {
|
|
626
|
+
client;
|
|
627
|
+
prefix;
|
|
628
|
+
/** member as handed in → member as stored, with its opening time. */
|
|
629
|
+
stored = /* @__PURE__ */ new Map();
|
|
630
|
+
constructor(client, prefix) {
|
|
631
|
+
this.client = client;
|
|
632
|
+
this.prefix = prefix;
|
|
633
|
+
}
|
|
634
|
+
key(key) {
|
|
635
|
+
return `${this.prefix}:limits:${key}`;
|
|
636
|
+
}
|
|
637
|
+
storedAs(key, member) {
|
|
638
|
+
const id = `${key}\n${member}`;
|
|
639
|
+
let stored = this.stored.get(id);
|
|
640
|
+
if (!stored) {
|
|
641
|
+
stored = `${Date.now().toString(36).padStart(9, "0")}|${member}`;
|
|
642
|
+
this.stored.set(id, stored);
|
|
643
|
+
}
|
|
644
|
+
return stored;
|
|
645
|
+
}
|
|
646
|
+
async hit(key, windowMs) {
|
|
647
|
+
const [count, resetMs] = await this.client.eval(HIT, 1, this.key(key), windowMs);
|
|
648
|
+
return {
|
|
649
|
+
count: Number(count),
|
|
650
|
+
resetMs: Number(resetMs)
|
|
651
|
+
};
|
|
652
|
+
}
|
|
653
|
+
async hold(key, member, ttlMs) {
|
|
654
|
+
const now = Date.now();
|
|
655
|
+
return (await this.client.eval(HOLD, 1, this.key(key), now, now + ttlMs, this.storedAs(key, member), ttlMs)).sort().map((stored) => stored.slice(stored.indexOf("|") + 1));
|
|
656
|
+
}
|
|
657
|
+
async release(key, member) {
|
|
658
|
+
const id = `${key}\n${member}`;
|
|
659
|
+
const stored = this.stored.get(id);
|
|
660
|
+
this.stored.delete(id);
|
|
661
|
+
if (!stored) return;
|
|
662
|
+
await this.client.eval("return redis.call('ZREM', KEYS[1], ARGV[1])", 1, this.key(key), stored);
|
|
663
|
+
}
|
|
664
|
+
async renew(held, ttlMs) {
|
|
665
|
+
const known = held.flatMap(({ key, member }) => {
|
|
666
|
+
const stored = this.stored.get(`${key}\n${member}`);
|
|
667
|
+
return stored ? [{
|
|
668
|
+
key: this.key(key),
|
|
669
|
+
stored
|
|
670
|
+
}] : [];
|
|
671
|
+
});
|
|
672
|
+
if (known.length === 0) return;
|
|
673
|
+
await this.client.eval(RENEW, known.length, ...known.map(({ key }) => key), Date.now() + ttlMs, ttlMs, ...known.map(({ stored }) => stored));
|
|
674
|
+
}
|
|
675
|
+
};
|
|
676
|
+
/**
|
|
677
|
+
* A socket's inbound budget: `burst` frames at once, refilled at `rate` a
|
|
678
|
+
* second.
|
|
679
|
+
*/
|
|
680
|
+
var TokenBucket = class {
|
|
681
|
+
rate;
|
|
682
|
+
burst;
|
|
683
|
+
tokens;
|
|
684
|
+
at = Date.now();
|
|
685
|
+
constructor(rate, burst) {
|
|
686
|
+
this.rate = rate;
|
|
687
|
+
this.burst = burst;
|
|
688
|
+
this.tokens = burst;
|
|
689
|
+
}
|
|
690
|
+
/** Spend one token, if there is one. */
|
|
691
|
+
take(now = Date.now()) {
|
|
692
|
+
this.tokens = Math.min(this.burst, this.tokens + (now - this.at) / 1e3 * this.rate);
|
|
693
|
+
this.at = now;
|
|
694
|
+
if (this.tokens < 1) return false;
|
|
695
|
+
this.tokens -= 1;
|
|
696
|
+
return true;
|
|
697
|
+
}
|
|
698
|
+
/** Whether it has refilled completely since it last ran dry. */
|
|
699
|
+
get full() {
|
|
700
|
+
return this.tokens >= this.burst - 1;
|
|
701
|
+
}
|
|
702
|
+
};
|
|
703
|
+
/**
|
|
704
|
+
* The client a handshake is counted against. Behind the stack's edge — a
|
|
705
|
+
* private peer — the address the edge put last in `X-Forwarded-For`, the one
|
|
706
|
+
* it saw; Traefik and Caddy both replace what an outside client sent there.
|
|
707
|
+
* From anywhere else, the peer itself: a header a client could set never
|
|
708
|
+
* picks the bucket it is counted in.
|
|
709
|
+
*/
|
|
710
|
+
function clientAddress(request) {
|
|
711
|
+
const peer = request.socket.remoteAddress ?? "unknown";
|
|
712
|
+
const forwarded = request.headers["x-forwarded-for"];
|
|
713
|
+
if (!forwarded || !isPrivateAddress(peer)) return peer;
|
|
714
|
+
return (Array.isArray(forwarded) ? forwarded.join(",") : forwarded).split(",").map((hop) => hop.trim()).filter(Boolean).at(-1) ?? peer;
|
|
715
|
+
}
|
|
716
|
+
//#endregion
|
|
492
717
|
//#region src/websocket/testing.ts
|
|
493
718
|
/**
|
|
494
719
|
* A sink that keeps what it is handed, decoded by the surface's frame shape,
|
|
@@ -794,6 +1019,10 @@ const key = Symbol.for("@geekmidas/constructs/websocket/memory");
|
|
|
794
1019
|
const registry = globalThis;
|
|
795
1020
|
registry[key] ??= /* @__PURE__ */ new Map();
|
|
796
1021
|
const channels = registry[key];
|
|
1022
|
+
const limitsKey = Symbol.for("@geekmidas/constructs/websocket/memory-limits");
|
|
1023
|
+
const limitRegistry = globalThis;
|
|
1024
|
+
limitRegistry[limitsKey] ??= /* @__PURE__ */ new Map();
|
|
1025
|
+
const limitStores = limitRegistry[limitsKey];
|
|
797
1026
|
/**
|
|
798
1027
|
* In one process: the server and whoever sends meet in a map, keyed by the
|
|
799
1028
|
* channel the connection string names.
|
|
@@ -826,6 +1055,15 @@ var MemoryTransport = class {
|
|
|
826
1055
|
const instances = channels.get(this.channel);
|
|
827
1056
|
for (const instance of this.subscribed) instances?.delete(instance);
|
|
828
1057
|
this.subscribed.clear();
|
|
1058
|
+
if (!instances?.size) limitStores.delete(this.channel);
|
|
1059
|
+
}
|
|
1060
|
+
limits() {
|
|
1061
|
+
let store = limitStores.get(this.channel);
|
|
1062
|
+
if (!store) {
|
|
1063
|
+
store = new MemoryLimitStore();
|
|
1064
|
+
limitStores.set(this.channel, store);
|
|
1065
|
+
}
|
|
1066
|
+
return store;
|
|
829
1067
|
}
|
|
830
1068
|
};
|
|
831
1069
|
/**
|
|
@@ -862,6 +1100,10 @@ var RedisTransport = class {
|
|
|
862
1100
|
});
|
|
863
1101
|
await subscriber.subscribe(own, every);
|
|
864
1102
|
}
|
|
1103
|
+
/** Counted in this Redis, under the transport's prefix. */
|
|
1104
|
+
limits() {
|
|
1105
|
+
return new RedisLimitStore(this.client, this.prefix);
|
|
1106
|
+
}
|
|
865
1107
|
/** Idempotent: the server and a shutdown hook may both close it. */
|
|
866
1108
|
close() {
|
|
867
1109
|
this.closed ??= Promise.all([this.subscriber?.quit(), this.client.quit()]).then(() => void 0);
|
|
@@ -882,7 +1124,7 @@ async function transportFromConnectionString(connectionString, fallback) {
|
|
|
882
1124
|
if (url.protocol === "redis:" || url.protocol === "rediss:") {
|
|
883
1125
|
const channel = url.searchParams.get("channel") || fallback;
|
|
884
1126
|
url.searchParams.delete("channel");
|
|
885
|
-
const { Redis } = await
|
|
1127
|
+
const { Redis } = await loadIoredis();
|
|
886
1128
|
return new RedisTransport(new Redis(url.toString(), {
|
|
887
1129
|
maxRetriesPerRequest: null,
|
|
888
1130
|
lazyConnect: false
|
|
@@ -897,20 +1139,28 @@ async function transportFromConnectionString(connectionString, fallback) {
|
|
|
897
1139
|
*
|
|
898
1140
|
* Node's own `http` server and `ws`, nothing between them. This owns what
|
|
899
1141
|
* only a real socket has — the upgrade, the Origin check, connection ids,
|
|
900
|
-
* the heartbeat, backpressure
|
|
901
|
-
* `
|
|
902
|
-
*
|
|
903
|
-
*
|
|
904
|
-
*
|
|
1142
|
+
* the heartbeat, backpressure, and the limits on what one client may ask of
|
|
1143
|
+
* it (`limits.ts`) — and hands the rest to the surface's `WebSocketCore`: a
|
|
1144
|
+
* handshake to `connect()`, each frame to `message()`, a close to
|
|
1145
|
+
* `disconnect()`. The HTTP server is whatever the entry started — the
|
|
1146
|
+
* generated one serves `/health` on the same port — and this attaches to its
|
|
1147
|
+
* `upgrade` event.
|
|
905
1148
|
*/
|
|
906
1149
|
/** Close codes a client sees. */
|
|
907
1150
|
const CLOSE = {
|
|
908
1151
|
normal: 1e3,
|
|
1152
|
+
/**
|
|
1153
|
+
* It kept sending past its message rate, or its identity opened more
|
|
1154
|
+
* sockets than `limits.maxConnections` and this was the oldest.
|
|
1155
|
+
*/
|
|
1156
|
+
policy: LIMIT_CLOSE.policy,
|
|
909
1157
|
/** The process is stopping; reconnect and land on another. */
|
|
910
1158
|
serviceRestart: 1012,
|
|
911
1159
|
/** It stopped reading, and what was queued for it passed the limit. */
|
|
912
1160
|
tooSlow: 1013
|
|
913
1161
|
};
|
|
1162
|
+
/** A handshake is counted as in flight for at most this long. */
|
|
1163
|
+
const IN_FLIGHT_TTL_MS = 3e4;
|
|
914
1164
|
var WebSocketSurfaceServer = class WebSocketSurfaceServer {
|
|
915
1165
|
wss;
|
|
916
1166
|
options;
|
|
@@ -920,22 +1170,30 @@ var WebSocketSurfaceServer = class WebSocketSurfaceServer {
|
|
|
920
1170
|
core;
|
|
921
1171
|
held = /* @__PURE__ */ new Map();
|
|
922
1172
|
heartbeat;
|
|
1173
|
+
heartbeatMs;
|
|
923
1174
|
trusted;
|
|
1175
|
+
sink;
|
|
1176
|
+
limits;
|
|
1177
|
+
store;
|
|
924
1178
|
next = 0;
|
|
925
1179
|
closing = false;
|
|
926
1180
|
constructor(wss, options) {
|
|
927
1181
|
this.wss = wss;
|
|
928
1182
|
this.options = options;
|
|
929
|
-
this.
|
|
1183
|
+
this.sink = new TransportSink(options.transport, {
|
|
930
1184
|
instance: this.instance,
|
|
931
1185
|
deliver: (delivery) => this.deliver(delivery)
|
|
932
|
-
})
|
|
1186
|
+
});
|
|
1187
|
+
this.core = options.core(this.sink);
|
|
933
1188
|
this.trusted = [...options.trustedOrigins, ...ownOrigins(options.url)];
|
|
934
|
-
this.
|
|
1189
|
+
this.limits = options.limits ?? resolveLimits(this.core.surface);
|
|
1190
|
+
this.store = options.transport.limits?.() ?? new MemoryLimitStore();
|
|
1191
|
+
this.heartbeatMs = options.heartbeatMs ?? 3e4;
|
|
1192
|
+
this.heartbeat = setInterval(() => this.beat(), this.heartbeatMs);
|
|
935
1193
|
this.heartbeat.unref();
|
|
936
1194
|
}
|
|
937
1195
|
static async start(options) {
|
|
938
|
-
const { WebSocketServer } = await
|
|
1196
|
+
const { WebSocketServer } = await loadWs();
|
|
939
1197
|
const wss = new WebSocketServer({
|
|
940
1198
|
noServer: true,
|
|
941
1199
|
maxPayload: options.maxPayload ?? 1048576,
|
|
@@ -960,25 +1218,87 @@ var WebSocketSurfaceServer = class WebSocketSurfaceServer {
|
|
|
960
1218
|
this.upgrade(request, socket, head);
|
|
961
1219
|
});
|
|
962
1220
|
}
|
|
963
|
-
/**
|
|
1221
|
+
/**
|
|
1222
|
+
* Upgrade one request, or refuse it with a status line. The cheap checks
|
|
1223
|
+
* come first — the Origin, the client's handshake rate, its handshakes in
|
|
1224
|
+
* flight and its open sockets — so a flood is refused before the connect
|
|
1225
|
+
* handler, and the session lookup it makes, runs.
|
|
1226
|
+
*/
|
|
964
1227
|
async upgrade(request, socket, head) {
|
|
965
1228
|
if (this.closing) return refuse(socket, 503, "Service Unavailable");
|
|
966
1229
|
const origin = request.headers.origin;
|
|
967
|
-
if (origin
|
|
968
|
-
const
|
|
969
|
-
|
|
970
|
-
|
|
971
|
-
|
|
972
|
-
|
|
973
|
-
|
|
974
|
-
|
|
975
|
-
|
|
1230
|
+
if (origin ? !trustsOrigin(origin, this.trusted) : this.options.requireOrigin) return refuse(socket, 403, "Forbidden");
|
|
1231
|
+
const { limits } = this;
|
|
1232
|
+
const client = clientAddress(request);
|
|
1233
|
+
const connectionId = `${this.instance}.${(this.next++).toString(36)}`;
|
|
1234
|
+
if (limits.handshakesPerMinute) {
|
|
1235
|
+
const window = await this.guard(() => this.store.hit(`handshakes:${client}`, 6e4));
|
|
1236
|
+
if (window && window.count > limits.handshakesPerMinute) return tooMany(socket, window.resetMs);
|
|
1237
|
+
}
|
|
1238
|
+
const inFlight = {
|
|
1239
|
+
key: `in-flight:${client}`,
|
|
1240
|
+
member: connectionId
|
|
1241
|
+
};
|
|
1242
|
+
if (limits.inFlightHandshakes && !await this.claim(inFlight, limits.inFlightHandshakes, IN_FLIGHT_TTL_MS)) return tooMany(socket);
|
|
1243
|
+
const leases = [];
|
|
1244
|
+
const releaseAll = () => {
|
|
1245
|
+
for (const lease of leases.splice(0)) this.release(lease);
|
|
1246
|
+
};
|
|
1247
|
+
try {
|
|
1248
|
+
if (limits.connectionsPerIp) {
|
|
1249
|
+
const lease = {
|
|
1250
|
+
key: `ip:${client}`,
|
|
1251
|
+
member: connectionId
|
|
1252
|
+
};
|
|
1253
|
+
if (!await this.claim(lease, limits.connectionsPerIp)) return tooMany(socket);
|
|
1254
|
+
leases.push(lease);
|
|
1255
|
+
}
|
|
1256
|
+
const outcome = await this.core.connect({
|
|
1257
|
+
connectionId,
|
|
1258
|
+
headers: headersOf(request),
|
|
1259
|
+
query: new URL(request.url ?? "/", "http://localhost").searchParams
|
|
1260
|
+
});
|
|
1261
|
+
if (!outcome.accepted) {
|
|
1262
|
+
releaseAll();
|
|
1263
|
+
return refuse(socket, outcome.status, outcome.statusText);
|
|
1264
|
+
}
|
|
1265
|
+
const identity = limits.maxConnectionsPer?.(outcome.connection.data);
|
|
1266
|
+
if (identity !== void 0) {
|
|
1267
|
+
const lease = {
|
|
1268
|
+
key: `identity:${identity}`,
|
|
1269
|
+
member: connectionId
|
|
1270
|
+
};
|
|
1271
|
+
leases.push(lease);
|
|
1272
|
+
const held = await this.guard(() => this.store.hold(lease.key, lease.member, this.connectionTtl));
|
|
1273
|
+
if (held && held.length > limits.maxConnections) {
|
|
1274
|
+
if (limits.overflow === "refuse") {
|
|
1275
|
+
releaseAll();
|
|
1276
|
+
return tooMany(socket);
|
|
1277
|
+
}
|
|
1278
|
+
const oldest = held.filter((id) => id !== connectionId).slice(0, held.length - limits.maxConnections);
|
|
1279
|
+
for (const id of oldest) this.release({
|
|
1280
|
+
key: lease.key,
|
|
1281
|
+
member: id
|
|
1282
|
+
});
|
|
1283
|
+
await this.guard(() => this.sink.close(oldest, CLOSE.policy, "Too many connections"));
|
|
1284
|
+
}
|
|
1285
|
+
}
|
|
1286
|
+
if (socket.destroyed) return releaseAll();
|
|
1287
|
+
const opened = leases.splice(0);
|
|
1288
|
+
this.wss.handleUpgrade(request, socket, head, (ws) => this.open(ws, outcome.connection, opened));
|
|
1289
|
+
} finally {
|
|
1290
|
+
if (limits.inFlightHandshakes) this.release(inFlight);
|
|
1291
|
+
}
|
|
976
1292
|
}
|
|
977
|
-
open(socket, connection) {
|
|
1293
|
+
open(socket, connection, leases) {
|
|
1294
|
+
const { messagesPerSecond, burst } = this.limits;
|
|
978
1295
|
const held = {
|
|
979
1296
|
socket,
|
|
980
1297
|
connection,
|
|
981
|
-
alive: true
|
|
1298
|
+
alive: true,
|
|
1299
|
+
leases,
|
|
1300
|
+
warned: false,
|
|
1301
|
+
...messagesPerSecond ? { bucket: new TokenBucket(messagesPerSecond, burst) } : {}
|
|
982
1302
|
};
|
|
983
1303
|
this.held.set(connection.id, held);
|
|
984
1304
|
const write = (payload) => this.write(held, payload);
|
|
@@ -987,17 +1307,69 @@ var WebSocketSurfaceServer = class WebSocketSurfaceServer {
|
|
|
987
1307
|
});
|
|
988
1308
|
socket.on("message", (raw, isBinary) => {
|
|
989
1309
|
held.alive = true;
|
|
1310
|
+
if (!this.admit(held)) return;
|
|
990
1311
|
this.core.message(connection, isBinary ? bytesOf(raw) : raw.toString(), write);
|
|
991
1312
|
});
|
|
992
1313
|
socket.on("error", () => socket.terminate());
|
|
993
1314
|
socket.on("close", (code, reason) => {
|
|
994
1315
|
this.held.delete(connection.id);
|
|
1316
|
+
for (const lease of held.leases.splice(0)) this.release(lease);
|
|
995
1317
|
this.core.disconnect(connection, {
|
|
996
1318
|
code,
|
|
997
1319
|
reason: reason.toString()
|
|
998
1320
|
});
|
|
999
1321
|
});
|
|
1000
1322
|
}
|
|
1323
|
+
/**
|
|
1324
|
+
* Whether a frame is within its socket's budget. The first past it is
|
|
1325
|
+
* answered with one `$error`; another before the budget has refilled
|
|
1326
|
+
* closes the socket with 1008.
|
|
1327
|
+
*/
|
|
1328
|
+
admit(held) {
|
|
1329
|
+
const { bucket } = held;
|
|
1330
|
+
if (!bucket) return true;
|
|
1331
|
+
if (bucket.take()) {
|
|
1332
|
+
if (held.warned && bucket.full) held.warned = false;
|
|
1333
|
+
return true;
|
|
1334
|
+
}
|
|
1335
|
+
if (held.socket.readyState !== held.socket.OPEN) return false;
|
|
1336
|
+
if (held.warned) {
|
|
1337
|
+
held.socket.close(CLOSE.policy, "Too many messages");
|
|
1338
|
+
return false;
|
|
1339
|
+
}
|
|
1340
|
+
held.warned = true;
|
|
1341
|
+
this.write(held, this.core.frame.encode("$error", { message: `Too many messages: at most ${this.limits.messagesPerSecond} a second, ${this.limits.burst} at once. Frames are dropped until the socket slows down, and it is closed if it keeps sending.` }));
|
|
1342
|
+
return false;
|
|
1343
|
+
}
|
|
1344
|
+
/**
|
|
1345
|
+
* Take a place in `lease`'s count — or none, when that would put it past
|
|
1346
|
+
* `max`. A store that cannot be reached lets the handshake through.
|
|
1347
|
+
*/
|
|
1348
|
+
async claim(lease, max, ttlMs = this.connectionTtl) {
|
|
1349
|
+
const held = await this.guard(() => this.store.hold(lease.key, lease.member, ttlMs));
|
|
1350
|
+
if (!held || held.length <= max) return true;
|
|
1351
|
+
this.release(lease);
|
|
1352
|
+
return false;
|
|
1353
|
+
}
|
|
1354
|
+
release(lease) {
|
|
1355
|
+
this.guard(() => this.store.release(lease.key, lease.member));
|
|
1356
|
+
}
|
|
1357
|
+
/**
|
|
1358
|
+
* How long a socket's place in a count outlives its process, should it
|
|
1359
|
+
* die without giving it back: three heartbeats, each of which renews it.
|
|
1360
|
+
*/
|
|
1361
|
+
get connectionTtl() {
|
|
1362
|
+
return this.heartbeatMs * 3;
|
|
1363
|
+
}
|
|
1364
|
+
/** The store's answer — or nothing, logged, when it fails. */
|
|
1365
|
+
async guard(call) {
|
|
1366
|
+
try {
|
|
1367
|
+
return await call();
|
|
1368
|
+
} catch (err) {
|
|
1369
|
+
this.options.logger?.warn({ err }, "WebSocket limit store failed; the limit was not applied");
|
|
1370
|
+
return;
|
|
1371
|
+
}
|
|
1372
|
+
}
|
|
1001
1373
|
/** Write, unless the socket has stopped reading and its queue is full. */
|
|
1002
1374
|
write(held, payload) {
|
|
1003
1375
|
const { socket } = held;
|
|
@@ -1027,8 +1399,12 @@ var WebSocketSurfaceServer = class WebSocketSurfaceServer {
|
|
|
1027
1399
|
return;
|
|
1028
1400
|
}
|
|
1029
1401
|
}
|
|
1030
|
-
/**
|
|
1402
|
+
/**
|
|
1403
|
+
* Drop every socket that missed the last ping, and ping the rest — whose
|
|
1404
|
+
* places in the limits' counts are renewed.
|
|
1405
|
+
*/
|
|
1031
1406
|
beat() {
|
|
1407
|
+
const renewed = [];
|
|
1032
1408
|
for (const [id, held] of this.held) {
|
|
1033
1409
|
if (!held.alive) {
|
|
1034
1410
|
held.socket.terminate();
|
|
@@ -1037,7 +1413,9 @@ var WebSocketSurfaceServer = class WebSocketSurfaceServer {
|
|
|
1037
1413
|
}
|
|
1038
1414
|
held.alive = false;
|
|
1039
1415
|
held.socket.ping();
|
|
1416
|
+
renewed.push(...held.leases);
|
|
1040
1417
|
}
|
|
1418
|
+
if (renewed.length > 0) this.guard(() => this.store.renew(renewed, this.connectionTtl));
|
|
1041
1419
|
}
|
|
1042
1420
|
/**
|
|
1043
1421
|
* Stop: refuse new upgrades, close every socket with `code` — 1012 tells
|
|
@@ -1062,16 +1440,6 @@ var WebSocketSurfaceServer = class WebSocketSurfaceServer {
|
|
|
1062
1440
|
this.wss.close();
|
|
1063
1441
|
}
|
|
1064
1442
|
};
|
|
1065
|
-
/**
|
|
1066
|
-
* The origins a client of the surface's own address sends: the `https://`
|
|
1067
|
-
* one a native socket derives from `wss://`, and the address's own.
|
|
1068
|
-
*/
|
|
1069
|
-
function ownOrigins(url) {
|
|
1070
|
-
if (!url || !URL.canParse(url)) return [];
|
|
1071
|
-
const own = new URL(url);
|
|
1072
|
-
const web = new URL(url.replace(/^ws(s?):/i, "http$1:"));
|
|
1073
|
-
return [.../* @__PURE__ */ new Set([`${own.protocol}//${own.host}`, web.origin])];
|
|
1074
|
-
}
|
|
1075
1443
|
/** A binary frame's bytes, however `ws` delivered them. */
|
|
1076
1444
|
function bytesOf(raw) {
|
|
1077
1445
|
if (Array.isArray(raw)) return Buffer.concat(raw);
|
|
@@ -1085,8 +1453,15 @@ function headersOf(request) {
|
|
|
1085
1453
|
}
|
|
1086
1454
|
return headers;
|
|
1087
1455
|
}
|
|
1088
|
-
function refuse(socket, status, message) {
|
|
1089
|
-
if (!socket.destroyed)
|
|
1456
|
+
function refuse(socket, status, message, headers = {}) {
|
|
1457
|
+
if (!socket.destroyed) {
|
|
1458
|
+
const extra = Object.entries(headers).map(([name, value]) => `${name}: ${value}\r\n`).join("");
|
|
1459
|
+
socket.end(`HTTP/1.1 ${status} ${message}\r\n${extra}Connection: close\r\nContent-Length: 0\r\n\r\n`);
|
|
1460
|
+
}
|
|
1461
|
+
}
|
|
1462
|
+
/** 429 — with when to come back, where a window says. */
|
|
1463
|
+
function tooMany(socket, retryAfterMs) {
|
|
1464
|
+
refuse(socket, 429, "Too Many Requests", retryAfterMs === void 0 ? {} : { "Retry-After": String(Math.max(1, Math.ceil(retryAfterMs / 1e3))) });
|
|
1090
1465
|
}
|
|
1091
1466
|
//#endregion
|
|
1092
1467
|
//#region src/websocket-api.ts
|
|
@@ -1114,6 +1489,8 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1114
1489
|
* `discriminator`. What a client of the surface decodes by.
|
|
1115
1490
|
*/
|
|
1116
1491
|
frame;
|
|
1492
|
+
/** What one client may ask of it, defaults filled in. */
|
|
1493
|
+
limits;
|
|
1117
1494
|
/**
|
|
1118
1495
|
* The surface as a dependency: `services.<id>` is its publisher, so an
|
|
1119
1496
|
* endpoint sends to a socket the way a route beside it does.
|
|
@@ -1129,6 +1506,7 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1129
1506
|
const frame = new FrameShape(canonical, config.frame?.discriminator);
|
|
1130
1507
|
if (config.messages) frame.check(config.messages);
|
|
1131
1508
|
this.frame = config.frame ? { discriminator: config.frame.discriminator } : {};
|
|
1509
|
+
this.limits = resolveLimits(canonical, config.limits);
|
|
1132
1510
|
this.keys = {
|
|
1133
1511
|
url: provideKey(canonical, "url"),
|
|
1134
1512
|
trustedOrigins: provideKey(canonical, "trustedOrigins"),
|
|
@@ -1142,14 +1520,11 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1142
1520
|
} : void 0);
|
|
1143
1521
|
const envVar = this.keys.publisherConnectionString;
|
|
1144
1522
|
const channel = channelOf(canonical);
|
|
1145
|
-
const declared = this.declared;
|
|
1146
1523
|
this.service = {
|
|
1147
1524
|
serviceName: serviceKey(canonical),
|
|
1148
|
-
async
|
|
1525
|
+
register: async ({ envParser }) => {
|
|
1149
1526
|
const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
|
|
1150
|
-
|
|
1151
|
-
onShutdown(() => transport.close());
|
|
1152
|
-
return new WebSocketPublisher(new TransportSink(transport), declared, frame);
|
|
1527
|
+
return this.publisher(await sinkFromConnectionString(connectionString, channel));
|
|
1153
1528
|
}
|
|
1154
1529
|
};
|
|
1155
1530
|
}
|
|
@@ -1182,7 +1557,7 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1182
1557
|
* closed with 1012 when the server shuts down.
|
|
1183
1558
|
*/
|
|
1184
1559
|
async server(options) {
|
|
1185
|
-
const { Hono } = await
|
|
1560
|
+
const { Hono } = await loadHono("A WebSocketApi");
|
|
1186
1561
|
const { connectionString, origins, url } = options.envParser.create((get) => ({
|
|
1187
1562
|
connectionString: get(this.keys.publisherConnectionString).string().default(`memory://${channelOf(this.id)}`),
|
|
1188
1563
|
origins: get(this.keys.trustedOrigins).string().default("").transform((value) => value.split(",").map((origin) => origin.trim()).filter(Boolean)),
|
|
@@ -1196,6 +1571,9 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1196
1571
|
}),
|
|
1197
1572
|
transport: await transportFromConnectionString(connectionString, channelOf(this.id)),
|
|
1198
1573
|
trustedOrigins: origins,
|
|
1574
|
+
...this.config.requireOrigin ? { requireOrigin: true } : {},
|
|
1575
|
+
limits: this.limits,
|
|
1576
|
+
logger: this.logger,
|
|
1199
1577
|
...url ? { url } : {},
|
|
1200
1578
|
...this.config.heartbeat ? { heartbeatMs: this.config.heartbeat * 1e3 } : {},
|
|
1201
1579
|
...this.config.maxPayload ? { maxPayload: this.config.maxPayload } : {}
|
|
@@ -1268,6 +1646,18 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1268
1646
|
testPublisher() {
|
|
1269
1647
|
return new TestWebSocketPublisher(new FrameShape(this.id, this.config.frame?.discriminator), this.declared);
|
|
1270
1648
|
}
|
|
1649
|
+
/**
|
|
1650
|
+
* The per-address limits the edge in front of it enforces too, so a
|
|
1651
|
+
* flood is refused before it reaches a replica.
|
|
1652
|
+
*/
|
|
1653
|
+
get edgeLimits() {
|
|
1654
|
+
const { handshakesPerMinute, connectionsPerIp } = this.limits;
|
|
1655
|
+
if (!handshakesPerMinute && !connectionsPerIp) return void 0;
|
|
1656
|
+
return {
|
|
1657
|
+
...handshakesPerMinute ? { handshakesPerMinute } : {},
|
|
1658
|
+
...connectionsPerIp ? { connectionsPerIp } : {}
|
|
1659
|
+
};
|
|
1660
|
+
}
|
|
1271
1661
|
/** The declared messages, with the surface they are checked for. */
|
|
1272
1662
|
get declared() {
|
|
1273
1663
|
return this.config.messages ? {
|
|
@@ -1281,9 +1671,11 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1281
1671
|
id: this.id,
|
|
1282
1672
|
path: this.config.path,
|
|
1283
1673
|
...this.config.subdomain ? { subdomain: this.config.subdomain } : {},
|
|
1674
|
+
...this.config.frame?.discriminator ? { discriminator: this.config.frame.discriminator } : {},
|
|
1284
1675
|
...this.authenticator ? { auth: edgeTo(this.authenticator) } : {},
|
|
1285
1676
|
...this.config.telemetry ? { telemetry: this.config.telemetry.id } : {},
|
|
1286
1677
|
...this.config.replicas && this.config.replicas > 1 ? { replicas: this.config.replicas } : {},
|
|
1678
|
+
...this.edgeLimits ? { limits: this.edgeLimits } : {},
|
|
1287
1679
|
provides: [
|
|
1288
1680
|
this.keys.url,
|
|
1289
1681
|
this.keys.trustedOrigins,
|
|
@@ -1292,11 +1684,28 @@ var WebSocketApi = class WebSocketApi {
|
|
|
1292
1684
|
}];
|
|
1293
1685
|
}
|
|
1294
1686
|
};
|
|
1687
|
+
/**
|
|
1688
|
+
* Where `services.<surface>` sends, by the publisher string's scheme: on an
|
|
1689
|
+
* AWS stage (`apigateway://`) the gateway's management API, which holds every
|
|
1690
|
+
* socket; anywhere else (`redis://`, `memory://`) whichever process does.
|
|
1691
|
+
*
|
|
1692
|
+
* The API Gateway sink is loaded only for its scheme, so a server stage never
|
|
1693
|
+
* resolves it — nor the AWS SDK it loads in turn.
|
|
1694
|
+
*/
|
|
1695
|
+
async function sinkFromConnectionString(connectionString, channel) {
|
|
1696
|
+
if (connectionString.startsWith(API_GATEWAY_WEBSOCKET_SCHEME)) {
|
|
1697
|
+
const { apiGatewayFromConnectionString } = await import("./apigateway-Dyjy_JwI.mjs").then((n) => n.s);
|
|
1698
|
+
return apiGatewayFromConnectionString(connectionString).sink;
|
|
1699
|
+
}
|
|
1700
|
+
const transport = await transportFromConnectionString(connectionString, channel);
|
|
1701
|
+
onShutdown(() => transport.close());
|
|
1702
|
+
return new TransportSink(transport);
|
|
1703
|
+
}
|
|
1295
1704
|
/** The prefix a surface's channels are named under. */
|
|
1296
1705
|
function channelOf(id) {
|
|
1297
1706
|
return `gkm:ws:${id}`;
|
|
1298
1707
|
}
|
|
1299
1708
|
//#endregion
|
|
1300
|
-
export { WebSocketMessageNotAnObject as C,
|
|
1709
|
+
export { WebSocketMessageNotAnObject as A, WebSocketCore as C, WebSocketDataHasDiscriminator as D, WebSocketPublisher as E, WebSocketDataNotAnObject as O, DuplicateWebSocketRoute as S, UnknownWebSocketMessage as T, LIMIT_CLOSE as _, MemoryTransport as a, TokenBucket as b, UnsupportedWebSocketTransport as c, WebSocketRouteBuilder as d, InvalidWebSocketRequest as f, InvalidWebSocketLimit as g, DEFAULT_WEBSOCKET_LIMITS as h, WebSocketSurfaceServer as i, WebSocketMessageDeclaresDiscriminator as k, transportFromConnectionString as l, TestWebSocketPublisher as m, WebSocketApi as n, RedisTransport as o, RecordingSink as p, CLOSE as r, TransportSink as s, InvalidReplicaCount as t, WebSocketRoute as u, MemoryLimitStore as v, InvalidWebSocketMessage as w, resolveLimits as x, RedisLimitStore as y };
|
|
1301
1710
|
|
|
1302
|
-
//# sourceMappingURL=websocket-api-
|
|
1711
|
+
//# sourceMappingURL=websocket-api-BvKS9x-l.mjs.map
|