@carbonbox/domain 0.44.0 → 0.46.0

package/build/carbonbox/activity-data-collection/activity-data-submissions/domain/entity/ActivityDataSubmission.js

@@ -10,16 +10,19 @@ 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 _ActivityDataSubmission_dynamicFormCode, _ActivityDataSubmission_carbonClient, _ActivityDataSubmission_footprintType, _ActivityDataSubmission_country, _ActivityDataSubmission_footprintConfiguration, _ActivityDataSubmission_segmentConfiguration, _ActivityDataSubmission_filledByStakeholder, _ActivityDataSubmission_fieldResponses, _ActivityDataSubmission_periodStart, _ActivityDataSubmission_periodEnd, _ActivityDataSubmission_overallUncertaintyPercentage, _ActivityDataSubmission_uncertaintySource, _ActivityDataSubmission_dataQualityNotes, _ActivityDataSubmission_reportingStandard, _ActivityDataSubmission_emissionScope, _ActivityDataSubmission_subScope, _ActivityDataSubmission_status, _ActivityDataSubmission_submittedAt, _ActivityDataSubmission_approvedAt, _ActivityDataSubmission_rejectedAt, _ActivityDataSubmission_rejectionReason;
+var _ActivityDataSubmission_dynamicFormCode, _ActivityDataSubmission_carbonClient, _ActivityDataSubmission_footprintType, _ActivityDataSubmission_country, _ActivityDataSubmission_footprintConfiguration, _ActivityDataSubmission_segmentConfiguration, _ActivityDataSubmission_facility, _ActivityDataSubmission_filledByStakeholder, _ActivityDataSubmission_fieldResponses, _ActivityDataSubmission_periodStart, _ActivityDataSubmission_periodEnd, _ActivityDataSubmission_overallUncertaintyPercentage, _ActivityDataSubmission_uncertaintySource, _ActivityDataSubmission_dataQualityNotes, _ActivityDataSubmission_reportingStandard, _ActivityDataSubmission_emissionScope, _ActivityDataSubmission_subScope, _ActivityDataSubmission_status, _ActivityDataSubmission_submittedAt, _ActivityDataSubmission_approvedAt, _ActivityDataSubmission_rejectedAt, _ActivityDataSubmission_rejectionReason;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.ActivityDataSubmission = void 0;
 const AggregateRoot_1 = require("../../../../shared/domain/entities/AggregateRoot");
 const InvalidPropertyValueError_1 = require("../../../../shared/domain/exceptions/InvalidPropertyValueError");
+const CarbonFootprint_1 = require("../../../../carbon-footprint-configurations/shared/domain/enums/CarbonFootprint");
+const InvalidActivityDataSubmissionFacilityError_1 = require("../exceptions/InvalidActivityDataSubmissionFacilityError");
 const ActivityDataSubmissionApprovedAt_1 = require("../value-objects/ActivityDataSubmissionApprovedAt");
 const ActivityDataSubmissionCarbonClient_1 = require("../value-objects/ActivityDataSubmissionCarbonClient");
 const ActivityDataSubmissionDataQualityNotes_1 = require("../value-objects/ActivityDataSubmissionDataQualityNotes");
 const ActivityDataSubmissionDynamicFormCode_1 = require("../value-objects/ActivityDataSubmissionDynamicFormCode");
 const ActivityDataSubmissionEmissionScope_1 = require("../value-objects/ActivityDataSubmissionEmissionScope");
+const ActivityDataSubmissionFacility_1 = require("../value-objects/ActivityDataSubmissionFacility");
 const ActivityDataSubmissionFieldResponses_1 = require("../value-objects/ActivityDataSubmissionFieldResponses");
 const ActivityDataSubmissionFilledByStakeholder_1 = require("../value-objects/ActivityDataSubmissionFilledByStakeholder");
 const ActivityDataSubmissionFootprintType_1 = require("../value-objects/ActivityDataSubmissionFootprintType");
@@ -49,6 +52,7 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
         _ActivityDataSubmission_country.set(this, void 0);
         _ActivityDataSubmission_footprintConfiguration.set(this, void 0);
         _ActivityDataSubmission_segmentConfiguration.set(this, void 0);
+        _ActivityDataSubmission_facility.set(this, void 0);
         _ActivityDataSubmission_filledByStakeholder.set(this, void 0);
         _ActivityDataSubmission_fieldResponses.set(this, void 0);
         _ActivityDataSubmission_periodStart.set(this, void 0);
@@ -71,6 +75,7 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _ActivityDataSubmission_country, ActivityDataSubmissionCountry_1.ActivityDataSubmissionCountry.create(props.country), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_footprintConfiguration, ActivityDataSubmissionFootprintConfiguration_1.ActivityDataSubmissionFootprintConfiguration.create(props.footprintConfiguration), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_segmentConfiguration, ActivityDataSubmissionSegmentConfiguration_1.ActivityDataSubmissionSegmentConfiguration.create(props.segmentConfiguration), "f");
+            __classPrivateFieldSet(this, _ActivityDataSubmission_facility, ActivityDataSubmissionFacility_1.ActivityDataSubmissionFacility.create(props.facility), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_filledByStakeholder, ActivityDataSubmissionFilledByStakeholder_1.ActivityDataSubmissionFilledByStakeholder.create(props.filledByStakeholder), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_fieldResponses, ActivityDataSubmissionFieldResponses_1.ActivityDataSubmissionFieldResponses.create(props.fieldResponses), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_periodStart, ActivityDataSubmissionPeriodStart_1.ActivityDataSubmissionPeriodStart.create(props.periodStart), "f");
@@ -87,6 +92,7 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _ActivityDataSubmission_rejectedAt, ActivityDataSubmissionRejectedAt_1.ActivityDataSubmissionRejectedAt.create(props.rejectedAt), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_rejectionReason, ActivityDataSubmissionRejectionReason_1.ActivityDataSubmissionRejectionReason.create(props.rejectionReason), "f");
             ActivityDataSubmission.guardAgainstInvalidPeriodRange(props.periodStart, props.periodEnd);
+            ActivityDataSubmission.guardAgainstFacilityOnNonCorporateFootprint(props.facility, props.footprintType);
         }
         else {
             __classPrivateFieldSet(this, _ActivityDataSubmission_dynamicFormCode, ActivityDataSubmissionDynamicFormCode_1.ActivityDataSubmissionDynamicFormCode.fromPrimitives(props.dynamicFormCode), "f");
@@ -95,6 +101,7 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _ActivityDataSubmission_country, ActivityDataSubmissionCountry_1.ActivityDataSubmissionCountry.fromPrimitives(props.country), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_footprintConfiguration, ActivityDataSubmissionFootprintConfiguration_1.ActivityDataSubmissionFootprintConfiguration.fromPrimitives(props.footprintConfiguration), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_segmentConfiguration, ActivityDataSubmissionSegmentConfiguration_1.ActivityDataSubmissionSegmentConfiguration.fromPrimitives(props.segmentConfiguration), "f");
+            __classPrivateFieldSet(this, _ActivityDataSubmission_facility, ActivityDataSubmissionFacility_1.ActivityDataSubmissionFacility.fromPrimitives(props.facility), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_filledByStakeholder, ActivityDataSubmissionFilledByStakeholder_1.ActivityDataSubmissionFilledByStakeholder.fromPrimitives(props.filledByStakeholder), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_fieldResponses, ActivityDataSubmissionFieldResponses_1.ActivityDataSubmissionFieldResponses.fromPrimitives(props.fieldResponses), "f");
             __classPrivateFieldSet(this, _ActivityDataSubmission_periodStart, ActivityDataSubmissionPeriodStart_1.ActivityDataSubmissionPeriodStart.fromPrimitives(props.periodStart), "f");
@@ -112,6 +119,16 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
             __classPrivateFieldSet(this, _ActivityDataSubmission_rejectionReason, ActivityDataSubmissionRejectionReason_1.ActivityDataSubmissionRejectionReason.fromPrimitives(props.rejectionReason), "f");
         }
     }
+    /**
+     * A facility attributes the activity data to one site of a corporate inventory. Product and
+     * event footprints measure a product / event edition, so they never carry a facility.
+     * `null` on a corporate submission means the data is reported at corporate level.
+     */
+    static guardAgainstFacilityOnNonCorporateFootprint(facility, footprintType) {
+        if (facility !== null && footprintType !== CarbonFootprint_1.CarbonFootprint.CORPORATE) {
+            throw InvalidActivityDataSubmissionFacilityError_1.InvalidActivityDataSubmissionFacilityError.create(facility.id, footprintType);
+        }
+    }
     /**
      * Validates that the reporting period range is coherent (`periodStart <= periodEnd`).
      * Dates are in canonical DD/MM/YYYY format (project convention DT-2).
@@ -140,6 +157,7 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
             country: primitives.country,
             footprintConfiguration: primitives.footprintConfiguration,
             segmentConfiguration: primitives.segmentConfiguration,
+            facility: primitives.facility,
             filledByStakeholder: primitives.filledByStakeholder,
             fieldResponses: primitives.fieldResponses,
             periodStart: primitives.periodStart,
@@ -167,6 +185,7 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
             country: __classPrivateFieldGet(this, _ActivityDataSubmission_country, "f").toEnum(),
             footprintConfiguration: __classPrivateFieldGet(this, _ActivityDataSubmission_footprintConfiguration, "f").toPrimitives(),
             segmentConfiguration: __classPrivateFieldGet(this, _ActivityDataSubmission_segmentConfiguration, "f").toPrimitives(),
+            facility: __classPrivateFieldGet(this, _ActivityDataSubmission_facility, "f").toPrimitives(),
             filledByStakeholder: __classPrivateFieldGet(this, _ActivityDataSubmission_filledByStakeholder, "f").toPrimitives(),
             fieldResponses: __classPrivateFieldGet(this, _ActivityDataSubmission_fieldResponses, "f").toPrimitives(),
             periodStart: __classPrivateFieldGet(this, _ActivityDataSubmission_periodStart, "f").toPrimitives(),
@@ -202,6 +221,9 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
     get segmentConfiguration() {
         return __classPrivateFieldGet(this, _ActivityDataSubmission_segmentConfiguration, "f");
     }
+    get facility() {
+        return __classPrivateFieldGet(this, _ActivityDataSubmission_facility, "f");
+    }
     get filledByStakeholder() {
         return __classPrivateFieldGet(this, _ActivityDataSubmission_filledByStakeholder, "f");
     }
@@ -249,4 +271,4 @@ class ActivityDataSubmission extends AggregateRoot_1.AggregateRoot {
     }
 }
 exports.ActivityDataSubmission = ActivityDataSubmission;
-_ActivityDataSubmission_dynamicFormCode = new WeakMap(), _ActivityDataSubmission_carbonClient = new WeakMap(), _ActivityDataSubmission_footprintType = new WeakMap(), _ActivityDataSubmission_country = new WeakMap(), _ActivityDataSubmission_footprintConfiguration = new WeakMap(), _ActivityDataSubmission_segmentConfiguration = new WeakMap(), _ActivityDataSubmission_filledByStakeholder = new WeakMap(), _ActivityDataSubmission_fieldResponses = new WeakMap(), _ActivityDataSubmission_periodStart = new WeakMap(), _ActivityDataSubmission_periodEnd = new WeakMap(), _ActivityDataSubmission_overallUncertaintyPercentage = new WeakMap(), _ActivityDataSubmission_uncertaintySource = new WeakMap(), _ActivityDataSubmission_dataQualityNotes = new WeakMap(), _ActivityDataSubmission_reportingStandard = new WeakMap(), _ActivityDataSubmission_emissionScope = new WeakMap(), _ActivityDataSubmission_subScope = new WeakMap(), _ActivityDataSubmission_status = new WeakMap(), _ActivityDataSubmission_submittedAt = new WeakMap(), _ActivityDataSubmission_approvedAt = new WeakMap(), _ActivityDataSubmission_rejectedAt = new WeakMap(), _ActivityDataSubmission_rejectionReason = new WeakMap();
+_ActivityDataSubmission_dynamicFormCode = new WeakMap(), _ActivityDataSubmission_carbonClient = new WeakMap(), _ActivityDataSubmission_footprintType = new WeakMap(), _ActivityDataSubmission_country = new WeakMap(), _ActivityDataSubmission_footprintConfiguration = new WeakMap(), _ActivityDataSubmission_segmentConfiguration = new WeakMap(), _ActivityDataSubmission_facility = new WeakMap(), _ActivityDataSubmission_filledByStakeholder = new WeakMap(), _ActivityDataSubmission_fieldResponses = new WeakMap(), _ActivityDataSubmission_periodStart = new WeakMap(), _ActivityDataSubmission_periodEnd = new WeakMap(), _ActivityDataSubmission_overallUncertaintyPercentage = new WeakMap(), _ActivityDataSubmission_uncertaintySource = new WeakMap(), _ActivityDataSubmission_dataQualityNotes = new WeakMap(), _ActivityDataSubmission_reportingStandard = new WeakMap(), _ActivityDataSubmission_emissionScope = new WeakMap(), _ActivityDataSubmission_subScope = new WeakMap(), _ActivityDataSubmission_status = new WeakMap(), _ActivityDataSubmission_submittedAt = new WeakMap(), _ActivityDataSubmission_approvedAt = new WeakMap(), _ActivityDataSubmission_rejectedAt = new WeakMap(), _ActivityDataSubmission_rejectionReason = new WeakMap();

package/build/carbonbox/activity-data-collection/activity-data-submissions/domain/exceptions/InvalidActivityDataSubmissionFacilityError.js

@@ -0,0 +1,31 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.InvalidActivityDataSubmissionFacilityError = void 0;
+const CodedRootError_1 = require("../../../../shared/domain/exceptions/CodedRootError");
+const ErrorCode_1 = require("../../../../shared/domain/enums/ErrorCode");
+const CarbonFootprint_1 = require("../../../../carbon-footprint-configurations/shared/domain/enums/CarbonFootprint");
+class InvalidActivityDataSubmissionFacilityError extends CodedRootError_1.CodedRootError {
+    constructor(facilityId, receivedFootprintType) {
+        const technicalMessage = `Invalid activity data submission facility '${facilityId}': a facility can only be assigned to a ${CarbonFootprint_1.CarbonFootprint.CORPORATE} footprint submission, received footprint type '${receivedFootprintType}'.`;
+        const context = {
+            facilityId,
+            receivedFootprintType,
+            allowedFootprintType: CarbonFootprint_1.CarbonFootprint.CORPORATE,
+            timestamp: new Date().toISOString(),
+        };
+        const suggestions = [
+            'Send facility as null for PRODUCT and EVENT footprint submissions',
+            'Assign a facility only when the submission belongs to a CORPORATE footprint configuration',
+            'Use null on a CORPORATE submission to report the activity data at corporate level',
+        ];
+        super(ErrorCode_1.ErrorCode.INVALID_SUBMISSION_FACILITY, technicalMessage, context, suggestions);
+        this.name = 'InvalidActivityDataSubmissionFacilityError';
+    }
+    static create(facilityId, receivedFootprintType) {
+        return new InvalidActivityDataSubmissionFacilityError(facilityId, receivedFootprintType);
+    }
+    logError() {
+        return `${this.name}: ${this.technicalMessage}`;
+    }
+}
+exports.InvalidActivityDataSubmissionFacilityError = InvalidActivityDataSubmissionFacilityError;

package/build/carbonbox/activity-data-collection/activity-data-submissions/domain/value-objects/ActivityDataSubmissionFacility.js

@@ -0,0 +1,25 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ActivityDataSubmissionFacility = void 0;
+const NullableFacilityReference_1 = require("../../../../shared/domain/value-objects/NullableFacilityReference");
+/**
+ * Sede a la que se imputa el dato de actividad. `null` significa "Nivel Corporativo":
+ * el dato pertenece a la organización y no a una sede concreta.
+ */
+class ActivityDataSubmissionFacility extends NullableFacilityReference_1.NullableFacilityReference {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, ActivityDataSubmissionFacility.PROPERTY_NAME);
+    }
+    static create(value) {
+        return new ActivityDataSubmissionFacility(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = primitives;
+        return new ActivityDataSubmissionFacility(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.ActivityDataSubmissionFacility = ActivityDataSubmissionFacility;
+ActivityDataSubmissionFacility.PROPERTY_NAME = 'facility';

package/build/carbonbox/carbon-footprint-configurations/corporate-configurations/domain/entity/CorporateCarbonFootprintConfiguration.js

@@ -10,7 +10,7 @@ var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (
     if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
     return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
 };
-var _CorporateCarbonFootprintConfiguration_facility, _CorporateCarbonFootprintConfiguration_executionPeriod, _CorporateCarbonFootprintConfiguration_baseYear, _CorporateCarbonFootprintConfiguration_segmentConfigurations;
+var _CorporateCarbonFootprintConfiguration_facilities, _CorporateCarbonFootprintConfiguration_executionPeriod, _CorporateCarbonFootprintConfiguration_baseYear, _CorporateCarbonFootprintConfiguration_segmentConfigurations;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.CorporateCarbonFootprintConfiguration = void 0;
 const CarbonFootprintConfiguration_1 = require("../../../shared/domain/entities/CarbonFootprintConfiguration");
@@ -20,7 +20,7 @@ const CorporateCarbonFootprintConfigurationName_1 = require("../value-objects/Co
 const CorporateCarbonFootprintConfigurationCreatedByStakeholder_1 = require("../value-objects/CorporateCarbonFootprintConfigurationCreatedByStakeholder");
 const CorporateCarbonFootprintConfigurationExecutionPeriod_1 = require("../value-objects/CorporateCarbonFootprintConfigurationExecutionPeriod");
 const CorporateCarbonFootprintConfigurationBaseYear_1 = require("../value-objects/CorporateCarbonFootprintConfigurationBaseYear");
-const CorporateCarbonFootprintConfigurationFacility_1 = require("../value-objects/CorporateCarbonFootprintConfigurationFacility");
+const CorporateCarbonFootprintConfigurationFacilities_1 = require("../value-objects/CorporateCarbonFootprintConfigurationFacilities");
 const CorporateCarbonFootprintConfigurationFootprintType_1 = require("../value-objects/CorporateCarbonFootprintConfigurationFootprintType");
 const CorporateCarbonFootprintConfigurationIntensityIndicatorConfigurations_1 = require("../value-objects/CorporateCarbonFootprintConfigurationIntensityIndicatorConfigurations");
 const CorporateCarbonFootprintConfigurationOwnedByCarbonClient_1 = require("../value-objects/CorporateCarbonFootprintConfigurationOwnedByCarbonClient");
@@ -72,20 +72,20 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
             ownedByCarbonClient,
             createdByStakeholder,
         }, skipDomainValidation);
-        _CorporateCarbonFootprintConfiguration_facility.set(this, void 0);
+        _CorporateCarbonFootprintConfiguration_facilities.set(this, void 0);
         _CorporateCarbonFootprintConfiguration_executionPeriod.set(this, void 0);
         _CorporateCarbonFootprintConfiguration_baseYear.set(this, void 0);
         _CorporateCarbonFootprintConfiguration_segmentConfigurations.set(this, void 0);
         if (skipDomainValidation === false) {
             // Initialize with domain validation
-            __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_facility, CorporateCarbonFootprintConfigurationFacility_1.CorporateCarbonFootprintConfigurationFacility.create(props.facility), "f");
+            __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_facilities, CorporateCarbonFootprintConfigurationFacilities_1.CorporateCarbonFootprintConfigurationFacilities.create(props.facilities), "f");
             __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_executionPeriod, CorporateCarbonFootprintConfigurationExecutionPeriod_1.CorporateCarbonFootprintConfigurationExecutionPeriod.create(props.executionPeriod), "f");
             __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_baseYear, CorporateCarbonFootprintConfigurationBaseYear_1.CorporateCarbonFootprintConfigurationBaseYear.create(props.baseYear), "f");
             __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_segmentConfigurations, CorporateCarbonFootprintConfigurationSegmentConfigurations_1.CorporateCarbonFootprintConfigurationSegmentConfigurations.create(props.segmentConfigurations), "f");
         }
         else {
             // Initialize from primitives (no domain validation)
-            __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_facility, CorporateCarbonFootprintConfigurationFacility_1.CorporateCarbonFootprintConfigurationFacility.fromPrimitives(props.facility), "f");
+            __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_facilities, CorporateCarbonFootprintConfigurationFacilities_1.CorporateCarbonFootprintConfigurationFacilities.fromPrimitives(props.facilities), "f");
             __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_executionPeriod, CorporateCarbonFootprintConfigurationExecutionPeriod_1.CorporateCarbonFootprintConfigurationExecutionPeriod.fromPrimitives(props.executionPeriod), "f");
             __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_baseYear, CorporateCarbonFootprintConfigurationBaseYear_1.CorporateCarbonFootprintConfigurationBaseYear.fromPrimitives(props.baseYear), "f");
             __classPrivateFieldSet(this, _CorporateCarbonFootprintConfiguration_segmentConfigurations, CorporateCarbonFootprintConfigurationSegmentConfigurations_1.CorporateCarbonFootprintConfigurationSegmentConfigurations.fromPrimitives(props.segmentConfigurations), "f");
@@ -106,7 +106,7 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
             status: primitives.status,
             ownedByCarbonClient: primitives.ownedByCarbonClient,
             createdByStakeholder: primitives.createdByStakeholder,
-            facility: primitives.facility,
+            facilities: primitives.facilities,
             executionPeriod: primitives.executionPeriod,
             baseYear: primitives.baseYear,
             segmentConfigurations: primitives.segmentConfigurations,
@@ -125,14 +125,14 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
             status: this.status.toEnum(),
             ownedByCarbonClient: this.ownedByCarbonClient.toPrimitives(),
             createdByStakeholder: this.createdByStakeholder.toPrimitives(),
-            facility: this.facility.toPrimitives(),
+            facilities: this.facilities.toPrimitives(),
             executionPeriod: this.executionPeriod.toPrimitives(),
             baseYear: this.baseYear.toPrimitives(),
             segmentConfigurations: this.segmentConfigurations.toPrimitives(),
         };
     }
-    get facility() {
-        return __classPrivateFieldGet(this, _CorporateCarbonFootprintConfiguration_facility, "f");
+    get facilities() {
+        return __classPrivateFieldGet(this, _CorporateCarbonFootprintConfiguration_facilities, "f");
     }
     get executionPeriod() {
         return __classPrivateFieldGet(this, _CorporateCarbonFootprintConfiguration_executionPeriod, "f");
@@ -145,4 +145,4 @@ class CorporateCarbonFootprintConfiguration extends CarbonFootprintConfiguration
     }
 }
 exports.CorporateCarbonFootprintConfiguration = CorporateCarbonFootprintConfiguration;
-_CorporateCarbonFootprintConfiguration_facility = new WeakMap(), _CorporateCarbonFootprintConfiguration_executionPeriod = new WeakMap(), _CorporateCarbonFootprintConfiguration_baseYear = new WeakMap(), _CorporateCarbonFootprintConfiguration_segmentConfigurations = new WeakMap();
+_CorporateCarbonFootprintConfiguration_facilities = new WeakMap(), _CorporateCarbonFootprintConfiguration_executionPeriod = new WeakMap(), _CorporateCarbonFootprintConfiguration_baseYear = new WeakMap(), _CorporateCarbonFootprintConfiguration_segmentConfigurations = new WeakMap();

package/build/carbonbox/carbon-footprint-configurations/corporate-configurations/domain/value-objects/CorporateCarbonFootprintConfigurationFacilities.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CorporateCarbonFootprintConfigurationFacilities = void 0;
+const FacilityReferences_1 = require("../../../../shared/domain/value-objects/FacilityReferences");
+class CorporateCarbonFootprintConfigurationFacilities extends FacilityReferences_1.FacilityReferences {
+    constructor(value, skipDomainValidation) {
+        super(value, skipDomainValidation, CorporateCarbonFootprintConfigurationFacilities.PROPERTY_NAME, { allowEmpty: false });
+    }
+    static create(value) {
+        return new CorporateCarbonFootprintConfigurationFacilities(value, false);
+    }
+    static fromPrimitives(primitives) {
+        const value = primitives.map((primitive) => ({
+            id: primitive.id,
+            commercialBranchName: primitive.commercialBranchName,
+        }));
+        return new CorporateCarbonFootprintConfigurationFacilities(value, true);
+    }
+    toPrimitives() {
+        return this.value;
+    }
+}
+exports.CorporateCarbonFootprintConfigurationFacilities = CorporateCarbonFootprintConfigurationFacilities;
+CorporateCarbonFootprintConfigurationFacilities.PROPERTY_NAME = 'facilities';

package/build/carbonbox/emission-calculation-results/emission-calculations/domain/value-objects/EmissionCalculationDimensions.js

@@ -14,7 +14,7 @@ const InvalidPropertyTypeError_1 = require("../../../../shared/domain/exceptions
  * Value object wrapping the intrinsic dimensional keys denormalized on the
  * EmissionCalculation at calculation time (CALC-001). Required string fields
  * (`emissionScope`, `segmentId`, `periodStart`) are validated non-empty;
- * `subScope` and `subsegmentId` are nullable.
+ * `subScope`, `subsegmentId` and `facilityId` are nullable.
  */
 class EmissionCalculationDimensions extends ValueObject_1.ValueObject {
     constructor(value, skipDomainValidation) {
@@ -47,6 +47,9 @@ _a = EmissionCalculationDimensions, _EmissionCalculationDimensions_validate = fu
     if (value.subsegmentId !== null && typeof value.subsegmentId !== 'string') {
         throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${_a.PROPERTY_NAME}.subsegmentId`, 'string or null', typeof value.subsegmentId);
     }
+    if (value.facilityId !== null && typeof value.facilityId !== 'string') {
+        throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${_a.PROPERTY_NAME}.facilityId`, 'string or null', typeof value.facilityId);
+    }
 }, _EmissionCalculationDimensions_toPrimitives = function _EmissionCalculationDimensions_toPrimitives(value) {
     return {
         emissionScope: value.emissionScope,
@@ -54,6 +57,7 @@ _a = EmissionCalculationDimensions, _EmissionCalculationDimensions_validate = fu
         segmentId: value.segmentId,
         subsegmentId: value.subsegmentId,
         periodStart: value.periodStart,
+        facilityId: value.facilityId,
     };
 };
 EmissionCalculationDimensions.PROPERTY_NAME = 'dimensions';

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

@@ -119,6 +119,13 @@ class GHGEmissionResult extends AggregateRoot_1.AggregateRoot {
     get unit() {
         return __classPrivateFieldGet(this, _GHGEmissionResult_unit, "f");
     }
+    /**
+     * Si este resultado se suma al total del inventario. Falso solo para el CO₂ biogénico
+     * (`CO2-BIOGENIC`), que se reporta como partida informativa fuera de los alcances.
+     */
+    countsTowardsInventoryTotal() {
+        return __classPrivateFieldGet(this, _GHGEmissionResult_greenhouseGas, "f").countsTowardsInventoryTotal();
+    }
 }
 exports.GHGEmissionResult = GHGEmissionResult;
 _GHGEmissionResult_emissionCalculation = new WeakMap(), _GHGEmissionResult_greenhouseGas = new WeakMap(), _GHGEmissionResult_activityValue = new WeakMap(), _GHGEmissionResult_emissionFactor = new WeakMap(), _GHGEmissionResult_globalWarmingPotential = new WeakMap(), _GHGEmissionResult_rawEmission = new WeakMap(), _GHGEmissionResult_co2Equivalent = new WeakMap(), _GHGEmissionResult_unit = new WeakMap();

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

@@ -45,6 +45,18 @@ class GHGEmissionResultGreenhouseGas extends ValueObject_1.ValueObject {
     isFluorinatedGas() {
         return GHGEmissionResultGreenhouseGas.FLUORINATED_CATEGORIES.includes(this.category);
     }
+    /** CO₂ de biomasa / biocombustibles (`CO2-BIOGENIC`): partida informativa fuera del total. */
+    isBiogenicCarbonDioxide() {
+        return GreenhouseGasSpecies_1.GreenhouseGasSpecies.isBiogenicCarbonDioxide(this.species);
+    }
+    /**
+     * Si el resultado de este gas se suma al total del inventario y a sus alcances. Solo el CO₂
+     * biogénico queda fuera (GHG Protocol cap. 9 / ISO 14064-1 §9.3.1); el CH₄ y el N₂O de la
+     * misma combustión cuentan con su PCG.
+     */
+    countsTowardsInventoryTotal() {
+        return !this.isBiogenicCarbonDioxide();
+    }
     toPrimitives() {
         return {
             greenhouseGasCategory: this.value.greenhouseGasCategory,

package/build/carbonbox/reporting/shared/domain/enums/DataBindingSource.js

@@ -43,9 +43,10 @@ var DataBindingSource;
     DataBindingSource["AGGREGATION_GAS_N2O"] = "aggregation.gas.n2o";
     // Aggregations - By Segment
     DataBindingSource["AGGREGATION_BY_SEGMENT"] = "aggregation.bySegment";
-    // Aggregations - Biogenic
-    DataBindingSource["AGGREGATION_BIOGENIC"] = "aggregation.biogenic";
+    // Aggregations - Biogenic CO₂ (informational item OUTSIDE the inventory total and the scopes,
+    // GHG Protocol cap. 9 / ISO 14064-1 §9.3.1): the `CO2-BIOGENIC` species, total and per source.
     DataBindingSource["AGGREGATION_BIOGENIC_CO2"] = "aggregation.biogenicCO2";
+    DataBindingSource["AGGREGATION_BIOGENIC_CO2_BY_SOURCE"] = "aggregation.biogenicCO2.bySource";
     // Aggregations - Uncertainty (GAP 4): inventory-level propagated uncertainty
     DataBindingSource["AGGREGATION_UNCERTAINTY_PERCENTAGE"] = "aggregation.uncertainty.percentage";
     DataBindingSource["AGGREGATION_UNCERTAINTY_LEVEL"] = "aggregation.uncertainty.level";

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

@@ -17,7 +17,7 @@ exports.ErrorCode = void 0;
  * - RPT: Reporting
  * - SHR: Shared/Common
  *
- * Total Codes: 173
+ * Total Codes: 174
  * Total Exceptions Migrated: 171 (100%)
  *
  * @since 1.0.0
@@ -118,6 +118,8 @@ var ErrorCode;
     ErrorCode["TRIGGER_VALUE_CONVERSION_ERROR"] = "CBX-ADC-020";
     ErrorCode["TRIGGER_VALUE_STRING_OPERATION_ERROR"] = "CBX-ADC-021";
     ErrorCode["UNKNOWN_CONDITIONAL_ACTION_CATEGORY"] = "CBX-ADC-022";
+    // Activity Data Submission facility attribution (CBX-ADC-023)
+    ErrorCode["INVALID_SUBMISSION_FACILITY"] = "CBX-ADC-023";
     // Emission Calculation Errors (CBX-EMC-XXX)
     ErrorCode["CALCULATION_FAILED"] = "CBX-EMC-001";
     ErrorCode["MISSING_EMISSION_FACTOR"] = "CBX-EMC-002";

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

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

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

@@ -0,0 +1,224 @@
+"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 _FacilityReferences_facilityReferences, _FacilityReferences_options;
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FacilityReferences = void 0;
+const InvalidPropertyTypeError_1 = require("../exceptions/InvalidPropertyTypeError");
+const InvalidPropertyValueError_1 = require("../exceptions/InvalidPropertyValueError");
+const ValueObject_1 = require("./ValueObject");
+const String_1 = require("./String");
+const AggregateId_1 = require("./AggregateId");
+class FacilityReferences extends ValueObject_1.ValueObject {
+    /**
+     * Constructor protegido para que solo clases hijas puedan instanciar.
+     * Aplica todas las validaciones de dominio al momento de construcción.
+     */
+    constructor(value, skipDomainValidation, propertyName = FacilityReferences.DEFAULT_PROPERTY_NAME, options = FacilityReferences.DEFAULT_OPTIONS) {
+        const finalOptions = { ...FacilityReferences.DEFAULT_OPTIONS, ...options };
+        if (skipDomainValidation === false) {
+            FacilityReferences.validateReferences(value, propertyName, finalOptions);
+        }
+        super(FacilityReferences.toCleanReferences(value), skipDomainValidation, propertyName, 'The provided value must be an array of FacilityReference from the domain layer', { allowNull: false, allowUndefined: false });
+        _FacilityReferences_facilityReferences.set(this, void 0);
+        _FacilityReferences_options.set(this, void 0);
+        __classPrivateFieldSet(this, _FacilityReferences_facilityReferences, FacilityReferences.toCleanReferences(value), "f");
+        __classPrivateFieldSet(this, _FacilityReferences_options, finalOptions, "f");
+    }
+    /**
+     * Validación estática para reutilización en factory methods y constructores.
+     */
+    static validateReferences(value, propertyName, options) {
+        this.guardAgainstInvalidType(value, propertyName);
+        this.guardAgainstInvalidEmptyArray(value, options, propertyName);
+        value.forEach((reference, index) => {
+            this.guardAgainstInvalidReference(reference, index, propertyName);
+        });
+        this.guardAgainstDuplicatedIds(value, propertyName);
+    }
+    /**
+     * Valida que el valor sea un array válido.
+     */
+    static guardAgainstInvalidType(value, propertyName) {
+        if (!Array.isArray(value)) {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(propertyName, 'array of FacilityReference', typeof value);
+        }
+    }
+    /**
+     * Valida que el array no esté vacío si no se permite.
+     */
+    static guardAgainstInvalidEmptyArray(value, options, propertyName) {
+        if (!options.allowEmpty && value.length === 0) {
+            throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(propertyName, 'non-empty array', 'empty array');
+        }
+    }
+    /**
+     * Valida que no haya sedes duplicadas en la lista.
+     */
+    static guardAgainstDuplicatedIds(value, propertyName) {
+        const ids = value.map((item) => item.id.trim());
+        const uniqueIds = new Set(ids);
+        if (ids.length !== uniqueIds.size) {
+            throw InvalidPropertyValueError_1.InvalidPropertyValueError.create(`${propertyName}.ids`, 'array with unique IDs', 'array with duplicated IDs');
+        }
+    }
+    /**
+     * Valida una referencia individual.
+     */
+    static guardAgainstInvalidReference(reference, index, basePropertyName) {
+        const propertyName = `${basePropertyName}[${index}]`;
+        if (!reference || typeof reference !== 'object') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(propertyName, 'FacilityReference object', typeof reference);
+        }
+        if (typeof reference.id !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.id`, 'string', typeof reference.id);
+        }
+        if (typeof reference.commercialBranchName !== 'string') {
+            throw InvalidPropertyTypeError_1.InvalidPropertyTypeError.create(`${propertyName}.commercialBranchName`, 'string', typeof reference.commercialBranchName);
+        }
+        String_1.String.guardAgainstEmptyValue(reference.id, `${propertyName}.id`);
+        AggregateId_1.AggregateId.guardAgainstInvalidId(reference.id, `${propertyName}.id`);
+        String_1.String.guardAgainstEmptyValue(reference.commercialBranchName, `${propertyName}.commercialBranchName`);
+    }
+    /**
+     * Limpia y normaliza las referencias.
+     */
+    static toCleanReferences(value) {
+        return value.map((item) => ({
+            id: item.id.trim(),
+            commercialBranchName: item.commercialBranchName.trim(),
+        }));
+    }
+    /**
+     * Array de referencias de sedes (inmutable).
+     */
+    get facilityReferences() {
+        return Object.freeze([...__classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f")]);
+    }
+    /**
+     * Opciones de configuración de la colección.
+     */
+    get options() {
+        return Object.freeze({ ...__classPrivateFieldGet(this, _FacilityReferences_options, "f") });
+    }
+    /**
+     * Número de referencias en la lista.
+     */
+    get count() {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").length;
+    }
+    /**
+     * Verifica si la lista está vacía.
+     */
+    isEmpty() {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").length === 0;
+    }
+    /**
+     * Verifica si la lista tiene referencias.
+     */
+    hasReferences() {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").length > 0;
+    }
+    /**
+     * Verifica si la colección permite estar vacía.
+     */
+    allowsEmpty() {
+        return __classPrivateFieldGet(this, _FacilityReferences_options, "f").allowEmpty === true;
+    }
+    /**
+     * Verifica si la colección está en un estado válido según sus opciones.
+     */
+    isValidState() {
+        if (!this.allowsEmpty() && this.isEmpty()) {
+            return false;
+        }
+        return true;
+    }
+    /**
+     * Obtiene una referencia por su id.
+     */
+    getById(id) {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").find((reference) => reference.id === id.trim());
+    }
+    /**
+     * Verifica si existe una referencia con el id especificado.
+     */
+    hasId(id) {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").some((reference) => reference.id === id.trim());
+    }
+    /**
+     * Obtiene todos los ids de las referencias.
+     */
+    getIds() {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").map((reference) => reference.id);
+    }
+    /**
+     * Obtiene todos los nombres comerciales de las referencias.
+     */
+    getCommercialBranchNames() {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").map((reference) => reference.commercialBranchName);
+    }
+    /**
+     * Compara la igualdad semántica con otra lista de referencias.
+     * Dos colecciones son iguales si referencian el mismo conjunto de sedes.
+     */
+    equals(other) {
+        if (!(other instanceof FacilityReferences)) {
+            return false;
+        }
+        if (__classPrivateFieldGet(this, _FacilityReferences_options, "f").allowEmpty !== __classPrivateFieldGet(other, _FacilityReferences_options, "f").allowEmpty) {
+            return false;
+        }
+        if (__classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").length !== __classPrivateFieldGet(other, _FacilityReferences_facilityReferences, "f").length) {
+            return false;
+        }
+        const otherIds = new Set(other.getIds());
+        return this.getIds().every((id) => otherIds.has(id));
+    }
+    /**
+     * Genera un hash code para usar en colecciones.
+     */
+    hashCode() {
+        const optionsHash = __classPrivateFieldGet(this, _FacilityReferences_options, "f").allowEmpty ? 'E' : 'NE';
+        return `facilityReferences_${optionsHash}_${[...this.getIds()].sort().join('_')}`;
+    }
+    /**
+     * Convierte a representación primitiva para persistencia.
+     */
+    toPrimitives() {
+        return __classPrivateFieldGet(this, _FacilityReferences_facilityReferences, "f").map((reference) => ({
+            id: reference.id,
+            commercialBranchName: reference.commercialBranchName,
+        }));
+    }
+    /**
+     * Representación como string (lista de nombres comerciales).
+     */
+    toString() {
+        if (this.isEmpty()) {
+            return 'Sin sedes';
+        }
+        return this.getCommercialBranchNames().join(', ');
+    }
+    /**
+     * Representación JSON para serialización.
+     */
+    toJSON() {
+        return this.toPrimitives();
+    }
+}
+exports.FacilityReferences = FacilityReferences;
+_FacilityReferences_facilityReferences = new WeakMap(), _FacilityReferences_options = new WeakMap();
+FacilityReferences.DEFAULT_PROPERTY_NAME = 'facilityReferences';
+FacilityReferences.DEFAULT_OPTIONS = {
+    allowEmpty: false, // Por defecto no permite estar vacío
+};

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

@@ -10,6 +10,12 @@ const InvalidPropertyValueError_1 = require("../exceptions/InvalidPropertyValueE
  * para que un mismo refrigerante escrito con espacios/casing distintos matchee siempre igual.
  * La categoría (GreenhouseGasCategory) viaja al lado; aquí no se valida coherencia química
  * especie↔categoría (decisión de diseño: validación permisiva, match por especie).
+ *
+ * CO₂ biogénico: el CO₂ liberado al quemar biomasa o biocombustibles se reporta por separado,
+ * fuera de los alcances y del total del inventario (GHG Protocol Corporate Standard cap. 9;
+ * ISO 14064-1:2018 §9.3.1). Se modela como la especie `CO2-BIOGENIC` de la categoría CO2
+ * (paralela a `CH4-BIOGENIC`, que SÍ cuenta en el total con su PCG). Este VO es el único lugar
+ * que conoce esa convención: toda suma de inventario pregunta `isBiogenicCarbonDioxide`.
  */
 class GreenhouseGasSpecies extends String_1.String {
     constructor(value, skipDomainValidation) {
@@ -33,6 +39,16 @@ class GreenhouseGasSpecies extends String_1.String {
         String_1.String.guardAgainstInvalidType(value, GreenhouseGasSpecies.PROPERTY_NAME);
         return value.trim().replace(/\s+/g, ' ').toUpperCase();
     }
+    /**
+     * True para la especie `CO2-BIOGENIC` (en cualquier casing/espaciado): CO₂ que NO cuenta en
+     * el total del inventario y se reporta como partida informativa.
+     */
+    static isBiogenicCarbonDioxide(value) {
+        return GreenhouseGasSpecies.normalize(value) === GreenhouseGasSpecies.BIOGENIC_CARBON_DIOXIDE;
+    }
+    isBiogenicCarbonDioxide() {
+        return GreenhouseGasSpecies.isBiogenicCarbonDioxide(this.value);
+    }
     static guardAgainstInvalidSpecies(value) {
         String_1.String.guardAgainstEmptyValue(value, GreenhouseGasSpecies.PROPERTY_NAME);
         if (!GreenhouseGasSpecies.SPECIES_REGEX.test(value)) {
@@ -45,6 +61,7 @@ class GreenhouseGasSpecies extends String_1.String {
 }
 exports.GreenhouseGasSpecies = GreenhouseGasSpecies;
 GreenhouseGasSpecies.PROPERTY_NAME = 'greenhouseGasSpecies';
+GreenhouseGasSpecies.BIOGENIC_CARBON_DIOXIDE = 'CO2-BIOGENIC';
 // Letras, dígitos, espacio, guion y barra: cubre ASHRAE (R-410A) y químicos/mezclas
 // (HFC-134A, MEZCLA HFC 365MFC/HFC 227EA, POLYCOLD 1102HC).
 GreenhouseGasSpecies.SPECIES_REGEX = /^[A-Z0-9][A-Z0-9 /-]*$/;