@carbonbox/domain 0.20.1 → 0.21.2

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

@@ -30,6 +30,7 @@ class StakeholderReference extends ObjectValueObject_1.ObjectValueObject {
         super(value, skipDomainValidation, propertyName, 'The provided value must be of type StakeholderReference from the domain layer', { allowNull: false, allowUndefined: false });
         _StakeholderReference_id.set(this, void 0);
         _StakeholderReference_displayName.set(this, void 0);
+        // USR-020: una referencia a una persona natural puede no tener identificación tributaria.
         _StakeholderReference_taxIdentification.set(this, void 0);
         _StakeholderReference_roleType.set(this, void 0);
         if (skipDomainValidation === false) {
@@ -63,8 +64,8 @@ class StakeholderReference 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);
@@ -102,8 +103,9 @@ class StakeholderReference 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');
@@ -202,18 +204,21 @@ class StakeholderReference extends ObjectValueObject_1.ObjectValueObject {
      * Verifica si la identificación tributaria tiene entidad emisora.
      */
     hasIssuedBy() {
-        return __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").issuedBy !== null;
+        return (__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f")?.issuedBy ?? null) !== null;
     }
     /**
      * Verifica si la identificación tributaria tiene fechas de validez.
      */
     hasValidityPeriod() {
-        return __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").validFrom !== null || __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").validUntil !== null;
+        return (__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f")?.validFrom ?? null) !== null || (__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f")?.validUntil ?? null) !== null;
     }
     /**
      * Verifica si el stakeholder puede participar en operaciones.
      */
     canParticipateInOperations() {
+        if (__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f") === null) {
+            return true;
+        }
         const now = new Date();
         const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
         if (__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").validFrom) {
@@ -241,21 +246,23 @@ class StakeholderReference extends ObjectValueObject_1.ObjectValueObject {
      * Verifica si pertenece a un país específico.
      */
     belongsToCountry(countryCode) {
-        return __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").country === countryCode.trim().toUpperCase();
+        return __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f")?.country === countryCode.trim().toUpperCase();
     }
     /**
      * Obtiene una representación formateada para mostrar al usuario.
      */
     getFormattedDisplay() {
-        const taxInfo = __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").toString();
+        const taxInfo = __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f") === null
+            ? 'N/A'
+            : `${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").type}-${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").number}-${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").country}`;
         return `${__classPrivateFieldGet(this, _StakeholderReference_displayName, "f")} (${taxInfo}) - ${__classPrivateFieldGet(this, _StakeholderReference_roleType, "f")}`;
     }
     /**
      * Obtiene información resumida del stakeholder.
      */
     getSummary() {
-        const { country } = __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f");
-        const taxType = __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").type;
+        const country = __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f")?.country ?? 'N/A';
+        const taxType = __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f")?.type ?? 'N/A';
         const role = __classPrivateFieldGet(this, _StakeholderReference_roleType, "f").replace('CARBON_', '').toLowerCase();
         return `${__classPrivateFieldGet(this, _StakeholderReference_displayName, "f")} - ${role} from ${country} (${taxType})`;
     }
@@ -277,8 +284,13 @@ class StakeholderReference extends ObjectValueObject_1.ObjectValueObject {
     }
     /**
      * Compara si dos identificaciones tributarias representan el mismo identificador.
+     * Si alguna referencia no tiene identificación tributaria (persona natural), no
+     * se las considera el mismo identificador por esta vía.
      */
     hasSameIdentifier(other) {
+        if (__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f") === null || other === null) {
+            return false;
+        }
         return (__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").type === other.type
             && __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").number === other.number
             && __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").country === other.country);
@@ -296,7 +308,10 @@ class StakeholderReference extends ObjectValueObject_1.ObjectValueObject {
      * Genera un hash code para usar en colecciones.
      */
     hashCode() {
-        const taxHash = `${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").type}_${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").number}_${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").country}_${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").issuedBy}_${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").validFrom}_${__classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f").validUntil}`;
+        const t = __classPrivateFieldGet(this, _StakeholderReference_taxIdentification, "f");
+        const taxHash = t === null
+            ? 'no-tax'
+            : `${t.type}_${t.number}_${t.country}_${t.issuedBy}_${t.validFrom}_${t.validUntil}`;
         return `${__classPrivateFieldGet(this, _StakeholderReference_displayName, "f")}_${taxHash}_${__classPrivateFieldGet(this, _StakeholderReference_roleType, "f")}`;
     }
     /**

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

@@ -78,7 +78,9 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
      * Valida que no haya identificaciones tributarias duplicadas.
      */
     static guardAgainstDuplicateStakeholderTaxIdentifications(value, propertyName) {
-        const taxIdentifications = value.map((stakeholder) => `${stakeholder.taxIdentification.type}-${stakeholder.taxIdentification.number}-${stakeholder.taxIdentification.country}`);
+        const taxIdentifications = value
+            .filter((stakeholder) => stakeholder.taxIdentification !== null)
+            .map((stakeholder) => `${stakeholder.taxIdentification.type}-${stakeholder.taxIdentification.number}-${stakeholder.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');
@@ -109,8 +111,8 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
         if (typeof stakeholderReference.displayName !== 'string') {
             throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.displayName`, 'string', typeof stakeholderReference.displayName);
         }
-        if (!stakeholderReference.taxIdentification || typeof stakeholderReference.taxIdentification !== 'object') {
-            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.taxIdentification`, 'TaxIdentification object', typeof stakeholderReference.taxIdentification);
+        if (stakeholderReference.taxIdentification !== null && typeof stakeholderReference.taxIdentification !== 'object') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.taxIdentification`, 'TaxIdentification object | null', typeof stakeholderReference.taxIdentification);
         }
         if (typeof stakeholderReference.roleType !== 'string') {
             throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.roleType`, 'string', typeof stakeholderReference.roleType);
@@ -185,7 +187,8 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
      * Obtiene un stakeholder por su identificación tributaria.
      */
     getStakeholderByTaxIdentification(type, number, country) {
-        const stakeholderFound = __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").find((stakeholder) => stakeholder.taxIdentification.type === type.trim()
+        const stakeholderFound = __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").find((stakeholder) => stakeholder.taxIdentification !== null
+            && stakeholder.taxIdentification.type === type.trim()
             && stakeholder.taxIdentification.number === number.trim()
             && stakeholder.taxIdentification.country === country.trim().toUpperCase());
         return stakeholderFound || null;
@@ -285,7 +288,9 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
      * Obtiene todas las identificaciones tributarias como strings.
      */
     getAllTaxIdentificationStrings() {
-        return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").map((stakeholder) => `${stakeholder.taxIdentification.type}-${stakeholder.taxIdentification.number}-${stakeholder.taxIdentification.country}`);
+        return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").map((stakeholder) => (stakeholder.taxIdentification === null
+            ? 'N/A'
+            : `${stakeholder.taxIdentification.type}-${stakeholder.taxIdentification.number}-${stakeholder.taxIdentification.country}`));
     }
     /**
      * Obtiene todos los roles únicos en la colección.
@@ -307,8 +312,8 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
     findStakeholdersMatching(searchText) {
         const lowerSearchText = searchText.toLowerCase().trim();
         return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").filter((stakeholder) => stakeholder.displayName.toLowerCase().includes(lowerSearchText)
-            || stakeholder.taxIdentification.number.toLowerCase().includes(lowerSearchText)
-            || stakeholder.taxIdentification.type.toLowerCase().includes(lowerSearchText)
+            || (stakeholder.taxIdentification !== null && stakeholder.taxIdentification.number.toLowerCase().includes(lowerSearchText))
+            || (stakeholder.taxIdentification !== null && stakeholder.taxIdentification.type.toLowerCase().includes(lowerSearchText))
             || stakeholder.roleType.toLowerCase().includes(lowerSearchText));
     }
     /**
@@ -334,14 +339,14 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
      */
     getStakeholdersByCountry(countryCode) {
         const upperCountryCode = countryCode.trim().toUpperCase();
-        return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").filter((stakeholder) => stakeholder.taxIdentification.country === upperCountryCode);
+        return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").filter((stakeholder) => stakeholder.taxIdentification?.country === upperCountryCode);
     }
     /**
      * Obtiene stakeholders por tipo de identificación tributaria.
      */
     getStakeholdersByTaxType(taxType) {
         const upperTaxType = taxType.trim().toUpperCase();
-        return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").filter((stakeholder) => stakeholder.taxIdentification.type === upperTaxType);
+        return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").filter((stakeholder) => stakeholder.taxIdentification?.type === upperTaxType);
     }
     /**
      * Verifica si todos los stakeholders tienen nombres únicos.
@@ -434,6 +439,9 @@ class StakeholderReferences 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
@@ -446,7 +454,13 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
      */
     hashCode() {
         const stakeholderHashes = __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f")
-            .map((stakeholder) => `${stakeholder.displayName}_${stakeholder.roleType}_${stakeholder.taxIdentification.type}_${stakeholder.taxIdentification.number}_${stakeholder.taxIdentification.country}`)
+            .map((stakeholder) => {
+            const tax = stakeholder.taxIdentification;
+            const taxHash = tax === null
+                ? 'no-tax'
+                : `${tax.type}_${tax.number}_${tax.country}`;
+            return `${stakeholder.displayName}_${stakeholder.roleType}_${taxHash}`;
+        })
             .join('|');
         const optionsHash = __classPrivateFieldGet(this, _StakeholderReferences_options, "f").allowEmpty ? 'allowEmpty' : 'requireElements';
         return `${optionsHash}_${stakeholderHashes}`;
@@ -458,14 +472,16 @@ class StakeholderReferences extends ValueObject_1.ValueObject {
         return __classPrivateFieldGet(this, _StakeholderReferences_stakeholderReferences, "f").map((stakeholder) => ({
             id: stakeholder.id,
             displayName: stakeholder.displayName,
-            taxIdentification: {
-                type: stakeholder.taxIdentification.type,
-                number: stakeholder.taxIdentification.number,
-                country: stakeholder.taxIdentification.country,
-                issuedBy: stakeholder.taxIdentification.issuedBy,
-                validFrom: stakeholder.taxIdentification.validFrom,
-                validUntil: stakeholder.taxIdentification.validUntil,
-            },
+            taxIdentification: stakeholder.taxIdentification === null
+                ? null
+                : {
+                    type: stakeholder.taxIdentification.type,
+                    number: stakeholder.taxIdentification.number,
+                    country: stakeholder.taxIdentification.country,
+                    issuedBy: stakeholder.taxIdentification.issuedBy,
+                    validFrom: stakeholder.taxIdentification.validFrom,
+                    validUntil: stakeholder.taxIdentification.validUntil,
+                },
             roleType: stakeholder.roleType,
         }));
     }

package/build/carbonbox/stakeholders/carbon-clients/domain/entity/CarbonClient.js

@@ -34,6 +34,7 @@ const CarbonClientPrimaryContactPhone_1 = require("../value-objects/CarbonClient
 const CarbonClientRoleType_1 = require("../value-objects/CarbonClientRoleType");
 const CarbonClientSupervisedByStakeholder_1 = require("../value-objects/CarbonClientSupervisedByStakeholder");
 const CarbonClientTaxIdentification_1 = require("../value-objects/CarbonClientTaxIdentification");
+const CarbonClientIdentityDocument_1 = require("../value-objects/CarbonClientIdentityDocument");
 const CarbonClientUserType_1 = require("../value-objects/CarbonClientUserType");
 const CarbonClientWebsiteUrl_1 = require("../value-objects/CarbonClientWebsiteUrl");
 class CarbonClient extends Stakeholder_1.Stakeholder {
@@ -56,9 +57,16 @@ class CarbonClient extends Stakeholder_1.Stakeholder {
         const lastAccessAt = skipDomainValidation
             ? CarbonClientLastAccessAt_1.CarbonClientLastAccessAt.fromPrimitives(props.lastAccessAt).toPrimitives()
             : CarbonClientLastAccessAt_1.CarbonClientLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = skipDomainValidation
-            ? CarbonClientTaxIdentification_1.CarbonClientTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
-            : CarbonClientTaxIdentification_1.CarbonClientTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : (skipDomainValidation
+                ? CarbonClientTaxIdentification_1.CarbonClientTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
+                : CarbonClientTaxIdentification_1.CarbonClientTaxIdentification.create(props.taxIdentification).toPrimitives());
+        const identityDocument = props.identityDocument === null
+            ? null
+            : (skipDomainValidation
+                ? CarbonClientIdentityDocument_1.CarbonClientIdentityDocument.fromPrimitives(props.identityDocument).toPrimitives()
+                : CarbonClientIdentityDocument_1.CarbonClientIdentityDocument.create(props.identityDocument).toPrimitives());
         const roleType = skipDomainValidation
             ? CarbonClientRoleType_1.CarbonClientRoleType.fromPrimitives(props.roleType).toEnum()
             : CarbonClientRoleType_1.CarbonClientRoleType.create(props.roleType).toEnum();
@@ -79,6 +87,7 @@ class CarbonClient extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument,
             roleType,
             businessStatus,
             userType,
@@ -134,6 +143,7 @@ class CarbonClient extends Stakeholder_1.Stakeholder {
             displayName: primitives.displayName,
             lastAccessAt: primitives.lastAccessAt,
             taxIdentification: primitives.taxIdentification,
+            identityDocument: primitives.identityDocument,
             roleType: primitives.roleType,
             businessStatus: primitives.businessStatus,
             userType: primitives.userType,
@@ -159,7 +169,12 @@ class CarbonClient extends Stakeholder_1.Stakeholder {
         const email = CarbonClientEmail_1.CarbonClientEmail.create(props.email).toPrimitives();
         const displayName = CarbonClientDisplayName_1.CarbonClientDisplayName.create(props.displayName).toPrimitives();
         const lastAccessAt = CarbonClientLastAccessAt_1.CarbonClientLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = CarbonClientTaxIdentification_1.CarbonClientTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : CarbonClientTaxIdentification_1.CarbonClientTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const identityDocument = props.identityDocument === null
+            ? null
+            : CarbonClientIdentityDocument_1.CarbonClientIdentityDocument.create(props.identityDocument).toPrimitives();
         const roleType = CarbonClientRoleType_1.CarbonClientRoleType.create(props.roleType).toEnum();
         const businessStatus = CarbonClientBusinessStatus_1.CarbonClientBusinessStatus.create(props.businessStatus).toEnum();
         const userType = CarbonClientUserType_1.CarbonClientUserType.create(props.userType).toEnum();
@@ -182,6 +197,7 @@ class CarbonClient extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument,
             roleType,
             businessStatus,
             userType,
@@ -212,7 +228,8 @@ class CarbonClient extends Stakeholder_1.Stakeholder {
             businessStatus: this.businessStatus.toEnum(),
             userType: this.userType.toEnum(),
             legalBusinessName: this.legalBusinessName.toPrimitives(),
-            taxIdentification: this.taxIdentification.toPrimitives(),
+            taxIdentification: this.taxIdentification?.toPrimitives() ?? null,
+            identityDocument: this.identityDocument?.toPrimitives() ?? null,
             industryType: this.industryType.toPrimitives(),
             organizationSize: this.organizationSize.toEnum(),
             physicalAddress: this.physicalAddress.toPrimitives(),

package/build/carbonbox/stakeholders/carbon-clients/domain/value-objects/CarbonClientIdentityDocument.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CarbonClientIdentityDocument = void 0;
+const StakeholderIdentityDocument_1 = require("../../../shared/domain/value-objects/StakeholderIdentityDocument");
+class CarbonClientIdentityDocument extends StakeholderIdentityDocument_1.StakeholderIdentityDocument {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation);
+    }
+    static create(value) {
+        return new CarbonClientIdentityDocument(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = {
+            country: primitives.country,
+            issuedBy: primitives.issuedBy,
+            number: primitives.number,
+            type: primitives.type,
+            validFrom: primitives.validFrom,
+            validUntil: primitives.validUntil,
+        };
+        return new CarbonClientIdentityDocument(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.CarbonClientIdentityDocument = CarbonClientIdentityDocument;

package/build/carbonbox/stakeholders/carbon-coordinators/domain/entity/CarbonCoordinator.js

@@ -30,6 +30,7 @@ const CarbonCoordinatorPermissions_1 = require("../value-objects/CarbonCoordinat
 const CarbonCoordinatorReportsToStakeholder_1 = require("../value-objects/CarbonCoordinatorReportsToStakeholder");
 const CarbonCoordinatorRoleType_1 = require("../value-objects/CarbonCoordinatorRoleType");
 const CarbonCoordinatorTaxIdentification_1 = require("../value-objects/CarbonCoordinatorTaxIdentification");
+const CarbonCoordinatorIdentityDocument_1 = require("../value-objects/CarbonCoordinatorIdentityDocument");
 const CarbonCoordinatorUserType_1 = require("../value-objects/CarbonCoordinatorUserType");
 const CarbonCoordinatorWeeklyWorkingSchedule_1 = require("../value-objects/CarbonCoordinatorWeeklyWorkingSchedule");
 class CarbonCoordinator extends Stakeholder_1.Stakeholder {
@@ -52,9 +53,16 @@ class CarbonCoordinator extends Stakeholder_1.Stakeholder {
         const lastAccessAt = skipDomainValidation
             ? CarbonCoordinatorLastAccessAt_1.CarbonCoordinatorLastAccessAt.fromPrimitives(props.lastAccessAt).toPrimitives()
             : CarbonCoordinatorLastAccessAt_1.CarbonCoordinatorLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = skipDomainValidation
-            ? CarbonCoordinatorTaxIdentification_1.CarbonCoordinatorTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
-            : CarbonCoordinatorTaxIdentification_1.CarbonCoordinatorTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : (skipDomainValidation
+                ? CarbonCoordinatorTaxIdentification_1.CarbonCoordinatorTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
+                : CarbonCoordinatorTaxIdentification_1.CarbonCoordinatorTaxIdentification.create(props.taxIdentification).toPrimitives());
+        const identityDocument = props.identityDocument === null
+            ? null
+            : (skipDomainValidation
+                ? CarbonCoordinatorIdentityDocument_1.CarbonCoordinatorIdentityDocument.fromPrimitives(props.identityDocument).toPrimitives()
+                : CarbonCoordinatorIdentityDocument_1.CarbonCoordinatorIdentityDocument.create(props.identityDocument).toPrimitives());
         const roleType = skipDomainValidation
             ? CarbonCoordinatorRoleType_1.CarbonCoordinatorRoleType.fromPrimitives(props.roleType).toEnum()
             : CarbonCoordinatorRoleType_1.CarbonCoordinatorRoleType.create(props.roleType).toEnum();
@@ -75,6 +83,7 @@ class CarbonCoordinator extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument,
             roleType,
             businessStatus,
             userType,
@@ -118,6 +127,7 @@ class CarbonCoordinator extends Stakeholder_1.Stakeholder {
             displayName: primitives.displayName,
             lastAccessAt: primitives.lastAccessAt,
             taxIdentification: primitives.taxIdentification,
+            identityDocument: primitives.identityDocument,
             roleType: primitives.roleType,
             businessStatus: primitives.businessStatus,
             userType: primitives.userType,
@@ -139,7 +149,12 @@ class CarbonCoordinator extends Stakeholder_1.Stakeholder {
         const email = CarbonCoordinatorEmail_1.CarbonCoordinatorEmail.create(props.email).toPrimitives();
         const displayName = CarbonCoordinatorDisplayName_1.CarbonCoordinatorDisplayName.create(props.displayName).toPrimitives();
         const lastAccessAt = CarbonCoordinatorLastAccessAt_1.CarbonCoordinatorLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = CarbonCoordinatorTaxIdentification_1.CarbonCoordinatorTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : CarbonCoordinatorTaxIdentification_1.CarbonCoordinatorTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const identityDocument = props.identityDocument === null
+            ? null
+            : CarbonCoordinatorIdentityDocument_1.CarbonCoordinatorIdentityDocument.create(props.identityDocument).toPrimitives();
         const roleType = CarbonCoordinatorRoleType_1.CarbonCoordinatorRoleType.create(props.roleType).toEnum();
         const businessStatus = CarbonCoordinatorBusinessStatus_1.CarbonCoordinatorBusinessStatus.create(props.businessStatus).toEnum();
         const userType = CarbonCoordinatorUserType_1.CarbonCoordinatorUserType.create(props.userType).toEnum();
@@ -158,6 +173,7 @@ class CarbonCoordinator extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument,
             roleType,
             businessStatus,
             userType,
@@ -183,7 +199,8 @@ class CarbonCoordinator extends Stakeholder_1.Stakeholder {
             roleType: this.roleType.toEnum(),
             businessStatus: this.businessStatus.toEnum(),
             userType: this.userType.toEnum(),
-            taxIdentification: this.taxIdentification.toPrimitives(),
+            taxIdentification: this.taxIdentification?.toPrimitives() ?? null,
+            identityDocument: this.identityDocument?.toPrimitives() ?? null,
             availabilityStatus: __classPrivateFieldGet(this, _CarbonCoordinator_availabilityStatus, "f").toEnum(),
             weeklyWorkingSchedule: __classPrivateFieldGet(this, _CarbonCoordinator_weeklyWorkingSchedule, "f").toPrimitives(),
             gender: __classPrivateFieldGet(this, _CarbonCoordinator_gender, "f").toEnum(),

package/build/carbonbox/stakeholders/carbon-coordinators/domain/value-objects/CarbonCoordinatorIdentityDocument.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CarbonCoordinatorIdentityDocument = void 0;
+const StakeholderIdentityDocument_1 = require("../../../shared/domain/value-objects/StakeholderIdentityDocument");
+class CarbonCoordinatorIdentityDocument extends StakeholderIdentityDocument_1.StakeholderIdentityDocument {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation);
+    }
+    static create(value) {
+        return new CarbonCoordinatorIdentityDocument(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = {
+            country: primitives.country,
+            issuedBy: primitives.issuedBy,
+            number: primitives.number,
+            type: primitives.type,
+            validFrom: primitives.validFrom,
+            validUntil: primitives.validUntil,
+        };
+        return new CarbonCoordinatorIdentityDocument(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.CarbonCoordinatorIdentityDocument = CarbonCoordinatorIdentityDocument;

package/build/carbonbox/stakeholders/carbon-host/domain/entity/CarbonHost.js

@@ -34,9 +34,13 @@ class CarbonHost extends Stakeholder_1.Stakeholder {
         const lastAccessAt = skipDomainValidation
             ? CarbonHostLastAccessAt_1.CarbonHostLastAccessAt.fromPrimitives(props.lastAccessAt).toPrimitives()
             : CarbonHostLastAccessAt_1.CarbonHostLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = skipDomainValidation
-            ? CarbonHostTaxIdentification_1.CarbonHostTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
-            : CarbonHostTaxIdentification_1.CarbonHostTaxIdentification.create(props.taxIdentification).toPrimitives();
+        // USR-020: Host conserva taxIdentification (a nivel app sigue requerido); identityDocument
+        // no aplica al Host (siempre null). El tipo base es nullable, de ahí el manejo defensivo.
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : (skipDomainValidation
+                ? CarbonHostTaxIdentification_1.CarbonHostTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
+                : CarbonHostTaxIdentification_1.CarbonHostTaxIdentification.create(props.taxIdentification).toPrimitives());
         const roleType = skipDomainValidation
             ? CarbonHostRoleType_1.CarbonHostRoleType.fromPrimitives(props.roleType).toEnum()
             : CarbonHostRoleType_1.CarbonHostRoleType.create(props.roleType).toEnum();
@@ -57,6 +61,7 @@ class CarbonHost extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument: null,
             roleType,
             businessStatus,
             userType,
@@ -76,6 +81,7 @@ class CarbonHost extends Stakeholder_1.Stakeholder {
             displayName: primitives.displayName,
             lastAccessAt: primitives.lastAccessAt,
             taxIdentification: primitives.taxIdentification,
+            identityDocument: primitives.identityDocument,
             roleType: primitives.roleType,
             businessStatus: primitives.businessStatus,
             userType: primitives.userType,
@@ -91,7 +97,9 @@ class CarbonHost extends Stakeholder_1.Stakeholder {
         const email = CarbonHostEmail_1.CarbonHostEmail.create(props.email).toPrimitives();
         const displayName = CarbonHostDisplayName_1.CarbonHostDisplayName.create(props.displayName).toPrimitives();
         const lastAccessAt = CarbonHostLastAccessAt_1.CarbonHostLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = CarbonHostTaxIdentification_1.CarbonHostTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : CarbonHostTaxIdentification_1.CarbonHostTaxIdentification.create(props.taxIdentification).toPrimitives();
         const roleType = CarbonHostRoleType_1.CarbonHostRoleType.create(props.roleType).toEnum();
         const businessStatus = CarbonHostBusinessStatus_1.CarbonHostBusinessStatus.create(props.businessStatus).toEnum();
         const userType = CarbonHostUserType_1.CarbonHostUserType.create(props.userType).toEnum();
@@ -104,6 +112,7 @@ class CarbonHost extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument: null,
             roleType,
             businessStatus,
             userType,
@@ -123,7 +132,8 @@ class CarbonHost extends Stakeholder_1.Stakeholder {
             roleType: this.roleType.toEnum(),
             businessStatus: this.businessStatus.toEnum(),
             userType: this.userType.toEnum(),
-            taxIdentification: this.taxIdentification.toPrimitives(),
+            taxIdentification: this.taxIdentification?.toPrimitives() ?? null,
+            identityDocument: this.identityDocument?.toPrimitives() ?? null,
             permissions: this.permissions.toEnums(),
             preferredLocale: this.preferredLocale.toEnum(),
         };

package/build/carbonbox/stakeholders/carbon-managers/domain/entity/CarbonManager.js

@@ -26,6 +26,7 @@ const CarbonManagerPassword_1 = require("../value-objects/CarbonManagerPassword"
 const CarbonManagerPermissions_1 = require("../value-objects/CarbonManagerPermissions");
 const CarbonManagerRoleType_1 = require("../value-objects/CarbonManagerRoleType");
 const CarbonManagerTaxIdentification_1 = require("../value-objects/CarbonManagerTaxIdentification");
+const CarbonManagerIdentityDocument_1 = require("../value-objects/CarbonManagerIdentityDocument");
 const CarbonManagerUserType_1 = require("../value-objects/CarbonManagerUserType");
 class CarbonManager extends Stakeholder_1.Stakeholder {
     constructor(props, skipDomainValidation) {
@@ -47,9 +48,16 @@ class CarbonManager extends Stakeholder_1.Stakeholder {
         const lastAccessAt = skipDomainValidation
             ? CarbonManagerLastAccessAt_1.CarbonManagerLastAccessAt.fromPrimitives(props.lastAccessAt).toPrimitives()
             : CarbonManagerLastAccessAt_1.CarbonManagerLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = skipDomainValidation
-            ? CarbonManagerTaxIdentification_1.CarbonManagerTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
-            : CarbonManagerTaxIdentification_1.CarbonManagerTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : (skipDomainValidation
+                ? CarbonManagerTaxIdentification_1.CarbonManagerTaxIdentification.fromPrimitives(props.taxIdentification).toPrimitives()
+                : CarbonManagerTaxIdentification_1.CarbonManagerTaxIdentification.create(props.taxIdentification).toPrimitives());
+        const identityDocument = props.identityDocument === null
+            ? null
+            : (skipDomainValidation
+                ? CarbonManagerIdentityDocument_1.CarbonManagerIdentityDocument.fromPrimitives(props.identityDocument).toPrimitives()
+                : CarbonManagerIdentityDocument_1.CarbonManagerIdentityDocument.create(props.identityDocument).toPrimitives());
         const roleType = skipDomainValidation
             ? CarbonManagerRoleType_1.CarbonManagerRoleType.fromPrimitives(props.roleType).toEnum()
             : CarbonManagerRoleType_1.CarbonManagerRoleType.create(props.roleType).toEnum();
@@ -70,6 +78,7 @@ class CarbonManager extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument,
             roleType,
             businessStatus,
             userType,
@@ -98,6 +107,7 @@ class CarbonManager extends Stakeholder_1.Stakeholder {
             displayName: primitives.displayName,
             lastAccessAt: primitives.lastAccessAt,
             taxIdentification: primitives.taxIdentification,
+            identityDocument: primitives.identityDocument,
             roleType: primitives.roleType,
             businessStatus: primitives.businessStatus,
             userType: primitives.userType,
@@ -114,7 +124,12 @@ class CarbonManager extends Stakeholder_1.Stakeholder {
         const email = CarbonManagerEmail_1.CarbonManagerEmail.create(props.email).toPrimitives();
         const displayName = CarbonManagerDisplayName_1.CarbonManagerDisplayName.create(props.displayName).toPrimitives();
         const lastAccessAt = CarbonManagerLastAccessAt_1.CarbonManagerLastAccessAt.create(props.lastAccessAt).toPrimitives();
-        const taxIdentification = CarbonManagerTaxIdentification_1.CarbonManagerTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const taxIdentification = props.taxIdentification === null
+            ? null
+            : CarbonManagerTaxIdentification_1.CarbonManagerTaxIdentification.create(props.taxIdentification).toPrimitives();
+        const identityDocument = props.identityDocument === null
+            ? null
+            : CarbonManagerIdentityDocument_1.CarbonManagerIdentityDocument.create(props.identityDocument).toPrimitives();
         const roleType = CarbonManagerRoleType_1.CarbonManagerRoleType.create(props.roleType).toEnum();
         const businessStatus = CarbonManagerBusinessStatus_1.CarbonManagerBusinessStatus.create(props.businessStatus).toEnum();
         const userType = CarbonManagerUserType_1.CarbonManagerUserType.create(props.userType).toEnum();
@@ -128,6 +143,7 @@ class CarbonManager extends Stakeholder_1.Stakeholder {
             displayName,
             lastAccessAt,
             taxIdentification,
+            identityDocument,
             roleType,
             businessStatus,
             userType,
@@ -148,7 +164,8 @@ class CarbonManager extends Stakeholder_1.Stakeholder {
             roleType: this.roleType.toEnum(),
             businessStatus: this.businessStatus.toEnum(),
             userType: this.userType.toEnum(),
-            taxIdentification: this.taxIdentification.toPrimitives(),
+            taxIdentification: this.taxIdentification?.toPrimitives() ?? null,
+            identityDocument: this.identityDocument?.toPrimitives() ?? null,
             permissions: this.permissions.toEnums(),
             preferredLocale: this.preferredLocale.toEnum(),
             managedStakeholders: __classPrivateFieldGet(this, _CarbonManager_managedStakeholders, "f").toPrimitives(),

package/build/carbonbox/stakeholders/carbon-managers/domain/value-objects/CarbonManagerIdentityDocument.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CarbonManagerIdentityDocument = void 0;
+const StakeholderIdentityDocument_1 = require("../../../shared/domain/value-objects/StakeholderIdentityDocument");
+class CarbonManagerIdentityDocument extends StakeholderIdentityDocument_1.StakeholderIdentityDocument {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation);
+    }
+    static create(value) {
+        return new CarbonManagerIdentityDocument(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = {
+            country: primitives.country,
+            issuedBy: primitives.issuedBy,
+            number: primitives.number,
+            type: primitives.type,
+            validFrom: primitives.validFrom,
+            validUntil: primitives.validUntil,
+        };
+        return new CarbonManagerIdentityDocument(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.CarbonManagerIdentityDocument = CarbonManagerIdentityDocument;