@nestjs-ssr/react 0.1.4 → 0.1.6

package/dist/{index-C7qZ7BPg.d.mts → index-Bpzo1KfR.d.mts}

@@ -295,7 +295,7 @@ declare class TemplateParserService {
      * This library handles all edge cases including escaping dangerous characters,
      * functions, dates, regexes, and prevents prototype pollution.
      */
-    buildInlineScripts(data: any, context: any, componentPath: string): string;
+    buildInlineScripts(data: any, context: any, componentName: string): string;
     /**
      * Get client script tag for hydration
      *
@@ -368,12 +368,13 @@ declare class RenderService {
     private isDevelopment;
     private ssrMode;
     private readonly entryServerPath;
+    private readonly entryClientPath;
     constructor(templateParser: TemplateParserService, streamingErrorHandler: StreamingErrorHandler, ssrMode?: SSRMode, defaultHead?: HeadData | undefined);
     setViteServer(vite: ViteDevServer): void;
     /**
      * Main render method that routes to string or stream mode
      */
-    render(viewPath: string, data?: any, res?: Response, head?: HeadData): Promise<string | void>;
+    render(viewComponent: any, data?: any, res?: Response, head?: HeadData): Promise<string | void>;
     /**
      * Merge default head with page-specific head
      * Page-specific head values override defaults

package/dist/{index-C7qZ7BPg.d.ts → index-Bpzo1KfR.d.ts}

@@ -295,7 +295,7 @@ declare class TemplateParserService {
      * This library handles all edge cases including escaping dangerous characters,
      * functions, dates, regexes, and prevents prototype pollution.
      */
-    buildInlineScripts(data: any, context: any, componentPath: string): string;
+    buildInlineScripts(data: any, context: any, componentName: string): string;
     /**
      * Get client script tag for hydration
      *
@@ -368,12 +368,13 @@ declare class RenderService {
     private isDevelopment;
     private ssrMode;
     private readonly entryServerPath;
+    private readonly entryClientPath;
     constructor(templateParser: TemplateParserService, streamingErrorHandler: StreamingErrorHandler, ssrMode?: SSRMode, defaultHead?: HeadData | undefined);
     setViteServer(vite: ViteDevServer): void;
     /**
      * Main render method that routes to string or stream mode
      */
-    render(viewPath: string, data?: any, res?: Response, head?: HeadData): Promise<string | void>;
+    render(viewComponent: any, data?: any, res?: Response, head?: HeadData): Promise<string | void>;
     /**
      * Merge default head with page-specific head
      * Page-specific head values override defaults

package/dist/index.d.mts

@@ -1,8 +1,7 @@
-import { H as HeadData } from './index-C7qZ7BPg.mjs';
-export { E as ErrorPageDevelopment, f as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, e as RenderResponse, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-C7qZ7BPg.mjs';
-import * as _nestjs_common from '@nestjs/common';
-export { viewRegistryPlugin } from './vite/index.mjs';
-import 'react';
+import { H as HeadData } from './index-Bpzo1KfR.mjs';
+export { E as ErrorPageDevelopment, f as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, e as RenderResponse, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-Bpzo1KfR.mjs';
+import React from 'react';
+import '@nestjs/common';
 import 'vite';
 import 'express';
 import '@nestjs/core';
@@ -122,39 +121,49 @@ type PageProps<TProps = {}> = TProps & {
 };
 
 /**
- * Interface for view paths - augmented by the generated view registry.
- * This enables type-safe path validation in Render decorator.
+ * Extract the data type T from PageProps<T>.
+ * PageProps<T> = T & { head?, context }, so we extract T by removing those keys.
  */
-interface ViewPaths {
-}
+type ExtractPagePropsData<P> = P extends PageProps<infer T> ? T : P extends {
+    head?: any;
+    context: any;
+} ? Omit<P, 'head' | 'context'> : P;
 /**
- * Type-safe view path - union of all registered view paths.
- * This is populated via module augmentation from the generated view registry.
+ * Extract controller return type from a React component's props.
  */
-type ViewPath = keyof ViewPaths extends never ? string : keyof ViewPaths;
+type ExtractComponentData<T> = T extends React.ComponentType<infer P> ? ExtractPagePropsData<P> : never;
 /**
  * Decorator to render a React component as the response.
- * Provides IDE autocomplete and type checking for view paths.
  *
- * Works the same as NestJS's @Render() decorator for template engines,
- * but renders React components with SSR instead.
+ * Import the component directly for Cmd+Click navigation in your IDE.
+ * TypeScript automatically validates your controller returns the correct props.
  *
- * @param viewPath - Path to the React component (e.g., 'users/views/user-list')
+ * @param component - The React component to render
  *
  * @example
  * ```typescript
+ * // Your view component (views/home.tsx)
+ * export interface HomeProps {
+ *   message: string;
+ * }
+ * export default function Home(props: PageProps<HomeProps>) { ... }
+ *
+ * // Your controller - Cmd+Click on Home navigates to the view file!
+ * import Home from './views/home';
+ *
  * @Get()
- * @Render('users/views/user-list')
- * getUsers() {
- *   return { users: [...] };
+ * @Render(Home)  // Type-safe! Wrong props = build error
+ * getHome() {
+ *   return { message: 'Hello' }; // ✅ Correct
+ *   // return { wrong: 'prop' }; // ❌ Type error!
  * }
  * ```
  */
-declare const Render: (viewPath: ViewPath) => _nestjs_common.CustomDecorator<string>;
+declare function Render<T extends React.ComponentType<any>>(component: T): <TMethod extends (...args: any[]) => ExtractComponentData<T> | Promise<ExtractComponentData<T>>>(target: any, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<TMethod>) => TypedPropertyDescriptor<TMethod> | void;
 /**
  * @deprecated Use `Render` instead. This alias will be removed in a future version.
  */
-declare const ReactRender: (viewPath: ViewPath) => _nestjs_common.CustomDecorator<string>;
+declare const ReactRender: typeof Render;
 
 /**
  * Hook to access the full page context.
@@ -217,4 +226,4 @@ declare function useQuery(): Record<string, string | string[]>;
  */
 declare function useUserAgent(): string | undefined;
 
-export { HeadData, type PageProps, ReactRender, Render, type RenderContext, type ViewPath, type ViewPaths, usePageContext, useParams, useQuery, useUserAgent };
+export { HeadData, type PageProps, ReactRender, Render, type RenderContext, usePageContext, useParams, useQuery, useUserAgent };

package/dist/index.d.ts

@@ -1,8 +1,7 @@
-import { H as HeadData } from './index-C7qZ7BPg.js';
-export { E as ErrorPageDevelopment, f as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, e as RenderResponse, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-C7qZ7BPg.js';
-import * as _nestjs_common from '@nestjs/common';
-export { viewRegistryPlugin } from './vite/index.js';
-import 'react';
+import { H as HeadData } from './index-Bpzo1KfR.js';
+export { E as ErrorPageDevelopment, f as ErrorPageProduction, c as RenderConfig, b as RenderInterceptor, R as RenderModule, e as RenderResponse, a as RenderService, d as SSRMode, S as StreamingErrorHandler, T as TemplateParserService } from './index-Bpzo1KfR.js';
+import React from 'react';
+import '@nestjs/common';
 import 'vite';
 import 'express';
 import '@nestjs/core';
@@ -122,39 +121,49 @@ type PageProps<TProps = {}> = TProps & {
 };
 
 /**
- * Interface for view paths - augmented by the generated view registry.
- * This enables type-safe path validation in Render decorator.
+ * Extract the data type T from PageProps<T>.
+ * PageProps<T> = T & { head?, context }, so we extract T by removing those keys.
  */
-interface ViewPaths {
-}
+type ExtractPagePropsData<P> = P extends PageProps<infer T> ? T : P extends {
+    head?: any;
+    context: any;
+} ? Omit<P, 'head' | 'context'> : P;
 /**
- * Type-safe view path - union of all registered view paths.
- * This is populated via module augmentation from the generated view registry.
+ * Extract controller return type from a React component's props.
  */
-type ViewPath = keyof ViewPaths extends never ? string : keyof ViewPaths;
+type ExtractComponentData<T> = T extends React.ComponentType<infer P> ? ExtractPagePropsData<P> : never;
 /**
  * Decorator to render a React component as the response.
- * Provides IDE autocomplete and type checking for view paths.
  *
- * Works the same as NestJS's @Render() decorator for template engines,
- * but renders React components with SSR instead.
+ * Import the component directly for Cmd+Click navigation in your IDE.
+ * TypeScript automatically validates your controller returns the correct props.
  *
- * @param viewPath - Path to the React component (e.g., 'users/views/user-list')
+ * @param component - The React component to render
  *
  * @example
  * ```typescript
+ * // Your view component (views/home.tsx)
+ * export interface HomeProps {
+ *   message: string;
+ * }
+ * export default function Home(props: PageProps<HomeProps>) { ... }
+ *
+ * // Your controller - Cmd+Click on Home navigates to the view file!
+ * import Home from './views/home';
+ *
  * @Get()
- * @Render('users/views/user-list')
- * getUsers() {
- *   return { users: [...] };
+ * @Render(Home)  // Type-safe! Wrong props = build error
+ * getHome() {
+ *   return { message: 'Hello' }; // ✅ Correct
+ *   // return { wrong: 'prop' }; // ❌ Type error!
  * }
  * ```
  */
-declare const Render: (viewPath: ViewPath) => _nestjs_common.CustomDecorator<string>;
+declare function Render<T extends React.ComponentType<any>>(component: T): <TMethod extends (...args: any[]) => ExtractComponentData<T> | Promise<ExtractComponentData<T>>>(target: any, propertyKey: string | symbol, descriptor: TypedPropertyDescriptor<TMethod>) => TypedPropertyDescriptor<TMethod> | void;
 /**
  * @deprecated Use `Render` instead. This alias will be removed in a future version.
  */
-declare const ReactRender: (viewPath: ViewPath) => _nestjs_common.CustomDecorator<string>;
+declare const ReactRender: typeof Render;
 
 /**
  * Hook to access the full page context.
@@ -217,4 +226,4 @@ declare function useQuery(): Record<string, string | string[]>;
  */
 declare function useUserAgent(): string | undefined;
 
-export { HeadData, type PageProps, ReactRender, Render, type RenderContext, type ViewPath, type ViewPaths, usePageContext, useParams, useQuery, useUserAgent };
+export { HeadData, type PageProps, ReactRender, Render, type RenderContext, usePageContext, useParams, useQuery, useUserAgent };