@nestjs-ssr/react 0.3.4 → 0.3.6

package/dist/client.d.mts

@@ -1,7 +1,7 @@
-export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-CGT9woWe.mjs';
+export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-CVC9DHcL.mjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-export { R as RenderContext } from './render-response.interface-CxbuKGnV.mjs';
+export { R as RenderContext } from './render-response.interface-ClWJXKL4.mjs';
 
 /**
  * Provider component for navigation state.

package/dist/client.d.ts

@@ -1,7 +1,7 @@
-export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-05ODF4zW.js';
+export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, i as useCookie, h as useCookies, g as useHeader, f as useHeaders, u as usePageContext, b as useParams, d as useQuery, e as useRequest } from './use-page-context-DChgHhL9.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
-export { R as RenderContext } from './render-response.interface-CxbuKGnV.js';
+export { R as RenderContext } from './render-response.interface-ClWJXKL4.js';
 
 /**
  * Provider component for navigation state.

package/dist/client.js

@@ -28,11 +28,31 @@ function updatePageContext(context) {
   setPageContextState?.(context);
 }
 __name(updatePageContext, "updatePageContext");
+var segmentSetters = /* @__PURE__ */ new Set();
+function registerSegmentSetter(setter) {
+  segmentSetters.add(setter);
+}
+__name(registerSegmentSetter, "registerSegmentSetter");
+function unregisterSegmentSetter(setter) {
+  segmentSetters.delete(setter);
+}
+__name(unregisterSegmentSetter, "unregisterSegmentSetter");
+function broadcastToSegments(context) {
+  segmentSetters.forEach((setter) => setter(context));
+}
+__name(broadcastToSegments, "broadcastToSegments");
 function PageContextProvider({ context: initialContext, children, isSegment = false }) {
   const [context, setContext] = React2.useState(initialContext);
   React2.useEffect(() => {
     if (!isSegment) {
-      registerPageContextState(setContext);
+      registerPageContextState((newContext) => {
+        setContext(newContext);
+        broadcastToSegments(newContext);
+      });
+      return void 0;
+    } else {
+      registerSegmentSetter(setContext);
+      return () => unregisterSegmentSetter(setContext);
     }
   }, [
     isSegment
@@ -239,7 +259,7 @@ var useHeader = defaultHooks.useHeader;
 var useCookies = defaultHooks.useCookies;
 var useCookie = defaultHooks.useCookie;
 var rootRegistry = /* @__PURE__ */ new WeakMap();
-function hydrateSegment(outlet, componentName, props) {
+function hydrateSegment(outlet, componentName, props, layouts) {
   const modules = window.__MODULES__;
   if (!modules) {
     console.warn("[navigation] Module registry not available for segment hydration. Make sure entry-client.tsx exports window.__MODULES__.");
@@ -254,10 +274,11 @@ function hydrateSegment(outlet, componentName, props) {
     return;
   }
   const context = window.__CONTEXT__ || {};
+  const composedElement = composeWithLayouts(ViewComponent, props, layouts || [], context, modules);
   const element = /* @__PURE__ */ React2__default.default.createElement(PageContextProvider, {
     context,
     isSegment: true
-  }, /* @__PURE__ */ React2__default.default.createElement(ViewComponent, props));
+  }, composedElement);
   let wrapper = outlet.querySelector("[data-segment-root]");
   if (wrapper) {
     const existingRoot = rootRegistry.get(wrapper);
@@ -275,6 +296,27 @@ function hydrateSegment(outlet, componentName, props) {
   rootRegistry.set(wrapper, root);
 }
 __name(hydrateSegment, "hydrateSegment");
+function composeWithLayouts(ViewComponent, props, layouts, context, modules) {
+  let result = /* @__PURE__ */ React2__default.default.createElement(ViewComponent, props);
+  for (let i = layouts.length - 1; i >= 0; i--) {
+    const { name: layoutName, props: layoutProps } = layouts[i];
+    const Layout = resolveComponent(layoutName, modules);
+    if (!Layout) {
+      console.warn(`[navigation] Layout "${layoutName}" not found for hydration`);
+      continue;
+    }
+    result = /* @__PURE__ */ React2__default.default.createElement("div", {
+      "data-layout": layoutName
+    }, /* @__PURE__ */ React2__default.default.createElement(Layout, {
+      context,
+      layoutProps
+    }, /* @__PURE__ */ React2__default.default.createElement("div", {
+      "data-outlet": layoutName
+    }, result)));
+  }
+  return result;
+}
+__name(composeWithLayouts, "composeWithLayouts");
 function resolveComponent(name, modules) {
   const componentMap = Object.entries(modules).filter(([path, module]) => {
     const filename = path.split("/").pop();
@@ -342,8 +384,12 @@ async function navigate(url, options = {}) {
       return;
     }
     const outlet = await swapContent(response.html, response.swapTarget);
+    if (response.context) {
+      updatePageContext(response.context);
+      window.__CONTEXT__ = response.context;
+    }
     if (outlet) {
-      hydrateSegment(outlet, response.componentName, response.props);
+      hydrateSegment(outlet, response.componentName, response.props, response.layouts);
     }
     if (replace) {
       history.replaceState({
@@ -354,10 +400,6 @@ async function navigate(url, options = {}) {
         url
       }, "", url);
     }
-    if (response.context) {
-      updatePageContext(response.context);
-      window.__CONTEXT__ = response.context;
-    }
     if (response.head) {
       updateHead(response.head);
     }

package/dist/client.mjs

@@ -22,11 +22,31 @@ function updatePageContext(context) {
   setPageContextState?.(context);
 }
 __name(updatePageContext, "updatePageContext");
+var segmentSetters = /* @__PURE__ */ new Set();
+function registerSegmentSetter(setter) {
+  segmentSetters.add(setter);
+}
+__name(registerSegmentSetter, "registerSegmentSetter");
+function unregisterSegmentSetter(setter) {
+  segmentSetters.delete(setter);
+}
+__name(unregisterSegmentSetter, "unregisterSegmentSetter");
+function broadcastToSegments(context) {
+  segmentSetters.forEach((setter) => setter(context));
+}
+__name(broadcastToSegments, "broadcastToSegments");
 function PageContextProvider({ context: initialContext, children, isSegment = false }) {
   const [context, setContext] = useState(initialContext);
   useEffect(() => {
     if (!isSegment) {
-      registerPageContextState(setContext);
+      registerPageContextState((newContext) => {
+        setContext(newContext);
+        broadcastToSegments(newContext);
+      });
+      return void 0;
+    } else {
+      registerSegmentSetter(setContext);
+      return () => unregisterSegmentSetter(setContext);
     }
   }, [
     isSegment
@@ -233,7 +253,7 @@ var useHeader = defaultHooks.useHeader;
 var useCookies = defaultHooks.useCookies;
 var useCookie = defaultHooks.useCookie;
 var rootRegistry = /* @__PURE__ */ new WeakMap();
-function hydrateSegment(outlet, componentName, props) {
+function hydrateSegment(outlet, componentName, props, layouts) {
   const modules = window.__MODULES__;
   if (!modules) {
     console.warn("[navigation] Module registry not available for segment hydration. Make sure entry-client.tsx exports window.__MODULES__.");
@@ -248,10 +268,11 @@ function hydrateSegment(outlet, componentName, props) {
     return;
   }
   const context = window.__CONTEXT__ || {};
+  const composedElement = composeWithLayouts(ViewComponent, props, layouts || [], context, modules);
   const element = /* @__PURE__ */ React2.createElement(PageContextProvider, {
     context,
     isSegment: true
-  }, /* @__PURE__ */ React2.createElement(ViewComponent, props));
+  }, composedElement);
   let wrapper = outlet.querySelector("[data-segment-root]");
   if (wrapper) {
     const existingRoot = rootRegistry.get(wrapper);
@@ -269,6 +290,27 @@ function hydrateSegment(outlet, componentName, props) {
   rootRegistry.set(wrapper, root);
 }
 __name(hydrateSegment, "hydrateSegment");
+function composeWithLayouts(ViewComponent, props, layouts, context, modules) {
+  let result = /* @__PURE__ */ React2.createElement(ViewComponent, props);
+  for (let i = layouts.length - 1; i >= 0; i--) {
+    const { name: layoutName, props: layoutProps } = layouts[i];
+    const Layout = resolveComponent(layoutName, modules);
+    if (!Layout) {
+      console.warn(`[navigation] Layout "${layoutName}" not found for hydration`);
+      continue;
+    }
+    result = /* @__PURE__ */ React2.createElement("div", {
+      "data-layout": layoutName
+    }, /* @__PURE__ */ React2.createElement(Layout, {
+      context,
+      layoutProps
+    }, /* @__PURE__ */ React2.createElement("div", {
+      "data-outlet": layoutName
+    }, result)));
+  }
+  return result;
+}
+__name(composeWithLayouts, "composeWithLayouts");
 function resolveComponent(name, modules) {
   const componentMap = Object.entries(modules).filter(([path, module]) => {
     const filename = path.split("/").pop();
@@ -336,8 +378,12 @@ async function navigate(url, options = {}) {
       return;
     }
     const outlet = await swapContent(response.html, response.swapTarget);
+    if (response.context) {
+      updatePageContext(response.context);
+      window.__CONTEXT__ = response.context;
+    }
     if (outlet) {
-      hydrateSegment(outlet, response.componentName, response.props);
+      hydrateSegment(outlet, response.componentName, response.props, response.layouts);
     }
     if (replace) {
       history.replaceState({
@@ -348,10 +394,6 @@ async function navigate(url, options = {}) {
         url
       }, "", url);
     }
-    if (response.context) {
-      updatePageContext(response.context);
-      window.__CONTEXT__ = response.context;
-    }
     if (response.head) {
       updateHead(response.head);
     }

package/dist/{index-BzOLOiIZ.d.ts → index-CSvZfKpi.d.ts}

@@ -1,12 +1,113 @@
 import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
 import { ComponentType } from 'react';
-import { H as HeadData, R as RenderContext } from './render-response.interface-CxbuKGnV.js';
+import { H as HeadData, R as RenderContext } from './render-response.interface-ClWJXKL4.js';
+import { ServerResponse } from 'http';
 import { ViteDevServer } from 'vite';
-import { Response } from 'express';
 import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/**
+ * Common HTTP request interface that works with both Express and Fastify.
+ * This represents the minimal interface needed for SSR context building.
+ */
+interface SSRRequest {
+    /** Full request URL including query string */
+    url: string;
+    /** HTTP method (GET, POST, etc.) */
+    method: string;
+    /** Request headers */
+    headers: Record<string, string | string[] | undefined>;
+    /** URL path (Express: path, Fastify: routeOptions.url or url without query) */
+    path?: string;
+    /** Parsed query parameters */
+    query?: Record<string, string | string[] | undefined>;
+    /** Route parameters */
+    params?: Record<string, string>;
+    /** Parsed cookies (requires cookie-parser middleware) */
+    cookies?: Record<string, string>;
+    /**
+     * User object populated by authentication middleware (e.g., Passport).
+     * Type is `unknown` since the shape depends on your auth strategy.
+     */
+    user?: unknown;
+    /** Allow any additional properties for framework-specific extensions */
+    [key: string]: unknown;
+}
+/**
+ * Minimal interface for the raw Node.js response.
+ * This is a subset of ServerResponse that we actually use for streaming SSR.
+ */
+interface RawServerResponse {
+    statusCode: number;
+    headersSent: boolean;
+    writableEnded: boolean;
+    setHeader(name: string, value: string | number | readonly string[]): void;
+    write(chunk: string | Buffer): boolean;
+    end(data?: string | Buffer): void;
+    on?(event: string, listener: (...args: any[]) => void): this;
+}
+/**
+ * Common HTTP response interface that works with both Express and Fastify.
+ * For streaming SSR, we access the raw Node.js ServerResponse.
+ */
+interface SSRResponse {
+    /** HTTP status code (optional - Fastify has it on raw) */
+    statusCode?: number;
+    /** Whether headers have been sent (Express) */
+    headersSent?: boolean;
+    /** Whether headers have been sent (Fastify uses 'sent') */
+    sent?: boolean;
+    /** Whether the response stream has ended */
+    writableEnded?: boolean;
+    /** Set a response header */
+    setHeader?(name: string, value: string | number | readonly string[]): void;
+    /** Write data to the response */
+    write?(chunk: string | Buffer): boolean;
+    /** End the response */
+    end?(data?: string | Buffer): void;
+    /** Event listener for 'close' event */
+    on?(event: string, listener: (...args: any[]) => void): this;
+    /** Raw Node.js response (Fastify) - uses minimal interface for easier testing */
+    raw?: RawServerResponse | ServerResponse;
+    /** Allow additional properties */
+    [key: string]: unknown;
+}
+
+/**
+ * Custom context properties that can be added via context factory.
+ * Allows any properties to be merged into RenderContext.
+ */
+type CustomContextProperties = Record<string, unknown>;
+/**
+ * Context factory function signature
+ * Called for each request to build custom context properties
+ *
+ * @param params - Object containing the HTTP request (Express or Fastify)
+ * @returns Custom context properties to merge into RenderContext (sync or async)
+ *
+ * @example
+ * ```typescript
+ * // Simple: pass user from Passport
+ * context: ({ req }) => ({ user: req.user })
+ *
+ * // With CLS
+ * context: ({ req }) => ({
+ *   user: req.user,
+ *   tenant: cls.get('tenant'),
+ * })
+ *
+ * // Async with services
+ * context: async ({ req }) => ({
+ *   user: req.user,
+ *   permissions: await permissionService.getForUser(req.user),
+ * })
+ * ```
+ */
+type ContextFactory<TRequest extends SSRRequest = SSRRequest> = (params: {
+    /** HTTP request object (Express Request or Fastify FastifyRequest) */
+    req: TRequest;
+}) => CustomContextProperties | Promise<CustomContextProperties>;
 /**
  * SSR rendering mode configuration
  */
@@ -173,6 +274,52 @@ interface RenderConfig {
      * ```
      */
     allowedCookies?: string[];
+    /**
+     * Context factory function to enrich RenderContext with custom properties
+     *
+     * This is called for each request and the result is merged into the base
+     * RenderContext (url, path, query, params, method, headers, cookies).
+     *
+     * Use this to add user data, feature flags, tenant info, or any other
+     * request-scoped data that should be available in React components via usePageContext().
+     *
+     * Similar to @nestjs/graphql context option - you choose how to get the data:
+     * - From request object (req.user from Passport)
+     * - From CLS (nestjs-cls)
+     * - From request-scoped services
+     *
+     * @example
+     * ```typescript
+     * // Simple: pass user from Passport JWT strategy
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *   }),
+     * })
+     *
+     * // With nestjs-cls
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *     tenant: cls.get('tenant'),
+     *     featureFlags: cls.get('featureFlags'),
+     *   }),
+     * })
+     *
+     * // Async with services (use forRootAsync)
+     * RenderModule.forRootAsync({
+     *   imports: [PermissionModule],
+     *   inject: [PermissionService],
+     *   useFactory: (permissionService: PermissionService) => ({
+     *     context: async ({ req }) => ({
+     *       user: req.user,
+     *       permissions: await permissionService.getForUser(req.user),
+     *     }),
+     *   }),
+     * })
+     * ```
+     */
+    context?: ContextFactory;
 }
 /**
  * Template parts for streaming SSR
@@ -206,6 +353,11 @@ interface SegmentResponse {
     componentName: string;
     /** Page context for updating hooks (path, params, query, etc.) */
     context?: RenderContext;
+    /** Layouts below the swap target that need to be composed on client */
+    layouts?: Array<{
+        name: string;
+        props?: any;
+    }>;
 }
 
 declare class RenderModule {
@@ -402,7 +554,7 @@ declare class StreamingErrorHandler {
      * Handle error that occurred before shell was ready
      * Can still set HTTP status code and send error page
      */
-    handleShellError(error: Error, res: Response, viewPath: string, isDevelopment: boolean): void;
+    handleShellError(error: Error, res: SSRResponse, viewPath: string, isDevelopment: boolean): void;
     /**
      * Handle error that occurred during streaming
      * Headers already sent, can only log the error
@@ -468,11 +620,11 @@ declare class StreamRenderer {
      *
      * @param viewComponent - The React component to render
      * @param data - Data to pass to the component
-     * @param res - Express response object (required for streaming)
+     * @param res - HTTP response object (Express or Fastify)
      * @param context - Render context with Vite and manifest info
      * @param head - Head data for SEO tags
      */
-    render(viewComponent: any, data: any, res: Response, context: StreamRenderContext, head?: HeadData): Promise<void>;
+    render(viewComponent: any, data: any, res: SSRResponse, context: StreamRenderContext, head?: HeadData): Promise<void>;
 }
 
 /**
@@ -537,7 +689,7 @@ declare class RenderService {
      * - Better TTFB, progressive rendering
      * - Requires response object
      */
-    render(viewComponent: any, data?: any, res?: Response, head?: HeadData): Promise<string | void>;
+    render(viewComponent: any, data?: any, res?: SSRResponse, head?: HeadData): Promise<string | void>;
     /**
      * Render a segment for client-side navigation.
      * Always uses string mode (streaming not supported for segments).
@@ -555,7 +707,8 @@ declare class RenderInterceptor implements NestInterceptor {
     private renderService;
     private allowedHeaders?;
     private allowedCookies?;
-    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined);
+    private contextFactory?;
+    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined);
     /**
      * Resolve the layout hierarchy for a given route
      * Hierarchy: Root Layout → Controller Layout → Method Layout → Page
@@ -606,4 +759,4 @@ declare function ErrorPageDevelopment({ error, viewPath, phase, }: ErrorPageDeve
  */
 declare function ErrorPageProduction(): react_jsx_runtime.JSX.Element;
 
-export { ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };
+export { type ContextFactory as C, ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };

package/dist/{index-DdE--mA2.d.mts → index-ZpkYrPcK.d.mts}

@@ -1,12 +1,113 @@
 import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
 import { ComponentType } from 'react';
-import { H as HeadData, R as RenderContext } from './render-response.interface-CxbuKGnV.mjs';
+import { H as HeadData, R as RenderContext } from './render-response.interface-ClWJXKL4.mjs';
+import { ServerResponse } from 'http';
 import { ViteDevServer } from 'vite';
-import { Response } from 'express';
 import { Reflector } from '@nestjs/core';
 import { Observable } from 'rxjs';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 
+/**
+ * Common HTTP request interface that works with both Express and Fastify.
+ * This represents the minimal interface needed for SSR context building.
+ */
+interface SSRRequest {
+    /** Full request URL including query string */
+    url: string;
+    /** HTTP method (GET, POST, etc.) */
+    method: string;
+    /** Request headers */
+    headers: Record<string, string | string[] | undefined>;
+    /** URL path (Express: path, Fastify: routeOptions.url or url without query) */
+    path?: string;
+    /** Parsed query parameters */
+    query?: Record<string, string | string[] | undefined>;
+    /** Route parameters */
+    params?: Record<string, string>;
+    /** Parsed cookies (requires cookie-parser middleware) */
+    cookies?: Record<string, string>;
+    /**
+     * User object populated by authentication middleware (e.g., Passport).
+     * Type is `unknown` since the shape depends on your auth strategy.
+     */
+    user?: unknown;
+    /** Allow any additional properties for framework-specific extensions */
+    [key: string]: unknown;
+}
+/**
+ * Minimal interface for the raw Node.js response.
+ * This is a subset of ServerResponse that we actually use for streaming SSR.
+ */
+interface RawServerResponse {
+    statusCode: number;
+    headersSent: boolean;
+    writableEnded: boolean;
+    setHeader(name: string, value: string | number | readonly string[]): void;
+    write(chunk: string | Buffer): boolean;
+    end(data?: string | Buffer): void;
+    on?(event: string, listener: (...args: any[]) => void): this;
+}
+/**
+ * Common HTTP response interface that works with both Express and Fastify.
+ * For streaming SSR, we access the raw Node.js ServerResponse.
+ */
+interface SSRResponse {
+    /** HTTP status code (optional - Fastify has it on raw) */
+    statusCode?: number;
+    /** Whether headers have been sent (Express) */
+    headersSent?: boolean;
+    /** Whether headers have been sent (Fastify uses 'sent') */
+    sent?: boolean;
+    /** Whether the response stream has ended */
+    writableEnded?: boolean;
+    /** Set a response header */
+    setHeader?(name: string, value: string | number | readonly string[]): void;
+    /** Write data to the response */
+    write?(chunk: string | Buffer): boolean;
+    /** End the response */
+    end?(data?: string | Buffer): void;
+    /** Event listener for 'close' event */
+    on?(event: string, listener: (...args: any[]) => void): this;
+    /** Raw Node.js response (Fastify) - uses minimal interface for easier testing */
+    raw?: RawServerResponse | ServerResponse;
+    /** Allow additional properties */
+    [key: string]: unknown;
+}
+
+/**
+ * Custom context properties that can be added via context factory.
+ * Allows any properties to be merged into RenderContext.
+ */
+type CustomContextProperties = Record<string, unknown>;
+/**
+ * Context factory function signature
+ * Called for each request to build custom context properties
+ *
+ * @param params - Object containing the HTTP request (Express or Fastify)
+ * @returns Custom context properties to merge into RenderContext (sync or async)
+ *
+ * @example
+ * ```typescript
+ * // Simple: pass user from Passport
+ * context: ({ req }) => ({ user: req.user })
+ *
+ * // With CLS
+ * context: ({ req }) => ({
+ *   user: req.user,
+ *   tenant: cls.get('tenant'),
+ * })
+ *
+ * // Async with services
+ * context: async ({ req }) => ({
+ *   user: req.user,
+ *   permissions: await permissionService.getForUser(req.user),
+ * })
+ * ```
+ */
+type ContextFactory<TRequest extends SSRRequest = SSRRequest> = (params: {
+    /** HTTP request object (Express Request or Fastify FastifyRequest) */
+    req: TRequest;
+}) => CustomContextProperties | Promise<CustomContextProperties>;
 /**
  * SSR rendering mode configuration
  */
@@ -173,6 +274,52 @@ interface RenderConfig {
      * ```
      */
     allowedCookies?: string[];
+    /**
+     * Context factory function to enrich RenderContext with custom properties
+     *
+     * This is called for each request and the result is merged into the base
+     * RenderContext (url, path, query, params, method, headers, cookies).
+     *
+     * Use this to add user data, feature flags, tenant info, or any other
+     * request-scoped data that should be available in React components via usePageContext().
+     *
+     * Similar to @nestjs/graphql context option - you choose how to get the data:
+     * - From request object (req.user from Passport)
+     * - From CLS (nestjs-cls)
+     * - From request-scoped services
+     *
+     * @example
+     * ```typescript
+     * // Simple: pass user from Passport JWT strategy
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *   }),
+     * })
+     *
+     * // With nestjs-cls
+     * RenderModule.forRoot({
+     *   context: ({ req }) => ({
+     *     user: req.user,
+     *     tenant: cls.get('tenant'),
+     *     featureFlags: cls.get('featureFlags'),
+     *   }),
+     * })
+     *
+     * // Async with services (use forRootAsync)
+     * RenderModule.forRootAsync({
+     *   imports: [PermissionModule],
+     *   inject: [PermissionService],
+     *   useFactory: (permissionService: PermissionService) => ({
+     *     context: async ({ req }) => ({
+     *       user: req.user,
+     *       permissions: await permissionService.getForUser(req.user),
+     *     }),
+     *   }),
+     * })
+     * ```
+     */
+    context?: ContextFactory;
 }
 /**
  * Template parts for streaming SSR
@@ -206,6 +353,11 @@ interface SegmentResponse {
     componentName: string;
     /** Page context for updating hooks (path, params, query, etc.) */
     context?: RenderContext;
+    /** Layouts below the swap target that need to be composed on client */
+    layouts?: Array<{
+        name: string;
+        props?: any;
+    }>;
 }
 
 declare class RenderModule {
@@ -402,7 +554,7 @@ declare class StreamingErrorHandler {
      * Handle error that occurred before shell was ready
      * Can still set HTTP status code and send error page
      */
-    handleShellError(error: Error, res: Response, viewPath: string, isDevelopment: boolean): void;
+    handleShellError(error: Error, res: SSRResponse, viewPath: string, isDevelopment: boolean): void;
     /**
      * Handle error that occurred during streaming
      * Headers already sent, can only log the error
@@ -468,11 +620,11 @@ declare class StreamRenderer {
      *
      * @param viewComponent - The React component to render
      * @param data - Data to pass to the component
-     * @param res - Express response object (required for streaming)
+     * @param res - HTTP response object (Express or Fastify)
      * @param context - Render context with Vite and manifest info
      * @param head - Head data for SEO tags
      */
-    render(viewComponent: any, data: any, res: Response, context: StreamRenderContext, head?: HeadData): Promise<void>;
+    render(viewComponent: any, data: any, res: SSRResponse, context: StreamRenderContext, head?: HeadData): Promise<void>;
 }
 
 /**
@@ -537,7 +689,7 @@ declare class RenderService {
      * - Better TTFB, progressive rendering
      * - Requires response object
      */
-    render(viewComponent: any, data?: any, res?: Response, head?: HeadData): Promise<string | void>;
+    render(viewComponent: any, data?: any, res?: SSRResponse, head?: HeadData): Promise<string | void>;
     /**
      * Render a segment for client-side navigation.
      * Always uses string mode (streaming not supported for segments).
@@ -555,7 +707,8 @@ declare class RenderInterceptor implements NestInterceptor {
     private renderService;
     private allowedHeaders?;
     private allowedCookies?;
-    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined);
+    private contextFactory?;
+    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined);
     /**
      * Resolve the layout hierarchy for a given route
      * Hierarchy: Root Layout → Controller Layout → Method Layout → Page
@@ -606,4 +759,4 @@ declare function ErrorPageDevelopment({ error, viewPath, phase, }: ErrorPageDeve
  */
 declare function ErrorPageProduction(): react_jsx_runtime.JSX.Element;
 
-export { ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };
+export { type ContextFactory as C, ErrorPageDevelopment as E, RenderModule as R, StreamingErrorHandler as S, TemplateParserService as T, RenderService as a, RenderInterceptor as b, type RenderConfig as c, type SSRMode as d, ErrorPageProduction as e };