@carbonbox/domain 0.20.1 → 0.21.0

package/build/carbonbox/shared/domain/enums/IdentityDocumentType.js

@@ -0,0 +1,10 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityDocumentType = void 0;
+var IdentityDocumentType;
+(function (IdentityDocumentType) {
+    IdentityDocumentType["CC"] = "CC";
+    IdentityDocumentType["CE"] = "CE";
+    IdentityDocumentType["PASSPORT"] = "PASSPORT";
+    IdentityDocumentType["DNI"] = "DNI";
+})(IdentityDocumentType || (exports.IdentityDocumentType = IdentityDocumentType = {}));

package/build/carbonbox/shared/domain/exceptions/InvalidIdentityDocumentTypeError.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidIdentityDocumentTypeError = void 0;
+const RootError_1 = require("./RootError");
+class InvalidIdentityDocumentTypeError extends RootError_1.RootError {
+    constructor(invalidType, validTypes) {
+        const message = `Invalid identity document type: '${invalidType}'. Valid types: ${validTypes.join(', ')}.`;
+        super(message);
+        this.name = 'InvalidIdentityDocumentTypeError';
+    }
+    static create(invalidType, validTypes) {
+        return new InvalidIdentityDocumentTypeError(invalidType, validTypes);
+    }
+    logError() {
+        return `${this.name}: ${this.message}`;
+    }
+}
+exports.InvalidIdentityDocumentTypeError = InvalidIdentityDocumentTypeError;

package/build/carbonbox/shared/domain/types/IdentityDocument.js

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

package/build/carbonbox/shared/domain/types/IdentityDocumentPrimitives.js

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

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

@@ -0,0 +1,336 @@
+"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 _IdentityDocument_type, _IdentityDocument_number, _IdentityDocument_country, _IdentityDocument_issuedBy, _IdentityDocument_validFrom, _IdentityDocument_validUntil;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.IdentityDocument = void 0;
+const InvalidPropertyTypeError_1 = require("../exceptions/InvalidPropertyTypeError");
+const InvalidIdentityDocumentTypeError_1 = require("../exceptions/InvalidIdentityDocumentTypeError");
+const InvalidCountryCodeError_1 = require("../exceptions/InvalidCountryCodeError");
+const InvalidDateRangeError_1 = require("../exceptions/InvalidDateRangeError");
+const ObjectValueObject_1 = require("./ObjectValueObject");
+const String_1 = require("./String");
+const NullableDate_1 = require("./NullableDate");
+const CountryCode_1 = require("../enums/CountryCode");
+const IdentityDocumentType_1 = require("../enums/IdentityDocumentType");
+class IdentityDocument extends ObjectValueObject_1.ObjectValueObject {
+    /**
+     * Constructor protegido para que solo clases hijas puedan instanciar.
+     * Aplica todas las validaciones de dominio al momento de construcción.
+     */
+    constructor(value, skipDomainValidation, propertyName = IdentityDocument.DEFAULT_PROPERTY_NAME) {
+        super(value, skipDomainValidation, propertyName, 'The provided value must be of type IdentityDocument from the domain layer', { allowNull: false, allowUndefined: false });
+        _IdentityDocument_type.set(this, void 0);
+        _IdentityDocument_number.set(this, void 0);
+        _IdentityDocument_country.set(this, void 0);
+        _IdentityDocument_issuedBy.set(this, void 0);
+        _IdentityDocument_validFrom.set(this, void 0);
+        _IdentityDocument_validUntil.set(this, void 0);
+        if (skipDomainValidation === false) {
+            IdentityDocument.validateIdentityDocument(value, propertyName);
+        }
+        __classPrivateFieldSet(this, _IdentityDocument_type, value.type.trim().toUpperCase(), "f");
+        __classPrivateFieldSet(this, _IdentityDocument_number, value.number.trim(), "f");
+        __classPrivateFieldSet(this, _IdentityDocument_country, value.country.trim().toUpperCase(), "f");
+        __classPrivateFieldSet(this, _IdentityDocument_issuedBy, value.issuedBy?.trim() || null, "f");
+        __classPrivateFieldSet(this, _IdentityDocument_validFrom, value.validFrom?.trim() || null, "f");
+        __classPrivateFieldSet(this, _IdentityDocument_validUntil, value.validUntil?.trim() || null, "f");
+    }
+    /**
+     * Validación estática para reutilización en factory methods y constructores.
+     */
+    static validateIdentityDocument(value, propertyName) {
+        this.guardAgainstInvalidType(value, propertyName);
+        this.guardAgainstInvalidDocumentType(value.type);
+        this.guardAgainstInvalidNumber(value.number);
+        this.guardAgainstInvalidCountryCode(value.country);
+        this.guardAgainstInvalidIssuedBy(value.issuedBy);
+        this.guardAgainstInvalidValidFrom(value.validFrom);
+        this.guardAgainstInvalidValidUntil(value.validUntil);
+        this.guardAgainstInvalidDateRange(value.validFrom, value.validUntil);
+    }
+    /**
+     * Valida que el objeto tenga la estructura correcta.
+     */
+    static guardAgainstInvalidType(value, propertyName) {
+        if (!value || typeof value !== 'object') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(propertyName, 'IdentityDocument object', typeof value);
+        }
+        if (typeof value.type !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('type', 'string', typeof value.type);
+        }
+        if (typeof value.number !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('number', 'string', typeof value.number);
+        }
+        if (typeof value.country !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('country', 'string', typeof value.country);
+        }
+        if (value.issuedBy !== null && typeof value.issuedBy !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('issuedBy', 'string | null', typeof value.issuedBy);
+        }
+        if (value.validFrom !== null && typeof value.validFrom !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('validFrom', 'string | null', typeof value.validFrom);
+        }
+        if (value.validUntil !== null && typeof value.validUntil !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('validUntil', 'string | null', typeof value.validUntil);
+        }
+    }
+    /**
+     * Valida que el tipo de documento de identidad sea válido.
+     */
+    static guardAgainstInvalidDocumentType(type) {
+        const trimmedType = type.trim().toUpperCase();
+        if (trimmedType.length === 0) {
+            throw InvalidIdentityDocumentTypeError_1.InvalidIdentityDocumentTypeError.create('empty identity document type', this.VALID_TYPES);
+        }
+        if (!this.VALID_TYPES.includes(trimmedType)) {
+            throw InvalidIdentityDocumentTypeError_1.InvalidIdentityDocumentTypeError.create(trimmedType, this.VALID_TYPES);
+        }
+    }
+    /**
+     * Valida el número del documento de identidad (no vacío y dentro de los límites de longitud).
+     */
+    static guardAgainstInvalidNumber(number) {
+        const trimmedNumber = number.trim();
+        if (trimmedNumber.length === 0) {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('number', 'non-empty identity document number', 'empty string');
+        }
+        if (trimmedNumber.length < this.MIN_NUMBER_LENGTH || trimmedNumber.length > this.MAX_NUMBER_LENGTH) {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('number', `identity document number with length between ${this.MIN_NUMBER_LENGTH} and ${this.MAX_NUMBER_LENGTH}`, `length ${trimmedNumber.length}`);
+        }
+    }
+    /**
+     * Valida el código de país según los valores permitidos en el enum CountryCode.
+     */
+    static guardAgainstInvalidCountryCode(country) {
+        const trimmedCountry = country.trim().toUpperCase();
+        if (trimmedCountry.length === 0) {
+            throw InvalidCountryCodeError_1.InvalidCountryCodeError.create('empty country code');
+        }
+        if (!this.VALID_COUNTRY_CODES.includes(trimmedCountry)) {
+            throw InvalidCountryCodeError_1.InvalidCountryCodeError.create(trimmedCountry);
+        }
+    }
+    /**
+     * Valida la entidad emisora si está presente.
+     */
+    static guardAgainstInvalidIssuedBy(issuedBy) {
+        if (issuedBy !== null) {
+            String_1.String.guardAgainstEmptyValue(issuedBy, 'issuedBy');
+        }
+    }
+    /**
+     * Valida la fecha de inicio de validez si está presente.
+     */
+    static guardAgainstInvalidValidFrom(validFrom) {
+        if (validFrom !== null) {
+            if (!NullableDate_1.NullableDate.isValidNullableDate(validFrom)) {
+                throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('validFrom', 'valid date string (DD/MM/YYYY)', validFrom);
+            }
+        }
+    }
+    /**
+     * Valida la fecha de fin de validez si está presente.
+     */
+    static guardAgainstInvalidValidUntil(validUntil) {
+        if (validUntil !== null) {
+            if (!NullableDate_1.NullableDate.isValidNullableDate(validUntil)) {
+                throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create('validUntil', 'valid date string (DD/MM/YYYY)', validUntil);
+            }
+        }
+    }
+    /**
+     * Valida que el rango de fechas sea consistente.
+     */
+    static guardAgainstInvalidDateRange(validFrom, validUntil) {
+        if (validFrom && validUntil) {
+            const fromDate = this.parseDate(validFrom);
+            const untilDate = this.parseDate(validUntil);
+            if (fromDate >= untilDate) {
+                throw InvalidDateRangeError_1.InvalidDateRangeError.create(validFrom, validUntil);
+            }
+        }
+    }
+    /**
+     * Método auxiliar para parsear fechas en formato DD/MM/YYYY.
+     */
+    static parseDate(dateString) {
+        const [day, month, year] = dateString.split('/').map(Number);
+        return new Date(year, month - 1, day);
+    }
+    /**
+     * Tipo de documento de identidad (CC, CE, PASSPORT, DNI).
+     */
+    get type() {
+        return __classPrivateFieldGet(this, _IdentityDocument_type, "f");
+    }
+    /**
+     * Número del documento de identidad.
+     */
+    get number() {
+        return __classPrivateFieldGet(this, _IdentityDocument_number, "f");
+    }
+    /**
+     * País de emisión del documento.
+     */
+    get country() {
+        return __classPrivateFieldGet(this, _IdentityDocument_country, "f");
+    }
+    /**
+     * Entidad emisora del documento (opcional).
+     */
+    get issuedBy() {
+        return __classPrivateFieldGet(this, _IdentityDocument_issuedBy, "f");
+    }
+    /**
+     * Fecha de inicio de validez (opcional).
+     */
+    get validFrom() {
+        return __classPrivateFieldGet(this, _IdentityDocument_validFrom, "f");
+    }
+    /**
+     * Fecha de fin de validez (opcional).
+     */
+    get validUntil() {
+        return __classPrivateFieldGet(this, _IdentityDocument_validUntil, "f");
+    }
+    /**
+     * Verifica si el documento de identidad tiene entidad emisora.
+     */
+    hasIssuedBy() {
+        return __classPrivateFieldGet(this, _IdentityDocument_issuedBy, "f") !== null;
+    }
+    /**
+     * Verifica si el documento de identidad tiene fechas de validez.
+     */
+    hasValidityPeriod() {
+        return __classPrivateFieldGet(this, _IdentityDocument_validFrom, "f") !== null || __classPrivateFieldGet(this, _IdentityDocument_validUntil, "f") !== null;
+    }
+    /**
+     * Verifica si el documento de identidad está actualmente válido.
+     */
+    isCurrentlyValid() {
+        const now = new Date();
+        const today = new Date(now.getFullYear(), now.getMonth(), now.getDate());
+        if (__classPrivateFieldGet(this, _IdentityDocument_validFrom, "f")) {
+            const fromDate = IdentityDocument.parseDate(__classPrivateFieldGet(this, _IdentityDocument_validFrom, "f"));
+            if (today < fromDate) {
+                return false;
+            }
+        }
+        if (__classPrivateFieldGet(this, _IdentityDocument_validUntil, "f")) {
+            const untilDate = IdentityDocument.parseDate(__classPrivateFieldGet(this, _IdentityDocument_validUntil, "f"));
+            if (today > untilDate) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Verifica si el documento de identidad será válido en una fecha específica.
+     */
+    isValidOnDate(date) {
+        const checkDate = new Date(date.getFullYear(), date.getMonth(), date.getDate());
+        if (__classPrivateFieldGet(this, _IdentityDocument_validFrom, "f")) {
+            const fromDate = IdentityDocument.parseDate(__classPrivateFieldGet(this, _IdentityDocument_validFrom, "f"));
+            if (checkDate < fromDate) {
+                return false;
+            }
+        }
+        if (__classPrivateFieldGet(this, _IdentityDocument_validUntil, "f")) {
+            const untilDate = IdentityDocument.parseDate(__classPrivateFieldGet(this, _IdentityDocument_validUntil, "f"));
+            if (checkDate > untilDate) {
+                return false;
+            }
+        }
+        return true;
+    }
+    /**
+     * Verifica si pertenece a un país específico.
+     */
+    belongsToCountry(countryCode) {
+        return __classPrivateFieldGet(this, _IdentityDocument_country, "f") === countryCode.trim().toUpperCase();
+    }
+    /**
+     * Verifica si es del mismo tipo que otro documento de identidad.
+     */
+    isSameType(other) {
+        return __classPrivateFieldGet(this, _IdentityDocument_type, "f") === __classPrivateFieldGet(other, _IdentityDocument_type, "f");
+    }
+    /**
+     * Compara la igualdad semántica con otro objeto IdentityDocument.
+     */
+    equals(other) {
+        if (!(other instanceof IdentityDocument)) {
+            return false;
+        }
+        return (__classPrivateFieldGet(this, _IdentityDocument_type, "f") === __classPrivateFieldGet(other, _IdentityDocument_type, "f")
+            && __classPrivateFieldGet(this, _IdentityDocument_number, "f") === __classPrivateFieldGet(other, _IdentityDocument_number, "f")
+            && __classPrivateFieldGet(this, _IdentityDocument_country, "f") === __classPrivateFieldGet(other, _IdentityDocument_country, "f")
+            && __classPrivateFieldGet(this, _IdentityDocument_issuedBy, "f") === __classPrivateFieldGet(other, _IdentityDocument_issuedBy, "f")
+            && __classPrivateFieldGet(this, _IdentityDocument_validFrom, "f") === __classPrivateFieldGet(other, _IdentityDocument_validFrom, "f")
+            && __classPrivateFieldGet(this, _IdentityDocument_validUntil, "f") === __classPrivateFieldGet(other, _IdentityDocument_validUntil, "f"));
+    }
+    /**
+     * Compara si dos documentos de identidad representan el mismo número
+     * independientemente de fechas de validez y entidad emisora.
+     */
+    hasSameIdentifier(other) {
+        if (!(other instanceof IdentityDocument)) {
+            return false;
+        }
+        return (__classPrivateFieldGet(this, _IdentityDocument_type, "f") === __classPrivateFieldGet(other, _IdentityDocument_type, "f")
+            && __classPrivateFieldGet(this, _IdentityDocument_number, "f") === __classPrivateFieldGet(other, _IdentityDocument_number, "f")
+            && __classPrivateFieldGet(this, _IdentityDocument_country, "f") === __classPrivateFieldGet(other, _IdentityDocument_country, "f"));
+    }
+    /**
+     * Convierte a representación primitiva para persistencia.
+     */
+    toPrimitives() {
+        return {
+            type: __classPrivateFieldGet(this, _IdentityDocument_type, "f"),
+            number: __classPrivateFieldGet(this, _IdentityDocument_number, "f"),
+            country: __classPrivateFieldGet(this, _IdentityDocument_country, "f"),
+            issuedBy: __classPrivateFieldGet(this, _IdentityDocument_issuedBy, "f"),
+            validFrom: __classPrivateFieldGet(this, _IdentityDocument_validFrom, "f"),
+            validUntil: __classPrivateFieldGet(this, _IdentityDocument_validUntil, "f"),
+        };
+    }
+    /**
+     * Representación como string.
+     */
+    toString() {
+        return `${__classPrivateFieldGet(this, _IdentityDocument_type, "f")}-${__classPrivateFieldGet(this, _IdentityDocument_number, "f")}-${__classPrivateFieldGet(this, _IdentityDocument_country, "f")}`;
+    }
+    /**
+     * Representación JSON para serialización.
+     */
+    toJSON() {
+        return this.toPrimitives();
+    }
+    /**
+     * Método de utilidad para validar completamente un IdentityDocument antes de crear la instancia.
+     */
+    static validateCompletely(value, propertyName = this.DEFAULT_PROPERTY_NAME) {
+        this.validateIdentityDocument(value, propertyName);
+    }
+}
+exports.IdentityDocument = IdentityDocument;
+_IdentityDocument_type = new WeakMap(), _IdentityDocument_number = new WeakMap(), _IdentityDocument_country = new WeakMap(), _IdentityDocument_issuedBy = new WeakMap(), _IdentityDocument_validFrom = new WeakMap(), _IdentityDocument_validUntil = new WeakMap();
+IdentityDocument.DEFAULT_PROPERTY_NAME = 'identityDocument';
+// Tipos de documento de identidad válidos
+IdentityDocument.VALID_TYPES = Object.values(IdentityDocumentType_1.IdentityDocumentType);
+// Códigos de país válidos
+IdentityDocument.VALID_COUNTRY_CODES = Object.values(CountryCode_1.CountryCode);
+// Límites de longitud del número de documento (cédula, pasaporte, DNI, etc.)
+IdentityDocument.MIN_NUMBER_LENGTH = 3;
+IdentityDocument.MAX_NUMBER_LENGTH = 20;

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(),
         };