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.
- package/README.md +39 -14
- package/dist/bin/helium.js +19 -10
- package/dist/bin/helium.js.map +1 -1
- package/dist/client/Router.d.ts.map +1 -1
- package/dist/client/Router.js +2 -4
- package/dist/client/Router.js.map +1 -1
- package/dist/client/callMethod.d.ts +8 -0
- package/dist/client/callMethod.d.ts.map +1 -0
- package/dist/client/callMethod.js +9 -0
- package/dist/client/callMethod.js.map +1 -0
- package/dist/client/index.d.ts +3 -2
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +2 -1
- package/dist/client/index.js.map +1 -1
- package/dist/client/rpcClient.d.ts +7 -37
- package/dist/client/rpcClient.d.ts.map +1 -1
- package/dist/client/rpcClient.js +118 -749
- package/dist/client/rpcClient.js.map +1 -1
- package/dist/client/rpcStreaming.d.ts +10 -0
- package/dist/client/rpcStreaming.d.ts.map +1 -0
- package/dist/client/rpcStreaming.js +125 -0
- package/dist/client/rpcStreaming.js.map +1 -0
- package/dist/client/useStreaming.d.ts +26 -0
- package/dist/client/useStreaming.d.ts.map +1 -0
- package/dist/client/useStreaming.js +126 -0
- package/dist/client/useStreaming.js.map +1 -0
- package/dist/runtime/protocol.d.ts +14 -0
- package/dist/runtime/protocol.d.ts.map +1 -1
- package/dist/runtime/protocol.js +3 -1
- package/dist/runtime/protocol.js.map +1 -1
- package/dist/server/config.d.ts +16 -101
- package/dist/server/config.d.ts.map +1 -1
- package/dist/server/config.js +5 -27
- package/dist/server/config.js.map +1 -1
- package/dist/server/context.d.ts +8 -6
- package/dist/server/context.d.ts.map +1 -1
- package/dist/server/context.js.map +1 -1
- package/dist/server/defineWorker.d.ts +1 -1
- package/dist/server/defineWorker.d.ts.map +1 -1
- package/dist/server/defineWorker.js +2 -1
- package/dist/server/defineWorker.js.map +1 -1
- package/dist/server/devServer.d.ts +1 -1
- package/dist/server/devServer.d.ts.map +1 -1
- package/dist/server/devServer.js +13 -250
- package/dist/server/devServer.js.map +1 -1
- package/dist/server/httpCompression.d.ts +8 -0
- package/dist/server/httpCompression.d.ts.map +1 -0
- package/dist/server/httpCompression.js +58 -0
- package/dist/server/httpCompression.js.map +1 -0
- package/dist/server/httpRouter.d.ts.map +1 -1
- package/dist/server/httpRouter.js +5 -2
- package/dist/server/httpRouter.js.map +1 -1
- package/dist/server/httpRpc.d.ts +10 -0
- package/dist/server/httpRpc.d.ts.map +1 -0
- package/dist/server/httpRpc.js +186 -0
- package/dist/server/httpRpc.js.map +1 -0
- package/dist/server/prodServer.d.ts +3 -1
- package/dist/server/prodServer.d.ts.map +1 -1
- package/dist/server/prodServer.js +36 -229
- package/dist/server/prodServer.js.map +1 -1
- package/dist/server/rateLimiter.d.ts +6 -36
- package/dist/server/rateLimiter.d.ts.map +1 -1
- package/dist/server/rateLimiter.js +18 -125
- package/dist/server/rateLimiter.js.map +1 -1
- package/dist/server/requestSignal.d.ts +10 -0
- package/dist/server/requestSignal.d.ts.map +1 -0
- package/dist/server/requestSignal.js +79 -0
- package/dist/server/requestSignal.js.map +1 -0
- package/dist/server/rpcRegistry.d.ts +10 -18
- package/dist/server/rpcRegistry.d.ts.map +1 -1
- package/dist/server/rpcRegistry.js +181 -269
- package/dist/server/rpcRegistry.js.map +1 -1
- package/dist/server/serializer.js +12 -6
- package/dist/server/serializer.js.map +1 -1
- package/dist/vite/heliumPlugin.d.ts.map +1 -1
- package/dist/vite/heliumPlugin.js +77 -43
- package/dist/vite/heliumPlugin.js.map +1 -1
- package/dist/vite/ssg.d.ts.map +1 -1
- package/dist/vite/ssg.js +20 -1
- package/dist/vite/ssg.js.map +1 -1
- package/package.json +2 -4
|
@@ -1,41 +1,11 @@
|
|
|
1
|
-
|
|
1
|
+
/** Share a fixed request window per client IP across unary and streaming RPC. */
|
|
2
2
|
export declare class RateLimiter {
|
|
3
|
-
private
|
|
4
|
-
private ipConnections;
|
|
5
|
-
private httpRequests;
|
|
6
|
-
private lastHttpCleanup;
|
|
7
|
-
private maxMessagesPerWindow;
|
|
3
|
+
private maxRequestsPerWindow;
|
|
8
4
|
private rateLimitWindowMs;
|
|
9
|
-
private
|
|
10
|
-
|
|
11
|
-
|
|
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,
|
|
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(
|
|
3
|
-
this.
|
|
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.
|
|
6
|
+
this.httpRequests = new Map();
|
|
7
|
+
this.lastCleanup = 0;
|
|
10
8
|
}
|
|
11
|
-
configure(
|
|
12
|
-
this.
|
|
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.
|
|
14
|
+
if (this.maxRequestsPerWindow === 0) {
|
|
122
15
|
return true;
|
|
123
16
|
}
|
|
124
17
|
const now = Date.now();
|
|
125
|
-
if (now - this.
|
|
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.
|
|
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 = {
|
|
28
|
+
info = { requestCount: 0, windowStart: now };
|
|
136
29
|
this.httpRequests.set(ip, info);
|
|
137
30
|
}
|
|
138
|
-
if (info.
|
|
31
|
+
if (info.requestCount >= this.maxRequestsPerWindow) {
|
|
139
32
|
return false;
|
|
140
33
|
}
|
|
141
|
-
info.
|
|
34
|
+
info.requestCount++;
|
|
142
35
|
return true;
|
|
143
36
|
}
|
|
144
37
|
getHttpStats(ip) {
|
|
145
|
-
|
|
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.
|
|
44
|
+
return { remainingRequests: this.maxRequestsPerWindow, resetInSeconds: 0 };
|
|
152
45
|
}
|
|
153
46
|
return {
|
|
154
|
-
remainingRequests: Math.max(0, this.
|
|
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
|
|
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
|
-
|
|
25
|
-
|
|
26
|
-
|
|
27
|
-
|
|
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,
|
|
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"}
|