@explorins/pers-shared 2.1.36 → 2.1.37

package/dist/cjs/shared-patterns/utils/error-message.utils.d.ts

@@ -0,0 +1,175 @@
+/**
+ * Standardized error message generators for consistent error handling across applications
+ *
+ * This utility provides reusable message generation functions for common error scenarios:
+ * - Authentication context errors
+ * - Resource not found errors
+ * - Access denied errors
+ * - Validation errors
+ * - Business rule violations
+ * - Database operation errors
+ *
+ * @example
+ * import { generateAuthRequiredMessage, generateNotFoundMessage } from '@explorins/pers-shared-patterns';
+ *
+ * const message = generateAuthRequiredMessage(['user', 'admin']);
+ * // "User or admin authentication required"
+ *
+ * const notFound = generateNotFoundMessage('transaction', 'tx-123');
+ * // "Transaction with identifier 'tx-123' not found"
+ */
+/**
+ * Authentication context types supported across applications
+ */
+export type AuthenticationContext = 'user' | 'business' | 'admin' | 'tenant';
+/**
+ * Resource types commonly used in error messages
+ */
+export type ResourceType = 'user' | 'business' | 'admin' | 'campaign' | 'transaction' | 'redemption' | 'wallet' | 'contract' | 'tenant' | 'token' | 'signing-account';
+/**
+ * Database operation types for error reporting
+ */
+export type DatabaseOperation = 'save' | 'find' | 'delete' | 'update' | 'query';
+/**
+ * Generate standardized authentication required error message
+ * @param requiredContexts - Array of required authentication contexts
+ * @param action - Optional action description (e.g., 'for redemption processing')
+ * @returns Standardized error message
+ */
+export declare function generateAuthRequiredMessage(requiredContexts: AuthenticationContext[], action?: string): string;
+/**
+ * Generate standardized "not found" error message
+ * @param resourceType - Type of resource that was not found
+ * @param identifier - Optional identifier (ID, email, etc.)
+ * @returns Standardized not found message
+ */
+export declare function generateNotFoundMessage(resourceType: ResourceType, identifier?: string): string;
+/**
+ * Generate standardized "access denied" error message
+ * @param action - The action being attempted
+ * @param resource - Optional resource context
+ * @returns Standardized access denied message
+ */
+export declare function generateAccessDeniedMessage(action: string, resource?: string): string;
+/**
+ * Generate standardized validation error message
+ * @param field - Field that failed validation
+ * @param constraint - The validation constraint
+ * @returns Standardized validation message
+ */
+export declare function generateValidationMessage(field: string, constraint: string): string;
+/**
+ * Generate standardized business rule violation message
+ * @param rule - The business rule that was violated
+ * @param context - Optional context information
+ * @returns Standardized business rule message
+ */
+export declare function generateBusinessRuleMessage(rule: string, context?: string): string;
+/**
+ * Generate standardized database error message
+ * @param operation - The database operation that failed
+ * @param resourceType - Type of resource involved
+ * @param details - Optional error details
+ * @returns Standardized database error message
+ */
+export declare function generateDatabaseErrorMessage(operation: DatabaseOperation, resourceType: ResourceType, details?: string): string;
+/**
+ * Generate standardized input validation error message
+ * @param parameter - The parameter that failed validation
+ * @param requirement - What the parameter should meet
+ * @returns Standardized input validation message
+ */
+export declare function generateInputValidationMessage(parameter: string, requirement: string): string;
+/**
+ * Generate standardized operation error message
+ * @param operation - The operation that was attempted
+ * @param reason - Why it failed
+ * @returns Standardized operation error message
+ */
+export declare function generateOperationErrorMessage(operation: string, reason: string): string;
+/**
+ * Common error message constants for quick access
+ */
+export declare const ERROR_MESSAGE_TEMPLATES: {
+    readonly AUTH: {
+        readonly USER_ONLY: () => string;
+        readonly BUSINESS_ONLY: () => string;
+        readonly ADMIN_ONLY: () => string;
+        readonly USER_OR_BUSINESS: () => string;
+        readonly USER_OR_ADMIN: () => string;
+        readonly BUSINESS_OR_ADMIN: () => string;
+        readonly USER_BUSINESS_OR_ADMIN: () => string;
+        readonly ANY_AUTH: () => string;
+        readonly FOR_REDEMPTION: () => string;
+        readonly FOR_TRANSACTION: () => string;
+        readonly FOR_ADMIN_ACTION: () => string;
+    };
+    readonly NOT_FOUND: {
+        readonly USER: (id?: string) => string;
+        readonly BUSINESS: (id?: string) => string;
+        readonly ADMIN: (id?: string) => string;
+        readonly CAMPAIGN: (id?: string) => string;
+        readonly TRANSACTION: (id?: string) => string;
+        readonly REDEMPTION: (id?: string) => string;
+        readonly WALLET: (id?: string) => string;
+        readonly CONTRACT: (address?: string) => string;
+        readonly TENANT: (id?: string) => string;
+        readonly TOKEN: (id?: string) => string;
+        readonly SIGNING_ACCOUNT: (id?: string) => string;
+    };
+    readonly ACCESS_DENIED: {
+        readonly VIEW_RESOURCE: (resource: string) => string;
+        readonly MODIFY_RESOURCE: (resource: string) => string;
+        readonly DELETE_RESOURCE: (resource: string) => string;
+        readonly EXECUTE_ACTION: (action: string) => string;
+    };
+    readonly VALIDATION: {
+        readonly REQUIRED_FIELD: (field: string) => string;
+        readonly INVALID_FORMAT: (field: string, format: string) => string;
+        readonly OUT_OF_RANGE: (field: string, min?: number, max?: number) => string;
+    };
+    readonly BUSINESS_RULES: {
+        readonly REDEMPTION_LIMIT_REACHED: () => string;
+        readonly INSUFFICIENT_BALANCE: (required?: string) => string;
+        readonly GEOGRAPHIC_RESTRICTION: (location: string) => string;
+        readonly STATUS_NOT_ALLOWED: (status: string, action: string) => string;
+    };
+    readonly DATABASE: {
+        readonly SAVE_FAILED: (resourceType: ResourceType, details?: string) => string;
+        readonly FIND_FAILED: (resourceType: ResourceType, details?: string) => string;
+        readonly DELETE_FAILED: (resourceType: ResourceType, details?: string) => string;
+        readonly UPDATE_FAILED: (resourceType: ResourceType, details?: string) => string;
+        readonly QUERY_FAILED: (resourceType: ResourceType, details?: string) => string;
+    };
+    readonly INPUT_VALIDATION: {
+        readonly REQUIRED: (param: string) => string;
+        readonly EMPTY: (param: string) => string;
+        readonly INVALID_FORMAT: (param: string, format: string) => string;
+        readonly OUT_OF_RANGE: (param: string, range: string) => string;
+        readonly INVALID_COMBINATION: (params: string) => string;
+        readonly MISSING_FIELD: (param: string) => string;
+    };
+    readonly OPERATIONS: {
+        readonly TRANSACTION_FAILED: (reason: string) => string;
+        readonly SIGNATURE_FAILED: (reason: string) => string;
+        readonly WALLET_OPERATION_FAILED: (reason: string) => string;
+        readonly CONTRACT_INTERACTION_FAILED: (reason: string) => string;
+        readonly DATA_PROCESSING_FAILED: (reason: string) => string;
+    };
+};
+/**
+ * Database operation error helper function
+ * Creates appropriate errors for database operations using the centralized ErrorFactory
+ */
+export declare function DatabaseOperationError(operation: DatabaseOperation, resourceType: ResourceType, details?: string): void;
+/**
+ * Input validation error helper function
+ * Creates appropriate validation errors using the centralized ErrorFactory
+ */
+export declare function InputValidationError(field: string, requirement: string, providedValue?: any): void;
+/**
+ * Operation failure error helper function
+ * Creates appropriate operation errors using the centralized ErrorFactory
+ */
+export declare function OperationFailureError(operation: string, reason: string, retryable?: boolean): void;
+//# sourceMappingURL=error-message.utils.d.ts.map

package/dist/cjs/shared-patterns/utils/error-message.utils.d.ts.map

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

package/dist/cjs/shared-patterns/utils/error-message.utils.js

@@ -0,0 +1,258 @@
+"use strict";
+/**
+ * Standardized error message generators for consistent error handling across applications
+ *
+ * This utility provides reusable message generation functions for common error scenarios:
+ * - Authentication context errors
+ * - Resource not found errors
+ * - Access denied errors
+ * - Validation errors
+ * - Business rule violations
+ * - Database operation errors
+ *
+ * @example
+ * import { generateAuthRequiredMessage, generateNotFoundMessage } from '@explorins/pers-shared-patterns';
+ *
+ * const message = generateAuthRequiredMessage(['user', 'admin']);
+ * // "User or admin authentication required"
+ *
+ * const notFound = generateNotFoundMessage('transaction', 'tx-123');
+ * // "Transaction with identifier 'tx-123' not found"
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ERROR_MESSAGE_TEMPLATES = void 0;
+exports.generateAuthRequiredMessage = generateAuthRequiredMessage;
+exports.generateNotFoundMessage = generateNotFoundMessage;
+exports.generateAccessDeniedMessage = generateAccessDeniedMessage;
+exports.generateValidationMessage = generateValidationMessage;
+exports.generateBusinessRuleMessage = generateBusinessRuleMessage;
+exports.generateDatabaseErrorMessage = generateDatabaseErrorMessage;
+exports.generateInputValidationMessage = generateInputValidationMessage;
+exports.generateOperationErrorMessage = generateOperationErrorMessage;
+exports.DatabaseOperationError = DatabaseOperationError;
+exports.InputValidationError = InputValidationError;
+exports.OperationFailureError = OperationFailureError;
+/**
+ * Generate standardized authentication required error message
+ * @param requiredContexts - Array of required authentication contexts
+ * @param action - Optional action description (e.g., 'for redemption processing')
+ * @returns Standardized error message
+ */
+function generateAuthRequiredMessage(requiredContexts, action) {
+    const contextMap = {
+        user: 'user',
+        business: 'business',
+        admin: 'admin',
+        tenant: 'tenant'
+    };
+    if (requiredContexts.length === 0) {
+        return `Authentication required${action ? ` ${action}` : ''}`;
+    }
+    if (requiredContexts.length === 1) {
+        return `${contextMap[requiredContexts[0]].charAt(0).toUpperCase() + contextMap[requiredContexts[0]].slice(1)} authentication required${action ? ` ${action}` : ''}`;
+    }
+    if (requiredContexts.length === 2) {
+        return `${contextMap[requiredContexts[0]].charAt(0).toUpperCase() + contextMap[requiredContexts[0]].slice(1)} or ${contextMap[requiredContexts[1]]} authentication required${action ? ` ${action}` : ''}`;
+    }
+    // For 3+ contexts, use comma separation with "or" before the last one
+    const lastContext = requiredContexts[requiredContexts.length - 1];
+    const otherContexts = requiredContexts.slice(0, -1);
+    const otherContextsStr = otherContexts.map(ctx => contextMap[ctx]).join(', ');
+    return `${otherContextsStr.charAt(0).toUpperCase() + otherContextsStr.slice(1)}, or ${contextMap[lastContext]} authentication required${action ? ` ${action}` : ''}`;
+}
+/**
+ * Generate standardized "not found" error message
+ * @param resourceType - Type of resource that was not found
+ * @param identifier - Optional identifier (ID, email, etc.)
+ * @returns Standardized not found message
+ */
+function generateNotFoundMessage(resourceType, identifier) {
+    const resource = resourceType.charAt(0).toUpperCase() + resourceType.slice(1);
+    return identifier
+        ? `${resource} with identifier '${identifier}' not found`
+        : `${resource} not found`;
+}
+/**
+ * Generate standardized "access denied" error message
+ * @param action - The action being attempted
+ * @param resource - Optional resource context
+ * @returns Standardized access denied message
+ */
+function generateAccessDeniedMessage(action, resource) {
+    return resource
+        ? `Access denied: cannot ${action} ${resource}`
+        : `Access denied: cannot ${action}`;
+}
+/**
+ * Generate standardized validation error message
+ * @param field - Field that failed validation
+ * @param constraint - The validation constraint
+ * @returns Standardized validation message
+ */
+function generateValidationMessage(field, constraint) {
+    return `Validation failed for '${field}': ${constraint}`;
+}
+/**
+ * Generate standardized business rule violation message
+ * @param rule - The business rule that was violated
+ * @param context - Optional context information
+ * @returns Standardized business rule message
+ */
+function generateBusinessRuleMessage(rule, context) {
+    return context
+        ? `Business rule violation: ${rule} (${context})`
+        : `Business rule violation: ${rule}`;
+}
+/**
+ * Generate standardized database error message
+ * @param operation - The database operation that failed
+ * @param resourceType - Type of resource involved
+ * @param details - Optional error details
+ * @returns Standardized database error message
+ */
+function generateDatabaseErrorMessage(operation, resourceType, details) {
+    const action = operation === 'find' ? 'retrieving' :
+        operation === 'save' ? 'saving' :
+            operation === 'delete' ? 'deleting' :
+                operation === 'update' ? 'updating' : 'querying';
+    const resource = resourceType.charAt(0).toUpperCase() + resourceType.slice(1);
+    const baseMessage = `Database error: failed ${action.toLowerCase()} ${resource.toLowerCase()}`;
+    return details ? `${baseMessage} - ${details}` : baseMessage;
+}
+/**
+ * Generate standardized input validation error message
+ * @param parameter - The parameter that failed validation
+ * @param requirement - What the parameter should meet
+ * @returns Standardized input validation message
+ */
+function generateInputValidationMessage(parameter, requirement) {
+    return `Invalid input: ${parameter} ${requirement}`;
+}
+/**
+ * Generate standardized operation error message
+ * @param operation - The operation that was attempted
+ * @param reason - Why it failed
+ * @returns Standardized operation error message
+ */
+function generateOperationErrorMessage(operation, reason) {
+    return `Operation failed: ${operation} - ${reason}`;
+}
+/**
+ * Common error message constants for quick access
+ */
+exports.ERROR_MESSAGE_TEMPLATES = {
+    // Authentication patterns
+    AUTH: {
+        USER_ONLY: () => generateAuthRequiredMessage(['user']),
+        BUSINESS_ONLY: () => generateAuthRequiredMessage(['business']),
+        ADMIN_ONLY: () => generateAuthRequiredMessage(['admin']),
+        USER_OR_BUSINESS: () => generateAuthRequiredMessage(['user', 'business']),
+        USER_OR_ADMIN: () => generateAuthRequiredMessage(['user', 'admin']),
+        BUSINESS_OR_ADMIN: () => generateAuthRequiredMessage(['business', 'admin']),
+        USER_BUSINESS_OR_ADMIN: () => generateAuthRequiredMessage(['user', 'business', 'admin']),
+        ANY_AUTH: () => generateAuthRequiredMessage([]),
+        // With action context
+        FOR_REDEMPTION: () => generateAuthRequiredMessage(['user'], 'for redemption processing'),
+        FOR_TRANSACTION: () => generateAuthRequiredMessage(['user', 'business'], 'for transaction access'),
+        FOR_ADMIN_ACTION: () => generateAuthRequiredMessage(['admin'], 'for administrative actions'),
+    },
+    // Resource not found patterns
+    NOT_FOUND: {
+        USER: (id) => generateNotFoundMessage('user', id),
+        BUSINESS: (id) => generateNotFoundMessage('business', id),
+        ADMIN: (id) => generateNotFoundMessage('admin', id),
+        CAMPAIGN: (id) => generateNotFoundMessage('campaign', id),
+        TRANSACTION: (id) => generateNotFoundMessage('transaction', id),
+        REDEMPTION: (id) => generateNotFoundMessage('redemption', id),
+        WALLET: (id) => generateNotFoundMessage('wallet', id),
+        CONTRACT: (address) => generateNotFoundMessage('contract', address),
+        TENANT: (id) => generateNotFoundMessage('tenant', id),
+        TOKEN: (id) => generateNotFoundMessage('token', id),
+        SIGNING_ACCOUNT: (id) => generateNotFoundMessage('signing-account', id),
+    },
+    // Access control patterns
+    ACCESS_DENIED: {
+        VIEW_RESOURCE: (resource) => generateAccessDeniedMessage('view', resource),
+        MODIFY_RESOURCE: (resource) => generateAccessDeniedMessage('modify', resource),
+        DELETE_RESOURCE: (resource) => generateAccessDeniedMessage('delete', resource),
+        EXECUTE_ACTION: (action) => generateAccessDeniedMessage(action),
+    },
+    // Validation patterns
+    VALIDATION: {
+        REQUIRED_FIELD: (field) => generateValidationMessage(field, 'field is required'),
+        INVALID_FORMAT: (field, format) => generateValidationMessage(field, `invalid ${format} format`),
+        OUT_OF_RANGE: (field, min, max) => {
+            if (min !== undefined && max !== undefined) {
+                return generateValidationMessage(field, `value must be between ${min} and ${max}`);
+            }
+            else if (min !== undefined) {
+                return generateValidationMessage(field, `value must be at least ${min}`);
+            }
+            else if (max !== undefined) {
+                return generateValidationMessage(field, `value must be at most ${max}`);
+            }
+            return generateValidationMessage(field, 'value is out of range');
+        },
+    },
+    // Business rule patterns
+    BUSINESS_RULES: {
+        REDEMPTION_LIMIT_REACHED: () => generateBusinessRuleMessage('redemption limit reached'),
+        INSUFFICIENT_BALANCE: (required) => generateBusinessRuleMessage('insufficient balance', required ? `required: ${required}` : undefined),
+        GEOGRAPHIC_RESTRICTION: (location) => generateBusinessRuleMessage('geographic restriction', `not available in ${location}`),
+        STATUS_NOT_ALLOWED: (status, action) => generateBusinessRuleMessage(`status '${status}' not allowed for ${action}`),
+    },
+    // Database operation patterns
+    DATABASE: {
+        SAVE_FAILED: (resourceType, details) => generateDatabaseErrorMessage('save', resourceType, details),
+        FIND_FAILED: (resourceType, details) => generateDatabaseErrorMessage('find', resourceType, details),
+        DELETE_FAILED: (resourceType, details) => generateDatabaseErrorMessage('delete', resourceType, details),
+        UPDATE_FAILED: (resourceType, details) => generateDatabaseErrorMessage('update', resourceType, details),
+        QUERY_FAILED: (resourceType, details) => generateDatabaseErrorMessage('query', resourceType, details),
+    },
+    // Input validation patterns
+    INPUT_VALIDATION: {
+        REQUIRED: (param) => generateInputValidationMessage(param, 'is required'),
+        EMPTY: (param) => generateInputValidationMessage(param, 'cannot be empty'),
+        INVALID_FORMAT: (param, format) => generateInputValidationMessage(param, `must be valid ${format}`),
+        OUT_OF_RANGE: (param, range) => generateInputValidationMessage(param, `must be ${range}`),
+        INVALID_COMBINATION: (params) => generateInputValidationMessage(params, 'combination is not allowed'),
+        MISSING_FIELD: (param) => generateInputValidationMessage(param, 'field is missing'),
+    },
+    // Operation error patterns
+    OPERATIONS: {
+        TRANSACTION_FAILED: (reason) => generateOperationErrorMessage('transaction processing', reason),
+        SIGNATURE_FAILED: (reason) => generateOperationErrorMessage('signature verification', reason),
+        WALLET_OPERATION_FAILED: (reason) => generateOperationErrorMessage('wallet operation', reason),
+        CONTRACT_INTERACTION_FAILED: (reason) => generateOperationErrorMessage('contract interaction', reason),
+        DATA_PROCESSING_FAILED: (reason) => generateOperationErrorMessage('data processing', reason),
+    }
+};
+/**
+ * Database operation error helper function
+ * Creates appropriate errors for database operations using the centralized ErrorFactory
+ */
+function DatabaseOperationError(operation, resourceType, details) {
+    const message = generateDatabaseErrorMessage(operation, resourceType, details);
+    // Using systemError as it's available in the current ErrorFactory
+    // TODO: Add dedicated databaseOperation method to ErrorFactory
+    throw new Error(message); // Temporary - will be replaced with proper ErrorFactory method
+}
+/**
+ * Input validation error helper function
+ * Creates appropriate validation errors using the centralized ErrorFactory
+ */
+function InputValidationError(field, requirement, providedValue) {
+    const message = generateInputValidationMessage(field, requirement);
+    // Using systemError as it's available in the current ErrorFactory
+    // TODO: Add dedicated inputValidation method to ErrorFactory  
+    throw new Error(message); // Temporary - will be replaced with proper ErrorFactory method
+}
+/**
+ * Operation failure error helper function
+ * Creates appropriate operation errors using the centralized ErrorFactory
+ */
+function OperationFailureError(operation, reason, retryable = false) {
+    const message = generateOperationErrorMessage(operation, reason);
+    throw new Error(message); // Temporary - will be replaced with proper ErrorFactory method
+}
+//# sourceMappingURL=error-message.utils.js.map

package/dist/cjs/shared-patterns/utils/error-message.utils.js.map

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

package/dist/cjs/shared-patterns/utils/index.d.ts

@@ -0,0 +1,3 @@
+export * from './validation.utils';
+export * from './error-message.utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/shared-patterns/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/utils/index.ts"],"names":[],"mappings":"AACA,cAAc,oBAAoB,CAAC;AACnC,cAAc,uBAAuB,CAAC"}

package/dist/cjs/shared-patterns/utils/index.js

@@ -0,0 +1,20 @@
+"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 });
+// Internal utilities for PERS architecture patterns
+__exportStar(require("./validation.utils"), exports);
+__exportStar(require("./error-message.utils"), exports);
+//# sourceMappingURL=index.js.map

package/dist/cjs/shared-patterns/utils/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/shared-patterns/utils/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,oDAAoD;AACpD,qDAAmC;AACnC,wDAAsC"}

package/dist/cjs/shared-patterns/utils/validation.utils.d.ts

@@ -0,0 +1,49 @@
+/**
+ * PERS Validation Utilities
+ *
+ * Centralized validation functions for consistent data validation
+ * across all PERS backend modules and domains.
+ */
+/**
+ * Validates email format according to RFC standards
+ *
+ * Features:
+ * - RFC-compliant email regex pattern
+ * - RFC 5321 length limit enforcement (254 characters)
+ * - Performance optimized with length check first
+ * - DoS protection against extremely long strings
+ *
+ * @param email - Email address to validate
+ * @returns true if email is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidEmail('user@example.com'); // true
+ * isValidEmail('invalid-email'); // false
+ * isValidEmail('a'.repeat(300) + '@example.com'); // false (too long)
+ * ```
+ */
+export declare function isValidEmail(email: string): boolean;
+/**
+ * Validates wallet address format
+ *
+ * @param address - Wallet address to validate
+ * @returns true if address format is valid
+ */
+export declare function isValidWalletAddress(address: string): boolean;
+/**
+ * Validates that a string is not empty and meets minimum length requirements
+ *
+ * @param value - String to validate
+ * @param minLength - Minimum required length (default: 1)
+ * @returns true if string meets requirements
+ */
+export declare function isValidNonEmptyString(value: string, minLength?: number): boolean;
+/**
+ * Validates UUID format (v4)
+ *
+ * @param uuid - UUID string to validate
+ * @returns true if UUID format is valid
+ */
+export declare function isValidUuid(uuid: string): boolean;
+//# sourceMappingURL=validation.utils.d.ts.map

package/dist/cjs/shared-patterns/utils/validation.utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.d.ts","sourceRoot":"","sources":["../../../../src/shared-patterns/utils/validation.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CASnD;AAED;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAM7D;AAED;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,MAAM,EAAE,SAAS,GAAE,MAAU,GAAG,OAAO,CAEnF;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAKjD"}

package/dist/cjs/shared-patterns/utils/validation.utils.js

@@ -0,0 +1,76 @@
+"use strict";
+/**
+ * PERS Validation Utilities
+ *
+ * Centralized validation functions for consistent data validation
+ * across all PERS backend modules and domains.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidEmail = isValidEmail;
+exports.isValidWalletAddress = isValidWalletAddress;
+exports.isValidNonEmptyString = isValidNonEmptyString;
+exports.isValidUuid = isValidUuid;
+/**
+ * Validates email format according to RFC standards
+ *
+ * Features:
+ * - RFC-compliant email regex pattern
+ * - RFC 5321 length limit enforcement (254 characters)
+ * - Performance optimized with length check first
+ * - DoS protection against extremely long strings
+ *
+ * @param email - Email address to validate
+ * @returns true if email is valid, false otherwise
+ *
+ * @example
+ * ```typescript
+ * isValidEmail('user@example.com'); // true
+ * isValidEmail('invalid-email'); // false
+ * isValidEmail('a'.repeat(300) + '@example.com'); // false (too long)
+ * ```
+ */
+function isValidEmail(email) {
+    // Quick length check first for performance and RFC 5321 compliance
+    if (!email || email.length > 254) {
+        return false;
+    }
+    // RFC-compliant email regex pattern
+    const emailRegex = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+    return emailRegex.test(email);
+}
+/**
+ * Validates wallet address format
+ *
+ * @param address - Wallet address to validate
+ * @returns true if address format is valid
+ */
+function isValidWalletAddress(address) {
+    if (!address)
+        return false;
+    // Ethereum address format: 0x followed by 40 hexadecimal characters
+    const ethereumAddressRegex = /^0x[a-fA-F0-9]{40}$/;
+    return ethereumAddressRegex.test(address);
+}
+/**
+ * Validates that a string is not empty and meets minimum length requirements
+ *
+ * @param value - String to validate
+ * @param minLength - Minimum required length (default: 1)
+ * @returns true if string meets requirements
+ */
+function isValidNonEmptyString(value, minLength = 1) {
+    return typeof value === 'string' && value.trim().length >= minLength;
+}
+/**
+ * Validates UUID format (v4)
+ *
+ * @param uuid - UUID string to validate
+ * @returns true if UUID format is valid
+ */
+function isValidUuid(uuid) {
+    if (!uuid)
+        return false;
+    const uuidRegex = /^[0-9a-f]{8}-[0-9a-f]{4}-4[0-9a-f]{3}-[89ab][0-9a-f]{3}-[0-9a-f]{12}$/i;
+    return uuidRegex.test(uuid);
+}
+//# sourceMappingURL=validation.utils.js.map

package/dist/cjs/shared-patterns/utils/validation.utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validation.utils.js","sourceRoot":"","sources":["../../../../src/shared-patterns/utils/validation.utils.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;AAqBH,oCASC;AAQD,oDAMC;AASD,sDAEC;AAQD,kCAKC;AAlED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,YAAY,CAAC,KAAa;IACxC,mEAAmE;IACnE,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACf,CAAC;IAED,oCAAoC;IACpC,MAAM,UAAU,GAAG,4BAA4B,CAAC;IAChD,OAAO,UAAU,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;AAChC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,oBAAoB,CAAC,OAAe;IAClD,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAC;IAE3B,oEAAoE;IACpE,MAAM,oBAAoB,GAAG,qBAAqB,CAAC;IACnD,OAAO,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AAC5C,CAAC;AAED;;;;;;GAMG;AACH,SAAgB,qBAAqB,CAAC,KAAa,EAAE,YAAoB,CAAC;IACxE,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,MAAM,IAAI,SAAS,CAAC;AACvE,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,IAAY;IACtC,IAAI,CAAC,IAAI;QAAE,OAAO,KAAK,CAAC;IAExB,MAAM,SAAS,GAAG,wEAAwE,CAAC;IAC3F,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC9B,CAAC"}

package/dist/esm/index.d.ts

@@ -3,4 +3,6 @@ export type * from './shared-lib/interfaces';
 export type * from './shared-lib/types';
 export type * from './shared-lib/dto';
 export type * from './shared-lib/errors';
+export * from './shared-lib/errors';
+export * from './shared-patterns';
 //# 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,mBAAmB,CAAC;AAClC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAIA,cAAc,mBAAmB,CAAC;AAClC,mBAAmB,yBAAyB,CAAC;AAC7C,mBAAmB,oBAAoB,CAAC;AACxC,mBAAmB,kBAAkB,CAAC;AAGtC,mBAAmB,qBAAqB,CAAC;AACzC,cAAc,qBAAqB,CAAC;AAGpC,cAAc,mBAAmB,CAAC"}

package/dist/esm/index.js

@@ -2,6 +2,9 @@
 // 🌐 PUBLIC: Safe for external consumption - contains only DTOs, interfaces, types, and enums
 // Core domain contracts
 export * from './shared-lib/enum';
-// Note: Architecture patterns (orchestrators, database schemas) moved to @explorins/pers-shared-patterns
-// This library now contains only pure data contracts safe for external consumption
+export * from './shared-lib/errors'; // Export actual error classes and functions
+// Shared patterns (architecture components)
+export * from './shared-patterns';
+// Note: This library contains both pure data contracts and internal architecture patterns
+// External consumers should only use the type exports and documented public APIs
 //# sourceMappingURL=index.js.map