@digitaldefiance/node-express-suite 3.7.5 → 3.8.0

package/src/routing/route-builder.js

@@ -0,0 +1,167 @@
+"use strict";
+/**
+ * @fileoverview Route builder for fluent route configuration.
+ * Provides builder pattern for defining Express routes.
+ * @module routing/route-builder
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RouteBuilder = void 0;
+/**
+ * Builder for constructing route configurations with fluent API.
+ * @template TLanguage - Language code type (defaults to string)
+ */
+class RouteBuilder {
+    config = {};
+    /**
+     * Creates a new RouteBuilder instance.
+     * @template T - Language code type
+     * @returns {RouteBuilder<T>} New builder instance
+     */
+    static create() {
+        return new RouteBuilder();
+    }
+    /**
+     * Sets GET method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    get(path) {
+        this.config.method = 'get';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Sets POST method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    post(path) {
+        this.config.method = 'post';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Sets PUT method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    put(path) {
+        this.config.method = 'put';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Sets DELETE method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    delete(path) {
+        this.config.method = 'delete';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Sets PATCH method and path.
+     * @param {string} path - Route path
+     * @returns {this} This builder for chaining
+     */
+    patch(path) {
+        this.config.method = 'patch';
+        this.config.path = path;
+        return this;
+    }
+    /**
+     * Enables authentication.
+     * @param {boolean} [enabled=true] - Whether to enable authentication
+     * @returns {this} This builder for chaining
+     */
+    auth(enabled = true) {
+        this.config.auth = enabled;
+        return this;
+    }
+    /**
+     * Enables crypto authentication.
+     * @param {boolean} [enabled=true] - Whether to enable crypto authentication
+     * @returns {this} This builder for chaining
+     */
+    cryptoAuth(enabled = true) {
+        this.config.cryptoAuth = enabled;
+        return this;
+    }
+    /**
+     * Sets validation chains.
+     * @param {ValidationChain[] | Function} validation - Validation chains or factory function
+     * @returns {this} This builder for chaining
+     */
+    validate(validation) {
+        this.config.validation = validation;
+        return this;
+    }
+    /**
+     * Sets Zod schema for validation.
+     * @param {z.ZodSchema} schema - Zod schema
+     * @returns {this} This builder for chaining
+     */
+    schema(schema) {
+        this.config.schema = schema;
+        return this;
+    }
+    /**
+     * Adds middleware to the route.
+     * @param {...RequestHandler[]} middleware - Middleware functions
+     * @returns {this} This builder for chaining
+     */
+    use(...middleware) {
+        this.config.middleware = [...(this.config.middleware || []), ...middleware];
+        return this;
+    }
+    /**
+     * Enables transaction support.
+     * @param {boolean} [enabled=true] - Whether to enable transactions
+     * @param {number} [timeout] - Transaction timeout in milliseconds
+     * @returns {this} This builder for chaining
+     */
+    transaction(enabled = true, timeout) {
+        this.config.transaction = enabled;
+        if (timeout)
+            this.config.transactionTimeout = timeout;
+        return this;
+    }
+    /**
+     * Enables raw JSON handling.
+     * @param {boolean} [enabled=true] - Whether to enable raw JSON
+     * @returns {this} This builder for chaining
+     */
+    rawJson(enabled = true) {
+        this.config.rawJson = enabled;
+        return this;
+    }
+    /**
+     * Builds the route configuration with handler.
+     * @param {RequestHandler} handler - Route handler function
+     * @returns {RouteConfig<TLanguage>} Complete route configuration
+     * @throws {Error} If method or path not set
+     */
+    handle(handler) {
+        if (!this.config.method || !this.config.path) {
+            throw new Error('Method and path must be set before calling handle()');
+        }
+        return {
+            method: this.config.method,
+            path: this.config.path,
+            handler,
+            options: {
+                auth: this.config.auth,
+                cryptoAuth: this.config.cryptoAuth,
+                validation: this.config.validation,
+                schema: this.config.schema,
+                middleware: this.config.middleware,
+                transaction: this.config.transaction,
+                transactionTimeout: this.config.transactionTimeout,
+                rawJson: this.config.rawJson,
+            },
+        };
+    }
+}
+exports.RouteBuilder = RouteBuilder;
+//# sourceMappingURL=route-builder.js.map

package/src/routing/route-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"route-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/routing/route-builder.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAMH;;;GAGG;AACH,MAAa,YAAY;IACf,MAAM,GAYV,EAAE,CAAC;IAEP;;;;OAIG;IACH,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,YAAY,EAAK,CAAC;IAC/B,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,IAAY;QACf,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,KAAK,CAAC;QAC3B,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,IAAY;QACjB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,QAAQ,CAAC;QAC9B,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,IAAY;QAChB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,OAAO,CAAC;QAC7B,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI,CAAC,OAAO,GAAG,IAAI;QACjB,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,OAAO,CAAC;QAC3B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,UAAU,CAAC,OAAO,GAAG,IAAI;QACvB,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,OAAO,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,QAAQ,CACN,UAAwE;QAExE,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,UAAU,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,MAAM,CAAC,MAAmB;QACxB,IAAI,CAAC,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC;QAC5B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,GAAG,CAAC,GAAG,UAA4B;QACjC,IAAI,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,GAAG,UAAU,CAAC,CAAC;QAC5E,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,WAAW,CAAC,OAAO,GAAG,IAAI,EAAE,OAAgB;QAC1C,IAAI,CAAC,MAAM,CAAC,WAAW,GAAG,OAAO,CAAC;QAClC,IAAI,OAAO;YAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB,GAAG,OAAO,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,OAAO,CAAC,OAAO,GAAG,IAAI;QACpB,IAAI,CAAC,MAAM,CAAC,OAAO,GAAG,OAAO,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,MAAM,CAAC,OAAuB;QAC5B,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC;YAC7C,MAAM,IAAI,KAAK,CAAC,qDAAqD,CAAC,CAAC;QACzE,CAAC;QACD,OAAO;YACL,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;YAC1B,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;YACtB,OAAO;YACP,OAAO,EAAE;gBACP,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,IAAI;gBACtB,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,MAAM,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM;gBAC1B,UAAU,EAAE,IAAI,CAAC,MAAM,CAAC,UAAU;gBAClC,WAAW,EAAE,IAAI,CAAC,MAAM,CAAC,WAAW;gBACpC,kBAAkB,EAAE,IAAI,CAAC,MAAM,CAAC,kBAAkB;gBAClD,OAAO,EAAE,IAAI,CAAC,MAAM,CAAC,OAAO;aAC7B;SACF,CAAC;IACJ,CAAC;CACF;AAnLD,oCAmLC"}

package/src/schemas/email-token.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @fileoverview Email token schema factory for MongoDB.
+ * Creates schema for email verification and password reset tokens.
+ * @module schemas/email-token
+ */
+import { Schema } from '@digitaldefiance/mongoose-types';
+import { EmailTokenType } from '@digitaldefiance/suite-core-lib';
+import { BaseModelName } from '../enumerations';
+import { IConstants } from '../interfaces';
+/**
+ * Configuration options for creating an email token schema.
+ * @template TTokenType - Token type enum (defaults to EmailTokenType)
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TConstants - Constants type (defaults to IConstants)
+ */
+export interface EmailTokenSchemaOptions<TTokenType extends string = EmailTokenType, TModelName extends string = BaseModelName, TConstants extends IConstants = IConstants> {
+    /** Token type enum values to use */
+    tokenTypeEnum?: TTokenType[];
+    /** Model name for user reference */
+    userModelName?: TModelName;
+    /** Token expiration time (default: '1d') */
+    expiresIn?: string;
+    /** Custom email validator function */
+    emailValidator?: (v: string) => boolean;
+    /** Custom validation error message function */
+    validationMessage?: (props: {
+        value: string;
+    }) => string;
+    constants?: TConstants;
+    /** ID type for references */
+    idType?: any;
+}
+/**
+ * Factory function to create an extensible email token schema.
+ * Includes TTL index for automatic token expiration.
+ * @template TTokenType - Token type enum (defaults to EmailTokenType)
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TConstants - Constants type (defaults to IConstants)
+ * @param {EmailTokenSchemaOptions<TTokenType, TModelName>} options - Schema configuration options
+ * @param {TConstants} [_constants] - Optional constants (reserved for future use)
+ * @returns {Schema} Configured email token schema with TTL and unique indexes
+ */
+export declare function createEmailTokenSchema<TTokenType extends string = EmailTokenType, TModelName extends string = BaseModelName, TConstants extends IConstants = IConstants>(options?: EmailTokenSchemaOptions<TTokenType, TModelName>, _constants?: TConstants): Schema;
+/**
+ * Default email token schema with base configuration.
+ * Pre-configured schema with 1-day TTL and compound unique index.
+ */
+export declare const EmailTokenSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, {
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<{
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}> & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}>;
+//# sourceMappingURL=email-token.d.ts.map

package/src/schemas/email-token.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-token.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/schemas/email-token.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AACzD,OAAO,EACL,cAAc,EAGf,MAAM,iCAAiC,CAAC;AAEzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;;GAKG;AACH,MAAM,WAAW,uBAAuB,CACtC,UAAU,SAAS,MAAM,GAAG,cAAc,EAC1C,UAAU,SAAS,MAAM,GAAG,aAAa,EACzC,UAAU,SAAS,UAAU,GAAG,UAAU;IAE1C,oCAAoC;IACpC,aAAa,CAAC,EAAE,UAAU,EAAE,CAAC;IAC7B,oCAAoC;IACpC,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,4CAA4C;IAC5C,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,sCAAsC;IACtC,cAAc,CAAC,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC;IACxC,+CAA+C;IAC/C,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE;QAAE,KAAK,EAAE,MAAM,CAAA;KAAE,KAAK,MAAM,CAAC;IACzD,SAAS,CAAC,EAAE,UAAU,CAAC;IACvB,6BAA6B;IAC7B,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CACpC,UAAU,SAAS,MAAM,GAAG,cAAc,EAC1C,UAAU,SAAS,MAAM,GAAG,aAAa,EACzC,UAAU,SAAS,UAAU,GAAG,UAAU,EAE1C,OAAO,GAAE,uBAAuB,CAAC,UAAU,EAAE,UAAU,CAAM,EAC7D,UAAU,CAAC,EAAE,UAAU,GACtB,MAAM,CA8CR;AAED;;;GAGG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;EAA2B,CAAC"}

package/src/schemas/email-token.js

@@ -0,0 +1,68 @@
+"use strict";
+/**
+ * @fileoverview Email token schema factory for MongoDB.
+ * Creates schema for email verification and password reset tokens.
+ * @module schemas/email-token
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EmailTokenSchema = void 0;
+exports.createEmailTokenSchema = createEmailTokenSchema;
+const tslib_1 = require("tslib");
+const mongoose_types_1 = require("@digitaldefiance/mongoose-types");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const validator_1 = tslib_1.__importDefault(require("validator"));
+const enumerations_1 = require("../enumerations");
+/**
+ * Factory function to create an extensible email token schema.
+ * Includes TTL index for automatic token expiration.
+ * @template TTokenType - Token type enum (defaults to EmailTokenType)
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TConstants - Constants type (defaults to IConstants)
+ * @param {EmailTokenSchemaOptions<TTokenType, TModelName>} options - Schema configuration options
+ * @param {TConstants} [_constants] - Optional constants (reserved for future use)
+ * @returns {Schema} Configured email token schema with TTL and unique indexes
+ */
+function createEmailTokenSchema(options = {}, _constants) {
+    const { tokenTypeEnum = Object.values(suite_core_lib_1.EmailTokenType), userModelName = enumerations_1.BaseModelName.User, expiresIn = '1d', validationMessage = (props) => (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Error_InvalidEmailTemplate, {
+        email: props.value,
+    }), idType = mongoose_types_1.Schema.Types.ObjectId, } = options;
+    const definition = {
+        userId: {
+            type: idType,
+            required: true,
+            ref: userModelName,
+            immutable: true,
+        },
+        type: {
+            type: String,
+            enum: tokenTypeEnum,
+            required: true,
+            immutable: true,
+        },
+        token: { type: String, required: true, immutable: true, unique: true },
+        email: {
+            type: String,
+            required: true,
+            immutable: true,
+            validate: {
+                validator: (v) => validator_1.default.isEmail(v),
+                message: validationMessage,
+            },
+        },
+        lastSent: { type: Date, required: false },
+        expiresAt: {
+            type: Date,
+            default: Date.now,
+            index: { expires: expiresIn },
+        },
+    };
+    const schema = new mongoose_types_1.Schema(definition, { timestamps: true });
+    schema.index({ userId: 1, email: 1, type: 1 }, { unique: true });
+    return schema;
+}
+/**
+ * Default email token schema with base configuration.
+ * Pre-configured schema with 1-day TTL and compound unique index.
+ */
+exports.EmailTokenSchema = createEmailTokenSchema();
+//# sourceMappingURL=email-token.js.map

package/src/schemas/email-token.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"email-token.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/schemas/email-token.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAgDH,wDAqDC;;AAnGD,oEAAyD;AACzD,oEAIyC;AACzC,kEAAkC;AAClC,kDAAgD;AA6BhD;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAKpC,UAA2D,EAAE,EAC7D,UAAuB;IAEvB,MAAM,EACJ,aAAa,GAAG,MAAM,CAAC,MAAM,CAAC,+BAAc,CAAiB,EAC7D,aAAa,GAAG,4BAAa,CAAC,IAAkB,EAChD,SAAS,GAAG,IAAI,EAChB,iBAAiB,GAAG,CAAC,KAAwB,EAAE,EAAE,CAC/C,IAAA,wCAAuB,EAAC,mCAAkB,CAAC,0BAA0B,EAAE;QACrE,KAAK,EAAE,KAAK,CAAC,KAAK;KACnB,CAAC,EACJ,MAAM,GAAG,uBAAM,CAAC,KAAK,CAAC,QAAQ,GAC/B,GAAG,OAAO,CAAC;IAEZ,MAAM,UAAU,GAAG;QACjB,MAAM,EAAE;YACN,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,GAAG,EAAE,aAAa;YAClB,SAAS,EAAE,IAAI;SAChB;QACD,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,IAAI,EAAE,aAAa;YACnB,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;SAChB;QACD,KAAK,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE;QACtE,KAAK,EAAE;YACL,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,SAAS,EAAE,IAAI;YACf,QAAQ,EAAE;gBACR,SAAS,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,mBAAS,CAAC,OAAO,CAAC,CAAC,CAAC;gBAC9C,OAAO,EAAE,iBAAiB;aAC3B;SACF;QACD,QAAQ,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;QACzC,SAAS,EAAE;YACT,IAAI,EAAE,IAAI;YACV,OAAO,EAAE,IAAI,CAAC,GAAG;YACjB,KAAK,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE;SAC9B;KACF,CAAC;IAEF,MAAM,MAAM,GAAG,IAAI,uBAAM,CAAC,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;IAC5D,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;IACjE,OAAO,MAAM,CAAC;AAChB,CAAC;AAED;;;GAGG;AACU,QAAA,gBAAgB,GAAG,sBAAsB,EAAE,CAAC"}

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

@@ -5,3 +5,4 @@ export * from './schema';
 export * from './used-direct-login-token';
 export * from './user';
 export * from './user-role';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/schemas/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,YAAY,CAAC;AAC3B,cAAc,QAAQ,CAAC;AACvB,cAAc,UAAU,CAAC;AACzB,cAAc,2BAA2B,CAAC;AAC1C,cAAc,QAAQ,CAAC;AACvB,cAAc,aAAa,CAAC"}

package/src/schemas/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./email-token"), exports);
+tslib_1.__exportStar(require("./mnemonic"), exports);
+tslib_1.__exportStar(require("./role"), exports);
+tslib_1.__exportStar(require("./schema"), exports);
+tslib_1.__exportStar(require("./used-direct-login-token"), exports);
+tslib_1.__exportStar(require("./user"), exports);
+tslib_1.__exportStar(require("./user-role"), exports);
+//# sourceMappingURL=index.js.map

package/src/schemas/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/schemas/index.ts"],"names":[],"mappings":";;;AAAA,wDAA8B;AAC9B,qDAA2B;AAC3B,iDAAuB;AACvB,mDAAyB;AACzB,oEAA0C;AAC1C,iDAAuB;AACvB,sDAA4B"}

package/src/schemas/mnemonic.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @fileoverview Mnemonic schema factory for MongoDB.
+ * Creates schema for storing HMAC-protected mnemonic hashes.
+ * @module schemas/mnemonic
+ */
+import { Schema } from '@digitaldefiance/mongoose-types';
+import { IConstants } from '../interfaces/constants';
+/**
+ * Creates a mnemonic schema with custom or default constants.
+ * @template T - Constants type extending IConstants
+ * @param {Function} [validationMessage] - Optional custom validation message function
+ * @param {T} constants - Constants for validation (defaults to AppConstants)
+ * @returns {Schema} Configured mnemonic schema
+ */
+export declare function createMnemonicSchema<T extends IConstants = IConstants>(validationMessage?: () => string, constants?: T): Schema;
+/**
+ * Default mnemonic schema using AppConstants.
+ * Pre-configured schema for standard mnemonic storage.
+ */
+export declare const MnemonicSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, {
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<{
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}> & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}>;
+//# sourceMappingURL=mnemonic.d.ts.map

package/src/schemas/mnemonic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/schemas/mnemonic.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,MAAM,EAAE,MAAM,iCAAiC,CAAC;AAMzD,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAErD;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAAC,CAAC,SAAS,UAAU,GAAG,UAAU,EACpE,iBAAiB,CAAC,EAAE,MAAM,MAAM,EAChC,SAAS,GAAE,CAAqB,GAC/B,MAAM,CAiBR;AAED;;;GAGG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;EAAyB,CAAC"}

package/src/schemas/mnemonic.js

@@ -0,0 +1,41 @@
+"use strict";
+/**
+ * @fileoverview Mnemonic schema factory for MongoDB.
+ * Creates schema for storing HMAC-protected mnemonic hashes.
+ * @module schemas/mnemonic
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MnemonicSchema = void 0;
+exports.createMnemonicSchema = createMnemonicSchema;
+const mongoose_types_1 = require("@digitaldefiance/mongoose-types");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const constants_1 = require("../constants");
+/**
+ * Creates a mnemonic schema with custom or default constants.
+ * @template T - Constants type extending IConstants
+ * @param {Function} [validationMessage] - Optional custom validation message function
+ * @param {T} constants - Constants for validation (defaults to AppConstants)
+ * @returns {Schema} Configured mnemonic schema
+ */
+function createMnemonicSchema(validationMessage, constants = constants_1.LocalhostConstants) {
+    const definition = {
+        hmac: {
+            type: String,
+            required: true,
+            unique: true,
+            index: true,
+            validate: {
+                validator: (v) => constants.MnemonicHmacRegex.test(v),
+                message: validationMessage ||
+                    (() => (0, suite_core_lib_1.getSuiteCoreTranslation)(suite_core_lib_1.SuiteCoreStringKey.Validation_HmacRegex)),
+            },
+        },
+    };
+    return new mongoose_types_1.Schema(definition);
+}
+/**
+ * Default mnemonic schema using AppConstants.
+ * Pre-configured schema for standard mnemonic storage.
+ */
+exports.MnemonicSchema = createMnemonicSchema();
+//# sourceMappingURL=mnemonic.js.map

package/src/schemas/mnemonic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mnemonic.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/schemas/mnemonic.ts"],"names":[],"mappings":";AAAA;;;;GAIG;;;AAiBH,oDAoBC;AAnCD,oEAAyD;AACzD,oEAGyC;AACzC,4CAAkE;AAGlE;;;;;;GAMG;AACH,SAAgB,oBAAoB,CAClC,iBAAgC,EAChC,YAAe,8BAAiB;IAEhC,MAAM,UAAU,GAAG;QACjB,IAAI,EAAE;YACJ,IAAI,EAAE,MAAM;YACZ,QAAQ,EAAE,IAAI;YACd,MAAM,EAAE,IAAI;YACZ,KAAK,EAAE,IAAI;YACX,QAAQ,EAAE;gBACR,SAAS,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,SAAS,CAAC,iBAAiB,CAAC,IAAI,CAAC,CAAC,CAAC;gBAC7D,OAAO,EACL,iBAAiB;oBACjB,CAAC,GAAG,EAAE,CACJ,IAAA,wCAAuB,EAAC,mCAAkB,CAAC,oBAAoB,CAAC,CAAC;aACtE;SACF;KACF,CAAC;IACF,OAAO,IAAI,uBAAM,CAAC,UAAU,CAAC,CAAC;AAChC,CAAC;AAED;;;GAGG;AACU,QAAA,cAAc,GAAG,oBAAoB,EAAE,CAAC"}

package/src/schemas/role.d.ts

@@ -0,0 +1,57 @@
+/**
+ * @fileoverview Role schema factory for MongoDB with RBAC support.
+ * Creates schema for role management with validation and immutability.
+ * @module schemas/role
+ */
+import { CallbackWithoutResultAndOptionalError, Schema } from '@digitaldefiance/mongoose-types';
+import { Role } from '@digitaldefiance/suite-core-lib';
+import { BaseModelName } from '../enumerations';
+import { IConstants } from '../interfaces';
+/**
+ * Configuration options for creating a role schema.
+ * @template TRole - Role enum type (defaults to Role)
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ */
+export interface RoleSchemaOptions<TRole extends string = Role, TModelName extends string = BaseModelName> {
+    /** Role enum values to use */
+    roleEnum?: TRole[];
+    /** Model name for user reference */
+    userModelName?: TModelName;
+    /** Custom pre-save validation function */
+    customValidation?: <T = any>(doc: T, next: CallbackWithoutResultAndOptionalError) => void;
+    /** ID type for references */
+    idType?: any;
+}
+/**
+ * Factory function to create an extensible role schema.
+ * Includes pre-save validation to prevent invalid role combinations.
+ * @template TRole - Role enum type (defaults to Role)
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TConstants - Constants type (defaults to IConstants)
+ * @param {RoleSchemaOptions<TRole, TModelName>} options - Schema configuration options
+ * @param {TConstants} _constants - Optional constants (reserved for future use)
+ * @returns {Schema} Configured role schema with validation hooks
+ */
+export declare function createRoleSchema<TRole extends string = Role, TModelName extends string = BaseModelName, TConstants extends IConstants = IConstants>(options?: RoleSchemaOptions<TRole, TModelName>, _constants?: TConstants): Schema;
+/**
+ * Default role schema with base configuration.
+ * Pre-configured schema with Role enum and validation hooks.
+ */
+export declare const RoleSchema: Schema<any, import("mongoose").Model<any, any, any, any, any, any>, {}, {}, {}, {}, import("mongoose").DefaultSchemaOptions, {
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}, import("mongoose").Document<unknown, {}, import("mongoose").FlatRecord<{
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}>, {}, import("mongoose").ResolveSchemaOptions<import("mongoose").DefaultSchemaOptions>> & import("mongoose").FlatRecord<{
+    [x: number]: unknown;
+    [x: symbol]: unknown;
+    [x: string]: unknown;
+}> & Required<{
+    _id: unknown;
+}> & {
+    __v: number;
+}>;
+//# sourceMappingURL=role.d.ts.map

package/src/schemas/role.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-node-express-suite/src/schemas/role.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EACL,qCAAqC,EACrC,MAAM,EACP,MAAM,iCAAiC,CAAC;AACzC,OAAO,EACL,IAAI,EAGL,MAAM,iCAAiC,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAE3C;;;;GAIG;AACH,MAAM,WAAW,iBAAiB,CAChC,KAAK,SAAS,MAAM,GAAG,IAAI,EAC3B,UAAU,SAAS,MAAM,GAAG,aAAa;IAEzC,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,KAAK,EAAE,CAAC;IACnB,oCAAoC;IACpC,aAAa,CAAC,EAAE,UAAU,CAAC;IAC3B,0CAA0C;IAC1C,gBAAgB,CAAC,EAAE,CAAC,CAAC,GAAG,GAAG,EACzB,GAAG,EAAE,CAAC,EACN,IAAI,EAAE,qCAAqC,KACxC,IAAI,CAAC;IACV,6BAA6B;IAC7B,MAAM,CAAC,EAAE,GAAG,CAAC;CACd;AAED;;;;;;;;;GASG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,SAAS,MAAM,GAAG,IAAI,EAC3B,UAAU,SAAS,MAAM,GAAG,aAAa,EACzC,UAAU,SAAS,UAAU,GAAG,UAAU,EAE1C,OAAO,GAAE,iBAAiB,CAAC,KAAK,EAAE,UAAU,CAAM,EAClD,UAAU,GAAE,UAA6B,GACxC,MAAM,CAyFR;AAED;;;GAGG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;EAAqB,CAAC"}

package/src/schemas/role.js

@@ -0,0 +1,102 @@
+"use strict";
+/**
+ * @fileoverview Role schema factory for MongoDB with RBAC support.
+ * Creates schema for role management with validation and immutability.
+ * @module schemas/role
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoleSchema = void 0;
+exports.createRoleSchema = createRoleSchema;
+const mongoose_types_1 = require("@digitaldefiance/mongoose-types");
+const suite_core_lib_1 = require("@digitaldefiance/suite-core-lib");
+const enumerations_1 = require("../enumerations");
+/**
+ * Factory function to create an extensible role schema.
+ * Includes pre-save validation to prevent invalid role combinations.
+ * @template TRole - Role enum type (defaults to Role)
+ * @template TModelName - Model name type (defaults to BaseModelName)
+ * @template TConstants - Constants type (defaults to IConstants)
+ * @param {RoleSchemaOptions<TRole, TModelName>} options - Schema configuration options
+ * @param {TConstants} _constants - Optional constants (reserved for future use)
+ * @returns {Schema} Configured role schema with validation hooks
+ */
+function createRoleSchema(options = {}, _constants = {}) {
+    const { roleEnum = Object.values(suite_core_lib_1.Role), userModelName = enumerations_1.BaseModelName.User, customValidation, idType = mongoose_types_1.Schema.Types.ObjectId, } = options;
+    const definition = {
+        name: {
+            type: String,
+            enum: roleEnum,
+            required: true,
+            immutable: true,
+        },
+        admin: {
+            type: Boolean,
+            default: false,
+            immutable: true,
+        },
+        member: {
+            type: Boolean,
+            default: false,
+            immutable: true,
+        },
+        child: {
+            type: Boolean,
+            default: false,
+            immutable: true,
+        },
+        system: {
+            type: Boolean,
+            default: false,
+            immutable: true,
+        },
+        createdBy: {
+            type: idType,
+            ref: userModelName,
+            required: true,
+            immutable: true,
+        },
+        updatedBy: {
+            type: idType,
+            ref: userModelName,
+            required: true,
+        },
+        deletedAt: {
+            type: Date,
+            optional: true,
+            get: (v) => v,
+            set: (v) => new Date(v.toUTCString()),
+        },
+        deletedBy: {
+            type: idType,
+            ref: userModelName,
+            required: false,
+            optional: true,
+        },
+    };
+    const schema = new mongoose_types_1.Schema(definition, { timestamps: true });
+    schema.index({ name: 1 }, { unique: true });
+    schema.pre('save', function (next) {
+        // eslint-disable-next-line @typescript-eslint/no-this-alias
+        const doc = this;
+        if (customValidation) {
+            customValidation(doc, next);
+        }
+        else {
+            // Default validation
+            if (doc.admin && doc.child) {
+                return next(new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_ChildRoleCannotBeAnAdminRole));
+            }
+            if (doc.system && doc.child) {
+                return next(new suite_core_lib_1.TranslatableSuiteError(suite_core_lib_1.SuiteCoreStringKey.Error_ChildRoleCannotBeASystemRole));
+            }
+            next();
+        }
+    });
+    return schema;
+}
+/**
+ * Default role schema with base configuration.
+ * Pre-configured schema with Role enum and validation hooks.
+ */
+exports.RoleSchema = createRoleSchema();
+//# sourceMappingURL=role.js.map

package/src/schemas/role.js.map

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