@explorins/pers-shared 2.1.40 → 2.1.42

package/dist/cjs/shared-lib/errors/technical-errors.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.OrchestrationError = exports.TechnicalError = void 0;
+exports.TechnicalError = void 0;
 const common_1 = require("@nestjs/common");
 const error_classification_enums_1 = require("./base/error-classification-enums");
 const error_codes_1 = require("./error-codes");
@@ -44,49 +44,4 @@ class TechnicalError extends common_1.HttpException {
     }
 }
 exports.TechnicalError = TechnicalError;
-/**
- * Orchestration errors that wrap other errors but preserve business context
- */
-class OrchestrationError extends common_1.HttpException {
-    operation;
-    originalError;
-    constructor(operation, originalError) {
-        // If the original error is a business error, preserve its HTTP status and message
-        const isBusinessError = originalError instanceof common_1.HttpException;
-        const status = isBusinessError ? originalError.getStatus() : common_1.HttpStatus.INTERNAL_SERVER_ERROR;
-        const response = isBusinessError ? originalError.getResponse() : {
-            code: error_codes_1.CommonErrorCodes.ORCHESTRATION_ERROR,
-            message: 'Operation failed',
-            timestamp: new Date().toISOString(),
-            category: 'ORCHESTRATION'
-        };
-        super(response, status);
-        this.operation = operation;
-        this.originalError = originalError;
-        this.name = this.constructor.name;
-    }
-    static isOrchestrationError(error) {
-        return error instanceof OrchestrationError;
-    }
-    /**
-     * Get the root business error if it exists
-     */
-    getRootBusinessError() {
-        let current = this.originalError;
-        while (current) {
-            if (current instanceof common_1.HttpException &&
-                current.getResponse?.()?.category === 'DOMAIN_RULE') {
-                return current;
-            }
-            if (current instanceof OrchestrationError) {
-                current = current.originalError;
-            }
-            else {
-                break;
-            }
-        }
-        return null;
-    }
-}
-exports.OrchestrationError = OrchestrationError;
 //# sourceMappingURL=technical-errors.js.map

package/dist/cjs/shared-lib/errors/technical-errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"technical-errors.js","sourceRoot":"","sources":["../../../../src/shared-lib/errors/technical-errors.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"technical-errors.js","sourceRoot":"","sources":["../../../../src/shared-lib/errors/technical-errors.ts"],"names":[],"mappings":";;;AAAA,2CAA2D;AAC3D,kFAAkE;AAClE,+CAAiD;AAEjD;;;GAGG;AACH,MAAa,cAAe,SAAQ,sBAAa;IAC/B,aAAa,CAAU;IACvB,aAAa,CAAS;IACtB,eAAe,CAAU;IAEzC,YACE,OAAe,EACf,aAAqB,EACrB,aAAsB,EACtB,aAAyB,mBAAU,CAAC,qBAAqB,EACzD,kBAA2B,IAAI;QAE/B,2EAA2E;QAC3E,MAAM,aAAa,GAAG,eAAe,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,8BAA8B,CAAC;QAEjF,KAAK,CACH;YACE,IAAI,EAAE,8BAAgB,CAAC,eAAe;YACtC,OAAO,EAAE,aAAa;YACtB,aAAa;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,0CAAa,CAAC,SAAS;SAClC,EACD,UAAU,CACX,CAAC;QAEF,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;QACnC,IAAI,CAAC,eAAe,GAAG,eAAe,CAAC;QACvC,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;IACpC,CAAC;IAED,MAAM,CAAC,gBAAgB,CAAC,KAAU;QAChC,OAAO,KAAK,YAAY,cAAc,CAAC;IACzC,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAe,EAAE,aAAsB;QACxD,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,mBAAU,CAAC,qBAAqB,EAAE,IAAI,CAAC,CAAC;IACvG,CAAC;IAED;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,OAAe,EAAE,aAAqB,EAAE,aAAsB;QAC1E,OAAO,IAAI,cAAc,CAAC,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,mBAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5G,CAAC;CACF;AAjDD,wCAiDC"}

package/dist/cjs/shared-lib/interfaces/jwt.payload.interface.d.ts

@@ -1,15 +1,37 @@
-import { ApiKeyType } from "../enum/api-key-type.enum";
-type JWTPayloadSub = 'PERS-Auth-Token';
-export interface JWTPayload {
-    sub: JWTPayloadSub | string;
-    providerContextId?: string;
+import { AccountOwnerType } from "../enum/owner-type.enum";
+import { IntegrationApiKeyType, ApiKeyType, AuthApiKeyType, BlockchainApiKeyType } from "../enum/api-key-type.enum";
+interface BaseJWTPayload {
+    sub: string;
     type: ApiKeyType;
     tenantId: string | null;
-    transactionId?: string | null;
-    userId: string | null;
-    adminId: string | null;
-    businessId?: string | null;
-    permissions?: string[];
+    accountType?: AccountOwnerType;
+}
+export interface AuthJWTPayload extends BaseJWTPayload {
+    sub: string;
+    type: AuthApiKeyType | IntegrationApiKeyType;
+    tenantId: string | null;
+    accountType: AccountOwnerType;
+    apiKeyId: string | null;
+    providerContextId?: string;
+}
+export interface ActionableJWTPayload extends BaseJWTPayload {
+    sub: string;
+    type: AuthApiKeyType;
+    tenantId: string | null;
+    accountType: AccountOwnerType;
+    transactionId: string | null;
+    providerContextId?: string;
+}
+export interface BlockchainJWTPayload extends BaseJWTPayload {
+    sub: string;
+    type: BlockchainApiKeyType;
+    tenantId: string | null;
+    accountType?: AccountOwnerType;
+    permissions: string[];
 }
+export type PersJWTPayload = AuthJWTPayload | ActionableJWTPayload | BlockchainJWTPayload;
+export declare function isAuthPayload(payload: PersJWTPayload): payload is AuthJWTPayload;
+export declare function isActionablePayload(payload: PersJWTPayload): payload is ActionableJWTPayload;
+export declare function isBlockchainPayload(payload: PersJWTPayload): payload is BlockchainJWTPayload;
 export {};
 //# sourceMappingURL=jwt.payload.interface.d.ts.map

package/dist/cjs/shared-lib/interfaces/jwt.payload.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.payload.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/jwt.payload.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvD,KAAK,aAAa,GAAG,iBAAiB,CAAC;AAEvC,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,aAAa,GAAG,MAAM,CAAC;IAC5B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAE9B,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;CACxB"}
+{"version":3,"file":"jwt.payload.interface.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/jwt.payload.interface.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,qBAAqB,EAAE,UAAU,EAAE,cAAc,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAwBpH,UAAU,cAAc;IACpB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,UAAU,CAAC;IACjB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,gBAAgB,CAAC;CAMlC;AAGD,MAAM,WAAW,cAAe,SAAQ,cAAc;IAClD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,GAAG,qBAAqB,CAAC;IAC7C,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,gBAAgB,CAAC;IAC9B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IAExB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAGD,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,cAAc,CAAC;IACrB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,EAAE,gBAAgB,CAAC;IAG9B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC9B;AAGD,MAAM,WAAW,oBAAqB,SAAQ,cAAc;IACxD,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,oBAAoB,CAAC;IAC3B,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,WAAW,CAAC,EAAE,gBAAgB,CAAC;IAG/B,WAAW,EAAE,MAAM,EAAE,CAAC;CACzB;AAOD,MAAM,MAAM,cAAc,GAAG,cAAc,GAAG,oBAAoB,GAAG,oBAAoB,CAAC;AAQ1F,wBAAgB,aAAa,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,cAAc,CAEhF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,oBAAoB,CAE5F;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,cAAc,GAAG,OAAO,IAAI,oBAAoB,CAE5F"}

package/dist/cjs/shared-lib/interfaces/jwt.payload.interface.js

@@ -1,4 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-;
+exports.isAuthPayload = isAuthPayload;
+exports.isActionablePayload = isActionablePayload;
+exports.isBlockchainPayload = isBlockchainPayload;
+// ===========================================
+// TYPE GUARDS & UTILITIES
+// ===========================================
+// Type guards for specific payload types
+function isAuthPayload(payload) {
+    return !('permissionss' in payload) && !('transactionId' in payload);
+}
+function isActionablePayload(payload) {
+    return 'transactionId' in payload && !('permissions' in payload);
+}
+function isBlockchainPayload(payload) {
+    return 'permissions' in payload;
+}
 //# sourceMappingURL=jwt.payload.interface.js.map

package/dist/cjs/shared-lib/interfaces/jwt.payload.interface.js.map

@@ -1 +1 @@
-{"version":3,"file":"jwt.payload.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/jwt.payload.interface.ts"],"names":[],"mappings":";;AAeG,CAAC"}
+{"version":3,"file":"jwt.payload.interface.js","sourceRoot":"","sources":["../../../../src/shared-lib/interfaces/jwt.payload.interface.ts"],"names":[],"mappings":";;AAoFA,sCAEC;AAED,kDAEC;AAED,kDAEC;AAhBD,8CAA8C;AAC9C,0BAA0B;AAC1B,8CAA8C;AAG9C,yCAAyC;AACzC,SAAgB,aAAa,CAAC,OAAuB;IACjD,OAAO,CAAC,CAAC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAuB;IACvD,OAAO,eAAe,IAAI,OAAO,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,SAAgB,mBAAmB,CAAC,OAAuB;IACvD,OAAO,aAAa,IAAI,OAAO,CAAC;AACpC,CAAC"}

package/dist/cjs/shared-lib/value-objects/account-selector.vo.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"account-selector.vo.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/account-selector.vo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAG5C,qBAAa,iBAAiB;IAGpB,WAAW,EAAE,gBAAgB,CAAC;IAI9B,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,cAAc,CAAC,EAAE,OAAO,CAAC;IAEjC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB;IAuC/D;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB;IAQ1D,MAAM,CAAC,oBAAoB,CAAC,WAAW,EAAE,gBAAgB,CAAC,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAOjI;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAOrD;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAO3D;;;OAGG;IACH,MAAM,CAAC,YAAY,IAAI,iBAAiB;gBAO9B,IAAI,EAAE,eAAe;IAQjC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAwB7B;;;OAGG;IACH,iBAAiB,IAAI,eAAe;CA+BrC"}
+{"version":3,"file":"account-selector.vo.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/account-selector.vo.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,gBAAgB,EAAE,MAAM,WAAW,CAAC;AAC7C,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAI5C,qBAAa,iBAAiB;IAGpB,WAAW,EAAE,gBAAgB,CAAC;IAI9B,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,cAAc,CAAC,EAAE,OAAO,CAAC;IAEjC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,kBAAkB,GAAG,iBAAiB;IAwC/D;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,GAAG,iBAAiB;IAQ1D,MAAM,CAAC,oBAAoB,CAAC,WAAW,EAAE,gBAAgB,CAAC,IAAI,GAAG,gBAAgB,CAAC,QAAQ,EAAE,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAOjI;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAOrD;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,iBAAiB;IAO3D;;;OAGG;IACH,MAAM,CAAC,YAAY,IAAI,iBAAiB;gBAO9B,IAAI,EAAE,eAAe;IAQjC;;;OAGG;IACH,OAAO,CAAC,qBAAqB;IAyB7B;;;OAGG;IACH,iBAAiB,IAAI,eAAe;CAgCrC"}

package/dist/cjs/shared-lib/value-objects/account-selector.vo.js

@@ -14,6 +14,7 @@ const class_transformer_1 = require("class-transformer");
 const class_validator_1 = require("class-validator");
 const enum_1 = require("./../enum");
 const address_value_object_1 = require("./address.value-object");
+const error_factory_1 = require("../../shared-patterns/errors/error-factory");
 class AccountSelectorVo {
     static fromDTO(selector) {
         // Create the appropriate AccountSelector based on accountType
@@ -22,7 +23,7 @@ class AccountSelectorVo {
             case enum_1.AccountOwnerType.USER:
             case enum_1.AccountOwnerType.BUSINESS:
                 if (!selector.accountId) {
-                    throw new Error(`${selector.accountType} account selector requires accountId`);
+                    throw error_factory_1.ErrorFactory.requiredField(`accountId for ${selector.accountType} account selector`);
                 }
                 accountSelectorData = {
                     accountType: selector.accountType,
@@ -31,7 +32,7 @@ class AccountSelectorVo {
                 break;
             case enum_1.AccountOwnerType.EXTERNAL:
                 if (!selector.accountAddress) {
-                    throw new Error('External account selector requires accountAddress');
+                    throw error_factory_1.ErrorFactory.requiredField('accountAddress for external account selector');
                 }
                 accountSelectorData = {
                     accountType: selector.accountType,
@@ -44,7 +45,8 @@ class AccountSelectorVo {
                 };
                 break;
             default:
-                throw new Error(`Unsupported account type: ${selector.accountType}`);
+                const accountTypeValue = selector.accountType === undefined ? 'undefined' : selector.accountType;
+                throw error_factory_1.ErrorFactory.invalidInput('accountType', `Unsupported account type: ${accountTypeValue}. Supported types: ${Object.values(enum_1.AccountOwnerType).join(', ')}`);
         }
         return new AccountSelectorVo(accountSelectorData);
     }
@@ -110,19 +112,20 @@ class AccountSelectorVo {
             case enum_1.AccountOwnerType.USER:
             case enum_1.AccountOwnerType.BUSINESS:
                 if (!this.accountId) {
-                    throw new Error(`${this.accountType} account selector requires accountId`);
+                    throw error_factory_1.ErrorFactory.requiredField(`accountId for ${this.accountType} account selector`);
                 }
                 break;
             case enum_1.AccountOwnerType.EXTERNAL:
                 if (!this.accountAddress) {
-                    throw new Error('External account selector requires accountAddress');
+                    throw error_factory_1.ErrorFactory.requiredField('accountAddress for external account selector');
                 }
                 break;
             case enum_1.AccountOwnerType.TENANT:
                 // Tenant context resolved from request - no validation needed
                 break;
             default:
-                throw new Error(`Unsupported account type: ${this.accountType}`);
+                const accountTypeValue = this.accountType === undefined ? 'undefined' : this.accountType;
+                throw error_factory_1.ErrorFactory.invalidInput('accountType', `Unsupported account type: ${accountTypeValue}. Supported types: ${Object.values(enum_1.AccountOwnerType).join(', ')}`);
         }
     }
     /**
@@ -134,7 +137,7 @@ class AccountSelectorVo {
             case enum_1.AccountOwnerType.USER:
             case enum_1.AccountOwnerType.BUSINESS:
                 if (!this.accountId) {
-                    throw new Error(`${this.accountType} account selector requires accountId`);
+                    throw error_factory_1.ErrorFactory.requiredField(`accountId for ${this.accountType} account selector`);
                 }
                 return {
                     accountType: this.accountType,
@@ -142,7 +145,7 @@ class AccountSelectorVo {
                 };
             case enum_1.AccountOwnerType.EXTERNAL:
                 if (!this.accountAddress) {
-                    throw new Error('EXTERNAL account selector requires accountAddress');
+                    throw error_factory_1.ErrorFactory.requiredField('accountAddress for external account selector');
                 }
                 return {
                     accountType: this.accountType,
@@ -154,7 +157,8 @@ class AccountSelectorVo {
                     accountType: this.accountType
                 };
             default:
-                throw new Error(`Unsupported account type: ${this.accountType}`);
+                const accountTypeValue = this.accountType === undefined ? 'undefined' : this.accountType;
+                throw error_factory_1.ErrorFactory.invalidInput('accountType', `Unsupported account type: ${accountTypeValue}. Supported types: ${Object.values(enum_1.AccountOwnerType).join(', ')}`);
         }
     }
 }

package/dist/cjs/shared-lib/value-objects/account-selector.vo.js.map

@@ -1 +1 @@
-{"version":3,"file":"account-selector.vo.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/account-selector.vo.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"account-selector.vo.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/account-selector.vo.ts"],"names":[],"mappings":";;;;;;;;;;;;AAAA,yDAAyC;AACzC,qDAA2F;AAC3F,oCAA6C;AAE7C,iEAAiD;AAEjD,8EAA0E;AAG1E,MAAa,iBAAiB;IAc5B,MAAM,CAAC,OAAO,CAAC,QAA4B;QACzC,8DAA8D;QAC9D,IAAI,mBAAoC,CAAC;QAEzC,QAAQ,QAAQ,CAAC,WAAW,EAAE,CAAC;YAC7B,KAAK,uBAAgB,CAAC,IAAI,CAAC;YAC3B,KAAK,uBAAgB,CAAC,QAAQ;gBAC5B,IAAI,CAAC,QAAQ,CAAC,SAAS,EAAE,CAAC;oBACxB,MAAM,4BAAY,CAAC,aAAa,CAAC,iBAAiB,QAAQ,CAAC,WAAW,mBAAmB,CAAC,CAAC;gBAC7F,CAAC;gBACD,mBAAmB,GAAG;oBACpB,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,SAAS,EAAE,QAAQ,CAAC,SAAS;iBAC9B,CAAC;gBACF,MAAM;YAER,KAAK,uBAAgB,CAAC,QAAQ;gBAC5B,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE,CAAC;oBAC7B,MAAM,4BAAY,CAAC,aAAa,CAAC,8CAA8C,CAAC,CAAC;gBACnF,CAAC;gBACD,mBAAmB,GAAG;oBACpB,WAAW,EAAE,QAAQ,CAAC,WAAW;oBACjC,cAAc,EAAE,QAAQ,CAAC,cAAc;iBACxC,CAAC;gBACF,MAAM;YAER,KAAK,uBAAgB,CAAC,MAAM;gBAC1B,mBAAmB,GAAG;oBACpB,WAAW,EAAE,QAAQ,CAAC,WAAW;iBAClC,CAAC;gBACF,MAAM;YAER;gBACE,MAAM,gBAAgB,GAAG,QAAQ,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC;gBACjG,MAAM,4BAAY,CAAC,YAAY,CAAC,aAAa,EAAE,6BAA6B,gBAAgB,sBAAsB,MAAM,CAAC,MAAM,CAAC,uBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpK,CAAC;QAED,OAAO,IAAI,iBAAiB,CAAC,mBAAmB,CAAC,CAAC;IACpD,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,OAAgB;QACpC,OAAO,IAAI,iBAAiB,CAAC;YAC3B,WAAW,EAAE,uBAAgB,CAAC,QAAQ;YACtC,cAAc,EAAE,OAAO,CAAC,QAAQ,EAAE;YAClC,gCAAgC;SACjC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,CAAC,oBAAoB,CAAC,WAA8D,EAAE,SAAiB;QAC3G,OAAO,IAAI,iBAAiB,CAAC;YAC3B,WAAW,EAAE,WAAW;YACxB,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;IACL,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,UAAU,CAAC,SAAiB;QACjC,OAAO,IAAI,iBAAiB,CAAC;YAC3B,WAAW,EAAE,uBAAgB,CAAC,IAAI;YAClC,SAAS,EAAE,SAAS;SACrB,CAAC,CAAC;IACL,CAAC;IAEC;;;OAGG;IACH,MAAM,CAAC,cAAc,CAAC,SAAiB;QACnC,OAAO,IAAI,iBAAiB,CAAC;YAC7B,WAAW,EAAE,uBAAgB,CAAC,QAAQ;YACtC,SAAS,EAAE,SAAS;SACnB,CAAC,CAAC;IACP,CAAC;IAED;;;OAGG;IACH,MAAM,CAAC,YAAY;QACf,OAAO,IAAI,iBAAiB,CAAC;YAC7B,WAAW,EAAE,uBAAgB,CAAC,MAAM;YACpC,6DAA6D;SAC5D,CAAC,CAAC;IACP,CAAC;IAEH,YAAY,IAAqB;QAC/B,IAAI,CAAC,WAAW,GAAG,IAAI,CAAC,WAAW,CAAC;QACpC,IAAI,CAAC,SAAS,GAAG,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;QAClE,IAAI,CAAC,cAAc,GAAG,gBAAgB,IAAI,IAAI,CAAC,CAAC,CAAC,IAAI,8BAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;QAE9F,IAAI,CAAC,qBAAqB,EAAE,CAAC;IAC/B,CAAC;IAED;;;OAGG;IACK,qBAAqB;QAC3B,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;YACzB,KAAK,uBAAgB,CAAC,IAAI,CAAC;YAC3B,KAAK,uBAAgB,CAAC,QAAQ;gBAC5B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,MAAM,4BAAY,CAAC,aAAa,CAAC,iBAAiB,IAAI,CAAC,WAAW,mBAAmB,CAAC,CAAC;gBACzF,CAAC;gBACD,MAAM;YAER,KAAK,uBAAgB,CAAC,QAAQ;gBAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;oBACzB,MAAM,4BAAY,CAAC,aAAa,CAAC,8CAA8C,CAAC,CAAC;gBACnF,CAAC;gBACD,MAAM;YAER,KAAK,uBAAgB,CAAC,MAAM;gBAC1B,8DAA8D;gBAC9D,MAAM;YAER;gBACE,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;gBACzF,MAAM,4BAAY,CAAC,YAAY,CAAC,aAAa,EAAE,6BAA6B,gBAAgB,sBAAsB,MAAM,CAAC,MAAM,CAAC,uBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpK,CAAC;IACH,CAAC;IAED;;;OAGG;IACH,iBAAiB;QACf,QAAQ,IAAI,CAAC,WAAW,EAAE,CAAC;YACzB,KAAK,uBAAgB,CAAC,IAAI,CAAC;YAC3B,KAAK,uBAAgB,CAAC,QAAQ;gBAC5B,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC;oBACpB,MAAM,4BAAY,CAAC,aAAa,CAAC,iBAAiB,IAAI,CAAC,WAAW,mBAAmB,CAAC,CAAC;gBACzF,CAAC;gBACD,OAAO;oBACL,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,SAAS,EAAE,IAAI,CAAC,SAAS;iBAC1B,CAAC;YAEJ,KAAK,uBAAgB,CAAC,QAAQ;gBAC5B,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;oBACzB,MAAM,4BAAY,CAAC,aAAa,CAAC,8CAA8C,CAAC,CAAC;gBACnF,CAAC;gBACD,OAAO;oBACL,WAAW,EAAE,IAAI,CAAC,WAAW;oBAC7B,cAAc,EAAE,IAAI,CAAC,cAAc,CAAC,QAAQ,EAAE;iBAC/C,CAAC;YAEJ,KAAK,uBAAgB,CAAC,MAAM,CAAC;YAC7B,KAAK,uBAAgB,CAAC,MAAM;gBAC1B,OAAO;oBACL,WAAW,EAAE,IAAI,CAAC,WAAW;iBAC9B,CAAC;YAEJ;gBACE,MAAM,gBAAgB,GAAG,IAAI,CAAC,WAAW,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,WAAW,CAAC;gBACzF,MAAM,4BAAY,CAAC,YAAY,CAAC,aAAa,EAAE,6BAA6B,gBAAgB,sBAAsB,MAAM,CAAC,MAAM,CAAC,uBAAgB,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACpK,CAAC;IACH,CAAC;CACF;AAnLD,8CAmLC;AAhLS;IAFP,IAAA,wBAAM,EAAC,uBAAgB,CAAC;IACxB,IAAA,4BAAU,GAAE;;sDACyB;AAI9B;IAFP,IAAA,0BAAQ,GAAE;IACV,IAAA,4BAAU,GAAE;;oDACc;AAKnB;IAHP,IAAA,gCAAc,GAAE;IAChB,IAAA,wBAAI,EAAC,GAAG,EAAE,CAAC,8BAAO,CAAC;IACnB,IAAA,4BAAU,GAAE;8BACY,8BAAO;yDAAC"}

package/dist/cjs/shared-lib/value-objects/address.value-object.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"address.value-object.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/address.value-object.ts"],"names":[],"mappings":"AAEA,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,EAAE,MAAM;IAOzB,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B,OAAO,CAAC,cAAc;CAIvB"}
+{"version":3,"file":"address.value-object.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/address.value-object.ts"],"names":[],"mappings":"AAIA,qBAAa,OAAO;IAChB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAS;gBAEnB,KAAK,EAAE,MAAM;IAOzB,QAAQ,IAAI,MAAM;IAIlB,MAAM,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO;IAI/B,OAAO,CAAC,cAAc;CAIvB"}

package/dist/cjs/shared-lib/value-objects/address.value-object.js

@@ -1,11 +1,12 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Address = void 0;
+const error_factory_1 = require("../../shared-patterns/errors/error-factory");
 class Address {
     value;
     constructor(value) {
         if (!this.isValidAddress(value)) {
-            throw new Error('Invalid address for value: ' + value);
+            throw error_factory_1.ErrorFactory.invalidFormat('address', `Valid Ethereum address (0x + 40 hex characters). Received: "${value}" with length ${value?.length || 0}`);
         }
         this.value = value;
     }

package/dist/cjs/shared-lib/value-objects/address.value-object.js.map

@@ -1 +1 @@
-{"version":3,"file":"address.value-object.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/address.value-object.ts"],"names":[],"mappings":";;;AAEA,MAAa,OAAO;IACC,KAAK,CAAS;IAE/B,YAAY,KAAa;QACvB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CAAC,6BAA6B,GAAG,KAAK,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,KAAc;QACnB,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,yEAAyE;QACzE,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;CACF;AAtBH,0BAsBG"}
+{"version":3,"file":"address.value-object.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/address.value-object.ts"],"names":[],"mappings":";;;AAEA,8EAA0E;AAE1E,MAAa,OAAO;IACC,KAAK,CAAS;IAE/B,YAAY,KAAa;QACvB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,4BAAY,CAAC,aAAa,CAAC,SAAS,EAAE,+DAA+D,KAAK,iBAAiB,KAAK,EAAE,MAAM,IAAI,CAAC,EAAE,CAAC,CAAC;QACzJ,CAAC;QACD,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;IAED,QAAQ;QACN,OAAO,IAAI,CAAC,KAAK,CAAC;IACpB,CAAC;IAED,MAAM,CAAC,KAAc;QACnB,OAAO,IAAI,CAAC,KAAK,KAAK,KAAK,CAAC,KAAK,CAAC;IACpC,CAAC;IAEO,cAAc,CAAC,KAAa;QAClC,yEAAyE;QACzE,OAAO,KAAK,CAAC,MAAM,KAAK,EAAE,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACvD,CAAC;CACF;AAtBH,0BAsBG"}

package/dist/cjs/shared-patterns/errors/error-factory.d.ts

@@ -0,0 +1,150 @@
+import { UserNotFoundError, BusinessNotFoundError, TokenNotFoundError, TransactionNotFoundError, AuthenticationRequiredError, InvalidTokenError, TokenExpiredError, AuthorizationFailedError, InsufficientBalanceError, InvalidInputError, RequiredFieldError, InvalidFormatError, SystemError, ExternalServiceError, ConfigurationMissingError, TokenNotActiveError, TokenIdRequiredError, TokenTypeNotFoundError, TokenUnitNotFoundError, TransactionAlreadyCompletedError, TransactionNotPendingError, TransactionValidationError, SigningAccountValidationError, SigningAccountNotFoundError, SigningAccountAlreadyExistsError, KeyGenerationError, CampaignNotFoundError, GeographicRestrictionError, LocationVerificationRequiredError, RedemptionLimitReachedError, UserStatusRestrictedError, WalletNotFoundError, WalletMissingSigningError, SmartWalletProcessingError, BusinessNotMinterError, UnexpectedValidationScenarioError } from '../../shared-lib/errors';
+/**
+ * Universal Error Factory for NestJS Applications
+ *
+ * This factory provides a clean, discoverable API for creating errors while
+ * maintaining the domain error classes as the single source of truth.
+ *
+ * Architecture:
+ * - Domain files define canonical error classes (exported as types for frontend)
+ * - Factory methods instantiate these domain classes (no duplication)
+ * - NestJS apps use factory for clean developer experience
+ * - Frontend devs import types from domain classes
+ */
+export declare class ErrorFactory {
+    /**
+     * Resource "not found" patterns
+     * Uses domain classes internally for consistency
+     */
+    static userNotFound(identifier: string): UserNotFoundError;
+    static businessNotFound(identifier: string): BusinessNotFoundError;
+    static tokenNotFound(tokenId: string): TokenNotFoundError;
+    static transactionNotFound(transactionId: string): TransactionNotFoundError;
+    static campaignNotFound(campaignId: string): CampaignNotFoundError;
+    static tokenUnitNotFound(tokenUnitId?: string): TokenUnitNotFoundError;
+    /**
+     * Authentication & Authorization patterns
+     */
+    static authRequired(resource?: string): AuthenticationRequiredError;
+    static invalidToken(reason?: string): InvalidTokenError;
+    static tokenExpired(): TokenExpiredError;
+    static forbidden(action: string, resource: string): AuthorizationFailedError;
+    /**
+     * Business rule patterns
+     */
+    static geographicRestriction(countryCode: string, resource?: string): GeographicRestrictionError;
+    static locationRequired(resource?: string): LocationVerificationRequiredError;
+    static limitReached(limitType: 'max_redemption' | 'user_limit'): RedemptionLimitReachedError;
+    static userStatusRestricted(): UserStatusRestrictedError;
+    /**
+     * Validation patterns
+     */
+    static invalidInput(field: string, reason?: string): InvalidInputError;
+    static requiredField(field: string): RequiredFieldError;
+    static invalidFormat(field: string, expectedFormat: string): InvalidFormatError;
+    /**
+     * Financial/Balance patterns
+     */
+    static insufficientBalance(required: string, available: string): InsufficientBalanceError;
+    /**
+     * Technical/Infrastructure patterns
+     */
+    static systemError(operation: string, details: string): SystemError;
+    static externalServiceError(serviceName: string, operation: string): ExternalServiceError;
+    static configMissing(configKey: string): ConfigurationMissingError;
+    /**
+     * Token-specific patterns
+     */
+    static tokenNotActive(tokenId: string): TokenNotActiveError;
+    static tokenIdRequired(tokenType: string): TokenIdRequiredError;
+    static tokenTypeNotFound(tokenType: string): TokenTypeNotFoundError;
+    /**
+     * Transaction-specific patterns
+     */
+    static transactionAlreadyCompleted(transactionId: string, currentStatus: string): TransactionAlreadyCompletedError;
+    static transactionNotPending(transactionId: string, currentStatus: string): TransactionNotPendingError;
+    static transactionValidation(field: string, reason: string): TransactionValidationError;
+    /**
+     * Signing account patterns
+     */
+    static signingAccountValidation(field: string, reason: string): SigningAccountValidationError;
+    static signingAccountNotFound(identifier: string): SigningAccountNotFoundError;
+    static signingAccountAlreadyExists(accountAddress: string): SigningAccountAlreadyExistsError;
+    static keyGeneration(reason: string): KeyGenerationError;
+    /**
+     * Wallet patterns
+     */
+    static walletNotFound(ownerAddress: string): WalletNotFoundError;
+    static walletMissingSigning(walletAddress: string, reason: string): WalletMissingSigningError;
+    static smartWalletProcessing(reason: string): SmartWalletProcessingError;
+    /**
+     * Business patterns
+     */
+    static businessNotMinter(businessId: string, tokenAddress: string): BusinessNotMinterError;
+    /**
+     * Validation patterns
+     */
+    static unexpectedValidationScenario(context: string): UnexpectedValidationScenarioError;
+}
+/**
+ * Convenient shortcut object for the most commonly used error patterns
+ * Provides clean, discoverable API for NestJS applications
+ */
+export declare const Errors: {
+    userNotFound: (id: string) => UserNotFoundError;
+    businessNotFound: (id: string) => BusinessNotFoundError;
+    tokenNotFound: (id: string) => TokenNotFoundError;
+    tokenUnitNotFound: (id?: string) => TokenUnitNotFoundError;
+    transactionNotFound: (id: string) => TransactionNotFoundError;
+    campaignNotFound: (id: string) => CampaignNotFoundError;
+    authRequired: (resource?: string) => AuthenticationRequiredError;
+    invalidToken: (reason?: string) => InvalidTokenError;
+    tokenExpired: () => TokenExpiredError;
+    forbidden: (action: string, resource: string) => AuthorizationFailedError;
+    geographicRestriction: (countryCode: string, resource?: string) => GeographicRestrictionError;
+    locationRequired: (resource?: string) => LocationVerificationRequiredError;
+    limitReached: (limitType: "max_redemption" | "user_limit") => RedemptionLimitReachedError;
+    userStatusRestricted: () => UserStatusRestrictedError;
+    invalidInput: (field: string, reason?: string) => InvalidInputError;
+    requiredField: (field: string) => RequiredFieldError;
+    invalidFormat: (field: string, format: string) => InvalidFormatError;
+    insufficientBalance: (required: string, available: string) => InsufficientBalanceError;
+    systemError: (operation: string, details: string) => SystemError;
+    externalServiceError: (service: string, operation: string) => ExternalServiceError;
+    configMissing: (key: string) => ConfigurationMissingError;
+    tokenNotActive: (id: string) => TokenNotActiveError;
+    tokenIdRequired: (type: string) => TokenIdRequiredError;
+    tokenTypeNotFound: (type: string) => TokenTypeNotFoundError;
+    transactionAlreadyCompleted: (id: string, status: string) => TransactionAlreadyCompletedError;
+    transactionNotPending: (id: string, status: string) => TransactionNotPendingError;
+    transactionValidation: (field: string, reason: string) => TransactionValidationError;
+    signingAccountValidation: (field: string, reason: string) => SigningAccountValidationError;
+    signingAccountNotFound: (id: string) => SigningAccountNotFoundError;
+    signingAccountAlreadyExists: (address: string) => SigningAccountAlreadyExistsError;
+    keyGeneration: (reason: string) => KeyGenerationError;
+    walletNotFound: (address: string) => WalletNotFoundError;
+    walletMissingSigning: (address: string, reason: string) => WalletMissingSigningError;
+    smartWalletProcessing: (reason: string) => SmartWalletProcessingError;
+    businessNotMinter: (businessId: string, tokenAddress: string) => BusinessNotMinterError;
+    unexpectedValidationScenario: (context: string) => UnexpectedValidationScenarioError;
+};
+/**
+ * Advanced Error Builder for complex scenarios
+ * Still references domain classes when possible
+ */
+export declare class ErrorBuilder {
+    private config;
+    static create(): ErrorBuilder;
+    /**
+     * Use a specific domain error class
+     */
+    useClass(errorClass: any, ...params: any[]): ErrorBuilder;
+    /**
+     * Build the error instance
+     */
+    build(): Error;
+    buildUserNotFound(id: string): UserNotFoundError;
+    buildBusinessNotFound(id: string): BusinessNotFoundError;
+    buildAuthRequired(resource: string): AuthenticationRequiredError;
+}
+//# sourceMappingURL=error-factory.d.ts.map

package/dist/cjs/shared-patterns/errors/error-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-factory.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/errors/error-factory.ts"],"names":[],"mappings":"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"}