@digitaldefiance/node-express-suite 1.0.23 → 1.0.24

package/src/controllers/base.js

@@ -0,0 +1,272 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseController = void 0;
+/// <reference path="../types.d.ts" />
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const express_1 = require("express");
+const express_validator_1 = require("express-validator");
+const base_model_name_1 = require("../enumerations/base-model-name");
+const express_validation_1 = require("../errors/express-validation");
+const missing_validated_data_1 = require("../errors/missing-validated-data");
+const authenticate_crypto_1 = require("../middlewares/authenticate-crypto");
+const authenticate_token_1 = require("../middlewares/authenticate-token");
+const set_global_context_language_1 = require("../middlewares/set-global-context-language");
+const model_registry_1 = require("../model-registry");
+const utils_1 = require("../utils");
+class BaseController {
+    router;
+    activeRequest = null;
+    activeResponse = null;
+    application;
+    routeDefinitions = [];
+    pluginEngine = i18n_lib_1.PluginI18nEngine.getInstance();
+    handlers;
+    // Allowlist of registered validation functions to prevent code injection
+    static validationRegistry = new WeakSet();
+    constructor(application) {
+        this.application = application;
+        this.router = (0, express_1.Router)();
+        this.handlers = {};
+        this.initRouteDefinitions();
+        this.registerValidationFunctions();
+        this.initializeRoutes();
+    }
+    /**
+     * Register validation functions in the allowlist.
+     * Override this method to register custom validation functions.
+     */
+    registerValidationFunctions() {
+        // Register validation functions from route definitions
+        this.routeDefinitions.forEach(route => {
+            if (typeof route.validation === 'function') {
+                BaseController.validationRegistry.add(route.validation);
+            }
+        });
+    }
+    getAuthenticationMiddleware(route) {
+        if (route.useAuthentication) {
+            return [
+                async (req, res, next) => {
+                    try {
+                        await this.authenticateRequest(route, req, res, next);
+                    }
+                    catch (err) {
+                        next(err);
+                    }
+                },
+            ];
+        }
+        else {
+            return [];
+        }
+    }
+    getCryptoAuthenticationMiddleware(route) {
+        if (route.useCryptoAuthentication) {
+            return [
+                async (req, res, next) => {
+                    try {
+                        await (0, authenticate_crypto_1.authenticateCrypto)(this.application, req, res, next);
+                    }
+                    catch (err) {
+                        next(err);
+                    }
+                },
+            ];
+        }
+        else {
+            return [];
+        }
+    }
+    getValidationMiddleware(route) {
+        if (Array.isArray(route.validation) && route.validation.length > 0) {
+            return [
+                ...route.validation,
+                this.createValidationHandler(route.validation),
+            ];
+        }
+        else if (typeof route.validation === 'function') {
+            return [this.createDynamicValidationHandler(route.validation)];
+        }
+        return [];
+    }
+    createValidationHandler(validation) {
+        return (req, res, next) => {
+            try {
+                this.checkRequestValidationAndThrow(req, res, next, validation);
+            }
+            catch (error) {
+                next(error);
+            }
+        };
+    }
+    createDynamicValidationHandler(validationFn) {
+        // Verify the validation function is in the allowlist
+        if (!BaseController.validationRegistry.has(validationFn)) {
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_ValidationFunctionNotRegisteredInAllowlist);
+        }
+        return async (req, res, next) => {
+            try {
+                const validationArray = validationFn(i18n_lib_1.GlobalActiveContext.getInstance().userLanguage);
+                // amazonq-ignore-next-line fixed above
+                await Promise.all(validationArray.map((v) => v.run(req)));
+                await this.checkRequestValidationAndThrow(req, res, next, validationArray);
+            }
+            catch (error) {
+                next(error);
+            }
+        };
+    }
+    createRequestHandler(config) {
+        return async (req, res, next) => {
+            this.activeRequest = req;
+            this.activeResponse = res;
+            if (config.useAuthentication && !this.activeRequest?.user) {
+                (0, utils_1.handleError)(new i18n_lib_1.HandleableError(new Error((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_Unauthorized)), {
+                    statusCode: 401,
+                }), res, utils_1.sendApiMessageResponse, next);
+                return;
+            }
+            try {
+                const handler = this.handlers[config.handlerKey];
+                const sendFunc = config.rawJsonHandler
+                    ? utils_1.sendRawJsonResponse.bind(this)
+                    : utils_1.sendApiMessageResponse.bind(this);
+                const handlerArgs = config.handlerArgs ?? [];
+                const { statusCode, response, headers } = await handler(req, ...handlerArgs);
+                if (headers) {
+                    res.set(headers);
+                }
+                sendFunc(statusCode, response, res);
+            }
+            catch (error) {
+                (0, utils_1.handleError)(error, res, utils_1.sendApiMessageResponse, next);
+            }
+        };
+    }
+    /**
+     * Initializes the routes for the controller.
+     */
+    initializeRoutes() {
+        Object.values(this.routeDefinitions).forEach((config) => {
+            this.router[config.method](config.path, ...[
+                ...this.getAuthenticationMiddleware(config),
+                set_global_context_language_1.setGlobalContextLanguageFromRequest,
+                ...this.getValidationMiddleware(config),
+                ...this.getCryptoAuthenticationMiddleware(config),
+                ...(config.middleware ?? []),
+                this.createRequestHandler(config),
+            ]);
+        });
+    }
+    /**
+     * Authenticates the request by checking the token. Also populates the request with the user object.
+     * @param route The route config
+     * @param req The request object
+     * @param res The response object
+     * @param next The next function
+     */
+    async authenticateRequest(route, req, res, next) {
+        // Pass the real `next` function directly to the middleware.
+        // It will now correctly control the request lifecycle.
+        await (0, authenticate_token_1.authenticateToken)(this.application, req, res, next);
+    }
+    handleBooleanFields(validationArray, validatedBody) {
+        // false booleans will be missing from validatedBody, so we need to add them
+        validationArray.forEach((validation) => {
+            const fieldChains = validation.builder.build().fields;
+            fieldChains.forEach((field) => {
+                const hasBooleanValidator = validation.builder
+                    .build()
+                    .stack.some((item) => {
+                    return (item.validator &&
+                        typeof item.validator === 'function' &&
+                        item.validator.name === 'isBoolean' &&
+                        !item.negated);
+                });
+                // If the field has a boolean validator and it's not in the validated body, add it
+                if (hasBooleanValidator && !(field in validatedBody)) {
+                    validatedBody[field] = false;
+                }
+            });
+        });
+        return validatedBody;
+    }
+    /**
+     * If express-validator flagged any errors, throw an error.
+     * @param req The request object
+     * @param res The response object
+     * @param next The next function
+     * @param validationArray An array of express validation chains that were applied to the request.
+     * @returns
+     */
+    checkRequestValidationAndThrow(req, res, next, validationArray = []) {
+        const errors = (0, express_validator_1.validationResult)(req);
+        if (!errors.isEmpty()) {
+            throw new express_validation_1.ExpressValidationError(errors);
+        }
+        // Create an object with only the validated fields
+        const validatedBody = (0, express_validator_1.matchedData)(req, {
+            locations: ['body'], // Only match data from request body
+            includeOptionals: false, // Exclude fields that weren't validated
+        });
+        const language = i18n_lib_1.GlobalActiveContext.getInstance()
+            .userLanguage ?? suite_core_lib_1.DefaultLanguageCode;
+        // If validationArray is a function, call it with the language
+        const valArray = typeof validationArray === 'function'
+            ? validationArray(language)
+            : validationArray;
+        // false booleans will be missing from validatedBody, so we need to add them
+        // Attach the validated fields to the request object
+        req.validatedBody = this.handleBooleanFields(valArray, validatedBody);
+        next();
+    }
+    get user() {
+        if (!this.activeRequest) {
+            throw new i18n_lib_1.PluginTranslatableGenericError(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_NoActiveRequest);
+        }
+        if (!this.activeRequest.user) {
+            throw new i18n_lib_1.PluginTranslatableGenericError(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_NoUserOnRequest);
+        }
+        return this.activeRequest.user;
+    }
+    get validatedBody() {
+        if (!this.activeRequest) {
+            throw new i18n_lib_1.PluginTranslatableGenericError(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_NoActiveRequest);
+        }
+        if (!this.activeRequest.validatedBody) {
+            throw new missing_validated_data_1.MissingValidatedDataError();
+        }
+        return this.activeRequest.validatedBody;
+    }
+    get req() {
+        if (!this.activeRequest) {
+            throw new i18n_lib_1.PluginTranslatableGenericError(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_NoActiveRequest);
+        }
+        return this.activeRequest;
+    }
+    get res() {
+        if (!this.activeResponse) {
+            throw new i18n_lib_1.PluginTranslatableGenericError(suite_core_lib_1.SuiteCoreComponentId, suite_core_lib_1.SuiteCoreStringKey.Common_NoActiveResponse);
+        }
+        return this.activeResponse;
+    }
+    async validateAndFetchRequestUser(req) {
+        const UserModel = model_registry_1.ModelRegistry.instance.get(base_model_name_1.BaseModelName.User).model;
+        if (!req.user) {
+            throw new i18n_lib_1.HandleableError(new Error((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_Unauthorized)), {
+                statusCode: 401,
+            });
+        }
+        const user = await UserModel.findById(req.user.id);
+        if (!user) {
+            throw new suite_core_lib_1.UserNotFoundError();
+        }
+        return user;
+    }
+    async withTransaction(callback, session, options, ...args) {
+        return await (0, utils_1.withTransaction)(this.application.db.connection, this.application.environment.mongo.useTransactions, session, callback, options, ...args);
+    }
+}
+exports.BaseController = BaseController;
+//# sourceMappingURL=base.js.map

package/src/controllers/base.js.map

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

package/src/controllers/{index.ts → index.d.ts}

@@ -1,2 +1,3 @@
 export * from './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/src/controllers/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC;AACvB,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("./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/src/controllers/index.ts"],"names":[],"mappings":";;;AAAA,iDAAuB;AACvB,iDAAuB"}

package/src/controllers/user.d.ts

@@ -0,0 +1,45 @@
+import { CoreLanguageCode } from '@digitaldefiance/i18n-lib';
+import { Member as BackendMember, ECIESService } from '@digitaldefiance/node-ecies-lib';
+import { ITokenRole, ITokenUser, IUserBase } from '@digitaldefiance/suite-core-lib';
+import type { NextFunction, Request, Response } from 'express';
+import { Types } from 'mongoose';
+import { DecoratorBaseController } from '../decorators/base-controller';
+import { IBaseDocument } from '../documents';
+import { Environment } from '../environment';
+import { IApiChallengeResponse, IApiCodeCountResponse, IApiLoginResponse, IApiMessageResponse, IApiMnemonicResponse, IApiRegistrationResponse, IApiRequestUserResponse, IConstants } from '../interfaces';
+import { IApiBackupCodesResponse } from '../interfaces/api-responses/backup-codes-response';
+import type { IApplication } from '../interfaces/application';
+import { IStatusCodeResponse } from '../interfaces/status-code-response';
+import { BackupCodeService } from '../services/backup-code';
+import { JwtService } from '../services/jwt';
+import { RoleService } from '../services/role';
+import { UserService } from '../services/user';
+import { ApiErrorResponse } from '../types';
+export declare class UserController<I extends Types.ObjectId | string = Types.ObjectId, D extends Date = Date, S extends string = string, A extends string = string, TUser extends IUserBase<I, D, S, A> = IUserBase<I, D, S, A>, TTokenRole extends ITokenRole<I, D> = ITokenRole<I, D>, TTokenUser extends ITokenUser = ITokenUser, TApplication extends IApplication<any, Types.ObjectId, IBaseDocument<any, Types.ObjectId>, Environment, IConstants> = IApplication<any, Types.ObjectId, IBaseDocument<any, Types.ObjectId>, Environment, IConstants>, TLanguage extends CoreLanguageCode = CoreLanguageCode> extends DecoratorBaseController<TLanguage> {
+    protected readonly userService: UserService<any, I, D, S, A, any, any, any, TUser, TTokenRole, TApplication>;
+    protected readonly jwtService: JwtService<I, D, TTokenRole, TTokenUser, TApplication>;
+    protected readonly backupCodeService: BackupCodeService<I, D, TTokenRole, TApplication>;
+    protected readonly roleService: RoleService<I, D, TTokenRole>;
+    protected readonly eciesService: ECIESService;
+    protected readonly systemUser: BackendMember;
+    constructor(application: IApplication<any, Types.ObjectId, IBaseDocument<any, Types.ObjectId>, Environment, IConstants>, jwtService: JwtService<I, D, TTokenRole, TTokenUser, TApplication>, userService: UserService<any, I, D, S, A, any, any, any, TUser, TTokenRole, TApplication>, backupCodeService: BackupCodeService<I, D, TTokenRole, TApplication>, roleService: RoleService<I, D, TTokenRole>, eciesService: ECIESService);
+    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>>;
+    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/src/controllers/user.ts"],"names":[],"mappings":"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"}