@explorins/pers-shared 2.1.35 → 2.1.37

package/dist/esm/shared-patterns/enums/lambda.enum.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Lambda function enums for internal microservice communication
+ * Used across multiple domains for lambda-based orchestration
+ */
+/**
+ * Domain enum for Lambda function names
+ * Contains business-meaningful function categories
+ */
+export declare enum LambdaFunctionName {
+    TRANSACTION = "transaction"
+}
+/**
+ * Domain enum for specific invokable Lambda functions
+ * Represents the business operations available through Lambda
+ */
+export declare enum LambdaInvokableFunctionName {
+    RUN_TRANSACTION_ASYNC = "runTransactionAsync",
+    SUBMIT_SIGNED_TRANSACTION = "submitSignedTransaction"
+}
+/**
+ * Domain enum for Lambda invocation types
+ * Business perspective on synchronous vs asynchronous operations
+ */
+export declare enum LambdaInvocationType {
+    SYNCHRONOUS = "RequestResponse",
+    ASYNCHRONOUS = "Event"
+}
+//# sourceMappingURL=lambda.enum.d.ts.map

package/dist/esm/shared-patterns/enums/lambda.enum.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.enum.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/enums/lambda.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,oBAAY,kBAAkB;IAC5B,WAAW,gBAAgB;CAC5B;AAED;;;GAGG;AACH,oBAAY,2BAA2B;IACrC,qBAAqB,wBAAwB;IAC7C,yBAAyB,4BAA4B;CACtD;AAED;;;GAGG;AACH,oBAAY,oBAAoB;IAC9B,WAAW,oBAAoB;IAC/B,YAAY,UAAU;CACvB"}

package/dist/esm/shared-patterns/enums/lambda.enum.js

@@ -0,0 +1,31 @@
+/**
+ * Lambda function enums for internal microservice communication
+ * Used across multiple domains for lambda-based orchestration
+ */
+/**
+ * Domain enum for Lambda function names
+ * Contains business-meaningful function categories
+ */
+export var LambdaFunctionName;
+(function (LambdaFunctionName) {
+    LambdaFunctionName["TRANSACTION"] = "transaction";
+})(LambdaFunctionName || (LambdaFunctionName = {}));
+/**
+ * Domain enum for specific invokable Lambda functions
+ * Represents the business operations available through Lambda
+ */
+export var LambdaInvokableFunctionName;
+(function (LambdaInvokableFunctionName) {
+    LambdaInvokableFunctionName["RUN_TRANSACTION_ASYNC"] = "runTransactionAsync";
+    LambdaInvokableFunctionName["SUBMIT_SIGNED_TRANSACTION"] = "submitSignedTransaction";
+})(LambdaInvokableFunctionName || (LambdaInvokableFunctionName = {}));
+/**
+ * Domain enum for Lambda invocation types
+ * Business perspective on synchronous vs asynchronous operations
+ */
+export var LambdaInvocationType;
+(function (LambdaInvocationType) {
+    LambdaInvocationType["SYNCHRONOUS"] = "RequestResponse";
+    LambdaInvocationType["ASYNCHRONOUS"] = "Event";
+})(LambdaInvocationType || (LambdaInvocationType = {}));
+//# sourceMappingURL=lambda.enum.js.map

package/dist/esm/shared-patterns/enums/lambda.enum.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lambda.enum.js","sourceRoot":"","sources":["../../../../src/shared-patterns/enums/lambda.enum.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;GAGG;AACH,MAAM,CAAN,IAAY,kBAEX;AAFD,WAAY,kBAAkB;IAC5B,iDAA2B,CAAA;AAC7B,CAAC,EAFW,kBAAkB,KAAlB,kBAAkB,QAE7B;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,2BAGX;AAHD,WAAY,2BAA2B;IACrC,4EAA6C,CAAA;IAC7C,oFAAqD,CAAA;AACvD,CAAC,EAHW,2BAA2B,KAA3B,2BAA2B,QAGtC;AAED;;;GAGG;AACH,MAAM,CAAN,IAAY,oBAGX;AAHD,WAAY,oBAAoB;IAC9B,uDAA+B,CAAA;IAC/B,8CAAsB,CAAA;AACxB,CAAC,EAHW,oBAAoB,KAApB,oBAAoB,QAG/B"}

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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"}

package/dist/esm/shared-patterns/errors/error-factory.js

@@ -0,0 +1,254 @@
+import { 
+// Domain error classes - single source of truth
+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 class ErrorFactory {
+    /**
+     * Resource "not found" patterns
+     * Uses domain classes internally for consistency
+     */
+    static userNotFound(identifier) {
+        return new UserNotFoundError(identifier);
+    }
+    static businessNotFound(identifier) {
+        return new BusinessNotFoundError(identifier);
+    }
+    static tokenNotFound(tokenId) {
+        return new TokenNotFoundError(tokenId);
+    }
+    static transactionNotFound(transactionId) {
+        return new TransactionNotFoundError(transactionId);
+    }
+    static campaignNotFound(campaignId) {
+        return new CampaignNotFoundError(campaignId);
+    }
+    static tokenUnitNotFound(tokenUnitId) {
+        return new TokenUnitNotFoundError(tokenUnitId);
+    }
+    /**
+     * Authentication & Authorization patterns
+     */
+    static authRequired(resource) {
+        return new AuthenticationRequiredError(resource || 'this resource');
+    }
+    static invalidToken(reason) {
+        return new InvalidTokenError(reason);
+    }
+    static tokenExpired() {
+        return new TokenExpiredError();
+    }
+    static forbidden(action, resource) {
+        return new AuthorizationFailedError(action, resource);
+    }
+    /**
+     * Business rule patterns
+     */
+    static geographicRestriction(countryCode, resource) {
+        return new GeographicRestrictionError(countryCode, resource);
+    }
+    static locationRequired(resource) {
+        return new LocationVerificationRequiredError(resource);
+    }
+    static limitReached(limitType) {
+        return new RedemptionLimitReachedError(limitType);
+    }
+    static userStatusRestricted() {
+        return new UserStatusRestrictedError();
+    }
+    /**
+     * Validation patterns
+     */
+    static invalidInput(field, reason) {
+        return new InvalidInputError(field, reason);
+    }
+    static requiredField(field) {
+        return new RequiredFieldError(field);
+    }
+    static invalidFormat(field, expectedFormat) {
+        return new InvalidFormatError(field, expectedFormat);
+    }
+    /**
+     * Financial/Balance patterns
+     */
+    static insufficientBalance(required, available) {
+        return new InsufficientBalanceError(required, available);
+    }
+    /**
+     * Technical/Infrastructure patterns
+     */
+    static systemError(operation, details) {
+        return new SystemError(operation, details);
+    }
+    static externalServiceError(serviceName, operation) {
+        return new ExternalServiceError(serviceName, operation);
+    }
+    static configMissing(configKey) {
+        return new ConfigurationMissingError(configKey);
+    }
+    /**
+     * Token-specific patterns
+     */
+    static tokenNotActive(tokenId) {
+        return new TokenNotActiveError(tokenId);
+    }
+    static tokenIdRequired(tokenType) {
+        return new TokenIdRequiredError(tokenType);
+    }
+    static tokenTypeNotFound(tokenType) {
+        return new TokenTypeNotFoundError(tokenType);
+    }
+    /**
+     * Transaction-specific patterns
+     */
+    static transactionAlreadyCompleted(transactionId, currentStatus) {
+        return new TransactionAlreadyCompletedError(transactionId, currentStatus);
+    }
+    static transactionNotPending(transactionId, currentStatus) {
+        return new TransactionNotPendingError(transactionId, currentStatus);
+    }
+    static transactionValidation(field, reason) {
+        return new TransactionValidationError(field, reason);
+    }
+    /**
+     * Signing account patterns
+     */
+    static signingAccountValidation(field, reason) {
+        return new SigningAccountValidationError(field, reason);
+    }
+    static signingAccountNotFound(identifier) {
+        return new SigningAccountNotFoundError(identifier);
+    }
+    static signingAccountAlreadyExists(accountAddress) {
+        return new SigningAccountAlreadyExistsError(accountAddress);
+    }
+    static keyGeneration(reason) {
+        return new KeyGenerationError(reason);
+    }
+    /**
+     * Wallet patterns
+     */
+    static walletNotFound(ownerAddress) {
+        return new WalletNotFoundError(ownerAddress);
+    }
+    static walletMissingSigning(walletAddress, reason) {
+        return new WalletMissingSigningError(walletAddress, reason);
+    }
+    static smartWalletProcessing(reason) {
+        return new SmartWalletProcessingError(reason);
+    }
+    /**
+     * Business patterns
+     */
+    static businessNotMinter(businessId, tokenAddress) {
+        return new BusinessNotMinterError(businessId, tokenAddress);
+    }
+    /**
+     * Validation patterns
+     */
+    static unexpectedValidationScenario(context) {
+        return new UnexpectedValidationScenarioError(context);
+    }
+}
+/**
+ * Convenient shortcut object for the most commonly used error patterns
+ * Provides clean, discoverable API for NestJS applications
+ */
+export const Errors = {
+    // Resource not found
+    userNotFound: (id) => ErrorFactory.userNotFound(id),
+    businessNotFound: (id) => ErrorFactory.businessNotFound(id),
+    tokenNotFound: (id) => ErrorFactory.tokenNotFound(id),
+    tokenUnitNotFound: (id) => ErrorFactory.tokenUnitNotFound(id),
+    transactionNotFound: (id) => ErrorFactory.transactionNotFound(id),
+    campaignNotFound: (id) => ErrorFactory.campaignNotFound(id),
+    // Authentication
+    authRequired: (resource) => ErrorFactory.authRequired(resource),
+    invalidToken: (reason) => ErrorFactory.invalidToken(reason),
+    tokenExpired: () => ErrorFactory.tokenExpired(),
+    forbidden: (action, resource) => ErrorFactory.forbidden(action, resource),
+    // Business rules
+    geographicRestriction: (countryCode, resource) => ErrorFactory.geographicRestriction(countryCode, resource),
+    locationRequired: (resource) => ErrorFactory.locationRequired(resource),
+    limitReached: (limitType) => ErrorFactory.limitReached(limitType),
+    userStatusRestricted: () => ErrorFactory.userStatusRestricted(),
+    // Validation
+    invalidInput: (field, reason) => ErrorFactory.invalidInput(field, reason),
+    requiredField: (field) => ErrorFactory.requiredField(field),
+    invalidFormat: (field, format) => ErrorFactory.invalidFormat(field, format),
+    // Financial
+    insufficientBalance: (required, available) => ErrorFactory.insufficientBalance(required, available),
+    // Technical
+    systemError: (operation, details) => ErrorFactory.systemError(operation, details),
+    externalServiceError: (service, operation) => ErrorFactory.externalServiceError(service, operation),
+    configMissing: (key) => ErrorFactory.configMissing(key),
+    // Token specific
+    tokenNotActive: (id) => ErrorFactory.tokenNotActive(id),
+    tokenIdRequired: (type) => ErrorFactory.tokenIdRequired(type),
+    tokenTypeNotFound: (type) => ErrorFactory.tokenTypeNotFound(type),
+    // Transaction specific
+    transactionAlreadyCompleted: (id, status) => ErrorFactory.transactionAlreadyCompleted(id, status),
+    transactionNotPending: (id, status) => ErrorFactory.transactionNotPending(id, status),
+    transactionValidation: (field, reason) => ErrorFactory.transactionValidation(field, reason),
+    // Signing account
+    signingAccountValidation: (field, reason) => ErrorFactory.signingAccountValidation(field, reason),
+    signingAccountNotFound: (id) => ErrorFactory.signingAccountNotFound(id),
+    signingAccountAlreadyExists: (address) => ErrorFactory.signingAccountAlreadyExists(address),
+    keyGeneration: (reason) => ErrorFactory.keyGeneration(reason),
+    // Wallet
+    walletNotFound: (address) => ErrorFactory.walletNotFound(address),
+    walletMissingSigning: (address, reason) => ErrorFactory.walletMissingSigning(address, reason),
+    smartWalletProcessing: (reason) => ErrorFactory.smartWalletProcessing(reason),
+    // Business
+    businessNotMinter: (businessId, tokenAddress) => ErrorFactory.businessNotMinter(businessId, tokenAddress),
+    // Validation
+    unexpectedValidationScenario: (context) => ErrorFactory.unexpectedValidationScenario(context)
+};
+/**
+ * Advanced Error Builder for complex scenarios
+ * Still references domain classes when possible
+ */
+export class ErrorBuilder {
+    config = {};
+    static create() {
+        return new ErrorBuilder();
+    }
+    /**
+     * Use a specific domain error class
+     */
+    useClass(errorClass, ...params) {
+        this.config.errorClass = errorClass;
+        this.config.params = params;
+        return this;
+    }
+    /**
+     * Build the error instance
+     */
+    build() {
+        if (this.config.errorClass && this.config.params) {
+            return new this.config.errorClass(...this.config.params);
+        }
+        throw new Error('ErrorBuilder: No error class specified');
+    }
+    // Convenience methods for common error types
+    buildUserNotFound(id) {
+        return new UserNotFoundError(id);
+    }
+    buildBusinessNotFound(id) {
+        return new BusinessNotFoundError(id);
+    }
+    buildAuthRequired(resource) {
+        return new AuthenticationRequiredError(resource);
+    }
+}
+//# sourceMappingURL=error-factory.js.map

package/dist/esm/shared-patterns/errors/error-factory.js.map

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

package/dist/esm/shared-patterns/exceptions/base/error-classification-enums.d.ts

@@ -0,0 +1,118 @@
+/**
+ * Error Classification Enums and Interfaces
+ *
+ * This file defines the error categorization system used throughout the application.
+ *
+ * 🎯 DEVELOPER GUIDANCE:
+ *
+ * When creating errors, choose the appropriate category:
+ *
+ * 1. DOMAIN_RULE: Business logic violations
+ *    → Use BusinessLogicError subclasses (e.g., TokenTypeNotFoundError)
+ *
+ * 2. TECHNICAL: Application/config issues
+ *    → Use TechnicalError.withMessage() for meaningful technical errors
+ *
+ * 3. VALIDATION: Input format/validation failures
+ *    → Let NestJS validation decorators handle these automatically
+ *
+ * 4. INFRASTRUCTURE: External system failures
+ *    → These are usually classified automatically from generic Error() instances
+ *
+ * 5. SECURITY: Auth/authorization issues
+ *    → Use NestJS guards and filters for consistent security errors
+ *
+ * 💡 TIP: Prefer structured errors (BusinessLogicError/TechnicalError) over generic Error()
+ *         for better user experience and debugging capability.
+ *
+ * 📊 QUICK REFERENCE TABLE:
+ * ┌─────────────────┬─────────────┬─────────────────────────────────────┬───────────┐
+ * │ Category        │ HTTP Status │ Example                             │ Retryable │
+ * ├─────────────────┼─────────────┼─────────────────────────────────────┼───────────┤
+ * │ VALIDATION      │ 400         │ "Email format invalid"              │ No        │
+ * │ DOMAIN_RULE     │ 422         │ "Insufficient balance"              │ No        │
+ * │ TECHNICAL       │ 422         │ "Invalid file format"               │ Maybe     │
+ * │ INFRASTRUCTURE  │ 503         │ "Database connection failed"        │ Yes       │
+ * │ SECURITY        │ 403         │ "Access denied"                     │ No        │
+ * │ RATE_LIMIT      │ 429         │ "API rate limit exceeded"           │ Yes       │
+ * │ TIMEOUT         │ 504         │ "Request timeout"                   │ Yes       │
+ * │ UNKNOWN         │ 500         │ Generic Error() instances           │ Yes       │
+ * └─────────────────┴─────────────┴─────────────────────────────────────┴───────────┘
+ */
+/**
+ * Error severity levels for prioritization and alerting
+ *
+ * Determines the urgency of response and escalation procedures:
+ * - Monitoring alert thresholds
+ * - On-call escalation policies
+ * - SLA response times
+ * - Business impact assessment
+ */
+export declare enum ErrorSeverity {
+    /**
+     * Low severity - Minor issues, degraded experience but service functional
+     * Examples: Optional feature failures, cosmetic issues, non-critical warnings
+     * Response Time: 24-48 hours
+     * Escalation: Development team during business hours
+     * Business Impact: Minimal
+     */
+    LOW = "LOW",
+    /**
+     * Medium severity - Noticeable issues, some functionality impaired
+     * Examples: Performance degradation, secondary feature failures, data sync delays
+     * Response Time: 4-8 hours
+     * Escalation: Development team within same day
+     * Business Impact: Moderate
+     */
+    MEDIUM = "MEDIUM",
+    /**
+     * High severity - Significant issues, core functionality impaired
+     * Examples: Payment failures, authentication issues, critical feature outages
+     * Response Time: 1-2 hours
+     * Escalation: Immediate development team notification
+     * Business Impact: High
+     */
+    HIGH = "HIGH",
+    /**
+     * Critical severity - System down, major business impact
+     * Examples: Complete service outage, data corruption, security breaches
+     * Response Time: Immediate (< 15 minutes)
+     * Escalation: Page on-call engineer, notify leadership
+     * Business Impact: Severe
+     */
+    CRITICAL = "CRITICAL"
+}
+/**
+ * API error response format including correlation tracking
+ */
+export interface ApiErrorResponse {
+    code: string;
+    domain: string;
+    message: string;
+    developerMessage?: string;
+    action?: string;
+    timestamp: string;
+    category: string;
+    correlationId: string;
+    retryable: boolean;
+    severity: ErrorSeverity;
+}
+/**
+ * HTTP Status codes used by our error classification system
+ *
+ * Centralized here to maintain consistency across error classification
+ * and avoid duplication with NestJS HttpStatus values.
+ */
+export declare enum ErrorHttpStatus {
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    CONFLICT = 409,
+    UNPROCESSABLE_ENTITY = 422,
+    TOO_MANY_REQUESTS = 429,
+    INTERNAL_SERVER_ERROR = 500,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504
+}
+//# sourceMappingURL=error-classification-enums.d.ts.map

package/dist/esm/shared-patterns/exceptions/base/error-classification-enums.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"error-classification-enums.d.ts","sourceRoot":"","sources":["../../../../../src/shared-patterns/exceptions/base/error-classification-enums.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAwCG;AAKH;;;;;;;;GAQG;AACH,oBAAY,aAAa;IACvB;;;;;;OAMG;IACH,GAAG,QAAQ;IAEX;;;;;;OAMG;IACH,MAAM,WAAW;IAEjB;;;;;;OAMG;IACH,IAAI,SAAS;IAEb;;;;;;OAMG;IACH,QAAQ,aAAa;CACtB;AAID;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,OAAO,EAAE,MAAM,CAAC;IAChB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,QAAQ,EAAE,aAAa,CAAC;CACzB;AAID;;;;;GAKG;AACH,oBAAY,eAAe;IACzB,WAAW,MAAM;IACjB,YAAY,MAAM;IAClB,SAAS,MAAM;IACf,SAAS,MAAM;IACf,QAAQ,MAAM;IACd,oBAAoB,MAAM;IAC1B,iBAAiB,MAAM;IACvB,qBAAqB,MAAM;IAC3B,mBAAmB,MAAM;IACzB,eAAe,MAAM;CACtB"}