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
@@ -1 +1 @@
1
- {"version":3,"file":"defineWorker.js","sourceRoot":"","sources":["../../src/server/defineWorker.ts"],"names":[],"mappings":"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","sourcesContent":["import { log } from \"../utils/logger.js\";\nimport type { HeliumContext } from \"./context.js\";\n\nexport type WorkerCleanup = (() => Promise<void> | void) | void;\n\nexport interface WorkerLifecycle {\n signal: AbortSignal;\n onCleanup: (cleanup: WorkerCleanup) => void;\n}\n\nexport interface WorkerOptions {\n /**\n * The name of the worker, used for logging and identification.\n * If not provided, the handler function name will be used.\n */\n name?: string;\n\n /**\n * Whether the worker should automatically restart if it crashes.\n * Default: true\n */\n autoRestart?: boolean;\n\n /**\n * Delay in milliseconds before restarting the worker after a crash.\n * Default: 5000 (5 seconds)\n */\n restartDelayMs?: number;\n\n /**\n * Maximum number of restart attempts before giving up.\n * Set to 0 for unlimited restarts.\n * Default: 0 (unlimited)\n */\n maxRestarts?: number;\n\n /**\n * Whether to start the worker automatically on server startup.\n * Default: true\n */\n autoStart?: boolean;\n}\n\nexport type WorkerHandler = (ctx: HeliumContext, lifecycle: WorkerLifecycle) => Promise<WorkerCleanup> | WorkerCleanup;\n\nexport type HeliumWorkerDef = {\n __kind: \"worker\";\n __id: string;\n name: string;\n handler: WorkerHandler;\n options: Required<WorkerOptions>;\n};\n\nexport interface WorkerInstance {\n id: string;\n name: string;\n status: \"running\" | \"stopped\" | \"crashed\" | \"restarting\";\n startedAt: Date | null;\n restartCount: number;\n lastError?: Error;\n stop: () => Promise<void>;\n}\n\n// Map to track running worker instances\nconst runningWorkers = new Map<\n string,\n {\n abortController: AbortController;\n promise: Promise<void>;\n instance: WorkerInstance;\n cleanupHandlers: Array<() => Promise<void> | void>;\n cleanupPromise: Promise<void> | null;\n }\n>();\n\nfunction isCleanupHandler(cleanup: WorkerCleanup): cleanup is () => Promise<void> | void {\n return typeof cleanup === \"function\";\n}\n\nfunction registerCleanup(\n workerState: {\n cleanupHandlers: Array<() => Promise<void> | void>;\n },\n cleanup: WorkerCleanup\n) {\n if (!isCleanupHandler(cleanup)) {\n return;\n }\n\n workerState.cleanupHandlers.push(cleanup);\n}\n\nasync function runWorkerCleanup(\n name: string,\n workerState: {\n cleanupHandlers: Array<() => Promise<void> | void>;\n cleanupPromise: Promise<void> | null;\n }\n): Promise<void> {\n if (workerState.cleanupPromise) {\n await workerState.cleanupPromise;\n return;\n }\n\n workerState.cleanupPromise = (async () => {\n const cleanupHandlers = workerState.cleanupHandlers.splice(0).reverse();\n\n for (const cleanup of cleanupHandlers) {\n try {\n await cleanup();\n } catch (error) {\n log(\"error\", `Worker '${name}' cleanup failed:`, error);\n }\n }\n })();\n\n await workerState.cleanupPromise;\n}\n\nfunction waitForAbort(signal: AbortSignal): Promise<void> {\n if (signal.aborted) {\n return Promise.resolve();\n }\n\n return new Promise((resolve) => {\n signal.addEventListener(\"abort\", () => resolve(), { once: true });\n });\n}\n\n/**\n * Create a Helium background worker definition.\n *\n * Workers are long-running background processes that start when the server\n * starts and continue running until the server shuts down. They are ideal for:\n * - Queue consumers (processing jobs from Redis, RabbitMQ, SQS, etc.)\n * - Background task processors\n * - Scheduled jobs and cron-like tasks\n * - Real-time data synchronization\n * - WebSocket connection managers\n * - Cache warmers and data pre-loaders\n *\n * @example\n * ```typescript\n * // Basic worker\n * export const queueConsumer = defineWorker(async (ctx) => {\n * while (true) {\n * const job = await queue.pop();\n * if (job) {\n * await processJob(job);\n * }\n * await sleep(1000);\n * }\n * }, { name: 'queueConsumer' });\n *\n * // Worker with options\n * export const dataSync = defineWorker(async (ctx) => {\n * // Sync data every 30 seconds\n * while (true) {\n * await syncData();\n * await sleep(30000);\n * }\n * }, {\n * name: 'dataSync',\n * autoRestart: true,\n * restartDelayMs: 10000,\n * maxRestarts: 5\n * });\n * ```\n *\n * @param handler - The worker function that runs in the background\n * @param options - Configuration options for the worker\n * @returns A HeliumWorkerDef that will be started by the server runtime\n */\nexport function defineWorker(handler: WorkerHandler, options: WorkerOptions = {}): HeliumWorkerDef {\n if (!handler) {\n throw new Error(\"defineWorker requires a handler\");\n }\n\n const name = options.name || handler.name || \"anonymous\";\n\n const resolvedOptions: Required<WorkerOptions> = {\n name,\n autoRestart: options.autoRestart ?? true,\n restartDelayMs: options.restartDelayMs ?? 5000,\n maxRestarts: options.maxRestarts ?? 0,\n autoStart: options.autoStart ?? true,\n };\n\n return {\n __kind: \"worker\",\n __id: name,\n name,\n handler,\n options: resolvedOptions,\n };\n}\n\n/**\n * Start a worker and manage its lifecycle.\n * @internal\n */\nexport async function startWorker(worker: HeliumWorkerDef, createContext: () => HeliumContext): Promise<WorkerInstance> {\n const { name, handler, options } = worker;\n\n // Check if worker is already running\n if (runningWorkers.has(name)) {\n const existing = runningWorkers.get(name)!;\n log(\"warn\", `Worker '${name}' is already running`);\n return existing.instance;\n }\n\n const abortController = new AbortController();\n let restartCount = 0;\n const workerState = {\n abortController,\n promise: Promise.resolve(),\n instance: undefined as unknown as WorkerInstance,\n cleanupHandlers: [] as Array<() => Promise<void> | void>,\n cleanupPromise: null as Promise<void> | null,\n };\n\n const instance: WorkerInstance = {\n id: name,\n name,\n status: \"running\",\n startedAt: new Date(),\n restartCount: 0,\n stop: async () => {\n abortController.abort();\n instance.status = \"stopped\";\n await runWorkerCleanup(name, workerState);\n runningWorkers.delete(name);\n log(\"info\", `Worker '${name}' stopped`);\n },\n };\n workerState.instance = instance;\n\n const runWorker = async (): Promise<void> => {\n while (!abortController.signal.aborted) {\n try {\n instance.status = \"running\";\n instance.startedAt = new Date();\n log(\"info\", `Starting worker '${name}'`);\n\n const ctx = createContext();\n const lifecycle: WorkerLifecycle = {\n signal: abortController.signal,\n onCleanup: (cleanup) => {\n registerCleanup(workerState, cleanup);\n },\n };\n const cleanup = await handler(ctx, lifecycle);\n registerCleanup(workerState, cleanup);\n\n if (isCleanupHandler(cleanup) && !abortController.signal.aborted) {\n await waitForAbort(abortController.signal);\n }\n\n // If handler completes normally, exit the loop\n if (!abortController.signal.aborted) {\n await runWorkerCleanup(name, workerState);\n log(\"info\", `Worker '${name}' completed successfully`);\n instance.status = \"stopped\";\n runningWorkers.delete(name);\n }\n break;\n } catch (error) {\n if (abortController.signal.aborted) {\n // Worker was intentionally stopped\n break;\n }\n\n await runWorkerCleanup(name, workerState);\n workerState.cleanupPromise = null;\n\n instance.lastError = error instanceof Error ? error : new Error(String(error));\n instance.status = \"crashed\";\n restartCount++;\n instance.restartCount = restartCount;\n\n log(\"error\", `Worker '${name}' crashed:`, error);\n\n // Check if we should restart\n if (options.autoRestart) {\n if (options.maxRestarts > 0 && restartCount >= options.maxRestarts) {\n log(\"error\", `Worker '${name}' exceeded max restarts (${options.maxRestarts}), giving up`);\n runningWorkers.delete(name);\n break;\n }\n\n instance.status = \"restarting\";\n log(\n \"info\",\n `Worker '${name}' will restart in ${options.restartDelayMs}ms (attempt ${restartCount}${options.maxRestarts > 0 ? `/${options.maxRestarts}` : \"\"})`\n );\n\n await new Promise((resolve) => setTimeout(resolve, options.restartDelayMs));\n } else {\n runningWorkers.delete(name);\n break;\n }\n }\n }\n };\n\n const promise = runWorker();\n workerState.promise = promise;\n\n runningWorkers.set(name, workerState);\n\n return instance;\n}\n\n/**\n * Stop a running worker by name.\n */\nexport function stopWorker(name: string): boolean {\n const worker = runningWorkers.get(name);\n if (worker) {\n worker.abortController.abort();\n worker.instance.status = \"stopped\";\n void runWorkerCleanup(name, worker)\n .catch(() => {})\n .finally(() => {\n runningWorkers.delete(name);\n log(\"info\", `Worker '${name}' stopped`);\n });\n return true;\n }\n return false;\n}\n\n/**\n * Stop all running workers.\n */\nexport async function stopAllWorkers(): Promise<void> {\n const workers = Array.from(runningWorkers.values());\n for (const worker of workers) {\n worker.abortController.abort();\n worker.instance.status = \"stopped\";\n }\n await Promise.all(workers.map(async (worker) => runWorkerCleanup(worker.instance.name, worker)));\n runningWorkers.clear();\n log(\"info\", `Stopped ${workers.length} worker(s)`);\n}\n\n/**\n * Get the status of all workers.\n */\nexport function getWorkerStatus(): WorkerInstance[] {\n return Array.from(runningWorkers.values()).map((w) => w.instance);\n}\n\n/**\n * Get a specific worker's status.\n */\nexport function getWorkerById(name: string): WorkerInstance | undefined {\n return runningWorkers.get(name)?.instance;\n}\n"]}
1
+ {"version":3,"file":"defineWorker.js","sourceRoot":"","sources":["../../src/server/defineWorker.ts"],"names":[],"mappings":"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","sourcesContent":["import { log } from \"../utils/logger.js\";\nimport type { HeliumContext } from \"./context.js\";\n\nexport type WorkerCleanup = (() => Promise<void> | void) | void;\n\nexport interface WorkerLifecycle {\n signal: AbortSignal;\n onCleanup: (cleanup: WorkerCleanup) => void;\n}\n\nexport interface WorkerOptions {\n /**\n * The name of the worker, used for logging and identification.\n * If not provided, the handler function name will be used.\n */\n name?: string;\n\n /**\n * Whether the worker should automatically restart if it crashes.\n * Default: true\n */\n autoRestart?: boolean;\n\n /**\n * Delay in milliseconds before restarting the worker after a crash.\n * Default: 5000 (5 seconds)\n */\n restartDelayMs?: number;\n\n /**\n * Maximum number of restart attempts before giving up.\n * Set to 0 for unlimited restarts.\n * Default: 0 (unlimited)\n */\n maxRestarts?: number;\n\n /**\n * Whether to start the worker automatically on server startup.\n * Default: true\n */\n autoStart?: boolean;\n}\n\nexport type WorkerHandler = (ctx: HeliumContext, lifecycle: WorkerLifecycle) => Promise<WorkerCleanup> | WorkerCleanup;\n\nexport type HeliumWorkerDef = {\n __kind: \"worker\";\n __id: string;\n name: string;\n handler: WorkerHandler;\n options: Required<WorkerOptions>;\n};\n\nexport interface WorkerInstance {\n id: string;\n name: string;\n status: \"running\" | \"stopped\" | \"crashed\" | \"restarting\";\n startedAt: Date | null;\n restartCount: number;\n lastError?: Error;\n stop: () => Promise<void>;\n}\n\ninterface WorkerState {\n abortController: AbortController;\n promise: Promise<void>;\n instance: WorkerInstance;\n cleanupHandlers: Array<() => Promise<void> | void>;\n cleanupPromise: Promise<void> | null;\n cleanupRequested: boolean;\n}\n\nconst runningWorkers = new Map<string, WorkerState>();\n\nfunction removeWorker(name: string, workerState: WorkerState): void {\n if (runningWorkers.get(name) === workerState) {\n runningWorkers.delete(name);\n }\n}\n\nfunction isCleanupHandler(cleanup: WorkerCleanup): cleanup is () => Promise<void> | void {\n return typeof cleanup === \"function\";\n}\n\nfunction registerCleanup(name: string, workerState: WorkerState, cleanup: WorkerCleanup) {\n if (!isCleanupHandler(cleanup)) {\n return;\n }\n\n workerState.cleanupHandlers.push(cleanup);\n // Async setup may finish after stop() has returned. Dispose its resources too.\n if (workerState.cleanupRequested) {\n void runWorkerCleanup(name, workerState);\n }\n}\n\nasync function runWorkerCleanup(name: string, workerState: WorkerState): Promise<void> {\n workerState.cleanupRequested = true;\n if (workerState.cleanupPromise) {\n await workerState.cleanupPromise;\n if (workerState.cleanupHandlers.length > 0) {\n await runWorkerCleanup(name, workerState);\n }\n return;\n }\n\n const cleanupPromise = (async () => {\n while (workerState.cleanupHandlers.length > 0) {\n const cleanupHandlers = workerState.cleanupHandlers.splice(0).reverse();\n for (const cleanup of cleanupHandlers) {\n try {\n await cleanup();\n } catch (error) {\n log(\"error\", `Worker '${name}' cleanup failed:`, error);\n }\n }\n }\n })();\n workerState.cleanupPromise = cleanupPromise;\n try {\n await cleanupPromise;\n } finally {\n if (workerState.cleanupPromise === cleanupPromise) {\n workerState.cleanupPromise = null;\n }\n }\n}\n\nfunction waitForRestart(signal: AbortSignal, delay: number): Promise<void> {\n if (signal.aborted) {\n return Promise.resolve();\n }\n return new Promise((resolve) => {\n const done = () => {\n clearTimeout(timer);\n signal.removeEventListener(\"abort\", done);\n resolve();\n };\n const timer = setTimeout(done, delay);\n signal.addEventListener(\"abort\", done, { once: true });\n });\n}\n\nfunction waitForAbort(signal: AbortSignal): Promise<void> {\n if (signal.aborted) {\n return Promise.resolve();\n }\n\n return new Promise((resolve) => {\n signal.addEventListener(\"abort\", () => resolve(), { once: true });\n });\n}\n\n/**\n * Create a Helium background worker definition.\n *\n * Workers are long-running background processes that start when the server\n * starts and continue running until the server shuts down. They are ideal for:\n * - Queue consumers (processing jobs from Redis, RabbitMQ, SQS, etc.)\n * - Background task processors\n * - Scheduled jobs and cron-like tasks\n * - Real-time data synchronization\n * - WebSocket connection managers\n * - Cache warmers and data pre-loaders\n *\n * @example\n * ```typescript\n * // Basic worker\n * export const queueConsumer = defineWorker(async (ctx) => {\n * while (true) {\n * const job = await queue.pop();\n * if (job) {\n * await processJob(job);\n * }\n * await sleep(1000);\n * }\n * }, { name: 'queueConsumer' });\n *\n * // Worker with options\n * export const dataSync = defineWorker(async (ctx) => {\n * // Sync data every 30 seconds\n * while (true) {\n * await syncData();\n * await sleep(30000);\n * }\n * }, {\n * name: 'dataSync',\n * autoRestart: true,\n * restartDelayMs: 10000,\n * maxRestarts: 5\n * });\n * ```\n *\n * @param handler - The worker function that runs in the background\n * @param options - Configuration options for the worker\n * @returns A HeliumWorkerDef that will be started by the server runtime\n */\nexport function defineWorker(handler: WorkerHandler, options: WorkerOptions = {}): HeliumWorkerDef {\n if (!handler) {\n throw new Error(\"defineWorker requires a handler\");\n }\n\n const name = options.name || handler.name || \"anonymous\";\n\n const resolvedOptions: Required<WorkerOptions> = {\n name,\n autoRestart: options.autoRestart ?? true,\n restartDelayMs: options.restartDelayMs ?? 5000,\n maxRestarts: options.maxRestarts ?? 0,\n autoStart: options.autoStart ?? true,\n };\n\n return {\n __kind: \"worker\",\n __id: name,\n name,\n handler,\n options: resolvedOptions,\n };\n}\n\n/**\n * Start a worker and manage its lifecycle.\n * @internal\n */\nexport async function startWorker(worker: HeliumWorkerDef, createContext: () => HeliumContext): Promise<WorkerInstance> {\n const { name, handler, options } = worker;\n\n // Check if worker is already running\n if (runningWorkers.has(name)) {\n const existing = runningWorkers.get(name)!;\n log(\"warn\", `Worker '${name}' is already running`);\n return existing.instance;\n }\n\n const abortController = new AbortController();\n let restartCount = 0;\n const workerState = {\n abortController,\n promise: Promise.resolve(),\n instance: undefined as unknown as WorkerInstance,\n cleanupHandlers: [] as Array<() => Promise<void> | void>,\n cleanupPromise: null as Promise<void> | null,\n cleanupRequested: false,\n };\n\n const instance: WorkerInstance = {\n id: name,\n name,\n status: \"running\",\n startedAt: new Date(),\n restartCount: 0,\n stop: async () => {\n abortController.abort();\n instance.status = \"stopped\";\n await runWorkerCleanup(name, workerState);\n removeWorker(name, workerState);\n log(\"info\", `Worker '${name}' stopped`);\n },\n };\n workerState.instance = instance;\n\n const runWorker = async (): Promise<void> => {\n while (!abortController.signal.aborted) {\n try {\n workerState.cleanupRequested = false;\n instance.status = \"running\";\n instance.startedAt = new Date();\n log(\"info\", `Starting worker '${name}'`);\n\n const ctx = createContext();\n const lifecycle: WorkerLifecycle = {\n signal: abortController.signal,\n onCleanup: (cleanup) => {\n registerCleanup(name, workerState, cleanup);\n },\n };\n const cleanup = await handler(ctx, lifecycle);\n registerCleanup(name, workerState, cleanup);\n\n if (isCleanupHandler(cleanup) && !abortController.signal.aborted) {\n await waitForAbort(abortController.signal);\n }\n\n // If handler completes normally, exit the loop\n if (!abortController.signal.aborted) {\n await runWorkerCleanup(name, workerState);\n log(\"info\", `Worker '${name}' completed successfully`);\n instance.status = \"stopped\";\n removeWorker(name, workerState);\n } else {\n await runWorkerCleanup(name, workerState);\n }\n break;\n } catch (error) {\n if (abortController.signal.aborted) {\n // Worker was intentionally stopped\n break;\n }\n\n await runWorkerCleanup(name, workerState);\n if (abortController.signal.aborted) {\n break;\n }\n\n instance.lastError = error instanceof Error ? error : new Error(String(error));\n instance.status = \"crashed\";\n log(\"error\", `Worker '${name}' crashed:`, error);\n\n // Check if we should restart\n if (options.autoRestart) {\n if (options.maxRestarts > 0 && restartCount >= options.maxRestarts) {\n log(\"error\", `Worker '${name}' exceeded max restarts (${options.maxRestarts}), giving up`);\n removeWorker(name, workerState);\n break;\n }\n\n restartCount++;\n instance.restartCount = restartCount;\n instance.status = \"restarting\";\n log(\n \"info\",\n `Worker '${name}' will restart in ${options.restartDelayMs}ms (attempt ${restartCount}${options.maxRestarts > 0 ? `/${options.maxRestarts}` : \"\"})`\n );\n\n await waitForRestart(abortController.signal, options.restartDelayMs);\n } else {\n removeWorker(name, workerState);\n break;\n }\n }\n }\n };\n\n // Publish state before invoking user code, including synchronous handlers.\n runningWorkers.set(name, workerState);\n workerState.promise = runWorker();\n\n return instance;\n}\n\n/**\n * Stop a running worker by name.\n */\nexport function stopWorker(name: string): boolean {\n const worker = runningWorkers.get(name);\n if (worker) {\n void worker.instance.stop();\n return true;\n }\n return false;\n}\n\n/**\n * Stop all running workers.\n */\nexport async function stopAllWorkers(): Promise<void> {\n const workers = Array.from(runningWorkers.values());\n await Promise.all(workers.map((worker) => worker.instance.stop()));\n log(\"info\", `Stopped ${workers.length} worker(s)`);\n}\n\n/**\n * Get the status of all workers.\n */\nexport function getWorkerStatus(): WorkerInstance[] {\n return Array.from(runningWorkers.values()).map((w) => w.instance);\n}\n\n/**\n * Get a specific worker's status.\n */\nexport function getWorkerById(name: string): WorkerInstance | undefined {\n return runningWorkers.get(name)?.instance;\n}\n"]}
@@ -1 +1 @@
1
- {"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../../src/server/devServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAuD,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3F,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAC5G,KAAK,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC;AAE3F,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;CAC3B;AAED,KAAK,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC;IAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAqD7K;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,cAAc,EAC5B,MAAM,GAAE,YAAiB,EACzB,OAAO,GAAE,WAAW,EAAO,EAC3B,QAAQ,GAAE,UAAU,EAAO,EAC3B,QAAQ,GAAE,cAAqB,QA6iBlC"}
1
+ {"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../../src/server/devServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAQtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAGzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAI7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAuD,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3F,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAC5G,KAAK,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC;AAE3F,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;CAC3B;AAED,KAAK,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC;IAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAyD7K;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,cAAc,EAC5B,MAAM,GAAE,YAAiB,EACzB,OAAO,GAAE,WAAW,EAAO,EAC3B,QAAQ,GAAE,UAAU,EAAO,EAC3B,QAAQ,GAAE,cAAqB,QA4kBlC"}
@@ -1,25 +1,22 @@
1
- import { encode as msgpackEncode } from "@msgpack/msgpack";
1
+ import { decode as msgpackDecode, encode as msgpackEncode } from "@msgpack/msgpack";
2
2
  import path from "path";
3
- import { promisify } from "util";
4
3
  import { WebSocketServer } from "ws";
5
- import { brotliCompress, deflate, gzip } from "zlib";
6
4
  import { SEO_METADATA_RPC_METHOD } from "../runtime/internalMethods.js";
7
5
  import { injectEnvToProcess, injectHeliumEnvIntoHtml, loadEnvFiles } from "../utils/envLoader.js";
8
6
  import { extractClientIP } from "../utils/ipExtractor.js";
9
7
  import { log } from "../utils/logger.js";
10
8
  import { getRpcConfig, getRpcSecurityConfig, getTrustProxyDepth } from "./config.js";
11
9
  import { startWorker, stopAllWorkers } from "./defineWorker.js";
10
+ import { compressHttpRpcResponse } from "./httpCompression.js";
12
11
  import { HTTPRouter } from "./httpRouter.js";
13
12
  import { injectSocialMetaIntoHtml, loadDefaultSocialMetaFromHtmlFile } from "./meta.js";
14
13
  import { RateLimiter } from "./rateLimiter.js";
14
+ import { withRequestErrorHandling } from "./requestHandler.js";
15
15
  import { RpcRegistry } from "./rpcRegistry.js";
16
16
  import { initializeSecurity, verifyConnectionToken } from "./security.js";
17
17
  import { SEOMetadataRouter } from "./seoMetadataRouter.js";
18
18
  import { prepareForMsgpack } from "./serializer.js";
19
19
  import { matchSSRPage, renderSSRHTML, resolveServerSideProps } from "./ssr.js";
20
- const gzipAsync = promisify(gzip);
21
- const deflateAsync = promisify(deflate);
22
- const brotliCompressAsync = promisify(brotliCompress);
23
20
  let currentRegistry = null;
24
21
  let currentHttpRouter = null;
25
22
  let currentSEORouter = null;
@@ -30,6 +27,10 @@ let rateLimiter = null;
30
27
  let currentWorkers = [];
31
28
  let cachedDefaultMeta;
32
29
  let workerReloadPromise = Promise.resolve();
30
+ const originalRequestListeners = new WeakMap();
31
+ const socketRequests = new WeakMap();
32
+ let currentTrustProxyDepth = 0;
33
+ let currentMaxConnectionsPerIP = 10;
33
34
  function createWorkerContext() {
34
35
  return {
35
36
  req: {
@@ -75,9 +76,12 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
75
76
  const rpcSecurity = getRpcSecurityConfig(config);
76
77
  const rpcConfig = getRpcConfig(config);
77
78
  const compressionConfig = rpcConfig.compression;
79
+ currentTrustProxyDepth = trustProxyDepth;
80
+ currentMaxConnectionsPerIP = rpcSecurity.maxConnectionsPerIP;
78
81
  initializeSecurity(rpcSecurity);
79
- // Re-initialize rate limiter with new config (always recreate in dev mode to pick up config changes)
80
- rateLimiter = new RateLimiter(rpcSecurity.maxMessagesPerWindow, rpcSecurity.rateLimitWindowMs, rpcSecurity.maxConnectionsPerIP);
82
+ // Keep live connections tracked across handler reloads.
83
+ rateLimiter ?? (rateLimiter = new RateLimiter(rpcSecurity.maxMessagesPerWindow, rpcSecurity.rateLimitWindowMs, rpcSecurity.maxConnectionsPerIP));
84
+ rateLimiter.configure(rpcSecurity.maxMessagesPerWindow, rpcSecurity.rateLimitWindowMs, rpcSecurity.maxConnectionsPerIP);
81
85
  const registry = new RpcRegistry();
82
86
  const httpRouter = new HTTPRouter({ maxBodySize: rpcConfig.maxBodySize });
83
87
  const seoRouter = new SEOMetadataRouter();
@@ -85,12 +89,19 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
85
89
  loadHandlers(registry, httpRouter, seoRouter);
86
90
  registry.setRateLimiter(rateLimiter);
87
91
  registry.setMaxBatchSize(rpcConfig.maxBatchSize);
92
+ registry.setCompressionConfig(compressionConfig);
88
93
  currentRegistry = registry;
89
94
  currentHttpRouter = httpRouter;
90
95
  currentSEORouter = seoRouter;
91
96
  currentSSRPages = ssrPages;
92
97
  currentAppShell = appShell;
93
98
  cachedDefaultMeta = undefined;
99
+ for (const socket of wss?.clients ?? []) {
100
+ const req = socketRequests.get(socket);
101
+ if (req) {
102
+ registry.setSocketMetadata(socket, extractClientIP(req, trustProxyDepth), req);
103
+ }
104
+ }
94
105
  const getDefaultMeta = async () => {
95
106
  if (cachedDefaultMeta !== undefined) {
96
107
  return cachedDefaultMeta;
@@ -136,8 +147,9 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
136
147
  : false,
137
148
  });
138
149
  wss.on("connection", (socket, req) => {
150
+ socketRequests.set(socket, req);
139
151
  // Extract client IP with proxy configuration
140
- const ip = extractClientIP(req, trustProxyDepth);
152
+ const ip = extractClientIP(req, currentTrustProxyDepth);
141
153
  // Store connection metadata for RPC context
142
154
  if (currentRegistry) {
143
155
  currentRegistry.setSocketMetadata(socket, ip, req);
@@ -162,7 +174,6 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
162
174
  let req;
163
175
  // Always expect MessagePack
164
176
  const buffer = Buffer.isBuffer(msg) ? msg : Buffer.from(msg);
165
- const { decode: msgpackDecode } = require("@msgpack/msgpack");
166
177
  req = msgpackDecode(buffer);
167
178
  const stats = rateLimiter.getConnectionStats(socket);
168
179
  const now = Date.now();
@@ -183,7 +194,8 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
183
194
  else {
184
195
  errorResponse = createError(req.id);
185
196
  }
186
- socket.send(msgpackEncode(errorResponse));
197
+ const encodedError = msgpackEncode(errorResponse);
198
+ socket.send(encodedError, { compress: compressionConfig.enabled && encodedError.length > compressionConfig.threshold });
187
199
  }
188
200
  catch {
189
201
  // If we can't parse the request, just close the connection
@@ -193,13 +205,15 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
193
205
  }
194
206
  // Always use the current registry (may have been updated)
195
207
  if (currentRegistry) {
196
- currentRegistry.handleMessage(socket, Buffer.isBuffer(msg) ? msg : Buffer.from(msg));
208
+ void currentRegistry.handleMessage(socket, Buffer.isBuffer(msg) ? msg : Buffer.from(msg)).catch((error) => {
209
+ log("error", "WebSocket RPC error:", error);
210
+ });
197
211
  }
198
212
  });
199
213
  });
200
214
  // Handle WebSocket upgrade requests
201
215
  httpServer.on("upgrade", (req, socket, head) => {
202
- if (req.url?.startsWith("/rpc")) {
216
+ if (req.url?.split("?")[0] === "/rpc") {
203
217
  // Security: read token from Sec-WebSocket-Protocol header instead of query string
204
218
  const protocols = req.headers["sec-websocket-protocol"];
205
219
  const token = typeof protocols === "string"
@@ -215,10 +229,10 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
215
229
  return;
216
230
  }
217
231
  // Check IP connection limit before upgrading
218
- const ip = extractClientIP(req, trustProxyDepth);
219
- if (rateLimiter && rpcSecurity.maxConnectionsPerIP > 0) {
232
+ const ip = extractClientIP(req, currentTrustProxyDepth);
233
+ if (rateLimiter && currentMaxConnectionsPerIP > 0) {
220
234
  const currentConnections = rateLimiter.getIPConnectionCount(ip);
221
- if (currentConnections >= rpcSecurity.maxConnectionsPerIP) {
235
+ if (currentConnections >= currentMaxConnectionsPerIP) {
222
236
  log("warn", `WebSocket connection rejected - IP ${ip} has ${currentConnections} connections`);
223
237
  socket.write("HTTP/1.1 429 Too Many Requests\r\n\r\n");
224
238
  socket.destroy();
@@ -231,14 +245,27 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
231
245
  }
232
246
  });
233
247
  log("info", "WebSocket RPC attached to dev server at /rpc");
248
+ const attachedWss = wss;
249
+ httpServer.once("close", () => {
250
+ for (const socket of attachedWss.clients) {
251
+ socket.terminate();
252
+ }
253
+ attachedWss.close();
254
+ if (wss === attachedWss) {
255
+ wss = null;
256
+ rateLimiter = null;
257
+ }
258
+ workerReloadPromise = workerReloadPromise.then(() => stopAllWorkers());
259
+ });
234
260
  }
235
261
  // Security: max body size for HTTP requests
236
262
  const maxBodySize = rpcConfig.maxBodySize ?? 1048576;
237
263
  // Attach HTTP request handler
238
264
  // We need to intercept requests before Vite handles them
239
- const originalListeners = httpServer.listeners("request").slice();
265
+ const originalListeners = originalRequestListeners.get(httpServer) ?? httpServer.listeners("request").slice();
266
+ originalRequestListeners.set(httpServer, originalListeners);
240
267
  httpServer.removeAllListeners("request");
241
- httpServer.on("request", async (req, res) => {
268
+ const handleRequest = withRequestErrorHandling(async (req, res) => {
242
269
  const reqUrl = new URL(req.url || "/", "http://localhost");
243
270
  const pathname = reqUrl.pathname;
244
271
  const search = reqUrl.search;
@@ -266,6 +293,7 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
266
293
  const ssrResult = await resolveServerSideProps({
267
294
  req,
268
295
  pathname: targetPathname,
296
+ search: targetUrl.search,
269
297
  params: ssrMatch.params,
270
298
  page: ssrMatch.page,
271
299
  ctx: httpCtx,
@@ -286,7 +314,7 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
286
314
  return;
287
315
  }
288
316
  // Handle token refresh endpoint
289
- if (req.url === "/__helium__/refresh-token") {
317
+ if (pathname === "/__helium__/refresh-token") {
290
318
  // Security: only allow POST to prevent CSRF via <img>/<script> tags
291
319
  if (req.method !== "POST") {
292
320
  res.writeHead(405, { "Content-Type": "application/json" });
@@ -301,12 +329,12 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
301
329
  }
302
330
  const { generateConnectionToken } = await import("./security.js");
303
331
  const token = generateConnectionToken();
304
- res.writeHead(200, { "Content-Type": "application/json" });
332
+ res.writeHead(200, { "Content-Type": "application/json", "Cache-Control": "no-store" });
305
333
  res.end(JSON.stringify({ token }));
306
334
  return;
307
335
  }
308
336
  // Handle HTTP-based RPC endpoint (alternative to WebSocket for mobile networks)
309
- if (req.url === "/__helium__/rpc" && req.method === "POST") {
337
+ if (pathname === "/__helium__/rpc" && req.method === "POST") {
310
338
  // Security: verify connection token for HTTP RPC
311
339
  const authToken = req.headers["x-helium-token"];
312
340
  if (!authToken || !verifyConnectionToken(authToken)) {
@@ -324,11 +352,16 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
324
352
  const chunks = [];
325
353
  let totalSize = 0;
326
354
  let aborted = false;
355
+ req.on("error", () => {
356
+ aborted = true;
357
+ });
327
358
  req.on("data", (chunk) => {
359
+ if (aborted) {
360
+ return;
361
+ }
328
362
  totalSize += chunk.length;
329
363
  if (totalSize > maxBodySize) {
330
364
  aborted = true;
331
- req.destroy();
332
365
  res.writeHead(413, { "Content-Type": "application/json" });
333
366
  res.end(JSON.stringify({ ok: false, error: "Request entity too large" }));
334
367
  return;
@@ -349,29 +382,16 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
349
382
  const ip = extractClientIP(req, trustProxyDepth);
350
383
  const result = await currentRegistry.handleHttpRequest(body, ip, req);
351
384
  const encoded = msgpackEncode(prepareForMsgpack(result.response));
352
- let responseBody = Buffer.from(encoded);
385
+ const compressed = await compressHttpRpcResponse(Buffer.from(encoded), req.headers["accept-encoding"]);
353
386
  const headers = {
354
387
  "Content-Type": "application/msgpack",
355
388
  "Cache-Control": "no-store",
356
389
  };
357
- // Handle compression
358
- const acceptEncoding = req.headers["accept-encoding"];
359
- if (acceptEncoding && responseBody.length > 1024) {
360
- if (acceptEncoding.includes("br")) {
361
- responseBody = await brotliCompressAsync(responseBody);
362
- headers["Content-Encoding"] = "br";
363
- }
364
- else if (acceptEncoding.includes("gzip")) {
365
- responseBody = await gzipAsync(responseBody);
366
- headers["Content-Encoding"] = "gzip";
367
- }
368
- else if (acceptEncoding.includes("deflate")) {
369
- responseBody = await deflateAsync(responseBody);
370
- headers["Content-Encoding"] = "deflate";
371
- }
390
+ if (compressed.encoding) {
391
+ headers["Content-Encoding"] = compressed.encoding;
372
392
  }
373
393
  res.writeHead(200, headers);
374
- res.end(responseBody);
394
+ res.end(compressed.body);
375
395
  }
376
396
  catch (error) {
377
397
  log("error", "HTTP RPC error:", error);
@@ -530,6 +550,7 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
530
550
  }
531
551
  else {
532
552
  log("error", `Failed to render SSR page for ${pathname}:`, error);
553
+ throw error;
533
554
  }
534
555
  }
535
556
  }
@@ -540,7 +561,15 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
540
561
  flushPendingWriteHead();
541
562
  originalEnd(Buffer.from(html, "utf-8"));
542
563
  };
543
- void finalize();
564
+ void finalize().catch((error) => {
565
+ log("error", "Failed to finalize dev response:", error);
566
+ if (!res.headersSent) {
567
+ originalWriteHead(500, { "Content-Type": "text/plain" });
568
+ }
569
+ if (!res.writableEnded) {
570
+ originalEnd("Internal server error");
571
+ }
572
+ });
544
573
  return true;
545
574
  };
546
575
  }
@@ -549,6 +578,7 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
549
578
  listener(req, res);
550
579
  }
551
580
  });
581
+ httpServer.on("request", handleRequest);
552
582
  }
553
583
  function toBuffer(chunk, encoding) {
554
584
  if (Buffer.isBuffer(chunk)) {