@carbonbox/domain 0.27.0 → 0.28.0

package/build/carbonbox/emission-calculation-results/emission-aggregations/domain/value-objects/EmissionAggregationGhgBreakdown.js

@@ -10,143 +10,97 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _a, _EmissionAggregationGhgBreakdown_ghgBreakdowns, _EmissionAggregationGhgBreakdown_guardAgainstInvalidArrayType, _EmissionAggregationGhgBreakdown_guardAgainstInvalidEmptyArray, _EmissionAggregationGhgBreakdown_guardAgainstDuplicateGreenhouseGases, _EmissionAggregationGhgBreakdown_guardAgainstInvalidTotalPercentage, _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgBreakdown, _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgStructure, _EmissionAggregationGhgBreakdown_guardAgainstInvalidGreenhouseGas, _EmissionAggregationGhgBreakdown_guardAgainstInvalidCo2Equivalent, _EmissionAggregationGhgBreakdown_guardAgainstInvalidPercentage, _EmissionAggregationGhgBreakdown_guardAgainstInvalidUnit;
+var _a, _EmissionAggregationGhgBreakdown_ghgBreakdowns, _EmissionAggregationGhgBreakdown_guardAgainstInvalidArrayType, _EmissionAggregationGhgBreakdown_guardAgainstInvalidEmptyArray, _EmissionAggregationGhgBreakdown_guardAgainstDuplicateSpecies, _EmissionAggregationGhgBreakdown_guardAgainstInvalidTotalPercentage, _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgBreakdown, _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgStructure, _EmissionAggregationGhgBreakdown_guardAgainstInvalidCategory, _EmissionAggregationGhgBreakdown_guardAgainstInvalidCo2Equivalent, _EmissionAggregationGhgBreakdown_guardAgainstInvalidPercentage, _EmissionAggregationGhgBreakdown_guardAgainstInvalidUnit;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.EmissionAggregationGhgBreakdown = void 0;
 const InvalidPropertyTypeError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyTypeError");
 const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
 const String_1 = require("../../../../shared/domain/value-objects/String");
 const Numeric_1 = require("../../../../shared/domain/value-objects/Numeric");
-const GreenhouseGas_1 = require("../../../../shared/domain/enums/GreenhouseGas");
+const GreenhouseGasCategory_1 = require("../../../../shared/domain/enums/GreenhouseGasCategory");
+const GreenhouseGasSpecies_1 = require("../../../../shared/domain/value-objects/GreenhouseGasSpecies");
 const ValueObject_1 = require("../../../../shared/domain/value-objects/ValueObject");
 class EmissionAggregationGhgBreakdown extends ValueObject_1.ValueObject {
-    /**
-     * Constructor privado para controlar la creación de instancias.
-     * Aplica todas las validaciones de dominio al momento de construcción.
-     */
     constructor(value, skipDomainValidation) {
         super(value, skipDomainValidation, _a.PROPERTY_NAME, 'The provided value must be of type GHGBreakdown[] from the domain layer');
         _EmissionAggregationGhgBreakdown_ghgBreakdowns.set(this, void 0);
         if (skipDomainValidation === false) {
             _a.validateGhgBreakdowns(value, _a.OPTIONS, _a.PROPERTY_NAME);
         }
-        __classPrivateFieldSet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, [...value], "f"); // Create defensive copy
+        __classPrivateFieldSet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, [...value], "f");
     }
-    /**
-     * Factory method para crear una nueva instancia de EmissionAggregationGhgBreakdown.
-     */
     static create(value) {
         return new _a(value, false);
     }
-    /**
-     * Factory method para crear desde primitivos.
-     */
     static fromPrimitives(primitives) {
         const ghgBreakdowns = primitives.map((primitive) => ({
-            greenhouseGas: primitive.greenhouseGas,
+            greenhouseGasCategory: primitive.greenhouseGasCategory,
+            greenhouseGasSpecies: primitive.greenhouseGasSpecies,
             co2Equivalent: primitive.co2Equivalent,
             percentage: primitive.percentage,
             unit: primitive.unit,
         }));
         return new _a(ghgBreakdowns, true);
     }
-    /**
-     * Validación estática para reutilización en factory methods y constructores.
-     */
     static validateGhgBreakdowns(value, options, propertyName) {
         __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidArrayType).call(this, value, propertyName);
         __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidEmptyArray).call(this, value, options, propertyName);
-        __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstDuplicateGreenhouseGases).call(this, value, propertyName);
+        __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstDuplicateSpecies).call(this, value, propertyName);
         __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidTotalPercentage).call(this, value, propertyName);
         value.forEach((ghgBreakdown, index) => {
             __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgBreakdown).call(this, ghgBreakdown, index, propertyName);
         });
     }
-    /**
-     * Breakdowns de GHG (inmutable).
-     */
     get ghgBreakdowns() {
         return Object.freeze([...__classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f")]);
     }
-    /**
-     * Número de breakdowns en la colección.
-     */
     get length() {
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").length;
     }
-    /**
-     * Verifica si la colección está vacía.
-     */
     isEmpty() {
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").length === 0;
     }
-    /**
-     * Verifica si la colección tiene breakdowns.
-     */
     hasBreakdowns() {
         return !this.isEmpty();
     }
-    /**
-     * Obtiene un breakdown por gas de efecto invernadero.
-     */
-    getBreakdownByGas(greenhouseGas) {
-        const breakdown = __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").find((b) => b.greenhouseGas === greenhouseGas);
+    getBreakdownBySpecies(species) {
+        const normalized = GreenhouseGasSpecies_1.GreenhouseGasSpecies.normalize(species);
+        const breakdown = __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").find((b) => b.greenhouseGasSpecies === normalized);
         return breakdown || null;
     }
-    /**
-     * Verifica si existe un breakdown para el gas especificado.
-     */
-    hasBreakdownForGas(greenhouseGas) {
-        return this.getBreakdownByGas(greenhouseGas) !== null;
+    hasBreakdownForSpecies(species) {
+        return this.getBreakdownBySpecies(species) !== null;
     }
-    /**
-     * Obtiene un breakdown por su índice.
-     */
     getBreakdownAt(index) {
         if (index < 0 || index >= __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").length) {
             return null;
         }
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f")[index];
     }
-    /**
-     * Obtiene todos los gases de efecto invernadero.
-     */
-    getAllGreenhouseGases() {
-        return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").map((breakdown) => breakdown.greenhouseGas);
+    getAllSpecies() {
+        return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").map((breakdown) => breakdown.greenhouseGasSpecies);
+    }
+    getAllCategories() {
+        return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").map((breakdown) => breakdown.greenhouseGasCategory);
     }
-    /**
-     * Obtiene el total de CO2 equivalente.
-     */
     getTotalCo2Equivalent() {
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").reduce((total, breakdown) => total + breakdown.co2Equivalent, 0);
     }
-    /**
-     * Obtiene el breakdown con mayor CO2 equivalente.
-     */
     getHighestCo2EquivalentBreakdown() {
         if (this.isEmpty()) {
             return null;
         }
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").reduce((max, current) => (current.co2Equivalent > max.co2Equivalent ? current : max));
     }
-    /**
-     * Obtiene el breakdown con menor CO2 equivalente.
-     */
     getLowestCo2EquivalentBreakdown() {
         if (this.isEmpty()) {
             return null;
         }
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").reduce((min, current) => (current.co2Equivalent < min.co2Equivalent ? current : min));
     }
-    /**
-     * Filtra breakdowns por umbral mínimo de porcentaje.
-     */
     getBreakdownsAbovePercentage(threshold) {
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").filter((breakdown) => breakdown.percentage >= threshold);
     }
-    /**
-     * Obtiene los N breakdowns con mayor CO2 equivalente.
-     */
     getTopNBreakdowns(count) {
         if (count <= 0) {
             return [];
@@ -155,30 +109,21 @@ class EmissionAggregationGhgBreakdown extends ValueObject_1.ValueObject {
             .sort((a, b) => b.co2Equivalent - a.co2Equivalent)
             .slice(0, count);
     }
-    /**
-     * Verifica si contiene todos los gases principales (CO2, CH4, N2O).
-     */
     hasMainGreenhouseGases() {
-        const mainGases = [GreenhouseGas_1.GreenhouseGas.CO2, GreenhouseGas_1.GreenhouseGas.CH4, GreenhouseGas_1.GreenhouseGas.N2O];
-        return mainGases.every((gas) => this.hasBreakdownForGas(gas));
-    }
-    /**
-     * Obtiene gases faltantes de una lista específica.
-     */
-    getMissingGases(requiredGases) {
-        return requiredGases.filter((gas) => !this.hasBreakdownForGas(gas));
-    }
-    /**
-     * Obtiene estadísticas de los breakdowns.
-     */
+        const presentCategories = new Set(this.getAllCategories());
+        return _a.MAIN_GAS_CATEGORIES.every((category) => presentCategories.has(category));
+    }
+    getMissingSpecies(requiredSpecies) {
+        return requiredSpecies.filter((species) => !this.hasBreakdownForSpecies(species));
+    }
     getStatistics() {
         if (this.isEmpty()) {
             return {
                 totalCo2Equivalent: 0,
                 averagePercentage: 0,
                 gasCount: 0,
-                highestGas: null,
-                lowestGas: null,
+                highestSpecies: null,
+                lowestSpecies: null,
             };
         }
         const highest = this.getHighestCo2EquivalentBreakdown();
@@ -187,36 +132,25 @@ class EmissionAggregationGhgBreakdown extends ValueObject_1.ValueObject {
             totalCo2Equivalent: this.getTotalCo2Equivalent(),
             averagePercentage: __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").reduce((sum, b) => sum + b.percentage, 0) / this.length,
             gasCount: this.length,
-            highestGas: highest?.greenhouseGas || null,
-            lowestGas: lowest?.greenhouseGas || null,
+            highestSpecies: highest?.greenhouseGasSpecies || null,
+            lowestSpecies: lowest?.greenhouseGasSpecies || null,
         };
     }
-    /**
-     * Convierte a representación primitiva para persistencia.
-     */
     toPrimitives() {
         return __classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f").map((breakdown) => ({
-            greenhouseGas: breakdown.greenhouseGas,
+            greenhouseGasCategory: breakdown.greenhouseGasCategory,
+            greenhouseGasSpecies: breakdown.greenhouseGasSpecies,
             co2Equivalent: breakdown.co2Equivalent,
             percentage: breakdown.percentage,
             unit: breakdown.unit,
         }));
     }
-    /**
-     * Representación JSON para serialización.
-     */
     toJSON() {
         return this.toPrimitives();
     }
-    /**
-     * Convierte a tipos de dominio.
-     */
     toEnums() {
         return [...__classPrivateFieldGet(this, _EmissionAggregationGhgBreakdown_ghgBreakdowns, "f")];
     }
-    /**
-     * Método estático para validar si un array es válido.
-     */
     static isValidGhgBreakdowns(value, options = _a.OPTIONS) {
         try {
             const finalOptions = { ..._a.OPTIONS, ...options };
@@ -237,25 +171,26 @@ _a = EmissionAggregationGhgBreakdown, _EmissionAggregationGhgBreakdown_ghgBreakd
     if (!options.allowEmpty && value.length === 0) {
         throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(propertyName, 'non-empty array', 'empty array');
     }
-}, _EmissionAggregationGhgBreakdown_guardAgainstDuplicateGreenhouseGases = function _EmissionAggregationGhgBreakdown_guardAgainstDuplicateGreenhouseGases(value, propertyName) {
-    const greenhouseGases = value.map((breakdown) => breakdown.greenhouseGas);
-    const uniqueGases = new Set(greenhouseGases);
-    if (greenhouseGases.length !== uniqueGases.size) {
-        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(`${propertyName}.greenhouseGas`, 'unique greenhouse gases', 'duplicate gases found');
+}, _EmissionAggregationGhgBreakdown_guardAgainstDuplicateSpecies = function _EmissionAggregationGhgBreakdown_guardAgainstDuplicateSpecies(value, propertyName) {
+    const species = value.map((breakdown) => GreenhouseGasSpecies_1.GreenhouseGasSpecies.normalize(breakdown.greenhouseGasSpecies));
+    const uniqueSpecies = new Set(species);
+    if (species.length !== uniqueSpecies.size) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(`${propertyName}.greenhouseGasSpecies`, 'unique greenhouse gas species', 'duplicate species found');
     }
 }, _EmissionAggregationGhgBreakdown_guardAgainstInvalidTotalPercentage = function _EmissionAggregationGhgBreakdown_guardAgainstInvalidTotalPercentage(value, propertyName) {
     if (value.length === 0) {
-        return; // Skip validation for empty arrays
+        return;
     }
     const totalPercentage = value.reduce((sum, breakdown) => sum + breakdown.percentage, 0);
-    const tolerance = 0.01; // 1% tolerance for rounding
+    const tolerance = 0.01;
     if (Math.abs(totalPercentage - 100) > tolerance) {
         throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(`${propertyName}.percentage`, 'total percentage should be approximately 100%', `total percentage is ${totalPercentage.toFixed(2)}%`);
     }
 }, _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgBreakdown = function _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgBreakdown(ghgBreakdown, index, basePropertyName) {
     const propertyName = `${basePropertyName}[${index}]`;
     __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidGhgStructure).call(this, ghgBreakdown, propertyName);
-    __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidGreenhouseGas).call(this, ghgBreakdown.greenhouseGas, `${propertyName}.greenhouseGas`);
+    __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidCategory).call(this, ghgBreakdown.greenhouseGasCategory, `${propertyName}.greenhouseGasCategory`);
+    GreenhouseGasSpecies_1.GreenhouseGasSpecies.create(ghgBreakdown.greenhouseGasSpecies);
     __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidCo2Equivalent).call(this, ghgBreakdown.co2Equivalent, `${propertyName}.co2Equivalent`);
     __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidPercentage).call(this, ghgBreakdown.percentage, `${propertyName}.percentage`);
     __classPrivateFieldGet(this, _a, "m", _EmissionAggregationGhgBreakdown_guardAgainstInvalidUnit).call(this, ghgBreakdown.unit, `${propertyName}.unit`);
@@ -263,8 +198,11 @@ _a = EmissionAggregationGhgBreakdown, _EmissionAggregationGhgBreakdown_ghgBreakd
     if (!ghgBreakdown || typeof ghgBreakdown !== 'object') {
         throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(propertyName, 'GHGBreakdown object', typeof ghgBreakdown);
     }
-    if (typeof ghgBreakdown.greenhouseGas !== 'string') {
-        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.greenhouseGas`, 'string', typeof ghgBreakdown.greenhouseGas);
+    if (typeof ghgBreakdown.greenhouseGasCategory !== 'string') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.greenhouseGasCategory`, 'string', typeof ghgBreakdown.greenhouseGasCategory);
+    }
+    if (typeof ghgBreakdown.greenhouseGasSpecies !== 'string') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.greenhouseGasSpecies`, 'string', typeof ghgBreakdown.greenhouseGasSpecies);
     }
     if (typeof ghgBreakdown.co2Equivalent !== 'number') {
         throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.co2Equivalent`, 'number', typeof ghgBreakdown.co2Equivalent);
@@ -275,10 +213,10 @@ _a = EmissionAggregationGhgBreakdown, _EmissionAggregationGhgBreakdown_ghgBreakd
     if (typeof ghgBreakdown.unit !== 'string') {
         throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.unit`, 'string', typeof ghgBreakdown.unit);
     }
-}, _EmissionAggregationGhgBreakdown_guardAgainstInvalidGreenhouseGas = function _EmissionAggregationGhgBreakdown_guardAgainstInvalidGreenhouseGas(greenhouseGas, propertyName) {
-    const validGases = Object.values(GreenhouseGas_1.GreenhouseGas);
-    if (!validGases.includes(greenhouseGas)) {
-        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(propertyName, 'valid GreenhouseGas', greenhouseGas);
+}, _EmissionAggregationGhgBreakdown_guardAgainstInvalidCategory = function _EmissionAggregationGhgBreakdown_guardAgainstInvalidCategory(category, propertyName) {
+    const validCategories = Object.values(GreenhouseGasCategory_1.GreenhouseGasCategory);
+    if (!validCategories.includes(category)) {
+        throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(propertyName, 'valid GreenhouseGasCategory', category);
     }
 }, _EmissionAggregationGhgBreakdown_guardAgainstInvalidCo2Equivalent = function _EmissionAggregationGhgBreakdown_guardAgainstInvalidCo2Equivalent(co2Equivalent, propertyName) {
     Numeric_1.Numeric.guardAgainstInvalidType(co2Equivalent, propertyName);
@@ -296,3 +234,8 @@ EmissionAggregationGhgBreakdown.PROPERTY_NAME = 'ghgBreakdown';
 EmissionAggregationGhgBreakdown.OPTIONS = {
     allowEmpty: true,
 };
+EmissionAggregationGhgBreakdown.MAIN_GAS_CATEGORIES = [
+    GreenhouseGasCategory_1.GreenhouseGasCategory.CO2,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.CH4,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.N2O,
+];

package/build/carbonbox/emission-calculation-results/ghg-emission-results/domain/entity/GHGEmissionResult.js

@@ -40,7 +40,7 @@ class GHGEmissionResult extends AggregateRoot_1.AggregateRoot {
         if (skipDomainValidation === false) {
             // Initialize with domain validation
             __classPrivateFieldSet(this, _GHGEmissionResult_emissionCalculation, GHGEmissionResultEmissionCalculation_1.GHGEmissionResultEmissionCalculation.create(props.emissionCalculation), "f");
-            __classPrivateFieldSet(this, _GHGEmissionResult_greenhouseGas, GHGEmissionResultGreenhouseGas_1.GHGEmissionResultGreenhouseGas.create(props.greenhouseGas), "f");
+            __classPrivateFieldSet(this, _GHGEmissionResult_greenhouseGas, GHGEmissionResultGreenhouseGas_1.GHGEmissionResultGreenhouseGas.create(props.greenhouseGasCategory, props.greenhouseGasSpecies), "f");
             __classPrivateFieldSet(this, _GHGEmissionResult_activityValue, GHGEmissionResultActivityValue_1.GHGEmissionResultActivityValue.create(props.activityValue), "f");
             __classPrivateFieldSet(this, _GHGEmissionResult_emissionFactor, GHGEmissionResultEmissionFactor_1.GHGEmissionResultEmissionFactor.create(props.emissionFactor), "f");
             __classPrivateFieldSet(this, _GHGEmissionResult_globalWarmingPotential, GHGEmissionResultGlobalWarmingPotential_1.GHGEmissionResultGlobalWarmingPotential.create(props.globalWarmingPotential), "f");
@@ -51,7 +51,10 @@ class GHGEmissionResult extends AggregateRoot_1.AggregateRoot {
         else {
             // Initialize from primitives (no domain validation)
             __classPrivateFieldSet(this, _GHGEmissionResult_emissionCalculation, GHGEmissionResultEmissionCalculation_1.GHGEmissionResultEmissionCalculation.fromPrimitives(props.emissionCalculation), "f");
-            __classPrivateFieldSet(this, _GHGEmissionResult_greenhouseGas, GHGEmissionResultGreenhouseGas_1.GHGEmissionResultGreenhouseGas.fromPrimitives(props.greenhouseGas), "f");
+            __classPrivateFieldSet(this, _GHGEmissionResult_greenhouseGas, GHGEmissionResultGreenhouseGas_1.GHGEmissionResultGreenhouseGas.fromPrimitives({
+                greenhouseGasCategory: props.greenhouseGasCategory,
+                greenhouseGasSpecies: props.greenhouseGasSpecies,
+            }), "f");
             __classPrivateFieldSet(this, _GHGEmissionResult_activityValue, GHGEmissionResultActivityValue_1.GHGEmissionResultActivityValue.fromPrimitives(props.activityValue), "f");
             __classPrivateFieldSet(this, _GHGEmissionResult_emissionFactor, GHGEmissionResultEmissionFactor_1.GHGEmissionResultEmissionFactor.fromPrimitives(props.emissionFactor), "f");
             __classPrivateFieldSet(this, _GHGEmissionResult_globalWarmingPotential, GHGEmissionResultGlobalWarmingPotential_1.GHGEmissionResultGlobalWarmingPotential.fromPrimitives(props.globalWarmingPotential), "f");
@@ -67,7 +70,8 @@ class GHGEmissionResult extends AggregateRoot_1.AggregateRoot {
         const props = {
             id: primitives.id,
             emissionCalculation: primitives.emissionCalculation,
-            greenhouseGas: primitives.greenhouseGas,
+            greenhouseGasCategory: primitives.greenhouseGasCategory,
+            greenhouseGasSpecies: primitives.greenhouseGasSpecies,
             activityValue: primitives.activityValue,
             emissionFactor: primitives.emissionFactor,
             globalWarmingPotential: primitives.globalWarmingPotential,
@@ -81,7 +85,8 @@ class GHGEmissionResult extends AggregateRoot_1.AggregateRoot {
         return {
             id: this.id.toPrimitives(),
             emissionCalculation: __classPrivateFieldGet(this, _GHGEmissionResult_emissionCalculation, "f").toPrimitives(),
-            greenhouseGas: __classPrivateFieldGet(this, _GHGEmissionResult_greenhouseGas, "f").toEnum(),
+            greenhouseGasCategory: __classPrivateFieldGet(this, _GHGEmissionResult_greenhouseGas, "f").category,
+            greenhouseGasSpecies: __classPrivateFieldGet(this, _GHGEmissionResult_greenhouseGas, "f").species,
             activityValue: __classPrivateFieldGet(this, _GHGEmissionResult_activityValue, "f").toPrimitives(),
             emissionFactor: __classPrivateFieldGet(this, _GHGEmissionResult_emissionFactor, "f").toPrimitives(),
             globalWarmingPotential: __classPrivateFieldGet(this, _GHGEmissionResult_globalWarmingPotential, "f").toPrimitives(),

package/build/carbonbox/emission-calculation-results/ghg-emission-results/domain/value-objects/GHGEmissionResultGreenhouseGas.js

@@ -1,184 +1,68 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GHGEmissionResultGreenhouseGas = void 0;
-const String_1 = require("../../../../shared/domain/value-objects/String");
-const GreenhouseGas_1 = require("../../../../shared/domain/enums/GreenhouseGas");
+const ValueObject_1 = require("../../../../shared/domain/value-objects/ValueObject");
+const GreenhouseGasCategory_1 = require("../../../../shared/domain/enums/GreenhouseGasCategory");
+const GreenhouseGasSpecies_1 = require("../../../../shared/domain/value-objects/GreenhouseGasSpecies");
 const InvalidGreenhouseGasTypeError_1 = require("../../../../emission-calculation-formulas/domain/exceptions/InvalidGreenhouseGasTypeError");
-const UnknownGreenhouseGasCategoryError_1 = require("../exceptions/UnknownGreenhouseGasCategoryError");
-class GHGEmissionResultGreenhouseGas extends String_1.String {
+/**
+ * Identidad del gas en un resultado de emisión: categoría (canasta de Kyoto) + especie concreta.
+ * El cálculo produce un resultado por especie; la categoría viaja al lado para agregación/reporte.
+ * La lógica de categorización (fluorinated/main-gases) opera sobre categoría, no sobre la especie.
+ */
+class GHGEmissionResultGreenhouseGas extends ValueObject_1.ValueObject {
     constructor(value, skipDomainValidation) {
-        super(value, skipDomainValidation, GHGEmissionResultGreenhouseGas.PROPERTY_NAME);
+        super(value, skipDomainValidation, GHGEmissionResultGreenhouseGas.PROPERTY_NAME, 'The provided value must be a { greenhouseGasCategory, greenhouseGasSpecies } from the domain layer', { allowNull: false, allowUndefined: false });
         if (skipDomainValidation === false) {
-            this.validateGreenhouseGas(value);
+            GHGEmissionResultGreenhouseGas.guardAgainstInvalidCategory(value.greenhouseGasCategory);
         }
     }
-    static create(value) {
-        String_1.String.guardAgainstEmptyValue(value, GHGEmissionResultGreenhouseGas.PROPERTY_NAME);
-        String_1.String.guardAgainstInvalidType(value, GHGEmissionResultGreenhouseGas.PROPERTY_NAME);
-        return new GHGEmissionResultGreenhouseGas(value, false);
+    static create(category, species) {
+        GHGEmissionResultGreenhouseGas.guardAgainstInvalidCategory(category);
+        const normalizedSpecies = GreenhouseGasSpecies_1.GreenhouseGasSpecies.create(species).toPrimitives();
+        return new GHGEmissionResultGreenhouseGas({ greenhouseGasCategory: category, greenhouseGasSpecies: normalizedSpecies }, false);
     }
-    static fromPrimitives(primitive) {
-        const value = primitive;
-        return new GHGEmissionResultGreenhouseGas(value, true);
+    static fromPrimitives(primitives) {
+        return new GHGEmissionResultGreenhouseGas(primitives, true);
     }
-    /**
-     * Valida que el valor sea un gas de efecto invernadero válido.
-     */
-    validateGreenhouseGas(value) {
-        if (!GHGEmissionResultGreenhouseGas.VALID_GREENHOUSE_GASES.includes(value)) {
-            throw InvalidGreenhouseGasTypeError_1.InvalidGreenhouseGasTypeError.create(GHGEmissionResultGreenhouseGas.PROPERTY_NAME, GHGEmissionResultGreenhouseGas.VALID_GREENHOUSE_GASES, value);
+    static guardAgainstInvalidCategory(category) {
+        if (!Object.values(GreenhouseGasCategory_1.GreenhouseGasCategory).includes(category)) {
+            throw InvalidGreenhouseGasTypeError_1.InvalidGreenhouseGasTypeError.create(GHGEmissionResultGreenhouseGas.PROPERTY_NAME, Object.values(GreenhouseGasCategory_1.GreenhouseGasCategory), category);
         }
     }
-    /**
-     * Verifica si es CO2 (Dióxido de Carbono).
-     */
-    isCO2() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.CO2;
-    }
-    /**
-     * Verifica si es CH4 (Metano).
-     */
-    isCH4() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.CH4;
-    }
-    /**
-     * Verifica si es N2O (Óxido Nitroso).
-     */
-    isN2O() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.N2O;
-    }
-    /**
-     * Verifica si es HFC (Hidrofluorocarbonos).
-     */
-    isHFC() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.HFC;
-    }
-    /**
-     * Verifica si es PFC (Perfluorocarbonos).
-     */
-    isPFC() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.PFC;
+    get category() {
+        return this.value.greenhouseGasCategory;
     }
-    /**
-     * Verifica si es SF6 (Hexafluoruro de Azufre).
-     */
-    isSF6() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.SF6;
+    get species() {
+        return this.value.greenhouseGasSpecies;
     }
-    /**
-     * Verifica si es NF3 (Trifluoruro de Nitrógeno).
-     */
-    isNF3() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.NF3;
-    }
-    /**
-     * Verifica si es HFC134a (Hidrofluorocarbono específico).
-     */
-    isHFC134a() {
-        return this.value === GreenhouseGas_1.GreenhouseGas.HFC134a;
-    }
-    /**
-     * Obtiene los gases de efecto invernadero válidos.
-     */
-    static getValidGreenhouseGases() {
-        return Object.freeze([...GHGEmissionResultGreenhouseGas.VALID_GREENHOUSE_GASES]);
-    }
-    /**
-     * Verifica si un valor es un gas de efecto invernadero válido.
-     */
-    static isValidGreenhouseGas(value) {
-        return GHGEmissionResultGreenhouseGas.VALID_GREENHOUSE_GASES.includes(value);
+    isCO2() {
+        return this.category === GreenhouseGasCategory_1.GreenhouseGasCategory.CO2;
     }
-    /**
-     * Verifica si es un gas de Kyoto Protocol (CO2, CH4, N2O, HFC, PFC, SF6).
-     */
-    isKyotoProtocolGas() {
-        return this.isCO2() || this.isCH4() || this.isN2O() || this.isHFC() || this.isPFC() || this.isSF6();
+    isMainGas() {
+        return GHGEmissionResultGreenhouseGas.MAIN_GAS_CATEGORIES.includes(this.category);
     }
-    /**
-     * Verifica si es un gas fluorado (HFC, PFC, SF6, NF3, HFC134a).
-     */
     isFluorinatedGas() {
-        return this.isHFC() || this.isPFC() || this.isSF6() || this.isNF3() || this.isHFC134a();
-    }
-    /**
-     * Verifica si es un gas con alto potencial de calentamiento global (todos excepto CO2).
-     */
-    isHighGWPGas() {
-        return !this.isCO2();
-    }
-    /**
-     * Obtiene el tipo de gas según su categoría.
-     */
-    getGasCategory() {
-        if (this.isCO2() || this.isCH4() || this.isN2O())
-            return 'natural';
-        if (this.isHFC134a())
-            return 'specific_hfc';
-        if (this.isFluorinatedGas())
-            return 'fluorinated';
-        // Este caso nunca debería ocurrir debido a las validaciones
-        throw UnknownGreenhouseGasCategoryError_1.UnknownGreenhouseGasCategoryError.create(this.value);
-    }
-    /**
-     * Verifica si requiere medición específica de GWP.
-     */
-    requiresSpecificGWP() {
-        // Los gases fluorados generalmente requieren GWP específico
-        return this.isFluorinatedGas();
-    }
-    /**
-     * Obtiene la descripción del gas de efecto invernadero.
-     */
-    getDescription() {
-        const descriptions = {
-            [GreenhouseGas_1.GreenhouseGas.CO2]: 'Dióxido de Carbono - Principal gas de efecto invernadero',
-            [GreenhouseGas_1.GreenhouseGas.CH4]: 'Metano - Gas de efecto invernadero con alto potencial de calentamiento',
-            [GreenhouseGas_1.GreenhouseGas.N2O]: 'Óxido Nitroso - Gas de efecto invernadero de larga duración',
-            [GreenhouseGas_1.GreenhouseGas.HFC]: 'Hidrofluorocarbonos - Gases sintéticos con alto GWP',
-            [GreenhouseGas_1.GreenhouseGas.PFC]: 'Perfluorocarbonos - Gases sintéticos de muy larga duración',
-            [GreenhouseGas_1.GreenhouseGas.SF6]: 'Hexafluoruro de Azufre - Gas con el GWP más alto',
-            [GreenhouseGas_1.GreenhouseGas.NF3]: 'Trifluoruro de Nitrógeno - Gas industrial con alto GWP',
-            [GreenhouseGas_1.GreenhouseGas.HFC134a]: 'HFC-134a - Hidrofluorocarbono específico usado en refrigeración',
-        };
-        return descriptions[this.value] || this.value;
-    }
-    /**
-     * Obtiene las características principales del gas.
-     */
-    getCharacteristics() {
-        return {
-            isKyotoProtocolGas: this.isKyotoProtocolGas(),
-            isFluorinatedGas: this.isFluorinatedGas(),
-            isHighGWPGas: this.isHighGWPGas(),
-            requiresSpecificGWP: this.requiresSpecificGWP(),
-            category: this.getGasCategory(),
-        };
+        return GHGEmissionResultGreenhouseGas.FLUORINATED_CATEGORIES.includes(this.category);
     }
     toPrimitives() {
-        return this.value;
-    }
-    toEnum() {
-        return this.value;
-    }
-    /**
-     * Representación como string descriptiva.
-     */
-    toString() {
-        const gasNames = {
-            [GreenhouseGas_1.GreenhouseGas.CO2]: 'CO₂',
-            [GreenhouseGas_1.GreenhouseGas.CH4]: 'CH₄',
-            [GreenhouseGas_1.GreenhouseGas.N2O]: 'N₂O',
-            [GreenhouseGas_1.GreenhouseGas.HFC]: 'HFC',
-            [GreenhouseGas_1.GreenhouseGas.PFC]: 'PFC',
-            [GreenhouseGas_1.GreenhouseGas.SF6]: 'SF₆',
-            [GreenhouseGas_1.GreenhouseGas.NF3]: 'NF₃',
-            [GreenhouseGas_1.GreenhouseGas.HFC134a]: 'HFC-134a',
+        return {
+            greenhouseGasCategory: this.value.greenhouseGasCategory,
+            greenhouseGasSpecies: this.value.greenhouseGasSpecies,
         };
-        return gasNames[this.value] || this.value;
     }
 }
 exports.GHGEmissionResultGreenhouseGas = GHGEmissionResultGreenhouseGas;
 GHGEmissionResultGreenhouseGas.PROPERTY_NAME = 'greenhouseGas';
-// Gases de efecto invernadero válidos
-GHGEmissionResultGreenhouseGas.VALID_GREENHOUSE_GASES = Object.values(GreenhouseGas_1.GreenhouseGas);
+GHGEmissionResultGreenhouseGas.MAIN_GAS_CATEGORIES = [
+    GreenhouseGasCategory_1.GreenhouseGasCategory.CO2,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.CH4,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.N2O,
+];
+GHGEmissionResultGreenhouseGas.FLUORINATED_CATEGORIES = [
+    GreenhouseGasCategory_1.GreenhouseGasCategory.HFC,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.PFC,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.SF6,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.NF3,
+    GreenhouseGasCategory_1.GreenhouseGasCategory.HCFC,
+];

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

@@ -0,0 +1,15 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GreenhouseGasCategory = void 0;
+var GreenhouseGasCategory;
+(function (GreenhouseGasCategory) {
+    GreenhouseGasCategory["CO2"] = "CO2";
+    GreenhouseGasCategory["CH4"] = "CH4";
+    GreenhouseGasCategory["N2O"] = "N2O";
+    GreenhouseGasCategory["HFC"] = "HFC";
+    GreenhouseGasCategory["PFC"] = "PFC";
+    GreenhouseGasCategory["SF6"] = "SF6";
+    GreenhouseGasCategory["NF3"] = "NF3";
+    GreenhouseGasCategory["HCFC"] = "HCFC";
+    GreenhouseGasCategory["OTHER"] = "OTHER";
+})(GreenhouseGasCategory || (exports.GreenhouseGasCategory = GreenhouseGasCategory = {}));