@reldens/cms 0.84.0 → 0.86.0

package/.claude/api-reference.md

@@ -1,171 +1,172 @@
-# API Reference
-
-## Manager Class
-
-- `start()` - Initialize and start the CMS
-- `isInstalled()` - Check if CMS is installed
-- `buildAppServerConfiguration()` - Build server configuration
-- `validateCdnMappingsInDevelopment()` - Warn when CDN domains are missing from CSP directives
-- `isCdnUrlInDirectives(cdnUrlWithProtocol, cdnHostname)` - Check if a CDN URL appears in any CSP directive
-- `initializeCmsAfterInstall(props)` - Post-installation callback
-
-## ManagerComponentValidator Class (lib/manager-component-validator.js)
-
-Static validators called from the Manager constructor:
-
-- `validateProvidedServer(app, appServer)` - Validate provided Express app and server
-- `validateProvidedDataServer(dataServer)` - Validate provided data server
-- `validateProvidedAdminManager(adminManager)` - Validate provided admin manager
-- `validateProvidedFrontend(frontend)` - Validate provided frontend
-
-## ManagerConfigLoader Class (lib/manager-config-loader.js)
-
-- `loadFromEnv()` - Build config object from `RELDENS_*` environment variables
-
-## ManagerServicesInitializer Class (lib/manager-services-initializer.js)
-
-Receives the Manager instance via constructor and handles all service initialization:
-
-- `initializeServices()` - Orchestrate full service initialization sequence
-- `initializeDataServer()` - Create data server; auto-creates PrismaClient via PrismaClientLoader when driver is `prisma` and no client provided
-- `setupEntityAccess()` - Sync entity access rules to database
-- `loadProcessedEntities()` - Apply config overrides and process raw entities
-- `generateAdminEntities()` - Generate admin panel entity definitions
-- `initializeAdminManager()` - Set up admin routes and authentication
-- `initializePasswordEncryptionHandler()` - Register password encryption event listeners
-- `initializeCmsPagesRouteManager()` - Wire CMS page routes to the data server
-- `initializeFrontend()` - Create and initialize Frontend instance
-- `renderCallback(template, params)` - Render a template via the configured render engine
-
-## Installer Class
-
-- `isInstalled()` - Check installation status
-- `configureAppServerRoutes(app, appServer, appServerFactory, renderEngine)` - Setup installer routes
-- `executeInstallProcess(req, res)` - Complete installation process
-- `runSubprocessInstallation(dbConfig, templateVariables)` - Handle subprocess operations
-- `checkAndInstallPackages(requiredPackages)` - Check and install dependencies
-- `generateEntities(server, isOverride, isInstallationMode, isDryPrisma, dbConfig)` - Generate entities
-- `createEnvFile(templateVariables)` - Create environment configuration
-- `copyAdminDirectory()` - Copy admin assets and templates
-
-## Frontend Architecture Classes
-
-### Frontend Class (Orchestrator)
-
-- `initialize()` - Set up frontend routes and templates
-- `handleRequest(req, res)` - Main request handler
-- `renderRoute(route, domain, res, req)` - Route-based rendering
-- `setupStaticAssets()` - Configure static asset serving
-
-### TemplateResolver Class
-
-- `findTemplatePath(templateName, domain)` - Template discovery with domain fallback
-- `findLayoutPath(layoutName, domain)` - Layout path resolution
-- `findTemplateByPath(path, domain)` - Template lookup by URL path
-- `resolveDomainToFolder(domain)` - Domain to folder mapping
-- `resolveDomainToSiteKey(domain)` - Domain to site key mapping
-
-### TemplateCache Class
-
-- `loadPartials()` - Load and cache template partials
-- `setupDomainTemplates()` - Initialize domain-specific templates
-- `getPartialsForDomain(domain)` - Get domain-specific partials with fallback
-
-### TemplateReloader Class
-
-- `checkAndReloadAdminTemplates()` - Check and reload admin templates when changed
-- `checkAndReloadFrontendTemplates()` - Check and reload frontend templates when changed
-- `trackTemplateFiles(templatesPaths)` - Start tracking template files for changes
-- `shouldReloadAdminTemplates(mappedAdminTemplates)` - Check if admin templates need reloading
-- `shouldReloadFrontendTemplates(templatesPath, templateExtensions)` - Check if frontend templates need reloading
-- `handleAdminTemplateReload(adminManager)` - Complete admin template reload process
-- `handleFrontendTemplateReload(templateCache, templateResolver)` - Complete frontend template reload process
-
-### RequestProcessor Class
-
-- `findRouteByPath(path, domain)` - Database route lookup
-- `handleRouteRedirect(route, res)` - Handle route redirects
-- `getDomainFromRequest(req)` - Extract domain from request
-- `buildCacheKey(path, req)` - Generate cache keys
-
-### ContentRenderer Class
-
-- `renderWithTemplateContent(content, data, domain, req, route)` - Main content rendering
-- `generateRouteContent(route, domain, req)` - Route-based content generation
-- `generateTemplateContent(templatePath, domain, req, data)` - Template-based content generation
-- `fetchMetaFields(data)` - Process meta fields for templates
-
-### EntityAccessManager Class
-
-- `loadEntityAccessRules()` - Load entity access configuration
-- `isEntityAccessible(entityName)` - Check entity accessibility
-- `findEntityByPath(path)` - Entity lookup by URL path
-
-### ResponseManager Class
-
-- `renderWithCacheHandler(contentGenerator, errorHandler, responseHandler, domain, res, path, req)` - Generic cached response handler
-- `renderNotFound(domain, res, req)` - 404 error handling
-
-### SearchRequestHandler Class
-
-- `handleSearchRequest(req, res)` - Process search requests with template data support
-
-## TemplateEngine Class
-
-- `render(template, data, partials, domain, req, route, currentEntityData)` - Main template rendering with enhanced context
-- `processAllTemplateFunctions(template, domain, req, systemVariables)` - Process all template functions
-- `buildEnhancedRenderData(data, systemVariables, currentEntityData)` - Build template context with system variables
-
-## SystemVariablesProvider Class
-
-- `buildSystemVariables(req, route, domain)` - Create system variables for templates
-- `buildCurrentRequestData(req, domain)` - Build request context
-- `buildCurrentRouteData(route)` - Build route context
-- `buildCurrentDomainData(domain)` - Build domain context
-
-## Search Classes
-
-- `Search.parseSearchParameters(query)` - Parse search query parameters including templateData
-- `Search.executeSearch(config)` - Execute search with configuration
-- `SearchRenderer.renderSearchResults(searchResults, config, domain, req)` - Render search results with template data
-
-## Forms System Classes
-
-### DynamicForm Class
-
-- `validateFormSubmission(formKey, submittedValues, req)` - Validate form submission
-- `getFormConfig(formKey)` - Load form configuration from database
-- `validateHoneypot(submittedValues)` - Check honeypot field for bots
-- `validateFields(fieldsSchema, submittedValues)` - Schema-based field validation
-- `prepareSubmittedValues(submittedValues, fieldsSchema)` - Process and normalize values
-- `saveFormSubmission(formConfig, preparedValues)` - Save to database
-
-### DynamicFormRenderer Class
-
-- `renderForm(formConfig, fieldsToRender, domain, req, attributes)` - Render complete form
-- `renderFormFields(fieldsToRender, domain, req)` - Render field set
-- `renderFormField(field, domain, submittedValues, errors)` - Render individual field
-- `loadFormTemplate(templateName, domain)` - Load form template with domain fallback
-- `findFormTemplate(templateName, domain)` - Template discovery for forms
-
-### DynamicFormRequestHandler Class
-
-- `handleFormSubmission(req, res)` - Process POST form submissions
-- `handleBadRequest(res, message)` - Handle validation errors
-- `handleSuccessResponse(req, res, formKey, result)` - Handle successful submissions
-- `buildErrorRedirectPath(req, error, formKey)` - Build error redirect URLs
-- `buildSuccessRedirectPath(successRedirect, formKey)` - Build success redirect URLs
-
-### FormsTransformer Class
-
-- `transform(template, domain, req, systemVariables, enhancedData)` - Process cmsForm tags
-- `findAllFormTags(template)` - Find cmsForm tags in template
-- `parseFormAttributes(fullTag)` - Parse tag attributes
-- `parseFieldsFilter(attributes, formConfig)` - Filter fields based on attributes
-
-## AdminManager Class
-
-- `setupAdmin()` - Initialize admin panel
-- `generateListRouteContent()` - Entity list pages
-- `generateEditRouteContent()` - Entity edit forms
-- `processSaveEntity()` - Handle form submissions
+# API Reference
+
+## Manager Class
+
+- `start()` - Initialize and start the CMS
+- `isInstalled()` - Check if CMS is installed
+- `buildAppServerConfiguration()` - Build server configuration
+- `validateCdnMappingsInDevelopment()` - Warn when CDN domains are missing from CSP directives
+- `isCdnUrlInDirectives(cdnUrlWithProtocol, cdnHostname)` - Check if a CDN URL appears in any CSP directive
+- `initializeCmsAfterInstall(props)` - Post-installation callback
+
+## ManagerComponentValidator Class (lib/manager-component-validator.js)
+
+Static validators called from the Manager constructor:
+
+- `validateProvidedServer(app, appServer)` - Validate provided Express app and server
+- `validateProvidedDataServer(dataServer)` - Validate provided data server
+- `validateProvidedAdminManager(adminManager)` - Validate provided admin manager
+- `validateProvidedFrontend(frontend)` - Validate provided frontend
+
+## ManagerConfigLoader Class (lib/manager-config-loader.js)
+
+- `loadFromEnv()` - Build config object from `RELDENS_*` environment variables
+
+## ManagerServicesInitializer Class (lib/manager-services-initializer.js)
+
+Receives the Manager instance via constructor and handles all service initialization:
+
+- `initializeServices()` - Orchestrate full service initialization sequence
+- `loadPrismaModules(projectRoot, clientPath, connectionData, adapterPackage, adapterClass)` - Static; resolves the Prisma adapter from the project and loads the Prisma modules via PrismaClientLoader
+- `initializeDataServer()` - Create data server; auto-loads Prisma modules via `loadPrismaModules()` when driver is `prisma` and no `prismaModules` provided
+- `setupEntityAccess()` - Sync entity access rules to database
+- `loadProcessedEntities()` - Apply config overrides and process raw entities
+- `generateAdminEntities()` - Generate admin panel entity definitions
+- `initializeAdminManager()` - Set up admin routes and authentication
+- `initializePasswordEncryptionHandler()` - Register password encryption event listeners
+- `initializeCmsPagesRouteManager()` - Wire CMS page routes to the data server
+- `initializeFrontend()` - Create and initialize Frontend instance
+- `renderCallback(template, params)` - Render a template via the configured render engine
+
+## Installer Class
+
+- `isInstalled()` - Check installation status
+- `configureAppServerRoutes(app, appServer, appServerFactory, renderEngine)` - Setup installer routes
+- `executeInstallProcess(req, res)` - Complete installation process
+- `runSubprocessInstallation(dbConfig, templateVariables)` - Handle subprocess operations
+- `checkAndInstallPackages(requiredPackages)` - Check and install dependencies
+- `generateEntities(server, isOverride, isInstallationMode, isDryPrisma, dbConfig)` - Generate entities
+- `createEnvFile(templateVariables)` - Create environment configuration
+- `copyAdminDirectory()` - Copy admin assets and templates
+
+## Frontend Architecture Classes
+
+### Frontend Class (Orchestrator)
+
+- `initialize()` - Set up frontend routes and templates
+- `handleRequest(req, res)` - Main request handler
+- `renderRoute(route, domain, res, req)` - Route-based rendering
+- `setupStaticAssets()` - Configure static asset serving
+
+### TemplateResolver Class
+
+- `findTemplatePath(templateName, domain)` - Template discovery with domain fallback
+- `findLayoutPath(layoutName, domain)` - Layout path resolution
+- `findTemplateByPath(path, domain)` - Template lookup by URL path
+- `resolveDomainToFolder(domain)` - Domain to folder mapping
+- `resolveDomainToSiteKey(domain)` - Domain to site key mapping
+
+### TemplateCache Class
+
+- `loadPartials()` - Load and cache template partials
+- `setupDomainTemplates()` - Initialize domain-specific templates
+- `getPartialsForDomain(domain)` - Get domain-specific partials with fallback
+
+### TemplateReloader Class
+
+- `checkAndReloadAdminTemplates()` - Check and reload admin templates when changed
+- `checkAndReloadFrontendTemplates()` - Check and reload frontend templates when changed
+- `trackTemplateFiles(templatesPaths)` - Start tracking template files for changes
+- `shouldReloadAdminTemplates(mappedAdminTemplates)` - Check if admin templates need reloading
+- `shouldReloadFrontendTemplates(templatesPath, templateExtensions)` - Check if frontend templates need reloading
+- `handleAdminTemplateReload(adminManager)` - Complete admin template reload process
+- `handleFrontendTemplateReload(templateCache, templateResolver)` - Complete frontend template reload process
+
+### RequestProcessor Class
+
+- `findRouteByPath(path, domain)` - Database route lookup
+- `handleRouteRedirect(route, res)` - Handle route redirects
+- `getDomainFromRequest(req)` - Extract domain from request
+- `buildCacheKey(path, req)` - Generate cache keys
+
+### ContentRenderer Class
+
+- `renderWithTemplateContent(content, data, domain, req, route)` - Main content rendering
+- `generateRouteContent(route, domain, req)` - Route-based content generation
+- `generateTemplateContent(templatePath, domain, req, data)` - Template-based content generation
+- `fetchMetaFields(data)` - Process meta fields for templates
+
+### EntityAccessManager Class
+
+- `loadEntityAccessRules()` - Load entity access configuration
+- `isEntityAccessible(entityName)` - Check entity accessibility
+- `findEntityByPath(path)` - Entity lookup by URL path
+
+### ResponseManager Class
+
+- `renderWithCacheHandler(contentGenerator, errorHandler, responseHandler, domain, res, path, req)` - Generic cached response handler
+- `renderNotFound(domain, res, req)` - 404 error handling
+
+### SearchRequestHandler Class
+
+- `handleSearchRequest(req, res)` - Process search requests with template data support
+
+## TemplateEngine Class
+
+- `render(template, data, partials, domain, req, route, currentEntityData)` - Main template rendering with enhanced context
+- `processAllTemplateFunctions(template, domain, req, systemVariables)` - Process all template functions
+- `buildEnhancedRenderData(data, systemVariables, currentEntityData)` - Build template context with system variables
+
+## SystemVariablesProvider Class
+
+- `buildSystemVariables(req, route, domain)` - Create system variables for templates
+- `buildCurrentRequestData(req, domain)` - Build request context
+- `buildCurrentRouteData(route)` - Build route context
+- `buildCurrentDomainData(domain)` - Build domain context
+
+## Search Classes
+
+- `Search.parseSearchParameters(query)` - Parse search query parameters including templateData
+- `Search.executeSearch(config)` - Execute search with configuration
+- `SearchRenderer.renderSearchResults(searchResults, config, domain, req)` - Render search results with template data
+
+## Forms System Classes
+
+### DynamicForm Class
+
+- `validateFormSubmission(formKey, submittedValues, req)` - Validate form submission
+- `getFormConfig(formKey)` - Load form configuration from database
+- `validateHoneypot(submittedValues)` - Check honeypot field for bots
+- `validateFields(fieldsSchema, submittedValues)` - Schema-based field validation
+- `prepareSubmittedValues(submittedValues, fieldsSchema)` - Process and normalize values
+- `saveFormSubmission(formConfig, preparedValues)` - Save to database
+
+### DynamicFormRenderer Class
+
+- `renderForm(formConfig, fieldsToRender, domain, req, attributes)` - Render complete form
+- `renderFormFields(fieldsToRender, domain, req)` - Render field set
+- `renderFormField(field, domain, submittedValues, errors)` - Render individual field
+- `loadFormTemplate(templateName, domain)` - Load form template with domain fallback
+- `findFormTemplate(templateName, domain)` - Template discovery for forms
+
+### DynamicFormRequestHandler Class
+
+- `handleFormSubmission(req, res)` - Process POST form submissions
+- `handleBadRequest(res, message)` - Handle validation errors
+- `handleSuccessResponse(req, res, formKey, result)` - Handle successful submissions
+- `buildErrorRedirectPath(req, error, formKey)` - Build error redirect URLs
+- `buildSuccessRedirectPath(successRedirect, formKey)` - Build success redirect URLs
+
+### FormsTransformer Class
+
+- `transform(template, domain, req, systemVariables, enhancedData)` - Process cmsForm tags
+- `findAllFormTags(template)` - Find cmsForm tags in template
+- `parseFormAttributes(fullTag)` - Parse tag attributes
+- `parseFieldsFilter(attributes, formConfig)` - Filter fields based on attributes
+
+## AdminManager Class
+
+- `setupAdmin()` - Initialize admin panel
+- `generateListRouteContent()` - Entity list pages
+- `generateEditRouteContent()` - Entity edit forms
+- `processSaveEntity()` - Handle form submissions

package/.claude/architecture-guide.md

@@ -20,7 +20,7 @@ Responsibilities are split across four files:
 - `lib/manager.js` — orchestration, server config, lifecycle
 - `lib/manager-component-validator.js` — static validation of provided server/dataServer/adminManager/frontend instances
 - `lib/manager-config-loader.js` — static `loadFromEnv()` reading all `RELDENS_*` env vars into a config object
-- `lib/manager-services-initializer.js` — data server, admin, frontend, entity and route manager initialization; auto-creates `PrismaClient` via `PrismaClientLoader` from `@reldens/storage` when driver is `prisma` and no client is provided
+- `lib/manager-services-initializer.js` — data server, admin, frontend, entity and route manager initialization; auto-loads the Prisma modules via `PrismaClientLoader` from `@reldens/storage` when driver is `prisma` and no `prismaModules` is provided
 
 ### Frontend
 
@@ -379,6 +379,33 @@ Admin UI builder that:
 - Form field generation
 - Branding and styling
 
+### Delete Relations Warning
+
+**File:** `lib/admin-manager/delete-relations-warning.js`
+
+Builds the sentences appended to the delete confirmation dialog, so the admin states what actually happens to the
+records that reference the one being deleted. `ContentsBuilder` owns an instance as `this.relationsWarning` and
+calls `buildReverseRelationsMap()` once per admin contents build, then `fetchWarning(entityId, reverseRelations)`
+per entity.
+
+`buildReverseRelationsMap()` walks every resource and, for each `type: 'reference'` property, files the child
+entity label under the referenced entity, grouped by what the foreign key does on delete. The group comes from
+`fetchRelationGroup(property.onDelete)`, where `onDelete` is generated by `@reldens/storage` from the live
+`information_schema` delete rule:
+
+- `cascade` goes to `deleted`, rendered with `messages.confirmDeleteRelations`.
+- `setNull` and `setDefault` go to `unlinked`, rendered with `messages.confirmUnlinkRelations`.
+- Everything else, including `restrict`, `noAction` and a missing value, goes to `blocking`, rendered with
+  `messages.confirmBlockingRelations`.
+
+There is deliberately no default claim: `restrict` and `noAction` neither delete nor unlink, they make the delete
+fail, and a missing `onDelete` means the consumer's entities predate the generated attribute. Reporting either of
+those as "will be deleted" was the original bug this grouping replaced.
+
+Only the three sentences are produced here. The cms itself never deletes related rows: `RouterContents`
+`processDeleteEntities()` deletes the entity row alone and the database referential actions do the rest, which is
+exactly why the wording has to follow the foreign keys.
+
 ### Admin Filters Manager
 
 **File:** `lib/admin-manager/admin-filters-manager.js`