@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.
Files changed (220) hide show
  1. package/README.md +23 -0
  2. package/dist/{Construct-DorKS0Ua.cjs → Construct-B8yWxGlR.cjs} +2 -2
  3. package/dist/{Construct-DorKS0Ua.cjs.map → Construct-B8yWxGlR.cjs.map} +1 -1
  4. package/dist/{Construct-DySlwh8o.d.mts → Construct-BMk_CRSD.d.mts} +2 -2
  5. package/dist/{Construct-DySlwh8o.d.mts.map → Construct-BMk_CRSD.d.mts.map} +1 -1
  6. package/dist/{Construct-CGuc_Ijk.mjs → Construct-CRV3RN2U.mjs} +11 -2
  7. package/dist/{Construct-CGuc_Ijk.mjs.map → Construct-CRV3RN2U.mjs.map} +1 -1
  8. package/dist/{Cron-D8mB_cPX.d.mts → Cron-D6Y7BBt3.d.mts} +5 -5
  9. package/dist/{Cron-D8mB_cPX.d.mts.map → Cron-D6Y7BBt3.d.mts.map} +1 -1
  10. package/dist/{CronBuilder-Cmajva3g.d.mts → CronBuilder-4BZhkChG.d.mts} +5 -5
  11. package/dist/{CronBuilder-Cmajva3g.d.mts.map → CronBuilder-4BZhkChG.d.mts.map} +1 -1
  12. package/dist/{CronBuilder-B_NSP-Y5.cjs → CronBuilder-B4DYaEjl.cjs} +4 -4
  13. package/dist/{CronBuilder-B_NSP-Y5.cjs.map → CronBuilder-B4DYaEjl.cjs.map} +1 -1
  14. package/dist/{CronBuilder-BJ5LoadF.mjs → CronBuilder-CukJuL3b.mjs} +3 -3
  15. package/dist/{CronBuilder-BJ5LoadF.mjs.map → CronBuilder-CukJuL3b.mjs.map} +1 -1
  16. package/dist/{Endpoint-BbHh3Qoc.d.mts → Endpoint-BUoDD96P.d.mts} +5 -5
  17. package/dist/{Endpoint-BbHh3Qoc.d.mts.map → Endpoint-BUoDD96P.d.mts.map} +1 -1
  18. package/dist/{Endpoint-sUOU7uLx.mjs → Endpoint-BuKHHVZc.mjs} +3 -3
  19. package/dist/{Endpoint-sUOU7uLx.mjs.map → Endpoint-BuKHHVZc.mjs.map} +1 -1
  20. package/dist/{Endpoint-52z1P0Ue.cjs → Endpoint-D2ckHqIx.cjs} +3 -3
  21. package/dist/{Endpoint-52z1P0Ue.cjs.map → Endpoint-D2ckHqIx.cjs.map} +1 -1
  22. package/dist/{EndpointFactory-qcLzi4f-.d.mts → EndpointFactory-BbVOeryo.d.mts} +5 -5
  23. package/dist/{EndpointFactory-qcLzi4f-.d.mts.map → EndpointFactory-BbVOeryo.d.mts.map} +1 -1
  24. package/dist/{EndpointFactory-Bzi9Sl7r.mjs → EndpointFactory-BsJUlUyL.mjs} +4 -4
  25. package/dist/{EndpointFactory-Bzi9Sl7r.mjs.map → EndpointFactory-BsJUlUyL.mjs.map} +1 -1
  26. package/dist/{EndpointFactory-Cf_Cs1ym.cjs → EndpointFactory-c4tHjQKM.cjs} +5 -5
  27. package/dist/{EndpointFactory-Cf_Cs1ym.cjs.map → EndpointFactory-c4tHjQKM.cjs.map} +1 -1
  28. package/dist/{Function-DfMzTGS4.d.mts → Function-BKReud5p.d.mts} +3 -3
  29. package/dist/{Function-DfMzTGS4.d.mts.map → Function-BKReud5p.d.mts.map} +1 -1
  30. package/dist/{HonoEndpointAdaptor-DR3j7S35.mjs → HonoEndpointAdaptor-BC7CZ7Cr.mjs} +7 -6
  31. package/dist/HonoEndpointAdaptor-BC7CZ7Cr.mjs.map +1 -0
  32. package/dist/{HonoEndpointAdaptor-BXBdb2Bt.cjs → HonoEndpointAdaptor-BGEW1Tu8.cjs} +9 -8
  33. package/dist/HonoEndpointAdaptor-BGEW1Tu8.cjs.map +1 -0
  34. package/dist/{ObjectSubscriberBuilder-Cv8C7yS1.d.mts → ObjectSubscriberBuilder-DfzXQEKW.d.mts} +4 -4
  35. package/dist/{ObjectSubscriberBuilder-Cv8C7yS1.d.mts.map → ObjectSubscriberBuilder-DfzXQEKW.d.mts.map} +1 -1
  36. package/dist/ObjectSubscriberBuilder-LWkey_oq.d.cts.map +1 -1
  37. package/dist/{ProcessorBuilder-CwfP-M33.d.mts → ProcessorBuilder-D4oYvZeG.d.mts} +2 -2
  38. package/dist/{ProcessorBuilder-CwfP-M33.d.mts.map → ProcessorBuilder-D4oYvZeG.d.mts.map} +1 -1
  39. package/dist/{Queue-u8w8_HpE.mjs → Queue-0FpvxdOa.mjs} +2 -2
  40. package/dist/{Queue-u8w8_HpE.mjs.map → Queue-0FpvxdOa.mjs.map} +1 -1
  41. package/dist/{Queue-BnK3UH8r.d.mts → Queue-B8HGg439.d.mts} +3 -3
  42. package/dist/{Queue-BnK3UH8r.d.mts.map → Queue-B8HGg439.d.mts.map} +1 -1
  43. package/dist/{Queue-D4Iaidrs.cjs → Queue-DZpV13LN.cjs} +2 -2
  44. package/dist/{Queue-D4Iaidrs.cjs.map → Queue-DZpV13LN.cjs.map} +1 -1
  45. package/dist/{QueueBuilder-2wP5lEC8.mjs → QueueBuilder-Bmyay_Di.mjs} +2 -2
  46. package/dist/{QueueBuilder-2wP5lEC8.mjs.map → QueueBuilder-Bmyay_Di.mjs.map} +1 -1
  47. package/dist/{QueueBuilder-DmwFtLzQ.d.mts → QueueBuilder-CVS_qPuo.d.mts} +2 -2
  48. package/dist/{QueueBuilder-DmwFtLzQ.d.mts.map → QueueBuilder-CVS_qPuo.d.mts.map} +1 -1
  49. package/dist/{QueueBuilder-BxsZ9o5z.cjs → QueueBuilder-FXkSDah1.cjs} +2 -2
  50. package/dist/{QueueBuilder-BxsZ9o5z.cjs.map → QueueBuilder-FXkSDah1.cjs.map} +1 -1
  51. package/dist/{Subscriber-CW_Dl-YR.d.mts → Subscriber-CtQXhcL7.d.mts} +3 -3
  52. package/dist/{Subscriber-CW_Dl-YR.d.mts.map → Subscriber-CtQXhcL7.d.mts.map} +1 -1
  53. package/dist/{SubscriberBuilder-CWzKwX1p.cjs → SubscriberBuilder-Bfn-iDSk.cjs} +4 -3
  54. package/dist/SubscriberBuilder-Bfn-iDSk.cjs.map +1 -0
  55. package/dist/{SubscriberBuilder-BL_GTcwh.mjs → SubscriberBuilder-CxG1OOug.mjs} +4 -3
  56. package/dist/SubscriberBuilder-CxG1OOug.mjs.map +1 -0
  57. package/dist/{Topic-DN2gYJ-p.mjs → Topic-DoEdDgh7.mjs} +2 -2
  58. package/dist/{Topic-DN2gYJ-p.mjs.map → Topic-DoEdDgh7.mjs.map} +1 -1
  59. package/dist/{Topic-Dp9Q7Lj2.cjs → Topic-t5GhqaeT.cjs} +2 -2
  60. package/dist/{Topic-Dp9Q7Lj2.cjs.map → Topic-t5GhqaeT.cjs.map} +1 -1
  61. package/dist/adaptors/aws.cjs +28 -16
  62. package/dist/adaptors/aws.cjs.map +1 -1
  63. package/dist/adaptors/aws.d.cts +141 -0
  64. package/dist/adaptors/aws.d.cts.map +1 -1
  65. package/dist/adaptors/aws.d.mts +147 -6
  66. package/dist/adaptors/aws.d.mts.map +1 -1
  67. package/dist/adaptors/aws.mjs +21 -15
  68. package/dist/adaptors/aws.mjs.map +1 -1
  69. package/dist/adaptors/hono.cjs +1 -1
  70. package/dist/adaptors/hono.d.mts +2 -2
  71. package/dist/adaptors/hono.mjs +1 -1
  72. package/dist/adaptors/testing.cjs +25 -15
  73. package/dist/adaptors/testing.cjs.map +1 -1
  74. package/dist/adaptors/testing.d.cts +1 -1
  75. package/dist/adaptors/testing.d.cts.map +1 -1
  76. package/dist/adaptors/testing.d.mts +9 -9
  77. package/dist/adaptors/testing.d.mts.map +1 -1
  78. package/dist/adaptors/testing.mjs +21 -11
  79. package/dist/adaptors/testing.mjs.map +1 -1
  80. package/dist/apigateway-Dyjy_JwI.mjs +329 -0
  81. package/dist/apigateway-Dyjy_JwI.mjs.map +1 -0
  82. package/dist/apigateway-zHDoMwlI.cjs +370 -0
  83. package/dist/apigateway-zHDoMwlI.cjs.map +1 -0
  84. package/dist/auth-BqWz2JxC.d.cts.map +1 -1
  85. package/dist/auth-DnB9H9KL.d.mts.map +1 -1
  86. package/dist/auth.cjs +7 -21
  87. package/dist/auth.cjs.map +1 -1
  88. package/dist/auth.mjs +6 -20
  89. package/dist/auth.mjs.map +1 -1
  90. package/dist/{cache-e3tfMQ9g.d.mts → cache-CCHcO9Oo.d.mts} +2 -2
  91. package/dist/cache-CCHcO9Oo.d.mts.map +1 -0
  92. package/dist/cache-CQjMNPrC.d.cts.map +1 -1
  93. package/dist/cache.cjs +3 -19
  94. package/dist/cache.cjs.map +1 -1
  95. package/dist/cache.d.mts +1 -1
  96. package/dist/cache.mjs +2 -18
  97. package/dist/cache.mjs.map +1 -1
  98. package/dist/crons/index.cjs +4 -3
  99. package/dist/crons/index.cjs.map +1 -1
  100. package/dist/crons/index.d.cts.map +1 -1
  101. package/dist/crons/index.d.mts +2 -2
  102. package/dist/crons/index.d.mts.map +1 -1
  103. package/dist/crons/index.mjs +4 -3
  104. package/dist/crons/index.mjs.map +1 -1
  105. package/dist/database/kysely.cjs +1 -1
  106. package/dist/database/kysely.d.mts +1 -1
  107. package/dist/email.cjs +4 -16
  108. package/dist/email.cjs.map +1 -1
  109. package/dist/email.d.cts.map +1 -1
  110. package/dist/email.d.mts.map +1 -1
  111. package/dist/email.mjs +2 -14
  112. package/dist/email.mjs.map +1 -1
  113. package/dist/endpoints/index.cjs +4 -4
  114. package/dist/endpoints/index.d.cts +1 -1
  115. package/dist/endpoints/index.d.cts.map +1 -1
  116. package/dist/endpoints/index.d.mts +4 -4
  117. package/dist/endpoints/index.d.mts.map +1 -1
  118. package/dist/endpoints/index.mjs +4 -4
  119. package/dist/file-server.cjs +1 -1
  120. package/dist/file-server.d.mts +1 -1
  121. package/dist/file-server.mjs +1 -1
  122. package/dist/functions/index.cjs +1 -1
  123. package/dist/functions/index.d.mts +2 -2
  124. package/dist/functions/index.mjs +1 -1
  125. package/dist/{functions-BvIDQKAA.mjs → functions-BF039DT8.mjs} +2 -2
  126. package/dist/{functions-BvIDQKAA.mjs.map → functions-BF039DT8.mjs.map} +1 -1
  127. package/dist/{functions-DLF6-IK8.cjs → functions-BqAq_0xQ.cjs} +3 -3
  128. package/dist/{functions-DLF6-IK8.cjs.map → functions-BqAq_0xQ.cjs.map} +1 -1
  129. package/dist/{inbox-CjxpLVkH.d.mts → inbox-YOdxlyfj.d.mts} +2 -2
  130. package/dist/{inbox-CjxpLVkH.d.mts.map → inbox-YOdxlyfj.d.mts.map} +1 -1
  131. package/dist/inbox.cjs +1 -1
  132. package/dist/inbox.d.mts +1 -1
  133. package/dist/inbox.mjs +1 -1
  134. package/dist/{index-DCkDQkwj.d.mts → index-BoQ3-M-K.d.mts} +4 -4
  135. package/dist/{index-DCkDQkwj.d.mts.map → index-BoQ3-M-K.d.mts.map} +1 -1
  136. package/dist/index.cjs +1 -1
  137. package/dist/index.d.mts +1 -1
  138. package/dist/index.mjs +1 -1
  139. package/dist/{kysely-CukArHJ0.cjs → kysely-CeoQdAkg.cjs} +2 -2
  140. package/dist/{kysely-CukArHJ0.cjs.map → kysely-CeoQdAkg.cjs.map} +1 -1
  141. package/dist/{kysely-DE4kADWD.d.mts → kysely-De5rAC-E.d.mts} +2 -2
  142. package/dist/{kysely-DE4kADWD.d.mts.map → kysely-De5rAC-E.d.mts.map} +1 -1
  143. package/dist/optionalPeers-D7Wt6dnF.mjs +140 -0
  144. package/dist/optionalPeers-D7Wt6dnF.mjs.map +1 -0
  145. package/dist/optionalPeers-DuNQXXe1.cjs +223 -0
  146. package/dist/optionalPeers-DuNQXXe1.cjs.map +1 -0
  147. package/dist/origins-C7T9covD.cjs +24 -0
  148. package/dist/origins-C7T9covD.cjs.map +1 -0
  149. package/dist/origins-CX6Ot7ax.mjs +19 -0
  150. package/dist/origins-CX6Ot7ax.mjs.map +1 -0
  151. package/dist/{pattern-QFaUIr77.cjs → pattern-HnNOPhE2.cjs} +2 -2
  152. package/dist/{pattern-QFaUIr77.cjs.map → pattern-HnNOPhE2.cjs.map} +1 -1
  153. package/dist/{pattern-C1CEcglD.mjs → pattern-YSqfAhXm.mjs} +2 -2
  154. package/dist/{pattern-C1CEcglD.mjs.map → pattern-YSqfAhXm.mjs.map} +1 -1
  155. package/dist/privateAddress-Bg5fUsbp.mjs +21 -0
  156. package/dist/privateAddress-Bg5fUsbp.mjs.map +1 -0
  157. package/dist/privateAddress-CqGyuFHn.cjs +26 -0
  158. package/dist/privateAddress-CqGyuFHn.cjs.map +1 -0
  159. package/dist/processors/index.cjs +1 -1
  160. package/dist/processors/index.d.mts +1 -1
  161. package/dist/processors/index.mjs +1 -1
  162. package/dist/queue/index.cjs +2 -2
  163. package/dist/queue/index.d.mts +2 -2
  164. package/dist/queue/index.mjs +2 -2
  165. package/dist/{readRequestBody-BTIl3k-D.mjs → readRequestBody-BmKnPl0a.mjs} +26 -4
  166. package/dist/readRequestBody-BmKnPl0a.mjs.map +1 -0
  167. package/dist/{readRequestBody-Dej_L3c4.cjs → readRequestBody-CN9GVdeE.cjs} +26 -4
  168. package/dist/readRequestBody-CN9GVdeE.cjs.map +1 -0
  169. package/dist/{requestLogger-BZcXwdBs.cjs → requestLogger-CnoYd-Ah.cjs} +4 -63
  170. package/dist/requestLogger-CnoYd-Ah.cjs.map +1 -0
  171. package/dist/{requestLogger-pA4gi3E1.mjs → requestLogger-D2JS7pPM.mjs} +3 -56
  172. package/dist/requestLogger-D2JS7pPM.mjs.map +1 -0
  173. package/dist/rest-api.cjs +1 -1
  174. package/dist/rest-api.d.mts +2 -2
  175. package/dist/rest-api.mjs +1 -1
  176. package/dist/{rolldown-runtime-y5ARvAq5.cjs → rolldown-runtime-Ctb5zv51.cjs} +15 -0
  177. package/dist/{runSubscriber-DyHWp_Lf.mjs → runSubscriber-HEqXkin1.mjs} +3 -2
  178. package/dist/runSubscriber-HEqXkin1.mjs.map +1 -0
  179. package/dist/{runSubscriber-CC_2C9F2.cjs → runSubscriber-sVJfLA0-.cjs} +3 -2
  180. package/dist/runSubscriber-sVJfLA0-.cjs.map +1 -0
  181. package/dist/subscribers/index.cjs +6 -6
  182. package/dist/subscribers/index.cjs.map +1 -1
  183. package/dist/subscribers/index.d.cts +1 -1
  184. package/dist/subscribers/index.d.mts +3 -3
  185. package/dist/subscribers/index.mjs +3 -3
  186. package/dist/subscribers/index.mjs.map +1 -1
  187. package/dist/topic/index.cjs +1 -1
  188. package/dist/topic/index.d.mts +1 -1
  189. package/dist/topic/index.mjs +1 -1
  190. package/dist/{websocket-api-Dn_3Y2fI.mjs → websocket-api-BvKS9x-l.mjs} +453 -44
  191. package/dist/websocket-api-BvKS9x-l.mjs.map +1 -0
  192. package/dist/{websocket-api-CLnV_7CB.d.cts → websocket-api-C3dWKNxO.d.cts} +481 -208
  193. package/dist/websocket-api-C3dWKNxO.d.cts.map +1 -0
  194. package/dist/{websocket-api-9bXfgrqd.cjs → websocket-api-CAQA_QOE.cjs} +494 -43
  195. package/dist/websocket-api-CAQA_QOE.cjs.map +1 -0
  196. package/dist/{websocket-api-DSWDhZph.d.mts → websocket-api-CDAxOTQZ.d.mts} +481 -208
  197. package/dist/websocket-api-CDAxOTQZ.d.mts.map +1 -0
  198. package/dist/websocket-api.cjs +8 -1
  199. package/dist/websocket-api.d.cts +2 -2
  200. package/dist/websocket-api.d.mts +2 -2
  201. package/dist/websocket-api.mjs +2 -2
  202. package/dist/worker.cjs +4 -4
  203. package/dist/worker.d.mts +9 -9
  204. package/dist/worker.mjs +4 -4
  205. package/package.json +41 -31
  206. package/dist/HonoEndpointAdaptor-BXBdb2Bt.cjs.map +0 -1
  207. package/dist/HonoEndpointAdaptor-DR3j7S35.mjs.map +0 -1
  208. package/dist/SubscriberBuilder-BL_GTcwh.mjs.map +0 -1
  209. package/dist/SubscriberBuilder-CWzKwX1p.cjs.map +0 -1
  210. package/dist/cache-e3tfMQ9g.d.mts.map +0 -1
  211. package/dist/readRequestBody-BTIl3k-D.mjs.map +0 -1
  212. package/dist/readRequestBody-Dej_L3c4.cjs.map +0 -1
  213. package/dist/requestLogger-BZcXwdBs.cjs.map +0 -1
  214. package/dist/requestLogger-pA4gi3E1.mjs.map +0 -1
  215. package/dist/runSubscriber-CC_2C9F2.cjs.map +0 -1
  216. package/dist/runSubscriber-DyHWp_Lf.mjs.map +0 -1
  217. package/dist/websocket-api-9bXfgrqd.cjs.map +0 -1
  218. package/dist/websocket-api-CLnV_7CB.d.cts.map +0 -1
  219. package/dist/websocket-api-DSWDhZph.d.mts.map +0 -1
  220. 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 { canonicalId, provideKey, serviceKey, trustsOrigin } from "@geekmidas/manifest";
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 import("ioredis");
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 — and hands the rest to the surface's
901
- * `WebSocketCore`: a handshake to `connect()`, each frame to `message()`, a
902
- * close to `disconnect()`. The HTTP server is whatever the entry started —
903
- * the generated one serves `/health` on the same port — and this attaches to
904
- * its `upgrade` event.
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.core = options.core(new TransportSink(options.transport, {
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.heartbeat = setInterval(() => this.beat(), options.heartbeatMs ?? 3e4);
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 import("ws");
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
- /** Upgrade one request, or refuse it with a status line. */
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 && !trustsOrigin(origin, this.trusted)) return refuse(socket, 403, "Forbidden");
968
- const outcome = await this.core.connect({
969
- connectionId: `${this.instance}.${(this.next++).toString(36)}`,
970
- headers: headersOf(request),
971
- query: new URL(request.url ?? "/", "http://localhost").searchParams
972
- });
973
- if (!outcome.accepted) return refuse(socket, outcome.status, outcome.statusText);
974
- if (socket.destroyed) return;
975
- this.wss.handleUpgrade(request, socket, head, (ws) => this.open(ws, outcome.connection));
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
- /** Drop every socket that missed the last ping, and ping the rest. */
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) socket.end(`HTTP/1.1 ${status} ${message}\r\nConnection: close\r\nContent-Length: 0\r\n\r\n`);
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 register({ envParser }) {
1525
+ register: async ({ envParser }) => {
1149
1526
  const { connectionString } = envParser.create((get) => ({ connectionString: get(envVar).string() })).parse();
1150
- const transport = await transportFromConnectionString(connectionString, channel);
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 import("hono");
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, WebSocketMessageDeclaresDiscriminator as S, InvalidWebSocketMessage as _, MemoryTransport as a, WebSocketDataHasDiscriminator as b, UnsupportedWebSocketTransport as c, WebSocketRouteBuilder as d, InvalidWebSocketRequest as f, WebSocketCore as g, DuplicateWebSocketRoute as h, WebSocketSurfaceServer as i, 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, UnknownWebSocketMessage as v, WebSocketDataNotAnObject as x, WebSocketPublisher as y };
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-Dn_3Y2fI.mjs.map
1711
+ //# sourceMappingURL=websocket-api-BvKS9x-l.mjs.map