heliumts 0.9.5 → 0.9.7
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 +7 -3
- package/dist/bin/helium.js +61 -53
- package/dist/bin/helium.js.map +1 -1
- package/dist/client/Router.d.ts +2 -2
- package/dist/client/Router.d.ts.map +1 -1
- package/dist/client/Router.js +32 -29
- package/dist/client/Router.js.map +1 -1
- package/dist/client/cache.d.ts.map +1 -1
- package/dist/client/cache.js +13 -13
- package/dist/client/cache.js.map +1 -1
- package/dist/client/callMethod.d.ts +13 -0
- package/dist/client/callMethod.d.ts.map +1 -0
- package/dist/client/callMethod.js +10 -0
- package/dist/client/callMethod.js.map +1 -0
- package/dist/client/env.js.map +1 -1
- package/dist/client/index.d.ts +2 -1
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/routerManifest.d.ts.map +1 -1
- package/dist/client/routerManifest.js +18 -29
- package/dist/client/routerManifest.js.map +1 -1
- package/dist/client/rpcClient.d.ts +7 -3
- package/dist/client/rpcClient.d.ts.map +1 -1
- package/dist/client/rpcClient.js +80 -78
- package/dist/client/rpcClient.js.map +1 -1
- package/dist/client/transitions.d.ts +1 -1
- package/dist/client/transitions.d.ts.map +1 -1
- package/dist/client/useCall.d.ts.map +1 -1
- package/dist/client/useCall.js +4 -1
- package/dist/client/useCall.js.map +1 -1
- package/dist/client/useFetch.d.ts.map +1 -1
- package/dist/client/useFetch.js +48 -92
- package/dist/client/useFetch.js.map +1 -1
- package/dist/runtime/routeOrder.d.ts +3 -0
- package/dist/runtime/routeOrder.d.ts.map +1 -0
- package/dist/runtime/routeOrder.js +15 -0
- package/dist/runtime/routeOrder.js.map +1 -0
- package/dist/server/config.d.ts.map +1 -1
- package/dist/server/config.js +51 -26
- package/dist/server/config.js.map +1 -1
- package/dist/server/defineHTTPRequest.d.ts +1 -1
- package/dist/server/defineHTTPRequest.d.ts.map +1 -1
- package/dist/server/defineHTTPRequest.js.map +1 -1
- package/dist/server/defineWorker.d.ts.map +1 -1
- package/dist/server/defineWorker.js +68 -37
- package/dist/server/defineWorker.js.map +1 -1
- package/dist/server/devServer.d.ts.map +1 -1
- package/dist/server/devServer.js +70 -40
- 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 +138 -43
- package/dist/server/httpRouter.js.map +1 -1
- package/dist/server/meta.d.ts.map +1 -1
- package/dist/server/meta.js +23 -15
- package/dist/server/meta.js.map +1 -1
- package/dist/server/prodServer.d.ts.map +1 -1
- package/dist/server/prodServer.js +87 -46
- package/dist/server/prodServer.js.map +1 -1
- package/dist/server/rateLimiter.d.ts +9 -0
- package/dist/server/rateLimiter.d.ts.map +1 -1
- package/dist/server/rateLimiter.js +46 -0
- package/dist/server/rateLimiter.js.map +1 -1
- package/dist/server/requestHandler.d.ts +4 -0
- package/dist/server/requestHandler.d.ts.map +1 -0
- package/dist/server/requestHandler.js +20 -0
- package/dist/server/requestHandler.js.map +1 -0
- package/dist/server/rpcRegistry.d.ts +4 -0
- package/dist/server/rpcRegistry.d.ts.map +1 -1
- package/dist/server/rpcRegistry.js +60 -15
- package/dist/server/rpcRegistry.js.map +1 -1
- package/dist/server/security.d.ts.map +1 -1
- package/dist/server/security.js +3 -2
- package/dist/server/security.js.map +1 -1
- package/dist/server/serializer.js +17 -6
- package/dist/server/serializer.js.map +1 -1
- package/dist/server/ssr.d.ts +2 -1
- package/dist/server/ssr.d.ts.map +1 -1
- package/dist/server/ssr.js +29 -32
- package/dist/server/ssr.js.map +1 -1
- package/dist/utils/envLoader.js +1 -1
- package/dist/utils/envLoader.js.map +1 -1
- package/dist/utils/html.d.ts +7 -0
- package/dist/utils/html.d.ts.map +1 -0
- package/dist/utils/html.js +197 -0
- package/dist/utils/html.js.map +1 -0
- package/dist/utils/ipExtractor.d.ts +6 -52
- package/dist/utils/ipExtractor.d.ts.map +1 -1
- package/dist/utils/ipExtractor.js +21 -118
- package/dist/utils/ipExtractor.js.map +1 -1
- package/dist/vite/heliumPlugin.d.ts.map +1 -1
- package/dist/vite/heliumPlugin.js +75 -83
- package/dist/vite/heliumPlugin.js.map +1 -1
- package/dist/vite/scanner.d.ts +3 -0
- package/dist/vite/scanner.d.ts.map +1 -1
- package/dist/vite/scanner.js +89 -18
- package/dist/vite/scanner.js.map +1 -1
- package/dist/vite/ssg.d.ts +4 -0
- package/dist/vite/ssg.d.ts.map +1 -1
- package/dist/vite/ssg.js +66 -39
- package/dist/vite/ssg.js.map +1 -1
- package/dist/vite/virtualServerModule.d.ts +1 -1
- package/dist/vite/virtualServerModule.d.ts.map +1 -1
- package/dist/vite/virtualServerModule.js +28 -16
- package/dist/vite/virtualServerModule.js.map +1 -1
- package/package.json +12 -7
|
@@ -2,6 +2,7 @@ import { decode as msgpackDecode, encode as msgpackEncode } from "@msgpack/msgpa
|
|
|
2
2
|
import { promisify } from "util";
|
|
3
3
|
import { gzip } from "zlib";
|
|
4
4
|
import { log } from "../utils/logger.js";
|
|
5
|
+
import { getCompressionConfig } from "./config.js";
|
|
5
6
|
import { prepareForMsgpack } from "./serializer.js";
|
|
6
7
|
const gzipAsync = promisify(gzip);
|
|
7
8
|
export class PublicError extends Error {
|
|
@@ -17,6 +18,7 @@ export class RpcRegistry {
|
|
|
17
18
|
this.rateLimiter = null;
|
|
18
19
|
this.socketMetadata = new WeakMap();
|
|
19
20
|
this.maxBatchSize = 20;
|
|
21
|
+
this.compression = getCompressionConfig();
|
|
20
22
|
}
|
|
21
23
|
register(id, def) {
|
|
22
24
|
def.__id = id;
|
|
@@ -31,6 +33,9 @@ export class RpcRegistry {
|
|
|
31
33
|
setMaxBatchSize(size) {
|
|
32
34
|
this.maxBatchSize = size;
|
|
33
35
|
}
|
|
36
|
+
setCompressionConfig(config) {
|
|
37
|
+
this.compression = getCompressionConfig({ rpc: { compression: config } });
|
|
38
|
+
}
|
|
34
39
|
/**
|
|
35
40
|
* Store metadata about a WebSocket connection.
|
|
36
41
|
* Should be called when a new connection is established.
|
|
@@ -53,7 +58,11 @@ export class RpcRegistry {
|
|
|
53
58
|
resetInSeconds: Math.max(0, resetInSeconds),
|
|
54
59
|
};
|
|
55
60
|
}
|
|
56
|
-
async processRequest(
|
|
61
|
+
async processRequest(value, socket) {
|
|
62
|
+
if (!isRpcRequest(value)) {
|
|
63
|
+
return invalidRequest(value, this.getStats(socket));
|
|
64
|
+
}
|
|
65
|
+
const req = value;
|
|
57
66
|
const def = this.methods.get(req.method);
|
|
58
67
|
if (!def) {
|
|
59
68
|
return {
|
|
@@ -136,7 +145,7 @@ export class RpcRegistry {
|
|
|
136
145
|
stats: this.getStats(socket),
|
|
137
146
|
error: `Batch size ${req.length} exceeds maximum of ${this.maxBatchSize}`,
|
|
138
147
|
};
|
|
139
|
-
|
|
148
|
+
await this.sendResponse(socket, errorResponse);
|
|
140
149
|
return;
|
|
141
150
|
}
|
|
142
151
|
let response;
|
|
@@ -146,23 +155,27 @@ export class RpcRegistry {
|
|
|
146
155
|
else {
|
|
147
156
|
response = await this.processRequest(req, socket);
|
|
148
157
|
}
|
|
158
|
+
await this.sendResponse(socket, response);
|
|
159
|
+
}
|
|
160
|
+
async sendResponse(socket, response) {
|
|
149
161
|
const encoded = msgpackEncode(prepareForMsgpack(response));
|
|
150
|
-
|
|
151
|
-
|
|
152
|
-
|
|
153
|
-
|
|
154
|
-
}
|
|
155
|
-
else {
|
|
156
|
-
socket.send(encoded);
|
|
157
|
-
}
|
|
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 });
|
|
158
167
|
}
|
|
159
|
-
async processRequestHttp(
|
|
168
|
+
async processRequestHttp(value, ip, httpReq) {
|
|
169
|
+
if (!isRpcRequest(value)) {
|
|
170
|
+
return invalidRequest(value, { remainingRequests: 0, resetInSeconds: 0 });
|
|
171
|
+
}
|
|
172
|
+
const req = value;
|
|
160
173
|
const def = this.methods.get(req.method);
|
|
161
174
|
if (!def) {
|
|
162
175
|
return {
|
|
163
176
|
id: req.id,
|
|
164
177
|
ok: false,
|
|
165
|
-
stats: { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
178
|
+
stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
166
179
|
error: `Unknown method ${req.method}`,
|
|
167
180
|
};
|
|
168
181
|
}
|
|
@@ -193,7 +206,7 @@ export class RpcRegistry {
|
|
|
193
206
|
return {
|
|
194
207
|
id: req.id,
|
|
195
208
|
ok: false,
|
|
196
|
-
stats: { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
209
|
+
stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
197
210
|
error: "Request blocked by middleware",
|
|
198
211
|
};
|
|
199
212
|
}
|
|
@@ -204,7 +217,7 @@ export class RpcRegistry {
|
|
|
204
217
|
return {
|
|
205
218
|
id: req.id,
|
|
206
219
|
ok: true,
|
|
207
|
-
stats: { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
220
|
+
stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
208
221
|
result,
|
|
209
222
|
};
|
|
210
223
|
}
|
|
@@ -213,7 +226,7 @@ export class RpcRegistry {
|
|
|
213
226
|
return {
|
|
214
227
|
id: req.id,
|
|
215
228
|
ok: false,
|
|
216
|
-
stats: { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
229
|
+
stats: this.rateLimiter?.getHttpStats(ip) ?? { remainingRequests: Infinity, resetInSeconds: 0 },
|
|
217
230
|
error: sanitizeErrorMessage(err),
|
|
218
231
|
};
|
|
219
232
|
}
|
|
@@ -241,6 +254,16 @@ export class RpcRegistry {
|
|
|
241
254
|
response: errorResponse,
|
|
242
255
|
};
|
|
243
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) };
|
|
266
|
+
}
|
|
244
267
|
let response;
|
|
245
268
|
if (Array.isArray(req)) {
|
|
246
269
|
// Security: cap batch size
|
|
@@ -261,6 +284,28 @@ export class RpcRegistry {
|
|
|
261
284
|
return { response };
|
|
262
285
|
}
|
|
263
286
|
}
|
|
287
|
+
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
|
+
}
|
|
293
|
+
}
|
|
294
|
+
return "unknown";
|
|
295
|
+
}
|
|
296
|
+
function isRpcRequest(value) {
|
|
297
|
+
return (value !== null &&
|
|
298
|
+
typeof value === "object" &&
|
|
299
|
+
!Array.isArray(value) &&
|
|
300
|
+
"id" in value &&
|
|
301
|
+
(typeof value.id === "string" || (typeof value.id === "number" && Number.isFinite(value.id))) &&
|
|
302
|
+
"method" in value &&
|
|
303
|
+
typeof value.method === "string" &&
|
|
304
|
+
value.method.length > 0);
|
|
305
|
+
}
|
|
306
|
+
function invalidRequest(value, stats) {
|
|
307
|
+
return { id: requestId(value), ok: false, stats, error: "Invalid request format" };
|
|
308
|
+
}
|
|
264
309
|
/**
|
|
265
310
|
* Sanitize error messages before sending to clients.
|
|
266
311
|
* In production, returns a generic message to prevent information leakage.
|
|
@@ -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 { 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\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 /**\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(req: RpcRequest, socket: WebSocket): Promise<RpcResponse> {\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 socket.send(msgpackEncode(prepareForMsgpack(errorResponse)) as Buffer);\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 const encoded = msgpackEncode(prepareForMsgpack(response));\n // Compress if larger than 1KB\n if (encoded.length > 1024) {\n const compressed = await gzipAsync(encoded);\n socket.send(compressed);\n } else {\n socket.send(encoded as Buffer);\n }\n }\n\n private async processRequestHttp(req: RpcRequest, ip: string, httpReq: http.IncomingMessage): Promise<RpcResponse> {\n const def = this.methods.get(req.method);\n if (!def) {\n return {\n id: req.id,\n ok: false,\n stats: { 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: { 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: { 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: { 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 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\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":"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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 +1 @@
|
|
|
1
|
-
{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/server/security.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAO3D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,IAAI,
|
|
1
|
+
{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../src/server/security.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAO3D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,CAAC,uBAAuB,CAAC,GAAG,IAAI,CAkBlF;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAoC5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}
|
package/dist/server/security.js
CHANGED
|
@@ -33,11 +33,12 @@ export function verifyConnectionToken(token) {
|
|
|
33
33
|
log("warn", "Token missing");
|
|
34
34
|
return false;
|
|
35
35
|
}
|
|
36
|
-
const
|
|
37
|
-
if (!
|
|
36
|
+
const match = /^(\d+)\.([a-f0-9]{64})$/.exec(token);
|
|
37
|
+
if (!match) {
|
|
38
38
|
log("warn", "Invalid token format");
|
|
39
39
|
return false;
|
|
40
40
|
}
|
|
41
|
+
const [, timestamp, signature] = match;
|
|
41
42
|
// Check if token is expired
|
|
42
43
|
const ts = parseInt(timestamp, 10);
|
|
43
44
|
const now = Date.now();
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/server/security.ts"],"names":[],"mappings":"AAAA,OAAO,MAAM,MAAM,QAAQ,CAAC;AAE5B,OAAO,EAAE,GAAG,EAAE,MAAM,oBAAoB,CAAC;AAGzC,oEAAoE;AACpE,IAAI,aAAa,GAAW,EAAE,CAAC;AAC/B,IAAI,eAAkD,CAAC;AACvD,IAAI,aAAa,GAAG,KAAK,CAAC;AAE1B,MAAM,UAAU,kBAAkB,CAAC,MAAyC;IACxE,IAAI,CAAC,aAAa,EAAE,CAAC;QACjB,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;QAC5C,IAAI,CAAC,SAAS,EAAE,CAAC;YACb,aAAa,GAAG,MAAM,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;YACvD,IAAI,OAAO,CAAC,GAAG,CAAC,QAAQ,KAAK,YAAY,EAAE,CAAC;gBACxC,GAAG,
|
|
1
|
+
{"version":3,"file":"security.js","sourceRoot":"","sources":["../../src/server/security.ts"],"names":[],"mappings":"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","sourcesContent":["import crypto from \"crypto\";\n\nimport { log } from \"../utils/logger.js\";\nimport type { HeliumRpcSecurityConfig } from \"./config.js\";\n\n// Module-scoped secrets — not accessible via globalThis enumeration\nlet SERVER_SECRET: string = \"\";\nlet SECURITY_CONFIG: Required<HeliumRpcSecurityConfig>;\nlet isInitialized = false;\n\nexport function initializeSecurity(config: Required<HeliumRpcSecurityConfig>): void {\n if (!isInitialized) {\n const envSecret = process.env.HELIUM_SECRET;\n if (!envSecret) {\n SERVER_SECRET = crypto.randomBytes(32).toString(\"hex\");\n if (process.env.NODE_ENV === \"production\") {\n log(\n \"warn\",\n \"HELIUM_SECRET is not set. A random secret was generated. Tokens will NOT verify across cluster instances or restarts. Set HELIUM_SECRET for production.\"\n );\n }\n } else {\n SERVER_SECRET = envSecret;\n }\n SECURITY_CONFIG = config;\n isInitialized = true;\n log(\"info\", \"Security module initialized\");\n }\n}\n\nexport function generateConnectionToken(): string {\n const timestamp = Date.now().toString();\n const hmac = crypto.createHmac(\"sha256\", SERVER_SECRET);\n hmac.update(timestamp);\n const signature = hmac.digest(\"hex\");\n return `${timestamp}.${signature}`;\n}\n\nexport function verifyConnectionToken(token: string): boolean {\n if (!token) {\n log(\"warn\", \"Token missing\");\n return false;\n }\n\n const match = /^(\\d+)\\.([a-f0-9]{64})$/.exec(token);\n if (!match) {\n log(\"warn\", \"Invalid token format\");\n return false;\n }\n const [, timestamp, signature] = match;\n\n // Check if token is expired\n const ts = parseInt(timestamp, 10);\n const now = Date.now();\n const validityMs = SECURITY_CONFIG?.tokenValidityMs ?? 10000;\n if (isNaN(ts) || now - ts > validityMs || ts > now + 1000) {\n log(\"warn\", `Token expired. TS: ${ts}, Now: ${now}, Diff: ${now - ts}, ValidityMs: ${validityMs}`);\n return false;\n }\n\n const hmac = crypto.createHmac(\"sha256\", SERVER_SECRET);\n hmac.update(timestamp);\n const expectedSignature = hmac.digest(\"hex\");\n\n if (signature.length !== expectedSignature.length) {\n log(\"warn\", \"Signature length mismatch\");\n return false;\n }\n\n const isValid = crypto.timingSafeEqual(Buffer.from(signature), Buffer.from(expectedSignature));\n if (!isValid) {\n log(\"warn\", \"Invalid signature\");\n }\n return isValid;\n}\n\n/**\n * Reset security state. Only for testing.\n * @internal\n */\nexport function resetSecurity(): void {\n SERVER_SECRET = \"\";\n isInitialized = false;\n}\n"]}
|
|
@@ -17,11 +17,6 @@ function prepareForMsgpackInner(value, stack) {
|
|
|
17
17
|
if (typeof value !== "object") {
|
|
18
18
|
return value;
|
|
19
19
|
}
|
|
20
|
-
// Security: circular reference detection (only true cycles, not shared refs)
|
|
21
|
-
if (stack.has(value)) {
|
|
22
|
-
return null;
|
|
23
|
-
}
|
|
24
|
-
stack.add(value);
|
|
25
20
|
// Preserve MessagePack supported types
|
|
26
21
|
if (value instanceof Date) {
|
|
27
22
|
return value;
|
|
@@ -29,6 +24,11 @@ function prepareForMsgpackInner(value, stack) {
|
|
|
29
24
|
if (value instanceof Uint8Array) {
|
|
30
25
|
return value;
|
|
31
26
|
}
|
|
27
|
+
// Security: circular reference detection (only true cycles, not shared refs)
|
|
28
|
+
if (stack.has(value)) {
|
|
29
|
+
return null;
|
|
30
|
+
}
|
|
31
|
+
stack.add(value);
|
|
32
32
|
// Handle toJSON (e.g. Mongoose documents, custom classes)
|
|
33
33
|
const valueWithToJson = value;
|
|
34
34
|
if (typeof valueWithToJson.toJSON === "function") {
|
|
@@ -47,7 +47,18 @@ function prepareForMsgpackInner(value, stack) {
|
|
|
47
47
|
const newObj = {};
|
|
48
48
|
for (const key in value) {
|
|
49
49
|
if (Object.prototype.hasOwnProperty.call(value, key)) {
|
|
50
|
-
|
|
50
|
+
const prepared = prepareForMsgpackInner(value[key], stack);
|
|
51
|
+
if (key === "__proto__") {
|
|
52
|
+
Object.defineProperty(newObj, key, {
|
|
53
|
+
value: prepared,
|
|
54
|
+
enumerable: true,
|
|
55
|
+
writable: true,
|
|
56
|
+
configurable: true,
|
|
57
|
+
});
|
|
58
|
+
}
|
|
59
|
+
else {
|
|
60
|
+
newObj[key] = prepared;
|
|
61
|
+
}
|
|
51
62
|
}
|
|
52
63
|
}
|
|
53
64
|
stack.delete(value);
|
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/server/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,MAAM,KAAK,GAAG,IAAI,OAAO,EAAU,CAAC;IACpC,OAAO,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc,EAAE,KAAsB;IAClE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,
|
|
1
|
+
{"version":3,"file":"serializer.js","sourceRoot":"","sources":["../../src/server/serializer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAc;IAC5C,MAAM,KAAK,GAAG,IAAI,OAAO,EAAU,CAAC;IACpC,OAAO,sBAAsB,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC;AAChD,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc,EAAE,KAAsB;IAClE,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QACxC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC5B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,uCAAuC;IACvC,IAAI,KAAK,YAAY,IAAI,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,KAAK,YAAY,UAAU,EAAE,CAAC;QAC9B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,6EAA6E;IAC7E,IAAI,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IAChB,CAAC;IACD,KAAK,CAAC,GAAG,CAAC,KAAe,CAAC,CAAC;IAE3B,0DAA0D;IAC1D,MAAM,eAAe,GAAG,KAAmC,CAAC;IAC5D,IAAI,OAAO,eAAe,CAAC,MAAM,KAAK,UAAU,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,sBAAsB,CAAC,eAAe,CAAC,MAAM,EAAE,EAAE,KAAK,CAAC,CAAC;QACvE,KAAK,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,eAAe;IACf,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACvB,MAAM,MAAM,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,sBAAsB,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC,CAAC;QACxE,KAAK,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;QAC9B,OAAO,MAAM,CAAC;IAClB,CAAC;IAED,uBAAuB;IACvB,wDAAwD;IACxD,MAAM,MAAM,GAA4B,EAAE,CAAC;IAC3C,KAAK,MAAM,GAAG,IAAI,KAAK,EAAE,CAAC;QACtB,IAAI,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,EAAE,CAAC;YACnD,MAAM,QAAQ,GAAG,sBAAsB,CAAE,KAAiC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;YACxF,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBACtB,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;oBAC/B,KAAK,EAAE,QAAQ;oBACf,UAAU,EAAE,IAAI;oBAChB,QAAQ,EAAE,IAAI;oBACd,YAAY,EAAE,IAAI;iBACrB,CAAC,CAAC;YACP,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,GAAG,CAAC,GAAG,QAAQ,CAAC;YAC3B,CAAC;QACL,CAAC;IACL,CAAC;IACD,KAAK,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;IAC9B,OAAO,MAAM,CAAC;AAClB,CAAC","sourcesContent":["/**\n * Prepares data for MessagePack serialization by respecting .toJSON() methods.\n * This ensures that objects like ORM entities (Mongoose, Prisma, etc.) are\n * serialized correctly (hiding private fields, virtuals, etc.) and efficiently.\n *\n * It preserves MessagePack-supported types like Date and Uint8Array (Buffer).\n * Circular references are replaced with null to avoid runtime crashes.\n */\nexport function prepareForMsgpack(value: unknown): unknown {\n const stack = new WeakSet<object>();\n return prepareForMsgpackInner(value, stack);\n}\n\nfunction prepareForMsgpackInner(value: unknown, stack: WeakSet<object>): unknown {\n if (value === null || value === undefined) {\n return value;\n }\n if (typeof value !== \"object\") {\n return value;\n }\n\n // Preserve MessagePack supported types\n if (value instanceof Date) {\n return value;\n }\n if (value instanceof Uint8Array) {\n return value;\n }\n\n // Security: circular reference detection (only true cycles, not shared refs)\n if (stack.has(value as object)) {\n return null;\n }\n stack.add(value as object);\n\n // Handle toJSON (e.g. Mongoose documents, custom classes)\n const valueWithToJson = value as { toJSON?: () => unknown };\n if (typeof valueWithToJson.toJSON === \"function\") {\n const result = prepareForMsgpackInner(valueWithToJson.toJSON(), stack);\n stack.delete(value as object);\n return result;\n }\n\n // Handle Array\n if (Array.isArray(value)) {\n const result = value.map((item) => prepareForMsgpackInner(item, stack));\n stack.delete(value as object);\n return result;\n }\n\n // Handle Plain Objects\n // We create a new object to avoid mutating the original\n const newObj: Record<string, unknown> = {};\n for (const key in value) {\n if (Object.prototype.hasOwnProperty.call(value, key)) {\n const prepared = prepareForMsgpackInner((value as Record<string, unknown>)[key], stack);\n if (key === \"__proto__\") {\n Object.defineProperty(newObj, key, {\n value: prepared,\n enumerable: true,\n writable: true,\n configurable: true,\n });\n } else {\n newObj[key] = prepared;\n }\n }\n }\n stack.delete(value as object);\n return newObj;\n}\n"]}
|
package/dist/server/ssr.d.ts
CHANGED
|
@@ -41,8 +41,9 @@ export declare function resolveServerSideProps(args: {
|
|
|
41
41
|
params: Record<string, string | string[]>;
|
|
42
42
|
page: SSRPageDef;
|
|
43
43
|
ctx: HeliumContext;
|
|
44
|
+
search?: string;
|
|
44
45
|
}): Promise<SSRPropsResolution>;
|
|
45
|
-
export declare function createServerSidePropsRequest(req: IncomingMessage, pathname: string, params: Record<string, string | string[]
|
|
46
|
+
export declare function createServerSidePropsRequest(req: IncomingMessage, pathname: string, params: Record<string, string | string[]>, search?: string): ServerSidePropsRequest;
|
|
46
47
|
export declare function renderSSRHTML(args: {
|
|
47
48
|
htmlTemplate: string;
|
|
48
49
|
pathname: string;
|
package/dist/server/ssr.d.ts.map
CHANGED
|
@@ -1 +1 @@
|
|
|
1
|
-
{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../../src/server/ssr.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAuB,eAAe,EAAE,MAAM,MAAM,CAAC;AACjE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAK,MAAM,OAAO,CAAC;
|
|
1
|
+
{"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../../src/server/ssr.ts"],"names":[],"mappings":"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"}
|
package/dist/server/ssr.js
CHANGED
|
@@ -1,5 +1,7 @@
|
|
|
1
1
|
import React from "react";
|
|
2
2
|
import ReactDOMServer from "react-dom/server";
|
|
3
|
+
import { compareRoutePatterns } from "../runtime/routeOrder.js";
|
|
4
|
+
import { replaceHtmlRootContents } from "../utils/html.js";
|
|
3
5
|
function createMatcher(pattern) {
|
|
4
6
|
const segments = pattern.split("/").filter(Boolean);
|
|
5
7
|
return (path) => {
|
|
@@ -23,14 +25,14 @@ function createMatcher(pattern) {
|
|
|
23
25
|
return null;
|
|
24
26
|
}
|
|
25
27
|
if (seg.startsWith(":")) {
|
|
26
|
-
params[seg.slice(1)] =
|
|
28
|
+
params[seg.slice(1)] = safeDecodeURIComponent(value);
|
|
27
29
|
}
|
|
28
30
|
else if (seg !== value) {
|
|
29
31
|
return null;
|
|
30
32
|
}
|
|
31
33
|
}
|
|
32
34
|
const remainingSegments = pathSegments.slice(catchAllIndex);
|
|
33
|
-
params[catchAllParam] = remainingSegments.map((s) =>
|
|
35
|
+
params[catchAllParam] = remainingSegments.map((s) => safeDecodeURIComponent(s));
|
|
34
36
|
return { params };
|
|
35
37
|
}
|
|
36
38
|
if (segments.length !== pathSegments.length) {
|
|
@@ -40,7 +42,7 @@ function createMatcher(pattern) {
|
|
|
40
42
|
const seg = segments[i];
|
|
41
43
|
const value = pathSegments[i];
|
|
42
44
|
if (seg.startsWith(":")) {
|
|
43
|
-
params[seg.slice(1)] =
|
|
45
|
+
params[seg.slice(1)] = safeDecodeURIComponent(value);
|
|
44
46
|
}
|
|
45
47
|
else if (seg !== value) {
|
|
46
48
|
return null;
|
|
@@ -49,8 +51,17 @@ function createMatcher(pattern) {
|
|
|
49
51
|
return { params };
|
|
50
52
|
};
|
|
51
53
|
}
|
|
54
|
+
function safeDecodeURIComponent(value) {
|
|
55
|
+
try {
|
|
56
|
+
return decodeURIComponent(value);
|
|
57
|
+
}
|
|
58
|
+
catch {
|
|
59
|
+
return value;
|
|
60
|
+
}
|
|
61
|
+
}
|
|
52
62
|
export function matchSSRPage(pathname, pages) {
|
|
53
|
-
|
|
63
|
+
const orderedPages = [...pages].sort((a, b) => compareRoutePatterns(a.pathPattern, b.pathPattern));
|
|
64
|
+
for (const page of orderedPages) {
|
|
54
65
|
const match = createMatcher(page.pathPattern)(pathname);
|
|
55
66
|
if (match) {
|
|
56
67
|
return { page, params: match.params };
|
|
@@ -94,11 +105,11 @@ function normalizeRedirect(redirect) {
|
|
|
94
105
|
};
|
|
95
106
|
}
|
|
96
107
|
export async function resolveServerSideProps(args) {
|
|
97
|
-
const { req, pathname, params, page, ctx } = args;
|
|
108
|
+
const { req, pathname, params, page, ctx, search } = args;
|
|
98
109
|
if (!page.getServerSideProps) {
|
|
99
110
|
return { kind: "props", props: {} };
|
|
100
111
|
}
|
|
101
|
-
const request = createServerSidePropsRequest(req, pathname, params);
|
|
112
|
+
const request = createServerSidePropsRequest(req, pathname, params, search);
|
|
102
113
|
const result = await page.getServerSideProps(request, ctx);
|
|
103
114
|
if (isServerSideRedirectResult(result)) {
|
|
104
115
|
return {
|
|
@@ -111,10 +122,10 @@ export async function resolveServerSideProps(args) {
|
|
|
111
122
|
props: result ?? {},
|
|
112
123
|
};
|
|
113
124
|
}
|
|
114
|
-
export function createServerSidePropsRequest(req, pathname, params) {
|
|
125
|
+
export function createServerSidePropsRequest(req, pathname, params, search) {
|
|
115
126
|
const method = req.method || "GET";
|
|
116
127
|
const headers = headersToRecord(req.headers);
|
|
117
|
-
const rawUrl = req.url || pathname
|
|
128
|
+
const rawUrl = search === undefined ? req.url || pathname : `${pathname}${search}`;
|
|
118
129
|
return {
|
|
119
130
|
method,
|
|
120
131
|
path: pathname,
|
|
@@ -131,6 +142,7 @@ export async function renderSSRHTML(args) {
|
|
|
131
142
|
params,
|
|
132
143
|
page,
|
|
133
144
|
ctx,
|
|
145
|
+
search,
|
|
134
146
|
});
|
|
135
147
|
if (ssrResult.kind === "redirect") {
|
|
136
148
|
return { redirect: ssrResult.redirect };
|
|
@@ -144,7 +156,7 @@ export async function renderSSRHTML(args) {
|
|
|
144
156
|
params,
|
|
145
157
|
searchParams: new URLSearchParams(search),
|
|
146
158
|
};
|
|
147
|
-
const renderTree = (
|
|
159
|
+
const renderTree = () => {
|
|
148
160
|
const globalState = globalThis;
|
|
149
161
|
const previousRouterState = globalState.__HELIUM_SSR_ROUTER__;
|
|
150
162
|
globalState.__HELIUM_SSR_ROUTER__ = {
|
|
@@ -154,11 +166,9 @@ export async function renderSSRHTML(args) {
|
|
|
154
166
|
};
|
|
155
167
|
const WrappedPage = () => {
|
|
156
168
|
let content = React.createElement(PageComponent, pageProps);
|
|
157
|
-
|
|
158
|
-
|
|
159
|
-
|
|
160
|
-
content = React.createElement(Layout, { children: content });
|
|
161
|
-
}
|
|
169
|
+
for (let i = layouts.length - 1; i >= 0; i--) {
|
|
170
|
+
const Layout = layouts[i];
|
|
171
|
+
content = React.createElement(Layout, { children: content });
|
|
162
172
|
}
|
|
163
173
|
return content;
|
|
164
174
|
};
|
|
@@ -181,29 +191,16 @@ export async function renderSSRHTML(args) {
|
|
|
181
191
|
}
|
|
182
192
|
}
|
|
183
193
|
};
|
|
184
|
-
|
|
185
|
-
|
|
186
|
-
markup = renderTree(true);
|
|
187
|
-
}
|
|
188
|
-
catch (error) {
|
|
189
|
-
// Some app-level layout trees can fail on SSR due to circular imports or browser-only paths.
|
|
190
|
-
// Fallback to page-only SSR so we still return HTML instead of an empty shell.
|
|
191
|
-
try {
|
|
192
|
-
markup = renderTree(false);
|
|
193
|
-
}
|
|
194
|
-
catch {
|
|
195
|
-
throw error;
|
|
196
|
-
}
|
|
197
|
-
}
|
|
198
|
-
const serializedPayload = JSON.stringify({ path: pathname, props: ssrProps })
|
|
194
|
+
const markup = renderTree();
|
|
195
|
+
const serializedPayload = JSON.stringify({ path: pathname, search, props: ssrProps })
|
|
199
196
|
.replace(/</g, "\\u003c")
|
|
200
197
|
.replace(/\u2028/g, "\\u2028")
|
|
201
198
|
.replace(/\u2029/g, "\\u2029");
|
|
202
|
-
const htmlWithRoot = htmlTemplate
|
|
199
|
+
const htmlWithRoot = replaceHtmlRootContents(htmlTemplate, markup);
|
|
203
200
|
const scriptTag = `<script>window.__HELIUM_SSR_DATA__=${serializedPayload};</script>`;
|
|
204
|
-
if (
|
|
201
|
+
if (/<\/body\s*>/i.test(htmlWithRoot)) {
|
|
205
202
|
return {
|
|
206
|
-
html: htmlWithRoot.replace(
|
|
203
|
+
html: htmlWithRoot.replace(/<\/body\s*>/i, (closingBody) => `${scriptTag}\n${closingBody}`),
|
|
207
204
|
pageProps: ssrProps,
|
|
208
205
|
};
|
|
209
206
|
}
|