heliumts 0.8.4 → 0.8.6

package/README.md

@@ -285,6 +285,15 @@ import type { HeliumConfig } from "heliumts/server";
 
 const config: HeliumConfig = {
     trustProxyDepth: 1,  // Trust 1 proxy level (e.g., Vercel)
+    security: {
+        defaultHeaders: true,
+        headerOverrides: {
+            "X-Frame-Options": "SAMEORIGIN",
+        },
+        contentSecurityPolicy: "default-src 'self'; frame-ancestors 'self'",
+        hsts: true,
+        corsOrigins: ["https://app.example.com"],
+    },
     rpc: {
         encoding: "msgpack",  // or "json"
         compression: {

package/dist/client/Router.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../src/client/Router.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAuD,MAAM,OAAO,CAAC;AA2D5E,KAAK,WAAW,GAAG,YAAY,GAAG,mBAAmB,CAAC;AACtD,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,KAAK,IAAI,CAAC;AAiKhG,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACpC,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAGD,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAChE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACnE,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,KAAK,MAAM,IAAI,CAAC;IAChE,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,8GAA8G;IAC9G,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,aAAa,qCAAkD,CAAC;AAE7E;;;;;;;;GAQG;AACH,wBAAgB,SAAS,kBAmCxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAe,EAAE,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,QAyBlF;AA6CD,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAC3C,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CACJ,CAAC;AA+BF;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,2CA4DpC;AAGD;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC9F,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B,CAAC;AAGF,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;CAAE,2CA0KlF"}
+{"version":3,"file":"Router.d.ts","sourceRoot":"","sources":["../../src/client/Router.tsx"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAC3C,OAAO,KAAuD,MAAM,OAAO,CAAC;AA6F5E,KAAK,WAAW,GAAG,YAAY,GAAG,mBAAmB,CAAC;AACtD,KAAK,aAAa,GAAG,CAAC,KAAK,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,EAAE,EAAE,MAAM,CAAC;IAAC,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;CAAE,KAAK,IAAI,CAAC;AAiKhG,kDAAkD;AAClD,MAAM,WAAW,uBAAuB;IACpC,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB;AAGD,KAAK,aAAa,GAAG;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;IAC1C,YAAY,EAAE,eAAe,CAAC;IAC9B,IAAI,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,KAAK,IAAI,CAAC;IAChE,OAAO,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,uBAAuB,KAAK,IAAI,CAAC;IACnE,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,QAAQ,EAAE,aAAa,KAAK,MAAM,IAAI,CAAC;IAChE,MAAM,EAAE,GAAG,GAAG,GAAG,CAAC;IAClB,YAAY,EAAE,OAAO,CAAC;IACtB,8GAA8G;IAC9G,SAAS,EAAE,OAAO,CAAC;CACtB,CAAC;AAEF,eAAO,MAAM,aAAa,qCAAkD,CAAC;AAE7E;;;;;;;;GAQG;AACH,wBAAgB,SAAS,kBAmCxB;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAe,EAAE,EAAE;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,OAAO,CAAC,EAAE,OAAO,CAAA;CAAE,QAyBlF;AA6CD,MAAM,MAAM,SAAS,GAAG,KAAK,CAAC,iBAAiB,CAC3C,IAAI,CAAC,KAAK,CAAC,oBAAoB,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC,GAAG;IAC1D,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,qDAAqD;IACrD,WAAW,CAAC,EAAE,OAAO,CAAC;CACzB,CACJ,CAAC;AA+BF;;;;;;;;;GASG;AACH,wBAAgB,IAAI,CAAC,KAAK,EAAE,SAAS,2CA4DpC;AAGD;;;;GAIG;AACH,MAAM,MAAM,aAAa,CAAC,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI;IAC9F,SAAS,EAAE,aAAa,CAAC,UAAU,CAAC,CAAC;IACrC,SAAS,EAAE,UAAU,CAAC;IACtB,QAAQ,CAAC,EAAE,KAAK,CAAC,SAAS,CAAC;CAC9B,CAAC;AAGF,wBAAgB,SAAS,CAAC,EAAE,QAAQ,EAAE,EAAE;IAAE,QAAQ,CAAC,EAAE,aAAa,CAAC,aAAa,CAAC,CAAA;CAAE,2CA8LlF"}

package/dist/client/Router.js

@@ -24,16 +24,28 @@ async function fetchSSRPageProps(path) {
             },
         });
         if (!response.ok) {
-            return null;
+            return { kind: "none" };
         }
         const payload = (await response.json());
-        if (!payload.ssr || !payload.props) {
-            return null;
+        if (!payload.ssr) {
+            return { kind: "none" };
         }
-        return payload.props;
+        if (payload.redirect && typeof payload.redirect.destination === "string" && payload.redirect.destination.length > 0) {
+            return {
+                kind: "redirect",
+                redirect: payload.redirect,
+            };
+        }
+        if (!payload.props) {
+            return { kind: "none" };
+        }
+        return {
+            kind: "props",
+            props: payload.props,
+        };
     }
     catch {
-        return null;
+        return { kind: "none" };
     }
 }
 class RouterEventEmitter {
@@ -431,11 +443,27 @@ export function AppRouter({ AppShell }) {
         }
         let cancelled = false;
         const load = async () => {
-            const props = await fetchSSRPageProps(targetPath);
+            const ssrPayload = await fetchSSRPageProps(targetPath);
             if (cancelled) {
                 return;
             }
-            setRuntimeSSRProps(props ?? {});
+            if (ssrPayload.kind === "redirect") {
+                const destination = ssrPayload.redirect.destination;
+                if (isExternalUrl(destination)) {
+                    window.location.assign(destination);
+                    return;
+                }
+                navigate(destination, {
+                    replace: ssrPayload.redirect.replace ?? true,
+                    scrollToTop: true,
+                });
+                return;
+            }
+            if (ssrPayload.kind === "props") {
+                setRuntimeSSRProps(ssrPayload.props);
+                return;
+            }
+            setRuntimeSSRProps({});
         };
         void load();
         return () => {

package/dist/client/Router.js.map

@@ -1 +1 @@
-{"version":3,"file":"Router.js","sourceRoot":"","sources":["../../src/client/Router.tsx"],"names":[],"mappings":";AACA,OAAO,KAAK,EAAE,EAAE,OAAO,EAAE,oBAAoB,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE5E,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAAE,yBAAyB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,gBAAgB,CAAC;AAOlG,SAAS,sBAAsB;IAC3B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,MAAM,YAAY,GAAG,MAEpB,CAAC;IAEF,MAAM,OAAO,GAAG,YAAY,CAAC,mBAAmB,CAAC;IACjD,IAAI,CAAC,OAAO,IAAI,OAAO,OAAO,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ,IAAI,OAAO,OAAO,CAAC,KAAK,KAAK,QAAQ,IAAI,OAAO,CAAC,KAAK,KAAK,IAAI,EAAE,CAAC;QAC7I,OAAO,IAAI,CAAC;IAChB,CAAC;IAED,OAAO,OAAO,CAAC;AACnB,CAAC;AAED,KAAK,UAAU,iBAAiB,CAAC,IAAY;IACzC,IAAI,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,KAAK,CAAC,+BAA+B,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE;YACpF,MAAM,EAAE,KAAK;YACb,OAAO,EAAE;gBACL,MAAM,EAAE,kBAAkB;aAC7B;SACJ,CAAC,CAAC;QAEH,IAAI,CAAC,QAAQ,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,MAAM,OAAO,GAAG,CAAC,MAAM,QAAQ,CAAC,IAAI,EAAE,CAGrC,CAAC;QAEF,IAAI,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,CAAC;YACjC,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,OAAO,OAAO,CAAC,KAAK,CAAC;IACzB,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,IAAI,CAAC;IAChB,CAAC;AACL,CAAC;AAMD,MAAM,kBAAkB;IAAxB;QACY,cAAS,GAAyC,IAAI,GAAG,EAAE,CAAC;IAsCxE,CAAC;IApCG,EAAE,CAAC,KAAkB,EAAE,QAAuB;QAC1C,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,EAAE,IAAI,GAAG,EAAE,CAAC,CAAC;QACzC,CAAC;QACD,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAE,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;QAEzC,8BAA8B;QAC9B,OAAO,GAAG,EAAE;YACR,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC;QAChD,CAAC,CAAC;IACN,CAAC;IAED,IAAI,CAAC,KAAkB,EAAE,IAAkC;QACvD,MAAM,cAAc,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC;QACjD,IAAI,CAAC,cAAc,IAAI,cAAc,CAAC,IAAI,KAAK,CAAC,EAAE,CAAC;YAC/C,OAAO,IAAI,CAAC;QAChB,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QACtB,MAAM,cAAc,GAAG,GAAG,EAAE;YACxB,SAAS,GAAG,IAAI,CAAC;QACrB,CAAC,CAAC;QAEF,MAAM,SAAS,GAAG,KAAK,KAAK,mBAAmB,CAAC,CAAC,CAAC,EAAE,GAAG,IAAI,EAAE,cAAc,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;QAErF,cAAc,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;YAChC,QAAQ,CAAC,SAAS,CAAC,CAAC;QACxB,CAAC,CAAC,CAAC;QAEH,OAAO,CAAC,SAAS,CAAC;IACtB,CAAC;IAED,uCAAuC;IACvC,KAAK;QACD,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IAC3B,CAAC;CACJ;AAED,uEAAuE;AACvE,IAAI,kBAAsC,CAAC;AAE3C,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,gBAAgB,EAAE,EAAE,CAAC;IACtD,0DAA0D;IAC1D,MAAM,YAAY,GAAG,MAAwE,CAAC;IAC9F,IAAI,CAAC,YAAY,CAAC,qBAAqB,EAAE,CAAC;QACtC,YAAY,CAAC,qBAAqB,GAAG,IAAI,kBAAkB,EAAE,CAAC;IAClE,CAAC;IACD,kBAAkB,GAAG,YAAY,CAAC,qBAAqB,CAAC;AAC5D,CAAC;KAAM,CAAC;IACJ,kBAAkB,GAAG,IAAI,kBAAkB,EAAE,CAAC;AAClD,CAAC;AAQD,SAAS,WAAW;IAChB,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC;IAC7C,OAAO;QACH,IAAI,EAAE,QAAQ;QACd,YAAY,EAAE,IAAI,eAAe,CAAC,MAAM,CAAC;QACzC,YAAY,EAAE,KAAK;KACtB,CAAC;AACN,CAAC;AAED,SAAS,UAAU,CAAC,IAAY,EAAE,MAAoB;IAClD,KAAK,MAAM,CAAC,IAAI,MAAM,EAAE,CAAC;QACrB,MAAM,CAAC,GAAG,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;QAC1B,IAAI,CAAC,EAAE,CAAC;YACJ,OAAO,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;QAC1C,CAAC;IACL,CAAC;IACD,OAAO,IAAI,CAAC;AAChB,CAAC;AAED,0CAA0C;AAC1C,yDAAyD;AACzD,IAAI,eAA4B,CAAC;AACjC,IAAI,iBAAkC,CAAC;AAEvC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,gBAAgB,EAAE,EAAE,CAAC;IACtD,MAAM,YAAY,GAAG,MAGpB,CAAC;IACF,IAAI,CAAC,YAAY,CAAC,uBAAuB,EAAE,CAAC;QACxC,YAAY,CAAC,uBAAuB,GAAG,WAAW,EAAE,CAAC;IACzD,CAAC;IACD,IAAI,CAAC,YAAY,CAAC,yBAAyB,EAAE,CAAC;QAC1C,YAAY,CAAC,yBAAyB,GAAG,IAAI,GAAG,EAAE,CAAC;IACvD,CAAC;IACD,eAAe,GAAG,YAAY,CAAC,uBAAuB,CAAC;IACvD,iBAAiB,GAAG,YAAY,CAAC,yBAAyB,CAAC;AAC/D,CAAC;KAAM,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IACvC,eAAe,GAAG,WAAW,EAAE,CAAC;IAChC,iBAAiB,GAAG,IAAI,GAAG,EAAE,CAAC;AAClC,CAAC;KAAM,CAAC;IACJ,eAAe,GAAG,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,eAAe,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;IAC1F,iBAAiB,GAAG,IAAI,GAAG,EAAE,CAAC;AAClC,CAAC;AAED,uEAAuE;AACvE,SAAS,qBAAqB,CAAC,IAAY;IACvC,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACtD,MAAM,YAAY,GAAG,MAAiE,CAAC;QACvF,MAAM,MAAM,GAAG,YAAY,CAAC,oBAAoB,CAAC;QACjD,IAAI,MAAM,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAC9B,MAAM,KAAK,GAAG,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;YACvC,IAAI,KAAK,EAAE,CAAC;gBACR,OAAO,KAAK,CAAC,MAAM,CAAC;YACxB,CAAC;QACL,CAAC;IACL,CAAC;IACD,OAAO,EAAE,CAAC;AACd,CAAC;AAED,SAAS,mBAAmB,CAAC,QAAoB;IAC7C,iBAAiB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;IAChC,OAAO,GAAG,EAAE,CAAC,iBAAiB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;AACpD,CAAC;AAED,SAAS,mBAAmB;IACxB,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED,MAAM,eAAe,GAAgB,EAAE,IAAI,EAAE,GAAG,EAAE,YAAY,EAAE,IAAI,eAAe,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC;AAC7G,SAAS,iBAAiB;IACtB,OAAO,eAAe,CAAC;AAC3B,CAAC;AAED,SAAS,cAAc,CAAC,YAAY,GAAG,KAAK;IACxC,MAAM,WAAW,GAAG,EAAE,GAAG,WAAW,EAAE,EAAE,YAAY,EAAE,CAAC;IACvD,eAAe,GAAG,WAAW,CAAC;IAC9B,0CAA0C;IAC1C,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,gBAAgB,EAAE,EAAE,CAAC;QACrD,MAAoE,CAAC,uBAAuB,GAAG,WAAW,CAAC;IAChH,CAAC;IACD,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;AACxD,CAAC;AAED,+BAA+B;AAC/B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;IAChC,iCAAiC;IACjC,MAAM,YAAY,GAAG,MAAqE,CAAC;IAC3F,IAAI,CAAC,YAAY,CAAC,6BAA6B,EAAE,CAAC;QAC9C,YAAY,CAAC,6BAA6B,GAAG,IAAI,CAAC;QAElD,MAAM,CAAC,gBAAgB,CAAC,UAAU,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;QAEjE,oDAAoD;QACpD,kBAAkB,CAAC,EAAE,CAAC,YAAY,EAAE,GAAG,EAAE,CAAC,cAAc,CAAC,KAAK,CAAC,CAAC,CAAC;IACrE,CAAC;AACL,CAAC;AAsBD,MAAM,CAAC,MAAM,aAAa,GAAG,KAAK,CAAC,aAAa,CAAuB,IAAI,CAAC,CAAC;AAE7E;;;;;;;;GAQG;AACH,MAAM,UAAU,SAAS;IACrB,MAAM,GAAG,GAAG,KAAK,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC;IAC5C,IAAI,CAAC,GAAG,EAAE,CAAC;QACP,sEAAsE;QACtE,gEAAgE;QAChE,0DAA0D;QAC1D,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,gBAAgB,EAAE,EAAE,CAAC;YACtD,MAAM,WAAW,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;YAC7C,OAAO;gBACH,IAAI,EAAE,WAAW;gBACjB,MAAM,EAAE,qBAAqB,CAAC,WAAW,CAAC;gBAC1C,YAAY,EAAE,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;gBACzD,IAAI,EAAE,CAAC,IAAY,EAAE,OAAiC,EAAE,EAAE;oBACtD,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;oBACvC,IAAI,OAAO,EAAE,WAAW,KAAK,KAAK,EAAE,CAAC;wBACjC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC7D,CAAC;oBACD,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;gBACxD,CAAC;gBACD,OAAO,EAAE,CAAC,IAAY,EAAE,OAAiC,EAAE,EAAE;oBACzD,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;oBAC1C,IAAI,OAAO,EAAE,WAAW,KAAK,KAAK,EAAE,CAAC;wBACjC,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;oBAC7D,CAAC;oBACD,MAAM,CAAC,aAAa,CAAC,IAAI,aAAa,CAAC,UAAU,CAAC,CAAC,CAAC;gBACxD,CAAC;gBACD,EAAE,EAAE,GAAG,EAAE,CAAC,GAAG,EAAE,GAAE,CAAC;gBAClB,MAAM,EAAE,GAAY;gBACpB,YAAY,EAAE,KAAK;gBACnB,SAAS,EAAE,KAAK;aACnB,CAAC;QACN,CAAC;QACD,MAAM,IAAI,KAAK,CAAC,2CAA2C,CAAC,CAAC;IACjE,CAAC;IACD,OAAO,GAAG,CAAC;AACf,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,QAAQ,CAAC,EAAE,EAAE,EAAE,OAAO,GAAG,KAAK,EAAqC;IAC/E,MAAM,aAAa,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE1C,+CAA+C;IAC/C,KAAK,CAAC,eAAe,CAAC,GAAG,EAAE;QACvB,MAAM,UAAU,GAAG,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACpC,IAAI,CAAC,aAAa,CAAC,OAAO,IAAI,MAAM,CAAC,QAAQ,CAAC,QAAQ,KAAK,UAAU,EAAE,CAAC;YACpE,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;YAE7B,qBAAqB;YACrB,IAAI,OAAO,EAAE,CAAC;gBACV,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC9C,CAAC;iBAAM,CAAC;gBACJ,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,EAAE,CAAC,CAAC;YAC3C,CAAC;YAED,+CAA+C;YAC/C,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE;gBAClC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,QAAQ;gBAC9B,EAAE,EAAE,UAAU;aACjB,CAAC,CAAC;QACP,CAAC;IACL,CAAC,EAAE,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC,CAAC;IAElB,OAAO,IAAI,CAAC;AAChB,CAAC;AAQD,oBAAoB;AACpB,SAAS,QAAQ,CAAC,IAAY,EAAE,UAA2B,EAAE;IACzD,MAAM,EAAE,OAAO,GAAG,KAAK,EAAE,WAAW,GAAG,IAAI,EAAE,GAAG,OAAO,CAAC;IACxD,MAAM,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,QAAQ,CAAC;IACtC,MAAM,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,6BAA6B;IAE5D,kDAAkD;IAClD,MAAM,WAAW,GAAG,kBAAkB,CAAC,IAAI,CAAC,mBAAmB,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;IAC/E,IAAI,CAAC,WAAW,EAAE,CAAC;QACf,OAAO,CAAC,2BAA2B;IACvC,CAAC;IAED,iDAAiD;IACjD,eAAe,GAAG,EAAE,GAAG,eAAe,EAAE,YAAY,EAAE,IAAI,EAAE,CAAC;IAC7D,iBAAiB,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,EAAE,CAAC,CAAC;IAEpD,IAAI,OAAO,EAAE,CAAC;QACV,MAAM,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAChD,CAAC;SAAM,CAAC;QACJ,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,EAAE,EAAE,EAAE,IAAI,CAAC,CAAC;IAC7C,CAAC;IAED,sEAAsE;IACtE,qEAAqE;IACrE,sEAAsE;IACtE,IAAI,WAAW,EAAE,CAAC;QACd,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC;IAED,wEAAwE;IACxE,yCAAyC;IACzC,cAAc,CAAC,KAAK,CAAC,CAAC;IAEtB,kDAAkD;IAClD,kBAAkB,CAAC,IAAI,CAAC,YAAY,EAAE,EAAE,IAAI,EAAE,EAAE,EAAE,CAAC,CAAC;AACxD,CAAC;AAaD;;GAEG;AACH,SAAS,aAAa,CAAC,IAAY;IAC/B,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;QAChC,OAAO,KAAK,CAAC;IACjB,CAAC;IACD,IAAI,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QAClD,OAAO,GAAG,CAAC,MAAM,KAAK,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC;IACjD,CAAC;IAAC,MAAM,CAAC;QACL,OAAO,KAAK,CAAC;IACjB,CAAC;AACL,CAAC;AAED,2DAA2D;AAC3D,kCAAkC;AAClC,IAAI,YAA0B,CAAC;AAE/B,IAAI,OAAO,MAAM,KAAK,WAAW,IAAI,gBAAgB,EAAE,EAAE,CAAC;IACtD,MAAM,YAAY,GAAG,MAAiE,CAAC;IACvF,IAAI,CAAC,YAAY,CAAC,oBAAoB,EAAE,CAAC;QACrC,YAAY,CAAC,oBAAoB,GAAG,EAAE,CAAC;IAC3C,CAAC;IACD,YAAY,GAAG,YAAY,CAAC,oBAAoB,CAAC;AACrD,CAAC;KAAM,CAAC;IACJ,YAAY,GAAG,EAAE,CAAC;AACtB,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,IAAI,CAAC,KAAgB;IACjC,MAAM,EACF,QAAQ,EACR,IAAI,EACJ,SAAS,EACT,QAAQ,EAAE,YAAY,GAAG,IAAI,EAC7B,WAAW,GAAG,IAAI,EAClB,OAAO,EAAE,WAAW,EACpB,MAAM,EACN,QAAQ,EACR,OAAO,EAAE,WAAW,EACpB,YAAY,EAAE,gBAAgB,EAC9B,OAAO,EAAE,WAAW,EACpB,GAAG,SAAS,EACf,GAAG,KAAK,CAAC;IAEV,MAAM,OAAO,GAAG,CAAC,CAAsC,EAAE,EAAE;QACvD,mEAAmE;QACnE,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;QAEjB,IACI,CAAC,CAAC,gBAAgB;YAClB,CAAC,CAAC,MAAM,KAAK,CAAC,IAAI,kBAAkB;YACpC,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,OAAO;YACT,CAAC,CAAC,QAAQ;YACV,CAAC,CAAC,MAAM;YACR,MAAM,IAAI,0CAA0C;YACpD,QAAQ,IAAI,IAAI,IAAI,+BAA+B;YACnD,aAAa,CAAC,IAAI,CAAC,CAAC,oCAAoC;UAC1D,CAAC;YACC,OAAO;QACX,CAAC;QACD,CAAC,CAAC,cAAc,EAAE,CAAC;QACnB,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,CAAC,CAAC;IAC1D,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,KAAK,EAAE,CAAsC,EAAE,EAAE;QAClE,qFAAqF;QACrF,IAAI,YAAY,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YACxD,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtC,CAAC;QACD,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC;IAC1B,CAAC,CAAC;IAEF,MAAM,OAAO,GAAG,KAAK,EAAE,CAAsC,EAAE,EAAE;QAC7D,+CAA+C;QAC/C,IAAI,YAAY,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,YAAY,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YAClE,MAAM,EAAE,aAAa,EAAE,GAAG,MAAM,MAAM,CAAC,eAAe,CAAC,CAAC;YACxD,aAAa,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;QACtC,CAAC;QACD,WAAW,EAAE,CAAC,CAAC,CAAC,CAAC;IACrB,CAAC,CAAC;IAEF,OAAO,CACH,eAAO,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,EAAE,SAAS,EAAE,SAAS,YACjJ,QAAQ,GACT,CACP,CAAC;AACN,CAAC;AAcD,wBAAwB;AACxB,MAAM,UAAU,SAAS,CAAC,EAAE,QAAQ,EAA+C;IAC/E,gGAAgG;IAChG,MAAM,CAAC,SAAS,EAAE,eAAe,CAAC,GAAG,aAAa,EAAE,CAAC;IAErD,gDAAgD;IAChD,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,GAAG,OAAO,CAAC,GAAG,EAAE;QACtC,IAAI,OAAO,MAAM,KAAK,WAAW,EAAE,CAAC;YAChC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,CAAC;QAC/C,CAAC;QACD,MAAM,MAAM,GAAG,WAAW,EAAE,CAAC;QAC7B,6CAA6C;QAC7C,+DAA+D;QAC/D,IAAI,gBAAgB,EAAE,EAAE,CAAC;YACrB,MAAM,YAAY,GAAG,MAAiE,CAAC;YACvF,YAAY,CAAC,oBAAoB,GAAG,MAAM,CAAC,MAAM,CAAC;YAClD,4CAA4C;YAC5C,YAAY,CAAC,MAAM,GAAG,CAAC,CAAC;YACxB,YAAY,CAAC,IAAI,CAAC,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC;QACxC,CAAC;aAAM,CAAC;YACJ,YAAY,GAAG,MAAM,CAAC,MAAM,CAAC;QACjC,CAAC;QACD,OAAO,MAAM,CAAC;IAClB,CAAC,EAAE,EAAE,CAAC,CAAC;IAEP,4DAA4D;IAC5D,yDAAyD;IACzD,MAAM,KAAK,GAAG,oBAAoB,CAAC,mBAAmB,EAAE,mBAAmB,EAAE,iBAAiB,CAAC,CAAC;IAChG,MAAM,CAAC,eAAe,EAAE,kBAAkB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAA0B,GAAG,EAAE;QACvF,MAAM,OAAO,GAAG,sBAAsB,EAAE,CAAC;QACzC,IAAI,CAAC,OAAO,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACd,CAAC;QAED,IAAI,OAAO,CAAC,IAAI,KAAK,MAAM,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC5C,OAAO,OAAO,CAAC,KAAK,CAAC;QACzB,CAAC;QAED,OAAO,EAAE,CAAC;IACd,CAAC,CAAC,CAAC;IACH,MAAM,CAAC,aAAa,EAAE,gBAAgB,CAAC,GAAG,KAAK,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;IAEhE,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;IAElF,6FAA6F;IAC7F,MAAM,aAAa,GAAG,KAAK,EAAE,MAAM,IAAI,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,qBAAqB,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;IAErG,gFAAgF;IAChF,MAAM,mBAAmB,GAAG,gBAAgB,EAAE,CAAC,CAAC,CAAC,IAAI,eAAe,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,YAAY,CAAC;IAElH,MAAM,WAAW,GAAkB;QAC/B,IAAI,EAAE,KAAK,CAAC,IAAI;QAChB,MAAM,EAAE,aAAa;QACrB,YAAY,EAAE,mBAAmB;QACjC,IAAI,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACpB,0DAA0D;YAC1D,eAAe,CAAC,GAAG,EAAE;gBACjB,QAAQ,CAAC,IAAI,EAAE,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YAC1D,CAAC,CAAC,CAAC;QACP,CAAC;QACD,OAAO,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,EAAE;YACvB,eAAe,CAAC,GAAG,EAAE;gBACjB,QAAQ,CAAC,IAAI,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,OAAO,EAAE,WAAW,EAAE,CAAC,CAAC;YACzE,CAAC,CAAC,CAAC;QACP,CAAC;QACD,EAAE,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,CAAC,kBAAkB,CAAC,EAAE,CAAC,KAAK,EAAE,QAAQ,CAAC;QAC/D,MAAM,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QACzB,YAAY,EAAE,KAAK,CAAC,YAAY;QAChC,SAAS;KACZ,CAAC;IAEF,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,MAAM,UAAU,GAAG,GAAG,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAElE,gFAAgF;QAChF,IAAI,CAAC,aAAa,EAAE,CAAC;YACjB,MAAM,SAAS,GAAG,sBAAsB,EAAE,CAAC;YAC3C,IAAI,SAAS,IAAI,SAAS,CAAC,IAAI,KAAK,KAAK,CAAC,IAAI,EAAE,CAAC;gBAC7C,gBAAgB,CAAC,IAAI,CAAC,CAAC;gBACvB,OAAO;YACX,CAAC;YACD,gBAAgB,CAAC,IAAI,CAAC,CAAC;QAC3B,CAAC;QAED,IAAI,SAAS,GAAG,KAAK,CAAC;QAEtB,MAAM,IAAI,GAAG,KAAK,IAAI,EAAE;YACpB,MAAM,KAAK,GAAG,MAAM,iBAAiB,CAAC,UAAU,CAAC,CAAC;YAClD,IAAI,SAAS,EAAE,CAAC;gBACZ,OAAO;YACX,CAAC;YAED,kBAAkB,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;QACpC,CAAC,CAAC;QAEF,KAAK,IAAI,EAAE,CAAC;QAEZ,OAAO,GAAG,EAAE;YACR,SAAS,GAAG,IAAI,CAAC;QACrB,CAAC,CAAC;IACN,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,EAAE,aAAa,CAAC,CAAC,CAAC;IAEhE,KAAK,CAAC,SAAS,CAAC,GAAG,EAAE;QACjB,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,UAAU,GAAG,GAAG,KAAK,CAAC,IAAI,GAAG,MAAM,CAAC,QAAQ,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC;QAElE,MAAM,YAAY,GAAG,KAAK,IAAI,EAAE;YAC5B,IAAI,CAAC;gBACD,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC5B,OAAO;gBACX,CAAC;gBAED,MAAM,MAAM,GAAG,MAAM,kBAAkB,CACnC,uBAAuB,EACvB,EAAE,IAAI,EAAE,UAAU,EAAE,EACpB;oBACI,SAAS,EAAE,yBAAyB,EAAE,IAAI,iBAAiB,EAAE;iBAChE,CACJ,CAAC;gBAEF,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;oBAC5B,OAAO;gBACX,CAAC;gBAED,kBAAkB,CAAC,MAAM,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC;YAC5C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACb,IAAK,KAA2B,EAAE,IAAI,KAAK,YAAY,EAAE,CAAC;oBACtD,OAAO;gBACX,CAAC;YACL,CAAC;QACL,CAAC,CAAC;QAEF,YAAY,EAAE,CAAC;QAEf,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,CAAC;IACpC,CAAC,EAAE,CAAC,KAAK,CAAC,IAAI,EAAE,mBAAmB,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;IAEjD,IAAI,CAAC,KAAK,EAAE,CAAC;QACT,MAAM,YAAY,GAAG,QAAQ,IAAI,CAAC,GAAG,EAAE,CAAC,sCAAoB,CAAC,CAAC;QAC9D,MAAM,OAAO,GAAG,KAAC,YAAY,KAAG,CAAC;QAEjC,OAAO,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,WAAW,YAAG,QAAQ,CAAC,CAAC,CAAC,KAAC,QAAQ,IAAC,SAAS,EAAE,YAAY,EAAE,SAAS,EAAE,EAAE,GAAI,CAAC,CAAC,CAAC,OAAO,GAA0B,CAAC;IAC5J,CAAC;IAED,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,SAAwG,CAAC;IAClI,MAAM,SAAS,GAAG;QACd,GAAG,eAAe;QAClB,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,YAAY,EAAE,mBAAmB;KACpC,CAAC;IAEF,uDAAuD;IACvD,MAAM,WAAW,GAAG,GAAG,EAAE;QACrB,IAAI,OAAO,GAAG,KAAC,IAAI,OAAK,SAAS,GAAI,CAAC;QACtC,+CAA+C;QAC/C,KAAK,IAAI,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;YACvD,MAAM,MAAM,GAAG,KAAK,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACtC,OAAO,GAAG,KAAC,MAAM,cAAE,OAAO,GAAU,CAAC;QACzC,CAAC;QACD,OAAO,OAAO,CAAC;IACnB,CAAC,CAAC;IAEF,MAAM,YAAY,GAAG,QAAQ,CAAC,CAAC,CAAC,CAC5B,KAAC,QAAQ,IAAC,SAAS,EAAE,WAAW,EAAE,SAAS,EAAE,SAAS,YAClD,KAAC,WAAW,KAAG,GACR,CACd,CAAC,CAAC,CAAC,CACA,KAAC,WAAW,KAAG,CAClB,CAAC;IAEF,OAAO,KAAC,aAAa,CAAC,QAAQ,IAAC,KAAK,EAAE,WAAW,YAAG,YAAY,GAA0B,CAAC;AAC/F,CAAC;AAeD,SAAS,kBAAkB,CAAC,IAA6B;IACrD,IAAI,OAAO,QAAQ,KAAK,WAAW,EAAE,CAAC;QAClC,OAAO;IACX,CAAC;IAED,qBAAqB,EAAE,CAAC;IAExB,IAAI,CAAC,IAAI,EAAE,CAAC;QACR,OAAO;IACX,CAAC;IAED,QAAQ,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC;IAE5B,MAAM,OAAO,GAAmE,EAAE,CAAC;IAEnF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACpF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,SAAS,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS,EAAE,EAAE,CAAC,CAAC;IAC/F,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,IAAI,qBAAqB,EAAE,EAAE,CAAC,CAAC;IACnH,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IAErF,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,gBAAgB,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QAChG,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IACrG,CAAC;IAED,IAAI,IAAI,CAAC,KAAK,EAAE,CAAC;QACb,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACpF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,eAAe,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;IACzF,CAAC;IAED,IAAI,IAAI,CAAC,YAAY,EAAE,CAAC;QACpB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;QACzF,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,GAAG,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IACxF,CAAC;IAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;QAChB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IAC/F,CAAC;IAED,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QACd,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;IACnF,CAAC;IAED,IAAI,IAAI,CAAC,WAAW,EAAE,CAAC;QACnB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,cAAc,EAAE,OAAO,EAAE,IAAI,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;IAC9F,CAAC;IAED,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;QACtB,OAAO,CAAC,IAAI,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,iBAAiB,EAAE,OAAO,EAAE,IAAI,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IACpG,CAAC;IAED,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC1B,MAAM,IAAI,GAAG,QAAQ,CAAC,aAAa,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAC/C,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YACrD,IAAI,CAAC,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;QAClC,CAAC;QACD,IAAI,CAAC,YAAY,CAAC,iBAAiB,EAAE,MAAM,CAAC,CAAC;QAC7C,QAAQ,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB;IAC1B,MAAM,SAAS,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,CAAC,CAAC;IAE3E,KAAK,MAAM,IAAI,IAAI,SAAS,EAAE,CAAC;QAC3B,IAAI,IAAI,CAAC,YAAY,CAAC,iBAAiB,CAAC,KAAK,MAAM,EAAE,CAAC;YAClD,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,SAAS;QACb,CAAC;QAED,IAAI,IAAI,CAAC,OAAO,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACxC,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;YAC3D,IAAI,GAAG,KAAK,WAAW,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,EAAE,CAAC;YAClB,CAAC;YACD,SAAS;QACb,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAC7D,MAAM,QAAQ,GAAG,CAAC,IAAI,CAAC,YAAY,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;QAErE,IAAI,IAAI,KAAK,aAAa,IAAI,IAAI,KAAK,QAAQ,IAAI,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC7E,IAAI,CAAC,MAAM,EAAE,CAAC;YACd,SAAS;QACb,CAAC;QAED,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;QAClB,CAAC;IACL,CAAC;AACL,CAAC","sourcesContent":["import type { ComponentType } from \"react\";\nimport React, { useMemo, useSyncExternalStore, useTransition } from \"react\";\n\nimport { SEO_METADATA_RPC_METHOD } from \"../runtime/internalMethods.js\";\nimport { isDevEnvironment } from \"./env.js\";\nimport type { RouteEntry } from \"./routerManifest.js\";\nimport { buildRoutes } from \"./routerManifest.js\";\nimport { isAutoHttpOnMobileEnabled, isMobileRpcDevice, rpcCallWithOptions } from \"./rpcClient.js\";\n\ntype HeliumSSRBootstrap = {\n    path: string;\n    props: Record<string, unknown>;\n};\n\nfunction getInitialSSRBootstrap(): HeliumSSRBootstrap | null {\n    if (typeof window === \"undefined\") {\n        return null;\n    }\n\n    const globalWindow = window as typeof window & {\n        __HELIUM_SSR_DATA__?: HeliumSSRBootstrap;\n    };\n\n    const payload = globalWindow.__HELIUM_SSR_DATA__;\n    if (!payload || typeof payload !== \"object\" || typeof payload.path !== \"string\" || typeof payload.props !== \"object\" || payload.props === null) {\n        return null;\n    }\n\n    return payload;\n}\n\nasync function fetchSSRPageProps(path: string): Promise<Record<string, unknown> | null> {\n    try {\n        const response = await fetch(`/__helium__/page-props?path=${encodeURIComponent(path)}`, {\n            method: \"GET\",\n            headers: {\n                Accept: \"application/json\",\n            },\n        });\n\n        if (!response.ok) {\n            return null;\n        }\n\n        const payload = (await response.json()) as {\n            ssr?: boolean;\n            props?: Record<string, unknown> | null;\n        };\n\n        if (!payload.ssr || !payload.props) {\n            return null;\n        }\n\n        return payload.props;\n    } catch {\n        return null;\n    }\n}\n\n// Event emitter for router events\ntype RouterEvent = \"navigation\" | \"before-navigation\";\ntype EventListener = (event: { from: string; to: string; preventDefault?: () => void }) => void;\n\nclass RouterEventEmitter {\n    private listeners: Map<RouterEvent, Set<EventListener>> = new Map();\n\n    on(event: RouterEvent, listener: EventListener): () => void {\n        if (!this.listeners.has(event)) {\n            this.listeners.set(event, new Set());\n        }\n        this.listeners.get(event)!.add(listener);\n\n        // Return unsubscribe function\n        return () => {\n            this.listeners.get(event)?.delete(listener);\n        };\n    }\n\n    emit(event: RouterEvent, data: { from: string; to: string }): boolean {\n        const eventListeners = this.listeners.get(event);\n        if (!eventListeners || eventListeners.size === 0) {\n            return true;\n        }\n\n        let prevented = false;\n        const preventDefault = () => {\n            prevented = true;\n        };\n\n        const eventData = event === \"before-navigation\" ? { ...data, preventDefault } : data;\n\n        eventListeners.forEach((listener) => {\n            listener(eventData);\n        });\n\n        return !prevented;\n    }\n\n    // Clear all listeners - useful for HMR\n    clear() {\n        this.listeners.clear();\n    }\n}\n\n// Use a singleton that survives HMR by attaching to window in dev mode\nlet routerEventEmitter: RouterEventEmitter;\n\nif (typeof window !== \"undefined\" && isDevEnvironment()) {\n    // In dev mode, reuse the same emitter instance across HMR\n    const globalWindow = window as typeof window & { __heliumRouterEmitter?: RouterEventEmitter };\n    if (!globalWindow.__heliumRouterEmitter) {\n        globalWindow.__heliumRouterEmitter = new RouterEventEmitter();\n    }\n    routerEventEmitter = globalWindow.__heliumRouterEmitter;\n} else {\n    routerEventEmitter = new RouterEventEmitter();\n}\n\ntype RouterState = {\n    path: string;\n    searchParams: URLSearchParams;\n    isNavigating: boolean;\n};\n\nfunction getLocation(): RouterState {\n    const { pathname, search } = window.location;\n    return {\n        path: pathname,\n        searchParams: new URLSearchParams(search),\n        isNavigating: false,\n    };\n}\n\nfunction matchRoute(path: string, routes: RouteEntry[]) {\n    for (const r of routes) {\n        const m = r.matcher(path);\n        if (m) {\n            return { params: m.params, route: r };\n        }\n    }\n    return null;\n}\n\n// Location store for useSyncExternalStore\n// Preserve across HMR by attaching to window in dev mode\nlet currentLocation: RouterState;\nlet locationListeners: Set<() => void>;\n\nif (typeof window !== \"undefined\" && isDevEnvironment()) {\n    const globalWindow = window as typeof window & {\n        __heliumCurrentLocation?: RouterState;\n        __heliumLocationListeners?: Set<() => void>;\n    };\n    if (!globalWindow.__heliumCurrentLocation) {\n        globalWindow.__heliumCurrentLocation = getLocation();\n    }\n    if (!globalWindow.__heliumLocationListeners) {\n        globalWindow.__heliumLocationListeners = new Set();\n    }\n    currentLocation = globalWindow.__heliumCurrentLocation;\n    locationListeners = globalWindow.__heliumLocationListeners;\n} else if (typeof window !== \"undefined\") {\n    currentLocation = getLocation();\n    locationListeners = new Set();\n} else {\n    currentLocation = { path: \"/\", searchParams: new URLSearchParams(), isNavigating: false };\n    locationListeners = new Set();\n}\n\n// Helper to re-extract params from path using stored routes during HMR\nfunction extractParamsFromPath(path: string): Record<string, string | string[]> {\n    if (typeof window !== \"undefined\" && isDevEnvironment()) {\n        const globalWindow = window as typeof window & { __heliumGlobalRoutes?: RouteEntry[] };\n        const routes = globalWindow.__heliumGlobalRoutes;\n        if (routes && routes.length > 0) {\n            const match = matchRoute(path, routes);\n            if (match) {\n                return match.params;\n            }\n        }\n    }\n    return {};\n}\n\nfunction subscribeToLocation(callback: () => void) {\n    locationListeners.add(callback);\n    return () => locationListeners.delete(callback);\n}\n\nfunction getLocationSnapshot() {\n    return currentLocation;\n}\n\nconst SERVER_SNAPSHOT: RouterState = { path: \"/\", searchParams: new URLSearchParams(), isNavigating: false };\nfunction getServerSnapshot() {\n    return SERVER_SNAPSHOT;\n}\n\nfunction updateLocation(isNavigating = false) {\n    const newLocation = { ...getLocation(), isNavigating };\n    currentLocation = newLocation;\n    // Update the global reference in dev mode\n    if (typeof window !== \"undefined\" && isDevEnvironment()) {\n        (window as typeof window & { __heliumCurrentLocation?: RouterState }).__heliumCurrentLocation = newLocation;\n    }\n    locationListeners.forEach((listener) => listener());\n}\n\n// Set up global listeners once\nif (typeof window !== \"undefined\") {\n    // Only set up once, survives HMR\n    const globalWindow = window as typeof window & { __heliumLocationListenerSetup?: boolean };\n    if (!globalWindow.__heliumLocationListenerSetup) {\n        globalWindow.__heliumLocationListenerSetup = true;\n\n        window.addEventListener(\"popstate\", () => updateLocation(false));\n\n        // Also listen to navigation events from the emitter\n        routerEventEmitter.on(\"navigation\", () => updateLocation(false));\n    }\n}\n\n/** Options for push/replace navigation methods */\nexport interface RouterNavigationOptions {\n    /** Scroll to top after navigation (default: true) */\n    scrollToTop?: boolean;\n}\n\n// Context for useRouter hook\ntype RouterContext = {\n    path: string;\n    params: Record<string, string | string[]>;\n    searchParams: URLSearchParams;\n    push: (href: string, options?: RouterNavigationOptions) => void;\n    replace: (href: string, options?: RouterNavigationOptions) => void;\n    on: (event: RouterEvent, listener: EventListener) => () => void;\n    status: 200 | 404;\n    isNavigating: boolean;\n    /** Indicates content is stale (old content shown while new content renders) - React 18+ concurrent feature */\n    isPending: boolean;\n};\n\nexport const RouterContext = React.createContext<RouterContext | null>(null);\n\n/**\n * Access router context inside a component tree managed by <AppRouter />.\n *\n * Provides current path, route params, URL search params and navigation helpers\n * (\\`push\\`, \\`replace\\`) as well as an \\`on\\` method to subscribe to navigation events.\n * The \\`isNavigating\\` property indicates when a navigation is in progress.\n * The \\`isPending\\` property indicates when content is stale (React concurrent features).\n * Throws when used outside of an <AppRouter /> provider.\n */\nexport function useRouter() {\n    const ctx = React.useContext(RouterContext);\n    if (!ctx) {\n        // During HMR in development, context might be temporarily unavailable\n        // Provide a temporary fallback to prevent white screen of death\n        // Re-extract params from current path using stored routes\n        if (typeof window !== \"undefined\" && isDevEnvironment()) {\n            const currentPath = window.location.pathname;\n            return {\n                path: currentPath,\n                params: extractParamsFromPath(currentPath),\n                searchParams: new URLSearchParams(window.location.search),\n                push: (href: string, options?: RouterNavigationOptions) => {\n                    window.history.pushState({}, \"\", href);\n                    if (options?.scrollToTop !== false) {\n                        window.scrollTo({ top: 0, left: 0, behavior: \"smooth\" });\n                    }\n                    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n                },\n                replace: (href: string, options?: RouterNavigationOptions) => {\n                    window.history.replaceState({}, \"\", href);\n                    if (options?.scrollToTop !== false) {\n                        window.scrollTo({ top: 0, left: 0, behavior: \"smooth\" });\n                    }\n                    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n                },\n                on: () => () => {},\n                status: 200 as const,\n                isNavigating: false,\n                isPending: false,\n            };\n        }\n        throw new Error(\"useRouter must be used inside <AppRouter>\");\n    }\n    return ctx;\n}\n\n/**\n * Redirect component for declarative navigation.\n * Use this instead of calling router.push() during render.\n *\n * @example\n * \\`\\`\\`tsx\n * export default function Docs() {\n *   return <Redirect to=\"/docs/getting-started\" />;\n * }\n * \\`\\`\\`\n */\nexport function Redirect({ to, replace = false }: { to: string; replace?: boolean }) {\n    const hasRedirected = React.useRef(false);\n\n    // Use useLayoutEffect to redirect before paint\n    React.useLayoutEffect(() => {\n        const targetPath = to.split(\"?\")[0];\n        if (!hasRedirected.current && window.location.pathname !== targetPath) {\n            hasRedirected.current = true;\n\n            // Perform navigation\n            if (replace) {\n                window.history.replaceState(null, \"\", to);\n            } else {\n                window.history.pushState(null, \"\", to);\n            }\n\n            // Emit navigation event to update router state\n            routerEventEmitter.emit(\"navigation\", {\n                from: window.location.pathname,\n                to: targetPath,\n            });\n        }\n    }, [to, replace]);\n\n    return null;\n}\n\n/** Options for navigation */\ninterface NavigateOptions {\n    replace?: boolean;\n    scrollToTop?: boolean;\n}\n\n// Navigation helper\nfunction navigate(href: string, options: NavigateOptions = {}) {\n    const { replace = false, scrollToTop = true } = options;\n    const from = window.location.pathname;\n    const to = href.split(\"?\")[0]; // Extract pathname from href\n\n    // Emit before-navigation event (can be prevented)\n    const canNavigate = routerEventEmitter.emit(\"before-navigation\", { from, to });\n    if (!canNavigate) {\n        return; // Navigation was prevented\n    }\n\n    // Set navigating state to true before navigation\n    currentLocation = { ...currentLocation, isNavigating: true };\n    locationListeners.forEach((listener) => listener());\n\n    if (replace) {\n        window.history.replaceState(null, \"\", href);\n    } else {\n        window.history.pushState(null, \"\", href);\n    }\n\n    // Scroll to top immediately after pushState, before React re-renders.\n    // Using instant scroll avoids race conditions where smooth scrolling\n    // gets interrupted by React DOM updates, especially on Safari mobile.\n    if (scrollToTop) {\n        window.scrollTo({ top: 0, left: 0, behavior: \"instant\" });\n    }\n\n    // Update location state synchronously so there is no stale-state window\n    // between pushState and the next render.\n    updateLocation(false);\n\n    // Emit navigation event after state is consistent\n    routerEventEmitter.emit(\"navigation\", { from, to });\n}\n\nexport type LinkProps = React.PropsWithChildren<\n    Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, \"href\"> & {\n        href: string;\n        replace?: boolean;\n        /** Disable prefetching on hover (default: false - prefetch is enabled) */\n        prefetch?: boolean;\n        /** Scroll to top after navigation (default: true) */\n        scrollToTop?: boolean;\n    }\n>;\n\n/**\n * Check if a URL is external (different origin).\n */\nfunction isExternalUrl(href: string): boolean {\n    if (typeof window === \"undefined\") {\n        return false;\n    }\n    try {\n        const url = new URL(href, window.location.origin);\n        return url.origin !== window.location.origin;\n    } catch {\n        return false;\n    }\n}\n\n// Store routes globally for prefetching (set by AppRouter)\n// Preserve across HMR in dev mode\nlet globalRoutes: RouteEntry[];\n\nif (typeof window !== \"undefined\" && isDevEnvironment()) {\n    const globalWindow = window as typeof window & { __heliumGlobalRoutes?: RouteEntry[] };\n    if (!globalWindow.__heliumGlobalRoutes) {\n        globalWindow.__heliumGlobalRoutes = [];\n    }\n    globalRoutes = globalWindow.__heliumGlobalRoutes;\n} else {\n    globalRoutes = [];\n}\n\n/**\n * Client-side navigation link.\n *\n * Intercepts left-clicks and uses the router's navigation helpers for SPA\n * navigation. Keeps normal anchor behaviour when modifier keys are used,\n * when the link is external, or when `target` / `download` attributes\n * are present.\n *\n * Automatically prefetches page chunks on hover for faster navigation.\n */\nexport function Link(props: LinkProps) {\n    const {\n        children,\n        href,\n        className,\n        prefetch: prefetchProp = true,\n        scrollToTop = true,\n        replace: replaceProp,\n        target,\n        download,\n        onClick: userOnClick,\n        onMouseEnter: userOnMouseEnter,\n        onFocus: userOnFocus,\n        ...restProps\n    } = props;\n\n    const onClick = (e: React.MouseEvent<HTMLAnchorElement>) => {\n        // Let user's onClick run first so they can call e.preventDefault()\n        userOnClick?.(e);\n\n        if (\n            e.defaultPrevented ||\n            e.button !== 0 || // only left click\n            e.metaKey ||\n            e.ctrlKey ||\n            e.shiftKey ||\n            e.altKey ||\n            target || // let browser handle target=\"_blank\" etc.\n            download != null || // let browser handle downloads\n            isExternalUrl(href) // let browser handle external links\n        ) {\n            return;\n        }\n        e.preventDefault();\n        navigate(href, { replace: replaceProp, scrollToTop });\n    };\n\n    const onMouseEnter = async (e: React.MouseEvent<HTMLAnchorElement>) => {\n        // Prefetch the route on hover if enabled and not external (lazy-load prefetch logic)\n        if (prefetchProp && !isExternalUrl(href) && globalRoutes.length > 0) {\n            const { prefetchRoute } = await import(\"./prefetch.js\");\n            prefetchRoute(href, globalRoutes);\n        }\n        userOnMouseEnter?.(e);\n    };\n\n    const onFocus = async (e: React.FocusEvent<HTMLAnchorElement>) => {\n        // Also prefetch on focus (keyboard navigation)\n        if (prefetchProp && !isExternalUrl(href) && globalRoutes.length > 0) {\n            const { prefetchRoute } = await import(\"./prefetch.js\");\n            prefetchRoute(href, globalRoutes);\n        }\n        userOnFocus?.(e);\n    };\n\n    return (\n        <a {...restProps} href={href} target={target} download={download} onClick={onClick} onMouseEnter={onMouseEnter} onFocus={onFocus} className={className}>\n            {children}\n        </a>\n    );\n}\n\n// AppShell props type\n/**\n * Props passed to an optional \\`AppShell\\` wrapper component used by <AppRouter />.\n *\n * \\`Component\\` — the page component to render. \\`pageProps\\` — props provided to the page.\n */\nexport type AppShellProps<TPageProps extends Record<string, unknown> = Record<string, unknown>> = {\n    Component: ComponentType<TPageProps>;\n    pageProps: TPageProps;\n    children?: React.ReactNode;\n};\n\n// Main router component\nexport function AppRouter({ AppShell }: { AppShell?: ComponentType<AppShellProps> }) {\n    // useTransition for concurrent rendering - allows React to keep UI responsive during navigation\n    const [isPending, startTransition] = useTransition();\n\n    // Build routes once on mount (client-side only)\n    const { routes, NotFound } = useMemo(() => {\n        if (typeof window === \"undefined\") {\n            return { routes: [], NotFound: undefined };\n        }\n        const result = buildRoutes();\n        // Store routes globally for Link prefetching\n        // In dev mode, also update the global reference to survive HMR\n        if (isDevEnvironment()) {\n            const globalWindow = window as typeof window & { __heliumGlobalRoutes?: RouteEntry[] };\n            globalWindow.__heliumGlobalRoutes = result.routes;\n            // Update the module-level reference as well\n            globalRoutes.length = 0;\n            globalRoutes.push(...result.routes);\n        } else {\n            globalRoutes = result.routes;\n        }\n        return result;\n    }, []);\n\n    // Use useSyncExternalStore to subscribe to location changes\n    // This ensures synchronous updates when location changes\n    const state = useSyncExternalStore(subscribeToLocation, getLocationSnapshot, getServerSnapshot);\n    const [runtimeSSRProps, setRuntimeSSRProps] = React.useState<Record<string, unknown>>(() => {\n        const payload = getInitialSSRBootstrap();\n        if (!payload) {\n            return {};\n        }\n\n        if (payload.path === window.location.pathname) {\n            return payload.props;\n        }\n\n        return {};\n    });\n    const [hydrationDone, setHydrationDone] = React.useState(false);\n\n    const match = useMemo(() => matchRoute(state.path, routes), [state.path, routes]);\n\n    // Use matched params, or fall back to re-extracting from path using global routes during HMR\n    const currentParams = match?.params ?? (isDevEnvironment() ? extractParamsFromPath(state.path) : {});\n\n    // In dev mode, always read fresh searchParams from URL to handle HMR edge cases\n    const currentSearchParams = isDevEnvironment() ? new URLSearchParams(window.location.search) : state.searchParams;\n\n    const routerValue: RouterContext = {\n        path: state.path,\n        params: currentParams,\n        searchParams: currentSearchParams,\n        push: (href, options) => {\n            // Wrap navigation in startTransition for smoother updates\n            startTransition(() => {\n                navigate(href, { scrollToTop: options?.scrollToTop });\n            });\n        },\n        replace: (href, options) => {\n            startTransition(() => {\n                navigate(href, { replace: true, scrollToTop: options?.scrollToTop });\n            });\n        },\n        on: (event, listener) => routerEventEmitter.on(event, listener),\n        status: match ? 200 : 404,\n        isNavigating: state.isNavigating,\n        isPending,\n    };\n\n    React.useEffect(() => {\n        const targetPath = `${state.path}${window.location.search || \"\"}`;\n\n        // On first client render, if SSR payload already exists for this path, keep it.\n        if (!hydrationDone) {\n            const bootstrap = getInitialSSRBootstrap();\n            if (bootstrap && bootstrap.path === state.path) {\n                setHydrationDone(true);\n                return;\n            }\n            setHydrationDone(true);\n        }\n\n        let cancelled = false;\n\n        const load = async () => {\n            const props = await fetchSSRPageProps(targetPath);\n            if (cancelled) {\n                return;\n            }\n\n            setRuntimeSSRProps(props ?? {});\n        };\n\n        void load();\n\n        return () => {\n            cancelled = true;\n        };\n    }, [state.path, currentSearchParams.toString(), hydrationDone]);\n\n    React.useEffect(() => {\n        const controller = new AbortController();\n        const targetPath = `${state.path}${window.location.search || \"\"}`;\n\n        const syncMetadata = async () => {\n            try {\n                if (controller.signal.aborted) {\n                    return;\n                }\n\n                const result = await rpcCallWithOptions<ClientSocialMeta | null, { path: string }>(\n                    SEO_METADATA_RPC_METHOD,\n                    { path: targetPath },\n                    {\n                        forceHttp: isAutoHttpOnMobileEnabled() && isMobileRpcDevice(),\n                    }\n                );\n\n                if (controller.signal.aborted) {\n                    return;\n                }\n\n                applyRouteMetadata(result.data ?? null);\n            } catch (error) {\n                if ((error as { name?: string })?.name === \"AbortError\") {\n                    return;\n                }\n            }\n        };\n\n        syncMetadata();\n\n        return () => controller.abort();\n    }, [state.path, currentSearchParams.toString()]);\n\n    if (!match) {\n        const NotFoundComp = NotFound ?? (() => <div>Not found</div>);\n        const content = <NotFoundComp />;\n\n        return <RouterContext.Provider value={routerValue}>{AppShell ? <AppShell Component={NotFoundComp} pageProps={{}} /> : content}</RouterContext.Provider>;\n    }\n\n    const Page = match.route.Component as ComponentType<{ params: Record<string, string | string[]>; searchParams: URLSearchParams }>;\n    const pageProps = {\n        ...runtimeSSRProps,\n        params: match.params,\n        searchParams: currentSearchParams,\n    };\n\n    // Create a wrapped component that includes all layouts\n    const WrappedPage = () => {\n        let content = <Page {...pageProps} />;\n        // Wrap page with layouts (from outer to inner)\n        for (let i = match.route.layouts.length - 1; i >= 0; i--) {\n            const Layout = match.route.layouts[i];\n            content = <Layout>{content}</Layout>;\n        }\n        return content;\n    };\n\n    const finalContent = AppShell ? (\n        <AppShell Component={WrappedPage} pageProps={pageProps}>\n            <WrappedPage />\n        </AppShell>\n    ) : (\n        <WrappedPage />\n    );\n\n    return <RouterContext.Provider value={routerValue}>{finalContent}</RouterContext.Provider>;\n}\n\ntype ClientSocialMeta = {\n    title: string;\n    description?: string;\n    image?: string;\n    canonicalUrl?: string;\n    siteName?: string;\n    type?: string;\n    robots?: string;\n    twitterCard?: \"summary\" | \"summary_large_image\" | \"app\" | \"player\";\n    twitterSite?: string;\n    twitterCreator?: string;\n};\n\nfunction applyRouteMetadata(meta: ClientSocialMeta | null) {\n    if (typeof document === \"undefined\") {\n        return;\n    }\n\n    removeExistingSeoTags();\n\n    if (!meta) {\n        return;\n    }\n\n    document.title = meta.title;\n\n    const entries: Array<{ tag: \"meta\" | \"link\"; attrs: Record<string, string> }> = [];\n\n    entries.push({ tag: \"meta\", attrs: { property: \"og:title\", content: meta.title } });\n    entries.push({ tag: \"meta\", attrs: { property: \"og:type\", content: meta.type ?? \"website\" } });\n    entries.push({ tag: \"meta\", attrs: { name: \"twitter:card\", content: meta.twitterCard ?? \"summary_large_image\" } });\n    entries.push({ tag: \"meta\", attrs: { name: \"twitter:title\", content: meta.title } });\n\n    if (meta.description) {\n        entries.push({ tag: \"meta\", attrs: { name: \"description\", content: meta.description } });\n        entries.push({ tag: \"meta\", attrs: { property: \"og:description\", content: meta.description } });\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:description\", content: meta.description } });\n    }\n\n    if (meta.image) {\n        entries.push({ tag: \"meta\", attrs: { property: \"og:image\", content: meta.image } });\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:image\", content: meta.image } });\n    }\n\n    if (meta.canonicalUrl) {\n        entries.push({ tag: \"meta\", attrs: { property: \"og:url\", content: meta.canonicalUrl } });\n        entries.push({ tag: \"link\", attrs: { rel: \"canonical\", href: meta.canonicalUrl } });\n    }\n\n    if (meta.siteName) {\n        entries.push({ tag: \"meta\", attrs: { property: \"og:site_name\", content: meta.siteName } });\n    }\n\n    if (meta.robots) {\n        entries.push({ tag: \"meta\", attrs: { name: \"robots\", content: meta.robots } });\n    }\n\n    if (meta.twitterSite) {\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:site\", content: meta.twitterSite } });\n    }\n\n    if (meta.twitterCreator) {\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:creator\", content: meta.twitterCreator } });\n    }\n\n    for (const entry of entries) {\n        const node = document.createElement(entry.tag);\n        for (const [key, value] of Object.entries(entry.attrs)) {\n            node.setAttribute(key, value);\n        }\n        node.setAttribute(\"data-helium-seo\", \"true\");\n        document.head.appendChild(node);\n    }\n}\n\nfunction removeExistingSeoTags() {\n    const headNodes = Array.from(document.head.querySelectorAll(\"meta, link\"));\n\n    for (const node of headNodes) {\n        if (node.getAttribute(\"data-helium-seo\") === \"true\") {\n            node.remove();\n            continue;\n        }\n\n        if (node.tagName.toLowerCase() === \"link\") {\n            const rel = (node.getAttribute(\"rel\") || \"\").toLowerCase();\n            if (rel === \"canonical\") {\n                node.remove();\n            }\n            continue;\n        }\n\n        const name = (node.getAttribute(\"name\") || \"\").toLowerCase();\n        const property = (node.getAttribute(\"property\") || \"\").toLowerCase();\n\n        if (name === \"description\" || name === \"robots\" || name.startsWith(\"twitter:\")) {\n            node.remove();\n            continue;\n        }\n\n        if (property.startsWith(\"og:\")) {\n            node.remove();\n        }\n    }\n}\n"]}
+{"version":3,"file":"Router.js","sourceRoot":"","sources":["../../src/client/Router.tsx"],"names":[],"mappings":"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","sourcesContent":["import type { ComponentType } from \"react\";\nimport React, { useMemo, useSyncExternalStore, useTransition } from \"react\";\n\nimport { SEO_METADATA_RPC_METHOD } from \"../runtime/internalMethods.js\";\nimport { isDevEnvironment } from \"./env.js\";\nimport type { RouteEntry } from \"./routerManifest.js\";\nimport { buildRoutes } from \"./routerManifest.js\";\nimport { isAutoHttpOnMobileEnabled, isMobileRpcDevice, rpcCallWithOptions } from \"./rpcClient.js\";\n\ntype HeliumSSRBootstrap = {\n    path: string;\n    props: Record<string, unknown>;\n};\n\ntype SSRRedirectPayload = {\n    destination: string;\n    statusCode?: 301 | 302 | 303 | 307 | 308;\n    replace?: boolean;\n};\n\ntype SSRPagePropsPayload =\n    | {\n          kind: \"props\";\n          props: Record<string, unknown>;\n      }\n    | {\n          kind: \"redirect\";\n          redirect: SSRRedirectPayload;\n      }\n    | {\n          kind: \"none\";\n      };\n\nfunction getInitialSSRBootstrap(): HeliumSSRBootstrap | null {\n    if (typeof window === \"undefined\") {\n        return null;\n    }\n\n    const globalWindow = window as typeof window & {\n        __HELIUM_SSR_DATA__?: HeliumSSRBootstrap;\n    };\n\n    const payload = globalWindow.__HELIUM_SSR_DATA__;\n    if (!payload || typeof payload !== \"object\" || typeof payload.path !== \"string\" || typeof payload.props !== \"object\" || payload.props === null) {\n        return null;\n    }\n\n    return payload;\n}\n\nasync function fetchSSRPageProps(path: string): Promise<SSRPagePropsPayload> {\n    try {\n        const response = await fetch(`/__helium__/page-props?path=${encodeURIComponent(path)}`, {\n            method: \"GET\",\n            headers: {\n                Accept: \"application/json\",\n            },\n        });\n\n        if (!response.ok) {\n            return { kind: \"none\" };\n        }\n\n        const payload = (await response.json()) as {\n            ssr?: boolean;\n            props?: Record<string, unknown> | null;\n            redirect?: SSRRedirectPayload;\n        };\n\n        if (!payload.ssr) {\n            return { kind: \"none\" };\n        }\n\n        if (payload.redirect && typeof payload.redirect.destination === \"string\" && payload.redirect.destination.length > 0) {\n            return {\n                kind: \"redirect\",\n                redirect: payload.redirect,\n            };\n        }\n\n        if (!payload.props) {\n            return { kind: \"none\" };\n        }\n\n        return {\n            kind: \"props\",\n            props: payload.props,\n        };\n    } catch {\n        return { kind: \"none\" };\n    }\n}\n\n// Event emitter for router events\ntype RouterEvent = \"navigation\" | \"before-navigation\";\ntype EventListener = (event: { from: string; to: string; preventDefault?: () => void }) => void;\n\nclass RouterEventEmitter {\n    private listeners: Map<RouterEvent, Set<EventListener>> = new Map();\n\n    on(event: RouterEvent, listener: EventListener): () => void {\n        if (!this.listeners.has(event)) {\n            this.listeners.set(event, new Set());\n        }\n        this.listeners.get(event)!.add(listener);\n\n        // Return unsubscribe function\n        return () => {\n            this.listeners.get(event)?.delete(listener);\n        };\n    }\n\n    emit(event: RouterEvent, data: { from: string; to: string }): boolean {\n        const eventListeners = this.listeners.get(event);\n        if (!eventListeners || eventListeners.size === 0) {\n            return true;\n        }\n\n        let prevented = false;\n        const preventDefault = () => {\n            prevented = true;\n        };\n\n        const eventData = event === \"before-navigation\" ? { ...data, preventDefault } : data;\n\n        eventListeners.forEach((listener) => {\n            listener(eventData);\n        });\n\n        return !prevented;\n    }\n\n    // Clear all listeners - useful for HMR\n    clear() {\n        this.listeners.clear();\n    }\n}\n\n// Use a singleton that survives HMR by attaching to window in dev mode\nlet routerEventEmitter: RouterEventEmitter;\n\nif (typeof window !== \"undefined\" && isDevEnvironment()) {\n    // In dev mode, reuse the same emitter instance across HMR\n    const globalWindow = window as typeof window & { __heliumRouterEmitter?: RouterEventEmitter };\n    if (!globalWindow.__heliumRouterEmitter) {\n        globalWindow.__heliumRouterEmitter = new RouterEventEmitter();\n    }\n    routerEventEmitter = globalWindow.__heliumRouterEmitter;\n} else {\n    routerEventEmitter = new RouterEventEmitter();\n}\n\ntype RouterState = {\n    path: string;\n    searchParams: URLSearchParams;\n    isNavigating: boolean;\n};\n\nfunction getLocation(): RouterState {\n    const { pathname, search } = window.location;\n    return {\n        path: pathname,\n        searchParams: new URLSearchParams(search),\n        isNavigating: false,\n    };\n}\n\nfunction matchRoute(path: string, routes: RouteEntry[]) {\n    for (const r of routes) {\n        const m = r.matcher(path);\n        if (m) {\n            return { params: m.params, route: r };\n        }\n    }\n    return null;\n}\n\n// Location store for useSyncExternalStore\n// Preserve across HMR by attaching to window in dev mode\nlet currentLocation: RouterState;\nlet locationListeners: Set<() => void>;\n\nif (typeof window !== \"undefined\" && isDevEnvironment()) {\n    const globalWindow = window as typeof window & {\n        __heliumCurrentLocation?: RouterState;\n        __heliumLocationListeners?: Set<() => void>;\n    };\n    if (!globalWindow.__heliumCurrentLocation) {\n        globalWindow.__heliumCurrentLocation = getLocation();\n    }\n    if (!globalWindow.__heliumLocationListeners) {\n        globalWindow.__heliumLocationListeners = new Set();\n    }\n    currentLocation = globalWindow.__heliumCurrentLocation;\n    locationListeners = globalWindow.__heliumLocationListeners;\n} else if (typeof window !== \"undefined\") {\n    currentLocation = getLocation();\n    locationListeners = new Set();\n} else {\n    currentLocation = { path: \"/\", searchParams: new URLSearchParams(), isNavigating: false };\n    locationListeners = new Set();\n}\n\n// Helper to re-extract params from path using stored routes during HMR\nfunction extractParamsFromPath(path: string): Record<string, string | string[]> {\n    if (typeof window !== \"undefined\" && isDevEnvironment()) {\n        const globalWindow = window as typeof window & { __heliumGlobalRoutes?: RouteEntry[] };\n        const routes = globalWindow.__heliumGlobalRoutes;\n        if (routes && routes.length > 0) {\n            const match = matchRoute(path, routes);\n            if (match) {\n                return match.params;\n            }\n        }\n    }\n    return {};\n}\n\nfunction subscribeToLocation(callback: () => void) {\n    locationListeners.add(callback);\n    return () => locationListeners.delete(callback);\n}\n\nfunction getLocationSnapshot() {\n    return currentLocation;\n}\n\nconst SERVER_SNAPSHOT: RouterState = { path: \"/\", searchParams: new URLSearchParams(), isNavigating: false };\nfunction getServerSnapshot() {\n    return SERVER_SNAPSHOT;\n}\n\nfunction updateLocation(isNavigating = false) {\n    const newLocation = { ...getLocation(), isNavigating };\n    currentLocation = newLocation;\n    // Update the global reference in dev mode\n    if (typeof window !== \"undefined\" && isDevEnvironment()) {\n        (window as typeof window & { __heliumCurrentLocation?: RouterState }).__heliumCurrentLocation = newLocation;\n    }\n    locationListeners.forEach((listener) => listener());\n}\n\n// Set up global listeners once\nif (typeof window !== \"undefined\") {\n    // Only set up once, survives HMR\n    const globalWindow = window as typeof window & { __heliumLocationListenerSetup?: boolean };\n    if (!globalWindow.__heliumLocationListenerSetup) {\n        globalWindow.__heliumLocationListenerSetup = true;\n\n        window.addEventListener(\"popstate\", () => updateLocation(false));\n\n        // Also listen to navigation events from the emitter\n        routerEventEmitter.on(\"navigation\", () => updateLocation(false));\n    }\n}\n\n/** Options for push/replace navigation methods */\nexport interface RouterNavigationOptions {\n    /** Scroll to top after navigation (default: true) */\n    scrollToTop?: boolean;\n}\n\n// Context for useRouter hook\ntype RouterContext = {\n    path: string;\n    params: Record<string, string | string[]>;\n    searchParams: URLSearchParams;\n    push: (href: string, options?: RouterNavigationOptions) => void;\n    replace: (href: string, options?: RouterNavigationOptions) => void;\n    on: (event: RouterEvent, listener: EventListener) => () => void;\n    status: 200 | 404;\n    isNavigating: boolean;\n    /** Indicates content is stale (old content shown while new content renders) - React 18+ concurrent feature */\n    isPending: boolean;\n};\n\nexport const RouterContext = React.createContext<RouterContext | null>(null);\n\n/**\n * Access router context inside a component tree managed by <AppRouter />.\n *\n * Provides current path, route params, URL search params and navigation helpers\n * (\\`push\\`, \\`replace\\`) as well as an \\`on\\` method to subscribe to navigation events.\n * The \\`isNavigating\\` property indicates when a navigation is in progress.\n * The \\`isPending\\` property indicates when content is stale (React concurrent features).\n * Throws when used outside of an <AppRouter /> provider.\n */\nexport function useRouter() {\n    const ctx = React.useContext(RouterContext);\n    if (!ctx) {\n        // During HMR in development, context might be temporarily unavailable\n        // Provide a temporary fallback to prevent white screen of death\n        // Re-extract params from current path using stored routes\n        if (typeof window !== \"undefined\" && isDevEnvironment()) {\n            const currentPath = window.location.pathname;\n            return {\n                path: currentPath,\n                params: extractParamsFromPath(currentPath),\n                searchParams: new URLSearchParams(window.location.search),\n                push: (href: string, options?: RouterNavigationOptions) => {\n                    window.history.pushState({}, \"\", href);\n                    if (options?.scrollToTop !== false) {\n                        window.scrollTo({ top: 0, left: 0, behavior: \"smooth\" });\n                    }\n                    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n                },\n                replace: (href: string, options?: RouterNavigationOptions) => {\n                    window.history.replaceState({}, \"\", href);\n                    if (options?.scrollToTop !== false) {\n                        window.scrollTo({ top: 0, left: 0, behavior: \"smooth\" });\n                    }\n                    window.dispatchEvent(new PopStateEvent(\"popstate\"));\n                },\n                on: () => () => {},\n                status: 200 as const,\n                isNavigating: false,\n                isPending: false,\n            };\n        }\n        throw new Error(\"useRouter must be used inside <AppRouter>\");\n    }\n    return ctx;\n}\n\n/**\n * Redirect component for declarative navigation.\n * Use this instead of calling router.push() during render.\n *\n * @example\n * \\`\\`\\`tsx\n * export default function Docs() {\n *   return <Redirect to=\"/docs/getting-started\" />;\n * }\n * \\`\\`\\`\n */\nexport function Redirect({ to, replace = false }: { to: string; replace?: boolean }) {\n    const hasRedirected = React.useRef(false);\n\n    // Use useLayoutEffect to redirect before paint\n    React.useLayoutEffect(() => {\n        const targetPath = to.split(\"?\")[0];\n        if (!hasRedirected.current && window.location.pathname !== targetPath) {\n            hasRedirected.current = true;\n\n            // Perform navigation\n            if (replace) {\n                window.history.replaceState(null, \"\", to);\n            } else {\n                window.history.pushState(null, \"\", to);\n            }\n\n            // Emit navigation event to update router state\n            routerEventEmitter.emit(\"navigation\", {\n                from: window.location.pathname,\n                to: targetPath,\n            });\n        }\n    }, [to, replace]);\n\n    return null;\n}\n\n/** Options for navigation */\ninterface NavigateOptions {\n    replace?: boolean;\n    scrollToTop?: boolean;\n}\n\n// Navigation helper\nfunction navigate(href: string, options: NavigateOptions = {}) {\n    const { replace = false, scrollToTop = true } = options;\n    const from = window.location.pathname;\n    const to = href.split(\"?\")[0]; // Extract pathname from href\n\n    // Emit before-navigation event (can be prevented)\n    const canNavigate = routerEventEmitter.emit(\"before-navigation\", { from, to });\n    if (!canNavigate) {\n        return; // Navigation was prevented\n    }\n\n    // Set navigating state to true before navigation\n    currentLocation = { ...currentLocation, isNavigating: true };\n    locationListeners.forEach((listener) => listener());\n\n    if (replace) {\n        window.history.replaceState(null, \"\", href);\n    } else {\n        window.history.pushState(null, \"\", href);\n    }\n\n    // Scroll to top immediately after pushState, before React re-renders.\n    // Using instant scroll avoids race conditions where smooth scrolling\n    // gets interrupted by React DOM updates, especially on Safari mobile.\n    if (scrollToTop) {\n        window.scrollTo({ top: 0, left: 0, behavior: \"instant\" });\n    }\n\n    // Update location state synchronously so there is no stale-state window\n    // between pushState and the next render.\n    updateLocation(false);\n\n    // Emit navigation event after state is consistent\n    routerEventEmitter.emit(\"navigation\", { from, to });\n}\n\nexport type LinkProps = React.PropsWithChildren<\n    Omit<React.AnchorHTMLAttributes<HTMLAnchorElement>, \"href\"> & {\n        href: string;\n        replace?: boolean;\n        /** Disable prefetching on hover (default: false - prefetch is enabled) */\n        prefetch?: boolean;\n        /** Scroll to top after navigation (default: true) */\n        scrollToTop?: boolean;\n    }\n>;\n\n/**\n * Check if a URL is external (different origin).\n */\nfunction isExternalUrl(href: string): boolean {\n    if (typeof window === \"undefined\") {\n        return false;\n    }\n    try {\n        const url = new URL(href, window.location.origin);\n        return url.origin !== window.location.origin;\n    } catch {\n        return false;\n    }\n}\n\n// Store routes globally for prefetching (set by AppRouter)\n// Preserve across HMR in dev mode\nlet globalRoutes: RouteEntry[];\n\nif (typeof window !== \"undefined\" && isDevEnvironment()) {\n    const globalWindow = window as typeof window & { __heliumGlobalRoutes?: RouteEntry[] };\n    if (!globalWindow.__heliumGlobalRoutes) {\n        globalWindow.__heliumGlobalRoutes = [];\n    }\n    globalRoutes = globalWindow.__heliumGlobalRoutes;\n} else {\n    globalRoutes = [];\n}\n\n/**\n * Client-side navigation link.\n *\n * Intercepts left-clicks and uses the router's navigation helpers for SPA\n * navigation. Keeps normal anchor behaviour when modifier keys are used,\n * when the link is external, or when `target` / `download` attributes\n * are present.\n *\n * Automatically prefetches page chunks on hover for faster navigation.\n */\nexport function Link(props: LinkProps) {\n    const {\n        children,\n        href,\n        className,\n        prefetch: prefetchProp = true,\n        scrollToTop = true,\n        replace: replaceProp,\n        target,\n        download,\n        onClick: userOnClick,\n        onMouseEnter: userOnMouseEnter,\n        onFocus: userOnFocus,\n        ...restProps\n    } = props;\n\n    const onClick = (e: React.MouseEvent<HTMLAnchorElement>) => {\n        // Let user's onClick run first so they can call e.preventDefault()\n        userOnClick?.(e);\n\n        if (\n            e.defaultPrevented ||\n            e.button !== 0 || // only left click\n            e.metaKey ||\n            e.ctrlKey ||\n            e.shiftKey ||\n            e.altKey ||\n            target || // let browser handle target=\"_blank\" etc.\n            download != null || // let browser handle downloads\n            isExternalUrl(href) // let browser handle external links\n        ) {\n            return;\n        }\n        e.preventDefault();\n        navigate(href, { replace: replaceProp, scrollToTop });\n    };\n\n    const onMouseEnter = async (e: React.MouseEvent<HTMLAnchorElement>) => {\n        // Prefetch the route on hover if enabled and not external (lazy-load prefetch logic)\n        if (prefetchProp && !isExternalUrl(href) && globalRoutes.length > 0) {\n            const { prefetchRoute } = await import(\"./prefetch.js\");\n            prefetchRoute(href, globalRoutes);\n        }\n        userOnMouseEnter?.(e);\n    };\n\n    const onFocus = async (e: React.FocusEvent<HTMLAnchorElement>) => {\n        // Also prefetch on focus (keyboard navigation)\n        if (prefetchProp && !isExternalUrl(href) && globalRoutes.length > 0) {\n            const { prefetchRoute } = await import(\"./prefetch.js\");\n            prefetchRoute(href, globalRoutes);\n        }\n        userOnFocus?.(e);\n    };\n\n    return (\n        <a {...restProps} href={href} target={target} download={download} onClick={onClick} onMouseEnter={onMouseEnter} onFocus={onFocus} className={className}>\n            {children}\n        </a>\n    );\n}\n\n// AppShell props type\n/**\n * Props passed to an optional \\`AppShell\\` wrapper component used by <AppRouter />.\n *\n * \\`Component\\` — the page component to render. \\`pageProps\\` — props provided to the page.\n */\nexport type AppShellProps<TPageProps extends Record<string, unknown> = Record<string, unknown>> = {\n    Component: ComponentType<TPageProps>;\n    pageProps: TPageProps;\n    children?: React.ReactNode;\n};\n\n// Main router component\nexport function AppRouter({ AppShell }: { AppShell?: ComponentType<AppShellProps> }) {\n    // useTransition for concurrent rendering - allows React to keep UI responsive during navigation\n    const [isPending, startTransition] = useTransition();\n\n    // Build routes once on mount (client-side only)\n    const { routes, NotFound } = useMemo(() => {\n        if (typeof window === \"undefined\") {\n            return { routes: [], NotFound: undefined };\n        }\n        const result = buildRoutes();\n        // Store routes globally for Link prefetching\n        // In dev mode, also update the global reference to survive HMR\n        if (isDevEnvironment()) {\n            const globalWindow = window as typeof window & { __heliumGlobalRoutes?: RouteEntry[] };\n            globalWindow.__heliumGlobalRoutes = result.routes;\n            // Update the module-level reference as well\n            globalRoutes.length = 0;\n            globalRoutes.push(...result.routes);\n        } else {\n            globalRoutes = result.routes;\n        }\n        return result;\n    }, []);\n\n    // Use useSyncExternalStore to subscribe to location changes\n    // This ensures synchronous updates when location changes\n    const state = useSyncExternalStore(subscribeToLocation, getLocationSnapshot, getServerSnapshot);\n    const [runtimeSSRProps, setRuntimeSSRProps] = React.useState<Record<string, unknown>>(() => {\n        const payload = getInitialSSRBootstrap();\n        if (!payload) {\n            return {};\n        }\n\n        if (payload.path === window.location.pathname) {\n            return payload.props;\n        }\n\n        return {};\n    });\n    const [hydrationDone, setHydrationDone] = React.useState(false);\n\n    const match = useMemo(() => matchRoute(state.path, routes), [state.path, routes]);\n\n    // Use matched params, or fall back to re-extracting from path using global routes during HMR\n    const currentParams = match?.params ?? (isDevEnvironment() ? extractParamsFromPath(state.path) : {});\n\n    // In dev mode, always read fresh searchParams from URL to handle HMR edge cases\n    const currentSearchParams = isDevEnvironment() ? new URLSearchParams(window.location.search) : state.searchParams;\n\n    const routerValue: RouterContext = {\n        path: state.path,\n        params: currentParams,\n        searchParams: currentSearchParams,\n        push: (href, options) => {\n            // Wrap navigation in startTransition for smoother updates\n            startTransition(() => {\n                navigate(href, { scrollToTop: options?.scrollToTop });\n            });\n        },\n        replace: (href, options) => {\n            startTransition(() => {\n                navigate(href, { replace: true, scrollToTop: options?.scrollToTop });\n            });\n        },\n        on: (event, listener) => routerEventEmitter.on(event, listener),\n        status: match ? 200 : 404,\n        isNavigating: state.isNavigating,\n        isPending,\n    };\n\n    React.useEffect(() => {\n        const targetPath = `${state.path}${window.location.search || \"\"}`;\n\n        // On first client render, if SSR payload already exists for this path, keep it.\n        if (!hydrationDone) {\n            const bootstrap = getInitialSSRBootstrap();\n            if (bootstrap && bootstrap.path === state.path) {\n                setHydrationDone(true);\n                return;\n            }\n            setHydrationDone(true);\n        }\n\n        let cancelled = false;\n\n        const load = async () => {\n            const ssrPayload = await fetchSSRPageProps(targetPath);\n            if (cancelled) {\n                return;\n            }\n\n            if (ssrPayload.kind === \"redirect\") {\n                const destination = ssrPayload.redirect.destination;\n\n                if (isExternalUrl(destination)) {\n                    window.location.assign(destination);\n                    return;\n                }\n\n                navigate(destination, {\n                    replace: ssrPayload.redirect.replace ?? true,\n                    scrollToTop: true,\n                });\n                return;\n            }\n\n            if (ssrPayload.kind === \"props\") {\n                setRuntimeSSRProps(ssrPayload.props);\n                return;\n            }\n\n            setRuntimeSSRProps({});\n        };\n\n        void load();\n\n        return () => {\n            cancelled = true;\n        };\n    }, [state.path, currentSearchParams.toString(), hydrationDone]);\n\n    React.useEffect(() => {\n        const controller = new AbortController();\n        const targetPath = `${state.path}${window.location.search || \"\"}`;\n\n        const syncMetadata = async () => {\n            try {\n                if (controller.signal.aborted) {\n                    return;\n                }\n\n                const result = await rpcCallWithOptions<ClientSocialMeta | null, { path: string }>(\n                    SEO_METADATA_RPC_METHOD,\n                    { path: targetPath },\n                    {\n                        forceHttp: isAutoHttpOnMobileEnabled() && isMobileRpcDevice(),\n                    }\n                );\n\n                if (controller.signal.aborted) {\n                    return;\n                }\n\n                applyRouteMetadata(result.data ?? null);\n            } catch (error) {\n                if ((error as { name?: string })?.name === \"AbortError\") {\n                    return;\n                }\n            }\n        };\n\n        syncMetadata();\n\n        return () => controller.abort();\n    }, [state.path, currentSearchParams.toString()]);\n\n    if (!match) {\n        const NotFoundComp = NotFound ?? (() => <div>Not found</div>);\n        const content = <NotFoundComp />;\n\n        return <RouterContext.Provider value={routerValue}>{AppShell ? <AppShell Component={NotFoundComp} pageProps={{}} /> : content}</RouterContext.Provider>;\n    }\n\n    const Page = match.route.Component as ComponentType<{ params: Record<string, string | string[]>; searchParams: URLSearchParams }>;\n    const pageProps = {\n        ...runtimeSSRProps,\n        params: match.params,\n        searchParams: currentSearchParams,\n    };\n\n    // Create a wrapped component that includes all layouts\n    const WrappedPage = () => {\n        let content = <Page {...pageProps} />;\n        // Wrap page with layouts (from outer to inner)\n        for (let i = match.route.layouts.length - 1; i >= 0; i--) {\n            const Layout = match.route.layouts[i];\n            content = <Layout>{content}</Layout>;\n        }\n        return content;\n    };\n\n    const finalContent = AppShell ? (\n        <AppShell Component={WrappedPage} pageProps={pageProps}>\n            <WrappedPage />\n        </AppShell>\n    ) : (\n        <WrappedPage />\n    );\n\n    return <RouterContext.Provider value={routerValue}>{finalContent}</RouterContext.Provider>;\n}\n\ntype ClientSocialMeta = {\n    title: string;\n    description?: string;\n    image?: string;\n    canonicalUrl?: string;\n    siteName?: string;\n    type?: string;\n    robots?: string;\n    twitterCard?: \"summary\" | \"summary_large_image\" | \"app\" | \"player\";\n    twitterSite?: string;\n    twitterCreator?: string;\n};\n\nfunction applyRouteMetadata(meta: ClientSocialMeta | null) {\n    if (typeof document === \"undefined\") {\n        return;\n    }\n\n    removeExistingSeoTags();\n\n    if (!meta) {\n        return;\n    }\n\n    document.title = meta.title;\n\n    const entries: Array<{ tag: \"meta\" | \"link\"; attrs: Record<string, string> }> = [];\n\n    entries.push({ tag: \"meta\", attrs: { property: \"og:title\", content: meta.title } });\n    entries.push({ tag: \"meta\", attrs: { property: \"og:type\", content: meta.type ?? \"website\" } });\n    entries.push({ tag: \"meta\", attrs: { name: \"twitter:card\", content: meta.twitterCard ?? \"summary_large_image\" } });\n    entries.push({ tag: \"meta\", attrs: { name: \"twitter:title\", content: meta.title } });\n\n    if (meta.description) {\n        entries.push({ tag: \"meta\", attrs: { name: \"description\", content: meta.description } });\n        entries.push({ tag: \"meta\", attrs: { property: \"og:description\", content: meta.description } });\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:description\", content: meta.description } });\n    }\n\n    if (meta.image) {\n        entries.push({ tag: \"meta\", attrs: { property: \"og:image\", content: meta.image } });\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:image\", content: meta.image } });\n    }\n\n    if (meta.canonicalUrl) {\n        entries.push({ tag: \"meta\", attrs: { property: \"og:url\", content: meta.canonicalUrl } });\n        entries.push({ tag: \"link\", attrs: { rel: \"canonical\", href: meta.canonicalUrl } });\n    }\n\n    if (meta.siteName) {\n        entries.push({ tag: \"meta\", attrs: { property: \"og:site_name\", content: meta.siteName } });\n    }\n\n    if (meta.robots) {\n        entries.push({ tag: \"meta\", attrs: { name: \"robots\", content: meta.robots } });\n    }\n\n    if (meta.twitterSite) {\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:site\", content: meta.twitterSite } });\n    }\n\n    if (meta.twitterCreator) {\n        entries.push({ tag: \"meta\", attrs: { name: \"twitter:creator\", content: meta.twitterCreator } });\n    }\n\n    for (const entry of entries) {\n        const node = document.createElement(entry.tag);\n        for (const [key, value] of Object.entries(entry.attrs)) {\n            node.setAttribute(key, value);\n        }\n        node.setAttribute(\"data-helium-seo\", \"true\");\n        document.head.appendChild(node);\n    }\n}\n\nfunction removeExistingSeoTags() {\n    const headNodes = Array.from(document.head.querySelectorAll(\"meta, link\"));\n\n    for (const node of headNodes) {\n        if (node.getAttribute(\"data-helium-seo\") === \"true\") {\n            node.remove();\n            continue;\n        }\n\n        if (node.tagName.toLowerCase() === \"link\") {\n            const rel = (node.getAttribute(\"rel\") || \"\").toLowerCase();\n            if (rel === \"canonical\") {\n                node.remove();\n            }\n            continue;\n        }\n\n        const name = (node.getAttribute(\"name\") || \"\").toLowerCase();\n        const property = (node.getAttribute(\"property\") || \"\").toLowerCase();\n\n        if (name === \"description\" || name === \"robots\" || name.startsWith(\"twitter:\")) {\n            node.remove();\n            continue;\n        }\n\n        if (property.startsWith(\"og:\")) {\n            node.remove();\n        }\n    }\n}\n"]}

package/dist/server/config.d.ts

@@ -60,9 +60,29 @@ export interface HeliumRpcSecurityConfig {
  * Security configuration for HTTP responses.
  */
 export interface HeliumSecurityConfig {
+    /**
+     * Apply Helium's built-in default security headers.
+     *
+     * When set to `false`, Helium will not set default security headers,
+     * allowing full manual control via `headerOverrides` and your own server logic.
+     *
+     * @default true
+     */
+    defaultHeaders?: boolean;
+    /**
+     * Header overrides applied after Helium's default security headers.
+     *
+     * - Set a header value to override (or add) that header.
+     * - Set a header value to `null` to remove that header.
+     *
+     * This is useful for custom framing policies, custom permissions policy,
+     * or disabling a specific default header.
+     */
+    headerOverrides?: Record<string, string | null>;
     /**
      * Content-Security-Policy header value.
      * Set to a CSP string to enable, or omit to skip CSP.
+     * Applied when `defaultHeaders` is enabled.
      *
      * @default undefined (no CSP header)
      */
@@ -70,6 +90,7 @@ export interface HeliumSecurityConfig {
     /**
      * Enable Strict-Transport-Security header.
      * Set to false to disable HSTS.
+     * Applied when `defaultHeaders` is enabled.
      *
      * @default true
      */

package/dist/server/config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;OAKG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAEhC;;;;;OAKG;IACH,GAAG,CAAC,EAAE;QACF;;;;;;;;;;;;;;;;;;WAkBG;QACH,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;QAE1C;;;;;;;;;WASG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAE3B;;;;;WAKG;QACH,WAAW,CAAC,EAAE,uBAAuB,CAAC;QAEtC;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;QAEnC;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;;;;WAKG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB;;;;;WAKG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACL;AAgBD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CASjG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAOjG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB;;;;;;EAQrD;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,YAAiB,GAAG,wBAAwB,CAMtF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,SAE/B"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"AAIA;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;;OAKG;IACH,OAAO,CAAC,EAAE,OAAO,CAAC;IAElB;;;;;;OAMG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;CACtB;AAED;;;GAGG;AACH,MAAM,WAAW,uBAAuB;IACpC;;;;;;OAMG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAE7B;;;;;;OAMG;IACH,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAE9B;;;;;OAKG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAE3B;;;;;;OAMG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACjC;;;;;;;OAOG;IACH,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB;;;;;;;;OAQG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC;IAEhD;;;;;;OAMG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAE/B;;;;;;OAMG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;IAEf;;;;;;OAMG;IACH,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CAC1B;AAED;;;;;GAKG;AACH,MAAM,WAAW,YAAY;IACzB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,eAAe,CAAC,EAAE,MAAM,CAAC;IAEzB;;;OAGG;IACH,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IAEhC;;;;;OAKG;IACH,GAAG,CAAC,EAAE;QACF;;;;;;;;;;;;;;;;;;WAkBG;QACH,SAAS,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;QAE1C;;;;;;;;;WASG;QACH,gBAAgB,CAAC,EAAE,OAAO,CAAC;QAE3B;;;;;WAKG;QACH,WAAW,CAAC,EAAE,uBAAuB,CAAC;QAEtC;;;;;WAKG;QACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;QAEnC;;;;;WAKG;QACH,WAAW,CAAC,EAAE,MAAM,CAAC;QAErB;;;;;WAKG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;QAEtB;;;;;WAKG;QACH,YAAY,CAAC,EAAE,MAAM,CAAC;KACzB,CAAC;CACL;AAgBD;;;;;;;;;GASG;AACH,wBAAsB,UAAU,CAAC,IAAI,GAAE,MAAsB,GAAG,OAAO,CAAC,YAAY,CAAC,CAuCpF;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,YAAiB,GAAG,MAAM,CAEpE;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CASjG;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,GAAE,YAAiB,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAOjG;AAED;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,MAAM,GAAE,YAAiB;;;;;;EAQrD;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAwB;IACrC,SAAS,EAAE,MAAM,GAAG,WAAW,GAAG,MAAM,CAAC;IACzC,gBAAgB,EAAE,OAAO,CAAC;IAC1B,eAAe,EAAE,MAAM,CAAC;CAC3B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,GAAE,YAAiB,GAAG,wBAAwB,CAMtF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,SAE/B"}

package/dist/server/config.js.map

@@ -1 +1 @@
-{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport { pathToFileURL } from \"url\";\n\n/**\n * WebSocket per-message compression configuration.\n * Uses the permessage-deflate extension to compress messages on the wire.\n */\nexport interface HeliumCompressionConfig {\n    /**\n     * Enable WebSocket per-message compression (permessage-deflate extension).\n     * When enabled, messages are compressed before sending to reduce bandwidth usage.\n     *\n     * @default true\n     */\n    enabled?: boolean;\n\n    /**\n     * Minimum message size in bytes to apply compression.\n     * Messages smaller than this threshold will not be compressed to avoid overhead.\n     * Only applies when compression is enabled.\n     *\n     * @default 1024 (1KB)\n     */\n    threshold?: number;\n}\n\n/**\n * RPC security and rate limiting configuration.\n * Controls WebSocket connection limits, message rate limits, and token-based authentication.\n */\nexport interface HeliumRpcSecurityConfig {\n    /**\n     * Maximum number of concurrent WebSocket connections allowed per IP address.\n     * Helps prevent a single client from exhausting connection resources.\n     * Set to 0 to disable this limit.\n     *\n     * @default 10\n     */\n    maxConnectionsPerIP?: number;\n\n    /**\n     * Maximum number of RPC messages allowed per connection within the time window.\n     * Helps prevent abuse by limiting message throughput per connection.\n     * Set to 0 to disable rate limiting.\n     *\n     * @default 100\n     */\n    maxMessagesPerWindow?: number;\n\n    /**\n     * Time window in milliseconds for rate limiting.\n     * Rate limits reset after this duration.\n     *\n     * @default 60000 (1 minute)\n     */\n    rateLimitWindowMs?: number;\n\n    /**\n     * WebSocket connection token validity duration in milliseconds.\n     * Tokens are generated server-side and must be used within this timeframe.\n     * Shorter durations improve security but may cause issues with slow networks.\n     *\n     * @default 30000 (30 seconds)\n     */\n    tokenValidityMs?: number;\n}\n\n/**\n * Security configuration for HTTP responses.\n */\nexport interface HeliumSecurityConfig {\n    /**\n     * Content-Security-Policy header value.\n     * Set to a CSP string to enable, or omit to skip CSP.\n     *\n     * @default undefined (no CSP header)\n     */\n    contentSecurityPolicy?: string;\n\n    /**\n     * Enable Strict-Transport-Security header.\n     * Set to false to disable HSTS.\n     *\n     * @default true\n     */\n    hsts?: boolean;\n\n    /**\n     * Allowed CORS origins.\n     * Set to [\"*\"] to allow all origins, or provide specific origins.\n     * Empty array or omit to restrict to same-origin only (default, most secure).\n     *\n     * @default [] (same-origin only)\n     */\n    corsOrigins?: string[];\n}\n\n/**\n * Helium framework configuration.\n *\n * Configure your Helium application behavior including RPC transport settings,\n * compression, security, and proxy configuration for production deployments.\n */\nexport interface HeliumConfig {\n    /**\n     * Number of proxy levels to trust when extracting client IP addresses.\n     *\n     * This setting is crucial for deployments behind reverse proxies, load balancers,\n     * or CDNs (like Vercel, Cloudflare, AWS ALB, etc.). It determines how the framework\n     * extracts the real client IP from headers like X-Forwarded-For.\n     *\n     * **How it works:**\n     * When behind proxies, the X-Forwarded-For header contains a chain of IPs:\n     * `X-Forwarded-For: <client-ip>, <proxy1-ip>, <proxy2-ip>`\n     *\n     * This setting tells Helium how many proxy IPs to skip from the right to find the real client IP.\n     *\n     * **Values:**\n     * - `0`: Don't trust any proxies, use direct connection IP (default, most secure)\n     * - `1`: Trust 1 proxy level (recommended for most platforms: Vercel, Netlify, Railway)\n     * - `2+`: Trust multiple proxy levels (for complex setups like Cloudflare → Load Balancer → Your Server)\n     *\n     * **Common configurations:**\n     * - Local development: `0`\n     * - Vercel/Netlify/Railway: `1`\n     * - Cloudflare → Your server: `1` or `2`\n     * - AWS ALB → EC2: `1`\n     * - Nginx → Node.js: `1`\n     * - Cloudflare → AWS ALB → EC2: `2`\n     *\n     * **Security note:** Setting this too high can allow IP spoofing. Only trust as many\n     * proxy levels as you actually have in your infrastructure.\n     *\n     * This setting applies to both HTTP requests and WebSocket connections.\n     *\n     * @default 0\n     */\n    trustProxyDepth?: number;\n\n    /**\n     * HTTP response security configuration.\n     * Controls CORS, CSP, HSTS, and other security headers.\n     */\n    security?: HeliumSecurityConfig;\n\n    /**\n     * RPC transport configuration.\n     *\n     * Configure the WebSocket-based RPC layer including compression\n     * and security settings.\n     */\n    rpc?: {\n        /**\n         * Client-side transport mode for RPC calls.\n         *\n         * - `\"websocket\"` (default): Uses persistent WebSocket connection\n         *   - ✅ Lower latency for subsequent calls (connection reuse)\n         *   - ✅ Real-time bidirectional communication ready\n         *   - ⚠️ Higher initial connection overhead\n         *\n         * - `\"http\"`: Uses HTTP POST requests for each RPC call\n         *   - ✅ Better performance on mobile/cellular networks (HTTP/2 optimizations)\n         *   - ✅ No connection state to maintain\n         *   - ⚠️ Slightly higher per-request overhead on fast networks\n         *\n         * - `\"auto\"`: Automatically selects based on network conditions\n         *   - Uses HTTP on cellular/slow networks when `autoHttpOnMobile` is true\n         *   - Uses WebSocket on fast networks (WiFi, wired)\n         *\n         * @default \"websocket\"\n         */\n        transport?: \"http\" | \"websocket\" | \"auto\";\n\n        /**\n         * Automatically switch to HTTP transport on mobile/cellular networks.\n         *\n         * When enabled and `transport` is `\"auto\"`, the client will use HTTP\n         * instead of WebSocket on cellular connections (4G/LTE, 5G) and slow\n         * connections (2G, 3G). This improves performance on mobile networks\n         * where HTTP/2 is more efficient due to carrier network optimizations.\n         *\n         * @default false\n         */\n        autoHttpOnMobile?: boolean;\n\n        /**\n         * WebSocket per-message compression configuration.\n         *\n         * Enable and configure the permessage-deflate extension to compress\n         * messages on the wire, reducing bandwidth usage.\n         */\n        compression?: HeliumCompressionConfig;\n\n        /**\n         * RPC security and rate limiting configuration.\n         *\n         * Configure connection limits, message rate limits, and token validity\n         * to protect your RPC endpoints from abuse.\n         */\n        security?: HeliumRpcSecurityConfig;\n\n        /**\n         * Maximum HTTP request body size in bytes.\n         * Requests exceeding this limit receive a 413 status.\n         *\n         * @default 1048576 (1 MB)\n         */\n        maxBodySize?: number;\n\n        /**\n         * Maximum number of RPC calls in a single batch request.\n         * Batches exceeding this limit are rejected.\n         *\n         * @default 20\n         */\n        maxBatchSize?: number;\n\n        /**\n         * Maximum WebSocket message payload size in bytes.\n         * Messages exceeding this limit cause the connection to be closed.\n         *\n         * @default 1048576 (1 MB)\n         */\n        maxWsPayload?: number;\n    };\n}\n\nconst DEFAULT_RPC_SECURITY: Required<HeliumRpcSecurityConfig> = {\n    maxConnectionsPerIP: 10,\n    maxMessagesPerWindow: 100,\n    rateLimitWindowMs: 60000,\n    tokenValidityMs: 30000,\n};\n\nconst DEFAULT_COMPRESSION: Required<HeliumCompressionConfig> = {\n    enabled: true,\n    threshold: 1024,\n};\n\nlet cachedConfig: HeliumConfig | null = null;\n\n/**\n * Load Helium configuration from the project root.\n * Searches for helium.config.js, helium.config.mjs, or helium.config.ts.\n * Results are cached for the lifetime of the process.\n *\n * In production, the build process automatically transpiles .ts config files\n * to .js in the dist directory. The loader checks dist/ first when available.\n *\n * @internal - Used by framework internals only\n */\nexport async function loadConfig(root: string = process.cwd()): Promise<HeliumConfig> {\n    if (cachedConfig) {\n        return cachedConfig;\n    }\n\n    // Check if there's a custom config directory (used in production)\n    const configDir = process.env.HELIUM_CONFIG_DIR || root;\n\n    // Prioritize .js/.mjs (work in both dev and production)\n    // .ts files work in dev with Vite but fail in production without transpilation\n    const configFiles = [\"helium.config.js\", \"helium.config.mjs\", \"helium.config.ts\"];\n\n    // In production with HELIUM_CONFIG_DIR set, check dist directory first\n    const searchPaths = configDir !== root ? [configDir, root] : [root];\n\n    for (const searchPath of searchPaths) {\n        for (const configFile of configFiles) {\n            const configPath = path.join(searchPath, configFile);\n            if (fs.existsSync(configPath)) {\n                try {\n                    const fileUrl = pathToFileURL(configPath).href;\n                    const module = await import(/* @vite-ignore */ `${fileUrl}?t=${Date.now()}`);\n                    const config = module.default || {};\n                    cachedConfig = config;\n                    return config;\n                } catch (err) {\n                    // In production, .ts files will fail to load without a TypeScript loader\n                    if (configFile.endsWith(\".ts\") && err instanceof Error && \"code\" in err && err.code === \"ERR_UNKNOWN_FILE_EXTENSION\") {\n                        console.warn(`[Helium] Cannot load ${configFile} in production. The build process should have transpiled it.`);\n                    } else {\n                        console.warn(`[Helium] Failed to load config from ${configFile}:`, err);\n                    }\n                }\n            }\n        }\n    }\n\n    cachedConfig = {};\n    return cachedConfig;\n}\n\n/**\n * Get the proxy trust depth from config.\n * Used for extracting client IPs from X-Forwarded-For headers.\n *\n * @internal - Used by framework internals only\n */\nexport function getTrustProxyDepth(config: HeliumConfig = {}): number {\n    return config.trustProxyDepth ?? 0;\n}\n\n/**\n * Get RPC security configuration with defaults applied.\n * Returns rate limiting, connection limits, and token settings.\n *\n * @internal - Used by framework internals only\n */\nexport function getRpcSecurityConfig(config: HeliumConfig = {}): Required<HeliumRpcSecurityConfig> {\n    const src = config.rpc?.security;\n\n    return {\n        maxConnectionsPerIP: src?.maxConnectionsPerIP ?? DEFAULT_RPC_SECURITY.maxConnectionsPerIP,\n        maxMessagesPerWindow: src?.maxMessagesPerWindow ?? DEFAULT_RPC_SECURITY.maxMessagesPerWindow,\n        rateLimitWindowMs: src?.rateLimitWindowMs ?? DEFAULT_RPC_SECURITY.rateLimitWindowMs,\n        tokenValidityMs: src?.tokenValidityMs ?? DEFAULT_RPC_SECURITY.tokenValidityMs,\n    };\n}\n\n/**\n * Get WebSocket compression configuration with defaults applied.\n *\n * @internal - Used by framework internals only\n */\nexport function getCompressionConfig(config: HeliumConfig = {}): Required<HeliumCompressionConfig> {\n    const src = config.rpc?.compression;\n\n    return {\n        enabled: src?.enabled ?? DEFAULT_COMPRESSION.enabled,\n        threshold: src?.threshold ?? DEFAULT_COMPRESSION.threshold,\n    };\n}\n\n/**\n * Get complete RPC configuration including compression, and security.\n *\n * @internal - Used by framework internals only\n */\nexport function getRpcConfig(config: HeliumConfig = {}) {\n    return {\n        compression: getCompressionConfig(config),\n        security: getRpcSecurityConfig(config),\n        maxBodySize: config.rpc?.maxBodySize ?? 1_048_576,\n        maxBatchSize: config.rpc?.maxBatchSize ?? 20,\n        maxWsPayload: config.rpc?.maxWsPayload ?? 1_048_576,\n    };\n}\n\n/**\n * Client-side RPC transport configuration.\n * This is injected into the client bundle at build time.\n */\nexport interface RpcClientTransportConfig {\n    transport: \"http\" | \"websocket\" | \"auto\";\n    autoHttpOnMobile: boolean;\n    tokenValidityMs: number;\n}\n\n/**\n * Get client-side RPC transport configuration.\n * This configuration is injected into the client bundle via Vite defines.\n *\n * @internal - Used by framework internals only\n */\nexport function getRpcClientConfig(config: HeliumConfig = {}): RpcClientTransportConfig {\n    return {\n        transport: config.rpc?.transport ?? \"websocket\",\n        autoHttpOnMobile: config.rpc?.autoHttpOnMobile ?? false,\n        tokenValidityMs: getRpcSecurityConfig(config).tokenValidityMs,\n    };\n}\n\n/**\n * Clear the cached configuration.\n * Useful for testing or when you need to reload config.\n *\n * @internal - Used by framework internals only\n */\nexport function clearConfigCache() {\n    cachedConfig = null;\n}\n"]}
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../../src/server/config.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from \"fs\";\nimport path from \"path\";\nimport { pathToFileURL } from \"url\";\n\n/**\n * WebSocket per-message compression configuration.\n * Uses the permessage-deflate extension to compress messages on the wire.\n */\nexport interface HeliumCompressionConfig {\n    /**\n     * Enable WebSocket per-message compression (permessage-deflate extension).\n     * When enabled, messages are compressed before sending to reduce bandwidth usage.\n     *\n     * @default true\n     */\n    enabled?: boolean;\n\n    /**\n     * Minimum message size in bytes to apply compression.\n     * Messages smaller than this threshold will not be compressed to avoid overhead.\n     * Only applies when compression is enabled.\n     *\n     * @default 1024 (1KB)\n     */\n    threshold?: number;\n}\n\n/**\n * RPC security and rate limiting configuration.\n * Controls WebSocket connection limits, message rate limits, and token-based authentication.\n */\nexport interface HeliumRpcSecurityConfig {\n    /**\n     * Maximum number of concurrent WebSocket connections allowed per IP address.\n     * Helps prevent a single client from exhausting connection resources.\n     * Set to 0 to disable this limit.\n     *\n     * @default 10\n     */\n    maxConnectionsPerIP?: number;\n\n    /**\n     * Maximum number of RPC messages allowed per connection within the time window.\n     * Helps prevent abuse by limiting message throughput per connection.\n     * Set to 0 to disable rate limiting.\n     *\n     * @default 100\n     */\n    maxMessagesPerWindow?: number;\n\n    /**\n     * Time window in milliseconds for rate limiting.\n     * Rate limits reset after this duration.\n     *\n     * @default 60000 (1 minute)\n     */\n    rateLimitWindowMs?: number;\n\n    /**\n     * WebSocket connection token validity duration in milliseconds.\n     * Tokens are generated server-side and must be used within this timeframe.\n     * Shorter durations improve security but may cause issues with slow networks.\n     *\n     * @default 30000 (30 seconds)\n     */\n    tokenValidityMs?: number;\n}\n\n/**\n * Security configuration for HTTP responses.\n */\nexport interface HeliumSecurityConfig {\n    /**\n     * Apply Helium's built-in default security headers.\n     *\n     * When set to `false`, Helium will not set default security headers,\n     * allowing full manual control via `headerOverrides` and your own server logic.\n     *\n     * @default true\n     */\n    defaultHeaders?: boolean;\n\n    /**\n     * Header overrides applied after Helium's default security headers.\n     *\n     * - Set a header value to override (or add) that header.\n     * - Set a header value to `null` to remove that header.\n     *\n     * This is useful for custom framing policies, custom permissions policy,\n     * or disabling a specific default header.\n     */\n    headerOverrides?: Record<string, string | null>;\n\n    /**\n     * Content-Security-Policy header value.\n     * Set to a CSP string to enable, or omit to skip CSP.\n     * Applied when `defaultHeaders` is enabled.\n     *\n     * @default undefined (no CSP header)\n     */\n    contentSecurityPolicy?: string;\n\n    /**\n     * Enable Strict-Transport-Security header.\n     * Set to false to disable HSTS.\n     * Applied when `defaultHeaders` is enabled.\n     *\n     * @default true\n     */\n    hsts?: boolean;\n\n    /**\n     * Allowed CORS origins.\n     * Set to [\"*\"] to allow all origins, or provide specific origins.\n     * Empty array or omit to restrict to same-origin only (default, most secure).\n     *\n     * @default [] (same-origin only)\n     */\n    corsOrigins?: string[];\n}\n\n/**\n * Helium framework configuration.\n *\n * Configure your Helium application behavior including RPC transport settings,\n * compression, security, and proxy configuration for production deployments.\n */\nexport interface HeliumConfig {\n    /**\n     * Number of proxy levels to trust when extracting client IP addresses.\n     *\n     * This setting is crucial for deployments behind reverse proxies, load balancers,\n     * or CDNs (like Vercel, Cloudflare, AWS ALB, etc.). It determines how the framework\n     * extracts the real client IP from headers like X-Forwarded-For.\n     *\n     * **How it works:**\n     * When behind proxies, the X-Forwarded-For header contains a chain of IPs:\n     * `X-Forwarded-For: <client-ip>, <proxy1-ip>, <proxy2-ip>`\n     *\n     * This setting tells Helium how many proxy IPs to skip from the right to find the real client IP.\n     *\n     * **Values:**\n     * - `0`: Don't trust any proxies, use direct connection IP (default, most secure)\n     * - `1`: Trust 1 proxy level (recommended for most platforms: Vercel, Netlify, Railway)\n     * - `2+`: Trust multiple proxy levels (for complex setups like Cloudflare → Load Balancer → Your Server)\n     *\n     * **Common configurations:**\n     * - Local development: `0`\n     * - Vercel/Netlify/Railway: `1`\n     * - Cloudflare → Your server: `1` or `2`\n     * - AWS ALB → EC2: `1`\n     * - Nginx → Node.js: `1`\n     * - Cloudflare → AWS ALB → EC2: `2`\n     *\n     * **Security note:** Setting this too high can allow IP spoofing. Only trust as many\n     * proxy levels as you actually have in your infrastructure.\n     *\n     * This setting applies to both HTTP requests and WebSocket connections.\n     *\n     * @default 0\n     */\n    trustProxyDepth?: number;\n\n    /**\n     * HTTP response security configuration.\n     * Controls CORS, CSP, HSTS, and other security headers.\n     */\n    security?: HeliumSecurityConfig;\n\n    /**\n     * RPC transport configuration.\n     *\n     * Configure the WebSocket-based RPC layer including compression\n     * and security settings.\n     */\n    rpc?: {\n        /**\n         * Client-side transport mode for RPC calls.\n         *\n         * - `\"websocket\"` (default): Uses persistent WebSocket connection\n         *   - ✅ Lower latency for subsequent calls (connection reuse)\n         *   - ✅ Real-time bidirectional communication ready\n         *   - ⚠️ Higher initial connection overhead\n         *\n         * - `\"http\"`: Uses HTTP POST requests for each RPC call\n         *   - ✅ Better performance on mobile/cellular networks (HTTP/2 optimizations)\n         *   - ✅ No connection state to maintain\n         *   - ⚠️ Slightly higher per-request overhead on fast networks\n         *\n         * - `\"auto\"`: Automatically selects based on network conditions\n         *   - Uses HTTP on cellular/slow networks when `autoHttpOnMobile` is true\n         *   - Uses WebSocket on fast networks (WiFi, wired)\n         *\n         * @default \"websocket\"\n         */\n        transport?: \"http\" | \"websocket\" | \"auto\";\n\n        /**\n         * Automatically switch to HTTP transport on mobile/cellular networks.\n         *\n         * When enabled and `transport` is `\"auto\"`, the client will use HTTP\n         * instead of WebSocket on cellular connections (4G/LTE, 5G) and slow\n         * connections (2G, 3G). This improves performance on mobile networks\n         * where HTTP/2 is more efficient due to carrier network optimizations.\n         *\n         * @default false\n         */\n        autoHttpOnMobile?: boolean;\n\n        /**\n         * WebSocket per-message compression configuration.\n         *\n         * Enable and configure the permessage-deflate extension to compress\n         * messages on the wire, reducing bandwidth usage.\n         */\n        compression?: HeliumCompressionConfig;\n\n        /**\n         * RPC security and rate limiting configuration.\n         *\n         * Configure connection limits, message rate limits, and token validity\n         * to protect your RPC endpoints from abuse.\n         */\n        security?: HeliumRpcSecurityConfig;\n\n        /**\n         * Maximum HTTP request body size in bytes.\n         * Requests exceeding this limit receive a 413 status.\n         *\n         * @default 1048576 (1 MB)\n         */\n        maxBodySize?: number;\n\n        /**\n         * Maximum number of RPC calls in a single batch request.\n         * Batches exceeding this limit are rejected.\n         *\n         * @default 20\n         */\n        maxBatchSize?: number;\n\n        /**\n         * Maximum WebSocket message payload size in bytes.\n         * Messages exceeding this limit cause the connection to be closed.\n         *\n         * @default 1048576 (1 MB)\n         */\n        maxWsPayload?: number;\n    };\n}\n\nconst DEFAULT_RPC_SECURITY: Required<HeliumRpcSecurityConfig> = {\n    maxConnectionsPerIP: 10,\n    maxMessagesPerWindow: 100,\n    rateLimitWindowMs: 60000,\n    tokenValidityMs: 30000,\n};\n\nconst DEFAULT_COMPRESSION: Required<HeliumCompressionConfig> = {\n    enabled: true,\n    threshold: 1024,\n};\n\nlet cachedConfig: HeliumConfig | null = null;\n\n/**\n * Load Helium configuration from the project root.\n * Searches for helium.config.js, helium.config.mjs, or helium.config.ts.\n * Results are cached for the lifetime of the process.\n *\n * In production, the build process automatically transpiles .ts config files\n * to .js in the dist directory. The loader checks dist/ first when available.\n *\n * @internal - Used by framework internals only\n */\nexport async function loadConfig(root: string = process.cwd()): Promise<HeliumConfig> {\n    if (cachedConfig) {\n        return cachedConfig;\n    }\n\n    // Check if there's a custom config directory (used in production)\n    const configDir = process.env.HELIUM_CONFIG_DIR || root;\n\n    // Prioritize .js/.mjs (work in both dev and production)\n    // .ts files work in dev with Vite but fail in production without transpilation\n    const configFiles = [\"helium.config.js\", \"helium.config.mjs\", \"helium.config.ts\"];\n\n    // In production with HELIUM_CONFIG_DIR set, check dist directory first\n    const searchPaths = configDir !== root ? [configDir, root] : [root];\n\n    for (const searchPath of searchPaths) {\n        for (const configFile of configFiles) {\n            const configPath = path.join(searchPath, configFile);\n            if (fs.existsSync(configPath)) {\n                try {\n                    const fileUrl = pathToFileURL(configPath).href;\n                    const module = await import(/* @vite-ignore */ `${fileUrl}?t=${Date.now()}`);\n                    const config = module.default || {};\n                    cachedConfig = config;\n                    return config;\n                } catch (err) {\n                    // In production, .ts files will fail to load without a TypeScript loader\n                    if (configFile.endsWith(\".ts\") && err instanceof Error && \"code\" in err && err.code === \"ERR_UNKNOWN_FILE_EXTENSION\") {\n                        console.warn(`[Helium] Cannot load ${configFile} in production. The build process should have transpiled it.`);\n                    } else {\n                        console.warn(`[Helium] Failed to load config from ${configFile}:`, err);\n                    }\n                }\n            }\n        }\n    }\n\n    cachedConfig = {};\n    return cachedConfig;\n}\n\n/**\n * Get the proxy trust depth from config.\n * Used for extracting client IPs from X-Forwarded-For headers.\n *\n * @internal - Used by framework internals only\n */\nexport function getTrustProxyDepth(config: HeliumConfig = {}): number {\n    return config.trustProxyDepth ?? 0;\n}\n\n/**\n * Get RPC security configuration with defaults applied.\n * Returns rate limiting, connection limits, and token settings.\n *\n * @internal - Used by framework internals only\n */\nexport function getRpcSecurityConfig(config: HeliumConfig = {}): Required<HeliumRpcSecurityConfig> {\n    const src = config.rpc?.security;\n\n    return {\n        maxConnectionsPerIP: src?.maxConnectionsPerIP ?? DEFAULT_RPC_SECURITY.maxConnectionsPerIP,\n        maxMessagesPerWindow: src?.maxMessagesPerWindow ?? DEFAULT_RPC_SECURITY.maxMessagesPerWindow,\n        rateLimitWindowMs: src?.rateLimitWindowMs ?? DEFAULT_RPC_SECURITY.rateLimitWindowMs,\n        tokenValidityMs: src?.tokenValidityMs ?? DEFAULT_RPC_SECURITY.tokenValidityMs,\n    };\n}\n\n/**\n * Get WebSocket compression configuration with defaults applied.\n *\n * @internal - Used by framework internals only\n */\nexport function getCompressionConfig(config: HeliumConfig = {}): Required<HeliumCompressionConfig> {\n    const src = config.rpc?.compression;\n\n    return {\n        enabled: src?.enabled ?? DEFAULT_COMPRESSION.enabled,\n        threshold: src?.threshold ?? DEFAULT_COMPRESSION.threshold,\n    };\n}\n\n/**\n * Get complete RPC configuration including compression, and security.\n *\n * @internal - Used by framework internals only\n */\nexport function getRpcConfig(config: HeliumConfig = {}) {\n    return {\n        compression: getCompressionConfig(config),\n        security: getRpcSecurityConfig(config),\n        maxBodySize: config.rpc?.maxBodySize ?? 1_048_576,\n        maxBatchSize: config.rpc?.maxBatchSize ?? 20,\n        maxWsPayload: config.rpc?.maxWsPayload ?? 1_048_576,\n    };\n}\n\n/**\n * Client-side RPC transport configuration.\n * This is injected into the client bundle at build time.\n */\nexport interface RpcClientTransportConfig {\n    transport: \"http\" | \"websocket\" | \"auto\";\n    autoHttpOnMobile: boolean;\n    tokenValidityMs: number;\n}\n\n/**\n * Get client-side RPC transport configuration.\n * This configuration is injected into the client bundle via Vite defines.\n *\n * @internal - Used by framework internals only\n */\nexport function getRpcClientConfig(config: HeliumConfig = {}): RpcClientTransportConfig {\n    return {\n        transport: config.rpc?.transport ?? \"websocket\",\n        autoHttpOnMobile: config.rpc?.autoHttpOnMobile ?? false,\n        tokenValidityMs: getRpcSecurityConfig(config).tokenValidityMs,\n    };\n}\n\n/**\n * Clear the cached configuration.\n * Useful for testing or when you need to reload config.\n *\n * @internal - Used by framework internals only\n */\nexport function clearConfigCache() {\n    cachedConfig = null;\n}\n"]}

package/dist/server/defineServerSideProps.d.ts

@@ -6,7 +6,17 @@ export interface ServerSidePropsRequest {
     query: Record<string, string>;
     params: Record<string, string | string[]>;
 }
-export type ServerSidePropsHandler = (req: ServerSidePropsRequest, ctx: HeliumContext) => Promise<Record<string, unknown> | null | undefined> | Record<string, unknown> | null | undefined;
+export interface ServerSideRedirect {
+    destination: string;
+    permanent?: boolean;
+    statusCode?: 301 | 302 | 303 | 307 | 308;
+    replace?: boolean;
+}
+export interface ServerSideRedirectResult {
+    redirect: ServerSideRedirect;
+}
+export type ServerSidePropsResult = Record<string, unknown> | ServerSideRedirectResult | null | undefined;
+export type ServerSidePropsHandler = (req: ServerSidePropsRequest, ctx: HeliumContext) => Promise<ServerSidePropsResult> | ServerSidePropsResult;
 /**
  * Type for convention-based page server props functions:
  *

package/dist/server/defineServerSideProps.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"defineServerSideProps.d.ts","sourceRoot":"","sources":["../../src/server/defineServerSideProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,sBAAsB,GAAG,CACjC,GAAG,EAAE,sBAAsB,EAC3B,GAAG,EAAE,aAAa,KACjB,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,IAAI,GAAG,SAAS,CAAC;AAEtG;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC"}
+{"version":3,"file":"defineServerSideProps.d.ts","sourceRoot":"","sources":["../../src/server/defineServerSideProps.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAElD,MAAM,WAAW,sBAAsB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC,CAAC;IACvD,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,EAAE,CAAC,CAAC;CAC7C;AAED,MAAM,WAAW,kBAAkB;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,UAAU,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACzC,OAAO,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,wBAAwB;IACrC,QAAQ,EAAE,kBAAkB,CAAC;CAChC;AAED,MAAM,MAAM,qBAAqB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,wBAAwB,GAAG,IAAI,GAAG,SAAS,CAAC;AAE1G,MAAM,MAAM,sBAAsB,GAAG,CAAC,GAAG,EAAE,sBAAsB,EAAE,GAAG,EAAE,aAAa,KAAK,OAAO,CAAC,qBAAqB,CAAC,GAAG,qBAAqB,CAAC;AAEjJ;;;;;;;;;;GAUG;AACH,MAAM,MAAM,kBAAkB,GAAG,sBAAsB,CAAC"}

package/dist/server/defineServerSideProps.js.map

@@ -1 +1 @@
-{"version":3,"file":"defineServerSideProps.js","sourceRoot":"","sources":["../../src/server/defineServerSideProps.ts"],"names":[],"mappings":"","sourcesContent":["import type { HeliumContext } from \"./context.js\";\n\nexport interface ServerSidePropsRequest {\n    method: string;\n    path: string;\n    headers: Record<string, string | string[] | undefined>;\n    query: Record<string, string>;\n    params: Record<string, string | string[]>;\n}\n\nexport type ServerSidePropsHandler = (\n    req: ServerSidePropsRequest,\n    ctx: HeliumContext\n) => Promise<Record<string, unknown> | null | undefined> | Record<string, unknown> | null | undefined;\n\n/**\n * Type for convention-based page server props functions:\n *\n * ```ts\n * import type { GetServerSideProps } from \"heliumts/server\";\n *\n * export const getServerSideProps: GetServerSideProps = async (req, ctx) => {\n *   return { user: await getUser(req) };\n * };\n * ```\n */\nexport type GetServerSideProps = ServerSidePropsHandler;\n"]}
+{"version":3,"file":"defineServerSideProps.js","sourceRoot":"","sources":["../../src/server/defineServerSideProps.ts"],"names":[],"mappings":"","sourcesContent":["import type { HeliumContext } from \"./context.js\";\n\nexport interface ServerSidePropsRequest {\n    method: string;\n    path: string;\n    headers: Record<string, string | string[] | undefined>;\n    query: Record<string, string>;\n    params: Record<string, string | string[]>;\n}\n\nexport interface ServerSideRedirect {\n    destination: string;\n    permanent?: boolean;\n    statusCode?: 301 | 302 | 303 | 307 | 308;\n    replace?: boolean;\n}\n\nexport interface ServerSideRedirectResult {\n    redirect: ServerSideRedirect;\n}\n\nexport type ServerSidePropsResult = Record<string, unknown> | ServerSideRedirectResult | null | undefined;\n\nexport type ServerSidePropsHandler = (req: ServerSidePropsRequest, ctx: HeliumContext) => Promise<ServerSidePropsResult> | ServerSidePropsResult;\n\n/**\n * Type for convention-based page server props functions:\n *\n * ```ts\n * import type { GetServerSideProps } from \"heliumts/server\";\n *\n * export const getServerSideProps: GetServerSideProps = async (req, ctx) => {\n *   return { user: await getUser(req) };\n * };\n * ```\n */\nexport type GetServerSideProps = ServerSidePropsHandler;\n"]}

package/dist/server/devServer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../../src/server/devServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAA6D,UAAU,EAAE,MAAM,UAAU,CAAC;AAMjG,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAC5G,KAAK,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC;AAE3F,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;CAC3B;AAED,KAAK,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC;IAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAY7K;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,cAAc,EAC5B,MAAM,GAAE,YAAiB,EACzB,OAAO,GAAE,WAAW,EAAO,EAC3B,QAAQ,GAAE,UAAU,EAAO,EAC3B,QAAQ,GAAE,cAAqB,QA6iBlC"}
+{"version":3,"file":"devServer.d.ts","sourceRoot":"","sources":["../../src/server/devServer.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,IAAI,MAAM,MAAM,CAAC;AAC7B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAC/B,OAAO,KAAK,KAAK,MAAM,OAAO,CAAC;AAE/B,OAAO,KAAK,EAAE,aAAa,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAUtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAGhD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEzD,OAAO,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAG7C,OAAO,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAE/C,OAAO,EAAE,iBAAiB,EAAE,MAAM,wBAAwB,CAAC;AAE3D,OAAO,EAAuD,UAAU,EAAE,MAAM,UAAU,CAAC;AAM3F,KAAK,cAAc,GAAG,CAAC,QAAQ,EAAE,WAAW,EAAE,UAAU,EAAE,UAAU,EAAE,SAAS,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAC5G,KAAK,UAAU,GAAG,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,WAAW,GAAG,KAAK,CAAC,iBAAiB,CAAC;AAE3F,UAAU,WAAW;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,eAAe,CAAC;CAC3B;AAED,KAAK,cAAc,GAAG,CAAC,MAAM,OAAO,CAAC,aAAa,CAAC;IAAE,SAAS,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAAC,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,QAAQ,CAAC,EAAE,SAAS,CAAA;CAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;AAY7K;;;GAGG;AACH,wBAAgB,iBAAiB,CAC7B,UAAU,EAAE,UAAU,EACtB,YAAY,EAAE,cAAc,EAC5B,MAAM,GAAE,YAAiB,EACzB,OAAO,GAAE,WAAW,EAAO,EAC3B,QAAQ,GAAE,UAAU,EAAO,EAC3B,QAAQ,GAAE,cAAqB,QA8lBlC"}

package/dist/server/devServer.js

@@ -16,7 +16,7 @@ import { RpcRegistry } from "./rpcRegistry.js";
 import { initializeSecurity, verifyConnectionToken } from "./security.js";
 import { SEOMetadataRouter } from "./seoMetadataRouter.js";
 import { prepareForMsgpack } from "./serializer.js";
-import { createServerSidePropsRequest, matchSSRPage, renderSSRHTML } from "./ssr.js";
+import { matchSSRPage, renderSSRHTML, resolveServerSideProps } from "./ssr.js";
 const gzipAsync = promisify(gzip);
 const deflateAsync = promisify(deflate);
 const brotliCompressAsync = promisify(brotliCompress);
@@ -280,13 +280,20 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
                 },
             };
             try {
-                let result = {};
-                if (ssrMatch.page.getServerSideProps) {
-                    const request = createServerSidePropsRequest(req, targetPathname, ssrMatch.params);
-                    result = (await ssrMatch.page.getServerSideProps(request, httpCtx)) ?? {};
+                const ssrResult = await resolveServerSideProps({
+                    req,
+                    pathname: targetPathname,
+                    params: ssrMatch.params,
+                    page: ssrMatch.page,
+                    ctx: httpCtx,
+                });
+                if (ssrResult.kind === "redirect") {
+                    res.writeHead(200, { "Content-Type": "application/json", "Cache-Control": "no-store" });
+                    res.end(JSON.stringify({ ssr: true, redirect: ssrResult.redirect }));
+                    return;
                 }
                 res.writeHead(200, { "Content-Type": "application/json", "Cache-Control": "no-store" });
-                res.end(JSON.stringify({ ssr: true, props: result ?? {} }));
+                res.end(JSON.stringify({ ssr: true, props: ssrResult.props }));
             }
             catch (error) {
                 log("error", "Failed to resolve SSR page props:", error);
@@ -428,6 +435,18 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
             const originalEnd = res.end.bind(res);
             const bufferedChunks = [];
             let capturedContentType = "";
+            let pendingWriteHead;
+            const flushPendingWriteHead = () => {
+                if (!pendingWriteHead) {
+                    return;
+                }
+                const { statusCode, statusMessageOrHeaders, headers } = pendingWriteHead;
+                if (typeof statusMessageOrHeaders === "string") {
+                    originalWriteHead(statusCode, statusMessageOrHeaders, headers);
+                    return;
+                }
+                originalWriteHead(statusCode, statusMessageOrHeaders);
+            };
             res.writeHead = (statusCode, statusMessageOrHeaders, headers) => {
                 const providedHeaders = typeof statusMessageOrHeaders === "string" ? headers : statusMessageOrHeaders;
                 if (providedHeaders) {
@@ -446,7 +465,12 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
                         }
                     }
                 }
-                return originalWriteHead(statusCode, statusMessageOrHeaders, headers);
+                pendingWriteHead = {
+                    statusCode,
+                    statusMessageOrHeaders,
+                    headers,
+                };
+                return res;
             };
             res.write = (chunk, encoding, callback) => {
                 if (chunk !== undefined && chunk !== null) {
@@ -479,6 +503,7 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
                     res.write = originalWrite;
                     res.end = originalEnd;
                     if (!(contentType.includes("text/html") || looksLikeHtml)) {
+                        flushPendingWriteHead();
                         originalEnd(bodyBuffer);
                         return;
                     }
@@ -505,6 +530,14 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
                                 ctx: httpCtx,
                                 loadAppShell: currentAppShell,
                             });
+                            if ("redirect" in rendered) {
+                                originalWriteHead(rendered.redirect.statusCode, {
+                                    Location: rendered.redirect.destination,
+                                    "Cache-Control": "no-store",
+                                });
+                                originalEnd();
+                                return;
+                            }
                             html = rendered.html;
                         }
                         catch (error) {
@@ -521,6 +554,7 @@ export function attachToDevServer(httpServer, loadHandlers, config = {}, workers
                     if (devResolvedMetadata) {
                         html = injectSocialMetaIntoHtml(html, devResolvedMetadata);
                     }
+                    flushPendingWriteHead();
                     originalEnd(Buffer.from(html, "utf-8"));
                 };
                 void finalize();