@explorins/pers-shared 2.1.40 → 2.1.42

package/dist/esm/shared-lib/dto/token/token.request.dto.d.ts

@@ -6,6 +6,7 @@ export declare class TokenUpdateRequestDTO {
 }
 export declare class TokenCreateRequestDTO {
     contractAddress: string;
+    chainId?: number;
     abiUrl?: string;
     type: NativeTokenType;
     decimals?: number;

package/dist/esm/shared-lib/dto/token/token.request.dto.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"token.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.request.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AAGvF,qBAAa,qBAAqB;IAK9B,SAAS,CAAC,EAAE,OAAO,CAAC;IAKpB,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAqB;IAI9B,eAAe,EAAE,MAAM,CAAK;IAe5B,MAAM,CAAC,EAAE,MAAM,CAAA;IAKf,IAAI,EAAE,eAAe,CAA0B;IAK/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}
+{"version":3,"file":"token.request.dto.d.ts","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.request.dto.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,eAAe,EAAoB,MAAM,+BAA+B,CAAC;AAGvF,qBAAa,qBAAqB;IAK9B,SAAS,CAAC,EAAE,OAAO,CAAC;IAKpB,IAAI,CAAC,EAAE,MAAM,CAAC;IAKd,MAAM,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qBAAa,qBAAqB;IAI9B,eAAe,EAAE,MAAM,CAAK;IAK5B,OAAO,CAAC,EAAE,MAAM,CAAC;IAejB,MAAM,CAAC,EAAE,MAAM,CAAA;IAKf,IAAI,EAAE,eAAe,CAA0B;IAK/C,QAAQ,CAAC,EAAE,MAAM,CAAC;CACrB"}

package/dist/esm/shared-lib/dto/token/token.request.dto.js

@@ -22,6 +22,7 @@ __decorate([
 ], TokenUpdateRequestDTO.prototype, "symbol", void 0);
 export class TokenCreateRequestDTO {
     contractAddress = '';
+    chainId;
     /* @ApiProperty({
         description: 'The chain id is the chain id of the contract. This is useful for multi-chain contracts.'
     })
@@ -39,6 +40,11 @@ __decorate([
         description: 'Contract address is the address of the token contract on chain.'
     })
 ], TokenCreateRequestDTO.prototype, "contractAddress", void 0);
+__decorate([
+    ApiPropertyOptional({
+        description: 'The chain id is the chain id of the contract. This is useful for multi-chain contracts.'
+    })
+], TokenCreateRequestDTO.prototype, "chainId", void 0);
 __decorate([
     ApiPropertyOptional({
         description: 'The ABI URL is the URL to the contract ABI. This is an optional field. If not provided, the contract ABI will be fetched from PERS instance depending on selected token type.'

package/dist/esm/shared-lib/dto/token/token.request.dto.js.map

@@ -1 +1 @@
-{"version":3,"file":"token.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.request.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAwB,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,MAAM,OAAO,qBAAqB;IAK9B,SAAS,CAAW;IAKpB,IAAI,CAAU;IAKd,MAAM,CAAU;CACnB;AAXG;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,uGAAuG,EAAC,CACzH;wDACmB;AAKpB;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,uBAAuB,EAAC,CACzC;mDACa;AAKd;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,yBAAyB,EAAC,CAC3C;qDACe;AAGpB,MAAM,OAAO,qBAAqB;IAI9B,eAAe,GAAW,EAAE,CAAA;IAE5B;;;0BAGsB;IAEtB;;;+BAG2B;IAK3B,MAAM,CAAS;IAKf,IAAI,GAAoB,gBAAgB,CAAC,KAAK,CAAC;IAK/C,QAAQ,CAAU;CACrB;AA1BG;IAHC,WAAW,CAAC;QACT,WAAW,EAAE,iEAAiE;KACjF,CAAC;8DAC0B;AAe5B;IAHC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+KAA+K;KAC/L,CAAC;qDACa;AAKf;IAHC,WAAW,CAAC;QACT,IAAI,EAAE,gBAAgB;KACzB,CAAC;mDAC6C;AAK/C;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,qFAAqF,EAAC,CACvG;uDACiB"}
+{"version":3,"file":"token.request.dto.js","sourceRoot":"","sources":["../../../../../src/shared-lib/dto/token/token.request.dto.ts"],"names":[],"mappings":";;;;;;AAAA,OAAO,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,iBAAiB,CAAA;AAClE,OAAO,EAAwB,gBAAgB,EAAE,MAAM,+BAA+B,CAAC;AAGvF,MAAM,OAAO,qBAAqB;IAK9B,SAAS,CAAW;IAKpB,IAAI,CAAU;IAKd,MAAM,CAAU;CACnB;AAXG;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,uGAAuG,EAAC,CACzH;wDACmB;AAKpB;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,uBAAuB,EAAC,CACzC;mDACa;AAKd;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,yBAAyB,EAAC,CAC3C;qDACe;AAGpB,MAAM,OAAO,qBAAqB;IAI9B,eAAe,GAAW,EAAE,CAAA;IAK5B,OAAO,CAAU;IAEjB;;;0BAGsB;IAEtB;;;+BAG2B;IAK3B,MAAM,CAAS;IAKf,IAAI,GAAoB,gBAAgB,CAAC,KAAK,CAAC;IAK/C,QAAQ,CAAU;CACrB;AA/BG;IAHC,WAAW,CAAC;QACT,WAAW,EAAE,iEAAiE;KACjF,CAAC;8DAC0B;AAK5B;IAHC,mBAAmB,CAAC;QACjB,WAAW,EAAE,yFAAyF;KACzG,CAAC;sDACe;AAejB;IAHC,mBAAmB,CAAC;QACjB,WAAW,EAAE,+KAA+K;KAC/L,CAAC;qDACa;AAKf;IAHC,WAAW,CAAC;QACT,IAAI,EAAE,gBAAgB;KACzB,CAAC;mDAC6C;AAK/C;IAHC,mBAAmB,CAChB,EAAC,WAAW,EAAE,qFAAqF,EAAC,CACvG;uDACiB"}

package/dist/esm/shared-lib/enum/api-key-type.enum.d.ts

@@ -1,5 +1,4 @@
 export declare enum ApiKeyType {
-    TENANT_SYSTEM_API_SECRET = "TENANT_SYSTEM_API_SECRET",
     TENANT_SYSTEM_JWT = "TENANT_SYSTEM_JWT",
     ADMIN_JWT_ACCESS_TOKEN = "ADMIN_JWT_ACCESS_TOKEN",
     ADMIN_JWT_REFRESH_TOKEN = "ADMIN_JWT_REFRESH_TOKEN",
@@ -9,4 +8,7 @@ export declare enum ApiKeyType {
     BLOCKCHAIN_READER_JWT = "BLOCKCHAIN_READER_JWT",
     TENANT_LEGACY_ADMIN = "TENANT_ADMIN_JWT"
 }
+export type AuthApiKeyType = ApiKeyType.USER_JWT_ACCESS_TOKEN | ApiKeyType.USER_JWT_REFRESH_TOKEN | ApiKeyType.ADMIN_JWT_ACCESS_TOKEN | ApiKeyType.ADMIN_JWT_REFRESH_TOKEN;
+export type BlockchainApiKeyType = ApiKeyType.BLOCKCHAIN_READER_JWT | ApiKeyType.BLOCKCHAIN_WRITER_JWT;
+export type IntegrationApiKeyType = ApiKeyType.TENANT_SYSTEM_JWT | ApiKeyType.TENANT_LEGACY_ADMIN;
 //# sourceMappingURL=api-key-type.enum.d.ts.map

package/dist/esm/shared-lib/enum/api-key-type.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"api-key-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/api-key-type.enum.ts"],"names":[],"mappings":"AAEA,oBAAY,UAAU;IAClB,wBAAwB,6BAAgC;IACxD,iBAAiB,sBAAgC;IACjD,sBAAsB,2BAAgC;IACtD,uBAAuB,4BAAgC;IACvD,qBAAqB,0BAAgC;IACrD,sBAAsB,2BAAgC;IACtD,qBAAqB,0BAAgC;IACrD,qBAAqB,0BAAgC;IAGrD,mBAAmB,qBAA6B;CACnD"}
+{"version":3,"file":"api-key-type.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/api-key-type.enum.ts"],"names":[],"mappings":"AAEA,oBAAY,UAAU;IAClB,iBAAiB,sBAAgC;IACjD,sBAAsB,2BAAgC;IACtD,uBAAuB,4BAAgC;IACvD,qBAAqB,0BAAgC;IACrD,sBAAsB,2BAAgC;IACtD,qBAAqB,0BAAgC;IACrD,qBAAqB,0BAAgC;IAGrD,mBAAmB,qBAA6B;CAEnD;AAOD,MAAM,MAAM,cAAc,GACpB,UAAU,CAAC,qBAAqB,GAChC,UAAU,CAAC,sBAAsB,GACjC,UAAU,CAAC,sBAAsB,GACjC,UAAU,CAAC,uBAAuB,CAAA;AAIxC,MAAM,MAAM,oBAAoB,GAC1B,UAAU,CAAC,qBAAqB,GAChC,UAAU,CAAC,qBAAqB,CAAC;AAGvC,MAAM,MAAM,qBAAqB,GAC3B,UAAU,CAAC,iBAAiB,GAC5B,UAAU,CAAC,mBAAmB,CAAC"}

package/dist/esm/shared-lib/enum/api-key-type.enum.js

@@ -1,6 +1,5 @@
 export var ApiKeyType;
 (function (ApiKeyType) {
-    ApiKeyType["TENANT_SYSTEM_API_SECRET"] = "TENANT_SYSTEM_API_SECRET";
     ApiKeyType["TENANT_SYSTEM_JWT"] = "TENANT_SYSTEM_JWT";
     ApiKeyType["ADMIN_JWT_ACCESS_TOKEN"] = "ADMIN_JWT_ACCESS_TOKEN";
     ApiKeyType["ADMIN_JWT_REFRESH_TOKEN"] = "ADMIN_JWT_REFRESH_TOKEN";
@@ -10,5 +9,6 @@ export var ApiKeyType;
     ApiKeyType["BLOCKCHAIN_READER_JWT"] = "BLOCKCHAIN_READER_JWT";
     // TODO: this needs to be removed. However, there is still dependency
     ApiKeyType["TENANT_LEGACY_ADMIN"] = "TENANT_ADMIN_JWT";
+    // TENANT_SYSTEM_API_SECRET    = 'TENANT_SYSTEM_API_SECRET',
 })(ApiKeyType || (ApiKeyType = {}));
 //# sourceMappingURL=api-key-type.enum.js.map

package/dist/esm/shared-lib/enum/api-key-type.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"api-key-type.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/api-key-type.enum.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,UAYX;AAZD,WAAY,UAAU;IAClB,mEAAwD,CAAA;IACxD,qDAAiD,CAAA;IACjD,+DAAsD,CAAA;IACtD,iEAAuD,CAAA;IACvD,6DAAqD,CAAA;IACrD,+DAAsD,CAAA;IACtD,6DAAqD,CAAA;IACrD,6DAAqD,CAAA;IAErD,qEAAqE;IACrE,sDAAgD,CAAA;AACpD,CAAC,EAZW,UAAU,KAAV,UAAU,QAYrB"}
+{"version":3,"file":"api-key-type.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/api-key-type.enum.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,UAYX;AAZD,WAAY,UAAU;IAClB,qDAAiD,CAAA;IACjD,+DAAsD,CAAA;IACtD,iEAAuD,CAAA;IACvD,6DAAqD,CAAA;IACrD,+DAAsD,CAAA;IACtD,6DAAqD,CAAA;IACrD,6DAAqD,CAAA;IAErD,qEAAqE;IACrE,sDAAgD,CAAA;IAChD,4DAA4D;AAChE,CAAC,EAZW,UAAU,KAAV,UAAU,QAYrB"}

package/dist/esm/shared-lib/enum/transaction-status.enum.d.ts

@@ -4,6 +4,8 @@ export declare enum TransactionStatus {
     PENDING_SIGNATURE = "pending_signature",
     BROADCASTED = "broadcasted",
     SUCCEEDED = "succeeded",
-    FAILED = "failed"
+    FAILED = "failed",
+    CANCELLED = "cancelled",
+    EXPIRED = "expired"
 }
 //# sourceMappingURL=transaction-status.enum.d.ts.map

package/dist/esm/shared-lib/enum/transaction-status.enum.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-status.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/transaction-status.enum.ts"],"names":[],"mappings":"AAEA,oBAAY,iBAAiB;IAEzB,OAAO,YAA+B;IAGtC,UAAU,eAAgC;IAG1C,iBAAiB,sBAAiC;IAGlD,WAAW,gBAAgC;IAG3C,SAAS,cAAgC;IAGzC,MAAM,WAAgC;CACvC"}
+{"version":3,"file":"transaction-status.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/enum/transaction-status.enum.ts"],"names":[],"mappings":"AAEA,oBAAY,iBAAiB;IAEzB,OAAO,YAA+B;IAGtC,UAAU,eAAgC;IAG1C,iBAAiB,sBAAiC;IAGlD,WAAW,gBAAgC;IAG3C,SAAS,cAAgC;IAGzC,MAAM,WAAgC;IAItC,SAAS,cAAgC;IAIzC,OAAO,YAA+B;CACvC"}

package/dist/esm/shared-lib/enum/transaction-status.enum.js

@@ -11,5 +11,11 @@ export var TransactionStatus;
     TransactionStatus["SUCCEEDED"] = "succeeded";
     // after transaction has failed
     TransactionStatus["FAILED"] = "failed";
+    // after transaction has been cancelled
+    // TODO : is it needed? & needs to be handled in the flows
+    TransactionStatus["CANCELLED"] = "cancelled";
+    // after transaction has expired
+    // TODO : is it needed? & needs to be handled in the flows
+    TransactionStatus["EXPIRED"] = "expired";
 })(TransactionStatus || (TransactionStatus = {}));
 //# sourceMappingURL=transaction-status.enum.js.map

package/dist/esm/shared-lib/enum/transaction-status.enum.js.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-status.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/transaction-status.enum.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,iBAkBT;AAlBH,WAAY,iBAAiB;IAEzB,wCAAsC,CAAA;IAEtC,kCAAkC;IAClC,8CAA0C,CAAA;IAE1C,2CAA2C;IAC3C,4DAAkD,CAAA;IAElD,yCAAyC;IACzC,gDAA2C,CAAA;IAE3C,kCAAkC;IAClC,4CAAyC,CAAA;IAEzC,+BAA+B;IAC/B,sCAAsC,CAAA;AACxC,CAAC,EAlBS,iBAAiB,KAAjB,iBAAiB,QAkB1B"}
+{"version":3,"file":"transaction-status.enum.js","sourceRoot":"","sources":["../../../../src/shared-lib/enum/transaction-status.enum.ts"],"names":[],"mappings":"AAEA,MAAM,CAAN,IAAY,iBA0BT;AA1BH,WAAY,iBAAiB;IAEzB,wCAAsC,CAAA;IAEtC,kCAAkC;IAClC,8CAA0C,CAAA;IAE1C,2CAA2C;IAC3C,4DAAkD,CAAA;IAElD,yCAAyC;IACzC,gDAA2C,CAAA;IAE3C,kCAAkC;IAClC,4CAAyC,CAAA;IAEzC,+BAA+B;IAC/B,sCAAsC,CAAA;IAEtC,uCAAuC;IACvC,0DAA0D;IAC1D,4CAAyC,CAAA;IAEzC,gCAAgC;IAChC,0DAA0D;IAC1D,wCAAsC,CAAA;AACxC,CAAC,EA1BS,iBAAiB,KAAjB,iBAAiB,QA0B1B"}

package/dist/esm/shared-lib/errors/technical-errors.d.ts

@@ -18,17 +18,4 @@ export declare class TechnicalError extends HttpException {
      */
     static hidden(message: string, originalError?: Error, correlationId?: string): TechnicalError;
 }
-/**
- * Orchestration errors that wrap other errors but preserve business context
- */
-export declare class OrchestrationError extends HttpException {
-    readonly operation: string;
-    readonly originalError: Error;
-    constructor(operation: string, originalError: Error);
-    static isOrchestrationError(error: any): error is OrchestrationError;
-    /**
-     * Get the root business error if it exists
-     */
-    getRootBusinessError(): HttpException | null;
-}
 //# sourceMappingURL=technical-errors.d.ts.map

package/dist/esm/shared-lib/errors/technical-errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"technical-errors.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/errors/technical-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI3D;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAgB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvC,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtC,SAAgB,eAAe,EAAE,OAAO,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,KAAK,EACrB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,GAAE,UAA6C,EACzD,eAAe,GAAE,OAAc;IAsBjC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,cAAc;IAI5D;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,cAAc;IAI3E;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,cAAc;CAG9F;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,aAAa;IACnD,SAAgB,SAAS,EAAE,MAAM,CAAC;IAClC,SAAgB,aAAa,EAAE,KAAK,CAAC;gBAEzB,SAAS,EAAE,MAAM,EAAE,aAAa,EAAE,KAAK;IAkBnD,MAAM,CAAC,oBAAoB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,kBAAkB;IAIpE;;OAEG;IACH,oBAAoB,IAAI,aAAa,GAAG,IAAI;CAkB7C"}
+{"version":3,"file":"technical-errors.d.ts","sourceRoot":"","sources":["../../../../src/shared-lib/errors/technical-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAI3D;;;GAGG;AACH,qBAAa,cAAe,SAAQ,aAAa;IAC/C,SAAgB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvC,SAAgB,aAAa,CAAC,EAAE,KAAK,CAAC;IACtC,SAAgB,eAAe,EAAE,OAAO,CAAC;gBAGvC,OAAO,EAAE,MAAM,EACf,aAAa,CAAC,EAAE,KAAK,EACrB,aAAa,CAAC,EAAE,MAAM,EACtB,UAAU,GAAE,UAA6C,EACzD,eAAe,GAAE,OAAc;IAsBjC,MAAM,CAAC,gBAAgB,CAAC,KAAK,EAAE,GAAG,GAAG,KAAK,IAAI,cAAc;IAI5D;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,cAAc;IAI3E;;OAEG;IACH,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,aAAa,CAAC,EAAE,KAAK,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,cAAc;CAG9F"}

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

@@ -40,48 +40,4 @@ export class TechnicalError extends HttpException {
         return new TechnicalError(message, originalError, correlationId, HttpStatus.INTERNAL_SERVER_ERROR, false);
     }
 }
-/**
- * Orchestration errors that wrap other errors but preserve business context
- */
-export class OrchestrationError extends HttpException {
-    operation;
-    originalError;
-    constructor(operation, originalError) {
-        // If the original error is a business error, preserve its HTTP status and message
-        const isBusinessError = originalError instanceof HttpException;
-        const status = isBusinessError ? originalError.getStatus() : HttpStatus.INTERNAL_SERVER_ERROR;
-        const response = isBusinessError ? originalError.getResponse() : {
-            code: 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 HttpException &&
-                current.getResponse?.()?.category === 'DOMAIN_RULE') {
-                return current;
-            }
-            if (current instanceof OrchestrationError) {
-                current = current.originalError;
-            }
-            else {
-                break;
-            }
-        }
-        return null;
-    }
-}
 //# sourceMappingURL=technical-errors.js.map

package/dist/esm/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,OAAO,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,mCAAmC,CAAC;AAClE,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AAEjD;;;GAGG;AACH,MAAM,OAAO,cAAe,SAAQ,aAAa;IAC/B,aAAa,CAAU;IACvB,aAAa,CAAS;IACtB,eAAe,CAAU;IAEzC,YACE,OAAe,EACf,aAAqB,EACrB,aAAsB,EACtB,aAAyB,UAAU,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,gBAAgB,CAAC,eAAe;YACtC,OAAO,EAAE,aAAa;YACtB,aAAa;YACb,SAAS,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;YACnC,QAAQ,EAAE,aAAa,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,UAAU,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,UAAU,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5G,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/shared-lib/interfaces/jwt.payload.interface.js

@@ -1,3 +1,14 @@
-;
-export {};
+// ===========================================
+// TYPE GUARDS & UTILITIES
+// ===========================================
+// Type guards for specific payload types
+export function isAuthPayload(payload) {
+    return !('permissionss' in payload) && !('transactionId' in payload);
+}
+export function isActionablePayload(payload) {
+    return 'transactionId' in payload && !('permissions' in payload);
+}
+export function isBlockchainPayload(payload) {
+    return 'permissions' in payload;
+}
 //# sourceMappingURL=jwt.payload.interface.js.map

package/dist/esm/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":"AA8EA,8CAA8C;AAC9C,0BAA0B;AAC1B,8CAA8C;AAG9C,yCAAyC;AACzC,MAAM,UAAU,aAAa,CAAC,OAAuB;IACjD,OAAO,CAAC,CAAC,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC,eAAe,IAAI,OAAO,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACvD,OAAO,eAAe,IAAI,OAAO,IAAI,CAAC,CAAC,aAAa,IAAI,OAAO,CAAC,CAAC;AACrE,CAAC;AAED,MAAM,UAAU,mBAAmB,CAAC,OAAuB;IACvD,OAAO,aAAa,IAAI,OAAO,CAAC;AACpC,CAAC"}

package/dist/esm/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/esm/shared-lib/value-objects/account-selector.vo.js

@@ -8,6 +8,7 @@ import { Type } from "class-transformer";
 import { IsEnum, IsNotEmpty, IsString, IsOptional, ValidateNested } from "class-validator";
 import { AccountOwnerType } from "./../enum";
 import { Address } from "./address.value-object";
+import { ErrorFactory } from '../../shared-patterns/errors/error-factory';
 export class AccountSelectorVo {
     static fromDTO(selector) {
         // Create the appropriate AccountSelector based on accountType
@@ -16,7 +17,7 @@ export class AccountSelectorVo {
             case AccountOwnerType.USER:
             case AccountOwnerType.BUSINESS:
                 if (!selector.accountId) {
-                    throw new Error(`${selector.accountType} account selector requires accountId`);
+                    throw ErrorFactory.requiredField(`accountId for ${selector.accountType} account selector`);
                 }
                 accountSelectorData = {
                     accountType: selector.accountType,
@@ -25,7 +26,7 @@ export class AccountSelectorVo {
                 break;
             case AccountOwnerType.EXTERNAL:
                 if (!selector.accountAddress) {
-                    throw new Error('External account selector requires accountAddress');
+                    throw ErrorFactory.requiredField('accountAddress for external account selector');
                 }
                 accountSelectorData = {
                     accountType: selector.accountType,
@@ -38,7 +39,8 @@ export class AccountSelectorVo {
                 };
                 break;
             default:
-                throw new Error(`Unsupported account type: ${selector.accountType}`);
+                const accountTypeValue = selector.accountType === undefined ? 'undefined' : selector.accountType;
+                throw ErrorFactory.invalidInput('accountType', `Unsupported account type: ${accountTypeValue}. Supported types: ${Object.values(AccountOwnerType).join(', ')}`);
         }
         return new AccountSelectorVo(accountSelectorData);
     }
@@ -104,19 +106,20 @@ export class AccountSelectorVo {
             case AccountOwnerType.USER:
             case AccountOwnerType.BUSINESS:
                 if (!this.accountId) {
-                    throw new Error(`${this.accountType} account selector requires accountId`);
+                    throw ErrorFactory.requiredField(`accountId for ${this.accountType} account selector`);
                 }
                 break;
             case AccountOwnerType.EXTERNAL:
                 if (!this.accountAddress) {
-                    throw new Error('External account selector requires accountAddress');
+                    throw ErrorFactory.requiredField('accountAddress for external account selector');
                 }
                 break;
             case 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 ErrorFactory.invalidInput('accountType', `Unsupported account type: ${accountTypeValue}. Supported types: ${Object.values(AccountOwnerType).join(', ')}`);
         }
     }
     /**
@@ -128,7 +131,7 @@ export class AccountSelectorVo {
             case AccountOwnerType.USER:
             case AccountOwnerType.BUSINESS:
                 if (!this.accountId) {
-                    throw new Error(`${this.accountType} account selector requires accountId`);
+                    throw ErrorFactory.requiredField(`accountId for ${this.accountType} account selector`);
                 }
                 return {
                     accountType: this.accountType,
@@ -136,7 +139,7 @@ export class AccountSelectorVo {
                 };
             case AccountOwnerType.EXTERNAL:
                 if (!this.accountAddress) {
-                    throw new Error('EXTERNAL account selector requires accountAddress');
+                    throw ErrorFactory.requiredField('accountAddress for external account selector');
                 }
                 return {
                     accountType: this.accountType,
@@ -148,7 +151,8 @@ export class AccountSelectorVo {
                     accountType: this.accountType
                 };
             default:
-                throw new Error(`Unsupported account type: ${this.accountType}`);
+                const accountTypeValue = this.accountType === undefined ? 'undefined' : this.accountType;
+                throw ErrorFactory.invalidInput('accountType', `Unsupported account type: ${accountTypeValue}. Supported types: ${Object.values(AccountOwnerType).join(', ')}`);
         }
     }
 }

package/dist/esm/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":"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"}

package/dist/esm/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/esm/shared-lib/value-objects/address.value-object.js

@@ -1,8 +1,9 @@
+import { ErrorFactory } from '../../shared-patterns/errors/error-factory';
 export class Address {
     value;
     constructor(value) {
         if (!this.isValidAddress(value)) {
-            throw new Error('Invalid address for value: ' + value);
+            throw ErrorFactory.invalidFormat('address', `Valid Ethereum address (0x + 40 hex characters). Received: "${value}" with length ${value?.length || 0}`);
         }
         this.value = value;
     }

package/dist/esm/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,MAAM,OAAO,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"}
+{"version":3,"file":"address.value-object.js","sourceRoot":"","sources":["../../../../src/shared-lib/value-objects/address.value-object.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,YAAY,EAAE,MAAM,4CAA4C,CAAC;AAE1E,MAAM,OAAO,OAAO;IACC,KAAK,CAAS;IAE/B,YAAY,KAAa;QACvB,IAAI,CAAC,IAAI,CAAC,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC;YAChC,MAAM,YAAY,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"}

package/dist/esm/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/esm/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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"}