@digitaldefiance/suite-core-lib 1.0.0 → 1.0.2

package/README.md

@@ -290,6 +290,16 @@ MIT © [Digital Defiance](https://github.com/digitaldefiance)
 
 ## ChangeLog
 
+## v1.0.2: Missing export (IConstants)
+
+- Sun Oct 12 2025 14:13:00 GMT-0700 (Pacific Daylight Time)
+  - Added missing export for IConstants in src/interfaces/index.ts
+
+## v1.0.1: Add constants/function
+
+- Sun Oct 12 2025 13:34:00 GMT-0700 (Pacific Daylight Time)
+  - Added more constants and changed to a function to create the constants object
+
 ## v1.0.0: Initial release of user system package
 
 - Sun Oct 12 2025 13:26:37 GMT-0700 (Pacific Daylight Time)

package/dist/constants.d.ts

@@ -1,5 +1,6 @@
 import { IBackupCodeConstants } from './interfaces';
 import { IConstants } from './interfaces/constants';
 export declare const BACKUP_CODES: IBackupCodeConstants;
+export declare const createConstants: (siteDomain: string, overrides?: Partial<IConstants>) => IConstants;
 export declare const Constants: IConstants;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,eAAO,MAAM,YAAY,EAAE,oBAOjB,CAAC;AAEX,eAAO,MAAM,SAAS,EAAE,UAEvB,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAEpD,eAAO,MAAM,YAAY,EAAE,oBAOhB,CAAC;AAEZ,eAAO,MAAM,eAAe,EAAE,CAC5B,UAAU,EAAE,MAAM,EAClB,SAAS,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,KAC5B,UAqHJ,CAAC;AAEF,eAAO,MAAM,SAAS,YAA+B,CAAC"}

package/dist/constants.js

@@ -1,15 +1,126 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.Constants = exports.BACKUP_CODES = void 0;
-exports.BACKUP_CODES = {
+exports.Constants = exports.createConstants = exports.BACKUP_CODES = void 0;
+const role_1 = require("./enumerations/role");
+exports.BACKUP_CODES = Object.freeze({
     /**
      * How many backup codes to generate for users
      */
     Count: 10,
     NormalizedHexRegex: /^[a-z0-9]{32}$/, // exactly 32 lowercase alphanumeric chars
     DisplayRegex: /^([a-z0-9]{4}-){7}[a-z0-9]{4}$/, // xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx-xxxx
+});
+const createConstants = (siteDomain, overrides) => {
+    const result = {
+        /**
+         * Default duration in seconds for which a mnemonic is kept in memory
+         */
+        DefaultExpireMemoryMnemonicSeconds: 300, // 5 minutes
+        /**
+         * Default duration in seconds for which a wallet is kept in memory
+         */
+        DefaultExpireMemoryWalletSeconds: 300, // 5 minutes
+        /**
+         * Duration in milliseconds for which a login challenge is valid.
+         */
+        LoginChallengeExpiration: 60000, // 60 seconds
+        /**
+         * The expected length of a direct login challenge in bytes
+         */
+        DirectLoginChallengeLength: 104,
+        /**
+         * Backup code system configuration
+         */
+        BACKUP_CODES: exports.BACKUP_CODES,
+        /**
+         * Duration in milliseconds for which an email token is valid.
+         */
+        EmailTokenExpiration: 86400000, // 24 * 60 * 60 * 1000
+        /**
+         * Length in bytes of the email token generated (is represented as a hex string of twice as many)
+         */
+        EmailTokenLength: 32,
+        /**
+         * Number of rounds for bcrypt hashing. Higher values increase security but also consume more CPU resources.
+         */
+        BcryptRounds: 10,
+        /**
+         * The username of the administrator user.
+         */
+        AdministratorUser: 'admin',
+        /**
+         * The name of the administrator role.
+         */
+        AdministratorRole: role_1.Role.Admin,
+        /**
+         * The email of the administrator user/admin contact
+         */
+        AdministratorEmail: `admin@${siteDomain}`,
+        /**
+         * The name of the member role.
+         */
+        MemberRole: role_1.Role.Member,
+        /**
+         * The email of the test user.
+         */
+        MemberEmail: `test@${siteDomain}`,
+        /**
+         * The username of the test user.
+         */
+        MemberUser: 'test',
+        /**
+         * The name of the system role.
+         */
+        SystemRole: role_1.Role.System,
+        /**
+         * The username of the system user.
+         */
+        SystemUser: 'system',
+        /**
+         * The email of the system user.
+         */
+        SystemEmail: `system@${siteDomain}`,
+        /**
+         * Minimum username length
+         */
+        UsernameMinLength: 3,
+        /**
+         * Maximum username length
+         */
+        UsernameMaxLength: 30,
+        /**
+         * The regular expression for valid usernames.
+         */
+        UsernameRegex: /^[A-Za-z0-9]{3,30}$/,
+        /**
+         * Minimum password length
+         */
+        PasswordMinLength: 8,
+        /**
+         * The regular expression for valid passwords.
+         */
+        PasswordRegex: /^(?=.*[A-Za-z])(?=.*\d)(?=.*[!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?])[A-Za-z\d!@#$%^&*()_+\-=[\]{};':"\\|,.<>/?]{8,}$/,
+        /**
+         * The regular expression for valid mnemonic phrases.
+         * BIP39 - supports 12, 15, 18, 21, or 24 word mnemonics
+         */
+        MnemonicRegex: /^(?:\w+\s){11}\w+$|^(?:\w+\s){14}\w+$|^(?:\w+\s){17}\w+$|^(?:\w+\s){20}\w+$|^(?:\w+\s){23}\w+$/i,
+        /**
+         * Matches a 64-character hexadecimal string (SHA-256).
+         */
+        HmacRegex: /^[a-f0-9]{64}$/,
+        /**
+         * The amount of time in milliseconds after which an email token can be resent.
+         */
+        EmailTokenResendInterval: 300000, // 5 * 60 * 1000 = 5 minutes
+        /**
+         * The interval in minutes after which an email token can be resent.
+         */
+        EmailTokenResendIntervalMinutes: 5,
+        ...(overrides ?? {}),
+    };
+    return Object.freeze(result);
 };
-exports.Constants = {
-    BACKUP_CODES: exports.BACKUP_CODES,
-};
+exports.createConstants = createConstants;
+exports.Constants = (0, exports.createConstants)('localhost');
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAGa,QAAA,YAAY,GAAyB;IAChD;;OAEG;IACH,KAAK,EAAE,EAAW;IAClB,kBAAkB,EAAE,gBAAgB,EAAE,0CAA0C;IAChF,YAAY,EAAE,gCAAgC,EAAE,0CAA0C;CAClF,CAAC;AAEE,QAAA,SAAS,GAAe;IACnC,YAAY,EAAZ,oBAAY;CACb,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":";;;AAAA,8CAA2C;AAI9B,QAAA,YAAY,GAAyB,MAAM,CAAC,MAAM,CAAC;IAC9D;;OAEG;IACH,KAAK,EAAE,EAAW;IAClB,kBAAkB,EAAE,gBAAgB,EAAE,0CAA0C;IAChF,YAAY,EAAE,gCAAgC,EAAE,0CAA0C;CAClF,CAAC,CAAC;AAEL,MAAM,eAAe,GAGV,CAAC,UAAkB,EAAE,SAA+B,EAAE,EAAE;IACxE,MAAM,MAAM,GAAG;QACb;;WAEG;QACH,kCAAkC,EAAE,GAAY,EAAE,YAAY;QAC9D;;WAEG;QACH,gCAAgC,EAAE,GAAY,EAAE,YAAY;QAE5D;;WAEG;QACH,wBAAwB,EAAE,KAAc,EAAE,aAAa;QAEvD;;WAEG;QACH,0BAA0B,EAAE,GAAY;QAExC;;WAEG;QACH,YAAY,EAAE,oBAAY;QAE1B;;WAEG;QACH,oBAAoB,EAAE,QAAiB,EAAE,sBAAsB;QAC/D;;WAEG;QACH,gBAAgB,EAAE,EAAW;QAC7B;;WAEG;QACH,YAAY,EAAE,EAAW;QACzB;;WAEG;QACH,iBAAiB,EAAE,OAAgB;QACnC;;WAEG;QACH,iBAAiB,EAAE,WAAI,CAAC,KAAc;QACtC;;WAEG;QACH,kBAAkB,EAAE,SAAS,UAAU,EAAW;QAClD;;WAEG;QACH,UAAU,EAAE,WAAI,CAAC,MAAe;QAChC;;WAEG;QACH,WAAW,EAAE,QAAQ,UAAU,EAAW;QAC1C;;WAEG;QACH,UAAU,EAAE,MAAe;QAC3B;;WAEG;QACH,UAAU,EAAE,WAAI,CAAC,MAAe;QAChC;;WAEG;QACH,UAAU,EAAE,QAAiB;QAC7B;;WAEG;QACH,WAAW,EAAE,UAAU,UAAU,EAAW;QAC5C;;WAEG;QACH,iBAAiB,EAAE,CAAU;QAC7B;;WAEG;QACH,iBAAiB,EAAE,EAAW;QAC9B;;WAEG;QACH,aAAa,EAAE,qBAAqB;QACpC;;WAEG;QACH,iBAAiB,EAAE,CAAU;QAC7B;;WAEG;QACH,aAAa,EACX,kHAAkH;QACpH;;;WAGG;QACH,aAAa,EACX,iGAAiG;QACnG;;WAEG;QACH,SAAS,EAAE,gBAAgB;QAC3B;;WAEG;QACH,wBAAwB,EAAE,MAAe,EAAE,4BAA4B;QACvE;;WAEG;QACH,+BAA+B,EAAE,CAAU;QAC3C,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC;KACZ,CAAC;IAEX,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;AAC/B,CAAC,CAAC;AAxHW,QAAA,eAAe,mBAwH1B;AAEW,QAAA,SAAS,GAAG,IAAA,uBAAe,EAAC,WAAW,CAAC,CAAC"}

package/dist/interfaces/constants.d.ts

@@ -1,5 +1,109 @@
 import { IBackupCodeConstants } from './backup-code-consts';
 export interface IConstants {
+    /**
+     * Backup code related constants
+     */
     BACKUP_CODES: IBackupCodeConstants;
+    /**
+     * Duration in milliseconds for a login challenge
+     */
+    LoginChallengeExpiration: number;
+    /**
+     * Default duration in seconds for which mnemonics are kept in memory
+     */
+    DefaultExpireMemoryMnemonicSeconds: number;
+    /**
+     * Default duration in seconds for which wallets are kept in memory
+     */
+    DefaultExpireMemoryWalletSeconds: number;
+    /**
+     * The expected length of a direct login challenge in bytes
+     */
+    DirectLoginChallengeLength: number;
+    /**
+     * Duration in milliseconds for which an email token is valid.
+     */
+    EmailTokenExpiration: number;
+    /**
+     * Length in bytes of the email token generated (is represented as a hex string of twice as many)
+     */
+    EmailTokenLength: number;
+    /**
+     * Number of rounds for bcrypt hashing. Higher values increase security but also consume more CPU resources.
+     */
+    BcryptRounds: number;
+    /**
+     * The username of the administrator user.
+     */
+    AdministratorUser: string;
+    /**
+     * The name of the administrator role.
+     */
+    AdministratorRole: string;
+    /**
+     * The email of the administrator user/admin contact
+     */
+    AdministratorEmail: string;
+    /**
+     * The name of the member role.
+     */
+    MemberRole: string;
+    /**
+     * The email of the test user.
+     */
+    MemberEmail: string;
+    /**
+     * The username of the test user.
+     */
+    MemberUser: string;
+    /**
+     * The name of the system role.
+     */
+    SystemRole: string;
+    /**
+     * The username of the system user.
+     */
+    SystemUser: string;
+    /**
+     * The email of the system user.
+     */
+    SystemEmail: string;
+    /**
+     * Minimum username length
+     */
+    UsernameMinLength: number;
+    /**
+     * Maximum username length
+     */
+    UsernameMaxLength: number;
+    /**
+     * The regular expression for valid usernames.
+     */
+    UsernameRegex: RegExp;
+    /**
+     * Minimum password length
+     */
+    PasswordMinLength: number;
+    /**
+     * The regular expression for valid passwords.
+     */
+    PasswordRegex: RegExp;
+    /**
+     * The regular expression for valid mnemonic phrases.
+     * BIP39
+     */
+    MnemonicRegex: RegExp;
+    /**
+     * The regular expression for valid HMAC keys.
+     */
+    HmacRegex: RegExp;
+    /**
+     * The amount of time in milliseconds after which an email token can be resent.
+     */
+    EmailTokenResendInterval: number;
+    /**
+     * The interval in minutes after which an email token can be resent.
+     */
+    EmailTokenResendIntervalMinutes: number;
 }
 //# sourceMappingURL=constants.d.ts.map

package/dist/interfaces/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/interfaces/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB,YAAY,EAAE,oBAAoB,CAAC;CACpC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../src/interfaces/constants.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAE5D,MAAM,WAAW,UAAU;IACzB;;OAEG;IACH,YAAY,EAAE,oBAAoB,CAAC;IACnC;;OAEG;IACH,wBAAwB,EAAE,MAAM,CAAC;IACjC;;OAEG;IACH,kCAAkC,EAAE,MAAM,CAAC;IAC3C;;OAEG;IACH,gCAAgC,EAAE,MAAM,CAAC;IACzC;;OAEG;IACH,0BAA0B,EAAE,MAAM,CAAC;IACnC;;OAEG;IACH,oBAAoB,EAAE,MAAM,CAAC;IAC7B;;OAEG;IACH,gBAAgB,EAAE,MAAM,CAAC;IACzB;;OAEG;IACH,YAAY,EAAE,MAAM,CAAC;IACrB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,kBAAkB,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,UAAU,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,WAAW,EAAE,MAAM,CAAC;IACpB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,iBAAiB,EAAE,MAAM,CAAC;IAC1B;;OAEG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;;OAGG;IACH,aAAa,EAAE,MAAM,CAAC;IACtB;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAClB;;OAEG;IACH,wBAAwB,EAAE,MAAM,CAAC;IACjC;;OAEG;IACH,+BAA+B,EAAE,MAAM,CAAC;CACzC"}

package/dist/interfaces/index.d.ts

@@ -1,6 +1,7 @@
 export * from './backup-code';
 export * from './backup-code-consts';
 export * from './bases';
+export * from './constants';
 export * from './dto';
 export * from './has-creation';
 export * from './has-creator';

package/dist/interfaces/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,sBAAsB,CAAC;AACrC,cAAc,SAAS,CAAC;AACxB,cAAc,aAAa,CAAC;AAC5B,cAAc,OAAO,CAAC;AACtB,cAAc,gBAAgB,CAAC;AAC/B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,mBAAmB,CAAC;AAClC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC"}

package/dist/interfaces/index.js

@@ -17,6 +17,7 @@ Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./backup-code"), exports);
 __exportStar(require("./backup-code-consts"), exports);
 __exportStar(require("./bases"), exports);
+__exportStar(require("./constants"), exports);
 __exportStar(require("./dto"), exports);
 __exportStar(require("./has-creation"), exports);
 __exportStar(require("./has-creator"), exports);

package/dist/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,uDAAqC;AACrC,0CAAwB;AACxB,wCAAsB;AACtB,iDAA+B;AAC/B,gDAA8B;AAC9B,2CAAyB;AACzB,oDAAkC;AAClC,qDAAmC;AACnC,yDAAuC;AACvC,mDAAiC;AACjC,gDAA8B;AAC9B,gDAA8B;AAC9B,2CAAyB"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,gDAA8B;AAC9B,uDAAqC;AACrC,0CAAwB;AACxB,8CAA4B;AAC5B,wCAAsB;AACtB,iDAA+B;AAC/B,gDAA8B;AAC9B,2CAAyB;AACzB,oDAAkC;AAClC,qDAAmC;AACnC,yDAAuC;AACvC,mDAAiC;AACjC,gDAA8B;AAC9B,gDAA8B;AAC9B,2CAAyB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@digitaldefiance/suite-core-lib",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Generic user system and document system common core for applications",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",