@carbonbox/domain 0.1.5 → 0.2.2

package/build/carbonbox/shared/either/domain/utils/EitherUtils.js

@@ -1,2 +1,93 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.EitherUtils = void 0;
+const LeftEitherImpl_1 = require("../implementations/LeftEitherImpl");
+const RightEitherImpl_1 = require("../implementations/RightEitherImpl");
+/**
+ * Utilidades para operaciones Either que requieren crear instancias cruzadas
+ * Resuelve dependencias circulares centralizando la creación
+ */
+class EitherUtils {
+    // ─── Métodos de creación cruzada ─────────────────────────────────────────────
+    /** Intercambia Left y Right */
+    static swap(either) {
+        return either.fold((left) => new RightEitherImpl_1.RightEitherImpl(left), (right) => new LeftEitherImpl_1.LeftEitherImpl(right));
+    }
+    /** Aplica un filtro creando Left si no pasa */
+    static filter(either, predicate, errorFactory) {
+        if (either.isLeft === true) {
+            return either;
+        }
+        const value = either.right();
+        return predicate(value) === true
+            ? either
+            : new LeftEitherImpl_1.LeftEitherImpl(errorFactory());
+    }
+    // ─── Métodos de combinación ──────────────────────────────────────────────────
+    /** Combina múltiples Either en uno solo - falla en el primer Left */
+    static sequence(eithers) {
+        const results = [];
+        for (const either of eithers) {
+            if (either.isLeft === true) {
+                return either;
+            }
+            results.push(either.right());
+        }
+        return new RightEitherImpl_1.RightEitherImpl(results);
+    }
+    /** Aplica una función que puede fallar a cada elemento */
+    static traverse(items, fn) {
+        return EitherUtils.sequence(items.map(fn));
+    }
+    /** Combina dos Either con una función */
+    static lift2(fn, eitherA, eitherB) {
+        return eitherA.flatMap((a) => eitherB.map((b) => fn(a, b)));
+    }
+    /** Combina tres Either con una función */
+    static lift3(fn, eitherA, eitherB, eitherC) {
+        return eitherA.flatMap((a) => eitherB.flatMap((b) => eitherC.map((c) => fn(a, b, c))));
+    }
+    /** Acumula errores en lugar de fallar en el primero */
+    static accumulate(eithers) {
+        const lefts = [];
+        const rights = [];
+        for (const either of eithers) {
+            either.fold((left) => lefts.push(left), (right) => rights.push(right));
+        }
+        return lefts.length > 0
+            ? new LeftEitherImpl_1.LeftEitherImpl(lefts)
+            : new RightEitherImpl_1.RightEitherImpl(rights);
+    }
+    // ─── Métodos de validación y transformación ─────────────────────────────────
+    /** Ejecuta Either en paralelo y acumula todos los errores */
+    static async parallel(operations) {
+        const results = await Promise.all(operations.map((op) => op()));
+        return EitherUtils.accumulate(results);
+    }
+    /** Aplica una transformación solo si se cumple una condición */
+    static when(condition, transform) {
+        return (either) => {
+            if (condition !== true || either.isLeft === true) {
+                return either;
+            }
+            return either.flatMap(transform);
+        };
+    }
+    /** Aplica una transformación solo si NO se cumple una condición */
+    static unless(condition, transform) {
+        return EitherUtils.when(condition !== true, transform);
+    }
+    // ─── Métodos de depuración ───────────────────────────────────────────────────
+    /** Ejecuta una función de side-effect sin afectar el Either */
+    static tap(either, onLeft, onRight) {
+        either.fold((left) => onLeft?.(left), (right) => onRight?.(right));
+        return either;
+    }
+    /** Log del estado del Either */
+    static log(either, prefix = 'Either') {
+        // eslint-disable-next-line no-console
+        console.log(`${prefix}:`, either.inspect());
+        return either;
+    }
+}
+exports.EitherUtils = EitherUtils;

package/build/carbonbox/shared/either/index.js

@@ -0,0 +1,81 @@
+"use strict";
+// =============================================================================
+// EITHER PATTERN - PUNTO DE ENTRADA PRINCIPAL
+// =============================================================================
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IS_REFACTORED = exports.EITHER_VERSION = exports.ResultUtils = exports.RightEither = exports.LeftEither = exports.Either = exports.CannotAccessRightOnLeftValueError = exports.CannotAccessLeftOnRightValueError = exports.ResultExtensions = exports.EitherUtils = exports.ResultFactory = exports.EitherFactory = exports.RightEitherImpl = exports.LeftEitherImpl = void 0;
+exports.configureEither = configureEither;
+exports.getEitherConfig = getEitherConfig;
+// ─── Imports para compatibilidad ────────────────────────────────────────────
+const ResultFactory_1 = require("./domain/factories/ResultFactory");
+// ─── Implementaciones principales ────────────────────────────────────────────
+var LeftEitherImpl_1 = require("./domain/implementations/LeftEitherImpl");
+Object.defineProperty(exports, "LeftEitherImpl", { enumerable: true, get: function () { return LeftEitherImpl_1.LeftEitherImpl; } });
+var RightEitherImpl_1 = require("./domain/implementations/RightEitherImpl");
+Object.defineProperty(exports, "RightEitherImpl", { enumerable: true, get: function () { return RightEitherImpl_1.RightEitherImpl; } });
+// ─── Factories ───────────────────────────────────────────────────────────────
+var EitherFactory_1 = require("./domain/factories/EitherFactory");
+Object.defineProperty(exports, "EitherFactory", { enumerable: true, get: function () { return EitherFactory_1.EitherFactory; } });
+var ResultFactory_2 = require("./domain/factories/ResultFactory");
+Object.defineProperty(exports, "ResultFactory", { enumerable: true, get: function () { return ResultFactory_2.ResultFactory; } });
+// ─── Utilidades ──────────────────────────────────────────────────────────────
+var EitherUtils_1 = require("./domain/utils/EitherUtils");
+Object.defineProperty(exports, "EitherUtils", { enumerable: true, get: function () { return EitherUtils_1.EitherUtils; } });
+var ResultExtensions_1 = require("./domain/utils/ResultExtensions");
+Object.defineProperty(exports, "ResultExtensions", { enumerable: true, get: function () { return ResultExtensions_1.ResultExtensions; } });
+// ─── Excepciones ─────────────────────────────────────────────────────────────
+var CannotAccessLeftOnRightValueError_1 = require("./domain/exceptions/CannotAccessLeftOnRightValueError");
+Object.defineProperty(exports, "CannotAccessLeftOnRightValueError", { enumerable: true, get: function () { return CannotAccessLeftOnRightValueError_1.CannotAccessLeftOnRightValueError; } });
+var CannotAccessRightOnLeftValueError_1 = require("./domain/exceptions/CannotAccessRightOnLeftValueError");
+Object.defineProperty(exports, "CannotAccessRightOnLeftValueError", { enumerable: true, get: function () { return CannotAccessRightOnLeftValueError_1.CannotAccessRightOnLeftValueError; } });
+// =============================================================================
+// COMPATIBILIDAD CON API EXISTENTE
+// =============================================================================
+// ─── Alias para mantener compatibilidad ─────────────────────────────────────
+var EitherFactory_2 = require("./domain/factories/EitherFactory");
+Object.defineProperty(exports, "Either", { enumerable: true, get: function () { return EitherFactory_2.EitherFactory; } });
+var LeftEitherImpl_2 = require("./domain/implementations/LeftEitherImpl");
+Object.defineProperty(exports, "LeftEither", { enumerable: true, get: function () { return LeftEitherImpl_2.LeftEitherImpl; } });
+var RightEitherImpl_2 = require("./domain/implementations/RightEitherImpl");
+Object.defineProperty(exports, "RightEither", { enumerable: true, get: function () { return RightEitherImpl_2.RightEitherImpl; } });
+// ─── Namespace Result para compatibilidad ───────────────────────────────────
+var ResultUtils;
+(function (ResultUtils) {
+    ResultUtils.fail = ResultFactory_1.ResultFactory.fail;
+    ResultUtils.failMultiple = ResultFactory_1.ResultFactory.failMultiple;
+    ResultUtils.ok = ResultFactory_1.ResultFactory.ok;
+    ResultUtils.fromEither = ResultFactory_1.ResultFactory.fromEither;
+    ResultUtils.fromEitherMultiple = ResultFactory_1.ResultFactory.fromEitherMultiple;
+    ResultUtils.fromNullable = ResultFactory_1.ResultFactory.fromNullable;
+    ResultUtils.fromCondition = ResultFactory_1.ResultFactory.fromCondition;
+    ResultUtils.fromTryCatch = ResultFactory_1.ResultFactory.fromTryCatch;
+    ResultUtils.fromPromise = ResultFactory_1.ResultFactory.fromPromise;
+    ResultUtils.sequence = ResultFactory_1.ResultFactory.sequence;
+    ResultUtils.traverse = ResultFactory_1.ResultFactory.traverse;
+    ResultUtils.accumulate = ResultFactory_1.ResultFactory.accumulate;
+    ResultUtils.parallel = ResultFactory_1.ResultFactory.parallel;
+    ResultUtils.chain = ResultFactory_1.ResultFactory.chain;
+    ResultUtils.validate = ResultFactory_1.ResultFactory.validate;
+    ResultUtils.when = ResultFactory_1.ResultFactory.when;
+    ResultUtils.unless = ResultFactory_1.ResultFactory.unless;
+})(ResultUtils || (exports.ResultUtils = ResultUtils = {}));
+let globalConfig = {
+    enableLogging: false,
+    logPrefix: 'Either',
+    debugMode: false,
+};
+/** Configura el comportamiento global de Either */
+function configureEither(config) {
+    globalConfig = { ...globalConfig, ...config };
+}
+/** Obtiene la configuración actual */
+function getEitherConfig() {
+    return { ...globalConfig };
+}
+// =============================================================================
+// EXPORTS FINALES
+// =============================================================================
+/** Versión del paquete Either */
+exports.EITHER_VERSION = '2.0.0';
+/** Flag para indicar que se está usando la versión refactorizada */
+exports.IS_REFACTORED = true;

package/build/main/index.js

@@ -12,8 +12,8 @@ exports.InvalidMarkupPercentageError = exports.InvalidDiscountPercentageError =
 exports.StringList = exports.CodeList = exports.AggregateIdList = exports.TaxIdentification = exports.Gender = exports.Currency = exports.ColombiaNIT = exports.TaxIdentificationNumber = exports.ExecutionPeriod = exports.AggregateId = exports.Code = exports.Url = exports.Image = exports.Address = exports.Phone = exports.Email = exports.DateTimeString = exports.DateString = exports.Boolean = exports.Numeric = exports.PositiveInteger = exports.Integer = exports.String = exports.TaxIdentificationType = exports.SystemBoundary = exports.StakeholderRole = exports.ReportingStandard = exports.ISOCategory = exports.GreenhouseGas = exports.GenderType = exports.GHGSubScope = exports.GHGScope = exports.EmissionSourceType = exports.EmissionCategory = exports.DayOfWeek = exports.CurrencyCode = exports.CountryCode = exports.BusinessScale = exports.RootError = exports.ObjectValueObject = exports.PrimitiveValueObject = exports.ValueObject = exports.User = exports.DomainError = exports.AggregateRoot = exports.InvalidUnitsError = exports.InvalidTaxPercentageError = exports.InvalidPricingStatusError = exports.InvalidPricingModelError = exports.InvalidPricePerUnitError = void 0;
 exports.ProductConfigurationCarbonFootprintSegmentReference = exports.ProductCarbonFootprintSegmentConfigurationReferences = exports.FacilityReference = exports.EventReference = exports.EventEditionReferences = exports.EventEditionReference = exports.EventEditionLifecycleStageReference = exports.EventEditionLifecycleStageConfigurationReferences = exports.EventEditionConfigurationCarbonFootprintSubsegmentReferences = exports.EventEditionConfigurationCarbonFootprintSubsegmentReference = exports.CorporateConfigurationCarbonFootprintSubsegmentReference = exports.CorporateConfigurationCarbonFootprintSegmentReference = exports.CorporateCarbonFootprintSegmentConfigurationReferences = exports.CollectionFieldReference = exports.CarbonFootprintSegmentReferences = exports.CarbonFootprintIntensityIndicatorReference = exports.CarbonFootprintConfigurationReference = exports.GlobalWarmingPotentialReference = exports.EmissionFactorReference = exports.EmissionCalculationFormulaReference = exports.EmissionCalculationReference = exports.CalculationVariableReferences = exports.CalculationProcessReference = exports.ActivityDataSubmissionReference = exports.EmissionSource = exports.EmissionSources = exports.CarbonClientReferences = exports.CarbonClientReference = exports.StakeholderReferences = exports.StakeholderReference = exports.UserLastAccessAt = exports.UserAvatar = exports.UserPassword = exports.UserDisplayName = exports.UserId = exports.UserEmail = exports.NullableProductConfigurationCarbonFootprintSubsegmentReference = exports.NullableEventEditionConfigurationCarbonFootprintSubsegmentReference = exports.NullableCorporateConfigurationCarbonFootprintSubsegmentReference = exports.NullableStakeholderReference = exports.NullableColombianNIT = exports.NullableTaxIdentificationNumber = exports.NullablePositiveInteger = exports.NullableNumeric = exports.NullableDateTimeString = exports.NullableDate = exports.NullableCode = exports.NullableString = exports.TaxIdentificationNumberList = exports.UrlList = void 0;
 exports.InvalidMinutesDurationError = exports.InvalidMeasurementUnitOperationError = exports.InvalidManagedStakeholderRoleError = exports.InvalidDomainCodeError = exports.InvalidCountrySpecificTaxIdentificationNumberError = exports.InvalidCodeError = exports.InvalidAssignerRoleError = exports.InvalidAggregateIdError = exports.EmptyTaxIdentificationNumberError = exports.EmptySegmentNameError = exports.EmptySegmentCodeError = exports.EmptyDisplayNameError = exports.DateGreaterThanError = exports.DivisionByZeroError = exports.MoneyOverflowError = exports.NotIntegerError = exports.NegativeAmountError = exports.MinimumValueViolationError = exports.InvalidUrlListError = exports.InvalidCodeListError = exports.InvalidStringListError = exports.EmptyArrayNotAllowedError = exports.PasswordPolicyViolationError = exports.InvalidNationalNumberError = exports.InvalidFullInternationalNumberError = exports.InvalidEmailPolicyError = exports.InvalidCoordinatesError = exports.InvalidTimeFormatError = exports.InvalidDateRangeError = exports.InvalidDateFormatError = exports.InvalidColombianNITNumberError = exports.InvalidColombianNITCheckDigitError = exports.InvalidColombianNITFormatError = exports.InvalidTaxIdentificationTypeError = exports.InvalidStakeholderRoleTypeError = exports.InvalidGenderError = exports.InvalidCurrencyError = exports.InvalidCountryCodeError = exports.InvalidBusinessScaleError = exports.InvalidPropertyValueError = exports.InvalidPropertyTypeError = exports.InvalidValueObjectConfigurationError = exports.UndefinedValueError = exports.NullValueError = exports.MethodNotImplementedError = exports.CreateMethodNotImplementedError = exports.ServiceReference = exports.ProductReference = exports.ProductConfigurationSystemBoundaryReference = exports.ProductConfigurationCarbonFootprintSubsegmentReference = void 0;
-exports.StakeholderBusinessStatusEnum = exports.CarbonManagerManagedStakeholders = exports.CarbonManagerDisplayName = exports.CarbonManagerEmail = exports.CarbonManagerId = exports.CarbonHostDisplayName = exports.CarbonHostEmail = exports.CarbonHostId = exports.CarbonCoordinatorManagedCarbonClients = exports.CarbonCoordinatorWeeklyWorkingSchedule = exports.CarbonCoordinatorGender = exports.CarbonCoordinatorAvailabilityStatus = exports.CarbonCoordinatorDisplayName = exports.CarbonCoordinatorEmail = exports.CarbonCoordinatorId = exports.CarbonClientPrimaryContactPhone = exports.CarbonClientPrimaryContactEmail = exports.CarbonClientLogo = exports.CarbonClientWebsiteUrl = exports.CarbonClientPhysicalAddress = exports.CarbonClientOrganizationSize = exports.CarbonClientIndustryType = exports.CarbonClientLegalBusinessName = exports.CarbonClientAccountType = exports.CarbonClientDisplayName = exports.CarbonClientEmail = exports.CarbonClientId = exports.StakeholderLastAccessAt = exports.StakeholderAvatar = exports.StakeholderTaxIdentification = exports.StakeholderRoleType = exports.StakeholderBusinessStatus = exports.StakeholderPassword = exports.StakeholderDisplayName = exports.StakeholderEmail = exports.StakeholderId = exports.CarbonManager = exports.CarbonHost = exports.CarbonCoordinator = exports.CarbonClient = exports.Stakeholder = exports.CannotAccessRightOnLeftValueError = exports.CannotAccessLeftOnRightValueError = exports.RightEither = exports.LeftEither = exports.Either = exports.TaxIdentificationNumberWithControlCharactersError = exports.InvalidTaxIdentificationNumberLengthError = exports.InvalidTaxIdentificationNumberFormatError = exports.InvalidSupervisorRoleError = void 0;
-exports.DateTimeFormattingDomainService = exports.InvalidCarbonCoordinatorAvailabilityStatusError = exports.InvalidCarbonClientAccountTypeError = exports.InvalidStakeholderBusinessStatusError = exports.CarbonCoordinatorAvailabilityStatusEnum = exports.CarbonClientAccount = void 0;
+exports.CarbonManagerId = exports.CarbonHostDisplayName = exports.CarbonHostEmail = exports.CarbonHostId = exports.CarbonCoordinatorManagedCarbonClients = exports.CarbonCoordinatorWeeklyWorkingSchedule = exports.CarbonCoordinatorGender = exports.CarbonCoordinatorAvailabilityStatus = exports.CarbonCoordinatorDisplayName = exports.CarbonCoordinatorEmail = exports.CarbonCoordinatorId = exports.CarbonClientPrimaryContactPhone = exports.CarbonClientPrimaryContactEmail = exports.CarbonClientLogo = exports.CarbonClientWebsiteUrl = exports.CarbonClientPhysicalAddress = exports.CarbonClientOrganizationSize = exports.CarbonClientIndustryType = exports.CarbonClientLegalBusinessName = exports.CarbonClientAccountType = exports.CarbonClientDisplayName = exports.CarbonClientEmail = exports.CarbonClientId = exports.StakeholderLastAccessAt = exports.StakeholderAvatar = exports.StakeholderTaxIdentification = exports.StakeholderRoleType = exports.StakeholderBusinessStatus = exports.StakeholderPassword = exports.StakeholderDisplayName = exports.StakeholderEmail = exports.StakeholderId = exports.CarbonManager = exports.CarbonHost = exports.CarbonCoordinator = exports.CarbonClient = exports.Stakeholder = exports.CannotAccessRightOnLeftValueError = exports.CannotAccessLeftOnRightValueError = exports.ResultExtensions = exports.EitherUtils = exports.ResultFactory = exports.EitherFactory = exports.RightEither = exports.LeftEither = exports.Either = exports.TaxIdentificationNumberWithControlCharactersError = exports.InvalidTaxIdentificationNumberLengthError = exports.InvalidTaxIdentificationNumberFormatError = exports.InvalidSupervisorRoleError = void 0;
+exports.DateTimeFormattingDomainService = exports.InvalidCarbonCoordinatorAvailabilityStatusError = exports.InvalidCarbonClientAccountTypeError = exports.InvalidStakeholderBusinessStatusError = exports.CarbonCoordinatorAvailabilityStatusEnum = exports.CarbonClientAccount = exports.StakeholderBusinessStatusEnum = exports.CarbonManagerManagedStakeholders = exports.CarbonManagerDisplayName = exports.CarbonManagerEmail = void 0;
 // ─── Entity Classes (For Application Layer) ─────────────────────────────────
 var ActivityDataSubmission_1 = require("../carbonbox/activity-data-collection/activity-data-submissions/domain/entity/ActivityDataSubmission");
 Object.defineProperty(exports, "ActivityDataSubmission", { enumerable: true, get: function () { return ActivityDataSubmission_1.ActivityDataSubmission; } });
@@ -1037,17 +1037,20 @@ Object.defineProperty(exports, "InvalidTaxIdentificationNumberLengthError", { en
 var TaxIdentificationNumberWithControlCharactersError_1 = require("../carbonbox/shared/domain/exceptions/TaxIdentificationNumberWithControlCharactersError");
 Object.defineProperty(exports, "TaxIdentificationNumberWithControlCharactersError", { enumerable: true, get: function () { return TaxIdentificationNumberWithControlCharactersError_1.TaxIdentificationNumberWithControlCharactersError; } });
 // ─── Either Pattern (Functional Exception Handling) ─────────────────────────
-var Either_1 = require("../carbonbox/shared/either/domain/models/Either");
-Object.defineProperty(exports, "Either", { enumerable: true, get: function () { return Either_1.Either; } });
-var LeftEither_1 = require("../carbonbox/shared/either/domain/models/LeftEither");
-Object.defineProperty(exports, "LeftEither", { enumerable: true, get: function () { return LeftEither_1.LeftEither; } });
-var RightEither_1 = require("../carbonbox/shared/either/domain/models/RightEither");
-Object.defineProperty(exports, "RightEither", { enumerable: true, get: function () { return RightEither_1.RightEither; } });
+var either_1 = require("../carbonbox/shared/either");
+Object.defineProperty(exports, "Either", { enumerable: true, get: function () { return either_1.Either; } });
+Object.defineProperty(exports, "LeftEither", { enumerable: true, get: function () { return either_1.LeftEither; } });
+Object.defineProperty(exports, "RightEither", { enumerable: true, get: function () { return either_1.RightEither; } });
+var either_2 = require("../carbonbox/shared/either");
+Object.defineProperty(exports, "EitherFactory", { enumerable: true, get: function () { return either_2.EitherFactory; } });
+Object.defineProperty(exports, "ResultFactory", { enumerable: true, get: function () { return either_2.ResultFactory; } });
+var either_3 = require("../carbonbox/shared/either");
+Object.defineProperty(exports, "EitherUtils", { enumerable: true, get: function () { return either_3.EitherUtils; } });
+Object.defineProperty(exports, "ResultExtensions", { enumerable: true, get: function () { return either_3.ResultExtensions; } });
 // Either Pattern Exceptions
-var CannotAccessLeftOnRightValueError_1 = require("../carbonbox/shared/either/domain/exceptions/CannotAccessLeftOnRightValueError");
-Object.defineProperty(exports, "CannotAccessLeftOnRightValueError", { enumerable: true, get: function () { return CannotAccessLeftOnRightValueError_1.CannotAccessLeftOnRightValueError; } });
-var CannotAccessRightOnLeftValueError_1 = require("../carbonbox/shared/either/domain/exceptions/CannotAccessRightOnLeftValueError");
-Object.defineProperty(exports, "CannotAccessRightOnLeftValueError", { enumerable: true, get: function () { return CannotAccessRightOnLeftValueError_1.CannotAccessRightOnLeftValueError; } });
+var either_4 = require("../carbonbox/shared/either");
+Object.defineProperty(exports, "CannotAccessLeftOnRightValueError", { enumerable: true, get: function () { return either_4.CannotAccessLeftOnRightValueError; } });
+Object.defineProperty(exports, "CannotAccessRightOnLeftValueError", { enumerable: true, get: function () { return either_4.CannotAccessRightOnLeftValueError; } });
 var Stakeholder_1 = require("../carbonbox/stakeholders/shared/domain/entity/Stakeholder");
 Object.defineProperty(exports, "Stakeholder", { enumerable: true, get: function () { return Stakeholder_1.Stakeholder; } });
 var CarbonClient_1 = require("../carbonbox/stakeholders/carbon-clients/domain/entity/CarbonClient");

package/build/types/carbonbox/shared/either/domain/contracts/Functor.d.ts

@@ -1,4 +1,4 @@
-export interface Functor<T> {
-    map<U>(fn: (value: T) => U): Functor<U>;
+export interface IFunctor<T> {
+    map<U>(fn: (value: T) => U): IFunctor<U>;
 }
 //# sourceMappingURL=Functor.d.ts.map

package/build/types/carbonbox/shared/either/domain/contracts/Functor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Functor.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/Functor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,OAAO,CAAC,CAAC;IACxB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,CAAC;CACzC"}
+{"version":3,"file":"Functor.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/Functor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC1C"}

package/build/types/carbonbox/shared/either/domain/contracts/IEither.d.ts

@@ -0,0 +1,45 @@
+import { IMonad } from './IMonad';
+import { EitherState } from '../types/EitherState';
+/**
+ * Interface principal para el patrón Either
+ * Representa una computación que puede resultar en éxito (Right) o fallo (Left)
+ */
+export interface IEither<L, R> extends IMonad<R> {
+    /** Estado interno del Either (left o right) */
+    readonly state: EitherState;
+    /** Indica si este Either contiene un valor Left */
+    readonly isLeft: boolean;
+    /** Indica si este Either contiene un valor Right */
+    readonly isRight: boolean;
+    /** Obtiene el valor Left de forma segura (puede ser undefined) */
+    getLeft(): L | undefined;
+    /** Obtiene el valor Right de forma segura (puede ser undefined) */
+    getRight(): R | undefined;
+    /** Obtiene el valor Left (lanza excepción si es Right) */
+    left(): L;
+    /** Obtiene el valor Right (lanza excepción si es Left) */
+    right(): R;
+    /** Transforma el valor Right manteniendo Left intacto */
+    map<U>(fn: (value: R) => U): IEither<L, U>;
+    /** Transforma el valor Left manteniendo Right intacto */
+    mapLeft<U>(fn: (value: L) => U): IEither<U, R>;
+    /** Composición monádica - encadena operaciones Either */
+    flatMap<U>(fn: (value: R) => IEither<L, U>): IEither<L, U>;
+    /** Aplica una función según el estado del Either */
+    fold<U>(onLeft: (left: L) => U, onRight: (right: R) => U): U;
+    /** Obtiene el valor Right o un valor de fallback */
+    getOrElse(fallback: R): R;
+    getOrElse(fallback: () => R): R;
+    getOrElse(fallback: R | (() => R)): R;
+    /** Aplica un filtro al valor Right */
+    filter(predicate: (value: R) => boolean, errorFactory: () => L): IEither<L, R>;
+    /** Alias para flatMap (más semántico para validaciones) */
+    chain<U>(fn: (value: R) => IEither<L, U>): IEither<L, U>;
+    /** Convierte a Optional (undefined si es Left) */
+    toOptional(): R | undefined;
+    /** Intercambia Left y Right */
+    swap(): IEither<R, L>;
+    /** Representación string para debugging */
+    inspect(): string;
+}
+//# sourceMappingURL=IEither.d.ts.map

package/build/types/carbonbox/shared/either/domain/contracts/IEither.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IEither.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/IEither.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAClC,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;;GAGG;AACH,MAAM,WAAW,OAAO,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,MAAM,CAAC,CAAC,CAAC;IAC9C,+CAA+C;IAC/C,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC;IAE5B,mDAAmD;IACnD,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IAEzB,oDAAoD;IACpD,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAI1B,kEAAkE;IAClE,OAAO,IAAI,CAAC,GAAG,SAAS,CAAC;IAEzB,mEAAmE;IACnE,QAAQ,IAAI,CAAC,GAAG,SAAS,CAAC;IAI1B,0DAA0D;IAC1D,IAAI,IAAI,CAAC,CAAC;IAEV,0DAA0D;IAC1D,KAAK,IAAI,CAAC,CAAC;IAIX,yDAAyD;IACzD,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE3C,yDAAyD;IACzD,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/C,yDAAyD;IACzD,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAI3D,oDAAoD;IACpD,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAE7D,oDAAoD;IACpD,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,CAAC;IAC1B,SAAS,CAAC,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAChC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC;IAItC,sCAAsC;IACtC,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,EAAE,YAAY,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAE/E,2DAA2D;IAC3D,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAIzD,kDAAkD;IAClD,UAAU,IAAI,CAAC,GAAG,SAAS,CAAC;IAE5B,+BAA+B;IAC/B,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAItB,2CAA2C;IAC3C,OAAO,IAAI,MAAM,CAAC;CACnB"}

package/build/types/carbonbox/shared/either/domain/contracts/IFunctor.d.ts

@@ -0,0 +1,4 @@
+export interface IFunctor<T> {
+    map<U>(fn: (value: T) => U): IFunctor<U>;
+}
+//# sourceMappingURL=IFunctor.d.ts.map

package/build/types/carbonbox/shared/either/domain/contracts/IFunctor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IFunctor.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/IFunctor.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ,CAAC,CAAC;IACzB,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;CAC1C"}

package/build/types/carbonbox/shared/either/domain/contracts/ILeftEither.d.ts

@@ -0,0 +1,22 @@
+import { IEither } from './IEither';
+/**
+ * Interface específica para representar el estado Left del Either
+ * Contiene un valor de error o fallo
+ */
+export interface ILeftEither<L, R> extends IEither<L, R> {
+    /** Siempre true para LeftEither */
+    readonly isLeft: true;
+    /** Siempre false para LeftEither */
+    readonly isRight: false;
+    /** Obtiene el valor Left (nunca undefined en LeftEither) */
+    getLeft(): L;
+    /** Siempre undefined para LeftEither */
+    getRight(): undefined;
+    /** Obtiene el valor Left directamente */
+    left(): L;
+    /** Lanza excepción para LeftEither */
+    right(): never;
+    /** Siempre undefined para LeftEither */
+    toOptional(): undefined;
+}
+//# sourceMappingURL=ILeftEither.d.ts.map

package/build/types/carbonbox/shared/either/domain/contracts/ILeftEither.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ILeftEither.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/ILeftEither.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACtD,mCAAmC;IACnC,QAAQ,CAAC,MAAM,EAAE,IAAI,CAAC;IAEtB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IAExB,4DAA4D;IAC5D,OAAO,IAAI,CAAC,CAAC;IAEb,wCAAwC;IACxC,QAAQ,IAAI,SAAS,CAAC;IAEtB,yCAAyC;IACzC,IAAI,IAAI,CAAC,CAAC;IAEV,sCAAsC;IACtC,KAAK,IAAI,KAAK,CAAC;IAEf,wCAAwC;IACxC,UAAU,IAAI,SAAS,CAAC;CACzB"}

package/build/types/carbonbox/shared/either/domain/contracts/IMonad.d.ts

@@ -0,0 +1,5 @@
+import { IFunctor } from './IFunctor';
+export interface IMonad<T> extends IFunctor<T> {
+    flatMap<U>(fn: (value: T) => IMonad<U>): IMonad<U>;
+}
+//# sourceMappingURL=IMonad.d.ts.map

package/build/types/carbonbox/shared/either/domain/contracts/IMonad.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IMonad.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/IMonad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,MAAM,WAAW,MAAM,CAAC,CAAC,CAAE,SAAQ,QAAQ,CAAC,CAAC,CAAC;IAC5C,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,CAAC,CAAC,CAAC,CAAC;CACpD"}

package/build/types/carbonbox/shared/either/domain/contracts/IRightEither.d.ts

@@ -0,0 +1,22 @@
+import { IEither } from './IEither';
+/**
+ * Interface específica para representar el estado Right del Either
+ * Contiene un valor de éxito
+ */
+export interface IRightEither<L, R> extends IEither<L, R> {
+    /** Siempre false para RightEither */
+    readonly isLeft: false;
+    /** Siempre true para RightEither */
+    readonly isRight: true;
+    /** Siempre undefined para RightEither */
+    getLeft(): undefined;
+    /** Obtiene el valor Right (nunca undefined en RightEither) */
+    getRight(): R;
+    /** Lanza excepción para RightEither */
+    left(): never;
+    /** Obtiene el valor Right directamente */
+    right(): R;
+    /** Obtiene el valor Right para RightEither */
+    toOptional(): R;
+}
+//# sourceMappingURL=IRightEither.d.ts.map

package/build/types/carbonbox/shared/either/domain/contracts/IRightEither.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IRightEither.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/IRightEither.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC;;;GAGG;AACH,MAAM,WAAW,YAAY,CAAC,CAAC,EAAE,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IACvD,qCAAqC;IACrC,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAC;IAEvB,oCAAoC;IACpC,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IAEvB,yCAAyC;IACzC,OAAO,IAAI,SAAS,CAAC;IAErB,8DAA8D;IAC9D,QAAQ,IAAI,CAAC,CAAC;IAEd,uCAAuC;IACvC,IAAI,IAAI,KAAK,CAAC;IAEd,0CAA0C;IAC1C,KAAK,IAAI,CAAC,CAAC;IAEX,8CAA8C;IAC9C,UAAU,IAAI,CAAC,CAAC;CACjB"}

package/build/types/carbonbox/shared/either/domain/contracts/Monad.d.ts

@@ -1,5 +1,12 @@
-import { Functor } from './Functor';
-export interface Monad<T> extends Functor<T> {
-    flatMap<U>(fn: (value: T) => Monad<U>): Monad<U>;
+/**
+ * Interfaz para el patrón Monad
+ * Interfaz legacy para compatibilidad
+ */
+export interface Monad<R> {
+    /**
+     * Operación monádica para evitar anidamiento (flatMap/bind)
+     * Permite composición secuencial de operaciones que retornan monadas
+     */
+    flatMap<U>(fn: (value: R) => Monad<U>): Monad<U>;
 }
 //# sourceMappingURL=Monad.d.ts.map

package/build/types/carbonbox/shared/either/domain/contracts/Monad.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Monad.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/Monad.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,WAAW,KAAK,CAAC,CAAC,CAAE,SAAQ,OAAO,CAAC,CAAC,CAAC;IAC1C,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;CAClD"}
+{"version":3,"file":"Monad.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/contracts/Monad.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,WAAW,KAAK,CAAC,CAAC;IACtB;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;CAClD"}

package/build/types/carbonbox/shared/either/domain/exceptions/FilterOperationNotImplementedError.d.ts

@@ -0,0 +1,7 @@
+import { RootError } from '../../../domain/exceptions/RootError';
+export declare class FilterOperationNotImplementedError extends RootError {
+    constructor(message: string);
+    static create(context?: string): FilterOperationNotImplementedError;
+    logError(): string;
+}
+//# sourceMappingURL=FilterOperationNotImplementedError.d.ts.map

package/build/types/carbonbox/shared/either/domain/exceptions/FilterOperationNotImplementedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FilterOperationNotImplementedError.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/exceptions/FilterOperationNotImplementedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjE,qBAAa,kCAAmC,SAAQ,SAAS;gBACnD,OAAO,EAAE,MAAM;WAKJ,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,kCAAkC;IAMnE,QAAQ,IAAI,MAAM;CAGnC"}

package/build/types/carbonbox/shared/either/domain/exceptions/SwapOperationNotImplementedError.d.ts

@@ -0,0 +1,7 @@
+import { RootError } from '../../../domain/exceptions/RootError';
+export declare class SwapOperationNotImplementedError extends RootError {
+    constructor(message: string);
+    static create(context?: string): SwapOperationNotImplementedError;
+    logError(): string;
+}
+//# sourceMappingURL=SwapOperationNotImplementedError.d.ts.map

package/build/types/carbonbox/shared/either/domain/exceptions/SwapOperationNotImplementedError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SwapOperationNotImplementedError.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/exceptions/SwapOperationNotImplementedError.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,sCAAsC,CAAC;AAEjE,qBAAa,gCAAiC,SAAQ,SAAS;gBACjD,OAAO,EAAE,MAAM;WAKJ,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,gCAAgC;IAMjE,QAAQ,IAAI,MAAM;CAGnC"}

package/build/types/carbonbox/shared/either/domain/factories/EitherFactory.d.ts

@@ -0,0 +1,36 @@
+import { IEither } from '../contracts/IEither';
+/**
+ * Factory para crear instancias de Either
+ * Resuelve las dependencias circulares al separar la creación de la implementación
+ */
+export declare class EitherFactory {
+    /** Crea un Either Left que contiene un valor de error */
+    static left<L, R>(value: L): IEither<L, R>;
+    /** Crea un Either Right que contiene un valor de éxito */
+    static right<L, R>(value: R): IEither<L, R>;
+    /** Factory method para manejo seguro de operaciones que pueden fallar */
+    static fromTryCatch<L, R>(operation: () => R, errorMapper: (error: unknown) => L): IEither<L, R>;
+    /** Factory method para promesas */
+    static fromPromise<L, R>(promise: Promise<R>, errorMapper: (error: unknown) => L): Promise<IEither<L, R>>;
+    /** Factory method para valores que pueden ser null o undefined */
+    static fromNullable<L, R>(value: R | null | undefined, errorFactory: () => L): IEither<L, R>;
+    /** Factory method para operaciones condicionales */
+    static fromCondition<L, R>(condition: boolean, rightValue: () => R, leftValue: () => L): IEither<L, R>;
+    /** Combina múltiples Either en uno solo - falla en el primer Left */
+    static sequence<L, R>(eithers: IEither<L, R>[]): IEither<L, R[]>;
+    /** Aplica una función que puede fallar a cada elemento */
+    static traverse<L, R, U>(items: R[], fn: (item: R) => IEither<L, U>): IEither<L, U[]>;
+    /** Combina dos Either con una función */
+    static lift2<L, A, B, C>(fn: (a: A, b: B) => C, eitherA: IEither<L, A>, eitherB: IEither<L, B>): IEither<L, C>;
+    /** Combina tres Either con una función */
+    static lift3<L, A, B, C, D>(fn: (a: A, b: B, c: C) => D, eitherA: IEither<L, A>, eitherB: IEither<L, B>, eitherC: IEither<L, C>): IEither<L, D>;
+    /** Acumula errores en lugar de fallar en el primero */
+    static accumulate<L, R>(eithers: IEither<L, R>[]): IEither<L[], R[]>;
+    /** Ejecuta Either en paralelo y acumula todos los errores */
+    static parallel<L, R>(operations: (() => Promise<IEither<L, R>>)[]): Promise<IEither<L[], R[]>>;
+    /** Aplica una transformación solo si se cumple una condición */
+    static when<L, R>(condition: boolean, transform: (value: R) => IEither<L, R>): (either: IEither<L, R>) => IEither<L, R>;
+    /** Aplica una transformación solo si NO se cumple una condición */
+    static unless<L, R>(condition: boolean, transform: (value: R) => IEither<L, R>): (either: IEither<L, R>) => IEither<L, R>;
+}
+//# sourceMappingURL=EitherFactory.d.ts.map

package/build/types/carbonbox/shared/either/domain/factories/EitherFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EitherFactory.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/factories/EitherFactory.ts"],"names":[],"mappings":"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"}

package/build/types/carbonbox/shared/either/domain/factories/ResultFactory.d.ts

@@ -0,0 +1,44 @@
+import { DomainError } from '../../../domain/entities/DomainError';
+import { IEither } from '../contracts/IEither';
+import { Result } from '../types/Result';
+/**
+ * Factory especializado para crear Result (Either con DomainFailure)
+ * Proporciona métodos específicos para el manejo de errores de dominio
+ */
+export declare class ResultFactory {
+    /** Crea un Result de fallo con un solo error */
+    static fail<T>(error: DomainError): Result<T>;
+    /** Crea un Result de fallo con múltiples errores */
+    static failMultiple<T>(errors: DomainError[]): Result<T>;
+    /** Crea un Result de éxito */
+    static ok<T>(value: T): Result<T>;
+    /** Convierte un Either simple a Result */
+    static fromEither<T>(either: IEither<DomainError, T>): Result<T>;
+    /** Convierte un Either con múltiples errores a Result */
+    static fromEitherMultiple<T>(either: IEither<DomainError[], T>): Result<T>;
+    /** Convierte un valor nullable a Result */
+    static fromNullable<T>(value: T | null | undefined, errorFactory: () => DomainError): Result<T>;
+    /** Convierte una condición a Result */
+    static fromCondition<T>(condition: boolean, valueFactory: () => T, errorFactory: () => DomainError): Result<T>;
+    /** Ejecuta una operación que puede fallar */
+    static fromTryCatch<T>(operation: () => T, errorMapper: (error: unknown) => DomainError): Result<T>;
+    /** Ejecuta una promesa que puede fallar */
+    static fromPromise<T>(promise: Promise<T>, errorMapper: (error: unknown) => DomainError): Promise<Result<T>>;
+    /** Combina múltiples Result en uno solo - falla en el primer error */
+    static sequence<T>(results: Result<T>[]): Result<T[]>;
+    /** Aplica una función que puede fallar a cada elemento */
+    static traverse<T, U>(items: T[], fn: (item: T) => Result<U>): Result<U[]>;
+    /** Acumula todos los errores en lugar de fallar en el primero */
+    static accumulate<T>(results: Result<T>[]): Result<T[]>;
+    /** Ejecuta validaciones en paralelo */
+    static parallel<T>(operations: (() => Promise<Result<T>>)[]): Promise<Result<T[]>>;
+    /** Crea una cadena de validaciones */
+    static chain<T>(...validations: ((value: T) => Result<T>)[]): (value: T) => Result<T>;
+    /** Aplica múltiples validaciones y acumula errores */
+    static validate<T>(value: T, ...validations: ((value: T) => Result<T>)[]): Result<T>;
+    /** Crea un validador condicional */
+    static when<T>(condition: (value: T) => boolean, validation: (value: T) => Result<T>): (value: T) => Result<T>;
+    /** Crea un validador que se ejecuta solo si NO se cumple la condición */
+    static unless<T>(condition: (value: T) => boolean, validation: (value: T) => Result<T>): (value: T) => Result<T>;
+}
+//# sourceMappingURL=ResultFactory.d.ts.map

package/build/types/carbonbox/shared/either/domain/factories/ResultFactory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ResultFactory.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/factories/ResultFactory.ts"],"names":[],"mappings":"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"}

package/build/types/carbonbox/shared/either/domain/implementations/LeftEitherImpl.d.ts

@@ -0,0 +1,29 @@
+import { ILeftEither } from '../contracts/ILeftEither';
+import { IEither } from '../contracts/IEither';
+import { EitherState } from '../types/EitherState';
+/**
+ * Implementación concreta de LeftEither
+ * Representa el estado de fallo en el patrón Either
+ */
+export declare class LeftEitherImpl<L, R> implements ILeftEither<L, R> {
+    #private;
+    readonly state: EitherState;
+    constructor(value: L);
+    get isLeft(): true;
+    get isRight(): false;
+    getLeft(): L;
+    getRight(): undefined;
+    left(): L;
+    right(): never;
+    map<U>(): IEither<L, U>;
+    mapLeft<U>(fn: (value: L) => U): IEither<U, R>;
+    flatMap<U>(): IEither<L, U>;
+    fold<U>(onLeft: (left: L) => U): U;
+    getOrElse(fallback: R | (() => R)): R;
+    filter(): IEither<L, R>;
+    chain<U>(): IEither<L, U>;
+    toOptional(): undefined;
+    swap(): IEither<R, L>;
+    inspect(): string;
+}
+//# sourceMappingURL=LeftEitherImpl.d.ts.map

package/build/types/carbonbox/shared/either/domain/implementations/LeftEitherImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LeftEitherImpl.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/implementations/LeftEitherImpl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAInD;;;GAGG;AACH,qBAAa,cAAc,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,WAAW,CAAC,CAAC,EAAE,CAAC,CAAC;;IAC5D,SAAgB,KAAK,EAAE,WAAW,CAAU;gBAIhC,KAAK,EAAE,CAAC;IAMpB,IAAW,MAAM,IAAI,IAAI,CAExB;IAED,IAAW,OAAO,IAAI,KAAK,CAE1B;IAIM,OAAO,IAAI,CAAC;IAIZ,QAAQ,IAAI,SAAS;IAMrB,IAAI,IAAI,CAAC;IAIT,KAAK,IAAI,KAAK;IAMd,GAAG,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAKvB,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAK9C,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAO3B,IAAI,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;IAIlC,SAAS,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC;IAMrC,MAAM,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAKvB,KAAK,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAOzB,UAAU,IAAI,SAAS;IAIvB,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAOrB,OAAO,IAAI,MAAM;CAGzB"}

package/build/types/carbonbox/shared/either/domain/implementations/RightEitherImpl.d.ts

@@ -0,0 +1,29 @@
+import { IRightEither } from '../contracts/IRightEither';
+import { IEither } from '../contracts/IEither';
+import { EitherState } from '../types/EitherState';
+/**
+ * Implementación concreta de RightEither
+ * Representa el estado de éxito en el patrón Either
+ */
+export declare class RightEitherImpl<L, R> implements IRightEither<L, R> {
+    #private;
+    readonly state: EitherState;
+    constructor(value: R);
+    get isLeft(): false;
+    get isRight(): true;
+    getLeft(): undefined;
+    getRight(): R;
+    left(): never;
+    right(): R;
+    map<U>(fn: (value: R) => U): IEither<L, U>;
+    mapLeft<U>(): IEither<U, R>;
+    flatMap<U>(fn: (value: R) => IEither<L, U>): IEither<L, U>;
+    fold<U>(_onLeft: (left: L) => U, onRight: (right: R) => U): U;
+    getOrElse(): R;
+    filter(predicate: (value: R) => boolean): IEither<L, R>;
+    chain<U>(fn: (value: R) => IEither<L, U>): IEither<L, U>;
+    toOptional(): R;
+    swap(): IEither<R, L>;
+    inspect(): string;
+}
+//# sourceMappingURL=RightEitherImpl.d.ts.map

package/build/types/carbonbox/shared/either/domain/implementations/RightEitherImpl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RightEitherImpl.d.ts","sourceRoot":"","sources":["../../../../../../../src/carbonbox/shared/either/domain/implementations/RightEitherImpl.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAC/C,OAAO,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAKnD;;;GAGG;AACH,qBAAa,eAAe,CAAC,CAAC,EAAE,CAAC,CAAE,YAAW,YAAY,CAAC,CAAC,EAAE,CAAC,CAAC;;IAC9D,SAAgB,KAAK,EAAE,WAAW,CAAW;gBAIjC,KAAK,EAAE,CAAC;IAMpB,IAAW,MAAM,IAAI,KAAK,CAEzB;IAED,IAAW,OAAO,IAAI,IAAI,CAEzB;IAIM,OAAO,IAAI,SAAS;IAIpB,QAAQ,IAAI,CAAC;IAMb,IAAI,IAAI,KAAK;IAIb,KAAK,IAAI,CAAC;IAMV,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAK1C,OAAO,CAAC,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAK3B,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAO1D,IAAI,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,CAAC;IAI7D,SAAS,IAAI,CAAC;IAOd,MAAM,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAQvD,KAAK,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAOxD,UAAU,IAAI,CAAC;IAIf,IAAI,IAAI,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC;IAOrB,OAAO,IAAI,MAAM;CAGzB"}