heliumts 0.9.7 → 0.10.1

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 (79) hide show
  1. package/README.md +37 -12
  2. package/dist/bin/helium.js +15 -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 +2 -7
  8. package/dist/client/callMethod.d.ts.map +1 -1
  9. package/dist/client/callMethod.js +4 -5
  10. package/dist/client/callMethod.js.map +1 -1
  11. package/dist/client/index.d.ts +3 -3
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js +1 -1
  14. package/dist/client/index.js.map +1 -1
  15. package/dist/client/rpcClient.d.ts +7 -41
  16. package/dist/client/rpcClient.d.ts.map +1 -1
  17. package/dist/client/rpcClient.js +118 -752
  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 -235
  45. package/dist/server/devServer.js.map +1 -1
  46. package/dist/server/httpRouter.d.ts.map +1 -1
  47. package/dist/server/httpRouter.js +5 -2
  48. package/dist/server/httpRouter.js.map +1 -1
  49. package/dist/server/httpRpc.d.ts +10 -0
  50. package/dist/server/httpRpc.d.ts.map +1 -0
  51. package/dist/server/httpRpc.js +186 -0
  52. package/dist/server/httpRpc.js.map +1 -0
  53. package/dist/server/prodServer.d.ts +3 -1
  54. package/dist/server/prodServer.d.ts.map +1 -1
  55. package/dist/server/prodServer.js +36 -214
  56. package/dist/server/prodServer.js.map +1 -1
  57. package/dist/server/rateLimiter.d.ts +6 -36
  58. package/dist/server/rateLimiter.d.ts.map +1 -1
  59. package/dist/server/rateLimiter.js +18 -125
  60. package/dist/server/rateLimiter.js.map +1 -1
  61. package/dist/server/requestSignal.d.ts +10 -0
  62. package/dist/server/requestSignal.d.ts.map +1 -0
  63. package/dist/server/requestSignal.js +79 -0
  64. package/dist/server/requestSignal.js.map +1 -0
  65. package/dist/server/rpcDecoder.d.ts +4 -0
  66. package/dist/server/rpcDecoder.d.ts.map +1 -0
  67. package/dist/server/rpcDecoder.js +151 -0
  68. package/dist/server/rpcDecoder.js.map +1 -0
  69. package/dist/server/rpcRegistry.d.ts +10 -22
  70. package/dist/server/rpcRegistry.d.ts.map +1 -1
  71. package/dist/server/rpcRegistry.js +181 -274
  72. package/dist/server/rpcRegistry.js.map +1 -1
  73. package/dist/vite/heliumPlugin.d.ts.map +1 -1
  74. package/dist/vite/heliumPlugin.js +73 -43
  75. package/dist/vite/heliumPlugin.js.map +1 -1
  76. package/dist/vite/ssg.d.ts.map +1 -1
  77. package/dist/vite/ssg.js +16 -1
  78. package/dist/vite/ssg.js.map +1 -1
  79. 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"]}
@@ -0,0 +1,4 @@
1
+ export declare const MAX_RPC_REQUEST_DEPTH = 128;
2
+ /** Reject impossible declared sizes before the MessagePack decoder allocates them. */
3
+ export declare function decodeRpcRequest(body: Buffer | string): unknown;
4
+ //# sourceMappingURL=rpcDecoder.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpcDecoder.d.ts","sourceRoot":"","sources":["../../src/server/rpcDecoder.ts"],"names":[],"mappings":"AAEA,eAAO,MAAM,qBAAqB,MAAM,CAAC;AAwIzC,sFAAsF;AACtF,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAU/D"}
@@ -0,0 +1,151 @@
1
+ import { decode } from "@msgpack/msgpack";
2
+ export const MAX_RPC_REQUEST_DEPTH = 128;
3
+ /** Validate container obligations before the decoder preallocates their arrays. */
4
+ function validateStructure(bytes) {
5
+ const remainingChildren = new Uint32Array(MAX_RPC_REQUEST_DEPTH);
6
+ let depth = 0;
7
+ let offset = 0;
8
+ let outstandingValues = 1;
9
+ const invalid = () => {
10
+ throw new RangeError("Invalid MessagePack request structure");
11
+ };
12
+ const skip = (size) => {
13
+ if (size > bytes.byteLength - offset) {
14
+ invalid();
15
+ }
16
+ offset += size;
17
+ };
18
+ const length = (size) => {
19
+ skip(size);
20
+ return size === 1 ? bytes[offset - 1] : size === 2 ? bytes.readUInt16BE(offset - 2) : bytes.readUInt32BE(offset - 4);
21
+ };
22
+ while (outstandingValues > 0) {
23
+ if (offset >= bytes.byteLength) {
24
+ invalid();
25
+ }
26
+ while (depth > 0 && remainingChildren[depth - 1] === 0) {
27
+ depth--;
28
+ }
29
+ if (depth > 0) {
30
+ remainingChildren[depth - 1] = remainingChildren[depth - 1] - 1;
31
+ }
32
+ outstandingValues--;
33
+ const tag = bytes[offset++];
34
+ let children = 0;
35
+ let container = false;
36
+ if (tag <= 0x7f || tag >= 0xe0 || tag === 0xc0 || tag === 0xc2 || tag === 0xc3) {
37
+ // Integers, nil, and booleans carry no additional bytes.
38
+ }
39
+ else if (tag <= 0x8f) {
40
+ container = true;
41
+ children = 2 * (tag & 0x0f);
42
+ }
43
+ else if (tag <= 0x9f) {
44
+ container = true;
45
+ children = tag & 0x0f;
46
+ }
47
+ else if (tag <= 0xbf) {
48
+ skip(tag & 0x1f);
49
+ }
50
+ else {
51
+ switch (tag) {
52
+ case 0xc4: // bin8
53
+ case 0xd9: // str8
54
+ skip(length(1));
55
+ break;
56
+ case 0xc5: // bin16
57
+ case 0xda: // str16
58
+ skip(length(2));
59
+ break;
60
+ case 0xc6: // bin32
61
+ case 0xdb: // str32
62
+ skip(length(4));
63
+ break;
64
+ case 0xc7: // ext8 includes its type byte
65
+ skip(length(1) + 1);
66
+ break;
67
+ case 0xc8: // ext16
68
+ skip(length(2) + 1);
69
+ break;
70
+ case 0xc9: // ext32
71
+ skip(length(4) + 1);
72
+ break;
73
+ case 0xcc: // uint8
74
+ case 0xd0: // int8
75
+ skip(1);
76
+ break;
77
+ case 0xcd: // uint16
78
+ case 0xd1: // int16
79
+ skip(2);
80
+ break;
81
+ case 0xca: // float32
82
+ case 0xce: // uint32
83
+ case 0xd2: // int32
84
+ skip(4);
85
+ break;
86
+ case 0xcb: // float64
87
+ case 0xcf: // uint64
88
+ case 0xd3: // int64
89
+ skip(8);
90
+ break;
91
+ case 0xd4: // fixext1, plus type byte
92
+ skip(2);
93
+ break;
94
+ case 0xd5: // fixext2
95
+ skip(3);
96
+ break;
97
+ case 0xd6: // fixext4, including timestamp32
98
+ skip(5);
99
+ break;
100
+ case 0xd7: // fixext8, including timestamp64
101
+ skip(9);
102
+ break;
103
+ case 0xd8: // fixext16
104
+ skip(17);
105
+ break;
106
+ case 0xdc: // array16
107
+ case 0xdd: // array32
108
+ container = true;
109
+ children = length(tag === 0xdc ? 2 : 4);
110
+ break;
111
+ case 0xde: // map16
112
+ case 0xdf: // map32
113
+ container = true;
114
+ children = 2 * length(tag === 0xde ? 2 : 4);
115
+ break;
116
+ default: // 0xc1 is reserved.
117
+ invalid();
118
+ }
119
+ }
120
+ outstandingValues += children;
121
+ // Every outstanding child needs at least one encoded byte. Checking the
122
+ // sum also rejects nested declarations that pass individual size caps.
123
+ if (outstandingValues > bytes.byteLength - offset) {
124
+ invalid();
125
+ }
126
+ if (container) {
127
+ if (depth >= MAX_RPC_REQUEST_DEPTH) {
128
+ invalid();
129
+ }
130
+ if (children > 0) {
131
+ remainingChildren[depth++] = children;
132
+ }
133
+ }
134
+ }
135
+ if (offset !== bytes.byteLength) {
136
+ invalid();
137
+ }
138
+ }
139
+ /** Reject impossible declared sizes before the MessagePack decoder allocates them. */
140
+ export function decodeRpcRequest(body) {
141
+ const bytes = Buffer.isBuffer(body) ? body : Buffer.from(body);
142
+ validateStructure(bytes);
143
+ return decode(bytes, {
144
+ maxStrLength: bytes.byteLength,
145
+ maxBinLength: bytes.byteLength,
146
+ maxArrayLength: bytes.byteLength,
147
+ maxMapLength: bytes.byteLength,
148
+ maxExtLength: bytes.byteLength,
149
+ });
150
+ }
151
+ //# sourceMappingURL=rpcDecoder.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"rpcDecoder.js","sourceRoot":"","sources":["../../src/server/rpcDecoder.ts"],"names":[],"mappings":"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","sourcesContent":["import { decode } from \"@msgpack/msgpack\";\n\nexport const MAX_RPC_REQUEST_DEPTH = 128;\n\n/** Validate container obligations before the decoder preallocates their arrays. */\nfunction validateStructure(bytes: Buffer): void {\n const remainingChildren = new Uint32Array(MAX_RPC_REQUEST_DEPTH);\n let depth = 0;\n let offset = 0;\n let outstandingValues = 1;\n const invalid = () => {\n throw new RangeError(\"Invalid MessagePack request structure\");\n };\n const skip = (size: number) => {\n if (size > bytes.byteLength - offset) {\n invalid();\n }\n offset += size;\n };\n const length = (size: 1 | 2 | 4): number => {\n skip(size);\n return size === 1 ? bytes[offset - 1]! : size === 2 ? bytes.readUInt16BE(offset - 2) : bytes.readUInt32BE(offset - 4);\n };\n\n while (outstandingValues > 0) {\n if (offset >= bytes.byteLength) {\n invalid();\n }\n while (depth > 0 && remainingChildren[depth - 1] === 0) {\n depth--;\n }\n if (depth > 0) {\n remainingChildren[depth - 1] = remainingChildren[depth - 1]! - 1;\n }\n outstandingValues--;\n const tag = bytes[offset++]!;\n let children = 0;\n let container = false;\n if (tag <= 0x7f || tag >= 0xe0 || tag === 0xc0 || tag === 0xc2 || tag === 0xc3) {\n // Integers, nil, and booleans carry no additional bytes.\n } else if (tag <= 0x8f) {\n container = true;\n children = 2 * (tag & 0x0f);\n } else if (tag <= 0x9f) {\n container = true;\n children = tag & 0x0f;\n } else if (tag <= 0xbf) {\n skip(tag & 0x1f);\n } else {\n switch (tag) {\n case 0xc4: // bin8\n case 0xd9: // str8\n skip(length(1));\n break;\n case 0xc5: // bin16\n case 0xda: // str16\n skip(length(2));\n break;\n case 0xc6: // bin32\n case 0xdb: // str32\n skip(length(4));\n break;\n case 0xc7: // ext8 includes its type byte\n skip(length(1) + 1);\n break;\n case 0xc8: // ext16\n skip(length(2) + 1);\n break;\n case 0xc9: // ext32\n skip(length(4) + 1);\n break;\n case 0xcc: // uint8\n case 0xd0: // int8\n skip(1);\n break;\n case 0xcd: // uint16\n case 0xd1: // int16\n skip(2);\n break;\n case 0xca: // float32\n case 0xce: // uint32\n case 0xd2: // int32\n skip(4);\n break;\n case 0xcb: // float64\n case 0xcf: // uint64\n case 0xd3: // int64\n skip(8);\n break;\n case 0xd4: // fixext1, plus type byte\n skip(2);\n break;\n case 0xd5: // fixext2\n skip(3);\n break;\n case 0xd6: // fixext4, including timestamp32\n skip(5);\n break;\n case 0xd7: // fixext8, including timestamp64\n skip(9);\n break;\n case 0xd8: // fixext16\n skip(17);\n break;\n case 0xdc: // array16\n case 0xdd: // array32\n container = true;\n children = length(tag === 0xdc ? 2 : 4);\n break;\n case 0xde: // map16\n case 0xdf: // map32\n container = true;\n children = 2 * length(tag === 0xde ? 2 : 4);\n break;\n default: // 0xc1 is reserved.\n invalid();\n }\n }\n outstandingValues += children;\n // Every outstanding child needs at least one encoded byte. Checking the\n // sum also rejects nested declarations that pass individual size caps.\n if (outstandingValues > bytes.byteLength - offset) {\n invalid();\n }\n if (container) {\n if (depth >= MAX_RPC_REQUEST_DEPTH) {\n invalid();\n }\n if (children > 0) {\n remainingChildren[depth++] = children;\n }\n }\n }\n if (offset !== bytes.byteLength) {\n invalid();\n }\n}\n\n/** Reject impossible declared sizes before the MessagePack decoder allocates them. */\nexport function decodeRpcRequest(body: Buffer | string): unknown {\n const bytes = Buffer.isBuffer(body) ? body : Buffer.from(body);\n validateStructure(bytes);\n return decode(bytes, {\n maxStrLength: bytes.byteLength,\n maxBinLength: bytes.byteLength,\n maxArrayLength: bytes.byteLength,\n maxMapLength: bytes.byteLength,\n maxExtLength: bytes.byteLength,\n });\n}\n"]}
@@ -1,7 +1,5 @@
1
1
  import type http from "http";
2
- import WebSocket from "ws";
3
- import type { RpcResponse } from "../runtime/protocol.js";
4
- import type { HeliumCompressionConfig } from "./config.js";
2
+ import type { RpcResponse, RpcStats } from "../runtime/protocol.js";
5
3
  import type { HeliumMethodDef } from "./defineMethod.js";
6
4
  import type { HeliumMiddleware } from "./middleware.js";
7
5
  import type { RateLimiter } from "./rateLimiter.js";
@@ -11,33 +9,23 @@ export interface HttpRpcResult {
11
9
  export declare class PublicError extends Error {
12
10
  readonly public = true;
13
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>;
14
15
  export declare class RpcRegistry {
15
16
  private methods;
16
17
  private middleware;
17
18
  private rateLimiter;
18
- private socketMetadata;
19
19
  private maxBatchSize;
20
- private compression;
21
20
  register(id: string, def: HeliumMethodDef<any, any>): void;
22
21
  setMiddleware(middleware: HeliumMiddleware): void;
23
22
  setRateLimiter(rateLimiter: RateLimiter): void;
24
23
  setMaxBatchSize(size: number): void;
25
- setCompressionConfig(config: HeliumCompressionConfig): void;
26
- /**
27
- * Store metadata about a WebSocket connection.
28
- * Should be called when a new connection is established.
29
- */
30
- setSocketMetadata(socket: WebSocket, ip: string, req: http.IncomingMessage): void;
31
- private getStats;
32
- private processRequest;
33
- handleMessage(socket: WebSocket, raw: string | Buffer): Promise<void>;
34
- private sendResponse;
35
- private processRequestHttp;
36
- /**
37
- * Handle an HTTP-based RPC request.
38
- * This is an alternative to WebSocket for environments where HTTP performs better
39
- * (e.g., mobile networks with high latency where HTTP/2 multiplexing helps).
40
- */
41
- 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>;
42
29
  }
30
+ export declare function sanitizeErrorMessage(error: unknown): string;
43
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;AAEhF,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAG3D,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;IAClC,OAAO,CAAC,WAAW,CAA0B;IAE7C,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,oBAAoB,CAAC,MAAM,EAAE,uBAAuB;IAIpD;;;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;YAgC7C,YAAY;YASZ,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":"AAAA,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;AAIpD,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"}