@digitaldefiance/node-express-suite 3.12.16 → 3.13.0

package/src/services/mongoose-database.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview Mongoose database adapter implementing IDatabase.
+ * Wraps a mongoose connection to conform to the shared IDatabase interface
+ * from brightchain-lib, enabling application code to work with mongoose
+ * through the unified database contract.
+ * @module services/mongoose-database
+ */
+import type { BsonDocument, CollectionOptions, IClientSession, ICollection, IDatabase } from '@brightchain/brightchain-lib';
+import type { Connection } from '@digitaldefiance/mongoose-types';
+/**
+ * Adapts a mongoose connection to the IDatabase interface.
+ * Allows existing mongoose-based applications to use the unified
+ * IDatabase contract from brightchain-lib.
+ */
+export declare class MongooseDatabase implements IDatabase {
+    private _connection;
+    /**
+     * @param connection - Optional mongoose connection to wrap.
+     *   Defaults to the global mongoose.connection if not provided.
+     */
+    constructor(connection?: Connection);
+    /**
+     * Get the underlying mongoose connection for direct access when needed.
+     */
+    get connection(): Connection;
+    /**
+     * Connect to MongoDB via mongoose.
+     * If a URI is provided, establishes a new connection.
+     * If already connected, this is a no-op.
+     */
+    connect(uri?: string): Promise<void>;
+    /**
+     * Disconnect from MongoDB.
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Whether the mongoose connection is in the 'connected' state.
+     */
+    isConnected(): boolean;
+    /**
+     * Get or create a collection by name, returning an ICollection adapter.
+     */
+    collection<T extends BsonDocument = BsonDocument>(name: string, _options?: CollectionOptions): ICollection<T>;
+    /**
+     * Start a client session for transaction support.
+     * Wraps the mongoose session in an IClientSession adapter.
+     */
+    startSession(): IClientSession;
+    /**
+     * Execute a callback within a mongoose transaction with retry logic.
+     * Handles session lifecycle: start → transaction → commit/abort → end.
+     */
+    withTransaction<R>(fn: (session: IClientSession) => Promise<R>): Promise<R>;
+    /**
+     * List all collection names known to this connection.
+     */
+    listCollections(): string[];
+    /**
+     * Drop a collection by name.
+     * @returns true if the collection was dropped, false if it didn't exist.
+     */
+    dropCollection(name: string): Promise<boolean>;
+}
+//# sourceMappingURL=mongoose-database.d.ts.map

package/src/services/mongoose-database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-database.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/services/mongoose-database.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EACV,YAAY,EACZ,iBAAiB,EACjB,cAAc,EACd,WAAW,EACX,SAAS,EACV,MAAM,8BAA8B,CAAC;AAEtC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAIlE;;;;GAIG;AACH,qBAAa,gBAAiB,YAAW,SAAS;IAChD,OAAO,CAAC,WAAW,CAAa;IAEhC;;;OAGG;gBACS,UAAU,CAAC,EAAE,UAAU;IAInC;;OAEG;IACH,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED;;;;OAIG;IACG,OAAO,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C;;OAEG;IACG,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAMjC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACH,UAAU,CAAC,CAAC,SAAS,YAAY,GAAG,YAAY,EAC9C,IAAI,EAAE,MAAM,EACZ,QAAQ,CAAC,EAAE,iBAAiB,GAC3B,WAAW,CAAC,CAAC,CAAC;IAIjB;;;OAGG;IACH,YAAY,IAAI,cAAc;IAW9B;;;OAGG;IACG,eAAe,CAAC,CAAC,EACrB,EAAE,EAAE,CAAC,OAAO,EAAE,cAAc,KAAK,OAAO,CAAC,CAAC,CAAC,GAC1C,OAAO,CAAC,CAAC,CAAC;IAeb;;OAEG;IACH,eAAe,IAAI,MAAM,EAAE;IAI3B;;;OAGG;IACG,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;CAQrD"}

package/src/services/mongoose-database.js

@@ -0,0 +1,121 @@
+"use strict";
+/**
+ * @fileoverview Mongoose database adapter implementing IDatabase.
+ * Wraps a mongoose connection to conform to the shared IDatabase interface
+ * from brightchain-lib, enabling application code to work with mongoose
+ * through the unified database contract.
+ * @module services/mongoose-database
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongooseDatabase = void 0;
+const tslib_1 = require("tslib");
+const mongoose_types_1 = tslib_1.__importDefault(require("@digitaldefiance/mongoose-types"));
+const mongoose_collection_1 = require("./mongoose-collection");
+const mongoose_session_adapter_1 = require("./mongoose-session-adapter");
+/**
+ * Adapts a mongoose connection to the IDatabase interface.
+ * Allows existing mongoose-based applications to use the unified
+ * IDatabase contract from brightchain-lib.
+ */
+class MongooseDatabase {
+    _connection;
+    /**
+     * @param connection - Optional mongoose connection to wrap.
+     *   Defaults to the global mongoose.connection if not provided.
+     */
+    constructor(connection) {
+        this._connection = connection ?? mongoose_types_1.default.connection;
+    }
+    /**
+     * Get the underlying mongoose connection for direct access when needed.
+     */
+    get connection() {
+        return this._connection;
+    }
+    /**
+     * Connect to MongoDB via mongoose.
+     * If a URI is provided, establishes a new connection.
+     * If already connected, this is a no-op.
+     */
+    async connect(uri) {
+        if (uri) {
+            await mongoose_types_1.default.connect(uri);
+            this._connection = mongoose_types_1.default.connection;
+        }
+    }
+    /**
+     * Disconnect from MongoDB.
+     */
+    async disconnect() {
+        if (this._connection.readyState !== 0) {
+            await mongoose_types_1.default.disconnect();
+        }
+    }
+    /**
+     * Whether the mongoose connection is in the 'connected' state.
+     */
+    isConnected() {
+        return this._connection.readyState === 1;
+    }
+    /**
+     * Get or create a collection by name, returning an ICollection adapter.
+     */
+    collection(name, _options) {
+        return new mongoose_collection_1.MongooseCollection(this._connection, name);
+    }
+    /**
+     * Start a client session for transaction support.
+     * Wraps the mongoose session in an IClientSession adapter.
+     */
+    startSession() {
+        // mongoose.connection.startSession() is async, but IDatabase declares
+        // startSession() as synchronous. We create a deferred session adapter
+        // that initializes the native session lazily on first transaction use.
+        //
+        // For the synchronous contract, we use the underlying client directly.
+        const client = this._connection.getClient();
+        const nativeSession = client.startSession();
+        return new mongoose_session_adapter_1.MongooseSessionAdapter(nativeSession);
+    }
+    /**
+     * Execute a callback within a mongoose transaction with retry logic.
+     * Handles session lifecycle: start → transaction → commit/abort → end.
+     */
+    async withTransaction(fn) {
+        const adapter = this.startSession();
+        adapter.startTransaction();
+        try {
+            const result = await fn(adapter);
+            await adapter.commitTransaction();
+            return result;
+        }
+        catch (err) {
+            await adapter.abortTransaction();
+            throw err;
+        }
+        finally {
+            adapter.endSession();
+        }
+    }
+    /**
+     * List all collection names known to this connection.
+     */
+    listCollections() {
+        return Object.keys(this._connection.collections);
+    }
+    /**
+     * Drop a collection by name.
+     * @returns true if the collection was dropped, false if it didn't exist.
+     */
+    async dropCollection(name) {
+        try {
+            await this._connection.dropCollection(name);
+            return true;
+        }
+        catch {
+            return false;
+        }
+    }
+}
+exports.MongooseDatabase = MongooseDatabase;
+//# sourceMappingURL=mongoose-database.js.map

package/src/services/mongoose-database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-database.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/services/mongoose-database.ts"],"names":[],"mappings":";AAAA;;;;;;GAMG;;;;AASH,6FAAuD;AAEvD,+DAA2D;AAC3D,yEAAoE;AAEpE;;;;GAIG;AACH,MAAa,gBAAgB;IACnB,WAAW,CAAa;IAEhC;;;OAGG;IACH,YAAY,UAAuB;QACjC,IAAI,CAAC,WAAW,GAAG,UAAU,IAAI,wBAAQ,CAAC,UAAU,CAAC;IACvD,CAAC;IAED;;OAEG;IACH,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAC;IAC1B,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,OAAO,CAAC,GAAY;QACxB,IAAI,GAAG,EAAE,CAAC;YACR,MAAM,wBAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAC5B,IAAI,CAAC,WAAW,GAAG,wBAAQ,CAAC,UAAU,CAAC;QACzC,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,UAAU;QACd,IAAI,IAAI,CAAC,WAAW,CAAC,UAAU,KAAK,CAAC,EAAE,CAAC;YACtC,MAAM,wBAAQ,CAAC,UAAU,EAAE,CAAC;QAC9B,CAAC;IACH,CAAC;IAED;;OAEG;IACH,WAAW;QACT,OAAO,IAAI,CAAC,WAAW,CAAC,UAAU,KAAK,CAAC,CAAC;IAC3C,CAAC;IAED;;OAEG;IACH,UAAU,CACR,IAAY,EACZ,QAA4B;QAE5B,OAAO,IAAI,wCAAkB,CAAI,IAAI,CAAC,WAAW,EAAE,IAAI,CAAC,CAAC;IAC3D,CAAC;IAED;;;OAGG;IACH,YAAY;QACV,sEAAsE;QACtE,sEAAsE;QACtE,uEAAuE;QACvE,EAAE;QACF,uEAAuE;QACvE,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,CAAC,SAAS,EAAE,CAAC;QAC5C,MAAM,aAAa,GAAG,MAAM,CAAC,YAAY,EAAE,CAAC;QAC5C,OAAO,IAAI,iDAAsB,CAAC,aAAa,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CACnB,EAA2C;QAE3C,MAAM,OAAO,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QACpC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC3B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,CAAC;YACjC,MAAM,OAAO,CAAC,iBAAiB,EAAE,CAAC;YAClC,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,OAAO,CAAC,gBAAgB,EAAE,CAAC;YACjC,MAAM,GAAG,CAAC;QACZ,CAAC;gBAAS,CAAC;YACT,OAAO,CAAC,UAAU,EAAE,CAAC;QACvB,CAAC;IACH,CAAC;IAED;;OAEG;IACH,eAAe;QACb,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC;IACnD,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,cAAc,CAAC,IAAY;QAC/B,IAAI,CAAC;YACH,MAAM,IAAI,CAAC,WAAW,CAAC,cAAc,CAAC,IAAI,CAAC,CAAC;YAC5C,OAAO,IAAI,CAAC;QACd,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;CACF;AA/GD,4CA+GC"}

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

@@ -0,0 +1,109 @@
+/**
+ * @fileoverview Mongoose implementation of the IDocumentStore interface.
+ * Wraps existing mongoose logic previously embedded in BaseApplication.
+ * @module services/mongoose-document-store
+ */
+import mongoose, { Model } from '@digitaldefiance/mongoose-types';
+import { MongoMemoryReplSet } from 'mongodb-memory-server';
+import { IBaseDocument } from '../documents/base';
+import { Environment } from '../environment';
+import { IApplication } from '../interfaces/application';
+import { IConstants } from '../interfaces/constants';
+import { IDocumentStore } from '../interfaces/document-store';
+import { IFailableResult } from '../interfaces/failable-result';
+import { SchemaMap } from '../types';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { BaseApplication } from '../application-base';
+/**
+ * Mongoose implementation of IDocumentStore.
+ * Extracts and preserves the existing mongoose logic from BaseApplication.
+ * @template TID - Platform-specific ID type extending PlatformID
+ * @template TModelDocs - Record mapping model names to their document types
+ * @template TInitResults - Type of database initialization results
+ * @template TConstants - Application constants type
+ */
+export declare class MongooseDocumentStore<TID extends PlatformID, TModelDocs extends Record<string, IBaseDocument<any, TID>>, TInitResults, TConstants extends IConstants = IConstants> implements IDocumentStore<TID, TModelDocs> {
+    /**
+     * Mongoose database instance
+     */
+    private _db?;
+    /**
+     * Schema map for all models
+     */
+    private _schemaMap?;
+    /**
+     * In-memory MongoDB instance for development
+     */
+    private _devDatabase?;
+    /**
+     * Function to create the schema map given a Mongoose connection
+     */
+    private readonly _schemaMapFactory;
+    /**
+     * Function to initialize the database with default data
+     */
+    private readonly _databaseInitFunction;
+    /**
+     * Function to create a hash from the database initialization results (for logging purposes)
+     */
+    private readonly _initResultHashFunction;
+    /**
+     * Application environment
+     */
+    private readonly _environment;
+    /**
+     * Application constants
+     */
+    private readonly _constants;
+    constructor(schemaMapFactory: (connection: mongoose.Connection) => SchemaMap<TID, TModelDocs>, databaseInitFunction: (application: BaseApplication<TID, TModelDocs, TInitResults>) => Promise<IFailableResult<TInitResults>>, initResultHashFunction: (initResults: TInitResults) => string, environment: Environment<TID>, constants?: TConstants);
+    /**
+     * Get the underlying mongoose instance (for backward compatibility).
+     */
+    get db(): typeof mongoose;
+    /** @inheritdoc */
+    get schemaMap(): SchemaMap<TID, TModelDocs> | undefined;
+    /** @inheritdoc */
+    get devDatabase(): MongoMemoryReplSet | undefined;
+    /**
+     * Validate MongoDB URI to prevent SSRF attacks.
+     * Delegates to the standalone defaultMongoUriValidator for reuse
+     * across both IDatabase and IDocumentStore paths.
+     */
+    private validateMongoUri;
+    /**
+     * Connect to MongoDB and initialize schemas.
+     * Extracted from BaseApplication.connectDatabase.
+     * @inheritdoc
+     */
+    connect(uri?: string): Promise<void>;
+    /**
+     * Disconnect from database.
+     * Extracted from BaseApplication.disconnectDatabase.
+     * @inheritdoc
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Whether the store is currently connected and ready for operations.
+     * @inheritdoc
+     */
+    isConnected(): boolean;
+    /**
+     * Retrieve a model/collection handle by name.
+     * Delegates to ModelRegistry.
+     * @inheritdoc
+     */
+    getModel<T extends IBaseDocument<any, TID>>(modelName: string): Model<T>;
+    /**
+     * Set up an in-memory MongoDB instance for development.
+     * Extracted from BaseApplication.setupDevDatabase.
+     * @inheritdoc
+     */
+    setupDevStore(): Promise<string>;
+    /**
+     * Initialize the development database with default data.
+     * Extracted from BaseApplication.initializeDevDatabase.
+     * @inheritdoc
+     */
+    initializeDevStore<TResult = TInitResults>(app: IApplication<TID>): Promise<TResult>;
+}
+//# sourceMappingURL=mongoose-document-store.d.ts.map

package/src/services/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/services/mongoose-document-store.ts"],"names":[],"mappings":"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"}

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

@@ -0,0 +1,264 @@
+"use strict";
+/**
+ * @fileoverview Mongoose implementation of the IDocumentStore interface.
+ * Wraps existing mongoose logic previously embedded in BaseApplication.
+ * @module services/mongoose-document-store
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongooseDocumentStore = void 0;
+const tslib_1 = require("tslib");
+const mongoose_types_1 = tslib_1.__importDefault(require("@digitaldefiance/mongoose-types"));
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const mongodb_memory_server_1 = require("mongodb-memory-server");
+const model_registry_1 = require("../model-registry");
+const utils_1 = require("../utils");
+const default_mongo_uri_validator_1 = require("../utils/default-mongo-uri-validator");
+/**
+ * Mongoose implementation of IDocumentStore.
+ * Extracts and preserves the existing mongoose logic from BaseApplication.
+ * @template TID - Platform-specific ID type extending PlatformID
+ * @template TModelDocs - Record mapping model names to their document types
+ * @template TInitResults - Type of database initialization results
+ * @template TConstants - Application constants type
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+class MongooseDocumentStore {
+    /**
+     * Mongoose database instance
+     */
+    _db;
+    /**
+     * Schema map for all models
+     */
+    _schemaMap;
+    /**
+     * In-memory MongoDB instance for development
+     */
+    _devDatabase;
+    /**
+     * Function to create the schema map given a Mongoose connection
+     */
+    _schemaMapFactory;
+    /**
+     * Function to initialize the database with default data
+     */
+    _databaseInitFunction;
+    /**
+     * Function to create a hash from the database initialization results (for logging purposes)
+     */
+    _initResultHashFunction;
+    /**
+     * Application environment
+     */
+    _environment;
+    /**
+     * Application constants
+     */
+    _constants;
+    constructor(schemaMapFactory, databaseInitFunction, initResultHashFunction, environment, constants = suite_core_lib_1.Constants) {
+        this._schemaMapFactory = schemaMapFactory;
+        this._databaseInitFunction = databaseInitFunction;
+        this._initResultHashFunction = initResultHashFunction;
+        this._environment = environment;
+        this._constants = constants;
+    }
+    /**
+     * Get the underlying mongoose instance (for backward compatibility).
+     */
+    get db() {
+        if (!this._db) {
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_DatabaseNotConnectedYet);
+        }
+        return this._db;
+    }
+    /** @inheritdoc */
+    get schemaMap() {
+        return this._schemaMap;
+    }
+    /** @inheritdoc */
+    get devDatabase() {
+        return this._devDatabase;
+    }
+    /**
+     * Validate MongoDB URI to prevent SSRF attacks.
+     * Delegates to the standalone defaultMongoUriValidator for reuse
+     * across both IDatabase and IDocumentStore paths.
+     */
+    validateMongoUri(uri) {
+        (0, default_mongo_uri_validator_1.defaultMongoUriValidator)(uri, this._environment.production);
+    }
+    /**
+     * Connect to MongoDB and initialize schemas.
+     * Extracted from BaseApplication.connectDatabase.
+     * @inheritdoc
+     */
+    async connect(uri) {
+        const mongoUri = uri ?? this._environment.mongo.uri;
+        const debug = this._environment.debug;
+        this.validateMongoUri(mongoUri);
+        (0, utils_1.debugLog)(debug, 'log', `[ ${(0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_Connecting, undefined, undefined, { constants: this._constants })} ] ${(0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_MongoDB, undefined, undefined, { constants: this._constants })}: ${mongoUri}`);
+        // Always disconnect first to ensure clean state
+        if (mongoose_types_1.default.connection.readyState !== 0) {
+            await mongoose_types_1.default.disconnect();
+        }
+        // amazonq-ignore-next-line solved above with validateMongoUri call
+        await mongoose_types_1.default.connect(mongoUri, {
+            maxPoolSize: this._environment.mongo.maxPoolSize,
+            minPoolSize: this._environment.mongo.minPoolSize,
+            maxIdleTimeMS: this._environment.mongo.maxIdleTimeMS,
+            serverSelectionTimeoutMS: this._environment.mongo.serverSelectionTimeoutMS,
+            socketTimeoutMS: this._environment.mongo.socketTimeoutMS,
+            retryWrites: this._environment.mongo.retryWrites,
+            retryReads: this._environment.mongo.retryReads,
+            readConcern: this._environment.mongo.readConcern,
+            writeConcern: this._environment.mongo.writeConcern,
+        });
+        this._db = mongoose_types_1.default;
+        await new Promise((resolve) => {
+            if (mongoose_types_1.default.connection.readyState === 1) {
+                resolve();
+            }
+            else {
+                mongoose_types_1.default.connection.once('connected', resolve);
+            }
+        });
+        const engine = (0, suite_core_lib_1.getSuiteCoreI18nEngine)({ constants: this._constants });
+        (0, utils_1.debugLog)(debug, 'log', engine.t('[ {{SuiteCoreStringKey.Common_Connected}} ] {{SuiteCoreStringKey.Common_MongoDB}}'));
+        (0, utils_1.debugLog)(debug, 'log', engine.t('[ {{SuiteCoreStringKey.Common_Loading}} ] {{SuiteCoreStringKey.Common_Schemas}}'));
+        this._schemaMap = this._schemaMapFactory(this.db.connection);
+        // Register all base models in ModelRegistry for extensibility
+        if (this._schemaMap) {
+            Object.values(this._schemaMap).forEach((schema) => {
+                model_registry_1.ModelRegistry.instance.register({
+                    modelName: schema.modelName,
+                    schema: schema.schema,
+                    model: schema.model,
+                    collection: schema.collection,
+                    discriminators: schema.discriminators,
+                });
+            });
+        }
+        if (debug) {
+            Object.values(this._schemaMap).forEach((schema) => {
+                console.log(engine.t(`[ {{SuiteCoreStringKey.Common_Loaded}} ] {{SuiteCoreStringKey.Common_Schema}} '${schema.modelName.replace(/[\r\n]/g, '')}'`));
+            });
+        }
+        if (!this._db.connection.db) {
+            console.error(engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_FailedToSetTransactionTimeout));
+        }
+        else {
+            const command = {
+                ...(this._environment.mongo.setParameterSupported
+                    ? { setParameter: 1 }
+                    : {}),
+                ...(this._environment.mongo.useTransactions &&
+                    this._environment.mongo.transactionLifetimeLimitSecondsSupported
+                    ? {
+                        transactionLifetimeLimitSeconds: this._environment.mongo.transactionTimeout,
+                    }
+                    : {}),
+                ...(this._environment.mongo.useTransactions &&
+                    this._environment.mongo.maxTransactionLockRequestTimeoutMillisSupported
+                    ? {
+                        maxTransactionLockRequestTimeoutMillis: this._environment.mongo.transactionLockRequestTimeout,
+                    }
+                    : {}),
+            };
+            if (Object.keys(command).length > 0) {
+                await this._db.connection.db
+                    .admin()
+                    .command(command)
+                    .catch(() => undefined);
+            }
+            (0, utils_1.debugLog)(debug, 'log', engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Admin_SetTransactionTimeoutSuccessfully));
+        }
+    }
+    /**
+     * Disconnect from database.
+     * Extracted from BaseApplication.disconnectDatabase.
+     * @inheritdoc
+     */
+    async disconnect() {
+        const debug = this._environment.debug;
+        if (this._db && mongoose_types_1.default.connection.readyState !== 0) {
+            await this._db.disconnect();
+        }
+        const engine = (0, suite_core_lib_1.getSuiteCoreI18nEngine)({ constants: this._constants });
+        this._db = undefined;
+        (0, utils_1.debugLog)(debug, 'log', `[ ${engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Common_Disconnected)} ] ${engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Common_MongoDB)}`);
+    }
+    /**
+     * Whether the store is currently connected and ready for operations.
+     * @inheritdoc
+     */
+    isConnected() {
+        return mongoose_types_1.default.connection.readyState === 1;
+    }
+    /**
+     * Retrieve a model/collection handle by name.
+     * Delegates to ModelRegistry.
+     * @inheritdoc
+     */
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    getModel(modelName) {
+        return model_registry_1.ModelRegistry.instance.get(modelName).model;
+    }
+    /**
+     * Set up an in-memory MongoDB instance for development.
+     * Extracted from BaseApplication.setupDevDatabase.
+     * @inheritdoc
+     */
+    async setupDevStore() {
+        this._devDatabase = await mongodb_memory_server_1.MongoMemoryReplSet.create({
+            replSet: { count: 1, storageEngine: 'wiredTiger' },
+        });
+        await this._devDatabase.waitUntilRunning();
+        const mongoUri = this._devDatabase.getUri(this._environment.devDatabase) +
+            '&maxPoolSize=20&minPoolSize=4';
+        this._environment.setEnvironment('mongo.uri', mongoUri);
+        (0, utils_1.debugLog)(this._environment.debug, 'log', `MongoDB Memory Server with transactions: ${mongoUri}`);
+        return mongoUri;
+    }
+    /**
+     * Initialize the development database with default data.
+     * Extracted from BaseApplication.initializeDevDatabase.
+     * @inheritdoc
+     */
+    async initializeDevStore(app) {
+        const engine = (0, suite_core_lib_1.getSuiteCoreI18nEngine)({ constants: this._constants });
+        (0, utils_1.debugLog)(this._environment.debug, 'log', `${engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Admin_StartingDatabaseInitialization)}: ${engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Admin_TransactionsEnabledDisabledTemplate, {
+            STATE: this._environment.mongo.useTransactions
+                ? engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Common_Enabled)
+                : engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Common_Disabled),
+        })}`);
+        let initTimeout;
+        const initTimeoutMs = 300000;
+        const accountDataResult = await Promise.race([
+            this._databaseInitFunction(app),
+            new Promise((_, reject) => {
+                initTimeout = setTimeout(() => {
+                    const logMsg = engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_FailedToInitializeUserDatabaseTimeoutTemplate, { timeMs: initTimeoutMs.toString() });
+                    console.error(logMsg);
+                    reject(new Error(logMsg));
+                }, initTimeoutMs);
+            }),
+        ]);
+        if (initTimeout)
+            clearTimeout(initTimeout);
+        if (accountDataResult.success && accountDataResult.data) {
+            if (this._environment.detailedDebug) {
+                const initHash = this._initResultHashFunction(accountDataResult.data);
+                (0, utils_1.debugLog)(true, 'log', engine.translateStringKey(suite_core_lib_1.SuiteCoreStringKey.Admin_DatabaseInitializedWithOptionsHashTemplate, { hash: initHash }));
+            }
+            return accountDataResult.data;
+        }
+        else {
+            if (this._environment.detailedDebug && accountDataResult.error) {
+                (0, utils_1.debugLog)(true, 'log', accountDataResult.error);
+            }
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Admin_Error_FailedToInitializeUserDatabase);
+        }
+    }
+}
+exports.MongooseDocumentStore = MongooseDocumentStore;
+//# sourceMappingURL=mongoose-document-store.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-document-store.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/services/mongoose-document-store.ts"],"names":[],"mappings":"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"}

package/src/services/mongoose-session-adapter.d.ts

@@ -0,0 +1,39 @@
+/**
+ * @fileoverview Mongoose session adapter implementing IClientSession.
+ * Wraps a mongodb ClientSession to conform to the shared IClientSession interface
+ * from brightchain-lib.
+ * @module services/mongoose-session-adapter
+ */
+import type { IClientSession } from '@brightchain/brightchain-lib';
+import type { ClientSession } from 'mongodb';
+/**
+ * Adapts a mongodb ClientSession to the IClientSession interface.
+ * This allows mongoose-based transaction code to work through the
+ * shared interface contract.
+ */
+export declare class MongooseSessionAdapter implements IClientSession {
+    private readonly _session;
+    constructor(session: ClientSession);
+    /**
+     * Unique session ID as a string.
+     * Falls back to 'unknown' if the session has no server session yet.
+     */
+    get id(): string;
+    /**
+     * Whether a transaction is currently active on this session.
+     */
+    get inTransaction(): boolean;
+    /**
+     * Get the underlying mongodb ClientSession for passing to mongoose operations.
+     */
+    get nativeSession(): ClientSession;
+    /** Start a new transaction on this session. */
+    startTransaction(): void;
+    /** Commit the current transaction. */
+    commitTransaction(): Promise<void>;
+    /** Abort the current transaction. */
+    abortTransaction(): Promise<void>;
+    /** End this session, releasing server resources. */
+    endSession(): void;
+}
+//# sourceMappingURL=mongoose-session-adapter.d.ts.map

package/src/services/mongoose-session-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongoose-session-adapter.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/services/mongoose-session-adapter.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAE7C;;;;GAIG;AACH,qBAAa,sBAAuB,YAAW,cAAc;IAC3D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAgB;gBAE7B,OAAO,EAAE,aAAa;IAIlC;;;OAGG;IACH,IAAI,EAAE,IAAI,MAAM,CAMf;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,OAAO,CAE3B;IAED;;OAEG;IACH,IAAI,aAAa,IAAI,aAAa,CAEjC;IAED,+CAA+C;IAC/C,gBAAgB,IAAI,IAAI;IAIxB,sCAAsC;IAChC,iBAAiB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIxC,qCAAqC;IAC/B,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAIvC,oDAAoD;IACpD,UAAU,IAAI,IAAI;CAKnB"}