@nestjs-ssr/react 0.2.3 → 0.2.5

package/dist/index.js

@@ -1154,39 +1154,32 @@ exports.RenderModule = class _RenderModule {
     __name(this, "RenderModule");
   }
   /**
-  * Register the render module with optional configuration
+  * Configure the render module
   *
   * @param config - Optional render configuration
   * @returns Dynamic module
   *
   * @example
   * ```ts
-  * // Zero config - embedded mode by default (simplest)
-  * @Module({
-  *   imports: [RenderModule],
-  * })
+  * // Zero config - uses defaults
+  * RenderModule.forRoot()
+  *
+  * // Enable streaming SSR
+  * RenderModule.forRoot({ mode: 'stream' })
   *
   * // Enable HMR with proxy mode
-  * @Module({
-  *   imports: [
-  *     RenderModule.register({
-  *       vite: { mode: 'proxy', port: 5173 }
-  *     })
-  *   ],
+  * RenderModule.forRoot({
+  *   vite: { mode: 'proxy', port: 5173 }
   * })
   *
-  * // Enable streaming SSR
-  * RenderModule.register({ mode: 'stream' })
-  *
   * // Custom error pages
-  * RenderModule.register({
-  *   mode: 'stream',
-  *   errorPageDevelopment: MyCustomDevErrorPage,
-  *   errorPageProduction: MyCustomProdErrorPage,
+  * RenderModule.forRoot({
+  *   errorPageDevelopment: DevErrorPage,
+  *   errorPageProduction: ProdErrorPage,
   * })
   * ```
   */
-  static register(config) {
+  static forRoot(config) {
     const providers = [
       exports.RenderService,
       exports.TemplateParserService,
@@ -1249,35 +1242,42 @@ exports.RenderModule = class _RenderModule {
     };
   }
   /**
-  * Register the render module asynchronously with dynamic configuration
+  * Configure the render module with async factory
   *
-  * Use this when you need to inject services (e.g., load config from database)
+  * Use when configuration depends on other services (database, config service, etc.)
   *
   * @param options - Async configuration options
   * @returns Dynamic module
   *
   * @example
   * ```ts
-  * // Load default head from database
-  * RenderModule.registerAsync({
+  * // Load config from ConfigService
+  * RenderModule.forRootAsync({
+  *   imports: [ConfigModule],
+  *   inject: [ConfigService],
+  *   useFactory: (config: ConfigService) => ({
+  *     mode: config.get('SSR_MODE'),
+  *     defaultHead: { title: config.get('APP_NAME') },
+  *   }),
+  * })
+  *
+  * // Load from database
+  * RenderModule.forRootAsync({
   *   imports: [TenantModule],
-  *   inject: [TenantRepository],
-  *   useFactory: async (tenantRepo: TenantRepository) => {
-  *     const tenant = await tenantRepo.findDefaultTenant();
+  *   inject: [TenantService],
+  *   useFactory: async (tenantService: TenantService) => {
+  *     const tenant = await tenantService.getCurrent();
   *     return {
   *       defaultHead: {
-  *         title: tenant.appName,
-  *         description: tenant.description,
-  *         links: [
-  *           { rel: 'icon', href: tenant.favicon }
-  *         ]
-  *       }
+  *         title: tenant.name,
+  *         links: [{ rel: 'icon', href: tenant.favicon }],
+  *       },
   *     };
-  *   }
+  *   },
   * })
   * ```
   */
-  static registerAsync(options) {
+  static forRootAsync(options) {
     const configProvider = {
       provide: "RENDER_CONFIG",
       useFactory: options.useFactory,
@@ -1293,7 +1293,6 @@ exports.RenderModule = class _RenderModule {
         provide: core.APP_INTERCEPTOR,
         useClass: exports.RenderInterceptor
       },
-      // Vite configuration provider - reads from config
       {
         provide: "VITE_CONFIG",
         useFactory: /* @__PURE__ */ __name((config) => config?.vite || {}, "useFactory"),
@@ -1301,7 +1300,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // SSR mode provider - reads from config
       {
         provide: "SSR_MODE",
         useFactory: /* @__PURE__ */ __name((config) => config?.mode, "useFactory"),
@@ -1309,7 +1307,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Error page providers - read from config
       {
         provide: "ERROR_PAGE_DEVELOPMENT",
         useFactory: /* @__PURE__ */ __name((config) => config?.errorPageDevelopment, "useFactory"),
@@ -1324,7 +1321,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Default head provider - reads from config
       {
         provide: "DEFAULT_HEAD",
         useFactory: /* @__PURE__ */ __name((config) => config?.defaultHead, "useFactory"),
@@ -1332,7 +1328,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Custom template provider - reads from config
       {
         provide: "CUSTOM_TEMPLATE",
         useFactory: /* @__PURE__ */ __name((config) => config?.template, "useFactory"),
@@ -1340,7 +1335,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Allowed headers provider - reads from config
       {
         provide: "ALLOWED_HEADERS",
         useFactory: /* @__PURE__ */ __name((config) => config?.allowedHeaders || [], "useFactory"),
@@ -1348,7 +1342,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Allowed cookies provider - reads from config
       {
         provide: "ALLOWED_COOKIES",
         useFactory: /* @__PURE__ */ __name((config) => config?.allowedCookies || [], "useFactory"),
@@ -1367,6 +1360,18 @@ exports.RenderModule = class _RenderModule {
       ]
     };
   }
+  /**
+  * @deprecated Use forRoot() instead
+  */
+  static register(config) {
+    return this.forRoot(config);
+  }
+  /**
+  * @deprecated Use forRootAsync() instead
+  */
+  static registerAsync(options) {
+    return this.forRootAsync(options);
+  }
 };
 exports.RenderModule = _ts_decorate6([
   common.Global(),
@@ -1471,7 +1476,7 @@ function createSSRHooks() {
     *
     * Configure in module registration:
     * ```typescript
-    * RenderModule.register({
+    * RenderModule.forRoot({
     *   allowedHeaders: ['user-agent', 'x-tenant-id', 'x-api-version']
     * })
     * ```
@@ -1533,7 +1538,7 @@ function createSSRHooks() {
     *
     * Configure in module registration:
     * ```typescript
-    * RenderModule.register({
+    * RenderModule.forRoot({
     *   allowedCookies: ['theme', 'locale', 'consent']
     * })
     * ```

package/dist/index.mjs

@@ -1147,39 +1147,32 @@ var RenderModule = class _RenderModule {
     __name(this, "RenderModule");
   }
   /**
-  * Register the render module with optional configuration
+  * Configure the render module
   *
   * @param config - Optional render configuration
   * @returns Dynamic module
   *
   * @example
   * ```ts
-  * // Zero config - embedded mode by default (simplest)
-  * @Module({
-  *   imports: [RenderModule],
-  * })
+  * // Zero config - uses defaults
+  * RenderModule.forRoot()
+  *
+  * // Enable streaming SSR
+  * RenderModule.forRoot({ mode: 'stream' })
   *
   * // Enable HMR with proxy mode
-  * @Module({
-  *   imports: [
-  *     RenderModule.register({
-  *       vite: { mode: 'proxy', port: 5173 }
-  *     })
-  *   ],
+  * RenderModule.forRoot({
+  *   vite: { mode: 'proxy', port: 5173 }
   * })
   *
-  * // Enable streaming SSR
-  * RenderModule.register({ mode: 'stream' })
-  *
   * // Custom error pages
-  * RenderModule.register({
-  *   mode: 'stream',
-  *   errorPageDevelopment: MyCustomDevErrorPage,
-  *   errorPageProduction: MyCustomProdErrorPage,
+  * RenderModule.forRoot({
+  *   errorPageDevelopment: DevErrorPage,
+  *   errorPageProduction: ProdErrorPage,
   * })
   * ```
   */
-  static register(config) {
+  static forRoot(config) {
     const providers = [
       RenderService,
       TemplateParserService,
@@ -1242,35 +1235,42 @@ var RenderModule = class _RenderModule {
     };
   }
   /**
-  * Register the render module asynchronously with dynamic configuration
+  * Configure the render module with async factory
   *
-  * Use this when you need to inject services (e.g., load config from database)
+  * Use when configuration depends on other services (database, config service, etc.)
   *
   * @param options - Async configuration options
   * @returns Dynamic module
   *
   * @example
   * ```ts
-  * // Load default head from database
-  * RenderModule.registerAsync({
+  * // Load config from ConfigService
+  * RenderModule.forRootAsync({
+  *   imports: [ConfigModule],
+  *   inject: [ConfigService],
+  *   useFactory: (config: ConfigService) => ({
+  *     mode: config.get('SSR_MODE'),
+  *     defaultHead: { title: config.get('APP_NAME') },
+  *   }),
+  * })
+  *
+  * // Load from database
+  * RenderModule.forRootAsync({
   *   imports: [TenantModule],
-  *   inject: [TenantRepository],
-  *   useFactory: async (tenantRepo: TenantRepository) => {
-  *     const tenant = await tenantRepo.findDefaultTenant();
+  *   inject: [TenantService],
+  *   useFactory: async (tenantService: TenantService) => {
+  *     const tenant = await tenantService.getCurrent();
   *     return {
   *       defaultHead: {
-  *         title: tenant.appName,
-  *         description: tenant.description,
-  *         links: [
-  *           { rel: 'icon', href: tenant.favicon }
-  *         ]
-  *       }
+  *         title: tenant.name,
+  *         links: [{ rel: 'icon', href: tenant.favicon }],
+  *       },
   *     };
-  *   }
+  *   },
   * })
   * ```
   */
-  static registerAsync(options) {
+  static forRootAsync(options) {
     const configProvider = {
       provide: "RENDER_CONFIG",
       useFactory: options.useFactory,
@@ -1286,7 +1286,6 @@ var RenderModule = class _RenderModule {
         provide: APP_INTERCEPTOR,
         useClass: RenderInterceptor
       },
-      // Vite configuration provider - reads from config
       {
         provide: "VITE_CONFIG",
         useFactory: /* @__PURE__ */ __name((config) => config?.vite || {}, "useFactory"),
@@ -1294,7 +1293,6 @@ var RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // SSR mode provider - reads from config
       {
         provide: "SSR_MODE",
         useFactory: /* @__PURE__ */ __name((config) => config?.mode, "useFactory"),
@@ -1302,7 +1300,6 @@ var RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Error page providers - read from config
       {
         provide: "ERROR_PAGE_DEVELOPMENT",
         useFactory: /* @__PURE__ */ __name((config) => config?.errorPageDevelopment, "useFactory"),
@@ -1317,7 +1314,6 @@ var RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Default head provider - reads from config
       {
         provide: "DEFAULT_HEAD",
         useFactory: /* @__PURE__ */ __name((config) => config?.defaultHead, "useFactory"),
@@ -1325,7 +1321,6 @@ var RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Custom template provider - reads from config
       {
         provide: "CUSTOM_TEMPLATE",
         useFactory: /* @__PURE__ */ __name((config) => config?.template, "useFactory"),
@@ -1333,7 +1328,6 @@ var RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Allowed headers provider - reads from config
       {
         provide: "ALLOWED_HEADERS",
         useFactory: /* @__PURE__ */ __name((config) => config?.allowedHeaders || [], "useFactory"),
@@ -1341,7 +1335,6 @@ var RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Allowed cookies provider - reads from config
       {
         provide: "ALLOWED_COOKIES",
         useFactory: /* @__PURE__ */ __name((config) => config?.allowedCookies || [], "useFactory"),
@@ -1360,6 +1353,18 @@ var RenderModule = class _RenderModule {
       ]
     };
   }
+  /**
+  * @deprecated Use forRoot() instead
+  */
+  static register(config) {
+    return this.forRoot(config);
+  }
+  /**
+  * @deprecated Use forRootAsync() instead
+  */
+  static registerAsync(options) {
+    return this.forRootAsync(options);
+  }
 };
 RenderModule = _ts_decorate6([
   Global(),
@@ -1464,7 +1469,7 @@ function createSSRHooks() {
     *
     * Configure in module registration:
     * ```typescript
-    * RenderModule.register({
+    * RenderModule.forRoot({
     *   allowedHeaders: ['user-agent', 'x-tenant-id', 'x-api-version']
     * })
     * ```
@@ -1526,7 +1531,7 @@ function createSSRHooks() {
     *
     * Configure in module registration:
     * ```typescript
-    * RenderModule.register({
+    * RenderModule.forRoot({
     *   allowedCookies: ['theme', 'locale', 'consent']
     * })
     * ```

package/dist/render/index.d.mts

@@ -1,4 +1,4 @@
-export { E as ErrorPageDevelopment, e as ErrorPageProduction, b as RenderInterceptor, R as RenderModule, a as RenderService, S as StreamingErrorHandler, T as TemplateParserService } from '../index-Dq1yt0sX.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-BMdluY1g.mjs';
 import '@nestjs/common';
 import 'react';
 import '../render-response.interface-Dc-Kwb09.mjs';

package/dist/render/index.d.ts

@@ -1,4 +1,4 @@
-export { E as ErrorPageDevelopment, e as ErrorPageProduction, b as RenderInterceptor, R as RenderModule, a as RenderService, S as StreamingErrorHandler, T as TemplateParserService } from '../index-CaGD266H.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-rl0S5kqW.js';
 import '@nestjs/common';
 import 'react';
 import '../render-response.interface-Dc-Kwb09.js';

package/dist/render/index.js

@@ -1136,39 +1136,32 @@ exports.RenderModule = class _RenderModule {
     __name(this, "RenderModule");
   }
   /**
-  * Register the render module with optional configuration
+  * Configure the render module
   *
   * @param config - Optional render configuration
   * @returns Dynamic module
   *
   * @example
   * ```ts
-  * // Zero config - embedded mode by default (simplest)
-  * @Module({
-  *   imports: [RenderModule],
-  * })
+  * // Zero config - uses defaults
+  * RenderModule.forRoot()
+  *
+  * // Enable streaming SSR
+  * RenderModule.forRoot({ mode: 'stream' })
   *
   * // Enable HMR with proxy mode
-  * @Module({
-  *   imports: [
-  *     RenderModule.register({
-  *       vite: { mode: 'proxy', port: 5173 }
-  *     })
-  *   ],
+  * RenderModule.forRoot({
+  *   vite: { mode: 'proxy', port: 5173 }
   * })
   *
-  * // Enable streaming SSR
-  * RenderModule.register({ mode: 'stream' })
-  *
   * // Custom error pages
-  * RenderModule.register({
-  *   mode: 'stream',
-  *   errorPageDevelopment: MyCustomDevErrorPage,
-  *   errorPageProduction: MyCustomProdErrorPage,
+  * RenderModule.forRoot({
+  *   errorPageDevelopment: DevErrorPage,
+  *   errorPageProduction: ProdErrorPage,
   * })
   * ```
   */
-  static register(config) {
+  static forRoot(config) {
     const providers = [
       exports.RenderService,
       exports.TemplateParserService,
@@ -1231,35 +1224,42 @@ exports.RenderModule = class _RenderModule {
     };
   }
   /**
-  * Register the render module asynchronously with dynamic configuration
+  * Configure the render module with async factory
   *
-  * Use this when you need to inject services (e.g., load config from database)
+  * Use when configuration depends on other services (database, config service, etc.)
   *
   * @param options - Async configuration options
   * @returns Dynamic module
   *
   * @example
   * ```ts
-  * // Load default head from database
-  * RenderModule.registerAsync({
+  * // Load config from ConfigService
+  * RenderModule.forRootAsync({
+  *   imports: [ConfigModule],
+  *   inject: [ConfigService],
+  *   useFactory: (config: ConfigService) => ({
+  *     mode: config.get('SSR_MODE'),
+  *     defaultHead: { title: config.get('APP_NAME') },
+  *   }),
+  * })
+  *
+  * // Load from database
+  * RenderModule.forRootAsync({
   *   imports: [TenantModule],
-  *   inject: [TenantRepository],
-  *   useFactory: async (tenantRepo: TenantRepository) => {
-  *     const tenant = await tenantRepo.findDefaultTenant();
+  *   inject: [TenantService],
+  *   useFactory: async (tenantService: TenantService) => {
+  *     const tenant = await tenantService.getCurrent();
   *     return {
   *       defaultHead: {
-  *         title: tenant.appName,
-  *         description: tenant.description,
-  *         links: [
-  *           { rel: 'icon', href: tenant.favicon }
-  *         ]
-  *       }
+  *         title: tenant.name,
+  *         links: [{ rel: 'icon', href: tenant.favicon }],
+  *       },
   *     };
-  *   }
+  *   },
   * })
   * ```
   */
-  static registerAsync(options) {
+  static forRootAsync(options) {
     const configProvider = {
       provide: "RENDER_CONFIG",
       useFactory: options.useFactory,
@@ -1275,7 +1275,6 @@ exports.RenderModule = class _RenderModule {
         provide: core.APP_INTERCEPTOR,
         useClass: exports.RenderInterceptor
       },
-      // Vite configuration provider - reads from config
       {
         provide: "VITE_CONFIG",
         useFactory: /* @__PURE__ */ __name((config) => config?.vite || {}, "useFactory"),
@@ -1283,7 +1282,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // SSR mode provider - reads from config
       {
         provide: "SSR_MODE",
         useFactory: /* @__PURE__ */ __name((config) => config?.mode, "useFactory"),
@@ -1291,7 +1289,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Error page providers - read from config
       {
         provide: "ERROR_PAGE_DEVELOPMENT",
         useFactory: /* @__PURE__ */ __name((config) => config?.errorPageDevelopment, "useFactory"),
@@ -1306,7 +1303,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Default head provider - reads from config
       {
         provide: "DEFAULT_HEAD",
         useFactory: /* @__PURE__ */ __name((config) => config?.defaultHead, "useFactory"),
@@ -1314,7 +1310,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Custom template provider - reads from config
       {
         provide: "CUSTOM_TEMPLATE",
         useFactory: /* @__PURE__ */ __name((config) => config?.template, "useFactory"),
@@ -1322,7 +1317,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Allowed headers provider - reads from config
       {
         provide: "ALLOWED_HEADERS",
         useFactory: /* @__PURE__ */ __name((config) => config?.allowedHeaders || [], "useFactory"),
@@ -1330,7 +1324,6 @@ exports.RenderModule = class _RenderModule {
           "RENDER_CONFIG"
         ]
       },
-      // Allowed cookies provider - reads from config
       {
         provide: "ALLOWED_COOKIES",
         useFactory: /* @__PURE__ */ __name((config) => config?.allowedCookies || [], "useFactory"),
@@ -1349,6 +1342,18 @@ exports.RenderModule = class _RenderModule {
       ]
     };
   }
+  /**
+  * @deprecated Use forRoot() instead
+  */
+  static register(config) {
+    return this.forRoot(config);
+  }
+  /**
+  * @deprecated Use forRootAsync() instead
+  */
+  static registerAsync(options) {
+    return this.forRootAsync(options);
+  }
 };
 exports.RenderModule = _ts_decorate6([
   common.Global(),