@digitaldefiance/suite-core-lib 1.3.27 → 2.1.3

package/README.md

@@ -247,7 +247,76 @@ The **@digitaldefiance/node-ecies** and **@digitaldefiance/node-express-suite**
 - Mobile and desktop SDKs for React Native, Flutter, Electron, and Tauri
 - DevOps and deployment tooling including Docker, Kubernetes, and CI/CD pipelines
 
-## 🧪 Testing & Quality
+## 🆕 What's New in v2.1
+
+### New Modules
+
+#### Builders - Fluent APIs
+```typescript
+import { UserBuilder, RoleBuilder } from '@digitaldefiance/suite-core-lib';
+
+const user = UserBuilder.create()
+  .withUsername('admin')
+  .withEmail('admin@example.com')
+  .withEmailVerified(true)
+  .build();
+
+const role = RoleBuilder.create()
+  .withName(Role.Admin)
+  .asAdmin()
+  .build();
+```
+
+#### Core - Result Pattern & Type Exports
+```typescript
+import { Result, success, failure, isSuccess } from '@digitaldefiance/suite-core-lib';
+
+function processUser(id: string): Result<User, UserNotFoundError> {
+  const user = findUser(id);
+  return user ? success(user) : failure(new UserNotFoundError(id));
+}
+
+if (isSuccess(result)) {
+  console.log('User:', result.data);
+} else {
+  console.error('Error:', result.error);
+}
+```
+
+#### Lib - Validators & Formatters
+```typescript
+import { 
+  isValidUsername, 
+  isValidEmail, 
+  isValidPassword,
+  createValidators,
+  createConstants 
+} from '@digitaldefiance/suite-core-lib';
+
+// Use default validators with built-in constants
+if (!isValidUsername('test123')) {
+  throw new InvalidUsernameError('test123');
+}
+
+// Create validators with custom constants
+const myConstants = createConstants('myapp.com', {
+  UsernameRegex: /^[a-z0-9_]{4,20}$/,
+  UsernameMinLength: 4,
+  UsernameMaxLength: 20,
+});
+
+const validators = createValidators(myConstants);
+if (!validators.isValidUsername('user_name')) {
+  throw new Error('Invalid username');
+}
+```
+
+### Improved Architecture
+
+- **70% Code Reduction**: `TranslatableSuiteHandleableError` now extends i18n-lib base classes
+- **Organized Structure**: New `builders/`, `core/`, `lib/` folders
+- **Custom Constants**: Validators accept custom `IConstants` for flexibility
+- **Better Type Safety**: Enhanced TypeScript types throughout
 
 ## 🛠️ Runtime Configuration Registry
 
@@ -283,15 +352,24 @@ All constants are immutable and accessible via the registry/config API. See `src
 # Run the comprehensive test suite
 yarn test
 
-# 104 tests covering:
+# 409 tests covering:
 # ✅ Type safety and interface validation
 # ✅ Cryptographic security functions  
 # ✅ Multi-language localization
 # ✅ Error handling and edge cases
 # ✅ Integration scenarios
-# ✅ Performance benchmarks
+# ✅ Builders and fluent APIs
+# ✅ Result pattern and core utilities
+# ✅ Validators with custom constants
 ```
 
+### Coverage Metrics (v2.1.3)
+
+- **Statements**: 98.47%
+- **Branches**: 94.56%
+- **Functions**: 88.09%
+- **Lines**: 98.63%
+
 ## 🤝 Contributing
 
 We welcome contributions to help build the future of secure user management! Areas where contributions are especially appreciated:
@@ -326,6 +404,42 @@ MIT © [Digital Defiance](https://github.com/digitaldefiance)
 
 ## ChangeLog
 
+## V2.1.3: New Modules & Architecture Improvements
+
+### New Features
+ - **Builders Module**: UserBuilder, RoleBuilder with fluent APIs
+ - **Core Module**: Result<T,E> pattern, type exports, error exports
+ - **Lib Module**: Validators, formatters, custom constants support
+ - **Custom Constants**: `createValidators(constants)` for flexible validation rules
+
+### Architecture Improvements
+ - TranslatableSuiteHandleableError extends i18n-lib base (70% code reduction)
+ - Organized folder structure: builders/, core/, lib/
+ - Enhanced type safety throughout
+
+### Quality Improvements
+ - 409 tests (was 313)
+ - 94.56% branch coverage (was 59.3%)
+ - 98.47% statement coverage (was 92.86%)
+ - 88.09% function coverage (was 67.53%)
+
+### Documentation
+ - Complete migration guide in [MIGRATION_V2.md](./docs/MIGRATION_V2.md)
+ - Comprehensive examples in [V2_IMPROVEMENTS_COMPLETE.md](./docs/V2_IMPROVEMENTS_COMPLETE.md)
+ - Final metrics in [V2_FINAL_SUMMARY.md](./docs/V2_FINAL_SUMMARY.md)
+
+### Breaking Changes
+ - **None** - 100% backwards compatible
+
+## V2.0.0: Major Version - Dependency Upgrades
+
+ - Upgraded all @digitaldefiance dependencies to v2.0
+   - @digitaldefiance/ecies-lib: 2.0.1
+   - @digitaldefiance/i18n-lib: 2.0.0
+   - @digitaldefiance/node-ecies-lib: 2.0.0
+ - No breaking API changes
+ - See [MIGRATION_V2.md](./docs/MIGRATION_V2.md) for upgrade guide
+
 ## V1.3.27: Upgrade i18n, ecies, version bump
 
  - Upgrade i18n, ecies, version bump

package/package.json

@@ -1,12 +1,16 @@
 {
   "name": "@digitaldefiance/suite-core-lib",
-  "version": "1.3.27",
+  "version": "2.1.3",
   "description": "Generic user system and document system common core for applications",
   "main": "src/index.js",
   "types": "src/index.d.ts",
   "scripts": {
     "build": "npx nx build digitaldefiance-suite-core-lib",
+    "build:stream": "npx nx build --outputStyle=stream digitaldefiance-suite-core-lib",
+    "build:logged": "npx nx build --outputStyle=stream digitaldefiance-suite-core-lib 2>&1 | ansifilter -o build.log",
     "test": "npx nx test digitaldefiance-suite-core-lib",
+    "test:stream": "npx nx test --outputStyle=stream digitaldefiance-suite-core-lib",
+    "test:logged": "npx nx test --outputStyle=stream digitaldefiance-suite-core-lib 2>&1 | ansifilter -o test.log",
     "lint": "npx nx lint digitaldefiance-suite-core-lib",
     "lint:fix": "npx nx lint digitaldefiance-suite-core-lib --fix",
     "prettier:check": "prettier --check 'src/**/*.{ts,tsx}'",
@@ -17,9 +21,8 @@
     "publish:public": "npm publish --access public"
   },
   "dependencies": {
-    "@digitaldefiance/ecies-lib": "1.3.27",
-    "@digitaldefiance/i18n-lib": "1.3.27",
-    "@digitaldefiance/node-ecies-lib": "1.3.27"
+    "@digitaldefiance/ecies-lib": "2.1.3",
+    "@digitaldefiance/i18n-lib": "2.1.1"
   },
   "files": [
     "src",

package/src/builders/index.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Builders module - fluent builders for common objects
+ */
+export * from './user-builder';
+export * from './role-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-suite-core-lib/src/builders/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,gBAAgB,CAAC;AAC/B,cAAc,gBAAgB,CAAC"}

package/src/builders/index.js

@@ -0,0 +1,9 @@
+"use strict";
+/**
+ * Builders module - fluent builders for common objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./user-builder"), exports);
+tslib_1.__exportStar(require("./role-builder"), exports);
+//# sourceMappingURL=index.js.map

package/src/builders/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/builders/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,yDAA+B;AAC/B,yDAA+B"}

package/src/builders/role-builder.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Fluent builder for creating role objects
+ */
+import { Role } from '../enumerations/role';
+import { IRoleBase } from '../interfaces/bases/role';
+/**
+ * Builder for creating role objects with fluent API
+ */
+export declare class RoleBuilder<I = string, D extends Date | string = Date> {
+    private data;
+    static create<I = string, D extends Date | string = Date>(): RoleBuilder<I, D>;
+    withName(name: Role): this;
+    asAdmin(): this;
+    asMember(): this;
+    asChild(): this;
+    asSystem(): this;
+    build(): Partial<IRoleBase<I, D, Role>>;
+}
+//# sourceMappingURL=role-builder.d.ts.map

package/src/builders/role-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"role-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/builders/role-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,IAAI;IACjE,OAAO,CAAC,IAAI,CAKV;IAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,IAAI,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;IAI9E,QAAQ,CAAC,IAAI,EAAE,IAAI,GAAG,IAAI;IAK1B,OAAO,IAAI,IAAI;IAQf,QAAQ,IAAI,IAAI;IAQhB,OAAO,IAAI,IAAI;IAQf,QAAQ,IAAI,IAAI;IAQhB,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC;CAGxC"}

package/src/builders/role-builder.js

@@ -0,0 +1,57 @@
+"use strict";
+/**
+ * Fluent builder for creating role objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RoleBuilder = void 0;
+/**
+ * Builder for creating role objects with fluent API
+ */
+class RoleBuilder {
+    data = {
+        admin: false,
+        member: false,
+        child: false,
+        system: false,
+    };
+    static create() {
+        return new RoleBuilder();
+    }
+    withName(name) {
+        this.data.name = name;
+        return this;
+    }
+    asAdmin() {
+        this.data.admin = true;
+        this.data.member = false;
+        this.data.child = false;
+        this.data.system = false;
+        return this;
+    }
+    asMember() {
+        this.data.admin = false;
+        this.data.member = true;
+        this.data.child = false;
+        this.data.system = false;
+        return this;
+    }
+    asChild() {
+        this.data.admin = false;
+        this.data.member = false;
+        this.data.child = true;
+        this.data.system = false;
+        return this;
+    }
+    asSystem() {
+        this.data.admin = false;
+        this.data.member = false;
+        this.data.child = false;
+        this.data.system = true;
+        return this;
+    }
+    build() {
+        return { ...this.data };
+    }
+}
+exports.RoleBuilder = RoleBuilder;
+//# sourceMappingURL=role-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"role-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/builders/role-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH;;GAEG;AACH,MAAa,WAAW;IACd,IAAI,GAAmC;QAC7C,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;QACb,KAAK,EAAE,KAAK;QACZ,MAAM,EAAE,KAAK;KACd,CAAC;IAEF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,WAAW,EAAQ,CAAC;IACjC,CAAC;IAED,QAAQ,CAAC,IAAU;QACjB,IAAI,CAAC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACtB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO;QACL,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC;QACvB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACzB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;CACF;AApDD,kCAoDC"}

package/src/builders/user-builder.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Fluent builder for creating user objects
+ */
+import { AccountStatus } from '../enumerations/account-status';
+import { IUserBase } from '../interfaces/bases/user';
+/**
+ * Builder for creating user objects with fluent API
+ */
+export declare class UserBuilder<I = string, D extends Date | string = Date, S extends string = string> {
+    private data;
+    static create<I = string, D extends Date | string = Date, S extends string = string>(): UserBuilder<I, D, S>;
+    withUsername(username: string): this;
+    withEmail(email: string): this;
+    withPublicKey(publicKey: string): this;
+    withTimezone(timezone: string): this;
+    withSiteLanguage(siteLanguage: S): this;
+    withEmailVerified(verified: boolean): this;
+    withAccountStatus(status: AccountStatus): this;
+    withDirectChallenge(enabled: boolean): this;
+    withMnemonicRecovery(recovery: string): this;
+    build(): Partial<IUserBase<I, D, S, AccountStatus>>;
+}
+//# sourceMappingURL=user-builder.d.ts.map

package/src/builders/user-builder.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"user-builder.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/builders/user-builder.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,SAAS,EAAE,MAAM,0BAA0B,CAAC;AAErD;;GAEG;AACH,qBAAa,WAAW,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM;IAC5F,OAAO,CAAC,IAAI,CAMV;IAEF,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,MAAM,EAAE,CAAC,SAAS,IAAI,GAAG,MAAM,GAAG,IAAI,EAAE,CAAC,SAAS,MAAM,GAAG,MAAM,KAAK,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IAI5G,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAK9B,aAAa,CAAC,SAAS,EAAE,MAAM,GAAG,IAAI;IAKtC,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAKpC,gBAAgB,CAAC,YAAY,EAAE,CAAC,GAAG,IAAI;IAKvC,iBAAiB,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAK1C,iBAAiB,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAK9C,mBAAmB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAK3C,oBAAoB,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI;IAK5C,KAAK,IAAI,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,aAAa,CAAC,CAAC;CAGpD"}

package/src/builders/user-builder.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * Fluent builder for creating user objects
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.UserBuilder = void 0;
+const account_status_1 = require("../enumerations/account-status");
+/**
+ * Builder for creating user objects with fluent API
+ */
+class UserBuilder {
+    data = {
+        emailVerified: false,
+        accountStatus: account_status_1.AccountStatus.Active,
+        directChallenge: false,
+        backupCodes: [],
+        timezone: 'UTC',
+    };
+    static create() {
+        return new UserBuilder();
+    }
+    withUsername(username) {
+        this.data.username = username;
+        return this;
+    }
+    withEmail(email) {
+        this.data.email = email;
+        return this;
+    }
+    withPublicKey(publicKey) {
+        this.data.publicKey = publicKey;
+        return this;
+    }
+    withTimezone(timezone) {
+        this.data.timezone = timezone;
+        return this;
+    }
+    withSiteLanguage(siteLanguage) {
+        this.data.siteLanguage = siteLanguage;
+        return this;
+    }
+    withEmailVerified(verified) {
+        this.data.emailVerified = verified;
+        return this;
+    }
+    withAccountStatus(status) {
+        this.data.accountStatus = status;
+        return this;
+    }
+    withDirectChallenge(enabled) {
+        this.data.directChallenge = enabled;
+        return this;
+    }
+    withMnemonicRecovery(recovery) {
+        this.data.mnemonicRecovery = recovery;
+        return this;
+    }
+    build() {
+        return { ...this.data };
+    }
+}
+exports.UserBuilder = UserBuilder;
+//# sourceMappingURL=user-builder.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"user-builder.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/builders/user-builder.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,mEAA+D;AAG/D;;GAEG;AACH,MAAa,WAAW;IACd,IAAI,GAA+C;QACzD,aAAa,EAAE,KAAK;QACpB,aAAa,EAAE,8BAAa,CAAC,MAAM;QACnC,eAAe,EAAE,KAAK;QACtB,WAAW,EAAE,EAAE;QACf,QAAQ,EAAE,KAAK;KAChB,CAAC;IAEF,MAAM,CAAC,MAAM;QACX,OAAO,IAAI,WAAW,EAAW,CAAC;IACpC,CAAC;IAED,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,SAAS,CAAC,KAAa;QACrB,IAAI,CAAC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACxB,OAAO,IAAI,CAAC;IACd,CAAC;IAED,aAAa,CAAC,SAAiB;QAC7B,IAAI,CAAC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,YAAY,CAAC,QAAgB;QAC3B,IAAI,CAAC,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QAC9B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,gBAAgB,CAAC,YAAe;QAC9B,IAAI,CAAC,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,QAAiB;QACjC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,QAAQ,CAAC;QACnC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,iBAAiB,CAAC,MAAqB;QACrC,IAAI,CAAC,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC;QACjC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,mBAAmB,CAAC,OAAgB;QAClC,IAAI,CAAC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC;QACpC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,oBAAoB,CAAC,QAAgB;QACnC,IAAI,CAAC,IAAI,CAAC,gBAAgB,GAAG,QAAQ,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC;IAED,KAAK;QACH,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;IAC1B,CAAC;CACF;AA7DD,kCA6DC"}

package/src/core/errors.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Core error class exports for suite-core-lib
+ */
+export { TranslatableSuiteError } from '../errors/translatable-suite';
+export { TranslatableSuiteHandleableError } from '../errors/translatable-suite-handleable';
+export { CoreTypedHandleableError } from '../errors/core-typed-handleable';
+export { UserNotFoundError } from '../errors/user-not-found';
+export { InvalidCredentialsError } from '../errors/invalid-credentials';
+export { InvalidEmailError } from '../errors/invalid-email';
+export { InvalidUsernameError } from '../errors/invalid-username';
+export { EmailInUseError } from '../errors/email-in-use';
+export { UsernameInUseError } from '../errors/username-in-use';
+export { GenericValidationError } from '../errors/generic-validation';
+//# sourceMappingURL=errors.d.ts.map

package/src/core/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC;AACtE,OAAO,EAAE,gCAAgC,EAAE,MAAM,yCAAyC,CAAC;AAC3F,OAAO,EAAE,wBAAwB,EAAE,MAAM,iCAAiC,CAAC;AAG3E,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,uBAAuB,EAAE,MAAM,+BAA+B,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAClE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,8BAA8B,CAAC"}

package/src/core/errors.js

@@ -0,0 +1,29 @@
+"use strict";
+/**
+ * Core error class exports for suite-core-lib
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GenericValidationError = exports.UsernameInUseError = exports.EmailInUseError = exports.InvalidUsernameError = exports.InvalidEmailError = exports.InvalidCredentialsError = exports.UserNotFoundError = exports.CoreTypedHandleableError = exports.TranslatableSuiteHandleableError = exports.TranslatableSuiteError = void 0;
+// Base error classes
+var translatable_suite_1 = require("../errors/translatable-suite");
+Object.defineProperty(exports, "TranslatableSuiteError", { enumerable: true, get: function () { return translatable_suite_1.TranslatableSuiteError; } });
+var translatable_suite_handleable_1 = require("../errors/translatable-suite-handleable");
+Object.defineProperty(exports, "TranslatableSuiteHandleableError", { enumerable: true, get: function () { return translatable_suite_handleable_1.TranslatableSuiteHandleableError; } });
+var core_typed_handleable_1 = require("../errors/core-typed-handleable");
+Object.defineProperty(exports, "CoreTypedHandleableError", { enumerable: true, get: function () { return core_typed_handleable_1.CoreTypedHandleableError; } });
+// Common error classes
+var user_not_found_1 = require("../errors/user-not-found");
+Object.defineProperty(exports, "UserNotFoundError", { enumerable: true, get: function () { return user_not_found_1.UserNotFoundError; } });
+var invalid_credentials_1 = require("../errors/invalid-credentials");
+Object.defineProperty(exports, "InvalidCredentialsError", { enumerable: true, get: function () { return invalid_credentials_1.InvalidCredentialsError; } });
+var invalid_email_1 = require("../errors/invalid-email");
+Object.defineProperty(exports, "InvalidEmailError", { enumerable: true, get: function () { return invalid_email_1.InvalidEmailError; } });
+var invalid_username_1 = require("../errors/invalid-username");
+Object.defineProperty(exports, "InvalidUsernameError", { enumerable: true, get: function () { return invalid_username_1.InvalidUsernameError; } });
+var email_in_use_1 = require("../errors/email-in-use");
+Object.defineProperty(exports, "EmailInUseError", { enumerable: true, get: function () { return email_in_use_1.EmailInUseError; } });
+var username_in_use_1 = require("../errors/username-in-use");
+Object.defineProperty(exports, "UsernameInUseError", { enumerable: true, get: function () { return username_in_use_1.UsernameInUseError; } });
+var generic_validation_1 = require("../errors/generic-validation");
+Object.defineProperty(exports, "GenericValidationError", { enumerable: true, get: function () { return generic_validation_1.GenericValidationError; } });
+//# sourceMappingURL=errors.js.map

package/src/core/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/errors.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,qBAAqB;AACrB,mEAAsE;AAA7D,4HAAA,sBAAsB,OAAA;AAC/B,yFAA2F;AAAlF,iJAAA,gCAAgC,OAAA;AACzC,yEAA2E;AAAlE,iIAAA,wBAAwB,OAAA;AAEjC,uBAAuB;AACvB,2DAA6D;AAApD,mHAAA,iBAAiB,OAAA;AAC1B,qEAAwE;AAA/D,8HAAA,uBAAuB,OAAA;AAChC,yDAA4D;AAAnD,kHAAA,iBAAiB,OAAA;AAC1B,+DAAkE;AAAzD,wHAAA,oBAAoB,OAAA;AAC7B,uDAAyD;AAAhD,+GAAA,eAAe,OAAA;AACxB,6DAA+D;AAAtD,qHAAA,kBAAkB,OAAA;AAC3B,mEAAsE;AAA7D,4HAAA,sBAAsB,OAAA"}

package/src/core/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Core module - central exports for common types and errors
+ */
+export * from './types';
+export * from './errors';
+export * from './result';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,UAAU,CAAC;AACzB,cAAc,UAAU,CAAC"}

package/src/core/index.js

@@ -0,0 +1,10 @@
+"use strict";
+/**
+ * Core module - central exports for common types and errors
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+tslib_1.__exportStar(require("./types"), exports);
+tslib_1.__exportStar(require("./errors"), exports);
+tslib_1.__exportStar(require("./result"), exports);
+//# sourceMappingURL=index.js.map

package/src/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/index.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAEH,kDAAwB;AACxB,mDAAyB;AACzB,mDAAyB"}

package/src/core/result.d.ts

@@ -0,0 +1,34 @@
+/**
+ * Result type pattern for better error handling
+ * Provides type-safe success/failure handling without exceptions
+ */
+export type Result<T, E = Error> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: E;
+};
+/**
+ * Create a successful result
+ */
+export declare function success<T>(data: T): Result<T, never>;
+/**
+ * Create a failed result
+ */
+export declare function failure<E>(error: E): Result<never, E>;
+/**
+ * Check if result is successful
+ */
+export declare function isSuccess<T, E>(result: Result<T, E>): result is {
+    success: true;
+    data: T;
+};
+/**
+ * Check if result is a failure
+ */
+export declare function isFailure<T, E>(result: Result<T, E>): result is {
+    success: false;
+    error: E;
+};
+//# sourceMappingURL=result.d.ts.map

package/src/core/result.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/result.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,MAAM,CAAC,CAAC,EAAE,CAAC,GAAG,KAAK,IAC3B;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAC;AAEjC;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,EAAE,KAAK,CAAC,CAEpD;AAED;;GAEG;AACH,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAErD;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,CAE1F;AAED;;GAEG;AACH,wBAAgB,SAAS,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAE5F"}

package/src/core/result.js

@@ -0,0 +1,35 @@
+"use strict";
+/**
+ * Result type pattern for better error handling
+ * Provides type-safe success/failure handling without exceptions
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.success = success;
+exports.failure = failure;
+exports.isSuccess = isSuccess;
+exports.isFailure = isFailure;
+/**
+ * Create a successful result
+ */
+function success(data) {
+    return { success: true, data };
+}
+/**
+ * Create a failed result
+ */
+function failure(error) {
+    return { success: false, error };
+}
+/**
+ * Check if result is successful
+ */
+function isSuccess(result) {
+    return result.success;
+}
+/**
+ * Check if result is a failure
+ */
+function isFailure(result) {
+    return !result.success;
+}
+//# sourceMappingURL=result.js.map

package/src/core/result.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"result.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/result.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AASH,0BAEC;AAKD,0BAEC;AAKD,8BAEC;AAKD,8BAEC;AA1BD;;GAEG;AACH,SAAgB,OAAO,CAAI,IAAO;IAChC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;AACjC,CAAC;AAED;;GAEG;AACH,SAAgB,OAAO,CAAI,KAAQ;IACjC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;AACnC,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAO,MAAoB;IAClD,OAAO,MAAM,CAAC,OAAO,CAAC;AACxB,CAAC;AAED;;GAEG;AACH,SAAgB,SAAS,CAAO,MAAoB;IAClD,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC;AACzB,CAAC"}

package/src/core/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Core type exports for suite-core-lib
+ */
+export type { IFailableResult } from '../interfaces/failable-result';
+export type { DeepPartial } from '../interfaces/deep-partial';
+export type { IHasId } from '../interfaces/has-id';
+export type { IHasTimestamps } from '../interfaces/has-timestamps';
+export type { IHasCreation } from '../interfaces/has-creation';
+export type { IHasUpdates } from '../interfaces/has-updates';
+export type { IHasSoftDelete } from '../interfaces/has-soft-delete';
+export type { IHasCreator } from '../interfaces/has-creator';
+export type { IHasUpdater } from '../interfaces/has-updater';
+export type { IHasSoftDeleter } from '../interfaces/has-soft-deleter';
+export type { IHasTimestampOwners } from '../interfaces/has-timestamp-owners';
+export type { ITokenUser } from '../interfaces/token-user';
+export type { BackupCodeString } from '../backup-code-string';
+//# sourceMappingURL=types.d.ts.map

package/src/core/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,YAAY,EAAE,eAAe,EAAE,MAAM,+BAA+B,CAAC;AACrE,YAAY,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AAG9D,YAAY,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AACnD,YAAY,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AACnE,YAAY,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC/D,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AACpE,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAC;AAC7D,YAAY,EAAE,eAAe,EAAE,MAAM,gCAAgC,CAAC;AACtE,YAAY,EAAE,mBAAmB,EAAE,MAAM,oCAAoC,CAAC;AAG9E,YAAY,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,YAAY,EAAE,gBAAgB,EAAE,MAAM,uBAAuB,CAAC"}

package/src/core/types.js

@@ -0,0 +1,6 @@
+"use strict";
+/**
+ * Core type exports for suite-core-lib
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/src/core/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../../packages/digitaldefiance-suite-core-lib/src/core/types.ts"],"names":[],"mappings":";AAAA;;GAEG"}

package/src/enumerations/suite-core-string-key.d.ts

@@ -37,6 +37,19 @@ export declare enum SuiteCoreStringKey {
     Error_MissingRequiredEnvironmentVariableTemplate = "error_missingRequiredEnvironmentVariableTemplate",
     Error_EmptyEnvironmentVariableTemplate = "error_emptyEnvironmentVariableTemplate",
     Error_RecursiveErrorHandlingDetected = "error_recursiveErrorHandlingDetected",
+    Error_SystemUserMustBeSystemMemberType = "error_systemUserMustBeSystemMemberType",
+    Error_MnemonicHmacSecretMustBe64CharHexString = "error_mnemonicHmacSecretMustBe64CharHexString",
+    Error_MnemonicEncryptionKeyMustBe64CharHexString = "error_mnemonicEncryptionKeyMustBe64CharHexString",
+    Error_AdminMnemonicMustBeValidMnemonicPhrase = "error_adminMnemonicMustBeValidMnemonicPhrase",
+    Error_MemberMnemonicMustBeValidMnemonicPhrase = "error_memberMnemonicMustBeValidMnemonicPhrase",
+    Error_Pbkdf2IterationsMustBeGreaterThanZero = "error_pbkdf2IterationsMustBeGreaterThanZero",
+    Error_InvalidCspOrHelmetOptionsProvided = "error_invalidCspOrHelmetOptionsProvided",
+    Error_EnvironmentIsRequired = "error_environmentIsRequired",
+    Error_ApiRouterFactoryIsRequired = "error_apiRouterFactoryIsRequired",
+    Error_SchemaMapFactoryIsRequired = "error_schemaMapFactoryIsRequired",
+    Error_DatabaseInitFunctionIsRequired = "error_databaseInitFunctionIsRequired",
+    Error_InitResultHashFunctionIsRequired = "error_initResultHashFunctionIsRequired",
+    Error_ServiceIsNotRegisteredTemplate = "error_serviceIsNotRegisteredTemplate",
     Validation_ValueIsRequired = "validation_valueIsRequired",
     Validation_ValueMustBeOneOfTheAvailableOptions = "validation_valueMustBeOneOfTheAvailableOptions",
     Admin_StartingDatabaseInitialization = "admin_startingDatabaseInitialization",