heliumts 0.9.4 → 0.9.6

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 (98) hide show
  1. package/README.md +5 -1
  2. package/dist/bin/helium.js +57 -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/env.js.map +1 -1
  12. package/dist/client/index.d.ts.map +1 -1
  13. package/dist/client/index.js.map +1 -1
  14. package/dist/client/routerManifest.d.ts.map +1 -1
  15. package/dist/client/routerManifest.js +18 -29
  16. package/dist/client/routerManifest.js.map +1 -1
  17. package/dist/client/rpcClient.d.ts.map +1 -1
  18. package/dist/client/rpcClient.js +71 -72
  19. package/dist/client/rpcClient.js.map +1 -1
  20. package/dist/client/transitions.d.ts +1 -1
  21. package/dist/client/transitions.d.ts.map +1 -1
  22. package/dist/client/useCall.d.ts.map +1 -1
  23. package/dist/client/useCall.js +4 -1
  24. package/dist/client/useCall.js.map +1 -1
  25. package/dist/client/useFetch.d.ts.map +1 -1
  26. package/dist/client/useFetch.js +48 -92
  27. package/dist/client/useFetch.js.map +1 -1
  28. package/dist/runtime/routeOrder.d.ts +3 -0
  29. package/dist/runtime/routeOrder.d.ts.map +1 -0
  30. package/dist/runtime/routeOrder.js +15 -0
  31. package/dist/runtime/routeOrder.js.map +1 -0
  32. package/dist/server/config.d.ts.map +1 -1
  33. package/dist/server/config.js +51 -26
  34. package/dist/server/config.js.map +1 -1
  35. package/dist/server/defineHTTPRequest.d.ts +1 -1
  36. package/dist/server/defineHTTPRequest.d.ts.map +1 -1
  37. package/dist/server/defineHTTPRequest.js.map +1 -1
  38. package/dist/server/defineWorker.d.ts.map +1 -1
  39. package/dist/server/defineWorker.js +68 -37
  40. package/dist/server/defineWorker.js.map +1 -1
  41. package/dist/server/devServer.d.ts.map +1 -1
  42. package/dist/server/devServer.js +62 -17
  43. package/dist/server/devServer.js.map +1 -1
  44. package/dist/server/httpRouter.d.ts.map +1 -1
  45. package/dist/server/httpRouter.js +147 -43
  46. package/dist/server/httpRouter.js.map +1 -1
  47. package/dist/server/meta.d.ts.map +1 -1
  48. package/dist/server/meta.js +23 -15
  49. package/dist/server/meta.js.map +1 -1
  50. package/dist/server/prodServer.d.ts.map +1 -1
  51. package/dist/server/prodServer.js +79 -23
  52. package/dist/server/prodServer.js.map +1 -1
  53. package/dist/server/rateLimiter.d.ts +9 -0
  54. package/dist/server/rateLimiter.d.ts.map +1 -1
  55. package/dist/server/rateLimiter.js +46 -0
  56. package/dist/server/rateLimiter.js.map +1 -1
  57. package/dist/server/requestHandler.d.ts +4 -0
  58. package/dist/server/requestHandler.d.ts.map +1 -0
  59. package/dist/server/requestHandler.js +20 -0
  60. package/dist/server/requestHandler.js.map +1 -0
  61. package/dist/server/rpcRegistry.d.ts.map +1 -1
  62. package/dist/server/rpcRegistry.js +46 -6
  63. package/dist/server/rpcRegistry.js.map +1 -1
  64. package/dist/server/security.d.ts.map +1 -1
  65. package/dist/server/security.js +3 -2
  66. package/dist/server/security.js.map +1 -1
  67. package/dist/server/serializer.js +11 -6
  68. package/dist/server/serializer.js.map +1 -1
  69. package/dist/server/ssr.d.ts +2 -1
  70. package/dist/server/ssr.d.ts.map +1 -1
  71. package/dist/server/ssr.js +29 -32
  72. package/dist/server/ssr.js.map +1 -1
  73. package/dist/utils/envLoader.js +1 -1
  74. package/dist/utils/envLoader.js.map +1 -1
  75. package/dist/utils/html.d.ts +7 -0
  76. package/dist/utils/html.d.ts.map +1 -0
  77. package/dist/utils/html.js +197 -0
  78. package/dist/utils/html.js.map +1 -0
  79. package/dist/utils/ipExtractor.d.ts +6 -52
  80. package/dist/utils/ipExtractor.d.ts.map +1 -1
  81. package/dist/utils/ipExtractor.js +21 -118
  82. package/dist/utils/ipExtractor.js.map +1 -1
  83. package/dist/vite/heliumPlugin.d.ts.map +1 -1
  84. package/dist/vite/heliumPlugin.js +71 -83
  85. package/dist/vite/heliumPlugin.js.map +1 -1
  86. package/dist/vite/scanner.d.ts +3 -0
  87. package/dist/vite/scanner.d.ts.map +1 -1
  88. package/dist/vite/scanner.js +89 -18
  89. package/dist/vite/scanner.js.map +1 -1
  90. package/dist/vite/ssg.d.ts +4 -0
  91. package/dist/vite/ssg.d.ts.map +1 -1
  92. package/dist/vite/ssg.js +62 -39
  93. package/dist/vite/ssg.js.map +1 -1
  94. package/dist/vite/virtualServerModule.d.ts +1 -1
  95. package/dist/vite/virtualServerModule.d.ts.map +1 -1
  96. package/dist/vite/virtualServerModule.js +28 -16
  97. package/dist/vite/virtualServerModule.js.map +1 -1
  98. package/package.json +12 -7
@@ -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 { 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(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 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(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":"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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(\"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":"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,CACC,MAAM,EACN,yJAAyJ,CAC5J,CAAC;YACN,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,KAAK,GAAG,yBAAyB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACpD,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,GAAG,CAAC,MAAM,EAAE,sBAAsB,CAAC,CAAC;QACpC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,MAAM,CAAC,EAAE,SAAS,EAAE,SAAS,CAAC,GAAG,KAAK,CAAC;IAEvC,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(\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,12 @@ 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
+ Object.defineProperty(newObj, key, {
51
+ value: prepareForMsgpackInner(value[key], stack),
52
+ enumerable: true,
53
+ writable: true,
54
+ configurable: true,
55
+ });
51
56
  }
52
57
  }
53
58
  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,CAAC,cAAc,CAAC,MAAM,EAAE,GAAG,EAAE;gBAC/B,KAAK,EAAE,sBAAsB,CAAE,KAAiC,CAAC,GAAG,CAAC,EAAE,KAAK,CAAC;gBAC7E,UAAU,EAAE,IAAI;gBAChB,QAAQ,EAAE,IAAI;gBACd,YAAY,EAAE,IAAI;aACrB,CAAC,CAAC;QACP,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 Object.defineProperty(newObj, key, {\n value: prepareForMsgpackInner((value as Record<string, unknown>)[key], stack),\n enumerable: true,\n writable: true,\n configurable: true,\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":"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"}
@@ -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
  }
@@ -1 +1 @@
1
- {"version":3,"file":"ssr.js","sourceRoot":"","sources":["../../src/server/ssr.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IncomingHttpHeaders, IncomingMessage } from \"http\";\nimport type { ComponentType } from \"react\";\nimport React from \"react\";\nimport ReactDOMServer from \"react-dom/server\";\n\nimport type { HeliumContext } from \"./context.js\";\nimport type { GetServerSideProps, ServerSidePropsRequest, ServerSidePropsResult, ServerSideRedirect, ServerSideRedirectResult } from \"./defineServerSideProps.js\";\n\nexport type { GetServerSideProps, ServerSidePropsRequest };\n\nexport interface SSRPageDef {\n pathPattern: string;\n loadComponent: () => Promise<React.ComponentType<Record<string, unknown>>>;\n loadLayouts: () => Promise<React.ComponentType<{ children: React.ReactNode }>[]>;\n getServerSideProps?: GetServerSideProps;\n}\n\nexport interface SSRMatch {\n page: SSRPageDef;\n params: Record<string, string | string[]>;\n}\n\ntype SSRRouterSnapshot = {\n path: string;\n params: Record<string, string | string[]>;\n search: string;\n};\n\nexport interface SSRRedirectResolved {\n destination: string;\n statusCode: 301 | 302 | 303 | 307 | 308;\n replace: boolean;\n}\n\nexport type SSRPropsResolution = { kind: \"props\"; props: Record<string, unknown> } | { kind: \"redirect\"; redirect: SSRRedirectResolved };\n\ntype RenderSSRHTMLResult = { html: string; pageProps: Record<string, unknown> } | { redirect: SSRRedirectResolved };\n\ntype SSRGlobalState = typeof globalThis & {\n __HELIUM_SSR_ROUTER__?: SSRRouterSnapshot;\n};\n\nfunction createMatcher(pattern: string): (path: string) => { params: Record<string, string | string[]> } | null {\n const segments = pattern.split(\"/\").filter(Boolean);\n\n return (path: string) => {\n const cleanPath = path.split(\"?\")[0].split(\"#\")[0];\n const pathSegments = cleanPath.split(\"/\").filter(Boolean);\n\n if (pattern === \"/\" && cleanPath === \"/\") {\n return { params: {} };\n }\n\n const params: Record<string, string | string[]> = {};\n\n const hasCatchAll = segments.some((seg) => seg.startsWith(\"*\"));\n if (hasCatchAll) {\n const catchAllIndex = segments.findIndex((seg) => seg.startsWith(\"*\"));\n if (catchAllIndex !== segments.length - 1) {\n return null;\n }\n\n const catchAllParam = segments[catchAllIndex].slice(1);\n\n for (let i = 0; i < catchAllIndex; i++) {\n const seg = segments[i];\n const value = pathSegments[i];\n\n if (!value) {\n return null;\n }\n\n if (seg.startsWith(\":\")) {\n params[seg.slice(1)] = decodeURIComponent(value);\n } else if (seg !== value) {\n return null;\n }\n }\n\n const remainingSegments = pathSegments.slice(catchAllIndex);\n params[catchAllParam] = remainingSegments.map((s) => decodeURIComponent(s));\n return { params };\n }\n\n if (segments.length !== pathSegments.length) {\n return null;\n }\n\n for (let i = 0; i < segments.length; i++) {\n const seg = segments[i];\n const value = pathSegments[i];\n\n if (seg.startsWith(\":\")) {\n params[seg.slice(1)] = decodeURIComponent(value);\n } else if (seg !== value) {\n return null;\n }\n }\n\n return { params };\n };\n}\n\nexport function matchSSRPage(pathname: string, pages: SSRPageDef[]): SSRMatch | null {\n for (const page of pages) {\n const match = createMatcher(page.pathPattern)(pathname);\n if (match) {\n return { page, params: match.params };\n }\n }\n\n return null;\n}\n\nfunction headersToRecord(headers: IncomingHttpHeaders): Record<string, string | string[] | undefined> {\n const out: Record<string, string | string[] | undefined> = {};\n\n for (const [key, value] of Object.entries(headers)) {\n out[key] = value;\n }\n\n return out;\n}\n\nfunction parseQuery(inputUrl: string): Record<string, string> {\n const query: Record<string, string> = {};\n const parsed = new URL(inputUrl, \"http://localhost\");\n\n for (const [key, value] of parsed.searchParams.entries()) {\n query[key] = value;\n }\n\n return query;\n}\n\nfunction isServerSideRedirectResult(value: ServerSidePropsResult): value is ServerSideRedirectResult {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n return false;\n }\n\n const maybeRedirect = (value as { redirect?: unknown }).redirect;\n if (!maybeRedirect || typeof maybeRedirect !== \"object\" || Array.isArray(maybeRedirect)) {\n return false;\n }\n\n const destination = (maybeRedirect as { destination?: unknown }).destination;\n return typeof destination === \"string\" && destination.length > 0;\n}\n\nfunction normalizeRedirect(redirect: ServerSideRedirect): SSRRedirectResolved {\n const allowedStatusCodes = new Set<301 | 302 | 303 | 307 | 308>([301, 302, 303, 307, 308]);\n const statusCode = redirect.statusCode && allowedStatusCodes.has(redirect.statusCode) ? redirect.statusCode : redirect.permanent ? 308 : 307;\n\n return {\n destination: redirect.destination,\n statusCode,\n replace: redirect.replace ?? true,\n };\n}\n\nexport async function resolveServerSideProps(args: {\n req: IncomingMessage;\n pathname: string;\n params: Record<string, string | string[]>;\n page: SSRPageDef;\n ctx: HeliumContext;\n}): Promise<SSRPropsResolution> {\n const { req, pathname, params, page, ctx } = args;\n\n if (!page.getServerSideProps) {\n return { kind: \"props\", props: {} };\n }\n\n const request = createServerSidePropsRequest(req, pathname, params);\n const result = await page.getServerSideProps(request, ctx);\n\n if (isServerSideRedirectResult(result)) {\n return {\n kind: \"redirect\",\n redirect: normalizeRedirect(result.redirect),\n };\n }\n\n return {\n kind: \"props\",\n props: result ?? {},\n };\n}\n\nexport function createServerSidePropsRequest(req: IncomingMessage, pathname: string, params: Record<string, string | string[]>): ServerSidePropsRequest {\n const method = req.method || \"GET\";\n const headers = headersToRecord(req.headers);\n const rawUrl = req.url || pathname;\n\n return {\n method,\n path: pathname,\n headers,\n query: parseQuery(rawUrl),\n params,\n };\n}\n\nexport async function renderSSRHTML(args: {\n htmlTemplate: string;\n pathname: string;\n search: string;\n params: Record<string, string | string[]>;\n page: SSRPageDef;\n req: IncomingMessage;\n ctx: HeliumContext;\n loadAppShell?: (() => Promise<ComponentType<{ Component: ComponentType<Record<string, unknown>>; pageProps: Record<string, unknown>; children?: React.ReactNode }>>) | null;\n}): Promise<RenderSSRHTMLResult> {\n const { htmlTemplate, pathname, search, params, page, req, ctx, loadAppShell = null } = args;\n\n const ssrResult = await resolveServerSideProps({\n req,\n pathname,\n params,\n page,\n ctx,\n });\n\n if (ssrResult.kind === \"redirect\") {\n return { redirect: ssrResult.redirect };\n }\n\n const ssrProps = ssrResult.props;\n\n const PageComponent = await page.loadComponent();\n const layouts = await page.loadLayouts();\n const AppShell = loadAppShell ? await loadAppShell() : null;\n\n const pageProps: Record<string, unknown> = {\n ...ssrProps,\n params,\n searchParams: new URLSearchParams(search),\n };\n\n const renderTree = (includeLayouts: boolean): string => {\n const globalState = globalThis as SSRGlobalState;\n const previousRouterState = globalState.__HELIUM_SSR_ROUTER__;\n globalState.__HELIUM_SSR_ROUTER__ = {\n path: pathname,\n params,\n search,\n };\n\n const WrappedPage: ComponentType<Record<string, unknown>> = () => {\n let content = React.createElement(PageComponent, pageProps);\n\n if (includeLayouts) {\n for (let i = layouts.length - 1; i >= 0; i--) {\n const Layout = layouts[i];\n content = React.createElement(Layout, { children: content });\n }\n }\n\n return content;\n };\n\n const element = AppShell\n ? React.createElement(AppShell, {\n Component: WrappedPage,\n pageProps,\n children: React.createElement(WrappedPage, pageProps),\n })\n : React.createElement(WrappedPage, pageProps);\n\n try {\n return ReactDOMServer.renderToString(element);\n } finally {\n if (previousRouterState) {\n globalState.__HELIUM_SSR_ROUTER__ = previousRouterState;\n } else {\n delete globalState.__HELIUM_SSR_ROUTER__;\n }\n }\n };\n\n let markup: string;\n try {\n markup = renderTree(true);\n } catch (error) {\n // Some app-level layout trees can fail on SSR due to circular imports or browser-only paths.\n // Fallback to page-only SSR so we still return HTML instead of an empty shell.\n try {\n markup = renderTree(false);\n } catch {\n throw error;\n }\n }\n const serializedPayload = JSON.stringify({ path: pathname, props: ssrProps })\n .replace(/</g, \"\\\\u003c\")\n .replace(/\\u2028/g, \"\\\\u2028\")\n .replace(/\\u2029/g, \"\\\\u2029\");\n\n const htmlWithRoot = htmlTemplate.replace(/<div\\s+id=\"root\"[^>]*>(.*?)<\\/div>/s, `<div id=\"root\">${markup}</div>`);\n const scriptTag = `<script>window.__HELIUM_SSR_DATA__=${serializedPayload};</script>`;\n\n if (htmlWithRoot.includes(\"</body>\")) {\n return {\n html: htmlWithRoot.replace(\"</body>\", `${scriptTag}\\n</body>`),\n pageProps: ssrProps,\n };\n }\n\n return {\n html: `${htmlWithRoot}${scriptTag}`,\n pageProps: ssrProps,\n };\n}\n"]}
1
+ {"version":3,"file":"ssr.js","sourceRoot":"","sources":["../../src/server/ssr.ts"],"names":[],"mappings":"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","sourcesContent":["import type { IncomingHttpHeaders, IncomingMessage } from \"http\";\nimport type { ComponentType } from \"react\";\nimport React from \"react\";\nimport ReactDOMServer from \"react-dom/server\";\n\nimport { compareRoutePatterns } from \"../runtime/routeOrder.js\";\nimport { replaceHtmlRootContents } from \"../utils/html.js\";\nimport type { HeliumContext } from \"./context.js\";\nimport type { GetServerSideProps, ServerSidePropsRequest, ServerSidePropsResult, ServerSideRedirect, ServerSideRedirectResult } from \"./defineServerSideProps.js\";\n\nexport type { GetServerSideProps, ServerSidePropsRequest };\n\nexport interface SSRPageDef {\n pathPattern: string;\n loadComponent: () => Promise<React.ComponentType<Record<string, unknown>>>;\n loadLayouts: () => Promise<React.ComponentType<{ children: React.ReactNode }>[]>;\n getServerSideProps?: GetServerSideProps;\n}\n\nexport interface SSRMatch {\n page: SSRPageDef;\n params: Record<string, string | string[]>;\n}\n\ntype SSRRouterSnapshot = {\n path: string;\n params: Record<string, string | string[]>;\n search: string;\n};\n\nexport interface SSRRedirectResolved {\n destination: string;\n statusCode: 301 | 302 | 303 | 307 | 308;\n replace: boolean;\n}\n\nexport type SSRPropsResolution = { kind: \"props\"; props: Record<string, unknown> } | { kind: \"redirect\"; redirect: SSRRedirectResolved };\n\ntype RenderSSRHTMLResult = { html: string; pageProps: Record<string, unknown> } | { redirect: SSRRedirectResolved };\n\ntype SSRGlobalState = typeof globalThis & {\n __HELIUM_SSR_ROUTER__?: SSRRouterSnapshot;\n};\n\nfunction createMatcher(pattern: string): (path: string) => { params: Record<string, string | string[]> } | null {\n const segments = pattern.split(\"/\").filter(Boolean);\n\n return (path: string) => {\n const cleanPath = path.split(\"?\")[0].split(\"#\")[0];\n const pathSegments = cleanPath.split(\"/\").filter(Boolean);\n\n if (pattern === \"/\" && cleanPath === \"/\") {\n return { params: {} };\n }\n\n const params: Record<string, string | string[]> = {};\n\n const hasCatchAll = segments.some((seg) => seg.startsWith(\"*\"));\n if (hasCatchAll) {\n const catchAllIndex = segments.findIndex((seg) => seg.startsWith(\"*\"));\n if (catchAllIndex !== segments.length - 1) {\n return null;\n }\n\n const catchAllParam = segments[catchAllIndex].slice(1);\n\n for (let i = 0; i < catchAllIndex; i++) {\n const seg = segments[i];\n const value = pathSegments[i];\n\n if (!value) {\n return null;\n }\n\n if (seg.startsWith(\":\")) {\n params[seg.slice(1)] = safeDecodeURIComponent(value);\n } else if (seg !== value) {\n return null;\n }\n }\n\n const remainingSegments = pathSegments.slice(catchAllIndex);\n params[catchAllParam] = remainingSegments.map((s) => safeDecodeURIComponent(s));\n return { params };\n }\n\n if (segments.length !== pathSegments.length) {\n return null;\n }\n\n for (let i = 0; i < segments.length; i++) {\n const seg = segments[i];\n const value = pathSegments[i];\n\n if (seg.startsWith(\":\")) {\n params[seg.slice(1)] = safeDecodeURIComponent(value);\n } else if (seg !== value) {\n return null;\n }\n }\n\n return { params };\n };\n}\n\nfunction safeDecodeURIComponent(value: string): string {\n try {\n return decodeURIComponent(value);\n } catch {\n return value;\n }\n}\n\nexport function matchSSRPage(pathname: string, pages: SSRPageDef[]): SSRMatch | null {\n const orderedPages = [...pages].sort((a, b) => compareRoutePatterns(a.pathPattern, b.pathPattern));\n for (const page of orderedPages) {\n const match = createMatcher(page.pathPattern)(pathname);\n if (match) {\n return { page, params: match.params };\n }\n }\n\n return null;\n}\n\nfunction headersToRecord(headers: IncomingHttpHeaders): Record<string, string | string[] | undefined> {\n const out: Record<string, string | string[] | undefined> = {};\n\n for (const [key, value] of Object.entries(headers)) {\n out[key] = value;\n }\n\n return out;\n}\n\nfunction parseQuery(inputUrl: string): Record<string, string> {\n const query: Record<string, string> = {};\n const parsed = new URL(inputUrl, \"http://localhost\");\n\n for (const [key, value] of parsed.searchParams.entries()) {\n query[key] = value;\n }\n\n return query;\n}\n\nfunction isServerSideRedirectResult(value: ServerSidePropsResult): value is ServerSideRedirectResult {\n if (!value || typeof value !== \"object\" || Array.isArray(value)) {\n return false;\n }\n\n const maybeRedirect = (value as { redirect?: unknown }).redirect;\n if (!maybeRedirect || typeof maybeRedirect !== \"object\" || Array.isArray(maybeRedirect)) {\n return false;\n }\n\n const destination = (maybeRedirect as { destination?: unknown }).destination;\n return typeof destination === \"string\" && destination.length > 0;\n}\n\nfunction normalizeRedirect(redirect: ServerSideRedirect): SSRRedirectResolved {\n const allowedStatusCodes = new Set<301 | 302 | 303 | 307 | 308>([301, 302, 303, 307, 308]);\n const statusCode = redirect.statusCode && allowedStatusCodes.has(redirect.statusCode) ? redirect.statusCode : redirect.permanent ? 308 : 307;\n\n return {\n destination: redirect.destination,\n statusCode,\n replace: redirect.replace ?? true,\n };\n}\n\nexport async function resolveServerSideProps(args: {\n req: IncomingMessage;\n pathname: string;\n params: Record<string, string | string[]>;\n page: SSRPageDef;\n ctx: HeliumContext;\n search?: string;\n}): Promise<SSRPropsResolution> {\n const { req, pathname, params, page, ctx, search } = args;\n\n if (!page.getServerSideProps) {\n return { kind: \"props\", props: {} };\n }\n\n const request = createServerSidePropsRequest(req, pathname, params, search);\n const result = await page.getServerSideProps(request, ctx);\n\n if (isServerSideRedirectResult(result)) {\n return {\n kind: \"redirect\",\n redirect: normalizeRedirect(result.redirect),\n };\n }\n\n return {\n kind: \"props\",\n props: result ?? {},\n };\n}\n\nexport function createServerSidePropsRequest(req: IncomingMessage, pathname: string, params: Record<string, string | string[]>, search?: string): ServerSidePropsRequest {\n const method = req.method || \"GET\";\n const headers = headersToRecord(req.headers);\n const rawUrl = search === undefined ? req.url || pathname : `${pathname}${search}`;\n\n return {\n method,\n path: pathname,\n headers,\n query: parseQuery(rawUrl),\n params,\n };\n}\n\nexport async function renderSSRHTML(args: {\n htmlTemplate: string;\n pathname: string;\n search: string;\n params: Record<string, string | string[]>;\n page: SSRPageDef;\n req: IncomingMessage;\n ctx: HeliumContext;\n loadAppShell?: (() => Promise<ComponentType<{ Component: ComponentType<Record<string, unknown>>; pageProps: Record<string, unknown>; children?: React.ReactNode }>>) | null;\n}): Promise<RenderSSRHTMLResult> {\n const { htmlTemplate, pathname, search, params, page, req, ctx, loadAppShell = null } = args;\n\n const ssrResult = await resolveServerSideProps({\n req,\n pathname,\n params,\n page,\n ctx,\n search,\n });\n\n if (ssrResult.kind === \"redirect\") {\n return { redirect: ssrResult.redirect };\n }\n\n const ssrProps = ssrResult.props;\n\n const PageComponent = await page.loadComponent();\n const layouts = await page.loadLayouts();\n const AppShell = loadAppShell ? await loadAppShell() : null;\n\n const pageProps: Record<string, unknown> = {\n ...ssrProps,\n params,\n searchParams: new URLSearchParams(search),\n };\n\n const renderTree = (): string => {\n const globalState = globalThis as SSRGlobalState;\n const previousRouterState = globalState.__HELIUM_SSR_ROUTER__;\n globalState.__HELIUM_SSR_ROUTER__ = {\n path: pathname,\n params,\n search,\n };\n\n const WrappedPage: ComponentType<Record<string, unknown>> = () => {\n let content = React.createElement(PageComponent, pageProps);\n\n for (let i = layouts.length - 1; i >= 0; i--) {\n const Layout = layouts[i];\n content = React.createElement(Layout, { children: content });\n }\n\n return content;\n };\n\n const element = AppShell\n ? React.createElement(AppShell, {\n Component: WrappedPage,\n pageProps,\n children: React.createElement(WrappedPage, pageProps),\n })\n : React.createElement(WrappedPage, pageProps);\n\n try {\n return ReactDOMServer.renderToString(element);\n } finally {\n if (previousRouterState) {\n globalState.__HELIUM_SSR_ROUTER__ = previousRouterState;\n } else {\n delete globalState.__HELIUM_SSR_ROUTER__;\n }\n }\n };\n\n const markup = renderTree();\n const serializedPayload = JSON.stringify({ path: pathname, search, props: ssrProps })\n .replace(/</g, \"\\\\u003c\")\n .replace(/\\u2028/g, \"\\\\u2028\")\n .replace(/\\u2029/g, \"\\\\u2029\");\n\n const htmlWithRoot = replaceHtmlRootContents(htmlTemplate, markup);\n const scriptTag = `<script>window.__HELIUM_SSR_DATA__=${serializedPayload};</script>`;\n\n if (/<\\/body\\s*>/i.test(htmlWithRoot)) {\n return {\n html: htmlWithRoot.replace(/<\\/body\\s*>/i, (closingBody) => `${scriptTag}\\n${closingBody}`),\n pageProps: ssrProps,\n };\n }\n\n return {\n html: `${htmlWithRoot}${scriptTag}`,\n pageProps: ssrProps,\n };\n}\n"]}
@@ -99,7 +99,7 @@ export function injectHeliumEnvIntoHtml(html, prefix = "HELIUM_PUBLIC_") {
99
99
  // Inject at the start of <head> so it runs before module scripts
100
100
  const headMatch = html.match(/<head[^>]*>/i);
101
101
  if (headMatch) {
102
- return html.replace(headMatch[0], `${headMatch[0]}\n${script}`);
102
+ return html.replace(headMatch[0], () => `${headMatch[0]}\n${script}`);
103
103
  }
104
104
  // Fallback: prepend to HTML
105
105
  return `${script}\n${html}`;
@@ -1 +1 @@
1
- {"version":3,"file":"envLoader.js","sourceRoot":"","sources":["../../src/utils/envLoader.ts"],"names":[],"mappings":"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","sourcesContent":["import dotenv from \"dotenv\";\nimport fs from \"fs\";\nimport path from \"path\";\n\nexport interface EnvLoadOptions {\n root?: string;\n mode?: string;\n}\n\n/**\n * Collects HELIUM_PUBLIC_ prefixed variables from process.env.\n * Used as a fallback for platform environments (Render, DigitalOcean Apps, etc.)\n * where env vars are set as platform variables rather than .env files.\n */\nexport function getPublicEnvFromProcess(prefix: string = \"HELIUM_PUBLIC_\"): Record<string, string> {\n const publicEnv: Record<string, string> = {};\n\n for (const [key, value] of Object.entries(process.env)) {\n if (key.startsWith(prefix) && value !== undefined) {\n publicEnv[key] = value;\n }\n }\n\n return publicEnv;\n}\n\n/**\n * Loads environment variables from .env files with priority.\n * Similar to Next.js, supports:\n * - .env.{mode}.local (highest priority)\n * - .env.local (not loaded in test mode)\n * - .env.{mode}\n * - .env\n * - process.env HELIUM_PUBLIC_* variables (lowest priority fallback)\n *\n * Platform environment variables (process.env) are used as the base layer,\n * so .env file values always take precedence. This ensures compatibility\n * with platforms like Render, DigitalOcean Apps, and Railway where env vars\n * are set as platform variables rather than .env files.\n */\nexport function loadEnvFiles(options: EnvLoadOptions = {}): Record<string, string> {\n const { root = process.cwd(), mode = process.env.NODE_ENV || \"development\" } = options;\n\n const envFiles = [\n `.env.${mode}.local`,\n // Don't load .env.local in test mode\n mode !== \"test\" ? `.env.local` : null,\n `.env.${mode}`,\n `.env`,\n ].filter(Boolean) as string[];\n\n // Start with platform env vars as the lowest-priority base layer\n const loadedEnv: Record<string, string> = getPublicEnvFromProcess();\n\n // Load in reverse order so earlier files override later ones\n for (let i = envFiles.length - 1; i >= 0; i--) {\n const envFile = envFiles[i];\n const envPath = path.resolve(root, envFile);\n\n if (fs.existsSync(envPath)) {\n const parsed = dotenv.parse(fs.readFileSync(envPath, \"utf-8\"));\n Object.assign(loadedEnv, parsed);\n }\n }\n\n return loadedEnv;\n}\n\n/**\n * Injects env variables into process.env\n */\nexport function injectEnvToProcess(env: Record<string, string>): void {\n for (const [key, value] of Object.entries(env)) {\n // Don't override existing process.env values\n if (process.env[key] === undefined) {\n process.env[key] = value;\n }\n }\n}\n\n/**\n * Filters env variables that should be exposed to the client.\n * By default, only HELIUM_PUBLIC_ prefixed variables are exposed.\n */\nexport function filterClientEnv(env: Record<string, string>, prefix: string = \"HELIUM_PUBLIC_\"): Record<string, string> {\n const clientEnv: Record<string, string> = {};\n\n for (const [key, value] of Object.entries(env)) {\n if (key.startsWith(prefix)) {\n clientEnv[key] = value;\n }\n }\n\n return clientEnv;\n}\n\n/**\n * Generates an inline <script> tag that exposes HELIUM_PUBLIC_ env vars\n * via window.__HELIUM__.env before the client bundle executes.\n */\nexport function buildHeliumEnvScript(prefix: string = \"HELIUM_PUBLIC_\"): string {\n const publicEnv = getPublicEnvFromProcess(prefix);\n\n if (Object.keys(publicEnv).length === 0) {\n return \"\";\n }\n\n const envJson = JSON.stringify(publicEnv).replace(/</g, \"\\\\u003c\");\n return `<script>window.__HELIUM__=window.__HELIUM__||{};window.__HELIUM__.env=${envJson};</script>`;\n}\n\n/**\n * Injects the Helium bootstrap script into an HTML string, placing it\n * at the beginning of <head> so it runs before any module scripts.\n */\nexport function injectHeliumEnvIntoHtml(html: string, prefix: string = \"HELIUM_PUBLIC_\"): string {\n const script = buildHeliumEnvScript(prefix);\n\n if (!script) {\n return html;\n }\n\n // Inject at the start of <head> so it runs before module scripts\n const headMatch = html.match(/<head[^>]*>/i);\n if (headMatch) {\n return html.replace(headMatch[0], `${headMatch[0]}\\n${script}`);\n }\n\n // Fallback: prepend to HTML\n return `${script}\\n${html}`;\n}\n"]}
1
+ {"version":3,"file":"envLoader.js","sourceRoot":"","sources":["../../src/utils/envLoader.ts"],"names":[],"mappings":"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","sourcesContent":["import dotenv from \"dotenv\";\nimport fs from \"fs\";\nimport path from \"path\";\n\nexport interface EnvLoadOptions {\n root?: string;\n mode?: string;\n}\n\n/**\n * Collects HELIUM_PUBLIC_ prefixed variables from process.env.\n * Used as a fallback for platform environments (Render, DigitalOcean Apps, etc.)\n * where env vars are set as platform variables rather than .env files.\n */\nexport function getPublicEnvFromProcess(prefix: string = \"HELIUM_PUBLIC_\"): Record<string, string> {\n const publicEnv: Record<string, string> = {};\n\n for (const [key, value] of Object.entries(process.env)) {\n if (key.startsWith(prefix) && value !== undefined) {\n publicEnv[key] = value;\n }\n }\n\n return publicEnv;\n}\n\n/**\n * Loads environment variables from .env files with priority.\n * Similar to Next.js, supports:\n * - .env.{mode}.local (highest priority)\n * - .env.local (not loaded in test mode)\n * - .env.{mode}\n * - .env\n * - process.env HELIUM_PUBLIC_* variables (lowest priority fallback)\n *\n * Platform environment variables (process.env) are used as the base layer,\n * so .env file values always take precedence. This ensures compatibility\n * with platforms like Render, DigitalOcean Apps, and Railway where env vars\n * are set as platform variables rather than .env files.\n */\nexport function loadEnvFiles(options: EnvLoadOptions = {}): Record<string, string> {\n const { root = process.cwd(), mode = process.env.NODE_ENV || \"development\" } = options;\n\n const envFiles = [\n `.env.${mode}.local`,\n // Don't load .env.local in test mode\n mode !== \"test\" ? `.env.local` : null,\n `.env.${mode}`,\n `.env`,\n ].filter(Boolean) as string[];\n\n // Start with platform env vars as the lowest-priority base layer\n const loadedEnv: Record<string, string> = getPublicEnvFromProcess();\n\n // Load in reverse order so earlier files override later ones\n for (let i = envFiles.length - 1; i >= 0; i--) {\n const envFile = envFiles[i];\n const envPath = path.resolve(root, envFile);\n\n if (fs.existsSync(envPath)) {\n const parsed = dotenv.parse(fs.readFileSync(envPath, \"utf-8\"));\n Object.assign(loadedEnv, parsed);\n }\n }\n\n return loadedEnv;\n}\n\n/**\n * Injects env variables into process.env\n */\nexport function injectEnvToProcess(env: Record<string, string>): void {\n for (const [key, value] of Object.entries(env)) {\n // Don't override existing process.env values\n if (process.env[key] === undefined) {\n process.env[key] = value;\n }\n }\n}\n\n/**\n * Filters env variables that should be exposed to the client.\n * By default, only HELIUM_PUBLIC_ prefixed variables are exposed.\n */\nexport function filterClientEnv(env: Record<string, string>, prefix: string = \"HELIUM_PUBLIC_\"): Record<string, string> {\n const clientEnv: Record<string, string> = {};\n\n for (const [key, value] of Object.entries(env)) {\n if (key.startsWith(prefix)) {\n clientEnv[key] = value;\n }\n }\n\n return clientEnv;\n}\n\n/**\n * Generates an inline <script> tag that exposes HELIUM_PUBLIC_ env vars\n * via window.__HELIUM__.env before the client bundle executes.\n */\nexport function buildHeliumEnvScript(prefix: string = \"HELIUM_PUBLIC_\"): string {\n const publicEnv = getPublicEnvFromProcess(prefix);\n\n if (Object.keys(publicEnv).length === 0) {\n return \"\";\n }\n\n const envJson = JSON.stringify(publicEnv).replace(/</g, \"\\\\u003c\");\n return `<script>window.__HELIUM__=window.__HELIUM__||{};window.__HELIUM__.env=${envJson};</script>`;\n}\n\n/**\n * Injects the Helium bootstrap script into an HTML string, placing it\n * at the beginning of <head> so it runs before any module scripts.\n */\nexport function injectHeliumEnvIntoHtml(html: string, prefix: string = \"HELIUM_PUBLIC_\"): string {\n const script = buildHeliumEnvScript(prefix);\n\n if (!script) {\n return html;\n }\n\n // Inject at the start of <head> so it runs before module scripts\n const headMatch = html.match(/<head[^>]*>/i);\n if (headMatch) {\n return html.replace(headMatch[0], () => `${headMatch[0]}\\n${script}`);\n }\n\n // Fallback: prepend to HTML\n return `${script}\\n${html}`;\n}\n"]}
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Replace the contents of the live HTML root without consuming nested closing
3
+ * tags or matching examples inside comments, scripts, styles, or templates.
4
+ * Missing or unclosed roots leave the template unchanged.
5
+ */
6
+ export declare function replaceHtmlRootContents(html: string, contents: string, attributes?: Record<string, string | null>): string;
7
+ //# sourceMappingURL=html.d.ts.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"html.d.ts","sourceRoot":"","sources":["../../src/utils/html.ts"],"names":[],"mappings":"AAyKA;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAM,GAAG,MAAM,CA0B9H"}