@nestjs-ssr/react 0.3.4 → 0.3.6

package/dist/render/index.d.ts

@@ -1,9 +1,9 @@
-export { E as ErrorPageDevelopment, e as ErrorPageProduction, b as RenderInterceptor, R as RenderModule, a as RenderService, S as StreamingErrorHandler, T as TemplateParserService } from '../index-BzOLOiIZ.js';
+export { E as ErrorPageDevelopment, e as ErrorPageProduction, b as RenderInterceptor, R as RenderModule, a as RenderService, S as StreamingErrorHandler, T as TemplateParserService } from '../index-CSvZfKpi.js';
 import '@nestjs/common';
 import 'react';
-import '../render-response.interface-CxbuKGnV.js';
+import '../render-response.interface-ClWJXKL4.js';
+import 'http';
 import 'vite';
-import 'express';
 import '@nestjs/core';
 import 'rxjs';
 import 'react/jsx-runtime';

package/dist/render/index.js

@@ -314,9 +314,13 @@ var StringRenderer = class _StringRenderer {
         throw new Error("Server bundle not found in manifest. Run `pnpm build:server` to generate the server bundle.");
       }
     }
-    const { data: pageData, __context: pageContext } = data;
+    const { data: pageData, __context: pageContext, __layouts: layouts } = data;
     const html = await renderModule.renderSegment(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
+    })) : [];
     if (context.isDevelopment) {
       const duration = Date.now() - startTime;
       this.logger.log(`[SSR] ${componentName} segment rendered in ${duration}ms`);
@@ -327,7 +331,8 @@ var StringRenderer = class _StringRenderer {
       props: pageData,
       swapTarget,
       componentName,
-      context: pageContext
+      context: pageContext,
+      layouts: layoutMetadata
     };
   }
 };
@@ -456,6 +461,39 @@ function ErrorPageProduction() {
 }
 __name(ErrorPageProduction, "ErrorPageProduction");
 
+// src/render/adapters/http-adapter-utils.ts
+function detectAdapterType(httpAdapterHost) {
+  const adapter = httpAdapterHost?.httpAdapter;
+  if (!adapter) return "unknown";
+  const instance = adapter.getInstance();
+  if (instance && typeof instance.register === "function") {
+    return "fastify";
+  }
+  if (instance && typeof instance.use === "function" && typeof instance.get === "function") {
+    return "express";
+  }
+  return "unknown";
+}
+__name(detectAdapterType, "detectAdapterType");
+function isFastifyLikeResponse(res) {
+  return res != null && typeof res === "object" && "raw" in res && res.raw != null && typeof res.raw.write === "function";
+}
+__name(isFastifyLikeResponse, "isFastifyLikeResponse");
+function getRawResponse(res) {
+  if (isFastifyLikeResponse(res)) {
+    return res.raw;
+  }
+  return res;
+}
+__name(getRawResponse, "getRawResponse");
+function isHeadersSent(res) {
+  if (typeof res.sent === "boolean") {
+    return res.sent;
+  }
+  return res.headersSent === true;
+}
+__name(isHeadersSent, "isHeadersSent");
+
 // src/render/streaming-error-handler.ts
 function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -491,21 +529,19 @@ exports.StreamingErrorHandler = class _StreamingErrorHandler {
   */
   handleShellError(error, res, viewPath, isDevelopment) {
     this.logger.error(`Shell error rendering ${viewPath}: ${error.message}`, error.stack);
-    if (res.headersSent) {
+    const rawRes = getRawResponse(res);
+    if (isHeadersSent(res)) {
       this.logger.error(`Cannot send error page for ${viewPath} - headers already sent (streaming started)`);
-      if (!res.writableEnded) {
-        res.write(this.renderInlineErrorOverlay(error, viewPath, isDevelopment));
-        res.end();
+      if (!rawRes.writableEnded) {
+        rawRes.write(this.renderInlineErrorOverlay(error, viewPath, isDevelopment));
+        rawRes.end();
       }
       return;
     }
-    res.statusCode = 500;
-    res.setHeader("Content-Type", "text/html; charset=utf-8");
-    if (isDevelopment) {
-      res.send(this.renderDevelopmentErrorPage(error, viewPath, "shell"));
-    } else {
-      res.send(this.renderProductionErrorPage());
-    }
+    rawRes.statusCode = 500;
+    rawRes.setHeader("Content-Type", "text/html; charset=utf-8");
+    const html = isDevelopment ? this.renderDevelopmentErrorPage(error, viewPath, "shell") : this.renderProductionErrorPage();
+    rawRes.end(html);
   }
   /**
   * Handle error that occurred during streaming
@@ -661,7 +697,7 @@ var StreamRenderer = 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
   */
@@ -703,20 +739,21 @@ var StreamRenderer = class _StreamRenderer {
         const { PassThrough } = await import('stream');
         const reactStream = new PassThrough();
         let allReadyFired = false;
+        const rawRes = getRawResponse(res);
         const { pipe, abort } = renderModule.renderComponentStream(viewComponent, data, {
           onShellReady: /* @__PURE__ */ __name(() => {
             shellReadyTime = Date.now();
-            if (!res.headersSent) {
-              res.statusCode = didError ? 500 : 200;
-              res.setHeader("Content-Type", "text/html; charset=utf-8");
+            if (!rawRes.headersSent) {
+              rawRes.statusCode = didError ? 500 : 200;
+              rawRes.setHeader("Content-Type", "text/html; charset=utf-8");
             }
             let htmlStart = templateParts.htmlStart;
             htmlStart = htmlStart.replace("<!--styles-->", stylesheetTags);
             htmlStart = htmlStart.replace("<!--head-meta-->", headTags);
-            res.write(htmlStart);
-            res.write(templateParts.rootStart);
+            rawRes.write(htmlStart);
+            rawRes.write(templateParts.rootStart);
             pipe(reactStream);
-            reactStream.pipe(res, {
+            reactStream.pipe(rawRes, {
               end: false
             });
             if (context.isDevelopment) {
@@ -741,11 +778,11 @@ var StreamRenderer = class _StreamRenderer {
           if (shellErrorOccurred) {
             return;
           }
-          res.write(inlineScripts);
-          res.write(clientScript);
-          res.write(templateParts.rootEnd);
-          res.write(templateParts.htmlEnd);
-          res.end();
+          rawRes.write(inlineScripts);
+          rawRes.write(clientScript);
+          rawRes.write(templateParts.rootEnd);
+          rawRes.write(templateParts.htmlEnd);
+          rawRes.end();
           if (context.isDevelopment) {
             const totalTime = Date.now() - startTime;
             const streamTime = Date.now() - shellReadyTime;
@@ -757,7 +794,7 @@ var StreamRenderer = class _StreamRenderer {
         reactStream.on("error", (error) => {
           reject(error);
         });
-        res.on("close", () => {
+        rawRes.on("close", () => {
           abort();
           resolve();
         });
@@ -1078,11 +1115,13 @@ exports.RenderInterceptor = class RenderInterceptor {
   renderService;
   allowedHeaders;
   allowedCookies;
-  constructor(reflector, renderService, allowedHeaders, allowedCookies) {
+  contextFactory;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory) {
     this.reflector = reflector;
     this.renderService = renderService;
     this.allowedHeaders = allowedHeaders;
     this.allowedCookies = allowedCookies;
+    this.contextFactory = contextFactory;
   }
   /**
   * Resolve the layout hierarchy for a given route
@@ -1222,6 +1261,14 @@ exports.RenderInterceptor = class RenderInterceptor {
           renderContext.cookies = cookies;
         }
       }
+      if (this.contextFactory) {
+        const customContext = await this.contextFactory({
+          req: request
+        });
+        if (customContext) {
+          Object.assign(renderContext, customContext);
+        }
+      }
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
@@ -1268,12 +1315,15 @@ exports.RenderInterceptor = _ts_decorate6([
   _ts_param3(2, common.Inject("ALLOWED_HEADERS")),
   _ts_param3(3, common.Optional()),
   _ts_param3(3, common.Inject("ALLOWED_COOKIES")),
+  _ts_param3(4, common.Optional()),
+  _ts_param3(4, common.Inject("CONTEXT_FACTORY")),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", [
     typeof core.Reflector === "undefined" ? Object : core.Reflector,
     typeof exports.RenderService === "undefined" ? Object : exports.RenderService,
     Array,
-    Array
+    Array,
+    typeof ContextFactory === "undefined" ? Object : ContextFactory
   ])
 ], exports.RenderInterceptor);
 function _ts_decorate7(decorators, target, key, desc) {
@@ -1324,7 +1374,7 @@ var ViteInitializerService = class _ViteInitializerService {
     if (isDevelopment) {
       await this.setupDevelopmentMode();
     } else {
-      this.setupProductionMode();
+      await this.setupProductionMode();
     }
   }
   async setupDevelopmentMode() {
@@ -1366,18 +1416,38 @@ var ViteInitializerService = class _ViteInitializerService {
       this.logger.warn(`Failed to setup Vite proxy: ${error.message}. Make sure http-proxy-middleware is installed.`);
     }
   }
-  setupProductionMode() {
+  async setupProductionMode() {
     try {
       const httpAdapter = this.httpAdapterHost.httpAdapter;
-      if (httpAdapter) {
-        const app = httpAdapter.getInstance();
-        const { join: join2 } = __require("path");
+      if (!httpAdapter) return;
+      const app = httpAdapter.getInstance();
+      const { join: join2 } = __require("path");
+      const staticPath = join2(process.cwd(), "dist/client");
+      const adapterType = detectAdapterType(this.httpAdapterHost);
+      if (adapterType === "fastify") {
+        try {
+          const fastifyStatic = await import('@fastify/static').catch(() => null);
+          if (fastifyStatic) {
+            await app.register(fastifyStatic.default, {
+              root: staticPath,
+              prefix: "/",
+              index: false,
+              maxAge: 31536e6
+            });
+            this.logger.log("\u2713 Static assets configured (dist/client) [Fastify]");
+          } else {
+            this.logger.warn("For Fastify static file serving, install @fastify/static: npm install @fastify/static");
+          }
+        } catch {
+          this.logger.warn("For Fastify static file serving, install @fastify/static: npm install @fastify/static");
+        }
+      } else {
         const express = __require("express");
-        app.use(express.static(join2(process.cwd(), "dist/client"), {
+        app.use(express.static(staticPath, {
           index: false,
           maxAge: "1y"
         }));
-        this.logger.log("\u2713 Static assets configured (dist/client)");
+        this.logger.log("\u2713 Static assets configured (dist/client) [Express]");
       }
     } catch (error) {
       this.logger.warn(`Failed to setup static assets: ${error.message}`);
@@ -1517,6 +1587,12 @@ exports.RenderModule = class _RenderModule {
       provide: "ALLOWED_COOKIES",
       useValue: config?.allowedCookies || []
     });
+    if (config?.context) {
+      providers.push({
+        provide: "CONTEXT_FACTORY",
+        useValue: config.context
+      });
+    }
     return {
       global: true,
       module: _RenderModule,
@@ -1635,6 +1711,13 @@ exports.RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      {
+        provide: "CONTEXT_FACTORY",
+        useFactory: /* @__PURE__ */ __name((config) => config?.context, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {

package/dist/render/index.mjs

@@ -1,5 +1,5 @@
 import { Injectable, Logger, Optional, Inject, Global, Module } from '@nestjs/common';
-import { HttpAdapterHost, APP_INTERCEPTOR, Reflector } from '@nestjs/core';
+import { Reflector, HttpAdapterHost, APP_INTERCEPTOR } from '@nestjs/core';
 import { existsSync, readFileSync } from 'fs';
 import { join, relative } from 'path';
 import { uneval } from 'devalue';
@@ -308,9 +308,13 @@ var StringRenderer = class _StringRenderer {
         throw new Error("Server bundle not found in manifest. Run `pnpm build:server` to generate the server bundle.");
       }
     }
-    const { data: pageData, __context: pageContext } = data;
+    const { data: pageData, __context: pageContext, __layouts: layouts } = data;
     const html = await renderModule.renderSegment(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
+    })) : [];
     if (context.isDevelopment) {
       const duration = Date.now() - startTime;
       this.logger.log(`[SSR] ${componentName} segment rendered in ${duration}ms`);
@@ -321,7 +325,8 @@ var StringRenderer = class _StringRenderer {
       props: pageData,
       swapTarget,
       componentName,
-      context: pageContext
+      context: pageContext,
+      layouts: layoutMetadata
     };
   }
 };
@@ -450,6 +455,39 @@ function ErrorPageProduction() {
 }
 __name(ErrorPageProduction, "ErrorPageProduction");
 
+// src/render/adapters/http-adapter-utils.ts
+function detectAdapterType(httpAdapterHost) {
+  const adapter = httpAdapterHost?.httpAdapter;
+  if (!adapter) return "unknown";
+  const instance = adapter.getInstance();
+  if (instance && typeof instance.register === "function") {
+    return "fastify";
+  }
+  if (instance && typeof instance.use === "function" && typeof instance.get === "function") {
+    return "express";
+  }
+  return "unknown";
+}
+__name(detectAdapterType, "detectAdapterType");
+function isFastifyLikeResponse(res) {
+  return res != null && typeof res === "object" && "raw" in res && res.raw != null && typeof res.raw.write === "function";
+}
+__name(isFastifyLikeResponse, "isFastifyLikeResponse");
+function getRawResponse(res) {
+  if (isFastifyLikeResponse(res)) {
+    return res.raw;
+  }
+  return res;
+}
+__name(getRawResponse, "getRawResponse");
+function isHeadersSent(res) {
+  if (typeof res.sent === "boolean") {
+    return res.sent;
+  }
+  return res.headersSent === true;
+}
+__name(isHeadersSent, "isHeadersSent");
+
 // src/render/streaming-error-handler.ts
 function _ts_decorate3(decorators, target, key, desc) {
   var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
@@ -485,21 +523,19 @@ var StreamingErrorHandler = class _StreamingErrorHandler {
   */
   handleShellError(error, res, viewPath, isDevelopment) {
     this.logger.error(`Shell error rendering ${viewPath}: ${error.message}`, error.stack);
-    if (res.headersSent) {
+    const rawRes = getRawResponse(res);
+    if (isHeadersSent(res)) {
       this.logger.error(`Cannot send error page for ${viewPath} - headers already sent (streaming started)`);
-      if (!res.writableEnded) {
-        res.write(this.renderInlineErrorOverlay(error, viewPath, isDevelopment));
-        res.end();
+      if (!rawRes.writableEnded) {
+        rawRes.write(this.renderInlineErrorOverlay(error, viewPath, isDevelopment));
+        rawRes.end();
       }
       return;
     }
-    res.statusCode = 500;
-    res.setHeader("Content-Type", "text/html; charset=utf-8");
-    if (isDevelopment) {
-      res.send(this.renderDevelopmentErrorPage(error, viewPath, "shell"));
-    } else {
-      res.send(this.renderProductionErrorPage());
-    }
+    rawRes.statusCode = 500;
+    rawRes.setHeader("Content-Type", "text/html; charset=utf-8");
+    const html = isDevelopment ? this.renderDevelopmentErrorPage(error, viewPath, "shell") : this.renderProductionErrorPage();
+    rawRes.end(html);
   }
   /**
   * Handle error that occurred during streaming
@@ -655,7 +691,7 @@ var StreamRenderer = 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
   */
@@ -697,20 +733,21 @@ var StreamRenderer = class _StreamRenderer {
         const { PassThrough } = await import('stream');
         const reactStream = new PassThrough();
         let allReadyFired = false;
+        const rawRes = getRawResponse(res);
         const { pipe, abort } = renderModule.renderComponentStream(viewComponent, data, {
           onShellReady: /* @__PURE__ */ __name(() => {
             shellReadyTime = Date.now();
-            if (!res.headersSent) {
-              res.statusCode = didError ? 500 : 200;
-              res.setHeader("Content-Type", "text/html; charset=utf-8");
+            if (!rawRes.headersSent) {
+              rawRes.statusCode = didError ? 500 : 200;
+              rawRes.setHeader("Content-Type", "text/html; charset=utf-8");
             }
             let htmlStart = templateParts.htmlStart;
             htmlStart = htmlStart.replace("<!--styles-->", stylesheetTags);
             htmlStart = htmlStart.replace("<!--head-meta-->", headTags);
-            res.write(htmlStart);
-            res.write(templateParts.rootStart);
+            rawRes.write(htmlStart);
+            rawRes.write(templateParts.rootStart);
             pipe(reactStream);
-            reactStream.pipe(res, {
+            reactStream.pipe(rawRes, {
               end: false
             });
             if (context.isDevelopment) {
@@ -735,11 +772,11 @@ var StreamRenderer = class _StreamRenderer {
           if (shellErrorOccurred) {
             return;
           }
-          res.write(inlineScripts);
-          res.write(clientScript);
-          res.write(templateParts.rootEnd);
-          res.write(templateParts.htmlEnd);
-          res.end();
+          rawRes.write(inlineScripts);
+          rawRes.write(clientScript);
+          rawRes.write(templateParts.rootEnd);
+          rawRes.write(templateParts.htmlEnd);
+          rawRes.end();
           if (context.isDevelopment) {
             const totalTime = Date.now() - startTime;
             const streamTime = Date.now() - shellReadyTime;
@@ -751,7 +788,7 @@ var StreamRenderer = class _StreamRenderer {
         reactStream.on("error", (error) => {
           reject(error);
         });
-        res.on("close", () => {
+        rawRes.on("close", () => {
           abort();
           resolve();
         });
@@ -1072,11 +1109,13 @@ var RenderInterceptor = class {
   renderService;
   allowedHeaders;
   allowedCookies;
-  constructor(reflector, renderService, allowedHeaders, allowedCookies) {
+  contextFactory;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory) {
     this.reflector = reflector;
     this.renderService = renderService;
     this.allowedHeaders = allowedHeaders;
     this.allowedCookies = allowedCookies;
+    this.contextFactory = contextFactory;
   }
   /**
   * Resolve the layout hierarchy for a given route
@@ -1216,6 +1255,14 @@ var RenderInterceptor = class {
           renderContext.cookies = cookies;
         }
       }
+      if (this.contextFactory) {
+        const customContext = await this.contextFactory({
+          req: request
+        });
+        if (customContext) {
+          Object.assign(renderContext, customContext);
+        }
+      }
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
@@ -1262,12 +1309,15 @@ RenderInterceptor = _ts_decorate6([
   _ts_param3(2, Inject("ALLOWED_HEADERS")),
   _ts_param3(3, Optional()),
   _ts_param3(3, Inject("ALLOWED_COOKIES")),
+  _ts_param3(4, Optional()),
+  _ts_param3(4, Inject("CONTEXT_FACTORY")),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", [
     typeof Reflector === "undefined" ? Object : Reflector,
     typeof RenderService === "undefined" ? Object : RenderService,
     Array,
-    Array
+    Array,
+    typeof ContextFactory === "undefined" ? Object : ContextFactory
   ])
 ], RenderInterceptor);
 function _ts_decorate7(decorators, target, key, desc) {
@@ -1318,7 +1368,7 @@ var ViteInitializerService = class _ViteInitializerService {
     if (isDevelopment) {
       await this.setupDevelopmentMode();
     } else {
-      this.setupProductionMode();
+      await this.setupProductionMode();
     }
   }
   async setupDevelopmentMode() {
@@ -1360,18 +1410,38 @@ var ViteInitializerService = class _ViteInitializerService {
       this.logger.warn(`Failed to setup Vite proxy: ${error.message}. Make sure http-proxy-middleware is installed.`);
     }
   }
-  setupProductionMode() {
+  async setupProductionMode() {
     try {
       const httpAdapter = this.httpAdapterHost.httpAdapter;
-      if (httpAdapter) {
-        const app = httpAdapter.getInstance();
-        const { join: join2 } = __require("path");
+      if (!httpAdapter) return;
+      const app = httpAdapter.getInstance();
+      const { join: join2 } = __require("path");
+      const staticPath = join2(process.cwd(), "dist/client");
+      const adapterType = detectAdapterType(this.httpAdapterHost);
+      if (adapterType === "fastify") {
+        try {
+          const fastifyStatic = await import('@fastify/static').catch(() => null);
+          if (fastifyStatic) {
+            await app.register(fastifyStatic.default, {
+              root: staticPath,
+              prefix: "/",
+              index: false,
+              maxAge: 31536e6
+            });
+            this.logger.log("\u2713 Static assets configured (dist/client) [Fastify]");
+          } else {
+            this.logger.warn("For Fastify static file serving, install @fastify/static: npm install @fastify/static");
+          }
+        } catch {
+          this.logger.warn("For Fastify static file serving, install @fastify/static: npm install @fastify/static");
+        }
+      } else {
         const express = __require("express");
-        app.use(express.static(join2(process.cwd(), "dist/client"), {
+        app.use(express.static(staticPath, {
           index: false,
           maxAge: "1y"
         }));
-        this.logger.log("\u2713 Static assets configured (dist/client)");
+        this.logger.log("\u2713 Static assets configured (dist/client) [Express]");
       }
     } catch (error) {
       this.logger.warn(`Failed to setup static assets: ${error.message}`);
@@ -1511,6 +1581,12 @@ var RenderModule = class _RenderModule {
       provide: "ALLOWED_COOKIES",
       useValue: config?.allowedCookies || []
     });
+    if (config?.context) {
+      providers.push({
+        provide: "CONTEXT_FACTORY",
+        useValue: config.context
+      });
+    }
     return {
       global: true,
       module: _RenderModule,
@@ -1629,6 +1705,13 @@ var RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      {
+        provide: "CONTEXT_FACTORY",
+        useFactory: /* @__PURE__ */ __name((config) => config?.context, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {

package/dist/{render-response.interface-CxbuKGnV.d.mts → render-response.interface-ClWJXKL4.d.mts}

@@ -3,7 +3,7 @@
  * Contains safe request metadata that can be exposed to the client.
  *
  * Extend this interface to add app-specific properties (user, tenant, feature flags, etc.).
- * Use module configuration to pass additional headers or cookies safely.
+ * Use the `context` option in module configuration to enrich the context.
  *
  * @example
  * // Basic usage - use as-is
@@ -32,19 +32,28 @@
  *   theme?: string;  // From cookie
  * }
  *
- * // Configure module to pass specific cookies/headers
- * ReactSSRModule.forRoot({
+ * // Configure module with context factory to enrich context
+ * RenderModule.forRoot({
  *   allowedCookies: ['theme', 'locale'],
  *   allowedHeaders: ['x-tenant-id'],
+ *   context: ({ req }) => ({
+ *     user: req.user,  // From Passport JWT strategy
+ *     tenant: req.tenant,
+ *     featureFlags: req.featureFlags,
+ *   }),
  * })
  *
- * // Use in interceptor/controller
- * const context: AppRenderContext = {
- *   ...baseContext,
- *   user: req.user,
- *   tenant: req.tenant,
- *   featureFlags: await featureFlagService.getFlags(req),
- * };
+ * // Or with async factory (use forRootAsync)
+ * RenderModule.forRootAsync({
+ *   imports: [PermissionModule],
+ *   inject: [PermissionService],
+ *   useFactory: (permissionService) => ({
+ *     context: async ({ req }) => ({
+ *       user: req.user,
+ *       permissions: await permissionService.getForUser(req.user),
+ *     }),
+ *   }),
+ * })
  */
 interface RenderContext {
     url: string;

package/dist/{render-response.interface-CxbuKGnV.d.ts → render-response.interface-ClWJXKL4.d.ts}

@@ -3,7 +3,7 @@
  * Contains safe request metadata that can be exposed to the client.
  *
  * Extend this interface to add app-specific properties (user, tenant, feature flags, etc.).
- * Use module configuration to pass additional headers or cookies safely.
+ * Use the `context` option in module configuration to enrich the context.
  *
  * @example
  * // Basic usage - use as-is
@@ -32,19 +32,28 @@
  *   theme?: string;  // From cookie
  * }
  *
- * // Configure module to pass specific cookies/headers
- * ReactSSRModule.forRoot({
+ * // Configure module with context factory to enrich context
+ * RenderModule.forRoot({
  *   allowedCookies: ['theme', 'locale'],
  *   allowedHeaders: ['x-tenant-id'],
+ *   context: ({ req }) => ({
+ *     user: req.user,  // From Passport JWT strategy
+ *     tenant: req.tenant,
+ *     featureFlags: req.featureFlags,
+ *   }),
  * })
  *
- * // Use in interceptor/controller
- * const context: AppRenderContext = {
- *   ...baseContext,
- *   user: req.user,
- *   tenant: req.tenant,
- *   featureFlags: await featureFlagService.getFlags(req),
- * };
+ * // Or with async factory (use forRootAsync)
+ * RenderModule.forRootAsync({
+ *   imports: [PermissionModule],
+ *   inject: [PermissionService],
+ *   useFactory: (permissionService) => ({
+ *     context: async ({ req }) => ({
+ *       user: req.user,
+ *       permissions: await permissionService.getForUser(req.user),
+ *     }),
+ *   }),
+ * })
  */
 interface RenderContext {
     url: string;