heliumts 0.9.6 → 0.10.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
Files changed (81) hide show
  1. package/README.md +39 -14
  2. package/dist/bin/helium.js +19 -10
  3. package/dist/bin/helium.js.map +1 -1
  4. package/dist/client/Router.d.ts.map +1 -1
  5. package/dist/client/Router.js +2 -4
  6. package/dist/client/Router.js.map +1 -1
  7. package/dist/client/callMethod.d.ts +8 -0
  8. package/dist/client/callMethod.d.ts.map +1 -0
  9. package/dist/client/callMethod.js +9 -0
  10. package/dist/client/callMethod.js.map +1 -0
  11. package/dist/client/index.d.ts +3 -2
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js +2 -1
  14. package/dist/client/index.js.map +1 -1
  15. package/dist/client/rpcClient.d.ts +7 -37
  16. package/dist/client/rpcClient.d.ts.map +1 -1
  17. package/dist/client/rpcClient.js +118 -749
  18. package/dist/client/rpcClient.js.map +1 -1
  19. package/dist/client/rpcStreaming.d.ts +10 -0
  20. package/dist/client/rpcStreaming.d.ts.map +1 -0
  21. package/dist/client/rpcStreaming.js +125 -0
  22. package/dist/client/rpcStreaming.js.map +1 -0
  23. package/dist/client/useStreaming.d.ts +26 -0
  24. package/dist/client/useStreaming.d.ts.map +1 -0
  25. package/dist/client/useStreaming.js +126 -0
  26. package/dist/client/useStreaming.js.map +1 -0
  27. package/dist/runtime/protocol.d.ts +14 -0
  28. package/dist/runtime/protocol.d.ts.map +1 -1
  29. package/dist/runtime/protocol.js +3 -1
  30. package/dist/runtime/protocol.js.map +1 -1
  31. package/dist/server/config.d.ts +16 -101
  32. package/dist/server/config.d.ts.map +1 -1
  33. package/dist/server/config.js +5 -27
  34. package/dist/server/config.js.map +1 -1
  35. package/dist/server/context.d.ts +8 -6
  36. package/dist/server/context.d.ts.map +1 -1
  37. package/dist/server/context.js.map +1 -1
  38. package/dist/server/defineWorker.d.ts +1 -1
  39. package/dist/server/defineWorker.d.ts.map +1 -1
  40. package/dist/server/defineWorker.js +2 -1
  41. package/dist/server/defineWorker.js.map +1 -1
  42. package/dist/server/devServer.d.ts +1 -1
  43. package/dist/server/devServer.d.ts.map +1 -1
  44. package/dist/server/devServer.js +13 -250
  45. package/dist/server/devServer.js.map +1 -1
  46. package/dist/server/httpCompression.d.ts +8 -0
  47. package/dist/server/httpCompression.d.ts.map +1 -0
  48. package/dist/server/httpCompression.js +58 -0
  49. package/dist/server/httpCompression.js.map +1 -0
  50. package/dist/server/httpRouter.d.ts.map +1 -1
  51. package/dist/server/httpRouter.js +5 -2
  52. package/dist/server/httpRouter.js.map +1 -1
  53. package/dist/server/httpRpc.d.ts +10 -0
  54. package/dist/server/httpRpc.d.ts.map +1 -0
  55. package/dist/server/httpRpc.js +186 -0
  56. package/dist/server/httpRpc.js.map +1 -0
  57. package/dist/server/prodServer.d.ts +3 -1
  58. package/dist/server/prodServer.d.ts.map +1 -1
  59. package/dist/server/prodServer.js +36 -229
  60. package/dist/server/prodServer.js.map +1 -1
  61. package/dist/server/rateLimiter.d.ts +6 -36
  62. package/dist/server/rateLimiter.d.ts.map +1 -1
  63. package/dist/server/rateLimiter.js +18 -125
  64. package/dist/server/rateLimiter.js.map +1 -1
  65. package/dist/server/requestSignal.d.ts +10 -0
  66. package/dist/server/requestSignal.d.ts.map +1 -0
  67. package/dist/server/requestSignal.js +79 -0
  68. package/dist/server/requestSignal.js.map +1 -0
  69. package/dist/server/rpcRegistry.d.ts +10 -18
  70. package/dist/server/rpcRegistry.d.ts.map +1 -1
  71. package/dist/server/rpcRegistry.js +181 -269
  72. package/dist/server/rpcRegistry.js.map +1 -1
  73. package/dist/server/serializer.js +12 -6
  74. package/dist/server/serializer.js.map +1 -1
  75. package/dist/vite/heliumPlugin.d.ts.map +1 -1
  76. package/dist/vite/heliumPlugin.js +77 -43
  77. package/dist/vite/heliumPlugin.js.map +1 -1
  78. package/dist/vite/ssg.d.ts.map +1 -1
  79. package/dist/vite/ssg.js +20 -1
  80. package/dist/vite/ssg.js.map +1 -1
  81. package/package.json +2 -4
@@ -1,41 +1,11 @@
1
- import type WebSocket from "ws";
1
+ /** Share a fixed request window per client IP across unary and streaming RPC. */
2
2
  export declare class RateLimiter {
3
- private connections;
4
- private ipConnections;
5
- private httpRequests;
6
- private lastHttpCleanup;
7
- private maxMessagesPerWindow;
3
+ private maxRequestsPerWindow;
8
4
  private rateLimitWindowMs;
9
- private maxConnectionsPerIP;
10
- constructor(maxMessagesPerWindow: number, rateLimitWindowMs: number, maxConnectionsPerIP: number);
11
- configure(maxMessagesPerWindow: number, rateLimitWindowMs: number, maxConnectionsPerIP: number): void;
12
- /**
13
- * Track a new WebSocket connection.
14
- * Returns false if the IP has exceeded the connection limit.
15
- */
16
- trackConnection(socket: WebSocket, ip: string): boolean;
17
- /**
18
- * Untrack a connection when it closes.
19
- */
20
- untrackConnection(socket: WebSocket): void;
21
- /**
22
- * Check if a message from this connection should be allowed.
23
- * Returns true if allowed, false if rate limit exceeded.
24
- */
25
- checkRateLimit(socket: WebSocket): boolean;
26
- /**
27
- * Get current stats for a connection.
28
- */
29
- getConnectionStats(socket: WebSocket): {
30
- messageCount: number;
31
- remainingMessages: number;
32
- resetTimeMs: number;
33
- } | null;
34
- /**
35
- * Get the number of connections from a specific IP.
36
- */
37
- getIPConnectionCount(ip: string): number;
38
- /** HTTP requests have no persistent socket, so share a window per client IP. */
5
+ private httpRequests;
6
+ private lastCleanup;
7
+ constructor(maxRequestsPerWindow: number, rateLimitWindowMs: number);
8
+ configure(maxRequestsPerWindow: number, rateLimitWindowMs: number): void;
39
9
  checkHttpRateLimit(ip: string): boolean;
40
10
  getHttpStats(ip: string): {
41
11
  remainingRequests: number;
@@ -1 +1 @@
1
- {"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../src/server/rateLimiter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,IAAI,CAAC;AAQhC,qBAAa,WAAW;IACpB,OAAO,CAAC,WAAW,CAA4C;IAC/D,OAAO,CAAC,aAAa,CAAqC;IAC1D,OAAO,CAAC,YAAY,CAAoE;IACxF,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,oBAAoB,CAAS;IACrC,OAAO,CAAC,iBAAiB,CAAS;IAClC,OAAO,CAAC,mBAAmB,CAAS;gBAExB,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM;IAMhG,SAAS,CAAC,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,GAAG,IAAI;IAMrG;;;OAGG;IACH,eAAe,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO;IA8BvD;;OAEG;IACH,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI;IAc1C;;;OAGG;IACH,cAAc,CAAC,MAAM,EAAE,SAAS,GAAG,OAAO;IA8B1C;;OAEG;IACH,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,iBAAiB,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI;IAyBtH;;OAEG;IACH,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM;IAIxC,gFAAgF;IAChF,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAyBvC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;CAclF"}
1
+ {"version":3,"file":"rateLimiter.d.ts","sourceRoot":"","sources":["../../src/server/rateLimiter.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,qBAAa,WAAW;IAKhB,OAAO,CAAC,oBAAoB;IAC5B,OAAO,CAAC,iBAAiB;IAL7B,OAAO,CAAC,YAAY,CAAoE;IACxF,OAAO,CAAC,WAAW,CAAK;gBAGZ,oBAAoB,EAAE,MAAM,EAC5B,iBAAiB,EAAE,MAAM;IAGrC,SAAS,CAAC,oBAAoB,EAAE,MAAM,EAAE,iBAAiB,EAAE,MAAM,GAAG,IAAI;IAKxE,kBAAkB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAyBvC,YAAY,CAAC,EAAE,EAAE,MAAM,GAAG;QAAE,iBAAiB,EAAE,MAAM,CAAC;QAAC,cAAc,EAAE,MAAM,CAAA;KAAE;CAclF"}
@@ -1,157 +1,50 @@
1
+ /** Share a fixed request window per client IP across unary and streaming RPC. */
1
2
  export class RateLimiter {
2
- constructor(maxMessagesPerWindow, rateLimitWindowMs, maxConnectionsPerIP) {
3
- this.connections = new WeakMap();
4
- this.ipConnections = new Map();
5
- this.httpRequests = new Map();
6
- this.lastHttpCleanup = 0;
7
- this.maxMessagesPerWindow = maxMessagesPerWindow;
3
+ constructor(maxRequestsPerWindow, rateLimitWindowMs) {
4
+ this.maxRequestsPerWindow = maxRequestsPerWindow;
8
5
  this.rateLimitWindowMs = rateLimitWindowMs;
9
- this.maxConnectionsPerIP = maxConnectionsPerIP;
6
+ this.httpRequests = new Map();
7
+ this.lastCleanup = 0;
10
8
  }
11
- configure(maxMessagesPerWindow, rateLimitWindowMs, maxConnectionsPerIP) {
12
- this.maxMessagesPerWindow = maxMessagesPerWindow;
9
+ configure(maxRequestsPerWindow, rateLimitWindowMs) {
10
+ this.maxRequestsPerWindow = maxRequestsPerWindow;
13
11
  this.rateLimitWindowMs = rateLimitWindowMs;
14
- this.maxConnectionsPerIP = maxConnectionsPerIP;
15
- }
16
- /**
17
- * Track a new WebSocket connection.
18
- * Returns false if the IP has exceeded the connection limit.
19
- */
20
- trackConnection(socket, ip) {
21
- // Check if IP has too many connections
22
- if (this.maxConnectionsPerIP > 0) {
23
- const connections = this.ipConnections.get(ip);
24
- if (connections && connections.size >= this.maxConnectionsPerIP) {
25
- return false;
26
- }
27
- }
28
- // Track the connection
29
- this.connections.set(socket, {
30
- messageCount: 0,
31
- windowStart: Date.now(),
32
- ip,
33
- });
34
- // Add to IP tracking
35
- if (!this.ipConnections.has(ip)) {
36
- this.ipConnections.set(ip, new Set());
37
- }
38
- this.ipConnections.get(ip).add(socket);
39
- // Clean up when socket closes
40
- socket.on("close", () => {
41
- this.untrackConnection(socket);
42
- });
43
- return true;
44
- }
45
- /**
46
- * Untrack a connection when it closes.
47
- */
48
- untrackConnection(socket) {
49
- const info = this.connections.get(socket);
50
- if (info) {
51
- const ipSet = this.ipConnections.get(info.ip);
52
- if (ipSet) {
53
- ipSet.delete(socket);
54
- if (ipSet.size === 0) {
55
- this.ipConnections.delete(info.ip);
56
- }
57
- }
58
- this.connections.delete(socket);
59
- }
60
12
  }
61
- /**
62
- * Check if a message from this connection should be allowed.
63
- * Returns true if allowed, false if rate limit exceeded.
64
- */
65
- checkRateLimit(socket) {
66
- if (this.maxMessagesPerWindow === 0) {
67
- return true; // Rate limiting disabled
68
- }
69
- const info = this.connections.get(socket);
70
- if (!info) {
71
- return false; // Connection not tracked
72
- }
73
- const now = Date.now();
74
- const windowElapsed = now - info.windowStart;
75
- // Reset window if it has expired
76
- if (windowElapsed >= this.rateLimitWindowMs) {
77
- info.messageCount = 1;
78
- info.windowStart = now;
79
- return true;
80
- }
81
- // Check if limit exceeded
82
- if (info.messageCount >= this.maxMessagesPerWindow) {
83
- return false;
84
- }
85
- // Increment counter
86
- info.messageCount++;
87
- return true;
88
- }
89
- /**
90
- * Get current stats for a connection.
91
- */
92
- getConnectionStats(socket) {
93
- const info = this.connections.get(socket);
94
- if (!info) {
95
- return null;
96
- }
97
- const now = Date.now();
98
- const windowElapsed = now - info.windowStart;
99
- // If window expired, stats are reset
100
- if (windowElapsed >= this.rateLimitWindowMs) {
101
- return {
102
- messageCount: 0,
103
- remainingMessages: this.maxMessagesPerWindow,
104
- resetTimeMs: now + this.rateLimitWindowMs,
105
- };
106
- }
107
- return {
108
- messageCount: info.messageCount,
109
- remainingMessages: Math.max(0, this.maxMessagesPerWindow - info.messageCount),
110
- resetTimeMs: info.windowStart + this.rateLimitWindowMs,
111
- };
112
- }
113
- /**
114
- * Get the number of connections from a specific IP.
115
- */
116
- getIPConnectionCount(ip) {
117
- return this.ipConnections.get(ip)?.size ?? 0;
118
- }
119
- /** HTTP requests have no persistent socket, so share a window per client IP. */
120
13
  checkHttpRateLimit(ip) {
121
- if (this.maxMessagesPerWindow === 0) {
14
+ if (this.maxRequestsPerWindow === 0) {
122
15
  return true;
123
16
  }
124
17
  const now = Date.now();
125
- if (now - this.lastHttpCleanup >= this.rateLimitWindowMs) {
18
+ if (now - this.lastCleanup >= this.rateLimitWindowMs) {
126
19
  for (const [key, info] of this.httpRequests) {
127
20
  if (now - info.windowStart >= this.rateLimitWindowMs) {
128
21
  this.httpRequests.delete(key);
129
22
  }
130
23
  }
131
- this.lastHttpCleanup = now;
24
+ this.lastCleanup = now;
132
25
  }
133
26
  let info = this.httpRequests.get(ip);
134
27
  if (!info || now - info.windowStart >= this.rateLimitWindowMs) {
135
- info = { messageCount: 0, windowStart: now };
28
+ info = { requestCount: 0, windowStart: now };
136
29
  this.httpRequests.set(ip, info);
137
30
  }
138
- if (info.messageCount >= this.maxMessagesPerWindow) {
31
+ if (info.requestCount >= this.maxRequestsPerWindow) {
139
32
  return false;
140
33
  }
141
- info.messageCount++;
34
+ info.requestCount++;
142
35
  return true;
143
36
  }
144
37
  getHttpStats(ip) {
145
- const info = this.httpRequests.get(ip);
146
- const now = Date.now();
147
- if (this.maxMessagesPerWindow === 0) {
38
+ if (this.maxRequestsPerWindow === 0) {
148
39
  return { remainingRequests: Infinity, resetInSeconds: 0 };
149
40
  }
41
+ const info = this.httpRequests.get(ip);
42
+ const now = Date.now();
150
43
  if (!info || now - info.windowStart >= this.rateLimitWindowMs) {
151
- return { remainingRequests: this.maxMessagesPerWindow, resetInSeconds: 0 };
44
+ return { remainingRequests: this.maxRequestsPerWindow, resetInSeconds: 0 };
152
45
  }
153
46
  return {
154
- remainingRequests: Math.max(0, this.maxMessagesPerWindow - info.messageCount),
47
+ remainingRequests: Math.max(0, this.maxRequestsPerWindow - info.requestCount),
155
48
  resetInSeconds: Math.max(0, Math.ceil((info.windowStart + this.rateLimitWindowMs - now) / 1000)),
156
49
  };
157
50
  }
@@ -1 +1 @@
1
- {"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../src/server/rateLimiter.ts"],"names":[],"mappings":"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","sourcesContent":["import type WebSocket from \"ws\";\n\ninterface ConnectionInfo {\n messageCount: number;\n windowStart: number;\n ip: string;\n}\n\nexport class RateLimiter {\n private connections = new WeakMap<WebSocket, ConnectionInfo>();\n private ipConnections = new Map<string, Set<WebSocket>>();\n private httpRequests = new Map<string, { messageCount: number; windowStart: number }>();\n private lastHttpCleanup = 0;\n private maxMessagesPerWindow: number;\n private rateLimitWindowMs: number;\n private maxConnectionsPerIP: number;\n\n constructor(maxMessagesPerWindow: number, rateLimitWindowMs: number, maxConnectionsPerIP: number) {\n this.maxMessagesPerWindow = maxMessagesPerWindow;\n this.rateLimitWindowMs = rateLimitWindowMs;\n this.maxConnectionsPerIP = maxConnectionsPerIP;\n }\n\n configure(maxMessagesPerWindow: number, rateLimitWindowMs: number, maxConnectionsPerIP: number): void {\n this.maxMessagesPerWindow = maxMessagesPerWindow;\n this.rateLimitWindowMs = rateLimitWindowMs;\n this.maxConnectionsPerIP = maxConnectionsPerIP;\n }\n\n /**\n * Track a new WebSocket connection.\n * Returns false if the IP has exceeded the connection limit.\n */\n trackConnection(socket: WebSocket, ip: string): boolean {\n // Check if IP has too many connections\n if (this.maxConnectionsPerIP > 0) {\n const connections = this.ipConnections.get(ip);\n if (connections && connections.size >= this.maxConnectionsPerIP) {\n return false;\n }\n }\n\n // Track the connection\n this.connections.set(socket, {\n messageCount: 0,\n windowStart: Date.now(),\n ip,\n });\n\n // Add to IP tracking\n if (!this.ipConnections.has(ip)) {\n this.ipConnections.set(ip, new Set());\n }\n this.ipConnections.get(ip)!.add(socket);\n\n // Clean up when socket closes\n socket.on(\"close\", () => {\n this.untrackConnection(socket);\n });\n\n return true;\n }\n\n /**\n * Untrack a connection when it closes.\n */\n untrackConnection(socket: WebSocket): void {\n const info = this.connections.get(socket);\n if (info) {\n const ipSet = this.ipConnections.get(info.ip);\n if (ipSet) {\n ipSet.delete(socket);\n if (ipSet.size === 0) {\n this.ipConnections.delete(info.ip);\n }\n }\n this.connections.delete(socket);\n }\n }\n\n /**\n * Check if a message from this connection should be allowed.\n * Returns true if allowed, false if rate limit exceeded.\n */\n checkRateLimit(socket: WebSocket): boolean {\n if (this.maxMessagesPerWindow === 0) {\n return true; // Rate limiting disabled\n }\n\n const info = this.connections.get(socket);\n if (!info) {\n return false; // Connection not tracked\n }\n\n const now = Date.now();\n const windowElapsed = now - info.windowStart;\n\n // Reset window if it has expired\n if (windowElapsed >= this.rateLimitWindowMs) {\n info.messageCount = 1;\n info.windowStart = now;\n return true;\n }\n\n // Check if limit exceeded\n if (info.messageCount >= this.maxMessagesPerWindow) {\n return false;\n }\n\n // Increment counter\n info.messageCount++;\n return true;\n }\n\n /**\n * Get current stats for a connection.\n */\n getConnectionStats(socket: WebSocket): { messageCount: number; remainingMessages: number; resetTimeMs: number } | null {\n const info = this.connections.get(socket);\n if (!info) {\n return null;\n }\n\n const now = Date.now();\n const windowElapsed = now - info.windowStart;\n\n // If window expired, stats are reset\n if (windowElapsed >= this.rateLimitWindowMs) {\n return {\n messageCount: 0,\n remainingMessages: this.maxMessagesPerWindow,\n resetTimeMs: now + this.rateLimitWindowMs,\n };\n }\n\n return {\n messageCount: info.messageCount,\n remainingMessages: Math.max(0, this.maxMessagesPerWindow - info.messageCount),\n resetTimeMs: info.windowStart + this.rateLimitWindowMs,\n };\n }\n\n /**\n * Get the number of connections from a specific IP.\n */\n getIPConnectionCount(ip: string): number {\n return this.ipConnections.get(ip)?.size ?? 0;\n }\n\n /** HTTP requests have no persistent socket, so share a window per client IP. */\n checkHttpRateLimit(ip: string): boolean {\n if (this.maxMessagesPerWindow === 0) {\n return true;\n }\n const now = Date.now();\n if (now - this.lastHttpCleanup >= this.rateLimitWindowMs) {\n for (const [key, info] of this.httpRequests) {\n if (now - info.windowStart >= this.rateLimitWindowMs) {\n this.httpRequests.delete(key);\n }\n }\n this.lastHttpCleanup = now;\n }\n let info = this.httpRequests.get(ip);\n if (!info || now - info.windowStart >= this.rateLimitWindowMs) {\n info = { messageCount: 0, windowStart: now };\n this.httpRequests.set(ip, info);\n }\n if (info.messageCount >= this.maxMessagesPerWindow) {\n return false;\n }\n info.messageCount++;\n return true;\n }\n\n getHttpStats(ip: string): { remainingRequests: number; resetInSeconds: number } {\n const info = this.httpRequests.get(ip);\n const now = Date.now();\n if (this.maxMessagesPerWindow === 0) {\n return { remainingRequests: Infinity, resetInSeconds: 0 };\n }\n if (!info || now - info.windowStart >= this.rateLimitWindowMs) {\n return { remainingRequests: this.maxMessagesPerWindow, resetInSeconds: 0 };\n }\n return {\n remainingRequests: Math.max(0, this.maxMessagesPerWindow - info.messageCount),\n resetInSeconds: Math.max(0, Math.ceil((info.windowStart + this.rateLimitWindowMs - now) / 1000)),\n };\n }\n}\n"]}
1
+ {"version":3,"file":"rateLimiter.js","sourceRoot":"","sources":["../../src/server/rateLimiter.ts"],"names":[],"mappings":"AAAA,iFAAiF;AACjF,MAAM,OAAO,WAAW;IAIpB,YACY,oBAA4B,EAC5B,iBAAyB;QADzB,yBAAoB,GAApB,oBAAoB,CAAQ;QAC5B,sBAAiB,GAAjB,iBAAiB,CAAQ;QAL7B,iBAAY,GAAG,IAAI,GAAG,EAAyD,CAAC;QAChF,gBAAW,GAAG,CAAC,CAAC;IAKrB,CAAC;IAEJ,SAAS,CAAC,oBAA4B,EAAE,iBAAyB;QAC7D,IAAI,CAAC,oBAAoB,GAAG,oBAAoB,CAAC;QACjD,IAAI,CAAC,iBAAiB,GAAG,iBAAiB,CAAC;IAC/C,CAAC;IAED,kBAAkB,CAAC,EAAU;QACzB,IAAI,IAAI,CAAC,oBAAoB,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,IAAI,CAAC;QAChB,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YACnD,KAAK,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;gBAC1C,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;oBACnD,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;gBAClC,CAAC;YACL,CAAC;YACD,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QAC3B,CAAC;QACD,IAAI,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACrC,IAAI,CAAC,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5D,IAAI,GAAG,EAAE,YAAY,EAAE,CAAC,EAAE,WAAW,EAAE,GAAG,EAAE,CAAC;YAC7C,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;QACpC,CAAC;QACD,IAAI,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,oBAAoB,EAAE,CAAC;YACjD,OAAO,KAAK,CAAC;QACjB,CAAC;QACD,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,YAAY,CAAC,EAAU;QACnB,IAAI,IAAI,CAAC,oBAAoB,KAAK,CAAC,EAAE,CAAC;YAClC,OAAO,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC9D,CAAC;QACD,MAAM,IAAI,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;QACvC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QACvB,IAAI,CAAC,IAAI,IAAI,GAAG,GAAG,IAAI,CAAC,WAAW,IAAI,IAAI,CAAC,iBAAiB,EAAE,CAAC;YAC5D,OAAO,EAAE,iBAAiB,EAAE,IAAI,CAAC,oBAAoB,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;QAC/E,CAAC;QACD,OAAO;YACH,iBAAiB,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,oBAAoB,GAAG,IAAI,CAAC,YAAY,CAAC;YAC7E,cAAc,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,iBAAiB,GAAG,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;SACnG,CAAC;IACN,CAAC;CACJ","sourcesContent":["/** Share a fixed request window per client IP across unary and streaming RPC. */\nexport class RateLimiter {\n private httpRequests = new Map<string, { requestCount: number; windowStart: number }>();\n private lastCleanup = 0;\n\n constructor(\n private maxRequestsPerWindow: number,\n private rateLimitWindowMs: number\n ) {}\n\n configure(maxRequestsPerWindow: number, rateLimitWindowMs: number): void {\n this.maxRequestsPerWindow = maxRequestsPerWindow;\n this.rateLimitWindowMs = rateLimitWindowMs;\n }\n\n checkHttpRateLimit(ip: string): boolean {\n if (this.maxRequestsPerWindow === 0) {\n return true;\n }\n const now = Date.now();\n if (now - this.lastCleanup >= this.rateLimitWindowMs) {\n for (const [key, info] of this.httpRequests) {\n if (now - info.windowStart >= this.rateLimitWindowMs) {\n this.httpRequests.delete(key);\n }\n }\n this.lastCleanup = now;\n }\n let info = this.httpRequests.get(ip);\n if (!info || now - info.windowStart >= this.rateLimitWindowMs) {\n info = { requestCount: 0, windowStart: now };\n this.httpRequests.set(ip, info);\n }\n if (info.requestCount >= this.maxRequestsPerWindow) {\n return false;\n }\n info.requestCount++;\n return true;\n }\n\n getHttpStats(ip: string): { remainingRequests: number; resetInSeconds: number } {\n if (this.maxRequestsPerWindow === 0) {\n return { remainingRequests: Infinity, resetInSeconds: 0 };\n }\n const info = this.httpRequests.get(ip);\n const now = Date.now();\n if (!info || now - info.windowStart >= this.rateLimitWindowMs) {\n return { remainingRequests: this.maxRequestsPerWindow, resetInSeconds: 0 };\n }\n return {\n remainingRequests: Math.max(0, this.maxRequestsPerWindow - info.requestCount),\n resetInSeconds: Math.max(0, Math.ceil((info.windowStart + this.rateLimitWindowMs - now) / 1000)),\n };\n }\n}\n"]}
@@ -0,0 +1,10 @@
1
+ import type { IncomingMessage, Server, ServerResponse } from "http";
2
+ /** One cancellation signal per HTTP request, shared by middleware and handlers. */
3
+ export declare function getRequestSignal(req: IncomingMessage, res: ServerResponse): AbortSignal;
4
+ /** Associate cancellation with its own server, never other servers in this process. */
5
+ export declare function trackServerRequest(server: Server, req: IncomingMessage, res: ServerResponse): void;
6
+ /** Keep cooperative iterator cleanup observable even after the response closes. */
7
+ export declare function trackRequestCleanup<T>(req: IncomingMessage, value: PromiseLike<T> | T): Promise<T>;
8
+ /** Abort synchronously, then allow bounded provider cleanup before process exit. */
9
+ export declare function abortServerRequests(server: Server, cleanupTimeoutMs?: number): Promise<void>;
10
+ //# sourceMappingURL=requestSignal.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"requestSignal.d.ts","sourceRoot":"","sources":["../../src/server/requestSignal.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,MAAM,CAAC;AAWpE,mFAAmF;AACnF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,WAAW,CAkCvF;AAED,uFAAuF;AACvF,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,EAAE,GAAG,EAAE,cAAc,GAAG,IAAI,CAUlG;AAED,mFAAmF;AACnF,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,GAAG,EAAE,eAAe,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CASlG;AAED,oFAAoF;AACpF,wBAAsB,mBAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,gBAAgB,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhG"}
@@ -0,0 +1,79 @@
1
+ const requests = new WeakMap();
2
+ const serverRequests = new WeakMap();
3
+ /** One cancellation signal per HTTP request, shared by middleware and handlers. */
4
+ export function getRequestSignal(req, res) {
5
+ const existing = requests.get(req);
6
+ if (existing) {
7
+ return existing.controller.signal;
8
+ }
9
+ const controller = new AbortController();
10
+ const state = { controller, pendingCleanup: new Set() };
11
+ requests.set(req, state);
12
+ const abort = () => controller.abort(new Error("Client disconnected"));
13
+ const cleanup = () => {
14
+ req.off?.("aborted", abort);
15
+ req.off?.("error", abort);
16
+ res.off?.("close", onClose);
17
+ res.off?.("finish", cleanup);
18
+ res.off?.("error", abort);
19
+ if (state.server) {
20
+ serverRequests.get(state.server)?.delete(state);
21
+ }
22
+ };
23
+ const onClose = () => {
24
+ if (!res.writableFinished) {
25
+ abort();
26
+ }
27
+ cleanup();
28
+ };
29
+ req.once?.("aborted", abort);
30
+ req.once?.("error", abort);
31
+ res.once?.("close", onClose);
32
+ res.once?.("finish", cleanup);
33
+ res.once?.("error", abort);
34
+ if (req.aborted || res.destroyed) {
35
+ abort();
36
+ }
37
+ return controller.signal;
38
+ }
39
+ /** Associate cancellation with its own server, never other servers in this process. */
40
+ export function trackServerRequest(server, req, res) {
41
+ getRequestSignal(req, res);
42
+ const state = requests.get(req);
43
+ state.server = server;
44
+ let active = serverRequests.get(server);
45
+ if (!active) {
46
+ active = new Set();
47
+ serverRequests.set(server, active);
48
+ }
49
+ active.add(state);
50
+ }
51
+ /** Keep cooperative iterator cleanup observable even after the response closes. */
52
+ export function trackRequestCleanup(req, value) {
53
+ const promise = Promise.resolve(value);
54
+ const pending = requests.get(req)?.pendingCleanup;
55
+ pending?.add(promise);
56
+ void promise.then(() => pending?.delete(promise), () => pending?.delete(promise));
57
+ return promise;
58
+ }
59
+ /** Abort synchronously, then allow bounded provider cleanup before process exit. */
60
+ export async function abortServerRequests(server, cleanupTimeoutMs = 1000) {
61
+ const active = [...(serverRequests.get(server) ?? [])];
62
+ for (const state of active) {
63
+ state.controller.abort(new Error("Server shutting down"));
64
+ }
65
+ // Direct abort listeners resume iterator work before this turn. Socket close
66
+ // events are deliberately not the trigger for shutdown cancellation.
67
+ await new Promise((resolve) => setImmediate(resolve));
68
+ const pending = active.flatMap((state) => [...state.pendingCleanup]);
69
+ if (pending.length > 0) {
70
+ await new Promise((resolve) => {
71
+ const timer = setTimeout(resolve, cleanupTimeoutMs);
72
+ void Promise.allSettled(pending).then(() => {
73
+ clearTimeout(timer);
74
+ resolve();
75
+ });
76
+ });
77
+ }
78
+ }
79
+ //# sourceMappingURL=requestSignal.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"requestSignal.js","sourceRoot":"","sources":["../../src/server/requestSignal.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IncomingMessage, Server, ServerResponse } from \"http\";\n\ninterface RequestState {\n controller: AbortController;\n pendingCleanup: Set<Promise<unknown>>;\n server?: Server;\n}\n\nconst requests = new WeakMap<IncomingMessage, RequestState>();\nconst serverRequests = new WeakMap<Server, Set<RequestState>>();\n\n/** One cancellation signal per HTTP request, shared by middleware and handlers. */\nexport function getRequestSignal(req: IncomingMessage, res: ServerResponse): AbortSignal {\n const existing = requests.get(req);\n if (existing) {\n return existing.controller.signal;\n }\n const controller = new AbortController();\n const state: RequestState = { controller, pendingCleanup: new Set() };\n requests.set(req, state);\n const abort = () => controller.abort(new Error(\"Client disconnected\"));\n const cleanup = () => {\n req.off?.(\"aborted\", abort);\n req.off?.(\"error\", abort);\n res.off?.(\"close\", onClose);\n res.off?.(\"finish\", cleanup);\n res.off?.(\"error\", abort);\n if (state.server) {\n serverRequests.get(state.server)?.delete(state);\n }\n };\n const onClose = () => {\n if (!res.writableFinished) {\n abort();\n }\n cleanup();\n };\n req.once?.(\"aborted\", abort);\n req.once?.(\"error\", abort);\n res.once?.(\"close\", onClose);\n res.once?.(\"finish\", cleanup);\n res.once?.(\"error\", abort);\n if (req.aborted || res.destroyed) {\n abort();\n }\n return controller.signal;\n}\n\n/** Associate cancellation with its own server, never other servers in this process. */\nexport function trackServerRequest(server: Server, req: IncomingMessage, res: ServerResponse): void {\n getRequestSignal(req, res);\n const state = requests.get(req)!;\n state.server = server;\n let active = serverRequests.get(server);\n if (!active) {\n active = new Set();\n serverRequests.set(server, active);\n }\n active.add(state);\n}\n\n/** Keep cooperative iterator cleanup observable even after the response closes. */\nexport function trackRequestCleanup<T>(req: IncomingMessage, value: PromiseLike<T> | T): Promise<T> {\n const promise = Promise.resolve(value);\n const pending = requests.get(req)?.pendingCleanup;\n pending?.add(promise);\n void promise.then(\n () => pending?.delete(promise),\n () => pending?.delete(promise)\n );\n return promise;\n}\n\n/** Abort synchronously, then allow bounded provider cleanup before process exit. */\nexport async function abortServerRequests(server: Server, cleanupTimeoutMs = 1000): Promise<void> {\n const active = [...(serverRequests.get(server) ?? [])];\n for (const state of active) {\n state.controller.abort(new Error(\"Server shutting down\"));\n }\n // Direct abort listeners resume iterator work before this turn. Socket close\n // events are deliberately not the trigger for shutdown cancellation.\n await new Promise<void>((resolve) => setImmediate(resolve));\n const pending = active.flatMap((state) => [...state.pendingCleanup]);\n if (pending.length > 0) {\n await new Promise<void>((resolve) => {\n const timer = setTimeout(resolve, cleanupTimeoutMs);\n void Promise.allSettled(pending).then(() => {\n clearTimeout(timer);\n resolve();\n });\n });\n }\n}\n"]}
@@ -1,6 +1,5 @@
1
1
  import type http from "http";
2
- import WebSocket from "ws";
3
- import type { RpcResponse } from "../runtime/protocol.js";
2
+ import type { RpcResponse, RpcStats } from "../runtime/protocol.js";
4
3
  import type { HeliumMethodDef } from "./defineMethod.js";
5
4
  import type { HeliumMiddleware } from "./middleware.js";
6
5
  import type { RateLimiter } from "./rateLimiter.js";
@@ -10,30 +9,23 @@ export interface HttpRpcResult {
10
9
  export declare class PublicError extends Error {
11
10
  readonly public = true;
12
11
  }
12
+ export declare function isAsyncIterable(value: unknown): value is AsyncIterable<unknown>;
13
+ /** Reject promptly on disconnect even when provider work has not settled yet. */
14
+ export declare function abortable<T>(value: PromiseLike<T> | T, signal: AbortSignal): Promise<T>;
13
15
  export declare class RpcRegistry {
14
16
  private methods;
15
17
  private middleware;
16
18
  private rateLimiter;
17
- private socketMetadata;
18
19
  private maxBatchSize;
19
20
  register(id: string, def: HeliumMethodDef<any, any>): void;
20
21
  setMiddleware(middleware: HeliumMiddleware): void;
21
22
  setRateLimiter(rateLimiter: RateLimiter): void;
22
23
  setMaxBatchSize(size: number): void;
23
- /**
24
- * Store metadata about a WebSocket connection.
25
- * Should be called when a new connection is established.
26
- */
27
- setSocketMetadata(socket: WebSocket, ip: string, req: http.IncomingMessage): void;
28
- private getStats;
29
- private processRequest;
30
- handleMessage(socket: WebSocket, raw: string | Buffer): Promise<void>;
31
- private processRequestHttp;
32
- /**
33
- * Handle an HTTP-based RPC request.
34
- * This is an alternative to WebSocket for environments where HTTP performs better
35
- * (e.g., mobile networks with high latency where HTTP/2 multiplexing helps).
36
- */
37
- handleHttpRequest(reqBody: Buffer | string, ip: string, httpReq: http.IncomingMessage): Promise<HttpRpcResult>;
24
+ getStats(ip: string): RpcStats;
25
+ private invoke;
26
+ private checkRateLimit;
27
+ handleHttpRequest(body: Buffer | string, ip: string, req: http.IncomingMessage, signal?: AbortSignal): Promise<HttpRpcResult>;
28
+ handleStreamRequest(body: Buffer, ip: string, req: http.IncomingMessage, signal: AbortSignal, onChunk: (value: unknown, signal: AbortSignal) => Promise<void>): Promise<RpcStats>;
38
29
  }
30
+ export declare function sanitizeErrorMessage(error: unknown): string;
39
31
  //# sourceMappingURL=rpcRegistry.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"rpcRegistry.d.ts","sourceRoot":"","sources":["../../src/server/rpcRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,SAAS,MAAM,IAAI,CAAC;AAG3B,OAAO,KAAK,EAAc,WAAW,EAAY,MAAM,wBAAwB,CAAC;AAGhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAUpD,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;CACzC;AAED,qBAAa,WAAY,SAAQ,KAAK;IAClC,SAAgB,MAAM,QAAQ;CACjC;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,cAAc,CAA4C;IAClE,OAAO,CAAC,YAAY,CAAc;IAElC,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC;IAKnD,aAAa,CAAC,UAAU,EAAE,gBAAgB;IAI1C,cAAc,CAAC,WAAW,EAAE,WAAW;IAIvC,eAAe,CAAC,IAAI,EAAE,MAAM;IAI5B;;;OAGG;IACH,iBAAiB,CAAC,MAAM,EAAE,SAAS,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe;IAI1E,OAAO,CAAC,QAAQ;YAmBF,cAAc;IA2EtB,aAAa,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM;YAuC7C,kBAAkB;IAwEhC;;;;OAIG;IACG,iBAAiB,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,OAAO,EAAE,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,aAAa,CAAC;CAiDvH"}
1
+ {"version":3,"file":"rpcRegistry.d.ts","sourceRoot":"","sources":["../../src/server/rpcRegistry.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B,OAAO,KAAK,EAAc,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAGhF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAGpD,MAAM,WAAW,aAAa;IAC1B,QAAQ,EAAE,WAAW,GAAG,WAAW,EAAE,CAAC;CACzC;AAED,qBAAa,WAAY,SAAQ,KAAK;IAClC,SAAgB,MAAM,QAAQ;CACjC;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,aAAa,CAAC,OAAO,CAAC,CAE/E;AAED,iFAAiF;AACjF,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,EAAE,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,MAAM,EAAE,WAAW,GAAG,OAAO,CAAC,CAAC,CAAC,CAwBvF;AAED,qBAAa,WAAW;IACpB,OAAO,CAAC,OAAO,CAAgD;IAC/D,OAAO,CAAC,UAAU,CAAiC;IACnD,OAAO,CAAC,WAAW,CAA4B;IAC/C,OAAO,CAAC,YAAY,CAAM;IAE1B,QAAQ,CAAC,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,eAAe,CAAC,GAAG,EAAE,GAAG,CAAC;IAInD,aAAa,CAAC,UAAU,EAAE,gBAAgB;IAG1C,cAAc,CAAC,WAAW,EAAE,WAAW;IAGvC,eAAe,CAAC,IAAI,EAAE,MAAM;IAG5B,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ;YAIhB,MAAM;IA+EpB,OAAO,CAAC,cAAc;IAMhB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,MAAM,GAAE,WAA0C,GAAG,OAAO,CAAC,aAAa,CAAC;IA6C3J,mBAAmB,CACrB,IAAI,EAAE,MAAM,EACZ,EAAE,EAAE,MAAM,EACV,GAAG,EAAE,IAAI,CAAC,eAAe,EACzB,MAAM,EAAE,WAAW,EACnB,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,KAAK,OAAO,CAAC,IAAI,CAAC,GAChE,OAAO,CAAC,QAAQ,CAAC;CA2CvB;AAsBD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAI3D"}