@carbonbox/domain 0.21.0 → 0.22.1

package/build/carbonbox/emission-calculation-formulas/calculation-variables/domain/entity/CalculationVariable.js

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _CalculationVariable_code, _CalculationVariable_symbol, _CalculationVariable_name, _CalculationVariable_description, _CalculationVariable_dataType, _CalculationVariable_resolutionStrategy, _CalculationVariable_activityDataConditions, _CalculationVariable_defaultValue;
+var _CalculationVariable_code, _CalculationVariable_symbol, _CalculationVariable_name, _CalculationVariable_description, _CalculationVariable_dataType, _CalculationVariable_resolutionStrategy, _CalculationVariable_activityDataConditions, _CalculationVariable_defaultValue, _CalculationVariable_options;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CalculationVariable = void 0;
 const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
@@ -21,6 +21,7 @@ const CalculationVariableDefaultValue_1 = require("../value-objects/CalculationV
 const CalculationVariableDescription_1 = require("../value-objects/CalculationVariableDescription");
 const CalculationVariableId_1 = require("../value-objects/CalculationVariableId");
 const CalculationVariableName_1 = require("../value-objects/CalculationVariableName");
+const CalculationVariableOptions_1 = require("../value-objects/CalculationVariableOptions");
 const CalculationVariableResolutionStrategy_1 = require("../value-objects/CalculationVariableResolutionStrategy");
 const CalculationVariableSymbol_1 = require("../value-objects/CalculationVariableSymbol");
 const InvalidCalculationVariableActivityDataConditionsForStrategyError_1 = require("../exceptions/InvalidCalculationVariableActivityDataConditionsForStrategyError");
@@ -38,6 +39,7 @@ class CalculationVariable extends AggregateRoot_1.AggregateRoot {
         _CalculationVariable_resolutionStrategy.set(this, void 0);
         _CalculationVariable_activityDataConditions.set(this, void 0);
         _CalculationVariable_defaultValue.set(this, void 0);
+        _CalculationVariable_options.set(this, void 0);
         if (skipDomainValidation === false) {
             // Initialize with domain validation
             __classPrivateFieldSet(this, _CalculationVariable_code, CalculationVariableCode_1.CalculationVariableCode.create(props.code), "f");
@@ -48,6 +50,9 @@ class CalculationVariable extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _CalculationVariable_resolutionStrategy, CalculationVariableResolutionStrategy_1.CalculationVariableResolutionStrategy.create(props.resolutionStrategy), "f");
             __classPrivateFieldSet(this, _CalculationVariable_activityDataConditions, CalculationVariableActivityDataConditions_1.CalculationVariableActivityDataConditions.create(props.activityDataConditions), "f");
             __classPrivateFieldSet(this, _CalculationVariable_defaultValue, CalculationVariableDefaultValue_1.CalculationVariableDefaultValue.create(props.defaultValue), "f");
+            __classPrivateFieldSet(this, _CalculationVariable_options, props.options !== null
+                ? CalculationVariableOptions_1.CalculationVariableOptions.create(props.options)
+                : CalculationVariableOptions_1.CalculationVariableOptions.create([]), "f");
         }
         else {
             // Initialize from primitives (no per-VO domain validation)
@@ -59,6 +64,9 @@ class CalculationVariable extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _CalculationVariable_resolutionStrategy, CalculationVariableResolutionStrategy_1.CalculationVariableResolutionStrategy.fromPrimitives(props.resolutionStrategy), "f");
             __classPrivateFieldSet(this, _CalculationVariable_activityDataConditions, CalculationVariableActivityDataConditions_1.CalculationVariableActivityDataConditions.fromPrimitives(props.activityDataConditions), "f");
             __classPrivateFieldSet(this, _CalculationVariable_defaultValue, CalculationVariableDefaultValue_1.CalculationVariableDefaultValue.fromPrimitives(props.defaultValue), "f");
+            __classPrivateFieldSet(this, _CalculationVariable_options, props.options !== null
+                ? CalculationVariableOptions_1.CalculationVariableOptions.fromPrimitives(props.options)
+                : CalculationVariableOptions_1.CalculationVariableOptions.fromPrimitives([]), "f");
         }
         // Cross-field invariant is enforced ALWAYS, even when constructing
         // via `fromPrimitives`. Per-VO validation can be skipped (because
@@ -82,6 +90,7 @@ class CalculationVariable extends AggregateRoot_1.AggregateRoot {
             resolutionStrategy: primitives.resolutionStrategy,
             activityDataConditions: primitives.activityDataConditions,
             defaultValue: primitives.defaultValue,
+            options: primitives.options,
         };
         return new CalculationVariable(props, true);
     }
@@ -96,6 +105,7 @@ class CalculationVariable extends AggregateRoot_1.AggregateRoot {
             resolutionStrategy: __classPrivateFieldGet(this, _CalculationVariable_resolutionStrategy, "f").toPrimitives(),
             activityDataConditions: __classPrivateFieldGet(this, _CalculationVariable_activityDataConditions, "f").toPrimitives(),
             defaultValue: __classPrivateFieldGet(this, _CalculationVariable_defaultValue, "f").toPrimitives(),
+            options: __classPrivateFieldGet(this, _CalculationVariable_options, "f").isEmpty() ? null : __classPrivateFieldGet(this, _CalculationVariable_options, "f").toPrimitives(),
         };
     }
     get code() {
@@ -122,6 +132,9 @@ class CalculationVariable extends AggregateRoot_1.AggregateRoot {
     get defaultValue() {
         return __classPrivateFieldGet(this, _CalculationVariable_defaultValue, "f");
     }
+    get options() {
+        return __classPrivateFieldGet(this, _CalculationVariable_options, "f");
+    }
     /**
      * Cross-field invariant: the relationship between `resolutionStrategy`
      * and `activityDataConditions` is owned by the aggregate root, not by
@@ -145,4 +158,4 @@ class CalculationVariable extends AggregateRoot_1.AggregateRoot {
     }
 }
 exports.CalculationVariable = CalculationVariable;
-_CalculationVariable_code = new WeakMap(), _CalculationVariable_symbol = new WeakMap(), _CalculationVariable_name = new WeakMap(), _CalculationVariable_description = new WeakMap(), _CalculationVariable_dataType = new WeakMap(), _CalculationVariable_resolutionStrategy = new WeakMap(), _CalculationVariable_activityDataConditions = new WeakMap(), _CalculationVariable_defaultValue = new WeakMap();
+_CalculationVariable_code = new WeakMap(), _CalculationVariable_symbol = new WeakMap(), _CalculationVariable_name = new WeakMap(), _CalculationVariable_description = new WeakMap(), _CalculationVariable_dataType = new WeakMap(), _CalculationVariable_resolutionStrategy = new WeakMap(), _CalculationVariable_activityDataConditions = new WeakMap(), _CalculationVariable_defaultValue = new WeakMap(), _CalculationVariable_options = new WeakMap();

package/build/carbonbox/emission-calculation-formulas/calculation-variables/domain/types/CalculationVariableOption.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/carbonbox/emission-calculation-formulas/calculation-variables/domain/types/CalculationVariableOptionOptions.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/carbonbox/emission-calculation-formulas/calculation-variables/domain/types/CalculationVariableOptionPrimitives.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/build/carbonbox/emission-calculation-formulas/calculation-variables/domain/value-objects/CalculationVariableOptions.js

@@ -0,0 +1,197 @@
+"use strict";
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _a, _CalculationVariableOptions_options, _CalculationVariableOptions_guardAgainstInvalidType, _CalculationVariableOptions_guardAgainstInvalidEmptyArray, _CalculationVariableOptions_guardAgainstDuplicatedValues, _CalculationVariableOptions_guardAgainstDuplicatedDisplayOrders, _CalculationVariableOptions_guardAgainstInvalidOption;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CalculationVariableOptions = void 0;
+const ValueObject_1 = require("../../../../shared/domain/value-objects/ValueObject");
+const String_1 = require("../../../../shared/domain/value-objects/String");
+const PositiveInteger_1 = require("../../../../shared/domain/value-objects/PositiveInteger");
+const InvalidPropertyTypeError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyTypeError");
+const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
+/**
+ * Structured list of selectable options for a `dataType === SELECT` calculation
+ * variable (e.g. tipo de combustible: Diesel / Gasolina / Eléctrico). Mirrors the
+ * canonical `CollectionFieldOptions` value object (`FieldOption` shape) but lives
+ * in the `calculation-variables` bounded context so the two contexts stay
+ * independent.
+ *
+ * The value object is permissive (`allowEmpty: true`): a SELECT variable can exist
+ * with an empty list initially. Whether options are required/forbidden for a given
+ * `dataType` is an application-layer concern (gated in the Create/Update DTO +
+ * handler against `DataTypeEnum.SELECT`), exactly like `CollectionFieldOptions`.
+ */
+class CalculationVariableOptions extends ValueObject_1.ValueObject {
+    constructor(value, skipDomainValidation, propertyName = _a.DEFAULT_PROPERTY_NAME, options = _a.DEFAULT_OPTIONS) {
+        const finalOptions = { ..._a.DEFAULT_OPTIONS, ...options };
+        if (skipDomainValidation === false) {
+            _a.validateOptions(value, propertyName, finalOptions);
+        }
+        const primitives = _a.toPrimitivesArray(value);
+        super(primitives, skipDomainValidation, propertyName, 'The provided value must be an array of CalculationVariableOption from the domain layer');
+        _CalculationVariableOptions_options.set(this, void 0);
+        __classPrivateFieldSet(this, _CalculationVariableOptions_options, _a.toCleanOptions(value), "f");
+    }
+    static create(value) {
+        return new _a(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = primitives.map((primitive) => ({
+            value: primitive.value,
+            label: primitive.label,
+            displayOrder: primitive.displayOrder,
+            isActive: primitive.isActive,
+            metadata: primitive.metadata,
+        }));
+        return new _a(value, true);
+    }
+    static validateOptions(value, propertyName, options) {
+        __classPrivateFieldGet(this, _a, "m", _CalculationVariableOptions_guardAgainstInvalidType).call(this, value, propertyName);
+        __classPrivateFieldGet(this, _a, "m", _CalculationVariableOptions_guardAgainstInvalidEmptyArray).call(this, value, options, propertyName);
+        if (options.allowDuplicates === false) {
+            __classPrivateFieldGet(this, _a, "m", _CalculationVariableOptions_guardAgainstDuplicatedValues).call(this, value, propertyName);
+        }
+        value.forEach((option, index) => {
+            __classPrivateFieldGet(this, _a, "m", _CalculationVariableOptions_guardAgainstInvalidOption).call(this, option, index, propertyName);
+        });
+        __classPrivateFieldGet(this, _a, "m", _CalculationVariableOptions_guardAgainstDuplicatedDisplayOrders).call(this, value, propertyName);
+    }
+    static toPrimitivesArray(value) {
+        return value.map((option) => ({
+            value: option.value.trim(),
+            label: option.label.trim(),
+            displayOrder: option.displayOrder,
+            isActive: option.isActive,
+            metadata: option.metadata,
+        }));
+    }
+    static toCleanOptions(value) {
+        return value.map((option) => ({
+            value: option.value.trim(),
+            label: option.label.trim(),
+            displayOrder: option.displayOrder,
+            isActive: option.isActive,
+            metadata: option.metadata,
+        }));
+    }
+    get options() {
+        return Object.freeze([...__classPrivateFieldGet(this, _CalculationVariableOptions_options, "f")]);
+    }
+    get count() {
+        return __classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").length;
+    }
+    isEmpty() {
+        return __classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").length === 0;
+    }
+    hasOptions() {
+        return __classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").length > 0;
+    }
+    getValues() {
+        return __classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").map((option) => option.value);
+    }
+    getByValue(value) {
+        return __classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").find((option) => option.value.toUpperCase() === value.trim().toUpperCase());
+    }
+    hasValue(value) {
+        return __classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").some((option) => option.value.toUpperCase() === value.trim().toUpperCase());
+    }
+    sortByDisplayOrder() {
+        return [...__classPrivateFieldGet(this, _CalculationVariableOptions_options, "f")].sort((a, b) => a.displayOrder - b.displayOrder);
+    }
+    equals(other) {
+        if (!(other instanceof _a)) {
+            return false;
+        }
+        if (__classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").length !== __classPrivateFieldGet(other, _CalculationVariableOptions_options, "f").length) {
+            return false;
+        }
+        const thisValues = new Set(this.getValues().map((v) => v.toUpperCase()));
+        const otherValues = new Set(other.getValues().map((v) => v.toUpperCase()));
+        if (thisValues.size !== otherValues.size) {
+            return false;
+        }
+        for (const value of thisValues) {
+            if (otherValues.has(value) === false) {
+                return false;
+            }
+            const thisOption = this.getByValue(value);
+            const otherOption = other.getByValue(value);
+            if (thisOption?.label !== otherOption?.label
+                || thisOption?.displayOrder !== otherOption?.displayOrder
+                || thisOption?.isActive !== otherOption?.isActive) {
+                return false;
+            }
+        }
+        return true;
+    }
+    toPrimitives() {
+        return __classPrivateFieldGet(this, _CalculationVariableOptions_options, "f").map((option) => ({
+            value: option.value,
+            label: option.label,
+            displayOrder: option.displayOrder,
+            isActive: option.isActive,
+            metadata: option.metadata,
+        }));
+    }
+}
+exports.CalculationVariableOptions = CalculationVariableOptions;
+_a = CalculationVariableOptions, _CalculationVariableOptions_options = new WeakMap(), _CalculationVariableOptions_guardAgainstInvalidType = function _CalculationVariableOptions_guardAgainstInvalidType(value, propertyName) {
+    if (Array.isArray(value) === false) {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(propertyName, 'array of CalculationVariableOption', typeof value);
+    }
+}, _CalculationVariableOptions_guardAgainstInvalidEmptyArray = function _CalculationVariableOptions_guardAgainstInvalidEmptyArray(value, options, propertyName) {
+    if (options.allowEmpty === false && value.length === 0) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(propertyName, 'non-empty array', 'empty array');
+    }
+}, _CalculationVariableOptions_guardAgainstDuplicatedValues = function _CalculationVariableOptions_guardAgainstDuplicatedValues(value, propertyName) {
+    const values = value.map((option) => option.value.trim().toUpperCase());
+    const uniqueValues = new Set(values);
+    if (values.length !== uniqueValues.size) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(`${propertyName}.values`, 'array with unique option values', 'array with duplicated option values');
+    }
+}, _CalculationVariableOptions_guardAgainstDuplicatedDisplayOrders = function _CalculationVariableOptions_guardAgainstDuplicatedDisplayOrders(value, propertyName) {
+    const displayOrders = value.map((option) => option.displayOrder);
+    const uniqueDisplayOrders = new Set(displayOrders);
+    if (displayOrders.length !== uniqueDisplayOrders.size) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(`${propertyName}.displayOrders`, 'array with unique display orders', 'array with duplicated display orders');
+    }
+}, _CalculationVariableOptions_guardAgainstInvalidOption = function _CalculationVariableOptions_guardAgainstInvalidOption(option, index, basePropertyName) {
+    const propertyName = `${basePropertyName}[${index}]`;
+    if (option === null || option === undefined || typeof option !== 'object') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(propertyName, 'CalculationVariableOption object', typeof option);
+    }
+    if (typeof option.value !== 'string') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.value`, 'string', typeof option.value);
+    }
+    if (typeof option.label !== 'string') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.label`, 'string', typeof option.label);
+    }
+    if (typeof option.displayOrder !== 'number') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.displayOrder`, 'number', typeof option.displayOrder);
+    }
+    if (typeof option.isActive !== 'boolean') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.isActive`, 'boolean', typeof option.isActive);
+    }
+    if (option.metadata !== null && typeof option.metadata !== 'object') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.metadata`, 'object or null', typeof option.metadata);
+    }
+    String_1.String.guardAgainstEmptyValue(option.value, `${propertyName}.value`);
+    String_1.String.guardAgainstEmptyValue(option.label, `${propertyName}.label`);
+    if (!PositiveInteger_1.PositiveInteger.isValidPositiveInteger(option.displayOrder)) {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.displayOrder`, 'positive integer', option.displayOrder.toString());
+    }
+};
+CalculationVariableOptions.DEFAULT_PROPERTY_NAME = 'calculationVariableOptions';
+CalculationVariableOptions.DEFAULT_OPTIONS = {
+    allowEmpty: true, // SELECT variables can be created without options initially
+    allowDuplicates: false, // Option values must be unique
+};

package/build/carbonbox/shared/domain/value-objects/CarbonClientReference.js

@@ -31,6 +31,7 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
         super(value, skipDomainValidation, propertyName, 'The provided value must be of type CarbonClientReference from the domain layer', { allowNull: false, allowUndefined: false });
         _CarbonClientReference_id.set(this, void 0);
         _CarbonClientReference_displayName.set(this, void 0);
+        // USR-020: una referencia a una persona natural puede no tener identificación tributaria.
         _CarbonClientReference_taxIdentification.set(this, void 0);
         _CarbonClientReference_roleType.set(this, void 0);
         _CarbonClientReference_accountType.set(this, void 0);
@@ -67,8 +68,8 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
         if (typeof value.displayName !== 'string') {
             throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('displayName', 'string', typeof value.displayName);
         }
-        if (this.taxIdentificationIsInvalid(value.taxIdentification)) {
-            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('taxIdentification', 'TaxIdentification object', typeof value.taxIdentification);
+        if (value.taxIdentification !== null && this.taxIdentificationIsInvalid(value.taxIdentification)) {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('taxIdentification', 'TaxIdentification object | null', typeof value.taxIdentification);
         }
         if (typeof value.roleType !== 'string') {
             throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('roleType', 'string', typeof value.roleType);
@@ -112,8 +113,9 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Valida la identificación tributaria usando las validaciones del VO TaxIdentification.
      */
     static guardAgainstInvalidTaxIdentification(taxIdentification) {
+        // USR-020: null es válido (persona natural sin identificación tributaria).
         if (this.taxIdentificationIsNull(taxIdentification)) {
-            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('taxIdentification', 'TaxIdentification object', 'null or undefined');
+            return;
         }
         // Usar las validaciones completas del VO TaxIdentification
         TaxIdentification_1.TaxIdentification.validateCompletely(taxIdentification, 'taxIdentification');
@@ -219,18 +221,21 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Verifica si la identificación tributaria tiene entidad emisora.
      */
     hasIssuedBy() {
-        return __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").issuedBy !== null;
+        return (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.issuedBy ?? null) !== null;
     }
     /**
      * Verifica si la identificación tributaria tiene fechas de validez.
      */
     hasValidityPeriod() {
-        return __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validFrom !== null || __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validUntil !== null;
+        return (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.validFrom ?? null) !== null || (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.validUntil ?? null) !== null;
     }
     /**
      * Verifica si el cliente puede participar en operaciones.
      */
     canParticipateInOperations() {
+        if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f") === null) {
+            return true;
+        }
         const now = new Date();
         const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
         if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validFrom) {
@@ -258,13 +263,13 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Verifica si pertenece a un país específico.
      */
     belongsToCountry(countryCode) {
-        return __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").country === countryCode.trim().toUpperCase();
+        return __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.country === countryCode.trim().toUpperCase();
     }
     /**
      * Verifica si requiere renovación próxima (dentro de 30 días).
      */
     requiresRenewalSoon() {
-        if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validUntil === null) {
+        if ((__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.validUntil ?? null) === null) {
             return false; // Si no tiene fecha de vencimiento, no requiere renovación
         }
         const now = new Date();
@@ -275,6 +280,9 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Verifica si la identificación tributaria será válida en una fecha específica.
      */
     isValidOnDate(date) {
+        if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f") === null) {
+            return true;
+        }
         const checkDate = new Date(date.getFullYear(), date.getMonth(), date.getDate());
         if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validFrom) {
             const fromDate = this.parseDate(__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validFrom);
@@ -294,12 +302,13 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Obtiene días restantes hasta el vencimiento.
      */
     getDaysUntilExpiration() {
-        if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validUntil === null) {
+        const validUntil = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.validUntil ?? null;
+        if (validUntil === null) {
             return null;
         }
         const now = new Date();
         const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
-        const [day, month, year] = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validUntil.split('/').map(Number);
+        const [day, month, year] = validUntil.split('/').map(Number);
         const expirationDate = new Date(year, month - 1, day);
         const diffTime = expirationDate.getTime() - today.getTime();
         const diffDays = Math.ceil(diffTime / (1000 * 60 * 60 * 24));
@@ -309,15 +318,17 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Obtiene una representación formateada para mostrar al usuario.
      */
     getFormattedDisplay() {
-        const taxInfo = `${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").type}-${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").number}-${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").country}`;
+        const taxInfo = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f") === null
+            ? 'N/A'
+            : `${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").type}-${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").number}-${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").country}`;
         return `${__classPrivateFieldGet(this, _CarbonClientReference_displayName, "f")} (${taxInfo}) - ${__classPrivateFieldGet(this, _CarbonClientReference_accountType, "f")} Carbon Client`;
     }
     /**
      * Obtiene información resumida del cliente de carbono.
      */
     getSummary() {
-        const { country } = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f");
-        const taxType = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").type;
+        const country = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.country ?? 'N/A';
+        const taxType = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f")?.type ?? 'N/A';
         return `${__classPrivateFieldGet(this, _CarbonClientReference_displayName, "f")} - ${__classPrivateFieldGet(this, _CarbonClientReference_accountType, "f").toLowerCase()} carbon client from ${country} (${taxType})`;
     }
     /**
@@ -343,6 +354,9 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Compara si dos identificaciones tributarias son iguales.
      */
     taxIdentificationsAreEqual(other) {
+        if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f") === null || other === null) {
+            return __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f") === other;
+        }
         return (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").type === other.type
             && __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").number === other.number
             && __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").country === other.country
@@ -364,6 +378,9 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Compara si dos identificaciones tributarias representan el mismo identificador.
      */
     hasSameIdentifier(other) {
+        if (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f") === null || other === null) {
+            return false;
+        }
         return (__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").type === other.type
             && __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").number === other.number
             && __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").country === other.country);
@@ -372,7 +389,10 @@ class CarbonClientReference extends ObjectValueObject_1.ObjectValueObject {
      * Genera un hash code para usar en colecciones.
      */
     hashCode() {
-        const taxHash = `${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").type}_${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").number}_${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").country}_${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").issuedBy}_${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validFrom}_${__classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f").validUntil}`;
+        const t = __classPrivateFieldGet(this, _CarbonClientReference_taxIdentification, "f");
+        const taxHash = t === null
+            ? 'no-tax'
+            : `${t.type}_${t.number}_${t.country}_${t.issuedBy}_${t.validFrom}_${t.validUntil}`;
         return `${__classPrivateFieldGet(this, _CarbonClientReference_id, "f")}_${__classPrivateFieldGet(this, _CarbonClientReference_displayName, "f")}_${taxHash}_${__classPrivateFieldGet(this, _CarbonClientReference_roleType, "f")}_${__classPrivateFieldGet(this, _CarbonClientReference_accountType, "f")}`;
     }
     /**

package/build/carbonbox/shared/domain/value-objects/CarbonClientReferences.js

@@ -66,7 +66,9 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
      * Valida que no haya identificaciones tributarias duplicadas.
      */
     static guardAgainstDuplicateClientTaxIdentifications(value, propertyName) {
-        const taxIdentifications = value.map((client) => `${client.taxIdentification.type}-${client.taxIdentification.number}-${client.taxIdentification.country}`);
+        const taxIdentifications = value
+            .filter((client) => client.taxIdentification !== null)
+            .map((client) => `${client.taxIdentification.type}-${client.taxIdentification.number}-${client.taxIdentification.country}`);
         const uniqueIds = new Set(taxIdentifications);
         if (taxIdentifications.length !== uniqueIds.size) {
             throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(`${propertyName}.taxIdentification`, 'unique tax identifications', 'duplicate tax identifications found');
@@ -96,8 +98,8 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
         if (typeof clientReference.displayName !== 'string') {
             throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.displayName`, 'string', typeof clientReference.displayName);
         }
-        if (!clientReference.taxIdentification || typeof clientReference.taxIdentification !== 'object') {
-            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.taxIdentification`, 'TaxIdentification object', typeof clientReference.taxIdentification);
+        if (clientReference.taxIdentification !== null && typeof clientReference.taxIdentification !== 'object') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.taxIdentification`, 'TaxIdentification object | null', typeof clientReference.taxIdentification);
         }
         if (typeof clientReference.roleType !== 'string') {
             throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.roleType`, 'string', typeof clientReference.roleType);
@@ -154,7 +156,8 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
      * Obtiene un cliente por su identificación tributaria.
      */
     getClientByTaxIdentification(type, number, country) {
-        const clientFound = __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").find((client) => client.taxIdentification.type === type.trim()
+        const clientFound = __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").find((client) => client.taxIdentification !== null
+            && client.taxIdentification.type === type.trim()
             && client.taxIdentification.number === number.trim()
             && client.taxIdentification.country === country.trim().toUpperCase());
         return clientFound || null;
@@ -197,7 +200,9 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
      * Obtiene todas las identificaciones tributarias como strings.
      */
     getAllTaxIdentificationStrings() {
-        return __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").map((client) => `${client.taxIdentification.type}-${client.taxIdentification.number}-${client.taxIdentification.country}`);
+        return __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").map((client) => (client.taxIdentification === null
+            ? 'N/A'
+            : `${client.taxIdentification.type}-${client.taxIdentification.number}-${client.taxIdentification.country}`));
     }
     /**
      * Busca clientes por texto en el nombre.
@@ -212,8 +217,8 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
     findClientsMatching(searchText) {
         const lowerSearchText = searchText.toLowerCase().trim();
         return __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").filter((client) => client.displayName.toLowerCase().includes(lowerSearchText)
-            || client.taxIdentification.number.toLowerCase().includes(lowerSearchText)
-            || client.taxIdentification.type.toLowerCase().includes(lowerSearchText));
+            || (client.taxIdentification !== null && client.taxIdentification.number.toLowerCase().includes(lowerSearchText))
+            || (client.taxIdentification !== null && client.taxIdentification.type.toLowerCase().includes(lowerSearchText)));
     }
     /**
      * Obtiene los primeros N clientes.
@@ -238,14 +243,14 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
      */
     getClientsByCountry(countryCode) {
         const upperCountryCode = countryCode.trim().toUpperCase();
-        return __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").filter((client) => client.taxIdentification.country === upperCountryCode);
+        return __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").filter((client) => client.taxIdentification?.country === upperCountryCode);
     }
     /**
      * Obtiene clientes por tipo de identificación tributaria.
      */
     getClientsByTaxType(taxType) {
         const upperTaxType = taxType.trim().toUpperCase();
-        return __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").filter((client) => client.taxIdentification.type === upperTaxType);
+        return __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f").filter((client) => client.taxIdentification?.type === upperTaxType);
     }
     /**
      * Verifica si todos los clientes tienen nombres únicos.
@@ -308,6 +313,9 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
      * Compara si dos identificaciones tributarias son iguales.
      */
     taxIdentificationsAreEqual(tax1, tax2) {
+        if (tax1 === null || tax1 === undefined || tax2 === null || tax2 === undefined) {
+            return (tax1 ?? null) === (tax2 ?? null);
+        }
         return (tax1.type === tax2.type
             && tax1.number === tax2.number
             && tax1.country === tax2.country
@@ -320,7 +328,13 @@ class CarbonClientReferences extends ValueObject_1.ValueObject {
      */
     hashCode() {
         const clientHashes = __classPrivateFieldGet(this, _CarbonClientReferences_clientReferences, "f")
-            .map((client) => `${client.id}_${client.displayName}_${client.accountType}_${client.taxIdentification.type}_${client.taxIdentification.number}_${client.taxIdentification.country}`)
+            .map((client) => {
+            const tax = client.taxIdentification;
+            const taxHash = tax === null
+                ? 'no-tax'
+                : `${tax.type}_${tax.number}_${tax.country}`;
+            return `${client.id}_${client.displayName}_${client.accountType}_${taxHash}`;
+        })
             .join('|');
         const optionsHash = __classPrivateFieldGet(this, _CarbonClientReferences_options, "f").allowEmpty ? 'allowEmpty' : 'requireElements';
         return `${optionsHash}_${clientHashes}`;