@explorins/pers-shared 2.1.11 → 2.1.13

package/dist/esm/internal/orchestrators/base-workflow.d.ts

@@ -1,50 +0,0 @@
-import { Logger } from '@nestjs/common';
-/**
- * BaseWorkflow - Business Process Coordination Pattern
- *
- * @description Foundation for business workflow coordination in PERS domains.
- * Distinct from BaseOrchestrator which handles technical CQRS coordination.
- *
- * ARCHITECTURAL DISTINCTION:
- * - BaseOrchestrator: Technical coordination (CQRS, queries, commands)
- * - BaseWorkflow: Business process coordination (orchestrator choreography)
- *
- * @usage Extend this class for domain-specific business workflows:
- * ```typescript
- * @Injectable()
- * export class ServerTransactionWorkflow extends BaseWorkflow {
- *   constructor(
- *     private readonly walletOrchestrator: WalletResolutionOrchestrator,
- *     private readonly tokenOrchestrator: TokenResolutionOrchestrator
- *   ) {
- *     super(ServerTransactionWorkflow.name);
- *   }
- *
- *   async executeTransactionFlow(dto: TransactionRequestDTO): Promise<TransactionDTO> {
- *     return this.executeWorkflowStep(async () => {
- *       const token = await this.tokenOrchestrator.resolveToken(dto.token);
- *       const addresses = await this.walletOrchestrator.resolveAddresses(dto, token.chainId);
- *       return this.createTransaction(token, addresses, dto);
- *     }, 'Transaction Creation Flow');
- *   }
- * }
- * ```
- *
- * @library @explorins/pers-shared-patterns
- * @version 1.0.0
- * @since September 2025
- */
-export declare abstract class BaseWorkflow {
-    protected readonly logger: Logger;
-    protected constructor(loggerContext: string);
-    /**
-     * Execute a workflow step with standardized logging and error handling
-     *
-     * @param step - Function to execute as workflow step
-     * @param stepName - Human-readable name for the step
-     * @param context - Optional context for logging
-     * @returns Promise resolving to step result
-     */
-    protected executeWorkflowStep<T>(step: () => Promise<T>, stepName: string, context?: Record<string, any>): Promise<T>;
-}
-//# sourceMappingURL=base-workflow.d.ts.map

package/dist/esm/internal/orchestrators/base-workflow.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-workflow.d.ts","sourceRoot":"","sources":["../../../../src/internal/orchestrators/base-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,8BAAsB,YAAY;IAChC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,SAAS,aAAa,aAAa,EAAE,MAAM;IAI3C;;;;;;;OAOG;cACa,mBAAmB,CAAC,CAAC,EACnC,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACtB,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC;CAYd"}

package/dist/esm/internal/orchestrators/base-workflow.js

@@ -1,64 +0,0 @@
-import { Logger } from '@nestjs/common';
-/**
- * BaseWorkflow - Business Process Coordination Pattern
- *
- * @description Foundation for business workflow coordination in PERS domains.
- * Distinct from BaseOrchestrator which handles technical CQRS coordination.
- *
- * ARCHITECTURAL DISTINCTION:
- * - BaseOrchestrator: Technical coordination (CQRS, queries, commands)
- * - BaseWorkflow: Business process coordination (orchestrator choreography)
- *
- * @usage Extend this class for domain-specific business workflows:
- * ```typescript
- * @Injectable()
- * export class ServerTransactionWorkflow extends BaseWorkflow {
- *   constructor(
- *     private readonly walletOrchestrator: WalletResolutionOrchestrator,
- *     private readonly tokenOrchestrator: TokenResolutionOrchestrator
- *   ) {
- *     super(ServerTransactionWorkflow.name);
- *   }
- *
- *   async executeTransactionFlow(dto: TransactionRequestDTO): Promise<TransactionDTO> {
- *     return this.executeWorkflowStep(async () => {
- *       const token = await this.tokenOrchestrator.resolveToken(dto.token);
- *       const addresses = await this.walletOrchestrator.resolveAddresses(dto, token.chainId);
- *       return this.createTransaction(token, addresses, dto);
- *     }, 'Transaction Creation Flow');
- *   }
- * }
- * ```
- *
- * @library @explorins/pers-shared-patterns
- * @version 1.0.0
- * @since September 2025
- */
-export class BaseWorkflow {
-    logger;
-    constructor(loggerContext) {
-        this.logger = new Logger(loggerContext);
-    }
-    /**
-     * Execute a workflow step with standardized logging and error handling
-     *
-     * @param step - Function to execute as workflow step
-     * @param stepName - Human-readable name for the step
-     * @param context - Optional context for logging
-     * @returns Promise resolving to step result
-     */
-    async executeWorkflowStep(step, stepName, context) {
-        try {
-            this.logger.debug(`🎯 Starting workflow step: ${stepName}`, context);
-            const result = await step();
-            this.logger.debug(`✅ Completed workflow step: ${stepName}`, context);
-            return result;
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            this.logger.error(`❌ Failed workflow step: ${stepName}: ${errorMessage}`, { ...context, error });
-            throw error; // Let business errors flow through unchanged
-        }
-    }
-}
-//# sourceMappingURL=base-workflow.js.map

package/dist/esm/internal/orchestrators/base-workflow.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-workflow.js","sourceRoot":"","sources":["../../../../src/internal/orchestrators/base-workflow.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAM,OAAgB,YAAY;IACb,MAAM,CAAS;IAElC,YAAsB,aAAqB;QACzC,IAAI,CAAC,MAAM,GAAG,IAAI,MAAM,CAAC,aAAa,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;;OAOG;IACO,KAAK,CAAC,mBAAmB,CACjC,IAAsB,EACtB,QAAgB,EAChB,OAA6B;QAE7B,IAAI,CAAC;YACH,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YACrE,MAAM,MAAM,GAAG,MAAM,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,8BAA8B,QAAQ,EAAE,EAAE,OAAO,CAAC,CAAC;YACrE,OAAO,MAAM,CAAC;QAChB,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,YAAY,GAAG,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;YAC5E,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,QAAQ,KAAK,YAAY,EAAE,EAAE,EAAE,GAAG,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;YACjG,MAAM,KAAK,CAAC,CAAC,6CAA6C;QAC5D,CAAC;IACH,CAAC;CACF"}

package/dist/esm/internal/orchestrators/index.d.ts

@@ -1,26 +0,0 @@
-/**
- * PERS Orchestrators - Application Layer Patterns
- *
- * @description Centralized orchestration utilities for DDD-compliant applications
- * - BaseOrchestrator: Foundation for all domain orchestrators (technical coordination)
- * - BaseWorkflow: Foundation for business process workflows (business coordination)
- * - OrchestrationError: Standard error handling
- * - OrchestrationResult: Type-safe result pattern
- * - Utility functions for error handling and result processing
- *
- * @usage Import directly from shared library:
- * ```typescript
- * import { BaseOrchestrator, BaseWorkflow, OrchestrationError } from '@explorins/pers-shared-patterns';
- * ```
- *
- * ARCHITECTURAL DISTINCTION:
- * - BaseOrchestrator: Technical coordination (CQRS, queries, commands)
- * - BaseWorkflow: Business process coordination (orchestrator choreography)
- *
- * @library @explorins/pers-shared-patterns
- * @version 2.0.0
- * @since August 2025
- */
-export * from './base-orchestrator';
-export * from './base-workflow';
-//# sourceMappingURL=index.d.ts.map

package/dist/esm/internal/orchestrators/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/orchestrators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC"}

package/dist/esm/internal/orchestrators/index.js

@@ -1,30 +0,0 @@
-/**
- * PERS Orchestrators - Application Layer Patterns
- *
- * @description Centralized orchestration utilities for DDD-compliant applications
- * - BaseOrchestrator: Foundation for all domain orchestrators (technical coordination)
- * - BaseWorkflow: Foundation for business process workflows (business coordination)
- * - OrchestrationError: Standard error handling
- * - OrchestrationResult: Type-safe result pattern
- * - Utility functions for error handling and result processing
- *
- * @usage Import directly from shared library:
- * ```typescript
- * import { BaseOrchestrator, BaseWorkflow, OrchestrationError } from '@explorins/pers-shared-patterns';
- * ```
- *
- * ARCHITECTURAL DISTINCTION:
- * - BaseOrchestrator: Technical coordination (CQRS, queries, commands)
- * - BaseWorkflow: Business process coordination (orchestrator choreography)
- *
- * @library @explorins/pers-shared-patterns
- * @version 2.0.0
- * @since August 2025
- */
-export * from './base-orchestrator';
-export * from './base-workflow';
-// Future orchestration utilities can be added here:
-// export * from './validation-orchestrator';
-// export * from './audit-orchestrator';
-// export * from './notification-orchestrator';
-//# sourceMappingURL=index.js.map

package/dist/esm/internal/orchestrators/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/orchestrators/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAEhC,oDAAoD;AACpD,6CAA6C;AAC7C,wCAAwC;AACxC,+CAA+C"}

package/dist/esm/internal/utils/index.d.ts

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

package/dist/esm/internal/utils/index.d.ts.map

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

package/dist/esm/internal/utils/index.js

@@ -1,3 +0,0 @@
-// Internal utilities for PERS architecture patterns
-export * from './validation.utils';
-//# sourceMappingURL=index.js.map

package/dist/esm/internal/utils/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/utils/index.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,cAAc,oBAAoB,CAAC"}

package/dist/esm/internal/utils/validation.utils.d.ts

@@ -1,49 +0,0 @@
-/**
- * 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/esm/internal/utils/validation.utils.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.utils.d.ts","sourceRoot":"","sources":["../../../../src/internal/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/esm/internal/utils/validation.utils.js

@@ -1,70 +0,0 @@
-/**
- * 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 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
- */
-export 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
- */
-export 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
- */
-export 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/esm/internal/utils/validation.utils.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"validation.utils.js","sourceRoot":"","sources":["../../../../src/internal/utils/validation.utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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,MAAM,UAAU,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"}