@digitaldefiance/node-express-suite 3.7.5 → 3.8.0

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

@@ -0,0 +1 @@
+{"version":3,"file":"application-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/builders/application-builder.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAGH,oEAGyC;AAEzC,gDAA6C;AAkB7C;;;;;;GAMG;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,OAAsC;QAClD,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;QAQH,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,OAAO,IAAI,yBAAW,CACpB,IAAI,CAAC,WAAW,EAChB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,oBAAoB,EACzB,IAAI,CAAC,sBAAsB,EAC3B,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,SAAS,EACd,IAAI,CAAC,gBAAgB,EACrB,IAAI,CAAC,oBAAoB,CAC1B,CAAC;IACJ,CAAC;CACF;AA7GD,gDA6GC"}

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

@@ -1 +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/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/src/builders/index.ts"],"names":[],"mappings":";;;AAAA,gEAAsC"}

package/src/constants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * @fileoverview Application constants including checksum, JWT, FEC, and ECIES configurations.
+ * Provides factory functions for creating environment-specific constant sets.
+ * @module constants
+ */
+import { IFECConsts } from './interfaces';
+import { IChecksumConsts } from './interfaces/checksum-consts';
+import { IConstants } from './interfaces/constants';
+import { IJwtConsts } from './interfaces/jwt-consts';
+/**
+ * Constants for checksum operations
+ * These values are critical for data integrity and MUST NOT be changed
+ * in an already established system as it will break all existing checksums.
+ */
+export declare const CHECKSUM: IChecksumConsts;
+export declare const JWT: IJwtConsts;
+export declare const FEC: IFECConsts;
+export declare const ECIES: Readonly<import("@digitaldefiance/ecies-lib").IECIESConstants>;
+export declare const createExpressConstants: (siteDomain: string, siteHostname: string, overrides?: Partial<IConstants>) => IConstants;
+export declare const LocalhostConstants: IConstants;
+//# sourceMappingURL=constants.d.ts.map

package/src/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-express-suite/src/constants.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AASH,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,8BAA8B,CAAC;AAC/D,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;;;GAIG;AACH,eAAO,MAAM,QAAQ,EAAE,eAYZ,CAAC;AAEZ,eAAO,MAAM,GAAG,EAAE,UAUR,CAAC;AAEX,eAAO,MAAM,GAAG,EAAE,UAKR,CAAC;AAGX,eAAO,MAAM,KAAK,gEAA+B,CAAC;AAElD,eAAO,MAAM,sBAAsB,GACjC,YAAY,MAAM,EAClB,cAAc,MAAM,EACpB,YAAY,OAAO,CAAC,UAAU,CAAC,KAC9B,UAWF,CAAC;AAEF,eAAO,MAAM,kBAAkB,EAAE,UAGhC,CAAC"}

package/src/constants.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * @fileoverview Application constants including checksum, JWT, FEC, and ECIES configurations.
+ * Provides factory functions for creating environment-specific constant sets.
+ * @module constants
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LocalhostConstants = exports.createExpressConstants = exports.ECIES = exports.FEC = exports.JWT = exports.CHECKSUM = void 0;
+const ecies_lib_1 = require("@digitaldefiance/ecies-lib");
+const node_ecies_lib_1 = require("@digitaldefiance/node-ecies-lib");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+/**
+ * Constants for checksum operations
+ * These values are critical for data integrity and MUST NOT be changed
+ * in an already established system as it will break all existing checksums.
+ */
+exports.CHECKSUM = Object.freeze({
+    /** Default hash bits for SHA3 */
+    SHA3_DEFAULT_HASH_BITS: 512,
+    /** Length of a SHA3 checksum buffer in bytes */
+    SHA3_BUFFER_LENGTH: 64,
+    /** algorithm to use for checksum */
+    ALGORITHM: 'sha3-512',
+    /** encoding to use for checksum */
+    ENCODING: 'hex',
+});
+exports.JWT = {
+    /**
+     * Algorithm to use for JWT
+     */
+    ALGORITHM: 'HS256',
+    /**
+     * The expiration time for a JWT token in seconds
+     */
+    EXPIRATION_SEC: 86400,
+};
+exports.FEC = {
+    /**
+     * Maximum size of a single shard
+     */
+    MAX_SHARD_SIZE: 1048576,
+};
+// use defaults from ecies-lib
+exports.ECIES = Object.freeze(ecies_lib_1.ECIES);
+const createExpressConstants = (siteDomain, siteHostname, overrides) => {
+    return Object.freeze({
+        ...node_ecies_lib_1.Constants,
+        CHECKSUM: exports.CHECKSUM,
+        JWT: exports.JWT,
+        FEC: exports.FEC,
+        ECIES: exports.ECIES,
+        ECIES_VERSION_SIZE: 1,
+        ECIES_CIPHER_SUITE_SIZE: 1,
+        ...(0, suite_core_lib_1.createConstants)(siteDomain, siteHostname, overrides),
+    });
+};
+exports.createExpressConstants = createExpressConstants;
+exports.LocalhostConstants = (0, exports.createExpressConstants)('localhost', 'localhost');
+if (exports.CHECKSUM.SHA3_BUFFER_LENGTH !== exports.CHECKSUM.SHA3_DEFAULT_HASH_BITS / 8 ||
+    exports.CHECKSUM.SHA3_BUFFER_LENGTH !== exports.CHECKSUM.SHA3_DEFAULT_HASH_BITS / 8) {
+    throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_InvalidChecksumConstants);
+}
+//# sourceMappingURL=constants.js.map

package/src/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../../packages/digitaldefiance-node-express-suite/src/constants.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,0DAAoE;AACpE,oEAAkF;AAClF,oEAIyC;AAMzC;;;;GAIG;AACU,QAAA,QAAQ,GAAoB,MAAM,CAAC,MAAM,CAAC;IACrD,iCAAiC;IACjC,sBAAsB,EAAE,GAAY;IAEpC,gDAAgD;IAChD,kBAAkB,EAAE,EAAW;IAE/B,oCAAoC;IACpC,SAAS,EAAE,UAAmB;IAE9B,mCAAmC;IACnC,QAAQ,EAAE,KAAc;CAChB,CAAC,CAAC;AAEC,QAAA,GAAG,GAAe;IAC7B;;OAEG;IACH,SAAS,EAAE,OAAgB;IAE3B;;OAEG;IACH,cAAc,EAAE,KAAc;CACtB,CAAC;AAEE,QAAA,GAAG,GAAe;IAC7B;;OAEG;IACH,cAAc,EAAE,OAAgB;CACxB,CAAC;AAEX,8BAA8B;AACjB,QAAA,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,iBAAa,CAAC,CAAC;AAE3C,MAAM,sBAAsB,GAAG,CACpC,UAAkB,EAClB,YAAoB,EACpB,SAA+B,EACnB,EAAE;IACd,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,GAAG,0BAAkB;QACrB,QAAQ,EAAE,gBAAQ;QAClB,GAAG,EAAE,WAAG;QACR,GAAG,EAAE,WAAG;QACR,KAAK,EAAE,aAAK;QACZ,kBAAkB,EAAE,CAAC;QACrB,uBAAuB,EAAE,CAAC;QAC1B,GAAG,IAAA,gCAAe,EAAC,UAAU,EAAE,YAAY,EAAE,SAAS,CAAC;KAC1C,CAAC,CAAC;AACnB,CAAC,CAAC;AAfW,QAAA,sBAAsB,0BAejC;AAEW,QAAA,kBAAkB,GAAe,IAAA,8BAAsB,EAClE,WAAW,EACX,WAAW,CACZ,CAAC;AAEF,IACE,gBAAQ,CAAC,kBAAkB,KAAK,gBAAQ,CAAC,sBAAsB,GAAG,CAAC;IACnE,gBAAQ,CAAC,kBAAkB,KAAK,gBAAQ,CAAC,sBAAsB,GAAG,CAAC,EACnE,CAAC;IACD,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,8BAA8B,CAClD,CAAC;AACJ,CAAC"}

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

@@ -1,2 +1,3 @@
 export * from './service-container';
 export * from './service-definitions';
+//# sourceMappingURL=index.d.ts.map

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

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

package/src/container/index.js

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

package/src/container/index.js.map

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

package/src/container/service-container.d.ts

@@ -0,0 +1,45 @@
+/**
+ * @fileoverview Service container for dependency injection.
+ * Manages service registration and lifecycle with singleton support.
+ * @module container/service-container
+ */
+/**
+ * Factory function for creating service instances.
+ * @template T - Service type
+ */
+export type ServiceFactory<T = any> = () => T;
+/**
+ * Service container for dependency injection.
+ */
+export declare class ServiceContainer {
+    private services;
+    private instances;
+    private singletons;
+    /**
+     * Registers a service with the container.
+     * @template T - Service type
+     * @param {string} key - Service identifier
+     * @param {ServiceFactory<T>} factory - Factory function to create service
+     * @param {boolean} [singleton=true] - Whether to cache as singleton
+     */
+    register<T>(key: string, factory: ServiceFactory<T>, singleton?: boolean): void;
+    /**
+     * Retrieves a service from the container.
+     * @template T - Service type
+     * @param {string} key - Service identifier
+     * @returns {T} Service instance
+     * @throws {TranslatableSuiteError} If service is not registered
+     */
+    get<T>(key: string): T;
+    /**
+     * Checks if a service is registered.
+     * @param {string} key - Service identifier
+     * @returns {boolean} True if service exists
+     */
+    has(key: string): boolean;
+    /**
+     * Clears all cached singleton instances.
+     */
+    clear(): void;
+}
+//# sourceMappingURL=service-container.d.ts.map

package/src/container/service-container.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-container.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/container/service-container.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;;GAGG;AACH,MAAM,MAAM,cAAc,CAAC,CAAC,GAAG,GAAG,IAAI,MAAM,CAAC,CAAC;AAE9C;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,UAAU,CAAqB;IAEvC;;;;;;OAMG;IACH,QAAQ,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,CAAC,CAAC,CAAC,EAAE,SAAS,UAAO,GAAG,IAAI;IAO5E;;;;;;OAMG;IACH,GAAG,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,GAAG,CAAC;IAuBtB;;;;OAIG;IACH,GAAG,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIzB;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/src/container/service-container.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * @fileoverview Service container for dependency injection.
+ * Manages service registration and lifecycle with singleton support.
+ * @module container/service-container
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceContainer = void 0;
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+/**
+ * Service container for dependency injection.
+ */
+class ServiceContainer {
+    services = new Map();
+    instances = new Map();
+    singletons = new Set();
+    /**
+     * Registers a service with the container.
+     * @template T - Service type
+     * @param {string} key - Service identifier
+     * @param {ServiceFactory<T>} factory - Factory function to create service
+     * @param {boolean} [singleton=true] - Whether to cache as singleton
+     */
+    register(key, factory, singleton = true) {
+        this.services.set(key, factory);
+        if (singleton) {
+            this.singletons.add(key);
+        }
+    }
+    /**
+     * Retrieves a service from the container.
+     * @template T - Service type
+     * @param {string} key - Service identifier
+     * @returns {T} Service instance
+     * @throws {TranslatableSuiteError} If service is not registered
+     */
+    get(key) {
+        if (this.singletons.has(key)) {
+            if (!this.instances.has(key)) {
+                const factory = this.services.get(key);
+                if (!factory)
+                    throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_ServiceIsNotRegisteredTemplate, { key });
+                this.instances.set(key, factory());
+            }
+            return this.instances.get(key);
+        }
+        const factory = this.services.get(key);
+        if (!factory)
+            throw new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_ServiceIsNotRegisteredTemplate, { key });
+        return factory();
+    }
+    /**
+     * Checks if a service is registered.
+     * @param {string} key - Service identifier
+     * @returns {boolean} True if service exists
+     */
+    has(key) {
+        return this.services.has(key);
+    }
+    /**
+     * Clears all cached singleton instances.
+     */
+    clear() {
+        this.instances.clear();
+    }
+}
+exports.ServiceContainer = ServiceContainer;
+//# sourceMappingURL=service-container.js.map

package/src/container/service-container.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-container.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/container/service-container.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH,oEAGyC;AAQzC;;GAEG;AACH,MAAa,gBAAgB;IACnB,QAAQ,GAAG,IAAI,GAAG,EAA0B,CAAC;IAC7C,SAAS,GAAG,IAAI,GAAG,EAAe,CAAC;IACnC,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;IAEvC;;;;;;OAMG;IACH,QAAQ,CAAI,GAAW,EAAE,OAA0B,EAAE,SAAS,GAAG,IAAI;QACnE,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,SAAS,EAAE,CAAC;YACd,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QAC3B,CAAC;IACH,CAAC;IAED;;;;;;OAMG;IACH,GAAG,CAAI,GAAW;QAChB,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAC7B,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;gBACvC,IAAI,CAAC,OAAO;oBACV,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,oCAAoC,EACvD,EAAE,GAAG,EAAE,CACR,CAAC;gBACJ,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,EAAE,CAAC,CAAC;YACrC,CAAC;YACD,OAAO,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACjC,CAAC;QAED,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACvC,IAAI,CAAC,OAAO;YACV,MAAM,IAAI,uCAAsB,CAC9B,mCAAkB,CAAC,oCAAoC,EACvD,EAAE,GAAG,EAAE,CACR,CAAC;QACJ,OAAO,OAAO,EAAE,CAAC;IACnB,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAW;QACb,OAAO,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAChC,CAAC;IAED;;OAEG;IACH,KAAK;QACH,IAAI,CAAC,SAAS,CAAC,KAAK,EAAE,CAAC;IACzB,CAAC;CACF;AAhED,4CAgEC"}

package/src/container/{service-definitions.ts → service-definitions.d.ts}

@@ -3,21 +3,20 @@
  * Defines constants for service registration keys.
  * @module container/service-definitions
  */
-
 /**
  * Service registration keys.
  */
-export const ServiceKeys = {
-  JWT: 'jwt',
-  EMAIL: 'email',
-  ECIES: 'ecies',
-  KEY_WRAPPING: 'keyWrapping',
-  ROLE: 'role',
-  USER: 'user',
-  BACKUP_CODE: 'backupCode',
-} as const;
-
+export declare const ServiceKeys: {
+    readonly JWT: "jwt";
+    readonly EMAIL: "email";
+    readonly ECIES: "ecies";
+    readonly KEY_WRAPPING: "keyWrapping";
+    readonly ROLE: "role";
+    readonly USER: "user";
+    readonly BACKUP_CODE: "backupCode";
+};
 /**
  * Union type of all service keys.
  */
 export type ServiceKey = (typeof ServiceKeys)[keyof typeof ServiceKeys];
+//# sourceMappingURL=service-definitions.d.ts.map

package/src/container/service-definitions.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-definitions.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/container/service-definitions.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;CAQd,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,OAAO,WAAW,CAAC,CAAC,MAAM,OAAO,WAAW,CAAC,CAAC"}

package/src/container/service-definitions.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * @fileoverview Service key definitions for dependency injection.
+ * Defines constants for service registration keys.
+ * @module container/service-definitions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ServiceKeys = void 0;
+/**
+ * Service registration keys.
+ */
+exports.ServiceKeys = {
+    JWT: 'jwt',
+    EMAIL: 'email',
+    ECIES: 'ecies',
+    KEY_WRAPPING: 'keyWrapping',
+    ROLE: 'role',
+    USER: 'user',
+    BACKUP_CODE: 'backupCode',
+};
+//# sourceMappingURL=service-definitions.js.map

package/src/container/service-definitions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-definitions.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/container/service-definitions.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAEH;;GAEG;AACU,QAAA,WAAW,GAAG;IACzB,GAAG,EAAE,KAAK;IACV,KAAK,EAAE,OAAO;IACd,KAAK,EAAE,OAAO;IACd,YAAY,EAAE,aAAa;IAC3B,IAAI,EAAE,MAAM;IACZ,IAAI,EAAE,MAAM;IACZ,WAAW,EAAE,YAAY;CACjB,CAAC"}

package/src/controllers/base.d.ts

@@ -0,0 +1,80 @@
+/**
+ * @fileoverview Base controller class providing common functionality for all API controllers.
+ * Handles routing, validation, authentication, transactions, and error handling.
+ * @module controllers/base
+ */
+import { PluginI18nEngine } from '@digitaldefiance/i18n-lib';
+import { ClientSession } from '@digitaldefiance/mongoose-types';
+import { IRequestUserDTO } from '@digitaldefiance/suite-core-lib';
+import { NextFunction, Request, Response, Router } from 'express';
+import { IUserDocument } from '../documents/user';
+import { IConstants } from '../interfaces';
+import { IApplication } from '../interfaces/application';
+import { TransactionManager } from '../transactions';
+import { ApiResponse, FlexibleValidationChain, RouteConfig, TransactionCallback } from '../types';
+import { TransactionOptions } from '../utils';
+import type { PlatformID } from '@digitaldefiance/node-ecies-lib';
+/**
+ * Abstract base controller for all API controllers.
+ * Provides routing, validation, authentication, transaction management, and error handling.
+ * @template T API response type
+ * @template THandler Handler object type
+ * @template TLanguage Language code type
+ * @template TID Platform ID type
+ */
+export declare abstract class BaseController<T extends ApiResponse, THandler extends object, TLanguage extends string, TID extends PlatformID = Buffer> {
+    readonly router: Router;
+    private activeRequest;
+    private activeResponse;
+    private activeSession;
+    readonly application: IApplication<TID>;
+    protected routeDefinitions: RouteConfig<THandler, TLanguage>[];
+    protected get constants(): IConstants;
+    protected get pluginEngine(): PluginI18nEngine<TLanguage>;
+    protected handlers: THandler;
+    private static validationRegistry;
+    protected transactionManager: TransactionManager;
+    constructor(application: IApplication<TID>);
+    /**
+     * Register validation functions in the allowlist.
+     * Override this method to register custom validation functions.
+     */
+    protected registerValidationFunctions(): void;
+    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<THandler, TLanguage>, 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<TLanguage>): void;
+    get user(): IRequestUserDTO;
+    get validatedBody(): Record<string, unknown>;
+    get req(): Request;
+    get res(): Response;
+    get session(): ClientSession | undefined;
+    protected validateAndFetchRequestUser(req: Request): Promise<IUserDocument<TLanguage, TID>>;
+    withTransaction<T>(callback: TransactionCallback<T>, session?: ClientSession, options?: TransactionOptions<TID>, ...args: any): Promise<T>;
+}
+//# sourceMappingURL=base.d.ts.map

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

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