@carbonbox/domain 0.20.1 → 0.21.2

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/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}`;

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;