heliumts 0.9.7 → 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 (75) 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/rpcRegistry.d.ts +10 -22
  66. package/dist/server/rpcRegistry.d.ts.map +1 -1
  67. package/dist/server/rpcRegistry.js +181 -274
  68. package/dist/server/rpcRegistry.js.map +1 -1
  69. package/dist/vite/heliumPlugin.d.ts.map +1 -1
  70. package/dist/vite/heliumPlugin.js +73 -43
  71. package/dist/vite/heliumPlugin.js.map +1 -1
  72. package/dist/vite/ssg.d.ts.map +1 -1
  73. package/dist/vite/ssg.js +16 -1
  74. package/dist/vite/ssg.js.map +1 -1
  75. package/package.json +2 -4
@@ -1,24 +1,44 @@
1
- import { decode as msgpackDecode, encode as msgpackEncode } from "@msgpack/msgpack";
2
- import { promisify } from "util";
3
- import { gzip } from "zlib";
1
+ import { decode as msgpackDecode } from "@msgpack/msgpack";
4
2
  import { log } from "../utils/logger.js";
5
- import { getCompressionConfig } from "./config.js";
6
- import { prepareForMsgpack } from "./serializer.js";
7
- const gzipAsync = promisify(gzip);
3
+ import { trackRequestCleanup } from "./requestSignal.js";
8
4
  export class PublicError extends Error {
9
5
  constructor() {
10
6
  super(...arguments);
11
7
  this.public = true;
12
8
  }
13
9
  }
10
+ export function isAsyncIterable(value) {
11
+ return value !== null && (typeof value === "object" || typeof value === "function") && typeof value[Symbol.asyncIterator] === "function";
12
+ }
13
+ /** Reject promptly on disconnect even when provider work has not settled yet. */
14
+ export function abortable(value, signal) {
15
+ const promise = Promise.resolve(value);
16
+ if (signal.aborted) {
17
+ void promise.catch(() => { });
18
+ return Promise.reject(signal.reason ?? new Error("Request aborted"));
19
+ }
20
+ return new Promise((resolve, reject) => {
21
+ const onAbort = () => {
22
+ cleanup();
23
+ reject(signal.reason ?? new Error("Request aborted"));
24
+ };
25
+ const cleanup = () => signal.removeEventListener("abort", onAbort);
26
+ signal.addEventListener("abort", onAbort, { once: true });
27
+ promise.then((result) => {
28
+ cleanup();
29
+ resolve(result);
30
+ }, (error) => {
31
+ cleanup();
32
+ reject(error);
33
+ });
34
+ });
35
+ }
14
36
  export class RpcRegistry {
15
37
  constructor() {
16
38
  this.methods = new Map();
17
39
  this.middleware = null;
18
40
  this.rateLimiter = null;
19
- this.socketMetadata = new WeakMap();
20
41
  this.maxBatchSize = 20;
21
- this.compression = getCompressionConfig();
22
42
  }
23
43
  register(id, def) {
24
44
  def.__id = id;
@@ -33,263 +53,187 @@ export class RpcRegistry {
33
53
  setMaxBatchSize(size) {
34
54
  this.maxBatchSize = size;
35
55
  }
36
- setCompressionConfig(config) {
37
- this.compression = getCompressionConfig({ rpc: { compression: config } });
56
+ getStats(ip) {
57
+ return this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 };
38
58
  }
39
- /**
40
- * Store metadata about a WebSocket connection.
41
- * Should be called when a new connection is established.
42
- */
43
- setSocketMetadata(socket, ip, req) {
44
- this.socketMetadata.set(socket, { ip, req });
45
- }
46
- getStats(socket) {
47
- if (!this.rateLimiter) {
48
- return { remainingRequests: Infinity, resetInSeconds: 0 };
49
- }
50
- const stats = this.rateLimiter.getConnectionStats(socket);
51
- if (!stats) {
52
- return { remainingRequests: 0, resetInSeconds: 0 };
53
- }
54
- const now = Date.now();
55
- const resetInSeconds = Math.ceil((stats.resetTimeMs - now) / 1000);
56
- return {
57
- remainingRequests: stats.remainingMessages,
58
- resetInSeconds: Math.max(0, resetInSeconds),
59
- };
60
- }
61
- async processRequest(value, socket) {
62
- if (!isRpcRequest(value)) {
63
- return invalidRequest(value, this.getStats(socket));
64
- }
65
- const req = value;
66
- const def = this.methods.get(req.method);
59
+ async invoke(request, ip, req, signal, consume) {
60
+ signal.throwIfAborted();
61
+ const def = this.methods.get(request.method);
67
62
  if (!def) {
68
- return {
69
- id: req.id,
70
- ok: false,
71
- stats: this.getStats(socket),
72
- error: `Unknown method ${req.method}`,
73
- };
74
- }
63
+ throw new PublicError(`Unknown method ${request.method}`);
64
+ }
65
+ // A method can also stop when middleware fails while next() is running.
66
+ // Keep the response signal alive long enough to deliver a terminal error.
67
+ const controller = new AbortController();
68
+ const abort = () => controller.abort(signal.reason);
69
+ signal.addEventListener("abort", abort, { once: true });
70
+ if (signal.aborted) {
71
+ abort();
72
+ }
73
+ const activeSignal = controller.signal;
74
+ const ctx = { signal: activeSignal, req: { ip, headers: req.headers, url: req.url, method: req.method, raw: req } };
75
+ let called = false;
76
+ let work;
77
+ const next = () => {
78
+ if (called) {
79
+ const error = new PublicError("Middleware next() may only be called once");
80
+ controller.abort(error);
81
+ const rejected = Promise.reject(error);
82
+ void rejected.catch(() => { });
83
+ return rejected;
84
+ }
85
+ called = true;
86
+ work = (async () => {
87
+ activeSignal.throwIfAborted();
88
+ const pending = Promise.resolve(def.handler(request.args, ctx));
89
+ let result;
90
+ try {
91
+ result = await abortable(pending, activeSignal);
92
+ }
93
+ catch (error) {
94
+ if (activeSignal.aborted) {
95
+ void pending
96
+ .then(async (late) => {
97
+ if (isAsyncIterable(late)) {
98
+ await trackRequestCleanup(req, late[Symbol.asyncIterator]().return?.());
99
+ }
100
+ })
101
+ .catch(() => { });
102
+ }
103
+ throw error;
104
+ }
105
+ await consume(result, activeSignal);
106
+ })();
107
+ // Middleware may call next() without returning/awaiting it. Observe
108
+ // failures immediately, and still await the original work below.
109
+ void work.catch(() => { });
110
+ return work;
111
+ };
75
112
  try {
76
- // Build context with request metadata
77
- const metadata = this.socketMetadata.get(socket);
78
- const ctx = {
79
- req: {
80
- ip: metadata?.ip || "unknown",
81
- headers: metadata?.req.headers || {},
82
- url: metadata?.req.url,
83
- method: metadata?.req.method,
84
- raw: metadata?.req,
85
- },
86
- };
87
- let result;
88
- // Execute middleware if present
113
+ activeSignal.throwIfAborted();
89
114
  if (this.middleware) {
90
- let nextCalled = false;
91
- await this.middleware.handler({
92
- ctx,
93
- type: "method",
94
- methodName: req.method,
95
- }, async () => {
96
- nextCalled = true;
97
- result = await def.handler(req.args, ctx);
98
- });
99
- // If next() was not called, the middleware blocked the request
100
- if (!nextCalled) {
101
- return {
102
- id: req.id,
103
- ok: false,
104
- stats: this.getStats(socket),
105
- error: "Request blocked by middleware",
106
- };
115
+ await abortable(this.middleware.handler({ ctx, type: "method", methodName: request.method }, next), activeSignal);
116
+ if (!called) {
117
+ throw new PublicError("Request blocked by middleware");
107
118
  }
108
119
  }
109
120
  else {
110
- // No middleware, execute handler directly
111
- result = await def.handler(req.args, ctx);
121
+ next();
122
+ }
123
+ if (work) {
124
+ await abortable(work, activeSignal);
112
125
  }
113
- return {
114
- id: req.id,
115
- ok: true,
116
- stats: this.getStats(socket),
117
- result,
118
- };
119
126
  }
120
- catch (err) {
121
- log("error", `RPC method '${req.method}' failed:`, err);
122
- return {
123
- id: req.id,
124
- ok: false,
125
- stats: this.getStats(socket),
126
- error: sanitizeErrorMessage(err),
127
- };
127
+ catch (error) {
128
+ controller.abort(error);
129
+ throw error;
130
+ }
131
+ finally {
132
+ signal.removeEventListener("abort", abort);
133
+ }
134
+ }
135
+ checkRateLimit(ip) {
136
+ if (this.rateLimiter && !this.rateLimiter.checkHttpRateLimit(ip)) {
137
+ throw new PublicError("Rate limit exceeded");
128
138
  }
129
139
  }
130
- async handleMessage(socket, raw) {
131
- let req;
140
+ async handleHttpRequest(body, ip, req, signal = new AbortController().signal) {
141
+ let value;
132
142
  try {
133
- // Always expect MessagePack
134
- const buffer = Buffer.isBuffer(raw) ? raw : Buffer.from(raw);
135
- req = msgpackDecode(buffer);
143
+ value = msgpackDecode(Buffer.isBuffer(body) ? body : Buffer.from(body));
136
144
  }
137
145
  catch {
138
- return;
146
+ return { response: { id: "unknown", ok: false, stats: this.getStats(ip), error: "Invalid request format" } };
139
147
  }
140
- // Security: cap batch size
141
- if (Array.isArray(req) && req.length > this.maxBatchSize) {
142
- const errorResponse = {
143
- id: "batch",
144
- ok: false,
145
- stats: this.getStats(socket),
146
- error: `Batch size ${req.length} exceeds maximum of ${this.maxBatchSize}`,
147
- };
148
- await this.sendResponse(socket, errorResponse);
149
- return;
150
- }
151
- let response;
152
- if (Array.isArray(req)) {
153
- response = await Promise.all(req.map((r) => this.processRequest(r, socket)));
154
- }
155
- else {
156
- response = await this.processRequest(req, socket);
157
- }
158
- await this.sendResponse(socket, response);
159
- }
160
- async sendResponse(socket, response) {
161
- const encoded = msgpackEncode(prepareForMsgpack(response));
162
- const compress = this.compression.enabled && encoded.length > this.compression.threshold;
163
- const body = compress ? await gzipAsync(encoded) : encoded;
164
- // With context takeover, ws ignores its threshold option. Make the
165
- // per-message choice explicit so both compression layers honor it.
166
- socket.send(body, { compress });
167
- }
168
- async processRequestHttp(value, ip, httpReq) {
169
- if (!isRpcRequest(value)) {
170
- return invalidRequest(value, { remainingRequests: 0, resetInSeconds: 0 });
148
+ const errorResponse = (input, error) => ({ id: requestId(input), ok: false, stats: this.getStats(ip), error });
149
+ try {
150
+ this.checkRateLimit(ip);
171
151
  }
172
- const req = value;
173
- const def = this.methods.get(req.method);
174
- if (!def) {
152
+ catch (error) {
175
153
  return {
176
- id: req.id,
177
- ok: false,
178
- stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
179
- error: `Unknown method ${req.method}`,
154
+ response: Array.isArray(value)
155
+ ? value.slice(0, this.maxBatchSize).map((item) => errorResponse(item, sanitizeErrorMessage(error)))
156
+ : errorResponse(value, sanitizeErrorMessage(error)),
180
157
  };
181
158
  }
182
- try {
183
- // Build context with request metadata
184
- const ctx = {
185
- req: {
186
- ip,
187
- headers: httpReq.headers,
188
- url: httpReq.url,
189
- method: httpReq.method,
190
- raw: httpReq,
191
- },
192
- };
193
- let result;
194
- // Execute middleware if present
195
- if (this.middleware) {
196
- let nextCalled = false;
197
- await this.middleware.handler({
198
- ctx,
199
- type: "method",
200
- methodName: req.method,
201
- }, async () => {
202
- nextCalled = true;
203
- result = await def.handler(req.args, ctx);
159
+ if (Array.isArray(value) && value.length > this.maxBatchSize) {
160
+ return { response: { id: "batch", ok: false, stats: this.getStats(ip), error: `Batch size ${value.length} exceeds maximum of ${this.maxBatchSize}` } };
161
+ }
162
+ const process = async (input) => {
163
+ if (!isRpcRequest(input)) {
164
+ return errorResponse(input, "Invalid request format");
165
+ }
166
+ try {
167
+ let result;
168
+ await this.invoke(input, ip, req, signal, async (value) => {
169
+ if (isAsyncIterable(value)) {
170
+ const iterator = value[Symbol.asyncIterator]();
171
+ void trackRequestCleanup(req, iterator.return?.()).catch(() => { });
172
+ throw new PublicError("This method returns a stream. Use useStreaming() instead of a unary RPC call.");
173
+ }
174
+ result = value;
204
175
  });
205
- if (!nextCalled) {
206
- return {
207
- id: req.id,
208
- ok: false,
209
- stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
210
- error: "Request blocked by middleware",
211
- };
212
- }
176
+ return { id: input.id, ok: true, stats: this.getStats(ip), result };
213
177
  }
214
- else {
215
- result = await def.handler(req.args, ctx);
178
+ catch (error) {
179
+ if (!signal.aborted) {
180
+ log("error", `RPC method '${input.method}' failed:`, error);
181
+ }
182
+ return errorResponse(input, sanitizeErrorMessage(error));
216
183
  }
217
- return {
218
- id: req.id,
219
- ok: true,
220
- stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
221
- result,
222
- };
223
- }
224
- catch (err) {
225
- log("error", `HTTP RPC method '${req.method}' failed:`, err);
226
- return {
227
- id: req.id,
228
- ok: false,
229
- stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
230
- error: sanitizeErrorMessage(err),
231
- };
232
- }
184
+ };
185
+ return { response: Array.isArray(value) ? await Promise.all(value.map(process)) : await process(value) };
233
186
  }
234
- /**
235
- * Handle an HTTP-based RPC request.
236
- * This is an alternative to WebSocket for environments where HTTP performs better
237
- * (e.g., mobile networks with high latency where HTTP/2 multiplexing helps).
238
- */
239
- async handleHttpRequest(reqBody, ip, httpReq) {
240
- let req;
187
+ async handleStreamRequest(body, ip, req, signal, onChunk) {
188
+ let request;
241
189
  try {
242
- // Always expect MessagePack
243
- const buffer = Buffer.isBuffer(reqBody) ? reqBody : Buffer.from(reqBody);
244
- req = msgpackDecode(buffer);
190
+ request = msgpackDecode(body);
245
191
  }
246
192
  catch {
247
- const errorResponse = {
248
- id: "unknown",
249
- ok: false,
250
- stats: { remainingRequests: 0, resetInSeconds: 0 },
251
- error: "Invalid request format",
252
- };
253
- return {
254
- response: errorResponse,
255
- };
256
- }
257
- if (this.rateLimiter && !this.rateLimiter.checkHttpRateLimit(ip)) {
258
- const stats = this.rateLimiter.getHttpStats(ip);
259
- const reject = (value) => ({
260
- id: requestId(value),
261
- ok: false,
262
- stats,
263
- error: "Rate limit exceeded",
264
- });
265
- return { response: Array.isArray(req) ? req.slice(0, this.maxBatchSize).map(reject) : reject(req) };
193
+ throw new PublicError("Invalid request format");
266
194
  }
267
- let response;
268
- if (Array.isArray(req)) {
269
- // Security: cap batch size
270
- if (req.length > this.maxBatchSize) {
271
- const errorResponse = {
272
- id: "batch",
273
- ok: false,
274
- stats: { remainingRequests: 0, resetInSeconds: 0 },
275
- error: `Batch size ${req.length} exceeds maximum of ${this.maxBatchSize}`,
276
- };
277
- return { response: errorResponse };
278
- }
279
- response = await Promise.all(req.map((r) => this.processRequestHttp(r, ip, httpReq)));
195
+ if (Array.isArray(request)) {
196
+ throw new PublicError("Streaming RPC accepts one call, not a batch");
280
197
  }
281
- else {
282
- response = await this.processRequestHttp(req, ip, httpReq);
198
+ if (!isRpcRequest(request)) {
199
+ throw new PublicError("Invalid request format");
283
200
  }
284
- return { response };
201
+ this.checkRateLimit(ip);
202
+ await this.invoke(request, ip, req, signal, async (result, iterationSignal) => {
203
+ if (!isAsyncIterable(result)) {
204
+ throw new PublicError("Streaming RPC requires a method returning an AsyncIterable. Use callMethod() for unary methods.");
205
+ }
206
+ const iterator = result[Symbol.asyncIterator]();
207
+ let completed = false;
208
+ try {
209
+ while (!iterationSignal.aborted) {
210
+ const item = await abortable(iterator.next(), iterationSignal);
211
+ if (item.done) {
212
+ completed = true;
213
+ break;
214
+ }
215
+ iterationSignal.throwIfAborted();
216
+ await abortable(onChunk(item.value, iterationSignal), iterationSignal);
217
+ }
218
+ }
219
+ finally {
220
+ if (!completed && iterator.return) {
221
+ const cleanup = trackRequestCleanup(req, iterator.return());
222
+ if (iterationSignal.aborted) {
223
+ void cleanup.catch(() => { });
224
+ }
225
+ else {
226
+ await abortable(cleanup, iterationSignal);
227
+ }
228
+ }
229
+ }
230
+ });
231
+ return this.getStats(ip);
285
232
  }
286
233
  }
287
234
  function requestId(value) {
288
- if (value && typeof value === "object" && "id" in value) {
289
- const id = value.id;
290
- if (typeof id === "string" || (typeof id === "number" && Number.isFinite(id))) {
291
- return id;
292
- }
235
+ if (value && typeof value === "object" && "id" in value && (typeof value.id === "string" || (typeof value.id === "number" && Number.isFinite(value.id)))) {
236
+ return value.id;
293
237
  }
294
238
  return "unknown";
295
239
  }
@@ -303,46 +247,9 @@ function isRpcRequest(value) {
303
247
  typeof value.method === "string" &&
304
248
  value.method.length > 0);
305
249
  }
306
- function invalidRequest(value, stats) {
307
- return { id: requestId(value), ok: false, stats, error: "Invalid request format" };
308
- }
309
- /**
310
- * Sanitize error messages before sending to clients.
311
- * In production, returns a generic message to prevent information leakage.
312
- * In development, returns the actual error message for debugging.
313
- */
314
- function sanitizeErrorMessage(err) {
315
- const message = getErrorMessage(err);
316
- const isPublic = isPublicError(err);
317
- if (process.env.NODE_ENV === "production") {
318
- if (isPublic && message) {
319
- return message;
320
- }
321
- return "Server error";
322
- }
323
- if (message) {
324
- return message;
325
- }
326
- return "Server error";
327
- }
328
- function isPublicError(err) {
329
- if (err instanceof PublicError) {
330
- return true;
331
- }
332
- if (!err || typeof err !== "object") {
333
- return false;
334
- }
335
- const publicFlag = err.public;
336
- return publicFlag === true;
337
- }
338
- function getErrorMessage(err) {
339
- if (err instanceof Error) {
340
- return err.message;
341
- }
342
- if (err && typeof err === "object") {
343
- const message = err.message;
344
- return typeof message === "string" ? message : null;
345
- }
346
- return null;
250
+ export function sanitizeErrorMessage(error) {
251
+ const message = error instanceof Error ? error.message : error && typeof error === "object" && "message" in error && typeof error.message === "string" ? error.message : null;
252
+ const isPublic = error instanceof PublicError || (error !== null && typeof error === "object" && "public" in error && error.public === true);
253
+ return process.env.NODE_ENV === "production" && !isPublic ? "Server error" : message || "Server error";
347
254
  }
348
255
  //# sourceMappingURL=rpcRegistry.js.map
@@ -1 +1 @@
1
- {"version":3,"file":"rpcRegistry.js","sourceRoot":"","sources":["../../src/server/rpcRegistry.ts"],"names":[],"mappings":"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","sourcesContent":["import { decode as msgpackDecode, encode as msgpackEncode } from \"@msgpack/msgpack\";\nimport type http from \"http\";\nimport { promisify } from \"util\";\nimport WebSocket from \"ws\";\nimport { gzip } from \"zlib\";\n\nimport type { RpcRequest, RpcResponse, RpcStats } from \"../runtime/protocol.js\";\nimport { log } from \"../utils/logger.js\";\nimport type { HeliumCompressionConfig } from \"./config.js\";\nimport { getCompressionConfig } from \"./config.js\";\nimport type { HeliumContext } from \"./context.js\";\nimport type { HeliumMethodDef } from \"./defineMethod.js\";\nimport type { HeliumMiddleware } from \"./middleware.js\";\nimport type { RateLimiter } from \"./rateLimiter.js\";\nimport { prepareForMsgpack } from \"./serializer.js\";\n\nconst gzipAsync = promisify(gzip);\n\ninterface SocketMetadata {\n ip: string;\n req: http.IncomingMessage;\n}\n\nexport interface HttpRpcResult {\n response: RpcResponse | RpcResponse[];\n}\n\nexport class PublicError extends Error {\n public readonly public = true;\n}\n\nexport class RpcRegistry {\n private methods = new Map<string, HeliumMethodDef<any, any>>();\n private middleware: HeliumMiddleware | null = null;\n private rateLimiter: RateLimiter | null = null;\n private socketMetadata = new WeakMap<WebSocket, SocketMetadata>();\n private maxBatchSize: number = 20;\n private compression = getCompressionConfig();\n\n register(id: string, def: HeliumMethodDef<any, any>) {\n def.__id = id;\n this.methods.set(id, def);\n }\n\n setMiddleware(middleware: HeliumMiddleware) {\n this.middleware = middleware;\n }\n\n setRateLimiter(rateLimiter: RateLimiter) {\n this.rateLimiter = rateLimiter;\n }\n\n setMaxBatchSize(size: number) {\n this.maxBatchSize = size;\n }\n\n setCompressionConfig(config: HeliumCompressionConfig) {\n this.compression = getCompressionConfig({ rpc: { compression: config } });\n }\n\n /**\n * Store metadata about a WebSocket connection.\n * Should be called when a new connection is established.\n */\n setSocketMetadata(socket: WebSocket, ip: string, req: http.IncomingMessage) {\n this.socketMetadata.set(socket, { ip, req });\n }\n\n private getStats(socket: WebSocket): RpcStats {\n if (!this.rateLimiter) {\n return { remainingRequests: Infinity, resetInSeconds: 0 };\n }\n\n const stats = this.rateLimiter.getConnectionStats(socket);\n if (!stats) {\n return { remainingRequests: 0, resetInSeconds: 0 };\n }\n\n const now = Date.now();\n const resetInSeconds = Math.ceil((stats.resetTimeMs - now) / 1000);\n\n return {\n remainingRequests: stats.remainingMessages,\n resetInSeconds: Math.max(0, resetInSeconds),\n };\n }\n\n private async processRequest(value: unknown, socket: WebSocket): Promise<RpcResponse> {\n if (!isRpcRequest(value)) {\n return invalidRequest(value, this.getStats(socket));\n }\n const req = value;\n const def = this.methods.get(req.method);\n if (!def) {\n return {\n id: req.id,\n ok: false,\n stats: this.getStats(socket),\n error: `Unknown method ${req.method}`,\n };\n }\n\n try {\n // Build context with request metadata\n const metadata = this.socketMetadata.get(socket);\n const ctx: HeliumContext = {\n req: {\n ip: metadata?.ip || \"unknown\",\n headers: metadata?.req.headers || {},\n url: metadata?.req.url,\n method: metadata?.req.method,\n raw: metadata?.req as http.IncomingMessage,\n },\n };\n let result: any;\n\n // Execute middleware if present\n if (this.middleware) {\n let nextCalled = false;\n await this.middleware.handler(\n {\n ctx,\n type: \"method\",\n methodName: req.method,\n },\n async () => {\n nextCalled = true;\n result = await def.handler(req.args, ctx);\n }\n );\n\n // If next() was not called, the middleware blocked the request\n if (!nextCalled) {\n return {\n id: req.id,\n ok: false,\n stats: this.getStats(socket),\n error: \"Request blocked by middleware\",\n };\n }\n } else {\n // No middleware, execute handler directly\n result = await def.handler(req.args, ctx);\n }\n\n return {\n id: req.id,\n ok: true,\n stats: this.getStats(socket),\n result,\n };\n } catch (err: any) {\n log(\"error\", `RPC method '${req.method}' failed:`, err);\n return {\n id: req.id,\n ok: false,\n stats: this.getStats(socket),\n error: sanitizeErrorMessage(err),\n };\n }\n }\n\n async handleMessage(socket: WebSocket, raw: string | Buffer) {\n let req: RpcRequest | RpcRequest[];\n try {\n // Always expect MessagePack\n const buffer = Buffer.isBuffer(raw) ? raw : Buffer.from(raw);\n req = msgpackDecode(buffer) as RpcRequest | RpcRequest[];\n } catch {\n return;\n }\n\n // Security: cap batch size\n if (Array.isArray(req) && req.length > this.maxBatchSize) {\n const errorResponse: RpcResponse = {\n id: \"batch\",\n ok: false,\n stats: this.getStats(socket),\n error: `Batch size ${req.length} exceeds maximum of ${this.maxBatchSize}`,\n };\n await this.sendResponse(socket, errorResponse);\n return;\n }\n\n let response: RpcResponse | RpcResponse[];\n if (Array.isArray(req)) {\n response = await Promise.all(req.map((r) => this.processRequest(r, socket)));\n } else {\n response = await this.processRequest(req, socket);\n }\n\n await this.sendResponse(socket, response);\n }\n\n private async sendResponse(socket: WebSocket, response: RpcResponse | RpcResponse[]): Promise<void> {\n const encoded = msgpackEncode(prepareForMsgpack(response));\n const compress = this.compression.enabled && encoded.length > this.compression.threshold;\n const body = compress ? await gzipAsync(encoded) : encoded;\n // With context takeover, ws ignores its threshold option. Make the\n // per-message choice explicit so both compression layers honor it.\n socket.send(body, { compress });\n }\n\n private async processRequestHttp(value: unknown, ip: string, httpReq: http.IncomingMessage): Promise<RpcResponse> {\n if (!isRpcRequest(value)) {\n return invalidRequest(value, { remainingRequests: 0, resetInSeconds: 0 });\n }\n const req = value;\n const def = this.methods.get(req.method);\n if (!def) {\n return {\n id: req.id,\n ok: false,\n stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },\n error: `Unknown method ${req.method}`,\n };\n }\n\n try {\n // Build context with request metadata\n const ctx: HeliumContext = {\n req: {\n ip,\n headers: httpReq.headers,\n url: httpReq.url,\n method: httpReq.method,\n raw: httpReq,\n },\n };\n let result: unknown;\n\n // Execute middleware if present\n if (this.middleware) {\n let nextCalled = false;\n await this.middleware.handler(\n {\n ctx,\n type: \"method\",\n methodName: req.method,\n },\n async () => {\n nextCalled = true;\n result = await def.handler(req.args, ctx);\n }\n );\n\n if (!nextCalled) {\n return {\n id: req.id,\n ok: false,\n stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },\n error: \"Request blocked by middleware\",\n };\n }\n } else {\n result = await def.handler(req.args, ctx);\n }\n\n return {\n id: req.id,\n ok: true,\n stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },\n result,\n };\n } catch (err: unknown) {\n log(\"error\", `HTTP RPC method '${req.method}' failed:`, err);\n return {\n id: req.id,\n ok: false,\n stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },\n error: sanitizeErrorMessage(err),\n };\n }\n }\n\n /**\n * Handle an HTTP-based RPC request.\n * This is an alternative to WebSocket for environments where HTTP performs better\n * (e.g., mobile networks with high latency where HTTP/2 multiplexing helps).\n */\n async handleHttpRequest(reqBody: Buffer | string, ip: string, httpReq: http.IncomingMessage): Promise<HttpRpcResult> {\n let req: RpcRequest | RpcRequest[];\n\n try {\n // Always expect MessagePack\n const buffer = Buffer.isBuffer(reqBody) ? reqBody : Buffer.from(reqBody);\n req = msgpackDecode(buffer) as RpcRequest | RpcRequest[];\n } catch {\n const errorResponse: RpcResponse = {\n id: \"unknown\",\n ok: false,\n stats: { remainingRequests: 0, resetInSeconds: 0 },\n error: \"Invalid request format\",\n };\n return {\n response: errorResponse,\n };\n }\n\n if (this.rateLimiter && !this.rateLimiter.checkHttpRateLimit(ip)) {\n const stats = this.rateLimiter.getHttpStats(ip);\n const reject = (value: unknown): RpcResponse => ({\n id: requestId(value),\n ok: false,\n stats,\n error: \"Rate limit exceeded\",\n });\n return { response: Array.isArray(req) ? req.slice(0, this.maxBatchSize).map(reject) : reject(req) };\n }\n\n let response: RpcResponse | RpcResponse[];\n if (Array.isArray(req)) {\n // Security: cap batch size\n if (req.length > this.maxBatchSize) {\n const errorResponse: RpcResponse = {\n id: \"batch\",\n ok: false,\n stats: { remainingRequests: 0, resetInSeconds: 0 },\n error: `Batch size ${req.length} exceeds maximum of ${this.maxBatchSize}`,\n };\n return { response: errorResponse };\n }\n response = await Promise.all(req.map((r) => this.processRequestHttp(r, ip, httpReq)));\n } else {\n response = await this.processRequestHttp(req as RpcRequest, ip, httpReq);\n }\n\n return { response };\n }\n}\n\nfunction requestId(value: unknown): string | number {\n if (value && typeof value === \"object\" && \"id\" in value) {\n const id = value.id;\n if (typeof id === \"string\" || (typeof id === \"number\" && Number.isFinite(id))) {\n return id;\n }\n }\n return \"unknown\";\n}\n\nfunction isRpcRequest(value: unknown): value is RpcRequest {\n return (\n value !== null &&\n typeof value === \"object\" &&\n !Array.isArray(value) &&\n \"id\" in value &&\n (typeof value.id === \"string\" || (typeof value.id === \"number\" && Number.isFinite(value.id))) &&\n \"method\" in value &&\n typeof value.method === \"string\" &&\n value.method.length > 0\n );\n}\n\nfunction invalidRequest(value: unknown, stats: RpcStats): RpcResponse {\n return { id: requestId(value), ok: false, stats, error: \"Invalid request format\" };\n}\n\n/**\n * Sanitize error messages before sending to clients.\n * In production, returns a generic message to prevent information leakage.\n * In development, returns the actual error message for debugging.\n */\nfunction sanitizeErrorMessage(err: unknown): string {\n const message = getErrorMessage(err);\n const isPublic = isPublicError(err);\n\n if (process.env.NODE_ENV === \"production\") {\n if (isPublic && message) {\n return message;\n }\n return \"Server error\";\n }\n\n if (message) {\n return message;\n }\n\n return \"Server error\";\n}\n\nfunction isPublicError(err: unknown): boolean {\n if (err instanceof PublicError) {\n return true;\n }\n\n if (!err || typeof err !== \"object\") {\n return false;\n }\n\n const publicFlag = (err as { public?: unknown }).public;\n return publicFlag === true;\n}\n\nfunction getErrorMessage(err: unknown): string | null {\n if (err instanceof Error) {\n return err.message;\n }\n\n if (err && typeof err === \"object\") {\n const message = (err as { message?: unknown }).message;\n return typeof message === \"string\" ? message : null;\n }\n\n return null;\n}\n"]}
1
+ {"version":3,"file":"rpcRegistry.js","sourceRoot":"","sources":["../../src/server/rpcRegistry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,aAAa,EAAE,MAAM,kBAAkB,CAAC;AAI3D,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAKzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAMzD,MAAM,OAAO,WAAY,SAAQ,KAAK;IAAtC;;QACoB,WAAM,GAAG,IAAI,CAAC;IAClC,CAAC;CAAA;AAED,MAAM,UAAU,eAAe,CAAC,KAAc;IAC1C,OAAO,KAAK,KAAK,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,UAAU,CAAC,IAAI,OAAQ,KAAgC,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,UAAU,CAAC;AACzK,CAAC;AAED,iFAAiF;AACjF,MAAM,UAAU,SAAS,CAAI,KAAyB,EAAE,MAAmB;IACvE,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACjB,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAC7B,OAAO,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;IACzE,CAAC;IACD,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACnC,MAAM,OAAO,GAAG,GAAG,EAAE;YACjB,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,iBAAiB,CAAC,CAAC,CAAC;QAC1D,CAAC,CAAC;QACF,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC;QACnE,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,IAAI,CACR,CAAC,MAAM,EAAE,EAAE;YACP,OAAO,EAAE,CAAC;YACV,OAAO,CAAC,MAAM,CAAC,CAAC;QACpB,CAAC,EACD,CAAC,KAAK,EAAE,EAAE;YACN,OAAO,EAAE,CAAC;YACV,MAAM,CAAC,KAAK,CAAC,CAAC;QAClB,CAAC,CACJ,CAAC;IACN,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,OAAO,WAAW;IAAxB;QACY,YAAO,GAAG,IAAI,GAAG,EAAqC,CAAC;QACvD,eAAU,GAA4B,IAAI,CAAC;QAC3C,gBAAW,GAAuB,IAAI,CAAC;QACvC,iBAAY,GAAG,EAAE,CAAC;IAsM9B,CAAC;IApMG,QAAQ,CAAC,EAAU,EAAE,GAA8B;QAC/C,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;QACd,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,CAAC,CAAC;IAC9B,CAAC;IACD,aAAa,CAAC,UAA4B;QACtC,IAAI,CAAC,UAAU,GAAG,UAAU,CAAC;IACjC,CAAC;IACD,cAAc,CAAC,WAAwB;QACnC,IAAI,CAAC,WAAW,GAAG,WAAW,CAAC;IACnC,CAAC;IACD,eAAe,CAAC,IAAY;QACxB,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC7B,CAAC;IACD,QAAQ,CAAC,EAAU;QACf,OAAO,IAAI,CAAC,WAAW,EAAE,YAAY,CAAC,EAAE,CAAC,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;IACpG,CAAC;IAEO,KAAK,CAAC,MAAM,CAChB,OAAmB,EACnB,EAAU,EACV,GAAyB,EACzB,MAAmB,EACnB,OAAgE;QAEhE,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;QAC7C,IAAI,CAAC,GAAG,EAAE,CAAC;YACP,MAAM,IAAI,WAAW,CAAC,kBAAkB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC;QAC9D,CAAC;QACD,wEAAwE;QACxE,0EAA0E;QAC1E,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,KAAK,GAAG,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;QACpD,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QACxD,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YACjB,KAAK,EAAE,CAAC;QACZ,CAAC;QACD,MAAM,YAAY,GAAG,UAAU,CAAC,MAAM,CAAC;QACvC,MAAM,GAAG,GAAkB,EAAE,MAAM,EAAE,YAAY,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC;QACnI,IAAI,MAAM,GAAG,KAAK,CAAC;QACnB,IAAI,IAA+B,CAAC;QACpC,MAAM,IAAI,GAAG,GAAkB,EAAE;YAC7B,IAAI,MAAM,EAAE,CAAC;gBACT,MAAM,KAAK,GAAG,IAAI,WAAW,CAAC,2CAA2C,CAAC,CAAC;gBAC3E,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACxB,MAAM,QAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;gBACvC,KAAK,QAAQ,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;gBAC9B,OAAO,QAAQ,CAAC;YACpB,CAAC;YACD,MAAM,GAAG,IAAI,CAAC;YACd,IAAI,GAAG,CAAC,KAAK,IAAI,EAAE;gBACf,YAAY,CAAC,cAAc,EAAE,CAAC;gBAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;gBAChE,IAAI,MAAe,CAAC;gBACpB,IAAI,CAAC;oBACD,MAAM,GAAG,MAAM,SAAS,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;gBACpD,CAAC;gBAAC,OAAO,KAAK,EAAE,CAAC;oBACb,IAAI,YAAY,CAAC,OAAO,EAAE,CAAC;wBACvB,KAAK,OAAO;6BACP,IAAI,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;4BACjB,IAAI,eAAe,CAAC,IAAI,CAAC,EAAE,CAAC;gCACxB,MAAM,mBAAmB,CAAC,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;4BAC5E,CAAC;wBACL,CAAC,CAAC;6BACD,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACzB,CAAC;oBACD,MAAM,KAAK,CAAC;gBAChB,CAAC;gBACD,MAAM,OAAO,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YACxC,CAAC,CAAC,EAAE,CAAC;YACL,oEAAoE;YACpE,iEAAiE;YACjE,KAAK,IAAI,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YAC1B,OAAO,IAAI,CAAC;QAChB,CAAC,CAAC;QACF,IAAI,CAAC;YACD,YAAY,CAAC,cAAc,EAAE,CAAC;YAC9B,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;gBAClB,MAAM,SAAS,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,EAAE,GAAG,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,CAAC,MAAM,EAAE,EAAE,IAAI,CAAC,EAAE,YAAY,CAAC,CAAC;gBAClH,IAAI,CAAC,MAAM,EAAE,CAAC;oBACV,MAAM,IAAI,WAAW,CAAC,+BAA+B,CAAC,CAAC;gBAC3D,CAAC;YACL,CAAC;iBAAM,CAAC;gBACJ,IAAI,EAAE,CAAC;YACX,CAAC;YACD,IAAI,IAAI,EAAE,CAAC;gBACP,MAAM,SAAS,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;YACxC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YACxB,MAAM,KAAK,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC;QAC/C,CAAC;IACL,CAAC;IAEO,cAAc,CAAC,EAAU;QAC7B,IAAI,IAAI,CAAC,WAAW,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,kBAAkB,CAAC,EAAE,CAAC,EAAE,CAAC;YAC/D,MAAM,IAAI,WAAW,CAAC,qBAAqB,CAAC,CAAC;QACjD,CAAC;IACL,CAAC;IAED,KAAK,CAAC,iBAAiB,CAAC,IAAqB,EAAE,EAAU,EAAE,GAAyB,EAAE,SAAsB,IAAI,eAAe,EAAE,CAAC,MAAM;QACpI,IAAI,KAAc,CAAC;QACnB,IAAI,CAAC;YACD,KAAK,GAAG,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5E,CAAC;QAAC,MAAM,CAAC;YACL,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,wBAAwB,EAAE,EAAE,CAAC;QACjH,CAAC;QACD,MAAM,aAAa,GAAG,CAAC,KAAc,EAAE,KAAa,EAAe,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,SAAS,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC7I,IAAI,CAAC;YACD,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QAC5B,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACb,OAAO;gBACH,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;oBAC1B,CAAC,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;oBACnG,CAAC,CAAC,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC;aAC1D,CAAC;QACN,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC3D,OAAO,EAAE,QAAQ,EAAE,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,cAAc,KAAK,CAAC,MAAM,uBAAuB,IAAI,CAAC,YAAY,EAAE,EAAE,EAAE,CAAC;QAC3J,CAAC;QACD,MAAM,OAAO,GAAG,KAAK,EAAE,KAAc,EAAwB,EAAE;YAC3D,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,EAAE,CAAC;gBACvB,OAAO,aAAa,CAAC,KAAK,EAAE,wBAAwB,CAAC,CAAC;YAC1D,CAAC;YACD,IAAI,CAAC;gBACD,IAAI,MAAe,CAAC;gBACpB,MAAM,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,EAAE;oBACtD,IAAI,eAAe,CAAC,KAAK,CAAC,EAAE,CAAC;wBACzB,MAAM,QAAQ,GAAG,KAAK,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;wBAC/C,KAAK,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;wBACnE,MAAM,IAAI,WAAW,CAAC,+EAA+E,CAAC,CAAC;oBAC3G,CAAC;oBACD,MAAM,GAAG,KAAK,CAAC;gBACnB,CAAC,CAAC,CAAC;gBACH,OAAO,EAAE,EAAE,EAAE,KAAK,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC;YACxE,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAClB,GAAG,CAAC,OAAO,EAAE,eAAe,KAAK,CAAC,MAAM,WAAW,EAAE,KAAK,CAAC,CAAC;gBAChE,CAAC;gBACD,OAAO,aAAa,CAAC,KAAK,EAAE,oBAAoB,CAAC,KAAK,CAAC,CAAC,CAAC;YAC7D,CAAC;QACL,CAAC,CAAC;QACF,OAAO,EAAE,QAAQ,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;IAC7G,CAAC;IAED,KAAK,CAAC,mBAAmB,CACrB,IAAY,EACZ,EAAU,EACV,GAAyB,EACzB,MAAmB,EACnB,OAA+D;QAE/D,IAAI,OAAgB,CAAC;QACrB,IAAI,CAAC;YACD,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;QAClC,CAAC;QAAC,MAAM,CAAC;YACL,MAAM,IAAI,WAAW,CAAC,wBAAwB,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,WAAW,CAAC,6CAA6C,CAAC,CAAC;QACzE,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,OAAO,CAAC,EAAE,CAAC;YACzB,MAAM,IAAI,WAAW,CAAC,wBAAwB,CAAC,CAAC;QACpD,CAAC;QACD,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC,CAAC;QACxB,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,EAAE,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,eAAe,EAAE,EAAE;YAC1E,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC3B,MAAM,IAAI,WAAW,CAAC,iGAAiG,CAAC,CAAC;YAC7H,CAAC;YACD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,aAAa,CAAC,EAAE,CAAC;YAChD,IAAI,SAAS,GAAG,KAAK,CAAC;YACtB,IAAI,CAAC;gBACD,OAAO,CAAC,eAAe,CAAC,OAAO,EAAE,CAAC;oBAC9B,MAAM,IAAI,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,eAAe,CAAC,CAAC;oBAC/D,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;wBACZ,SAAS,GAAG,IAAI,CAAC;wBACjB,MAAM;oBACV,CAAC;oBACD,eAAe,CAAC,cAAc,EAAE,CAAC;oBACjC,MAAM,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,eAAe,CAAC,EAAE,eAAe,CAAC,CAAC;gBAC3E,CAAC;YACL,CAAC;oBAAS,CAAC;gBACP,IAAI,CAAC,SAAS,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;oBAChC,MAAM,OAAO,GAAG,mBAAmB,CAAC,GAAG,EAAE,QAAQ,CAAC,MAAM,EAAE,CAAC,CAAC;oBAC5D,IAAI,eAAe,CAAC,OAAO,EAAE,CAAC;wBAC1B,KAAK,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;oBACjC,CAAC;yBAAM,CAAC;wBACJ,MAAM,SAAS,CAAC,OAAO,EAAE,eAAe,CAAC,CAAC;oBAC9C,CAAC;gBACL,CAAC;YACL,CAAC;QACL,CAAC,CAAC,CAAC;QACH,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC7B,CAAC;CACJ;AAED,SAAS,SAAS,CAAC,KAAc;IAC7B,IAAI,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,IAAI,IAAI,KAAK,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvJ,OAAO,KAAK,CAAC,EAAE,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AACrB,CAAC;AAED,SAAS,YAAY,CAAC,KAAc;IAChC,OAAO,CACH,KAAK,KAAK,IAAI;QACd,OAAO,KAAK,KAAK,QAAQ;QACzB,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QACrB,IAAI,IAAI,KAAK;QACb,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,CAAC,OAAO,KAAK,CAAC,EAAE,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC,CAAC;QAC7F,QAAQ,IAAI,KAAK;QACjB,OAAO,KAAK,CAAC,MAAM,KAAK,QAAQ;QAChC,KAAK,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAC1B,CAAC;AACN,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,KAAc;IAC/C,MAAM,OAAO,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,SAAS,IAAI,KAAK,IAAI,OAAO,KAAK,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9K,MAAM,QAAQ,GAAG,KAAK,YAAY,WAAW,IAAI,CAAC,KAAK,KAAK,IAAI,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,QAAQ,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,IAAI,CAAC,CAAC;IAC7I,OAAO,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,OAAO,IAAI,cAAc,CAAC;AAC3G,CAAC","sourcesContent":["import { decode as msgpackDecode } from \"@msgpack/msgpack\";\nimport type http from \"http\";\n\nimport type { RpcRequest, RpcResponse, RpcStats } from \"../runtime/protocol.js\";\nimport { log } from \"../utils/logger.js\";\nimport type { HeliumContext } from \"./context.js\";\nimport type { HeliumMethodDef } from \"./defineMethod.js\";\nimport type { HeliumMiddleware } from \"./middleware.js\";\nimport type { RateLimiter } from \"./rateLimiter.js\";\nimport { trackRequestCleanup } from \"./requestSignal.js\";\n\nexport interface HttpRpcResult {\n response: RpcResponse | RpcResponse[];\n}\n\nexport class PublicError extends Error {\n public readonly public = true;\n}\n\nexport function isAsyncIterable(value: unknown): value is AsyncIterable<unknown> {\n return value !== null && (typeof value === \"object\" || typeof value === \"function\") && typeof (value as AsyncIterable<unknown>)[Symbol.asyncIterator] === \"function\";\n}\n\n/** Reject promptly on disconnect even when provider work has not settled yet. */\nexport function abortable<T>(value: PromiseLike<T> | T, signal: AbortSignal): Promise<T> {\n const promise = Promise.resolve(value);\n if (signal.aborted) {\n void promise.catch(() => {});\n return Promise.reject(signal.reason ?? new Error(\"Request aborted\"));\n }\n return new Promise((resolve, reject) => {\n const onAbort = () => {\n cleanup();\n reject(signal.reason ?? new Error(\"Request aborted\"));\n };\n const cleanup = () => signal.removeEventListener(\"abort\", onAbort);\n signal.addEventListener(\"abort\", onAbort, { once: true });\n promise.then(\n (result) => {\n cleanup();\n resolve(result);\n },\n (error) => {\n cleanup();\n reject(error);\n }\n );\n });\n}\n\nexport class RpcRegistry {\n private methods = new Map<string, HeliumMethodDef<any, any>>();\n private middleware: HeliumMiddleware | null = null;\n private rateLimiter: RateLimiter | null = null;\n private maxBatchSize = 20;\n\n register(id: string, def: HeliumMethodDef<any, any>) {\n def.__id = id;\n this.methods.set(id, def);\n }\n setMiddleware(middleware: HeliumMiddleware) {\n this.middleware = middleware;\n }\n setRateLimiter(rateLimiter: RateLimiter) {\n this.rateLimiter = rateLimiter;\n }\n setMaxBatchSize(size: number) {\n this.maxBatchSize = size;\n }\n getStats(ip: string): RpcStats {\n return this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 };\n }\n\n private async invoke(\n request: RpcRequest,\n ip: string,\n req: http.IncomingMessage,\n signal: AbortSignal,\n consume: (result: unknown, signal: AbortSignal) => Promise<void>\n ): Promise<void> {\n signal.throwIfAborted();\n const def = this.methods.get(request.method);\n if (!def) {\n throw new PublicError(`Unknown method ${request.method}`);\n }\n // A method can also stop when middleware fails while next() is running.\n // Keep the response signal alive long enough to deliver a terminal error.\n const controller = new AbortController();\n const abort = () => controller.abort(signal.reason);\n signal.addEventListener(\"abort\", abort, { once: true });\n if (signal.aborted) {\n abort();\n }\n const activeSignal = controller.signal;\n const ctx: HeliumContext = { signal: activeSignal, req: { ip, headers: req.headers, url: req.url, method: req.method, raw: req } };\n let called = false;\n let work: Promise<void> | undefined;\n const next = (): Promise<void> => {\n if (called) {\n const error = new PublicError(\"Middleware next() may only be called once\");\n controller.abort(error);\n const rejected = Promise.reject(error);\n void rejected.catch(() => {});\n return rejected;\n }\n called = true;\n work = (async () => {\n activeSignal.throwIfAborted();\n const pending = Promise.resolve(def.handler(request.args, ctx));\n let result: unknown;\n try {\n result = await abortable(pending, activeSignal);\n } catch (error) {\n if (activeSignal.aborted) {\n void pending\n .then(async (late) => {\n if (isAsyncIterable(late)) {\n await trackRequestCleanup(req, late[Symbol.asyncIterator]().return?.());\n }\n })\n .catch(() => {});\n }\n throw error;\n }\n await consume(result, activeSignal);\n })();\n // Middleware may call next() without returning/awaiting it. Observe\n // failures immediately, and still await the original work below.\n void work.catch(() => {});\n return work;\n };\n try {\n activeSignal.throwIfAborted();\n if (this.middleware) {\n await abortable(this.middleware.handler({ ctx, type: \"method\", methodName: request.method }, next), activeSignal);\n if (!called) {\n throw new PublicError(\"Request blocked by middleware\");\n }\n } else {\n next();\n }\n if (work) {\n await abortable(work, activeSignal);\n }\n } catch (error) {\n controller.abort(error);\n throw error;\n } finally {\n signal.removeEventListener(\"abort\", abort);\n }\n }\n\n private checkRateLimit(ip: string): void {\n if (this.rateLimiter && !this.rateLimiter.checkHttpRateLimit(ip)) {\n throw new PublicError(\"Rate limit exceeded\");\n }\n }\n\n async handleHttpRequest(body: Buffer | string, ip: string, req: http.IncomingMessage, signal: AbortSignal = new AbortController().signal): Promise<HttpRpcResult> {\n let value: unknown;\n try {\n value = msgpackDecode(Buffer.isBuffer(body) ? body : Buffer.from(body));\n } catch {\n return { response: { id: \"unknown\", ok: false, stats: this.getStats(ip), error: \"Invalid request format\" } };\n }\n const errorResponse = (input: unknown, error: string): RpcResponse => ({ id: requestId(input), ok: false, stats: this.getStats(ip), error });\n try {\n this.checkRateLimit(ip);\n } catch (error) {\n return {\n response: Array.isArray(value)\n ? value.slice(0, this.maxBatchSize).map((item) => errorResponse(item, sanitizeErrorMessage(error)))\n : errorResponse(value, sanitizeErrorMessage(error)),\n };\n }\n if (Array.isArray(value) && value.length > this.maxBatchSize) {\n return { response: { id: \"batch\", ok: false, stats: this.getStats(ip), error: `Batch size ${value.length} exceeds maximum of ${this.maxBatchSize}` } };\n }\n const process = async (input: unknown): Promise<RpcResponse> => {\n if (!isRpcRequest(input)) {\n return errorResponse(input, \"Invalid request format\");\n }\n try {\n let result: unknown;\n await this.invoke(input, ip, req, signal, async (value) => {\n if (isAsyncIterable(value)) {\n const iterator = value[Symbol.asyncIterator]();\n void trackRequestCleanup(req, iterator.return?.()).catch(() => {});\n throw new PublicError(\"This method returns a stream. Use useStreaming() instead of a unary RPC call.\");\n }\n result = value;\n });\n return { id: input.id, ok: true, stats: this.getStats(ip), result };\n } catch (error) {\n if (!signal.aborted) {\n log(\"error\", `RPC method '${input.method}' failed:`, error);\n }\n return errorResponse(input, sanitizeErrorMessage(error));\n }\n };\n return { response: Array.isArray(value) ? await Promise.all(value.map(process)) : await process(value) };\n }\n\n async handleStreamRequest(\n body: Buffer,\n ip: string,\n req: http.IncomingMessage,\n signal: AbortSignal,\n onChunk: (value: unknown, signal: AbortSignal) => Promise<void>\n ): Promise<RpcStats> {\n let request: unknown;\n try {\n request = msgpackDecode(body);\n } catch {\n throw new PublicError(\"Invalid request format\");\n }\n if (Array.isArray(request)) {\n throw new PublicError(\"Streaming RPC accepts one call, not a batch\");\n }\n if (!isRpcRequest(request)) {\n throw new PublicError(\"Invalid request format\");\n }\n this.checkRateLimit(ip);\n await this.invoke(request, ip, req, signal, async (result, iterationSignal) => {\n if (!isAsyncIterable(result)) {\n throw new PublicError(\"Streaming RPC requires a method returning an AsyncIterable. Use callMethod() for unary methods.\");\n }\n const iterator = result[Symbol.asyncIterator]();\n let completed = false;\n try {\n while (!iterationSignal.aborted) {\n const item = await abortable(iterator.next(), iterationSignal);\n if (item.done) {\n completed = true;\n break;\n }\n iterationSignal.throwIfAborted();\n await abortable(onChunk(item.value, iterationSignal), iterationSignal);\n }\n } finally {\n if (!completed && iterator.return) {\n const cleanup = trackRequestCleanup(req, iterator.return());\n if (iterationSignal.aborted) {\n void cleanup.catch(() => {});\n } else {\n await abortable(cleanup, iterationSignal);\n }\n }\n }\n });\n return this.getStats(ip);\n }\n}\n\nfunction requestId(value: unknown): string | number {\n if (value && typeof value === \"object\" && \"id\" in value && (typeof value.id === \"string\" || (typeof value.id === \"number\" && Number.isFinite(value.id)))) {\n return value.id;\n }\n return \"unknown\";\n}\n\nfunction isRpcRequest(value: unknown): value is RpcRequest {\n return (\n value !== null &&\n typeof value === \"object\" &&\n !Array.isArray(value) &&\n \"id\" in value &&\n (typeof value.id === \"string\" || (typeof value.id === \"number\" && Number.isFinite(value.id))) &&\n \"method\" in value &&\n typeof value.method === \"string\" &&\n value.method.length > 0\n );\n}\n\nexport function sanitizeErrorMessage(error: unknown): string {\n const message = error instanceof Error ? error.message : error && typeof error === \"object\" && \"message\" in error && typeof error.message === \"string\" ? error.message : null;\n const isPublic = error instanceof PublicError || (error !== null && typeof error === \"object\" && \"public\" in error && error.public === true);\n return process.env.NODE_ENV === \"production\" && !isPublic ? \"Server error\" : message || \"Server error\";\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"heliumPlugin.d.ts","sourceRoot":"","sources":["../../src/vite/heliumPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAkBnC,MAAM,CAAC,OAAO,UAAU,MAAM,IAAI,MAAM,CAwbvC;AAsID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAiBrG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAUhD"}
1
+ {"version":3,"file":"heliumPlugin.d.ts","sourceRoot":"","sources":["../../src/vite/heliumPlugin.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,MAAM,CAAC;AAkBnC,MAAM,CAAC,OAAO,UAAU,MAAM,IAAI,MAAM,CAsdvC;AA2ID;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAEzD;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,OAAO,CAiBrG;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAUhD"}