@digitaldefiance/node-express-suite 3.18.3 → 4.0.0

package/README.md

@@ -1769,6 +1769,235 @@ For issues and questions:
 - GitHub Issues: <https://github.com/Digital-Defiance/node-express-suite/issues>
 - Email: <support@digitaldefiance.org>
 
+## Plugin-Based Architecture
+
+The framework uses a plugin-based architecture that separates database concerns from the core application. This replaces the old deep inheritance hierarchy (Mongo base → Application → concrete subclass) with a composable plugin pattern.
+
+### Architecture Overview
+
+```
+BaseApplication<TID>          ← Database-agnostic base (accepts IDatabase)
+  └── Application<TID>        ← HTTP/Express layer (server, routing, middleware)
+        └── useDatabasePlugin()  ← Plug in any database backend
+
+IDatabasePlugin<TID>          ← Plugin interface for database backends
+  └── MongoDatabasePlugin     ← Mongoose/MongoDB implementation
+
+MongoApplicationConcrete      ← Ready-to-use concrete class for testing/dev
+```
+
+### Core Classes
+
+| Class | Purpose |
+|-------|---------|
+| `BaseApplication<TID>` | Database-agnostic base. Accepts an `IDatabase` instance and optional lifecycle hooks. Manages `PluginManager`, `ServiceContainer`, and environment. |
+| `Application<TID>` | Extends `BaseApplication` with Express HTTP/HTTPS server, routing, CSP/Helmet config, and middleware. Database-agnostic — database backends are provided via `IDatabasePlugin`. |
+| `MongoApplicationConcrete<TID>` | Concrete `Application` subclass for testing/development. Wires up `MongoDatabasePlugin` with default configuration, schema maps, and a dummy email service. Replaces the old concrete class. |
+
+### IDatabasePlugin Interface
+
+The `IDatabasePlugin<TID>` interface extends `IApplicationPlugin<TID>` with database-specific lifecycle hooks:
+
+```typescript
+interface IDatabasePlugin<TID> extends IApplicationPlugin<TID> {
+  readonly database: IDatabase;
+  readonly authenticationProvider?: IAuthenticationProvider<TID>;
+
+  connect(uri?: string): Promise<void>;
+  disconnect(): Promise<void>;
+  isConnected(): boolean;
+
+  // Optional dev/test store management
+  setupDevStore?(): Promise<string>;
+  teardownDevStore?(): Promise<void>;
+  initializeDevStore?(): Promise<unknown>;
+}
+```
+
+### MongoDatabasePlugin
+
+`MongoDatabasePlugin` implements `IDatabasePlugin` for MongoDB/Mongoose:
+
+```typescript
+import { MongoDatabasePlugin } from '@digitaldefiance/node-express-suite';
+
+const mongoPlugin = new MongoDatabasePlugin({
+  schemaMapFactory: getSchemaMap,
+  databaseInitFunction: DatabaseInitializationService.initUserDb.bind(DatabaseInitializationService),
+  initResultHashFunction: DatabaseInitializationService.serverInitResultHash.bind(DatabaseInitializationService),
+  environment,
+  constants,
+});
+```
+
+It wraps a `MongooseDocumentStore` and provides:
+- Connection/disconnection lifecycle
+- Dev database provisioning via `MongoMemoryReplSet`
+- Authentication provider wiring
+- Mongoose model and schema map access
+
+### Application Constructor
+
+The `Application` constructor accepts these parameters:
+
+```typescript
+constructor(
+  environment: TEnvironment,
+  apiRouterFactory: (app: IApplication<TID>) => BaseRouter<TID>,
+  cspConfig?: ICSPConfig | HelmetOptions | IFlexibleCSP,
+  constants?: TConstants,
+  appRouterFactory?: (apiRouter: BaseRouter<TID>) => TAppRouter,
+  customInitMiddleware?: typeof initMiddleware,
+  database?: IDatabase,  // Optional — use useDatabasePlugin() instead
+)
+```
+
+The `database` parameter is optional. When using a database plugin, the plugin's `database` property is used automatically.
+
+### Registering a Database Plugin
+
+Use `useDatabasePlugin()` to register a database plugin with the application:
+
+```typescript
+const app = new Application(environment, apiRouterFactory);
+app.useDatabasePlugin(mongoPlugin);
+await app.start();
+```
+
+`useDatabasePlugin()` stores the plugin as the application's database plugin AND registers it with the `PluginManager`, so it participates in the full plugin lifecycle (`init`, `stop`).
+
+### Implementing a Custom Database Plugin (BrightChain Example)
+
+To use a non-Mongo database, implement `IDatabasePlugin` directly. You do not need `IDocumentStore` or any Mongoose types:
+
+```typescript
+import type { IDatabasePlugin, IDatabase, IApplication } from '@digitaldefiance/node-express-suite';
+
+class BrightChainDatabasePlugin implements IDatabasePlugin<Buffer> {
+  readonly name = 'brightchain-database';
+  readonly version = '1.0.0';
+
+  private _connected = false;
+  private _database: IDatabase;
+
+  constructor(private config: BrightChainConfig) {
+    this._database = new BrightChainDatabase(config);
+  }
+
+  get database(): IDatabase {
+    return this._database;
+  }
+
+  // Optional: provide an auth provider if your DB manages authentication
+  get authenticationProvider() {
+    return undefined;
+  }
+
+  async connect(uri?: string): Promise<void> {
+    await this._database.connect(uri ?? this.config.connectionString);
+    this._connected = true;
+  }
+
+  async disconnect(): Promise<void> {
+    await this._database.disconnect();
+    this._connected = false;
+  }
+
+  isConnected(): boolean {
+    return this._connected;
+  }
+
+  async init(app: IApplication<Buffer>): Promise<void> {
+    // Wire up any app-level integrations after connection
+    // e.g., register services, set auth provider, etc.
+  }
+
+  async stop(): Promise<void> {
+    await this.disconnect();
+  }
+}
+
+// Usage:
+const app = new Application(environment, apiRouterFactory);
+app.useDatabasePlugin(new BrightChainDatabasePlugin(config));
+await app.start();
+```
+
+---
+
+## Migration Guide: Inheritance → Plugin Architecture
+
+This section covers migrating from the old inheritance-based hierarchy to the new plugin-based architecture.
+
+### What Changed
+
+| Before | After |
+|--------|-------|
+| Old Mongo base → `Application` → old concrete class | `BaseApplication` → `Application` + `IDatabasePlugin` |
+| Database logic baked into the class hierarchy | Database logic provided via plugins |
+| Old concrete class for testing/dev | `MongoApplicationConcrete` for testing/dev |
+| Extending the old Mongo base for custom apps | Implementing `IDatabasePlugin` for custom databases |
+
+### Before (Old Hierarchy)
+
+```typescript
+// Old: The concrete class extended Application which extended the Mongo base class
+// Database logic was tightly coupled into the inheritance chain
+import { /* old concrete class */ } from '@digitaldefiance/node-express-suite';
+
+const app = new OldConcreteApp(environment);
+await app.start();
+```
+
+### After (Plugin Architecture)
+
+```typescript
+// New: Application is database-agnostic, MongoDatabasePlugin provides Mongo support
+import { MongoApplicationConcrete } from '@digitaldefiance/node-express-suite';
+
+// For testing/development (drop-in replacement for the old concrete class):
+const app = new MongoApplicationConcrete(environment);
+await app.start();
+```
+
+Or for custom wiring:
+
+```typescript
+import { Application, MongoDatabasePlugin } from '@digitaldefiance/node-express-suite';
+
+const app = new Application(environment, apiRouterFactory);
+
+const mongoPlugin = new MongoDatabasePlugin({
+  schemaMapFactory: getSchemaMap,
+  databaseInitFunction: DatabaseInitializationService.initUserDb.bind(DatabaseInitializationService),
+  initResultHashFunction: DatabaseInitializationService.serverInitResultHash.bind(DatabaseInitializationService),
+  environment,
+  constants,
+});
+
+app.useDatabasePlugin(mongoPlugin);
+await app.start();
+```
+
+### Key Renames
+
+| Old Name | New Name | Notes |
+|----------|----------|-------|
+| Old concrete class | `MongoApplicationConcrete` | Drop-in replacement for testing/dev |
+| Old Mongo base class | *(removed)* | Functionality moved to `BaseApplication` + `MongoDatabasePlugin` |
+| Old base file | `base-application.ts` | File renamed |
+| Old concrete file | `mongo-application-concrete.ts` | File renamed |
+
+### Migration Checklist
+
+- [ ] Replace the old concrete class with `MongoApplicationConcrete`
+- [ ] Replace any old Mongo base subclasses with `Application` + `useDatabasePlugin()`
+- [ ] Update imports to use `base-application` (renamed from old base file)
+- [ ] Update imports to use `mongo-application-concrete` (renamed from old concrete file)
+- [ ] If you had a custom concrete subclass, convert it to use `MongoDatabasePlugin` or implement your own `IDatabasePlugin`
+
+---
+
 ## Architecture Refactor (2025)
 
 **Major improvements with large complexity reduction:**
@@ -2654,7 +2883,7 @@ This release introduces a complete decorator-based API for defining controllers,
 ### Version 2.1.24
 
 - Provide mocks/fixtures for use in testing
-- Provide concrete/runnable ApplicationConcrete class
+- Provide concrete/runnable MongoApplicationConcrete class
 - Export DummyEmailService for testing
 - Further streamline Application generics
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/node-express-suite",
-  "version": "3.18.3",
+  "version": "4.0.0",
   "homepage": "https://github.com/Digital-Defiance/node-express-suite",
   "repository": {
     "type": "git",

package/src/__tests__/helpers/setup-test-env.d.ts

@@ -3,10 +3,11 @@ import { IFailableResult } from '@digitaldefiance/suite-core-lib';
 import { HelmetOptions } from 'helmet';
 import { IBaseDocument } from '../../documents';
 import { IApplication, IConstants, ICSPConfig, IFlexibleCSP, IServerInitResult } from '../../interfaces';
+import { IMongoApplication } from '../../interfaces/mongo-application';
 import { ITestEnvironment } from '../../interfaces/test-environment';
 import { initMiddleware } from '../../middleware-utils';
 import { AppRouter, BaseRouter } from '../../routers';
 import { SchemaMap } from '../../types';
 import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
-export declare function setupTestEnvironment<TID extends PlatformID = Buffer, TModelDocs extends Record<string, IBaseDocument<any, TID>> = Record<string, IBaseDocument<any, TID>>, TConstants extends IConstants = IConstants, TAppRouter extends AppRouter<TID> = AppRouter<TID>>(constants: TConstants, apiRouterFactory: (app: IApplication<TID>) => BaseRouter<TID>, schemaMapFactory: (connection: Connection) => SchemaMap<TID, TModelDocs>, appRouterFactory?: (apiRouter: BaseRouter<TID>) => TAppRouter, customInitMiddleware?: typeof initMiddleware, envLocation?: string, databaseInitFunction?: (application: IApplication<TID>) => Promise<IFailableResult<IServerInitResult<TID>>>, initResultHashFunction?: (initResults: IServerInitResult<TID>) => string, cspConfig?: ICSPConfig | HelmetOptions | IFlexibleCSP): Promise<ITestEnvironment<TID>>;
+export declare function setupTestEnvironment<TID extends PlatformID = Buffer, TModelDocs extends Record<string, IBaseDocument<never, TID>> = Record<string, IBaseDocument<never, TID>>, TConstants extends IConstants = IConstants, TAppRouter extends AppRouter<TID> = AppRouter<TID>>(constants: TConstants, apiRouterFactory: (app: IApplication<TID>) => BaseRouter<TID>, schemaMapFactory: (connection: Connection) => SchemaMap<TID, TModelDocs>, appRouterFactory?: (apiRouter: BaseRouter<TID>) => TAppRouter, customInitMiddleware?: typeof initMiddleware, envLocation?: string, databaseInitFunction?: (application: IMongoApplication<TID>) => Promise<IFailableResult<IServerInitResult<TID>>>, initResultHashFunction?: (initResults: IServerInitResult<TID>) => string, cspConfig?: ICSPConfig | HelmetOptions | IFlexibleCSP): Promise<ITestEnvironment<TID>>;
 //# sourceMappingURL=setup-test-env.d.ts.map

package/src/__tests__/helpers/setup-test-env.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"setup-test-env.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite/src/__tests__/helpers/setup-test-env.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAEtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,wBAAsB,oBAAoB,CACxC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CACjE,MAAM,EACN,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CACxB,EACD,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1C,UAAU,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,EAElD,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAC7D,gBAAgB,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,EACxE,gBAAgB,GAAE,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,UACV,EACxC,oBAAoB,GAAE,OAAO,cAA+B,EAC5D,WAAW,CAAC,EAAE,MAAM,EACpB,oBAAoB,CAAC,EAAE,CACrB,WAAW,EAAE,YAAY,CAAC,GAAG,CAAC,KAC3B,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EACrD,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAAK,MAAM,EACxE,SAAS,GAAE,UAAU,GAAG,aAAa,GAAG,YAWvC,GACA,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CA+IhC"}
+{"version":3,"file":"setup-test-env.d.ts","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite/src/__tests__/helpers/setup-test-env.ts"],"names":[],"mappings":"AAKA,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAEvC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAEhD,OAAO,EACL,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,iBAAiB,EAClB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AACvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AACrE,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAGtD,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE,wBAAsB,oBAAoB,CACxC,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,GAAG,MAAM,CACnE,MAAM,EACN,aAAa,CAAC,KAAK,EAAE,GAAG,CAAC,CAC1B,EACD,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1C,UAAU,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,EAElD,SAAS,EAAE,UAAU,EACrB,gBAAgB,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAC7D,gBAAgB,EAAE,CAAC,UAAU,EAAE,UAAU,KAAK,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,EACxE,gBAAgB,GAAE,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,UACV,EACxC,oBAAoB,GAAE,OAAO,cAA+B,EAC5D,WAAW,CAAC,EAAE,MAAM,EACpB,oBAAoB,CAAC,EAAE,CACrB,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAChC,OAAO,CAAC,eAAe,CAAC,iBAAiB,CAAC,GAAG,CAAC,CAAC,CAAC,EACrD,sBAAsB,CAAC,EAAE,CAAC,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAAK,MAAM,EACxE,SAAS,GAAE,UAAU,GAAG,aAAa,GAAG,YAWvC,GACA,OAAO,CAAC,gBAAgB,CAAC,GAAG,CAAC,CAAC,CAmKhC"}

package/src/__tests__/helpers/setup-test-env.js

@@ -7,6 +7,7 @@ const environment_1 = require("../../environment");
 const middleware_utils_1 = require("../../middleware-utils");
 const routers_1 = require("../../routers");
 const services_1 = require("../../services");
+const mongo_database_plugin_1 = require("../../plugins/mongo-database-plugin");
 async function setupTestEnvironment(constants, apiRouterFactory, schemaMapFactory, appRouterFactory = (apiRouter) => new routers_1.AppRouter(apiRouter), customInitMiddleware = middleware_utils_1.initMiddleware, envLocation, databaseInitFunction, initResultHashFunction, cspConfig = {
     corsWhitelist: [],
     csp: {
@@ -28,29 +29,29 @@ async function setupTestEnvironment(constants, apiRouterFactory, schemaMapFactor
     }
     // Optimize MongoDB settings for test performance while maintaining reliability
     if (!process.env['MONGO_MAX_POOL_SIZE']) {
-        process.env['MONGO_MAX_POOL_SIZE'] = '5'; // Increased for better concurrency
+        process.env['MONGO_MAX_POOL_SIZE'] = '5';
     }
     if (!process.env['MONGO_MIN_POOL_SIZE']) {
-        process.env['MONGO_MIN_POOL_SIZE'] = '2'; // Increased for better performance
+        process.env['MONGO_MIN_POOL_SIZE'] = '2';
     }
     if (!process.env['MONGO_SERVER_SELECTION_TIMEOUT_MS']) {
-        process.env['MONGO_SERVER_SELECTION_TIMEOUT_MS'] = '5000'; // Increased for stability
+        process.env['MONGO_SERVER_SELECTION_TIMEOUT_MS'] = '5000';
     }
     if (!process.env['MONGO_SOCKET_TIMEOUT_MS']) {
-        process.env['MONGO_SOCKET_TIMEOUT_MS'] = '15000'; // Increased for stability
+        process.env['MONGO_SOCKET_TIMEOUT_MS'] = '15000';
     }
     if (!process.env['MONGO_TRANSACTION_TIMEOUT']) {
-        process.env['MONGO_TRANSACTION_TIMEOUT'] = '15000'; // Increased for stability
+        process.env['MONGO_TRANSACTION_TIMEOUT'] = '15000';
     }
     if (!process.env['MONGO_TRANSACTION_LOCK_REQUEST_TIMEOUT']) {
-        process.env['MONGO_TRANSACTION_LOCK_REQUEST_TIMEOUT'] = '8000'; // Increased for stability
+        process.env['MONGO_TRANSACTION_LOCK_REQUEST_TIMEOUT'] = '8000';
     }
     if (!process.env['MONGO_TRANSACTION_RETRY_BASE_DELAY']) {
-        process.env['MONGO_TRANSACTION_RETRY_BASE_DELAY'] = '100'; // Increased for stability
+        process.env['MONGO_TRANSACTION_RETRY_BASE_DELAY'] = '100';
     }
     // Disable transactions in test environment for better reliability
     if (!process.env['MONGO_USE_TRANSACTIONS']) {
-        process.env['MONGO_USE_TRANSACTIONS'] = 'false'; // Disable transactions for tests
+        process.env['MONGO_USE_TRANSACTIONS'] = 'false';
     }
     // Ensure language is set to English for consistent test behavior
     process.env.LANGUAGE = 'English (US)';
@@ -66,41 +67,47 @@ async function setupTestEnvironment(constants, apiRouterFactory, schemaMapFactor
     };
     setAdminLanguage('en-US');
     const env = new environment_1.Environment(envLocation, true);
-    const application = new application_1.Application(env, apiRouterFactory, schemaMapFactory, databaseInitFunction ??
-        services_1.DatabaseInitializationService.initUserDb.bind(services_1.DatabaseInitializationService), initResultHashFunction ??
-        services_1.DatabaseInitializationService.serverInitResultHash.bind(services_1.DatabaseInitializationService), cspConfig, constants, appRouterFactory, customInitMiddleware);
-    const initResult = await services_1.DatabaseInitializationService.initUserDb(application);
-    if (!initResult.success || !initResult.data) {
-        throw new Error('Failed to initialize database for tests');
-    }
-    const accountData = initResult.data;
-    // Create and start your app
+    // Create the Application with MongoDatabasePlugin
+    const application = new application_1.Application(env, apiRouterFactory, cspConfig, constants, appRouterFactory, customInitMiddleware);
+    const mongoPlugin = new mongo_database_plugin_1.MongoDatabasePlugin({
+        schemaMapFactory,
+        databaseInitFunction: databaseInitFunction ??
+            services_1.DatabaseInitializationService.initUserDb.bind(services_1.DatabaseInitializationService),
+        initResultHashFunction: initResultHashFunction ??
+            services_1.DatabaseInitializationService.serverInitResultHash.bind(services_1.DatabaseInitializationService),
+        environment: env,
+        constants,
+    });
+    application.useDatabasePlugin(mongoPlugin);
+    // Create and start your app — this connects the DB, inits plugins,
+    // and runs initializeDevStore (which calls initUserDb) via the plugin.
     try {
         await application.start();
-        const command = {
-            ...(application.environment.mongo.setParameterSupported
-                ? { setParameter: 1 }
-                : {}),
-            ...(application.environment.mongo.useTransactions &&
-                application.environment.mongo.transactionLifetimeLimitSecondsSupported
-                ? {
-                    transactionLifetimeLimitSeconds: application.environment.mongo.transactionTimeout,
-                }
-                : {}),
-            ...(application.environment.mongo.useTransactions &&
-                application.environment.mongo
-                    .maxTransactionLockRequestTimeoutMillisSupported
-                ? {
-                    maxTransactionLockRequestTimeoutMillis: application.environment.mongo.transactionLockRequestTimeout,
-                }
-                : {}),
-        };
-        if (Object.keys(command).length > 0 && application.db.connection.db) {
-            // Configure MongoDB for better concurrency
-            await application.db.connection.db
-                .admin()
-                .command(command)
-                .catch(() => undefined);
+        if (mongoPlugin.db.connection.db) {
+            const command = {
+                ...(application.environment.mongo.setParameterSupported
+                    ? { setParameter: 1 }
+                    : {}),
+                ...(application.environment.mongo.useTransactions &&
+                    application.environment.mongo.transactionLifetimeLimitSecondsSupported
+                    ? {
+                        transactionLifetimeLimitSeconds: application.environment.mongo.transactionTimeout,
+                    }
+                    : {}),
+                ...(application.environment.mongo.useTransactions &&
+                    application.environment.mongo
+                        .maxTransactionLockRequestTimeoutMillisSupported
+                    ? {
+                        maxTransactionLockRequestTimeoutMillis: application.environment.mongo.transactionLockRequestTimeout,
+                    }
+                    : {}),
+            };
+            if (Object.keys(command).length > 0) {
+                await mongoPlugin.db.connection.db
+                    .admin()
+                    .command(command)
+                    .catch(() => undefined);
+            }
         }
     }
     catch (error) {
@@ -110,9 +117,14 @@ async function setupTestEnvironment(constants, apiRouterFactory, schemaMapFactor
     }
     // Ensure the test process uses the same JWT secret as the application
     process.env.JWT_SECRET = application.environment.jwtSecret;
+    // Get the init result from the plugin (populated during start() → initializeDevStore)
+    const accountData = mongoPlugin.lastInitResult;
+    if (!accountData) {
+        throw new Error('Failed to initialize database for tests — no init result from plugin');
+    }
     return {
-        application,
-        mongoServer: application.devDatabase,
+        application: application,
+        mongoServer: mongoPlugin.devDatabase,
         mongoUri: application.environment.mongo.uri,
         accountData,
         dbName: application.environment.devDatabase,

package/src/__tests__/helpers/setup-test-env.js.map

@@ -1 +1 @@
-{"version":3,"file":"setup-test-env.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite/src/__tests__/helpers/setup-test-env.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"setup-test-env.js","sourceRoot":"","sources":["../../../../../../packages/digitaldefiance-node-express-suite/src/__tests__/helpers/setup-test-env.ts"],"names":[],"mappings":"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"}

package/src/application.d.ts

@@ -1,24 +1,35 @@
 /**
- * @fileoverview Main application class with Express server.
- * Extends MongoApplicationBase with HTTP/HTTPS server and routing.
+ * @fileoverview Generic Express application class.
+ * Extends BaseApplication with HTTP/HTTPS server, routing, and middleware.
+ * Database-agnostic — database backends are provided via IDatabasePlugin.
  * @module application
  */
-import mongoose from '@digitaldefiance/mongoose-types';
 import { Application as ExpressApplication } from 'express';
 import { HelmetOptions } from 'helmet';
-import { MongoApplicationBase } from './mongo-application-base';
-import { IBaseDocument } from './documents/base';
+import { BaseApplication } from './base-application';
 import { Environment } from './environment';
-import { IApplication, ICSPConfig, IFailableResult, IServerInitResult, IMongoApplication } from './interfaces';
+import { IApplication, ICSPConfig } from './interfaces';
 import { IConstants } from './interfaces/constants';
-import { IDocumentStore } from './interfaces/document-store';
 import { IFlexibleCSP } from './interfaces/flexible-csp';
 import { initMiddleware } from './middleware-utils';
 import { AppRouter } from './routers/app';
 import { BaseRouter } from './routers/base';
-import { SchemaMap } from './types';
+import { IDatabasePlugin } from './plugins/database-plugin';
+import type { IDatabase } from './interfaces/storage';
 import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
-export declare class Application<TInitResults extends IServerInitResult<TID>, TModelDocs extends Record<string, IBaseDocument<any, TID>>, TID extends PlatformID = Buffer, TEnvironment extends Environment<TID> = Environment<TID>, TConstants extends IConstants = IConstants, TAppRouter extends AppRouter<TID> = AppRouter<TID>> extends MongoApplicationBase<TID, TModelDocs, TInitResults, TConstants> implements IMongoApplication<TID> {
+/**
+ * Generic Express application class.
+ *
+ * Provides HTTP/HTTPS server, routing, middleware, and error handling.
+ * Database backends are plugged in via IDatabasePlugin rather than
+ * being baked into the class hierarchy.
+ *
+ * @template TID - Platform ID type (Buffer, ObjectId, etc.)
+ * @template TEnvironment - Environment type
+ * @template TConstants - Constants type
+ * @template TAppRouter - App router type
+ */
+export declare class Application<TID extends PlatformID = Buffer, TEnvironment extends Environment<TID> = Environment<TID>, TConstants extends IConstants = IConstants, TAppRouter extends AppRouter<TID> = AppRouter<TID>> extends BaseApplication<TID, unknown, TConstants> {
     readonly expressApp: ExpressApplication;
     private server;
     private readonly _cspConfig;
@@ -27,10 +38,25 @@ export declare class Application<TInitResults extends IServerInitResult<TID>, TM
     private readonly _initMiddleware;
     private _apiRouter?;
     private greenlockManager;
+    private _databasePlugin;
     get environment(): TEnvironment;
+    /**
+     * Get the registered database plugin, if any.
+     */
+    get databasePlugin(): IDatabasePlugin<TID> | null;
+    /**
+     * Register a database plugin. Must be called before start().
+     * The plugin will be initialized during start() and its database
+     * will be used as the application's primary database.
+     */
+    useDatabasePlugin(plugin: IDatabasePlugin<TID>): this;
+    /**
+     * Hook for subclasses to register services before the server starts.
+     * Called during the constructor.
+     */
     protected registerServices(): void;
-    constructor(environment: TEnvironment, apiRouterFactory: (app: IApplication<TID>) => BaseRouter<TID>, schemaMapFactory: (connection: mongoose.Connection) => SchemaMap<TID, TModelDocs>, databaseInitFunction: (application: MongoApplicationBase<TID, TModelDocs, TInitResults>) => Promise<IFailableResult<TInitResults>>, initResultHashFunction: (initResults: TInitResults) => string, cspConfig?: ICSPConfig | HelmetOptions | IFlexibleCSP, constants?: TConstants, appRouterFactory?: (apiRouter: BaseRouter<TID>) => TAppRouter, customInitMiddleware?: typeof initMiddleware, documentStore?: IDocumentStore<TID, TModelDocs>);
-    start(mongoUri?: string): Promise<void>;
+    constructor(environment: TEnvironment, apiRouterFactory: (app: IApplication<TID>) => BaseRouter<TID>, cspConfig?: ICSPConfig | HelmetOptions | IFlexibleCSP, constants?: TConstants, appRouterFactory?: (apiRouter: BaseRouter<TID>) => TAppRouter, customInitMiddleware?: typeof initMiddleware, database?: IDatabase);
+    start(uri?: string): Promise<void>;
     stop(): Promise<void>;
 }
 //# sourceMappingURL=application.d.ts.map

package/src/application.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-express-suite/src/application.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AAOvD,OAAgB,EACd,WAAW,IAAI,kBAAkB,EAIlC,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAIvC,OAAO,EAAE,oBAAoB,EAAE,MAAM,0BAA0B,CAAC;AAChE,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EACL,YAAY,EACZ,UAAU,EACV,eAAe,EAEf,iBAAiB,EACjB,iBAAiB,EAClB,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,cAAc,EAAE,MAAM,6BAA6B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAiB,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAK5C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAGpC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAOlE,qBAAa,WAAW,CACtB,YAAY,SAAS,iBAAiB,CAAC,GAAG,CAAC,EAC3C,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAC1D,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,YAAY,SAAS,WAAW,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,EACxD,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1C,UAAU,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAElD,SAAQ,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,CACtE,YAAW,iBAAiB,CAAC,GAAG,CAAC;IAEjC,SAAgB,UAAU,EAAE,kBAAkB,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IACvE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEb;IACrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAElB;IAChB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAAiC;IAEzD,IAAoB,WAAW,IAAI,YAAY,CAE9C;IAED,SAAS,CAAC,gBAAgB,IAAI,IAAI;gBAMhC,WAAW,EAAE,YAAY,EACzB,gBAAgB,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAC7D,gBAAgB,EAAE,CAChB,UAAU,EAAE,QAAQ,CAAC,UAAU,KAC5B,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,EAC/B,oBAAoB,EAAE,CACpB,WAAW,EAAE,oBAAoB,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,CAAC,KAC7D,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,EAC3C,sBAAsB,EAAE,CAAC,WAAW,EAAE,YAAY,KAAK,MAAM,EAC7D,SAAS,GAAE,UAAU,GAAG,aAAa,GAAG,YAWvC,EACD,SAAS,GAAE,UAAoC,EAC/C,gBAAgB,GAAE,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,UAEP,EAC3C,oBAAoB,GAAE,OAAO,cAA+B,EAC5D,aAAa,CAAC,EAAE,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC;IAqB3B,KAAK,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAqKvC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CA0C5C"}
+{"version":3,"file":"application.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-express-suite/src/application.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AASH,OAAgB,EACd,WAAW,IAAI,kBAAkB,EAIlC,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AAIvC,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,UAAU,EAAe,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,YAAY,EAAiB,MAAM,2BAA2B,CAAC;AACxE,OAAO,EAAE,cAAc,EAAmB,MAAM,oBAAoB,CAAC;AACrE,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAG5C,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACtD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAKlE;;;;;;;;;;;GAWG;AACH,qBAAa,WAAW,CACtB,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,YAAY,SAAS,WAAW,CAAC,GAAG,CAAC,GAAG,WAAW,CAAC,GAAG,CAAC,EACxD,UAAU,SAAS,UAAU,GAAG,UAAU,EAC1C,UAAU,SAAS,SAAS,CAAC,GAAG,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAClD,SAAQ,eAAe,CAAC,GAAG,EAAE,OAAO,EAAE,UAAU,CAAC;IACjD,SAAgB,UAAU,EAAE,kBAAkB,CAAC;IAC/C,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAA4C;IACvE,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAEb;IACrB,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAElB;IAChB,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAwB;IACxD,OAAO,CAAC,UAAU,CAAC,CAAkB;IACrC,OAAO,CAAC,gBAAgB,CAAiC;IACzD,OAAO,CAAC,eAAe,CAAqC;IAE5D,IAAoB,WAAW,IAAI,YAAY,CAE9C;IAED;;OAEG;IACH,IAAW,cAAc,IAAI,eAAe,CAAC,GAAG,CAAC,GAAG,IAAI,CAEvD;IAED;;;;OAIG;IACI,iBAAiB,CAAC,MAAM,EAAE,eAAe,CAAC,GAAG,CAAC,GAAG,IAAI;IAO5D;;;OAGG;IACH,SAAS,CAAC,gBAAgB,IAAI,IAAI;gBAKhC,WAAW,EAAE,YAAY,EACzB,gBAAgB,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,EAC7D,SAAS,GAAE,UAAU,GAAG,aAAa,GAAG,YAWvC,EACD,SAAS,GAAE,UAAoC,EAC/C,gBAAgB,GAAE,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,UAEP,EAC3C,oBAAoB,GAAE,OAAO,cAA+B,EAC5D,QAAQ,CAAC,EAAE,SAAS;IAYA,KAAK,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAuNlC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAiD5C"}