@explorins/pers-shared 2.1.2 → 2.1.8

package/dist/cjs/errors/index.js

@@ -0,0 +1,38 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BusinessLogicError = void 0;
+// Base error classes and interfaces
+var base_business_error_1 = require("./base-business-error");
+Object.defineProperty(exports, "BusinessLogicError", { enumerable: true, get: function () { return base_business_error_1.BusinessLogicError; } });
+__exportStar(require("./technical-errors"), exports);
+__exportStar(require("./domains/transaction-errors"), exports);
+// Error classification system
+__exportStar(require("./base/error-classification-enums"), exports);
+// Note: Error classification system moved to @explorins/pers-shared-patterns
+// Error codes extracted from domain classes
+__exportStar(require("./error-codes"), exports);
+// Domain-specific errors (organized by domain)
+__exportStar(require("./domains/token-errors"), exports);
+__exportStar(require("./domains/user-errors"), exports);
+__exportStar(require("./domains/wallet-errors"), exports);
+__exportStar(require("./domains/business-errors"), exports);
+__exportStar(require("./domains/balance-errors"), exports);
+__exportStar(require("./domains/contract-errors"), exports);
+__exportStar(require("./domains/system-errors"), exports);
+__exportStar(require("./domains/authentication-errors"), exports);
+__exportStar(require("./domains/signing-account-errors"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/errors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,oCAAoC;AACpC,6DAA2D;AAAlD,yHAAA,kBAAkB,OAAA;AAC3B,qDAAmC;AACnC,+DAA6C;AAE7C,8BAA8B;AAC9B,oEAAkD;AAElD,6EAA6E;AAE7E,4CAA4C;AAC5C,gDAA8B;AAE9B,+CAA+C;AAC/C,yDAAuC;AACvC,wDAAsC;AACtC,0DAAwC;AACxC,4DAA0C;AAC1C,2DAAyC;AACzC,4DAA0C;AAC1C,0DAAwC;AACxC,kEAAgD;AAChD,mEAAiD"}

package/dist/cjs/errors/technical-errors.d.ts

@@ -0,0 +1,34 @@
+import { HttpException, HttpStatus } from '@nestjs/common';
+/**
+ * Technical errors with meaningful messages that should be preserved
+ * Use for system errors that have specific, actionable messages but aren't business logic errors
+ */
+export declare class TechnicalError extends HttpException {
+    readonly correlationId?: string;
+    readonly originalError?: Error;
+    readonly preserveMessage: boolean;
+    constructor(message: string, originalError?: Error, correlationId?: string, httpStatus?: HttpStatus, preserveMessage?: boolean);
+    static isTechnicalError(error: any): error is TechnicalError;
+    /**
+     * Create a technical error that preserves the original message
+     */
+    static withMessage(message: string, correlationId?: string): TechnicalError;
+    /**
+     * Create a technical error that hides the original message (legacy behavior)
+     */
+    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/cjs/errors/technical-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"technical-errors.d.ts","sourceRoot":"","sources":["../../../src/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"}

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

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OrchestrationError = 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");
+/**
+ * Technical errors with meaningful messages that should be preserved
+ * Use for system errors that have specific, actionable messages but aren't business logic errors
+ */
+class TechnicalError extends common_1.HttpException {
+    correlationId;
+    originalError;
+    preserveMessage;
+    constructor(message, originalError, correlationId, httpStatus = common_1.HttpStatus.INTERNAL_SERVER_ERROR, preserveMessage = true) {
+        // Preserve original message if flag is true, otherwise use generic message
+        const clientMessage = preserveMessage ? message : 'An unexpected error occurred';
+        super({
+            code: error_codes_1.CommonErrorCodes.TECHNICAL_ERROR,
+            message: clientMessage,
+            correlationId,
+            timestamp: new Date().toISOString(),
+            category: error_classification_enums_1.ErrorCategory.TECHNICAL
+        }, httpStatus);
+        this.originalError = originalError;
+        this.correlationId = correlationId;
+        this.preserveMessage = preserveMessage;
+        this.name = this.constructor.name;
+    }
+    static isTechnicalError(error) {
+        return error instanceof TechnicalError;
+    }
+    /**
+     * Create a technical error that preserves the original message
+     */
+    static withMessage(message, correlationId) {
+        return new TechnicalError(message, undefined, correlationId, common_1.HttpStatus.INTERNAL_SERVER_ERROR, true);
+    }
+    /**
+     * Create a technical error that hides the original message (legacy behavior)
+     */
+    static hidden(message, originalError, correlationId) {
+        return new TechnicalError(message, originalError, correlationId, common_1.HttpStatus.INTERNAL_SERVER_ERROR, false);
+    }
+}
+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/errors/technical-errors.js.map

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

package/dist/cjs/index.d.ts

@@ -1,8 +1,8 @@
 export * from './enum';
 export * from './value-objects';
-export * from './functions';
 export * from './interfaces';
 export * from './types';
 export * from './dto';
+export * from './errors';
 export * from './types/backend';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAGtB,cAAc,iBAAiB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAGtB,cAAc,UAAU,CAAC;AAGzB,cAAc,iBAAiB,CAAC"}

package/dist/cjs/index.js

@@ -19,10 +19,11 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Core domain contracts
 __exportStar(require("./enum"), exports);
 __exportStar(require("./value-objects"), exports);
-__exportStar(require("./functions"), exports);
 __exportStar(require("./interfaces"), exports);
 __exportStar(require("./types"), exports);
 __exportStar(require("./dto"), exports);
+// Error handling system
+__exportStar(require("./errors"), exports);
 // Backend-only exports (Node.js environment)
 __exportStar(require("./types/backend"), exports);
 // Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns

package/dist/cjs/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,yCAAuB;AACvB,kDAAgC;AAChC,8CAA4B;AAC5B,+CAA6B;AAC7B,0CAAwB;AACxB,wCAAsB;AAEtB,6CAA6C;AAC7C,kDAAgC;AAEhC,yGAAyG;AACzG,mFAAmF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":";AAAA,4EAA4E;AAC5E,8FAA8F;;;;;;;;;;;;;;;;AAE9F,wBAAwB;AACxB,yCAAuB;AACvB,kDAAgC;AAChC,+CAA6B;AAC7B,0CAAwB;AACxB,wCAAsB;AAEtB,wBAAwB;AACxB,2CAAyB;AAEzB,6CAA6C;AAC7C,kDAAgC;AAEhC,yGAAyG;AACzG,mFAAmF"}

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

@@ -1,7 +1,5 @@
 export * from './audit-metadata.interface';
 export * from './transaction-account-data.interface';
-export * from './stripe-payment-intent-metadata.interface';
-export * from './request.interface';
 export * from './local-storage-item.interface';
 export * from './token-storage-data.interface';
 export * from './jwt.payload.interface';
@@ -11,7 +9,6 @@ export * from './geolocation-result.interface';
 export * from './wallet.interface';
 export * from './polymorphic-owner.interface';
 export * from './signer-verification.interface';
-export * from './transaction-actor.interface';
 export * from './wallet-signing-scenario.interface';
 export * from './base-pagination.interface';
 export * from './group-by-expression.interface';

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qBAAqB,CAAC;AACpC,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAE1D,cAAc,yBAAyB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AACA,cAAc,4BAA4B,CAAC;AAC3C,cAAc,sCAAsC,CAAC;AACrD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,gCAAgC,CAAC;AAC/C,cAAc,yBAAyB,CAAC;AACxC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0CAA0C,CAAC;AACzD,cAAc,gCAAgC,CAAC;AAC/C,cAAc,oBAAoB,CAAC;AACnC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,iCAAiC,CAAC;AAChD,cAAc,qCAAqC,CAAC;AACpD,cAAc,6BAA6B,CAAC;AAC5C,cAAc,iCAAiC,CAAC;AAChD,cAAc,2CAA2C,CAAC;AAE1D,cAAc,yBAAyB,CAAC"}

package/dist/cjs/interfaces/index.js

@@ -17,8 +17,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 // Interfaces Barrel - Auto-exports all interfaces
 __exportStar(require("./audit-metadata.interface"), exports);
 __exportStar(require("./transaction-account-data.interface"), exports);
-__exportStar(require("./stripe-payment-intent-metadata.interface"), exports);
-__exportStar(require("./request.interface"), exports);
 __exportStar(require("./local-storage-item.interface"), exports);
 __exportStar(require("./token-storage-data.interface"), exports);
 __exportStar(require("./jwt.payload.interface"), exports);
@@ -28,7 +26,6 @@ __exportStar(require("./geolocation-result.interface"), exports);
 __exportStar(require("./wallet.interface"), exports);
 __exportStar(require("./polymorphic-owner.interface"), exports);
 __exportStar(require("./signer-verification.interface"), exports);
-__exportStar(require("./transaction-actor.interface"), exports);
 __exportStar(require("./wallet-signing-scenario.interface"), exports);
 __exportStar(require("./base-pagination.interface"), exports);
 __exportStar(require("./group-by-expression.interface"), exports);

package/dist/cjs/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,6DAA2C;AAC3C,uEAAqD;AACrD,6EAA2D;AAC3D,sDAAoC;AACpC,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,gEAA8C;AAC9C,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAE1D,0DAAwC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,kDAAkD;AAClD,6DAA2C;AAC3C,uEAAqD;AACrD,iEAA+C;AAC/C,iEAA+C;AAC/C,0DAAwC;AACxC,+DAA6C;AAC7C,2EAAyD;AACzD,iEAA+C;AAC/C,qDAAmC;AACnC,gEAA8C;AAC9C,kEAAgD;AAChD,sEAAoD;AACpD,8DAA4C;AAC5C,kEAAgD;AAChD,4EAA0D;AAE1D,0DAAwC"}

package/dist/cjs/interfaces/signer-verification.interface.d.ts

@@ -4,6 +4,7 @@
  * Shared interfaces for signer backend verification operations.
  * Used across multiple modules for type consistency.
  */
+import { SigningAccountProvider } from './../enum/signing-account-provider.enum';
 import { ExternalWallet } from './wallet.interface';
 export interface PasskeyTokenPayload {
     sub: string;
@@ -25,7 +26,7 @@ export interface PasskeyTokenPayload {
 }
 export interface TokenVerificationResult {
     valid: boolean;
-    provider: string | null;
+    provider: SigningAccountProvider | null;
     claims: PasskeyTokenPayload | null;
     wallets?: ExternalWallet[] | null;
 }

package/dist/cjs/interfaces/signer-verification.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"signer-verification.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/signer-verification.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAClB,CAAC;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"signer-verification.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/signer-verification.interface.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,sBAAsB,EAAE,MAAM,yCAAyC,CAAC;AACjF,OAAO,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAElD,MAAM,WAAW,mBAAmB;IAClC,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,aAAa,CAAC,EAAE;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,KAAK,EAAE,MAAM,CAAC;QACd,SAAS,EAAE,MAAM,CAAC;QAClB,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;KAClB,CAAC;IACF,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAC;IACf,QAAQ,EAAE,sBAAsB,GAAG,IAAI,CAAC;IACxC,MAAM,EAAE,mBAAmB,GAAG,IAAI,CAAC;IACnC,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;CACnC;AAED,MAAM,WAAW,eAAe;IAC9B,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,cAAc,EAAE,GAAG,IAAI,CAAC;IAClC,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB"}

package/dist/cjs/interfaces/transaction-analytics-request.interface.d.ts

@@ -1,8 +1,8 @@
-import { AnalyticsMetricType } from 'types';
 import { GroupByExpression } from './group-by-expression.interface';
 import { SortOrder } from '../enum/sort-order.enum';
 import { TransactionCompleteFields } from './transaction.interface';
 import { TransactionAnalyticsGroupByType } from '../dto/transaction/transaction-analytics.request.dto';
+import { AnalyticsMetricType } from 'types/analytics.type';
 export interface TransactionAnalyticsRequest {
     filters?: TransactionAnalyticsFilters;
     groupBy?: TransactionAnalyticsGroupByType[];

package/dist/cjs/interfaces/transaction-analytics-request.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"transaction-analytics-request.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/transaction-analytics-request.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,MAAM,OAAO,CAAC;AAC5C,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sDAAsD,CAAC;AAEvG,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC;IAC5C,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,mBAAmB,GAAG,WAAW,CAAC;IAC3C,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAC5E,WAAW,GACX,WAAW,CACd,CAAC,CAAC"}
+{"version":3,"file":"transaction-analytics-request.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/transaction-analytics-request.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,iCAAiC,CAAC;AACpE,OAAO,EAAE,SAAS,EAAE,MAAM,yBAAyB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,yBAAyB,CAAC;AACpE,OAAO,EAAE,+BAA+B,EAAE,MAAM,sDAAsD,CAAC;AACvG,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAE3D,MAAM,WAAW,2BAA2B;IAC1C,OAAO,CAAC,EAAE,2BAA2B,CAAC;IACtC,OAAO,CAAC,EAAE,+BAA+B,EAAE,CAAC;IAC5C,kBAAkB,CAAC,EAAE,iBAAiB,EAAE,CAAC;IACzC,OAAO,CAAC,EAAE,mBAAmB,EAAE,CAAC;IAChC,MAAM,CAAC,EAAE,mBAAmB,GAAG,WAAW,CAAC;IAC3C,SAAS,CAAC,EAAE,SAAS,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;IAC1B,OAAO,CAAC,EAAE,IAAI,GAAG,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,2BAA2B,GAAG,OAAO,CAAC,IAAI,CAAC,yBAAyB,EAC5E,WAAW,GACX,WAAW,CACd,CAAC,CAAC"}

package/dist/cjs/interfaces/wallet.interface.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"wallet.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/wallet.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEtF,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}
+{"version":3,"file":"wallet.interface.d.ts","sourceRoot":"","sources":["../../../src/interfaces/wallet.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAC3E,OAAO,EAAE,mBAAmB,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGtF,MAAM,WAAW,UAAU;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,EAAE,mBAAmB,CAAC;IAC5B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,KAAK,EAAE,aAAa,CAAC;IACrB,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,aAAa,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,CAAC,EAAE,MAAM,CAAC;IACZ,UAAU,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,OAAO,EAAE,WAAW,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,MAAM,EAAE,oBAAoB,CAAC;IAC7B,UAAU,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IACnB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,GAAG,IAAI,CAAC;CAC/B"}

package/dist/cjs/types/account-selector.type.d.ts

@@ -0,0 +1,17 @@
+import { AccountOwnerType } from "enum/owner-type.enum";
+import { Address } from "value-objects/address.value-object";
+export type AccountSelector = {
+    /** Type of the actor entity */
+    accountType: AccountOwnerType.EXTERNAL;
+    /** Blockchain address for external actors */
+    accountAddress: Address;
+} | {
+    /** Type of the actor entity */
+    accountType: AccountOwnerType.USER | AccountOwnerType.BUSINESS;
+    /** String identifier for entity actors (user ID, business ID, etc.) */
+    accountId: string;
+} | {
+    /** Type of the actor entity */
+    accountType: AccountOwnerType.TENANT | AccountOwnerType.SYSTEM;
+};
+//# sourceMappingURL=account-selector.type.d.ts.map

package/dist/cjs/types/account-selector.type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-selector.type.d.ts","sourceRoot":"","sources":["../../../src/types/account-selector.type.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,OAAO,EAAE,MAAM,oCAAoC,CAAC;AAU7D,MAAM,MAAM,eAAe,GACvB;IACE,+BAA+B;IAC/B,WAAW,EAAE,gBAAgB,CAAC,QAAQ,CAAC;IACvC,6CAA6C;IAC7C,cAAc,EAAE,OAAO,CAAC;CACzB,GACD;IACE,+BAA+B;IAC/B,WAAW,EAAE,gBAAgB,CAAC,IAAI,GAAG,gBAAgB,CAAC,QAAQ,CAAC;IAC/D,uEAAuE;IACvE,SAAS,EAAE,MAAM,CAAC;CACnB,GACD;IACE,+BAA+B;IAC/B,WAAW,EAAE,gBAAgB,CAAC,MAAM,GAAG,gBAAgB,CAAC,MAAM,CAAC;CAEhE,CAAC"}

package/dist/cjs/{interfaces/transaction-actor.interface.js → types/account-selector.type.js}

@@ -1,3 +1,3 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=transaction-actor.interface.js.map
+//# sourceMappingURL=account-selector.type.js.map

package/dist/cjs/types/account-selector.type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"account-selector.type.js","sourceRoot":"","sources":["../../../src/types/account-selector.type.ts"],"names":[],"mappings":""}

package/dist/cjs/types/backend.d.ts

@@ -1,2 +1,3 @@
-export { TRANSACTION_FORMATS, TransactionFormat } from "@explorins/web3-ts/types";
+export type { TransactionFormat } from "@explorins/web3-ts/types";
+export { TRANSACTION_FORMATS } from "@explorins/web3-ts/types";
 //# sourceMappingURL=backend.d.ts.map

package/dist/cjs/types/backend.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/types/backend.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"backend.d.ts","sourceRoot":"","sources":["../../../src/types/backend.ts"],"names":[],"mappings":"AACA,YAAY,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAGlE,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/cjs/types/backend.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.TRANSACTION_FORMATS = void 0;
-// Backend-only types that depend on Node.js modules
+// ✅ CORRECT: Use regular 'export' for runtime values/constants
 var types_1 = require("@explorins/web3-ts/types");
 Object.defineProperty(exports, "TRANSACTION_FORMATS", { enumerable: true, get: function () { return types_1.TRANSACTION_FORMATS; } });
 //# sourceMappingURL=backend.js.map

package/dist/cjs/types/backend.js.map

@@ -1 +1 @@
-{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../src/types/backend.ts"],"names":[],"mappings":";;;AAAA,oDAAoD;AACpD,kDAAkF;AAAzE,4GAAA,mBAAmB,OAAA"}
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../src/types/backend.ts"],"names":[],"mappings":";;;AAGA,+DAA+D;AAC/D,kDAA+D;AAAtD,4GAAA,mBAAmB,OAAA"}

package/dist/cjs/types/index.d.ts

@@ -2,4 +2,5 @@ export * from './testnet-prefix';
 export * from './unique-user-identifier-keys';
 export * from './native-token.type';
 export * from './analytics.type';
+export * from './account-selector.type';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/types/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":"AACA,cAAc,kBAAkB,CAAC;AACjC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,yBAAyB,CAAC"}

package/dist/cjs/types/index.js

@@ -19,4 +19,5 @@ __exportStar(require("./testnet-prefix"), exports);
 __exportStar(require("./unique-user-identifier-keys"), exports);
 __exportStar(require("./native-token.type"), exports);
 __exportStar(require("./analytics.type"), exports);
+__exportStar(require("./account-selector.type"), exports);
 //# sourceMappingURL=index.js.map

package/dist/cjs/types/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAmD;AACnD,mDAAiC;AACjC,gEAA8C;AAC9C,sDAAoC;AACpC,mDAAiC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/types/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,mDAAmD;AACnD,mDAAiC;AACjC,gEAA8C;AAC9C,sDAAoC;AACpC,mDAAiC;AACjC,0DAAwC"}

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

@@ -0,0 +1,38 @@
+import { AccountOwnerType } from "./../enum";
+import { AccountSelector } from "./../types";
+import { Address } from "./address.value-object";
+import { AccountSelectorDTO } from "../dto";
+export declare class AccountSelectorVo {
+    accountType: AccountOwnerType;
+    accountId?: string;
+    accountAddress?: Address;
+    static fromDTO(selector: AccountSelectorDTO): AccountSelectorVo;
+    /**
+     * 🏭 FACTORY METHOD: Create External Account Selector
+     * Extensible for different account types
+     */
+    static createExternal(address: Address): AccountSelectorVo;
+    static createUserOrBusiness(accountType: AccountOwnerType.USER | AccountOwnerType.BUSINESS, accountId: string): AccountSelectorVo;
+    /**
+     * 🏭 FACTORY METHOD: Create User Account Selector
+     * Clear intent and type safety
+     */
+    static createUser(accountId: string): AccountSelectorVo;
+    /**
+     * 🏭 FACTORY METHOD: Create Business Account Selector
+     * Creates an AccountSelectorVo for business accounts
+     */
+    static createBusiness(accountId: string): AccountSelectorVo;
+    /**
+     * 🏭 FACTORY METHOD: Create Tenant Account Selector
+     * Creates an AccountSelectorVo for tenant accounts
+     */
+    static createTenant(): AccountSelectorVo;
+    constructor(data: AccountSelector);
+    /**
+     * 🔧 BUSINESS VALIDATION
+     * Ensures proper AccountSelector construction based on type
+     */
+    private validateBusinessRules;
+}
+//# sourceMappingURL=account-selector.vo.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-selector.vo.d.ts","sourceRoot":"","sources":["../../../src/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;IAG5B,WAAW,EAAE,gBAAgB,CAAC;IAI9B,SAAS,CAAC,EAAE,MAAM,CAAC;IAKnB,cAAc,CAAC,EAAE,OAAO,CAAC;IAEzB,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;CAuB9B"}

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

@@ -0,0 +1,149 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.AccountSelectorVo = void 0;
+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");
+class AccountSelectorVo {
+    accountType;
+    accountId;
+    accountAddress;
+    static fromDTO(selector) {
+        // Create the appropriate AccountSelector based on accountType
+        let accountSelectorData;
+        switch (selector.accountType) {
+            case enum_1.AccountOwnerType.USER:
+            case enum_1.AccountOwnerType.BUSINESS:
+                if (!selector.accountId) {
+                    throw new Error(`${selector.accountType} account selector requires accountId`);
+                }
+                accountSelectorData = {
+                    accountType: selector.accountType,
+                    accountId: selector.accountId
+                };
+                break;
+            case enum_1.AccountOwnerType.EXTERNAL:
+                if (!selector.accountAddress) {
+                    throw new Error('External account selector requires accountAddress');
+                }
+                accountSelectorData = {
+                    accountType: selector.accountType,
+                    accountAddress: new address_value_object_1.Address(selector.accountAddress)
+                };
+                break;
+            case enum_1.AccountOwnerType.TENANT:
+                accountSelectorData = {
+                    accountType: selector.accountType
+                };
+                break;
+            default:
+                throw new Error(`Unsupported account type: ${selector.accountType}`);
+        }
+        return new AccountSelectorVo(accountSelectorData);
+    }
+    /**
+     * 🏭 FACTORY METHOD: Create External Account Selector
+     * Extensible for different account types
+     */
+    static createExternal(address) {
+        return new AccountSelectorVo({
+            accountType: enum_1.AccountOwnerType.EXTERNAL,
+            accountAddress: address,
+            // accountId: address.getValue()
+        });
+    }
+    static createUserOrBusiness(accountType, accountId) {
+        return new AccountSelectorVo({
+            accountType: accountType,
+            accountId: accountId
+        });
+    }
+    /**
+     * 🏭 FACTORY METHOD: Create User Account Selector
+     * Clear intent and type safety
+     */
+    static createUser(accountId) {
+        return new AccountSelectorVo({
+            accountType: enum_1.AccountOwnerType.USER,
+            accountId: accountId
+        });
+    }
+    /**
+     * 🏭 FACTORY METHOD: Create Business Account Selector
+     * Creates an AccountSelectorVo for business accounts
+     */
+    static createBusiness(accountId) {
+        return new AccountSelectorVo({
+            accountType: enum_1.AccountOwnerType.BUSINESS,
+            accountId: accountId
+        });
+    }
+    /**
+     * 🏭 FACTORY METHOD: Create Tenant Account Selector
+     * Creates an AccountSelectorVo for tenant accounts
+     */
+    static createTenant() {
+        return new AccountSelectorVo({
+            accountType: enum_1.AccountOwnerType.TENANT
+            // Tenant context resolved automatically from request context
+        });
+    }
+    constructor(data) {
+        this.accountType = data.accountType;
+        this.accountId = 'accountId' in data ? data.accountId : undefined;
+        this.accountAddress = 'accountAddress' in data ? data.accountAddress : undefined;
+        this.validateBusinessRules();
+    }
+    /**
+     * 🔧 BUSINESS VALIDATION
+     * Ensures proper AccountSelector construction based on type
+     */
+    validateBusinessRules() {
+        switch (this.accountType) {
+            case enum_1.AccountOwnerType.USER:
+            case enum_1.AccountOwnerType.BUSINESS:
+                if (!this.accountId) {
+                    throw new Error(`${this.accountType} account selector requires accountId`);
+                }
+                break;
+            case enum_1.AccountOwnerType.EXTERNAL:
+                if (!this.accountAddress) {
+                    throw new Error('External account selector requires accountAddress');
+                }
+                break;
+            case enum_1.AccountOwnerType.TENANT:
+                // Tenant context resolved from request - no validation needed
+                break;
+            default:
+                throw new Error(`Unsupported account type: ${this.accountType}`);
+        }
+    }
+}
+exports.AccountSelectorVo = AccountSelectorVo;
+__decorate([
+    (0, class_validator_1.IsEnum)(enum_1.AccountOwnerType),
+    (0, class_validator_1.IsNotEmpty)(),
+    __metadata("design:type", String)
+], AccountSelectorVo.prototype, "accountType", void 0);
+__decorate([
+    (0, class_validator_1.IsString)(),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", String)
+], AccountSelectorVo.prototype, "accountId", void 0);
+__decorate([
+    (0, class_validator_1.ValidateNested)(),
+    (0, class_transformer_1.Type)(() => address_value_object_1.Address),
+    (0, class_validator_1.IsOptional)(),
+    __metadata("design:type", address_value_object_1.Address)
+], AccountSelectorVo.prototype, "accountAddress", void 0);
+//# sourceMappingURL=account-selector.vo.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"account-selector.vo.js","sourceRoot":"","sources":["../../../src/value-objects/account-selector.vo.ts"],"names":[],"mappings":"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"}

package/dist/cjs/value-objects/index.d.ts

@@ -5,4 +5,5 @@ export * from './token-unit.value-object';
 export * from './token-transaction-input.vo';
 export * from './token-transaction-entity-reference-input.vo';
 export * from './signed-tx-data.vo';
+export * from './account-selector.vo';
 //# sourceMappingURL=index.d.ts.map

package/dist/cjs/value-objects/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/value-objects/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAG1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/value-objects/index.ts"],"names":[],"mappings":"AACA,cAAc,wBAAwB,CAAC;AACvC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,uCAAuC,CAAC;AACtD,cAAc,2BAA2B,CAAC;AAG1C,cAAc,8BAA8B,CAAC;AAC7C,cAAc,+CAA+C,CAAC;AAC9D,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC"}

package/dist/cjs/value-objects/index.js

@@ -23,4 +23,5 @@ __exportStar(require("./token-unit.value-object"), exports);
 __exportStar(require("./token-transaction-input.vo"), exports);
 __exportStar(require("./token-transaction-entity-reference-input.vo"), exports);
 __exportStar(require("./signed-tx-data.vo"), exports);
+__exportStar(require("./account-selector.vo"), exports);
 //# sourceMappingURL=index.js.map