@digitaldefiance/node-express-suite 3.18.3 → 4.0.1

package/src/interfaces/document-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"document-store.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/document-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;GAKG;AAEH,MAAM,WAAW,cAAc,CAC7B,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;IAED,8EAA8E;IAC9E,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,yCAAyC;IACzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,yEAAyE;IACzE,WAAW,IAAI,OAAO,CAAC;IAEvB,kDAAkD;IAClD,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzE,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAE9E,+DAA+D;IAC/D,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAE1C,6EAA6E;IAC7E,aAAa,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEzC,yDAAyD;IACzD,kBAAkB,CAAC,CAAC,YAAY,EAC9B,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GACrB,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B"}
+{"version":3,"file":"document-store.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/document-store.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,cAAc,2BAA2B,CAAC"}

package/src/interfaces/document-store.js

@@ -1,8 +1,10 @@
 "use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
 /**
- * @fileoverview Storage-agnostic interface for database operations.
- * Implementations wrap specific database technologies (mongoose, BrightChainDb, etc.).
+ * @fileoverview Backward-compatible re-export of IDocumentStore.
+ * @deprecated Import from './mongoose-document-store' instead.
  * @module interfaces/document-store
  */
-Object.defineProperty(exports, "__esModule", { value: true });
+tslib_1.__exportStar(require("./mongoose-document-store"), exports);
 //# sourceMappingURL=document-store.js.map

package/src/interfaces/document-store.js.map

@@ -1 +1 @@
-{"version":3,"file":"document-store.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/document-store.ts"],"names":[],"mappings":";AAAA;;;;GAIG"}
+{"version":3,"file":"document-store.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/document-store.ts"],"names":[],"mappings":";;;AAAA;;;;GAIG;AACH,oEAA0C"}

package/src/interfaces/index.d.ts

@@ -1,3 +1,4 @@
+export * from './mongoose-document-store';
 export * from './document-store';
 export * from './storage';
 export * from './api-error-response';

package/src/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAE1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,2BAA2B,CAAC;AAC1C,cAAc,kBAAkB,CAAC;AACjC,cAAc,WAAW,CAAC;AAE1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,yCAAyC,CAAC;AACxD,cAAc,wBAAwB,CAAC;AACvC,cAAc,uCAAuC,CAAC;AACtD,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,2BAA2B,CAAC;AAC1C,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,mBAAmB,CAAC;AAClC,cAAc,aAAa,CAAC;AAC5B,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC;AAC7B,cAAc,kBAAkB,CAAC;AACjC,cAAc,kBAAkB,CAAC;AACjC,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iBAAiB,CAAC;AAChC,cAAc,eAAe,CAAC;AAC9B,cAAc,qBAAqB,CAAC;AACpC,cAAc,mBAAmB,CAAC;AAClC,cAAc,cAAc,CAAC;AAC7B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,4BAA4B,CAAC;AAC3C,cAAc,cAAc,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,UAAU,CAAC;AACzB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,WAAW,CAAC;AAC1B,cAAc,WAAW,CAAC;AAC1B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,wBAAwB,CAAC;AACvC,cAAc,UAAU,CAAC;AACzB,cAAc,sBAAsB,CAAC;AACrC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,kBAAkB,CAAC"}

package/src/interfaces/index.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mongoose-document-store"), exports);
 tslib_1.__exportStar(require("./document-store"), exports);
 tslib_1.__exportStar(require("./storage"), exports);
 tslib_1.__exportStar(require("./api-error-response"), exports);

package/src/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,2DAAiC;AACjC,oDAA0B;AAE1B,+DAAqC;AACrC,kFAAwD;AACxD,iEAAuC;AACvC,gFAAsD;AACtD,0DAAgC;AAChC,wDAA8B;AAC9B,oEAA0C;AAC1C,8DAAoC;AACpC,4DAAkC;AAClC,4DAAkC;AAClC,4DAAkC;AAClC,sDAA4B;AAC5B,8DAAoC;AACpC,+DAAqC;AACrC,uDAA6B;AAC7B,2DAAiC;AACjC,2DAAiC;AACjC,sEAA4C;AAC5C,0DAAgC;AAChC,wDAA8B;AAC9B,8DAAoC;AACpC,4DAAkC;AAClC,uDAA6B;AAC7B,yDAA+B;AAC/B,qEAA2C;AAC3C,uDAA6B;AAC7B,8DAAoC;AACpC,gEAAsC;AACtC,mDAAyB;AACzB,yDAA+B;AAC/B,oDAA0B;AAC1B,oDAA0B;AAC1B,yDAA+B;AAC/B,iEAAuC;AACvC,mDAAyB;AACzB,+DAAqC;AACrC,iEAAuC;AACvC,yEAA+C;AAC/C,2DAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/index.ts"],"names":[],"mappings":";;;AAAA,oEAA0C;AAC1C,2DAAiC;AACjC,oDAA0B;AAE1B,+DAAqC;AACrC,kFAAwD;AACxD,iEAAuC;AACvC,gFAAsD;AACtD,0DAAgC;AAChC,wDAA8B;AAC9B,oEAA0C;AAC1C,8DAAoC;AACpC,4DAAkC;AAClC,4DAAkC;AAClC,4DAAkC;AAClC,sDAA4B;AAC5B,8DAAoC;AACpC,+DAAqC;AACrC,uDAA6B;AAC7B,2DAAiC;AACjC,2DAAiC;AACjC,sEAA4C;AAC5C,0DAAgC;AAChC,wDAA8B;AAC9B,8DAAoC;AACpC,4DAAkC;AAClC,uDAA6B;AAC7B,yDAA+B;AAC/B,qEAA2C;AAC3C,uDAA6B;AAC7B,8DAAoC;AACpC,gEAAsC;AACtC,mDAAyB;AACzB,yDAA+B;AAC/B,oDAA0B;AAC1B,oDAA0B;AAC1B,yDAA+B;AAC/B,iEAAuC;AACvC,mDAAyB;AACzB,+DAAqC;AACrC,iEAAuC;AACvC,yEAA+C;AAC/C,2DAAiC"}

package/src/interfaces/mongoose-document-store.d.ts

@@ -0,0 +1,42 @@
+/**
+ * @fileoverview Mongoose-specific interface for document store operations.
+ * This interface depends on Mongoose types (Model, MongoMemoryReplSet).
+ * Non-Mongoose database plugins should implement IDatabasePlugin directly
+ * without depending on this interface.
+ * @module interfaces/mongoose-document-store
+ */
+import { Model } from '@digitaldefiance/mongoose-types';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import { MongoMemoryReplSet } from 'mongodb-memory-server';
+import { IBaseDocument } from '../documents/base';
+import { ISchema } from './schema';
+import { IApplication } from './application';
+/**
+ * Mongoose-specific interface for document store operations.
+ * This interface depends on Mongoose types (Model, MongoMemoryReplSet).
+ * Non-Mongoose database plugins should implement IDatabasePlugin directly
+ * without depending on this interface.
+ * @template TID - Platform-specific ID type extending PlatformID
+ * @template TModelDocs - Record mapping model names to their document types
+ */
+export interface IDocumentStore<TID extends PlatformID = Buffer, TModelDocs extends Record<string, IBaseDocument<any, TID>> = Record<string, IBaseDocument<any, TID>>> {
+    /** Connect to the backing store. URI may be ignored by non-network stores. */
+    connect(uri?: string): Promise<void>;
+    /** Disconnect from the backing store. */
+    disconnect(): Promise<void>;
+    /** Whether the store is currently connected and ready for operations. */
+    isConnected(): boolean;
+    /** Retrieve a Mongoose model by name. */
+    getModel<T extends IBaseDocument<any, TID>>(modelName: string): Model<T>;
+    /** The schema map, if available (populated after connect). */
+    readonly schemaMap?: {
+        [K in keyof TModelDocs]: ISchema<TID, TModelDocs[K]>;
+    };
+    /** The dev database instance (MongoMemoryReplSet), if any (for cleanup on stop). */
+    readonly devDatabase?: MongoMemoryReplSet;
+    /** Optional: provision a dev/test database, returning its connection URI. */
+    setupDevStore?(): Promise<string | void>;
+    /** Optional: seed the dev database with initial data. */
+    initializeDevStore?<TInitResults>(app: IApplication<TID>): Promise<TInitResults>;
+}
+//# sourceMappingURL=mongoose-document-store.d.ts.map

package/src/interfaces/mongoose-document-store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-document-store.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/mongoose-document-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,UAAU,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C;;;;;;;GAOG;AAEH,MAAM,WAAW,cAAc,CAC7B,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;IAED,8EAA8E;IAC9E,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC,yCAAyC;IACzC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B,yEAAyE;IACzE,WAAW,IAAI,OAAO,CAAC;IAEvB,yCAAyC;IACzC,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;IAEzE,8DAA8D;IAC9D,QAAQ,CAAC,SAAS,CAAC,EAAE;SAAG,CAAC,IAAI,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC;KAAE,CAAC;IAE9E,oFAAoF;IACpF,QAAQ,CAAC,WAAW,CAAC,EAAE,kBAAkB,CAAC;IAE1C,6EAA6E;IAC7E,aAAa,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAAC;IAEzC,yDAAyD;IACzD,kBAAkB,CAAC,CAAC,YAAY,EAC9B,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GACrB,OAAO,CAAC,YAAY,CAAC,CAAC;CAC1B"}

package/src/interfaces/mongoose-document-store.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @fileoverview Mongoose-specific interface for document store operations.
+ * This interface depends on Mongoose types (Model, MongoMemoryReplSet).
+ * Non-Mongoose database plugins should implement IDatabasePlugin directly
+ * without depending on this interface.
+ * @module interfaces/mongoose-document-store
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=mongoose-document-store.js.map

package/src/interfaces/mongoose-document-store.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-document-store.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/interfaces/mongoose-document-store.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/src/{application-concrete.d.ts → mongo-application-concrete.d.ts}

@@ -1,20 +1,26 @@
 /**
  * @fileoverview Concrete implementation of the Application class for testing and development.
- * @module application-concrete
+ * Uses the new plugin-based architecture with MongoDatabasePlugin.
+ * @module mongo-application-concrete
  */
 import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
 import { Application } from './application';
 import { Environment } from './environment';
-import { IConstants, IServerInitResult } from './interfaces';
+import { IConstants } from './interfaces';
 import { AppRouter } from './routers';
-import { BaseModelDocs } from './schemas';
+import { MongoDatabasePlugin } from './plugins/mongo-database-plugin';
 /**
  * Concrete implementation of the Application class for testing and development purposes.
- * Provides a ready-to-use application instance with default configuration and dummy email service.
+ * Provides a ready-to-use application instance with default configuration,
+ * MongoDatabasePlugin, and dummy email service.
  *
  * @template TID - Platform ID type (Buffer, ObjectId, etc.)
  */
-export declare class ApplicationConcrete<TID extends PlatformID = Buffer> extends Application<IServerInitResult<TID>, BaseModelDocs, TID, Environment<TID>, IConstants, AppRouter<TID>> {
+export declare class MongoApplicationConcrete<TID extends PlatformID = Buffer> extends Application<TID, Environment<TID>, IConstants, AppRouter<TID>> {
+    /**
+     * The Mongo database plugin for accessing Mongoose-specific features.
+     */
+    readonly mongoPlugin: MongoDatabasePlugin<TID, any, any, IConstants>;
     /**
      * Creates a new concrete application instance.
      *
@@ -23,4 +29,4 @@ export declare class ApplicationConcrete<TID extends PlatformID = Buffer> extend
      */
     constructor(environment: Environment<TID>, constants?: IConstants);
 }
-//# sourceMappingURL=application-concrete.d.ts.map
+//# sourceMappingURL=mongo-application-concrete.d.ts.map

package/src/mongo-application-concrete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-application-concrete.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-express-suite/src/mongo-application-concrete.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAE5C,OAAO,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAC5C,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAG1C,OAAO,EAAa,SAAS,EAAE,MAAM,WAAW,CAAC;AAIjD,OAAO,EAAE,mBAAmB,EAAE,MAAM,iCAAiC,CAAC;AAEtE;;;;;;GAMG;AACH,qBAAa,wBAAwB,CACnC,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;IACtE;;OAEG;IACH,SAAgB,WAAW,EAAE,mBAAmB,CAC9C,GAAG,EAEH,GAAG,EAEH,GAAG,EACH,UAAU,CACX,CAAC;IAEF;;;;;OAKG;gBAED,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,EAC7B,SAAS,GAAE,UAA+B;CA8B7C"}

package/src/mongo-application-concrete.js

@@ -0,0 +1,49 @@
+"use strict";
+/**
+ * @fileoverview Concrete implementation of the Application class for testing and development.
+ * Uses the new plugin-based architecture with MongoDatabasePlugin.
+ * @module mongo-application-concrete
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoApplicationConcrete = void 0;
+const application_1 = require("./application");
+const constants_1 = require("./constants");
+const registry_1 = require("./registry");
+const routers_1 = require("./routers");
+const schemas_1 = require("./schemas");
+const services_1 = require("./services");
+const dummy_email_service_1 = require("./services/dummy-email-service");
+const mongo_database_plugin_1 = require("./plugins/mongo-database-plugin");
+/**
+ * Concrete implementation of the Application class for testing and development purposes.
+ * Provides a ready-to-use application instance with default configuration,
+ * MongoDatabasePlugin, and dummy email service.
+ *
+ * @template TID - Platform ID type (Buffer, ObjectId, etc.)
+ */
+class MongoApplicationConcrete extends application_1.Application {
+    /**
+     * The Mongo database plugin for accessing Mongoose-specific features.
+     */
+    mongoPlugin;
+    /**
+     * Creates a new concrete application instance.
+     *
+     * @param environment - Application environment configuration
+     * @param constants - Application constants (defaults to LocalhostConstants)
+     */
+    constructor(environment, constants = constants_1.LocalhostConstants) {
+        super(environment, (app) => new routers_1.ApiRouter(app), undefined, constants, (apiRouter) => new routers_1.AppRouter(apiRouter), undefined);
+        this.mongoPlugin = new mongo_database_plugin_1.MongoDatabasePlugin({
+            schemaMapFactory: schemas_1.getSchemaMap,
+            databaseInitFunction: services_1.DatabaseInitializationService.initUserDb.bind(services_1.DatabaseInitializationService),
+            initResultHashFunction: services_1.DatabaseInitializationService.serverInitResultHash.bind(services_1.DatabaseInitializationService),
+            environment,
+            constants,
+        });
+        this.useDatabasePlugin(this.mongoPlugin);
+        registry_1.emailServiceRegistry.setService(new dummy_email_service_1.DummyEmailService(this));
+    }
+}
+exports.MongoApplicationConcrete = MongoApplicationConcrete;
+//# sourceMappingURL=mongo-application-concrete.js.map

package/src/mongo-application-concrete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-application-concrete.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-express-suite/src/mongo-application-concrete.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,+CAA4C;AAC5C,2CAAiD;AAIjD,yCAAkD;AAClD,uCAAiD;AACjD,uCAAyC;AACzC,yCAA2D;AAC3D,wEAAmE;AACnE,2EAAsE;AAEtE;;;;;;GAMG;AACH,MAAa,wBAEX,SAAQ,yBAA8D;IACtE;;OAEG;IACa,WAAW,CAOzB;IAEF;;;;;OAKG;IACH,YACE,WAA6B,EAC7B,YAAwB,8BAAkB;QAE1C,KAAK,CACH,WAAW,EACX,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,mBAAS,CAAC,GAA6B,CAAC,EACrD,SAAS,EACT,SAAS,EACT,CAAC,SAAS,EAAE,EAAE,CAAC,IAAI,mBAAS,CAAC,SAAS,CAAmB,EACzD,SAAS,CACV,CAAC;QAEF,IAAI,CAAC,WAAW,GAAG,IAAI,2CAAmB,CAAC;YACzC,gBAAgB,EAAE,sBAAY;YAC9B,oBAAoB,EAAE,wCAA6B,CAAC,UAAU,CAAC,IAAI,CACjE,wCAA6B,CAC9B;YACD,sBAAsB,EACpB,wCAA6B,CAAC,oBAAoB,CAAC,IAAI,CACrD,wCAA6B,CAC9B;YACH,WAAW;YACX,SAAS;SACV,CAAC,CAAC;QAEH,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,WAAW,CAAC,CAAC;QAEzC,+BAAoB,CAAC,UAAU,CAC7B,IAAI,uCAAiB,CAAmB,IAAI,CAAC,CAC9C,CAAC;IACJ,CAAC;CACF;AArDD,4DAqDC"}

package/src/plugins/database-plugin.d.ts

@@ -0,0 +1,66 @@
+/**
+ * @fileoverview Database plugin interface.
+ * Extends IApplicationPlugin with database-specific lifecycle hooks,
+ * allowing database backends to be plugged into an Application as plugins
+ * rather than baked into the class hierarchy.
+ * @module plugins/database-plugin
+ */
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { IDatabase } from '../interfaces/storage';
+import type { IAuthenticationProvider } from '../interfaces/authentication-provider';
+import type { IApplicationPlugin } from './plugin-interface';
+/**
+ * Plugin interface for database backends.
+ *
+ * A database plugin owns the full database lifecycle: connection, disconnection,
+ * dev store provisioning, authentication provider wiring, and any
+ * backend-specific accessors (e.g. Mongoose models, schema maps).
+ *
+ * The plugin's `init()` is called during `Application.start()` (via PluginManager)
+ * after the base IDatabase has been connected. The plugin can use `init()` to
+ * wire up the auth provider, seed dev data, register models, etc.
+ *
+ * @template TID - Platform ID type (Buffer, ObjectId, etc.)
+ */
+export interface IDatabasePlugin<TID extends PlatformID = Buffer> extends IApplicationPlugin<TID> {
+    /**
+     * The IDatabase instance this plugin manages.
+     * The Application will use this as its primary database.
+     */
+    readonly database: IDatabase;
+    /**
+     * Optional authentication provider supplied by this database backend.
+     * If provided, the Application will set this as its authProvider during start().
+     */
+    readonly authenticationProvider?: IAuthenticationProvider<TID>;
+    /**
+     * Connect the database. Called by Application.start() before plugin init.
+     * @param uri - Optional connection URI (from environment or dev store).
+     */
+    connect(uri?: string): Promise<void>;
+    /**
+     * Disconnect the database. Called by Application.stop().
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Whether the database is currently connected.
+     */
+    isConnected(): boolean;
+    /**
+     * Optional: provision an ephemeral dev/test database.
+     * Returns the connection URI for the provisioned store.
+     * Called before connect() when environment.devDatabase is truthy.
+     */
+    setupDevStore?(): Promise<string>;
+    /**
+     * Optional: tear down the ephemeral dev/test database on shutdown.
+     */
+    teardownDevStore?(): Promise<void>;
+    /**
+     * Optional: seed the database after connection in dev mode.
+     * Called after connect() and init() when environment.devDatabase is truthy.
+     * May return initialization results (e.g. seeded user data).
+     */
+    initializeDevStore?(): Promise<unknown>;
+}
+//# sourceMappingURL=database-plugin.d.ts.map

package/src/plugins/database-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-plugin.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/database-plugin.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAE7D;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,eAAe,CAC9B,GAAG,SAAS,UAAU,GAAG,MAAM,CAC/B,SAAQ,kBAAkB,CAAC,GAAG,CAAC;IAC/B;;;OAGG;IACH,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC;IAE7B;;;OAGG;IACH,QAAQ,CAAC,sBAAsB,CAAC,EAAE,uBAAuB,CAAC,GAAG,CAAC,CAAC;IAE/D;;;OAGG;IACH,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAE5B;;OAEG;IACH,WAAW,IAAI,OAAO,CAAC;IAEvB;;;;OAIG;IACH,aAAa,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;IAElC;;OAEG;IACH,gBAAgB,CAAC,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IAEnC;;;;OAIG;IACH,kBAAkB,CAAC,IAAI,OAAO,CAAC,OAAO,CAAC,CAAC;CACzC"}

package/src/plugins/database-plugin.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * @fileoverview Database plugin interface.
+ * Extends IApplicationPlugin with database-specific lifecycle hooks,
+ * allowing database backends to be plugged into an Application as plugins
+ * rather than baked into the class hierarchy.
+ * @module plugins/database-plugin
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=database-plugin.js.map

package/src/plugins/database-plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database-plugin.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/database-plugin.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG"}

package/src/plugins/index.d.ts

@@ -1,4 +1,6 @@
 export * from './plugin-interface';
 export * from './plugin-manager';
+export * from './database-plugin';
+export * from './mongo-database-plugin';
 export * from './upnp';
 //# sourceMappingURL=index.d.ts.map

package/src/plugins/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,QAAQ,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC;AACnC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,yBAAyB,CAAC;AACxC,cAAc,QAAQ,CAAC"}

package/src/plugins/index.js

@@ -3,5 +3,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 const tslib_1 = require("tslib");
 tslib_1.__exportStar(require("./plugin-interface"), exports);
 tslib_1.__exportStar(require("./plugin-manager"), exports);
+tslib_1.__exportStar(require("./database-plugin"), exports);
+tslib_1.__exportStar(require("./mongo-database-plugin"), exports);
 tslib_1.__exportStar(require("./upnp"), exports);
 //# sourceMappingURL=index.js.map

package/src/plugins/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,2DAAiC;AACjC,iDAAuB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/index.ts"],"names":[],"mappings":";;;AAAA,6DAAmC;AACnC,2DAAiC;AACjC,4DAAkC;AAClC,kEAAwC;AACxC,iDAAuB"}

package/src/plugins/mongo-database-plugin.d.ts

@@ -0,0 +1,115 @@
+/**
+ * @fileoverview Mongoose/MongoDB database plugin.
+ * Extracts all Mongo-specific database lifecycle
+ * into a plugin that can be registered on any Application instance.
+ * @module plugins/mongo-database-plugin
+ */
+import { Model } from '@digitaldefiance/mongoose-types';
+import mongoose from '@digitaldefiance/mongoose-types';
+import { MongoMemoryReplSet } from 'mongodb-memory-server';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { IDatabase } from '../interfaces/storage';
+import type { IAuthenticationProvider } from '../interfaces/authentication-provider';
+import type { IApplication } from '../interfaces/application';
+import type { IBaseDocument } from '../documents/base';
+import type { IDocumentStore } from '../interfaces/mongoose-document-store';
+import type { IConstants } from '../interfaces/constants';
+import type { IMongoApplication } from '../interfaces/mongo-application';
+import type { IFailableResult } from '../interfaces/failable-result';
+import type { SchemaMap } from '../types';
+import type { IDatabasePlugin } from './database-plugin';
+import { Environment } from '../environment';
+/**
+ * Options for constructing a MongoDatabasePlugin.
+ */
+export interface MongoDatabasePluginOptions<TID extends PlatformID, TModelDocs extends Record<string, IBaseDocument<any, TID>>, TInitResults, TConstants extends IConstants = IConstants> {
+    schemaMapFactory: (connection: mongoose.Connection) => SchemaMap<TID, TModelDocs>;
+    databaseInitFunction: (application: IMongoApplication<TID>) => Promise<IFailableResult<TInitResults>>;
+    initResultHashFunction: (initResults: TInitResults) => string;
+    environment: Environment<TID>;
+    constants?: TConstants;
+}
+/**
+ * Mongoose/MongoDB database plugin.
+ *
+ * Wraps a MongooseDocumentStore and exposes Mongoose-specific accessors
+ * (db, getModel, schemaMap, devDatabase) while conforming to the
+ * IDatabasePlugin contract for pluggable database backends.
+ *
+ * @template TID - Platform ID type
+ * @template TModelDocs - Record mapping model names to document types
+ * @template TInitResults - Database initialization result type
+ * @template TConstants - Application constants type
+ */
+export declare class MongoDatabasePlugin<TID extends PlatformID, TModelDocs extends Record<string, IBaseDocument<any, TID>>, TInitResults, TConstants extends IConstants = IConstants> implements IDatabasePlugin<TID> {
+    readonly name = "mongo-database";
+    readonly version = "1.0.0";
+    private readonly _documentStore;
+    private readonly _environment;
+    private _authProvider;
+    private _application;
+    private _lastInitResult;
+    constructor(options: MongoDatabasePluginOptions<TID, TModelDocs, TInitResults, TConstants>);
+    /**
+     * Construct from an existing IDocumentStore instance.
+     */
+    static fromDocumentStore<TID extends PlatformID, TModelDocs extends Record<string, IBaseDocument<any, TID>>, TInitResults, TConstants extends IConstants = IConstants>(documentStore: IDocumentStore<TID, TModelDocs>, environment: Environment<TID>): MongoDatabasePlugin<TID, TModelDocs, TInitResults, TConstants>;
+    /**
+     * The IDatabase instance. For Mongo, this is a no-op adapter since
+     * the document store manages its own connection lifecycle.
+     */
+    get database(): IDatabase;
+    get authenticationProvider(): IAuthenticationProvider<TID> | undefined;
+    connect(uri?: string): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    setupDevStore(): Promise<string>;
+    teardownDevStore(): Promise<void>;
+    initializeDevStore(): Promise<TInitResults | undefined>;
+    /**
+     * Get the result of the last initializeDevStore call.
+     * Available after start() completes in dev mode.
+     */
+    get lastInitResult(): TInitResults | undefined;
+    /**
+     * Get the IMongoApplication adapter created during init().
+     * This adapter delegates Mongo-specific accessors (db, getModel) to the plugin
+     * and everything else to the real application. Use this when constructing
+     * services that need IMongoApplication (e.g. UserService, RoleService).
+     * Available after init() has been called.
+     */
+    get mongoApplication(): IMongoApplication<TID> | undefined;
+    /**
+     * Called by PluginManager during Application.start().
+     * Wires up the Mongoose-backed authentication provider.
+     */
+    init(app: IApplication<TID>): Promise<void>;
+    stop(): Promise<void>;
+    /**
+     * Get the Mongoose database instance.
+     */
+    get db(): typeof mongoose;
+    /**
+     * Get the schema map for all models.
+     */
+    get schemaMap(): SchemaMap<TID, TModelDocs>;
+    /**
+     * Get the in-memory MongoDB instance (if any).
+     */
+    get devDatabase(): MongoMemoryReplSet | undefined;
+    /**
+     * Get the underlying document store.
+     */
+    get documentStore(): IDocumentStore<TID, TModelDocs>;
+    /**
+     * Get a Mongoose model by name.
+     */
+    getModel<T extends IBaseDocument<any, TID>>(modelName: string): Model<T>;
+    /**
+     * Creates a lightweight adapter that satisfies IMongoApplication
+     * by delegating to the plugin for Mongo-specific accessors and
+     * to the real app for everything else.
+     */
+    private createMongoAppAdapter;
+}
+//# sourceMappingURL=mongo-database-plugin.d.ts.map

package/src/plugins/mongo-database-plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-database-plugin.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/plugins/mongo-database-plugin.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,iCAAiC,CAAC;AACxD,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AAMvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAClE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AACvD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,uCAAuC,CAAC;AACrF,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uCAAuC,CAAC;AAC5E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAC1D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AAC1C,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAIzD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAG7C;;GAEG;AACH,MAAM,WAAW,0BAA0B,CACzC,GAAG,SAAS,UAAU,EAEtB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAC1D,YAAY,EACZ,UAAU,SAAS,UAAU,GAAG,UAAU;IAE1C,gBAAgB,EAAE,CAChB,UAAU,EAAE,QAAQ,CAAC,UAAU,KAC5B,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAAC;IAChC,oBAAoB,EAAE,CACpB,WAAW,EAAE,iBAAiB,CAAC,GAAG,CAAC,KAChC,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,CAAC;IAC5C,sBAAsB,EAAE,CAAC,WAAW,EAAE,YAAY,KAAK,MAAM,CAAC;IAC9D,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,CAAC;IAC9B,SAAS,CAAC,EAAE,UAAU,CAAC;CACxB;AAED;;;;;;;;;;;GAWG;AAEH,qBAAa,mBAAmB,CAC9B,GAAG,SAAS,UAAU,EAEtB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAC1D,YAAY,EACZ,UAAU,SAAS,UAAU,GAAG,UAAU,CAC1C,YAAW,eAAe,CAAC,GAAG,CAAC;IAC/B,SAAgB,IAAI,oBAAoB;IACxC,SAAgB,OAAO,WAAW;IAElC,OAAO,CAAC,QAAQ,CAAC,cAAc,CAAkC;IACjE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAmB;IAChD,OAAO,CAAC,aAAa,CAA+C;IACpE,OAAO,CAAC,YAAY,CAAgC;IACpD,OAAO,CAAC,eAAe,CAA2B;gBAGhD,OAAO,EAAE,0BAA0B,CACjC,GAAG,EACH,UAAU,EACV,YAAY,EACZ,UAAU,CACX;IAkBH;;OAEG;IACH,MAAM,CAAC,iBAAiB,CACtB,GAAG,SAAS,UAAU,EAEtB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,EAC1D,YAAY,EACZ,UAAU,SAAS,UAAU,GAAG,UAAU,EAE1C,aAAa,EAAE,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,EAC9C,WAAW,EAAE,WAAW,CAAC,GAAG,CAAC,GAC5B,mBAAmB,CAAC,GAAG,EAAE,UAAU,EAAE,YAAY,EAAE,UAAU,CAAC;IAyBjE;;;OAGG;IACH,IAAI,QAAQ,IAAI,SAAS,CAExB;IAED,IAAI,sBAAsB,IAAI,uBAAuB,CAAC,GAAG,CAAC,GAAG,SAAS,CAErE;IAEK,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAepC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAOjC,WAAW,IAAI,OAAO;IAIhB,aAAa,IAAI,OAAO,CAAC,MAAM,CAAC;IAQhC,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC,kBAAkB,IAAI,OAAO,CAAC,YAAY,GAAG,SAAS,CAAC;IAiB7D;;;OAGG;IACH,IAAI,cAAc,IAAI,YAAY,GAAG,SAAS,CAE7C;IAED;;;;;;OAMG;IACH,IAAI,gBAAgB,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,SAAS,CAEzD;IAED;;;OAGG;IACG,IAAI,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAmB3C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;OAEG;IACH,IAAI,EAAE,IAAI,OAAO,QAAQ,CAOxB;IAED;;OAEG;IACH,IAAI,SAAS,IAAI,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,CAQ1C;IAED;;OAEG;IACH,IAAI,WAAW,IAAI,kBAAkB,GAAG,SAAS,CAEhD;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,cAAc,CAAC,GAAG,EAAE,UAAU,CAAC,CAEnD;IAED;;OAEG;IAEH,QAAQ,CAAC,CAAC,SAAS,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,EAAE,SAAS,EAAE,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC;IAIxE;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;CAoC9B"}