@digitaldefiance/node-express-suite-mongo 4.23.0

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

@@ -0,0 +1,131 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.setupTestEnvironment = setupTestEnvironment;
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const services_1 = require("../../services");
+const mongo_database_plugin_1 = require("../../plugins/mongo-database-plugin");
+async function setupTestEnvironment(constants, apiRouterFactory, schemaMapFactory, appRouterFactory = (apiRouter) => new node_express_suite_1.AppRouter(apiRouter), customInitMiddleware = node_express_suite_1.initMiddleware, envLocation, databaseInitFunction, initResultHashFunction, cspConfig = {
+    corsWhitelist: [],
+    csp: {
+        defaultSrc: [],
+        imgSrc: [],
+        connectSrc: [],
+        scriptSrc: [],
+        styleSrc: [],
+        fontSrc: [],
+        frameSrc: [],
+    },
+}) {
+    // Make runtime deterministic for tests
+    process.env.NODE_ENV = 'test';
+    process.env['DEV_DATABASE'] = 'test';
+    // Increase libuv threadpool for concurrent pbkdf2 work
+    if (!process.env['UV_THREADPOOL_SIZE']) {
+        process.env['UV_THREADPOOL_SIZE'] = '16';
+    }
+    // Optimize MongoDB settings for test performance while maintaining reliability
+    if (!process.env['MONGO_MAX_POOL_SIZE']) {
+        process.env['MONGO_MAX_POOL_SIZE'] = '5';
+    }
+    if (!process.env['MONGO_MIN_POOL_SIZE']) {
+        process.env['MONGO_MIN_POOL_SIZE'] = '2';
+    }
+    if (!process.env['MONGO_SERVER_SELECTION_TIMEOUT_MS']) {
+        process.env['MONGO_SERVER_SELECTION_TIMEOUT_MS'] = '5000';
+    }
+    if (!process.env['MONGO_SOCKET_TIMEOUT_MS']) {
+        process.env['MONGO_SOCKET_TIMEOUT_MS'] = '15000';
+    }
+    if (!process.env['MONGO_TRANSACTION_TIMEOUT']) {
+        process.env['MONGO_TRANSACTION_TIMEOUT'] = '15000';
+    }
+    if (!process.env['MONGO_TRANSACTION_LOCK_REQUEST_TIMEOUT']) {
+        process.env['MONGO_TRANSACTION_LOCK_REQUEST_TIMEOUT'] = '8000';
+    }
+    if (!process.env['MONGO_TRANSACTION_RETRY_BASE_DELAY']) {
+        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';
+    }
+    // Ensure language is set to English for consistent test behavior
+    process.env.LANGUAGE = 'English (US)';
+    // Use a random high port to avoid conflicts
+    process.env['PORT'] = String(Math.floor(Math.random() * 10000) + 50000);
+    // Use unique database name for each test to avoid conflicts
+    const uniqueDbName = `test_${Date.now()}_${Math.floor(Math.random() * 10000)}`;
+    process.env['DEV_DATABASE'] = uniqueDbName;
+    // Reset global language context to English
+    const setAdminLanguage = (language) => {
+        const context = i18n_lib_1.GlobalActiveContext.getInstance();
+        context.setAdminLanguage(language);
+    };
+    setAdminLanguage('en-US');
+    const env = new node_express_suite_1.Environment(envLocation, true);
+    // Create the Application with MongoDatabasePlugin
+    const application = new node_express_suite_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();
+        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) {
+        console.error('Failed to start application with MongoDB URI:', application.environment.mongo.uri);
+        console.error('Connection error:', error);
+        throw error;
+    }
+    // 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: application,
+        mongoServer: mongoPlugin.devDatabase,
+        mongoUri: application.environment.mongo
+            .uri,
+        accountData,
+        dbName: application.environment.devDatabase,
+    };
+}
+//# sourceMappingURL=setup-test-env.js.map

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

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

package/src/__tests__/index.d.ts

@@ -0,0 +1,3 @@
+export * from './fixtures';
+export * from './helpers';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/index.ts"],"names":[],"mappings":"AAAA,cAAc,YAAY,CAAC;AAC3B,cAAc,WAAW,CAAC"}

package/src/__tests__/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./fixtures"), exports);
+tslib_1.__exportStar(require("./helpers"), exports);
+//# sourceMappingURL=index.js.map

package/src/__tests__/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/__tests__/index.ts"],"names":[],"mappings":";;;AAAA,qDAA2B;AAC3B,oDAA0B"}

package/src/builders/application-builder.d.ts

@@ -0,0 +1,38 @@
+/**
+ * @fileoverview Application builder for fluent application construction.
+ * Provides builder pattern for creating Application instances with MongoDatabasePlugin.
+ * @module builders/application-builder
+ */
+import mongoose from '@digitaldefiance/mongoose-types';
+import { IFailableResult } from '@digitaldefiance/suite-core-lib';
+import { HelmetOptions } from 'helmet';
+import { Application, Environment, IApplication, ICSPConfig, IConstants, IFlexibleCSP, initMiddleware, AppRouter, BaseRouter } from '@digitaldefiance/node-express-suite';
+import { BaseDocument } from '../documents';
+import { IMongoApplication } from '../interfaces/mongo-application';
+import { IServerInitResult } from '../interfaces/server-init-result';
+import { SchemaMap } from '../types';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+/**
+ * Builder for constructing Application instances with MongoDatabasePlugin using a fluent API.
+ */
+export declare class ApplicationBuilder<TID extends PlatformID, TModelDocs extends Record<string, BaseDocument<never, TID>>, TInitResults extends IServerInitResult<TID>, TConstants extends IConstants = IConstants> {
+    private environment?;
+    private apiRouterFactory?;
+    private appRouterFactory?;
+    private schemaMapFactory?;
+    private databaseInitFunction?;
+    private initResultHashFunction?;
+    private cspConfig?;
+    private constants?;
+    private customInitMiddleware?;
+    withEnvironment(env: Environment<TID>): this;
+    withApiRouter(factory: (app: IApplication<TID>) => BaseRouter<TID>): this;
+    withAppRouter(factory: (apiRouter: BaseRouter<TID>) => AppRouter<TID>): this;
+    withSchemaMap(factory: (connection: mongoose.Connection) => SchemaMap<TID, TModelDocs>): this;
+    withDatabaseInit(initFn: (app: IMongoApplication<TID>) => Promise<IFailableResult<TInitResults>>, hashFn: (results: TInitResults) => string): this;
+    withCSP(config: ICSPConfig | HelmetOptions | IFlexibleCSP): this;
+    withConstants(constants: TConstants): this;
+    withMiddleware(middleware: typeof initMiddleware): this;
+    build(): Application<TID, Environment<TID>, TConstants, AppRouter<TID>>;
+}
+//# sourceMappingURL=application-builder.d.ts.map

package/src/builders/application-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/builders/application-builder.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,QAAQ,MAAM,iCAAiC,CAAC;AACvD,OAAO,EACL,eAAe,EAGhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,QAAQ,CAAC;AACvC,OAAO,EACL,WAAW,EACX,WAAW,EACX,YAAY,EACZ,UAAU,EACV,UAAU,EACV,YAAY,EACZ,cAAc,EACd,SAAS,EACT,UAAU,EACX,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAErE,OAAO,EAAE,SAAS,EAAE,MAAM,UAAU,CAAC;AACrC,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAElE;;GAEG;AACH,qBAAa,kBAAkB,CAC7B,GAAG,SAAS,UAAU,EACtB,UAAU,SAAS,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,EAC3D,YAAY,SAAS,iBAAiB,CAAC,GAAG,CAAC,EAC3C,UAAU,SAAS,UAAU,GAAG,UAAU;IAE1C,OAAO,CAAC,WAAW,CAAC,CAAmB;IACvC,OAAO,CAAC,gBAAgB,CAAC,CAA8C;IACvE,OAAO,CAAC,gBAAgB,CAAC,CAAiD;IAC1E,OAAO,CAAC,gBAAgB,CAAC,CAEO;IAChC,OAAO,CAAC,oBAAoB,CAAC,CAEe;IAC5C,OAAO,CAAC,sBAAsB,CAAC,CAAoC;IACnE,OAAO,CAAC,SAAS,CAAC,CAA4C;IAC9D,OAAO,CAAC,SAAS,CAAC,CAAa;IAC/B,OAAO,CAAC,oBAAoB,CAAC,CAAwB;IAErD,eAAe,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,GAAG,IAAI;IAK5C,aAAa,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,YAAY,CAAC,GAAG,CAAC,KAAK,UAAU,CAAC,GAAG,CAAC,GAAG,IAAI;IAKzE,aAAa,CAAC,OAAO,EAAE,CAAC,SAAS,EAAE,UAAU,CAAC,GAAG,CAAC,KAAK,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI;IAK5E,aAAa,CACX,OAAO,EAAE,CAAC,UAAU,EAAE,QAAQ,CAAC,UAAU,KAAK,SAAS,CAAC,GAAG,EAAE,UAAU,CAAC,GACvE,IAAI;IAKP,gBAAgB,CACd,MAAM,EAAE,CACN,GAAG,EAAE,iBAAiB,CAAC,GAAG,CAAC,KACxB,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,CAAC,EAC3C,MAAM,EAAE,CAAC,OAAO,EAAE,YAAY,KAAK,MAAM,GACxC,IAAI;IAMP,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,aAAa,GAAG,YAAY,GAAG,IAAI;IAKhE,aAAa,CAAC,SAAS,EAAE,UAAU,GAAG,IAAI;IAK1C,cAAc,CAAC,UAAU,EAAE,OAAO,cAAc,GAAG,IAAI;IAKvD,KAAK,IAAI,WAAW,CAAC,GAAG,EAAE,WAAW,CAAC,GAAG,CAAC,EAAE,UAAU,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC;CAqDxE"}

package/src/builders/application-builder.js

@@ -0,0 +1,82 @@
+"use strict";
+/**
+ * @fileoverview Application builder for fluent application construction.
+ * Provides builder pattern for creating Application instances with MongoDatabasePlugin.
+ * @module builders/application-builder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApplicationBuilder = void 0;
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const mongo_database_plugin_1 = require("../plugins/mongo-database-plugin");
+/**
+ * Builder for constructing Application instances with MongoDatabasePlugin using a fluent API.
+ */
+class ApplicationBuilder {
+    environment;
+    apiRouterFactory;
+    appRouterFactory;
+    schemaMapFactory;
+    databaseInitFunction;
+    initResultHashFunction;
+    cspConfig;
+    constants;
+    customInitMiddleware;
+    withEnvironment(env) {
+        this.environment = env;
+        return this;
+    }
+    withApiRouter(factory) {
+        this.apiRouterFactory = factory;
+        return this;
+    }
+    withAppRouter(factory) {
+        this.appRouterFactory = factory;
+        return this;
+    }
+    withSchemaMap(factory) {
+        this.schemaMapFactory = factory;
+        return this;
+    }
+    withDatabaseInit(initFn, hashFn) {
+        this.databaseInitFunction = initFn;
+        this.initResultHashFunction = hashFn;
+        return this;
+    }
+    withCSP(config) {
+        this.cspConfig = config;
+        return this;
+    }
+    withConstants(constants) {
+        this.constants = constants;
+        return this;
+    }
+    withMiddleware(middleware) {
+        this.customInitMiddleware = middleware;
+        return this;
+    }
+    build() {
+        if (!this.environment)
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_EnvironmentIsRequired);
+        if (!this.apiRouterFactory)
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_ApiRouterFactoryIsRequired);
+        if (!this.schemaMapFactory)
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_SchemaMapFactoryIsRequired);
+        if (!this.databaseInitFunction)
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_DatabaseInitFunctionIsRequired);
+        if (!this.initResultHashFunction)
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_InitResultHashFunctionIsRequired);
+        const app = new node_express_suite_1.Application(this.environment, this.apiRouterFactory, this.cspConfig, this.constants, this.appRouterFactory, this.customInitMiddleware);
+        const mongoPlugin = new mongo_database_plugin_1.MongoDatabasePlugin({
+            schemaMapFactory: this.schemaMapFactory,
+            databaseInitFunction: this.databaseInitFunction,
+            initResultHashFunction: this.initResultHashFunction,
+            environment: this.environment,
+            constants: this.constants,
+        });
+        app.useDatabasePlugin(mongoPlugin);
+        return app;
+    }
+}
+exports.ApplicationBuilder = ApplicationBuilder;
+//# sourceMappingURL=application-builder.js.map

package/src/builders/application-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"application-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/builders/application-builder.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,oEAIyC;AAEzC,4EAU6C;AAI7C,4EAAuE;AAIvE;;GAEG;AACH,MAAa,kBAAkB;IAMrB,WAAW,CAAoB;IAC/B,gBAAgB,CAA+C;IAC/D,gBAAgB,CAAkD;IAClE,gBAAgB,CAEQ;IACxB,oBAAoB,CAEgB;IACpC,sBAAsB,CAAqC;IAC3D,SAAS,CAA6C;IACtD,SAAS,CAAc;IACvB,oBAAoB,CAAyB;IAErD,eAAe,CAAC,GAAqB;QACnC,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC;QACvB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,OAAoD;QAChE,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,OAAuD;QACnE,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CACX,OAAwE;QAExE,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB,CACd,MAE2C,EAC3C,MAAyC;QAEzC,IAAI,CAAC,oBAAoB,GAAG,MAAM,CAAC;QACnC,IAAI,CAAC,sBAAsB,GAAG,MAAM,CAAC;QACrC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,CAAC,MAAiD;QACvD,IAAI,CAAC,SAAS,GAAG,MAAM,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,SAAqB;QACjC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,cAAc,CAAC,UAAiC;QAC9C,IAAI,CAAC,oBAAoB,GAAG,UAAU,CAAC;QACvC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,IAAI,CAAC,IAAI,CAAC,WAAW;YACnB,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,2BAA2B,CAC/C,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,gBAAgB;YACxB,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,gCAAgC,CACpD,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,gBAAgB;YACxB,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,gCAAgC,CACpD,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,oBAAoB;YAC5B,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,oCAAoC,CACxD,CAAC;QACJ,IAAI,CAAC,IAAI,CAAC,sBAAsB;YAC9B,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,sCAAsC,CAC1D,CAAC;QAEJ,MAAM,GAAG,GAAG,IAAI,gCAAW,CAMzB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,oBAAoB,CAC1B,CAAC;QAEF,MAAM,WAAW,GAAG,IAAI,2CAAmB,CAKzC;YACA,gBAAgB,EAAE,IAAI,CAAC,gBAAgB;YACvC,oBAAoB,EAAE,IAAI,CAAC,oBAAoB;YAC/C,sBAAsB,EAAE,IAAI,CAAC,sBAAsB;YACnD,WAAW,EAAE,IAAI,CAAC,WAAW;YAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;SAC1B,CAAC,CAAC;QAEH,GAAG,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;QAEnC,OAAO,GAAG,CAAC;IACb,CAAC;CACF;AAzHD,gDAyHC"}

package/src/builders/index.d.ts

@@ -0,0 +1,2 @@
+export * from './application-builder';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/builders/index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC"}

package/src/builders/index.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./application-builder"), exports);
+//# sourceMappingURL=index.js.map

package/src/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/builders/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC"}

package/src/controllers/index.d.ts

@@ -0,0 +1,3 @@
+export * from './mongo-base';
+export * from './user';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,cAAc,CAAC;AAC7B,cAAc,QAAQ,CAAC"}

package/src/controllers/index.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./mongo-base"), exports);
+tslib_1.__exportStar(require("./user"), exports);
+//# sourceMappingURL=index.js.map

package/src/controllers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/controllers/index.ts"],"names":[],"mappings":";;;AAAA,uDAA6B;AAC7B,iDAAuB"}

package/src/controllers/mongo-base.d.ts

@@ -0,0 +1,55 @@
+/**
+ * @fileoverview Mongo-specific base controller extending the database-agnostic BaseController.
+ * Restores Mongoose-specific functionality: isMongoApplication(), mongoApplication,
+ * transactionManager, validateAndFetchRequestUser(), and Mongoose-specific withTransaction().
+ * @module controllers/mongo-base
+ */
+import { ClientSession } from '@digitaldefiance/mongoose-types';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+import type { Request } from 'express';
+import { BaseController, type ApiResponse, type TransactionCallback } from '@digitaldefiance/node-express-suite';
+import type { IApplication } from '@digitaldefiance/node-express-suite';
+import type { IMongoApplication } from '../interfaces/mongo-application';
+import type { UserDocument } from '../documents/user';
+import { TransactionManager } from '../transactions';
+import { type MongoTransactionOptions } from '../utils/mongo-transaction';
+/**
+ * Abstract Mongo-specific base controller.
+ * Extends the database-agnostic BaseController with Mongoose transaction management,
+ * Mongo application type guards, and user validation via Mongoose models.
+ *
+ * @template T API response type
+ * @template THandler Handler object type
+ * @template TLanguage Language code type
+ * @template TID Platform ID type
+ * @template TApplication Application interface type
+ */
+export declare abstract class MongoBaseController<T extends ApiResponse, THandler extends object, TLanguage extends string, TID extends PlatformID = Buffer, TApplication extends IApplication<TID> = IApplication<TID>> extends BaseController<T, THandler, TLanguage, TID, TApplication> {
+    protected transactionManager: TransactionManager | undefined;
+    constructor(application: TApplication);
+    /**
+     * Type guard: does the application expose a Mongoose connection?
+     * Uses try/catch to safely handle cases where the db getter throws
+     * (e.g. when no MongoDatabasePlugin is registered).
+     */
+    protected isMongoApplication(): boolean;
+    /**
+     * Returns the application typed as IMongoApplication, or undefined if not Mongo-backed.
+     */
+    protected get mongoApplication(): IMongoApplication<TID> | undefined;
+    /**
+     * Validates the request has a user and fetches the full UserDocument from Mongoose.
+     * @param req The Express request object
+     * @returns The UserDocument for the authenticated user
+     * @throws Error if the application is not Mongo-backed
+     * @throws HandleableError if no user is on the request
+     * @throws UserNotFoundError if the user is not found in the database
+     */
+    protected validateAndFetchRequestUser(req: Request): Promise<UserDocument<TLanguage, TID>>;
+    /**
+     * Wraps a callback in a Mongoose transaction with full retry/timeout support.
+     * Falls back to IDatabase.withTransaction or direct execution when Mongoose is unavailable.
+     */
+    withTransaction<TResult>(callback: TransactionCallback<TResult>, session?: ClientSession, options?: MongoTransactionOptions<TID>, ...args: any): Promise<TResult>;
+}
+//# sourceMappingURL=mongo-base.d.ts.map

package/src/controllers/mongo-base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mongo-base.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/controllers/mongo-base.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAOlE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AACvC,OAAO,EACL,cAAc,EACd,KAAK,WAAW,EAChB,KAAK,mBAAmB,EACzB,MAAM,qCAAqC,CAAC;AAC7C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,qCAAqC,CAAC;AACxE,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACzE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAGtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAEL,KAAK,uBAAuB,EAC7B,MAAM,4BAA4B,CAAC;AAEpC;;;;;;;;;;GAUG;AACH,8BAAsB,mBAAmB,CACvC,CAAC,SAAS,WAAW,EACrB,QAAQ,SAAS,MAAM,EACvB,SAAS,SAAS,MAAM,EACxB,GAAG,SAAS,UAAU,GAAG,MAAM,EAC/B,YAAY,SAAS,YAAY,CAAC,GAAG,CAAC,GAAG,YAAY,CAAC,GAAG,CAAC,CAC1D,SAAQ,cAAc,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,EAAE,YAAY,CAAC;IACjE,SAAS,CAAC,kBAAkB,EAAE,kBAAkB,GAAG,SAAS,CAAC;gBAE1C,WAAW,EAAE,YAAY;IAY5C;;;;OAIG;IACH,SAAS,CAAC,kBAAkB,IAAI,OAAO;IAWvC;;OAEG;IACH,SAAS,KAAK,gBAAgB,IAAI,iBAAiB,CAAC,GAAG,CAAC,GAAG,SAAS,CAKnE;IAED;;;;;;;OAOG;cACa,2BAA2B,CACzC,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,YAAY,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;IAgCxC;;;OAGG;IACU,eAAe,CAAC,OAAO,EAClC,QAAQ,EAAE,mBAAmB,CAAC,OAAO,CAAC,EACtC,OAAO,CAAC,EAAE,aAAa,EACvB,OAAO,CAAC,EAAE,uBAAuB,CAAC,GAAG,CAAC,EACtC,GAAG,IAAI,EAAE,GAAG;CA0Bf"}

package/src/controllers/mongo-base.js

@@ -0,0 +1,108 @@
+"use strict";
+/**
+ * @fileoverview Mongo-specific base controller extending the database-agnostic BaseController.
+ * Restores Mongoose-specific functionality: isMongoApplication(), mongoApplication,
+ * transactionManager, validateAndFetchRequestUser(), and Mongoose-specific withTransaction().
+ * @module controllers/mongo-base
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MongoBaseController = void 0;
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const base_model_name_1 = require("../enumerations/base-model-name");
+const model_registry_1 = require("../model-registry");
+const transactions_1 = require("../transactions");
+const mongo_transaction_1 = require("../utils/mongo-transaction");
+/**
+ * Abstract Mongo-specific base controller.
+ * Extends the database-agnostic BaseController with Mongoose transaction management,
+ * Mongo application type guards, and user validation via Mongoose models.
+ *
+ * @template T API response type
+ * @template THandler Handler object type
+ * @template TLanguage Language code type
+ * @template TID Platform ID type
+ * @template TApplication Application interface type
+ */
+class MongoBaseController extends node_express_suite_1.BaseController {
+    transactionManager;
+    constructor(application) {
+        super(application);
+        // Only create TransactionManager when the app has a Mongoose connection
+        const mongoApp = this.mongoApplication;
+        if (mongoApp) {
+            this.transactionManager = new transactions_1.TransactionManager(mongoApp.db.connection, mongoApp.environment.mongo.useTransactions);
+        }
+    }
+    /**
+     * Type guard: does the application expose a Mongoose connection?
+     * Uses try/catch to safely handle cases where the db getter throws
+     * (e.g. when no MongoDatabasePlugin is registered).
+     */
+    isMongoApplication() {
+        try {
+            return ('db' in this.application &&
+                this.application.db !== undefined);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Returns the application typed as IMongoApplication, or undefined if not Mongo-backed.
+     */
+    get mongoApplication() {
+        if (this.isMongoApplication()) {
+            return this.application;
+        }
+        return undefined;
+    }
+    /**
+     * Validates the request has a user and fetches the full UserDocument from Mongoose.
+     * @param req The Express request object
+     * @returns The UserDocument for the authenticated user
+     * @throws Error if the application is not Mongo-backed
+     * @throws HandleableError if no user is on the request
+     * @throws UserNotFoundError if the user is not found in the database
+     */
+    async validateAndFetchRequestUser(req) {
+        if (!this.isMongoApplication()) {
+            throw new Error('validateAndFetchRequestUser requires a Mongo-backed application. ' +
+                'Override this method for non-Mongo storage backends.');
+        }
+        const UserModel = model_registry_1.ModelRegistry.instance.getTypedModel(base_model_name_1.BaseModelName.User);
+        if (!req.user) {
+            throw new i18n_lib_1.HandleableError(new Error((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_Unauthorized, undefined, undefined, { constants: this.application.constants })), {
+                statusCode: 401,
+            });
+        }
+        const user = await UserModel.findById(req.user.id);
+        if (!user) {
+            throw new suite_core_lib_1.UserNotFoundError();
+        }
+        return user;
+    }
+    /**
+     * Wraps a callback in a Mongoose transaction with full retry/timeout support.
+     * Falls back to IDatabase.withTransaction or direct execution when Mongoose is unavailable.
+     */
+    async withTransaction(callback, session, options, ...args) {
+        // Mongoose path — full retry/timeout support
+        if (this.isMongoApplication()) {
+            const mongoApp = this.mongoApplication;
+            return await (0, mongo_transaction_1.withMongoTransaction)(mongoApp.db.connection, mongoApp.environment.mongo.useTransactions, session, callback, { application: this.application, ...options }, ...args);
+        }
+        // IDatabase path — delegate to IDatabase.withTransaction
+        const db = this.application.database;
+        if (db) {
+            return await db.withTransaction(async () => {
+                return await callback(session, ...args);
+            });
+        }
+        // No database — run callback directly without transaction
+        return await callback(session, ...args);
+    }
+}
+exports.MongoBaseController = MongoBaseController;
+//# sourceMappingURL=mongo-base.js.map

package/src/controllers/mongo-base.js.map

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

package/src/controllers/user.d.ts

@@ -0,0 +1,61 @@
+/**
+ * @fileoverview User controller handling authentication, registration, and user management endpoints.
+ * Provides comprehensive user operations including login, password management, and settings.
+ * @module controllers/user
+ */
+import { CoreLanguageCode } from '@digitaldefiance/i18n-lib';
+import { Member as BackendMember, ECIESService, PlatformID } from '@digitaldefiance/node-ecies-lib';
+import { ITokenRole, ITokenUser, IUserBase } from '@digitaldefiance/suite-core-lib';
+import type { NextFunction, Request, Response } from 'express';
+import { DecoratorBaseController, Environment, IApiChallengeResponse, IApiCodeCountResponse, IApiLoginResponse, IApiMessageResponse, IApiMnemonicResponse, IApiRegistrationResponse, IApiRequestUserResponse, IApiUserSettingsResponse, IApiBackupCodesResponse, IConstants, IStatusCodeResponse } from '@digitaldefiance/node-express-suite';
+import type { ApiErrorResponse } from '@digitaldefiance/node-express-suite';
+import { JwtService } from '../services/jwt';
+import { BaseDocument } from '../documents';
+import { UserDocument } from '../documents/user';
+import type { IMongoApplication } from '../interfaces/mongo-application';
+import { BackupCodeService } from '../services/backup-code';
+import { RoleService } from '../services/role';
+import { UserService } from '../services/user';
+/**
+ * User controller handling all user-related API endpoints.
+ * Manages authentication, registration, password operations, settings, and backup codes.
+ * @template TID Platform ID type
+ * @template TDate Date type
+ * @template TLanguage Site language string type
+ * @template TAccountStatus Account status string type
+ * @template TUser User base type
+ * @template TTokenRole Token role type
+ * @template TTokenUser Token user type
+ * @template TApplication Application type
+ */
+export declare class UserController<TID extends PlatformID = Buffer, TDate extends Date = Date, TLanguage extends CoreLanguageCode = CoreLanguageCode, TAccountStatus extends string = string, TUser extends IUserBase<TID, TDate, TLanguage, TAccountStatus> = IUserBase<TID, TDate, TLanguage, TAccountStatus>, TTokenRole extends ITokenRole<TID, TDate> = ITokenRole<TID, TDate>, TTokenUser extends ITokenUser = ITokenUser, TApplication extends IMongoApplication<TID> = IMongoApplication<TID>> extends DecoratorBaseController<TLanguage, TID, TApplication> {
+    protected readonly userService: UserService<UserDocument, TID, TDate, TLanguage, TAccountStatus, Environment<TID>, IConstants, BaseDocument<UserDocument, TID>, TUser, TTokenRole, TApplication>;
+    protected readonly jwtService: JwtService<TID, TDate, TTokenRole, TTokenUser, TApplication>;
+    protected readonly backupCodeService: BackupCodeService<TID, TDate, TTokenRole, TApplication>;
+    protected readonly roleService: RoleService<TID, TDate, TTokenRole>;
+    protected readonly eciesService: ECIESService<TID>;
+    protected readonly systemUser: BackendMember<TID>;
+    constructor(application: TApplication, jwtService: JwtService<TID, TDate, TTokenRole, TTokenUser, TApplication>, userService: UserService<any, TID, TDate, TLanguage, TAccountStatus, any, any, any, TUser, TTokenRole, TApplication>, backupCodeService: BackupCodeService<TID, TDate, TTokenRole, TApplication>, roleService: RoleService<TID, TDate, TTokenRole>, eciesService: ECIESService<TID>);
+    tokenVerifiedResponse(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiRequestUserResponse | ApiErrorResponse>>;
+    refreshToken(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiLoginResponse | ApiErrorResponse>>;
+    register(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiRegistrationResponse | ApiErrorResponse>>;
+    completeAccountVerification(_req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMessageResponse | ApiErrorResponse>>;
+    setLanguage(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiRequestUserResponse | ApiErrorResponse>>;
+    setDarkMode(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiRequestUserResponse | ApiErrorResponse>>;
+    getSettings(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiUserSettingsResponse | ApiErrorResponse>>;
+    updateSettings(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiRequestUserResponse | ApiErrorResponse>>;
+    getBackupCodeCount(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiCodeCountResponse | ApiErrorResponse>>;
+    resetBackupCodes(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiBackupCodesResponse | ApiErrorResponse>>;
+    recoverMnemonic(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMnemonicResponse | ApiErrorResponse>>;
+    changePassword(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMessageResponse | ApiErrorResponse>>;
+    requestDirectLogin(_req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiChallengeResponse | ApiErrorResponse>>;
+    directLoginChallenge(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiLoginResponse | ApiErrorResponse>>;
+    requestEmailLogin(_req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMessageResponse | ApiErrorResponse>>;
+    emailLoginChallenge(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiLoginResponse | ApiErrorResponse>>;
+    resendVerification(_req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMessageResponse | ApiErrorResponse>>;
+    useBackupCodeLogin(_req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiLoginResponse | ApiErrorResponse>>;
+    forgotPassword(_req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMessageResponse | ApiErrorResponse>>;
+    verifyResetToken(req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMessageResponse | ApiErrorResponse>>;
+    resetPassword(_req: Request, _res: Response, _next: NextFunction): Promise<IStatusCodeResponse<IApiMessageResponse | ApiErrorResponse>>;
+}
+//# sourceMappingURL=user.d.ts.map

package/src/controllers/user.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite-mongo/src/controllers/user.ts"],"names":[],"mappings":"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"}