@nestjs-ssr/react 0.3.13 → 0.3.14

package/dist/client.d.mts

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

package/dist/client.d.ts

@@ -1,4 +1,4 @@
-export { a as PageContextProvider, P as PageProps, c as createSSRHooks, j as updatePageContext, u as useCookie, b as useCookies, d as useHeader, e as useHeaders, f as usePageContext, g as useParams, h as useQuery, i as useRequest } from './use-page-context-CUV31oda.js';
+export { P as PageContextProvider, a as PageProps, c as createSSRHooks, u as updatePageContext, b as useCookie, d as useCookies, e as useHeader, f as useHeaders, g as usePageContext, h as useParams, i as useQuery, j as useRequest } from './use-page-context-Bo3Z0m-_.js';
 import * as react_jsx_runtime from 'react/jsx-runtime';
 import React from 'react';
 export { R as RenderContext } from './render-response.interface-ClWJXKL4.js';

package/dist/{index-DcpOFSp4.d.mts → index-CF5JpFZh.d.mts}

@@ -257,6 +257,27 @@ interface RenderConfig {
      * ```
      */
     allowedHeaders?: string[];
+    /**
+     * Enable JSON API mode for content negotiation
+     *
+     * When enabled, routes with `@Render()` respond with JSON when the request
+     * includes `Accept: application/json`. The response body is the raw controller
+     * return value — no wrapper, no metadata.
+     *
+     * Can be overridden per-route via `@Render(Component, { jsonApi: true/false })`.
+     *
+     * @default false
+     *
+     * @example
+     * ```typescript
+     * // Enable globally
+     * RenderModule.forRoot({ jsonApi: true })
+     *
+     * // Then disable on specific routes
+     * @Render(SecretPage, { jsonApi: false })
+     * ```
+     */
+    jsonApi?: boolean;
     /**
      * Cookie names to pass to client
      * By default, no cookies are passed to client for security
@@ -708,7 +729,8 @@ declare class RenderInterceptor implements NestInterceptor {
     private allowedHeaders?;
     private allowedCookies?;
     private contextFactory?;
-    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined);
+    private jsonApiEnabled?;
+    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined, jsonApiEnabled?: boolean | undefined);
     /**
      * Resolve the layout hierarchy for a given route
      * Hierarchy: Root Layout → Controller Layout → Method Layout → Page
@@ -735,6 +757,15 @@ declare class RenderInterceptor implements NestInterceptor {
      * The swap target's outlet will contain the filtered layouts.
      */
     private filterLayoutsFromSwapTarget;
+    /**
+     * Check if the request wants a JSON response via Accept header
+     */
+    private isJsonRequest;
+    /**
+     * Resolve whether JSON API is enabled for a given route.
+     * Priority: route-level @Render jsonApi → module-level jsonApi → false
+     */
+    private isJsonApiEnabled;
     intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
 }
 

package/dist/{index-CGfEDKI4.d.ts → index-Cd0UvVmK.d.ts}

@@ -257,6 +257,27 @@ interface RenderConfig {
      * ```
      */
     allowedHeaders?: string[];
+    /**
+     * Enable JSON API mode for content negotiation
+     *
+     * When enabled, routes with `@Render()` respond with JSON when the request
+     * includes `Accept: application/json`. The response body is the raw controller
+     * return value — no wrapper, no metadata.
+     *
+     * Can be overridden per-route via `@Render(Component, { jsonApi: true/false })`.
+     *
+     * @default false
+     *
+     * @example
+     * ```typescript
+     * // Enable globally
+     * RenderModule.forRoot({ jsonApi: true })
+     *
+     * // Then disable on specific routes
+     * @Render(SecretPage, { jsonApi: false })
+     * ```
+     */
+    jsonApi?: boolean;
     /**
      * Cookie names to pass to client
      * By default, no cookies are passed to client for security
@@ -708,7 +729,8 @@ declare class RenderInterceptor implements NestInterceptor {
     private allowedHeaders?;
     private allowedCookies?;
     private contextFactory?;
-    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined);
+    private jsonApiEnabled?;
+    constructor(reflector: Reflector, renderService: RenderService, allowedHeaders?: string[] | undefined, allowedCookies?: string[] | undefined, contextFactory?: ContextFactory | undefined, jsonApiEnabled?: boolean | undefined);
     /**
      * Resolve the layout hierarchy for a given route
      * Hierarchy: Root Layout → Controller Layout → Method Layout → Page
@@ -735,6 +757,15 @@ declare class RenderInterceptor implements NestInterceptor {
      * The swap target's outlet will contain the filtered layouts.
      */
     private filterLayoutsFromSwapTarget;
+    /**
+     * Check if the request wants a JSON response via Accept header
+     */
+    private isJsonRequest;
+    /**
+     * Resolve whether JSON API is enabled for a given route.
+     * Priority: route-level @Render jsonApi → module-level jsonApi → false
+     */
+    private isJsonApiEnabled;
     intercept(context: ExecutionContext, next: CallHandler): Observable<any>;
 }
 

package/dist/index.d.mts

@@ -1,7 +1,7 @@
-export { C as ContextFactory, E as ErrorPageDevelopment, a as ErrorPageProduction, R as RenderConfig, b as RenderInterceptor, c as RenderModule, d as RenderService, S as SSRMode, e as StreamingErrorHandler, T as TemplateParserService } from './index-DcpOFSp4.mjs';
+export { C as ContextFactory, E as ErrorPageDevelopment, a as ErrorPageProduction, R as RenderConfig, b as RenderInterceptor, c as RenderModule, d as RenderService, S as SSRMode, e as StreamingErrorHandler, T as TemplateParserService } from './index-CF5JpFZh.mjs';
 import React, { ComponentType, ReactNode } from 'react';
-import { P as PageProps } from './use-page-context-CmxWHIK3.mjs';
-export { a as PageContextProvider, c as createSSRHooks, u as useCookie, b as useCookies, d as useHeader, e as useHeaders, f as usePageContext, g as useParams, h as useQuery, i as useRequest } from './use-page-context-CmxWHIK3.mjs';
+import { a as PageProps } from './use-page-context-DXjw-66u.mjs';
+export { P as PageContextProvider, c as createSSRHooks, b as useCookie, d as useCookies, e as useHeader, f as useHeaders, g as usePageContext, h as useParams, i as useQuery, j as useRequest } from './use-page-context-DXjw-66u.mjs';
 import { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-ClWJXKL4.mjs';
 import '@nestjs/common';
 import 'http';
@@ -101,6 +101,24 @@ interface PageComponentWithLayout<TPageProps = {}, TLayoutProps = {}> {
     layoutProps?: TLayoutProps;
 }
 
+/**
+ * Type representing the JSON API response shape.
+ *
+ * When JSON API mode is enabled and a request includes `Accept: application/json`,
+ * the response body is the raw controller return value — this type.
+ *
+ * @typeParam T - The controller return type (same shape as the React component's data props)
+ *
+ * @example
+ * ```typescript
+ * // Controller returns { recipes: Recipe[], total: number }
+ * // JSON API response is typed as:
+ * type Response = JsonApiResponse<{ recipes: Recipe[]; total: number }>;
+ * // → { recipes: Recipe[]; total: number }
+ * ```
+ */
+type JsonApiResponse<T> = T;
+
 /**
  * Extract the data type T from PageProps<T>.
  * PageProps<T> = T & { head?, context }, so we extract T by removing those keys.
@@ -134,6 +152,15 @@ interface RenderOptions {
      * Props to pass to the layout component
      */
     layoutProps?: Record<string, any>;
+    /**
+     * Enable or disable JSON API mode for this route.
+     * Overrides the module-level `jsonApi` setting.
+     *
+     * - `true`: This route serves JSON when `Accept: application/json` is sent
+     * - `false`: This route returns 406 for JSON requests
+     * - `undefined`: Uses the module-level setting (default `false`)
+     */
+    jsonApi?: boolean;
 }
 /**
  * Decorator to render a React component as the response.
@@ -222,4 +249,4 @@ interface LayoutDecoratorOptions {
  */
 declare function Layout(layout: LayoutComponent<any>, options?: LayoutDecoratorOptions): ClassDecorator;
 
-export { HeadData, Layout, type LayoutComponent, type LayoutDecoratorOptions, type LayoutProps, type PageComponentWithLayout, PageProps, Render, RenderContext, type RenderOptions, RenderResponse };
+export { HeadData, type JsonApiResponse, Layout, type LayoutComponent, type LayoutDecoratorOptions, type LayoutProps, type PageComponentWithLayout, PageProps, Render, RenderContext, type RenderOptions, RenderResponse };

package/dist/index.d.ts

@@ -1,7 +1,7 @@
-export { C as ContextFactory, E as ErrorPageDevelopment, a as ErrorPageProduction, R as RenderConfig, b as RenderInterceptor, c as RenderModule, d as RenderService, S as SSRMode, e as StreamingErrorHandler, T as TemplateParserService } from './index-CGfEDKI4.js';
+export { C as ContextFactory, E as ErrorPageDevelopment, a as ErrorPageProduction, R as RenderConfig, b as RenderInterceptor, c as RenderModule, d as RenderService, S as SSRMode, e as StreamingErrorHandler, T as TemplateParserService } from './index-Cd0UvVmK.js';
 import React, { ComponentType, ReactNode } from 'react';
-import { P as PageProps } from './use-page-context-CUV31oda.js';
-export { a as PageContextProvider, c as createSSRHooks, u as useCookie, b as useCookies, d as useHeader, e as useHeaders, f as usePageContext, g as useParams, h as useQuery, i as useRequest } from './use-page-context-CUV31oda.js';
+import { a as PageProps } from './use-page-context-Bo3Z0m-_.js';
+export { P as PageContextProvider, c as createSSRHooks, b as useCookie, d as useCookies, e as useHeader, f as useHeaders, g as usePageContext, h as useParams, i as useQuery, j as useRequest } from './use-page-context-Bo3Z0m-_.js';
 import { R as RenderContext, H as HeadData, a as RenderResponse } from './render-response.interface-ClWJXKL4.js';
 import '@nestjs/common';
 import 'http';
@@ -101,6 +101,24 @@ interface PageComponentWithLayout<TPageProps = {}, TLayoutProps = {}> {
     layoutProps?: TLayoutProps;
 }
 
+/**
+ * Type representing the JSON API response shape.
+ *
+ * When JSON API mode is enabled and a request includes `Accept: application/json`,
+ * the response body is the raw controller return value — this type.
+ *
+ * @typeParam T - The controller return type (same shape as the React component's data props)
+ *
+ * @example
+ * ```typescript
+ * // Controller returns { recipes: Recipe[], total: number }
+ * // JSON API response is typed as:
+ * type Response = JsonApiResponse<{ recipes: Recipe[]; total: number }>;
+ * // → { recipes: Recipe[]; total: number }
+ * ```
+ */
+type JsonApiResponse<T> = T;
+
 /**
  * Extract the data type T from PageProps<T>.
  * PageProps<T> = T & { head?, context }, so we extract T by removing those keys.
@@ -134,6 +152,15 @@ interface RenderOptions {
      * Props to pass to the layout component
      */
     layoutProps?: Record<string, any>;
+    /**
+     * Enable or disable JSON API mode for this route.
+     * Overrides the module-level `jsonApi` setting.
+     *
+     * - `true`: This route serves JSON when `Accept: application/json` is sent
+     * - `false`: This route returns 406 for JSON requests
+     * - `undefined`: Uses the module-level setting (default `false`)
+     */
+    jsonApi?: boolean;
 }
 /**
  * Decorator to render a React component as the response.
@@ -222,4 +249,4 @@ interface LayoutDecoratorOptions {
  */
 declare function Layout(layout: LayoutComponent<any>, options?: LayoutDecoratorOptions): ClassDecorator;
 
-export { HeadData, Layout, type LayoutComponent, type LayoutDecoratorOptions, type LayoutProps, type PageComponentWithLayout, PageProps, Render, RenderContext, type RenderOptions, RenderResponse };
+export { HeadData, type JsonApiResponse, Layout, type LayoutComponent, type LayoutDecoratorOptions, type LayoutProps, type PageComponentWithLayout, PageProps, Render, RenderContext, type RenderOptions, RenderResponse };

package/dist/index.js

@@ -1135,12 +1135,14 @@ exports.RenderInterceptor = class RenderInterceptor {
   allowedHeaders;
   allowedCookies;
   contextFactory;
-  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory) {
+  jsonApiEnabled;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory, jsonApiEnabled) {
     this.reflector = reflector;
     this.renderService = renderService;
     this.allowedHeaders = allowedHeaders;
     this.allowedCookies = allowedCookies;
     this.contextFactory = contextFactory;
+    this.jsonApiEnabled = jsonApiEnabled;
   }
   /**
   * Resolve the layout hierarchy for a given route
@@ -1241,6 +1243,25 @@ exports.RenderInterceptor = class RenderInterceptor {
     const index = layouts.findIndex((l) => (l.layout.displayName || l.layout.name) === swapTarget);
     return index >= 0 ? layouts.slice(index + 1) : layouts;
   }
+  /**
+  * Check if the request wants a JSON response via Accept header
+  */
+  isJsonRequest(request) {
+    const accept = request.headers["accept"];
+    if (!accept || typeof accept !== "string") return false;
+    return accept.includes("application/json");
+  }
+  /**
+  * Resolve whether JSON API is enabled for a given route.
+  * Priority: route-level @Render jsonApi → module-level jsonApi → false
+  */
+  isJsonApiEnabled(context) {
+    const renderOptions = this.reflector.get(RENDER_OPTIONS_KEY, context.getHandler());
+    if (renderOptions?.jsonApi !== void 0) {
+      return renderOptions.jsonApi;
+    }
+    return this.jsonApiEnabled ?? false;
+  }
   intercept(context, next) {
     const viewPathOrComponent = this.reflector.get(RENDER_KEY, context.getHandler());
     if (!viewPathOrComponent) {
@@ -1292,6 +1313,17 @@ exports.RenderInterceptor = class RenderInterceptor {
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
+      const hasSegmentHeader = !!request.headers["x-current-layouts"];
+      if (!hasSegmentHeader && this.isJsonRequest(request)) {
+        if (this.isJsonApiEnabled(context)) {
+          response.type("application/json");
+          return renderResponse.props;
+        }
+        throw new common.HttpException({
+          error: "Not Acceptable",
+          message: "JSON response not available for this route"
+        }, common.HttpStatus.NOT_ACCEPTABLE);
+      }
       const layoutChain = await this.resolveLayoutChain(context, renderResponse.layoutProps);
       const fullData = {
         data: renderResponse.props,
@@ -1337,13 +1369,16 @@ exports.RenderInterceptor = _ts_decorate6([
   _ts_param3(3, common.Inject("ALLOWED_COOKIES")),
   _ts_param3(4, common.Optional()),
   _ts_param3(4, common.Inject("CONTEXT_FACTORY")),
+  _ts_param3(5, common.Optional()),
+  _ts_param3(5, common.Inject("JSON_API")),
   _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,
-    typeof ContextFactory === "undefined" ? Object : ContextFactory
+    typeof ContextFactory === "undefined" ? Object : ContextFactory,
+    Boolean
   ])
 ], exports.RenderInterceptor);
 function _ts_decorate7(decorators, target, key, desc) {
@@ -1607,6 +1642,10 @@ exports.RenderModule = class _RenderModule {
       provide: "ALLOWED_COOKIES",
       useValue: config?.allowedCookies || []
     });
+    providers.push({
+      provide: "JSON_API",
+      useValue: config?.jsonApi ?? false
+    });
     if (config?.context) {
       providers.push({
         provide: "CONTEXT_FACTORY",
@@ -1738,6 +1777,13 @@ exports.RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      {
+        provide: "JSON_API",
+        useFactory: /* @__PURE__ */ __name((config) => config?.jsonApi ?? false, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {

package/dist/index.mjs

@@ -1,4 +1,4 @@
-import { Injectable, Logger, Optional, Inject, Global, Module, SetMetadata } from '@nestjs/common';
+import { Injectable, Logger, Optional, Inject, HttpException, HttpStatus, Global, Module, SetMetadata } from '@nestjs/common';
 import { Reflector, HttpAdapterHost, APP_INTERCEPTOR } from '@nestjs/core';
 import { existsSync, readFileSync } from 'fs';
 import { join, relative } from 'path';
@@ -1128,12 +1128,14 @@ var RenderInterceptor = class {
   allowedHeaders;
   allowedCookies;
   contextFactory;
-  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory) {
+  jsonApiEnabled;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory, jsonApiEnabled) {
     this.reflector = reflector;
     this.renderService = renderService;
     this.allowedHeaders = allowedHeaders;
     this.allowedCookies = allowedCookies;
     this.contextFactory = contextFactory;
+    this.jsonApiEnabled = jsonApiEnabled;
   }
   /**
   * Resolve the layout hierarchy for a given route
@@ -1234,6 +1236,25 @@ var RenderInterceptor = class {
     const index = layouts.findIndex((l) => (l.layout.displayName || l.layout.name) === swapTarget);
     return index >= 0 ? layouts.slice(index + 1) : layouts;
   }
+  /**
+  * Check if the request wants a JSON response via Accept header
+  */
+  isJsonRequest(request) {
+    const accept = request.headers["accept"];
+    if (!accept || typeof accept !== "string") return false;
+    return accept.includes("application/json");
+  }
+  /**
+  * Resolve whether JSON API is enabled for a given route.
+  * Priority: route-level @Render jsonApi → module-level jsonApi → false
+  */
+  isJsonApiEnabled(context) {
+    const renderOptions = this.reflector.get(RENDER_OPTIONS_KEY, context.getHandler());
+    if (renderOptions?.jsonApi !== void 0) {
+      return renderOptions.jsonApi;
+    }
+    return this.jsonApiEnabled ?? false;
+  }
   intercept(context, next) {
     const viewPathOrComponent = this.reflector.get(RENDER_KEY, context.getHandler());
     if (!viewPathOrComponent) {
@@ -1285,6 +1306,17 @@ var RenderInterceptor = class {
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
+      const hasSegmentHeader = !!request.headers["x-current-layouts"];
+      if (!hasSegmentHeader && this.isJsonRequest(request)) {
+        if (this.isJsonApiEnabled(context)) {
+          response.type("application/json");
+          return renderResponse.props;
+        }
+        throw new HttpException({
+          error: "Not Acceptable",
+          message: "JSON response not available for this route"
+        }, HttpStatus.NOT_ACCEPTABLE);
+      }
       const layoutChain = await this.resolveLayoutChain(context, renderResponse.layoutProps);
       const fullData = {
         data: renderResponse.props,
@@ -1330,13 +1362,16 @@ RenderInterceptor = _ts_decorate6([
   _ts_param3(3, Inject("ALLOWED_COOKIES")),
   _ts_param3(4, Optional()),
   _ts_param3(4, Inject("CONTEXT_FACTORY")),
+  _ts_param3(5, Optional()),
+  _ts_param3(5, Inject("JSON_API")),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", [
     typeof Reflector === "undefined" ? Object : Reflector,
     typeof RenderService === "undefined" ? Object : RenderService,
     Array,
     Array,
-    typeof ContextFactory === "undefined" ? Object : ContextFactory
+    typeof ContextFactory === "undefined" ? Object : ContextFactory,
+    Boolean
   ])
 ], RenderInterceptor);
 function _ts_decorate7(decorators, target, key, desc) {
@@ -1600,6 +1635,10 @@ var RenderModule = class _RenderModule {
       provide: "ALLOWED_COOKIES",
       useValue: config?.allowedCookies || []
     });
+    providers.push({
+      provide: "JSON_API",
+      useValue: config?.jsonApi ?? false
+    });
     if (config?.context) {
       providers.push({
         provide: "CONTEXT_FACTORY",
@@ -1731,6 +1770,13 @@ var RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      {
+        provide: "JSON_API",
+        useFactory: /* @__PURE__ */ __name((config) => config?.jsonApi ?? false, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {

package/dist/render/index.d.mts

@@ -1,4 +1,4 @@
-export { E as ErrorPageDevelopment, a as ErrorPageProduction, b as RenderInterceptor, c as RenderModule, d as RenderService, e as StreamingErrorHandler, T as TemplateParserService } from '../index-DcpOFSp4.mjs';
+export { E as ErrorPageDevelopment, a as ErrorPageProduction, b as RenderInterceptor, c as RenderModule, d as RenderService, e as StreamingErrorHandler, T as TemplateParserService } from '../index-CF5JpFZh.mjs';
 import '@nestjs/common';
 import 'react';
 import '../render-response.interface-ClWJXKL4.mjs';

package/dist/render/index.d.ts

@@ -1,4 +1,4 @@
-export { E as ErrorPageDevelopment, a as ErrorPageProduction, b as RenderInterceptor, c as RenderModule, d as RenderService, e as StreamingErrorHandler, T as TemplateParserService } from '../index-CGfEDKI4.js';
+export { E as ErrorPageDevelopment, a as ErrorPageProduction, b as RenderInterceptor, c as RenderModule, d as RenderService, e as StreamingErrorHandler, T as TemplateParserService } from '../index-Cd0UvVmK.js';
 import '@nestjs/common';
 import 'react';
 import '../render-response.interface-ClWJXKL4.js';

package/dist/render/index.js

@@ -1116,12 +1116,14 @@ exports.RenderInterceptor = class RenderInterceptor {
   allowedHeaders;
   allowedCookies;
   contextFactory;
-  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory) {
+  jsonApiEnabled;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory, jsonApiEnabled) {
     this.reflector = reflector;
     this.renderService = renderService;
     this.allowedHeaders = allowedHeaders;
     this.allowedCookies = allowedCookies;
     this.contextFactory = contextFactory;
+    this.jsonApiEnabled = jsonApiEnabled;
   }
   /**
   * Resolve the layout hierarchy for a given route
@@ -1222,6 +1224,25 @@ exports.RenderInterceptor = class RenderInterceptor {
     const index = layouts.findIndex((l) => (l.layout.displayName || l.layout.name) === swapTarget);
     return index >= 0 ? layouts.slice(index + 1) : layouts;
   }
+  /**
+  * Check if the request wants a JSON response via Accept header
+  */
+  isJsonRequest(request) {
+    const accept = request.headers["accept"];
+    if (!accept || typeof accept !== "string") return false;
+    return accept.includes("application/json");
+  }
+  /**
+  * Resolve whether JSON API is enabled for a given route.
+  * Priority: route-level @Render jsonApi → module-level jsonApi → false
+  */
+  isJsonApiEnabled(context) {
+    const renderOptions = this.reflector.get(RENDER_OPTIONS_KEY, context.getHandler());
+    if (renderOptions?.jsonApi !== void 0) {
+      return renderOptions.jsonApi;
+    }
+    return this.jsonApiEnabled ?? false;
+  }
   intercept(context, next) {
     const viewPathOrComponent = this.reflector.get(RENDER_KEY, context.getHandler());
     if (!viewPathOrComponent) {
@@ -1273,6 +1294,17 @@ exports.RenderInterceptor = class RenderInterceptor {
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
+      const hasSegmentHeader = !!request.headers["x-current-layouts"];
+      if (!hasSegmentHeader && this.isJsonRequest(request)) {
+        if (this.isJsonApiEnabled(context)) {
+          response.type("application/json");
+          return renderResponse.props;
+        }
+        throw new common.HttpException({
+          error: "Not Acceptable",
+          message: "JSON response not available for this route"
+        }, common.HttpStatus.NOT_ACCEPTABLE);
+      }
       const layoutChain = await this.resolveLayoutChain(context, renderResponse.layoutProps);
       const fullData = {
         data: renderResponse.props,
@@ -1318,13 +1350,16 @@ exports.RenderInterceptor = _ts_decorate6([
   _ts_param3(3, common.Inject("ALLOWED_COOKIES")),
   _ts_param3(4, common.Optional()),
   _ts_param3(4, common.Inject("CONTEXT_FACTORY")),
+  _ts_param3(5, common.Optional()),
+  _ts_param3(5, common.Inject("JSON_API")),
   _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,
-    typeof ContextFactory === "undefined" ? Object : ContextFactory
+    typeof ContextFactory === "undefined" ? Object : ContextFactory,
+    Boolean
   ])
 ], exports.RenderInterceptor);
 function _ts_decorate7(decorators, target, key, desc) {
@@ -1588,6 +1623,10 @@ exports.RenderModule = class _RenderModule {
       provide: "ALLOWED_COOKIES",
       useValue: config?.allowedCookies || []
     });
+    providers.push({
+      provide: "JSON_API",
+      useValue: config?.jsonApi ?? false
+    });
     if (config?.context) {
       providers.push({
         provide: "CONTEXT_FACTORY",
@@ -1719,6 +1758,13 @@ exports.RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      {
+        provide: "JSON_API",
+        useFactory: /* @__PURE__ */ __name((config) => config?.jsonApi ?? false, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {

package/dist/render/index.mjs

@@ -1,4 +1,4 @@
-import { Injectable, Logger, Optional, Inject, Global, Module } from '@nestjs/common';
+import { Injectable, Logger, Optional, Inject, HttpException, HttpStatus, Global, Module } from '@nestjs/common';
 import { Reflector, HttpAdapterHost, APP_INTERCEPTOR } from '@nestjs/core';
 import { existsSync, readFileSync } from 'fs';
 import { join, relative } from 'path';
@@ -1110,12 +1110,14 @@ var RenderInterceptor = class {
   allowedHeaders;
   allowedCookies;
   contextFactory;
-  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory) {
+  jsonApiEnabled;
+  constructor(reflector, renderService, allowedHeaders, allowedCookies, contextFactory, jsonApiEnabled) {
     this.reflector = reflector;
     this.renderService = renderService;
     this.allowedHeaders = allowedHeaders;
     this.allowedCookies = allowedCookies;
     this.contextFactory = contextFactory;
+    this.jsonApiEnabled = jsonApiEnabled;
   }
   /**
   * Resolve the layout hierarchy for a given route
@@ -1216,6 +1218,25 @@ var RenderInterceptor = class {
     const index = layouts.findIndex((l) => (l.layout.displayName || l.layout.name) === swapTarget);
     return index >= 0 ? layouts.slice(index + 1) : layouts;
   }
+  /**
+  * Check if the request wants a JSON response via Accept header
+  */
+  isJsonRequest(request) {
+    const accept = request.headers["accept"];
+    if (!accept || typeof accept !== "string") return false;
+    return accept.includes("application/json");
+  }
+  /**
+  * Resolve whether JSON API is enabled for a given route.
+  * Priority: route-level @Render jsonApi → module-level jsonApi → false
+  */
+  isJsonApiEnabled(context) {
+    const renderOptions = this.reflector.get(RENDER_OPTIONS_KEY, context.getHandler());
+    if (renderOptions?.jsonApi !== void 0) {
+      return renderOptions.jsonApi;
+    }
+    return this.jsonApiEnabled ?? false;
+  }
   intercept(context, next) {
     const viewPathOrComponent = this.reflector.get(RENDER_KEY, context.getHandler());
     if (!viewPathOrComponent) {
@@ -1267,6 +1288,17 @@ var RenderInterceptor = class {
       const renderResponse = isRenderResponse(data) ? data : {
         props: data
       };
+      const hasSegmentHeader = !!request.headers["x-current-layouts"];
+      if (!hasSegmentHeader && this.isJsonRequest(request)) {
+        if (this.isJsonApiEnabled(context)) {
+          response.type("application/json");
+          return renderResponse.props;
+        }
+        throw new HttpException({
+          error: "Not Acceptable",
+          message: "JSON response not available for this route"
+        }, HttpStatus.NOT_ACCEPTABLE);
+      }
       const layoutChain = await this.resolveLayoutChain(context, renderResponse.layoutProps);
       const fullData = {
         data: renderResponse.props,
@@ -1312,13 +1344,16 @@ RenderInterceptor = _ts_decorate6([
   _ts_param3(3, Inject("ALLOWED_COOKIES")),
   _ts_param3(4, Optional()),
   _ts_param3(4, Inject("CONTEXT_FACTORY")),
+  _ts_param3(5, Optional()),
+  _ts_param3(5, Inject("JSON_API")),
   _ts_metadata5("design:type", Function),
   _ts_metadata5("design:paramtypes", [
     typeof Reflector === "undefined" ? Object : Reflector,
     typeof RenderService === "undefined" ? Object : RenderService,
     Array,
     Array,
-    typeof ContextFactory === "undefined" ? Object : ContextFactory
+    typeof ContextFactory === "undefined" ? Object : ContextFactory,
+    Boolean
   ])
 ], RenderInterceptor);
 function _ts_decorate7(decorators, target, key, desc) {
@@ -1582,6 +1617,10 @@ var RenderModule = class _RenderModule {
       provide: "ALLOWED_COOKIES",
       useValue: config?.allowedCookies || []
     });
+    providers.push({
+      provide: "JSON_API",
+      useValue: config?.jsonApi ?? false
+    });
     if (config?.context) {
       providers.push({
         provide: "CONTEXT_FACTORY",
@@ -1713,6 +1752,13 @@ var RenderModule = class _RenderModule {
         inject: [
           "RENDER_CONFIG"
         ]
+      },
+      {
+        provide: "JSON_API",
+        useFactory: /* @__PURE__ */ __name((config) => config?.jsonApi ?? false, "useFactory"),
+        inject: [
+          "RENDER_CONFIG"
+        ]
       }
     ];
     return {

package/dist/{use-page-context-CUV31oda.d.ts → use-page-context-Bo3Z0m-_.d.ts}

@@ -279,4 +279,4 @@ declare const useHeader: (name: string) => string | undefined;
 declare const useCookies: () => Record<string, string>;
 declare const useCookie: (name: string) => string | undefined;
 
-export { type PageProps as P, PageContextProvider as a, useCookies as b, createSSRHooks as c, useHeader as d, useHeaders as e, usePageContext as f, useParams as g, useQuery as h, useRequest as i, updatePageContext as j, useCookie as u };
+export { PageContextProvider as P, type PageProps as a, useCookie as b, createSSRHooks as c, useCookies as d, useHeader as e, useHeaders as f, usePageContext as g, useParams as h, useQuery as i, useRequest as j, updatePageContext as u };

package/dist/{use-page-context-CmxWHIK3.d.mts → use-page-context-DXjw-66u.d.mts}

@@ -279,4 +279,4 @@ declare const useHeader: (name: string) => string | undefined;
 declare const useCookies: () => Record<string, string>;
 declare const useCookie: (name: string) => string | undefined;
 
-export { type PageProps as P, PageContextProvider as a, useCookies as b, createSSRHooks as c, useHeader as d, useHeaders as e, usePageContext as f, useParams as g, useQuery as h, useRequest as i, updatePageContext as j, useCookie as u };
+export { PageContextProvider as P, type PageProps as a, useCookie as b, createSSRHooks as c, useCookies as d, useHeader as e, useHeaders as f, usePageContext as g, useParams as h, useQuery as i, useRequest as j, updatePageContext as u };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nestjs-ssr/react",
-  "version": "0.3.13",
+  "version": "0.3.14",
   "description": "React SSR for NestJS that respects Clean Architecture. Proper DI, SOLID principles, clear separation of concerns.",
   "keywords": [
     "nestjs",
@@ -141,11 +141,11 @@
   "dependencies": {
     "citty": "^0.2.1",
     "consola": "^3.4.2",
-    "devalue": "^5.6.3",
+    "devalue": "^5.6.4",
     "escape-html": "^1.0.3"
   },
   "devDependencies": {
-    "@microsoft/api-extractor": "^7.57.6",
+    "@microsoft/api-extractor": "^7.57.7",
     "@nestjs/common": "^11.1.16",
     "@nestjs/core": "^11.1.16",
     "@nestjs/platform-express": "^11.1.16",
@@ -155,14 +155,14 @@
     "@testing-library/react": "^16.3.2",
     "@types/escape-html": "^1.0.4",
     "@types/express": "^5.0.6",
-    "@types/node": "^25.3.5",
+    "@types/node": "^25.5.0",
     "@types/react": "^19.2.14",
     "@types/react-dom": "^19.2.3",
     "@types/supertest": "^7.2.0",
     "@vitejs/plugin-react": "^5.1.4",
-    "@vitest/coverage-v8": "^4.0.18",
-    "@vitest/ui": "^4.0.18",
-    "happy-dom": "^20.8.3",
+    "@vitest/coverage-v8": "^4.1.0",
+    "@vitest/ui": "^4.1.0",
+    "happy-dom": "^20.8.4",
     "react": "^19.2.4",
     "react-dom": "^19.2.4",
     "rxjs": "^7.8.2",
@@ -170,7 +170,7 @@
     "tsup": "^8.5.1",
     "typescript": "^5.9.3",
     "vite": "^7.3.1",
-    "vitest": "^4.0.18"
+    "vitest": "^4.1.0"
   },
   "publishConfig": {
     "access": "public"