@brightchain/brightchain-api-lib 0.0.1

package/src/lib/blocks/handle.js

@@ -0,0 +1,221 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createBlockHandle = createBlockHandle;
+exports.createBlockHandleFromPath = createBlockHandleFromPath;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const brightchain_lib_1 = require("@brightchain/brightchain-lib");
+const node_ecies_lib_1 = require("@digitaldefiance/node-ecies-lib");
+const fs_1 = require("fs");
+const stream_1 = require("stream");
+/**
+ * This function creates a "block handle" for a block of type T which extends BaseBlock.
+ * It makes the returned object equivalent to the underlying block type T but replacing
+ * the get data() method with an on-demand load of the block data from the block store
+ * and adding other functions for block handle operations.
+ *
+ * So for createBlockHandle<EphemeralBlock>(...) this function shall return an EphemeralBlock
+ * but with the overriden get data() method to load the block data from the file system
+ * on demand along with other added functions.
+ *
+ * @param blockConstructor - The constructor for the block type T
+ * @param path - The path to the block file
+ * @param blockSize - The block size
+ * @param checksum - The checksum of the block
+ * @param canRead - Whether the block can be read
+ * @param canPersist - Whether the block can be persisted
+ * @param constructorArgs - Additional arguments to pass to the block constructor
+ * @returns A block handle for the specified block type
+ */
+function createBlockHandle(blockConstructor, path, blockSize, checksum, canRead = true, canPersist = true, ...constructorArgs) {
+    if (!(0, fs_1.existsSync)(path)) {
+        throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockFileNotFound, path);
+    }
+    // Create the file stats once to avoid repeated file system calls
+    const stats = (0, fs_1.statSync)(path);
+    // Create a basic instance of T
+    // This uses a temporary empty buffer since we'll load data on demand
+    // Use a date slightly in the past to avoid timing issues with validation
+    const creationDate = new Date(Math.min(stats.birthtime.getTime(), Date.now() - 1000));
+    const instance = new blockConstructor(blockSize, Buffer.alloc(0), creationDate, checksum, brightchain_lib_1.BlockType.Handle, // Override blockType to indicate it's a handle
+    brightchain_lib_1.BlockDataType.RawData, canRead, canPersist, ...constructorArgs);
+    // Add handle-specific properties
+    instance._path = path;
+    instance._cachedData = null;
+    // Override and add methods
+    // Override get data()
+    Object.defineProperty(instance, 'data', {
+        get: function () {
+            if (!this.canRead) {
+                throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockIsNotReadable);
+            }
+            if (!this._cachedData) {
+                if (!(0, fs_1.existsSync)(this._path)) {
+                    throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockFileNotFound, this._path);
+                }
+                this._cachedData = (0, fs_1.readFileSync)(this._path);
+            }
+            return this._cachedData;
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Add path getter
+    Object.defineProperty(instance, 'path', {
+        get: function () {
+            return this._path;
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Add setPath method
+    instance.setPath = function (path) {
+        this._path = path;
+    };
+    // Add fullData getter
+    Object.defineProperty(instance, 'fullData', {
+        get: function () {
+            return this.data;
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Override get layerPayload()
+    Object.defineProperty(instance, 'layerPayload', {
+        get: function () {
+            return this.fullData;
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Add layerData getter
+    Object.defineProperty(instance, 'layerData', {
+        get: function () {
+            return this.fullData;
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Add layerPayloadSize getter
+    Object.defineProperty(instance, 'layerPayloadSize', {
+        get: function () {
+            return this.fullData.length;
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Override metadata getter
+    Object.defineProperty(instance, 'metadata', {
+        get: function () {
+            if (!(0, fs_1.existsSync)(this._path)) {
+                throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockFileNotFound, this._path);
+            }
+            const stats = (0, fs_1.statSync)(this._path);
+            return new brightchain_lib_1.BlockMetadata(this.blockSize, brightchain_lib_1.BlockType.Handle, brightchain_lib_1.BlockDataType.RawData, stats.size, new Date(stats.birthtime));
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Add getReadStream method
+    instance.getReadStream = function () {
+        if (!this.canRead) {
+            throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockIsNotReadable);
+        }
+        if (!(0, fs_1.existsSync)(this._path)) {
+            throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockFileNotFound, this._path);
+        }
+        return (0, fs_1.createReadStream)(this._path);
+    };
+    // Add getWriteStream method
+    instance.getWriteStream = function (overwrite = false) {
+        if (!this.canPersist) {
+            throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockIsNotPersistable);
+        }
+        if ((0, fs_1.existsSync)(this._path) && !overwrite) {
+            throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockAlreadyExists);
+        }
+        return (0, fs_1.createWriteStream)(this._path);
+    };
+    // Add calculateChecksum method
+    instance.calculateChecksum = async function () {
+        return new Promise((resolve, reject) => {
+            const readStream = this.getReadStream();
+            const checksumTransform = new node_ecies_lib_1.ChecksumTransform();
+            readStream.pipe(checksumTransform);
+            checksumTransform.on('checksum', (checksum) => {
+                readStream.destroy();
+                resolve(brightchain_lib_1.Checksum.fromUint8Array(checksum));
+            });
+            readStream.on('error', (error) => {
+                checksumTransform.destroy();
+                reject(error);
+            });
+            checksumTransform.on('error', (error) => {
+                readStream.destroy();
+                reject(error);
+            });
+            // Ensure cleanup on completion
+            checksumTransform.on('end', () => {
+                readStream.destroy();
+            });
+        });
+    };
+    // Add calculateChecksumSync method
+    instance.calculateChecksumSync = function () {
+        if (!(0, fs_1.existsSync)(this._path)) {
+            throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockFileNotFound, this._path);
+        }
+        const data = (0, fs_1.readFileSync)(this._path);
+        return brightchain_lib_1.ServiceProvider.getInstance().checksumService.calculateChecksum(data);
+    };
+    // Override validateAsync method
+    instance.validateAsync = async function () {
+        const checksum = await this.calculateChecksum();
+        if (!checksum.equals(this.idChecksum)) {
+            throw new brightchain_lib_1.ChecksumMismatchError(this.idChecksum, checksum);
+        }
+    };
+    // Override validateSync method
+    instance.validateSync = function () {
+        const checksum = this.calculateChecksumSync();
+        if (!checksum.equals(this.idChecksum)) {
+            throw new brightchain_lib_1.ChecksumMismatchError(this.idChecksum, checksum);
+        }
+    };
+    // Override validate method
+    instance.validate = function () {
+        this.validateSync();
+    };
+    // Add clearCache method
+    instance.clearCache = function () {
+        this._cachedData = null;
+    };
+    // Add block getter
+    Object.defineProperty(instance, 'block', {
+        get: function () {
+            const newBlock = new brightchain_lib_1.RawDataBlock(this.blockSize, this.fullData, this.dateCreated, this.idChecksum, this.blockType, this.blockDataType, this.canRead, this.canPersist);
+            newBlock.validateSync();
+            return newBlock;
+        },
+        enumerable: true,
+        configurable: true,
+    });
+    // Return the augmented instance
+    return instance;
+}
+/**
+ * Create a new block handle from a file path
+ */
+async function createBlockHandleFromPath(blockConstructor, path, blockSize, checksum, canRead = true, canPersist = true, ...constructorArgs) {
+    if (!(0, fs_1.existsSync)(path)) {
+        throw new brightchain_lib_1.BlockAccessError(brightchain_lib_1.BlockAccessErrorType.BlockFileNotFound, path);
+    }
+    // If no checksum provided, calculate it
+    if (!checksum) {
+        const nodeStream = (0, fs_1.createReadStream)(path);
+        const webStream = stream_1.Readable.toWeb(nodeStream);
+        checksum =
+            await brightchain_lib_1.ServiceProvider.getInstance().checksumService.calculateChecksumForStream(webStream);
+    }
+    return createBlockHandle(blockConstructor, path, blockSize, checksum, canRead, canPersist, ...constructorArgs);
+}
+//# sourceMappingURL=handle.js.map

package/src/lib/blocks/handle.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handle.js","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/blocks/handle.ts"],"names":[],"mappings":"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"}

package/src/lib/constants.d.ts

@@ -0,0 +1,50 @@
+/**
+ * BrightChain API Constants Module
+ *
+ * This module extends base constants from @digitaldefiance/node-express-suite
+ * using createExpressConstants() and adds API-specific constants.
+ *
+ * Base constants (from @digitaldefiance/node-express-suite):
+ * - PBKDF2: Password-based key derivation configuration
+ * - CHECKSUM: SHA3 checksum configuration
+ * - FEC: Forward error correction settings
+ * - KEYRING: Keyring algorithm configuration
+ * - ENCRYPTION: Encryption settings
+ * - Express Configuration: Express app settings, CORS, CSP, etc.
+ * - JWT: Base JWT configuration
+ * - Session: Session management settings
+ *
+ * API-specific constants:
+ * - WRAPPED_KEY: Wrapped key operations
+ *
+ * @see {@link https://github.com/Digital-Defiance/node-express-suite} for base constants
+ * @module constants
+ */
+import { IApiConstants } from './interfaces/api-constants';
+/**
+ * API-specific constants for wrapped key operations
+ * These constants define the cryptographic parameters for wrapping and unwrapping keys
+ */
+export declare const WRAPPED_KEY: {
+    readonly SALT_SIZE: 32;
+    readonly IV_SIZE: 16;
+    readonly MASTER_KEY_SIZE: 32;
+    readonly MIN_ITERATIONS: 100000;
+};
+/**
+ * API Constants extending from @digitaldefiance/node-express-suite
+ *
+ * Uses createExpressConstants() to generate base constants for Express applications,
+ * then adds API-specific constants (WRAPPED_KEY).
+ *
+ * Includes all base constants:
+ * - PBKDF2, CHECKSUM, FEC, KEYRING, ENCRYPTION (cryptographic)
+ * - CORS, CSP, JWT, Session (Express/API)
+ *
+ * Plus API-specific constants:
+ * - WRAPPED_KEY (key wrapping operations)
+ *
+ * @see {@link https://github.com/Digital-Defiance/node-express-suite} for base constants
+ */
+export declare const Constants: IApiConstants;
+//# sourceMappingURL=constants.d.ts.map

package/src/lib/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/constants.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAGH,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAE3D;;;GAGG;AACH,eAAO,MAAM,WAAW;;;;;CAKd,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,SAAS,EAAE,aAKvB,CAAC"}

package/src/lib/constants.js

@@ -0,0 +1,58 @@
+"use strict";
+/**
+ * BrightChain API Constants Module
+ *
+ * This module extends base constants from @digitaldefiance/node-express-suite
+ * using createExpressConstants() and adds API-specific constants.
+ *
+ * Base constants (from @digitaldefiance/node-express-suite):
+ * - PBKDF2: Password-based key derivation configuration
+ * - CHECKSUM: SHA3 checksum configuration
+ * - FEC: Forward error correction settings
+ * - KEYRING: Keyring algorithm configuration
+ * - ENCRYPTION: Encryption settings
+ * - Express Configuration: Express app settings, CORS, CSP, etc.
+ * - JWT: Base JWT configuration
+ * - Session: Session management settings
+ *
+ * API-specific constants:
+ * - WRAPPED_KEY: Wrapped key operations
+ *
+ * @see {@link https://github.com/Digital-Defiance/node-express-suite} for base constants
+ * @module constants
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Constants = exports.WRAPPED_KEY = void 0;
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+/**
+ * API-specific constants for wrapped key operations
+ * These constants define the cryptographic parameters for wrapping and unwrapping keys
+ */
+exports.WRAPPED_KEY = {
+    SALT_SIZE: 32,
+    IV_SIZE: 16,
+    MASTER_KEY_SIZE: 32,
+    MIN_ITERATIONS: 100000,
+};
+/**
+ * API Constants extending from @digitaldefiance/node-express-suite
+ *
+ * Uses createExpressConstants() to generate base constants for Express applications,
+ * then adds API-specific constants (WRAPPED_KEY).
+ *
+ * Includes all base constants:
+ * - PBKDF2, CHECKSUM, FEC, KEYRING, ENCRYPTION (cryptographic)
+ * - CORS, CSP, JWT, Session (Express/API)
+ *
+ * Plus API-specific constants:
+ * - WRAPPED_KEY (key wrapping operations)
+ *
+ * @see {@link https://github.com/Digital-Defiance/node-express-suite} for base constants
+ */
+exports.Constants = {
+    ...(0, node_express_suite_1.createExpressConstants)('brightchain.io', 'brightchain.io', {
+        Site: 'BrightChain',
+    }),
+    WRAPPED_KEY: exports.WRAPPED_KEY,
+};
+//# sourceMappingURL=constants.js.map

package/src/lib/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../brightchain-api-lib/src/lib/constants.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;;;AAEH,4EAA6E;AAG7E;;;GAGG;AACU,QAAA,WAAW,GAAG;IACzB,SAAS,EAAE,EAAW;IACtB,OAAO,EAAE,EAAW;IACpB,eAAe,EAAE,EAAW;IAC5B,cAAc,EAAE,MAAe;CACvB,CAAC;AAEX;;;;;;;;;;;;;;GAcG;AACU,QAAA,SAAS,GAAkB;IACtC,GAAG,IAAA,2CAAsB,EAAC,gBAAgB,EAAE,gBAAgB,EAAE;QAC5D,IAAI,EAAE,aAAa;KACpB,CAAC;IACF,WAAW,EAAX,mBAAW;CACZ,CAAC"}

package/src/lib/controllers/base.d.ts

@@ -0,0 +1,50 @@
+import { ApiResponse, FlexibleValidationChain, RouteConfig } from '@digitaldefiance/node-express-suite';
+import { IRequestUserDTO } from '@digitaldefiance/suite-core-lib';
+import { NextFunction, Request, Response, Router } from 'express';
+import { IUserDocument } from '../documents/user';
+import { IApplication } from '../interfaces/application';
+import { StringLanguage } from '../interfaces/request-user';
+export declare abstract class BaseController<T extends ApiResponse, H extends object> {
+    readonly router: Router;
+    private activeRequest;
+    private activeResponse;
+    readonly application: IApplication;
+    protected routeDefinitions: RouteConfig<H, StringLanguage>[];
+    protected handlers: H;
+    constructor(application: IApplication);
+    protected abstract initRouteDefinitions(): void;
+    private getAuthenticationMiddleware;
+    private getCryptoAuthenticationMiddleware;
+    private getValidationMiddleware;
+    private createValidationHandler;
+    private createDynamicValidationHandler;
+    private createRequestHandler;
+    /**
+     * Initializes the routes for the controller.
+     */
+    private initializeRoutes;
+    /**
+     * 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
+     */
+    protected authenticateRequest(route: RouteConfig<H, StringLanguage>, req: Request, res: Response<T>, next: NextFunction): Promise<void>;
+    private handleBooleanFields;
+    /**
+     * 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
+     */
+    protected checkRequestValidationAndThrow(req: Request, res: Response, next: NextFunction, validationArray?: FlexibleValidationChain<StringLanguage>): void;
+    get user(): IRequestUserDTO;
+    get validatedBody(): Record<string, any>;
+    get req(): Request;
+    get res(): Response;
+    protected validateAndFetchRequestUser(req: Request): Promise<IUserDocument>;
+}
+//# sourceMappingURL=base.d.ts.map

package/src/lib/controllers/base.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.d.ts","sourceRoot":"","sources":["../../../../../brightchain-api-lib/src/lib/controllers/base.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,WAAW,EAGX,uBAAuB,EAEvB,WAAW,EAKZ,MAAM,qCAAqC,CAAC;AAC7C,OAAO,EACL,eAAe,EAGhB,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,YAAY,EACZ,OAAO,EAEP,QAAQ,EACR,MAAM,EACP,MAAM,SAAS,CAAC;AAMjB,OAAO,EAAE,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGlD,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAE5D,8BAAsB,cAAc,CAAC,CAAC,SAAS,WAAW,EAAE,CAAC,SAAS,MAAM;IAC1E,SAAgB,MAAM,EAAE,MAAM,CAAC;IAC/B,OAAO,CAAC,aAAa,CAAwB;IAC7C,OAAO,CAAC,cAAc,CAAyB;IAC/C,SAAgB,WAAW,EAAE,YAAY,CAAC;IAC1C,SAAS,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,EAAE,CAAM;IAClE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;gBAEH,WAAW,EAAE,YAAY;IAQ5C,SAAS,CAAC,QAAQ,CAAC,oBAAoB,IAAI,IAAI;IAE/C,OAAO,CAAC,2BAA2B;IAkBnC,OAAO,CAAC,iCAAiC;IAuBzC,OAAO,CAAC,uBAAuB;IAc/B,OAAO,CAAC,uBAAuB;IAY/B,OAAO,CAAC,8BAA8B;IAqBtC,OAAO,CAAC,oBAAoB;IA2C5B;;OAEG;IACH,OAAO,CAAC,gBAAgB;IAkBxB;;;;;;OAMG;cACa,mBAAmB,CACjC,KAAK,EAAE,WAAW,CAAC,CAAC,EAAE,cAAc,CAAC,EACrC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,CAAC,CAAC,CAAC,EAChB,IAAI,EAAE,YAAY,GACjB,OAAO,CAAC,IAAI,CAAC;IAMhB,OAAO,CAAC,mBAAmB;IA6B3B;;;;;;;OAOG;IACH,SAAS,CAAC,8BAA8B,CACtC,GAAG,EAAE,OAAO,EACZ,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE,YAAY,EAClB,eAAe,GAAE,uBAAuB,CAAC,cAAc,CAAM,GAC5D,IAAI;IA2BP,IAAW,IAAI,IAAI,eAAe,CAQjC;IAED,IAAW,aAAa,IAAI,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAQ9C;IAED,IAAW,GAAG,IAAI,OAAO,CAKxB;IAED,IAAW,GAAG,IAAI,QAAQ,CAKzB;cAEe,2BAA2B,CACzC,GAAG,EAAE,OAAO,GACX,OAAO,CAAC,aAAa,CAAC;CAW1B"}

package/src/lib/controllers/base.js

@@ -0,0 +1,235 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BaseController = void 0;
+/* eslint-disable @typescript-eslint/no-explicit-any */
+const i18n_lib_1 = require("@digitaldefiance/i18n-lib");
+const node_express_suite_1 = require("@digitaldefiance/node-express-suite");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const express_1 = require("express");
+const express_validator_1 = require("express-validator");
+const express_validation_1 = require("../errors/express-validation");
+const missing_validated_data_1 = require("../errors/missing-validated-data");
+class BaseController {
+    constructor(application) {
+        this.activeRequest = null;
+        this.activeResponse = null;
+        this.routeDefinitions = [];
+        this.application = application;
+        this.router = (0, express_1.Router)();
+        this.handlers = {};
+        this.initRouteDefinitions();
+        this.initializeRoutes();
+    }
+    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, node_express_suite_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) {
+        return async (req, res, next) => {
+            try {
+                const validationArray = validationFn(i18n_lib_1.GlobalActiveContext.instance.userLanguage);
+                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, node_express_suite_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, node_express_suite_1.sendApiMessageResponse, next);
+                return;
+            }
+            try {
+                const handler = this.handlers[config.handlerKey];
+                const sendFunc = config.rawJsonHandler
+                    ? node_express_suite_1.sendRawJsonResponse.bind(this)
+                    : node_express_suite_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, node_express_suite_1.handleError)(error, res, node_express_suite_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),
+                node_express_suite_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, node_express_suite_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.instance.userLanguage ??
+            i18n_lib_1.LanguageCodes.EN_US);
+        // 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 Error((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_NoActiveRequest));
+        }
+        if (!this.activeRequest.user) {
+            throw new Error((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_NoUserOnRequest));
+        }
+        return this.activeRequest.user;
+    }
+    get validatedBody() {
+        if (!this.activeRequest) {
+            throw new Error((0, suite_core_lib_1.getSuiteCoreTranslation)(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 Error((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_NoActiveRequest));
+        }
+        return this.activeRequest;
+    }
+    get res() {
+        if (!this.activeResponse) {
+            throw new Error((0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Common_NoActiveResponse));
+        }
+        return this.activeResponse;
+    }
+    async validateAndFetchRequestUser(req) {
+        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,
+            });
+        }
+        throw new Error('Not implemented');
+    }
+}
+exports.BaseController = BaseController;
+//# sourceMappingURL=base.js.map

package/src/lib/controllers/base.js.map

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