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":"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"}
@@ -0,0 +1,197 @@
1
+ const RAW_TEXT_TAGS = new Set(["script", "style", "textarea", "title", "xmp", "iframe", "noembed", "noframes"]);
2
+ const VOID_TAGS = new Set(["area", "base", "br", "col", "embed", "hr", "img", "input", "link", "meta", "param", "source", "track", "wbr"]);
3
+ function tagEnd(html, start) {
4
+ let quote = "";
5
+ for (let index = start; index < html.length; index++) {
6
+ const character = html[index];
7
+ if (quote) {
8
+ if (character === quote) {
9
+ quote = "";
10
+ }
11
+ }
12
+ else if (character === '"' || character === "'") {
13
+ quote = character;
14
+ }
15
+ else if (character === ">") {
16
+ return index + 1;
17
+ }
18
+ }
19
+ return -1;
20
+ }
21
+ function readAttributes(html, start, end) {
22
+ const attributes = [];
23
+ let index = start;
24
+ while (index < end - 1) {
25
+ while (/\s/.test(html[index] ?? "")) {
26
+ index++;
27
+ }
28
+ if (index >= end - 1) {
29
+ break;
30
+ }
31
+ if (html[index] === "/") {
32
+ index++;
33
+ continue;
34
+ }
35
+ const attributeStart = index;
36
+ while (index < end - 1 && !/[\s=/>]/.test(html[index])) {
37
+ index++;
38
+ }
39
+ const name = html.slice(attributeStart, index).toLowerCase();
40
+ let attributeEnd = index;
41
+ while (index < end - 1 && /\s/.test(html[index])) {
42
+ index++;
43
+ }
44
+ let value = "";
45
+ if (html[index] === "=") {
46
+ index++;
47
+ while (index < end - 1 && /\s/.test(html[index])) {
48
+ index++;
49
+ }
50
+ const quote = html[index] === '"' || html[index] === "'" ? html[index++] : undefined;
51
+ const valueStart = index;
52
+ if (quote) {
53
+ while (index < end - 1 && html[index] !== quote) {
54
+ index++;
55
+ }
56
+ value = html.slice(valueStart, index);
57
+ if (html[index] === quote) {
58
+ index++;
59
+ }
60
+ }
61
+ else {
62
+ while (index < end - 1 && !/\s/.test(html[index])) {
63
+ index++;
64
+ }
65
+ value = html.slice(valueStart, index);
66
+ }
67
+ attributeEnd = index;
68
+ }
69
+ if (name) {
70
+ attributes.push({ name, value, start: attributeStart, end: attributeEnd });
71
+ }
72
+ // Make progress even for malformed attributes.
73
+ if (index === attributeStart) {
74
+ index++;
75
+ }
76
+ }
77
+ return attributes;
78
+ }
79
+ function* tags(html) {
80
+ const lowerHtml = html.toLowerCase();
81
+ let index = 0;
82
+ while (index < html.length) {
83
+ const start = html.indexOf("<", index);
84
+ if (start === -1) {
85
+ return;
86
+ }
87
+ if (html.startsWith("<!--", start)) {
88
+ const end = html.indexOf("-->", start + 4);
89
+ index = end === -1 ? html.length : end + 3;
90
+ continue;
91
+ }
92
+ if (html.startsWith("<![CDATA[", start)) {
93
+ const end = html.indexOf("]]>", start + 9);
94
+ index = end === -1 ? html.length : end + 3;
95
+ continue;
96
+ }
97
+ const match = /^<(\/)?([a-z][a-z0-9:-]*)(?=[\s/>])/i.exec(html.slice(start));
98
+ if (!match) {
99
+ if (html[start + 1] === "!" || html[start + 1] === "?") {
100
+ const end = tagEnd(html, start + 2);
101
+ index = end === -1 ? html.length : end;
102
+ }
103
+ else {
104
+ index = start + 1;
105
+ }
106
+ continue;
107
+ }
108
+ const end = tagEnd(html, start + match[0].length);
109
+ if (end === -1) {
110
+ return;
111
+ }
112
+ const name = match[2].toLowerCase();
113
+ const closing = Boolean(match[1]);
114
+ yield { name, closing, start, end, attributes: closing ? [] : readAttributes(html, start + match[0].length, end) };
115
+ index = end;
116
+ if (!closing && name === "plaintext") {
117
+ return;
118
+ }
119
+ if (!closing && RAW_TEXT_TAGS.has(name)) {
120
+ // HTML raw text ends at its closing tag, regardless of JavaScript or
121
+ // CSS quoting. Markup-looking strings inside it are not elements.
122
+ let close = lowerHtml.indexOf(`</${name}`, index);
123
+ while (close !== -1 && !/[\s/>]/.test(html[close + name.length + 2] ?? "")) {
124
+ close = lowerHtml.indexOf(`</${name}`, close + 2);
125
+ }
126
+ index = close === -1 ? html.length : close;
127
+ }
128
+ }
129
+ }
130
+ function escapeAttribute(value) {
131
+ return value.replace(/&/g, "&amp;").replace(/"/g, "&quot;").replace(/</g, "&lt;").replace(/>/g, "&gt;");
132
+ }
133
+ function patchOpeningTag(html, tag, attributes) {
134
+ let opening = html.slice(tag.start, tag.end);
135
+ const updates = new Map(Object.entries(attributes).map(([name, value]) => [name.toLowerCase(), value]));
136
+ const replacements = [];
137
+ const handled = new Set();
138
+ for (const attribute of tag.attributes) {
139
+ if (!updates.has(attribute.name)) {
140
+ continue;
141
+ }
142
+ const value = updates.get(attribute.name);
143
+ replacements.push({
144
+ start: attribute.start - tag.start,
145
+ end: attribute.end - tag.start,
146
+ value: value === null || handled.has(attribute.name) ? "" : `${attribute.name}="${escapeAttribute(value)}"`,
147
+ });
148
+ handled.add(attribute.name);
149
+ }
150
+ for (const replacement of replacements.reverse()) {
151
+ opening = opening.slice(0, replacement.start) + replacement.value + opening.slice(replacement.end);
152
+ }
153
+ const additions = [...updates]
154
+ .filter(([name, value]) => !handled.has(name) && value !== null)
155
+ .map(([name, value]) => ` ${name}="${escapeAttribute(value)}"`)
156
+ .join("");
157
+ if (additions) {
158
+ const slash = /\/\s*>$/.exec(opening)?.index;
159
+ const slashBelongsToValue = html[tag.end - 2] === "/" && tag.attributes.some((attribute) => attribute.end === tag.end - 1);
160
+ const insertion = slash !== undefined && !slashBelongsToValue ? slash : opening.length - 1;
161
+ opening = opening.slice(0, insertion) + additions + opening.slice(insertion);
162
+ }
163
+ return opening;
164
+ }
165
+ /**
166
+ * Replace the contents of the live HTML root without consuming nested closing
167
+ * tags or matching examples inside comments, scripts, styles, or templates.
168
+ * Missing or unclosed roots leave the template unchanged.
169
+ */
170
+ export function replaceHtmlRootContents(html, contents, attributes = {}) {
171
+ let root;
172
+ let depth = 0;
173
+ let templateDepth = 0;
174
+ for (const tag of tags(html)) {
175
+ if (!root) {
176
+ if (tag.name === "template") {
177
+ templateDepth += tag.closing ? -1 : 1;
178
+ templateDepth = Math.max(0, templateDepth);
179
+ }
180
+ if (!tag.closing && !templateDepth && !VOID_TAGS.has(tag.name) && tag.attributes.find((attribute) => attribute.name === "id")?.value === "root") {
181
+ root = tag;
182
+ depth = 1;
183
+ }
184
+ continue;
185
+ }
186
+ if (tag.name !== root.name) {
187
+ continue;
188
+ }
189
+ // A self-closing slash is ignored on non-void HTML elements such as div.
190
+ depth += tag.closing ? -1 : 1;
191
+ if (depth === 0) {
192
+ return html.slice(0, root.start) + patchOpeningTag(html, root, attributes) + contents + html.slice(tag.start);
193
+ }
194
+ }
195
+ return html;
196
+ }
197
+ //# sourceMappingURL=html.js.map
@@ -0,0 +1 @@
1
+ {"version":3,"file":"html.js","sourceRoot":"","sources":["../../src/utils/html.ts"],"names":[],"mappings":"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","sourcesContent":["type Attribute = { name: string; value: string; start: number; end: number };\ntype Tag = { name: string; closing: boolean; start: number; end: number; attributes: Attribute[] };\n\nconst RAW_TEXT_TAGS = new Set([\"script\", \"style\", \"textarea\", \"title\", \"xmp\", \"iframe\", \"noembed\", \"noframes\"]);\nconst VOID_TAGS = new Set([\"area\", \"base\", \"br\", \"col\", \"embed\", \"hr\", \"img\", \"input\", \"link\", \"meta\", \"param\", \"source\", \"track\", \"wbr\"]);\n\nfunction tagEnd(html: string, start: number): number {\n let quote = \"\";\n for (let index = start; index < html.length; index++) {\n const character = html[index];\n if (quote) {\n if (character === quote) {\n quote = \"\";\n }\n } else if (character === '\"' || character === \"'\") {\n quote = character;\n } else if (character === \">\") {\n return index + 1;\n }\n }\n return -1;\n}\n\nfunction readAttributes(html: string, start: number, end: number): Attribute[] {\n const attributes: Attribute[] = [];\n let index = start;\n while (index < end - 1) {\n while (/\\s/.test(html[index] ?? \"\")) {\n index++;\n }\n if (index >= end - 1) {\n break;\n }\n if (html[index] === \"/\") {\n index++;\n continue;\n }\n const attributeStart = index;\n while (index < end - 1 && !/[\\s=/>]/.test(html[index])) {\n index++;\n }\n const name = html.slice(attributeStart, index).toLowerCase();\n let attributeEnd = index;\n while (index < end - 1 && /\\s/.test(html[index])) {\n index++;\n }\n let value = \"\";\n if (html[index] === \"=\") {\n index++;\n while (index < end - 1 && /\\s/.test(html[index])) {\n index++;\n }\n const quote = html[index] === '\"' || html[index] === \"'\" ? html[index++] : undefined;\n const valueStart = index;\n if (quote) {\n while (index < end - 1 && html[index] !== quote) {\n index++;\n }\n value = html.slice(valueStart, index);\n if (html[index] === quote) {\n index++;\n }\n } else {\n while (index < end - 1 && !/\\s/.test(html[index])) {\n index++;\n }\n value = html.slice(valueStart, index);\n }\n attributeEnd = index;\n }\n if (name) {\n attributes.push({ name, value, start: attributeStart, end: attributeEnd });\n }\n // Make progress even for malformed attributes.\n if (index === attributeStart) {\n index++;\n }\n }\n return attributes;\n}\n\nfunction* tags(html: string): Generator<Tag> {\n const lowerHtml = html.toLowerCase();\n let index = 0;\n while (index < html.length) {\n const start = html.indexOf(\"<\", index);\n if (start === -1) {\n return;\n }\n if (html.startsWith(\"<!--\", start)) {\n const end = html.indexOf(\"-->\", start + 4);\n index = end === -1 ? html.length : end + 3;\n continue;\n }\n if (html.startsWith(\"<![CDATA[\", start)) {\n const end = html.indexOf(\"]]>\", start + 9);\n index = end === -1 ? html.length : end + 3;\n continue;\n }\n const match = /^<(\\/)?([a-z][a-z0-9:-]*)(?=[\\s/>])/i.exec(html.slice(start));\n if (!match) {\n if (html[start + 1] === \"!\" || html[start + 1] === \"?\") {\n const end = tagEnd(html, start + 2);\n index = end === -1 ? html.length : end;\n } else {\n index = start + 1;\n }\n continue;\n }\n const end = tagEnd(html, start + match[0].length);\n if (end === -1) {\n return;\n }\n const name = match[2].toLowerCase();\n const closing = Boolean(match[1]);\n yield { name, closing, start, end, attributes: closing ? [] : readAttributes(html, start + match[0].length, end) };\n index = end;\n if (!closing && name === \"plaintext\") {\n return;\n }\n if (!closing && RAW_TEXT_TAGS.has(name)) {\n // HTML raw text ends at its closing tag, regardless of JavaScript or\n // CSS quoting. Markup-looking strings inside it are not elements.\n let close = lowerHtml.indexOf(`</${name}`, index);\n while (close !== -1 && !/[\\s/>]/.test(html[close + name.length + 2] ?? \"\")) {\n close = lowerHtml.indexOf(`</${name}`, close + 2);\n }\n index = close === -1 ? html.length : close;\n }\n }\n}\n\nfunction escapeAttribute(value: string): string {\n return value.replace(/&/g, \"&amp;\").replace(/\"/g, \"&quot;\").replace(/</g, \"&lt;\").replace(/>/g, \"&gt;\");\n}\n\nfunction patchOpeningTag(html: string, tag: Tag, attributes: Record<string, string | null>): string {\n let opening = html.slice(tag.start, tag.end);\n const updates = new Map(Object.entries(attributes).map(([name, value]) => [name.toLowerCase(), value]));\n const replacements: Array<{ start: number; end: number; value: string }> = [];\n const handled = new Set<string>();\n for (const attribute of tag.attributes) {\n if (!updates.has(attribute.name)) {\n continue;\n }\n const value = updates.get(attribute.name);\n replacements.push({\n start: attribute.start - tag.start,\n end: attribute.end - tag.start,\n value: value === null || handled.has(attribute.name) ? \"\" : `${attribute.name}=\"${escapeAttribute(value!)}\"`,\n });\n handled.add(attribute.name);\n }\n for (const replacement of replacements.reverse()) {\n opening = opening.slice(0, replacement.start) + replacement.value + opening.slice(replacement.end);\n }\n const additions = [...updates]\n .filter(([name, value]) => !handled.has(name) && value !== null)\n .map(([name, value]) => ` ${name}=\"${escapeAttribute(value!)}\"`)\n .join(\"\");\n if (additions) {\n const slash = /\\/\\s*>$/.exec(opening)?.index;\n const slashBelongsToValue = html[tag.end - 2] === \"/\" && tag.attributes.some((attribute) => attribute.end === tag.end - 1);\n const insertion = slash !== undefined && !slashBelongsToValue ? slash : opening.length - 1;\n opening = opening.slice(0, insertion) + additions + opening.slice(insertion);\n }\n return opening;\n}\n\n/**\n * Replace the contents of the live HTML root without consuming nested closing\n * tags or matching examples inside comments, scripts, styles, or templates.\n * Missing or unclosed roots leave the template unchanged.\n */\nexport function replaceHtmlRootContents(html: string, contents: string, attributes: Record<string, string | null> = {}): string {\n let root: Tag | undefined;\n let depth = 0;\n let templateDepth = 0;\n for (const tag of tags(html)) {\n if (!root) {\n if (tag.name === \"template\") {\n templateDepth += tag.closing ? -1 : 1;\n templateDepth = Math.max(0, templateDepth);\n }\n if (!tag.closing && !templateDepth && !VOID_TAGS.has(tag.name) && tag.attributes.find((attribute) => attribute.name === \"id\")?.value === \"root\") {\n root = tag;\n depth = 1;\n }\n continue;\n }\n if (tag.name !== root.name) {\n continue;\n }\n // A self-closing slash is ignored on non-void HTML elements such as div.\n depth += tag.closing ? -1 : 1;\n if (depth === 0) {\n return html.slice(0, root.start) + patchOpeningTag(html, root, attributes) + contents + html.slice(tag.start);\n }\n }\n return html;\n}\n"]}
@@ -1,59 +1,13 @@
1
1
  import type http from "http";
2
2
  /**
3
- * Extracts the client IP address from an HTTP request, checking multiple headers
4
- * and taking into account proxy configurations.
3
+ * Extract the client IP by trusting exactly `trustProxyDepth` hops, including
4
+ * the direct peer. For one trusted proxy, use the rightmost X-Forwarded-For
5
+ * entry; for two, use the next entry to its left. Untrusted prefixes are ignored.
5
6
  *
6
- * Checks headers in order of reliability:
7
- * 1. CF-Connecting-IP (Cloudflare)
8
- * 2. True-Client-IP (Cloudflare Enterprise, Akamai)
9
- * 3. X-Real-IP (Nginx, other proxies)
10
- * 4. X-Forwarded-For (Standard, but can be spoofed)
11
- * 5. req.socket.remoteAddress (Direct connection)
12
- *
13
- * When behind proxies, the X-Forwarded-For header contains a chain of IP addresses.
14
- * Format: "client, proxy1, proxy2, ..."
15
- *
16
- * @param req - The HTTP request object
17
- * @param trustProxyDepth - Number of proxy levels to trust
18
- * - 0: Only use req.socket.remoteAddress (no proxy trust)
19
- * - 1: Trust 1 proxy level (recommended for Vercel, Netlify, Railway)
20
- * - 2+: Trust multiple proxy levels (for complex setups)
21
- *
22
- * Examples:
23
- * - trustProxyDepth=0: Direct connection, no proxies
24
- * All proxy headers ignored
25
- * Result: req.socket.remoteAddress
26
- *
27
- * - trustProxyDepth=1: Behind one proxy (e.g., Vercel, Netlify)
28
- * X-Forwarded-For: "203.0.113.1, 198.51.100.1"
29
- * Result: "203.0.113.1" (client IP)
30
- *
31
- * - trustProxyDepth=2: Behind two proxies (e.g., Cloudflare -> Load Balancer)
32
- * X-Forwarded-For: "203.0.113.1, 198.51.100.1, 192.0.2.1"
33
- * Result: "203.0.113.1" (client IP)
34
- *
35
- * Common configurations:
36
- * - Vercel/Netlify/Railway: trustProxyDepth=1
37
- * - Cloudflare -> Origin: trustProxyDepth=1 (use CF-Connecting-IP)
38
- * - AWS ALB -> EC2: trustProxyDepth=1
39
- * - Nginx -> Node: trustProxyDepth=1 (use X-Real-IP)
40
- * - Cloudflare -> Nginx -> Node: trustProxyDepth=2
7
+ * With no forwarded chain, provider-specific headers are accepted only when
8
+ * proxy trust is enabled. The trusted proxy must overwrite those headers.
41
9
  */
42
10
  export declare function extractClientIP(req: http.IncomingMessage, trustProxyDepth?: number): string;
43
- /**
44
- * Alternative extraction method that works from the right (trusts the rightmost IPs).
45
- * This is useful when you want to trust the last N proxies in the chain.
46
- *
47
- * Note: This only applies to X-Forwarded-For parsing. Single-value headers like
48
- * CF-Connecting-IP are still checked first.
49
- *
50
- * @param req - The HTTP request object
51
- * @param trustProxyDepth - Number of proxy levels to trust from the right
52
- *
53
- * Example:
54
- * X-Forwarded-For: "203.0.113.1, 198.51.100.1, 192.0.2.1"
55
- * trustProxyDepth=1: Result is "198.51.100.1" (skip the last trusted proxy)
56
- * trustProxyDepth=2: Result is "203.0.113.1" (skip the last 2 trusted proxies)
57
- */
11
+ /** Uses the same depth-based extraction as extractClientIP. */
58
12
  export declare function extractClientIPFromRight(req: http.IncomingMessage, trustProxyDepth?: number): string;
59
13
  //# sourceMappingURL=ipExtractor.d.ts.map
@@ -1 +1 @@
1
- {"version":3,"file":"ipExtractor.d.ts","sourceRoot":"","sources":["../../src/utils/ipExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAE7B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAuCG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,GAAE,MAAU,GAAG,MAAM,CAgD9F;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,GAAE,MAAU,GAAG,MAAM,CAqCvG"}
1
+ {"version":3,"file":"ipExtractor.d.ts","sourceRoot":"","sources":["../../src/utils/ipExtractor.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAG7B;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,GAAE,MAAU,GAAG,MAAM,CAoB9F;AAED,+DAA+D;AAC/D,wBAAgB,wBAAwB,CAAC,GAAG,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,GAAE,MAAU,GAAG,MAAM,CAEvG"}
@@ -1,130 +1,33 @@
1
+ import { isIP } from "net";
1
2
  /**
2
- * Extracts the client IP address from an HTTP request, checking multiple headers
3
- * and taking into account proxy configurations.
3
+ * Extract the client IP by trusting exactly `trustProxyDepth` hops, including
4
+ * the direct peer. For one trusted proxy, use the rightmost X-Forwarded-For
5
+ * entry; for two, use the next entry to its left. Untrusted prefixes are ignored.
4
6
  *
5
- * Checks headers in order of reliability:
6
- * 1. CF-Connecting-IP (Cloudflare)
7
- * 2. True-Client-IP (Cloudflare Enterprise, Akamai)
8
- * 3. X-Real-IP (Nginx, other proxies)
9
- * 4. X-Forwarded-For (Standard, but can be spoofed)
10
- * 5. req.socket.remoteAddress (Direct connection)
11
- *
12
- * When behind proxies, the X-Forwarded-For header contains a chain of IP addresses.
13
- * Format: "client, proxy1, proxy2, ..."
14
- *
15
- * @param req - The HTTP request object
16
- * @param trustProxyDepth - Number of proxy levels to trust
17
- * - 0: Only use req.socket.remoteAddress (no proxy trust)
18
- * - 1: Trust 1 proxy level (recommended for Vercel, Netlify, Railway)
19
- * - 2+: Trust multiple proxy levels (for complex setups)
20
- *
21
- * Examples:
22
- * - trustProxyDepth=0: Direct connection, no proxies
23
- * All proxy headers ignored
24
- * Result: req.socket.remoteAddress
25
- *
26
- * - trustProxyDepth=1: Behind one proxy (e.g., Vercel, Netlify)
27
- * X-Forwarded-For: "203.0.113.1, 198.51.100.1"
28
- * Result: "203.0.113.1" (client IP)
29
- *
30
- * - trustProxyDepth=2: Behind two proxies (e.g., Cloudflare -> Load Balancer)
31
- * X-Forwarded-For: "203.0.113.1, 198.51.100.1, 192.0.2.1"
32
- * Result: "203.0.113.1" (client IP)
33
- *
34
- * Common configurations:
35
- * - Vercel/Netlify/Railway: trustProxyDepth=1
36
- * - Cloudflare -> Origin: trustProxyDepth=1 (use CF-Connecting-IP)
37
- * - AWS ALB -> EC2: trustProxyDepth=1
38
- * - Nginx -> Node: trustProxyDepth=1 (use X-Real-IP)
39
- * - Cloudflare -> Nginx -> Node: trustProxyDepth=2
7
+ * With no forwarded chain, provider-specific headers are accepted only when
8
+ * proxy trust is enabled. The trusted proxy must overwrite those headers.
40
9
  */
41
10
  export function extractClientIP(req, trustProxyDepth = 0) {
42
- // If not trusting any proxies, return the direct connection IP
43
- if (trustProxyDepth === 0) {
44
- return req.socket.remoteAddress || "unknown";
11
+ const directIP = req.socket?.remoteAddress || "unknown";
12
+ if (!Number.isInteger(trustProxyDepth) || trustProxyDepth <= 0) {
13
+ return directIP;
45
14
  }
46
- // Security: When trustProxyDepth >= 1, extract IP using X-Forwarded-For first.
47
- // Single-value headers (CF-Connecting-IP, True-Client-IP, X-Real-IP) are only
48
- // checked as a fallback since they can be spoofed by direct clients when no
49
- // trusted proxy IP allowlist is configured.
50
- // 1. Check X-Forwarded-For (Standard, most reliable with depth-based extraction)
51
15
  const forwardedFor = req.headers["x-forwarded-for"];
52
- if (forwardedFor) {
53
- const forwardedIPs = (Array.isArray(forwardedFor) ? forwardedFor.join(",") : forwardedFor)
54
- .split(",")
55
- .map((ip) => ip.trim())
56
- .filter((ip) => ip.length > 0);
57
- if (forwardedIPs.length > 0) {
58
- // Verify we have enough IPs in the chain for the trust depth
59
- if (forwardedIPs.length >= trustProxyDepth) {
60
- // Return the client IP (first in the chain)
61
- return forwardedIPs[0];
62
- }
16
+ if (forwardedFor !== undefined) {
17
+ const forwardedIPs = (Array.isArray(forwardedFor) ? forwardedFor.join(",") : forwardedFor).split(",").map((ip) => ip.trim());
18
+ const clientIP = forwardedIPs[forwardedIPs.length - trustProxyDepth];
19
+ return clientIP && isIP(clientIP) ? clientIP : directIP;
20
+ }
21
+ for (const name of ["cf-connecting-ip", "true-client-ip", "x-real-ip"]) {
22
+ const value = req.headers[name];
23
+ if (typeof value === "string" && isIP(value.trim())) {
24
+ return value.trim();
63
25
  }
64
26
  }
65
- // 2. Fallback: Check CF-Connecting-IP (Cloudflare)
66
- const cfConnectingIP = req.headers["cf-connecting-ip"];
67
- if (cfConnectingIP && typeof cfConnectingIP === "string" && cfConnectingIP.trim().length > 0) {
68
- return cfConnectingIP.trim();
69
- }
70
- // 3. Fallback: Check True-Client-IP (Cloudflare Enterprise, Akamai)
71
- const trueClientIP = req.headers["true-client-ip"];
72
- if (trueClientIP && typeof trueClientIP === "string" && trueClientIP.trim().length > 0) {
73
- return trueClientIP.trim();
74
- }
75
- // 4. Fallback: Check X-Real-IP (Nginx, other proxies)
76
- const xRealIP = req.headers["x-real-ip"];
77
- if (xRealIP && typeof xRealIP === "string" && xRealIP.trim().length > 0) {
78
- return xRealIP.trim();
79
- }
80
- // 5. Fall back to direct connection
81
- return req.socket.remoteAddress || "unknown";
27
+ return directIP;
82
28
  }
83
- /**
84
- * Alternative extraction method that works from the right (trusts the rightmost IPs).
85
- * This is useful when you want to trust the last N proxies in the chain.
86
- *
87
- * Note: This only applies to X-Forwarded-For parsing. Single-value headers like
88
- * CF-Connecting-IP are still checked first.
89
- *
90
- * @param req - The HTTP request object
91
- * @param trustProxyDepth - Number of proxy levels to trust from the right
92
- *
93
- * Example:
94
- * X-Forwarded-For: "203.0.113.1, 198.51.100.1, 192.0.2.1"
95
- * trustProxyDepth=1: Result is "198.51.100.1" (skip the last trusted proxy)
96
- * trustProxyDepth=2: Result is "203.0.113.1" (skip the last 2 trusted proxies)
97
- */
29
+ /** Uses the same depth-based extraction as extractClientIP. */
98
30
  export function extractClientIPFromRight(req, trustProxyDepth = 0) {
99
- if (trustProxyDepth === 0) {
100
- return req.socket.remoteAddress || "unknown";
101
- }
102
- // Check single-value headers first (same as extractClientIP)
103
- const cfConnectingIP = req.headers["cf-connecting-ip"];
104
- if (cfConnectingIP && typeof cfConnectingIP === "string" && cfConnectingIP.trim().length > 0) {
105
- return cfConnectingIP.trim();
106
- }
107
- const trueClientIP = req.headers["true-client-ip"];
108
- if (trueClientIP && typeof trueClientIP === "string" && trueClientIP.trim().length > 0) {
109
- return trueClientIP.trim();
110
- }
111
- const xRealIP = req.headers["x-real-ip"];
112
- if (xRealIP && typeof xRealIP === "string" && xRealIP.trim().length > 0) {
113
- return xRealIP.trim();
114
- }
115
- // For X-Forwarded-For, use right-based extraction
116
- const forwardedFor = req.headers["x-forwarded-for"];
117
- if (forwardedFor) {
118
- const forwardedIPs = (Array.isArray(forwardedFor) ? forwardedFor.join(",") : forwardedFor)
119
- .split(",")
120
- .map((ip) => ip.trim())
121
- .filter((ip) => ip.length > 0);
122
- if (forwardedIPs.length > 0) {
123
- // Calculate which IP to trust by skipping the rightmost N trusted proxies
124
- const clientIPIndex = Math.max(0, forwardedIPs.length - trustProxyDepth - 1);
125
- return forwardedIPs[clientIPIndex];
126
- }
127
- }
128
- return req.socket.remoteAddress || "unknown";
31
+ return extractClientIP(req, trustProxyDepth);
129
32
  }
130
33
  //# sourceMappingURL=ipExtractor.js.map