@reldens/cms 0.85.0 → 0.86.0

package/.claude/installation-guide.md

@@ -1,225 +1,225 @@
-# Advanced Installation Guide
-
-## Subprocess Installation Handling
-
-The installer supports complex operations through subprocess management:
-
-```javascript
-const { Installer } = require('@reldens/cms');
-const { Logger } = require('@reldens/utils');
-
-let installer = new Installer({
-    projectRoot: process.cwd(),
-    subprocessMaxAttempts: 1800,
-    postInstallCallback: async (props) => {
-        Logger.info('Entities loaded: '+Object.keys(props.loadedEntities.rawRegisteredEntities).length);
-        return true;
-    }
-});
-```
-
-**The installer automatically handles:**
-
-- Package dependency checking and installation
-- Database schema creation via subprocess
-- Prisma client generation with progress tracking
-- Entity generation with validation
-- Environment file creation
-- Directory structure setup
-
-## Enhanced Manager Initialization
-
-The Manager class provides comprehensive service initialization:
-
-```javascript
-let cms = new Manager({
-    app: customExpressApp,
-    appServer: customAppServer,
-    dataServer: customDataServer,
-    adminManager: customAdmin,
-    frontend: customFrontend,
-    adminRoleId: 99,
-    authenticationMethod: 'db-users',
-    authenticationCallback: async (email, password, roleId) => {
-        return await yourAuthService.validate(email, password, roleId);
-    },
-    cache: true,
-    reloadTime: -1,
-    defaultDomain: 'example.com',
-    domainMapping: {'dev.example.com': 'development'},
-    siteKeyMapping: {'example.com': 'main'}
-});
-```
-
-**Manager automatically:**
-
-- Validates all provided instances
-- Initializes missing services
-- Auto-creates `PrismaClient` via `PrismaClientLoader` from `@reldens/storage` when `RELDENS_STORAGE_DRIVER=prisma` and no `prismaClient` is passed in — no Prisma imports needed in your entry point
-- Sets up entity access control
-- Generates admin entities
-- Configures template reloading
-
-## Development Mode Detection
-
-The CMS automatically detects development environments based on domain patterns.
-
-**Default Development Patterns:**
-
-```javascript
-let patterns = [
-    'localhost',
-    '127.0.0.1',
-    '.local',
-    '.test',
-    '.dev',
-    '.acc',
-    '.staging',
-    'local.',
-    'test.',
-    'dev.',
-    'acc.',
-    'staging.'
-];
-```
-
-**Override Development Patterns:**
-
-```javascript
-let cms = new Manager({
-    developmentPatterns: [
-        'localhost',
-        '127.0.0.1',
-        '.local'
-    ],
-    domainMapping: {
-        'www.example.com': 'example.com',
-        'new.example.com': 'example.com'
-    }
-});
-```
-
-**Important Notes:**
-
-- Domain patterns only match at the start or end of domains, not arbitrary positions
-- Override `developmentPatterns` in production to prevent staging/acc domains from enabling development mode
-
-## Security Configuration
-
-### External Domains for CSP
-
-Configure external domains for CSP directives (kebab-case or camelCase):
-
-```javascript
-let cms = new Manager({
-    appServerConfig: {
-        developmentExternalDomains: {
-            'scriptSrc': ['https://cdn.example.com'],
-            'script-src': ['https://analytics.example.com'],
-            'styleSrc': ['https://fonts.googleapis.com'],
-            'font-src': ['https://fonts.gstatic.com']
-        }
-    }
-});
-```
-
-**The system automatically:**
-
-- Converts kebab-case keys to camelCase
-- Adds domains to both the base directive and the -elem variant
-
-### CSP Directive Merging vs Override
-
-**Default (merge with base directives):**
-
-```javascript
-let cms = new Manager({
-    appServerConfig: {
-        helmetConfig: {
-            contentSecurityPolicy: {
-                directives: {
-                    scriptSrc: ['https://cdn.example.com']
-                }
-            }
-        }
-    }
-});
-```
-
-**Default Base Directives:**
-
-```javascript
-{
-    defaultSrc: ["'self'"],
-    scriptSrc: ["'self'"],
-    scriptSrcElem: ["'self'"],
-    styleSrc: ["'self'", "'unsafe-inline'"],
-    styleSrcElem: ["'self'", "'unsafe-inline'"],
-    imgSrc: ["'self'", "data:", "https:"],
-    fontSrc: ["'self'"],
-    connectSrc: ["'self'"],
-    frameAncestors: ["'none'"],
-    baseUri: ["'self'"],
-    formAction: ["'self'"]
-}
-```
-
-**Complete Replacement:**
-
-```javascript
-let cms = new Manager({
-    appServerConfig: {
-        helmetConfig: {
-            contentSecurityPolicy: {
-                overrideDirectives: true,
-                directives: {
-                    defaultSrc: ["'self'"],
-                    scriptSrc: ["'self'", "https://trusted-cdn.com"],
-                    styleSrc: ["'self'", "'unsafe-inline'"],
-                    imgSrc: ["'self'", "data:", "https:"],
-                    fontSrc: ["'self'"],
-                    connectSrc: ["'self'"],
-                    frameAncestors: ["'none'"],
-                    baseUri: ["'self'"],
-                    formAction: ["'self'"]
-                }
-            }
-        }
-    }
-});
-```
-
-### Additional Helmet Security Headers
-
-```javascript
-let cms = new Manager({
-    appServerConfig: {
-        helmetConfig: {
-            hsts: {
-                maxAge: 31536000,
-                includeSubDomains: true,
-                preload: true
-            },
-            crossOriginOpenerPolicy: {
-                policy: "same-origin"
-            },
-            crossOriginResourcePolicy: {
-                policy: "same-origin"
-            },
-            crossOriginEmbedderPolicy: {
-                policy: "require-corp"
-            }
-        }
-    }
-});
-```
-
-**Note:** In development mode, CSP and HSTS are automatically disabled. Security headers are only enforced in production.
-
-**Trusted Types:** To enable Trusted Types for enhanced XSS protection:
-
-```javascript
-requireTrustedTypesFor: ["'script'"]
-```
-
-However, this requires updating all JavaScript code to use the Trusted Types API.
+# Advanced Installation Guide
+
+## Subprocess Installation Handling
+
+The installer supports complex operations through subprocess management:
+
+```javascript
+const { Installer } = require('@reldens/cms');
+const { Logger } = require('@reldens/utils');
+
+let installer = new Installer({
+    projectRoot: process.cwd(),
+    subprocessMaxAttempts: 1800,
+    postInstallCallback: async (props) => {
+        Logger.info('Entities loaded: '+Object.keys(props.loadedEntities.rawRegisteredEntities).length);
+        return true;
+    }
+});
+```
+
+**The installer automatically handles:**
+
+- Package dependency checking and installation
+- Database schema creation via subprocess
+- Prisma client generation with progress tracking
+- Entity generation with validation
+- Environment file creation
+- Directory structure setup
+
+## Enhanced Manager Initialization
+
+The Manager class provides comprehensive service initialization:
+
+```javascript
+let cms = new Manager({
+    app: customExpressApp,
+    appServer: customAppServer,
+    dataServer: customDataServer,
+    adminManager: customAdmin,
+    frontend: customFrontend,
+    adminRoleId: 99,
+    authenticationMethod: 'db-users',
+    authenticationCallback: async (email, password, roleId) => {
+        return await yourAuthService.validate(email, password, roleId);
+    },
+    cache: true,
+    reloadTime: -1,
+    defaultDomain: 'example.com',
+    domainMapping: {'dev.example.com': 'development'},
+    siteKeyMapping: {'example.com': 'main'}
+});
+```
+
+**Manager automatically:**
+
+- Validates all provided instances
+- Initializes missing services
+- Auto-loads the Prisma modules via `PrismaClientLoader` from `@reldens/storage` when `RELDENS_STORAGE_DRIVER=prisma` and no `prismaModules` is passed in, resolving the adapter from `prismaAdapter` / `prismaAdapterClass` props (defaults from `RELDENS_PRISMA_ADAPTER` / `RELDENS_PRISMA_ADAPTER_CLASS`) — no Prisma imports needed in your entry point
+- Sets up entity access control
+- Generates admin entities
+- Configures template reloading
+
+## Development Mode Detection
+
+The CMS automatically detects development environments based on domain patterns.
+
+**Default Development Patterns:**
+
+```javascript
+let patterns = [
+    'localhost',
+    '127.0.0.1',
+    '.local',
+    '.test',
+    '.dev',
+    '.acc',
+    '.staging',
+    'local.',
+    'test.',
+    'dev.',
+    'acc.',
+    'staging.'
+];
+```
+
+**Override Development Patterns:**
+
+```javascript
+let cms = new Manager({
+    developmentPatterns: [
+        'localhost',
+        '127.0.0.1',
+        '.local'
+    ],
+    domainMapping: {
+        'www.example.com': 'example.com',
+        'new.example.com': 'example.com'
+    }
+});
+```
+
+**Important Notes:**
+
+- Domain patterns only match at the start or end of domains, not arbitrary positions
+- Override `developmentPatterns` in production to prevent staging/acc domains from enabling development mode
+
+## Security Configuration
+
+### External Domains for CSP
+
+Configure external domains for CSP directives (kebab-case or camelCase):
+
+```javascript
+let cms = new Manager({
+    appServerConfig: {
+        developmentExternalDomains: {
+            'scriptSrc': ['https://cdn.example.com'],
+            'script-src': ['https://analytics.example.com'],
+            'styleSrc': ['https://fonts.googleapis.com'],
+            'font-src': ['https://fonts.gstatic.com']
+        }
+    }
+});
+```
+
+**The system automatically:**
+
+- Converts kebab-case keys to camelCase
+- Adds domains to both the base directive and the -elem variant
+
+### CSP Directive Merging vs Override
+
+**Default (merge with base directives):**
+
+```javascript
+let cms = new Manager({
+    appServerConfig: {
+        helmetConfig: {
+            contentSecurityPolicy: {
+                directives: {
+                    scriptSrc: ['https://cdn.example.com']
+                }
+            }
+        }
+    }
+});
+```
+
+**Default Base Directives:**
+
+```javascript
+{
+    defaultSrc: ["'self'"],
+    scriptSrc: ["'self'"],
+    scriptSrcElem: ["'self'"],
+    styleSrc: ["'self'", "'unsafe-inline'"],
+    styleSrcElem: ["'self'", "'unsafe-inline'"],
+    imgSrc: ["'self'", "data:", "https:"],
+    fontSrc: ["'self'"],
+    connectSrc: ["'self'"],
+    frameAncestors: ["'none'"],
+    baseUri: ["'self'"],
+    formAction: ["'self'"]
+}
+```
+
+**Complete Replacement:**
+
+```javascript
+let cms = new Manager({
+    appServerConfig: {
+        helmetConfig: {
+            contentSecurityPolicy: {
+                overrideDirectives: true,
+                directives: {
+                    defaultSrc: ["'self'"],
+                    scriptSrc: ["'self'", "https://trusted-cdn.com"],
+                    styleSrc: ["'self'", "'unsafe-inline'"],
+                    imgSrc: ["'self'", "data:", "https:"],
+                    fontSrc: ["'self'"],
+                    connectSrc: ["'self'"],
+                    frameAncestors: ["'none'"],
+                    baseUri: ["'self'"],
+                    formAction: ["'self'"]
+                }
+            }
+        }
+    }
+});
+```
+
+### Additional Helmet Security Headers
+
+```javascript
+let cms = new Manager({
+    appServerConfig: {
+        helmetConfig: {
+            hsts: {
+                maxAge: 31536000,
+                includeSubDomains: true,
+                preload: true
+            },
+            crossOriginOpenerPolicy: {
+                policy: "same-origin"
+            },
+            crossOriginResourcePolicy: {
+                policy: "same-origin"
+            },
+            crossOriginEmbedderPolicy: {
+                policy: "require-corp"
+            }
+        }
+    }
+});
+```
+
+**Note:** In development mode, CSP and HSTS are automatically disabled. Security headers are only enforced in production.
+
+**Trusted Types:** To enable Trusted Types for enhanced XSS protection:
+
+```javascript
+requireTrustedTypesFor: ["'script'"]
+```
+
+However, this requires updating all JavaScript code to use the Trusted Types API.

package/.claude/password-management-guide.md

@@ -102,9 +102,9 @@ npx reldens-cms-update-password --email=admin@example.com --password=newPassword
 #### How It Works
 
 The CLI tool is **driver-agnostic** and works with any storage driver:
-1. Reads `RELDENS_STORAGE_DRIVER` from .env (defaults to 'prisma')
+1. Reads `RELDENS_STORAGE_DRIVER` from .env (defaults to 'mikro-orm')
 2. Uses `EntitiesLoader` to load entities for the detected driver
-3. If driver is 'prisma', automatically loads Prisma client from `./prisma/client`
+3. If driver is 'prisma', automatically loads the Prisma modules from `./prisma/client` using the adapter from `RELDENS_PRISMA_ADAPTER` / `RELDENS_PRISMA_ADAPTER_CLASS`
 4. Initializes Manager and dataServer with the correct driver
 5. Updates password using the driver's entity repository
 

package/CLAUDE.md

@@ -99,7 +99,7 @@ RELDENS_APP_PORT=8080
 RELDENS_ADMIN_ROUTE_PATH=/admin
 RELDENS_ADMIN_SECRET=your-secret-key
 RELDENS_DB_CLIENT=mysql
-RELDENS_STORAGE_DRIVER=prisma
+RELDENS_STORAGE_DRIVER=mikro-orm
 ```
 
 **Manager Configuration:**

package/README.md

@@ -45,7 +45,7 @@ A powerful, flexible Content Management System built with Node.js, featuring an
 - **Template-driven UI** with customizable admin themes
 
 ### -️ Database & Entities
-- **Multiple database drivers** (Prisma by default, others via DriversMap)
+- **Multiple database drivers** (MikroORM by default, others via DriversMap)
 - **Automatic entity generation** from a database schema
 - **Relationship mapping** and foreign key handling
 - **Custom entity configuration** with validation rules

package/bin/reldens-cms-generate-entities.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  *
@@ -7,8 +7,11 @@
  */
 
 const { Manager } = require('../index');
-const { PrismaClientLoader } = require('@reldens/storage');
+const { ManagerConfigLoader } = require('../lib/manager-config-loader');
+const { ManagerServicesInitializer } = require('../lib/manager-services-initializer');
 const { Logger, sc } = require('@reldens/utils');
+const { FileHandler } = require('@reldens/server-utils');
+const dotenv = require('dotenv');
 const readline = require('readline');
 
 class CmsEntitiesGenerator
@@ -58,7 +61,7 @@ class CmsEntitiesGenerator
         Logger.info('');
         Logger.info('Options:');
         Logger.info('  --prisma-client=[path]           Path to Prisma client (e.g., ./prisma/client)');
-        Logger.info('  --driver=[driver]                Storage driver (default: prisma)');
+        Logger.info('  --driver=[driver]                Storage driver (default: mikro-orm)');
         Logger.info('  --override                       Force regeneration and overwrite existing files');
         Logger.info('  --dry-prisma                     Skip Prisma schema generation');
         Logger.info('  --help, -h                       Show this help message');
@@ -87,7 +90,7 @@ class CmsEntitiesGenerator
 
     get driver()
     {
-        return sc.get(this.config, 'driver', process.env.RELDENS_STORAGE_DRIVER || 'prisma');
+        return sc.get(this.config, 'driver', process.env.RELDENS_STORAGE_DRIVER || 'mikro-orm');
     }
 
     async run()
@@ -107,10 +110,18 @@ class CmsEntitiesGenerator
             Logger.info('Running in dry-prisma mode - skipping Prisma schema generation.');
         }
         let managerConfig = {projectRoot: this.projectRoot};
+        dotenv.config({path: FileHandler.joinPaths(this.projectRoot, '.env')});
         if('prisma' === this.driver){
-            let prismaClient = PrismaClientLoader.load(this.projectRoot, this.prismaClientPath, null);
-            if(prismaClient){
-                managerConfig.prismaClient = prismaClient;
+            let databaseConfig = ManagerConfigLoader.loadFromEnv().database;
+            let prismaModules = ManagerServicesInitializer.loadPrismaModules(
+                this.projectRoot,
+                this.prismaClientPath,
+                null,
+                databaseConfig.prismaAdapter,
+                databaseConfig.prismaAdapterClass
+            );
+            if(prismaModules){
+                managerConfig.prismaModules = prismaModules;
             }
         }
         let manager = new Manager(managerConfig);
@@ -119,7 +130,7 @@ class CmsEntitiesGenerator
             return false;
         }
         Logger.debug('Reldens CMS Manager instance created for entities generation.');
-        await manager.initializeDataServer();
+        await manager.servicesInitializer.initializeDataServer();
         let success = await manager.installer.generateEntities(
             manager.dataServer,
             this.isOverride,

package/bin/reldens-cms-update-password.js

@@ -1,4 +1,4 @@
-#!/usr/bin/env node
+#!/usr/bin/env node
 
 /**
  *
@@ -8,7 +8,8 @@
 
 const { Manager } = require('../index');
 const { EntitiesLoader } = require('../lib/entities-loader');
-const { PrismaClientLoader } = require('@reldens/storage');
+const { ManagerConfigLoader } = require('../lib/manager-config-loader');
+const { ManagerServicesInitializer } = require('../lib/manager-services-initializer');
 const { Logger, sc } = require('@reldens/utils');
 const { FileHandler, Encryptor } = require('@reldens/server-utils');
 const dotenv = require('dotenv');
@@ -111,7 +112,8 @@ class CmsPasswordUpdater
         }
         let envFilePath = FileHandler.joinPaths(this.projectRoot, '.env');
         dotenv.config({path: envFilePath});
-        let storageDriver = process.env.RELDENS_STORAGE_DRIVER || 'prisma';
+        let databaseConfig = ManagerConfigLoader.loadFromEnv().database;
+        let storageDriver = databaseConfig.driver;
         Logger.debug('Using storage driver: '+storageDriver);
         let entitiesLoader = new EntitiesLoader({projectRoot: this.projectRoot});
         let loadedEntities = entitiesLoader.loadEntities(storageDriver);
@@ -128,10 +130,16 @@ class CmsPasswordUpdater
             entitiesTranslations: loadedEntities.entitiesTranslations
         };
         if('prisma' === storageDriver){
-            let prismaClient = PrismaClientLoader.load(this.projectRoot, null, null);
-            if(prismaClient){
-                managerConfig.prismaClient = prismaClient;
-                Logger.debug('Prisma client loaded and configured.');
+            let prismaModules = ManagerServicesInitializer.loadPrismaModules(
+                this.projectRoot,
+                null,
+                null,
+                databaseConfig.prismaAdapter,
+                databaseConfig.prismaAdapterClass
+            );
+            if(prismaModules){
+                managerConfig.prismaModules = prismaModules;
+                Logger.debug('Prisma modules loaded and configured.');
             }
         }
         let manager = new Manager(managerConfig);
@@ -140,7 +148,7 @@ class CmsPasswordUpdater
             return false;
         }
         Logger.debug('Reldens CMS Manager instance created for password update.');
-        let initResult = await manager.initializeDataServer();
+        let initResult = await manager.servicesInitializer.initializeDataServer();
         if(!initResult){
             Logger.error('Failed to initialize data server.');
             return false;