@nestjs-ssr/react 0.3.5 → 0.3.6

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

@@ -1,12 +1,79 @@
 import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
 import { ComponentType } from 'react';
-import { Request, Response } from 'express';
 import { H as HeadData, R as RenderContext } from './render-response.interface-ClWJXKL4.js';
+import { ServerResponse } from 'http';
 import { ViteDevServer } from 'vite';
 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.
@@ -16,7 +83,7 @@ type CustomContextProperties = Record<string, unknown>;
  * Context factory function signature
  * Called for each request to build custom context properties
  *
- * @param params - Object containing the Express request
+ * @param params - Object containing the HTTP request (Express or Fastify)
  * @returns Custom context properties to merge into RenderContext (sync or async)
  *
  * @example
@@ -37,8 +104,9 @@ type CustomContextProperties = Record<string, unknown>;
  * })
  * ```
  */
-type ContextFactory = (params: {
-    req: Request;
+type ContextFactory<TRequest extends SSRRequest = SSRRequest> = (params: {
+    /** HTTP request object (Express Request or Fastify FastifyRequest) */
+    req: TRequest;
 }) => CustomContextProperties | Promise<CustomContextProperties>;
 /**
  * SSR rendering mode configuration
@@ -486,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
@@ -552,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>;
 }
 
 /**
@@ -621,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).

package/dist/{index-CiYcz-1T.d.mts → index-ZpkYrPcK.d.mts}

@@ -1,12 +1,79 @@
 import { DynamicModule, NestInterceptor, ExecutionContext, CallHandler } from '@nestjs/common';
 import { ComponentType } from 'react';
-import { Request, Response } from 'express';
 import { H as HeadData, R as RenderContext } from './render-response.interface-ClWJXKL4.mjs';
+import { ServerResponse } from 'http';
 import { ViteDevServer } from 'vite';
 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.
@@ -16,7 +83,7 @@ type CustomContextProperties = Record<string, unknown>;
  * Context factory function signature
  * Called for each request to build custom context properties
  *
- * @param params - Object containing the Express request
+ * @param params - Object containing the HTTP request (Express or Fastify)
  * @returns Custom context properties to merge into RenderContext (sync or async)
  *
  * @example
@@ -37,8 +104,9 @@ type CustomContextProperties = Record<string, unknown>;
  * })
  * ```
  */
-type ContextFactory = (params: {
-    req: Request;
+type ContextFactory<TRequest extends SSRRequest = SSRRequest> = (params: {
+    /** HTTP request object (Express Request or Fastify FastifyRequest) */
+    req: TRequest;
 }) => CustomContextProperties | Promise<CustomContextProperties>;
 /**
  * SSR rendering mode configuration
@@ -486,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
@@ -552,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>;
 }
 
 /**
@@ -621,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).

package/dist/index.d.mts

@@ -1,10 +1,10 @@
-export { C as ContextFactory, E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-CiYcz-1T.mjs';
+export { C as ContextFactory, E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-ZpkYrPcK.mjs';
 import React, { ComponentType, ReactNode } from 'react';
 import { P as PageProps } from './use-page-context-CVC9DHcL.mjs';
 export { a as PageContextProvider, c as createSSRHooks, 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 { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-ClWJXKL4.mjs';
 import '@nestjs/common';
-import 'express';
+import 'http';
 import 'vite';
 import '@nestjs/core';
 import 'rxjs';

package/dist/index.d.ts

@@ -1,10 +1,10 @@
-export { C as ContextFactory, E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-Dq2qZSge.js';
+export { C as ContextFactory, E as ErrorPageDevelopment, e as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-CSvZfKpi.js';
 import React, { ComponentType, ReactNode } from 'react';
 import { P as PageProps } from './use-page-context-DChgHhL9.js';
 export { a as PageContextProvider, c as createSSRHooks, 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 { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-ClWJXKL4.js';
 import '@nestjs/common';
-import 'express';
+import 'http';
 import 'vite';
 import '@nestjs/core';
 import 'rxjs';

package/dist/index.js

@@ -462,6 +462,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;
@@ -497,21 +530,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
@@ -667,7 +698,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
   */
@@ -709,20 +740,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) {
@@ -747,11 +779,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;
@@ -763,7 +795,7 @@ var StreamRenderer = class _StreamRenderer {
         reactStream.on("error", (error) => {
           reject(error);
         });
-        res.on("close", () => {
+        rawRes.on("close", () => {
           abort();
           resolve();
         });
@@ -1361,7 +1393,7 @@ var ViteInitializerService = class _ViteInitializerService {
     if (isDevelopment) {
       await this.setupDevelopmentMode();
     } else {
-      this.setupProductionMode();
+      await this.setupProductionMode();
     }
   }
   async setupDevelopmentMode() {
@@ -1403,18 +1435,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}`);

package/dist/index.mjs

@@ -455,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;
@@ -490,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
@@ -660,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
   */
@@ -702,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) {
@@ -740,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;
@@ -756,7 +788,7 @@ var StreamRenderer = class _StreamRenderer {
         reactStream.on("error", (error) => {
           reject(error);
         });
-        res.on("close", () => {
+        rawRes.on("close", () => {
           abort();
           resolve();
         });
@@ -1354,7 +1386,7 @@ var ViteInitializerService = class _ViteInitializerService {
     if (isDevelopment) {
       await this.setupDevelopmentMode();
     } else {
-      this.setupProductionMode();
+      await this.setupProductionMode();
     }
   }
   async setupDevelopmentMode() {
@@ -1396,18 +1428,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}`);

package/dist/render/index.d.mts

@@ -1,8 +1,8 @@
-export { E as ErrorPageDevelopment, e as ErrorPageProduction, b as RenderInterceptor, R as RenderModule, a as RenderService, S as StreamingErrorHandler, T as TemplateParserService } from '../index-CiYcz-1T.mjs';
+export { E as ErrorPageDevelopment, e as ErrorPageProduction, b as RenderInterceptor, R as RenderModule, a as RenderService, S as StreamingErrorHandler, T as TemplateParserService } from '../index-ZpkYrPcK.mjs';
 import '@nestjs/common';
 import 'react';
-import 'express';
 import '../render-response.interface-ClWJXKL4.mjs';
+import 'http';
 import 'vite';
 import '@nestjs/core';
 import 'rxjs';

package/dist/render/index.d.ts

@@ -1,8 +1,8 @@
-export { E as ErrorPageDevelopment, e as ErrorPageProduction, b as RenderInterceptor, R as RenderModule, a as RenderService, S as StreamingErrorHandler, T as TemplateParserService } from '../index-Dq2qZSge.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 'express';
 import '../render-response.interface-ClWJXKL4.js';
+import 'http';
 import 'vite';
 import '@nestjs/core';
 import 'rxjs';

package/dist/render/index.js

@@ -461,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;
@@ -496,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
@@ -666,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
   */
@@ -708,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) {
@@ -746,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;
@@ -762,7 +794,7 @@ var StreamRenderer = class _StreamRenderer {
         reactStream.on("error", (error) => {
           reject(error);
         });
-        res.on("close", () => {
+        rawRes.on("close", () => {
           abort();
           resolve();
         });
@@ -1342,7 +1374,7 @@ var ViteInitializerService = class _ViteInitializerService {
     if (isDevelopment) {
       await this.setupDevelopmentMode();
     } else {
-      this.setupProductionMode();
+      await this.setupProductionMode();
     }
   }
   async setupDevelopmentMode() {
@@ -1384,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}`);

package/dist/render/index.mjs

@@ -455,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;
@@ -490,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
@@ -660,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
   */
@@ -702,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) {
@@ -740,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;
@@ -756,7 +788,7 @@ var StreamRenderer = class _StreamRenderer {
         reactStream.on("error", (error) => {
           reject(error);
         });
-        res.on("close", () => {
+        rawRes.on("close", () => {
           abort();
           resolve();
         });
@@ -1336,7 +1368,7 @@ var ViteInitializerService = class _ViteInitializerService {
     if (isDevelopment) {
       await this.setupDevelopmentMode();
     } else {
-      this.setupProductionMode();
+      await this.setupProductionMode();
     }
   }
   async setupDevelopmentMode() {
@@ -1378,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}`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs-ssr/react",
-  "version": "0.3.5",
+  "version": "0.3.6",
   "description": "React SSR for NestJS that respects Clean Architecture. Proper DI, SOLID principles, clear separation of concerns.",
   "keywords": [
     "nestjs",
@@ -112,6 +112,8 @@
     "@nestjs/common": "^11.0.0",
     "@nestjs/core": "^11.0.0",
     "@nestjs/platform-express": "^11.0.0",
+    "@nestjs/platform-fastify": "^11.0.0",
+    "@fastify/static": "^8.0.0 || ^7.0.0",
     "http-proxy-middleware": "^3.0.0 || ^2.0.0",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
@@ -119,6 +121,15 @@
     "vite": "^7.0.0 || ^6.0.0"
   },
   "peerDependenciesMeta": {
+    "@nestjs/platform-express": {
+      "optional": true
+    },
+    "@nestjs/platform-fastify": {
+      "optional": true
+    },
+    "@fastify/static": {
+      "optional": true
+    },
     "http-proxy-middleware": {
       "optional": true
     }