@explorins/pers-shared 2.1.40 → 2.1.41

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@explorins/pers-shared",
-  "version": "2.1.40",
+  "version": "2.1.41",
   "scripts": {
     "clean": "find dist -type f -delete 2>/dev/null || true",
     "build:esm": "tsc -p tsconfig.esm.json",