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
package/dist/server/ssr.js.map
CHANGED
|
@@ -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"]}
|
package/dist/utils/envLoader.js
CHANGED
|
@@ -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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
|
|
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, "&").replace(/"/g, """).replace(/</g, "<").replace(/>/g, ">");
|
|
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, \"&\").replace(/\"/g, \""\").replace(/</g, \"<\").replace(/>/g, \">\");\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
|
-
*
|
|
4
|
-
*
|
|
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
|
-
*
|
|
7
|
-
*
|
|
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;
|
|
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
|
-
*
|
|
3
|
-
*
|
|
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
|
-
*
|
|
6
|
-
*
|
|
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
|
-
|
|
43
|
-
if (trustProxyDepth
|
|
44
|
-
return
|
|
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
|
-
|
|
55
|
-
|
|
56
|
-
|
|
57
|
-
|
|
58
|
-
|
|
59
|
-
|
|
60
|
-
|
|
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
|
-
|
|
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
|
-
|
|
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
|