@lenne.tech/nest-server 11.43.3 → 12.1.0

package/src/core/modules/hub/README.md

@@ -33,11 +33,12 @@ Do NOT set `hub` in the `production` block unless you intend the cockpit to be r
 | Diagnostics          | `/hub/diagnostics`    | heap/rss, node/platform, collector buffer levels                |
 | Logs                 | `/hub/logs`           | in-memory log ring buffer (redacted)                            |
 | Request Traces       | `/hub/traces`         | HTTP timing middleware                                          |
-| Query Performance    | `/hub/queries`        | MongoDB driver command monitoring (opt-in)                      |
+| Query Performance    | `/hub/queries`        | MongoDB driver command monitoring (opt-in; MongoDB only)        |
 | Cron Jobs            | `/hub/cron`           | `@nestjs/schedule` `SchedulerRegistry` (optional)               |
-| Database             | `/hub/db`             | dbStats / per-collection collStats                              |
+| Database             | `/hub/db`             | dbStats / per-collection collStats (MongoDB only)               |
 | Models / ERD         | `/hub/models`         | Mongoose schemas → Mermaid ER diagram                           |
-| Migrations           | `/hub/migrations`     | `MigrationRunner` status + run/rollback                         |
+| Persistence          | `/hub/persistence`    | data sources, and per model: source, database, capabilities     |
+| Migrations           | `/hub/migrations`     | `MigrationRunner` status + run/rollback (MongoDB or SQL state)  |
 | Files                | `/hub/files`          | listing + delete across all three storage drivers               |
 | Config               | `/hub/config`         | full config, secrets masked                                     |
 | Auth Migration       | `/hub/auth-migration` | Legacy → IAM progress (BetterAuth, optional)                    |
@@ -50,17 +51,25 @@ Do NOT set `hub` in the `production` block unless you intend the cockpit to be r
 Each panel has a `*.json` sidecar (the stable data contract) that the client polls. Optional sources
 degrade to an "unavailable" state instead of erroring.
 
+With a SQL data source (`database`, see `.claude/rules/configurable-features.md` → Data Sources) the Database and
+Query Performance panels cover the MongoDB connection only and report "unavailable" without one. The Migrations panel
+reads the state from the store the framework keeps for the default source: on a SQL default source the
+`lt_migrations` table, through the owner connection (`database.ownerUrl`, required there). That presumes
+`migrations-utils/migrate.js` passes `database.ownerUrl` to `createMigrationStore()` (see the migrate README). While
+it still passes the MongoDB URI, the table stays empty and the MongoDB collection lists the applied migrations; the
+panel then reports that conflict and refuses Run and Rollback, which would apply the migrations a second time.
+
 ### Files panel
 
 The panel reads all three file metadata stores, not just GridFS — the same three
-`CoreFileService.findFileInfo()` consults, because metadata always lives in MongoDB whichever store
-holds the bytes:
-
-| Store        | Collection                            | Bytes live in                   |
-| ------------ | ------------------------------------- | ------------------------------- |
-| `s3`         | `s3-files`                            | the S3 bucket                   |
-| `filesystem` | `filesystem-files`                    | `file.storageDir` on local disk |
-| `gridfs`     | `<bucket>.files` (default `fs.files`) | MongoDB                         |
+`CoreFileService.findFileInfo()` consults, wherever `database` routes their metadata
+(`fileMetadataCollection()`):
+
+| Store        | Metadata                                                | Bytes live in                   |
+| ------------ | ------------------------------------------------------- | ------------------------------- |
+| `s3`         | collection `s3-files`, on a SQL source table `s3_files` | the S3 bucket                   |
+| `filesystem` | `filesystem-files`, on a SQL source `filesystem_files`  | `file.storageDir` on local disk |
+| `gridfs`     | `<bucket>.files` (default `fs.files`), always MongoDB   | MongoDB                         |
 
 Every row carries the `store` it was found in, and `files.json` reports a per-store `count` so an
 empty store reads as **empty** rather than as _"this panel does not cover your driver"_. Until

package/src/core/modules/hub/core-hub-actions.controller.ts

@@ -9,8 +9,8 @@ import {
   Post,
 } from '@nestjs/common';
 
-import { HubActionMessage } from './hub-action-messages';
-import { CoreHubActionsService } from './services/core-hub-actions.service';
+import { HubActionMessage } from './hub-action-messages.js';
+import { CoreHubActionsService } from './services/core-hub-actions.service.js';
 
 /** Body shape shared by the confirm-guarded actions. */
 interface ConfirmBody {

package/src/core/modules/hub/core-hub-html.service.ts

@@ -1,6 +1,6 @@
 import { Inject, Injectable } from '@nestjs/common';
 
-import { HUB_CONFIG } from './hub.constants';
+import { HUB_CONFIG } from './hub.constants.js';
 
 /**
  * Per-process cache-bust token for the client bundle (`hub.js?v=<token>`). It changes on every server
@@ -10,9 +10,9 @@ import { HUB_CONFIG } from './hub.constants';
  * (the version is shown only in the ADMIN-gated, client-built topbar from session.json).
  */
 const HUB_ASSET_TOKEN = Date.now().toString(36);
-import { getHubClientJs } from './helpers/hub-client-js.helper';
-import { escapeHtml, escapeJsString, HUB_NONCE_PLACEHOLDER } from './helpers/hub-shell.helper';
-import { ResolvedHubConfig } from './interfaces/hub-config.interface';
+import { getHubClientJs } from './helpers/hub-client-js.helper.js';
+import { escapeHtml, escapeJsString, HUB_NONCE_PLACEHOLDER } from './helpers/hub-shell.helper.js';
+import type { ResolvedHubConfig } from './interfaces/hub-config.interface.js';
 
 /**
  * Builds the Hub's single, self-contained HTML shell. Every page route serves the same shell (the

package/src/core/modules/hub/core-hub.controller.ts

@@ -1,21 +1,21 @@
 import { Controller, Get, Headers, Optional, Param, Query, Res } from '@nestjs/common';
-import { Response } from 'express';
-
-import { Roles } from '../../common/decorators/roles.decorator';
-import { RoleEnum } from '../../common/enums/role.enum';
-
-import { CoreHubHtmlService } from './core-hub-html.service';
-import { CoreHubService } from './core-hub.service';
-import { HUB_PANELS } from './hub-nav';
-import { CoreHubDbService } from './services/core-hub-db.service';
-import { CoreHubEmailService } from './services/core-hub-email.service';
-import { CoreHubMailboxService } from './services/core-hub-mailbox.service';
-import { CoreHubMigrationsService } from './services/core-hub-migrations.service';
-import { CoreHubSourcesService } from './services/core-hub-sources.service';
-import { HubLogBufferService } from './services/hub-log-buffer.service';
-import { HubQueryProfilerService } from './services/hub-query-profiler.service';
-import { HubTraceBufferService } from './services/hub-trace-buffer.service';
-import { buildHubSecurityHeaders, escapeHtml, generateNonce, injectNonce } from './helpers/hub-shell.helper';
+import type { Response } from 'express';
+
+import { Roles } from '../../common/decorators/roles.decorator.js';
+import { RoleEnum } from '../../common/enums/role.enum.js';
+
+import { CoreHubHtmlService } from './core-hub-html.service.js';
+import { CoreHubService } from './core-hub.service.js';
+import { HUB_PANELS } from './hub-nav.js';
+import { CoreHubDbService } from './services/core-hub-db.service.js';
+import { CoreHubEmailService } from './services/core-hub-email.service.js';
+import { CoreHubMailboxService } from './services/core-hub-mailbox.service.js';
+import { CoreHubMigrationsService } from './services/core-hub-migrations.service.js';
+import { CoreHubSourcesService } from './services/core-hub-sources.service.js';
+import { HubLogBufferService } from './services/hub-log-buffer.service.js';
+import { HubQueryProfilerService } from './services/hub-query-profiler.service.js';
+import { HubTraceBufferService } from './services/hub-trace-buffer.service.js';
+import { buildHubSecurityHeaders, escapeHtml, generateNonce, injectNonce } from './helpers/hub-shell.helper.js';
 
 /** Route sub-paths of every non-root panel — the shell handler answers all of them. */
 const HUB_PAGE_PATHS = HUB_PANELS.filter((panel) => panel.path).map((panel) => panel.path);
@@ -156,6 +156,11 @@ export class CoreHubController {
     this.sendJson(res, this.dbService.getModels());
   }
 
+  @Get('persistence.json')
+  persistenceJson(@Res() res: Response): void {
+    this.sendJson(res, this.sourcesService.getPersistence());
+  }
+
   /**
    * ADMIN-gated auth probe AND cockpit-chrome payload: 200 returns the navigation, environment badge,
    * version and external links the client uses to build the layout; 401/403 keeps the shell showing

package/src/core/modules/hub/core-hub.module.ts

@@ -1,23 +1,23 @@
 import { DynamicModule, MiddlewareConsumer, Module, NestModule, Provider, Type } from '@nestjs/common';
 import { PATH_METADATA } from '@nestjs/common/constants';
 
-import { CoreHubActionsController } from './core-hub-actions.controller';
-import { CoreHubHtmlService } from './core-hub-html.service';
-import { CoreHubController } from './core-hub.controller';
-import { CoreHubService } from './core-hub.service';
-import { HUB_CONFIG, HUB_EMAIL_CAPTURE } from './hub.constants';
-import { HubConfigContext, isReachableEnv, normalizeHubConfig } from './hub-config.helper';
-import { HubTraceMiddleware } from './middleware/hub-trace.middleware';
-import { CoreHubActionsService } from './services/core-hub-actions.service';
-import { CoreHubDbService } from './services/core-hub-db.service';
-import { CoreHubEmailService } from './services/core-hub-email.service';
-import { CoreHubMailboxService } from './services/core-hub-mailbox.service';
-import { CoreHubMigrationsService } from './services/core-hub-migrations.service';
-import { CoreHubSourcesService } from './services/core-hub-sources.service';
-import { HubLogBufferService } from './services/hub-log-buffer.service';
-import { HubQueryProfilerService } from './services/hub-query-profiler.service';
-import { HubTraceBufferService } from './services/hub-trace-buffer.service';
-import { IHubConfig } from './interfaces/hub-config.interface';
+import { CoreHubActionsController } from './core-hub-actions.controller.js';
+import { CoreHubHtmlService } from './core-hub-html.service.js';
+import { CoreHubController } from './core-hub.controller.js';
+import { CoreHubService } from './core-hub.service.js';
+import { HUB_CONFIG, HUB_EMAIL_CAPTURE } from './hub.constants.js';
+import { HubConfigContext, isReachableEnv, normalizeHubConfig } from './hub-config.helper.js';
+import { HubTraceMiddleware } from './middleware/hub-trace.middleware.js';
+import { CoreHubActionsService } from './services/core-hub-actions.service.js';
+import { CoreHubDbService } from './services/core-hub-db.service.js';
+import { CoreHubEmailService } from './services/core-hub-email.service.js';
+import { CoreHubMailboxService } from './services/core-hub-mailbox.service.js';
+import { CoreHubMigrationsService } from './services/core-hub-migrations.service.js';
+import { CoreHubSourcesService } from './services/core-hub-sources.service.js';
+import { HubLogBufferService } from './services/hub-log-buffer.service.js';
+import { HubQueryProfilerService } from './services/hub-query-profiler.service.js';
+import { HubTraceBufferService } from './services/hub-trace-buffer.service.js';
+import { IHubConfig } from './interfaces/hub-config.interface.js';
 
 /** Options passed by `CoreModule.forRoot()` when it registers the Hub. */
 export interface CoreHubModuleOptions {

package/src/core/modules/hub/core-hub.service.ts

@@ -1,16 +1,16 @@
 import { Inject, Injectable, Optional } from '@nestjs/common';
-import { InjectConnection } from '@nestjs/mongoose';
-import { Connection } from 'mongoose';
+import { InjectConnection } from '../../common/persistence/mongo/mongoose-compat.js';
+import type { Connection } from 'mongoose';
 
-import { getBuildInfo } from '../../common/helpers/meta.helper';
-import { ConfigService } from '../../common/services/config.service';
+import { getBuildInfo } from '../../common/helpers/meta.helper.js';
+import { ConfigService } from '../../common/services/config.service.js';
 
-import { HUB_CONFIG } from './hub.constants';
-import { HUB_PANEL_GROUPS, HUB_PANELS } from './hub-nav';
-import { maskConfigDeep } from './helpers/hub-mask.helper';
-import { CoreHubSourcesService } from './services/core-hub-sources.service';
-import { HubDashboardData, HubDiagnosticsData, HubSessionData } from './interfaces/hub-panels.interface';
-import { ResolvedHubConfig } from './interfaces/hub-config.interface';
+import { HUB_CONFIG } from './hub.constants.js';
+import { HUB_PANEL_GROUPS, HUB_PANELS } from './hub-nav.js';
+import { maskConfigDeep } from './helpers/hub-mask.helper.js';
+import { CoreHubSourcesService } from './services/core-hub-sources.service.js';
+import { HubDashboardData, HubDiagnosticsData, HubSessionData } from './interfaces/hub-panels.interface.js';
+import type { ResolvedHubConfig } from './interfaces/hub-config.interface.js';
 
 /**
  * Framework-default secret field names (see CheckSecurityInterceptor). Union with the pattern-based

package/src/core/modules/hub/helpers/hub-client-js.helper.ts

@@ -479,6 +479,29 @@ export function getHubClientJs(): string {
     }, function (e) { clear(content); content.appendChild(unavailable('Failed to load: ' + e.message)); });
   };
 
+  Hub.panels.persistence = function (content) {
+    // Routing is fixed at boot; load once instead of polling.
+    hubFetch('/persistence.json').then(function (d) {
+      clear(content);
+      if (d && d.available === false) { content.appendChild(unavailable(d.hint)); return; }
+      content.appendChild(el('h3', { text: 'Data sources' }));
+      content.appendChild(table([
+        { key: 'name', label: 'Source', render: function (r) { return r.name + (r.name === d.defaultSource ? ' (default)' : ''); } },
+        { key: 'driver', label: 'Database' },
+        { key: 'engine', label: 'Engine', render: function (r) { return r.engine || '–'; } },
+        { key: 'host', label: 'Host' },
+        { key: 'ownerConfigured', label: 'Owner role', render: function (r) { return r.driver === 'mongodb' ? '–' : (r.ownerConfigured ? 'configured' : 'verify only'); } },
+      ], d.sources || []));
+      content.appendChild(el('h3', { text: 'Models (' + (d.models || []).length + ')' }));
+      content.appendChild(table([
+        { key: 'name', label: 'Model' },
+        { key: 'source', label: 'Source', render: function (r) { return r.source || '–'; } },
+        { key: 'driver', label: 'Store', render: function (r) { return r.driver || 'not created yet'; } },
+        { key: 'capabilities', label: 'Capabilities', render: function (r) { return (r.capabilities || []).join(', ') || '–'; } },
+      ], d.models || []));
+    }, function (e) { clear(content); content.appendChild(unavailable('Failed to load: ' + e.message)); });
+  };
+
   Hub.panels.config = function (content) {
     hubFetch('/config.json').then(function (d) { clear(content); content.appendChild(el('p', { class: 'hub-hint', text: 'Secrets are masked.' })); content.appendChild(jsonView(d)); },
       function (e) { clear(content); content.appendChild(unavailable('Failed to load: ' + e.message)); });

package/src/core/modules/hub/hub-action-messages.ts

@@ -39,6 +39,12 @@ export const HubActionMessage = {
   missingHubRequestHeader: 'Missing X-Hub-Request header.',
   /** Any action that needs the Mongo connection while it is unavailable. */
   mongoUnavailable: 'No MongoDB connection is available.',
+  /** Migrations on a SQL default source run as the table owner. */
+  sqlOwnerMissing:
+    'The migration state of a SQL default source is read and written as the table owner — configure database.ownerUrl.',
+  /** SQL default source with an empty `lt_migrations` while the MongoDB collection lists applied migrations. */
+  migrationStateInMongo: (collection: string) =>
+    `The default source is a SQL database, but its lt_migrations table is empty while the MongoDB collection "${collection}" lists applied migrations — migrations-utils/migrate.js still keeps the state in MongoDB. Pass database.ownerUrl to createMigrationStore() and move the state to the table; until then the Hub neither shows nor runs migrations, which would apply them again.`,
   /** Migrations action while no Mongo URI is configured. */
   mongoUriMissing: 'No MongoDB URI is configured.',
   /** Test mail: no recipient supplied. */

package/src/core/modules/hub/hub-buffer.ts

@@ -1,5 +1,5 @@
-import { CoreRedisService } from '../../common/services/core-redis.service';
-import { HubBufferEntry, HubRingBuffer } from './hub-ring-buffer';
+import { CoreRedisService } from '../../common/services/core-redis.service.js';
+import { HubBufferEntry, HubRingBuffer } from './hub-ring-buffer.js';
 
 /** A buffer read, shaped like the `cursor` / `dropped` fields every Hub panel payload carries. */
 export interface HubBufferData<T> {

package/src/core/modules/hub/hub-config.helper.ts

@@ -1,5 +1,5 @@
-import { RoleEnum } from '../../common/enums/role.enum';
-import { getVersion } from '../../common/helpers/meta.helper';
+import { RoleEnum } from '../../common/enums/role.enum.js';
+import { getVersion } from '../../common/helpers/meta.helper.js';
 
 import {
   HUB_DEFAULT_LOG_CAPACITY,
@@ -17,7 +17,7 @@ import {
   HUB_DEFAULT_TRACE_CAPACITY,
   HUB_DEFAULT_TRACE_SLOW_MS,
   HUB_MIN_POLL_INTERVAL_MS,
-} from './hub.constants';
+} from './hub.constants.js';
 import {
   IHubConfig,
   IHubLogsConfig,
@@ -25,7 +25,7 @@ import {
   IHubQueriesConfig,
   IHubTracesConfig,
   ResolvedHubConfig,
-} from './interfaces/hub-config.interface';
+} from './interfaces/hub-config.interface.js';
 
 /** Context needed to resolve environment-dependent defaults (env badge, links, mailbox guard). */
 export interface HubConfigContext {

package/src/core/modules/hub/hub-nav.ts

@@ -32,6 +32,7 @@ export const HUB_PANELS: readonly HubPanel[] = [
   { group: 'Runtime', id: 'cron', json: 'cron.json', optional: true, path: 'cron', title: 'Cron Jobs' },
   { group: 'Data', id: 'db', json: 'db.json', path: 'db', title: 'Database' },
   { group: 'Data', id: 'models', json: 'models.json', path: 'models', title: 'Models / ERD' },
+  { group: 'Data', id: 'persistence', json: 'persistence.json', path: 'persistence', title: 'Persistence' },
   { group: 'Data', id: 'migrations', json: 'migrations.json', path: 'migrations', title: 'Migrations' },
   { group: 'Data', id: 'files', json: 'files.json', path: 'files', title: 'Files' },
   { group: 'Data', id: 'config', json: 'config.json', path: 'config', title: 'Config' },

package/src/core/modules/hub/index.ts

@@ -1,25 +1,25 @@
-export * from './core-hub-actions.controller';
-export * from './core-hub-html.service';
-export * from './core-hub.controller';
-export * from './core-hub.module';
-export * from './core-hub.service';
-export * from './services/core-hub-actions.service';
-export * from './services/core-hub-db.service';
-export * from './services/core-hub-email.service';
-export * from './services/core-hub-mailbox.service';
-export * from './services/core-hub-migrations.service';
-export * from './services/core-hub-sources.service';
-export * from './services/hub-log-buffer.service';
-export * from './services/hub-query-profiler.service';
-export * from './services/hub-trace-buffer.service';
-export * from './middleware/hub-trace.middleware';
-export * from './helpers/hub-command-shape.helper';
-export * from './helpers/hub-mask.helper';
-export * from './helpers/hub-mermaid.helper';
-export * from './helpers/hub-shell.helper';
-export * from './hub-config.helper';
-export * from './hub-nav';
-export * from './hub-ring-buffer';
-export * from './hub.constants';
-export * from './interfaces/hub-config.interface';
-export * from './interfaces/hub-panels.interface';
+export * from './core-hub-actions.controller.js';
+export * from './core-hub-html.service.js';
+export * from './core-hub.controller.js';
+export * from './core-hub.module.js';
+export * from './core-hub.service.js';
+export * from './services/core-hub-actions.service.js';
+export * from './services/core-hub-db.service.js';
+export * from './services/core-hub-email.service.js';
+export * from './services/core-hub-mailbox.service.js';
+export * from './services/core-hub-migrations.service.js';
+export * from './services/core-hub-sources.service.js';
+export * from './services/hub-log-buffer.service.js';
+export * from './services/hub-query-profiler.service.js';
+export * from './services/hub-trace-buffer.service.js';
+export * from './middleware/hub-trace.middleware.js';
+export * from './helpers/hub-command-shape.helper.js';
+export * from './helpers/hub-mask.helper.js';
+export * from './helpers/hub-mermaid.helper.js';
+export * from './helpers/hub-shell.helper.js';
+export * from './hub-config.helper.js';
+export * from './hub-nav.js';
+export * from './hub-ring-buffer.js';
+export * from './hub.constants.js';
+export * from './interfaces/hub-config.interface.js';
+export * from './interfaces/hub-panels.interface.js';

package/src/core/modules/hub/interfaces/hub-panels.interface.ts

@@ -71,12 +71,19 @@ export interface HubModelsData {
   relationCount: number;
 }
 
+/** Persistence panel: where each model is stored, on which database and engine, with which capabilities */
+export interface HubPersistenceData {
+  defaultSource?: string;
+  models: { capabilities: string[]; driver?: string; name: string; source?: string }[];
+  sources: { driver: string; engine?: string; host: string; name: string; ownerConfigured: boolean }[];
+}
+
 export interface HubMigrationsData {
   completed: string[];
   dirAvailable: boolean;
   lastRun?: string;
   pending: string[];
-  source: 'collection' | 'runner';
+  source: 'collection' | 'runner' | 'table';
 }
 
 /**

package/src/core/modules/hub/middleware/hub-trace.middleware.ts

@@ -1,7 +1,7 @@
 import { Injectable, NestMiddleware } from '@nestjs/common';
 import { NextFunction, Request, Response } from 'express';
 
-import { HubTraceBufferService } from '../services/hub-trace-buffer.service';
+import { HubTraceBufferService } from '../services/hub-trace-buffer.service.js';
 
 /**
  * Measures request duration and records a trace at response completion.

package/src/core/modules/hub/services/core-hub-actions.service.ts

@@ -1,17 +1,17 @@
 import { Injectable, Logger, Optional } from '@nestjs/common';
 
-import { EmailService } from '../../../common/services/email.service';
-import { RequestContext } from '../../../common/services/request-context.service';
-import { HubActionMessage } from '../hub-action-messages';
-import { HubFileStore } from '../interfaces/hub-panels.interface';
-import { CoreHubDbService } from './core-hub-db.service';
-import { CoreHubEmailService } from './core-hub-email.service';
-import { CoreHubMailboxService } from './core-hub-mailbox.service';
-import { CoreHubMigrationsService } from './core-hub-migrations.service';
-import { CoreHubSourcesService } from './core-hub-sources.service';
-import { HubLogBufferService } from './hub-log-buffer.service';
-import { HubQueryProfilerService } from './hub-query-profiler.service';
-import { HubTraceBufferService } from './hub-trace-buffer.service';
+import { EmailService } from '../../../common/services/email.service.js';
+import { RequestContext } from '../../../common/services/request-context.service.js';
+import { HubActionMessage } from '../hub-action-messages.js';
+import { HubFileStore } from '../interfaces/hub-panels.interface.js';
+import { CoreHubDbService } from './core-hub-db.service.js';
+import { CoreHubEmailService } from './core-hub-email.service.js';
+import { CoreHubMailboxService } from './core-hub-mailbox.service.js';
+import { CoreHubMigrationsService } from './core-hub-migrations.service.js';
+import { CoreHubSourcesService } from './core-hub-sources.service.js';
+import { HubLogBufferService } from './hub-log-buffer.service.js';
+import { HubQueryProfilerService } from './hub-query-profiler.service.js';
+import { HubTraceBufferService } from './hub-trace-buffer.service.js';
 
 /** Illustrative sample data for the test-mail action. */
 const TEST_MAIL_DATA = {

package/src/core/modules/hub/services/core-hub-db.service.ts

@@ -1,20 +1,20 @@
 import { Inject, Injectable, Logger, Optional } from '@nestjs/common';
-import { InjectConnection } from '@nestjs/mongoose';
-import * as mongo from 'mongodb';
-import { Connection, Types } from 'mongoose';
+import type * as mongo from 'mongodb';
+import type { Connection } from 'mongoose';
 
-import { ConfigService } from '../../../common/services/config.service';
-import { CoreS3Service } from '../../../common/services/core-s3.service';
-import { ModelRegistry } from '../../../common/services/model-registry.service';
+import { ConfigService } from '../../../common/services/config.service.js';
+import { CoreS3Service } from '../../../common/services/core-s3.service.js';
+import { ModelRegistry } from '../../../common/services/model-registry.service.js';
 import {
   DEFAULT_FILESYSTEM_DIR,
   FILESYSTEM_FILES_COLLECTION,
   FilesystemFileHelper,
-} from '../../file/filesystem-file.helper';
-import { S3_FILES_COLLECTION, S3FileHelper } from '../../file/s3-file.helper';
-import { HubActionMessage } from '../hub-action-messages';
-import { HUB_CONFIG } from '../hub.constants';
-import { buildErDiagram, HubModelDescriptor, HubModelField } from '../helpers/hub-mermaid.helper';
+} from '../../file/filesystem-file.helper.js';
+import { fileMetadataCollection } from '../../file/file-metadata.store.js';
+import { S3_FILES_COLLECTION, S3FileHelper } from '../../file/s3-file.helper.js';
+import { HubActionMessage } from '../hub-action-messages.js';
+import { HUB_CONFIG } from '../hub.constants.js';
+import { buildErDiagram, HubModelDescriptor, HubModelField } from '../helpers/hub-mermaid.helper.js';
 import {
   HubDbData,
   HubFilesData,
@@ -22,8 +22,14 @@ import {
   HubFileStoreSummary,
   HubModelsData,
   HubUnavailable,
-} from '../interfaces/hub-panels.interface';
-import { ResolvedHubConfig } from '../interfaces/hub-config.interface';
+} from '../interfaces/hub-panels.interface.js';
+import type { ResolvedHubConfig } from '../interfaces/hub-config.interface.js';
+import {
+  createGridFsBucket,
+  InjectConnection,
+  isValidObjectId,
+  newObjectId,
+} from '../../../common/persistence/mongo/mongoose-compat.js';
 
 /**
  * Read-only MongoDB introspection for the DB, Models/ERD and Files panels.
@@ -123,10 +129,10 @@ export class CoreHubDbService {
     if (!db) {
       throw new Error(HubActionMessage.mongoUnavailable);
     }
-    if (!Types.ObjectId.isValid(id)) {
+    if (!isValidObjectId(id)) {
       throw new Error(HubActionMessage.invalidFileId);
     }
-    const objectId = new Types.ObjectId(id);
+    const objectId = newObjectId(id);
 
     // Same probe order as `CoreFileService.deleteFile()`: S3, then filesystem, then GridFS as the
     // fallthrough. Keeping the two in step matters — a Hub that resolved a file differently from the
@@ -134,7 +140,7 @@ export class CoreHubDbService {
     let store: HubFileStore | undefined;
     let doc: any;
     for (const candidate of this.fileStores(bucket)) {
-      const [found] = await db.collection(candidate.collection).find({ _id: objectId }, { limit: 1 }).toArray();
+      const [found] = await this.fileCollection(candidate).find({ _id: objectId }, { limit: 1 }).toArray();
       if (found) {
         doc = found;
         store = candidate.store;
@@ -150,7 +156,11 @@ export class CoreHubDbService {
 
     switch (store) {
       case 'filesystem': {
-        await FilesystemFileHelper.deleteFile(this.filesystemDir, db.collection(FILESYSTEM_FILES_COLLECTION), objectId);
+        await FilesystemFileHelper.deleteFile(
+          this.filesystemDir,
+          fileMetadataCollection(this.connection, 'filesystem'),
+          objectId,
+        );
         break;
       }
       case 's3': {
@@ -158,11 +168,11 @@ export class CoreHubDbService {
         if (!this.s3Service?.enabled) {
           throw new Error(HubActionMessage.s3Unavailable);
         }
-        await S3FileHelper.deleteFile(this.s3Service, db.collection(S3_FILES_COLLECTION), objectId);
+        await S3FileHelper.deleteFile(this.s3Service, fileMetadataCollection(this.connection, 's3'), objectId);
         break;
       }
       default: {
-        const gridFs = new mongo.GridFSBucket(db as unknown as mongo.Db, { bucketName: bucket });
+        const gridFs = createGridFsBucket(db as unknown as mongo.Db, { bucketName: bucket });
         await gridFs.delete(objectId as unknown as mongo.ObjectId);
       }
     }
@@ -173,9 +183,9 @@ export class CoreHubDbService {
   /**
    * File inventory across ALL THREE metadata stores.
    *
-   * Metadata always lives in MongoDB whichever store holds the bytes (`fs.files` / `s3-files` /
-   * `filesystem-files`), so one connection can see everything — which is exactly what
-   * `CoreFileService.findFileInfo()` does, and what this panel now mirrors.
+   * Metadata is queryable whichever store holds the bytes (`fs.files` / `s3-files` /
+   * `filesystem-files`, the latter two as tables when `database` routes them to a SQL source), so the
+   * panel reads all three the way `CoreFileService.findFileInfo()` does (`fileCollection()`).
    *
    * It used to read `fs.files` alone. Under `file.storage: 's3'` or `'filesystem'` that made the
    * panel report **0 files** — not "this panel does not cover your driver", but a confident wrong
@@ -209,11 +219,9 @@ export class CoreHubDbService {
 
     for (const source of this.fileStores(bucket)) {
       try {
-        const docs = await db
-          .collection(source.collection)
-          .find({}, { limit: window, sort: { uploadDate: -1 } })
-          .toArray();
-        const count = await db.collection(source.collection).countDocuments();
+        const collection = this.fileCollection(source);
+        const docs = await collection.find({}, { limit: window, sort: { uploadDate: -1 } }).toArray();
+        const count = await collection.countDocuments();
         stores.push({ collection: source.collection, count, store: source.store });
         for (const doc of docs) {
           rows.push({
@@ -255,6 +263,16 @@ export class CoreHubDbService {
    * GridFS is last because it is the fallthrough: its collection name depends on the bucket, and a
    * document there carries no `storage` marker to identify it by.
    */
+  /**
+   * The metadata of one store as `CoreFileService` reads it: S3 and filesystem metadata follow `database` to a SQL
+   * table when their model is routed there; GridFS keeps `<bucket>.files` in MongoDB
+   */
+  protected fileCollection(source: { collection: string; store: HubFileStore }): mongo.Collection<any> {
+    return source.store === 'gridfs'
+      ? this.connection.db.collection(source.collection)
+      : fileMetadataCollection(this.connection, source.store);
+  }
+
   protected fileStores(bucket: string): { collection: string; store: HubFileStore }[] {
     return [
       { collection: S3_FILES_COLLECTION, store: 's3' },

package/src/core/modules/hub/services/core-hub-email.service.ts

@@ -2,11 +2,12 @@ import { Inject, Injectable, Logger, Optional } from '@nestjs/common';
 import { existsSync, readdirSync } from 'fs';
 import { join, resolve } from 'path';
 
-import { ConfigService } from '../../../common/services/config.service';
-import { TemplateService } from '../../../common/services/template.service';
-import { HUB_CONFIG } from '../hub.constants';
-import { HubEmailsData, HubUnavailable } from '../interfaces/hub-panels.interface';
-import { ResolvedHubConfig } from '../interfaces/hub-config.interface';
+import { ConfigService } from '../../../common/services/config.service.js';
+import { TemplateService } from '../../../common/services/template.service.js';
+import { HUB_CONFIG } from '../hub.constants.js';
+import { HubEmailsData, HubUnavailable } from '../interfaces/hub-panels.interface.js';
+import type { ResolvedHubConfig } from '../interfaces/hub-config.interface.js';
+import { callerDirectory } from '../../../common/helpers/module-location.helper.js';
 
 /** Sample data used to render an email template preview. Values are illustrative, never real user data. */
 const SAMPLE_PAYLOAD: Record<string, unknown> = {
@@ -118,7 +119,7 @@ export class CoreHubEmailService {
 
   protected frameworkTemplatesDir(): string {
     // From src/core/modules/hub/services → src/templates (same relative offset in dist/).
-    return resolve(__dirname, '../../../../templates');
+    return resolve(callerDirectory(), '../../../../templates');
   }
 
   protected listEjs(dir: string): string[] {

package/src/core/modules/hub/services/core-hub-mailbox.service.ts

@@ -1,11 +1,11 @@
 import { Inject, Injectable, Optional } from '@nestjs/common';
 
-import { redactSensitiveText } from '../../../common/helpers/logging.helper';
-import { CoreRedisService } from '../../../common/services/core-redis.service';
-import { HUB_CONFIG } from '../hub.constants';
-import { HubBuffer } from '../hub-buffer';
-import { HubMailboxData, HubMailboxEntry } from '../interfaces/hub-panels.interface';
-import { IHubCapturedMailInput, IHubEmailCapture, ResolvedHubConfig } from '../interfaces/hub-config.interface';
+import { redactSensitiveText } from '../../../common/helpers/logging.helper.js';
+import { CoreRedisService } from '../../../common/services/core-redis.service.js';
+import { HUB_CONFIG } from '../hub.constants.js';
+import { HubBuffer } from '../hub-buffer.js';
+import { HubMailboxData, HubMailboxEntry } from '../interfaces/hub-panels.interface.js';
+import { IHubCapturedMailInput, IHubEmailCapture, type ResolvedHubConfig } from '../interfaces/hub-config.interface.js';
 
 /** A captured mail: the list metadata plus the (truncated) bodies kept for the preview iframe. */
 interface StoredMail extends HubMailboxEntry {