heliumts 0.9.5 → 0.9.7
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/README.md +7 -3
- package/dist/bin/helium.js +61 -53
- package/dist/bin/helium.js.map +1 -1
- package/dist/client/Router.d.ts +2 -2
- package/dist/client/Router.d.ts.map +1 -1
- package/dist/client/Router.js +32 -29
- package/dist/client/Router.js.map +1 -1
- package/dist/client/cache.d.ts.map +1 -1
- package/dist/client/cache.js +13 -13
- package/dist/client/cache.js.map +1 -1
- package/dist/client/callMethod.d.ts +13 -0
- package/dist/client/callMethod.d.ts.map +1 -0
- package/dist/client/callMethod.js +10 -0
- package/dist/client/callMethod.js.map +1 -0
- package/dist/client/env.js.map +1 -1
- package/dist/client/index.d.ts +2 -1
- package/dist/client/index.d.ts.map +1 -1
- package/dist/client/index.js +1 -0
- package/dist/client/index.js.map +1 -1
- package/dist/client/routerManifest.d.ts.map +1 -1
- package/dist/client/routerManifest.js +18 -29
- package/dist/client/routerManifest.js.map +1 -1
- package/dist/client/rpcClient.d.ts +7 -3
- package/dist/client/rpcClient.d.ts.map +1 -1
- package/dist/client/rpcClient.js +80 -78
- package/dist/client/rpcClient.js.map +1 -1
- package/dist/client/transitions.d.ts +1 -1
- package/dist/client/transitions.d.ts.map +1 -1
- package/dist/client/useCall.d.ts.map +1 -1
- package/dist/client/useCall.js +4 -1
- package/dist/client/useCall.js.map +1 -1
- package/dist/client/useFetch.d.ts.map +1 -1
- package/dist/client/useFetch.js +48 -92
- package/dist/client/useFetch.js.map +1 -1
- package/dist/runtime/routeOrder.d.ts +3 -0
- package/dist/runtime/routeOrder.d.ts.map +1 -0
- package/dist/runtime/routeOrder.js +15 -0
- package/dist/runtime/routeOrder.js.map +1 -0
- package/dist/server/config.d.ts.map +1 -1
- package/dist/server/config.js +51 -26
- package/dist/server/config.js.map +1 -1
- package/dist/server/defineHTTPRequest.d.ts +1 -1
- package/dist/server/defineHTTPRequest.d.ts.map +1 -1
- package/dist/server/defineHTTPRequest.js.map +1 -1
- package/dist/server/defineWorker.d.ts.map +1 -1
- package/dist/server/defineWorker.js +68 -37
- package/dist/server/defineWorker.js.map +1 -1
- package/dist/server/devServer.d.ts.map +1 -1
- package/dist/server/devServer.js +70 -40
- package/dist/server/devServer.js.map +1 -1
- package/dist/server/httpCompression.d.ts +8 -0
- package/dist/server/httpCompression.d.ts.map +1 -0
- package/dist/server/httpCompression.js +58 -0
- package/dist/server/httpCompression.js.map +1 -0
- package/dist/server/httpRouter.d.ts.map +1 -1
- package/dist/server/httpRouter.js +138 -43
- package/dist/server/httpRouter.js.map +1 -1
- package/dist/server/meta.d.ts.map +1 -1
- package/dist/server/meta.js +23 -15
- package/dist/server/meta.js.map +1 -1
- package/dist/server/prodServer.d.ts.map +1 -1
- package/dist/server/prodServer.js +87 -46
- package/dist/server/prodServer.js.map +1 -1
- package/dist/server/rateLimiter.d.ts +9 -0
- package/dist/server/rateLimiter.d.ts.map +1 -1
- package/dist/server/rateLimiter.js +46 -0
- package/dist/server/rateLimiter.js.map +1 -1
- package/dist/server/requestHandler.d.ts +4 -0
- package/dist/server/requestHandler.d.ts.map +1 -0
- package/dist/server/requestHandler.js +20 -0
- package/dist/server/requestHandler.js.map +1 -0
- package/dist/server/rpcRegistry.d.ts +4 -0
- package/dist/server/rpcRegistry.d.ts.map +1 -1
- package/dist/server/rpcRegistry.js +60 -15
- package/dist/server/rpcRegistry.js.map +1 -1
- package/dist/server/security.d.ts.map +1 -1
- package/dist/server/security.js +3 -2
- package/dist/server/security.js.map +1 -1
- package/dist/server/serializer.js +17 -6
- package/dist/server/serializer.js.map +1 -1
- package/dist/server/ssr.d.ts +2 -1
- package/dist/server/ssr.d.ts.map +1 -1
- package/dist/server/ssr.js +29 -32
- package/dist/server/ssr.js.map +1 -1
- package/dist/utils/envLoader.js +1 -1
- package/dist/utils/envLoader.js.map +1 -1
- package/dist/utils/html.d.ts +7 -0
- package/dist/utils/html.d.ts.map +1 -0
- package/dist/utils/html.js +197 -0
- package/dist/utils/html.js.map +1 -0
- package/dist/utils/ipExtractor.d.ts +6 -52
- package/dist/utils/ipExtractor.d.ts.map +1 -1
- package/dist/utils/ipExtractor.js +21 -118
- package/dist/utils/ipExtractor.js.map +1 -1
- package/dist/vite/heliumPlugin.d.ts.map +1 -1
- package/dist/vite/heliumPlugin.js +75 -83
- package/dist/vite/heliumPlugin.js.map +1 -1
- package/dist/vite/scanner.d.ts +3 -0
- package/dist/vite/scanner.d.ts.map +1 -1
- package/dist/vite/scanner.js +89 -18
- package/dist/vite/scanner.js.map +1 -1
- package/dist/vite/ssg.d.ts +4 -0
- package/dist/vite/ssg.d.ts.map +1 -1
- package/dist/vite/ssg.js +66 -39
- package/dist/vite/ssg.js.map +1 -1
- package/dist/vite/virtualServerModule.d.ts +1 -1
- package/dist/vite/virtualServerModule.d.ts.map +1 -1
- package/dist/vite/virtualServerModule.js +28 -16
- package/dist/vite/virtualServerModule.js.map +1 -1
- package/package.json +12 -7
|
@@ -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;
|
|
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"}
|
package/dist/server/devServer.js
CHANGED
|
@@ -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
|
-
//
|
|
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,
|
|
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
|
-
|
|
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?.
|
|
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,
|
|
219
|
-
if (rateLimiter &&
|
|
232
|
+
const ip = extractClientIP(req, currentTrustProxyDepth);
|
|
233
|
+
if (rateLimiter && currentMaxConnectionsPerIP > 0) {
|
|
220
234
|
const currentConnections = rateLimiter.getIPConnectionCount(ip);
|
|
221
|
-
if (currentConnections >=
|
|
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
|
-
|
|
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 (
|
|
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 (
|
|
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
|
-
|
|
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
|
-
|
|
358
|
-
|
|
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(
|
|
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)) {
|