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.
Files changed (110) hide show
  1. package/README.md +7 -3
  2. package/dist/bin/helium.js +61 -53
  3. package/dist/bin/helium.js.map +1 -1
  4. package/dist/client/Router.d.ts +2 -2
  5. package/dist/client/Router.d.ts.map +1 -1
  6. package/dist/client/Router.js +32 -29
  7. package/dist/client/Router.js.map +1 -1
  8. package/dist/client/cache.d.ts.map +1 -1
  9. package/dist/client/cache.js +13 -13
  10. package/dist/client/cache.js.map +1 -1
  11. package/dist/client/callMethod.d.ts +13 -0
  12. package/dist/client/callMethod.d.ts.map +1 -0
  13. package/dist/client/callMethod.js +10 -0
  14. package/dist/client/callMethod.js.map +1 -0
  15. package/dist/client/env.js.map +1 -1
  16. package/dist/client/index.d.ts +2 -1
  17. package/dist/client/index.d.ts.map +1 -1
  18. package/dist/client/index.js +1 -0
  19. package/dist/client/index.js.map +1 -1
  20. package/dist/client/routerManifest.d.ts.map +1 -1
  21. package/dist/client/routerManifest.js +18 -29
  22. package/dist/client/routerManifest.js.map +1 -1
  23. package/dist/client/rpcClient.d.ts +7 -3
  24. package/dist/client/rpcClient.d.ts.map +1 -1
  25. package/dist/client/rpcClient.js +80 -78
  26. package/dist/client/rpcClient.js.map +1 -1
  27. package/dist/client/transitions.d.ts +1 -1
  28. package/dist/client/transitions.d.ts.map +1 -1
  29. package/dist/client/useCall.d.ts.map +1 -1
  30. package/dist/client/useCall.js +4 -1
  31. package/dist/client/useCall.js.map +1 -1
  32. package/dist/client/useFetch.d.ts.map +1 -1
  33. package/dist/client/useFetch.js +48 -92
  34. package/dist/client/useFetch.js.map +1 -1
  35. package/dist/runtime/routeOrder.d.ts +3 -0
  36. package/dist/runtime/routeOrder.d.ts.map +1 -0
  37. package/dist/runtime/routeOrder.js +15 -0
  38. package/dist/runtime/routeOrder.js.map +1 -0
  39. package/dist/server/config.d.ts.map +1 -1
  40. package/dist/server/config.js +51 -26
  41. package/dist/server/config.js.map +1 -1
  42. package/dist/server/defineHTTPRequest.d.ts +1 -1
  43. package/dist/server/defineHTTPRequest.d.ts.map +1 -1
  44. package/dist/server/defineHTTPRequest.js.map +1 -1
  45. package/dist/server/defineWorker.d.ts.map +1 -1
  46. package/dist/server/defineWorker.js +68 -37
  47. package/dist/server/defineWorker.js.map +1 -1
  48. package/dist/server/devServer.d.ts.map +1 -1
  49. package/dist/server/devServer.js +70 -40
  50. package/dist/server/devServer.js.map +1 -1
  51. package/dist/server/httpCompression.d.ts +8 -0
  52. package/dist/server/httpCompression.d.ts.map +1 -0
  53. package/dist/server/httpCompression.js +58 -0
  54. package/dist/server/httpCompression.js.map +1 -0
  55. package/dist/server/httpRouter.d.ts.map +1 -1
  56. package/dist/server/httpRouter.js +138 -43
  57. package/dist/server/httpRouter.js.map +1 -1
  58. package/dist/server/meta.d.ts.map +1 -1
  59. package/dist/server/meta.js +23 -15
  60. package/dist/server/meta.js.map +1 -1
  61. package/dist/server/prodServer.d.ts.map +1 -1
  62. package/dist/server/prodServer.js +87 -46
  63. package/dist/server/prodServer.js.map +1 -1
  64. package/dist/server/rateLimiter.d.ts +9 -0
  65. package/dist/server/rateLimiter.d.ts.map +1 -1
  66. package/dist/server/rateLimiter.js +46 -0
  67. package/dist/server/rateLimiter.js.map +1 -1
  68. package/dist/server/requestHandler.d.ts +4 -0
  69. package/dist/server/requestHandler.d.ts.map +1 -0
  70. package/dist/server/requestHandler.js +20 -0
  71. package/dist/server/requestHandler.js.map +1 -0
  72. package/dist/server/rpcRegistry.d.ts +4 -0
  73. package/dist/server/rpcRegistry.d.ts.map +1 -1
  74. package/dist/server/rpcRegistry.js +60 -15
  75. package/dist/server/rpcRegistry.js.map +1 -1
  76. package/dist/server/security.d.ts.map +1 -1
  77. package/dist/server/security.js +3 -2
  78. package/dist/server/security.js.map +1 -1
  79. package/dist/server/serializer.js +17 -6
  80. package/dist/server/serializer.js.map +1 -1
  81. package/dist/server/ssr.d.ts +2 -1
  82. package/dist/server/ssr.d.ts.map +1 -1
  83. package/dist/server/ssr.js +29 -32
  84. package/dist/server/ssr.js.map +1 -1
  85. package/dist/utils/envLoader.js +1 -1
  86. package/dist/utils/envLoader.js.map +1 -1
  87. package/dist/utils/html.d.ts +7 -0
  88. package/dist/utils/html.d.ts.map +1 -0
  89. package/dist/utils/html.js +197 -0
  90. package/dist/utils/html.js.map +1 -0
  91. package/dist/utils/ipExtractor.d.ts +6 -52
  92. package/dist/utils/ipExtractor.d.ts.map +1 -1
  93. package/dist/utils/ipExtractor.js +21 -118
  94. package/dist/utils/ipExtractor.js.map +1 -1
  95. package/dist/vite/heliumPlugin.d.ts.map +1 -1
  96. package/dist/vite/heliumPlugin.js +75 -83
  97. package/dist/vite/heliumPlugin.js.map +1 -1
  98. package/dist/vite/scanner.d.ts +3 -0
  99. package/dist/vite/scanner.d.ts.map +1 -1
  100. package/dist/vite/scanner.js +89 -18
  101. package/dist/vite/scanner.js.map +1 -1
  102. package/dist/vite/ssg.d.ts +4 -0
  103. package/dist/vite/ssg.d.ts.map +1 -1
  104. package/dist/vite/ssg.js +66 -39
  105. package/dist/vite/ssg.js.map +1 -1
  106. package/dist/vite/virtualServerModule.d.ts +1 -1
  107. package/dist/vite/virtualServerModule.d.ts.map +1 -1
  108. package/dist/vite/virtualServerModule.js +28 -16
  109. package/dist/vite/virtualServerModule.js.map +1 -1
  110. 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(req, socket) {
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
- socket.send(msgpackEncode(prepareForMsgpack(errorResponse)));
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
- // Compress if larger than 1KB
151
- if (encoded.length > 1024) {
152
- const compressed = await gzipAsync(encoded);
153
- socket.send(compressed);
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(req, ip, httpReq) {
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,CAelF;AAED,wBAAgB,uBAAuB,IAAI,MAAM,CAMhD;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAmC5D;AAED;;;GAGG;AACH,wBAAgB,aAAa,IAAI,IAAI,CAGpC"}
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"}
@@ -33,11 +33,12 @@ export function verifyConnectionToken(token) {
33
33
  log("warn", "Token missing");
34
34
  return false;
35
35
  }
36
- const [timestamp, signature] = token.split(".");
37
- if (!timestamp || !signature) {
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,CAAC,MAAM,EAAE,yJAAyJ,CAAC,CAAC;YAC3K,CAAC;QACL,CAAC;aAAM,CAAC;YACJ,aAAa,GAAG,SAAS,CAAC;QAC9B,CAAC;QACD,eAAe,GAAG,MAAM,CAAC;QACzB,aAAa,GAAG,IAAI,CAAC;QACrB,GAAG,CAAC,MAAM,EAAE,6BAA6B,CAAC,CAAC;IAC/C,CAAC;AACL,CAAC;AAED,MAAM,UAAU,uBAAuB;IACnC,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvB,MAAM,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACrC,OAAO,GAAG,SAAS,IAAI,SAAS,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAa;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,GAAG,CAAC,MAAM,EAAE,eAAe,CAAC,CAAC;QAC7B,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,CAAC,SAAS,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,IAAI,CAAC,SAAS,EAAE,CAAC;QAC3B,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,4BAA4B;IAC5B,MAAM,EAAE,GAAG,QAAQ,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;IACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACvB,MAAM,UAAU,GAAG,eAAe,EAAE,eAAe,IAAI,KAAK,CAAC;IAC7D,IAAI,KAAK,CAAC,EAAE,CAAC,IAAI,GAAG,GAAG,EAAE,GAAG,UAAU,IAAI,EAAE,GAAG,GAAG,GAAG,IAAI,EAAE,CAAC;QACxD,GAAG,CAAC,MAAM,EAAE,sBAAsB,EAAE,UAAU,GAAG,WAAW,GAAG,GAAG,EAAE,iBAAiB,UAAU,EAAE,CAAC,CAAC;QACnG,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,CAAC,UAAU,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvB,MAAM,iBAAiB,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE7C,IAAI,SAAS,CAAC,MAAM,KAAK,iBAAiB,CAAC,MAAM,EAAE,CAAC;QAChD,GAAG,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;QACzC,OAAO,KAAK,CAAC;IACjB,CAAC;IAED,MAAM,OAAO,GAAG,MAAM,CAAC,eAAe,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC,CAAC;IAC/F,IAAI,CAAC,OAAO,EAAE,CAAC;QACX,GAAG,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACrC,CAAC;IACD,OAAO,OAAO,CAAC;AACnB,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa;IACzB,aAAa,GAAG,EAAE,CAAC;IACnB,aAAa,GAAG,KAAK,CAAC;AAC1B,CAAC","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(\"warn\", \"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 } 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 [timestamp, signature] = token.split(\".\");\n if (!timestamp || !signature) {\n log(\"warn\", \"Invalid token format\");\n return false;\n }\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}"]}
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
- newObj[key] = prepareForMsgpackInner(value[key], stack);
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,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,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,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,CAAC,GAAG,CAAC,GAAG,sBAAsB,CAAE,KAAiC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC;QACzF,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 // 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 // Preserve MessagePack supported types\n if (value instanceof Date) {\n return value;\n }\n if (value instanceof Uint8Array) {\n return value;\n }\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 newObj[key] = prepareForMsgpackInner((value as Record<string, unknown>)[key], stack);\n }\n }\n stack.delete(value as object);\n return newObj;\n}\n"]}
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"]}
@@ -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[]>): ServerSidePropsRequest;
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;
@@ -1 +1 @@
1
- {"version":3,"file":"ssr.d.ts","sourceRoot":"","sources":["../../src/server/ssr.ts"],"names":[],"mappings":"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"}
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;AAK1B,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAClD,OAAO,KAAK,EAAE,kBAAkB,EAAE,sBAAsB,EAAuE,MAAM,4BAA4B,CAAC;AAElK,YAAY,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,CAAC;AAE3D,MAAM,WAAW,UAAU;IACvB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC;IAC3E,WAAW,EAAE,MAAM,OAAO,CAAC,KAAK,CAAC,aAAa,CAAC;QAAE,QAAQ,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC,EAAE,CAAC,CAAC;IACjF,kBAAkB,CAAC,EAAE,kBAAkB,CAAC;CAC3C;AAED,MAAM,WAAW,QAAQ;IACrB,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C;AAQD,MAAM,WAAW,mBAAmB;IAChC,WAAW,EAAE,MAAM,CAAC;IACpB,UAAU,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACxC,OAAO,EAAE,OAAO,CAAC;CACpB;AAED,MAAM,MAAM,kBAAkB,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC;AAEzI,KAAK,mBAAmB,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAAE,GAAG;IAAE,QAAQ,EAAE,mBAAmB,CAAA;CAAE,CAAC;AA2EpH,wBAAgB,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,UAAU,EAAE,GAAG,QAAQ,GAAG,IAAI,CAUnF;AAgDD,wBAAsB,sBAAsB,CAAC,IAAI,EAAE;IAC/C,GAAG,EAAE,eAAe,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,aAAa,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,kBAAkB,CAAC,CAqB9B;AAED,wBAAgB,4BAA4B,CAAC,GAAG,EAAE,eAAe,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAYvK;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE;IACtC,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,IAAI,EAAE,UAAU,CAAC;IACjB,GAAG,EAAE,eAAe,CAAC;IACrB,GAAG,EAAE,aAAa,CAAC;IACnB,YAAY,CAAC,EAAE,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC;QAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAAC,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAA;KAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;CAC/K,GAAG,OAAO,CAAC,mBAAmB,CAAC,CAuF/B"}
@@ -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)] = decodeURIComponent(value);
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) => decodeURIComponent(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)] = decodeURIComponent(value);
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
- for (const page of pages) {
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 = (includeLayouts) => {
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
- if (includeLayouts) {
158
- for (let i = layouts.length - 1; i >= 0; i--) {
159
- const Layout = layouts[i];
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
- let markup;
185
- try {
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.replace(/<div\s+id="root"[^>]*>(.*?)<\/div>/s, `<div id="root">${markup}</div>`);
199
+ const htmlWithRoot = replaceHtmlRootContents(htmlTemplate, markup);
203
200
  const scriptTag = `<script>window.__HELIUM_SSR_DATA__=${serializedPayload};</script>`;
204
- if (htmlWithRoot.includes("</body>")) {
201
+ if (/<\/body\s*>/i.test(htmlWithRoot)) {
205
202
  return {
206
- html: htmlWithRoot.replace("</body>", `${scriptTag}\n</body>`),
203
+ html: htmlWithRoot.replace(/<\/body\s*>/i, (closingBody) => `${scriptTag}\n${closingBody}`),
207
204
  pageProps: ssrProps,
208
205
  };
209
206
  }