@explorins/pers-shared 2.1.12 → 2.1.17

package/dist/cjs/internal/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internal/index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAGhC,cAAc,YAAY,CAAC;AAG3B,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,aAAa,CAAC;AAE5B,cAAc,cAAc,CAAC;AAK7B,cAAc,SAAS,CAAC;AACxB,cAAc,kBAAkB,CAAC;AACjC,cAAc,eAAe,CAAC;AAC9B,cAAc,UAAU,CAAC;AACzB,cAAc,QAAQ,CAAC;AAGvB,cAAc,WAAW,CAAC"}

package/dist/cjs/internal/index.js

@@ -1,42 +0,0 @@
-"use strict";
-// PERS Shared Patterns Library - Internal Architecture Components
-// 🔒 PRIVATE: For internal PERS microservices only
-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 });
-// Orchestrators - Business coordination patterns
-__exportStar(require("./orchestrators"), exports);
-// Database - Shared entity models and schemas
-__exportStar(require("./database"), exports);
-// Utils - Validation and utility functions
-__exportStar(require("./utils"), exports);
-// Exceptions - Business and technical error classes
-__exportStar(require("./exceptions"), exports);
-// Enums - Internal business enums for microservice communication
-__exportStar(require("./enums/lambda.enum"), exports);
-__exportStar(require("./functions"), exports);
-__exportStar(require("./interfaces"), exports);
-// Shared Pattern
-// Core domain contracts
-__exportStar(require("../enum"), exports);
-__exportStar(require("../value-objects"), exports);
-__exportStar(require("../interfaces"), exports);
-__exportStar(require("../types"), exports);
-__exportStar(require("../dto"), exports);
-// Error handling system
-__exportStar(require("../errors"), exports);
-// Note: This library contains proprietary business logic and architecture patterns
-// It should only be used within PERS internal microservices
-//# sourceMappingURL=index.js.map

package/dist/cjs/internal/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internal/index.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,mDAAmD;;;;;;;;;;;;;;;;AAEnD,iDAAiD;AACjD,kDAAgC;AAEhC,8CAA8C;AAC9C,6CAA2B;AAE3B,2CAA2C;AAC3C,0CAAwB;AAExB,oDAAoD;AACpD,+CAA6B;AAE7B,iEAAiE;AACjE,sDAAoC;AAEpC,8CAA4B;AAE5B,+CAA6B;AAG7B,iBAAiB;AACjB,wBAAwB;AACxB,0CAAwB;AACxB,mDAAiC;AACjC,gDAA8B;AAC9B,2CAAyB;AACzB,yCAAuB;AAEvB,wBAAwB;AACxB,4CAA0B;AAE1B,mFAAmF;AACnF,4DAA4D"}

package/dist/cjs/internal/interfaces/index.d.ts

@@ -1,3 +0,0 @@
-export * from './stripe-payment-intent-metadata.interface';
-export * from './request.interface';
-//# sourceMappingURL=index.d.ts.map

package/dist/cjs/internal/interfaces/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/internal/interfaces/index.ts"],"names":[],"mappings":"AAEA,cAAc,4CAA4C,CAAC;AAC3D,cAAc,qBAAqB,CAAC"}

package/dist/cjs/internal/interfaces/index.js

@@ -1,19 +0,0 @@
-"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 });
-__exportStar(require("./stripe-payment-intent-metadata.interface"), exports);
-__exportStar(require("./request.interface"), exports);
-//# sourceMappingURL=index.js.map

package/dist/cjs/internal/interfaces/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/internal/interfaces/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAEA,6EAA2D;AAC3D,sDAAoC"}

package/dist/cjs/internal/interfaces/request.interface.d.ts

@@ -1,21 +0,0 @@
-import { UserDTO, TenantDTO, BusinessDTO, AdminDTO } from '@explorins/pers-shared';
-export interface ExtendedAppRequest extends Request {
-    tenant?: TenantDTO;
-    business?: BusinessDTO;
-    user?: UserDTO;
-    admin?: AdminDTO;
-    isVerifiedTenantAdmin?: boolean;
-    originalIp?: string;
-    anonymizedIp?: string;
-}
-export declare class AllowedAppRequestHeaders {
-    'x-project-key': string;
-    'x-api-key': string;
-    'Authorization': string;
-    'Origin': string;
-    'X-Requested-With': string;
-    'Content-Type': string;
-    'Accept': string;
-    'stripe-signature': string;
-}
-//# sourceMappingURL=request.interface.d.ts.map

package/dist/cjs/internal/interfaces/request.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"request.interface.d.ts","sourceRoot":"","sources":["../../../../src/internal/interfaces/request.interface.ts"],"names":[],"mappings":"AACA,OAAO,EAAC,OAAO,EAAE,SAAS,EAAE,WAAW,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjF,MAAM,WAAW,kBAAmB,SAAQ,OAAO;IAC/C,MAAM,CAAC,EAAE,SAAS,CAAA;IAClB,QAAQ,CAAC,EAAE,WAAW,CAAC;IACvB,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,QAAQ,CAAA;IAChB,qBAAqB,CAAC,EAAE,OAAO,CAAA;IAE/B,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,YAAY,CAAC,EAAE,MAAM,CAAA;CACxB;AACD,qBAAa,wBAAwB;IACjC,eAAe,EAAE,MAAM,CAAkB;IACzC,WAAW,EAAE,MAAM,CAAc;IACjC,eAAe,EAAE,MAAM,CAAkB;IACzC,QAAQ,EAAE,MAAM,CAAW;IAC3B,kBAAkB,EAAE,MAAM,CAAqB;IAC/C,cAAc,EAAE,MAAM,CAAiB;IACvC,QAAQ,EAAE,MAAM,CAAW;IAC3B,kBAAkB,EAAE,MAAM,CAAqB;CAClD"}

package/dist/cjs/internal/interfaces/request.interface.js

@@ -1,15 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.AllowedAppRequestHeaders = void 0;
-class AllowedAppRequestHeaders {
-    'x-project-key' = 'x-project-key';
-    'x-api-key' = 'x-api-key';
-    'Authorization' = 'Authorization';
-    'Origin' = 'Origin';
-    'X-Requested-With' = 'X-Requested-With';
-    'Content-Type' = 'Content-Type';
-    'Accept' = 'Accept';
-    'stripe-signature' = 'stripe-signature';
-}
-exports.AllowedAppRequestHeaders = AllowedAppRequestHeaders;
-//# sourceMappingURL=request.interface.js.map

package/dist/cjs/internal/interfaces/request.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"request.interface.js","sourceRoot":"","sources":["../../../../src/internal/interfaces/request.interface.ts"],"names":[],"mappings":";;;AAaA,MAAa,wBAAwB;IACjC,eAAe,GAAW,eAAe,CAAA;IACzC,WAAW,GAAW,WAAW,CAAA;IACjC,eAAe,GAAW,eAAe,CAAA;IACzC,QAAQ,GAAW,QAAQ,CAAA;IAC3B,kBAAkB,GAAW,kBAAkB,CAAA;IAC/C,cAAc,GAAW,cAAc,CAAA;IACvC,QAAQ,GAAW,QAAQ,CAAA;IAC3B,kBAAkB,GAAW,kBAAkB,CAAA;CAClD;AATD,4DASC"}

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.d.ts

@@ -1,9 +0,0 @@
-export interface StripePaymentIntentMetadata {
-    accountAddress: string;
-    tokenAddress: string;
-    tokenId: string | null;
-    minterAddress: string;
-    tenantId: string;
-    isTestnet: boolean;
-}
-//# sourceMappingURL=stripe-payment-intent-metadata.interface.d.ts.map

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"stripe-payment-intent-metadata.interface.d.ts","sourceRoot":"","sources":["../../../../src/internal/interfaces/stripe-payment-intent-metadata.interface.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,2BAA2B;IACxC,cAAc,EAAE,MAAM,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,aAAa,EAAE,MAAM,CAAC;IACtB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,OAAO,CAAC;CACtB"}

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.js

@@ -1,3 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=stripe-payment-intent-metadata.interface.js.map

package/dist/cjs/internal/interfaces/stripe-payment-intent-metadata.interface.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"stripe-payment-intent-metadata.interface.js","sourceRoot":"","sources":["../../../../src/internal/interfaces/stripe-payment-intent-metadata.interface.ts"],"names":[],"mappings":""}

package/dist/cjs/internal/internal-index.d.ts

@@ -1,8 +0,0 @@
-export * from './orchestrators';
-export * from './database';
-export * from './utils';
-export * from './exceptions';
-export * from './enums/lambda.enum';
-export * from './functions';
-export * from './interfaces';
-//# sourceMappingURL=internal-index.d.ts.map

package/dist/cjs/internal/internal-index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"internal-index.d.ts","sourceRoot":"","sources":["../../../src/internal/internal-index.ts"],"names":[],"mappings":"AAIA,cAAc,iBAAiB,CAAC;AAGhC,cAAc,YAAY,CAAC;AAG3B,cAAc,SAAS,CAAC;AAGxB,cAAc,cAAc,CAAC;AAG7B,cAAc,qBAAqB,CAAC;AAEpC,cAAc,aAAa,CAAC;AAE5B,cAAc,cAAc,CAAC"}

package/dist/cjs/internal/internal-index.js

@@ -1,33 +0,0 @@
-"use strict";
-// PERS Shared Patterns Library - Internal Architecture Components
-// 🔒 PRIVATE: For internal PERS microservices only
-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 });
-// Orchestrators - Business coordination patterns
-__exportStar(require("./orchestrators"), exports);
-// Database - Shared entity models and schemas
-__exportStar(require("./database"), exports);
-// Utils - Validation and utility functions
-__exportStar(require("./utils"), exports);
-// Exceptions - Business and technical error classes
-__exportStar(require("./exceptions"), exports);
-// Enums - Internal business enums for microservice communication
-__exportStar(require("./enums/lambda.enum"), exports);
-__exportStar(require("./functions"), exports);
-__exportStar(require("./interfaces"), exports);
-// Note: This library contains proprietary business logic and architecture patterns
-// It should only be used within PERS internal microservices
-//# sourceMappingURL=internal-index.js.map

package/dist/cjs/internal/internal-index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"internal-index.js","sourceRoot":"","sources":["../../../src/internal/internal-index.ts"],"names":[],"mappings":";AAAA,kEAAkE;AAClE,mDAAmD;;;;;;;;;;;;;;;;AAEnD,iDAAiD;AACjD,kDAAgC;AAEhC,8CAA8C;AAC9C,6CAA2B;AAE3B,2CAA2C;AAC3C,0CAAwB;AAExB,oDAAoD;AACpD,+CAA6B;AAE7B,iEAAiE;AACjE,sDAAoC;AAEpC,8CAA4B;AAE5B,+CAA6B;AAE7B,mFAAmF;AACnF,4DAA4D"}

package/dist/cjs/internal/orchestrators/base-orchestrator.d.ts

@@ -1,90 +0,0 @@
-import { Logger } from '@nestjs/common';
-import { CommandBus, QueryBus } from '@nestjs/cqrs';
-import { OrchestrationError } from '@explorins/pers-shared';
-/**
- * BaseOrchestrator - Centralized Application Layer Orchestration Pattern
- *
- * @description Foundation for all domain orchestrators following PERS DDD principles:
- * - Application layer orchestrates cross-domain operations via CQRS
- * - Domain services contain pure business logic only
- * - Microservice boundary preparation through clean abstractions
- * - Consistent patterns across all domains (transaction, user, wallet, token, etc.)
- * - Smart error handling that preserves business context
- *
- * @usage Extend this class in domain-specific orchestrators:
- * ```typescript
- * @Injectable()
- * export class UserOrchestrator extends BaseOrchestrator {
- *   constructor(commandBus: CommandBus, queryBus: QueryBus) {
- *     super(commandBus, queryBus, UserOrchestrator.name);
- *   }
- * }
- * ```
- *
- * @library @explorins/pers-shared
- * @version 2.0.0
- * @since August 2025
- */
-export declare abstract class BaseOrchestrator {
-    protected readonly commandBus: CommandBus;
-    protected readonly queryBus: QueryBus;
-    protected readonly logger: Logger;
-    protected constructor(commandBus: CommandBus, queryBus: QueryBus, loggerContext: string);
-    /**
-     * Enhanced error handling that preserves business errors while wrapping technical errors
-     * Business errors (with category: DOMAIN_RULE) are passed through unchanged
-     * Technical errors are wrapped in OrchestrationError for consistent handling
-     */
-    protected executeWithErrorHandling<T>(operation: () => Promise<T>, operationName: string, context?: Record<string, any>): Promise<T>;
-    /**
-     * Execute CQRS command with consistent error handling and logging
-     * Standardizes command execution across all orchestrators
-     */
-    protected executeCommand<T>(command: any, operationName?: string): Promise<T>;
-    /**
-     * Execute CQRS query with consistent error handling and logging
-     * Standardizes query execution across all orchestrators
-     */
-    protected executeQuery<T>(query: any, operationName?: string): Promise<T>;
-    /**
-     * Execute multiple operations in parallel with error handling
-     * Useful for batch operations across domains
-     */
-    protected executeParallel<T>(operations: (() => Promise<T>)[], operationName: string): Promise<T[]>;
-}
-/**
- * Result pattern for orchestrator operations (optional - for complex flows)
- * Provides type-safe error handling without exceptions
- */
-export type OrchestrationResult<T> = {
-    success: true;
-    data: T;
-    operation?: string;
-} | {
-    success: false;
-    error: OrchestrationError;
-    operation?: string;
-};
-/**
- * Helper function to create success result
- */
-export declare function createSuccessResult<T>(data: T, operation?: string): OrchestrationResult<T>;
-/**
- * Helper function to create error result
- */
-export declare function createErrorResult<T>(error: OrchestrationError, operation?: string): OrchestrationResult<T>;
-/**
- * Utility function to check if result is successful
- * Provides type guard for TypeScript
- */
-export declare function isSuccessResult<T>(result: OrchestrationResult<T>): result is {
-    success: true;
-    data: T;
-    operation?: string;
-};
-/**
- * Utility function to extract data from result or throw error
- * Useful for converting result pattern back to exception-based flow
- */
-export declare function unwrapResult<T>(result: OrchestrationResult<T>): T;
-//# sourceMappingURL=base-orchestrator.d.ts.map

package/dist/cjs/internal/orchestrators/base-orchestrator.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-orchestrator.d.ts","sourceRoot":"","sources":["../../../../src/internal/orchestrators/base-orchestrator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAiB,MAAM,gBAAgB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,kBAAkB,EAAiB,MAAM,wBAAwB,CAAC;AAE3E;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,8BAAsB,gBAAgB;IAIlC,SAAS,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU;IACzC,SAAS,CAAC,QAAQ,CAAC,QAAQ,EAAE,QAAQ;IAJvC,SAAS,CAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAElC,SAAS,aACY,UAAU,EAAE,UAAU,EACtB,QAAQ,EAAE,QAAQ,EACrC,aAAa,EAAE,MAAM;IAKvB;;;;OAIG;cACa,wBAAwB,CAAC,CAAC,EACxC,SAAS,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EAC3B,aAAa,EAAE,MAAM,EACrB,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAC5B,OAAO,CAAC,CAAC,CAAC;IAwBb;;;OAGG;cACa,cAAc,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IASnF;;;OAGG;cACa,YAAY,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,EAAE,aAAa,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAS/E;;;OAGG;cACa,eAAe,CAAC,CAAC,EAC/B,UAAU,EAAE,CAAC,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,EAChC,aAAa,EAAE,MAAM,GACpB,OAAO,CAAC,CAAC,EAAE,CAAC;CAOhB;AAED;;;GAGG;AACH,MAAM,MAAM,mBAAmB,CAAC,CAAC,IAAI;IACnC,OAAO,EAAE,IAAI,CAAC;IACd,IAAI,EAAE,CAAC,CAAC;IACR,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG;IACF,OAAO,EAAE,KAAK,CAAC;IACf,KAAK,EAAE,kBAAkB,CAAC;IAC1B,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC;AAEF;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAE1F;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,CAAC,EAAE,KAAK,EAAE,kBAAkB,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAE1G;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,MAAM,IAAI;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAC;IAAC,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CAE3H;AAED;;;GAGG;AACH,wBAAgB,YAAY,CAAC,CAAC,EAAE,MAAM,EAAE,mBAAmB,CAAC,CAAC,CAAC,GAAG,CAAC,CAKjE"}

package/dist/cjs/internal/orchestrators/base-orchestrator.js

@@ -1,124 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseOrchestrator = void 0;
-exports.createSuccessResult = createSuccessResult;
-exports.createErrorResult = createErrorResult;
-exports.isSuccessResult = isSuccessResult;
-exports.unwrapResult = unwrapResult;
-const common_1 = require("@nestjs/common");
-const pers_shared_1 = require("@explorins/pers-shared");
-/**
- * BaseOrchestrator - Centralized Application Layer Orchestration Pattern
- *
- * @description Foundation for all domain orchestrators following PERS DDD principles:
- * - Application layer orchestrates cross-domain operations via CQRS
- * - Domain services contain pure business logic only
- * - Microservice boundary preparation through clean abstractions
- * - Consistent patterns across all domains (transaction, user, wallet, token, etc.)
- * - Smart error handling that preserves business context
- *
- * @usage Extend this class in domain-specific orchestrators:
- * ```typescript
- * @Injectable()
- * export class UserOrchestrator extends BaseOrchestrator {
- *   constructor(commandBus: CommandBus, queryBus: QueryBus) {
- *     super(commandBus, queryBus, UserOrchestrator.name);
- *   }
- * }
- * ```
- *
- * @library @explorins/pers-shared
- * @version 2.0.0
- * @since August 2025
- */
-class BaseOrchestrator {
-    commandBus;
-    queryBus;
-    logger;
-    constructor(commandBus, queryBus, loggerContext) {
-        this.commandBus = commandBus;
-        this.queryBus = queryBus;
-        this.logger = new common_1.Logger(loggerContext);
-    }
-    /**
-     * Enhanced error handling that preserves business errors while wrapping technical errors
-     * Business errors (with category: DOMAIN_RULE) are passed through unchanged
-     * Technical errors are wrapped in OrchestrationError for consistent handling
-     */
-    async executeWithErrorHandling(operation, operationName, context) {
-        try {
-            this.logger.debug(`🚀 Starting ${operationName}`, context);
-            const result = await operation();
-            this.logger.debug(`✅ Completed ${operationName}`, context);
-            return result;
-        }
-        catch (error) {
-            const errorMessage = error instanceof Error ? error.message : String(error);
-            // Preserve business errors - don't wrap them
-            if (error instanceof common_1.HttpException) {
-                const response = error.getResponse();
-                if (typeof response === 'object' && response?.category === pers_shared_1.ErrorCategory.DOMAIN_RULE) {
-                    this.logger.warn(`⚠️ Business logic error in ${operationName}: ${errorMessage}`, { ...context, error });
-                    throw error; // Pass through unchanged
-                }
-            }
-            // Wrap technical errors
-            this.logger.error(`❌ Failed ${operationName}: ${errorMessage}`, { ...context, error });
-            throw new pers_shared_1.OrchestrationError(operationName, error instanceof Error ? error : new Error(errorMessage));
-        }
-    }
-    /**
-     * Execute CQRS command with consistent error handling and logging
-     * Standardizes command execution across all orchestrators
-     */
-    async executeCommand(command, operationName) {
-        const operation = operationName || `Command: ${command.constructor.name}`;
-        return this.executeWithErrorHandling(() => this.commandBus.execute(command), operation, { commandType: command.constructor.name });
-    }
-    /**
-     * Execute CQRS query with consistent error handling and logging
-     * Standardizes query execution across all orchestrators
-     */
-    async executeQuery(query, operationName) {
-        const operation = operationName || `Query: ${query.constructor.name}`;
-        return this.executeWithErrorHandling(() => this.queryBus.execute(query), operation, { queryType: query.constructor.name });
-    }
-    /**
-     * Execute multiple operations in parallel with error handling
-     * Useful for batch operations across domains
-     */
-    async executeParallel(operations, operationName) {
-        return this.executeWithErrorHandling(() => Promise.all(operations.map(op => op())), `Parallel: ${operationName}`, { operationCount: operations.length });
-    }
-}
-exports.BaseOrchestrator = BaseOrchestrator;
-/**
- * Helper function to create success result
- */
-function createSuccessResult(data, operation) {
-    return { success: true, data, operation };
-}
-/**
- * Helper function to create error result
- */
-function createErrorResult(error, operation) {
-    return { success: false, error, operation };
-}
-/**
- * Utility function to check if result is successful
- * Provides type guard for TypeScript
- */
-function isSuccessResult(result) {
-    return result.success === true;
-}
-/**
- * Utility function to extract data from result or throw error
- * Useful for converting result pattern back to exception-based flow
- */
-function unwrapResult(result) {
-    if (isSuccessResult(result)) {
-        return result.data;
-    }
-    throw result.error;
-}
-//# sourceMappingURL=base-orchestrator.js.map

package/dist/cjs/internal/orchestrators/base-orchestrator.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"base-orchestrator.js","sourceRoot":"","sources":["../../../../src/internal/orchestrators/base-orchestrator.ts"],"names":[],"mappings":"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"}

package/dist/cjs/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/cjs/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/cjs/internal/orchestrators/base-workflow.js

@@ -1,68 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.BaseWorkflow = void 0;
-const common_1 = require("@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
- */
-class BaseWorkflow {
-    logger;
-    constructor(loggerContext) {
-        this.logger = new common_1.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
-        }
-    }
-}
-exports.BaseWorkflow = BaseWorkflow;
-//# sourceMappingURL=base-workflow.js.map

package/dist/cjs/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,2CAAwC;AAExC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAkCG;AACH,MAAsB,YAAY;IACb,MAAM,CAAS;IAElC,YAAsB,aAAqB;QACzC,IAAI,CAAC,MAAM,GAAG,IAAI,eAAM,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;AA/BD,oCA+BC"}

package/dist/cjs/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/cjs/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/cjs/internal/orchestrators/index.js

@@ -1,46 +0,0 @@
-"use strict";
-/**
- * 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
- */
-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 });
-__exportStar(require("./base-orchestrator"), exports);
-__exportStar(require("./base-workflow"), exports);
-// 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/cjs/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,sDAAoC;AACpC,kDAAgC;AAEhC,oDAAoD;AACpD,6CAA6C;AAC7C,wCAAwC;AACxC,+CAA+C"}