@nestjs-ssr/react 0.1.11 → 0.2.0

package/dist/index.mjs

@@ -2,10 +2,10 @@ import { Injectable, Logger, Optional, Inject, Global, Module, SetMetadata } fro
 import { HttpAdapterHost, APP_INTERCEPTOR, Reflector } from '@nestjs/core';
 import { existsSync, readFileSync } from 'fs';
 import { join, relative } from 'path';
-import serialize from 'serialize-javascript';
+import { uneval } from 'devalue';
 import escapeHtml from 'escape-html';
 import { renderToStaticMarkup } from 'react-dom/server';
-import { createElement, useContext, createContext } from 'react';
+import { createElement, createContext, useContext } from 'react';
 import { switchMap } from 'rxjs/operators';
 
 var __defProp = Object.defineProperty;
@@ -98,21 +98,20 @@ var TemplateParserService = class {
   /**
   * Build inline script that provides initial state to the client
   *
-  * Safely serializes data using serialize-javascript to avoid XSS vulnerabilities.
-  * This library handles all edge cases including escaping dangerous characters,
-  * functions, dates, regexes, and prevents prototype pollution.
+  * Safely serializes data using devalue to avoid XSS vulnerabilities.
+  * Devalue is designed specifically for SSR, handling complex types safely
+  * while being faster and more secure than alternatives.
   */
-  buildInlineScripts(data, context, componentName) {
+  buildInlineScripts(data, context, componentName, layouts) {
+    const layoutMetadata = layouts ? layouts.map((l) => ({
+      name: l.layout.displayName || l.layout.name || "default",
+      props: l.props
+    })) : [];
     return `<script>
-window.__INITIAL_STATE__ = ${serialize(data, {
-      isJSON: true
-    })};
-window.__CONTEXT__ = ${serialize(context, {
-      isJSON: true
-    })};
-window.__COMPONENT_NAME__ = ${serialize(componentName, {
-      isJSON: true
-    })};
+window.__INITIAL_STATE__ = ${uneval(data)};
+window.__CONTEXT__ = ${uneval(context)};
+window.__COMPONENT_NAME__ = ${uneval(componentName)};
+window.__LAYOUTS__ = ${uneval(layoutMetadata)};
 </script>`;
   }
   /**
@@ -421,12 +420,14 @@ var RenderService = class _RenderService {
   isDevelopment;
   ssrMode;
   entryServerPath;
-  constructor(templateParser, streamingErrorHandler, ssrMode, defaultHead) {
+  rootLayout = void 0;
+  rootLayoutChecked = false;
+  constructor(templateParser, streamingErrorHandler, ssrMode, defaultHead, customTemplate) {
     this.templateParser = templateParser;
     this.streamingErrorHandler = streamingErrorHandler;
     this.defaultHead = defaultHead;
     this.isDevelopment = process.env.NODE_ENV !== "production";
-    this.ssrMode = ssrMode || process.env.SSR_MODE || "string";
+    this.ssrMode = ssrMode || process.env.SSR_MODE || "stream";
     const absoluteServerPath = join(__dirname, "/templates/entry-server.tsx");
     const relativeServerPath = relative(process.cwd(), absoluteServerPath);
     if (relativeServerPath.startsWith("..")) {
@@ -434,36 +435,54 @@ var RenderService = class _RenderService {
     } else {
       this.entryServerPath = "/" + relativeServerPath.replace(/\\/g, "/");
     }
-    let templatePath;
-    if (this.isDevelopment) {
-      const packageTemplatePaths = [
-        join(__dirname, "../templates/index.html"),
-        join(__dirname, "../src/templates/index.html"),
-        join(__dirname, "../../src/templates/index.html")
-      ];
-      const localTemplatePath = join(process.cwd(), "src/views/index.html");
-      const foundPackageTemplate = packageTemplatePaths.find((p) => existsSync(p));
-      if (foundPackageTemplate) {
-        templatePath = foundPackageTemplate;
-      } else if (existsSync(localTemplatePath)) {
-        templatePath = localTemplatePath;
+    if (customTemplate) {
+      if (customTemplate.includes("<!DOCTYPE") || customTemplate.includes("<html")) {
+        this.template = customTemplate;
+        this.logger.log(`\u2713 Loaded custom template (inline)`);
       } else {
-        throw new Error(`Template file not found. Tried:
+        const customTemplatePath = customTemplate.startsWith("/") ? customTemplate : join(process.cwd(), customTemplate);
+        if (!existsSync(customTemplatePath)) {
+          throw new Error(`Custom template file not found at ${customTemplatePath}`);
+        }
+        try {
+          this.template = readFileSync(customTemplatePath, "utf-8");
+          this.logger.log(`\u2713 Loaded custom template from ${customTemplatePath}`);
+        } catch (error) {
+          throw new Error(`Failed to read custom template file at ${customTemplatePath}: ${error.message}`);
+        }
+      }
+    } else {
+      let templatePath;
+      if (this.isDevelopment) {
+        const packageTemplatePaths = [
+          join(__dirname, "../templates/index.html"),
+          join(__dirname, "../src/templates/index.html"),
+          join(__dirname, "../../src/templates/index.html")
+        ];
+        const localTemplatePath = join(process.cwd(), "src/views/index.html");
+        const foundPackageTemplate = packageTemplatePaths.find((p) => existsSync(p));
+        if (foundPackageTemplate) {
+          templatePath = foundPackageTemplate;
+        } else if (existsSync(localTemplatePath)) {
+          templatePath = localTemplatePath;
+        } else {
+          throw new Error(`Template file not found. Tried:
 ` + packageTemplatePaths.map((p) => `  - ${p} (package template)`).join("\n") + `
   - ${localTemplatePath} (local template)`);
+        }
+      } else {
+        templatePath = join(process.cwd(), "dist/client/index.html");
+        if (!existsSync(templatePath)) {
+          throw new Error(`Template file not found at ${templatePath}. Make sure to run the build process first.`);
+        }
       }
-    } else {
-      templatePath = join(process.cwd(), "dist/client/index.html");
-      if (!existsSync(templatePath)) {
-        throw new Error(`Template file not found at ${templatePath}. Make sure to run the build process first.`);
+      try {
+        this.template = readFileSync(templatePath, "utf-8");
+        this.logger.log(`\u2713 Loaded template from ${templatePath}`);
+      } catch (error) {
+        throw new Error(`Failed to read template file at ${templatePath}: ${error.message}`);
       }
     }
-    try {
-      this.template = readFileSync(templatePath, "utf-8");
-      this.logger.log(`\u2713 Loaded template from ${templatePath}`);
-    } catch (error) {
-      throw new Error(`Failed to read template file at ${templatePath}: ${error.message}`);
-    }
     if (!this.isDevelopment) {
       const manifestPath = join(process.cwd(), "dist/client/.vite/manifest.json");
       if (existsSync(manifestPath)) {
@@ -483,6 +502,52 @@ var RenderService = class _RenderService {
     this.vite = vite;
   }
   /**
+  * Get the root layout component if it exists
+  * Auto-discovers layout files at conventional paths:
+  * - src/views/layout.tsx
+  * - src/views/layout/index.tsx
+  * - src/views/_layout.tsx
+  */
+  async getRootLayout() {
+    if (this.rootLayoutChecked) {
+      return this.rootLayout;
+    }
+    this.rootLayoutChecked = true;
+    const conventionalPaths = [
+      "src/views/layout.tsx",
+      "src/views/layout/index.tsx",
+      "src/views/_layout.tsx"
+    ];
+    try {
+      for (const path of conventionalPaths) {
+        const absolutePath = join(process.cwd(), path);
+        if (!existsSync(absolutePath)) {
+          continue;
+        }
+        this.logger.log(`\u2713 Found root layout at ${path}`);
+        if (this.vite) {
+          const layoutModule = await this.vite.ssrLoadModule("/" + path);
+          this.rootLayout = layoutModule.default;
+          return this.rootLayout;
+        } else {
+          const prodPath = path.replace("src/views", "dist/server/views").replace(".tsx", ".js");
+          const absoluteProdPath = join(process.cwd(), prodPath);
+          if (existsSync(absoluteProdPath)) {
+            const layoutModule = await import(absoluteProdPath);
+            this.rootLayout = layoutModule.default;
+            return this.rootLayout;
+          }
+        }
+      }
+      this.rootLayout = null;
+      return null;
+    } catch (error) {
+      this.logger.warn(`\u26A0\uFE0F  Error loading root layout: ${error.message}`);
+      this.rootLayout = null;
+      return null;
+    }
+  }
+  /**
   * Main render method that routes to string or stream mode
   */
   async render(viewComponent, data = {}, res, head) {
@@ -544,20 +609,19 @@ var RenderService = class _RenderService {
           throw new Error("Server bundle not found in manifest. Run `pnpm build:server` to generate the server bundle.");
         }
       }
-      const { data: pageData, __context: context } = data;
+      const { data: pageData, __context: context, __layouts: layouts } = data;
       const appHtml = await renderModule.renderComponent(viewComponent, data);
       const componentName = viewComponent.displayName || viewComponent.name || "Component";
+      const layoutMetadata = layouts ? layouts.map((l) => ({
+        name: l.layout.displayName || l.layout.name || "default",
+        props: l.props
+      })) : [];
       const initialStateScript = `
         <script>
-          window.__INITIAL_STATE__ = ${serialize(pageData, {
-        isJSON: true
-      })};
-          window.__CONTEXT__ = ${serialize(context, {
-        isJSON: true
-      })};
-          window.__COMPONENT_NAME__ = ${serialize(componentName, {
-        isJSON: true
-      })};
+          window.__INITIAL_STATE__ = ${uneval(pageData)};
+          window.__CONTEXT__ = ${uneval(context)};
+          window.__COMPONENT_NAME__ = ${uneval(componentName)};
+          window.__LAYOUTS__ = ${uneval(layoutMetadata)};
         </script>
       `;
       let clientScript = "";
@@ -630,9 +694,9 @@ var RenderService = class _RenderService {
           throw new Error("Server bundle not found in manifest. Run `pnpm build:server` to generate the server bundle.");
         }
       }
-      const { data: pageData, __context: context } = data;
+      const { data: pageData, __context: context, __layouts: layouts } = data;
       const componentName = viewComponent.displayName || viewComponent.name || "Component";
-      const inlineScripts = this.templateParser.buildInlineScripts(pageData, context, componentName);
+      const inlineScripts = this.templateParser.buildInlineScripts(pageData, context, componentName, layouts);
       const clientScript = this.templateParser.getClientScriptTag(this.isDevelopment, this.manifest);
       const stylesheetTags = this.templateParser.getStylesheetTags(this.isDevelopment, this.manifest);
       const headTags = this.templateParser.buildHeadTags(head);
@@ -688,22 +752,38 @@ RenderService = _ts_decorate3([
   _ts_param2(2, Inject("SSR_MODE")),
   _ts_param2(3, Optional()),
   _ts_param2(3, Inject("DEFAULT_HEAD")),
+  _ts_param2(4, Optional()),
+  _ts_param2(4, Inject("CUSTOM_TEMPLATE")),
   _ts_metadata2("design:type", Function),
   _ts_metadata2("design:paramtypes", [
     typeof TemplateParserService === "undefined" ? Object : TemplateParserService,
     typeof StreamingErrorHandler === "undefined" ? Object : StreamingErrorHandler,
     typeof SSRMode === "undefined" ? Object : SSRMode,
-    typeof HeadData === "undefined" ? Object : HeadData
+    typeof HeadData === "undefined" ? Object : HeadData,
+    String
   ])
 ], RenderService);
 var RENDER_KEY = "render";
-function Render(component) {
+var RENDER_OPTIONS_KEY = "render_options";
+function Render(component, options) {
   return (target, propertyKey, descriptor) => {
     SetMetadata(RENDER_KEY, component)(target, propertyKey, descriptor);
+    if (options) {
+      SetMetadata(RENDER_OPTIONS_KEY, options)(target, propertyKey, descriptor);
+    }
   };
 }
 __name(Render, "Render");
-var ReactRender = Render;
+var LAYOUT_KEY = "layout";
+function Layout(layout, options) {
+  return (target) => {
+    SetMetadata(LAYOUT_KEY, {
+      layout,
+      options
+    })(target);
+  };
+}
+__name(Layout, "Layout");
 
 // src/render/render.interceptor.ts
 function _ts_decorate4(decorators, target, key, desc) {
@@ -717,6 +797,12 @@ function _ts_metadata3(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata3, "_ts_metadata");
+function _ts_param3(paramIndex, decorator) {
+  return function(target, key) {
+    decorator(target, key, paramIndex);
+  };
+}
+__name(_ts_param3, "_ts_param");
 function isRenderResponse(data) {
   return data && typeof data === "object" && "props" in data;
 }
@@ -727,9 +813,60 @@ var RenderInterceptor = class {
   }
   reflector;
   renderService;
-  constructor(reflector, renderService) {
+  allowedHeaders;
+  allowedCookies;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies) {
     this.reflector = reflector;
     this.renderService = renderService;
+    this.allowedHeaders = allowedHeaders;
+    this.allowedCookies = allowedCookies;
+  }
+  /**
+  * Resolve the layout hierarchy for a given route
+  * Hierarchy: Root Layout → Controller Layout → Method Layout → Page
+  *
+  * Props are merged in priority order:
+  * 1. Static props from @Layout decorator (base)
+  * 2. Static props from @Render decorator (override)
+  * 3. Dynamic props from controller return (final override)
+  */
+  async resolveLayoutChain(context, dynamicLayoutProps) {
+    const layouts = [];
+    const rootLayout = await this.renderService.getRootLayout();
+    if (rootLayout) {
+      layouts.push({
+        layout: rootLayout,
+        props: dynamicLayoutProps || {}
+      });
+    }
+    const controllerLayoutMeta = this.reflector.get(LAYOUT_KEY, context.getClass());
+    const renderOptions = this.reflector.get(RENDER_OPTIONS_KEY, context.getHandler());
+    if (renderOptions?.layout === null) {
+      return [];
+    } else if (renderOptions?.layout === false) {
+      return layouts;
+    }
+    if (controllerLayoutMeta) {
+      const mergedProps = {
+        ...controllerLayoutMeta.options?.props || {},
+        ...dynamicLayoutProps || {}
+      };
+      layouts.push({
+        layout: controllerLayoutMeta.layout,
+        props: mergedProps
+      });
+    }
+    if (renderOptions?.layout) {
+      const mergedProps = {
+        ...renderOptions.layoutProps || {},
+        ...dynamicLayoutProps || {}
+      };
+      layouts.push({
+        layout: renderOptions.layout,
+        props: mergedProps
+      });
+    }
+    return layouts;
   }
   intercept(context, next) {
     const viewPathOrComponent = this.reflector.get(RENDER_KEY, context.getHandler());
@@ -745,16 +882,36 @@ var RenderInterceptor = class {
         path: request.path,
         query: request.query,
         params: request.params,
-        userAgent: request.headers["user-agent"],
-        acceptLanguage: request.headers["accept-language"],
-        referer: request.headers.referer
+        method: request.method
       };
+      if (this.allowedHeaders?.length) {
+        for (const headerName of this.allowedHeaders) {
+          const value = request.headers[headerName.toLowerCase()];
+          if (value) {
+            renderContext[headerName] = Array.isArray(value) ? value.join(", ") : value;
+          }
+        }
+      }
+      if (this.allowedCookies?.length && request.cookies) {
+        const cookies = {};
+        for (const cookieName of this.allowedCookies) {
+          const value = request.cookies[cookieName];
+          if (value !== void 0) {
+            cookies[cookieName] = value;
+          }
+        }
+        if (Object.keys(cookies).length > 0) {
+          renderContext.cookies = cookies;
+        }
+      }
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
+      const layoutChain = await this.resolveLayoutChain(context, renderResponse.layoutProps);
       const fullData = {
         data: renderResponse.props,
-        __context: renderContext
+        __context: renderContext,
+        __layouts: layoutChain
       };
       try {
         const html = await this.renderService.render(viewPathOrComponent, fullData, response, renderResponse.head);
@@ -771,10 +928,16 @@ var RenderInterceptor = class {
 };
 RenderInterceptor = _ts_decorate4([
   Injectable(),
+  _ts_param3(2, Optional()),
+  _ts_param3(2, Inject("ALLOWED_HEADERS")),
+  _ts_param3(3, Optional()),
+  _ts_param3(3, Inject("ALLOWED_COOKIES")),
   _ts_metadata3("design:type", Function),
   _ts_metadata3("design:paramtypes", [
     typeof Reflector === "undefined" ? Object : Reflector,
-    typeof RenderService === "undefined" ? Object : RenderService
+    typeof RenderService === "undefined" ? Object : RenderService,
+    Array,
+    Array
   ])
 ], RenderInterceptor);
 function _ts_decorate5(decorators, target, key, desc) {
@@ -788,12 +951,12 @@ function _ts_metadata4(k, v) {
   if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
 }
 __name(_ts_metadata4, "_ts_metadata");
-function _ts_param3(paramIndex, decorator) {
+function _ts_param4(paramIndex, decorator) {
   return function(target, key) {
     decorator(target, key, paramIndex);
   };
 }
-__name(_ts_param3, "_ts_param");
+__name(_ts_param4, "_ts_param");
 var ViteInitializerService = class _ViteInitializerService {
   static {
     __name(this, "ViteInitializerService");
@@ -909,8 +1072,8 @@ var ViteInitializerService = class _ViteInitializerService {
 };
 ViteInitializerService = _ts_decorate5([
   Injectable(),
-  _ts_param3(2, Optional()),
-  _ts_param3(2, Inject("VITE_CONFIG")),
+  _ts_param4(2, Optional()),
+  _ts_param4(2, Inject("VITE_CONFIG")),
   _ts_metadata4("design:type", Function),
   _ts_metadata4("design:paramtypes", [
     typeof RenderService === "undefined" ? Object : RenderService,
@@ -1003,6 +1166,20 @@ var RenderModule = class _RenderModule {
         useValue: config.defaultHead
       });
     }
+    if (config?.template) {
+      providers.push({
+        provide: "CUSTOM_TEMPLATE",
+        useValue: config.template
+      });
+    }
+    providers.push({
+      provide: "ALLOWED_HEADERS",
+      useValue: config?.allowedHeaders || []
+    });
+    providers.push({
+      provide: "ALLOWED_COOKIES",
+      useValue: config?.allowedCookies || []
+    });
     return {
       global: true,
       module: _RenderModule,
@@ -1095,6 +1272,30 @@ var RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      // Custom template provider - reads from config
+      {
+        provide: "CUSTOM_TEMPLATE",
+        useFactory: /* @__PURE__ */ __name((config) => config?.template, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
+      },
+      // Allowed headers provider - reads from config
+      {
+        provide: "ALLOWED_HEADERS",
+        useFactory: /* @__PURE__ */ __name((config) => config?.allowedHeaders || [], "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
+      },
+      // Allowed cookies provider - reads from config
+      {
+        provide: "ALLOWED_COOKIES",
+        useFactory: /* @__PURE__ */ __name((config) => config?.allowedCookies || [], "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {
@@ -1131,25 +1332,198 @@ RenderModule = _ts_decorate6([
   })
 ], RenderModule);
 var PageContext = /* @__PURE__ */ createContext(null);
-function usePageContext() {
-  const context = useContext(PageContext);
-  if (!context) {
-    throw new Error("usePageContext must be used within PageContextProvider");
-  }
-  return context;
+function PageContextProvider({ context, children }) {
+  return /* @__PURE__ */ React.createElement(PageContext.Provider, {
+    value: context
+  }, children);
 }
-__name(usePageContext, "usePageContext");
-function useParams() {
-  return usePageContext().params;
-}
-__name(useParams, "useParams");
-function useQuery() {
-  return usePageContext().query;
-}
-__name(useQuery, "useQuery");
-function useUserAgent() {
-  return usePageContext().userAgent;
+__name(PageContextProvider, "PageContextProvider");
+function createSSRHooks() {
+  return {
+    /**
+    * Hook to access the full page context with your app's type.
+    * Contains URL metadata, headers, and any custom properties you've added.
+    */
+    usePageContext: /* @__PURE__ */ __name(() => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("usePageContext must be used within PageContextProvider");
+      }
+      return context;
+    }, "usePageContext"),
+    /**
+    * Hook to access route parameters.
+    *
+    * @example
+    * ```tsx
+    * // Route: /users/:id
+    * const params = useParams();
+    * console.log(params.id); // '123'
+    * ```
+    */
+    useParams: /* @__PURE__ */ __name(() => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("useParams must be used within PageContextProvider");
+      }
+      return context.params;
+    }, "useParams"),
+    /**
+    * Hook to access query string parameters.
+    *
+    * @example
+    * ```tsx
+    * // URL: /search?q=react&sort=date
+    * const query = useQuery();
+    * console.log(query.q);    // 'react'
+    * console.log(query.sort); // 'date'
+    * ```
+    */
+    useQuery: /* @__PURE__ */ __name(() => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("useQuery must be used within PageContextProvider");
+      }
+      return context.query;
+    }, "useQuery"),
+    /**
+    * Alias for usePageContext() with a more intuitive name.
+    * Returns the full request context with your app's type.
+    *
+    * @example
+    * ```tsx
+    * const request = useRequest();
+    * console.log(request.path);   // '/users/123'
+    * console.log(request.method); // 'GET'
+    * console.log(request.params); // { id: '123' }
+    * console.log(request.query);  // { search: 'foo' }
+    * ```
+    */
+    useRequest: /* @__PURE__ */ __name(() => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("useRequest must be used within PageContextProvider");
+      }
+      return context;
+    }, "useRequest"),
+    /**
+    * Hook to access headers configured via allowedHeaders.
+    * Returns all headers as a Record.
+    *
+    * Configure in module registration:
+    * ```typescript
+    * RenderModule.register({
+    *   allowedHeaders: ['user-agent', 'x-tenant-id', 'x-api-version']
+    * })
+    * ```
+    *
+    * @example
+    * ```tsx
+    * const headers = useHeaders();
+    * console.log(headers['user-agent']); // 'Mozilla/5.0...'
+    * console.log(headers['x-tenant-id']); // 'tenant-123'
+    * console.log(headers['x-api-version']); // 'v2'
+    * ```
+    */
+    useHeaders: /* @__PURE__ */ __name(() => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("useHeaders must be used within PageContextProvider");
+      }
+      const baseKeys = /* @__PURE__ */ new Set([
+        "url",
+        "path",
+        "query",
+        "params",
+        "method",
+        "cookies"
+      ]);
+      const headers = {};
+      for (const [key, value] of Object.entries(context)) {
+        if (!baseKeys.has(key) && typeof value === "string") {
+          headers[key] = value;
+        }
+      }
+      return headers;
+    }, "useHeaders"),
+    /**
+    * Hook to access a specific custom header by name.
+    * Returns undefined if the header is not configured or not present.
+    *
+    * @param name - The header name (as configured in allowedHeaders)
+    *
+    * @example
+    * ```tsx
+    * const tenantId = useHeader('x-tenant-id');
+    * if (tenantId) {
+    *   console.log(`Tenant: ${tenantId}`);
+    * }
+    * ```
+    */
+    useHeader: /* @__PURE__ */ __name((name) => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("useHeader must be used within PageContextProvider");
+      }
+      const value = context[name];
+      return typeof value === "string" ? value : void 0;
+    }, "useHeader"),
+    /**
+    * Hook to access cookies configured via allowedCookies.
+    * Returns all allowed cookies as a Record.
+    *
+    * Configure in module registration:
+    * ```typescript
+    * RenderModule.register({
+    *   allowedCookies: ['theme', 'locale', 'consent']
+    * })
+    * ```
+    *
+    * @example
+    * ```tsx
+    * const cookies = useCookies();
+    * console.log(cookies.theme);  // 'dark'
+    * console.log(cookies.locale); // 'en-US'
+    * ```
+    */
+    useCookies: /* @__PURE__ */ __name(() => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("useCookies must be used within PageContextProvider");
+      }
+      const cookies = context.cookies;
+      return typeof cookies === "object" && cookies !== null ? cookies : {};
+    }, "useCookies"),
+    /**
+    * Hook to access a specific cookie by name.
+    * Returns undefined if the cookie is not configured or not present.
+    *
+    * @param name - The cookie name (as configured in allowedCookies)
+    *
+    * @example
+    * ```tsx
+    * const theme = useCookie('theme');
+    * if (theme === 'dark') {
+    *   console.log('Dark mode enabled');
+    * }
+    * ```
+    */
+    useCookie: /* @__PURE__ */ __name((name) => {
+      const context = useContext(PageContext);
+      if (!context) {
+        throw new Error("useCookie must be used within PageContextProvider");
+      }
+      const contextObj = context;
+      const cookies = contextObj.cookies;
+      if (typeof cookies === "object" && cookies !== null && !Array.isArray(cookies)) {
+        const cookiesRecord = cookies;
+        const value = cookiesRecord[name];
+        return typeof value === "string" ? value : void 0;
+      }
+      return void 0;
+    }, "useCookie")
+  };
 }
-__name(useUserAgent, "useUserAgent");
+__name(createSSRHooks, "createSSRHooks");
 
-export { ErrorPageDevelopment, ErrorPageProduction, ReactRender, Render, RenderInterceptor, RenderModule, RenderService, StreamingErrorHandler, TemplateParserService, usePageContext, useParams, useQuery, useUserAgent };
+export { ErrorPageDevelopment, ErrorPageProduction, Layout, PageContextProvider, Render, RenderInterceptor, RenderModule, RenderService, StreamingErrorHandler, TemplateParserService, createSSRHooks };