@explorins/pers-shared 2.1.2 → 2.1.5

package/dist/esm/errors/domains/wallet-errors.js

@@ -0,0 +1,22 @@
+import { HttpStatus } from '@nestjs/common';
+import { BusinessLogicError } from '../base-business-error';
+import { CommonErrorCodes, ErrorDomains } from '../error-codes';
+/**
+ * Wallet domain business errors
+ */
+export class WalletMissingSigningError extends BusinessLogicError {
+    constructor(walletAddress, reason) {
+        super(CommonErrorCodes.WALLET_MISSING_SIGNING, ErrorDomains.WALLET, 'Wallet requires signing account setup', `Wallet ${walletAddress} missing signing: ${reason}`, HttpStatus.UNPROCESSABLE_ENTITY, 'Please set up signing account for this wallet');
+    }
+}
+export class WalletNotFoundError extends BusinessLogicError {
+    constructor(ownerAddress) {
+        super(CommonErrorCodes.WALLET_NOT_FOUND, ErrorDomains.WALLET, 'No wallet found for this address', `No wallet found for owner address: ${ownerAddress}`, HttpStatus.NOT_FOUND, 'Please create a wallet first');
+    }
+}
+export class SmartWalletProcessingError extends BusinessLogicError {
+    constructor(reason) {
+        super(CommonErrorCodes.SMART_WALLET_PROCESSING_FAILED, ErrorDomains.WALLET, 'Smart wallet transaction processing failed', `Smart wallet processing failed: ${reason}`, HttpStatus.UNPROCESSABLE_ENTITY, 'Please try with a standard wallet transaction');
+    }
+}
+//# sourceMappingURL=wallet-errors.js.map

package/dist/esm/errors/domains/wallet-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wallet-errors.js","sourceRoot":"","sources":["../../../../src/errors/domains/wallet-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,wBAAwB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEhE;;GAEG;AAEH,MAAM,OAAO,yBAA0B,SAAQ,kBAAkB;IAC/D,YAAY,aAAqB,EAAE,MAAc;QAC/C,KAAK,CACH,gBAAgB,CAAC,sBAAsB,EACvC,YAAY,CAAC,MAAM,EACnB,uCAAuC,EACvC,UAAU,aAAa,qBAAqB,MAAM,EAAE,EACpD,UAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,mBAAoB,SAAQ,kBAAkB;IACzD,YAAY,YAAoB;QAC9B,KAAK,CACH,gBAAgB,CAAC,gBAAgB,EACjC,YAAY,CAAC,MAAM,EACnB,kCAAkC,EAClC,sCAAsC,YAAY,EAAE,EACpD,UAAU,CAAC,SAAS,EACpB,8BAA8B,CAC/B,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,kBAAkB;IAChE,YAAY,MAAc;QACxB,KAAK,CACH,gBAAgB,CAAC,8BAA8B,EAC/C,YAAY,CAAC,MAAM,EACnB,4CAA4C,EAC5C,mCAAmC,MAAM,EAAE,EAC3C,UAAU,CAAC,oBAAoB,EAC/B,+CAA+C,CAChD,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/errors/error-codes.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Error Codes extracted from actual domain error classes
+ *
+ * This object maps all error codes from domain error classes to provide
+ * type-safe constants for API documentation and usage.
+ *
+ * Using object pattern for better performance and developer experience:
+ * - Single export vs 50+ individual exports
+ * - Namespaced access: CommonErrorCodes.USER_NOT_FOUND
+ * - Better tree-shaking and bundle optimization
+ * - Cleaner type definition
+ */
+export declare const CommonErrorCodes: {
+    readonly USER_NOT_FOUND: "USER_NOT_FOUND";
+    readonly USER_ALREADY_EXISTS: "USER_ALREADY_EXISTS";
+    readonly USER_NOT_AUTHORIZED: "USER_NOT_AUTHORIZED";
+    readonly TOKEN_NOT_FOUND: "TOKEN_NOT_FOUND";
+    readonly TOKEN_NOT_ACTIVE: "TOKEN_NOT_ACTIVE";
+    readonly TOKEN_ID_REQUIRED: "TOKEN_ID_REQUIRED";
+    readonly TOKEN_TYPE_NOT_FOUND: "TOKEN_TYPE_NOT_FOUND";
+    readonly WALLET_MISSING_SIGNING: "WALLET_MISSING_SIGNING";
+    readonly WALLET_NOT_FOUND: "WALLET_NOT_FOUND";
+    readonly SMART_WALLET_PROCESSING_FAILED: "SMART_WALLET_PROCESSING_FAILED";
+    readonly INSUFFICIENT_BALANCE: "INSUFFICIENT_BALANCE";
+    readonly CONTRACT_NOT_FOUND: "CONTRACT_NOT_FOUND";
+    readonly BUSINESS_NOT_MINTER: "BUSINESS_NOT_MINTER";
+    readonly TRANSACTION_NOT_FOUND: "TRANSACTION_NOT_FOUND";
+    readonly TRANSACTION_SIGNATURE_INVALID: "TRANSACTION_SIGNATURE_INVALID";
+    readonly TRANSACTION_ALREADY_COMPLETED: "TRANSACTION_ALREADY_COMPLETED";
+    readonly TRANSACTION_NOT_PENDING: "TRANSACTION_NOT_PENDING";
+    readonly TRANSACTION_VALIDATION_ERROR: "TRANSACTION_VALIDATION_ERROR";
+    readonly UNEXPECTED_VALIDATION_SCENARIO: "UNEXPECTED_VALIDATION_SCENARIO";
+    readonly TECHNICAL_ERROR: "TECHNICAL_ERROR";
+    readonly ORCHESTRATION_ERROR: "ORCHESTRATION_ERROR";
+    readonly SYSTEM_ERROR: "SYSTEM_ERROR";
+    readonly EXTERNAL_SERVICE_ERROR: "EXTERNAL_SERVICE_ERROR";
+    readonly AUTHENTICATION_REQUIRED: "AUTHENTICATION_REQUIRED";
+    readonly AUTHORIZATION_FAILED: "AUTHORIZATION_FAILED";
+    readonly INTERNAL_ERROR: "INTERNAL_ERROR";
+    readonly VALIDATION_ERROR: "VALIDATION_ERROR";
+    readonly BUSINESS_RULE_VIOLATION: "BUSINESS_RULE_VIOLATION";
+};
+/**
+ * Type-safe union of all error codes
+ *
+ * This provides the same type safety as the individual constants approach
+ * but with better performance through the object pattern.
+ */
+export type CommonErrorCode = typeof CommonErrorCodes[keyof typeof CommonErrorCodes];
+/**
+ * Domain names used in error classification
+ *
+ * Centralized domain strings to ensure consistency across all error classes
+ * and prevent typos in domain names.
+ */
+export declare const ErrorDomains: {
+    readonly USER: "user";
+    readonly TOKEN: "token";
+    readonly WALLET: "wallet";
+    readonly BUSINESS: "business";
+    readonly BALANCE: "balance";
+    readonly CONTRACT: "contract";
+    readonly TRANSACTION: "transaction";
+    readonly VALIDATION: "validation";
+    readonly SYSTEM: "system";
+    readonly AUTHENTICATION: "authentication";
+    readonly EXTERNAL: "external";
+};
+/**
+ * Type-safe union of all domain names
+ */
+export type ErrorDomain = typeof ErrorDomains[keyof typeof ErrorDomains];
+//# sourceMappingURL=error-codes.d.ts.map

package/dist/esm/errors/error-codes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.d.ts","sourceRoot":"","sources":["../../../src/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAgDnB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,MAAM,eAAe,GAAG,OAAO,gBAAgB,CAAC,MAAM,OAAO,gBAAgB,CAAC,CAAC;AAErF;;;;;GAKG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;CAYf,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,OAAO,YAAY,CAAC,MAAM,OAAO,YAAY,CAAC,CAAC"}

package/dist/esm/errors/error-codes.js

@@ -0,0 +1,72 @@
+/**
+ * Error Codes extracted from actual domain error classes
+ *
+ * This object maps all error codes from domain error classes to provide
+ * type-safe constants for API documentation and usage.
+ *
+ * Using object pattern for better performance and developer experience:
+ * - Single export vs 50+ individual exports
+ * - Namespaced access: CommonErrorCodes.USER_NOT_FOUND
+ * - Better tree-shaking and bundle optimization
+ * - Cleaner type definition
+ */
+export const CommonErrorCodes = {
+    // User domain
+    USER_NOT_FOUND: 'USER_NOT_FOUND',
+    USER_ALREADY_EXISTS: 'USER_ALREADY_EXISTS',
+    USER_NOT_AUTHORIZED: 'USER_NOT_AUTHORIZED',
+    // Token domain
+    TOKEN_NOT_FOUND: 'TOKEN_NOT_FOUND',
+    TOKEN_NOT_ACTIVE: 'TOKEN_NOT_ACTIVE',
+    TOKEN_ID_REQUIRED: 'TOKEN_ID_REQUIRED',
+    TOKEN_TYPE_NOT_FOUND: 'TOKEN_TYPE_NOT_FOUND',
+    // Wallet domain
+    WALLET_MISSING_SIGNING: 'WALLET_MISSING_SIGNING',
+    WALLET_NOT_FOUND: 'WALLET_NOT_FOUND',
+    SMART_WALLET_PROCESSING_FAILED: 'SMART_WALLET_PROCESSING_FAILED',
+    // Balance domain
+    INSUFFICIENT_BALANCE: 'INSUFFICIENT_BALANCE',
+    // Contract domain
+    CONTRACT_NOT_FOUND: 'CONTRACT_NOT_FOUND',
+    // Business domain
+    BUSINESS_NOT_MINTER: 'BUSINESS_NOT_MINTER',
+    // Transaction domain
+    TRANSACTION_NOT_FOUND: 'TRANSACTION_NOT_FOUND',
+    TRANSACTION_SIGNATURE_INVALID: 'TRANSACTION_SIGNATURE_INVALID',
+    TRANSACTION_ALREADY_COMPLETED: 'TRANSACTION_ALREADY_COMPLETED',
+    TRANSACTION_NOT_PENDING: 'TRANSACTION_NOT_PENDING',
+    TRANSACTION_VALIDATION_ERROR: 'TRANSACTION_VALIDATION_ERROR',
+    UNEXPECTED_VALIDATION_SCENARIO: 'UNEXPECTED_VALIDATION_SCENARIO',
+    // Technical errors
+    TECHNICAL_ERROR: 'TECHNICAL_ERROR',
+    ORCHESTRATION_ERROR: 'ORCHESTRATION_ERROR',
+    // System errors
+    SYSTEM_ERROR: 'SYSTEM_ERROR',
+    EXTERNAL_SERVICE_ERROR: 'EXTERNAL_SERVICE_ERROR',
+    AUTHENTICATION_REQUIRED: 'AUTHENTICATION_REQUIRED',
+    AUTHORIZATION_FAILED: 'AUTHORIZATION_FAILED',
+    // Generic fallbacks
+    INTERNAL_ERROR: 'INTERNAL_ERROR',
+    VALIDATION_ERROR: 'VALIDATION_ERROR',
+    BUSINESS_RULE_VIOLATION: 'BUSINESS_RULE_VIOLATION'
+};
+/**
+ * Domain names used in error classification
+ *
+ * Centralized domain strings to ensure consistency across all error classes
+ * and prevent typos in domain names.
+ */
+export const ErrorDomains = {
+    USER: 'user',
+    TOKEN: 'token',
+    WALLET: 'wallet',
+    BUSINESS: 'business',
+    BALANCE: 'balance',
+    CONTRACT: 'contract',
+    TRANSACTION: 'transaction',
+    VALIDATION: 'validation',
+    SYSTEM: 'system',
+    AUTHENTICATION: 'authentication',
+    EXTERNAL: 'external'
+};
+//# sourceMappingURL=error-codes.js.map

package/dist/esm/errors/error-codes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-codes.js","sourceRoot":"","sources":["../../../src/errors/error-codes.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,MAAM,CAAC,MAAM,gBAAgB,GAAG;IAC9B,cAAc;IACd,cAAc,EAAE,gBAAgB;IAChC,mBAAmB,EAAE,qBAAqB;IAC1C,mBAAmB,EAAE,qBAAqB;IAE1C,eAAe;IACf,eAAe,EAAE,iBAAiB;IAClC,gBAAgB,EAAE,kBAAkB;IACpC,iBAAiB,EAAE,mBAAmB;IACtC,oBAAoB,EAAE,sBAAsB;IAE5C,gBAAgB;IAChB,sBAAsB,EAAE,wBAAwB;IAChD,gBAAgB,EAAE,kBAAkB;IACpC,8BAA8B,EAAE,gCAAgC;IAEhE,iBAAiB;IACjB,oBAAoB,EAAE,sBAAsB;IAE5C,kBAAkB;IAClB,kBAAkB,EAAE,oBAAoB;IAExC,kBAAkB;IAClB,mBAAmB,EAAE,qBAAqB;IAE1C,qBAAqB;IACrB,qBAAqB,EAAE,uBAAuB;IAC9C,6BAA6B,EAAE,+BAA+B;IAC9D,6BAA6B,EAAE,+BAA+B;IAC9D,uBAAuB,EAAE,yBAAyB;IAClD,4BAA4B,EAAE,8BAA8B;IAC5D,8BAA8B,EAAE,gCAAgC;IAEhE,mBAAmB;IACnB,eAAe,EAAE,iBAAiB;IAClC,mBAAmB,EAAE,qBAAqB;IAE1C,gBAAgB;IAChB,YAAY,EAAE,cAAc;IAC5B,sBAAsB,EAAE,wBAAwB;IAChD,uBAAuB,EAAE,yBAAyB;IAClD,oBAAoB,EAAE,sBAAsB;IAE5C,oBAAoB;IACpB,cAAc,EAAE,gBAAgB;IAChC,gBAAgB,EAAE,kBAAkB;IACpC,uBAAuB,EAAE,yBAAyB;CAC1C,CAAC;AAUX;;;;;GAKG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG;IAC1B,IAAI,EAAE,MAAM;IACZ,KAAK,EAAE,OAAO;IACd,MAAM,EAAE,QAAQ;IAChB,QAAQ,EAAE,UAAU;IACpB,OAAO,EAAE,SAAS;IAClB,QAAQ,EAAE,UAAU;IACpB,WAAW,EAAE,aAAa;IAC1B,UAAU,EAAE,YAAY;IACxB,MAAM,EAAE,QAAQ;IAChB,cAAc,EAAE,gBAAgB;IAChC,QAAQ,EAAE,UAAU;CACZ,CAAC"}

package/dist/esm/errors/index.d.ts

@@ -0,0 +1,14 @@
+export { BusinessLogicError } from './base-business-error';
+export * from './technical-errors';
+export * from './transaction-errors';
+export * from './base/error-classification-enums';
+export * from './error-codes';
+export * from './domains/token-errors';
+export * from './domains/user-errors';
+export * from './domains/wallet-errors';
+export * from './domains/business-errors';
+export * from './domains/balance-errors';
+export * from './domains/contract-errors';
+export * from './domains/system-errors';
+export * from './domains/authentication-errors';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/errors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,mCAAmC,CAAC;AAKlD,cAAc,eAAe,CAAC;AAG9B,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/esm/errors/index.js

@@ -0,0 +1,19 @@
+// Base error classes and interfaces
+export { BusinessLogicError } from './base-business-error';
+export * from './technical-errors';
+export * from './transaction-errors';
+// Error classification system
+export * from './base/error-classification-enums';
+// Note: Error classification system moved to @explorins/pers-shared-patterns
+// Error codes extracted from domain classes
+export * from './error-codes';
+// Domain-specific errors (organized by domain)
+export * from './domains/token-errors';
+export * from './domains/user-errors';
+export * from './domains/wallet-errors';
+export * from './domains/business-errors';
+export * from './domains/balance-errors';
+export * from './domains/contract-errors';
+export * from './domains/system-errors';
+export * from './domains/authentication-errors';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/errors/index.ts"],"names":[],"mappings":"AAAA,oCAAoC;AACpC,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,cAAc,oBAAoB,CAAC;AACnC,cAAc,sBAAsB,CAAC;AAErC,8BAA8B;AAC9B,cAAc,mCAAmC,CAAC;AAElD,6EAA6E;AAE7E,4CAA4C;AAC5C,cAAc,eAAe,CAAC;AAE9B,+CAA+C;AAC/C,cAAc,wBAAwB,CAAC;AACvC,cAAc,uBAAuB,CAAC;AACtC,cAAc,yBAAyB,CAAC;AACxC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,0BAA0B,CAAC;AACzC,cAAc,2BAA2B,CAAC;AAC1C,cAAc,yBAAyB,CAAC;AACxC,cAAc,iCAAiC,CAAC"}

package/dist/esm/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/esm/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/esm/errors/technical-errors.js

@@ -0,0 +1,87 @@
+import { HttpException, HttpStatus } from '@nestjs/common';
+import { ErrorCategory } from './base/error-classification-enums';
+import { CommonErrorCodes } from './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
+ */
+export class TechnicalError extends HttpException {
+    correlationId;
+    originalError;
+    preserveMessage;
+    constructor(message, originalError, correlationId, httpStatus = 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: CommonErrorCodes.TECHNICAL_ERROR,
+            message: clientMessage,
+            correlationId,
+            timestamp: new Date().toISOString(),
+            category: 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, 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, 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/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/esm/errors/transaction-errors.d.ts

@@ -0,0 +1,17 @@
+import { BusinessLogicError } from './base-business-error';
+/**
+ * Transaction domain business errors
+ */
+export declare class TransactionAlreadyCompletedError extends BusinessLogicError {
+    constructor(transactionId: string, currentStatus: string);
+}
+export declare class TransactionNotPendingError extends BusinessLogicError {
+    constructor(transactionId: string, currentStatus: string);
+}
+export declare class TransactionValidationError extends BusinessLogicError {
+    constructor(field: string, reason: string);
+}
+export declare class UnexpectedValidationScenarioError extends BusinessLogicError {
+    constructor(scenario: string);
+}
+//# sourceMappingURL=transaction-errors.d.ts.map

package/dist/esm/errors/transaction-errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-errors.d.ts","sourceRoot":"","sources":["../../../src/errors/transaction-errors.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAG3D;;GAEG;AACH,qBAAa,gCAAiC,SAAQ,kBAAkB;gBAC1D,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAUzD;AAED,qBAAa,0BAA2B,SAAQ,kBAAkB;gBACpD,aAAa,EAAE,MAAM,EAAE,aAAa,EAAE,MAAM;CAUzD;AAED,qBAAa,0BAA2B,SAAQ,kBAAkB;gBACpD,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;CAU1C;AAED,qBAAa,iCAAkC,SAAQ,kBAAkB;gBAC3D,QAAQ,EAAE,MAAM;CAU7B"}

package/dist/esm/errors/transaction-errors.js

@@ -0,0 +1,27 @@
+import { HttpStatus } from '@nestjs/common';
+import { BusinessLogicError } from './base-business-error';
+import { CommonErrorCodes, ErrorDomains } from './error-codes';
+/**
+ * Transaction domain business errors
+ */
+export class TransactionAlreadyCompletedError extends BusinessLogicError {
+    constructor(transactionId, currentStatus) {
+        super(CommonErrorCodes.TRANSACTION_ALREADY_COMPLETED, ErrorDomains.TRANSACTION, 'This transaction has already been completed', `Transaction ${transactionId} is in status: ${currentStatus}`, HttpStatus.CONFLICT, 'Please refresh and check the transaction status');
+    }
+}
+export class TransactionNotPendingError extends BusinessLogicError {
+    constructor(transactionId, currentStatus) {
+        super(CommonErrorCodes.TRANSACTION_NOT_PENDING, ErrorDomains.TRANSACTION, 'Transaction is not in a pending state', `Transaction ${transactionId} has status: ${currentStatus}, expected: pending`, HttpStatus.CONFLICT, 'Please check the current transaction status');
+    }
+}
+export class TransactionValidationError extends BusinessLogicError {
+    constructor(field, reason) {
+        super(CommonErrorCodes.TRANSACTION_VALIDATION_ERROR, ErrorDomains.TRANSACTION, `Transaction validation failed: ${reason}`, `Field '${field}' validation failed: ${reason}`, HttpStatus.BAD_REQUEST, 'Please check the transaction data and try again');
+    }
+}
+export class UnexpectedValidationScenarioError extends BusinessLogicError {
+    constructor(scenario) {
+        super(CommonErrorCodes.UNEXPECTED_VALIDATION_SCENARIO, ErrorDomains.VALIDATION, 'Unexpected validation scenario encountered', `Unexpected validation scenario: ${scenario}`, HttpStatus.INTERNAL_SERVER_ERROR, 'Please contact support');
+    }
+}
+//# sourceMappingURL=transaction-errors.js.map

package/dist/esm/errors/transaction-errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"transaction-errors.js","sourceRoot":"","sources":["../../../src/errors/transaction-errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE/D;;GAEG;AACH,MAAM,OAAO,gCAAiC,SAAQ,kBAAkB;IACtE,YAAY,aAAqB,EAAE,aAAqB;QACtD,KAAK,CACH,gBAAgB,CAAC,6BAA6B,EAC9C,YAAY,CAAC,WAAW,EACxB,6CAA6C,EAC7C,eAAe,aAAa,kBAAkB,aAAa,EAAE,EAC7D,UAAU,CAAC,QAAQ,EACnB,iDAAiD,CAClD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,kBAAkB;IAChE,YAAY,aAAqB,EAAE,aAAqB;QACtD,KAAK,CACH,gBAAgB,CAAC,uBAAuB,EACxC,YAAY,CAAC,WAAW,EACxB,uCAAuC,EACvC,eAAe,aAAa,gBAAgB,aAAa,qBAAqB,EAC9E,UAAU,CAAC,QAAQ,EACnB,6CAA6C,CAC9C,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,0BAA2B,SAAQ,kBAAkB;IAChE,YAAY,KAAa,EAAE,MAAc;QACvC,KAAK,CACH,gBAAgB,CAAC,4BAA4B,EAC7C,YAAY,CAAC,WAAW,EACxB,kCAAkC,MAAM,EAAE,EAC1C,UAAU,KAAK,wBAAwB,MAAM,EAAE,EAC/C,UAAU,CAAC,WAAW,EACtB,iDAAiD,CAClD,CAAC;IACJ,CAAC;CACF;AAED,MAAM,OAAO,iCAAkC,SAAQ,kBAAkB;IACvE,YAAY,QAAgB;QAC1B,KAAK,CACH,gBAAgB,CAAC,8BAA8B,EAC/C,YAAY,CAAC,UAAU,EACvB,4CAA4C,EAC5C,mCAAmC,QAAQ,EAAE,EAC7C,UAAU,CAAC,qBAAqB,EAChC,wBAAwB,CACzB,CAAC;IACJ,CAAC;CACF"}

package/dist/esm/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/esm/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/esm/index.js

@@ -3,10 +3,11 @@
 // Core domain contracts
 export * from './enum';
 export * from './value-objects';
-export * from './functions';
 export * from './interfaces';
 export * from './types';
 export * from './dto';
+// Error handling system
+export * from './errors';
 // Backend-only exports (Node.js environment)
 export * from './types/backend';
 // Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns

package/dist/esm/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,aAAa,CAAC;AAC5B,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAEtB,6CAA6C;AAC7C,cAAc,iBAAiB,CAAC;AAEhC,yGAAyG;AACzG,mFAAmF"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,4EAA4E;AAC5E,8FAA8F;AAE9F,wBAAwB;AACxB,cAAc,QAAQ,CAAC;AACvB,cAAc,iBAAiB,CAAC;AAChC,cAAc,cAAc,CAAC;AAC7B,cAAc,SAAS,CAAC;AACxB,cAAc,OAAO,CAAC;AAEtB,wBAAwB;AACxB,cAAc,UAAU,CAAC;AAEzB,6CAA6C;AAC7C,cAAc,iBAAiB,CAAC;AAEhC,yGAAyG;AACzG,mFAAmF"}

package/dist/esm/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/esm/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/esm/interfaces/index.js

@@ -1,8 +1,6 @@
 // Interfaces Barrel - Auto-exports all interfaces
 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';
@@ -12,7 +10,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/esm/interfaces/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,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.js","sourceRoot":"","sources":["../../../src/interfaces/index.ts"],"names":[],"mappings":"AAAA,kDAAkD;AAClD,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/esm/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/esm/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/esm/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/esm/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/esm/types/account-selector.type.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=account-selector.type.js.map

package/dist/esm/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/esm/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/esm/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/esm/types/backend.js

@@ -1,3 +1,3 @@
-// Backend-only types that depend on Node.js modules
+// ✅ CORRECT: Use regular 'export' for runtime values/constants
 export { TRANSACTION_FORMATS } from "@explorins/web3-ts/types";
 //# sourceMappingURL=backend.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../src/types/backend.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,OAAO,EAAE,mBAAmB,EAAqB,MAAM,0BAA0B,CAAC"}
+{"version":3,"file":"backend.js","sourceRoot":"","sources":["../../../src/types/backend.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/esm/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/esm/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/esm/types/index.js

@@ -3,4 +3,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.js.map

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

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